Update ARTEMIS.md build status to match reality

The flat-pool storage scope ("Immediate Goal") has been implemented for
some time -- capsules/artemis/init.4th boots live in the Tripod fleet on
every kernel boot -- but the doc still said "do not begin implementation
without explicit instruction from Captain Bob" in two places, and
CLAUDE.md's pointer still said "build-authorization deferred."

.claude/ARTEMIS.md: replaced both stale lines with a dated Build Status
section giving an honest per-criterion accounting rather than a blanket
"done": 4 of 6 acceptance criteria fully confirmed (boot-state detection,
free-map init, fetch/persist, and -- as of the persist-read fix earlier
today -- cross-boot/cross-arch persistence), K-conservation implemented
but not hard-asserted, and the unrecognized-disk halt implemented but
never actually exercised against real unrecognized content. Future
material (zones, USB hot-plug, ACL records, PKI) remains correctly
marked deferred -- unchanged.

.claude/CLAUDE.md: updated the Artemis pointer line so it's consistent
with the above instead of contradicting it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-02 09:15:16 -04:00
co-authored by Claude Sonnet 5
parent 1c1097ec40
commit 3d9664d176
2 changed files with 34 additions and 4 deletions
+33 -3
View File
@@ -131,7 +131,37 @@ not remember *heat*. Every join is a cold join.
6. Unrecognized disk content halts the mount with a clear error — no 6. Unrecognized disk content halts the mount with a clear error — no
silent overwrite. silent overwrite.
**Do not begin implementation without explicit instruction from Captain Bob.** ### Build Status — Implemented (2026-08-02)
Implementation happened; this section used to say "do not begin without
explicit instruction" — that instruction was given and the work is done
for this scope. `capsules/artemis/init.4th` implements the full flat-pool
target above, and Artemis boots live in the Tripod fleet (announces ready
to Hermes) on every amd64/aarch64/riscv64 kernel boot.
Acceptance criteria status, verified 2026-08-02:
1.`ART-BOOT-DETECT` — BLANK/LithosAnanke/Unrecognized classification,
confirmed working (both the blank→format and resume paths observed
live in boot logs).
2.`ART-FORMAT` — free map initializes fresh on BLANK, confirmed.
3.`BLK-FETCH`/`BLK-PERSIST` — confirmed working against the real
virtio-blk-backed disk image.
4. ⚠️ K is tracked and printed before/after alloc/free
(`ART-K-TOTAL`/`ART-SELF-TEST`), but nothing asserts the before/after
values actually match — implemented, not yet a hard-checked invariant.
5. ✅ Cross-boot AND cross-arch persistence — confirmed via
`ART-WRITE-TEST`/`ART-READ-TEST`, `PASS: persist-read` on all three
architectures against the same disk image (a write on one arch reads
correctly on the other two). Note: `disk/artemis.img` itself had been
silently stuck failing this exact test since before this repo's git
history begins (bad *data* from some pre-history run, not bad code)
until reformatted this same day — see `disk/README.md`.
6.`ART-HALT-UNRECOG` exists and looks correct by inspection, but has
not actually been exercised against genuinely unrecognized disk
content — untested, not confirmed.
Not done: everything under "FUTURE MATERIAL" below (zones, USB hot-plug,
ACL records, PKI) — that line remains accurate and unchanged.
--- ---
@@ -163,8 +193,8 @@ compudynamic concerns:
2. Block thermal state — how hot is each active block 2. Block thermal state — how hot is each active block
3. K≡1.0 — fleet conservation across all block operations 3. K≡1.0 — fleet conservation across all block operations
These must be designed together. Do not implement one without the others. These must be designed together — and were: see Build Status under
Do not begin implementation without explicit instruction from Captain Bob. Immediate Goal, above, for what's actually implemented and verified.
--- ---
+1 -1
View File
@@ -10,7 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
> **Tripod:** `.claude/TRIPOD.md` is authoritative for all Tripod VM (Hera/Hermes/Artemis) work. Read it completely before touching any Tripod code. > **Tripod:** `.claude/TRIPOD.md` is authoritative for all Tripod VM (Hera/Hermes/Artemis) work. Read it completely before touching any Tripod code.
> **Hermes:** `.claude/HERMES.md` is authoritative for all Hermes VM work. Read before touching Hermes. > **Hermes:** `.claude/HERMES.md` is authoritative for all Hermes VM work. Read before touching Hermes.
> **Artemis:** `.claude/ARTEMIS.md` is authoritative for all Artemis VM work. Read before touching Artemis. Note: Artemis is design-confirmed but **build-authorization deferred** as of this writing — see the "Build Status" section of that file before assuming it's live. > **Artemis:** `.claude/ARTEMIS.md` is authoritative for all Artemis VM work. Read before touching Artemis. Note: as of 2026-08-02 the flat-pool storage scope ("Immediate Goal" in that file) is **implemented and live** — Artemis boots and manages `disk/artemis.img` in the Tripod fleet on every kernel boot, all three architectures. Zones, USB hot-plug, ACL records, and PKI remain deferred future material — see that file's "Build Status" section for exactly what's verified vs. not.
> **Scope:** This repo is LithosAnanke — the bare-metal UEFI kernel that boots StarForth > **Scope:** This repo is LithosAnanke — the bare-metal UEFI kernel that boots StarForth
> directly on hardware. StarForth (the hosted FORTH-79 VM) has its own separate repository > directly on hardware. StarForth (the hosted FORTH-79 VM) has its own separate repository