`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
24 lines
999 B
C++
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
|