CLI¶
designed · Phase 1 (#33) · PLAN §22.7, §22.8
The ni tool (PLAN §22.7) does not exist yet. In Phase 1 the harness runs as a project:
dotnet run --project tests/NextIteration.Harness -- <scenario> --seeds N --days M [--out DIR]
dotnet run --project tests/NextIteration.Harness -- <scenario> --seeds 1 --days M --golden --processes 2
dotnet test tests/NextIteration.Harness --filter milestone=phase-1
| Option | Meaning |
|---|---|
<scenario> |
a file in data/scenarios/ by id (village) |
--seeds N |
run seeds 1…N |
--days M |
sim-days per run |
--out DIR |
write summary.md, report.json, chronicle/seed-N.md |
--golden --processes K |
run one seed in K child processes and diff per-tick digests; non-zero exit on the first differing tick |
--intervene "day 3 12:00 ignite inn" |
queue a player action at a world time (the milestone tests do this in code) |
Planned ni surface (later phases): ni new system, ni dev (hot reload), ni test, ni harness (wraps the above), ni build schema (generates WorldSchema.cs and the vocabulary reference), ni package, ni install, ni docs.
Scripts that exist now: scripts/dev.ps1 / dev.sh (start API + client), scripts/check-docs.sh (section references and stale patterns), scripts/check-rates.sh (per-tick literals), scripts/check-determinism.sh (Math.* transcendental calls).