Files
tidewall/docs/DEVLOG.md
T
2026-11-09 17:16:03 -05:00

33 lines
1.6 KiB
Markdown

# Tidewall development log
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.