# Simulation-only card substitutions.
#
# Some cards are `AI:RemoveDeck:All` in Forge because the AI genuinely cannot
# evaluate them -- not because nobody wrote logic. Forcing those on makes the AI
# play them badly, which is worse than not playing them. Instead we swap in a
# functionally similar card the AI CAN pilot, so the deck's SHAPE is simulated
# correctly (the removal slot still does removal) even though the specific card
# differs.
#
# decklist.mgt remains the source of truth. This map applies ONLY when building
# the .dck for simulation, and every substitution is recorded in the run's JSON
# metadata and printed in reports.
#
# IMPORTANT: per-card statistics for a substituted card describe the STAND-IN,
# not the real card. Never read "Terminate had a 40% win rate" as a fact about
# Beast Within. This trades per-card precision for whole-deck realism.

substitutions:
  # Blocked because it gives the opponent a 3/3 -- the AI can't weigh that downside,
  # even though it already has working targeting logic (AITgts$ Card.cmcGE4).
  # Feed the Swarm is the same slot: cheap unconditional removal, and it also hits
  # enchantments, so it is closer to Beast Within's flexibility than Terminate.
  # DEVIATION: Beast Within hits ANY permanent at instant speed; Feed the Swarm is
  # a sorcery limited to creatures/enchantments and costs life.
  Beast Within: Feed the Swarm

  # Blocked because of `Cost$ 2 B PayLife<X>` -- an X-cost paid with LIFE, which
  # the AI has no logic to size. Blasphemous Edict is a fixed-cost mass sacrifice.
  # DEVIATION: Deluge is scalable, symmetric and dodges indestructible; the Edict
  # is an edict effect that opponents choose for, so it kills different creatures.
  Toxic Deluge: Blasphemous Edict

  # Blocked because "draw X, then discard 3" is a symmetrical drawback it can't
  # evaluate. Umbral Collar Zealot is a repeatable sac-for-value outlet the AI can
  # pilot, keeping the "sacrifice converts to cards" slot filled.
  # DEVIATION: far smaller effect, and a creature rather than an enchantment.
  Greater Good: Umbral Collar Zealot

  # Black Sun's Zenith and Cauldron of Souls are also AI-blocked but are NOT
  # substituted: no close AI-playable analogue exists, and swapping them would
  # distort the -1/-1 theme more than leaving the slot inert. They stay in the
  # deck, remain uncast, and are reported as "never cast (AI-blocked)".