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
53 changes: 53 additions & 0 deletions docs/UI_MAP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Universal Law reader UI map

Source reconnaissance by OpenAI/Codex, 25 October 2026, based on Main `105ced0b74b3212d1340eab057e3bd6fbd9ec398` and the reader navigation polish. This map describes presentation structure; it makes no scientific, AT, deployed-site or browser-verification verdict. Changes and verification are tracked in the separate [edit checklist](superpowers/plans/2026-10-25-reader-polish.md).

## Routes and reader regions

The public entry is `/site/` under a server whose root is `docs`. `docs/index.html` is the outer entrance. Ten public HTML pages share the brand header, Primary navigation, Research tools row, generated current-source disclosure, and full footer site map. Header destinations are Home → `index.html`, Explore → `explore.html`, Research → `research.html`, Library → `workspace.html#inventory`, Mathematics → `dependencies.html#current-atlas`. The tools row links Reproduce and Cite. Header/footer HTML is repeated per page rather than generated by a runtime component.

| Route | Main visible regions / preserved destinations | Main page styles after `style.css` |
|---|---|---|
| `index.html` | Hero/landscape illustration, `#the-idea`, current-source panel, `#discover`, `#questions`, `#about`; legacy `#inventory`, `#board`, `#coefficient`, `#contribute` redirect to Workspace via `home.mjs` | `home.css`, `brand.css`, `current.css` |
| `explore.html` | Intro/lesson links, curvature control/result `#peaks`, current-source panel, pin lesson `#distance`, finite grouping `#groups`, next routes | `explore.css`, `brand.css`, `current.css` |
| `research.html` | Editorial-date hero, question cards `#reading-questions`, current-source panel, `#reading-guide` and `#reading-archive` disclosures; dated cuts and introductory paths `#lifetimes`, `#peaks`, `#neighbors`, `#finite` remain fragment targets | `home.css`, `brand.css`, `current.css` |
| `workspace.html` | Hero/local routes, current-source panel, searchable catalog `#inventory`, dated `#board`, exact `#coefficient`, `#contribute` | `brand.css`, `current.css` |
| `measure.html` | Explore breadcrumb, teaching model and normalization/error controls, current-source panel | `explore.css`, `brand.css`, `current.css` |
| `reproduce.html` | Research breadcrumb, replay hero, current-source panel, `#run`, `#output`, scope/source material | `brand.css`, `home.css`, `reference.css`, `current.css` |
| `cite.html` | Research breadcrumb, citation hero, current-source panel, `#choose`, `#identity`, `#reference-builder` | `brand.css`, `home.css`, `reference.css`, `current.css` |
| `museum.html` | Research breadcrumb, source-record intro/outline, current-source panel, `#exhibits`, `#claims`, `#conditionals`, `#replay`, `#packets` | `museum.css`, `brand.css`, `current.css` |
| `formal.html` | Research breadcrumb, snapshot/scope intro, current-source panel, `#formal-coverage`, `#formal-since`, source material | `museum.css`, `brand.css`, `current.css` |
| `dependencies.html` | Mathematical Atlas `#current-atlas`, current-source panel, preserved dependency viewer `#dependency-archive`; static current node/source entry at `nodes/index.html` and `nodes/*.html` | `brand.css`, `dependencies.css`, `current.css`, `atlas-layout.css` |

Atlas spatial work is separately owned by active PR613; this reconnaissance supplies no competing spatial implementation or recommendation. Snapshot node trees under `snapshots/<identity>/nodes/` preserve their own source identities.

## Presentation ownership and cascade

`docs/BRAND_STYLE.md` defines the approved navy/blue/gold identity, existing fonts, literal scope labels and distinct evidence-border patterns. `brand/tokens.json` records colors; `brand.css` owns variables, light/dark colors, focus, reduced-motion, forced-colors and print treatment. `style.css` is the legacy global structural base and reset. Later, more specific brand rules intentionally override it.

The compact shared reader shell lives in `brand.css`. Its `:is(.reader-shell, body)` header/tools selectors cover supporting pages even without `.reader-shell`; `.reader-shell` content rules apply to Home, Explore, Research and Workspace. Header and tool links use at least 44px targets. Footer navigation uses three named parent groups, each with a nested `.site-map-links` list. Desktop has three columns; below 640px the first two groups share a row and Records/tools occupies a two-column row beneath. Print returns to compact inline links. The Home footer additionally uses `home.css` for its identity/two-column layout and mobile stacking. Reader media rules stack the header and compact content at 800px; below 360px the five primary links form three/two rows. Earlier 640px and 950px brand rules still apply where later selectors do not override them. `home.css` also has 800px and 440px rules; `current.css` has a 720px Atlas fallback.

The common generated source block is `<!-- CURRENT-SITE:START -->…END`. Its compact disclosure styling lives in the `.current-research-compact` rules of `brand.css` with deliberately higher specificity because `current.css` loads afterward. `current.css` also contains Atlas/source-node styles, so a generic source-panel change can affect those views. `atlas-layout.css` loads last on Dependencies and owns its newer workbench layout. `explore.css`, `museum.css`, `dependencies.css` and `reference.css` retain page-specific layouts.

`reader-shell.mjs` only manages native disclosure visibility for preserved hash targets; it does not build navigation, replace history or change focus. `home.mjs` handles the legacy home section redirects. Normal navigation remains native links; the full footer map is available without JavaScript. Old source-bound IDs, dates, source pins, refusal text and status labels are deliberate content boundaries.

## Local viewing and existing browser entry points

From the source checkout, a local static server is:

```sh
python3 -m http.server 8000 --directory docs
```

Open `http://localhost:8000/site/`. The documented browser suite uses Python Playwright dependencies pinned in `tests/browser-requirements.txt`, packaged Chrome and a real sandbox:

```sh
python3 -B tools/public_shop_browser_check.py --output /workspace/research/reader-polish-20261025/public-shop-browser
python3 -B tools/current_site_browser_check.py --output /workspace/research/reader-polish-20261025/current-browser
```

The public-shop harness covers 1200×900 and 390×844 light/dark entries, reader navigation/history, keyboard focus, source refusals and overflow; additional layout cases use 1280px, 390px and 320px. It records browser executable/version/hash and checkout identity. Its packaged executable is `/opt/google/chrome/chrome`; scratch Chromium adaptation must retain the exact harness change and executable/sandbox setting as documented in `docs/site/README.md:220`. A modified local harness is local evidence, not the official CI replay. Screenshots still require visual inspection. The current-site browser harness is Atlas-oriented and is not necessary to duplicate during this reader reconnaissance.

Focused existing source tests include `tests/test_reader_experience.mjs`, `tests/test_reader_navigation.mjs`, `tests/test_workspace_navigation.mjs`, `tests/test_public_shop_frontend.mjs`, `tests/test_brand_identity.mjs`, and `tests/test_reader_links.py`. Required release/public-shop commands remain in `docs/site/README.md:33`; after site changes the release tool must run before its `--check`, and every rewritten importer must be included. Fresh captures, source-preservation evidence and verification results are recorded separately from this structural map.

Applicable onboarding records: `AGENTS.md`, `docs/site/AGENTS.md`, `governance/OWNER_MANDATE_20261015.md`, `governance/OP-AUTONOMY-20260923-v2.1.md`, `governance/OWNER_DECISION_20261025_REVIEW_FAMILIES.md`, and `governance/OP-WORKFLOW-20260930.md`. A separate same-family engineering review is permitted; scientific review requires a different model family and is outside this map's scope.
33 changes: 26 additions & 7 deletions docs/site/brand.css
Original file line number Diff line number Diff line change
Expand Up @@ -232,8 +232,25 @@ a:focus-visible, button:focus-visible, input:focus-visible, select:focus-visible
/* Shared footer site map: every route from every page without script; undoes style.css nav{display:flex;font-weight:650}. */
.site-map { display: block; font-weight: 400; font-size: 13px; margin-top: 18px; padding-top: 14px; border-top: 1px solid var(--ul-border); }
.site-map ul { list-style: none; margin: 0; padding: 0; }
.site-map li { margin: 6px 0; }
.site-map strong { color: var(--ul-text); margin-right: 6px; }
.site-map > ul { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 24px 40px; }
.site-map > ul > li { margin: 0; min-width: 0; }
.site-map strong { display: block; color: var(--ul-text); font-size: 12px; margin-bottom: 8px; }
.site-map .site-map-links li { margin: 0; }
.site-map .site-map-links a { display: flex; align-items: center; min-height: 44px; margin: 0; padding: 6px 0; font-size: 14px; line-height: 1.5; overflow-wrap: anywhere; }
@media (max-width: 640px) {
.site-map > ul { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 24px 20px; }
.site-map > ul > li:last-child { grid-column: 1 / -1; }
.site-map > ul > li:last-child > .site-map-links { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0 20px; }
}
@media print {
.site-map > ul { display: block; }
.site-map > ul > li { margin: 8px 0; }
.site-map strong { display: inline; margin-right: 6px; }
.site-map .site-map-links, .site-map > ul > li:last-child > .site-map-links { display: inline; }
.site-map .site-map-links li { display: inline; }
.site-map .site-map-links li + li::before { content: " · " / ""; }
.site-map .site-map-links a { display: inline; min-height: 0; padding: 0; font-size: inherit; }
}

/* Lesson/reading-path links, shared by Explore, Measure and the Research hero (moved from explore.css: measure.html loads explore.css before brand.css). */
.lesson-links { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); margin-top: 25px; gap: 16px; }
Expand Down Expand Up @@ -279,10 +296,10 @@ h1 { overflow-wrap: anywhere; }
:is(.reader-shell, body) .brand::before { width: 32px; height: 32px; top: 3px; }
:is(.reader-shell, body) .brand span { font-size: 10px; letter-spacing: .14em; }
:is(.reader-shell, body) > header nav { gap: 6px 22px; }
:is(.reader-shell, body) > header nav a { margin: 0; padding: 0; font-size: 13px; }
:is(.reader-shell, body) > header nav a { margin: 0; padding: 0; min-width: 44px; font-size: 13px; }
:is(.reader-shell, body) > header nav a[aria-current=page] { color: var(--ul-link); }
:is(.reader-shell, body) > .reader-tools { max-width: 1280px; padding: 0 36px; gap: 20px; }
:is(.reader-shell, body) > .reader-tools a { min-height: 36px; font-size: 12px; }
:is(.reader-shell, body) > .reader-tools a { min-height: 44px; min-width: 44px; font-size: 12px; }
:is(.reader-shell, body) .reader-tools-label { font-size: 10px; letter-spacing: .13em; }
.reader-shell main { max-width: 1200px; }
.reader-shell section { padding: 44px 0; }
Expand Down Expand Up @@ -358,7 +375,7 @@ h1 { overflow-wrap: anywhere; }
@media(max-width: 800px) {
:is(.reader-shell, body) > header { align-items: flex-start; flex-direction: column; padding: 14px 20px 8px; gap: 8px; }
:is(.reader-shell, body) > header nav { width: 100%; justify-content: space-between; gap: 4px 10px; }
:is(.reader-shell, body) > header nav a { font-size: 12px; min-height: 42px; }
:is(.reader-shell, body) > header nav a { font-size: 12px; min-height: 44px; }
:is(.reader-shell, body) > .reader-tools { padding: 0 20px; gap: 18px; }
.reader-shell main { padding: 0 20px; }
.reader-shell section { padding: 32px 0; }
Expand Down Expand Up @@ -401,7 +418,9 @@ h1 { overflow-wrap: anywhere; }
@media(max-width: 359px) {
.reader-shell main { padding: 0 16px; }
:is(.reader-shell, body) > header { padding-inline: 16px; }
:is(.reader-shell, body) > header nav { gap: 0 8px; flex-wrap: wrap; justify-content: flex-start; }
:is(.reader-shell, body) > header nav { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 0 8px; }
:is(.reader-shell, body) > header nav a { grid-column: span 2; justify-content: center; }
:is(.reader-shell, body) > header nav a:nth-child(n + 4) { grid-column: span 3; }
.reader-shell h1, .reader-shell .home-hero h1 { font-size: 38px; }
.reader-shell .home-hero .actions .button { width: 100%; }
.reader-shell .lesson-links.four-up { grid-template-columns: minmax(0,1fr); }
Expand All @@ -427,7 +446,7 @@ h1 { overflow-wrap: anywhere; }
@media print {
:root { color-scheme: light; --ul-background: #ffffff; --ul-surface: #ffffff; --ul-raised: #f4f4f4; --ul-text: #111111; --ul-muted: #333333; --ul-link: #17314f; --ul-gold: #61480d; --ul-border: #999999; --ul-accept: #14634d; --ul-amend: #874608; --ul-error: #9c2c3a; --ul-engineering: #526179; --ul-edge: #6a7e96; --ul-focus: #10558d; --ul-button: #17314f; --ul-buttonText: #ffffff; }
body { background: #ffffff; color: #111111; }
.actions, .skip-link, body > header nav, .reader-tools, button, button.button, #more, input[type="search"]:placeholder-shown, .page-outline { display: none; }
.actions, .skip-link, :is(.reader-shell, body) > header nav, .reader-tools, button, button.button, #more, input[type="search"]:placeholder-shown, .page-outline { display: none; }
label:has(+ input[type="search"]:placeholder-shown) { display: none; } /* its own rule: a browser without :has() drops only this one */
section { padding: 24px 0; }
a { color: #17314f; text-decoration: underline; }
Expand Down
4 changes: 2 additions & 2 deletions docs/site/cite.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta name="description" content="Cite exact proofs, calculations and software sources with their real metadata, immutable commits and stated scope.">
<meta http-equiv="Content-Security-Policy" content="default-src 'self'; connect-src 'self'; style-src 'self'; script-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; form-action 'none'">
<title>Cite · Universal Law</title>
<link rel="stylesheet" href="style.css?site-release=6eb56e5c80ebf5811a77d0cb8583bf77dd8be44f170bebc9ae10721b2e6e9ab1"><link rel="stylesheet" href="brand.css?site-release=bcc96c00cf52da560f9ba5c565762a67d6d93b96efdbe7d76973ee0eb352044f"><link rel="stylesheet" href="home.css?site-release=3745da1d9ea12f78ef0e350eb982d603d5e476db0b4cbf36746104a13fbf663e"><link rel="stylesheet" href="reference.css?site-release=f8709329ef33be5c92a2a53d27e906f2433836bc0a78324bfb8a15ecd2ffee48"><link rel="icon" type="image/svg+xml" href="brand/mark.svg?site-release=ef97bd43ea3d8999dbf26e5707d467987a745bf961cac2b3163f94062d087ba7"><meta name="color-scheme" content="dark light"><meta name="theme-color" media="(prefers-color-scheme: light)" content="#f6f8fc"><meta name="theme-color" media="(prefers-color-scheme: dark)" content="#07111f">
<link rel="stylesheet" href="style.css?site-release=6eb56e5c80ebf5811a77d0cb8583bf77dd8be44f170bebc9ae10721b2e6e9ab1"><link rel="stylesheet" href="brand.css?site-release=5394863b316a477063ff357fce9654bfb48c3190f6880a518ad95db5b888aad3"><link rel="stylesheet" href="home.css?site-release=3745da1d9ea12f78ef0e350eb982d603d5e476db0b4cbf36746104a13fbf663e"><link rel="stylesheet" href="reference.css?site-release=f8709329ef33be5c92a2a53d27e906f2433836bc0a78324bfb8a15ecd2ffee48"><link rel="icon" type="image/svg+xml" href="brand/mark.svg?site-release=ef97bd43ea3d8999dbf26e5707d467987a745bf961cac2b3163f94062d087ba7"><meta name="color-scheme" content="dark light"><meta name="theme-color" media="(prefers-color-scheme: light)" content="#f6f8fc"><meta name="theme-color" media="(prefers-color-scheme: dark)" content="#07111f">
<script type="module" src="cite.mjs?site-release=d069bacebd8467fb69c0ae1de0abb85e6ac8b9b80ba152fc1c8d56fafa10e9bf"></script>
<link rel="stylesheet" href="current.css?site-release=9b70fee7f54345912905f33f4d15af39748b09c456bd88527b534cc9ceaae207">
<script type="module" src="current.mjs?site-release=fc7e8a98c1e23f476962c4c83e95ed3ce817490007987112d9b2cf6d3d90b142"></script>
Expand Down Expand Up @@ -52,4 +52,4 @@ <h2>Source observation</h2>
<noscript><section><h2>Build a source link without JavaScript</h2><p>Open the file on GitHub, press <kbd>y</kbd> to switch to its commit permalink, then copy the URL. Include the source’s authorship and review scope in your reference.</p></section></noscript>
<section><h2>Reuse with the source’s terms.</h2><p>This website repository carries an <a href="https://github.com/d6g8k5htny-coder/main/blob/main/LICENSE">MIT license</a>. That license is not a blanket grant for linked repositories or imported third-party sources. Math- carries its <a href="https://github.com/d6g8k5htny-coder/Math-/blob/main/LICENSE">own license file</a>, with an attribution note for material of unknown authorship. Check the object’s own license and attribution before reuse.</p><p><a href="https://github.com/d6g8k5htny-coder/main/blob/main/docs/REPOSITORY_STANDARDS.md">How the repository conventions were chosen</a> · <a href="https://github.com/d6g8k5htny-coder/main/blob/main/CONTRIBUTING.md">Corrections and contributions</a></p></section>
</main>
<footer><p><a href="index.html">Home</a> · <a href="reproduce.html">Reproduce</a> · <a href="cite.html">Cite</a> · <a href="workspace.html">Library (research workspace)</a> · <a href="workspace.html#contribute">Contribute</a></p><nav class="site-map" aria-label="All pages"><ul><li><strong>Learn</strong> <a href="index.html">Home</a> · <a href="explore.html">Explore</a> · <a href="measure.html">From counts to density</a></li><li><strong>Research</strong> <a href="research.html">Research</a> · <a href="museum.html">Source records</a> · <a href="dependencies.html">Claim dependencies</a> · <a href="formal.html">Formal verification</a></li><li><strong>Records and tools</strong> <a href="workspace.html#inventory">Library</a> · <a href="workspace.html#board">Status snapshot</a> · <a href="workspace.html#coefficient">Exact coefficients</a> · <a href="reproduce.html">Reproduce</a> · <a href="cite.html">Cite</a> · <a href="workspace.html#contribute">Contribute</a> · <a href="https://github.com/d6g8k5htny-coder/main">GitHub</a></li></ul></nav></footer></body></html>
<footer><p><a href="index.html">Home</a> · <a href="reproduce.html">Reproduce</a> · <a href="cite.html">Cite</a> · <a href="workspace.html">Library (research workspace)</a> · <a href="workspace.html#contribute">Contribute</a></p><nav class="site-map" aria-label="All pages"><ul><li><strong>Learn</strong><ul class="site-map-links"><li><a href="index.html">Home</a></li><li><a href="explore.html">Explore</a></li><li><a href="measure.html">From counts to density</a></li></ul></li><li><strong>Research</strong><ul class="site-map-links"><li><a href="research.html">Research</a></li><li><a href="museum.html">Source records</a></li><li><a href="dependencies.html">Claim dependencies</a></li><li><a href="formal.html">Formal verification</a></li></ul></li><li><strong>Records and tools</strong><ul class="site-map-links"><li><a href="workspace.html#inventory">Library</a></li><li><a href="workspace.html#board">Status snapshot</a></li><li><a href="workspace.html#coefficient">Exact coefficients</a></li><li><a href="reproduce.html">Reproduce</a></li><li><a href="cite.html">Cite</a></li><li><a href="workspace.html#contribute">Contribute</a></li><li><a href="https://github.com/d6g8k5htny-coder/main">GitHub</a></li></ul></li></ul></nav></footer></body></html>
Loading
Loading