feat: add Jajce world scaffold

2026-07-04 21:06:57 +02:00
parent 83fc258afc
commit 556d0fdc26
19 changed files with 545 additions and 0 deletions
@@ -0,0 +1,46 @@
+# Flat-map baseline
+
+- **Captured:** 2026-07-04
+- **Scene:** `res://main.tscn`
+- **Automated check:** `res://tests/flat_map_baseline_test.gd`
+- **Companion resource test:** `res://tests/resource_node_player_parity_test.gd`
+
+## Contract
+
+The flat prototype remains the regression reference while `JajceWorld` is
+developed separately.
+
+The automated baseline verifies:
+
+- the scene creates three simulated NPCs;
+- four stable-ID ResourceNodes register;
+- three fixed origins can reach the four remaining activity markers and four
+  ResourceNode interaction points (24 route checks);
+- a two-tick working task completes;
+- starvation still reaches death at its configured threshold.
+
+The companion player-parity scenario verifies:
+
+- player food extraction conserves the actual remaining amount;
+- player wood extraction uses the configured yield;
+- player depletion releases an NPC reservation.
+
+## Commands
+
+```powershell
+& "C:\Program Files (x86)\Godot\Godot_v4.5.1-stable_win64_console.exe" `
+  --headless --path . --script res://tests/flat_map_baseline_test.gd
+
+& "C:\Program Files (x86)\Godot\Godot_v4.5.1-stable_win64_console.exe" `
+  --headless --path . --script res://tests/resource_node_player_parity_test.gd
+```
+
+Godot 4.5.1 is the locally available validation runtime. The project currently
+declares Godot 4.7 features, so final editor validation should also be performed
+with the project version when available.
+
+## Purpose
+
+This baseline protects behavior, not visual composition. Terrain, lighting,
+camera framing, and placeholder geometry may change. A Jajce migration is a
+regression if it breaks these contracts without an explicit replacement test.