feat(battle-node): CountHiddenDraws — hidden shared-RNG draw tally for real spin

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
gamer147
2026-06-04 15:13:47 -04:00
parent 56652c7034
commit 63cb3248b4
2 changed files with 107 additions and 0 deletions

View File

@@ -42,6 +42,41 @@ internal static class KnownListBuilder
return null;
}
/// <summary>Count hidden, non-reproduced shared-RNG draws implied by an orderList: <c>move</c> ops
/// from Deck(0) to Hand(10) for a non-played, unrevealed card (a random fetch the opponent can't
/// reproduce — it can't enumerate the active player's deck). Each such moved card = one crank the
/// receiver must apply (<c>spin += 1</c>). Skips: the played card's own move (<c>idx == playIdx</c>);
/// any idx in <paramref name="revealed"/> (its identity is already on the wire — a revealed uList
/// fetch); and lot-based randoms (a <c>move</c> op carrying a <c>rand</c> array — the receiver
/// reproduces those by re-rolling, so counting would double-crank). An ordinary card DRAW also
/// surfaces as a hidden <c>move(0→10)</c> but is a deterministic top-of-deck pop (no shared-stream
/// roll) and must NOT be counted — distinguishing it from a random fetch on the wire is the open
/// capture (real-spin design §3.1; the spec's Task 0). Base 0; see the real-spin design doc.</summary>
public static int CountHiddenDraws(object? orderList, int playIdx, IReadOnlySet<int> revealed)
{
if (orderList is not IEnumerable<object?> ops) return 0;
var count = 0;
foreach (var op in ops)
{
if (op is not IDictionary<string, object?> opDict) continue;
if (!opDict.TryGetValue("move", out var moveRaw) || moveRaw is not IDictionary<string, object?> move) continue;
if (move.ContainsKey("rand")) continue; // lot random → receiver re-rolls
if (!move.TryGetValue("from", out var fromRaw) || (int)AsLong(fromRaw) != 0) continue; // not from Deck
if (!move.TryGetValue("to", out var toRaw) || (int)AsLong(toRaw) != 10) continue; // not to Hand
if (!move.TryGetValue("idx", out var idxRaw) || idxRaw is not IEnumerable<object?> idxList) continue;
foreach (var i in idxList)
{
var idx = (int)AsLong(i);
if (idx == playIdx) continue; // the played card's own move
if (revealed.Contains(idx)) continue; // opponent already knows this card's identity
count++;
}
}
return count;
}
/// <summary>Mine generated-token identities from a sender's <c>add</c> ops: yields
/// <c>(idx, cardId, isSelf)</c> for every idx in each <c>{add:{idx:[...], isSelf, card:{cardId}}}</c>
/// op. <c>isSelf</c> is surfaced verbatim (the sender's perspective tag on <c>CardObj.IsPlayer</c>,