darwin-agents 0.7.1 → 0.8.0

package/README.md

@@ -329,6 +329,11 @@ Actual numbers from **419 runs across 19 agents** in our internal `darwin_db`
 not synthetic benchmarks. "Success" means the run completed and produced valid
 output (100% across 419 runs); "quality" is the critic's separate 1–10 score.
 
+> Those 19 are our own internal + custom agents; the package ships **8 built-in
+> agents** by default (`writer`, `researcher`, `critic`, `analyst`,
+> `investigator`, `investigator-critic`, `marketing`, `blog-writer`) — the table
+> below shows the four with enough runs to report.
+
 ```
 Agent          Runs   Avg quality
 writer          172   6.94 / 10
@@ -402,12 +407,39 @@ darwin run analyst --path ./src    # Analyze a codebase
 darwin status                      # Overview of all agents
 darwin status writer               # Detailed agent stats + evolution history
 
-darwin evolve writer --enable      # Enable self-evolution
+darwin evolve writer --enable      # Enable self-evolution (persisted)
+darwin evolve writer --disable     # Disable self-evolution (persisted)
 darwin evolve writer --reset       # Reset to v1
+darwin evolve writer --force       # Force one optimization cycle now
 
 darwin create my-agent             # Scaffold a new agent
 ```
 
+### Advanced evolution flags
+
+The v0.6/v0.7 evolution strategies are reachable from the CLI. `darwin evolve`
+**persists** them onto the agent (they survive process exit); `darwin run`
+accepts the same flags as a one-off override for a single run.
+
+```bash
+# Persist: reflect with GEPA + a stronger reflection model, pick parents by coverage
+darwin evolve writer --gepa --reflection-model claude-opus-4-8 --coverage
+
+# One-off for a single run
+darwin run writer "Explain consensus" --gepa --pareto-gate
+```
+
+| Flag | What it does |
+|------|--------------|
+| `--gepa` / `--no-gepa` | GEPA-style reflective prompt mutation (vs. the legacy stats optimizer) |
+| `--merge` / `--no-merge` | GEPA system-aware merge of two Pareto-front prompts as a challenger source |
+| `--pareto-gate` / `--no-pareto-gate` | Reject an A/B winner that regressed on any objective |
+| `--coverage` / `--no-coverage` | Pick the reflection parent by per-task-type coverage breadth (GEPA Algorithm 2) |
+| `--reflection-model <id>` | Use a stronger model for GEPA reflection (the documented leverage point) |
+
+All default to **off** — the baseline single-objective evolution loop is
+unchanged unless you opt in.
+
 ## Storage: SQLite or PostgreSQL — both free, both MIT
 
 Darwin runs on SQLite by default (zero config, single file) and on PostgreSQL

package/dist/src/cli/evolution-flags.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Darwin CLI — shared parser for the advanced evolution-config flags.
+ *
+ * Both `darwin run` and `darwin evolve` accept the same knobs that toggle the
+ * v0.6/v0.7 evolution config (GEPA reflective optimizer, system-aware merge,
+ * Pareto activation gate, instance-wise coverage selection, and the reflection
+ * model). This module centralises the flag spelling + parsing so the two
+ * commands stay in sync.
+ *
+ *   --gepa / --no-gepa
+ *   --merge / --no-merge
+ *   --pareto-gate / --no-pareto-gate
+ *   --coverage / --no-coverage
+ *   --reflection-model <model-id>
+ */
+import type { EvolutionConfigOverride } from '../types.js';
+/** True when `arg` is one of the evolution-config flags this module handles. */
+export declare function isEvolutionConfigFlag(arg: string): boolean;
+/**
+ * Apply a single recognised evolution flag to `target`, mutating it in place.
+ *
+ * Returns the number of EXTRA argv tokens consumed (1 for `--reflection-model`
+ * which takes a value, 0 for the boolean flags). Callers that walk argv use the
+ * return value to advance their index. Unknown flags are ignored (return 0) —
+ * use {@link isEvolutionConfigFlag} to gate first.
+ */
+export declare function applyEvolutionFlag(arg: string, nextArg: string | undefined, target: EvolutionConfigOverride): number;
+/**
+ * Parse an argv slice into an {@link EvolutionConfigOverride}, returning the
+ * override plus the tokens that were NOT consumed (so the caller can keep
+ * parsing its own flags / positionals). Only the evolution-config flags above
+ * are recognised; everything else is passed through untouched.
+ */
+export declare function parseEvolutionConfigFlags(args: string[]): {
+    override: EvolutionConfigOverride;
+    rest: string[];
+};
+/** True when the override carries at least one set flag. */
+export declare function hasAnyEvolutionFlag(override: EvolutionConfigOverride): boolean;
+//# sourceMappingURL=evolution-flags.d.ts.map

package/dist/src/cli/evolution-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-flags.d.ts","sourceRoot":"","sources":["../../../src/cli/evolution-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAe1D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAmCR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IACzD,QAAQ,EAAE,uBAAuB,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAaA;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAQ9E"}

package/dist/src/cli/evolution-flags.js

@@ -0,0 +1,106 @@
+/**
+ * Darwin CLI — shared parser for the advanced evolution-config flags.
+ *
+ * Both `darwin run` and `darwin evolve` accept the same knobs that toggle the
+ * v0.6/v0.7 evolution config (GEPA reflective optimizer, system-aware merge,
+ * Pareto activation gate, instance-wise coverage selection, and the reflection
+ * model). This module centralises the flag spelling + parsing so the two
+ * commands stay in sync.
+ *
+ *   --gepa / --no-gepa
+ *   --merge / --no-merge
+ *   --pareto-gate / --no-pareto-gate
+ *   --coverage / --no-coverage
+ *   --reflection-model <model-id>
+ */
+/** True when `arg` is one of the evolution-config flags this module handles. */
+export function isEvolutionConfigFlag(arg) {
+    switch (arg) {
+        case '--gepa':
+        case '--no-gepa':
+        case '--merge':
+        case '--no-merge':
+        case '--pareto-gate':
+        case '--no-pareto-gate':
+        case '--coverage':
+        case '--no-coverage':
+        case '--reflection-model':
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Apply a single recognised evolution flag to `target`, mutating it in place.
+ *
+ * Returns the number of EXTRA argv tokens consumed (1 for `--reflection-model`
+ * which takes a value, 0 for the boolean flags). Callers that walk argv use the
+ * return value to advance their index. Unknown flags are ignored (return 0) —
+ * use {@link isEvolutionConfigFlag} to gate first.
+ */
+export function applyEvolutionFlag(arg, nextArg, target) {
+    switch (arg) {
+        case '--gepa':
+            target.useGepa = true;
+            return 0;
+        case '--no-gepa':
+            target.useGepa = false;
+            return 0;
+        case '--merge':
+            target.useMerge = true;
+            return 0;
+        case '--no-merge':
+            target.useMerge = false;
+            return 0;
+        case '--pareto-gate':
+            target.paretoGate = true;
+            return 0;
+        case '--no-pareto-gate':
+            target.paretoGate = false;
+            return 0;
+        case '--coverage':
+            target.useCoverage = true;
+            return 0;
+        case '--no-coverage':
+            target.useCoverage = false;
+            return 0;
+        case '--reflection-model':
+            if (nextArg !== undefined) {
+                target.reflectionModel = nextArg;
+                return 1;
+            }
+            return 0;
+        default:
+            return 0;
+    }
+}
+/**
+ * Parse an argv slice into an {@link EvolutionConfigOverride}, returning the
+ * override plus the tokens that were NOT consumed (so the caller can keep
+ * parsing its own flags / positionals). Only the evolution-config flags above
+ * are recognised; everything else is passed through untouched.
+ */
+export function parseEvolutionConfigFlags(args) {
+    const override = {};
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (isEvolutionConfigFlag(arg)) {
+            const consumed = applyEvolutionFlag(arg, args[i + 1], override);
+            i += consumed;
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { override, rest };
+}
+/** True when the override carries at least one set flag. */
+export function hasAnyEvolutionFlag(override) {
+    return (override.useGepa !== undefined ||
+        override.useMerge !== undefined ||
+        override.paretoGate !== undefined ||
+        override.useCoverage !== undefined ||
+        override.reflectionModel !== undefined);
+}
+//# sourceMappingURL=evolution-flags.js.map

package/dist/src/cli/evolution-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-flags.js","sourceRoot":"","sources":["../../../src/cli/evolution-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe,CAAC;QACrB,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe,CAAC;QACrB,KAAK,oBAAoB;YACvB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,OAA2B,EAC3B,MAA+B;IAE/B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,OAAO,CAAC,CAAC;QACX,KAAK,YAAY;YACf,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;YACxB,OAAO,CAAC,CAAC;QACX,KAAK,eAAe;YAClB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,KAAK,kBAAkB;YACrB,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,KAAK,YAAY;YACf,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,KAAK,eAAe;YAClB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,KAAK,oBAAoB;YACvB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC;gBACjC,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAc;IAItD,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAChE,CAAC,IAAI,QAAQ,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,QAAiC;IACnE,OAAO,CACL,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC9B,QAAQ,CAAC,QAAQ,KAAK,SAAS;QAC/B,QAAQ,CAAC,UAAU,KAAK,SAAS;QACjC,QAAQ,CAAC,WAAW,KAAK,SAAS;QAClC,QAAQ,CAAC,eAAe,KAAK,SAAS,CACvC,CAAC;AACJ,CAAC"}

package/dist/src/cli/evolve.d.ts

@@ -7,7 +7,16 @@
  *   darwin evolve researcher --enable
  *   darwin evolve researcher --disable
  *   darwin evolve researcher --reset
- *   darwin evolve researcher --force   (force optimization now)
+ *   darwin evolve researcher --force            (force one optimization now)
+ *   darwin evolve researcher --gepa --coverage  (persist advanced config flags)
+ *   darwin evolve researcher --reflection-model claude-opus-4-8
+ *
+ * Advanced flags (persisted, also accepted by `darwin run`):
+ *   --gepa / --no-gepa            GEPA reflective optimizer
+ *   --merge / --no-merge          GEPA system-aware merge
+ *   --pareto-gate / --no-pareto-gate   multi-objective A/B activation gate
+ *   --coverage / --no-coverage    instance-wise coverage selection
+ *   --reflection-model <id>       stronger reflection model for GEPA
  */
 export declare function evolveCommand(args: string[]): Promise<void>;
 //# sourceMappingURL=evolve.d.ts.map

package/dist/src/cli/evolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../../src/cli/evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDjE"}
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../../src/cli/evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGjE"}

package/dist/src/cli/evolve.js

@@ -7,28 +7,52 @@
  *   darwin evolve researcher --enable
  *   darwin evolve researcher --disable
  *   darwin evolve researcher --reset
- *   darwin evolve researcher --force   (force optimization now)
+ *   darwin evolve researcher --force            (force one optimization now)
+ *   darwin evolve researcher --gepa --coverage  (persist advanced config flags)
+ *   darwin evolve researcher --reflection-model claude-opus-4-8
+ *
+ * Advanced flags (persisted, also accepted by `darwin run`):
+ *   --gepa / --no-gepa            GEPA reflective optimizer
+ *   --merge / --no-merge          GEPA system-aware merge
+ *   --pareto-gate / --no-pareto-gate   multi-objective A/B activation gate
+ *   --coverage / --no-coverage    instance-wise coverage selection
+ *   --reflection-model <id>       stronger reflection model for GEPA
  */
 import { createMemory } from '../memory/index.js';
 import { loadConfig } from '../core/agent.js';
 import { builtinAgents } from '../agents/index.js';
+import { resolveEvolutionEnabled, resolveEvolutionConfig, setEvolutionEnabled, setEvolutionConfigOverrides, } from '../evolution/enabled-state.js';
+import { buildEvolutionLoop } from '../evolution/build-loop.js';
+import { parseEvolutionConfigFlags, hasAnyEvolutionFlag } from './evolution-flags.js';
 export async function evolveCommand(args) {
     const agentName = args[0];
     if (!agentName) {
-        throw new Error('Usage: darwin evolve <agent> [--enable|--disable|--reset|--force]');
+        throw new Error('Usage: darwin evolve <agent> [--enable|--disable|--reset|--force|--gepa|--coverage|…]');
     }
     const agent = builtinAgents[agentName];
     if (!agent) {
         throw new Error(`Unknown agent: "${agentName}". Available: ${Object.keys(builtinAgents).join(', ')}`);
     }
-    const flags = args.slice(1);
+    // Separate the advanced evolution-config flags from the action flags.
+    const { override, rest: flags } = parseEvolutionConfigFlags(args.slice(1));
     const config = await loadConfig();
     const memory = createMemory(config);
     await memory.init();
+    // Persist advanced-config flags FIRST (so e.g. `--force --gepa` forces with
+    // GEPA on, and `--gepa --coverage` alone just records the config).
+    if (hasAnyEvolutionFlag(override)) {
+        await setEvolutionConfigOverrides(memory, agentName, override);
+        console.log(`[darwin] Evolution config updated for ${agentName}: ${describeOverride(override)}`);
+    }
     if (flags.includes('--enable')) {
+        // Persist the override into DarwinState so it survives process exit.
+        // (Mutating the in-memory singleton alone was the v0.7.1 bug — the flag
+        // was gone the moment the CLI process ended and `darwin run` read the
+        // static source default again.)
         if (agent.evolution) {
             agent.evolution.enabled = true;
         }
+        await setEvolutionEnabled(memory, agentName, true);
         console.log(`[darwin] Evolution ENABLED for ${agentName}`);
         console.log(`[darwin] The critic will evaluate runs and Darwin will optimize prompts automatically.`);
     }
@@ -36,6 +60,7 @@ export async function evolveCommand(args) {
         if (agent.evolution) {
             agent.evolution.enabled = false;
         }
+        await setEvolutionEnabled(memory, agentName, false);
         console.log(`[darwin] Evolution DISABLED for ${agentName}`);
     }
     else if (flags.includes('--reset')) {
@@ -47,23 +72,83 @@ export async function evolveCommand(args) {
         console.log(`[darwin] Evolution RESET for ${agentName}. Back to v1.`);
     }
     else if (flags.includes('--force')) {
-        console.log(`[darwin] Force evolution is not yet available.`);
-        console.log(`[darwin] Run the agent normally — Darwin will evolve automatically after enough runs.`);
+        // On-demand manual trigger: run the loop's variant-generation + A/B-start
+        // path ONCE, bypassing the "enough runs / actionable patterns / data
+        // quality" gates of the automatic loop. Uses the experiments collected so
+        // far. Refuses cleanly when there is nothing to mutate from (no active
+        // prompt / no experiments) or a test is already running.
+        console.log(`[darwin] Forcing evolution for ${agentName}...`);
+        // Build the loop with the resolved advanced config (persisted overrides +
+        // any flags passed on this command line) so `--force --gepa` etc. take
+        // effect for the forced cycle.
+        const state = await memory.getState();
+        const resolvedEvolution = resolveEvolutionConfig(agent, state);
+        const evolutionAgent = resolvedEvolution
+            ? { ...agent, evolution: resolvedEvolution }
+            : agent;
+        const loop = buildEvolutionLoop(evolutionAgent, config, memory);
+        const evoResult = await loop.forceEvolve(agentName);
+        if (evoResult.abTestStarted) {
+            console.log(`[darwin] EVOLVED: ${evoResult.message}`);
+        }
+        else {
+            console.log(`[darwin] ${evoResult.message}`);
+        }
+        if (evoResult.patternsFound.length > 0) {
+            console.log(`[darwin] Patterns detected:`);
+            for (const p of evoResult.patternsFound.slice(0, 5)) {
+                console.log(`  ${p.type}: ${p.description}`);
+            }
+        }
     }
-    else {
-        // Show current status
+    else if (!hasAnyEvolutionFlag(override)) {
+        // Show current status (only when no config flag was the whole command —
+        // a bare `--gepa` already printed its confirmation above).
         const state = await memory.getState();
         const version = state.activeVersions[agentName] ?? 'v1';
         const runs = state.experimentCounts[agentName] ?? 0;
         const abTest = state.abTests[agentName];
-        const enabled = agent.evolution?.enabled ?? false;
+        // Reflect the PERSISTED override (set by --enable/--disable) so `darwin
+        // evolve <agent>` reports the same enabled-state `darwin run` will act on.
+        const enabled = resolveEvolutionEnabled(agent, state);
+        const evo = resolveEvolutionConfig(agent, state);
         console.log(`\n[darwin] Evolution for ${agentName}:`);
         console.log(`  Enabled:   ${enabled ? 'yes' : 'no'}`);
         console.log(`  Version:   ${version}`);
         console.log(`  Runs:      ${runs}`);
         console.log(`  A/B Test:  ${abTest ? `${abTest.versionA} vs ${abTest.versionB}` : 'none'}`);
         console.log(`  Min Runs:  ${agent.evolution?.minRuns ?? 5}`);
+        console.log(`  Advanced:  ${describeConfig(evo)}`);
     }
     await memory.close();
 }
+/** One-line summary of which advanced flags an override set (for confirmation). */
+function describeOverride(o) {
+    const parts = [];
+    if (o.useGepa !== undefined)
+        parts.push(`gepa=${o.useGepa}`);
+    if (o.useMerge !== undefined)
+        parts.push(`merge=${o.useMerge}`);
+    if (o.paretoGate !== undefined)
+        parts.push(`paretoGate=${o.paretoGate}`);
+    if (o.useCoverage !== undefined)
+        parts.push(`coverage=${o.useCoverage}`);
+    if (o.reflectionModel !== undefined)
+        parts.push(`reflectionModel=${o.reflectionModel}`);
+    return parts.length > 0 ? parts.join(', ') : '(none)';
+}
+/** One-line summary of the effective advanced config for the status view. */
+function describeConfig(evo) {
+    if (!evo)
+        return '(no evolution config)';
+    const parts = [
+        `gepa=${evo.useGepa ?? false}`,
+        `merge=${evo.useMerge ?? false}`,
+        `paretoGate=${evo.paretoGate ?? false}`,
+        `coverage=${evo.useCoverage ?? false}`,
+    ];
+    if (evo.reflectionModel)
+        parts.push(`reflectionModel=${evo.reflectionModel}`);
+    return parts.join(', ');
+}
 //# sourceMappingURL=evolve.js.map

package/dist/src/cli/evolve.js.map

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

package/dist/src/cli/index.js

@@ -36,6 +36,12 @@ const HELP = `
     darwin run analyst --path ./src
     darwin status researcher
     darwin evolve researcher --enable
+    darwin evolve researcher --force
+
+  Evolve flags:
+    --enable / --disable  Persistently turn self-evolution on/off for an agent
+    --reset               Reset the agent back to its v1 prompt
+    --force               Force one optimization cycle now (needs >=1 prior run)
 
   Options:
     --task-type <type>    Categorize the task (tech, webdesign, market, general)
@@ -44,6 +50,13 @@ const HELP = `
     --model <model>       Override LLM model
     --verbose             Show detailed output
     --help                Show this help
+
+  Advanced evolution flags (run + evolve; persisted by evolve):
+    --gepa / --no-gepa            GEPA reflective optimizer
+    --merge / --no-merge          GEPA system-aware merge
+    --pareto-gate / --no-pareto-gate   multi-objective A/B activation gate
+    --coverage / --no-coverage    instance-wise coverage selection
+    --reflection-model <id>       stronger reflection model for GEPA
 `;
 async function main() {
     const args = process.argv.slice(2);

package/dist/src/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/src/cli/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwJH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9D"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8JH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9D"}

package/dist/src/cli/run.js

@@ -7,15 +7,13 @@ import { builtinAgents } from '../agents/index.js';
 import { createMemory } from '../memory/index.js';
 import { runAgent } from '../core/runner.js';
 import { loadConfig } from '../core/agent.js';
-import { DarwinLoop } from '../evolution/loop.js';
-import { ExperimentTracker } from '../evolution/tracker.js';
-import { PatternDetector } from '../evolution/patterns.js';
-import { PromptOptimizer } from '../evolution/optimizer.js';
-import { GepaOptimizer } from '../evolution/optimizer-gepa.js';
-import { SafetyGate } from '../evolution/safety.js';
 import { runMultiCritic, getCriticPrompts } from '../evolution/multi-critic.js';
-import { loadNotificationConfig } from '../evolution/notifications.js';
 import { createProvider } from '../providers/index.js';
+import { resolveEvolutionEnabled } from '../evolution/enabled-state.js';
+import { parseCriticScore } from '../evolution/parse-score.js';
+import { resolveEvolutionConfig } from '../evolution/enabled-state.js';
+import { buildEvolutionLoop } from '../evolution/build-loop.js';
+import { isEvolutionConfigFlag, applyEvolutionFlag } from './evolution-flags.js';
 /**
  * Auto-detect available API keys and assign different providers to critics.
  * Reduces LLM-as-judge bias by using multiple model families.
@@ -72,6 +70,7 @@ function parseRunArgs(args) {
         noEvolve: false,
         noCritic: false,
         verbose: false,
+        evolutionOverride: {},
     };
     const positional = [];
     for (let i = 0; i < args.length; i++) {
@@ -103,7 +102,12 @@ function parseRunArgs(args) {
                 flags.verbose = true;
                 break;
             default:
-                positional.push(arg);
+                if (isEvolutionConfigFlag(arg)) {
+                    i += applyEvolutionFlag(arg, args[i + 1], flags.evolutionOverride);
+                }
+                else {
+                    positional.push(arg);
+                }
         }
     }
     flags.agentName = positional[0] ?? '';
@@ -161,11 +165,17 @@ async function runCommandInner(flags, agent, config, memory) {
     if (provider)
         console.log(`[darwin] Provider: ${provider.name}`);
     console.log('');
+    // Resolve the effective evolution-enabled flag ONCE from persisted state.
+    // `darwin evolve --enable/--disable` records the override in DarwinState; a
+    // persisted value wins over the agent definition's static default. Reading
+    // the static `agent.evolution?.enabled` directly (the v0.7.1 behaviour) lost
+    // the toggle across processes.
+    const preState = await memory.getState();
+    const evolutionEnabled = resolveEvolutionEnabled(agent, preState);
     // A/B test routing: check if there's an active test and pick a version
     let activePromptVersion = 'v1';
     let agentToRun = agent;
     {
-        const preState = await memory.getState();
         const abTest = preState.abTests[agent.name] ?? null;
         if (abTest) {
             // Round-robin: pick whichever version has fewer runs
@@ -227,7 +237,7 @@ async function runCommandInner(flags, agent, config, memory) {
     }
     // Save experiment — tracker.recordExperiment() handles this for evolution-enabled agents.
     // Only save here for non-evolution agents to avoid double-save.
-    if (!agent.evolution?.enabled) {
+    if (!evolutionEnabled) {
         await memory.saveExperiment(result.experiment);
         await memory.updateState((state) => {
             state.experimentCounts[agent.name] = (state.experimentCounts[agent.name] ?? 0) + 1;
@@ -238,8 +248,8 @@ async function runCommandInner(flags, agent, config, memory) {
         });
     }
     // Run critic evaluation (unless skipped)
-    if (!flags.noCritic && agent.name !== 'critic' && agent.name !== 'investigator-critic' && agent.name !== 'multi-critic' && agent.evolution?.enabled) {
-        const evaluatorName = agent.evolution.evaluator ?? 'critic';
+    if (!flags.noCritic && agent.name !== 'critic' && agent.name !== 'investigator-critic' && agent.name !== 'multi-critic' && evolutionEnabled) {
+        const evaluatorName = agent.evolution?.evaluator ?? 'critic';
         if (evaluatorName === 'multi-critic') {
             // ── Multi-Critic Mode — Multi-Model ───────────
             const criticProviders = resolveCriticProviders(agent.name);
@@ -290,18 +300,11 @@ async function runCommandInner(flags, agent, config, memory) {
                 taskType: 'evaluation',
                 autonomous: true,
             });
-            // Parse critic score (primary: ===SCORE=== format, fallback: "X/10" pattern)
-            const scoreMatch = criticResult.output.match(/===SCORE===\s*(\d+(?:\.\d+)?)/);
-            let score = scoreMatch ? parseFloat(scoreMatch[1]) : null;
-            if (score === null) {
-                const fallback = criticResult.output.match(/\b(\d+(?:\.\d+)?)\s*\/\s*10\b/);
-                if (fallback) {
-                    score = parseFloat(fallback[1]);
-                }
-            }
-            if (score !== null) {
-                score = Math.max(1, Math.min(10, score));
-            }
+            // Parse critic score with the shared robust extractor (handles
+            // ===SCORE===, N/10, "N out of 10", "rating: N", "I'd rate this N", …;
+            // already clamped to 1–10). Previously only ===SCORE=== + a bare N/10
+            // were handled, silently dropping every other phrasing from evolution.
+            const score = parseCriticScore(criticResult.output);
             if (score !== null) {
                 result.experiment.metrics.qualityScore = score;
                 result.experiment.feedback = {
@@ -315,51 +318,17 @@ async function runCommandInner(flags, agent, config, memory) {
         }
     }
     // Darwin evolution loop (unless skipped)
-    if (!flags.noEvolve && agent.evolution?.enabled) {
-        const tracker = new ExperimentTracker(memory);
-        const patterns = new PatternDetector(memory);
-        const safety = new SafetyGate();
-        // The optimizer uses Claude CLI to generate improved prompts
-        const optimizer = new PromptOptimizer(async (metaPrompt) => {
-            const optimizerResult = await runAgent({
-                name: 'optimizer',
-                role: 'Prompt Optimizer',
-                description: 'Generates improved prompt variants',
-                type: 'llm',
-                systemPrompt: 'You are a prompt optimization expert. Return ONLY the improved prompt text.',
-                maxTurns: 3,
-                model: 'claude-sonnet-4-6',
-            }, metaPrompt, { config, taskType: 'optimization', autonomous: true });
-            return optimizerResult.output;
-        });
-        // v0.6.0 — GEPA reflective optimizer (opt-in via agent.evolution.useGepa).
-        // Routes the reflection LLM call through a (ideally STRONGER) model: GEPA's
-        // published guidance + the Decagon production ablation both find the
-        // reflection model is the leverage point — a weak reflector can leave the
-        // prompt unchanged. Warn if useGepa is on but no reflectionModel is set.
-        let gepa;
-        if (agent.evolution?.useGepa) {
-            const reflectionModel = agent.evolution.reflectionModel;
-            if (!reflectionModel) {
-                console.warn('[darwin] evolution.useGepa is on but no evolution.reflectionModel is set — ' +
-                    'reflection will use the agent model. GEPA works best with a STRONGER reflection ' +
-                    'model (e.g. claude-opus-4-8); set agent.evolution.reflectionModel to silence this.');
-            }
-            gepa = new GepaOptimizer(async (reflectionPrompt) => {
-                const reflectionResult = await runAgent({
-                    name: 'reflector',
-                    role: 'GEPA Reflector',
-                    description: 'Reflective prompt mutator (GEPA smallest-possible-edit)',
-                    type: 'llm',
-                    systemPrompt: 'You are a prompt-engineering reflector. Return ONLY the mutated prompt text.',
-                    maxTurns: 3,
-                    model: reflectionModel ?? agent.model ?? 'claude-sonnet-4-6',
-                }, reflectionPrompt, { config, taskType: 'reflection', autonomous: true });
-                return reflectionResult.output;
-            });
-        }
-        const notifications = loadNotificationConfig();
-        const loop = new DarwinLoop({ memory, tracker, optimizer, safety, patterns, agent, notifications, gepa });
+    if (!flags.noEvolve && evolutionEnabled) {
+        // Resolve the advanced evolution config: static definition < persisted
+        // overrides (darwin evolve --gepa/…) < this run's CLI flags. The resulting
+        // config drives both the GEPA wiring and the loop. With no overrides set,
+        // resolvedEvolution === the static config, so the loop is wired exactly as
+        // before (default path unchanged).
+        const resolvedEvolution = resolveEvolutionConfig(agent, preState, flags.evolutionOverride);
+        const evolutionAgent = resolvedEvolution
+            ? { ...agent, evolution: resolvedEvolution }
+            : agent;
+        const loop = buildEvolutionLoop(evolutionAgent, config, memory);
         console.log(`\n[darwin] Evolution: Running Darwin loop...`);
         const evoResult = await loop.afterRun(result.experiment);
         if (evoResult.rolledBack) {