save

Signed-off-by: Onur Özkan <work@onurozkan.dev>

ground-suite/docs/FAKE_SCENARIOS.md

@@ -0,0 +1,20 @@
+# Deterministic fake scenarios
+
+The default seed (`17`) creates Coastal Survey / ALPHA-17, five operators,
+five groups, fifty vehicles, six archetypes, tasks, queues, authority leases,
+and a common initial event history. Positions, energy, link quality, and
+headings are reproducible.
+
+The virtual clock supports pause, resume, restart, 0.5×–4× UI speed, and
+manual stepping in tests. A 100 ms source cadence models 10 Hz vehicle input;
+the data plane batches subscriber notification. Deterministic tick windows
+exercise packet staleness, ALPHA navigation degradation and coverage loss,
+source degradation, and recovery. BRAVO starts near constraint R-210B.
+
+Recovery ranks compatible reserve candidates from energy, link, distance, and
+capability. The recommendation remains a preview until the operator confirms;
+the alert is marked resolved only by the acknowledged simulated command event.
+Restart reconstitutes the exact seed and clears the data-plane ordering state.
+
+Tests construct the source with automatic timers disabled and call `step`, so
+no assertion depends on wall-clock scheduling.