sots-engine/src/app/report.h
alex 39c01422f7 src/app: the standalone -- load a save, run a turn, write a save
`sots_turn` loads a save through the engine's own reader, walks the published
phase order of all three turn drivers, runs what we hold, prints what we do
not, and writes the result back through the engine's own writer.

The phase catalog carries all 32 + 12 + 37 phases whether or not they are
implemented, so an unimplemented phase is a named no-op that appears in the run
log rather than a silent absence. 14 of the 44 turn-driver phases are modelled,
7 commit anything, 2 of the 37 tail phases are modelled.

Modelled but NOT committed is a first-class state. A phase whose formula we hold
and whose inputs we do not is evaluated, reported, and left unwritten unless
--commit-blocked is passed. That distinction was earned: committing phase 31's
player-status restore regressed two leaves that had agreed with the oracle
before the turn, because the phase writes 1 and the file carries 4.

Measured against the game's own post-turn saves, leaves localised by
state_checksum.py with coverage proved by re-serialisation:

  turn1-state -> turn2-state   209 -> 204 diverging, closed 5, regressed 0
  turn2-state -> turn3-state   108 -> 103 diverging, closed 5, regressed 0

Two tests: app_catalog (the tables stay complete and nothing claims to be
verified against a live game) and app_turn (11 saves driven; an untouched load
re-serialises byte-identically, a turn leaves the file re-readable, and no
blocked or stub phase writes anything). Skips cleanly without SOTS_SAVES_DIR.

ctest 38/38, clean-room OK. src/shim untouched. docs/S-standalone.md has the
full gap list.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ARBgSooAfokKUy6wKUKEyZ
2026-09-08 10:35:45 -04:00

24 lines
999 B
C++

// Run reporting: the phase log a human reads, and the machine-readable completion metric.
#pragma once
#include <cstdio>
#include <string>
#include "app/turn.h"
namespace sots::app {
// The phase table with this run's numbers, in execution order. Every phase appears --
// including the ones that did nothing -- because the point of the listing is the gap.
void PrintPhaseLog(std::FILE* out, const TurnResult& r, bool verbose);
// A one-screen summary: how many phases of each driver we hold, and how much this run moved.
void PrintSummary(std::FILE* out, const TurnResult& r);
// The completion metric, as JSON, for the campaign dashboard. Written to `path`; the
// divergence numbers are filled in by the comparison tool that runs the checksum diff, so
// this file carries only what the standalone itself knows.
bool WriteMetricJson(const std::string& path, const TurnResult& r, const std::string& inputName,
const std::string& outputName);
} // namespace sots::app