darwin-agents 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,119 @@
 
 ## [Unreleased]
 
+## [0.10.0] — 2026-07-03
+
+Two research-driven, opt-in evolution surfaces — a new challenger *source*
+(demo injection) and a new parent-*selection* strategy for the existing
+reflective challenger — both validated against the current state of the field
+(GEPA upstream docs, DSPy SIMBA) before a line was written. Default behaviour
+is byte-for-byte unchanged with the flags off.
+
+### Added
+
+- **SIMBA-style demo injection** (`src/evolution/demos.ts` + `evolution.useDemos`).
+  DSPy's SIMBA optimizer improves programs two ways: appending self-reflective
+  *rules* (Darwin's reflector already covers that ground) and appending
+  successful past examples as *demonstrations*. This release adapts the second
+  strategy to the online loop: on every `demoEveryK`-th evolution cycle (default
+  4) the loop harvests the agent's own highest-scoring past runs (score ≥
+  `demoScoreThreshold`, default 8; at most one demo per task type for
+  diversity; `maxDemos` cap, default 2) and appends them as a marker-delimited
+  "Demonstrations" section. The demo-augmented prompt is a normal challenger —
+  same alignment guard, same A/B test, same safety gate; if demos don't help
+  this agent, the incumbent wins. **Zero LLM cost** (pure selection +
+  rendering on data Darwin already persists), works with or without `useGepa`,
+  idempotent via `<!-- darwin:demos:start/end -->` markers (a later cycle
+  *refreshes* the section, never stacks a second one). Pure helpers
+  (`selectDemoCandidates` / `buildDemoSection` / `applyDemoSection` /
+  `stripDemoSection`) are exported from the package root. CLI: `--demos` /
+  `--no-demos`.
+
+- **Parent-selection strategies** (`src/evolution/selection.ts` +
+  `evolution.candidateSelection`) — GEPA `candidate_selection_strategy` parity
+  for the online loop. Historically the loop always reflected from the
+  currently-active prompt (a hill-climb that can sit on a local optimum).
+  Opt-in strategies pick the reflection parent from the agent's *scored
+  version history* instead: `'best'` (GEPA `current_best` — highest
+  scalarised composite), `'pareto'` (GEPA default — uniform sample from the
+  non-dominated front, keeping lineages alive that win on different
+  objectives), `'epsilon-greedy'` (explore with probability
+  `explorationEpsilon`, default 0.1, exploit otherwise). The RNG is
+  injectable via the new `DarwinLoopDeps.rng` for deterministic tests.
+  Precedence: `useCoverage` (GEPA Algorithm 2, the more specific selector)
+  wins when it finds a coverage parent. Only consulted when `useGepa` is on.
+  CLI: `--candidate-selection <active|best|pareto|epsilon-greedy>`.
+
+### Internal
+
+- `tryMergeVariant`'s version-history scoring extracted into a shared
+  `buildScoredHistory` (used by merge *and* parent selection) — behaviour
+  unchanged.
+- `package.json` now lists Claude (Anthropic) as a contributor — see the
+  README's new **Credits** section for how this project is actually built.
+
+## [0.9.0] — 2026-06-21
+
+### Added
+
+- **Validate-by-reproduce drift-detection canary** (Phase 2 A5) — new
+  `src/evolution/canary.ts` + a `darwin canary <agent>` command. The A/B gate
+  guards prompt *quality*; the canary guards *behaviour*. It compares an agent's
+  recent execution trajectories (captured in A1) against a frozen baseline using
+  tolerance-based metrics — unordered tool-set Jaccard, ordered tool-sequence
+  similarity, turn-count ratio, error-rate delta — and flags drift the score can
+  miss (a model update or a broken tool changing *how* the agent works while the
+  quality score stays flat). Exact-hash equivalence is deliberately avoided (LLM
+  runs are non-deterministic). Drift requires a *pattern* (default ≥2 of N runs),
+  and the baseline is pinned to the active prompt version so an intentional
+  evolution reports `insufficient-data` (re-baseline) rather than a false alarm.
+  Pure and zero-dep; `--json` + `--exit-on-drift` for CI. The metrics and the
+  `runCanaryOverExperiments` orchestrator are exported from the package root so
+  consumers can run the same check on their own captured trajectories.
+
+- **Cross-family critic diversity check** (`src/evolution/critic-families.ts`).
+  Multi-critic evaluation spreads critics across model families to reduce
+  LLM-as-judge bias — but only when more than one provider key is present.
+  Otherwise all three critics collapse onto a single family (`claude-cli` and
+  `anthropic-api` are the *same* family, differing only in latency) with no
+  signal to the operator. The run path now warns when the critics share one
+  family, and hard-fails when `DARWIN_REQUIRE_CROSS_FAMILY` is set (CI / strict
+  setups). Default behaviour is unchanged apart from the new warning.
+
+## [0.8.0] — 2026-06-21
+
+**Evolution wired end-to-end through the CLI, plus three correctness fixes.** The
+v0.7 evolution surfaces existed but the `darwin evolve` command couldn't fully
+drive them; this release closes that gap and hardens score parsing. The
+automatic loop is behaviour-preserving — the gated path still passes the
+existing loop/GEPA suites unchanged.
+
+### Added
+
+- **`darwin evolve <agent> --force`** now runs the loop's real
+  variant-generation + A/B-start path on demand (`DarwinLoop.forceEvolve()`),
+  bypassing the automatic "enough runs / actionable patterns / data quality"
+  gates while still refusing the impossible cases (no active prompt, no recorded
+  experiments, an A/B test already running). It was previously a stub that
+  printed "not yet available" while the help text advertised it.
+- **`src/evolution/build-loop.ts`** — shared loop wiring (legacy optimizer +
+  opt-in GEPA) used by both `cli/run.ts` and the new `--force` command.
+
+### Fixed
+
+- **`darwin evolve <agent> --enable|--disable` now persists.** The flag mutated
+  only the in-memory agent singleton, so it was lost on process exit and `darwin
+  run` read the static source default again. A new `DarwinState.evolutionEnabled`
+  override map (round-tripped by every backend's existing JSON state blob) is set
+  atomically by the evolve command and wins over the static default in the run
+  path. Persisting an enable on an agent with no evolution config is a no-op, not
+  a crash; the field is read defensively so pre-existing state rows keep their
+  prior behaviour. New shared helper `src/evolution/enabled-state.ts`.
+- **Robust critic-score parsing** via a shared `parseCriticScore` helper —
+  handles `===SCORE===`, `N/10`, "N out of 10", "rating: N", "I'd rate this N", …
+  (clamped 1–10). Previously only `===SCORE===` and a bare `N/10` were read,
+  silently dropping every other phrasing from evolution.
+
 ## [0.7.1] — 2026-06-20
 
 **Documentation honesty + a reproducible evolution benchmark.** No library code

package/README.md

@@ -195,6 +195,66 @@ const loop = new DarwinLoop({
 - **Style-bias-free judging** (`normalizeForJudging`) — strip markdown before the
   critic scores, so it measures content not formatting.
 
+### Drift detection — validate-by-reproduce canary (v0.9)
+
+The A/B gate guards prompt *quality*. The canary guards *behaviour*: a model
+update or a broken tool can change *how* an agent reaches its answer (different
+tools, more turns, more errors) while the quality score stays flat. `darwin
+canary` re-checks recent runs against a frozen baseline and flags that drift.
+
+```bash
+darwin canary writer                 # Stable / drift / insufficient-data report
+darwin canary writer --json          # Machine-readable, for dashboards
+darwin canary writer --exit-on-drift # Non-zero exit on drift, for CI
+```
+
+It compares execution *trajectories* (captured opt-in since v0.5) with
+tolerance-based metrics — unordered tool-set Jaccard, ordered sequence
+similarity, turn-count ratio, error-rate delta — never an exact hash (LLM runs
+are non-deterministic). Drift has to be a *pattern* (≥2 of N runs), and the
+baseline is pinned to the active prompt version, so an intentional evolution
+reports `insufficient-data` (re-baseline), not a false alarm. The metrics and
+the `runCanaryOverExperiments` orchestrator are exported for your own pipelines.
+
+**Cross-family judging:** with more than one provider key present, Darwin
+already spreads the three critics across model families to cut LLM-as-judge
+bias. With only one key they collapse onto a single family (note: `claude-cli`
+and `anthropic-api` are the *same* family) — Darwin now warns, and hard-fails
+under `DARWIN_REQUIRE_CROSS_FAMILY=1` for strict / CI setups.
+
+### Demo injection + parent selection (v0.10, opt-in)
+
+Two more challenger surfaces, both borrowed from the strongest ideas in the
+field and adapted to the online loop. Both are off by default.
+
+**Demo injection** (`useDemos`) is DSPy SIMBA's `append_a_demo` strategy: on
+every `demoEveryK`-th cycle (default 4) the loop harvests the agent's *own
+highest-scoring past runs* (score ≥ 8, one per task type, capped at
+`maxDemos`) and appends them to the prompt as a marker-delimited
+"Demonstrations" section. Zero LLM cost — pure selection over data Darwin
+already stores — and the demo-augmented prompt is a normal challenger: same
+alignment guard, same A/B test, same rollback. If showing the agent its own
+best work doesn't measurably help, the incumbent wins and nothing changes.
+
+**Parent selection** (`candidateSelection`) is GEPA's
+`candidate_selection_strategy`: instead of always mutating the currently-active
+prompt (a hill-climb), reflect from `'best'` (highest composite in the version
+history), `'pareto'` (uniform sample from the history's Pareto front — keeps
+lineages alive that win on *different* objectives), or `'epsilon-greedy'`
+(explore with probability `explorationEpsilon`). Requires `useGepa`.
+
+```typescript
+evolution: {
+  enabled: true,
+  useDemos: true,                    // SIMBA-style demos as a challenger source
+  demoEveryK: 4,                     // cadence (offset from mergeEveryK: 3)
+  maxDemos: 2,
+  useGepa: true,
+  candidateSelection: 'pareto',      // or 'best' | 'epsilon-greedy' | 'active'
+  explorationEpsilon: 0.1,           // only for 'epsilon-greedy'
+},
+```
+
 ## Built-in Agents
 
 | Agent | What it does | Needs |
@@ -407,6 +467,8 @@ darwin run analyst --path ./src    # Analyze a codebase
 darwin status                      # Overview of all agents
 darwin status writer               # Detailed agent stats + evolution history
 
+darwin canary writer               # Behavioural drift vs a frozen baseline (--json, --exit-on-drift)
+
 darwin evolve writer --enable      # Enable self-evolution (persisted)
 darwin evolve writer --disable     # Disable self-evolution (persisted)
 darwin evolve writer --reset       # Reset to v1
@@ -436,6 +498,8 @@ darwin run writer "Explain consensus" --gepa --pareto-gate
 | `--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) |
+| `--demos` / `--no-demos` | SIMBA-style demo injection: the agent's best past runs as a challenger (v0.10) |
+| `--candidate-selection <s>` | Reflection parent strategy: `active` \| `best` \| `pareto` \| `epsilon-greedy` (v0.10) |
 
 All default to **off** — the baseline single-objective evolution loop is
 unchanged unless you opt in.
@@ -497,6 +561,19 @@ The safety gate prevents regressions. If a new variant scores >20% lower, Darwin
 
 PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
 
+## Credits
+
+Darwin is pair-built by a human and an AI, and we think that should be said
+plainly rather than hidden. Matthias Meyer (StudioMeyer) sets direction, makes
+the calls and reviews everything; most of the code is written by
+[Claude](https://www.anthropic.com/claude) — currently **Claude Fable 5** —
+working from research against the primary sources (the GEPA paper and
+reference implementation, DSPy, the MCP spec) and gated by multi-agent code
+review plus this repo's own test suite before anything ships. Claude is listed
+as a contributor in `package.json`, and the commits it co-writes carry a
+`Co-Authored-By` trailer. A framework about agents that improve themselves,
+built with an agent — we find that fitting.
+
 ## About StudioMeyer
 
 [StudioMeyer](https://studiomeyer.io) is an AI and design studio based in Palma de Mallorca, working with clients worldwide. We build custom websites and AI infrastructure for small and medium businesses. Production stack on Claude Agent SDK, MCP and n8n, with Sentry, Langfuse and LangGraph for observability and an in-house guard layer.

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

@@ -0,0 +1,13 @@
+/**
+ * darwin canary <agent> [--json] [--exit-on-drift]
+ *
+ * Validate-by-reproduce drift check (Phase 2 A5). Loads the agent's recent
+ * experiments, baselines within the active prompt version, and reports whether
+ * the recent trajectories have drifted from that baseline (different tools,
+ * more turns, more errors) — behavioural drift the A/B *quality* gate can miss.
+ *
+ * Read-only. Exits 0 by default even on drift (the signal is the printed report
+ * / JSON, mirroring the staleness monitor); pass `--exit-on-drift` for CI.
+ */
+export declare function canaryCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=canary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canary.d.ts","sourceRoot":"","sources":["../../../src/cli/canary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BjE"}

package/dist/src/cli/canary.js

@@ -0,0 +1,66 @@
+/**
+ * darwin canary <agent> [--json] [--exit-on-drift]
+ *
+ * Validate-by-reproduce drift check (Phase 2 A5). Loads the agent's recent
+ * experiments, baselines within the active prompt version, and reports whether
+ * the recent trajectories have drifted from that baseline (different tools,
+ * more turns, more errors) — behavioural drift the A/B *quality* gate can miss.
+ *
+ * Read-only. Exits 0 by default even on drift (the signal is the printed report
+ * / JSON, mirroring the staleness monitor); pass `--exit-on-drift` for CI.
+ */
+import { createMemory } from '../memory/index.js';
+import { loadConfig } from '../core/agent.js';
+import { runCanaryOverExperiments } from '../evolution/canary.js';
+/** How many recent experiments to pull for the drift window — wide enough that
+ *  several same-version runs land in it after an evolution. */
+const CANARY_WINDOW = 100;
+export async function canaryCommand(args) {
+    const agentName = args.find((a) => !a.startsWith('--'));
+    if (!agentName) {
+        throw new Error('Usage: darwin canary <agent> [--json] [--exit-on-drift]');
+    }
+    const asJson = args.includes('--json');
+    const exitOnDrift = args.includes('--exit-on-drift');
+    const config = await loadConfig();
+    const memory = createMemory(config);
+    await memory.init();
+    try {
+        const state = await memory.getState();
+        const activeVersion = state.activeVersions[agentName] ?? null;
+        const experiments = await memory.loadExperiments(agentName, CANARY_WINDOW);
+        const report = runCanaryOverExperiments(agentName, experiments, activeVersion);
+        if (asJson) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+        if (exitOnDrift && report.status === 'drift') {
+            process.exitCode = 1;
+        }
+    }
+    finally {
+        await memory.close();
+    }
+}
+function printReport(report) {
+    const icon = report.status === 'drift' ? '⚠' : report.status === 'ok' ? '✓' : '·';
+    console.log('');
+    console.log(`[darwin] Canary: ${report.agentName}${report.promptVersion ? ` / ${report.promptVersion}` : ''}`);
+    if (report.baselineId)
+        console.log(`  Baseline:  ${report.baselineId}`);
+    console.log(`  Evaluated: ${report.evaluated} candidate run(s)`);
+    console.log(`  Status:    ${icon} ${report.status.toUpperCase()}`);
+    if (report.result) {
+        const r = report.result;
+        console.log(`  Drifted:   ${r.driftedCount}/${r.total} runs`);
+        console.log(`  Medians:   tool-Jaccard ${r.medianToolJaccard.toFixed(2)} | turn-ratio ${r.medianTurnRatio.toFixed(2)}`);
+        if (r.reasons.length > 0) {
+            console.log(`  Reasons:   ${r.reasons.join('; ')}`);
+        }
+    }
+    console.log(`  ${report.message}`);
+    console.log('');
+}
+//# sourceMappingURL=canary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canary.js","sourceRoot":"","sources":["../../../src/cli/canary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAqB,MAAM,wBAAwB,CAAC;AAErF;+DAC+D;AAC/D,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAC9D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QAE/E,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAoB;IACvC,MAAM,IAAI,GACR,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAEvE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/G,IAAI,MAAM,CAAC,UAAU;QAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,mBAAmB,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAEnE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxH,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

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

@@ -12,6 +12,8 @@
  *   --pareto-gate / --no-pareto-gate
  *   --coverage / --no-coverage
  *   --reflection-model <model-id>
+ *   --demos / --no-demos                                       (v0.10.0)
+ *   --candidate-selection <active|best|pareto|epsilon-greedy>  (v0.10.0)
  */
 import type { EvolutionConfigOverride } from '../types.js';
 /** True when `arg` is one of the evolution-config flags this module handles. */

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

@@ -1 +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"}
+{"version":3,"file":"evolution-flags.d.ts","sourceRoot":"","sources":["../../../src/cli/evolution-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAU3D,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAkB1D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAyDR;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,CAU9E"}

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

@@ -12,7 +12,16 @@
  *   --pareto-gate / --no-pareto-gate
  *   --coverage / --no-coverage
  *   --reflection-model <model-id>
+ *   --demos / --no-demos                                       (v0.10.0)
+ *   --candidate-selection <active|best|pareto|epsilon-greedy>  (v0.10.0)
  */
+/** Valid values for `--candidate-selection` (v0.10.0). */
+const CANDIDATE_SELECTION_VALUES = new Set([
+    'active',
+    'best',
+    'pareto',
+    'epsilon-greedy',
+]);
 /** True when `arg` is one of the evolution-config flags this module handles. */
 export function isEvolutionConfigFlag(arg) {
     switch (arg) {
@@ -25,6 +34,9 @@ export function isEvolutionConfigFlag(arg) {
         case '--coverage':
         case '--no-coverage':
         case '--reflection-model':
+        case '--demos':
+        case '--no-demos':
+        case '--candidate-selection':
             return true;
         default:
             return false;
@@ -70,6 +82,27 @@ export function applyEvolutionFlag(arg, nextArg, target) {
                 return 1;
             }
             return 0;
+        case '--demos':
+            target.useDemos = true;
+            return 0;
+        case '--no-demos':
+            target.useDemos = false;
+            return 0;
+        case '--candidate-selection':
+            // Value is consumed either way (it was clearly meant as this flag's
+            // argument); it is only APPLIED when it names a known strategy — an
+            // unknown value warns instead of silently persisting a config the loop
+            // would then silently treat as 'active'.
+            if (nextArg !== undefined) {
+                if (CANDIDATE_SELECTION_VALUES.has(nextArg)) {
+                    target.candidateSelection = nextArg;
+                }
+                else {
+                    console.warn(`[darwin] --candidate-selection "${nextArg}" is not one of: ${[...CANDIDATE_SELECTION_VALUES].join(', ')} — ignored.`);
+                }
+                return 1;
+            }
+            return 0;
         default:
             return 0;
     }
@@ -101,6 +134,8 @@ export function hasAnyEvolutionFlag(override) {
         override.useMerge !== undefined ||
         override.paretoGate !== undefined ||
         override.useCoverage !== undefined ||
-        override.reflectionModel !== undefined);
+        override.reflectionModel !== undefined ||
+        override.useDemos !== undefined ||
+        override.candidateSelection !== undefined);
 }
 //# sourceMappingURL=evolution-flags.js.map

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

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

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

@@ -17,6 +17,8 @@
  *   --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
+ *   --demos / --no-demos          SIMBA-style demo injection (v0.10)
+ *   --candidate-selection <s>     reflection parent: active|best|pareto|epsilon-greedy
  */
 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;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGjE"}
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../../src/cli/evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAeH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGjE"}

package/dist/src/cli/evolve.js

@@ -17,6 +17,8 @@
  *   --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
+ *   --demos / --no-demos          SIMBA-style demo injection (v0.10)
+ *   --candidate-selection <s>     reflection parent: active|best|pareto|epsilon-greedy
  */
 import { createMemory } from '../memory/index.js';
 import { loadConfig } from '../core/agent.js';
@@ -135,6 +137,10 @@ function describeOverride(o) {
         parts.push(`coverage=${o.useCoverage}`);
     if (o.reflectionModel !== undefined)
         parts.push(`reflectionModel=${o.reflectionModel}`);
+    if (o.useDemos !== undefined)
+        parts.push(`demos=${o.useDemos}`);
+    if (o.candidateSelection !== undefined)
+        parts.push(`candidateSelection=${o.candidateSelection}`);
     return parts.length > 0 ? parts.join(', ') : '(none)';
 }
 /** One-line summary of the effective advanced config for the status view. */
@@ -146,9 +152,13 @@ function describeConfig(evo) {
         `merge=${evo.useMerge ?? false}`,
         `paretoGate=${evo.paretoGate ?? false}`,
         `coverage=${evo.useCoverage ?? false}`,
+        `demos=${evo.useDemos ?? false}`,
     ];
     if (evo.reflectionModel)
         parts.push(`reflectionModel=${evo.reflectionModel}`);
+    if (evo.candidateSelection && evo.candidateSelection !== 'active') {
+        parts.push(`candidateSelection=${evo.candidateSelection}`);
+    }
     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

@@ -14,12 +14,14 @@ import { statusCommand } from './status.js';
 import { evolveCommand } from './evolve.js';
 import { initCommand } from './init.js';
 import { createCommand } from './create.js';
+import { canaryCommand } from './canary.js';
 const HELP = `
   darwin — AI agents that improve themselves.
 
   Usage:
     darwin run <agent> "task"     Run an agent on a task
     darwin status [agent]        Show evolution status & metrics
+    darwin canary <agent>        Check for behavioural drift vs a frozen baseline
     darwin evolve <agent>        Manage evolution settings
     darwin create <name>         Scaffold a new agent
     darwin init                  Initialize darwin in current project
@@ -57,6 +59,8 @@ const HELP = `
     --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
+    --demos / --no-demos          SIMBA-style demo injection (v0.10)
+    --candidate-selection <s>     reflection parent: active|best|pareto|epsilon-greedy
 `;
 async function main() {
     const args = process.argv.slice(2);
@@ -73,6 +77,9 @@ async function main() {
             case 'status':
                 await statusCommand(args.slice(1));
                 break;
+            case 'canary':
+                await canaryCommand(args.slice(1));
+                break;
             case 'evolve':
                 await evolveCommand(args.slice(1));
                 break;

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CZ,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,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;AA8JH,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;AAmKH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9D"}

package/dist/src/cli/run.js

@@ -11,6 +11,7 @@ import { runMultiCritic, getCriticPrompts } from '../evolution/multi-critic.js';
 import { createProvider } from '../providers/index.js';
 import { resolveEvolutionEnabled } from '../evolution/enabled-state.js';
 import { parseCriticScore } from '../evolution/parse-score.js';
+import { checkCriticFamilies, crossFamilyRequired, singleFamilyHint } from '../evolution/critic-families.js';
 import { resolveEvolutionConfig } from '../evolution/enabled-state.js';
 import { buildEvolutionLoop } from '../evolution/build-loop.js';
 import { isEvolutionConfigFlag, applyEvolutionFlag } from './evolution-flags.js';
@@ -29,7 +30,7 @@ function resolveCriticProviders(agentName) {
     const defaults = {};
     // Initialize all critics with CLI default
     for (const { name } of prompts) {
-        defaults[name] = { model: 'claude-sonnet-4-6', label: 'claude-cli' };
+        defaults[name] = { model: 'claude-sonnet-4-6', label: 'claude-cli', family: 'anthropic' };
     }
     const criticNames = prompts.map(p => p.name);
     // GPT-5.4 for first critic (model diversity — different training, different biases)
@@ -40,6 +41,7 @@ function resolveCriticProviders(agentName) {
                 provider: openaiProvider,
                 model: 'gpt-5.4',
                 label: 'openai/gpt-5.4',
+                family: 'openai',
             };
         }
         catch {
@@ -54,6 +56,7 @@ function resolveCriticProviders(agentName) {
                 provider: anthropicProvider,
                 model: 'claude-sonnet-4-6',
                 label: 'anthropic-api',
+                family: 'anthropic',
             };
         }
         catch {
@@ -253,6 +256,18 @@ async function runCommandInner(flags, agent, config, memory) {
         if (evaluatorName === 'multi-critic') {
             // ── Multi-Critic Mode — Multi-Model ───────────
             const criticProviders = resolveCriticProviders(agent.name);
+            // Cross-family bias check: if every critic collapsed onto a single model
+            // family (e.g. only a Claude key present, so claude-cli + anthropic-api),
+            // the LLM-as-judge diversity guarantee is gone. Warn by default; hard-fail
+            // when DARWIN_REQUIRE_CROSS_FAMILY is set (CI / strict setups).
+            const familyCheck = checkCriticFamilies(criticProviders);
+            if (familyCheck.singleFamily) {
+                const hint = singleFamilyHint(familyCheck);
+                if (crossFamilyRequired()) {
+                    throw new Error(`[darwin] DARWIN_REQUIRE_CROSS_FAMILY is set. ${hint}`);
+                }
+                console.warn(`[darwin] ⚠  ${hint}`);
+            }
             const providerLabels = Object.entries(criticProviders)
                 .map(([name, info]) => `${name}→${info.label}`)
                 .join(', ');