From dd3469f9a39c0d272f218b242135ae2d48835647 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 18 Nov 2026 19:51:40 +0000 Subject: [PATCH] plan capsule blocks: (- marks a system blob -- the idea, its rulings so far, and what is open Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- .../v4.0.0/plans/2026-11-18-capsule-blocks.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/docs/v4.0.0/plans/2026-11-18-capsule-blocks.md b/docs/v4.0.0/plans/2026-11-18-capsule-blocks.md index c99333c9..87a4d46a 100644 --- a/docs/v4.0.0/plans/2026-11-18-capsule-blocks.md +++ b/docs/v4.0.0/plans/2026-11-18-capsule-blocks.md @@ -116,3 +116,37 @@ Each step is test first, then POST and the protocol: 5. **The documents.** The range tables go, and the rules take their place. `experiments/bare_metal/ README.md` rule 3 ("file order") goes. + +## 5. `(-` marks a system blob (Captain Bob's idea, 2026-11-18; nothing built) + +**The idea, as given:** +- `(-` is a special comment word, terminated by `)` like any `(` comment. +- It also "leaves behind the equivalent of a magic number". +- "The capsule loader can differentiate a 'system capsule' from any other capsule and it can be + diverted into 'please include in a kernel rom image'." + +**What exists already:** +- **v3:** `(-` is a C word (`v3/src/word_source/starforth_words.c:274`) that skips to the matching + `)` and nests. Its own comment says it is "used for marking blocks that should be extracted to + init.4th", so v3 already meant it as a marker. +- **v4:** the same nesting comment, in `capsules/v4/physics.4th` block 8204. +- **POST:** v3's 4 cases for it pass in v4. + +**Ruled:** +1. **The magic number lives in both places.** `mkcapsule` recognises `(-` at build time, and + interpreting it also leaves the magic number at run time, for the loader to check. +2. **`(-` nests, as now.** Only the magic number is added; the 4 POST cases are unchanged. +3. **It is per named blob** ("Named blobs are well defined in the documents": MACHINE.md §1–2, the + trailer's source, typed by name). Read here as: a blob that opens with `(-` is a system blob, as a + magic number opens a file. Captain Bob to correct this if it is wrong. +4. **Where a system blob goes is open.** "I'm thinking either 3 or 1": + - (1) a new, read-only kernel ROM image holding the system blobs only; + - (3) the kernel's capsule directory holding the system blobs only, with every other blob loaded + from elsewhere (Artemis, the stick). + + Not (2), v4's node ROM. + +**Still to settle before any of it is built:** +- the choice between (1) and (3); +- what the run-time magic number is (a variable's value, or a cell the loader reads); +- what the loader does with an unmarked blob in each case.