For: researcher
Port Fidelity Workflow
Use the C oracle, deterministic seams, and five governing rules to prove behavioral parity.
Dark Pawns is a faithful port, not a reinterpretation. The original reachable C path decides game behavior; differential scenarios prove the Go server against it.
The five rules
The full Port Rulebook defines:
- R1: player-facing bytes are law.
- R2: command names, aliases, gates, and positions are part of the game.
- R3: random draw counts, time, and operation order must match.
- R4: do not invent player-observable behavior.
- R5: verify the reachable call path, prove fixes, and audit repeated failure classes.
Set up the oracle
The complete workstation procedure is maintained in docs/DEV-SETUP.md. It builds the separate read-only C oracle and points DP_ORACLE_BIN at its executable.
Run a scenario
DP_ORACLE_BIN=/path/to/darkpawns-c-oracle/bin/circle \
DP_SEED=1 DP_FRESH_MUD=1 \
go run ./cmd/dp-oracle-diff --scenario mortal-batch14
Read the reported result: line; the harness may exit successfully even when it reports a divergence. Random outcomes require validation of underlying rolls or multiple samples, not a single coincidentally matching result.
Preserve the authority boundary
Never edit src/ or the oracle to make Go pass. A confirmed repeated pattern changes the rulebook and triggers a class-wide audit. A suspected mismatch is not confirmed until its real call path is shown to be reachable.