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;