From 913b74a631d9e9083d89ad6f40e5682f2e34331f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 14:50:48 +0000 Subject: [PATCH] ABI choice 2c: a word with no fixed stack effect cannot be exported; every export has a fixed, derived effect Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/ABI.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/v4.0.0/ABI.md b/docs/v4.0.0/ABI.md index bf78f43a..2a50ccc3 100644 --- a/docs/v4.0.0/ABI.md +++ b/docs/v4.0.0/ABI.md @@ -143,9 +143,10 @@ stock." Ruled "One train per capsule" (§1). - **There is no declaration in the source.** The host tool computes each exported word's stack effect from its compiled code, by static analysis of the F18 opcodes, and records it in the artifact. The proofs check it. Comments stay comments. - - **Open within it (2c):** a word whose effect depends on its data (a loop, a branch that leaves - different depths, `EXECUTE`) has no fixed count. What the tool records for such a word is a question - of its own, asked again now that each capsule is a train. + - **2c, ruled 2026-11-19: "Refused as an export".** A word whose effect depends on its data (a loop + leaving a count of values, branches that leave different depths, `EXECUTE`, a `DEFER`red word) has no + fixed count. It cannot be exported by an engine: it stays internal to its train, or is restructured. + Every export has a fixed effect, which the tool derives and the build fails without. 3. **What a capsule carries:** an artifact alone, or the artifact and its source (provenance, ADR §3.1)? 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?