docs: update stale entry docs and deprecate superseded docs with annotations

- docs/lithosananke/README.md + ROADMAP.md: correct branch topology (no
  lithosananke branch post-split; master is the sole line), mark M7.1 as
  live, and fix build commands (kernel/Makefile, not Makefile.starkernel)
- docs/README.md: refresh current active work (Tripod = Hera/Artemis/Hestia,
  M7.1 live, StarForth v4) and flag INDEX.md as stale
- docs/INDEX.md: add dated-snapshot staleness banner
- Add TARGET-HAL / OBSOLETE / SUPERSEDED banners to stale HAL, physics,
  heartbeat, and DoE docs under docs/working/ (annotation only, no deletions)
This commit is contained in:
rajames
2026-10-09 18:21:10 -04:00
parent f1419e739c
commit 2e6262c91f
21 changed files with 147 additions and 32 deletions
+19 -10
View File
@@ -16,11 +16,13 @@ doesn't fit either tier.
- **[working/](working/)** — Living documents: architecture design notes, DoE
experiment logs, hardware/platform notes, draft specs, academic-paper source
material, and an archive of superseded docs. Source material for `formal/`.
- **[03-architecture/](03-architecture/)** — Tripod VM architecture constraints
(Hera/Hermes/Artemis) and the word-level ACL system design.
- **[03-architecture/](03-architecture/)** — Tripod VM architecture constraints and the
word-level ACL system design. (Note: the fleet is now **Hera/Artemis/Hestia** post-
reshuffle; the old Hera/Hermes/Artemis framing in older docs is historical. The older,
triaged copy of this tree is `working/architecture/03-architecture/`.)
- **[lithosananke/](lithosananke/)** — LithosAnanke kernel branch documentation:
milestone roadmap, system architecture, HAL reference, kernel command-line
argument design, and the amd64 APIC-timer ISR postmortem.
milestone roadmap, system architecture, HAL reference, kernel command-line argument
design, and the amd64 APIC-timer ISR postmortem.
- **[birthing/](birthing/)** — VM birthing plan and status for the Hera-spawns-
Hermes/Artemis constellation, plus three-architecture QEMU acceptance logs.
- **[patent/](patent/)** — Provisional patent application source. **Legal hold —
@@ -32,12 +34,19 @@ doesn't fit either tier.
## Current Active Work
- **LithosAnanke M7/M7.1** — VM parity validation and init capsule architecture.
See `lithosananke/README.md` and `lithosananke/M7.1.md`.
- **Word-level ACL system** — Phase 6 complete on `master`; Phase 7 (LithosAnanke
parity) is the next step. See `03-architecture/word-acl/README.md`.
- **Tripod VMs** — Hera (governor), Hermes (messenger), Artemis (memory/block
storage). See `03-architecture/tripod/README.md` and `birthing/`.
> **⚠ `INDEX.md` is a dated triage snapshot (2026-06-16) and is stale.** The authoritative
> current status lives in `.claude/CLAUDE.md` and `docs/fabric/FABRIC-2.md` /
> `FABRIC-3.md` / `FABRIC-3.5.md` / `FABRIC-3.6.md` — not in the status tags in `INDEX.md`.
- **LithosAnanke M7.1 — live** — init capsules, the Tripod fleet, Stadium physics-economy,
and word-level ACL (Phases 1–7 complete; Phase 8 Ed25519 PKI pending). See
`lithosananke/ROADMAP.md` and the FABRIC documents above.
- **Tripod VMs (post-reshuffle)** — Hera (governor), Artemis (memory/block storage),
Hestia; the Hermes VM was removed and messaging moved into the kernel as kernel-Hermes.
See `.claude/CLAUDE.md`.
- **StarForth v4** — the F18-derived 32-opcode engine with the node/mesh design. See
`v4.0.0/` and `../v4/README.md`.
- **Word-level ACL system** — see `03-architecture/word-acl/` and `lithosananke/ROADMAP.md`.
## Contributing