33 KiB
capsules/MANIFEST.md — Block Ownership Registry (justifications)
StarshipOS / StarForth — Captain Bob (Robert Allan James)
This document is authoritative for WHY each block is where it is and
whether it's immutable. For WHICH blocks exist and their current
content hash, see capsules/BLOCK_MAP.md — auto-generated by
make -f Makefile.starkernel manifest (or on every kernel build),
never hand-edited. If the two ever disagree on a block NUMBER,
BLOCK_MAP.md is correct; this document's numbers need updating.
Any new capsule MUST claim a range and get a justification row here
before first commit. Collisions are marked ⚠️ — resolve before
production bake.
How to Read This Document
Each entry lists:
- File — path relative to
capsules/ - Blocks — LBN range(s) claimed (cross-check against
BLOCK_MAP.md) - Immutable — block is locked for life; reason given
- Justification — why each block or range lives where it does
The block namespace is shared across all loaded capsules. mkcapsule.c bakes
every .4th file into the kernel image. If two capsules claim the same block
and are loaded together, the later-loaded definition wins in block RAM.
Definitions already compiled into the dictionary are unaffected, but LOADing
that block again would give wrong results. Flag collisions; resolve before
production bake. Run mkcapsule --manifest capsules (or make -f Makefile.starkernel manifest) before adding any new capsule — it reports
conflicts directly, no need to hand-check against the tables below.
For the full current block-to-capsule map (LBN, capsule, content hash,
conflict status), see capsules/BLOCK_MAP.md — regenerated
automatically on every Makefile.starkernel build, so it never drifts.
This document intentionally no longer duplicates that map; it only carries
the parts a tool can't generate — the justification for each block and the
history of how the layout got here.
Mama VM Personality Capsules
Mama VM is the root VM (Hera). Exactly one Mama personality is active at a time. All entries in this section are mutually exclusive — they are never loaded together.
init.4th — Default Mama personality
Blocks: 2049–2052, 2057
| Block | Immutable | Justification |
|---|---|---|
| 2049 | No | Hera VM init: loads compudynamics, VM-INIT, lib, common:msg, fleet-k, process; BIRTHs Artemis + Hermes. VM-TREE + VM-CHILDREN implemented (b52281b9), unrolled for v1 Tripod |
| 2050 | No | BOOT-BANNER call — separated so the banner block can be swapped without touching init logic |
| 2051 | No | TRIPOD-TEST — 6 acceptance gates per TRIPOD.md. Dead EVENT-WAIT step replaced with HERMES-TICK liveness check (3436d564) |
| 2052 | No | TRIPOD-TEST invocation block |
| 2057 | No | BOOT-BANNER word definition (reusable across Mama variants) |
Note: 2048 is the kernel ramdrive entry point. init.4th starts at 2049 intentionally
(2048 = PERSONALITY block, loaded separately by the capsule birth protocol).
doe.4th — DoE Mama personality
Blocks: 2100–2107
Moved from 2049–2056 (2026-07-05) — that range collided with init.4th's
real blocks (2049–2052). Alternate-personality status doesn't excuse a real
LBN clash when both capsules are baked into the same binary; renumbered
into the range this doc had already earmarked for doe.4th ("2100–2199")
but the file itself had never actually used. See Conflict Register C2.
Note (2026-07-08): the table below previously described generic lifecycle-stage content ("loop control", "teardown / flush") that didn't match any of this file's actual blocks. Rewritten to match the live file.
| Block | Immutable | Justification |
|---|---|---|
| 2100 | No | Factor threshold constants (ENT-HI/CV-HI/TMP-HI/STB-HI) + run-matrix sizing (N-CFG/N-REPS/N-RUNS) |
| 2101 | No | Serial output primitives: N./COMMA/CRLF/CSV-COL/CSV-LAST/CSV-HEADER |
| 2102 | No | Factor extraction + apply: CFG-ENT/CFG-CV/CFG-TMP/CFG-STB/APPLY-CFG (drives L8-UPDATE/L8-APPLY) |
| 2103 | No | DOE-WORK: the arithmetic workload itself (~5000-iteration loop, ~35000 word executions) |
| 2104 | No | Run matrix: RUN-MATRIX (CREATE...ALLOT) + MATRIX!/MATRIX@/SWAP-MTX/INIT-MATRIX. Not fully immutable: CREATE allocates memory at compile time |
| 2105 | No | Fisher-Yates shuffle (SHUFFLE-MATRIX) over the run matrix |
| 2106 | No | EMIT-ROW: CSV row emitter, pulls inference-engine state (INFER-RUN, L8-MODE, WINDOW-DIVERSITY, etc.) |
| 2107 | No | EXEC-DOE/DOE: main entry point — seeds, shuffles, runs the full matrix, emits CSV |
init-4.4th — Mama variant (numbered)
Blocks: 2130–2132
| Block | Immutable | Justification |
|---|---|---|
| 2130 | No | Mama variant init logic |
| 2131 | No | Variant personality block 2 |
| 2132 | No | Variant personality block 3 |
init-7.4th — Mama variant (numbered)
Blocks: 2150
| Block | Immutable | Justification |
|---|---|---|
| 2150 | No | Single-block Mama variant |
init-8.4th — Mama variant (numbered)
Blocks: 2160
| Block | Immutable | Justification |
|---|---|---|
| 2160 | No | Single-block Mama variant |
init-0.4th — Mama variant (numbered)
Blocks: 2200–2201
| Block | Immutable | Justification |
|---|---|---|
| 2200 | No | Mama variant init |
| 2201 | No | Mama variant personality continuation |
init-6.4th — Full-range Mama variant
Blocks: 2080–2095
Moved from 2048–2063 (2026-07-05). That range put both init-6.4th and
its byte-identical twin init-l8-omni.4th on top of init.4th's real
blocks (2049–2052, 2057) — a genuine collision the original Conflict
Register missed by only tracking "6 vs omni" (C1) and "init vs doe" (C2)
as separate entries, never checking omni/6 against init.4th itself. See
Conflict Register C1.
| Block | Immutable | Justification |
|---|---|---|
| 2080–2095 | No | Full Mama personality suite: 16 blocks covering init, loop control, L8 hooks, workload dispatch, banner, teardown |
init-l8-omni.4th — L8 Jacquard omni Mama variant
Blocks: 2064–2079
Moved from 2048–2063 (2026-07-05), for the same reason as init-6.4th
above. init-l8-omni.4th is byte-identical to init-6.4th (same content,
same xxHash64) — presumably a copy-forward placeholder awaiting real L8
Jacquard omni-mode content that was never written. Given as a separate
capsule anyway (rather than deleted) since it's referenced by name
elsewhere as the L8-enabled variant; flagging the duplication here for
visibility, not resolving it — that's a content decision, not a block
numbering one.
| Block | Immutable | Justification |
|---|---|---|
| 2064–2079 | No | L8 Jacquard omni Mama personality; currently identical content to init-6.4th (see note above) |
init-5.4th — Raw code capsule (no block format)
Blocks: none (no Block N headers)
init-5.4th defines words inline without FORTH block formatting. It is a raw
code capsule compiled directly into the dictionary at load time. It does not
claim any LBN slot and cannot be LOADed by number. This is intentional for
volatile/chaos workloads where block-structured layout adds no value.
Workload Capsules (4406–4849)
Exactly one workload capsule is active per DoE run — never co-loaded with
another. Moved off 3001–3060 (2026-07-05): that range was shared verbatim
across all 9 workload capsules on the theory that "mutually exclusive, so
sharing is fine" — the same reasoning that masked C1/C2 above, and true
only in the narrow sense that boot-time compilation reads capsule text
straight from the in-memory payload. The write_ramdrive_block re-cache
step (so a human can later type N LOAD) goes through the real block
subsystem, and 9 capsules pointing at the same LBN for that step meant only
the last-loaded one's text was ever recoverable that way — worth cleaning
up even though nothing observable broke. See Conflict Register C3.
Each capsule now owns a private, non-overlapping range. The numbered non-L8 workloads keep their original sparse per-phase spacing (still room to add a phase without renumbering); the contiguous L8 workloads keep their original contiguous style, just relocated.
init-1.4th — Non-L8 workload, 4 phases
Blocks: 4406, 4415, 4425, 4435
| Block | Immutable | Justification |
|---|---|---|
| 4406 | No | Workload entry point |
| 4415 | No | Phase 2 workload words |
| 4425 | No | Phase 3 workload words |
| 4435 | No | Phase 4 workload words |
init-2.4th — Non-L8 workload, 5 phases
Blocks: 4506, 4515, 4525, 4535, 4545
Same sparse slot pattern as init-1.4th, own private hundred-block zone,
plus one additional phase block.
init-3.4th — Non-L8 workload, 7 phases
Blocks: 4606, 4615, 4625, 4635, 4645, 4655, 4665
Largest non-L8 workload. Own private hundred-block zone with room for three more phases (4675, 4685, 4695) before needing a new zone.
init-9.4th — Non-L8 workload, 5 phases
Blocks: 4706, 4715, 4725, 4735, 4745
Structurally identical slot pattern to init-2.4th; different workload content.
init-l8-stable.4th — L8 stable mode workload
Blocks: 4806
Single-block workload. Stable mode = low CV, minimal variability. One block suffices.
init-l8-volatile.4th — L8 volatile mode workload
Blocks: 4810–4813
Four blocks. Volatile mode generates high-CV execution patterns requiring more definition space.
init-l8-diverse.4th — L8 diverse mode workload
Blocks: 4820–4822
Three blocks. Diverse mode cycles across word categories.
init-l8-temporal.4th — L8 temporal mode workload
Blocks: 4830–4831
Two blocks. Temporal mode generates time-varying access patterns.
init-l8-transition.4th — L8 transition mode workload
Blocks: 4840–4842
Three blocks. Transition mode exercises mode-switching boundary behavior.
Infrastructure Capsules (4000+)
Infrastructure capsules are permanent system libraries. Multiple may be loaded simultaneously. Block assignments in this range are non-overlapping except where explicitly flagged.
Everything in this range lives on Artemis's disk, not the ramdrive.
The kernel ramdrive is exactly 1024 blocks, LBN 2048–3071 (KRD_MAX_BLOCKS
in capsule_loader.c). Artemis's virtio-blk disk is attached immediately
after as the next device in the block subsystem's LBN-ordered slot chain
(kernel_main.c, blk_subsys_attach_device), starting at LBN 3072 — which
is also ART-HDR-LBN, the very first byte of Artemis's own on-disk header.
So every block number in this section (4000+) resolves through
blk_get_buffer()'s device routing to Artemis's persistent disk image
(disk/artemis.img), not a scratch buffer. This has been true since these
capsules were first numbered — it isn't new. It's provably harmless for
boot correctness (capsule_load_blocks compiles word definitions straight
from the in-memory payload; the block-subsystem write is only a courtesy
copy so a human can later type N LOAD interactively), but it does mean
every boot writes capsule source text over whatever LBNs 4000+ map to on
Artemis's disk — which is why disk/artemis.img shows a binary diff after
every acceptance run. Keep this in mind before claiming new blocks in the
"OPEN"/"UNASSIGNED" ranges below: they are disk offsets, not free RAM.
ACL.4th — Word-level ACL system
Blocks: 4000–4007, 4015
Note (2026-07-08): rows 4001–4007 below were previously wrong in every
row (describing ACL-BOOT-STRICT/ACL-BOOT-PERMISSIVE/ACL-PERMISSIVE-MODE/
ACL-TTL-TICK — none of which exist — and misplacing content between rows,
e.g. claiming zuse.4th loads from 4007 when that call is actually in 4015).
Corrected this pass by reading the live file directly.
| Block | Immutable | Justification |
|---|---|---|
| 4000 | Yes | ACL-STRICT-MODE/ACL-TTL-MODE-VAL/ACL-BASE-TTL/ACL-MAX-TTL constants. Immutable: changing these alters security semantics of all downstream capsules |
| 4001 | No | ACL-ENTRY ( xt -- xt ): identity word for API symmetry. Not immutable: cosmetic, safe to extend |
| 4002 | Yes | ACL-STRICT / ACL-TTL-MODE: pin-guarded mode selector words. Immutable: mode selection is a load-bearing policy operation |
| 4003 | Yes | ACL-TTL-COMPUTE: adaptive TTL formula (heat/4 + ACL-BASE-TTL, capped at ACL-MAX-TTL). Immutable: formally verified in ACL_TTL_Bounded.thy; core enforcement math |
| 4004 | Yes | ACL-RECHECK: cold-path policy called by C acl_recheck() at TTL=0. Immutable: core enforcement path; changes here affect every word execution under ACL |
| 4005 | Yes | ACL-BOOT: stamps default ACL via ACL-INIT-PRIMITIVES, pins EXEC/BYE/ACL-RECHECK/ACL-INIT-PRIMITIVES, self-pins. Immutable: self-activation runs once at boot; must be stable |
| 4006 | Yes | ACL-CA-KEY-LO/ACL-CA-KEY-HI: Ed25519 CA root public key placeholders. Immutable: capsule hash is the root-of-trust fingerprint; any change rejects the birth protocol |
| 4007 | No | Self-activation placeholder comment + historical note on the removed RWT mechanism (see 4008–4014 below). Not immutable: comment-only content |
| 4008–4014 | — | UNASSIGNED. Formerly the "ACL Rolling Window of Truth" (RWT) TTL mechanism (ring buffer, slope inference, ACL-RECHECK-RW, ACL-BOOT-RW). Removed 2026-07-08: it was dead code from the day it was written — the C hot path's acl_recheck() looks up the word literally named ACL-RECHECK (11 chars), never ACL-RECHECK-RW (14 chars), so nothing ever reached this mechanism regardless of ACL-BOOT-RW pinning it. It was never covered by ACL_TTL_Bounded.thy despite this table's prior claim otherwise. Also removed: 4 backing DictEntry fields (acl_rwt[8]/acl_rwt_head/acl_rwt_count/acl_rwt_slope) that violated the project's own four-field ACL limit, and 6 orphaned C primitives (ACL-RWT-*) in src/word_source/acl_words.c. |
| 4015 | Yes | Self-activation: runs ACL-BOOT (the real, live boot function defined at 4005), then S" zuse.4th" EXEC. Immutable: runs once at boot |
zuse.4th — Bootstrap superuser
Blocks: 4016–4018
| Block | Immutable | Justification |
|---|---|---|
| 4016 | Yes | ZUSE-CERT-LO / ZUSE-CERT-HI constants. Immutable: capsule hash = root of superuser trust; changing breaks PKI chain |
| 4017 | Yes | ACL-ZUSE-BOOT: authenticates session + pins zuse words. Immutable: this is the sole path to zuse_session=1; must not be alterable post-boot |
| 4018 | Yes | Self-activation (ACL-ZUSE-BOOT). Immutable: runs once at boot |
lib.4th — Shared serial output + FORTH aliases
Blocks: 4050
| Block | Immutable | Justification |
|---|---|---|
| 4050 | No | N. COMMA CRLF CSV-COL CSV-LAST Q.SHOW USE RUN. Not immutable: these are utilities; adding words is safe. Removing or renaming existing words requires audit of all callers |
common/msg.4th — Hermes participant interface
Blocks: 4055
| Block | Immutable | Justification |
|---|---|---|
| 4055 | Yes | HERMES-ACK / HERMES-NACK. Immutable: this is the cross-VM ACK/NACK ABI. Every messaging VM (Hera, Hermes, Artemis) loads this at birth. Changing the block or the word names breaks the Hermes delivery protocol |
doe-campaign.4th — DoE campaign harness
Blocks: 4060–4065
Note (2026-07-08): this table previously described fictional content
(e.g. "CSV output formatting", "statistical reduction words") that never
matched the file at any point on record. Rewritten to match the actual
content, migrated this pass off the deleted compudynamics.4th/
fleet-k.4th primitives onto the VM-PHYSICS-STATUS/VM-CONSERVED?
mechanism — see capsules/hermes/init.4th block 4153 and
capsules/artemis/init.4th block 4852 for the companion LOAD-DOE fix
this migration also required.
| Block | Immutable | Justification |
|---|---|---|
| 4060 | No | SETUP-HERMES/SETUP-ARTEMIS/SETUP-VMS: BIRTH + remote LOAD-DOE VM-EXEC per child VM. Not immutable: setup sequence may grow |
| 4061 | No | PHASE1-DOE: real per-VM DOE-WORK baseline touches. Historical note: dead CD-WORK (index-dispatch, deleted VM-HERA/HERMES/ARTEMIS constants) removed here 2026-07-08 |
| 4062 | No | CD-TICK/CD-DOE: one real fleet-touch pass (VM-EXEC "DOE-WORK" on Hermes+Artemis), looped N times. CAMPAIGN-STATUS: VM-PHYSICS-STATUS + VM-CONSERVED? check. Not immutable: workload/status content may evolve |
| 4063 | No | CAMPAIGN: full campaign — baselines then 30 real fleet touches |
| 4064 | No | SMOKE-CAMPAIGN: 1-rep seed-1959 smoke test + 16 real fleet touches |
| 4065 | No | THREE-VM-CAMPAIGN: loads doe.4th locally on Hera, then 48 real fleet touches, all three VMs as Compudynamics peers |
hermes/init.4th — Hermes VM (messenger)
Blocks: 4100–4109, 4114–4121, 4142–4153
Gap 4110–4113 = Artemis. HARD LOCKED. Never touch from Hermes side. Gap 4122–4141 = Artemis (extended — see below). Never touch from Hermes side.
| Block | Immutable | Justification |
|---|---|---|
| 4100 | Yes | Hermes constants: event codes, channel states, node sizes, arena sizes, MSG-DELIVERED. Immutable: changing node size constants corrupts all arena math |
| 4101 | Yes | Arena CREATE: MSG-ARENA CH-ARENA MBR-ARENA; free-list roots; MSG-SEQ CH-ACTIVE. Immutable: CREATE allocates memory at compile time; re-running changes VM memory layout |
| 4102 | Yes | MSG-INIT-FREE + CH-INIT-FREE. Immutable: free-list init is called once from CD-INIT; structure change breaks allocator |
| 4103 | Yes | MBR-INIT-FREE + MSG-ALLOC + MSG-FREE-NODE. Immutable: allocator ABI; MSG-ALLOC is called by every MSG-SEND |
| 4104 | Yes | CH-ALLOC + CH-FREE-NODE + MBR-ALLOC + MBR-FREE-NODE. Immutable: same allocator ABI constraint |
| 4105 | Yes | Message field accessors (MSG-TYPE@/! through MSG-SEQ@/!). Immutable: field offsets are load-bearing; changing breaks every accessor caller |
| 4106 | Yes | Channel + member accessors (CH-ID@/! through MBR-VM@). Immutable: same field offset constraint |
| 4107 | No | VARIABLE MSG-LAST-MSG + IDX>NAME + MSG-DELIVER. Not fully immutable: MSG-DELIVER may evolve for async model. IDX>NAME now a table lookup over VM-NAME-ADDRS/LENS (see 4142) |
| 4108 | No | MSG-SEND. Not immutable: send protocol may evolve |
| 4109 | No | MSG-REAP. Ordering bug fixed (8ca0cda2) — type cleared before free-node prepend |
| — | — | 4110–4113: ARTEMIS. NEVER TOUCH. |
| 4114 | No | VARIABLE CH-SCAN + CH-COOL-ALL + CH-TOTAL-HEAT. Not immutable: channel cooling may evolve |
| 4115 | No | CH-REAP-SAFE. Not immutable: channel reaping logic may evolve |
| 4116 | No | VARIABLE COMMON-CH + COMMON-INIT + HERMES-TICK. Not immutable: HERMES-TICK drives the event loop; may grow |
| 4117 | No | EVENT-EMIT + EVENT-WAIT + EVENT-DRAIN (backward compat). Not immutable: EVENT-WAIT is a diagnostic peek only per HERMES.md |
| — | — | 4118: reserved, currently empty (former HERA-NOTIFY-SPAWN/KILL, removed 9323f776 — notification is automatic via vm_physics_init/retire) |
| 4119 | No | CH-MINT-ID + CH-REQUEST. Not immutable: channel negotiation protocol may expand (multi-party invite deferred) |
| 4120 | No | CD-INIT. Not immutable: init sequence may grow |
| 4121 | No | MSG-ACK-LAST + MSG-NACK-LAST. Not immutable: NACK-requeue (reduced heat, retry) deferred; block may need extension |
| — | — | 4122–4141: ARTEMIS (extended). NEVER TOUCH. |
| 4142 | No | VM name routing table: VM-NAME-ADDRS/LENS + VM-NAME-REG + VM-NAMES-INIT. Not immutable: table-driven, grows via VM-MAX |
| 4143 | Yes | MSG-CH@/! + MSG-ORIG-TYPE@/! + MSG-NACKED. Immutable: field offset constraint, same as 4105 |
| 4144 | No | MSG-SEND. Not immutable: send protocol may evolve |
| 4145 | No | MSG-TOTAL-HEAT + MSG-REDELIVER-NACKED. Not immutable: cooling/redelivery logic may evolve |
| 4146 | No | MSG-DELIVER-ALL. Not immutable: delivery logic may evolve |
| 4147 | No | HERMES-K + WELCOME. Not immutable: may grow |
| 4148 | No | CH-ACCEPT + CH-CONFIRM + CH-CLOSE. Not immutable: channel negotiation protocol may expand |
| 4149 | No | HERMES-STATUS (MSG-USED + CH-USED). Not immutable: status may expand |
| 4150 | No | Member management: MBR-NEXT!/VM! + CH-ADD-MBR + HERMES-MSG-TEST. Not immutable: may grow |
| 4151 | No | Phase 2 real multi-member broadcast: MSG-BROADCAST + BC-* variables. Not immutable: broadcast protocol may expand |
| 4152 | No | Phase 2 COMMON-CH membership + test: BCAST-GOT/BCAST-RECV/REGISTER-COMMON-MEMBERS/SEND-BROADCAST-TEST. Not immutable: test harness may grow |
| 4153 | No | LOAD-DOE ( -- ): S" doe.4th" EXEC. Added 2026-07-08 — doe-campaign.4th's SETUP-HERMES calls this remotely so Hermes gets DOE-WORK; was missing entirely before this pass, so doe-campaign.4th could never have worked even pre-dating the VM-fleet-physics redesign. Not immutable: trivial wrapper |
2026-07-05 collision fix: blocks 4142–4150 were previously numbered
4122–4131 (interleaved with the blocks below them in this list), directly
colliding with Artemis's real block range. The collision was introduced
fca7b09a (Jul 1) when the VM-name routing table was added without
checking MANIFEST.md, and went undetected for 4 days because mkcapsule's
build path doesn't run conflict detection (only --manifest does). Found
via mkcapsule --manifest while syncing this document; renumbered into
genuinely free space and reverified with a clean amd64 TRIPOD-TEST boot
(PASS: fleet K, PASS: Hermes liveness, PASS: Artemis ready, K soak,
PASS: E2E msg flow — Hermes's kill/rebirth soak test reproduced an
identical dict_hash before and after, confirming the reload path is now
clean). amd64-only per the rev-f iteration rule; three-arch not yet run for
this fix. See Conflict Register entry C5.
artemis/init.4th — Artemis VM (flat pool disk manager v2)
Blocks: 4110–4113 (core, hard locked) + 4122–4141, 4851–4852 (extended)
★ HARD LOCKED (4110–4113). Core Artemis block storage primitives. They live in the middle of the Hermes range by deliberate layout choice (Hermes owns 4100–4121 + 4142–4150; Artemis owns 4110–4113 as a protected island plus its own extended range at 4122–4141). No other capsule may ever claim these blocks. No tool, script, or automated process may modify these blocks without Captain Bob's explicit written permission.
Artemis's extended range grew organically across several sessions
(ed05db25 Artemis BAM, 48b5f726 entry-block renumbering) without a
MANIFEST.md update at each step — this is the range that collided with
Hermes (see above). The table below reflects the actual current footprint.
| Block | Immutable | Justification |
|---|---|---|
| 4110 | Yes | Constants (ART-HDR-LBN, ART-FM-LBN, ART-DATA-LBN, ART-DATA-BLKS) + Q-DECAY. Immutable: constants define the on-disk geometry; changing them corrupts existing disk images |
| 4111 | Yes | LE32!/LE32@ — arch-neutral little-endian 32-bit byte I/O. Immutable: on-disk format depends on these; changing byte order corrupts cross-arch images |
| 4112 | Yes | SHL1N/SHR1N/BIT-TEST/BIT-SET/BIT-CLR — bit manipulation. Immutable: free map correctness depends on these primitives |
| 4113 | Yes | FM-ADDR-BIT/FM-TEST/FM-SET/FM-CLR — free map core. Immutable: free map ABI; changing breaks allocator |
| 4122 | No | FM-FIND-FREE/BLK-ALLOC/BLK-FREE. Not immutable: scan strategy may improve (e.g. hint-based) |
| 4123 | No | ART-MAGIC!/ART-MAGIC? — disk detection primitives. Not immutable: magic check may extend |
| 4124 | No | ART-BOOT-DETECT/BLK-FETCH/BLK-PERSIST/ART-FLUSH. Not immutable: boot mode may gain additional cases |
| 4125 | No | ART-HDR-WRITE — on-disk header format. Not immutable: header layout may extend |
| 4126 | No | ART-FORMAT/ART-RESUME/ART-HALT-UNRECOG. Not immutable: resume path will grow |
| 4127 | No | ART-STATUS/WELCOME. Not immutable: status may expand |
| 4128 | Yes | LE64!/LE64@ — depends on LE32!/LE32@ (4111). Immutable: same on-disk format constraint |
| 4129 | — | UNASSIGNED (former entry block; entry moved to 4133 in 48b5f726) |
| 4130 | No | ART-BLANK? — blank block detection. Not immutable: may extend |
| 4131 | No | ART-INIT — boot state machine. Not immutable: boot cases may grow |
| 4132 | No | ART-SELF-TEST. Not immutable: may expand |
| 4133 | No | Entry block — ART-INIT ART-BOOT-ENTRY WELCOME. Numbered after all defs to avoid CAPSULE DEFER; may grow |
| 4134 | No | ART-WRITE-TEST (persist-write test). Not immutable: test may expand |
| 4135 | No | ART-READ-TEST (persist-read test). Not immutable: test may expand |
| 4136 | No | ART-BOOT-ENTRY — boot-mode dispatch. Not immutable: dispatch cases may grow |
| 4137 | Yes | BLK-HEAT arena (CREATE ... ALLOT). Immutable: CREATE allocates memory at compile time; re-running changes VM memory layout |
| 4138 | No | BLK-HEAT@/! + LBN>IDX. Not immutable: accessor logic may evolve |
| 4139 | No | ART-K-TOTAL + ART-COOL. Not immutable: cooling logic may evolve |
| 4140 | No | ART-REAP + ART-TICK. Not immutable: reap logic may evolve |
| 4141 | No | CD-INIT — Hera calls this at fleet boot. Not immutable: init sequence may grow |
| 4851 | No | ART-PING ( -- ): cheap O(1) touch target for Phase 3 fleet DoE workload, unlike ART-TICK/ART-STATUS which scan all ART-DATA-BLKS. Not immutable: may extend |
| 4852 | No | LOAD-DOE ( -- ): S" doe.4th" EXEC. Added 2026-07-08 — same missing-word fix as hermes/init.4th 4153; doe-campaign.4th's SETUP-ARTEMIS calls this remotely. Not immutable: trivial wrapper |
process.4th — VM process management
Blocks: 4300–4301
| Block | Immutable | Justification |
|---|---|---|
| 4300 | No | Event code constants + SPAWN + PAUSE lifecycle operators. Not immutable: process model may evolve |
| 4301 | No | RESUME + KILL-VM. Not immutable: process model may evolve |
Deleted capsules (historical)
compudynamics.4th (formerly 4200–4204) and fleet-k.4th (formerly
4400–4405) were deleted in 9323f776 (2026-07-05) — superseded by the
generalized VM fleet physics mechanism (capsule_vm_physics.c/.h,
VM-CONSERVED? / VM-PHYSICS-STATUS primitives). See
docs/working/architecture/VM-PHYSICS-DYNAMIC-FLEET-DESIGN-20260705.md
and docs/working/archive/session-logs/2026-07-05-worklog.md. Their
former ranges are now UNASSIGNED (see Namespace Map).
Unassigned Ranges
| Range | Status | Notes |
|---|---|---|
| 0–2047 | KERNEL | VM internal; never use in capsules |
| 2053–2056, 2058–2063 | UNASSIGNED | init.4th extension space (after its real 2049–2052,2057) |
| 2096–2099 | UNASSIGNED | Between init-6.4th and doe.4th |
| 2108–2129 | UNASSIGNED | doe.4th extension space (within its 2100–2199 range) |
| 2133–2149 | UNASSIGNED | Between init-4 and init-7 variants |
| 2151–2159 | UNASSIGNED | Between init-7 and init-8 variants |
| 2161–2199 | UNASSIGNED | Between init-8 and init-0 variants |
| 2202–2999 | UNASSIGNED | Open for future Mama variants |
| 3001–3999 | UNASSIGNED | Freed by the 2026-07-05 workload renumbering (was 3001–3060, shared across all 9 workload capsules — see C3). NOTE: LBN 3072+ is Artemis's virtio-blk disk, not ramdrive — see the callout above the Infrastructure Capsules section before claiming anything here |
| 4008–4009 | UNASSIGNED | ACL extension space |
| 4019–4049 | UNASSIGNED | ACL / zuse extension space |
| 4051–4054 | UNASSIGNED | lib.4th extension space |
| 4056–4059 | UNASSIGNED | common:msg extension space |
| 4066–4099 | UNASSIGNED | doe-campaign extension space |
| 4154–4199 | UNASSIGNED | Hermes extension space (post-4153) |
| 4200–4299 | UNASSIGNED | Former compudynamics.4th range (deleted 9323f776) |
| 4302–4399 | UNASSIGNED | process extension space |
| 4400–4405 | UNASSIGNED | Former fleet-k.4th range (deleted 9323f776) |
| 4410–4414, 4420–4424, 4430–4434 | UNASSIGNED | init-1.4th's private zone, room for growth |
| 4853+ | OPEN | Future capsules — claim here first |
Conflict Register
| ID | Blocks | Capsule A | Capsule B | Risk | Resolution |
|---|---|---|---|---|---|
| C1 | init-6.4th | init-l8-omni.4th / init.4th | Resolved (was mislabeled Low — the pair also silently overlapped init.4th's real blocks, missed because the register only tracked "6 vs omni") |
init-l8-omni.4th moved to 2064–2079; init-6.4th moved to 2080–2095. Both now clear of init.4th (2049–2052,2057) and of each other. |
|
| C2 | init.4th | doe.4th | Resolved (was real — both baked into the same binary; "never co-loaded" doesn't stop a shared-manifest ambiguity) | doe.4th moved to 2100–2107, the range this doc had already earmarked for it but the file never actually used. |
|
| C3 | init-1..3,9 | init-l8-*.4th | Resolved (was real for the N LOAD re-cache path — see the disk-routing callout above the Infrastructure Capsules section; harmless for boot compilation, still worth fixing) |
Each of the 9 workload capsules moved to its own private range in 4406–4842; sparse per-phase spacing preserved for the numbered non-L8 workloads. | |
| C4 | ACL.4th | zuse.4th | Resolved | zuse.4th moved to 4016–4018; no overlap | |
| C5 | hermes/init.4th | artemis/init.4th | Resolved (was real — both VMs co-loaded every boot, unlike C1–C3's mutually-exclusive personalities) | Introduced fca7b09a (Jul 1), undetected for 4 days — mkcapsule's build path runs no conflict check, only --manifest does. Found while syncing this doc. Hermes's colliding blocks renumbered to 4142–4150; Artemis untouched. Reverified with a clean amd64 TRIPOD-TEST boot, including Hermes kill/rebirth reproducing an identical dict_hash before and after. |
mkcapsule --manifest capsules reports zero conflicts as of this
renumbering (2026-07-05) — verify with the same command before adding any
new capsule.
This document is authoritative for capsule block assignments. Last updated: 2026-07-05 — C1/C2/C3 resolved: eliminated every remaining documented "safe by design" overlap, not just the real C5 one. init-6.4th and init-l8-omni.4th (byte-identical) moved off init.4th's range; doe.4th moved into its own already-documented 2100–2199 range; all 9 workload capsules moved off the shared 3001–3060 range into private zones at 4406–4842. Added a callout that LBN 3072+ (everything infrastructure capsules and workload capsules now occupy) is Artemis's virtio-blk disk, not a ramdrive — discovered while sizing free space for this renumbering. Reverified with a full three-arch (amd64/aarch64/riscv64) TRIPOD-TEST boot: zero FAIL lines, matching dict_hash at every checkpoint on all three architectures, identical to the pre-renumbering baseline (the moved capsules aren't in the default Tripod boot path).
Doc-debt pass, 2026-07-08 — every block-table row was checked directly
against the live .4th files and mkcapsule --manifest's authoritative
block map (not against this document's own prior claims). Corrected:
ACL.4th's entire 4001–4007 table (every row previously described words
that don't exist, e.g. ACL-BOOT-STRICT); doe-campaign.4th's entire
table (previously fictional, e.g. "CSV output formatting" — real content
is SETUP-VMS/CD-TICK/CAMPAIGN, migrated this same pass off the
deleted compudynamics.4th/fleet-k.4th primitives); doe.4th's entire
table (block-shifted against real content); missing hermes/init.4th
blocks 4151–4153 and artemis/init.4th blocks 4851–4852 (both existed in
source, undocumented, before this pass — 4153/4852 are new LOAD-DOE
definitions added this session to fix a second bug found while migrating
doe-campaign.4th: it was never defined on either VM). Zero conflicts
per mkcapsule --manifest capsules; three-arch QEMU acceptance run for
the doe-campaign.4th/hermes/artemis changes (commit e2f30bfe)
before this doc pass. Not re-verified this pass: whether every other
still-unflagged row elsewhere in this document matches source exactly —
this was a targeted correction of the rows touched by recent work plus
doe.4th/ACL.4th, not a full line-by-line re-audit of all ~250 blocks.