v0.4.1 - bug fixes. initial d12 rolls determine what player in which seat.

docs/architecture/components.md

@@ -35,7 +35,7 @@ decision (you are the Superintendent, ruling on your own trains).
 | Turn arbitration between players | Card catalogue |
 | Presence, reconnection of others | Track graph and Move legality |
 | Fedora rotation between players | Board and action UI |
-| Competitive/Co-op victory modes | Event log and persistence |
+| Competitive/Co-op victory modes | Intent history and persistence |
 | Collision floor (Competitive only) | Server and protocol |
 
 **Consequence: the engine is the dominant cost and it is front-loaded.** Components 4–6 barely differ
@@ -141,11 +141,12 @@ is what makes the whole system testable without a server.
 - **Size driver:** at MVP one game and one player, so the pump loop is nearly all of it. Grows with
   concurrent games and per-player routing.
 
-**9. Event log and persistence**
+**9. Intent history and persistence**
 
 - **Where:** Server · **When:** append per event; full read on startup
-- **Does:** append-only log to disk; state is `fold(events)`. Powers restart recovery at MVP, and
-  later reconnection and the replay viewer.
+- **Does:** append-only `{ engineVersion, seed, config, history: Intent[] }` to disk. Restart recovery
+  is `fromSave` over the stored intents; the replay viewer reads the same file
+  ([`protocol.md`](protocol.md) §3 — events narrate, intents reconstruct).
 - **MVP: S** · **Final: M** · ~100 → ~350 LOC
 - **Size driver:** an append and a read-back. Grows with snapshotting, retention and indexing.
 
@@ -180,7 +181,7 @@ is what makes the whole system testable without a server.
 
 - **Where:** Server · **When:** once, at process start
 - **Does:** reads environment configuration (bind address, port, data directory), opens or creates the
-  event log, constructs the session host and transport, wires them together, handles shutdown.
+  intent history, constructs the session host and transport, wires them together, handles shutdown.
 - **MVP: XS** · **Final: S** · ~80 → ~200 LOC
 - **Size driver:** trivial in itself, but it is where
   [`deployment.md`](deployment.md)'s five portability rules are actually enforced — single process
@@ -223,9 +224,9 @@ is what makes the whole system testable without a server.
 **16. Replay viewer**
 
 - **Where:** Browser · **When:** after a game ends — **pulled forward, built**
-- **Does:** read-only projection over the event log, with playback controls. A Node script
-  precomputes one frame per visible event and writes a self-contained HTML file, so the browser
-  never runs the engine and there is no bundling or build step.
+- **Does:** read-only playback of a stored game, with controls. A Node script replays the saved
+  intents, precomputes one `Frame` per visible event with its narration, and writes a self-contained
+  HTML file — so the browser never runs the engine and there is no bundling or build step.
 - **MVP: —** · **Final: S** · 0 → ~250 LOC · *built: 560 LOC (replay) + 330 (narration)*
 - **Size driver:** the narration layer, not the rendering. Turning 30 event types into readable
   sentences and deriving the "what is currently blocked" panel is most of it.
@@ -304,7 +305,7 @@ under.
     [4]apply [5]advance [6]legalActions
       └───────┼───────┘
               ▼
-        [8] session host ──► [9] event log
+        [8] session host ──► [9] intent history
               │
               ▼
         [10] view projection
@@ -393,7 +394,7 @@ Crew Tray onto a card holding two standing cars, which couples them automaticall
 | 4 | Apply | Validates the Move via component 3; rejects with `WOULD_REVERSE` / `NOT_OPERATIONAL_RAIL` / `TRACK_OCCUPIED` if illegal. |
 | 3 | Track graph | Confirms the path exists without a direction change. |
 | 4 | Apply | Moves the tray, couples the standing cars **in track order**, checks the four-slot limit, decrements Moves. Emits `TrayMoved` and `CarsCoupled`. |
-| 9 | Event log | Appends both events to disk. |
+| 9 | Intent history | Appends the accepted `switch.move` intent to the game's history on disk. |
 | 8 | Session host | Calls `advance` — no automatic work is due mid-Local-Ops, so it returns `needsInput`. |
 | 10 | View projection | Rebuilds the view. Nothing is redacted here; the board is public. |
 | 6 | Legal-action enumeration | Recomputes affordances from the new state — fewer Moves remain, and a fuller consist may now be at its four-slot limit. |