Robert Allan JamesandClaude Sonnet 5
5c1b31669e
These are alternate boot personality capsules, not files doe.4th dispatches from -- confirmed by reading doe.4th itself (it generates its own synthetic workload internally, DOE-WORK) and mkcapsule.c (only the exact filename "init.4th" is special-cased as the active MAMA_INIT capsule). "workload-N.4th" names them for what they are without colliding with that reserved name. Renamed the 10 files (git mv, preserving history) and their own self-referential header comments (also fixed a pre-existing typo, "init-4.th" -> "workload-4.4th"), updated capsules/README.md, capsules/MANIFEST.md (21 references), .claude/CLAUDE.md, and a tools/mkcapsule.c comment. Also fixed experiments/bare_metal/README.md's "Adding a Custom Workload Capsule" section, discovered stale while doing this rename: it documented a WL-HI/WL-LO dispatch table and a wl_id CSV column that don't exist anywhere in the current capsules/ tree or doe.4th's own CSV header -- corrected to describe what's actually there (no pluggable workload dispatch; a custom workload is run by substituting it in as the boot's own init.4th). Verified: mkcapsule --lint clean (35 files, 0 violations), all 3 architectures build with zero new warnings, amd64 boots to zuse)ok> with an unchanged dict_hash/capsule_hash from every prior boot this session (0xc8f4b09e36f4fc4a / 0x1ef4939ed32ec1e6) and zero faults. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EXieurDfDSsDFdnSyusuWo
40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# 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) |
|
||
| `hermes/init.4th` | `(p)` | Hermes baby VM personality |
|
||
| `artemis/init.4th` | `(p)` | Artemis baby VM personality |
|
||
|
||
## 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/03-architecture/word-acl/DESIGN.md`](../docs/03-architecture/word-acl/DESIGN.md) — ACL system design
|
||
- [`tools/mkcapsule.c`](../tools/mkcapsule.c) — assembles capsules into `capsule_generated.c`
|
||
- [Project root](../README.md)
|