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`,