Captain Bob ruled that MACHINE.md stands. The kernel's system capsules are now starshipos.4th, centre.4th, hera.4th and physics.4th, after forth79.4th. COLD, after POST, leaves FORTH alone in the search order, so the prompt reaches STARSHIPOS's words by naming the vocabulary. The ruling is that init.4th will set the search order; the capsule's header now says so. Test first in test_mesh_boot.c: its parity line, and `STARSHIPOS S" ok" DOE`. It failed before the change. 105 checks now pass, POST is 990/990, and ASan/UBSan and the amd64 build are clean. Logs are in logs/20261118-starshipos. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
capsules/
FORTH personality files loaded by the VM at boot. A capsule is an immutable, content-addressed payload; its XXHash64 hash is its identity. Any mutation changes the hash and the birth protocol rejects the image.
Key files
| File | Type | Purpose |
|---|---|---|
init.4th |
(m) MAMA_INIT |
Default Mama VM personality — loaded at LBN 2048 |
ACL.4th |
user | Word-level ACL system; self-activating at boot |
zuse.4th |
user | Bootstrap superuser; loaded by ACL.4th |
doe.4th |
user | DoE workload words (EXEC-DOE) — opt-in |
workload-0.4th … workload-9.4th |
(p) |
Numbered personality variants |
init-l8-*.4th |
(p) |
L8 Jacquard mode variants (stable/volatile/diverse/temporal/transition/omni) |
artemis/init.4th |
(p) |
Artemis baby VM personality |
hestia/init.4th |
(p) |
Hestia, the third Tripod leg (Hera/Artemis/Hestia): bind point and drawing-fabric owner |
v4/forth79.4th |
v4 | The FORTH-79 Required Word Set as colon definitions, loaded at boot (blocks 6000 up) |
v4/starshipos.4th |
v4 | The StarshipOS words in their own vocabulary, STARSHIPOS, loaded after forth79.4th (blocks 7000 up) |
v4/hera.4th |
v4 | What is Hera's alone: KILL, PAUSE, RESUME by number, through the kernel's registry (block 8000) |
v4/centre.4th |
v4 | What a node that births others needs: the kernel's requests by number (block 8100) |
v4/physics.4th |
v4 | The words of the loops: v3's physics-freeze and inference words, asked of the kernel (block 8200) |
Block namespace
Block ranges are shared across all loaded capsules — collisions cause silent word-definition overwrites.
| Range | Owner |
|---|---|
| 2048–2099 | init.4th |
| 2100–2199 | doe.4th |
| 3000–3999 | workload capsules |
| 4000+ | user-defined (ACL.4th, zuse.4th, …) |
Each block is limited to 1024 bytes. Verify with wc -c before committing.
See also
experiments/bare_metal/README.md— DoE protocols and block namespace rulesdocs/reference/word-acl/DESIGN.md— ACL system designtools/mkcapsule.c— assembles capsules intocapsule_generated.c- Project root