v4: init.4th and the ACL at call; the F18 ADR, ABI and artifact layout; ADR step 3 tasks 1-3 (mkf18a) #198

Open
rajames wants to merge 52 commits from StarForth-v4.0.0 into master
2 changed files with 10 additions and 0 deletions
Showing only changes of commit d6b894769c - Show all commits
+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
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.
@@ -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".