plans, ARTIFACT.md: task 3 ruling, capabilities declared, then checked

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
This commit is contained in:
Claude
2026-11-19 19:48:24 +00:00
parent cad8291478
commit d6b894769c
2 changed files with 10 additions and 0 deletions
+4
View File
@@ -145,6 +145,10 @@ about the format:
its list. Compatibility refuses a replacement that needs one the old did not (`ABI.md` §7). The list its list. Compatibility refuses a replacement that needs one the old did not (`ABI.md` §7). The list
is a count unit then that many request numbers (§7). The bit layout and the list's form were chosen in is a count unit then that many request numbers (§7). The bit layout and the list's form were chosen in
drafting; confirmed by Captain Bob, 2026-11-19 ("Yes"). drafting; confirmed by Captain Bob, 2026-11-19 ("Yes").
**Changed 2026-11-19 (step 3, `plans/2026-11-19-f18-artifact-build.md` §10.5, "Declared, then checked"):**
v4 has no port opcode, so capabilities cannot be derived. Each word declares them (`ports`, `request N`),
and the tool fails the build where it can see a port or a request that is not declared. The layout is
unchanged.
5. ~~Endianness for the code cells~~ **Ruled 2026-11-19: "Low-first, like the records".** Every byte of 5. ~~Endianness for the code cells~~ **Ruled 2026-11-19: "Low-first, like the records".** Every byte of
the artifact has one order, low byte first, so its hashes and signature are the same whichever host the artifact has one order, low byte first, so its hashes and signature are the same whichever host
built it. A big-endian host swaps the bytes when it places the code. built it. A big-endian host swaps the bytes when it places the code.
@@ -241,3 +241,9 @@ this is a measure of the analysis, not an interface.
is named with hash 0 and resolved by name in the node's dictionary at placement. Exact-hash imports is named with hash 0 and resolved by name in the node's dictionary at placement. Exact-hash imports
(`ABI.md` choice 4) hold between artifact trains only. Asked because a capsule today is one file, and (`ABI.md` choice 4) hold between artifact trains only. Asked because a capsule today is one file, and
the nucleus is 16 blobs. the nucleus is 16 blobs.
5. **Capabilities: "Declared, then checked"** (2026-11-19). v4 has no port opcode: a port is an address,
reached through A, B or P, whose values are data, so which words touch ports cannot be derived. A word
declares what it needs after its name, like its flags: `ports`, `request N`. The tool records the
declaration. Where it can see a port or a request, it fails the build if the declaration is missing:
a literal port address put into A or B, or a kernel request with a literal number. What it cannot see
is the declaration's. This changes `ARTIFACT.md` choice 4's "the tool derives it from the code".