poke-crucible 0.1.0

package/dist/critic/parse.js

@@ -0,0 +1,84 @@
+/**
+ * Parse-and-validate the model's text into a {@link Critique}. The Agent SDK is
+ * prose-first (no strict output schema), so we extract the JSON object, coerce
+ * fields defensively, and — honouring the PRD's "suggestions are legality-checked"
+ * decision — keep a `revisedPaste` only if it is a legal Gen 3 OU Team.
+ */
+import { parseAndValidate } from '../team.js';
+export class CritiqueParseError extends Error {
+    name = 'CritiqueParseError';
+}
+/** Pull the first balanced-looking JSON object out of the model's text. */
+function extractJsonObject(text) {
+    const trimmed = text.trim();
+    const fenced = /```(?:json)?\s*([\s\S]*?)```/.exec(trimmed);
+    const body = fenced?.[1] ?? trimmed;
+    const start = body.indexOf('{');
+    const end = body.lastIndexOf('}');
+    if (start < 0 || end <= start) {
+        throw new CritiqueParseError('no JSON object found in model output');
+    }
+    try {
+        return JSON.parse(body.slice(start, end + 1));
+    }
+    catch (e) {
+        throw new CritiqueParseError(`invalid JSON: ${e.message}`);
+    }
+}
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function asStringArray(v) {
+    return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+}
+function asSeverity(v) {
+    return v === 'high' || v === 'medium' || v === 'low' ? v : 'medium';
+}
+function coerceWeakness(w) {
+    const o = (w ?? {});
+    return {
+        summary: asString(o['summary']),
+        exploitedBy: asStringArray(o['exploitedBy']),
+        mechanism: asString(o['mechanism']),
+        severity: asSeverity(o['severity']),
+    };
+}
+function coerceFix(f) {
+    const o = (f ?? {});
+    return { change: asString(o['change']), rationale: asString(o['rationale']) };
+}
+export function parseCritique(text, input, model) {
+    const raw = extractJsonObject(text);
+    if (!raw || typeof raw !== 'object') {
+        throw new CritiqueParseError('model output was not a JSON object');
+    }
+    const o = raw;
+    const overall = asString(o['overall']);
+    const weaknesses = Array.isArray(o['weaknesses']) ? o['weaknesses'].map(coerceWeakness) : [];
+    const fixes = Array.isArray(o['fixes']) ? o['fixes'].map(coerceFix) : [];
+    const caveats = asStringArray(o['caveats']);
+    if (!overall && weaknesses.length === 0) {
+        throw new CritiqueParseError('critique had neither an overall summary nor any weaknesses');
+    }
+    const critique = {
+        team: input.row.team,
+        strength: input.row.strength,
+        overall,
+        weaknesses,
+        fixes,
+        caveats,
+        model,
+        seed: input.seed,
+    };
+    if (input.gauntletVersion)
+        critique.gauntletVersion = input.gauntletVersion;
+    // Keep a proposed revised Team only if it is actually legal Gen 3 OU.
+    const revised = o['revisedPaste'];
+    if (typeof revised === 'string' && revised.trim()) {
+        const { legal } = parseAndValidate([{ name: input.row.team, paste: revised }]);
+        if (legal.length === 1)
+            critique.revisedPaste = revised.trim();
+    }
+    return critique;
+}
+//# sourceMappingURL=parse.js.map

package/dist/critic/parse.js.map

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

package/dist/critic/prompt.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Prompt assembly — builds the system + user messages the Critic model sees
+ * from a {@link CritiqueContext}. The ADR-0004 guardrail is baked into the
+ * system prompt so the model caveats verdicts that lean on the Pilot's known
+ * offense bias.
+ */
+import type { CritiqueContext } from './evidence.js';
+export interface CritiquePrompt {
+    system: string;
+    user: string;
+}
+/** The ADR-0004 caveat, stated for the model. */
+export declare const PILOT_CAVEAT: string;
+export declare function buildPrompt(ctx: CritiqueContext): CritiquePrompt;

package/dist/critic/prompt.js

@@ -0,0 +1,56 @@
+/** The ADR-0004 caveat, stated for the model. */
+export const PILOT_CAVEAT = 'The win-rates come from a fixed, competent-but-greedy heuristic Pilot that ' +
+    'drives BOTH sides, so skill is held constant. This Pilot somewhat UNDER-RATES ' +
+    'stall and defensive play: it does not fully value long-term Toxic / hazard / ' +
+    'recovery attrition. Treat a poor result against offense as real, but be ' +
+    'cautious about over-reading a poor result that hinges on the Pilot mis-piloting ' +
+    'a defensive plan — and say so in `caveats` when a verdict depends on it.';
+const JSON_SHAPE = '{"overall": string, "weaknesses": [{"summary": string, "exploitedBy": string[], ' +
+    '"mechanism": string, "severity": "high"|"medium"|"low"}], "fixes": [{"change": ' +
+    'string, "rationale": string}], "caveats": string[], "revisedPaste": string | null}';
+function pct(x) {
+    return `${Math.round(x * 100)}%`;
+}
+function summarize(matchups) {
+    return matchups
+        .map((m) => `${m.opponent}${m.archetype ? ` [${m.archetype}]` : ''} ${pct(m.winRate)}`)
+        .join(', ');
+}
+export function buildPrompt(ctx) {
+    // The full table is small for the current Gauntlet; the worst/best highlights
+    // focus the model (and are the compact evidence to lead with as it grows).
+    const table = [...ctx.all]
+        .sort((a, b) => a.winRate - b.winRate)
+        .map((m) => `- ${pct(m.winRate)} vs ${m.opponent}${m.archetype ? ` [${m.archetype}]` : ''} ` +
+        `(${m.battles} battles)`)
+        .join('\n');
+    const system = [
+        'You are the Critic: a rigorous Gen 3 OU team critic.',
+        'You scrutinise ONE team using its battle results and explain, specifically and ' +
+            'mechanically, its weaknesses and matchup holes, then suggest concrete, legal ' +
+            'Gen 3 OU fixes. Ground every claim in the provided results and team list — ' +
+            'no generic Pokémon platitudes. Tie each weakness to the Archetype(s) that ' +
+            'exploit it.',
+        PILOT_CAVEAT,
+        `Respond with ONLY a JSON object (no prose, no code fences) of this exact shape:\n${JSON_SHAPE}`,
+        '`exploitedBy` MUST use the bracketed Archetype label(s) from the matchup table ' +
+            '(e.g. "Special Offense"), never the opponent team name. `revisedPaste` is ' +
+            'optional: a full LEGAL Showdown paste of the team with your fixes applied, or null.',
+    ].join('\n\n');
+    const user = [
+        `Team: ${ctx.team}`,
+        `Overall Strength vs the Gauntlet (${ctx.gauntletVersion ?? 'n/a'}): ${pct(ctx.strength)} ` +
+            `over ${ctx.battles} battles (seed ${ctx.seed}).`,
+        '',
+        'Team (Showdown paste):',
+        ctx.paste,
+        '',
+        `Weakest matchups (focus here): ${summarize(ctx.worst)}`,
+        `Best matchups: ${summarize(ctx.best)}`,
+        '',
+        'Per-matchup win-rates (worst first):',
+        table,
+    ].join('\n');
+    return { system, user };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/critic/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/critic/prompt.ts"],"names":[],"mappings":"AAaA,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GACvB,6EAA6E;IAC7E,gFAAgF;IAChF,+EAA+E;IAC/E,0EAA0E;IAC1E,kFAAkF;IAClF,0EAA0E,CAAC;AAE7E,MAAM,UAAU,GACd,kFAAkF;IAClF,iFAAiF;IACjF,oFAAoF,CAAC;AAEvF,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,QAAkC;IACnD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SACtF,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,8EAA8E;IAC9E,2EAA2E;IAC3E,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SACrC,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;QAChF,IAAI,CAAC,CAAC,OAAO,WAAW,CAC3B;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG;QACb,sDAAsD;QACtD,iFAAiF;YAC/E,+EAA+E;YAC/E,6EAA6E;YAC7E,4EAA4E;YAC5E,aAAa;QACf,YAAY;QACZ,oFAAoF,UAAU,EAAE;QAChG,iFAAiF;YAC/E,4EAA4E;YAC5E,qFAAqF;KACxF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,IAAI,GAAG;QACX,SAAS,GAAG,CAAC,IAAI,EAAE;QACnB,qCAAqC,GAAG,CAAC,eAAe,IAAI,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG;YACzF,QAAQ,GAAG,CAAC,OAAO,kBAAkB,GAAG,CAAC,IAAI,IAAI;QACnD,EAAE;QACF,wBAAwB;QACxB,GAAG,CAAC,KAAK;QACT,EAAE;QACF,kCAAkC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACxD,kBAAkB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACvC,EAAE;QACF,sCAAsC;QACtC,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/critic/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The Critique contract — the structured result the Critic (Slice 2) produces
+ * from one Team's Slice-1 evaluation. This is what the CLI prints and what the
+ * Slice-3 Designer will reuse to name and explain what it discovers.
+ */
+import type { StrengthRow } from '../types.js';
+export type Severity = 'high' | 'medium' | 'low';
+/** One matchup hole or structural weakness, tied to what exploits it. */
+export interface CritiqueWeakness {
+    /** One-line statement of the weakness. */
+    summary: string;
+    /** Archetype label(s) that exploit it (matching the Gauntlet's labels). */
+    exploitedBy: string[];
+    /** Why it happens — the threat plus what the Team lacks. */
+    mechanism: string;
+    severity: Severity;
+}
+/** A concrete, actionable change to shore up a weakness. */
+export interface CritiqueFix {
+    change: string;
+    rationale: string;
+}
+/** The full critique of one Team. */
+export interface Critique {
+    team: string;
+    /** Overall Strength echoed from the evaluation, in [0, 1]. */
+    strength: number;
+    /** Plain-language summary of the Team's biggest problems. */
+    overall: string;
+    /** Ranked weaknesses, most severe first. */
+    weaknesses: CritiqueWeakness[];
+    fixes: CritiqueFix[];
+    /** Caveats the Critic flagged — notably where a verdict leans on the Pilot's
+     *  known offense bias (ADR 0004). */
+    caveats: string[];
+    /** Optional full legal Showdown paste with the fixes applied. */
+    revisedPaste?: string;
+    /** Which model produced the critique (for reproducibility). */
+    model: string;
+    /** Gauntlet version and seed of the underlying evaluation. */
+    gauntletVersion?: string;
+    seed: string;
+}
+/** Input to {@link critique}: one Team's paste plus its Slice-1 result. */
+export interface CritiqueInput {
+    /** Standard Showdown paste — lets the Critic reason about mechanism and fixes. */
+    paste: string;
+    /** That Team's row from an `evaluate()` result. */
+    row: StrengthRow;
+    seed: string;
+    gauntletVersion?: string;
+}

package/dist/critic/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/critic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/critic/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,30 @@
+/**
+ * The live {@link DesignerModel}, backed by the Claude Agent SDK on the
+ * maintainer's subscription (like the Critic — Slice 2). `proposeMutations` asks
+ * for improved legal Team pastes (the search legality-checks them before use);
+ * `nameArchetype` labels a Team. Robust to malformed output: returns nothing
+ * rather than throwing, so a bad reply just costs a generation's LLM injection.
+ */
+import type { DesignerModel } from './types.js';
+import { type Effort } from '../llm/agent-query.js';
+export declare const DEFAULT_DESIGNER_MODEL = "claude-sonnet-5";
+export interface AgentSdkDesignerOptions {
+    model?: string;
+    effort?: Effort;
+    timeoutMs?: number;
+    /** How many variant pastes to ask for per call. */
+    proposals?: number;
+}
+export declare class AgentSdkDesignerModel implements DesignerModel {
+    readonly name: string;
+    private readonly effort;
+    private readonly timeoutMs;
+    private readonly proposals;
+    constructor(options?: AgentSdkDesignerOptions);
+    proposeMutations(paste: string, critique?: string): Promise<string[]>;
+    nameArchetype(paste: string, note: string): Promise<{
+        archetype: string;
+        novel: boolean;
+    }>;
+    private opts;
+}

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

@@ -0,0 +1,62 @@
+import { runAgentQuery } from '../llm/agent-query.js';
+export const DEFAULT_DESIGNER_MODEL = 'claude-sonnet-5';
+function extractJson(text) {
+    const fenced = /```(?:json)?\s*([\s\S]*?)```/.exec(text.trim());
+    const body = fenced?.[1] ?? text.trim();
+    const start = Math.min(...['{', '['].map((c) => (body.indexOf(c) < 0 ? Infinity : body.indexOf(c))));
+    const end = Math.max(body.lastIndexOf('}'), body.lastIndexOf(']'));
+    if (!Number.isFinite(start) || end <= start)
+        return null;
+    try {
+        return JSON.parse(body.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+export class AgentSdkDesignerModel {
+    name;
+    effort;
+    timeoutMs;
+    proposals;
+    constructor(options = {}) {
+        this.name = options.model ?? DEFAULT_DESIGNER_MODEL;
+        this.effort = options.effort ?? 'low';
+        this.timeoutMs = options.timeoutMs ?? 120_000;
+        this.proposals = options.proposals ?? 2;
+    }
+    async proposeMutations(paste, critique) {
+        const system = 'You are a Gen 3 OU team designer. Given a team (and optionally a critique of it), ' +
+            `propose up to ${this.proposals} improved, fully LEGAL Gen 3 OU variants that address its ` +
+            'weaknesses — change members, sets, moves, items, or EVs as needed. Output ONLY a JSON ' +
+            'array of strings, where each string is a complete Showdown paste of one team. No prose.';
+        const user = `Team:\n${paste}${critique ? `\n\nCritique:\n${critique}` : ''}`;
+        try {
+            const parsed = extractJson(await runAgentQuery(system, user, this.opts()));
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.filter((p) => typeof p === 'string' && p.trim().length > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    async nameArchetype(paste, note) {
+        const system = 'Name the Gen 3 OU archetype of this team in 2-4 words (e.g. "Spikes stall", "Sand ' +
+            'offense", "Calm Mind balance"). Output ONLY JSON {"archetype": string, "novel": boolean}. ' +
+            'Set novel to true only if the strategy is unusual or creative for the metagame.';
+        const user = `Team:\n${paste}${note ? `\n\nNote: ${note}` : ''}`;
+        try {
+            const parsed = extractJson(await runAgentQuery(system, user, this.opts()));
+            const archetype = typeof parsed?.archetype === 'string' ? parsed.archetype : 'Unnamed';
+            return { archetype, novel: parsed?.novel === true };
+        }
+        catch {
+            return { archetype: 'Unnamed', novel: false };
+        }
+    }
+    opts() {
+        return { model: this.name, effort: this.effort, timeoutMs: this.timeoutMs };
+    }
+}
+//# sourceMappingURL=agent-sdk-model.js.map

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

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

package/dist/designer/design.d.ts

@@ -0,0 +1,12 @@
+import type { CritiqueModel } from '../critic/llm.js';
+import { type EvaluateRuntimeOptions } from '../evaluate.js';
+import type { DesignInput, DesignResult, DesignerModel } from './types.js';
+/** Identity of the Pilot the fitness is measured under (ADR 0002/0004). */
+export declare const PILOT_ID = "greedy-heuristic-v1";
+export interface DesignOptions {
+    runtime?: EvaluateRuntimeOptions;
+    /** When provided, the Critic critiques each generation's best Team and its
+     *  critique drives the LLM's mutation proposals (User Story 11). */
+    critic?: CritiqueModel;
+}
+export declare function design(input: DesignInput, model: DesignerModel, options?: DesignOptions): Promise<DesignResult>;

package/dist/designer/design.js

@@ -0,0 +1,218 @@
+/**
+ * The Designer seam. `design` runs the discovery loop: initialise a population
+ * (seed Teams + a gene pool drawn from the Gauntlet), then each generation score
+ * every Team's composite fitness (Gauntlet Strength via `evaluate`, cached, with
+ * an adaptive screen; plus a peer round-robin), select the fittest, breed the
+ * next generation by mutation and crossover (with LLM-proposed variants, driven
+ * by the Slice-2 Critic), and carry the elite forward. Deterministic under the
+ * seed; reuses the Slice-1 `evaluate` seam for all fitness — no direct sim access.
+ */
+import { critique } from '../critic/critique.js';
+import { evaluate } from '../evaluate.js';
+import { DEFAULT_GAUNTLET_VERSION, gauntletTeamData } from '../gauntlet/gauntlet.js';
+import { parseAndValidate, toSubmissions } from '../team.js';
+import { DEFAULT_WEIGHTS, composite, fitnessParts } from './fitness.js';
+import { buildGenePool, buildMovePool, crossover, isLegal, mutate, parse, serialize, uniqueSpeciesTeam, } from './mutate.js';
+import { Rng } from './rng.js';
+/** Identity of the Pilot the fitness is measured under (ADR 0002/0004). */
+export const PILOT_ID = 'greedy-heuristic-v1';
+const BASE_BUDGET = {
+    population: 8,
+    generations: 4,
+    battlesPerPairing: 16,
+    elitism: 2,
+    battleBudget: 20_000,
+    weights: DEFAULT_WEIGHTS,
+};
+function resolveBudget(input) {
+    const battlesPerPairing = input?.battlesPerPairing ?? BASE_BUDGET.battlesPerPairing;
+    return {
+        population: input?.population ?? BASE_BUDGET.population,
+        generations: input?.generations ?? BASE_BUDGET.generations,
+        battlesPerPairing,
+        // Adaptive screen defaults to half the full budget (clamped to ≤ full).
+        screenBattlesPerPairing: Math.min(battlesPerPairing, input?.screenBattlesPerPairing ?? Math.max(1, Math.floor(battlesPerPairing / 2))),
+        battleBudget: input?.battleBudget ?? BASE_BUDGET.battleBudget,
+        elitism: input?.elitism ?? BASE_BUDGET.elitism,
+        weights: input?.weights ?? BASE_BUDGET.weights,
+    };
+}
+function tournament(scored, rng, k = 3) {
+    let best = scored[rng.int(scored.length)];
+    for (let i = 1; i < k; i++) {
+        const c = scored[rng.int(scored.length)];
+        if (c.fitness > best.fitness)
+            best = c;
+    }
+    return best;
+}
+export async function design(input, model, options = {}) {
+    const seed = input.seed ?? 'poke-crucible';
+    const gauntletVersion = input.gauntletVersion ?? DEFAULT_GAUNTLET_VERSION;
+    const budget = resolveBudget(input.budget);
+    const rng = new Rng(seed);
+    const gauntletTeams = gauntletTeamData(gauntletVersion);
+    const gauntletPastes = gauntletTeams.map((t) => t.paste);
+    const genePool = buildGenePool(gauntletPastes);
+    const movePool = buildMovePool(gauntletPastes);
+    let battlesRun = 0;
+    const ctx = {
+        budget,
+        seed,
+        gauntletVersion,
+        gauntletSize: gauntletTeams.length,
+        runtime: options.runtime ?? {},
+        addBattles: (n) => {
+            battlesRun += n;
+        },
+    };
+    const { legal, errors } = parseAndValidate(toSubmissions(input.seedTeams ?? []));
+    let counter = 0;
+    const makeMember = (team, lineage) => {
+        const { paste, packed } = serialize(team);
+        return { id: `m${counter++}`, team, paste, packed, lineage };
+    };
+    // --- Initial population: seed Teams, then random Teams from the gene pool.
+    let population = legal.map((t) => makeMember(t.team, { origin: 'seed', generation: 0, parents: [] }));
+    let guard = 0;
+    while (population.length < budget.population && guard++ < budget.population * 40) {
+        const t = uniqueSpeciesTeam(genePool, 6, rng);
+        if (t.length === 6 && isLegal(t)) {
+            population.push(makeMember(t, { origin: 'random', generation: 0, parents: [] }));
+        }
+    }
+    population = population.slice(0, budget.population);
+    const gauntletCache = new Map();
+    let ranked = [];
+    let generations = 0;
+    for (let gen = 0; gen < budget.generations; gen++) {
+        await scoreGauntlet(ctx, population, gauntletCache, gen);
+        const peer = await scorePeers(ctx, population, gen);
+        generations = gen + 1;
+        ranked = population
+            .map((member) => {
+            const row = gauntletCache.get(member.packed);
+            const parts = fitnessParts(row, peer.get(member.id) ?? 0);
+            return { member, row, parts, fitness: composite(parts, budget.weights) };
+        })
+            .sort((a, b) => b.fitness - a.fitness);
+        if (gen === budget.generations - 1 || battlesRun >= budget.battleBudget)
+            break;
+        population = await breed(ctx, ranked, gen, model, options.critic, genePool, movePool, rng, makeMember);
+    }
+    // --- Name the Archetypes of the final ranked Teams.
+    const discovered = [];
+    for (const s of ranked) {
+        const { archetype, novel } = await model.nameArchetype(s.member.paste, `Strength ${Math.round(s.row.strength * 100)}%`);
+        discovered.push({
+            id: s.member.id,
+            paste: s.member.paste,
+            strength: s.row.strength,
+            fitness: s.fitness,
+            fitnessParts: s.parts,
+            archetype,
+            novel,
+            lineage: s.member.lineage,
+            matchups: s.row.matchups,
+        });
+    }
+    return { discovered, generations, seed, gauntletVersion, pilot: PILOT_ID, budget, battlesRun, errors };
+}
+/** Build the next generation: elitism + Critic-driven LLM proposals + variation. */
+async function breed(ctx, ranked, gen, model, critic, genePool, movePool, rng, makeMember) {
+    const { budget } = ctx;
+    const next = ranked.slice(0, budget.elitism).map((s) => s.member);
+    const best = ranked[0];
+    // Reuse the Slice-2 Critic to explain the best Team; feed that into the proposer.
+    let critiqueNote;
+    if (critic) {
+        const c = await critique({ paste: best.member.paste, row: best.row, seed: ctx.seed, gauntletVersion: ctx.gauntletVersion }, critic);
+        critiqueNote = [c.overall, ...c.weaknesses.map((w) => `- ${w.summary}`)].join('\n');
+    }
+    for (const paste of await model.proposeMutations(best.member.paste, critiqueNote)) {
+        if (next.length >= budget.population)
+            break;
+        const team = parse(paste);
+        if (team && isLegal(team)) {
+            next.push(makeMember(team, { origin: 'mutation', generation: gen + 1, parents: [best.member.id], operator: 'llm' }));
+        }
+    }
+    let offspringGuard = 0;
+    while (next.length < budget.population && offspringGuard++ < budget.population * 30) {
+        const a = tournament(ranked, rng);
+        if (rng.chance(0.3)) {
+            const b = tournament(ranked, rng);
+            const child = crossover(a.member.team, b.member.team, rng);
+            if (child) {
+                next.push(makeMember(child, {
+                    origin: 'crossover', generation: gen + 1, parents: [a.member.id, b.member.id], operator: 'crossover',
+                }));
+            }
+        }
+        else {
+            const m = mutate(a.member.team, genePool, rng, movePool);
+            if (m) {
+                next.push(makeMember(m.team, {
+                    origin: 'mutation', generation: gen + 1, parents: [a.member.id], operator: m.operator,
+                }));
+            }
+        }
+    }
+    return next.slice(0, budget.population);
+}
+/**
+ * Evaluate Gauntlet Strength for any Members not already cached (by packed Team),
+ * with an adaptive screen: score all new Teams cheaply first, then re-evaluate
+ * only the top half at the full battle count (more battles where they matter).
+ */
+async function scoreGauntlet(ctx, members, cache, gen) {
+    const uncached = members.filter((m) => !cache.has(m.packed));
+    if (uncached.length === 0)
+        return;
+    const { budget } = ctx;
+    const full = budget.battlesPerPairing;
+    const screen = budget.screenBattlesPerPairing;
+    const evalAt = async (group, battles, tag) => {
+        const result = await evaluate({
+            teams: group.map((m) => ({ name: m.id, paste: m.paste })),
+            opposition: { mode: 'gauntlet', gauntletVersion: ctx.gauntletVersion },
+            battlesPerPairing: battles,
+            seed: `${ctx.seed}:g${gen}:${tag}`,
+        }, ctx.runtime);
+        ctx.addBattles(group.length * ctx.gauntletSize * battles);
+        for (const row of result.ranking) {
+            const m = group.find((x) => x.id === row.team);
+            if (m)
+                cache.set(m.packed, row);
+        }
+    };
+    if (screen >= full) {
+        await evalAt(uncached, full, 'gauntlet');
+        return;
+    }
+    await evalAt(uncached, screen, 'screen');
+    const contenders = [...uncached]
+        .sort((a, b) => (cache.get(b.packed).strength - cache.get(a.packed).strength))
+        .slice(0, Math.max(1, Math.ceil(uncached.length / 2)));
+    await evalAt(contenders, full, 'gauntlet');
+}
+/** Peer round-robin Strength within the current population. */
+async function scorePeers(ctx, members, gen) {
+    const map = new Map();
+    if (members.length < 2) {
+        for (const m of members)
+            map.set(m.id, 0.5);
+        return map;
+    }
+    const result = await evaluate({
+        teams: members.map((m) => ({ name: m.id, paste: m.paste })),
+        opposition: { mode: 'round-robin' },
+        battlesPerPairing: ctx.budget.battlesPerPairing,
+        seed: `${ctx.seed}:g${gen}:peer`,
+    }, ctx.runtime);
+    ctx.addBattles((members.length * (members.length - 1) / 2) * ctx.budget.battlesPerPairing);
+    for (const row of result.ranking)
+        map.set(row.team, row.strength);
+    return map;
+}
+//# sourceMappingURL=design.js.map

package/dist/designer/design.js.map

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

package/dist/designer/fitness.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Composite fitness — the signal the search optimises. Deliberately NOT raw
+ * win-rate: blending Gauntlet Strength with peer performance and a worst-matchup
+ * robustness floor rewards well-rounded Teams (no catastrophic matchup) and
+ * dampens raw win-rate's pull toward glass-cannon offense.
+ *
+ * TUNING FINDING (ADR 0004): this does NOT fully recover stall's value. The
+ * Pilot genuinely scores a stall Team's worst matchups near 0%, so its
+ * robustness floor is 0 and the term can't lift it — the offense lean can't be
+ * corrected downstream, only in the Pilot. What the robustness floor *does* do
+ * is reward robust offense (e.g. Choice Band, no 0% hole) over glass cannons —
+ * a legitimate design pressure, just not the stall rescue ADR 0004 hoped for.
+ * Re-tuning the weights (0.15 vs 0.30 vs 0.40 robustness) does not move stall.
+ */
+import type { StrengthRow } from '../types.js';
+import type { FitnessParts, FitnessWeights } from './types.js';
+export declare const DEFAULT_WEIGHTS: FitnessWeights;
+/**
+ * The worst-matchup floor: the lowest per-matchup win-rate. Rewards a flat,
+ * robust matchup profile over a Team the Pilot merely offense-favours (which
+ * spikes some matchups to ~100% and zeroes others).
+ */
+export declare function robustnessFloor(row: StrengthRow): number;
+export declare function fitnessParts(gauntletRow: StrengthRow, peerStrength: number): FitnessParts;
+export declare function composite(parts: FitnessParts, weights?: FitnessWeights): number;

package/dist/designer/fitness.js

@@ -0,0 +1,24 @@
+export const DEFAULT_WEIGHTS = { gauntlet: 0.5, peer: 0.35, robustness: 0.15 };
+/**
+ * The worst-matchup floor: the lowest per-matchup win-rate. Rewards a flat,
+ * robust matchup profile over a Team the Pilot merely offense-favours (which
+ * spikes some matchups to ~100% and zeroes others).
+ */
+export function robustnessFloor(row) {
+    if (row.matchups.length === 0)
+        return row.strength;
+    return Math.min(...row.matchups.map((m) => m.winRate));
+}
+export function fitnessParts(gauntletRow, peerStrength) {
+    return {
+        gauntlet: gauntletRow.strength,
+        peer: peerStrength,
+        robustness: robustnessFloor(gauntletRow),
+    };
+}
+export function composite(parts, weights = DEFAULT_WEIGHTS) {
+    return (weights.gauntlet * parts.gauntlet +
+        weights.peer * parts.peer +
+        weights.robustness * parts.robustness);
+}
+//# sourceMappingURL=fitness.js.map

package/dist/designer/fitness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness.js","sourceRoot":"","sources":["../../src/designer/fitness.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,eAAe,GAAmB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAE/F;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAwB,EAAE,YAAoB;IACzE,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,YAAY;QAClB,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAmB,EAAE,UAA0B,eAAe;IACtF,OAAO,CACL,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ;QACjC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;QACzB,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CACtC,CAAC;AACJ,CAAC"}