Files
LithosAnanke/capsules/README.md
T
Claude 371ea698d4
Build / Image RASPI (push) Successful in 3m53s
Build / Image PC (push) Successful in 4m28s
Build / Image MILKV (push) Successful in 4m33s
Build / v4 tests (32- and 64-bit cells) (push) Successful in 14m8s
capsules/README: Hermes's row gone (it moved into the kernel); Hestia and the v4 capsules listed
Ruled by Captain Bob. The empty capsules/hermes/ is left as it is.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
2026-11-17 23:45:06 +00:00

45 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)