ABI choice 1: artifacts come from a host tool, checked cell for cell against the ROM's assembly

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
This commit is contained in:
Claude
2026-11-19 14:41:22 +00:00
parent f8be000b0a
commit 0c2aab1ab5
+5 -3
View File
@@ -63,7 +63,7 @@ All of it is in cells, so an F18 node can read it.
| Record | Holds | | Record | Holds |
|---|---| |---|---|
| **Header** | a magic number; the ABI version; the cell width (32 or 64); the record counts | | **Header** | a magic number; the ABI version; the cell width (32 or 64); the record counts |
| **Provenance** (ADR §3.1) | the source capsule's hash; the compiler's identity (the ROM's hash, which assembled it); the build configuration's hash (the knobs, `V4_NODE_WORDS`, the rings); the target | | **Provenance** (ADR §3.1) | the source capsule's hash; the compiler's identity (the host tool's hash, choice 1); the build configuration's hash (the knobs, `V4_NODE_WORDS`, the rings); the target |
| **Exports** | for each word: its name, its entry's offset in the code, its flags, its declared stack effect, its capabilities | | **Exports** | for each word: its name, its entry's offset in the code, its flags, its declared stack effect, its capabilities |
| **Imports** | for each word used from another capsule: (that capsule's hash, the name), and the stack effect it is expected to have | | **Imports** | for each word used from another capsule: (that capsule's hash, the name), and the stack effect it is expected to have |
| **Relocations** | every cell of the code whose branch field holds an address, with how to fix it: internal (add the base), or import *k* | | **Relocations** | every cell of the code whose branch field holds an address, with how to fix it: internal (add the base), or import *k* |
@@ -126,8 +126,10 @@ is verified (ADR §5); compatibility is checked against the old artifact's recor
## 9. Open, for ruling one at a time ## 9. Open, for ruling one at a time
1. **Where artifacts come from:** the ROM assembling the source as now, its output kept (the compiler 1. ~~Where artifacts come from~~ **Ruled 2026-11-19: "A host tool".** A C tool beside `mkcapsule` compiles
identity is then the ROM's hash), or a host tool? `.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.
2. **The stack-effect declaration:** written in the source as today's `( a b -- c )` comments, parsed 2. **The stack-effect declaration:** written in the source as today's `( a b -- c )` comments, parsed
strictly, or a new form? strictly, or a new form?
3. **What a capsule carries:** an artifact alone, or the artifact and its source (provenance, ADR §3.1)? 3. **What a capsule carries:** an artifact alone, or the artifact and its source (provenance, ADR §3.1)?