getcompetitive 4.5.0 → 4.6.0

package/README.md

@@ -48,15 +48,15 @@ Built on [`@pkmn/dex`](https://github.com/pkmn/EPOKe) (Showdown data) and
 ### Team analysis
 | Tool | Purpose |
 | --- | --- |
-| `analyze_team` | Team synergy: stacked defensive weaknesses, offensive coverage gaps, speed placement, a heuristic score, and — with a regulation — coverage against the meta's real sets |
+| `analyze_team` | Team synergy: stacked defensive weaknesses, offensive coverage gaps, speed placement, a heuristic score, and — with a regulation — coverage against the meta's real sets, with battle-math `answerClass` verdicts from the shared MatchupEvaluator |
 
 ### Team workflows
 | Tool | Purpose |
 | --- | --- |
 | `parse_team` | Turn a Showdown/Pokepaste block (or a `species @ item \| ability \| nature \| EVs \| moves` one-liner) into the canonical team every tool takes; unknown names become warnings, not errors |
 | `format_team` | Render a canonical team back into paste text, round-tripping through `parse_team` |
-| `diagnose_team` | "Fix my team": weaknesses with evidence, then concrete spread, move, item and member changes, each backed by exact math or usage data |
-| `prepare_matchup` | "Prepare me": their likely sets by usage, speed races with margins, key damage rolls, bring-four, leads, and win/loss conditions |
+| `diagnose_team` | "Fix my team": weaknesses with evidence — battle-math matchup verdicts included when sets are known — then concrete spread, move, item and member changes, each backed by exact math or usage data |
+| `prepare_matchup` | "Prepare me": their likely sets by usage, speed races with margins, key damage rolls, an exhaustively scored bring-four with alternates, scored lead pairings, and win/loss conditions |
 | `analyze_replay` | Post-match read of a battle log: teams, KOs with causes, observed Speed order, damage percentages, and a type-coverage read |
 | `infer_set` | Reverse constraint solving: battle observations (who moved first, damage dealt/taken) narrow the opponent's likely set, ranked against the meta |
 | `optimize_team` | Fill open team slots against constraints — cover these types, answer these threats — with reasons for every recommendation |
@@ -197,8 +197,13 @@ The Showdown dataset and battle math track `@pkmn/dex` / `@smogon/calc`. Officia
 (`src/threats.ts`) with `node scripts/build-threats.mjs <regulation>`, and the
 **two-window usage history** behind `compare_meta` with
 `node scripts/build-meta-history.mjs <regulation>` (it refuses to write unless
-every tournament in the window was fetched). All generated data files are
-committed, so the tools stay offline at runtime. See [CONTRIBUTING](CONTRIBUTING.md).
+every tournament in the window was fetched). The **Champions game model** is
+the single `getChampionsDex()` layer: `node scripts/verify-champions.mjs`
+diffs base stats, types and abilities for every Champions-exclusive form, the
+whole roster, and every threat species against official data and refreshes the
+committed facts table, which `test/champions.mjs` pins as golden regression
+tests. All generated data files are committed, so the tools stay offline at
+runtime. See [CONTRIBUTING](CONTRIBUTING.md).
 
 ## Contributing
 

package/dist/champions.data.js

@@ -0,0 +1,394 @@
+// Generated by scripts/verify-champions.mjs — do not edit by hand.
+// The Champions-exclusive forms bundled with the gen-9 dataset, with the typing
+// and base-stat total the official game data was verified against. Every entry
+// here is pinned by test/champions.mjs, so a dataset upgrade that silently
+// changes a form fails the suite instead of corrupting every analysis.
+export default {
+    source: "official Champions data via the MunchStats aggregator, diffed by scripts/verify-champions.mjs",
+    verifiedAsOf: "2026-09-19",
+    forms: [
+        {
+            "species": "Absol-Mega-Z",
+            "types": [
+                "Dark",
+                "Ghost"
+            ],
+            "bst": 565
+        },
+        {
+            "species": "Barbaracle-Mega",
+            "types": [
+                "Rock",
+                "Fighting"
+            ],
+            "bst": 600
+        },
+        {
+            "species": "Baxcalibur-Mega",
+            "types": [
+                "Dragon",
+                "Ice"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Chandelure-Mega",
+            "types": [
+                "Ghost",
+                "Fire"
+            ],
+            "bst": 620
+        },
+        {
+            "species": "Chesnaught-Mega",
+            "types": [
+                "Grass",
+                "Fighting"
+            ],
+            "bst": 630
+        },
+        {
+            "species": "Chimecho-Mega",
+            "types": [
+                "Psychic",
+                "Steel"
+            ],
+            "bst": 555
+        },
+        {
+            "species": "Clefable-Mega",
+            "types": [
+                "Fairy",
+                "Flying"
+            ],
+            "bst": 583
+        },
+        {
+            "species": "Crabominable-Mega",
+            "types": [
+                "Fighting",
+                "Ice"
+            ],
+            "bst": 578
+        },
+        {
+            "species": "Darkrai-Mega",
+            "types": [
+                "Dark"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Delphox-Mega",
+            "types": [
+                "Fire",
+                "Psychic"
+            ],
+            "bst": 634
+        },
+        {
+            "species": "Dragalge-Mega",
+            "types": [
+                "Poison",
+                "Dragon"
+            ],
+            "bst": 594
+        },
+        {
+            "species": "Dragonite-Mega",
+            "types": [
+                "Dragon",
+                "Flying"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Drampa-Mega",
+            "types": [
+                "Normal",
+                "Dragon"
+            ],
+            "bst": 585
+        },
+        {
+            "species": "Eelektross-Mega",
+            "types": [
+                "Electric"
+            ],
+            "bst": 615
+        },
+        {
+            "species": "Emboar-Mega",
+            "types": [
+                "Fire",
+                "Fighting"
+            ],
+            "bst": 628
+        },
+        {
+            "species": "Excadrill-Mega",
+            "types": [
+                "Ground",
+                "Steel"
+            ],
+            "bst": 608
+        },
+        {
+            "species": "Falinks-Mega",
+            "types": [
+                "Fighting"
+            ],
+            "bst": 570
+        },
+        {
+            "species": "Feraligatr-Mega",
+            "types": [
+                "Water",
+                "Dragon"
+            ],
+            "bst": 630
+        },
+        {
+            "species": "Floette-Mega",
+            "types": [
+                "Fairy"
+            ],
+            "bst": 651
+        },
+        {
+            "species": "Froslass-Mega",
+            "types": [
+                "Ice",
+                "Ghost"
+            ],
+            "bst": 580
+        },
+        {
+            "species": "Garchomp-Mega-Z",
+            "types": [
+                "Dragon"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Glimmora-Mega",
+            "types": [
+                "Rock",
+                "Poison"
+            ],
+            "bst": 625
+        },
+        {
+            "species": "Golisopod-Mega",
+            "types": [
+                "Bug",
+                "Steel"
+            ],
+            "bst": 630
+        },
+        {
+            "species": "Golurk-Mega",
+            "types": [
+                "Ground",
+                "Ghost"
+            ],
+            "bst": 583
+        },
+        {
+            "species": "Greninja-Mega",
+            "types": [
+                "Water",
+                "Dark"
+            ],
+            "bst": 630
+        },
+        {
+            "species": "Hawlucha-Mega",
+            "types": [
+                "Fighting",
+                "Flying"
+            ],
+            "bst": 600
+        },
+        {
+            "species": "Heatran-Mega",
+            "types": [
+                "Fire",
+                "Steel"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Lucario-Mega-Z",
+            "types": [
+                "Fighting",
+                "Steel"
+            ],
+            "bst": 625
+        },
+        {
+            "species": "Magearna-Mega",
+            "types": [
+                "Steel",
+                "Fairy"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Magearna-Original-Mega",
+            "types": [
+                "Steel",
+                "Fairy"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Malamar-Mega",
+            "types": [
+                "Dark",
+                "Psychic"
+            ],
+            "bst": 582
+        },
+        {
+            "species": "Meganium-Mega",
+            "types": [
+                "Grass",
+                "Fairy"
+            ],
+            "bst": 625
+        },
+        {
+            "species": "Meowstic-F-Mega",
+            "types": [
+                "Psychic"
+            ],
+            "bst": 566
+        },
+        {
+            "species": "Meowstic-M-Mega",
+            "types": [
+                "Psychic"
+            ],
+            "bst": 566
+        },
+        {
+            "species": "Pyroar-Mega",
+            "types": [
+                "Fire",
+                "Normal"
+            ],
+            "bst": 607
+        },
+        {
+            "species": "Raichu-Mega-X",
+            "types": [
+                "Electric"
+            ],
+            "bst": 585
+        },
+        {
+            "species": "Raichu-Mega-Y",
+            "types": [
+                "Electric"
+            ],
+            "bst": 585
+        },
+        {
+            "species": "Scolipede-Mega",
+            "types": [
+                "Bug",
+                "Poison"
+            ],
+            "bst": 585
+        },
+        {
+            "species": "Scovillain-Mega",
+            "types": [
+                "Grass",
+                "Fire"
+            ],
+            "bst": 586
+        },
+        {
+            "species": "Scrafty-Mega",
+            "types": [
+                "Dark",
+                "Fighting"
+            ],
+            "bst": 588
+        },
+        {
+            "species": "Skarmory-Mega",
+            "types": [
+                "Steel",
+                "Flying"
+            ],
+            "bst": 565
+        },
+        {
+            "species": "Staraptor-Mega",
+            "types": [
+                "Fighting",
+                "Flying"
+            ],
+            "bst": 585
+        },
+        {
+            "species": "Starmie-Mega",
+            "types": [
+                "Water",
+                "Psychic"
+            ],
+            "bst": 620
+        },
+        {
+            "species": "Tatsugiri-Curly-Mega",
+            "types": [
+                "Dragon",
+                "Water"
+            ],
+            "bst": 575
+        },
+        {
+            "species": "Tatsugiri-Droopy-Mega",
+            "types": [
+                "Dragon",
+                "Water"
+            ],
+            "bst": 575
+        },
+        {
+            "species": "Tatsugiri-Stretchy-Mega",
+            "types": [
+                "Dragon",
+                "Water"
+            ],
+            "bst": 575
+        },
+        {
+            "species": "Victreebel-Mega",
+            "types": [
+                "Grass",
+                "Poison"
+            ],
+            "bst": 590
+        },
+        {
+            "species": "Zeraora-Mega",
+            "types": [
+                "Electric"
+            ],
+            "bst": 700
+        },
+        {
+            "species": "Zygarde-Mega",
+            "types": [
+                "Dragon",
+                "Ground"
+            ],
+            "bst": 778
+        }
+    ]
+};
+//# sourceMappingURL=champions.data.js.map

package/dist/champions.data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"champions.data.js","sourceRoot":"","sources":["../src/champions.data.ts"],"names":[],"mappings":"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"}

package/dist/champions.js

@@ -0,0 +1,23 @@
+/**
+ * ChampionsDex: the single canonical game model every gameplay system reads
+ * from. The bundled gen-9 dataset is verified against official Champions data
+ * by `scripts/verify-champions.mjs`, which diffs base stats, types and
+ * abilities for every Champions-exclusive form, the whole regulation roster,
+ * and every threat species; the verified facts are committed in
+ * `champions.data.ts` and pinned by `test/champions.mjs`.
+ *
+ * `getChampionsDex()` is currently a passthrough because verification found no
+ * divergence. If an override ever becomes necessary, it lands here — exactly
+ * once, in front of every tool — instead of being sprinkled across call sites.
+ */
+import { getDex } from './dex.js';
+import raw from './champions.data.js';
+export const CHAMPIONS_VERIFIED_AS_OF = raw.verifiedAsOf;
+export const CHAMPIONS_SOURCE = raw.source;
+/** Champions-exclusive forms with the typing and BST they were verified to have. */
+export const CHAMPIONS_EXCLUSIVE_FORMS = raw.forms;
+/** The canonical Champions game model; the only dex access gameplay tools should use. */
+export function getChampionsDex() {
+    return getDex(9);
+}
+//# sourceMappingURL=champions.js.map

package/dist/champions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"champions.js","sourceRoot":"","sources":["../src/champions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,GAAG,MAAM,qBAAqB,CAAC;AAEtC,MAAM,CAAC,MAAM,wBAAwB,GAAW,GAAG,CAAC,YAAY,CAAC;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAW,GAAG,CAAC,MAAM,CAAC;AAEnD,oFAAoF;AACpF,MAAM,CAAC,MAAM,yBAAyB,GAA0E,GAAG,CAAC,KAAK,CAAC;AAE1H,yFAAyF;AACzF,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/evaluator.js

@@ -0,0 +1,200 @@
+/**
+ * MatchupEvaluator: one reusable definition of what constitutes an actual
+ * competitive answer. "Has a super-effective move" is not an answer; this
+ * engine runs the real math both directions — each side's hardest hit and
+ * damage range, level-50 Speed with priority taken into account, and a
+ * conservative turn simulation — and classifies the matchup.
+ *
+ * Determinism contract: the classification never consults a random roll. Our
+ * side is always simulated with its minimum roll and their side with its
+ * maximum, so a classification of HARD_ANSWER or SOFT_ANSWER is a worst-case
+ * guarantee, and SPEED_DEPENDENT/TRADE mean exactly that order or rolls can
+ * flip the result.
+ */
+import { getChampionsDex } from './champions.js';
+import { damageResult, finalStat, typeEffectiveness } from './dex.js';
+/** Better answers rank lower; shared by every consumer that picks the best member. */
+export const ANSWER_CLASS_RANK = {
+    HARD_ANSWER: 0,
+    SOFT_ANSWER: 1,
+    REVENGE: 2,
+    SPEED_DEPENDENT: 3,
+    TRADE: 4,
+    UNFAVORABLE: 5,
+    UNKNOWN: 6,
+};
+/** Strongest hit one side has into the other's typing, by eff x power x STAB. */
+function bestMove(dex, side, targetTypes) {
+    let best = null;
+    for (const mv of side.moves ?? []) {
+        const m = dex.moves.get(mv);
+        if (!m.exists || !(m.basePower || 0))
+            continue;
+        const eff = typeEffectiveness(m.type, targetTypes, 9);
+        if (eff === 0)
+            continue;
+        const stab = dex.species.get(side.species).types.includes(m.type) ? 1.5 : 1;
+        const score = eff * m.basePower * stab;
+        if (!best || score > best.score)
+            best = { name: m.name, score, priority: m.priority ?? 0 };
+    }
+    return best ? { name: best.name, priority: best.priority } : null;
+}
+/**
+ * Conservative two-hit race simulation: our minimum roll against their maximum,
+ * alternating by Speed unless priority intervenes. Returns whether we win and
+ * the share of our HP left in the worst case.
+ */
+function simulateRace(ourMove, theirMove, ourRange, theirRange, ourHp, theirHp, ourPriority, theirPriority, weMoveFirst) {
+    let usHp = ourHp;
+    let themHp = theirHp;
+    // Conservative rolls: our worst, their best.
+    const ourHit = ourRange[0];
+    const theirHit = theirRange[1];
+    let turn = 0;
+    while (usHp > 0 && themHp > 0 && turn < 12) {
+        turn++;
+        const ourTurn = ourPriority !== theirPriority
+            ? ourPriority > theirPriority
+            : weMoveFirst
+                ? turn % 2 === 1
+                : turn % 2 === 0;
+        if (ourTurn) {
+            themHp -= ourHit;
+            if (themHp <= 0)
+                return { weWin: true, hpLeftPct: (usHp / ourHp) * 100 };
+        }
+        else {
+            usHp -= theirHit;
+            if (usHp <= 0)
+                return { weWin: false, hpLeftPct: (usHp / ourHp) * 100 };
+        }
+    }
+    // 12 turns without a faint: effectively unwinnable by damage.
+    return { weWin: false, hpLeftPct: (usHp / ourHp) * 100 };
+}
+/** True when the side has at least one damaging move that is not fully resisted or immune into the target. */
+function canHit(dex, side, targetTypes) {
+    for (const mv of side.moves ?? []) {
+        const m = dex.moves.get(mv);
+        if (m.exists && (m.basePower || 0) && typeEffectiveness(m.type, targetTypes, 9) > 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * Classify the matchup between two sets. Both sides must carry at least one
+ * usable damaging move, else the class is UNKNOWN — a type chart is not a
+ * battle.
+ */
+export function evaluateMatchup(us, them) {
+    const dex = getChampionsDex();
+    const usSp = dex.species.get(us.species);
+    const themSp = dex.species.get(them.species);
+    const ourMove = bestMove(dex, us, themSp.types);
+    const theirMove = bestMove(dex, them, usSp.types);
+    const speed = (side, sp) => {
+        const nature = side.nature ?? 'Serious';
+        const evs = side.championsPoints
+            ? Object.fromEntries(Object.entries(side.championsPoints).map(([k, v]) => [k, v * 8]))
+            : (side.evs ?? {});
+        let s = finalStat(9, 'spe', sp.baseStats.spe, 31, evs.spe ?? 0, 50, nature);
+        if (side.item === 'Choice Scarf')
+            s = Math.floor(s * 1.5);
+        return s;
+    };
+    const ourSpeed = speed(us, usSp);
+    const theirSpeed = speed(them, themSp);
+    const weMoveFirst = ourSpeed >= theirSpeed;
+    const empty = {
+        ourBest: null,
+        theirBest: null,
+        speed: { ours: ourSpeed, theirs: theirSpeed, weMoveFirst },
+    };
+    if (!ourMove || !theirMove) {
+        const weBlocked = !ourMove && !!us.moves?.length && !canHit(dex, us, themSp.types);
+        const theyBlocked = !theirMove && !!them.moves?.length && !canHit(dex, them, usSp.types);
+        if (weBlocked || theyBlocked) {
+            return {
+                ...empty,
+                answerClass: 'UNFAVORABLE',
+                reason: weBlocked
+                    ? `every damaging move ${us.species} knows is resisted or immune into ${them.species}\u2019s typing.`
+                    : `every damaging move ${them.species} knows is resisted or immune into ${us.species}\u2019s typing.`,
+            };
+        }
+        return {
+            ...empty,
+            answerClass: 'UNKNOWN',
+            reason: !ourMove ? `no damaging move known for ${us.species}` : `no damaging move known for ${them.species}`,
+        };
+    }
+    const ourRes = damageResult(9, { species: us.species, level: 50, nature: us.nature, evs: us.evs, championsPoints: us.championsPoints, item: us.item, ability: us.ability, moves: [ourMove.name] }, { species: them.species, level: 50, nature: them.nature, evs: them.evs, championsPoints: them.championsPoints, item: them.item, ability: them.ability, moves: them.moves }, ourMove.name);
+    const theirRes = damageResult(9, { species: them.species, level: 50, nature: them.nature, evs: them.evs, championsPoints: them.championsPoints, item: them.item, ability: them.ability, moves: [theirMove.name] }, { species: us.species, level: 50, nature: us.nature, evs: us.evs, championsPoints: us.championsPoints, item: us.item, ability: us.ability, moves: us.moves }, theirMove.name);
+    const ourHp = ourRes.attacker.stats.hp;
+    const theirHp = theirRes.attacker.stats.hp;
+    const ourRange = ourRes.damageRange;
+    const theirRange = theirRes.damageRange;
+    const base = {
+        ourBest: { move: ourMove.name, damageRange: ourRange, koChance: ourRes.koChance },
+        theirBest: { move: theirMove.name, damageRange: theirRange, koChance: theirRes.koChance },
+        speed: { ours: ourSpeed, theirs: theirSpeed, weMoveFirst },
+    };
+    const ourReliableKO = ourRange[0] >= theirHp;
+    const theirReliableKO = theirRange[0] >= ourHp;
+    const theirPossibleKO = theirRange[1] >= ourHp;
+    if (ourReliableKO && theirReliableKO) {
+        return {
+            ...base,
+            answerClass: weMoveFirst ? 'REVENGE' : 'UNFAVORABLE',
+            reason: `both sides one-shot the other; ${weMoveFirst ? `we move first (${ourSpeed} vs ${theirSpeed}), so we win on initiative only and cannot switch in` : `they move first (${theirSpeed} vs ${ourSpeed})`}.`,
+        };
+    }
+    if (ourReliableKO) {
+        if (theirPossibleKO && !weMoveFirst) {
+            return {
+                ...base,
+                answerClass: 'TRADE',
+                reason: `we one-shot reliably but move second; their best roll (${theirRange[1]} of ${ourHp}) can one-shot us, so the result rides on their roll.`,
+            };
+        }
+        return {
+            ...base,
+            answerClass: 'HARD_ANSWER',
+            reason: `we one-shot (${ourRange[0]}-${ourRange[1]} of ${theirHp})${theirPossibleKO ? ' and move first' : ' and survive their best hit'}.`,
+        };
+    }
+    if (theirReliableKO) {
+        return {
+            ...base,
+            answerClass: 'UNFAVORABLE',
+            reason: `they one-shot us (${theirRange[0]}-${theirRange[1]} of ${ourHp}) and our best hit does not one-shot back.`,
+        };
+    }
+    // Neither side one-shots: the two-hit race, simulated conservatively, and
+    // re-simulated with the order flipped to see whether speed decides it.
+    const worstCase = simulateRace(ourMove.name, theirMove.name, ourRange, theirRange, ourHp, theirHp, ourMove.priority, theirMove.priority, weMoveFirst);
+    const flipped = simulateRace(ourMove.name, theirMove.name, ourRange, theirRange, ourHp, theirHp, ourMove.priority, theirMove.priority, !weMoveFirst);
+    if (worstCase.weWin && flipped.weWin) {
+        return {
+            ...base,
+            answerClass: worstCase.hpLeftPct >= 50 ? 'HARD_ANSWER' : 'SOFT_ANSWER',
+            reason: worstCase.hpLeftPct >= 50
+                ? `we win the exchange regardless of turn order, finishing above half HP (${worstCase.hpLeftPct.toFixed(0)}%).`
+                : `we win the exchange regardless of turn order, but finish at ${worstCase.hpLeftPct.toFixed(0)}% HP against their best rolls.`,
+        };
+    }
+    if (worstCase.weWin !== flipped.weWin) {
+        return {
+            ...base,
+            answerClass: 'SPEED_DEPENDENT',
+            reason: `the winner flips with turn order: both sides need at least two hits, and ${weMoveFirst ? `we move first (${ourSpeed} vs ${theirSpeed})` : `they move first (${theirSpeed} vs ${ourSpeed})`}.`,
+        };
+    }
+    return {
+        ...base,
+        answerClass: 'UNFAVORABLE',
+        reason: `they win the exchange on both orderings; our best is ${ourRange[0]}-${ourRange[1]} of ${theirHp}, theirs ${theirRange[0]}-${theirRange[1]} of ${ourHp}.`,
+    };
+}
+//# sourceMappingURL=evaluator.js.map