@cdot65/prisma-airs-cli 1.0.0

package/dist/memory/diff.js

@@ -0,0 +1,24 @@
+export function computeIterationDiff(from, to) {
+    const fromExSet = new Set(from.topic.examples);
+    const toExSet = new Set(to.topic.examples);
+    const examplesAdded = to.topic.examples.filter((e) => !fromExSet.has(e));
+    const examplesRemoved = from.topic.examples.filter((e) => !toExSet.has(e));
+    return {
+        fromIteration: from.iteration,
+        toIteration: to.iteration,
+        descriptionChanged: from.topic.description !== to.topic.description,
+        examplesChanged: examplesAdded.length > 0 || examplesRemoved.length > 0,
+        examplesAdded,
+        examplesRemoved,
+        descriptionBefore: from.topic.description,
+        descriptionAfter: to.topic.description,
+        metricDelta: {
+            coverage: to.metrics.coverage - from.metrics.coverage,
+            tpr: to.metrics.truePositiveRate - from.metrics.truePositiveRate,
+            tnr: to.metrics.trueNegativeRate - from.metrics.trueNegativeRate,
+            accuracy: to.metrics.accuracy - from.metrics.accuracy,
+            f1: to.metrics.f1Score - from.metrics.f1Score,
+        },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/memory/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/memory/diff.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAAC,IAAqB,EAAE,EAAmB;IAC7E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3E,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,SAAS;QAC7B,WAAW,EAAE,EAAE,CAAC,SAAS;QACzB,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,EAAE,CAAC,KAAK,CAAC,WAAW;QACnE,eAAe,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QACvE,aAAa;QACb,eAAe;QACf,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;QACzC,gBAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW;QACtC,WAAW,EAAE;YACX,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;YACrD,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAChE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAChE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;YACrD,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO;SAC9C;KACF,CAAC;AACJ,CAAC"}

package/dist/memory/extractor.d.ts

@@ -0,0 +1,15 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { RunState } from '../core/types.js';
+import { type MemoryStore } from './store.js';
+import type { Learning } from './types.js';
+export declare class LearningExtractor {
+    private model;
+    private store;
+    constructor(model: BaseChatModel, store: MemoryStore);
+    extractAndSave(runState: RunState): Promise<{
+        learnings: Learning[];
+    }>;
+    private mergeLearnings;
+    private formatIterationHistory;
+}
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/memory/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,YAAY,CAAC;AAExD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;gBADL,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,WAAW;IAGtB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IAoF5E,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,sBAAsB;CAwC/B"}

package/dist/memory/extractor.js

@@ -0,0 +1,133 @@
+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 existing 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(`Example count: ${iter.topic.examples.length}`);
+            lines.push(`Examples: ${iter.topic.examples.length > 0 ? iter.topic.examples.map((e) => `"${e}"`).join(', ') : 'None (description-only)'}`);
+            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) {
+                    const prevCount = runState.iterations[i - 1].topic.examples.length;
+                    const currCount = iter.topic.examples.length;
+                    changes.push(`example count: ${prevCount} → ${currCount}`);
+                    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,22 @@
+import type { MemoryStore } from './store.js';
+/**
+ * Builds a budget-aware memory section for LLM prompt injection.
+ * Retrieves relevant learnings from the store, sorts by corroboration count,
+ * and formats them within a character budget (verbose -> compact -> omit).
+ */
+export declare class MemoryInjector {
+    private store;
+    private maxChars;
+    /**
+     * @param store - Memory store for retrieving learnings.
+     * @param maxChars - Character budget for the memory section. Default 3000.
+     */
+    constructor(store: MemoryStore, maxChars?: number);
+    /**
+     * Build a formatted memory section string for prompt injection.
+     * @param topicDescription - Topic to find relevant learnings for.
+     * @returns Formatted learnings string, or empty string if none found.
+     */
+    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;;;;GAIG;AACH,qBAAa,cAAc;IAMvB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IANlB;;;OAGG;gBAEO,KAAK,EAAE,WAAW,EAClB,QAAQ,GAAE,MAAa;IAGjC;;;;OAIG;IACG,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA6EpE"}

package/dist/memory/injector.js

@@ -0,0 +1,90 @@
+/**
+ * Builds a budget-aware memory section for LLM prompt injection.
+ * Retrieves relevant learnings from the store, sorts by corroboration count,
+ * and formats them within a character budget (verbose -> compact -> omit).
+ */
+export class MemoryInjector {
+    store;
+    maxChars;
+    /**
+     * @param store - Memory store for retrieving learnings.
+     * @param maxChars - Character budget for the memory section. Default 3000.
+     */
+    constructor(store, maxChars = 3000) {
+        this.store = store;
+        this.maxChars = maxChars;
+    }
+    /**
+     * Build a formatted memory section string for prompt injection.
+     * @param topicDescription - Topic to find relevant learnings for.
+     * @returns Formatted learnings string, or empty string if none found.
+     */
+    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":"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"}

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,8BAqCjC,CAAC"}

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

@@ -0,0 +1,40 @@
+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", "example-count", "zero-examples", "description-weight"
+
+2. **Anti-patterns**: Strategies that consistently degraded performance (e.g., "Adding coded language patterns broadens AIRS matching unpredictably")
+
+Pay special attention to the RELATIONSHIP BETWEEN EXAMPLE COUNT AND EFFICACY:
+- Track whether reducing examples improved or degraded metrics
+- Note when fewer examples (2) outperformed configurations with more examples (3-5)
+- Identify if specific example counts (2, 3, 4, 5) correlate with better coverage for this topic type
+- Tag learnings about example count with "example-count" and the relevant count (e.g., "few-examples", "many-examples")
+
+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;;;;;;;;;;;;;;;;;;yGAkBqG;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,28 @@
+import type { TopicMemory } from './types.js';
+/**
+ * Normalize a topic description into a stable category key.
+ * Removes stop words, lowercases, deduplicates, and sorts alphabetically.
+ * @param description - Free-text topic description.
+ * @returns Hyphen-joined keyword string used as the memory file name.
+ */
+export declare function normalizeCategory(description: string): string;
+/**
+ * File-based persistence for cross-run learnings.
+ * Stores one JSON file per category at `{dir}/{category}.json`.
+ * Supports keyword-overlap-based retrieval for cross-topic transfer.
+ */
+export declare class MemoryStore {
+    private dir;
+    constructor(dir: string);
+    private filePath;
+    /** Persist a topic memory to disk, creating the directory if needed. */
+    save(memory: TopicMemory): Promise<void>;
+    /** Load a topic memory by category, or null if not found. */
+    load(category: string): Promise<TopicMemory | null>;
+    /** Find all topic memories with >= 50% keyword overlap to the given description. */
+    findRelevant(topicDescription: string): Promise<TopicMemory[]>;
+    /** List all stored category names. */
+    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;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAE/B,OAAO,CAAC,QAAQ;IAIhB,wEAAwE;IAClE,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,6DAA6D;IACvD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASzD,oFAAoF;IAC9E,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAepE,sCAAsC;IAChC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASzC,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/memory/store.js

@@ -0,0 +1,103 @@
+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',
+]);
+/**
+ * Normalize a topic description into a stable category key.
+ * Removes stop words, lowercases, deduplicates, and sorts alphabetically.
+ * @param description - Free-text topic description.
+ * @returns Hyphen-joined keyword string used as the memory file name.
+ */
+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.length > 0 ? unique.join('-') : 'uncategorized';
+}
+/**
+ * File-based persistence for cross-run learnings.
+ * Stores one JSON file per category at `{dir}/{category}.json`.
+ * Supports keyword-overlap-based retrieval for cross-topic transfer.
+ */
+export class MemoryStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    filePath(category) {
+        return join(this.dir, `${category}.json`);
+    }
+    /** Persist a topic memory to disk, creating the directory if needed. */
+    async save(memory) {
+        await mkdir(this.dir, { recursive: true });
+        await writeFile(this.filePath(memory.category), JSON.stringify(memory, null, 2), 'utf-8');
+    }
+    /** Load a topic memory by category, or null if not found. */
+    async load(category) {
+        try {
+            const data = await readFile(this.filePath(category), 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Find all topic memories with >= 50% keyword overlap to the given description. */
+    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;
+    }
+    /** List all stored category names. */
+    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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"}