rajames
2e6262c91f
- 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)
60 lines
3.5 KiB
Markdown
60 lines
3.5 KiB
Markdown
# StarForth / LithosAnanke Documentation
|
||
|
||
This is the `lithosananke` branch: the bare-metal StarKernel side of the project
|
||
(contrast `master`, which is the hosted-VM-only side). Documentation follows the
|
||
two-tier model described in `docs/CLAUDE.md`: **`formal/`** is the polished,
|
||
citable LaTeX tier; **`working/`** is living design notes and drafts that feed it.
|
||
Everything else in this directory is branch- or subsystem-specific material that
|
||
doesn't fit either tier.
|
||
|
||
## Layout
|
||
|
||
- **[formal/](formal/)** — Three-volume LaTeX documentation set (research volumes,
|
||
practitioner books, standalone reports) plus the `scraps/` fragment library it's
|
||
assembled from. Audience: patent counsel, SSRN reviewers, licensees, hobbyists
|
||
with hardware in hand. See `formal/CLAUDE.md` for authoring conventions.
|
||
- **[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 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.
|
||
- **[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 —
|
||
ask Bob before touching anything in this directory.**
|
||
- **[api/](api/)** — Generated Doxygen tag file and warnings log (gitignored;
|
||
not part of the tracked doc tree).
|
||
- **[pptx/](pptx/)** — Elevator-pitch and deep-dive slide decks for different
|
||
audiences (technical, non-technical, academic, PhD-level).
|
||
|
||
## Current Active Work
|
||
|
||
> **⚠ `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
|
||
|
||
- Place new material in `working/` first; promote to `formal/` only when it's
|
||
ready to be cited (see `formal/CLAUDE.md` for promotion criteria).
|
||
- Never touch `patent/`, `formal/patent/`, `formal/scraps/legal/`, or
|
||
`working/legal/` without Bob's explicit instruction.
|
||
- Add a `README.md` to any new category-level subdirectory, following the
|
||
format used throughout this tree: orientation paragraph + bullet list of
|
||
real files with one-line descriptions.
|