Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Duke Alumnus, B.S. in Mathematics and M.Eng. in Risk Engineering · Sequoia Fell
## Selected Research

- **[Critical Dependence Stress for Diversification Gains under Fixed Marginals](https://www.theodoreoy.com/critical-dependence-stress-for-diversification-gains-under-fixed-marginals/)**
How much dependence stress reverses a portfolio's Expected Shortfall advantage while every loss distribution stays fixed. The asymptotic reversal budget is at least 30% above the initial-sensitivity prediction.
How much dependence stress reverses a portfolio's Expected Shortfall advantage while every loss distribution stays fixed. In the uniform benchmark, the critical budget is at least 30% above the tangent prediction.
- **[Certified Valuation of Arithmetic Asian Options](https://www.theodoreoy.com/certified-valuation-of-arithmetic-asian-options/)**
What an arithmetic Asian option loses when exercise is decided on the geometric average of its fixings. The proved bound is below a hundredth of a cent per barrel for a one-month crude oil option, and under Heston it becomes a certified price interval.
- **[Certified Joint Pricing Errors in Rough Heston](https://www.theodoreoy.com/certified-joint-pricing-errors-in-rough-heston/)**
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ permissions:

concurrency:
group: pages-${{ github.event_name == 'push' && 'production' || github.ref }}
cancel-in-progress: true
cancel-in-progress: ${{ github.event_name != 'push' }}

jobs:
build:
Expand Down
5 changes: 3 additions & 2 deletions architecture/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,8 @@ npm --prefix website run check

The integration applies the site's type roles, a responsive reader layout, major-section
heading semantics, control labels, and export-font settings while preserving SVG
geometry. It accepts both freshly generated and integrated viewers, and running it again
geometry. It sets the site's palette with no bullet before the title or the card
headings, and adds the site's Return Home link, with its return arrow, above the title. It accepts both freshly generated and integrated viewers, and running it again
leaves an integrated viewer unchanged.

The viewer loads `../assets/fonts/inter.css`, preloads regular Inter, and shares the
Expand All @@ -61,7 +62,7 @@ keep their SVG coordinate sizes.

SVG exports embed the local regular and italic Inter files with the same optical
settings; PNG and WebM exports render from those prepared fonts. After regeneration,
check theme switching, search, tracing, keyboard controls, responsive layout, and
check search, tracing, keyboard controls, responsive layout, and
export. The complete build also verifies the viewer's production security policy and
local assets.

Expand Down
28 changes: 26 additions & 2 deletions architecture/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4978,6 +4978,29 @@
.toolbar > button, .toolbar > .preset-wrap, .toolbar > .export-wrap { min-width: 0; }
.toolbar button { max-width: 100%; white-space: normal; }
.diagram-container { container: diagram / inline-size; }
.site-return {
display: inline-flex;
min-height: 44px;
align-items: center;
gap: 10px;
margin-bottom: 1rem;
color: var(--text);
font-size: var(--type-interface);
line-height: var(--interface-leading);
text-decoration: underline;
text-decoration-color: var(--text-dim);
text-decoration-thickness: 1px;
text-underline-offset: 0.18em;
}
.site-return svg {
flex: 0 0 16px;
width: 16px;
min-width: 0;
height: 16px;
transform: none;
transition: none;
}
html[data-embed="true"] .site-return, html[data-present="true"] .site-return { display: none; }

@container viewer (width < 60rem) {
html:not([data-embed="true"]):not([data-present="true"]) .toolbar {
Expand Down Expand Up @@ -5077,7 +5100,7 @@
}
body { background: var(--bg); }
#btn-theme, #btn-preset, .preset-wrap { display: none !important; }
.pulse-dot, .card-dot { background: var(--text) !important; box-shadow: none !important; }
.pulse-dot, .card-dot { display: none !important; }
*:not(.pulse-dot):not(.motion-control-dot) { border-radius: 0 !important; }
</style>
</head>
Expand Down Expand Up @@ -5183,6 +5206,7 @@
<div class="container">
<!-- Header -->
<div class="header">
<a class="site-return" href="/" data-site-return><svg aria-hidden="true" focusable="false" viewBox="0 0 16 16" width="16" height="16" fill="none"><path d="M13 8H3m0 0 4-4M3 8l4 4" stroke="currentColor" stroke-width="1.25" stroke-linecap="round" stroke-linejoin="round"/></svg>Return Home</a>
<div class="header-row"
data-preset-badge-signal-flow="SIGNAL FLOW"
data-preset-badge-blueprint="BLUEPRINT / REV 01"
Expand Down Expand Up @@ -5681,7 +5705,7 @@ <h2>Focused Interactions</h2>
</div>
<ul>
<li>&bull; Clarinet hero, navigation, contents, article figures, table and figure zoom, and note previews</li>
<li>&bull; Architecture search, themes, tracing, and export</li>
<li>&bull; Architecture search, tracing, and export</li>
</ul>
</div>
</div>
Expand Down
2 changes: 1 addition & 1 deletion architecture/site.json
Original file line number Diff line number Diff line change
Expand Up @@ -251,7 +251,7 @@
"title": "Focused Interactions",
"items": [
"Clarinet hero, navigation, contents, article figures, table and figure zoom, and note previews",
"Architecture search, themes, tracing, and export"
"Architecture search, tracing, and export"
]
}
]
Expand Down
26 changes: 16 additions & 10 deletions docs/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,9 +96,10 @@ prose to the reading track. Structural column guides are decorative, hidden from
assistive technology, and omitted on phones. A guide meets the content edge it marks at
every width; the closing guide on tablets sits on the last column's end. Every page
title starts 112px below the top of the content field on desktop and 52px below the
header on phones. A page title keeps to four fifths of its column (`--title-width`);
at 540px and below it takes the whole column, so a long title holds a few balanced
lines on a phone.
header on phones; the rail's wordmark starts at the same 112px (`--content-top`), so it
sits on the title's line. A page title keeps to four fifths of its column
(`--title-width`); below 1024px it takes the whole column, so a long title holds a few
balanced lines on tablets and phones.

The rail's minimum width follows the interface type size, indent, padding, and
scrollbar allowance, so the rail, reading field, and guides reflow together when text
Expand Down Expand Up @@ -240,9 +241,10 @@ with its logic diagram under the record strip.
AI pages present the scope disclosure, Problem and Approach, Key Contributions, and the
numbered manuscript chapters. Selected Research headers hold the title, GitHub link, and
Full Manuscript link; reading begins at Abstract, and appendices and supporting material
link to the pinned manuscript on GitHub. Chapter headings display Roman numerals and
subsections letters in reading order, while source numbering and anchors stay intact;
verified internal section references link to their headings. The three manuscripts link
link to the pinned manuscript on GitHub. AI and Selected Research headings show the
manuscript's own numbers (1., 2.1, 7.3.), so "Section 5", "(5.1)" and "Appendix A.5" in
the text match what the reader sees; legal articles keep their manuscripts' Parts (I.,
A.). Anchors stay intact, and verified internal section references link to their headings. The three manuscripts link
their own references alike: an equation by its parenthesized number, a statement, table,
or figure by its number. The dependence manuscript carries these links from its TeX
source; the Asian and Rough Heston manuscripts cite in plain text, and each reference to
Expand Down Expand Up @@ -306,7 +308,8 @@ Each AI and legal article opens with a `LogicDiagram`, its visual abstract, draw
`app/lib/content/architecture-diagrams.ts`. Four stages read left to right, each holding
one node or one node per lane, with an optional feedback loop to an earlier stage.
Stage labels sit on short rules with blue ticks; nodes are flat panels with a 1px
border, and the stage holding the decisive mechanism is set in ink. Connectors are CSS
border, and the stage holding the decisive mechanism is set in ink. A lane's name above a
node title is in the label role of the diagram's one face. Connectors are CSS
on the same grid as the nodes; the loop is the one blue path, labeled beneath. Node
details accept inline TeX. Below 640px of figure width the diagram becomes a vertical
sequence (parallel nodes side by side from 480px) and the loop a labeled return note.
Expand All @@ -331,8 +334,10 @@ Text is HTML at its true size, so labels stay legible at every width; only curve
in a stretched SVG layer whose strokes keep their width, and schematics scale uniformly
so arrows and angles keep their shape. Labels sit in open space beside the marks they
name and never cover a curve. Bar rows align on one grid; in a narrow figure each label
shares a line with its value above a full-width bar. A title stands alone on its line,
with any view switch beneath it as one segmented control.
and its value stand above a full-width bar, and the grid and reference rules run through
the bar's own row only. A comparison wider than its column scrolls sideways and fades at
its right edge, as a wide table does. A title stands alone on its line, with any view
switch beneath it as one segmented control.

A segmented switch swaps views, a readout follows the pointer on line charts, marks
show exact values, the proof-obligation graph accepts a chosen failure, and each figure
Expand Down Expand Up @@ -483,4 +488,5 @@ keyboard use, enlarged text, reduced motion, and pages without JavaScript. Use t
shared tokens in `app/globals.css`, focused CSS Modules for local surfaces, and semantic
HTML, and match the existing type, measure, and spacing before adding a new pattern. The
[architecture viewer](../architecture/) is a technical reference drawn in the site's
palette: paper, ink and hairlines, square corners, one theme.
palette: paper, ink and hairlines, square corners, one theme, no bullets before titles,
and the site's Return Home link above its title.
47 changes: 28 additions & 19 deletions docs/maintenance.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Paths below are relative to `website/`.
| Experience | `content/experience-showcase.json`; AI fields are generated from the manuscript below | `app/lib/content/experience-showcase.ts` | `/experience/`, `/experience/[slug]/` |
| AI research | `content/sources/ai-portfolio/ai-research-and-engineering.md` | `scripts/import-ai-portfolio.mjs`, `app/lib/content/ai-projects.ts` | `/experience/[slug]/` |
| Selected Research | `content/sources/selected-research/` (pinned manuscripts), `content/selected-research/` (generated articles) | Research import scripts, `app/lib/content/selected-research.ts` | `/[paper]/` |
| Legal research | `content/legal-papers/` structured manuscripts | `app/lib/content/legal-papers.ts` | `/experience/[slug]/` |
| Legal research | `content/legal-papers/` structured manuscripts, generated from the LAW repositories | `app/lib/content/legal-papers.ts` | `/experience/[slug]/` |
| Blog | `content/blog/<slug>.md`, images in `public/assets/blog/<slug>/` | `app/lib/content/blog.ts` | `/blog/`, `/blog/[slug]/` |
| Architecture | `../architecture/site.json` | Archify and `scripts/integrate-architecture.mjs` | `/architecture/` |

Expand All @@ -61,8 +61,8 @@ Every URL belongs to About (`/`, `/coursework/`, `/[paper]/`), Experience
or a detail page from its category. The export holds the content
routes (About, Coursework, three Selected Research articles, Experience and its eighteen
entries, Blog, and one page per post), the architecture viewer, and the 404 page. A work that a
post presents is published on this domain at its own address named after the work, as
The Étude Sky is at `/etude-sky/`.
post presents is published on this domain at its repository's address, as
The Étude Sky is at `/BLOG-Etude-Sky/`.

### Blog

Expand Down Expand Up @@ -116,7 +116,7 @@ The three papers use pinned research inputs and deterministic importers:

| Paper | Input and importer | On-site scope |
| --- | --- | --- |
| Critical Dependence Stress for Diversification Gains under Fixed Marginals | `content/sources/selected-research/dependence/`; `scripts/import-dependence-research.mjs` | Abstract, chapters 1–5, references, and supporting-material links |
| Critical Dependence Stress for Diversification Gains under Fixed Marginals | `content/sources/selected-research/dependence/`; `scripts/import-dependence-research.mjs` | Abstract, chapters 1–5 with their four figures, references, and supporting-material links |
| Certified Valuation of Arithmetic Asian Options | `content/sources/selected-research/asian-source.md` and the study results in `asian-studies/`; `scripts/import-selected-research.mjs` | Abstract, chapters 1–9 with their four figures, references, and supporting-material links |
| Certified Joint Pricing Errors in Rough Heston | `content/sources/selected-research/rough-source.md` and the saved banks in `rough-studies/`; `scripts/import-selected-research.mjs` | Abstract, chapters 1–8 with their four figures, references, and supporting-material links |

Expand Down Expand Up @@ -157,15 +157,20 @@ return to the corresponding About research entry.
### Legal research

`content/legal-papers/` preserves source titles, authors, dates, Abstracts, chapter
hierarchies, paragraph runs, citations, acknowledgments, and numbered footnotes.
The approved source PDFs are external inputs, not served downloads:
hierarchies, paragraph runs, tables with their captions, citations, acknowledgments, and
numbered footnotes. Each file is generated by `site_legal_sync.py` from the manuscript in
its LAW repository, which is the authority for the text; the converter sets the
footnotes' small-caps fields in true small caps:

| Structured manuscript | Source PDF |
| Structured manuscript | Source repository and manuscript |
| --- | --- |
| `who-may-choose-the-lesser-risk.json` | `ESSAY1.pdf` |
| `small-states-and-the-governance-of-strategic-space-dependence.json` | `ESSAY2.pdf` |
| `autonomous-authority-in-space.json` | `ESSAY3.pdf` |
| `mangrove-restoration-and-the-limits-of-compensatory-mitigation.json` | `ESSAY4.pdf` |
| `autonomous-authority-in-space.json` | `130U/LAW-Autonomous-Authority-in-Space`, `manuscript/autonomous-authority-in-space.md` |
| `small-states-and-the-governance-of-strategic-space-dependence.json` | `130U/LAW-Small-States-and-the-Governance-of-Strategic-Space-Dependence`, `manuscript/small-states-and-the-governance-of-strategic-space-dependence.md` |
| `who-may-choose-the-lesser-risk.json` | `130U/LAW-Who-May-Choose-the-Lesser-Risk`, `manuscript/who-may-choose-the-lesser-risk.md` |
| `mangrove-restoration-and-the-limits-of-compensatory-mitigation.json` | `130U/LAW-Mangrove-Restoration-and-the-Limits-of-Compensatory-Mitigation`, `manuscript/mangrove-restoration-and-the-limits-of-compensatory-mitigation.md` |

Change wording in the repository and regenerate the file; then refresh
`content/protected-sources.json` and the visible-copy manifest.

`PaperParagraph.text` must equal the concatenated run text. Preserve emphasis,
capitalization, superscripts, unique chapter anchors, and sequential notes.
Expand Down Expand Up @@ -194,7 +199,7 @@ Article figures live in `app/components/figures/`: `kit.tsx` holds the frame, sc
plot, schematic and bar primitives, `selected-research.tsx`, `ai-research.tsx` and
`legal-research.tsx` hold the figures, `dependence-manuscript.tsx` draws the dependence
manuscript's four figures from the formulas in `130U/RESEARCH-Critical-Dependence-Stress-for-Diversification-Gains-under-Fixed-Marginals`
(`code/generate_mechanism_figures.py` and `calculations/plot_profiles_and_flows.py` at
(`computation/code/generate_mechanism_figures.py` and `computation/calculations/plot_profiles_and_flows.py` at
the pinned commit), `asian-manuscript.tsx` draws the Asian manuscript's four figures
from its imported study results and from Proposition 4.1 as
`app/lib/content/asian-kink-bound.ts` evaluates it, `rough-manuscript.tsx` draws the
Expand Down Expand Up @@ -297,18 +302,22 @@ files for credentials, temporary files, and unintended generated output.
The workflow validates pull requests with read-only repository access. A push to
`main` runs validation and the dependency audit, uploads `website/out/`, and deploys
with Pages write and OIDC permissions confined to the deployment job. Every action
is SHA-pinned. After publishing, verify the workflow for the exact commit and read
back the live routes separately.
is SHA-pinned. A newer pull-request run cancels the older one; production runs queue,
so a deployment in progress always completes. After publishing, verify the workflow
for the exact commit and read back the live routes separately.

Review the repository's Dependabot alerts, secret scanning, and push-protection
settings when maintaining a release. The workflow's dependency audit checks the
installed lockfile on every build.

Each exported HTML page receives hashes for its exact inline scripts before any
script executes. Production CSP blocks arbitrary inline scripts, eval, inline event
handlers, embedded frames/objects, and form submission; fonts and network fetches
use the same origin. Inline styles support framework and viewer geometry.
handlers, embedded frames/objects, media, and form submission; fonts, images, and
network fetches use the same origin, and only the architecture viewer adds the data and
blob images its exports draw. Inline styles support framework and viewer geometry.
Formulas are rendered at build time; a formula that sets a link, style, or class
attribute stops the build.
GitHub Pages controls HTTP response headers: a meta policy cannot enforce
`frame-ancestors` or supply host-level security headers. Keep the lockfile, pinned
dependencies, and scoped overrides aligned. An advisory check is current only when
the npm endpoint returns a successful result.
`frame-ancestors` or supply host-level security headers. Keep the lockfile and pinned
dependencies aligned. An advisory check is current only when the npm endpoint returns
a successful result.
Loading