@dragonflymcp/plugin 1.0.0

package/dist/tools/evolve/algorithm.js

@@ -0,0 +1,64 @@
+/**
+ * Evolution Algorithm
+ * Tournament selection, elite preservation, and convergence detection.
+ */
+/**
+ * Tournament selection: pick k random candidates, return the best.
+ * Repeat `count` times to get multiple parents.
+ */
+export function tournamentSelect(variants, count, k = 3) {
+    const parents = [];
+    for (let i = 0; i < count; i++) {
+        const candidates = [];
+        for (let j = 0; j < k; j++) {
+            candidates.push(variants[Math.floor(Math.random() * variants.length)]);
+        }
+        candidates.sort((a, b) => (b.fitnessScore ?? 0) - (a.fitnessScore ?? 0));
+        parents.push(candidates[0]);
+    }
+    return parents;
+}
+/**
+ * Get elite variants (top N by fitness) that always survive to the next generation.
+ */
+export function getElites(variants, count = 2) {
+    return [...variants]
+        .sort((a, b) => (b.fitnessScore ?? 0) - (a.fitnessScore ?? 0))
+        .slice(0, count);
+}
+/**
+ * Check if evolution has converged.
+ * Converged = best fitness hasn't improved by more than `threshold`
+ * for `window` consecutive generations.
+ */
+export function checkConvergence(fitnessHistory, window = 3, threshold = 0.01) {
+    if (fitnessHistory.length < window + 1)
+        return false;
+    const recent = fitnessHistory.slice(-window);
+    const baseline = fitnessHistory[fitnessHistory.length - window - 1];
+    return recent.every((f) => f - baseline < threshold);
+}
+/**
+ * Build mutation instructions for the next generation.
+ * For each parent, identify weaknesses and create instructions.
+ */
+export function buildMutationInstructions(parents, conceptName, populationSize) {
+    const parentInfo = parents.map((p) => ({
+        prompt: p.prompt,
+        fitness: p.fitnessScore ?? 0,
+        weaknesses: p.notes ?? "No specific weaknesses noted",
+    }));
+    const instructions = [
+        `Generate ${populationSize} variant prompts for "${conceptName}".`,
+        `Use these top-performing parents as starting points:`,
+        ...parentInfo.map((p, i) => `  Parent ${i + 1} (fitness: ${p.fitness.toFixed(2)}): "${p.prompt.slice(0, 100)}..."${p.weaknesses !== "No specific weaknesses noted" ? ` — Weakness: ${p.weaknesses}` : ""}`),
+        ``,
+        `For each variant:`,
+        `1. Take a parent prompt and modify it to improve weaknesses`,
+        `2. Keep the parts that scored well`,
+        `3. Evaluate each variant against the test cases`,
+        `4. Call evolve_submit with the scored variants`,
+    ].join("\n");
+    return { parents: parentInfo, instructions };
+}
+//# sourceMappingURL=algorithm.js.map

package/dist/tools/evolve/algorithm.js.map

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

package/dist/tools/evolve/algorithm.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Evolution Algorithm Tests
+ * Pure function tests — no DB needed
+ */
+export {};
+//# sourceMappingURL=algorithm.test.d.ts.map

package/dist/tools/evolve/algorithm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.test.d.ts","sourceRoot":"","sources":["../../../src/tools/evolve/algorithm.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tools/evolve/algorithm.test.js

@@ -0,0 +1,138 @@
+/**
+ * Evolution Algorithm Tests
+ * Pure function tests — no DB needed
+ */
+import { describe, it, expect } from 'vitest';
+import { tournamentSelect, getElites, checkConvergence, buildMutationInstructions, } from './algorithm.js';
+function makeVariant(overrides = {}) {
+    return {
+        id: `var-${Math.random().toString(36).slice(2, 6)}`,
+        sessionId: 'evo-test',
+        generation: 0,
+        prompt: 'Test prompt',
+        fitnessScore: 0.5,
+        notes: null,
+        parentId: null,
+        createdAt: new Date().toISOString(),
+        ...overrides,
+    };
+}
+describe('tournamentSelect', () => {
+    it('should return the requested number of parents', () => {
+        const variants = Array.from({ length: 10 }, (_, i) => makeVariant({ fitnessScore: i * 0.1 }));
+        const parents = tournamentSelect(variants, 3);
+        expect(parents).toHaveLength(3);
+    });
+    it('should return variants from the input pool', () => {
+        const variants = [
+            makeVariant({ prompt: 'A', fitnessScore: 0.9 }),
+            makeVariant({ prompt: 'B', fitnessScore: 0.1 }),
+            makeVariant({ prompt: 'C', fitnessScore: 0.5 }),
+        ];
+        const parents = tournamentSelect(variants, 2, 2);
+        for (const p of parents) {
+            expect(['A', 'B', 'C']).toContain(p.prompt);
+        }
+    });
+    it('should bias toward higher-fitness variants', () => {
+        const high = makeVariant({ prompt: 'high', fitnessScore: 1.0 });
+        const low = makeVariant({ prompt: 'low', fitnessScore: 0.0 });
+        const variants = [high, low, low, low]; // 3:1 ratio of low:high
+        // With tournament k=3 from 4 variants (3 low, 1 high), the high should still win often
+        const parents = tournamentSelect(variants, 50, 3);
+        const highCount = parents.filter((p) => p.prompt === 'high').length;
+        // High should appear more often than pure random (12.5 out of 50 = 25%)
+        expect(highCount).toBeGreaterThan(15);
+    });
+});
+describe('getElites', () => {
+    it('should return top N variants sorted by fitness descending', () => {
+        const variants = [
+            makeVariant({ prompt: 'low', fitnessScore: 0.2 }),
+            makeVariant({ prompt: 'high', fitnessScore: 0.9 }),
+            makeVariant({ prompt: 'mid', fitnessScore: 0.5 }),
+            makeVariant({ prompt: 'very-high', fitnessScore: 0.95 }),
+        ];
+        const elites = getElites(variants, 2);
+        expect(elites).toHaveLength(2);
+        expect(elites[0].prompt).toBe('very-high');
+        expect(elites[1].prompt).toBe('high');
+    });
+    it('should handle count larger than variants', () => {
+        const variants = [makeVariant({ fitnessScore: 0.5 })];
+        const elites = getElites(variants, 5);
+        expect(elites).toHaveLength(1);
+    });
+    it('should not mutate the original array', () => {
+        const variants = [
+            makeVariant({ fitnessScore: 0.1 }),
+            makeVariant({ fitnessScore: 0.9 }),
+        ];
+        const originalFirst = variants[0];
+        getElites(variants, 1);
+        expect(variants[0]).toBe(originalFirst);
+    });
+    it('should handle null fitness scores as 0', () => {
+        const variants = [
+            makeVariant({ fitnessScore: null }),
+            makeVariant({ fitnessScore: 0.5 }),
+        ];
+        const elites = getElites(variants, 1);
+        expect(elites[0].fitnessScore).toBe(0.5);
+    });
+});
+describe('checkConvergence', () => {
+    it('should return false when history is too short', () => {
+        expect(checkConvergence([0.5, 0.6])).toBe(false);
+        expect(checkConvergence([0.5, 0.6, 0.7])).toBe(false);
+    });
+    it('should return true when fitness stagnates', () => {
+        // window=3: need at least 4 entries
+        // baseline = history[-4] = 0.8
+        // recent 3 all <= 0.8 + 0.01
+        const history = [0.5, 0.6, 0.7, 0.8, 0.8, 0.8, 0.8];
+        expect(checkConvergence(history)).toBe(true);
+    });
+    it('should return false when fitness is still improving', () => {
+        const history = [0.5, 0.6, 0.7, 0.8, 0.85, 0.9, 0.95];
+        expect(checkConvergence(history)).toBe(false);
+    });
+    it('should respect custom window and threshold', () => {
+        // window=2, threshold=0.05
+        // baseline = history[-3] = 0.8
+        // recent 2: [0.81, 0.82] — both < 0.8 + 0.05 = 0.85
+        const history = [0.5, 0.7, 0.8, 0.81, 0.82];
+        expect(checkConvergence(history, 2, 0.05)).toBe(true);
+    });
+    it('should return false when one recent value shows improvement', () => {
+        // baseline = 0.8, one recent value exceeds threshold
+        const history = [0.5, 0.7, 0.8, 0.8, 0.8, 0.82];
+        expect(checkConvergence(history, 3, 0.01)).toBe(false);
+    });
+});
+describe('buildMutationInstructions', () => {
+    it('should include concept name in instructions', () => {
+        const parents = [makeVariant({ prompt: 'Parent A', fitnessScore: 0.8 })];
+        const result = buildMutationInstructions(parents, 'code-review', 5);
+        expect(result.instructions).toContain('code-review');
+    });
+    it('should include parent fitness info', () => {
+        const parents = [
+            makeVariant({ prompt: 'Parent A', fitnessScore: 0.8, notes: 'Too verbose' }),
+            makeVariant({ prompt: 'Parent B', fitnessScore: 0.6 }),
+        ];
+        const result = buildMutationInstructions(parents, 'summarizer', 3);
+        expect(result.parents).toHaveLength(2);
+        expect(result.parents[0].fitness).toBe(0.8);
+        expect(result.parents[0].weaknesses).toBe('Too verbose');
+        expect(result.parents[1].weaknesses).toBe('No specific weaknesses noted');
+        expect(result.instructions).toContain('0.80');
+        expect(result.instructions).toContain('Too verbose');
+    });
+    it('should mention population size', () => {
+        const parents = [makeVariant({ fitnessScore: 0.5 })];
+        const result = buildMutationInstructions(parents, 'test', 7);
+        expect(result.instructions).toContain('7');
+    });
+});
+//# sourceMappingURL=algorithm.test.js.map

package/dist/tools/evolve/algorithm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.test.js","sourceRoot":"","sources":["../../../src/tools/evolve/algorithm.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,SAAS,WAAW,CAAC,YAAuC,EAAE;IAC5D,OAAO;QACL,EAAE,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACnD,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,GAAG;QACjB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnD,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CACvC,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;SAChD,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,wBAAwB;QAEhE,uFAAuF;QACvF,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QACpE,wEAAwE;QACxE,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YACjD,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YAClD,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YACjD,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SACzD,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;YAClC,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;SACnC,CAAC;QACF,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACnC,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;SACnC,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,oCAAoC;QACpC,+BAA+B;QAC/B,6BAA6B;QAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,2BAA2B;QAC3B,+BAA+B;QAC/B,oDAAoD;QACpD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,qDAAqD;QACrD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG;YACd,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;YAC5E,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;SACvD,CAAC;QACF,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/evolve/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Evolve Module
+ * Orchestrated prompt evolution where Claude drives mutation/evaluation
+ * and dragonfly manages state, selection, and convergence.
+ *
+ * 4 tools: evolve_start, evolve_submit, evolve_status, evolve_best
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export declare const evolveModule: import("../../core/types.js").ToolModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/evolve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/evolve/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAmC1D,eAAO,MAAM,KAAK,EAAE,IAAI,EA2GvB,CAAC;AA8MF,eAAO,MAAM,YAAY,0CAAkC,CAAC"}

package/dist/tools/evolve/index.js

@@ -0,0 +1,300 @@
+/**
+ * Evolve Module
+ * Orchestrated prompt evolution where Claude drives mutation/evaluation
+ * and dragonfly manages state, selection, and convergence.
+ *
+ * 4 tools: evolve_start, evolve_submit, evolve_status, evolve_best
+ */
+import { successResponse, errorResponse, args as a } from "../../utils/responses.js";
+import { createDispatcher, createModule } from "../../core/dispatcher.js";
+import { createLazyLoader } from "../../utils/lazy.js";
+import { requireEvolve } from "../../utils/guards.js";
+import { config } from "../../core/config.js";
+import { EvolveStore } from "./store.js";
+import { tournamentSelect, getElites, checkConvergence, buildMutationInstructions, } from "./algorithm.js";
+const dispatcher = createDispatcher();
+const getStore = createLazyLoader(() => new EvolveStore(config().stateDbPath));
+/** Build fitness history (best score per generation, sorted by generation). */
+function buildFitnessHistory(store, sessionId) {
+    const allVariants = store.getVariants(sessionId);
+    const fitnessByGen = new Map();
+    for (const v of allVariants) {
+        const current = fitnessByGen.get(v.generation) ?? 0;
+        if ((v.fitnessScore ?? 0) > current) {
+            fitnessByGen.set(v.generation, v.fitnessScore ?? 0);
+        }
+    }
+    return Array.from(fitnessByGen.entries())
+        .sort(([a], [b]) => a - b)
+        .map(([, f]) => f);
+}
+// ─── Tool Definitions ────────────────────────────────────
+export const tools = [
+    {
+        name: "evolve_start",
+        description: "Create an evolution session for prompt optimization. Returns instructions for Claude to generate and evaluate variant prompts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept_name: {
+                    type: "string",
+                    description: "What's being optimized (e.g., 'code-review-prompt')",
+                },
+                initial_prompt: {
+                    type: "string",
+                    description: "Starting prompt to evolve",
+                },
+                test_cases: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            input: { type: "string" },
+                            expected: { type: "string" },
+                        },
+                        required: ["input", "expected"],
+                    },
+                    description: "Fitness evaluation criteria",
+                },
+                population_size: {
+                    type: "number",
+                    description: "Variants per generation (default: 5)",
+                },
+                max_generations: {
+                    type: "number",
+                    description: "Maximum generations (default: 10)",
+                },
+                mutation_rate: {
+                    type: "number",
+                    description: "Mutation rate 0-1 (default: 0.7)",
+                },
+            },
+            required: ["concept_name", "initial_prompt", "test_cases"],
+        },
+    },
+    {
+        name: "evolve_submit",
+        description: "Submit evaluated variants and advance the evolution. Returns selection results and mutation instructions for the next generation, or convergence/completion status.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Evolution session ID",
+                },
+                variants: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            prompt: { type: "string" },
+                            fitness_score: {
+                                type: "number",
+                                description: "Fitness score 0.0-1.0",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "What worked/didn't",
+                            },
+                        },
+                        required: ["prompt", "fitness_score"],
+                    },
+                    description: "Evaluated variant prompts with fitness scores",
+                },
+            },
+            required: ["session_id", "variants"],
+        },
+    },
+    {
+        name: "evolve_status",
+        description: "Check evolution session progress and statistics.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Evolution session ID",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
+    {
+        name: "evolve_best",
+        description: "Get the winning variant from an evolution session. Returns the best prompt, its fitness score, and improvement over the initial prompt.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Evolution session ID",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
+];
+// ─── Handlers ────────────────────────────────────────────
+dispatcher
+    .register("evolve_start", requireEvolve(async (args) => {
+    const conceptName = a.string(args, "concept_name");
+    const initialPrompt = a.string(args, "initial_prompt");
+    const testCases = a.array(args, "test_cases");
+    const populationSize = a.number(args, "population_size", 5);
+    const maxGenerations = a.number(args, "max_generations", 10);
+    const mutationRate = a.number(args, "mutation_rate", 0.7);
+    if (!conceptName)
+        return errorResponse("concept_name is required");
+    if (!initialPrompt)
+        return errorResponse("initial_prompt is required");
+    if (!testCases.length)
+        return errorResponse("test_cases must contain at least one test case");
+    const store = getStore();
+    const session = store.createSession(conceptName, initialPrompt, testCases, {
+        populationSize,
+        maxGenerations,
+        mutationRate,
+    });
+    const instructions = [
+        `Generate ${populationSize} variant prompts for "${conceptName}".`,
+        `Start from this initial prompt: "${initialPrompt.slice(0, 200)}${initialPrompt.length > 200 ? "..." : ""}"`,
+        ``,
+        `Evaluate each variant against these test cases:`,
+        ...testCases.map((tc, i) => `  ${i + 1}. Input: "${tc.input}" → Expected: "${tc.expected}"`),
+        ``,
+        `For each variant, assign a fitness_score from 0.0 to 1.0 based on how well it meets the expected outputs.`,
+        `Then call evolve_submit with the session_id and scored variants.`,
+    ].join("\n");
+    return successResponse({
+        session_id: session.id,
+        generation: 0,
+        instructions,
+    });
+}))
+    .register("evolve_submit", requireEvolve(async (args) => {
+    const sessionId = a.string(args, "session_id");
+    if (!sessionId)
+        return errorResponse("session_id is required");
+    const variants = a.array(args, "variants");
+    if (!variants.length)
+        return errorResponse("variants must contain at least one variant");
+    const store = getStore();
+    const session = store.getSession(sessionId);
+    if (!session)
+        return errorResponse(`Session "${sessionId}" not found`);
+    if (session.status !== "active") {
+        return errorResponse(`Session is ${session.status}, not active`);
+    }
+    // Insert variants for current generation
+    const nextGen = session.currentGeneration + 1;
+    const inserted = store.insertVariants(sessionId, nextGen, variants.map((v) => ({
+        prompt: v.prompt,
+        fitnessScore: v.fitness_score,
+        notes: v.notes,
+    })));
+    // Find best variant across all generations
+    const bestVariant = store.getBestVariant(sessionId);
+    const bestFitness = bestVariant?.fitnessScore ?? 0;
+    // Build fitness history for convergence check
+    const fitnessHistory = buildFitnessHistory(store, sessionId);
+    // Check convergence and max generations
+    const converged = checkConvergence(fitnessHistory);
+    const maxReached = nextGen >= session.config.maxGenerations;
+    const status = converged ? "converged" : maxReached ? "completed" : "active";
+    // Update session
+    store.updateSession(sessionId, {
+        currentGeneration: nextGen,
+        status,
+        bestFitness,
+        bestVariantId: bestVariant?.id ?? null,
+    });
+    if (status !== "active") {
+        return successResponse({
+            generation: nextGen,
+            best_fitness: bestFitness,
+            status,
+            message: status === "converged"
+                ? `Evolution converged at generation ${nextGen}. Call evolve_best to get the winning prompt.`
+                : `Reached maximum generations (${session.config.maxGenerations}). Call evolve_best to get the winning prompt.`,
+        });
+    }
+    // Select parents for next generation
+    const genVariants = inserted;
+    const elites = getElites(genVariants, 2);
+    const parents = tournamentSelect(genVariants, session.config.populationSize);
+    // Deduplicate parents with elites
+    const parentSet = new Map();
+    for (const e of elites)
+        parentSet.set(e.id, e);
+    for (const p of parents)
+        parentSet.set(p.id, p);
+    const uniqueParents = Array.from(parentSet.values()).slice(0, session.config.populationSize);
+    const { parents: parentInfo, instructions } = buildMutationInstructions(uniqueParents, session.conceptName, session.config.populationSize);
+    return successResponse({
+        generation: nextGen,
+        best_fitness: bestFitness,
+        status: "active",
+        parents: parentInfo,
+        instructions,
+    });
+}))
+    .registerQuick("evolve_status", requireEvolve(async (args) => {
+    const sessionId = a.string(args, "session_id");
+    if (!sessionId)
+        return errorResponse("session_id is required");
+    const store = getStore();
+    const session = store.getSession(sessionId);
+    if (!session)
+        return errorResponse(`Session "${sessionId}" not found`);
+    const variantCount = store.getVariantCount(sessionId);
+    // Build fitness history for convergence window display
+    const fitnessHistory = buildFitnessHistory(store, sessionId);
+    const initialFitness = fitnessHistory[0] ?? 0;
+    const improvementPct = initialFitness > 0
+        ? ((session.bestFitness - initialFitness) / initialFitness) * 100
+        : 0;
+    return successResponse({
+        session_id: session.id,
+        concept_name: session.conceptName,
+        status: session.status,
+        current_generation: session.currentGeneration,
+        max_generations: session.config.maxGenerations,
+        best_fitness: session.bestFitness,
+        improvement_pct: Math.round(improvementPct * 10) / 10,
+        variants_evaluated: variantCount,
+        convergence_window: fitnessHistory.slice(-3),
+    });
+}))
+    .registerQuick("evolve_best", requireEvolve(async (args) => {
+    const sessionId = a.string(args, "session_id");
+    if (!sessionId)
+        return errorResponse("session_id is required");
+    const store = getStore();
+    const session = store.getSession(sessionId);
+    if (!session)
+        return errorResponse(`Session "${sessionId}" not found`);
+    const bestVariant = store.getBestVariant(sessionId);
+    if (!bestVariant) {
+        return errorResponse("No variants found. Submit variants first with evolve_submit.");
+    }
+    const variantCount = store.getVariantCount(sessionId);
+    // Calculate improvement over initial
+    const allVariants = store.getVariants(sessionId);
+    const gen1Variants = allVariants.filter((v) => v.generation === 1);
+    const initialBestFitness = gen1Variants.length > 0
+        ? Math.max(...gen1Variants.map((v) => v.fitnessScore ?? 0))
+        : 0;
+    const improvementPct = initialBestFitness > 0
+        ? ((bestVariant.fitnessScore - initialBestFitness) / initialBestFitness) * 100
+        : 0;
+    return successResponse({
+        prompt: bestVariant.prompt,
+        fitness_score: bestVariant.fitnessScore,
+        generation: bestVariant.generation,
+        improvement_pct: Math.round(improvementPct * 10) / 10,
+        initial_prompt: session.initialPrompt,
+        total_variants_evaluated: variantCount,
+    });
+}));
+export const evolveModule = createModule(tools, dispatcher);
+//# sourceMappingURL=index.js.map

package/dist/tools/evolve/index.js.map

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

package/dist/tools/evolve/store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Evolution Store
+ * SQLite-backed storage for evolution sessions and variants.
+ * Uses the existing state.db via shared stateDbPath config.
+ */
+import { BaseStore } from "../../core/store.js";
+import type { EvolutionSession, EvolutionVariant, EvolutionConfig, TestCase } from "./types.js";
+export declare class EvolveStore extends BaseStore {
+    constructor(dbPath: string);
+    private initTables;
+    createSession(conceptName: string, initialPrompt: string, testCases: TestCase[], config: EvolutionConfig): EvolutionSession;
+    getSession(id: string): EvolutionSession | null;
+    private static readonly sessionFields;
+    updateSession(id: string, updates: Partial<Pick<EvolutionSession, "currentGeneration" | "status" | "bestFitness" | "bestVariantId">>): void;
+    insertVariants(sessionId: string, generation: number, variants: Array<{
+        prompt: string;
+        fitnessScore: number;
+        notes?: string;
+        parentId?: string;
+    }>): EvolutionVariant[];
+    getVariants(sessionId: string, generation?: number): EvolutionVariant[];
+    getBestVariant(sessionId: string): EvolutionVariant | null;
+    getVariantCount(sessionId: string): number;
+    private rowToSession;
+    private rowToVariant;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/tools/evolve/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/tools/evolve/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AAEnE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAEf,QAAQ,EACT,MAAM,YAAY,CAAC;AA2BpB,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,MAAM,EAAE,MAAM;IAK1B,OAAO,CAAC,UAAU;IAoClB,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,eAAe,GACtB,gBAAgB;IA0BnB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAQ/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAKnC;IAEF,aAAa,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC,CAAC,GACzG,IAAI;IAMP,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3F,gBAAgB,EAAE;IA6BrB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAavE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAQ1D,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAU1C,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,YAAY;CAYrB"}