docs: mark TRIPOD/HERMES/ARTEMIS/CONSOLE.md superseded by FABRIC.md/FABRIC-2.md

Captain Bob ruled directly: all four subsystem docs are superseded, not
individually assessed for partial staleness case-by-case. FABRIC.md
(design history) and FABRIC-2.md (current/living) are the sole
design-of-record for Tripod/Hermes/Artemis/Console work now.

Added a superseded-header banner to the top of all four .claude/*.md
files, pointing to FABRIC.md/FABRIC-2.md. Corrected .claude/CLAUDE.md's
own pointer paragraph, which previously claimed these four were
individually "authoritative" for their subsystems - that's now wrong.

Closes FABRIC-2.md's three open documentation questions (CONSOLE.md's
fate, HERMES.md's stale block map, 5.3's larger shrink-the-docs ask) at
once: the header approach makes reconciling a superseded document's
internal accuracy moot, and accomplishes what "shrink to a pointer" was
already trying to do.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-15 09:26:59 -04:00
co-authored by Claude Sonnet 5
parent 00e657019e
commit c5442c8377
6 changed files with 78 additions and 41 deletions
+34 -38
View File
@@ -249,9 +249,11 @@ and recorded.
> done: the vocabulary-chain mechanics, the block-window cache, the hot-words cache —
> each flagged as its own project, not started.
- [ ] **5.3 — Shrink the subsystem documents.** `ARTEMIS.md`, `HERMES.md`, `CONSOLE.md`,
- [x] **5.3 — Shrink the subsystem documents.** `ARTEMIS.md`, `HERMES.md`, `CONSOLE.md`,
`TRIPOD.md` need trimming now that `FABRIC-2.md` (via `FABRIC.md`) is the design-of-record.
Not started. **Specific pending edit found within this item:** `TRIPOD.md`'s own Immediate
**CLOSED 2026-08-15 — see Section F.1 above:** Captain Bob ruled all four superseded
outright, not case-by-case; resolved via a superseded-header banner on each, not a
line-count trim. **Specific pending edit found within this item:** `TRIPOD.md`'s own Immediate
Goal section still describes Hera spawning Hermes and Artemis automatically at boot — item
0.1 undid that behavior, and the doc was never updated to match.
@@ -696,34 +698,28 @@ together. **F.3** is the condensed punch list distilled from both.
- [x] `tools/README.md`'s stale `fbtest.c` row → `ttftest.c`. Doc-only, no build impact.
Commit `b9e8fdc`.
**Needs Captain Bob's ruling — each already investigated as far as it can go without one:**
**RESOLVED 2026-08-15 — Captain Bob ruled directly, no per-document weighing needed:**
`TRIPOD.md`, `HERMES.md`, `ARTEMIS.md`, `CONSOLE.md` are **all** superseded — not
individually assessed for partial staleness, not a case-by-case rewrite-vs-header call.
`FABRIC.md`/`FABRIC-2.md` are the sole design-of-record for all Tripod/Hermes/Artemis/
Console work now. Fixed by adding a superseded-header banner (pointing here) to the top of
all four `.claude/*.md` files, and correcting `.claude/CLAUDE.md`'s own pointer paragraph
(previously claimed these four were individually "authoritative" — now redirects to
`FABRIC.md`/`FABRIC-2.md`). This closes all three items below at once:
- [ ] **`CONSOLE.md`'s fate** (item 5.3). Dated 2026-08-02, states outright "there is no
Console code in the tree yet" — no longer true in two ways: (1) its central design premise
(Console as a 4th Tripod VM, "Quadrupod not Tripod") was superseded by `FABRIC.md` §17.5's
later, decided ruling — framebuffer is a utility, not a patron, confirmed by grepping the
fleet machinery for a Console VM kind (zero hits); (2) its "explicitly out of scope" list
(no keyboard driver) is now false — `i8042.c` and `virtio_input.c` both exist and a
keyboard-to-REPL bridge is live (item 4.4v). Some content is still accurate (the Y-up
coordinate flip, stroke-font/TrueType glyph work) but was not re-verified line-by-line.
**Question for Bob:** full rewrite against `FABRIC.md` §17.5/§27 as the design-of-record,
or an explicit "superseded, kept for history" header on the existing document?
- [ ] **`HERMES.md`'s stale block map and cell-count table** (item 5.3). Its "Message
node — 8 cells" layout table contradicts the shipped capsule's own `9 CONSTANT MSG-CELLS`
(`capsules/hermes/init.4th`) — the real layout stores a Stadium cell index at offset 5 (not
raw heat) and adds an `ORIG-TYPE` field at offset 8 the doc doesn't mention. Separately its
"v1 Block Map — LOCKED" section lists only blocks 41004128; the actual capsule also has
4142, 41444159, 4175, 4176 — a substantial share of item 4.2's Stadium-integration content
isn't in the documented map at all. The doc closes with "if it conflicts with the codebase,
the codebase is wrong" — that claim doesn't hold here; the 9-cell layout is a deliberate,
intentional change the doc was never updated to match. **Question for Bob:** reconcile the
full map now, or defer — Hermes's own message layout may shift again once Artemis becomes a
live message endpoint, which argues for waiting.
- [ ] **5.3's larger ask** — actually shrinking `ARTEMIS.md`/`HERMES.md`/`CONSOLE.md`/
`TRIPOD.md`'s line counts now that `FABRIC.md`/`FABRIC-2.md` are the design-of-record, not
just fixing stale claims (`ARTEMIS.md` and `TRIPOD.md` already got that narrower fix).
Blocked on the two rulings above — can't shrink a document whose fate/content isn't settled
yet.
- [x] ~~`CONSOLE.md`'s fate~~ — superseded header added, no rewrite. Its architectural
reversal (VM-per-patron vs. direct-C-utility) is fully described in `FABRIC.md` §17.5,
which is now the pointer target — no need to re-derive that content into `CONSOLE.md`
itself.
- [x] ~~`HERMES.md`'s stale block map and cell-count table~~ — moot now that the document is
historical-only, not living: reconciling a superseded document's internal accuracy is not
useful work. The real, current block map lives in `capsules/hermes/init.4th` itself
(`grep '^Block '`), which is authoritative by construction — no document needed to restate
it.
- [x] ~~5.3's larger ask (shrinking the four documents)~~ — superseded by the header
approach: a one-paragraph banner accomplishes what "shrink to a pointer" was already
trying to do, without touching the historical content underneath. No further line-count
reduction planned.
### F.2 — Code & actionable-work track
@@ -804,11 +800,10 @@ unreachable NULL-write, `m5_time_trust`/`m5_variance` dead fields.
### F.3 — Punch list
**Documentation — pending Captain Bob's call, one at a time:**
- [ ] `CONSOLE.md` — full rewrite against §17.5/§27, or a "superseded" header?
- [ ] `HERMES.md` — reconcile block map + cell-count table now, or defer until after Artemis?
- [ ] 5.3 — shrink `ARTEMIS.md`/`HERMES.md`/`CONSOLE.md`/`TRIPOD.md` (blocked on the two above)
**Documentation — CLOSED 2026-08-15.** All four subsystem docs (`TRIPOD.md`, `HERMES.md`,
`ARTEMIS.md`, `CONSOLE.md`) ruled superseded outright by Captain Bob, not case-by-case.
Superseded-header banners added to all four; `.claude/CLAUDE.md`'s own pointer corrected to
redirect to `FABRIC.md`/`FABRIC-2.md`. Nothing left pending in this track.
**Code / actionable — pending Captain Bob's call or Artemis landing:**
@@ -819,10 +814,11 @@ unreachable NULL-write, `m5_time_trust`/`m5_variance` dead fields.
Phase 8 (identity storage), out of this pass's scope
- [ ] 5.1 (DoE re-run) + ACL-RWT re-measurement — run now, or wait for Artemis (recommended)?
**Net result:** F.1 has one closed item and three documentation questions; F.2 has three
closed items, four sequencing-blocked items (no ruling needed, just not startable yet), and
one code question. Nothing in either track's open half is closeable without either Artemis or
an explicit decision from Captain Bob — which is the state this pass was asked to produce.
**Net result:** F.1 (documentation) is fully closed. F.2 has four closed items (three from
the original pass plus the RAM-derived Stadium VM-count fix, Section G), four
sequencing-blocked items (no ruling needed, just not startable yet), and one open code
question (§12 Q5). Nothing left open is closeable without either Artemis or an explicit
decision from Captain Bob on §12 Q5.
---