# 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`](../experiments/bare_metal/README.md) — DoE protocols and block namespace rules - [`docs/reference/word-acl/DESIGN.md`](../docs/reference/word-acl/DESIGN.md) — ACL system design - [`tools/mkcapsule.c`](../tools/mkcapsule.c) — assembles capsules into `capsule_generated.c` - [Project root](../README.md)