Skip to main content

Module event

Module event 

Source
Expand description

The event log — the game state is this append-only stream.

Two principles from DESIGN.md §6 shape what gets recorded:

  1. Record resolved values, not raw inputs. GameStarted carries the generated world snapshot, not just the seed: if only the seed were stored and the world re-derived on load, any improvement to worldgen would silently corrupt every old save — the same failure mode as re-parsing raw LLM text. Worldgen is an edge producer whose output is the recorded input.
  2. Record outcomes the fold consumes without re-running engines. MatchPlayed carries the result; replay folds over it and never re-simulates, so upgrading the match engine (Phase 2) can never rewrite history. Live play produces these events via step; replay just eats them. This is exactly how recorded agent Decisions will enter in Phase 5 — human lineups (LineupSubmitted) already follow the pattern.

Enums§

Event