darwin-agents 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 ## [Unreleased]
 
+## [0.7.1] — 2026-06-20
+
+**Documentation honesty + a reproducible evolution benchmark.** No library code
+changed — `src/` is byte-for-byte 0.7.0, **455 tests green**, `build` clean. This
+release makes every claim in the README survive scrutiny and ships a way to
+reproduce the one that matters.
+
+### Added
+
+- **`benchmark/`** — a reproducible evolution benchmark (`npm run benchmark`).
+  Ships the baseline `writer` prompt and the prompt Darwin's own optimizer
+  produced from it, a frozen held-out task set, and the exact critic-scoring
+  loop, so anyone can reproduce the baseline-vs-evolved delta on their own tasks.
+  `--quick` (1 task) and `--dry` (validate wiring, zero LLM calls) flags.
+
+### Changed
+
+- **README metrics are now real and dated.** Replaced the stale "300+ runs /
+  7.2–7.8" block with actual figures from 419 runs across 19 agents
+  (Mar–Jun 2026), including the measured v1→v2 evolution lift (writer +0.23,
+  marketing +0.28).
+- **Removed the "Darwin Pro — coming soon" tier.** PostgreSQL already ships free
+  in the open-source package; the old table implied a paywall and even listed
+  Postgres itself as a paid feature. Replaced with an honest "SQLite or
+  PostgreSQL — both free, both MIT" section + an open roadmap for the
+  genuinely-unbuilt features (pgvector semantic search, cross-agent learnings,
+  analytics, contradiction detection, data export).
+- **Clarified the LLM-as-judge mitigation.** Critics are multi-*dimension* by
+  default; the CLI spreads them across model families (GPT + Claude) only when
+  more than one provider key is present.
+- **Comparison table:** "MCP native" → "MCP-native memory bridge" — the specific,
+  defensible claim (other frameworks added MCP tool use during 2025).
+- Surfaced the production safety gate, online GEPA, and always-valid sequential
+  tests in a "why this isn't a toy" callout near the top of the README.
+
 ## [0.7.0] — 2026-06-20
 
 **Statistical rigor + coverage sampling.** Seven additive, opt-in upgrades that

package/README.md

@@ -79,6 +79,16 @@ Your agent got better.
 You did nothing.
 ```
 
+> **Why this isn't a toy.** The loop runs behind a real production **safety gate**
+> — regression rollback to last-known-good, data-quality guards that pause
+> evolution during a tool outage, and an alignment check on *every* mutation so a
+> rewrite can't quietly erode a safety constraint. It can drive that mutation with
+> a [GEPA](https://arxiv.org/abs/2507.19457) reflective optimizer running **online,
+> inside the gate** (not as an offline batch step), and the A/B gate supports
+> **always-valid sequential tests** (mSPRT / Hoeffding) so checking after every run
+> doesn't inflate false positives. Details: [reflective evolution](#reflective-evolution--gepa-online-v06-opt-in)
+> · [statistical rigor](#statistical-rigor--coverage-sampling-v07-opt-in).
+
 ## Quick Start
 
 ```bash
@@ -313,28 +323,36 @@ last run's lessons.
 
 <!-- REAL_METRICS_START -->
 
-### Real results from 300+ production runs
+### Real results from our own production use (Mar–Jun 2026)
 
-These are actual metrics from our development — not synthetic benchmarks.
+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.
 
-```
-Agents:      writer, researcher, marketing, blog-writer
-Total Runs:  300+
-Success Rate: 100%
+> 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.
 
-Writer:       7.2/10  (120 runs across tech, webdesign, market)
-Marketing:    7.8/10  (70 runs across LinkedIn, Instagram)
-Researcher:   7.6/10  (50+ runs, web research with citations)
+```
+Agent          Runs   Avg quality
+writer          172   6.94 / 10
+marketing        70   7.74 / 10
+investigator     28   8.33 / 10
+blog-writer       5   8.20 / 10
 ```
 
-#### Multi-Model Critics in action
+**Evolution, measured.** When the safety gate adopted an evolved prompt, the
+critic score rose on the runs that followed — modest, but real and directional:
 
 ```
-platform-compliance  ████████░░  8/10
-scroll-stopping      ████████░░  8/10
-conversion-intent    ████████░░  8/10
+writer      v1  6.89 (126 runs)  →  v2  7.12 (42 runs)    +0.23
+marketing   v1  7.64 (45 runs)   →  v2  7.92 (25 runs)    +0.28
 ```
 
+Don't take our word for it — reproduce the v1-vs-evolved comparison on your own
+tasks with [`npm run benchmark`](benchmark/).
+
 <!-- REAL_METRICS_END -->
 
 ## Feature Comparison
@@ -346,7 +364,7 @@ conversion-intent    ████████░░  8/10
 | Safety gate + rollback | **Yes** | No | No | No | No |
 | TypeScript native | **Yes** | No (Python) | No (Python) | No (Python) | No (Python) |
 | Zero-config first agent | **Yes** | No | No | No | Partial |
-| MCP native | **Yes** | No | No | No | No |
+| MCP-native memory bridge | **Yes** | No | No | No | No |
 | File-based (no DB required) | **Yes** | No | No | No | No |
 | Built-in Critic agent | **Yes** | No | No | No | No |
 
@@ -374,8 +392,10 @@ Darwin uses SQLite by default — zero config, single file, no database to insta
     └── exp-researcher-2026-03-08-002.md
 ```
 
-**Want semantic search, cross-agent learnings, and analytics?**
-Upgrade to [Darwin Pro](#darwin-pro) for PostgreSQL + pgvector support.
+**Want concurrent multi-process writes and richer analytics?**
+PostgreSQL is supported out of the box, for free — set `DARWIN_POSTGRES_URL`.
+Semantic search (pgvector), cross-agent learnings and analytics are on the
+[roadmap](#storage-sqlite-or-postgresql--both-free-both-mit), not gated behind a paywall.
 
 ## CLI Reference
 
@@ -387,34 +407,65 @@ 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
 ```
 
-## Darwin Pro
+### Advanced evolution flags
 
-The free version uses SQLite — great for getting started, handles thousands of experiments.
+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
+```
 
-For teams and production use, Darwin Pro adds:
+| 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) |
 
-| Feature | Free (SQLite) | Pro (PostgreSQL) |
+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
+out of the box — just set `DARWIN_POSTGRES_URL`. Both backends ship in the
+open-source package. There is no paywall.
+
+| Capability | SQLite | PostgreSQL |
 |---------|:---:|:---:|
 | Experiment tracking | ✓ | ✓ |
 | Prompt versioning | ✓ | ✓ |
-| A/B testing | ✓ | ✓ |
-| Safety gate | ✓ | ✓ |
-| Keyword search | ✓ | ✓ |
-| **Semantic search** (pgvector) | — | ✓ |
-| **Cross-agent learnings** | — | ✓ |
-| **Analytics & time series** | — | ✓ |
-| **Contradiction detection** | — | ✓ |
-| **Team support** (multi-user) | — | ✓ |
-| **Data export** (CSV/JSON) | — | ✓ |
-| **Learning decay** | — | ✓ |
-
-*Coming soon. Follow the repo for updates.*
+| A/B testing + safety gate | ✓ | ✓ |
+| Keyword search | ✓ (FTS5) | ✓ (GIN / `ts_rank`) |
+| Concurrent multi-process writes | — | ✓ |
+
+### Roadmap
+
+Not built yet — tracked in the open, PRs welcome:
+
+- Semantic search (pgvector embeddings)
+- Cross-agent learnings
+- Analytics & time series
+- Contradiction detection
+- Data export (CSV/JSON)
+
+The core stays MIT. If a hosted option ever ships, the self-host path keeps
+every feature.
 
 ## FAQ
 
@@ -438,7 +489,7 @@ The safety gate prevents regressions. If a new variant scores >20% lower, Darwin
 
 ## Known Limitations
 
-- **LLM-as-Judge bias**: Critics use LLMs to evaluate LLM outputs. We mitigate this with multi-model critics (GPT + Claude), but inherent self-preference bias exists. [Research context](https://openreview.net/forum?id=Ns8zGZ0lmM).
+- **LLM-as-Judge bias**: Critics use LLMs to evaluate LLM outputs. Each agent is scored by a **multi-dimension critic set** (several scoring rubrics per agent type, not a single number). When more than one provider key is present, the CLI also spreads those critics across model families — e.g. GPT for one, Claude for another — to blunt single-model self-preference; with one provider they all run on it. Inherent judge bias still exists. [Research context](https://openreview.net/forum?id=Ns8zGZ0lmM).
 - **Statistical simplicity (default)**: A/B tests use mean comparison with a 5% threshold by default, not formal significance tests. `computeDynamicMinRuns()` adjusts sample sizes based on variance. For rigor, v0.6 added an opt-in `requireConfidence` effect-size gate and **v0.7 ships proper always-valid sequential tests** — set `confidenceMethod: 'msprt'` (Mixture SPRT) or `'hoeffding'` (σ-free confidence sequence) on your `SafetyThresholds` to make the peeking-resistant gate statistically sound. The default path remains the simple threshold for zero-config use.
 - **No human-in-the-loop approval**: Prompt mutations go directly to A/B testing. Telegram notifications inform you, but there's no approval gate before testing starts.
 

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"}