From b5e85392c1232f5db7926367d7f17159d820deff Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 16:30:24 +0000 Subject: [PATCH] =?UTF-8?q?plans:=20step=203=20=C2=A76.3=20ruled,=20all=20?= =?UTF-8?q?it=20finds,=20name=20order?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm --- docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) 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 25d83a12..0502555c 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 @@ -30,9 +30,9 @@ existing build system". It builds on: A C tool beside `mkrom.c`, built the same way, one per cell width: - mkf18a OUT.f18a MAP.f18 SOURCE.f18... + mkf18a OUT.f18a MAP.f18 DIR -1. It assembles the sources with `text.c`, at origin 0, in the order given. +1. It assembles every `.f18` in DIR with `text.c`, at origin 0, in name order (ruled §6.3), after MAP. 2. It writes the artifact, laid out as `ARTIFACT.md` gives: - the header; - the provenance, with its four SHA-512 hashes; @@ -111,7 +111,9 @@ ADR step 8 asks. The boot gains nothing. artifacts. The nucleus is checked as the tool's assembly against the ROM's, and no artifact file is written for it. `ABI.md` §4 stands. Is the nucleus the first artifact, or is a small relocatable train written first? -3. **The order of the sources.** Captain Bob's image is "the .f18 assembler assembles all .f18 files it +3. ~~The order of the sources~~ **Ruled 2026-11-19: "All it finds, name order".** The tool takes every + `.f18` in a train's directory, sorted by name, so the file names set the order (`00-core.f18`, ...) and + there is no list to keep. As asked: Captain Bob's image is "the .f18 assembler assembles all .f18 files it finds", but the order matters: the map first, `sys_files.h`'s list, `end.f18` last. Does each train name its order in a list, as `sys_files.h` does, or does the tool take the files in name order? 4. **Which words are exports.** The nucleus defines hundreds of words, and some have no fixed effect, which