From 33bd83547423589f030e2a2447c41a665fbf593c Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 20 Nov 2026 00:21:36 +0000 Subject: [PATCH] plans, ARTIFACT.md: task 3's six drafting choices ruled, each kept as drafted The hash framing and what each provenance hash covers (choices 1, 2, now in ARTIFACT.md section 4), the pool's unit 0, a literal store to (PORT) as a request, capabilities through calls, and the import placeholders at the node's top. Held locally until #198 merges. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/ARTIFACT.md | 6 ++++++ docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md | 2 +- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/v4.0.0/ARTIFACT.md b/docs/v4.0.0/ARTIFACT.md index 511f4838..10d17be3 100644 --- a/docs/v4.0.0/ARTIFACT.md +++ b/docs/v4.0.0/ARTIFACT.md @@ -67,6 +67,12 @@ Each hash is SHA-512 (choice 2). | 32–47 | the build configuration's hash: the knobs that change code, the cell width, `V4_NODE_WORDS`, the rings | | 48–63 | the ROM's hash it must agree with: the tool's output is checked against the ROM's assembly | +**How each hash is taken** (ruled 2026-11-20, "Keep as drafted": plan 2026-11-19-f18-artifact-build §11, +choices 1 and 2). Each input is framed as its name, a NUL, its length in 8 bytes low first, then its +bytes, so two inputs cannot run together. The tool's hash covers its own sources and every `include/v4` +header, in a fixed order. The configuration's covers the sizes as text, framed as `config`, then the map. +The ROM's covers the ROM file. `v4/tools/f18a.h` names the files. + ## 5. Exports, imports, relocations **An export (8 units):** 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 20c9707e..65f62b42 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 @@ -275,7 +275,7 @@ of the checker, and of the tool (r1-r9 refused, r10 built). **The test's own error.** A name meant to be 32 characters, to be refused, was 31 and was taken; the test was corrected, not the tool. -**Choices made in drafting, for ruling:** +**Choices made in drafting.** Ruled 2026-11-20, each "Keep as drafted", one at a time: 1. The provenance hashes frame each input as its name, a NUL, its length in 8 bytes low first, then its bytes (`f18a.h`). 2. The tool's hash covers `tools/mkf18a.c`, `tools/f18a.c`, `tools/f18a.h`, `src/artifact.c`, `asm.c`,