fa86739ac2
Full single-client capture replay (cl1 send=player seat, receive=opponent seat, ts-ordered) ingests end-to-end: 33 frames, 0 rejects, 0 invariant violations at turn boundaries (leader life/PP/board/hand). Headless gaps filled per playbook (no Engine/ drift): - IsRecovery=true after construction: the engine's own headless replay mode gates the live view/UI layer off (BattleUIContainer, turn-control UI, VFX waits) while keeping the live NetworkBattleReceiver (ND4) and authoritative state. - Seed ToolboxGame.RealTimeNetworkAgent, BattleUIContainer, _backGround, and per-player NullPlayerEmotion no-ops the receive/turn cycle dereferences. - _IfaceImpl.g.cs (shim, not Engine/): BattleCardView.BattleCardIconAnimations returns a lazy non-null no-op so the opponent card-reveal icon-init (deferred VFX) doesn't NRE. - HeadlessCardMaster.Load made cumulative: it replaced the global CardMaster each call, so a Load(deck) evicted the oracle card set and broke tests run after. Adds board-state accessors (LeaderLife/Pp/HandCount/BoardCount) and CaptureReplay ts ordering. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
SVSim.BattleNode
Socket.IO node-server emulation for in-battle real-time traffic — the second of prod's 4-server
topology. Handles Matched / BattleStart / Deal / per-action PlayActions / Echo /
TurnEnd between a client and a server-side opponent, for TK2 PvP and AI rank battles.
Documentation lives in the outer repo
This project's canonical reference is a single hub doc in the outer SVSim repo (this directory is an inner git repo, so the doc isn't tracked alongside the code):
→ docs/battle-node.md (from the SVSim root) — architecture, the dispatch matrix by battle
type, connect handshake + crypto, BattleFinish wire-result semantics, SIO/EIO event coverage,
reliability (pubSeq/playSeq/Gungnir), wire-format gotchas, where-to-extend, the manual smoke
walkthrough, and the consolidated open-items list.
Relative path from here: ../../../docs/battle-node.md.
Detailed per-URI wire shapes are in docs/api-spec/in-battle/; the hub links into them.
Keep docs/battle-node.md updated in the same change whenever you alter node behavior.