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 — DECISIVE VERIFICATION (TEST-ONLY, no production fix, no Engine/*.cs edits).
///
/// QUESTION: does feeding the headless shadow engine the FULL client inputs (server-authored
/// Deal/Swap/Ready setup frames for BOTH seats + the real per-seat idxChangeSeed) make its
/// recovery-mode draw recompute faithful, so the "Target card was not found in hand cards"
/// divergences vanish?
///
/// This builds the explicit 2x2 {setup-frames ingested: yes/no} x {real seed: yes/no} divergence
/// table over the SAME fresh battle (907324319325, battle_test_fresh_cl1/cl2.ndjson), and — at the
/// FIRST remaining divergence — dumps the engine's hand indices/ids vs the wire's playIdx.
///
/// SEEDING MECHANISM (clean, both seats): the seat-B Ready ingest throws an NRE headless (the
/// recovery deal path isn't headless-clean for the opponent seat), so the wire Ready cannot be
/// relied on to seat seat B's XorShift. To inject the real seed FAITHFULLY for BOTH seats without
/// depending on the throwing Ready, we call the test seam .
/// DebugSeedIdxChange(self, oppo) (-> BattleManagerBase.CreateXorShift) BEFORE the
/// mulligan-end frame, with the real per-seat seeds (seat A = cl1's Ready idxChangeSeed = 1430655717,
/// seat B = cl2's = 661650374). We ASSERT both SelfXorShiftActive and OppoXorShiftActive
/// are true after.
///
/// SETUP-FRAME INGEST: identical mechanism to — a
/// single Deal (cl1's receive Deal seats BOTH hands), each seat's Swap (its mulligan),
/// each seat's Ready (mulligan-end). The {no-setup-frames} row SKIPS Deal/Swap/Ready entirely:
/// the engine's autonomous Setup hand stands, and we replay only the plays.
///
[TestFixture]
[NonParallelizable]
public class CaptureReplayFullInputDivergenceExperimentTests
{
// Real per-seat idxChangeSeed carried by each client's Ready frame (given in the experiment brief;
// re-confirmed below against the captures).
private const int SeatASeed = 1430655717; // cl1 / seat A / player
private const int SeatBSeed = 661650374; // cl2 / seat B / opponent
private static readonly HashSet SkipUris = new()
{
nameof(NetworkBattleUri.Echo),
nameof(NetworkBattleUri.ChatStamp),
nameof(NetworkBattleUri.Gungnir),
};
private static readonly HashSet MulliganUris = new()
{
nameof(NetworkBattleUri.Deal),
nameof(NetworkBattleUri.Swap),
nameof(NetworkBattleUri.Ready),
};
private sealed record HandDump(string Seat, int PlayIdx, string Uri, string Reason,
IReadOnlyList<(int Index, int CardId)> SelfHand,
IReadOnlyList<(int Index, int CardId)> OppoHand,
bool PlayIdxInSelfHand, bool PlayIdxInOppoHand);
private sealed record Cell(
bool SetupFrames, bool RealSeed,
int Divergences, bool SelfXorActive, bool OppoXorActive,
HandDump? FirstNotFoundDump);
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;
}
// Snapshot a seat's hand as (engine Index, CardId) pairs. Reads through the SessionBattleEngine
// oracle accessors (HandCount/HandCardIndex/HandCardId).
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 Cell Run(bool setupFrames, bool realSeed)
{
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);
// Inject the real per-seat seed BEFORE mulligan-end (Ready). Clean both-seat activation via the
// CreateXorShift seam, sidestepping the seat-B Ready NRE.
if (realSeed)
engine.DebugSeedIdxChange(SeatASeed, SeatBSeed);
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"))
{
int playIdx = ReadPlayIdx(rawBody);
var self = HandSnapshot(engine, seat);
var oppo = HandSnapshot(engine, !seat);
firstNotFound = new HandDump(
seat ? "A" : "B", playIdx, uri, Trim(r.RejectReason),
self, oppo,
self.Any(h => h.Item1 == playIdx), oppo.Any(h => h.Item1 == playIdx));
}
}
CapturedFrame Receive(IReadOnlyList frames, string uri) =>
frames.First(f => f.Direction == "receive" && f.Uri == uri);
// --- Phase 1: setup frames (optional) ---------------------------------------------------------
if (setupFrames)
{
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);
}
}
bool selfActive = engine.SelfXorShiftActive;
bool oppoActive = engine.OppoXorShiftActive;
// Snapshot the engine's post-setup hands (after Deal/Swap/Ready) for the full-inputs cell, so the
// report can compare the engine's mulligan-resolved hand against the wire's Swap/Ready move list.
if (setupFrames && realSeed)
{
TestContext.WriteLine(" [post-setup] engine SELF (seat A) hand: " +
string.Join(" ", HandSnapshot(engine, true).Select(h => $"(idx={h.Item1},cid={h.Item2})")));
TestContext.WriteLine(" [post-setup] engine OPPO (seat B) hand: " +
string.Join(" ", HandSnapshot(engine, false).Select(h => $"(idx={h.Item1},cid={h.Item2})")));
}
// --- 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(setupFrames, realSeed, divergences, selfActive, oppoActive, 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 Full_input_2x2_divergence_table_and_first_remaining_divergence_dump()
{
// Confirm the brief's per-seat seeds match the captures' Ready frames before relying on them.
ConfirmReadySeeds();
var cells = new[]
{
Run(setupFrames: false, realSeed: false), // baseline-ish: autonomous Setup hand, seed -1
Run(setupFrames: false, realSeed: true),
Run(setupFrames: true, realSeed: false),
Run(setupFrames: true, realSeed: true), // FULL INPUTS
};
TestContext.WriteLine("=== 2x2 DIVERGENCE TABLE (setup-frames x real-seed) ===");
TestContext.WriteLine("setupFrames | realSeed | divergences | selfXor | oppoXor");
foreach (var c in cells)
TestContext.WriteLine(
$" {(c.SetupFrames ? "YES" : "no ")} | {(c.RealSeed ? "YES" : "no ")} | {c.Divergences,2} | {c.SelfXorActive,-5} | {c.OppoXorActive,-5}");
var full = cells.Single(c => c.SetupFrames && c.RealSeed);
TestContext.WriteLine("");
TestContext.WriteLine($"FULL-INPUTS cell: setupFrames=YES realSeed=YES -> divergences={full.Divergences} " +
$"selfXorActive={full.SelfXorActive} oppoXorActive={full.OppoXorActive}");
if (full.FirstNotFoundDump is { } d)
{
TestContext.WriteLine("");
TestContext.WriteLine("=== FIRST 'not found in hand' DIVERGENCE (full-inputs cell) ===");
TestContext.WriteLine($" seat={d.Seat} uri={d.Uri} wire playIdx={d.PlayIdx} reason={d.Reason}");
TestContext.WriteLine($" playIdx in self hand? {d.PlayIdxInSelfHand} in oppo hand? {d.PlayIdxInOppoHand}");
TestContext.WriteLine($" engine SELF (seat {d.Seat}) hand [{d.SelfHand.Count}]: " +
string.Join(" ", d.SelfHand.Select(h => $"(idx={h.Index},cid={h.CardId})")));
TestContext.WriteLine($" engine OPPO hand [{d.OppoHand.Count}]: " +
string.Join(" ", d.OppoHand.Select(h => $"(idx={h.Index},cid={h.CardId})")));
}
else
{
TestContext.WriteLine("");
TestContext.WriteLine("FULL-INPUTS cell produced NO 'not found in hand' divergence.");
}
// EVIDENCE ASSERTIONS (pin the experiment's reproducibility, not a desired fix outcome):
Assert.Multiple(() =>
{
// The seed seam activates BOTH seats' XorShift in every realSeed cell.
foreach (var c in cells.Where(c => c.RealSeed))
{
Assert.That(c.SelfXorActive, Is.True,
$"realSeed cell (setup={c.SetupFrames}) must activate self XorShift");
Assert.That(c.OppoXorActive, Is.True,
$"realSeed cell (setup={c.SetupFrames}) must activate oppo XorShift");
}
// With NO seed seam AND NO setup frames (the live shadow's effective state — never
// ingests the seed-bearing Ready), BOTH seats' XorShift stay inactive.
var bare = cells.Single(c => !c.RealSeed && !c.SetupFrames);
Assert.That(bare.SelfXorActive, Is.False, "no-seed/no-setup leaves self XorShift inactive");
Assert.That(bare.OppoXorActive, Is.False, "no-seed/no-setup leaves oppo XorShift inactive");
// With setup frames but no seam, the seat-A Ready frame's own idxChangeSeed activates the
// SELF XorShift (seat B's Ready NREs before it can seat oppo) — so self is active, oppo isn't.
var setupNoSeam = cells.Single(c => !c.RealSeed && c.SetupFrames);
Assert.That(setupNoSeam.SelfXorActive, Is.True,
"setup-frames cell: seat-A Ready idxChangeSeed activates self XorShift");
Assert.That(setupNoSeam.OppoXorActive, Is.False,
"setup-frames cell: seat-B Ready NREs before seating oppo XorShift");
// THE DECISIVE FINDING: full inputs (setup frames + real seed, both seats' XorShift active)
// do NOT eliminate the divergences — they stay at the 14 baseline.
var full2 = cells.Single(c => c.SetupFrames && c.RealSeed);
Assert.That(full2.SelfXorActive && full2.OppoXorActive, Is.True,
"full-inputs cell has both seats' XorShift active");
Assert.That(full2.Divergences, Is.GreaterThan(0),
"REFUTED: full inputs do NOT make the recovery recompute faithful — divergences remain");
});
}
// Re-confirm the brief's per-seat seeds against the captured Ready frames (fail loudly if the
// fixtures ever drift from the assumed seeds).
private static void ConfirmReadySeeds()
{
var cl1 = CaptureReplay.Load("battle_test_fresh_cl1.ndjson");
var cl2 = CaptureReplay.Load("battle_test_fresh_cl2.ndjson");
int a = ReadReadySeed(cl1);
int b = ReadReadySeed(cl2);
TestContext.WriteLine($"Confirmed Ready idxChangeSeed: cl1(seatA)={a} cl2(seatB)={b}");
Assert.That(a, Is.EqualTo(SeatASeed), "cl1 Ready idxChangeSeed must equal the brief's seat-A seed");
Assert.That(b, Is.EqualTo(SeatBSeed), "cl2 Ready idxChangeSeed must equal the brief's seat-B seed");
}
private static int ReadReadySeed(IReadOnlyList frames)
{
var ready = frames.First(f => f.Direction == "receive" && f.Uri == nameof(NetworkBattleUri.Ready));
var obj = JsonNode.Parse(ready.RawBody)!.AsObject();
return (int)obj["idxChangeSeed"]!;
}
}
}