Robert Allan JamesandClaude Sonnet 5
aba0b01a08
FABRIC.md did its job: §1-24's design argument is settled and every implementation item through 4.5/4.4ac either landed or was explicitly deferred with a reason. At 7,595 lines it was no longer a good place to find what's actually still open, so it's now archival -- header rewritten to say so, pointing to FABRIC-2.md. Before closing it, read the entire document end to end (not sampled) looking for anything unresolved: punch-list checkboxes, the nine "### N.N Open" architectural subsections in §1-24, the §25.7 "reported, not scheduled" list, and any other "not yet"/"deferred" language. Found and fixed four stale bookkeeping spots where later work had actually resolved something but the note was never updated: §19.6 #3 (resolved by item 2.1), §21.5 #4 (resolved by §20.5 #4), the §25.7 stadium_owner[idx] bullet (resolved by item 4.2), and item 4.5's own parent checkbox (all six sub-items 4.5a-4.5f were already [x]). FABRIC-2.md carries forward everything genuinely still open: the blocked/scoped punch-list items (1.11, 4.3, 4.4s, 4.6, 5.1-5.3, plus a specific pending TRIPOD.md edit found within 5.3), two regressions that were invisible with Tripod pruned to Hera-alone and are now live since item 4.2 restored Hermes (the fleet heat leak in vm_physics_touch(), and multi-VM heartbeat ownership), nine dead-code/ cruft reports, three open design questions (§12 Q5, §17.4, §23.4 #2), and two documentation-debt items (the taxonomy/glossary Captain Bob flagged 2026-08-04, and re-measuring ACL-RWT DoE overhead now that real compiler optimization is enabled). Also includes BLOCK_MAP.md/artemis.img/amd64.csv regenerated by builds during this session, and a qemu boot log/DoE run that weren't from any command in this session -- kept per repo convention, logs are audit artifacts, not deleted. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
disk/
QEMU disk images used for Artemis (block-storage VM) persistence testing.
Mounted via Makefile.starkernel's ARTDISK variable (default
disk/artemis.img) as a virtio-blk-pci device on all three
architectures' kernel QEMU boots — not scripts/rundisk.sh, which targets
a separate, currently-unused disks/ (plural) directory for the hosted
VM's --disk-img= flag instead.
artemis.img— standard Artemis persistence test disk. Reformatted 2026-08-02: this image had been stuck in a corrupted state (validLithosAnankemagic header, but data not matching whatART-READ-TESTexpects) since before this repo's own git history begins (git logshows it already broken at the initial commit, carried over from the pre-split monorepo). Chasing down the resulting persistentFAIL: persist-readtraced to the data, not the code — the write→reboot→read round trip works correctly on a fresh image (seeartemis-debug-roundtrip.imgbelow). Reformatted by blanking the file and letting a normal boot format+write-test it; verifiedPASS: persist-readon amd64, aarch64, and riscv64 against the same image afterward (cross-arch resume, matching the arch-neutral on-disk format.claude/ARTEMIS.mdspecifies).artemis-debug-roundtrip.img— round-trip regression fixture created during that investigation. Known-good: format → self-test → write-test → reboot → resume →PASS: persist-read, confirmed 3 times in a row. Keep this in a passing state; if a future change breaks it, that's a real regression, not a stale-fixture artifact likeartemis.imgwas.artemis-persist-test.img— persistence round-trip test image (pre-existing; history/state not re-verified during the above investigation).artemis-poison.img— a separate test image (exact scenario not documented elsewhere in the repo as of this writing; name suggests an adversarial/corruption test, not confirmed).artemis-unrecognized-test.img— exercisesART-HALT-UNRECOG(.claude/ARTEMIS.mdacceptance criterion #6). Regenerated 2026-08-02: the previous copy of this file had itself been silently reformatted by a since-fixed bug in the generic block subsystem (src/block_subsystem.c) — it carried a valid low-level'STFR'/v2 header despite being meant to represent foreign disk content, direct forensic evidence of the bug described in.claude/ARTEMIS.md's Build Status item 6. Regenerated as 30MB of a repeatingPOISON-UNRECOGNIZED-DISK-TEST-FIXTURE--NOT-BLANK-NOT-STFR-NOT-ARTEMIS--ASCII pattern — deliberately neither blank, nor the block subsystem's own'STFR'magic, nor Artemis's"ARTEMIS\0"marker. Verified on amd64 and riscv64 post-fix: boot correctly halts (ARTEMIS HALT: unrecognized disk content) and the file's sha256 is now byte-for-byte identical before and after boot. Keep this fixture in this poisoned state — if a future change makes its sha256 change across a boot, that is exactly the regression this fixture exists to catch.
Note on incidental header churn: artemis.img picks up a few changed
header bytes on every ordinary boot even though no user data changes —
blk_subsys_attach_device() always records a fresh mounted_time on a
successfully recognized disk, which gets flushed at shutdown. This is
expected bookkeeping, not a bug; revert it before committing rather than
carrying timestamp noise in git history.
These are regenerable QEMU raw disk images, not source — see
.claude/ARTEMIS.md for the storage model they exercise.