From f2174a39a4867ebe4792b7dbfcd017ffd6648d92 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 16:24:51 +0000 Subject: [PATCH] ABI.md, ARTIFACT.md: three drafting additions confirmed Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/ABI.md | 4 +++- docs/v4.0.0/ARTIFACT.md | 3 ++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/v4.0.0/ABI.md b/docs/v4.0.0/ABI.md index 8456c631..78f30ae3 100644 --- a/docs/v4.0.0/ABI.md +++ b/docs/v4.0.0/ABI.md @@ -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); diff --git a/docs/v4.0.0/ARTIFACT.md b/docs/v4.0.0/ARTIFACT.md index 76048714..4d174e1e 100644 --- a/docs/v4.0.0/ARTIFACT.md +++ b/docs/v4.0.0/ARTIFACT.md @@ -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.