ONTOLOGY.md: add Stadium/Fabric vocabulary section, close taxonomy/glossary debt

Extends the existing lexicon (which already covered heat/decay/inference vocabulary but predated Stadium work entirely) with patron, mass, density, K, cell, code field, Stadium, warehouse, utility -- all cited to their FABRIC.md DECIDED sections. Adds a Kconfig-knob-to-concept table with verified wiring status, flagging STADIUM_CAPACITY_TICK as dead (matches this session's §12 Q5 finding). Bumped to v1.1.
This commit is contained in:
Robert Allan James
2026-08-13 10:26:22 -04:00
parent c9710093ae
commit be598af65c
2 changed files with 193 additions and 5 deletions
+16 -1
View File
@@ -346,11 +346,26 @@ and recorded.
## E. Documentation debt
- [ ] **Taxonomy / glossary.** Captain Bob's own flag, 2026-08-04: the physics vocabulary
- [x] **Taxonomy / glossary.** Captain Bob's own flag, 2026-08-04: the physics vocabulary
(heat, mass, density, patron, Stadium, and Kconfig knob names built on it) needs an
explicit glossary stating these are named analogies, so code, Kconfig, and documentation
terminology don't drift apart over time. Never scoped into any phase. Real, acknowledged
debt: "I guess that we didn't finish out FABRIC.md quite as much as we thought."
> **DONE 2026-08-13.** `ONTOLOGY.md` already existed and already did exactly this job for
> the original heat/decay/inference vocabulary (Section III's lexicon, Section 3.2's
> "avoid/deprecated terms" table) — it just predated the Stadium work entirely (confirmed:
> zero mentions of "Stadium," "patron," "mass," or "density" before this edit) and was
> never extended to cover it. Added new §IX "Stadium/Fabric Vocabulary" in the same
> format as the existing lexicon: a metaphor-mapping table, alphabetical definitions for
> Cell, Code field, Density, K, Mass, Mass-vs-heat-conservation, Patron, Reap, Stadium,
> Warehouse, and Utility (all cited back to their `FABRIC.md` DECIDED sections, not
> invented), plus a Kconfig-knob-to-concept table with **verified, not assumed** wiring
> status for every `STADIUM_*` symbol — including flagging `STADIUM_CAPACITY_TICK` as
> dead, the same finding this document's own §12 Q5 closure made independently, now
> cross-referenced from the glossary too. Bumped `ONTOLOGY.md` to v1.1 with a version-
> history entry. No FABRIC.md/FABRIC-2.md content moved — this is a new, additive section
> in the document that already owned this job.
- [ ] **ACL-RWT DoE overhead re-measurement.** The measured overhead numbers in
`.claude/CLAUDE.md` ("+0.0054%+0.0088%") were all captured at `-O0`, before item 4.5
enabled real compiler optimization. Nobody has re-measured, or even confirmed the old and