@cdot65/daystrom 1.0.3

package/dist/memory/extractor.js

@@ -0,0 +1,129 @@
+import { nanoid } from 'nanoid';
+import { computeIterationDiff } from './diff.js';
+import { extractLearningsPrompt } from './prompts/extract-learnings.js';
+import { LearningExtractionOutputSchema } from './schemas.js';
+import { normalizeCategory } from './store.js';
+export class LearningExtractor {
+    model;
+    store;
+    constructor(model, store) {
+        this.model = model;
+        this.store = store;
+    }
+    async extractAndSave(runState) {
+        if (runState.iterations.length < 1) {
+            return { learnings: [] };
+        }
+        const structured = this.model.withStructuredOutput(LearningExtractionOutputSchema);
+        const chain = extractLearningsPrompt.pipe(structured);
+        const iterationHistory = this.formatIterationHistory(runState);
+        const raw = (await chain.invoke({
+            topicDescription: runState.userInput.topicDescription,
+            intent: runState.userInput.intent,
+            totalIterations: runState.iterations.length,
+            bestIteration: runState.bestIteration,
+            bestCoverage: `${(runState.bestCoverage * 100).toFixed(1)}%`,
+            iterationHistory,
+        }));
+        const category = normalizeCategory(runState.userInput.topicDescription);
+        const bestIter = runState.iterations[runState.bestIteration - 1] ??
+            runState.iterations[runState.iterations.length - 1];
+        // Build learnings with metadata
+        const newLearnings = raw.learnings.map((l) => ({
+            id: nanoid(),
+            runId: runState.id,
+            extractedAt: new Date().toISOString(),
+            topicCategory: category,
+            topicDescription: runState.userInput.topicDescription,
+            insight: l.insight,
+            strategy: l.strategy,
+            outcome: l.outcome,
+            changeType: l.changeType,
+            metrics: {
+                coverage: bestIter.metrics.coverage,
+                tpr: bestIter.metrics.truePositiveRate,
+                tnr: bestIter.metrics.trueNegativeRate,
+                accuracy: bestIter.metrics.accuracy,
+                f1: bestIter.metrics.f1Score,
+            },
+            corroborations: 0,
+            tags: l.tags,
+        }));
+        // Merge into existing memory
+        const existing = (await this.store.load(category)) ?? {
+            category,
+            updatedAt: '',
+            learnings: [],
+            bestKnown: null,
+            antiPatterns: [],
+        };
+        const mergedLearnings = this.mergeLearnings(existing.learnings, newLearnings);
+        // Update bestKnown only if new run is better
+        let { bestKnown } = existing;
+        if (!bestKnown || runState.bestCoverage > bestKnown.metrics.coverage) {
+            bestKnown = {
+                runId: runState.id,
+                iteration: bestIter.iteration,
+                topic: bestIter.topic,
+                metrics: bestIter.metrics,
+            };
+        }
+        // Merge anti-patterns (deduplicate)
+        const antiPatternSet = new Set([...existing.antiPatterns, ...raw.antiPatterns]);
+        const memory = {
+            category,
+            updatedAt: new Date().toISOString(),
+            learnings: mergedLearnings,
+            bestKnown,
+            antiPatterns: [...antiPatternSet],
+        };
+        await this.store.save(memory);
+        return { learnings: newLearnings };
+    }
+    mergeLearnings(existing, incoming) {
+        const merged = [...existing];
+        for (const newL of incoming) {
+            const match = merged.findIndex((e) => e.insight === newL.insight);
+            if (match >= 0) {
+                // Corroborate: increment count, keep the better metrics
+                merged[match] = {
+                    ...merged[match],
+                    corroborations: merged[match].corroborations + 1,
+                    extractedAt: newL.extractedAt,
+                };
+            }
+            else {
+                merged.push(newL);
+            }
+        }
+        return merged;
+    }
+    formatIterationHistory(runState) {
+        const lines = [];
+        for (let i = 0; i < runState.iterations.length; i++) {
+            const iter = runState.iterations[i];
+            lines.push(`--- Iteration ${iter.iteration} ---`);
+            lines.push(`Description: "${iter.topic.description}"`);
+            lines.push(`Examples: ${iter.topic.examples.map((e) => `"${e}"`).join(', ')}`);
+            lines.push(`Coverage: ${(iter.metrics.coverage * 100).toFixed(1)}% | TPR: ${(iter.metrics.truePositiveRate * 100).toFixed(1)}% | TNR: ${(iter.metrics.trueNegativeRate * 100).toFixed(1)}%`);
+            lines.push(`Analysis: ${iter.analysis.summary}`);
+            if (i > 0) {
+                const diff = computeIterationDiff(runState.iterations[i - 1], iter);
+                const changes = [];
+                if (diff.descriptionChanged)
+                    changes.push('description changed');
+                if (diff.examplesChanged) {
+                    if (diff.examplesAdded.length)
+                        changes.push(`+examples: ${diff.examplesAdded.join(', ')}`);
+                    if (diff.examplesRemoved.length)
+                        changes.push(`-examples: ${diff.examplesRemoved.join(', ')}`);
+                }
+                lines.push(`Changes: ${changes.join('; ') || 'none'}`);
+                lines.push(`Coverage delta: ${diff.metricDelta.coverage >= 0 ? '+' : ''}${(diff.metricDelta.coverage * 100).toFixed(1)}%`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=extractor.js.map

package/dist/memory/extractor.js.map

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

package/dist/memory/injector.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryStore } from './store.js';
+export declare class MemoryInjector {
+    private store;
+    private maxChars;
+    constructor(store: MemoryStore, maxChars?: number);
+    buildMemorySection(topicDescription: string): Promise<string>;
+}
+//# sourceMappingURL=injector.d.ts.map

package/dist/memory/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../src/memory/injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,qBAAa,cAAc;IAEvB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;gBADR,KAAK,EAAE,WAAW,EAClB,QAAQ,GAAE,MAAa;IAG3B,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA6EpE"}

package/dist/memory/injector.js

@@ -0,0 +1,76 @@
+export class MemoryInjector {
+    store;
+    maxChars;
+    constructor(store, maxChars = 3000) {
+        this.store = store;
+        this.maxChars = maxChars;
+    }
+    async buildMemorySection(topicDescription) {
+        const memories = await this.store.findRelevant(topicDescription);
+        if (memories.length === 0)
+            return '';
+        const allLearnings = [];
+        const allAntiPatterns = [];
+        for (const mem of memories) {
+            allLearnings.push(...mem.learnings);
+            allAntiPatterns.push(...mem.antiPatterns);
+        }
+        if (allLearnings.length === 0 && allAntiPatterns.length === 0)
+            return '';
+        // Sort by corroborations descending
+        allLearnings.sort((a, b) => b.corroborations - a.corroborations);
+        const header = [
+            '\n## Learnings from Previous Runs',
+            'These are empirically validated observations from prior guardrail generation runs:',
+        ];
+        // Budget for content after header; each added line costs lineLen + 1 (newline separator)
+        let budget = this.maxChars - header.join('\n').length;
+        const lines = [...header];
+        let compactMode = false;
+        let omitted = 0;
+        for (const l of allLearnings) {
+            const tag = l.outcome === 'degraded' ? 'AVOID' : 'DO';
+            const seenCount = l.corroborations + 1;
+            if (!compactMode) {
+                const verbose = `- [${tag}] ${l.insight} (${l.changeType}, seen ${seenCount}x)`;
+                if (verbose.length + 1 <= budget) {
+                    lines.push(verbose);
+                    budget -= verbose.length + 1; // +1 for newline
+                    continue;
+                }
+                // Switch to compact mode
+                compactMode = true;
+            }
+            const compact = `- [${tag}] ${l.insight}`;
+            if (compact.length + 1 <= budget) {
+                lines.push(compact);
+                budget -= compact.length + 1;
+            }
+            else {
+                omitted++;
+            }
+        }
+        if (omitted > 0) {
+            const notice = `(+${omitted} more learnings omitted)`;
+            if (notice.length + 1 <= budget) {
+                lines.push(notice);
+                budget -= notice.length + 1;
+            }
+        }
+        const uniqueAntiPatterns = [...new Set(allAntiPatterns)];
+        if (uniqueAntiPatterns.length > 0) {
+            lines.push('');
+            lines.push('Known anti-patterns:');
+            budget -= 1 + 'Known anti-patterns:'.length + 1; // blank line + header
+            for (const ap of uniqueAntiPatterns) {
+                const line = `- ${ap}`;
+                if (line.length + 1 <= budget) {
+                    lines.push(line);
+                    budget -= line.length + 1;
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=injector.js.map

package/dist/memory/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../../src/memory/injector.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,KAAkB,EAClB,WAAmB,IAAI;QADvB,UAAK,GAAL,KAAK,CAAa;QAClB,aAAQ,GAAR,QAAQ,CAAe;IAC9B,CAAC;IAEJ,KAAK,CAAC,kBAAkB,CAAC,gBAAwB;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,YAAY,GAAe,EAAE,CAAC;QACpC,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;YACpC,eAAe,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzE,oCAAoC;QACpC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG;YACb,mCAAmC;YACnC,oFAAoF;SACrF,CAAC;QACF,yFAAyF;QACzF,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAEtD,MAAM,KAAK,GAAa,CAAC,GAAG,MAAM,CAAC,CAAC;QACpC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACtD,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC;YAEvC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,UAAU,UAAU,SAAS,IAAI,CAAC;gBAChF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;oBACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACpB,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iBAAiB;oBAC/C,SAAS;gBACX,CAAC;gBACD,yBAAyB;gBACzB,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,OAAO,0BAA0B,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnB,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzD,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,GAAG,sBAAsB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,sBAAsB;YAEvE,KAAK,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjB,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/memory/prompts/extract-learnings.d.ts

@@ -0,0 +1,3 @@
+import { ChatPromptTemplate } from '@langchain/core/prompts';
+export declare const extractLearningsPrompt: ChatPromptTemplate<any, any>;
+//# sourceMappingURL=extract-learnings.d.ts.map

package/dist/memory/prompts/extract-learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-learnings.d.ts","sourceRoot":"","sources":["../../../src/memory/prompts/extract-learnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,eAAO,MAAM,sBAAsB,8BA+BjC,CAAC"}

package/dist/memory/prompts/extract-learnings.js

@@ -0,0 +1,34 @@
+import { ChatPromptTemplate } from '@langchain/core/prompts';
+export const extractLearningsPrompt = ChatPromptTemplate.fromMessages([
+    [
+        'system',
+        `You are analyzing the results of a Prisma AIRS custom topic guardrail generation run to extract reusable learnings.
+
+Given the iteration history, identify:
+1. **Learnings**: What worked, what didn't, and why. Each learning should have:
+   - insight: A concise observation (e.g., "Short direct descriptions outperform nuanced ones on AIRS")
+   - strategy: What was actually done (e.g., "Used a short description without exclusion clauses")
+   - outcome: "improved", "degraded", or "neutral"
+   - changeType: "description-only", "examples-only", "both", or "initial"
+   - tags: keywords like "brevity", "coded-language", "fp-reduction", "fn-reduction", "exclusion-clauses"
+
+2. **Anti-patterns**: Strategies that consistently degraded performance (e.g., "Adding coded language patterns broadens AIRS matching unpredictably")
+
+Focus on actionable, generalizable insights. Avoid restating metrics — explain the *why* behind changes.`,
+    ],
+    [
+        'human',
+        `Analyze this guardrail generation run:
+
+Topic Description: {topicDescription}
+Intent: {intent}
+Total Iterations: {totalIterations}
+Best Iteration: {bestIteration} (coverage: {bestCoverage})
+
+Iteration History:
+{iterationHistory}
+
+Extract structured learnings from this run.`,
+    ],
+]);
+//# sourceMappingURL=extract-learnings.js.map

package/dist/memory/prompts/extract-learnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-learnings.js","sourceRoot":"","sources":["../../../src/memory/prompts/extract-learnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,YAAY,CAAC;IACpE;QACE,QAAQ;QACR;;;;;;;;;;;;yGAYqG;KACtG;IACD;QACE,OAAO;QACP;;;;;;;;;;4CAUwC;KACzC;CACF,CAAC,CAAC"}

package/dist/memory/schemas.d.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export declare const ExtractedLearningSchema: z.ZodObject<{
+    insight: z.ZodString;
+    strategy: z.ZodString;
+    outcome: z.ZodEnum<["improved", "degraded", "neutral"]>;
+    changeType: z.ZodEnum<["description-only", "examples-only", "both", "initial"]>;
+    tags: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    insight: string;
+    strategy: string;
+    outcome: "improved" | "degraded" | "neutral";
+    changeType: "description-only" | "examples-only" | "both" | "initial";
+    tags: string[];
+}, {
+    insight: string;
+    strategy: string;
+    outcome: "improved" | "degraded" | "neutral";
+    changeType: "description-only" | "examples-only" | "both" | "initial";
+    tags: string[];
+}>;
+export declare const LearningExtractionOutputSchema: z.ZodObject<{
+    learnings: z.ZodArray<z.ZodObject<{
+        insight: z.ZodString;
+        strategy: z.ZodString;
+        outcome: z.ZodEnum<["improved", "degraded", "neutral"]>;
+        changeType: z.ZodEnum<["description-only", "examples-only", "both", "initial"]>;
+        tags: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        insight: string;
+        strategy: string;
+        outcome: "improved" | "degraded" | "neutral";
+        changeType: "description-only" | "examples-only" | "both" | "initial";
+        tags: string[];
+    }, {
+        insight: string;
+        strategy: string;
+        outcome: "improved" | "degraded" | "neutral";
+        changeType: "description-only" | "examples-only" | "both" | "initial";
+        tags: string[];
+    }>, "many">;
+    antiPatterns: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    learnings: {
+        insight: string;
+        strategy: string;
+        outcome: "improved" | "degraded" | "neutral";
+        changeType: "description-only" | "examples-only" | "both" | "initial";
+        tags: string[];
+    }[];
+    antiPatterns: string[];
+}, {
+    learnings: {
+        insight: string;
+        strategy: string;
+        outcome: "improved" | "degraded" | "neutral";
+        changeType: "description-only" | "examples-only" | "both" | "initial";
+        tags: string[];
+    }[];
+    antiPatterns: string[];
+}>;
+export type ExtractedLearning = z.infer<typeof ExtractedLearningSchema>;
+export type LearningExtractionOutput = z.infer<typeof LearningExtractionOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/memory/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/memory/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAMlC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/memory/schemas.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const ExtractedLearningSchema = z.object({
+    insight: z.string().min(1),
+    strategy: z.string().min(1),
+    outcome: z.enum(['improved', 'degraded', 'neutral']),
+    changeType: z.enum(['description-only', 'examples-only', 'both', 'initial']),
+    tags: z.array(z.string()),
+});
+export const LearningExtractionOutputSchema = z.object({
+    learnings: z.array(ExtractedLearningSchema),
+    antiPatterns: z.array(z.string()),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/memory/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/memory/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAC"}

package/dist/memory/store.d.ts

@@ -0,0 +1,13 @@
+import type { TopicMemory } from './types.js';
+export declare function normalizeCategory(description: string): string;
+export declare class MemoryStore {
+    private dir;
+    constructor(dir: string);
+    private filePath;
+    save(memory: TopicMemory): Promise<void>;
+    load(category: string): Promise<TopicMemory | null>;
+    findRelevant(topicDescription: string): Promise<TopicMemory[]>;
+    listCategories(): Promise<string[]>;
+    private categoriesOverlap;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB9C,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAE/B,OAAO,CAAC,QAAQ;IAIV,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASnD,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAe9D,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASzC,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/memory/store.js

@@ -0,0 +1,88 @@
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const STOP_WORDS = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'of',
+    'about',
+    'for',
+    'in',
+    'on',
+    'to',
+    'with',
+    'that',
+    'this',
+    'is',
+    'are',
+    'was',
+    'were',
+]);
+export function normalizeCategory(description) {
+    const words = description
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .split(/\s+/)
+        .filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+    const unique = [...new Set(words)].sort();
+    return unique.join('-');
+}
+export class MemoryStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    filePath(category) {
+        return join(this.dir, `${category}.json`);
+    }
+    async save(memory) {
+        await mkdir(this.dir, { recursive: true });
+        await writeFile(this.filePath(memory.category), JSON.stringify(memory, null, 2), 'utf-8');
+    }
+    async load(category) {
+        try {
+            const data = await readFile(this.filePath(category), 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async findRelevant(topicDescription) {
+        const targetCategory = normalizeCategory(topicDescription);
+        const categories = await this.listCategories();
+        const results = [];
+        for (const cat of categories) {
+            if (this.categoriesOverlap(targetCategory, cat)) {
+                const memory = await this.load(cat);
+                if (memory)
+                    results.push(memory);
+            }
+        }
+        return results;
+    }
+    async listCategories() {
+        try {
+            const files = await readdir(this.dir);
+            return files.filter((f) => f.endsWith('.json')).map((f) => f.replace(/\.json$/, ''));
+        }
+        catch {
+            return [];
+        }
+    }
+    categoriesOverlap(a, b) {
+        const wordsA = new Set(a.split('-'));
+        const wordsB = new Set(b.split('-'));
+        let overlap = 0;
+        for (const w of wordsA) {
+            if (wordsB.has(w))
+                overlap++;
+        }
+        // Require at least 50% keyword overlap relative to smaller set
+        const minSize = Math.min(wordsA.size, wordsB.size);
+        return minSize > 0 && overlap / minSize >= 0.5;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Memory system types — cross-run learning persistence that lets
+ * future runs benefit from past refinement insights.
+ */
+import type { CustomTopic, EfficacyMetrics } from '../core/types.js';
+export interface IterationDiff {
+    fromIteration: number;
+    toIteration: number;
+    descriptionChanged: boolean;
+    examplesChanged: boolean;
+    examplesAdded: string[];
+    examplesRemoved: string[];
+    descriptionBefore: string;
+    descriptionAfter: string;
+    metricDelta: {
+        coverage: number;
+        tpr: number;
+        tnr: number;
+        accuracy: number;
+        f1: number;
+    };
+}
+export interface Learning {
+    id: string;
+    runId: string;
+    extractedAt: string;
+    topicCategory: string;
+    topicDescription: string;
+    insight: string;
+    strategy: string;
+    outcome: 'improved' | 'degraded' | 'neutral';
+    changeType: 'description-only' | 'examples-only' | 'both' | 'initial';
+    metrics: {
+        coverage: number;
+        tpr: number;
+        tnr: number;
+        accuracy: number;
+        f1: number;
+    };
+    corroborations: number;
+    tags: string[];
+}
+export interface TopicMemory {
+    category: string;
+    updatedAt: string;
+    learnings: Learning[];
+    bestKnown: {
+        runId: string;
+        iteration: number;
+        topic: CustomTopic;
+        metrics: EfficacyMetrics;
+    } | null;
+    antiPatterns: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKrE,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAKD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,UAAU,EAAE,kBAAkB,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;IACtE,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAKD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,WAAW,CAAC;QACnB,OAAO,EAAE,eAAe,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/memory/types.js

@@ -0,0 +1,6 @@
+/**
+ * Memory system types — cross-run learning persistence that lets
+ * future runs benefit from past refinement insights.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/persistence/store.d.ts

@@ -0,0 +1,12 @@
+import type { RunState } from '../core/types.js';
+import type { RunStateSummary, RunStore } from './types.js';
+export declare class JsonFileStore implements RunStore {
+    private readonly dir;
+    constructor(dir: string);
+    save(run: RunState): Promise<void>;
+    load(id: string): Promise<RunState | null>;
+    list(): Promise<RunStateSummary[]>;
+    delete(id: string): Promise<void>;
+    private filePath;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/persistence/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/persistence/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,aAAc,YAAW,QAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAElC,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IASlC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAS1C,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA8BlC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/persistence/store.js

@@ -0,0 +1,68 @@
+import { mkdir, readdir, readFile, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export class JsonFileStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async save(run) {
+        await mkdir(this.dir, { recursive: true });
+        const filePath = this.filePath(run.id);
+        const tmp = `${filePath}.tmp`;
+        await writeFile(tmp, JSON.stringify(run, null, 2), 'utf-8');
+        await writeFile(filePath, JSON.stringify(run, null, 2), 'utf-8');
+        await unlink(tmp).catch(() => { });
+    }
+    async load(id) {
+        try {
+            const data = await readFile(this.filePath(id), 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async list() {
+        let files;
+        try {
+            files = await readdir(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const summaries = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const data = await readFile(join(this.dir, file), 'utf-8');
+                const run = JSON.parse(data);
+                summaries.push({
+                    id: run.id,
+                    createdAt: run.createdAt,
+                    updatedAt: run.updatedAt,
+                    status: run.status,
+                    currentIteration: run.currentIteration,
+                    bestCoverage: run.bestCoverage,
+                    topicDescription: run.userInput.topicDescription,
+                });
+            }
+            catch {
+                // skip corrupted files
+            }
+        }
+        return summaries;
+    }
+    async delete(id) {
+        try {
+            await unlink(this.filePath(id));
+        }
+        catch {
+            // ignore if doesn't exist
+        }
+    }
+    filePath(id) {
+        return join(this.dir, `${id}.json`);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/persistence/store.js.map

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