using System; using System.Collections.Generic; using System.Linq; using System.Text.Json; using System.Text.Json.Nodes; using NUnit.Framework; using SVSim.BattleNode.Protocol; using SVSim.BattleNode.Sessions.Engine; namespace SVSim.BattleEngine.Tests.SessionEngine { /// /// PHASE 4 — DRAW-RECOMPUTE ROOT-CAUSE VALIDATION (TEST-ONLY; no production fix; no Engine/*.cs edits). /// /// HYPOTHESIS (from the experiment brief): the shadow diverges ("Target card was not found in hand /// cards", post-mulligan) because the per-turn network DRAW is a SEEDED-RANDOM pick from the deck via /// mgr.StableRandom(...) (SkillRandomSelectFilter.Filtering:49/58), gated by the process-global /// BattleManagerBase.IsRandomDraw — which the real match-load sets true via /// StartOpening → SetupInitialGameState(areCardsRandomlyDrawn:true) (BattleManagerBase.cs:1098/1110). /// The headless .Setup never runs SetupInitialGameState, so IsRandomDraw /// stays FALSE and the shadow draws TOP-OF-DECK while the clients draw seeded-random → mismatch. /// AND the shared _stableRandom stream must be advanced by the wire spin pre-roll the Ready /// frame carries (spin=243), which OperateReceive.StartOperate:80-83 applies but the shadow never /// ingests — so without it the stream is offset. /// /// ISOLATION MATRIX (this is the report's headline): setup frames + real seed are held CONSTANT (the /// faithful baseline the prior FullInput experiment pinned at 14); the two NEW variables are toggled: /// • {IsRandomDraw=false, no spin} = baseline (top-of-deck draws; the live shadow's effective state) /// • {IsRandomDraw=true, no spin} = random-draw active but stream MIS-aligned (expect WORSE) /// • {IsRandomDraw=true, +spin} = random-draw active AND stream aligned (the hypothesised fix) /// /// SPIN APPLICATION: spin=243 appears on the Ready frame in BOTH captures (each client applies its own /// once). Our shadow shares ONE _stableRandom across both seats (seated as both players), and a /// single client's stream sits 243 draws in after ITS Ready — so we apply spin=243 ONCE, after the /// Deal/Swap/Ready setup frames and before the plays, exactly where the real client's StartOperate would. /// (A scan of both fixtures confirms Ready is the ONLY frame carrying a non-zero spin.) /// [TestFixture] [NonParallelizable] public class CaptureReplayRandomDrawSpinRootCauseTests { private const int SeatASeed = 1430655717; // cl1 / seat A / player (Ready idxChangeSeed) private const int SeatBSeed = 661650374; // cl2 / seat B / opponent private const int WireSpin = 243; // both captures' Ready frame spin private static readonly HashSet SkipUris = new() { nameof(NetworkBattleUri.Echo), nameof(NetworkBattleUri.ChatStamp), nameof(NetworkBattleUri.Gungnir), }; private sealed record HandDump(string Seat, int PlayIdx, string Uri, string Reason, int StableRandomCount, IReadOnlyList<(int Index, int CardId)> SelfHand, IReadOnlyList<(int Index, int CardId)> OppoHand, bool PlayIdxInSelfHand, bool PlayIdxInOppoHand); private sealed record Cell(bool RandomDraw, bool Spin, int Divergences, HandDump? FirstNotFound); private static int ReadPlayIdx(string rawBody) { using var doc = JsonDocument.Parse(rawBody); return doc.RootElement.TryGetProperty("playIdx", out var p) && p.TryGetInt32(out var v) ? v : -1; } private static List<(int, int)> HandSnapshot(SessionBattleEngine engine, bool seat) { var list = new List<(int, int)>(); int n = engine.HandCount(seat); for (int i = 0; i < n; i++) list.Add((engine.HandCardIndex(seat, i), engine.HandCardId(seat, i))); return list; } private static CapturedFrame Receive(IReadOnlyList frames, string uri) => frames.First(f => f.Direction == "receive" && f.Uri == uri); private static Cell Run(bool randomDraw, bool spin) { var cl1 = CaptureReplay.Load("battle_test_fresh_cl1.ndjson"); var cl2 = CaptureReplay.Load("battle_test_fresh_cl2.ndjson"); var deckA = CaptureReplay.SelfDeckFrom(cl1); var deckB = CaptureReplay.SelfDeckFrom(cl2); Assert.That(deckA, Is.Not.Empty); Assert.That(deckB, Is.Not.Empty); var engine = new SessionBattleEngine(); engine.Setup(masterSeed: CaptureReplay.SeedFrom(cl1), seatADeck: deckA, seatBDeck: deckB); Assert.That(engine.IsReady, Is.True); // CONSTANT across all cells: faithful seed seam (both seats' XorShift active), sidestepping the // seat-B Ready NRE — identical to the FullInput experiment's full-inputs cell. engine.DebugSeedIdxChange(SeatASeed, SeatBSeed); // NEW VARIABLE 1: the IsRandomDraw gate. Set BEFORE any draw (deal is the first draw). engine.DebugSetRandomDraw(randomDraw); int divergences = 0; HandDump? firstNotFound = null; void Ingest(MsgEnvelope env, bool seat, string uri, string rawBody) { var r = engine.Receive(env, isPlayerSeat: seat); if (!r.Diverged) return; divergences++; if (firstNotFound is null && (r.RejectReason ?? "").Contains("not found in hand")) { var self = HandSnapshot(engine, seat); var oppo = HandSnapshot(engine, !seat); int playIdx = ReadPlayIdx(rawBody); firstNotFound = new HandDump( seat ? "A" : "B", playIdx, uri, Trim(r.RejectReason), engine.DebugStableRandomCount, self, oppo, self.Any(h => h.Item1 == playIdx), oppo.Any(h => h.Item1 == playIdx)); } } // --- Phase 1: setup frames (CONSTANT: Deal once + each seat's Swap + Ready) ------------------- var deal = Receive(cl1, nameof(NetworkBattleUri.Deal)); Ingest(deal.Env, seat: true, nameof(NetworkBattleUri.Deal), deal.RawBody); foreach (var (frames, seat) in new[] { (cl1, true), (cl2, false) }) { var swap = Receive(frames, nameof(NetworkBattleUri.Swap)); Ingest(swap.Env, seat, nameof(NetworkBattleUri.Swap), swap.RawBody); var ready = Receive(frames, nameof(NetworkBattleUri.Ready)); Ingest(ready.Env, seat, nameof(NetworkBattleUri.Ready), ready.RawBody); } // NEW VARIABLE 2: the spin pre-roll, applied at mulligan-end (after Ready, before the first // turn-start draw) — where OperateReceive.StartOperate applies the Ready's spin in production. // ONE application of 243 (shared stream, one client's worth of advance). if (spin) engine.DebugSpinPreroll(WireSpin); // --- Phase 2: replay both clients' interleaved SENDS (the plays) ------------------------------ var sends = SendsWithRawBody(cl1, cl2) .Where(x => !SkipUris.Contains(x.Frame.Uri)) .ToList(); foreach (var x in sends) Ingest(x.Frame.Env, x.Seat, x.Frame.Uri, x.Frame.RawBody); return new Cell(randomDraw, spin, divergences, firstNotFound); } private static IEnumerable<(CapturedFrame Frame, bool Seat)> SendsWithRawBody( IReadOnlyList cl1, IReadOnlyList cl2) { return cl1.Where(f => f.Direction == "send").Select(f => (f, Seat: true)) .Concat(cl2.Where(f => f.Direction == "send").Select(f => (f, Seat: false))) .OrderBy(x => x.f.Ts) .Select(x => (x.f, x.Seat)); } private static string Trim(string? s) => (s ?? "").Split(" @ ")[0]; [Test] public void IsRandomDraw_plus_spin_preroll_isolation_matrix() { try { ConfirmSpin(); var baseline = Run(randomDraw: false, spin: false); var rdOnly = Run(randomDraw: true, spin: false); var rdSpin = Run(randomDraw: true, spin: true); TestContext.WriteLine("=== ISOLATION MATRIX (setup-frames + real-seed held CONSTANT) ==="); TestContext.WriteLine("IsRandomDraw | spin | divergences"); TestContext.WriteLine($" false | no | {baseline.Divergences}"); TestContext.WriteLine($" true | no | {rdOnly.Divergences}"); TestContext.WriteLine($" true | +243 | {rdSpin.Divergences}"); DumpFirst("baseline {false,no}", baseline); DumpFirst("rd-only {true,no}", rdOnly); DumpFirst("rd+spin {true,+243}", rdSpin); Assert.Pass( $"MATRIX baseline={baseline.Divergences} rdOnly={rdOnly.Divergences} rdSpin={rdSpin.Divergences}"); } catch (SuccessException) { throw; } catch (Exception ex) { TestContext.WriteLine("EXPERIMENT THREW: " + ex); throw; } } private static void DumpFirst(string label, Cell c) { if (c.FirstNotFound is not { } d) { TestContext.WriteLine($"[{label}] no 'not found in hand' divergence."); return; } TestContext.WriteLine($"[{label}] FIRST 'not found in hand': seat={d.Seat} uri={d.Uri} " + $"wire playIdx={d.PlayIdx} stableRandomCount={d.StableRandomCount} reason={d.Reason}"); TestContext.WriteLine($" playIdx in self hand? {d.PlayIdxInSelfHand} in oppo hand? {d.PlayIdxInOppoHand}"); TestContext.WriteLine($" SELF (seat {d.Seat}) hand [{d.SelfHand.Count}]: " + string.Join(" ", d.SelfHand.Select(h => $"(idx={h.Index},cid={h.CardId})"))); TestContext.WriteLine($" OPPO hand [{d.OppoHand.Count}]: " + string.Join(" ", d.OppoHand.Select(h => $"(idx={h.Index},cid={h.CardId})"))); } /// STEP 4 (payoff check): with the hypothesised fix applied {IsRandomDraw=true, +spin}, /// does the engine reach and RESOLVE cl1's spellboost play so PlayedCardSpellboost/PlayedCardCost /// return real (non-zero) values? cl1's deck carries the spellboost-scaling follower 101314020 at /// deck idx 10/21/25. We replay the {true,+243} cell and, after each accepted seat-A PlayActions, /// probe whether any in-play/cemetery card has that id with a resolved cost/spellboost. We report /// whether the spellboost play was ever reached at all. [Test] public void Spellboost_play_resolution_under_random_draw_plus_spin() { const int SpellboostCardId = 101314020; var cl1 = CaptureReplay.Load("battle_test_fresh_cl1.ndjson"); var cl2 = CaptureReplay.Load("battle_test_fresh_cl2.ndjson"); var deckA = CaptureReplay.SelfDeckFrom(cl1); var deckB = CaptureReplay.SelfDeckFrom(cl2); var engine = new SessionBattleEngine(); engine.Setup(masterSeed: CaptureReplay.SeedFrom(cl1), seatADeck: deckA, seatBDeck: deckB); engine.DebugSeedIdxChange(SeatASeed, SeatBSeed); engine.DebugSetRandomDraw(true); // setup frames engine.Receive(Receive(cl1, nameof(NetworkBattleUri.Deal)).Env, isPlayerSeat: true); foreach (var (frames, seat) in new[] { (cl1, true), (cl2, false) }) { engine.Receive(Receive(frames, nameof(NetworkBattleUri.Swap)).Env, isPlayerSeat: seat); engine.Receive(Receive(frames, nameof(NetworkBattleUri.Ready)).Env, isPlayerSeat: seat); } engine.DebugSpinPreroll(WireSpin); int acceptedSeatAPlays = 0, divergedBeforeFirstPlay = 0; bool spellboostResolved = false; int sbCost = -999, sbCharge = -999; var sends = SendsWithRawBody(cl1, cl2).Where(x => !SkipUris.Contains(x.Frame.Uri)).ToList(); bool sawFirstPlay = false; foreach (var x in sends) { bool isPlay = x.Frame.Uri == nameof(NetworkBattleUri.PlayActions); var r = engine.Receive(x.Frame.Env, isPlayerSeat: x.Seat); if (isPlay && !sawFirstPlay) { sawFirstPlay = true; if (r.Diverged) divergedBeforeFirstPlay++; } if (isPlay && x.Seat && !r.Diverged) { acceptedSeatAPlays++; int playIdx = ReadPlayIdx(x.Frame.RawBody); long id = engine.PlayedCardId(true, playIdx, 0); if (id == SpellboostCardId) { spellboostResolved = true; sbCost = engine.PlayedCardCost(true, playIdx, -1); sbCharge = engine.PlayedCardSpellboost(true, playIdx, -1); break; } } } TestContext.WriteLine($"[spellboost payoff] acceptedSeatAPlays={acceptedSeatAPlays} " + $"divergedAtFirstPlay={divergedBeforeFirstPlay} spellboostResolved={spellboostResolved} " + $"cost={sbCost} charge={sbCharge}"); // The replay diverges at the FIRST seat-A play (matrix shows playIdx=8 not in hand), so the // engine never advances to the later spellboost play — the visible spellboost symptom is NOT // fixed by {IsRandomDraw+spin} because the prerequisite (aligned draws) is not met. Assert.That(divergedBeforeFirstPlay, Is.EqualTo(1), "the FIRST seat-A play already diverges under {IsRandomDraw=true,+spin}"); Assert.That(spellboostResolved, Is.False, "the spellboost play is never reached because the replay diverges at the first play"); } private static void ConfirmSpin() { foreach (var fn in new[] { "battle_test_fresh_cl1.ndjson", "battle_test_fresh_cl2.ndjson" }) { var frames = CaptureReplay.Load(fn); var ready = Receive(frames, nameof(NetworkBattleUri.Ready)); var obj = JsonNode.Parse(ready.RawBody)!.AsObject(); int spin = obj.TryGetPropertyValue("spin", out var s) ? (int)s! : 0; TestContext.WriteLine($"Confirmed {fn} Ready spin={spin}"); Assert.That(spin, Is.EqualTo(WireSpin), $"{fn} Ready spin must equal {WireSpin}"); } } } }