From bc876f808831d46046f0af2a5b7a4e35541a02d3 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 14:51:53 +0000 Subject: [PATCH] ABI choice 4: imports name the exact build (capsule hash); an update replaces the dependent set together Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/ABI.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/v4.0.0/ABI.md b/docs/v4.0.0/ABI.md index 7b676ebe..99986ddd 100644 --- a/docs/v4.0.0/ABI.md +++ b/docs/v4.0.0/ABI.md @@ -151,8 +151,10 @@ stock." Ruled "One train per capsule" (ยง1). hash of the `.f18` source it was assembled from, in its provenance record. The source stays in the repository and in its own capsule. To check an engine against its source, the source is fetched by that hash. -4. **Imports by capsule hash:** a hash pins one exact build. Is an import of an older build of the same - capsule a mismatch, or is the name of the capsule enough with the stack effect checked? +4. ~~Imports by capsule hash~~ **Ruled 2026-11-19: "Exact hash".** An import names the exact build of + 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. 5. **How callers reach a replacement:** - (a) the old entry's code is overwritten by a `jump` to the new: one cell, every caller follows, and the old code is unreachable but for that cell;