darwin-agents 0.4.4

package/dist/evolution/loop.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Darwin — Evolution Loop
+ *
+ * The core evolution cycle. Called after every agent run, it:
+ *   1. Records the experiment
+ *   2. Checks for failure rollback
+ *   3. Manages A/B tests between prompt versions
+ *   4. Triggers prompt optimization when enough data exists
+ *
+ * This is the brain of Darwin's self-evolution.
+ */
+import type { AgentDefinition, DarwinExperiment, DarwinPattern, MemoryProvider } from '../types.js';
+import type { ExperimentTracker } from './tracker.js';
+import type { PromptOptimizer } from './optimizer.js';
+import type { SafetyGate } from './safety.js';
+import type { PatternDetector } from './patterns.js';
+import type { NotificationConfig } from './notifications.js';
+export interface EvolutionResult {
+    patternsFound: DarwinPattern[];
+    promptEvolved: boolean;
+    abTestStarted: boolean;
+    abTestCompleted: boolean;
+    rolledBack: boolean;
+    newVersion?: string;
+    message: string;
+}
+interface DarwinLoopDeps {
+    memory: MemoryProvider;
+    tracker: ExperimentTracker;
+    optimizer: PromptOptimizer;
+    safety: SafetyGate;
+    patterns: PatternDetector;
+    /** Agent definition — used to pass tool context to optimizer */
+    agent?: AgentDefinition;
+    /** Notification config (Telegram alerts) — auto-loaded from env if not set */
+    notifications?: NotificationConfig;
+}
+export declare class DarwinLoop {
+    private memory;
+    private tracker;
+    private optimizer;
+    private safety;
+    private patterns;
+    private agent?;
+    private notifications;
+    constructor(deps: DarwinLoopDeps);
+    /**
+     * Called AFTER every agent run. Drives the evolution cycle.
+     *
+     * Flow:
+     *   0. Detect incomplete runs (skip them)
+     *   1. Record experiment
+     *   2. Rollback check (consecutive failures)
+     *   3. A/B test management (if active)
+     *   4. Validate data quality before evolving
+     *   5. Evolution trigger (if enough data and no active test)
+     */
+    afterRun(experiment: DarwinExperiment): Promise<EvolutionResult>;
+    private handleABTest;
+    /**
+     * Roll back to the last known good prompt version.
+     * Returns true if a rollback was performed.
+     */
+    private rollback;
+    /**
+     * Activate a specific prompt version and deactivate all others.
+     */
+    private activateVersion;
+    /**
+     * Extract recent critic feedback reports from experiments.
+     *
+     * Returns up to `limit` feedback report texts from the most recent experiments
+     * that have critic feedback. Experiments are already ordered by started_at DESC
+     * from loadExperiments(), so we just filter for ones with feedback.
+     */
+    private getRecentFeedback;
+    /**
+     * Increment version string: "v1" -> "v2", "v12" -> "v13".
+     */
+    private nextVersion;
+    /**
+     * Check if a run is incomplete (agent ran out of turns or produced no real output).
+     * Incomplete runs are NOT recorded as experiments to avoid poisoning the data.
+     *
+     * Checks output length regardless of success flag — a 300-char "successful" run
+     * is still garbage data that shouldn't influence evolution.
+     */
+    private isIncompleteRun;
+    /**
+     * Validate that experiment data is clean enough for evolution.
+     * Prevents garbage-in-garbage-out (e.g., broken search backend producing 0 sources).
+     */
+    private validateDataQuality;
+    /**
+     * Build a human-readable change reason from detected patterns.
+     */
+    private buildChangeReason;
+}
+export {};
+//# sourceMappingURL=loop.d.ts.map

package/dist/evolution/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/evolution/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK7D,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,UAAU,cAAc;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAYD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAqB;gBAE9B,IAAI,EAAE,cAAc;IAUhC;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YA4NxD,YAAY;IAiG1B;;;OAGG;YACW,QAAQ;IA8BtB;;OAEG;YACW,eAAe;IAe7B;;;;;;OAMG;YACW,iBAAiB;IAe/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAKvB;;;OAGG;YACW,mBAAmB;IAiDjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAsB1B"}

package/dist/evolution/loop.js

@@ -0,0 +1,424 @@
+/**
+ * Darwin — Evolution Loop
+ *
+ * The core evolution cycle. Called after every agent run, it:
+ *   1. Records the experiment
+ *   2. Checks for failure rollback
+ *   3. Manages A/B tests between prompt versions
+ *   4. Triggers prompt optimization when enough data exists
+ *
+ * This is the brain of Darwin's self-evolution.
+ */
+import { notifyABTestComplete, notifyEvolutionStarted, notifyRollback } from './notifications.js';
+// ─── Validation Constants ─────────────────────────────
+/** Default minimum output length (overridden by agent.evolution.minOutputLength) */
+const DEFAULT_MIN_VALID_OUTPUT = 2000;
+/** Minimum % of runs with sources needed before evolution triggers */
+const MIN_SOURCE_COVERAGE = 0.5;
+// ─── Loop ──────────────────────────────────────────────
+export class DarwinLoop {
+    memory;
+    tracker;
+    optimizer;
+    safety;
+    patterns;
+    agent;
+    notifications;
+    constructor(deps) {
+        this.memory = deps.memory;
+        this.tracker = deps.tracker;
+        this.optimizer = deps.optimizer;
+        this.safety = deps.safety;
+        this.patterns = deps.patterns;
+        this.agent = deps.agent;
+        this.notifications = deps.notifications ?? {};
+    }
+    /**
+     * Called AFTER every agent run. Drives the evolution cycle.
+     *
+     * Flow:
+     *   0. Detect incomplete runs (skip them)
+     *   1. Record experiment
+     *   2. Rollback check (consecutive failures)
+     *   3. A/B test management (if active)
+     *   4. Validate data quality before evolving
+     *   5. Evolution trigger (if enough data and no active test)
+     */
+    async afterRun(experiment) {
+        const result = {
+            patternsFound: [],
+            promptEvolved: false,
+            abTestStarted: false,
+            abTestCompleted: false,
+            rolledBack: false,
+            message: '',
+        };
+        const agent = experiment.agentName;
+        // ── Step 0: Incomplete Run Detection (P1-3) ─────
+        if (this.isIncompleteRun(experiment)) {
+            // Track failure in A/B test if one is active
+            const preState = await this.memory.getState();
+            const activeTest = preState.abTests[agent] ?? null;
+            if (activeTest) {
+                // Atomically increment failure counts inside callback (prevents stale-read race)
+                await this.memory.updateState((s) => {
+                    const test = s.abTests[agent];
+                    if (!test)
+                        return s;
+                    if (experiment.promptVersion === test.versionA) {
+                        test.failsA = (test.failsA ?? 0) + 1;
+                    }
+                    else if (experiment.promptVersion === test.versionB) {
+                        test.failsB = (test.failsB ?? 0) + 1;
+                    }
+                    return s;
+                });
+                // Re-read state after atomic update for evaluation
+                const postState = await this.memory.getState();
+                const currentTest = postState.abTests[agent];
+                if (!currentTest) {
+                    result.message = `Incomplete run. A/B test cleared concurrently.`;
+                    return result;
+                }
+                // Check if this version should auto-lose due to unreliability
+                const evalResult = this.safety.evaluateABTest(0, 0, currentTest.runsA, currentTest.runsB, currentTest.failsA ?? 0, currentTest.failsB ?? 0, currentTest.minRuns);
+                if (evalResult !== 'continue') {
+                    const winner = evalResult === 'a_wins' ? currentTest.versionA : currentTest.versionB;
+                    const loser = evalResult === 'a_wins' ? currentTest.versionB : currentTest.versionA;
+                    await this.activateVersion(agent, winner);
+                    await this.memory.updateState((s) => {
+                        s.abTests[agent] = null;
+                        s.lastKnownGood[agent] = winner;
+                        s.activeVersions[agent] = winner;
+                        return s;
+                    });
+                    result.abTestCompleted = true;
+                    result.message = `A/B test auto-ended: ${loser} too unreliable. ${winner} wins.`;
+                    return result;
+                }
+            }
+            result.message = `Incomplete run detected (output: ${experiment.metrics.outputLength} chars). Skipping — not counted for evolution.`;
+            return result;
+        }
+        // ── Step 1: Record ────────────────────────────────
+        await this.tracker.recordExperiment(experiment);
+        // ── Step 2: Rollback check ────────────────────────
+        const state = await this.memory.getState();
+        const failures = state.consecutiveFailures[agent] ?? 0;
+        if (this.safety.shouldRollback(failures)) {
+            const rolledBack = await this.rollback(agent);
+            if (rolledBack) {
+                result.rolledBack = true;
+                result.message = `Rolled back to last known good version after ${failures} consecutive failures.`;
+                const rolledBackState = await this.memory.getState();
+                notifyRollback(this.notifications, agent, rolledBackState.activeVersions[agent] ?? 'unknown', failures).catch(() => { });
+                return result;
+            }
+        }
+        // ── Step 3: A/B test management ───────────────────
+        const activeTest = state.abTests[agent] ?? null;
+        if (activeTest) {
+            const testResult = await this.handleABTest(agent, experiment, activeTest);
+            result.abTestCompleted = testResult.completed;
+            if (testResult.completed) {
+                result.message = testResult.message;
+                if (testResult.winner) {
+                    result.newVersion = testResult.winner;
+                    result.promptEvolved = testResult.winner !== activeTest.versionA;
+                }
+                return result;
+            }
+            // Test still running — just record which bucket this was in
+            const failInfoA = (activeTest.failsA ?? 0) > 0 ? `, ${activeTest.failsA} fails` : '';
+            const failInfoB = (activeTest.failsB ?? 0) > 0 ? `, ${activeTest.failsB} fails` : '';
+            result.message = `A/B test in progress: ${activeTest.versionA} (${activeTest.runsA} runs${failInfoA}) vs ${activeTest.versionB} (${activeTest.runsB} runs${failInfoB}).`;
+            return result;
+        }
+        // ── Step 4: Check if we should evolve ─────────────
+        const stats = await this.tracker.getStats(agent);
+        if (!this.safety.canEvolve(agent, stats)) {
+            result.message = `Collecting data: ${stats.totalRuns} runs so far, need more before evolving.`;
+            return result;
+        }
+        // Detect patterns
+        const detectedPatterns = await this.patterns.detectPatterns(agent);
+        result.patternsFound = detectedPatterns;
+        // Only evolve if there are actionable patterns
+        const hasWeaknesses = detectedPatterns.some((p) => p.type === 'weakness');
+        const hasNegativeTrend = detectedPatterns.some((p) => p.type === 'trend' && p.description.includes('declining'));
+        if (!hasWeaknesses && !hasNegativeTrend) {
+            result.message = `${detectedPatterns.length} patterns found, but no weaknesses or negative trends — no evolution needed.`;
+            return result;
+        }
+        // ── Step 5: Input Validation (P0-1) ─────────────
+        const validation = await this.validateDataQuality(agent);
+        if (!validation.valid) {
+            result.message = `Data quality check failed: ${validation.reason}. Skipping evolution.`;
+            return result;
+        }
+        // Generate a new prompt variant
+        const activePrompt = await this.memory.getActivePrompt(agent);
+        if (!activePrompt) {
+            result.message = 'No active prompt found — cannot evolve.';
+            return result;
+        }
+        // Build tool context (P0-2) and category stats (P2-5) for optimizer
+        const toolContext = this.agent
+            ? { mcp: this.agent.mcp, tools: this.agent.tools }
+            : undefined;
+        const catStats = await this.tracker.getStatsByCategory(agent);
+        // Extract recent critic feedback reports for the optimizer.
+        // The optimizer previously only saw aggregated stats but not WHY runs scored poorly.
+        const recentFeedback = await this.getRecentFeedback(agent, 5);
+        const newPromptText = await this.optimizer.generateVariant(activePrompt.promptText, detectedPatterns, stats, toolContext, catStats, recentFeedback);
+        // Create a new prompt version
+        const newVersion = this.nextVersion(activePrompt.version);
+        const newPromptVersion = {
+            version: newVersion,
+            agentName: agent,
+            promptText: newPromptText,
+            createdAt: new Date().toISOString(),
+            parentVersion: activePrompt.version,
+            changeReason: this.buildChangeReason(detectedPatterns),
+            active: false, // Not active yet — going into A/B test
+            stats: { totalRuns: 0, avgQuality: 0, avgDuration: 0, successRate: 0, avgSourceCount: 0 },
+        };
+        await this.memory.savePromptVersion(newPromptVersion);
+        // Compute dynamic minRuns based on quality score variance
+        const allExperiments = await this.memory.loadExperiments(agent);
+        const agentMinRuns = this.agent?.evolution?.minRuns;
+        const dynamicMinRuns = this.safety.computeDynamicMinRuns(allExperiments, agentMinRuns);
+        // Start A/B test
+        const newTest = {
+            versionA: activePrompt.version,
+            versionB: newVersion,
+            runsA: 0,
+            runsB: 0,
+            failsA: 0,
+            failsB: 0,
+            minRuns: dynamicMinRuns,
+            startedAt: new Date().toISOString(),
+        };
+        await this.memory.updateState((s) => {
+            s.abTests[agent] = newTest;
+            return s;
+        });
+        result.promptEvolved = true;
+        result.abTestStarted = true;
+        result.newVersion = newVersion;
+        result.message = `New prompt ${newVersion} generated. A/B test started: ${activePrompt.version} vs ${newVersion} (minRuns: ${dynamicMinRuns}).`;
+        // Notify via Telegram (non-blocking)
+        notifyEvolutionStarted(this.notifications, agent, activePrompt.version, newVersion, this.buildChangeReason(detectedPatterns)).catch(() => { });
+        return result;
+    }
+    // ─── A/B Test Handling ─────────────────────────────
+    async handleABTest(agentName, experiment, test) {
+        // Atomically increment run counts inside callback (prevents stale-read race)
+        await this.memory.updateState((s) => {
+            const t = s.abTests[agentName];
+            if (!t)
+                return s;
+            if (experiment.promptVersion === t.versionA) {
+                t.runsA++;
+            }
+            else if (experiment.promptVersion === t.versionB) {
+                t.runsB++;
+            }
+            return s;
+        });
+        // Re-read the updated test state for evaluation
+        const postState = await this.memory.getState();
+        const currentTest = postState.abTests[agentName];
+        if (!currentTest) {
+            return { completed: false, message: 'A/B test cleared concurrently.' };
+        }
+        // Get composite scores — only from A/B test period
+        // Use agent-specific metric weights if configured.
+        const agentWeights = this.agent?.evolution?.metrics;
+        const compositeA = await this.tracker.getAverageComposite(agentName, currentTest.versionA, agentWeights, currentTest.startedAt);
+        const compositeB = await this.tracker.getAverageComposite(agentName, currentTest.versionB, agentWeights, currentTest.startedAt);
+        // Evaluate the test (including reliability from failure counts)
+        const outcome = this.safety.evaluateABTest(compositeA, compositeB, currentTest.runsA, currentTest.runsB, currentTest.failsA ?? 0, currentTest.failsB ?? 0, currentTest.minRuns);
+        if (outcome === 'continue') {
+            return { completed: false, message: 'A/B test continues.' };
+        }
+        // Test is complete — determine winner
+        let winner = outcome === 'a_wins' ? currentTest.versionA : currentTest.versionB;
+        let loser = outcome === 'a_wins' ? currentTest.versionB : currentTest.versionA;
+        // Regression check: if the challenger (B) won, verify it doesn't regress below A
+        if (outcome === 'b_wins') {
+            const passesRegression = this.safety.checkRegression(compositeA, compositeB);
+            if (!passesRegression) {
+                // B won on score but regressed on safety threshold — revert to A
+                winner = currentTest.versionA;
+                loser = currentTest.versionB;
+            }
+        }
+        // Activate winner, deactivate loser
+        await this.activateVersion(agentName, winner);
+        // Update state atomically: clear test, set last-known-good
+        await this.memory.updateState((s) => {
+            s.abTests[agentName] = null;
+            s.lastKnownGood[agentName] = winner;
+            s.activeVersions[agentName] = winner;
+            return s;
+        });
+        const scoreMsg = `(composite: ${outcome === 'a_wins' ? compositeA.toFixed(3) : compositeB.toFixed(3)} vs ${outcome === 'a_wins' ? compositeB.toFixed(3) : compositeA.toFixed(3)})`;
+        // Notify via Telegram (non-blocking)
+        const winnerScore = outcome === 'a_wins' ? compositeA : compositeB;
+        const loserScore = outcome === 'a_wins' ? compositeB : compositeA;
+        notifyABTestComplete(this.notifications, agentName, winner, loser, winnerScore, loserScore)
+            .catch(() => { });
+        return {
+            completed: true,
+            winner,
+            message: `A/B test complete: ${winner} wins over ${loser} ${scoreMsg}.`,
+        };
+    }
+    // ─── Rollback ──────────────────────────────────────
+    /**
+     * Roll back to the last known good prompt version.
+     * Returns true if a rollback was performed.
+     */
+    async rollback(agentName) {
+        const state = await this.memory.getState();
+        const lastGood = state.lastKnownGood[agentName];
+        if (!lastGood) {
+            return false;
+        }
+        const currentVersion = state.activeVersions[agentName];
+        if (currentVersion === lastGood) {
+            // Already on last-known-good — nothing to roll back
+            return false;
+        }
+        // Activate the last-known-good version
+        await this.activateVersion(agentName, lastGood);
+        // Atomically clear A/B test and reset failure counter
+        await this.memory.updateState((s) => {
+            s.abTests[agentName] = null;
+            s.activeVersions[agentName] = lastGood;
+            s.consecutiveFailures[agentName] = 0;
+            return s;
+        });
+        return true;
+    }
+    // ─── Helpers ───────────────────────────────────────
+    /**
+     * Activate a specific prompt version and deactivate all others.
+     */
+    async activateVersion(agentName, version) {
+        const allVersions = await this.memory.getAllPromptVersions(agentName);
+        for (const pv of allVersions) {
+            const shouldBeActive = pv.version === version;
+            if (pv.active !== shouldBeActive) {
+                pv.active = shouldBeActive;
+                await this.memory.savePromptVersion(pv);
+            }
+        }
+    }
+    /**
+     * Extract recent critic feedback reports from experiments.
+     *
+     * Returns up to `limit` feedback report texts from the most recent experiments
+     * that have critic feedback. Experiments are already ordered by started_at DESC
+     * from loadExperiments(), so we just filter for ones with feedback.
+     */
+    async getRecentFeedback(agentName, limit) {
+        const experiments = await this.memory.loadExperiments(agentName);
+        const feedback = [];
+        for (const exp of experiments) {
+            if (feedback.length >= limit)
+                break;
+            if (exp.feedback?.report) {
+                const header = `Score: ${exp.feedback.score}/10 | Task: "${exp.task}" | Version: ${exp.promptVersion}`;
+                feedback.push(`${header}\n${exp.feedback.report}`);
+            }
+        }
+        return feedback;
+    }
+    /**
+     * Increment version string: "v1" -> "v2", "v12" -> "v13".
+     */
+    nextVersion(current) {
+        const match = current.match(/^v(\d+)$/);
+        if (match) {
+            return `v${parseInt(match[1], 10) + 1}`;
+        }
+        // Fallback: append a version number
+        return `${current}-v2`;
+    }
+    // ─── Input Validation (P0-1) ─────────────────────
+    /**
+     * Check if a run is incomplete (agent ran out of turns or produced no real output).
+     * Incomplete runs are NOT recorded as experiments to avoid poisoning the data.
+     *
+     * Checks output length regardless of success flag — a 300-char "successful" run
+     * is still garbage data that shouldn't influence evolution.
+     */
+    isIncompleteRun(experiment) {
+        const minOutput = this.agent?.evolution?.minOutputLength ?? DEFAULT_MIN_VALID_OUTPUT;
+        return experiment.metrics.outputLength < minOutput;
+    }
+    /**
+     * Validate that experiment data is clean enough for evolution.
+     * Prevents garbage-in-garbage-out (e.g., broken search backend producing 0 sources).
+     */
+    async validateDataQuality(agentName) {
+        const experiments = await this.memory.loadExperiments(agentName);
+        if (experiments.length === 0) {
+            return { valid: false, reason: 'No experiments recorded' };
+        }
+        // Check: at least MIN_SOURCE_COVERAGE of runs have sources > 0
+        // Only enforce for agents that rely on sources (sourceCount weight > 0.05)
+        const sourceWeight = this.agent?.evolution?.metrics?.sourceCount ?? 0.15;
+        if (sourceWeight > 0.05) {
+            const withSources = experiments.filter((e) => e.metrics.sourceCount > 0);
+            const sourceCoverage = withSources.length / experiments.length;
+            if (sourceCoverage < MIN_SOURCE_COVERAGE) {
+                return {
+                    valid: false,
+                    reason: `Only ${(sourceCoverage * 100).toFixed(0)}% of runs have sources (need ${(MIN_SOURCE_COVERAGE * 100).toFixed(0)}%). Possible tool/search outage.`,
+                };
+            }
+        }
+        // Check: at least half of runs have quality scores
+        const withQuality = experiments.filter((e) => e.metrics.qualityScore !== null);
+        if (withQuality.length < experiments.length * 0.5) {
+            return {
+                valid: false,
+                reason: `Only ${withQuality.length}/${experiments.length} runs have quality scores. Critic may be failing.`,
+            };
+        }
+        // Check: no sudden metric collapse (last 3 runs all 0 sources = tool outage).
+        // loadExperiments() returns DESC order (newest first), so slice(0, 3) gets the latest.
+        // Only enforce for agents that rely on sources.
+        if (sourceWeight > 0.05) {
+            const recent = experiments.slice(0, 3);
+            if (recent.length >= 3 && recent.every((e) => e.metrics.sourceCount === 0)) {
+                return {
+                    valid: false,
+                    reason: 'Last 3 runs have 0 sources — likely search backend outage.',
+                };
+            }
+        }
+        return { valid: true, reason: 'Data quality OK' };
+    }
+    /**
+     * Build a human-readable change reason from detected patterns.
+     */
+    buildChangeReason(patterns) {
+        const weaknesses = patterns.filter((p) => p.type === 'weakness');
+        const trends = patterns.filter((p) => p.type === 'trend' && p.description.includes('declining'));
+        const reasons = [];
+        if (weaknesses.length > 0) {
+            reasons.push(`Address ${weaknesses.length} weakness${weaknesses.length > 1 ? 'es' : ''}: ${weaknesses.map((w) => w.description).join('; ')}`);
+        }
+        if (trends.length > 0) {
+            reasons.push(`Counter declining trend`);
+        }
+        return reasons.length > 0
+            ? reasons.join('. ')
+            : 'Optimization based on detected patterns';
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/evolution/loop.js.map

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

package/dist/evolution/multi-critic.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Darwin — Multi-Critic Evaluator
+ *
+ * Runs 3 specialized critics in parallel and takes the median score.
+ * More robust than a single critic — reduces bias and random variance.
+ *
+ * Agent-aware: Different agents get different evaluation criteria.
+ *
+ * Investigator Critics:
+ *   A: Facts & Sources — accuracy, citations, primary documents
+ *   B: Honesty & Courage — intellectual bravery, clear positions, uncomfortable truths
+ *   C: Completeness & Structure — full investigation, proper format, both sides covered
+ *
+ * Writer Critics:
+ *   A: Task Compliance & Accuracy — did the writer follow the brief? Correct claims?
+ *   B: Persuasion & Voice — tone, engagement, conviction, audience awareness
+ *   C: Substance & Originality — depth, concrete value, fresh angles
+ */
+/** Critic prompt definition */
+export interface CriticPromptDef {
+    name: string;
+    prompt: string;
+}
+/** Score result from a single critic */
+export interface CriticScore {
+    critic: string;
+    score: number;
+    report: string;
+}
+/** Combined result from multi-critic evaluation */
+export interface MultiCriticResult {
+    /** Median score across all critics */
+    medianScore: number;
+    /** Individual critic results */
+    critics: CriticScore[];
+    /** Combined report text */
+    combinedReport: string;
+}
+/** Function that runs a critic and returns its output */
+export type RunCriticFn = (systemPrompt: string, task: string, criticName: string) => Promise<string>;
+/**
+ * Get the right critic prompts for an agent.
+ * Falls back to investigator prompts for unknown agents (backward-compatible).
+ */
+export declare function getCriticPrompts(agentName: string): CriticPromptDef[];
+/** @deprecated Use getCriticPrompts(agentName) instead. Kept for backward compatibility. */
+export declare const CRITIC_PROMPTS: CriticPromptDef[];
+/**
+ * Run multiple specialized critics and return the median score.
+ * Critics are selected based on the agent being evaluated.
+ *
+ * @param agentOutput - The agent's output to evaluate
+ * @param task - The original task description
+ * @param runCritic - Function to run a critic (injected, uses Claude CLI)
+ * @param agentName - Name of the agent being evaluated (determines which critic set to use)
+ */
+export declare function runMultiCritic(agentOutput: string, task: string, runCritic: RunCriticFn, agentName?: string): Promise<MultiCriticResult>;
+//# sourceMappingURL=multi-critic.d.ts.map

package/dist/evolution/multi-critic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-critic.d.ts","sourceRoot":"","sources":["../../src/evolution/multi-critic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AA4PtG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAErE;AAED,4FAA4F;AAC5F,eAAO,MAAM,cAAc,EAAE,eAAe,EAAyB,CAAC;AAYtE;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,WAAW,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CA+C5B"}