ABI.md, ARTIFACT.md: three drafting additions confirmed
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
This commit is contained in:
+3
-1
@@ -154,6 +154,7 @@ capsule-blocks.md` §5), and Artemis keeping what is kept (ruling 3).
|
||||
`.f18` to artifacts on the build machine. It is a second assembler beside the ROM's, so the two must
|
||||
agree: the tool's output is checked against what the ROM assembles from the same source, cell for cell,
|
||||
in the build and in CI. The compiler's identity in the provenance record is the tool's own hash.
|
||||
The cell-for-cell check was added in drafting; confirmed by Captain Bob, 2026-11-19 ("Yes").
|
||||
2. ~~The stack-effect declaration~~ **Ruled 2026-11-19: "Derived by the tool".**
|
||||
- A first answer, "the ( -- ) comment, strict", was withdrawn the same day. Captain Bob: "I think I may
|
||||
have made a bad assumption. I had the idea of that after (- was aliased to ( is for SDK special. We're
|
||||
@@ -182,7 +183,8 @@ capsule-blocks.md` §5), and Artemis keeping what is kept (ruling 3).
|
||||
scans every node's P and return stack for an address inside the old words' code. When none is there, it
|
||||
writes all of a set's jumps in that one tick. While some are there, it tries again on later ticks. A
|
||||
message waiting for an old word is not code on a stack and does not hold the set back: the word it
|
||||
reaches is the new one.
|
||||
reaches is the new one. That last point was added in drafting; confirmed by Captain Bob, 2026-11-19
|
||||
("Yes").
|
||||
7. ~~Proofs first~~ **Ruled 2026-11-19: "Safe activation first".** The first Isabelle/HOL property:
|
||||
- the jump at each old entry is written only at a tick when no node's P or return stack holds an address
|
||||
inside the old code (choice 6);
|
||||
|
||||
@@ -138,7 +138,8 @@ about the format:
|
||||
4. ~~Capabilities~~ **Ruled 2026-11-19: "Port bit + request list".** As drafted (§5, unit 5). The tool
|
||||
derives it from the code: a port opcode sets the bit, and each kernel request the word reaches goes in
|
||||
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).
|
||||
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").
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user