FABRIC.md — reconcile §1-24, add §25 punch list

Reconciliation. §1-15 were written before any code was read and had drifted
from §16-24 in twenty places. Each superseded claim is now marked in place
rather than rewritten -- §19.4 and §19.5 quote the original §4 wording
directly, and the retracing trail matters more than a tidy read.

Two real gaps surfaced during the reread, neither previously recorded:

- §3's wire table was missing `mass`. Density is heat / mass, so mass has to
  live in the entry, and §3 is the table an implementer would work from. It is
  now an eighth wire.
- §8 asserts a per-patron exclusivity primitive -- "one sits in a car, the only
  exclusive thing in the room, no global lock" -- that nothing in §16-24
  defines. §21 covers ISR-vs-mainline concurrency, which is a different
  question. Marked OPEN at the source and carried as punch list item 1.1.

Also corrected: §9's admission table is complete for all five patron kinds with
both `?` marks closed; §12's six questions are all resolved; §5's third
category is supplied; §15's five-line summary had two wrong lines; §4, §6, §7,
§17.4 and §17.6 status markers now match reality.

§25 is the punch list, with its operating instructions first: one item at a
time, no jumping ahead, no scope increase, no fabricating anything unverified,
stop when blocked. Every checked item gets its own commit carrying both the
change and this file with that box ticked, so the document is never a claim
about work not in the branch.

Phase 0 is the substrate -- Hera alone plus real timers and IRQ return paths on
all three ISAs. Nothing else can start until it is done.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-03 10:27:49 -04:00
co-authored by Claude Opus 5
parent 7c436351a0
commit 7fe0133d07
+566 -58
View File
File diff suppressed because it is too large Load Diff