diff --git a/docs/v4.0.0/ABI.md b/docs/v4.0.0/ABI.md index 95b544df..1583ac02 100644 --- a/docs/v4.0.0/ABI.md +++ b/docs/v4.0.0/ABI.md @@ -176,6 +176,9 @@ capsule-blocks.md` §5), and Artemis keeping what is kept (ruling 3). the train it imports from: (its capsule hash, the word's name). If that train is rebuilt or updated, its hash changes, so its importers are rebuilt too, and a live update replaces the whole dependent set of trains together. Placement refuses an import whose hash is not present. + **Ruled 2026-11-19 (step 3, `plans/2026-11-19-f18-artifact-build.md` §10.4):** a train's hash is its + `.f18a`'s capsule ID. The nucleus has none, so a word imported from it has hash 0 and is resolved by name + in the node's dictionary at placement; exact hashes hold between artifact trains only. 5. ~~How callers reach a replacement~~ **Ruled 2026-11-19: "Jump at the old entry".** At activation, each replaced word's first code cell, at its xt, is overwritten with a `jump` to the new word: one cell per word, and every caller, compiled at run time or not, follows at once. The old code stays in place, 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 8638ed9f..a85403c4 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 @@ -236,3 +236,8 @@ this is a measure of the analysis, not an interface. 3. **Imports: "An import line"** (2026-11-19). `import TRAIN NAME` declares NAME as from the train TRAIN, before it is used. The tool takes TRAIN's capsule hash, and the word's derived effects, from that train's build, so the build fails if TRAIN does not export NAME. Each call to NAME is a relocation to its import. +4. **A train's capsule hash: "Its .f18a's capsule ID"** (2026-11-19). A train is identified by its engine: + the capsule ID `mkcapsule` gives its `.f18a`. The nucleus has none (§6.2a), so a word imported from it + 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.