From d6b894769cce82cf1132fbe3a4489f8a4e002ead Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 19:48:24 +0000 Subject: [PATCH] plans, ARTIFACT.md: task 3 ruling, capabilities declared, then checked Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/ARTIFACT.md | 4 ++++ docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md | 6 ++++++ 2 files changed, 10 insertions(+) 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".