poke-crucible 0.1.0

package/dist/cli.js

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+/**
+ * CLI — a thin wrapper over {@link evaluate} and {@link critiqueTeam}: parse
+ * arguments, read Team pastes, print results, write files. Holds no logic worth
+ * testing on its own (per the PRD).
+ *
+ *   poke-crucible eval [options] <team-file...>       rank Teams by Strength
+ *   poke-crucible critique [options] <team-file>      LLM critique of one Team
+ *
+ * With no team file, a single Team paste is read from stdin.
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { evaluate } from './evaluate.js';
+import { critiqueTeam } from './critic/critique.js';
+import { AgentSdkCritiqueModel, DEFAULT_CRITIC_MODEL } from './critic/agent-sdk-model.js';
+import { design } from './designer/design.js';
+import { StubDesignerModel } from './designer/model.js';
+import { AgentSdkDesignerModel, DEFAULT_DESIGNER_MODEL } from './designer/agent-sdk-model.js';
+function parseArgs(argv) {
+    const args = { files: [], mode: 'gauntlet' };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case 'eval':
+                break; // optional subcommand
+            case '-h':
+            case '--help':
+                break; // handled in main() before dispatch
+            case '--mode':
+                args.mode = argv[++i] ?? 'gauntlet';
+                break;
+            case '--battles':
+                args.battles = Number(argv[++i]);
+                break;
+            case '--seed':
+                args.seed = argv[++i];
+                break;
+            case '--gauntlet-version':
+                args.gauntletVersion = argv[++i];
+                break;
+            case '--out':
+                args.out = argv[++i] ?? args.out;
+                break;
+            case '--model':
+                args.model = argv[++i];
+                break;
+            case '--effort':
+                args.effort = argv[++i];
+                break;
+            case '--population':
+                args.population = Number(argv[++i]);
+                break;
+            case '--generations':
+                args.generations = Number(argv[++i]);
+                break;
+            case '--no-llm':
+                args.noLlm = true;
+                break;
+            case '--concurrency':
+                i++; // applied to the environment in main(), before any Battle runs
+                break;
+            default:
+                if (a.startsWith('-'))
+                    throw new Error(`Unknown option: ${a}`);
+                args.files.push(a);
+        }
+    }
+    return args;
+}
+function readStdin() {
+    try {
+        return readFileSync(0, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+const USAGE = `poke-crucible — evaluate and critique Gen 3 OU Teams
+
+Usage:
+  poke-crucible eval [options] <team-file...>     rank Teams by Strength
+  poke-crucible critique [options] <team-file>    LLM critique of one Team
+
+eval options:
+  --mode <gauntlet|round-robin>   Opposition mode (default: gauntlet)
+  --battles <N>                   Battles per pairing (default: 100)
+  --seed <string>                 Master seed for reproducibility
+  --gauntlet-version <v>          Gauntlet version (gauntlet mode)
+  --out <file>                    Structured results file (default: poke-crucible-results.json)
+
+critique options:
+  --model <id>                    Critic model (default: ${DEFAULT_CRITIC_MODEL}; runs on your Claude subscription)
+  --effort <low|medium|high|xhigh|max>  Reasoning effort (default: low)
+  --battles <N>                   Battles for the underlying evaluation (default: 100)
+  --seed <string>                 Master seed
+  --gauntlet-version <v>          Gauntlet version
+  --out <file>                    Critique JSON file (default: poke-crucible-critique.json)
+
+design options:
+  --population <N>                Teams per generation (default: 8)
+  --generations <N>              Generations to run (default: 4)
+  --battles <N>                   Battles per pairing for fitness (default: 16)
+  --model <id> / --effort <...>   Designer LLM model / effort (default: ${DEFAULT_DESIGNER_MODEL}, low)
+  --no-llm                        Random operators only — no subscription call
+  --seed <string>                 Master seed
+  --gauntlet-version <v>          Gauntlet version
+  --out <file>                    Design JSON file (default: poke-crucible-design.json)
+
+shared:
+  --concurrency <N>               Run Battles across N worker threads (default: 1)
+  -h, --help                      Show this help
+
+With no team file, critique reads a paste from stdin; design searches from scratch.`;
+function pct(x) {
+    return `${(x * 100).toFixed(1)}%`;
+}
+function printReport(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(`Mode: ${result.mode}` +
+        (result.gauntletVersion ? `   Gauntlet: ${result.gauntletVersion}` : '') +
+        `   Seed: ${result.seed}   Battles/pairing: ${result.battlesPerPairing}`);
+    if (result.errors.length > 0) {
+        lines.push('');
+        lines.push('Illegal Teams (not run):');
+        for (const e of result.errors) {
+            lines.push(`  ✗ ${e.team}`);
+            for (const p of e.problems)
+                lines.push(`      - ${p}`);
+        }
+    }
+    lines.push('');
+    const header = ['#', 'Team', 'Strength', '95% CI', 'Battles'];
+    const rows = result.ranking.map((r, i) => [
+        String(i + 1),
+        r.team,
+        pct(r.strength),
+        `${pct(r.ci95[0])}–${pct(r.ci95[1])}`,
+        String(r.battles),
+    ]);
+    lines.push(...formatTable(header, rows));
+    for (const r of result.ranking) {
+        lines.push('');
+        lines.push(`${r.team} — per matchup:`);
+        for (const m of [...r.matchups].sort((a, b) => a.winRate - b.winRate)) {
+            const label = m.archetype ? `${m.opponent} [${m.archetype}]` : m.opponent;
+            lines.push(`    ${pct(m.winRate).padStart(6)}  vs ${label}`);
+        }
+    }
+    process.stdout.write(lines.join('\n') + '\n');
+}
+function formatTable(header, rows) {
+    const widths = header.map((h, c) => Math.max(h.length, ...rows.map((r) => (r[c] ?? '').length)));
+    const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join('  ').trimEnd();
+    return [fmt(header), fmt(widths.map((w) => '-'.repeat(w))), ...rows.map(fmt)];
+}
+function printCritique(c) {
+    const lines = [];
+    lines.push('');
+    lines.push(`Critique: ${c.team}   Strength ${pct(c.strength)}   Model: ${c.model}` +
+        (c.gauntletVersion ? `   Gauntlet: ${c.gauntletVersion}` : '') +
+        `   Seed: ${c.seed}`);
+    lines.push('');
+    lines.push(c.overall);
+    if (c.weaknesses.length > 0) {
+        lines.push('');
+        lines.push('Weaknesses:');
+        for (const w of c.weaknesses) {
+            const by = w.exploitedBy.length > 0 ? ` (vs ${w.exploitedBy.join(', ')})` : '';
+            lines.push(`  [${w.severity.toUpperCase()}] ${w.summary}${by}`);
+            if (w.mechanism)
+                lines.push(`      ${w.mechanism}`);
+        }
+    }
+    if (c.fixes.length > 0) {
+        lines.push('');
+        lines.push('Suggested fixes:');
+        for (const f of c.fixes) {
+            lines.push(`  - ${f.change}`);
+            if (f.rationale)
+                lines.push(`      ${f.rationale}`);
+        }
+    }
+    if (c.caveats.length > 0) {
+        lines.push('');
+        lines.push('Caveats:');
+        for (const cav of c.caveats)
+            lines.push(`  - ${cav}`);
+    }
+    process.stdout.write(lines.join('\n') + '\n');
+}
+async function runEval(argv) {
+    const args = parseArgs(argv);
+    if (args.mode !== 'gauntlet' && args.mode !== 'round-robin') {
+        throw new Error(`--mode must be "gauntlet" or "round-robin", got "${args.mode}"`);
+    }
+    const teams = args.files.length > 0 ? args.files.map((f) => readFileSync(f, 'utf8')) : [readStdin()];
+    if (teams.every((t) => t.trim() === '')) {
+        process.stderr.write('No Teams provided.\n\n' + USAGE + '\n');
+        process.exitCode = 1;
+        return;
+    }
+    const opposition = args.mode === 'gauntlet'
+        ? { mode: 'gauntlet', gauntletVersion: args.gauntletVersion }
+        : { mode: 'round-robin' };
+    const input = { teams, opposition };
+    if (args.battles !== undefined)
+        input.battlesPerPairing = args.battles;
+    if (args.seed !== undefined)
+        input.seed = args.seed;
+    const result = await evaluate(input);
+    const out = args.out ?? 'poke-crucible-results.json';
+    printReport(result);
+    writeFileSync(out, JSON.stringify(result, null, 2), 'utf8');
+    process.stdout.write(`\nResults written to ${out}\n`);
+}
+async function runCritique(argv) {
+    // Reuse the shared parser; critique adds --model and defaults --out.
+    const args = parseArgs(argv);
+    const model = args.model ?? DEFAULT_CRITIC_MODEL;
+    const effort = args.effort;
+    const out = args.out ?? 'poke-crucible-critique.json';
+    const paste = (args.files[0] ? readFileSync(args.files[0], 'utf8') : readStdin()).trim();
+    if (!paste) {
+        process.stderr.write('No Team provided.\n\n' + USAGE + '\n');
+        process.exitCode = 1;
+        return;
+    }
+    const critique = await critiqueTeam(paste, new AgentSdkCritiqueModel({ model, ...(effort ? { effort } : {}) }), {
+        ...(args.seed !== undefined ? { seed: args.seed } : {}),
+        ...(args.gauntletVersion !== undefined ? { gauntletVersion: args.gauntletVersion } : {}),
+        ...(args.battles !== undefined ? { battlesPerPairing: args.battles } : {}),
+    });
+    printCritique(critique);
+    writeFileSync(out, JSON.stringify(critique, null, 2), 'utf8');
+    process.stdout.write(`\nCritique written to ${out}\n`);
+}
+function printDesign(result) {
+    const lines = [''];
+    lines.push(`Design: ${result.discovered.length} Teams over ${result.generations} generations` +
+        `   Gauntlet: ${result.gauntletVersion}   Pilot: ${result.pilot}   Seed: ${result.seed}`);
+    if (result.errors.length > 0) {
+        lines.push('');
+        lines.push('Illegal seed Teams (excluded):');
+        for (const e of result.errors)
+            lines.push(`  ✗ ${e.team}: ${e.problems.join('; ')}`);
+    }
+    lines.push('');
+    const header = ['#', 'Fitness', 'Strength', 'Archetype', 'Origin', 'Lead'];
+    const rows = result.discovered.map((d, i) => [
+        String(i + 1),
+        pct(d.fitness),
+        pct(d.strength),
+        d.archetype + (d.novel ? ' *' : ''),
+        d.lineage.operator ? `${d.lineage.origin}/${d.lineage.operator}` : d.lineage.origin,
+        (d.paste.split('\n')[0] ?? '').split(' @ ')[0] ?? '',
+    ]);
+    lines.push(...formatTable(header, rows));
+    const best = result.discovered[0];
+    if (best) {
+        lines.push('');
+        lines.push('Best Team:');
+        lines.push(best.paste);
+    }
+    process.stdout.write(lines.join('\n') + '\n');
+}
+async function runDesign(argv) {
+    const args = parseArgs(argv);
+    const out = args.out ?? 'poke-crucible-design.json';
+    const seedText = args.files[0] ? readFileSync(args.files[0], 'utf8') : readStdin();
+    const budget = {};
+    if (args.population !== undefined)
+        budget.population = args.population;
+    if (args.generations !== undefined)
+        budget.generations = args.generations;
+    if (args.battles !== undefined)
+        budget.battlesPerPairing = args.battles;
+    const input = { budget };
+    if (seedText.trim())
+        input.seedTeams = seedText;
+    if (args.seed !== undefined)
+        input.seed = args.seed;
+    if (args.gauntletVersion !== undefined)
+        input.gauntletVersion = args.gauntletVersion;
+    const useLlm = !args.noLlm;
+    const model = useLlm
+        ? new AgentSdkDesignerModel({
+            model: args.model ?? DEFAULT_DESIGNER_MODEL,
+            ...(args.effort ? { effort: args.effort } : {}),
+        })
+        : new StubDesignerModel();
+    // With the LLM on, the Critic explains each generation's best Team and drives
+    // the mutation proposals (PRD: the Critic sources candidate mutations).
+    const options = useLlm ? { critic: new AgentSdkCritiqueModel() } : {};
+    const result = await design(input, model, options);
+    printDesign(result);
+    writeFileSync(out, JSON.stringify(result, null, 2), 'utf8');
+    process.stdout.write(`\nDesign written to ${out}\n`);
+}
+async function main() {
+    const rawArgs = process.argv.slice(2);
+    if (rawArgs.includes('-h') || rawArgs.includes('--help')) {
+        process.stdout.write(USAGE + '\n');
+        return;
+    }
+    // Run Battles across worker threads (default 1 = inline). Set before any run.
+    const ci = rawArgs.indexOf('--concurrency');
+    if (ci >= 0 && rawArgs[ci + 1])
+        process.env['POKE_CONCURRENCY'] = rawArgs[ci + 1];
+    const command = rawArgs[0];
+    if (command === 'critique') {
+        await runCritique(rawArgs.slice(1));
+    }
+    else if (command === 'design') {
+        await runDesign(rawArgs.slice(1));
+    }
+    else {
+        // Default command is `eval`; strip an explicit leading `eval` token.
+        await runEval(command === 'eval' ? rawArgs.slice(1) : rawArgs);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/critic/agent-sdk-model.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The live {@link CritiqueModel}, backed by the Claude Agent SDK, running on the
+ * maintainer's Claude subscription (individual use — ADR / PRD Slice 2). It just
+ * assembles the critique prompt and delegates the headless call to the shared
+ * {@link runAgentQuery} helper (which handles tools-off, auth, and the timeout).
+ */
+import type { CritiqueModel } from './llm.js';
+import type { CritiquePrompt } from './prompt.js';
+import { type Effort } from '../llm/agent-query.js';
+export type { Effort };
+/** Default Critic model (a Sonnet-tier model; overridable). */
+export declare const DEFAULT_CRITIC_MODEL = "claude-sonnet-5";
+export interface AgentSdkModelOptions {
+    /** Model id/alias passed to the Agent SDK (e.g. `claude-sonnet-5`, `sonnet`). */
+    model?: string;
+    /** Reasoning effort (default `low`). */
+    effort?: Effort;
+    /** Wall-clock cap per critique (default 90s). */
+    timeoutMs?: number;
+}
+export declare class AgentSdkCritiqueModel implements CritiqueModel {
+    readonly name: string;
+    private readonly effort;
+    private readonly timeoutMs;
+    constructor(options?: AgentSdkModelOptions);
+    complete(prompt: CritiquePrompt): Promise<string>;
+}

package/dist/critic/agent-sdk-model.js

@@ -0,0 +1,21 @@
+import { runAgentQuery } from '../llm/agent-query.js';
+/** Default Critic model (a Sonnet-tier model; overridable). */
+export const DEFAULT_CRITIC_MODEL = 'claude-sonnet-5';
+export class AgentSdkCritiqueModel {
+    name;
+    effort;
+    timeoutMs;
+    constructor(options = {}) {
+        this.name = options.model ?? DEFAULT_CRITIC_MODEL;
+        this.effort = options.effort ?? 'low';
+        this.timeoutMs = options.timeoutMs ?? 90_000;
+    }
+    async complete(prompt) {
+        return runAgentQuery(prompt.system, prompt.user, {
+            model: this.name,
+            effort: this.effort,
+            timeoutMs: this.timeoutMs,
+        });
+    }
+}
+//# sourceMappingURL=agent-sdk-model.js.map

package/dist/critic/agent-sdk-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sdk-model.js","sourceRoot":"","sources":["../../src/critic/agent-sdk-model.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAInE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAWtD,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAS;IACL,MAAM,CAAS;IACf,SAAS,CAAS;IAEnC,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/critic/critique.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The Critic seam. `critique` turns one Team's Slice-1 result into a structured
+ * {@link Critique} via an injected {@link CritiqueModel} — so it never touches
+ * the simulation core or the LLM transport directly. `critiqueTeam` is a
+ * convenience that runs `evaluate()` for a single Team first.
+ */
+import { type EvaluateRuntimeOptions } from '../evaluate.js';
+import type { Critique, CritiqueInput } from './types.js';
+import type { CritiqueModel } from './llm.js';
+/** Critique one Team from its precomputed evaluation row. Retries once on
+ *  unparseable model output before giving up. */
+export declare function critique(input: CritiqueInput, model: CritiqueModel): Promise<Critique>;
+export interface CritiqueTeamOptions {
+    name?: string;
+    seed?: string;
+    gauntletVersion?: string;
+    battlesPerPairing?: number;
+    runtime?: EvaluateRuntimeOptions;
+}
+/** Evaluate a single Team against the Gauntlet, then critique it. */
+export declare function critiqueTeam(paste: string, model: CritiqueModel, options?: CritiqueTeamOptions): Promise<Critique>;

package/dist/critic/critique.js

@@ -0,0 +1,51 @@
+/**
+ * The Critic seam. `critique` turns one Team's Slice-1 result into a structured
+ * {@link Critique} via an injected {@link CritiqueModel} — so it never touches
+ * the simulation core or the LLM transport directly. `critiqueTeam` is a
+ * convenience that runs `evaluate()` for a single Team first.
+ */
+import { evaluate } from '../evaluate.js';
+import { buildContext } from './evidence.js';
+import { buildPrompt } from './prompt.js';
+import { CritiqueParseError, parseCritique } from './parse.js';
+/** Critique one Team from its precomputed evaluation row. Retries once on
+ *  unparseable model output before giving up. */
+export async function critique(input, model) {
+    const prompt = buildPrompt(buildContext(input));
+    let lastError;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const text = await model.complete(prompt);
+        try {
+            return parseCritique(text, input, model.name);
+        }
+        catch (e) {
+            if (!(e instanceof CritiqueParseError))
+                throw e;
+            lastError = e;
+        }
+    }
+    throw new CritiqueParseError(`model output could not be parsed after 2 attempts: ${lastError?.message ?? 'unknown'}`);
+}
+/** Evaluate a single Team against the Gauntlet, then critique it. */
+export async function critiqueTeam(paste, model, options = {}) {
+    const opposition = options.gauntletVersion !== undefined
+        ? { mode: 'gauntlet', gauntletVersion: options.gauntletVersion }
+        : { mode: 'gauntlet' };
+    const result = await evaluate({
+        teams: [{ name: options.name ?? 'Team', paste }],
+        opposition,
+        ...(options.battlesPerPairing !== undefined
+            ? { battlesPerPairing: options.battlesPerPairing }
+            : {}),
+        ...(options.seed !== undefined ? { seed: options.seed } : {}),
+    }, options.runtime ?? {});
+    const row = result.ranking[0];
+    if (!row) {
+        throw new Error(`Team could not be evaluated: ${result.errors.map((e) => e.problems.join('; ')).join(' | ')}`);
+    }
+    const input = { paste, row, seed: result.seed };
+    if (result.gauntletVersion)
+        input.gauntletVersion = result.gauntletVersion;
+    return critique(input, model);
+}
+//# sourceMappingURL=critique.js.map

package/dist/critic/critique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.js","sourceRoot":"","sources":["../../src/critic/critique.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAA+B,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;iDACiD;AACjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB,EAAE,KAAoB;IACvE,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhD,IAAI,SAAyC,CAAC;IAC9C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC;gBAAE,MAAM,CAAC,CAAC;YAChD,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,kBAAkB,CAC1B,sDAAsD,SAAS,EAAE,OAAO,IAAI,SAAS,EAAE,CACxF,CAAC;AACJ,CAAC;AAUD,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,KAAoB,EACpB,UAA+B,EAAE;IAEjC,MAAM,UAAU,GACd,OAAO,CAAC,eAAe,KAAK,SAAS;QACnC,CAAC,CAAE,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAY;QAC3E,CAAC,CAAE,EAAE,IAAI,EAAE,UAAU,EAAY,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B;QACE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;QAChD,UAAU;QACV,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,EACD,OAAO,CAAC,OAAO,IAAI,EAAE,CACtB,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,MAAM,CAAC,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC3E,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/critic/evidence.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Evidence builder — turns a Slice-1 {@link StrengthRow} into a compact,
+ * faithful context for the model: the Team, its overall Strength, and its
+ * best/worst matchups. Deliberately does not do Pokémon reasoning itself
+ * (identifying "hazard-weak", "no special wall", etc. is the LLM's job) — it
+ * only selects and shapes the evidence.
+ */
+import type { MatchupResult } from '../types.js';
+import type { CritiqueInput } from './types.js';
+export interface CritiqueContext {
+    team: string;
+    paste: string;
+    strength: number;
+    battles: number;
+    /** The worst matchups, ascending win-rate. */
+    worst: MatchupResult[];
+    /** The best matchups, descending win-rate. */
+    best: MatchupResult[];
+    /** Every matchup, for the full table in the prompt. */
+    all: MatchupResult[];
+    seed: string;
+    gauntletVersion?: string;
+}
+export declare function buildContext(input: CritiqueInput, worstN?: number, bestN?: number): CritiqueContext;

package/dist/critic/evidence.js

@@ -0,0 +1,17 @@
+export function buildContext(input, worstN = 4, bestN = 2) {
+    const byWinRate = [...input.row.matchups].sort((a, b) => a.winRate - b.winRate);
+    const context = {
+        team: input.row.team,
+        paste: input.paste,
+        strength: input.row.strength,
+        battles: input.row.battles,
+        worst: byWinRate.slice(0, worstN),
+        best: byWinRate.slice(Math.max(0, byWinRate.length - bestN)).reverse(),
+        all: input.row.matchups,
+        seed: input.seed,
+    };
+    if (input.gauntletVersion)
+        context.gauntletVersion = input.gauntletVersion;
+    return context;
+}
+//# sourceMappingURL=evidence.js.map

package/dist/critic/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/critic/evidence.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC;IACtE,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,OAAO,GAAoB;QAC/B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ;QAC5B,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO;QAC1B,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;QACjC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE;QACtE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/critic/llm.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The Critic's model seam. The rest of the Critic depends only on this small
+ * interface, so every non-LLM path is unit-testable with {@link StubCritiqueModel}
+ * and no subscription call.
+ *
+ * THE REAL IMPLEMENTATION (deferred — needs the maintainer's go-ahead + install):
+ * a client backed by the Claude Agent SDK (`@anthropic-ai/claude-agent-sdk`),
+ * running on the maintainer's Claude Max subscription (individual use). It calls
+ * `query({ prompt, options })` with ALL built-in tools disabled (`allowedTools:
+ * []`) — the Critic only reasons over the context we pass in — and concatenates
+ * the assistant text. Auth is the Claude Code OAuth flow (`claude` login or
+ * `CLAUDE_CODE_OAUTH_TOKEN`); `ANTHROPIC_API_KEY` must be UNSET or it shadows the
+ * OAuth token and reverts to pay-per-token. See docs/prd-slice-2-critic.md.
+ */
+import type { CritiquePrompt } from './prompt.js';
+export interface CritiqueModel {
+    /** Model identifier, recorded on the Critique for reproducibility. */
+    readonly name: string;
+    /** Return the model's raw text response to the prompt. */
+    complete(prompt: CritiquePrompt): Promise<string>;
+}
+/**
+ * A deterministic stand-in for tests and offline development: returns a fixed
+ * response (or a sequence, one per call) without any network or subscription.
+ */
+export declare class StubCritiqueModel implements CritiqueModel {
+    readonly name: string;
+    private readonly responses;
+    private calls;
+    constructor(response: string | string[], name?: string);
+    complete(_prompt: CritiquePrompt): Promise<string>;
+    /** How many times the model was asked to complete (useful in tests). */
+    get callCount(): number;
+}

package/dist/critic/llm.js

@@ -0,0 +1,23 @@
+/**
+ * A deterministic stand-in for tests and offline development: returns a fixed
+ * response (or a sequence, one per call) without any network or subscription.
+ */
+export class StubCritiqueModel {
+    name;
+    responses;
+    calls = 0;
+    constructor(response, name = 'stub') {
+        this.responses = Array.isArray(response) ? response : [response];
+        this.name = name;
+    }
+    async complete(_prompt) {
+        const i = Math.min(this.calls, this.responses.length - 1);
+        this.calls += 1;
+        return this.responses[i] ?? '';
+    }
+    /** How many times the model was asked to complete (useful in tests). */
+    get callCount() {
+        return this.calls;
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/critic/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/critic/llm.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,CAAS;IACL,SAAS,CAAW;IAC7B,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,QAA2B,EAAE,IAAI,GAAG,MAAM;QACpD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAuB;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/critic/parse.d.ts

@@ -0,0 +1,5 @@
+import type { Critique, CritiqueInput } from './types.js';
+export declare class CritiqueParseError extends Error {
+    name: string;
+}
+export declare function parseCritique(text: string, input: CritiqueInput, model: string): Critique;