@metaharness/darwin 0.1.0

package/dist/evolve.js

@@ -0,0 +1,129 @@
+// SPDX-License-Identifier: MIT
+//
+// The evolution loop (ADR-070). Ties the pieces together:
+//
+//   profile → baseline → (mutate → sandbox → score → archive)* → promote/select
+//
+// Population variants are evaluated with BOUNDED concurrency (no unbounded fan-out),
+// under an optional per-generation cost-proxy budget (the circuit breaker of
+// ADR-072). Selection samples from the WHOLE archive on a stalled generation
+// (ADR-073) rather than dead-ending — a weak ancestor can still seed a branch.
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Archive } from './archive.js';
+import { generateBaselineHarness } from './generator.js';
+import { createChildVariant, DeterministicMutator } from './mutator.js';
+import { profileRepo } from './repo_profiler.js';
+import { runVariantTasks } from './sandbox.js';
+import { scoreVariant } from './scorer.js';
+const DEFAULT_CONCURRENCY = 4;
+const DEFAULT_TASK_TIMEOUT_MS = 120_000;
+/** Run async `fn` over `items` with at most `limit` in flight at once. Order-preserving. */
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const width = Math.max(1, Math.min(limit, items.length));
+    const workers = Array.from({ length: width }, async () => {
+        for (;;) {
+            const i = next++;
+            if (i >= items.length)
+                break;
+            results[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+async function ensureWorkRoot(workRoot) {
+    await mkdir(join(workRoot, 'variants'), { recursive: true });
+    await mkdir(join(workRoot, 'runs'), { recursive: true });
+    await mkdir(join(workRoot, 'reports'), { recursive: true });
+}
+/** Run + score one variant. Pure of archive mutation (caller commits results). */
+async function evaluateVariant(variant, profile, cfg, parentScore) {
+    const timeout = cfg.taskTimeoutMs ?? DEFAULT_TASK_TIMEOUT_MS;
+    const traces = await runVariantTasks(variant, profile, cfg.tasks, {
+        taskTimeoutMs: timeout,
+    });
+    const score = scoreVariant(variant.id, traces, parentScore, cfg.promotionDelta, timeout);
+    return { variant, traces, score };
+}
+/** Cost proxy for the breaker: cumulative variant-seconds in a generation. */
+function traceSeconds(traces) {
+    return traces.reduce((s, t) => s + t.durationMs, 0) / 1000;
+}
+async function commit(archive, workRoot, evalResult) {
+    await writeFile(join(workRoot, 'runs', `${evalResult.variant.id}.json`), JSON.stringify({ traces: evalResult.traces, score: evalResult.score }, null, 2), 'utf8');
+    archive.setScore(evalResult.variant.id, evalResult.score);
+}
+/**
+ * Run a full Darwin Mode evolution. Returns the baseline, the winning record,
+ * the whole archive, and the winner's lineage. Side effects are confined to the
+ * `<workRoot>/.metaharness`-style tree (variants, runs, reports, archive.json,
+ * lineage.json).
+ */
+export async function evolve(config) {
+    await ensureWorkRoot(config.workRoot);
+    const profile = await profileRepo(config.repoRoot);
+    const archive = new Archive(join(config.workRoot, 'archive.json'));
+    await archive.load();
+    const seed = config.seed ?? 0;
+    const concurrency = config.concurrency ?? DEFAULT_CONCURRENCY;
+    // ADR-071: pluggable generator. Default deterministic; config.generator can
+    // be an LLM-backed CodeGenerator (e.g. OpenRouterMutator) — same safety gate.
+    const mutator = config.generator ?? new DeterministicMutator(seed);
+    // --- baseline ---
+    const baseline = await generateBaselineHarness(profile, config.workRoot);
+    archive.addVariant(baseline);
+    const baselineEval = await evaluateVariant(baseline, profile, config, null);
+    await commit(archive, config.workRoot, baselineEval);
+    await archive.save();
+    const scoreById = new Map([[baseline.id, baselineEval.score]]);
+    let parents = [baseline];
+    // --- generations ---
+    for (let generation = 1; generation <= config.generations; generation++) {
+        // Build this generation's children from the current parents.
+        const children = [];
+        for (const parent of parents) {
+            for (let index = 0; index < config.childrenPerGeneration; index++) {
+                const child = await createChildVariant(parent, config.workRoot, generation, index, mutator, seed);
+                archive.addVariant(child);
+                children.push({ child, parent });
+            }
+        }
+        // Evaluate with bounded concurrency.
+        const evals = await mapLimit(children, concurrency, ({ child, parent }) => evaluateVariant(child, profile, config, scoreById.get(parent.id) ?? null));
+        // Commit sequentially (single-writer to the archive + one save), honouring
+        // the per-generation cost breaker.
+        let spent = 0;
+        const promoted = [];
+        for (const ev of evals) {
+            await commit(archive, config.workRoot, ev);
+            scoreById.set(ev.variant.id, ev.score);
+            if (ev.score.promoted)
+                promoted.push(ev.variant);
+            spent += traceSeconds(ev.traces);
+            if (config.costBudgetSeconds && spent >= config.costBudgetSeconds)
+                break;
+        }
+        await archive.save();
+        // Selection (ADR-073): prefer promoted children; on a stalled generation
+        // sample the whole archive so we explore sideways instead of dead-ending.
+        parents = promoted.length > 0 ? promoted : archive.selectParents(2);
+        if (parents.length === 0)
+            break;
+    }
+    const winner = archive.best();
+    const winnerLineage = winner ? archive.lineageOf(winner.variant.id) : [];
+    await writeFile(join(config.workRoot, 'reports', 'winner.json'), JSON.stringify(winner, null, 2), 'utf8');
+    await writeFile(join(config.workRoot, 'lineage.json'), JSON.stringify(archive.toLineageGraph(), null, 2), 'utf8');
+    const baselineRecord = archive.get(baseline.id);
+    return {
+        baseline: baselineRecord ?? { variant: baseline, score: baselineEval.score, children: [] },
+        winner,
+        records: archive.all(),
+        generations: config.generations,
+        winnerLineage,
+    };
+}
+//# sourceMappingURL=evolve.js.map

package/dist/evolve.js.map

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

package/dist/generator.d.ts

@@ -0,0 +1,9 @@
+import type { HarnessVariant, RepoProfile } from './types.js';
+/**
+ * Generate the baseline harness variant from a repo profile. Writes the seven
+ * mutation-surface files (filenames per FILE_BY_SURFACE) into
+ * `<workRoot>/variants/baseline/`, creating directories as needed, and returns
+ * the variant descriptor. Generation 0, no parent.
+ */
+export declare function generateBaselineHarness(profile: RepoProfile, workRoot: string): Promise<HarnessVariant>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY9D;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/generator.js

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: MIT
+//
+// Baseline generator (ADR-070 §generate) — turns a RepoProfile into the root
+// "baseline" harness variant: a directory holding exactly the seven approved
+// mutation-surface files (ADR-071). Every emitted file is pure policy logic and
+// passes the safety inspection by construction.
+//
+// Dependency-free (Node built-ins only).
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { FILE_BY_SURFACE } from './safety.js';
+import { contextBuilderTemplate, memoryPolicyTemplate, plannerTemplate, retryPolicyTemplate, reviewerTemplate, scorePolicyTemplate, toolPolicyTemplate, } from './templates.js';
+/**
+ * Generate the baseline harness variant from a repo profile. Writes the seven
+ * mutation-surface files (filenames per FILE_BY_SURFACE) into
+ * `<workRoot>/variants/baseline/`, creating directories as needed, and returns
+ * the variant descriptor. Generation 0, no parent.
+ */
+export async function generateBaselineHarness(profile, workRoot) {
+    const dir = join(workRoot, 'variants', 'baseline');
+    await mkdir(dir, { recursive: true });
+    // Surface filename -> source text. Filenames come from the safety allowlist so
+    // the generator and inspector can never drift apart.
+    const files = {
+        [FILE_BY_SURFACE.planner]: plannerTemplate(profile),
+        [FILE_BY_SURFACE.contextBuilder]: contextBuilderTemplate(),
+        [FILE_BY_SURFACE.reviewer]: reviewerTemplate(),
+        [FILE_BY_SURFACE.retryPolicy]: retryPolicyTemplate(),
+        [FILE_BY_SURFACE.toolPolicy]: toolPolicyTemplate(),
+        [FILE_BY_SURFACE.memoryPolicy]: memoryPolicyTemplate(),
+        [FILE_BY_SURFACE.scorePolicy]: scorePolicyTemplate(),
+    };
+    for (const [name, source] of Object.entries(files)) {
+        await writeFile(join(dir, name), source, 'utf8');
+    }
+    return {
+        id: 'baseline',
+        parentId: null,
+        generation: 0,
+        dir,
+        mutationSurface: 'planner',
+        mutationSummary: 'baseline generated from repo profile',
+        createdAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,gDAAgD;AAChD,EAAE;AACF,yCAAyC;AAEzC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAoB,EACpB,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,+EAA+E;IAC/E,qDAAqD;IACrD,MAAM,KAAK,GAA2B;QACpC,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC;QACnD,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,sBAAsB,EAAE;QAC1D,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE;QAC9C,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE;QACpD,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE;QAClD,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,oBAAoB,EAAE;QACtD,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE;KACrD,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,CAAC;QACb,GAAG;QACH,eAAe,EAAE,SAAS;QAC1B,eAAe,EAAE,sCAAsC;QACvD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './types.js';
+export * from './safety.js';
+export * from './repo_profiler.js';
+export * from './templates.js';
+export * from './generator.js';
+export * from './mutator.js';
+export * from './sandbox.js';
+export * from './scorer.js';
+export * from './archive.js';
+export * from './evolve.js';
+export * as bench from './bench/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAI5B,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+//
+// @metaharness/darwin — Darwin Mode (ADR-070…075).
+//
+// Bounded, empirical, population-based self-improvement of an agent harness.
+// The foundation model is frozen; the HARNESS evolves: generate child variants
+// over seven approved mutation surfaces, sandbox-score them, archive the lineage
+// as a tree (not a single best branch), and promote only measured, safe wins.
+//
+//   The model proposes nothing here — the harness mutates, the benchmark judges,
+//   the archive remembers.
+//
+// Modules:
+//   types          — the shared contract
+//   safety         — the load-bearing allowlist + content gate (ADR-071)
+//   repo_profiler  — repo → RepoProfile
+//   templates      — the seven baseline mutation-surface sources
+//   generator      — RepoProfile → baseline variant
+//   mutator        — bounded, validated child mutations + the CodeGenerator hook
+//   sandbox        — gate-first, shell-free, env-scrubbed task runner
+//   scorer         — the frozen weighted scorer + strict promotion gate (ADR-072)
+//   archive        — the population tree + archive-wide selection (ADR-073)
+//   evolve         — the loop that composes them all (ADR-070)
+export * from './types.js';
+export * from './safety.js';
+export * from './repo_profiler.js';
+export * from './templates.js';
+export * from './generator.js';
+export * from './mutator.js';
+export * from './sandbox.js';
+export * from './scorer.js';
+export * from './archive.js';
+export * from './evolve.js';
+// The benchmark + SOTA "Darwin Plus" layer (ADR-076…081) is namespaced to avoid
+// name collisions (e.g. scoreWeights) with the lightweight ADR-072 scorer.
+export * as bench from './bench/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,mDAAmD;AACnD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,iFAAiF;AACjF,8EAA8E;AAC9E,EAAE;AACF,iFAAiF;AACjF,2BAA2B;AAC3B,EAAE;AACF,WAAW;AACX,yCAAyC;AACzC,yEAAyE;AACzE,wCAAwC;AACxC,iEAAiE;AACjE,oDAAoD;AACpD,iFAAiF;AACjF,sEAAsE;AACtE,kFAAkF;AAClF,4EAA4E;AAC5E,+DAA+D;AAE/D,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,gFAAgF;AAChF,2EAA2E;AAC3E,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/mutator.d.ts

@@ -0,0 +1,61 @@
+import type { HarnessVariant, MutationSurface } from './types.js';
+/**
+ * A pluggable code generator. Given the parent's surface file and context, it
+ * returns replacement code for that one file plus a one-line summary. The
+ * default implementation is deterministic; an LLM-backed one slots in behind the
+ * same `validateGeneratedCode` gate (ADR-071 §contract).
+ */
+export interface CodeGenerator {
+    generateMutation(input: {
+        parentCode: string;
+        surface: MutationSurface;
+        repoSummary: string;
+        parentScore: number;
+        failedTraces: string[];
+    }): Promise<{
+        code: string;
+        summary: string;
+    }>;
+}
+/**
+ * The default mutator: deterministic, seeded, dependency-free. It applies the
+ * first matching bounded edit (in a seeded rotation) to the parent file. If no
+ * edit rule matches, it appends a tracking comment — a safe, signature-neutral
+ * no-op so the surface still differs and the file still passes the scanner.
+ */
+export declare class DeterministicMutator implements CodeGenerator {
+    private readonly seed;
+    constructor(seed?: number);
+    generateMutation(input: {
+        parentCode: string;
+        surface: MutationSurface;
+        repoSummary: string;
+        parentScore: number;
+        failedTraces: string[];
+    }): Promise<{
+        code: string;
+        summary: string;
+    }>;
+}
+/**
+ * Deterministically pick one of the seven surfaces from `(generation+index+seed)`.
+ * Same inputs ⇒ same surface (reproducibility, ADR-070 §seed).
+ */
+export declare function pickSurface(generation: number, index: number, seed: number): MutationSurface;
+/**
+ * Recursively copy a variant directory using `node:fs/promises` only (never a
+ * shell). The destination is created fresh; only the parent's files are copied,
+ * so no extraneous entry can leak in.
+ */
+export declare function copyVariantDir(src: string, dest: string): Promise<void>;
+/**
+ * Create a child variant from `parent`: copy its directory, pick one surface
+ * deterministically, regenerate that surface's file via `gen`, validate the
+ * generated code BEFORE writing, and return the resulting `HarnessVariant`.
+ *
+ * If `validateGeneratedCode` reports any violation, the mutation is DISCARDED
+ * and the parent's surface file is left untouched (a safe no-op). The child
+ * directory therefore always still passes `inspectVariant`.
+ */
+export declare function createChildVariant(parent: HarnessVariant, workRoot: string, generation: number, index: number, gen?: CodeGenerator, seed?: number): Promise<HarnessVariant>;
+//# sourceMappingURL=mutator.d.ts.map

package/dist/mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../src/mutator.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,KAAK,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AA6FD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,SAAI;IAId,gBAAgB,CAAC,KAAK,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAqB/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,eAAe,CAGjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,aAA0C,EAC/C,IAAI,SAAI,GACP,OAAO,CAAC,cAAc,CAAC,CA4CzB"}

package/dist/mutator.js

@@ -0,0 +1,193 @@
+// SPDX-License-Identifier: MIT
+//
+// The mutation engine (ADR-071) — produces a child variant from a parent by
+// perturbing exactly one approved surface file, behind the safety gate.
+//
+// A mutation is BOUNDED by construction: it copies the parent variant directory
+// verbatim, picks ONE surface deterministically, regenerates ONLY that surface's
+// file, and writes nothing else. Generated code is run through
+// `validateGeneratedCode` BEFORE it touches disk; a violation is discarded and
+// the parent's file is preserved (a safe no-op mutation), so a child variant
+// always still passes `inspectVariant` (ADR-071 §hard gate).
+//
+// The mutator is pluggable via `CodeGenerator`: the default `DeterministicMutator`
+// performs seeded string-replacement edits (the prototype path), and can be
+// swapped for an LLM-backed generator behind the SAME gate.
+import { cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { FILE_BY_SURFACE, SURFACES, validateGeneratedCode } from './safety.js';
+/** A pure, deterministic 32-bit hash — seeds choice without `Math.random`. */
+function hash(...parts) {
+    let h = 0x811c9dc5;
+    const s = parts.join('|');
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+/** Clamp a `.slice(start, end)` window to a small, sane range. */
+function clampWindow(n) {
+    if (!Number.isFinite(n))
+        return 30;
+    return Math.max(5, Math.min(200, Math.round(n)));
+}
+/**
+ * The ordered catalogue of bounded edits the deterministic mutator can apply.
+ * They are tried in a seeded rotation; the first that matches the parent file is
+ * used. Every rule is signature-preserving and capability-neutral.
+ */
+const EDIT_RULES = [
+    // Tweak a `.slice(0, N)` context window up or down by a bounded step.
+    {
+        find: /\.slice\(\s*0\s*,\s*(\d+)\s*\)/,
+        replace: (match, variant) => {
+            const current = Number(/(\d+)\s*\)/.exec(match)?.[1] ?? '30');
+            const step = (variant % 2 === 0 ? 1 : -1) * (10 + (variant % 3) * 5);
+            const next = clampWindow(current + step);
+            return match.replace(/0\s*,\s*\d+/, `0, ${next}`);
+        },
+        summary: (variant) => `adjusted context slice window (variant ${variant})`,
+    },
+    // Adjust a retry / attempt budget literal (e.g. `maxRetries = 3`).
+    {
+        find: /\b(maxRetries|retries|maxAttempts|attempts|retryBudget|budget)\b(\s*[:=]\s*)(\d+)/,
+        replace: (match, variant) => {
+            const m = /(\d+)\s*$/.exec(match);
+            const current = Number(m?.[1] ?? '3');
+            const delta = variant % 2 === 0 ? 1 : -1;
+            const next = Math.max(0, Math.min(16, current + delta));
+            return match.replace(/\d+\s*$/, String(next));
+        },
+        summary: (variant) => `adjusted retry/attempt budget (variant ${variant})`,
+    },
+    // Nudge a numeric threshold literal (memory/score policy), bounded to [0,1].
+    {
+        find: /\b(threshold|cutoff|minScore|weight|decay|temperature)\b(\s*[:=]\s*)(0?\.\d+|1(?:\.0+)?|0)\b/,
+        replace: (match, variant) => {
+            const m = /(0?\.\d+|1(?:\.0+)?|0)\s*$/.exec(match);
+            const current = Number(m?.[1] ?? '0.5');
+            const step = (variant % 2 === 0 ? 0.05 : -0.05) * (1 + (variant % 2));
+            const next = Math.max(0, Math.min(1, Math.round((current + step) * 100) / 100));
+            return match.replace(/(0?\.\d+|1(?:\.0+)?|0)\s*$/, String(next));
+        },
+        summary: (variant) => `nudged numeric threshold (variant ${variant})`,
+    },
+    // Perturb a quoted planner/reviewer phrase by appending a directive variant.
+    {
+        find: /(['"`])((?:step|plan|decompose|review|consider|first|then|focus)[^'"`]{0,80}?)\1/i,
+        replace: (match, variant) => {
+            const phrases = [
+                ' Prefer the smallest viable change.',
+                ' Verify assumptions before acting.',
+                ' Surface the riskiest unknown first.',
+            ];
+            const add = phrases[variant % phrases.length];
+            const quote = match[0];
+            const inner = match.slice(1, -1).replace(/\s+$/, '');
+            return `${quote}${inner}${add}${quote}`;
+        },
+        summary: (variant) => `refined planner/reviewer phrasing (variant ${variant})`,
+    },
+];
+/**
+ * The default mutator: deterministic, seeded, dependency-free. It applies the
+ * first matching bounded edit (in a seeded rotation) to the parent file. If no
+ * edit rule matches, it appends a tracking comment — a safe, signature-neutral
+ * no-op so the surface still differs and the file still passes the scanner.
+ */
+export class DeterministicMutator {
+    seed;
+    constructor(seed = 0) {
+        this.seed = seed;
+    }
+    async generateMutation(input) {
+        const { parentCode, surface } = input;
+        const variant = hash(this.seed, surface, parentCode.length) % 6;
+        const start = hash(this.seed, surface) % EDIT_RULES.length;
+        for (let i = 0; i < EDIT_RULES.length; i++) {
+            const rule = EDIT_RULES[(start + i) % EDIT_RULES.length];
+            if (!rule.find.test(parentCode))
+                continue;
+            const code = parentCode.replace(rule.find, (m) => rule.replace(m, variant));
+            if (code !== parentCode) {
+                return { code, summary: rule.summary(variant) };
+            }
+        }
+        // No structural edit matched — emit a signature-neutral tracking comment.
+        const note = `\n// darwin: ${surface} perturbation v${variant} (seed ${this.seed})\n`;
+        return {
+            code: parentCode.replace(/\s*$/, '') + note,
+            summary: `appended ${surface} tracking note (no structural edit available)`,
+        };
+    }
+}
+/**
+ * Deterministically pick one of the seven surfaces from `(generation+index+seed)`.
+ * Same inputs ⇒ same surface (reproducibility, ADR-070 §seed).
+ */
+export function pickSurface(generation, index, seed) {
+    const i = hash(generation, index, seed) % SURFACES.length;
+    return SURFACES[i];
+}
+/**
+ * Recursively copy a variant directory using `node:fs/promises` only (never a
+ * shell). The destination is created fresh; only the parent's files are copied,
+ * so no extraneous entry can leak in.
+ */
+export async function copyVariantDir(src, dest) {
+    await mkdir(dest, { recursive: true });
+    await cp(src, dest, { recursive: true, dereference: true, force: true });
+}
+/**
+ * Create a child variant from `parent`: copy its directory, pick one surface
+ * deterministically, regenerate that surface's file via `gen`, validate the
+ * generated code BEFORE writing, and return the resulting `HarnessVariant`.
+ *
+ * If `validateGeneratedCode` reports any violation, the mutation is DISCARDED
+ * and the parent's surface file is left untouched (a safe no-op). The child
+ * directory therefore always still passes `inspectVariant`.
+ */
+export async function createChildVariant(parent, workRoot, generation, index, gen = new DeterministicMutator(), seed = 0) {
+    const id = `g${generation}_v${index}`;
+    const dir = join(workRoot, 'variants', id);
+    // 1) Copy the parent directory verbatim (no shell, no extra files).
+    await copyVariantDir(parent.dir, dir);
+    // 2) Pick the single surface to mutate, deterministically.
+    const surface = pickSurface(generation, index, seed);
+    const fileName = FILE_BY_SURFACE[surface];
+    const filePath = join(dir, fileName);
+    const parentCode = await readFile(filePath, 'utf8');
+    // 3) Generate a candidate mutation for that one file.
+    const { code, summary } = await gen.generateMutation({
+        parentCode,
+        surface,
+        repoSummary: '',
+        parentScore: 0,
+        failedTraces: [],
+    });
+    // 4) Gate: validate BEFORE writing. Violations are discarded, never written.
+    const violations = validateGeneratedCode(code);
+    let mutationSummary;
+    if (violations.length > 0) {
+        // Discard: leave the parent's file unchanged (safe no-op mutation).
+        mutationSummary = `mutation rejected by validator; surface unchanged (${violations.join('; ')})`;
+    }
+    else if (code === parentCode) {
+        mutationSummary = `${summary} (no-op: identical to parent)`;
+    }
+    else {
+        await writeFile(filePath, code, 'utf8');
+        mutationSummary = summary;
+    }
+    return {
+        id,
+        parentId: parent.id,
+        generation,
+        dir,
+        mutationSurface: surface,
+        mutationSummary,
+        createdAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=mutator.js.map

package/dist/mutator.js.map

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

package/dist/openrouter-mutator.d.ts

@@ -0,0 +1,32 @@
+import type { CodeGenerator } from './mutator.js';
+import type { MutationSurface } from './types.js';
+export interface OpenRouterMutatorOptions {
+    model?: string;
+    /** Per-call cost/latency cap. */
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface MutatorTelemetry {
+    calls: number;
+    promptTokens: number;
+    completionTokens: number;
+    costUSD: number;
+}
+export declare class OpenRouterMutator implements CodeGenerator {
+    readonly model: string;
+    private readonly maxTokens;
+    private readonly temperature;
+    readonly telemetry: MutatorTelemetry;
+    constructor(opts?: OpenRouterMutatorOptions);
+    generateMutation(input: {
+        parentCode: string;
+        surface: MutationSurface;
+        repoSummary: string;
+        parentScore: number;
+        failedTraces: string[];
+    }): Promise<{
+        code: string;
+        summary: string;
+    }>;
+}
+//# sourceMappingURL=openrouter-mutator.d.ts.map

package/dist/openrouter-mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-mutator.d.ts","sourceRoot":"","sources":["../src/openrouter-mutator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkBlD,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAkE;gBAE1F,IAAI,GAAE,wBAA6B;IAMzC,gBAAgB,CAAC,KAAK,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA4C/C"}