diff --git a/docs/v4.0.0/ARTIFACT.md b/docs/v4.0.0/ARTIFACT.md index 1dc7ff42..511f4838 100644 --- a/docs/v4.0.0/ARTIFACT.md +++ b/docs/v4.0.0/ARTIFACT.md @@ -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 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"). + **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 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. diff --git a/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md b/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md index a85403c4..9520fefe 100644 --- a/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md +++ b/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md @@ -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 (`ABI.md` choice 4) hold between artifact trains only. Asked because a capsule today is one file, and 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".