--- title: MD Viewer History · the recurring ask, the recurring build kind: index · meta-log captured: 2026-05-23 captured_by: Claude · responding to captain's "wrap all those into one HTML page" question back_reference: ../_ops/AGENT-PRE-FLIGHT.md # §3 "Never ship raw MD — pipe through the viewer skin" parent_brief: ../_ops/BRIEF-OMPHALOS-001.md principle_honored: - AGENT-PRE-FLIGHT §1 (find the existing grammar before inventing) - AGENT-PRE-FLIGHT §3 (never ship raw MD — pipe through the viewer skin) - AGENT-PRE-FLIGHT §4 (frontmatter back-reference) trigger: captain uploaded `_ops/OMPHALOS-kernel-cornerstones-foundry.md` and asked "did you already tell me how to open this doc in _ops in a browser?" --- # MD VIEWER HISTORY > *"The captain does not read raw MD. Every artifact lands behind a viewer."* > — `_ops/AGENT-PRE-FLIGHT.md`, §3 This file is the consolidated audit trail of every chat where the captain asked for "MD-in-a-browser" and every artifact built to satisfy that ask. Compiled across ~150 sessions on 2026-05-23. The motif is so recurrent that it has become a structural rule — AGENT-PRE-FLIGHT §3. The deliverable is **this MD piped through the canonical cyrelium viewer skin** (`MASTER-CONTROL/build-viewer.py`). The viewer lives at `_ops/MD-VIEWER-HISTORY-000-viewer.html`. Opening this file as raw MD is itself the failure mode the file documents. --- ## ▸ 1 · The immediate question **Captain:** "did you already tell me how to open this doc in _ops in a browser?" (re: `OMPHALOS-kernel-cornerstones-foundry.md`) **Answer:** Not in this session. But the framework already has the answer — pre-stamped into AGENT-PRE-FLIGHT §3. The canonical path: 1. The doc lives at `~/Desktop/root/_ops/OMPHALOS-kernel-cornerstones-foundry.md`. 2. It is a symlink-adjacent companion to `OMPHALOS-KERNEL.md` → `shalaco.com/shalaco.com/OMPHALOS-KERNEL.md`, which already has a viewer: `_ops/omphalos.html` (also a symlink). 3. The standalone viewer is `_ops/omphalos.standalone.html` (105 KB, file:// works). 4. Launch via `_ops/launchers/launch-omphalos.command` (double-click). So the answer to "how do I open this in a browser" is: **double-click `launch-omphalos.command`** (or open `omphalos.standalone.html` directly). The kernel-cornerstones-foundry MD is read through that same viewer surface. The newer ask — "wrap the history of all my MD-in-browser asks into one HTML page" — is fulfilled by the viewer this file generates. --- ## ▸ 2 · Direct asks to view MD in a browser Chronological-ish. Format: *[session · date] — ask → built*. - **local_91dcce60 · 2026-05-19** — *Locate missing 12 breathing HTML file*. Where did the 12-breathing HTML go? → Located `aichemystprime.com/TWELVE_BREATHING/index.html`; handed back as one viewer link. - **local_a93b2aaf · 2026-05-17** — *Define and launch employee manager dashboard*. "GIVE ME ALL THE LOCALHOST LINKS AND A DIRECTORY TO FIND THEM WRAPPED IN HTML." → Localhost-links directory HTML inside `Wildfuturesadvancementgroup.com/BACKBONE/`. - **local_866a03da · 2026-05-18** — *Kickoff Mycelium MD project*. Substrate as MD on disk, launched via tincture files. → `~/Desktop/mycelium/mycelium.md` + tincture MDs with viewer-ready skeleton. - **local_a004dab5 · 2026-05-21** — *Workboard dashboard architecture*. "Create a node for that in AA according to the run man." → `MYCELIUM.md` in WFAG AA Annex (raw MD per AA convention — still expects viewer). - **local_b9237d62 · 2026-05-21** — *iCal sync task-event linking*. Hand off an MD brief; captain complained raw MD ships violated convention. → `_ops/BRIEF-OMPHALOS-001.md` + lexicon MDs, opened via existing viewer. - **local_7052473e · 2026-05-21** — *Hermetic business schema design*. Captain rebuke: "never ship raw MD — pipe through the viewer skin." → `ermeticbusinessservicesmanagement.local/viewer.html` (7 MD inlined) + the canonical `_ops/AGENT-PRE-FLIGHT.md` rule itself. - **local_befeb39a · 2026-05-21** — *Organize script file in directory*. Build a constellation reference resource page in HBS site grammar. → `hermeticbusinessservices.com/SANDBOX_CONSTELLATION/index.html` via symlinks. - **local_8e149221 · 2026-05-20** — *Integrate architecture frameworks into unified template*. Surface-reigns auto-page so seed pages self-describe. → `surface-reigns.html` + `surface-reigns.py` wired into ITERATE.sh. - **local_2364b613 · 2026-05-22** — *Link table of contents to chapters*. Per principle, add live and local URL pills. → Chapter-link rows wired into `Principia-Operandi.html`. - **local_ef14ba99 · 2026-05-22** — *Convert gravity chat into HTML webpage*. Convert chat MD to viewable HTML entry with PO grammar. → `spacetimecurvaturehurts.com/index.html` v1.1 with layer-mark paragraphs. - **local_2fd70804 · 2026-05-22** — *Build WFAG master control dashboard*. Build an iteration MD reader in cyrelium skin. → 127 KB iteration `viewer.html` via `build-iteration-viewer.py`. - **local_a18e2425 · 2026-05-22** — *Gate view bug fixes*. Clean up bugs in `Principia-Triskelion-Branchv001-ical/views/gate.html` (the cyrelium MD wrapper). → CSS grid blowout fix; logged in `THE-DRIFT.md`. - **local_ccbaad9c · 2026-05-23** — *Chat history and output review*. "i don't read md's we have wrappers and renderers" — captain rebuked raw-MD response. → Pointer back to `views/gate.html` cyrelium viewer. --- ## ▸ 3 · Tools / viewers built Format: *[session · date] — artifact → purpose*. - **local_6c6ee81f · 2026-05-22** — `~/Desktop/root/{Desktop-Project-Atlas,Meta-Map,Site-Constellation,The-Twelve,The-Constellation}.html` → HTML wrappers/atlases over the root project graph; paths repointed into `root/`. - **local_fc095572 · 2026-05-20** — `templates/treehouse/_absorb-root.py` + `root-orbit.cosmos.json` + treehouse `index.html` "absorb root's orbit" button → Pulls `The-Twelve.html` STARS/LINES into the treehouse viewer. - **local_551c91e1 · 2026-05-20** — `templates/sun/_metamap-to-nested.py` + `nested-corpus.{json,html}` → Nested viewer where leaves carry `→ open page` links to real on-disk pages. - **local_2fd70804 · 2026-05-22** — `build-iteration-viewer.py` importing `build()` from `MASTER-CONTROL/build-viewer.py` → 11-MD cyrelium iteration reader with j/k nav and radial overlay. - **local_7052473e · 2026-05-21** — `ermeticbusinessservicesmanagement.local/viewer.html` + `_ops/AGENT-PRE-FLIGHT.md` → Canonical viewer-per-project; "never ship raw MD" institutionalized as a §3 rule. - **local_a18e2425 · 2026-05-22** — `Principia-Triskelion-Branchv001-ical/views/gate.html` → The cyrelium MD viewer ("gate") wrapping THE-BUILD / THE-DRIFT / THE-ENQUIRY MDs; collision patched. - **local_a93b2aaf · 2026-05-17** — Localhost-links directory HTML + `Launch.command` scripts under WFAG BACKBONE → One HTML hub of all local viewers. - **local_7f125d41 · 2026-05-21** — `~/Desktop/root/05-21 Binge Report/index.html` + sibling `Launch.command` → 3-view (hierarchy / topography / star-map) report with sort + always-on TOC; file:// fallback inlines data. - **local_3a9c3848 · 2026-05-23** — `~/Desktop/root/_design-library/index.html` → Launcher page with chips/search over design resources. - **local_e026c4cc · 2026-05-23** — `MASTER-CONTROL/wfag-phase-ring.html` + symlink at `aichemystprime.com/wfag-phase-ring.html` → Region-as-segment viz over `computed.json`. - **local_866a03da → local_ef14ba99 · 2026-05-22** — `spacetimecurvaturehurts.com/index.html` + `entry.json` + `.htaccess` → PO-QUICKSTART layered MD-as-HTML entry. - **local_11212512 · 2026-05-15** — `seeds/corpus constellation cradle/index.html` w/ phase-1 hitbox + eclipse moon → Visual cradle viewer over corpus nodes. - **local_6c55b34c · 2026-05-12** — `speculumrecursum.com/THE_KICKOFF/index.html` + `SPECULUM_RECURSUM/index.html` → TULKU_STREAM-pattern dual-page (timeless statement + dated conversation viewer). - **local_50d5fc4d · 2026-05-19** — `Principia-Triskelion/views/tulku-stream.html` + `_brief-tulku-stream-view.md` → Genealogy-tree view sibling to `todo.html` viewer. - **local_a0c9b429 · 2026-05-22** — Stub-as-PO-entry pattern (HTML w/ `entry.json` + `.adotom.json` + APPLIED.md row) → Convert overreach tombstone into an architected MD-+-viewer node. - **local_befeb39a · 2026-05-21** — `hermeticbusinessservices.com/SANDBOX_CONSTELLATION/index.html` → Sandboxed reference-library HTML over MD entries with symlinks (no copy). - **local_8e149221 · 2026-05-20** — `seeds/PURUSHA/surface-reigns.html` + `surface-reigns.py` → Auto-enumerated reins / views / data page; ITERATE.sh keeps it fresh. - **local_2364b613 · 2026-05-22** — Chapter-link pills wired into `Principia-Operandi.html` → Live+local pairing pattern from MD chapter folders into the dashboard. - **local_e61a377a · 2026-05-22** — *Serve localhost on local network* → Scoped how `viewer.html` files get served (bind 0.0.0.0, `.local` Bonjour, Tailscale, Synology Container Manager for phase 2). --- ## ▸ 4 · Recurring patterns observed The motif resolves into a five-line structural rule, observable across every session above: 1. **Viewer-per-project.** Each project domain ships a `viewer.html` (or named equivalent: `gate.html`, `forge.html`, `surface-reigns.html`) that inlines its MD set and renders cyrelium-skinned with j/k nav + radial overlay. 2. **Canonical builder.** `MASTER-CONTROL/build-viewer.py` is the load-bearing template; per-project wrappers (`build-iteration-viewer.py`, `build-octo-viewer.py`, this file's `build-md-viewer-history.py`) import its `build()` rather than fork the 500-line CSS/JS. Enforces P3 ("the seed lives once"). 3. **The §3 rule.** "Never ship raw MD — pipe through the viewer skin" lives in `_ops/AGENT-PRE-FLIGHT.md` and is enforced retroactively in nearly every recent session. When the captain catches a raw `.md` path, the response is to retrofit a viewer on the spot. 4. **Three-pane wrapper convention.** Every viewer carries (a) inlined MD content, (b) live + local URL pills, (c) a back-reference / drift-log row — so the same HTML reads as document, navigator, and audit trail. 5. **Launch.command + localhost directory hub.** Most projects ship a per-folder `Launch.command` (Python `http.server` on a dedicated port); at the WFAG level a single localhost-links HTML directory acts as home base. file:// fallback (script-tag-inlined data) is built in so the same viewer also opens via double-click. Naming/symlink discipline (P3 again): `_principia`, `_ops`, `_design-library`, `_uber` are the standing input wells; viewers symlink to them rather than copy. --- ## ▸ 5 · Next legs - If the captain wants a single dashboard listing every viewer on disk (vs. this index of asks), call that out — that is a different artifact (`_ops/VIEWER-INDEX-000.html`) and should ride the same skin. - If the cornerstones-foundry MD wants its own dedicated viewer (vs. being read through `omphalos.standalone.html`), wrap it with `build-cornerstones-viewer.py` mirroring `build-octo-viewer.py`. - Consider promoting AGENT-PRE-FLIGHT §3 to a gate in `keystones.jsonl` — currently it's only catchable post-violation. --- *Generated by `_ops/build-md-viewer-history.py` via `MASTER-CONTROL/build-viewer.py`. Captured 2026-05-23.*