From 46b131fe84b523e98c47e8e33bff116a44141855 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 9 Nov 2026 17:16:03 -0500 Subject: [PATCH] Devlog: first build run Co-Authored-By: Claude Opus 5.5 --- docs/DEVLOG.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/DEVLOG.md b/docs/DEVLOG.md index 9ea50dd..1750737 100644 --- a/docs/DEVLOG.md +++ b/docs/DEVLOG.md @@ -2,3 +2,31 @@ Newest entries at the bottom. Each entry records what was done, test results, decisions, and what's next. + +## 2026-11-09: first build run + +**Done:** F1 skeleton and pinned engine, F2 GDD and originality rules, F3 architecture, +F4 test harness, F5 simulation core. Commits were made in the order F1, F4, F2, F3, F5, +because F2 and F3 add tests that need F4's runner. + +**Tests:** `make check` passes: engine verified, 18 scripts parsed, 38 tests pass, and +all 8 self-check fixtures behave as expected. The determinism test replays a log of 24 +players over 10,000 ticks. + +**Decisions:** +- The test runner uses Godot's `Logger` API (`OS.add_logger`), so engine and script + errors during a test fail that test, without having to scrape output. +- The tuning table is `src/sim/tuning.gd`, as constants, because a misspelled name is a + parse error. The GDD refers to numbers by constant name, so it can't go stale. +- `tools/godot.sh` forces `--headless` and keeps engine data in `.godot-home/`. F7 can set + `TIDEWALL_GODOT_DISPLAY=1` inside its container only. +- Untyped declarations are errors, set in `project.godot`. +- `.gitattributes` can't filter by size, so `tools/check_binaries.sh` fails `make check` + on any tracked binary over 1 MB that isn't in LFS. +- Player movement in `Simulation` is a flat placeholder until v0.2 replaces it. +- Scanning for unseeded randomness uses a regex that tells `randf()` from a seeded + `stream.randf()`. Only `sim_rng.gd` may create a generator. + +**Known gaps:** the LFS push path hasn't been exercised, as nothing is in LFS yet. + +**Next:** F6 headless server and `make smoke`, then F7 capture harness.