pi-recollect 0.1.1 → 0.3.0

package/README.md

@@ -0,0 +1,73 @@
+# pi-recollect
+
+Memory and context management extension for coding agents.
+
+## Features
+
+- **Graph Memory** - Hash-based ID memory with dependencies
+- **Context Compaction** - Session compaction for long conversations
+- **Memory Decay** - Semantic summarization of old content
+- **Progressive Disclosure** - Layered context presentation
+- **Session Continuity** - Seamless session recovery
+
+## Installation
+
+```bash
+npm install pi-recollect
+```
+
+## Usage
+
+### Commands
+
+- `/remember [insight]` - Store insight in graph memory
+- `/recall [topic]` - Recall related memories
+- `/compact` - Compact session context
+- `/forget [id]` - Remove from memory
+
+### Graph Store
+
+```typescript
+import { createGraphStore, generateHashId } from 'pi-recollect';
+
+const store = createGraphStore();
+
+// Add memory node
+const node = store.addNode({
+  type: 'insight',
+  title: 'Important finding',
+  content: '...',
+  relations: [{ type: 'relates_to', targetId: otherNode.id }],
+});
+
+// Query memories
+const insights = store.query({ type: 'insight', closed: false });
+```
+
+## Architecture
+
+```
+src/
+├── graph/
+│   ├── graph-store.ts     # Graph memory
+│   ├── hash-id.ts         # Hash-based IDs
+│   ├── memory-store.ts    # Memory persistence
+│   └── decay.ts           # Memory decay
+├── context/
+│   └── context-saver.ts   # Context management
+├── session/
+│   └── session-continuity.ts
+└── index.ts
+```
+
+## Patterns Applied
+
+- Hash-based IDs from beads
+- Graph memory from beads
+- Memory categories from pi-hermes-memory
+- Context compaction from oh-my-pi
+- Memory decay from beads
+
+## License
+
+MIT

package/dist/categories/memory-categories.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Memory Categories - Pattern from pi-hermes-memory
+ *
+ * Standardized memory types for organizing persistent knowledge.
+ */
+export type MemoryCategory = 'observation' | 'summary' | 'decision' | 'pattern' | 'task' | 'failure' | 'correction' | 'insight' | 'preference' | 'convention' | 'tool-quirk';
+export interface CategorizedMemory {
+    category: MemoryCategory;
+    content: string;
+    failureReason?: string;
+    toolState?: string;
+    correctedTo?: string;
+    created: string;
+    lastReferenced: string;
+}
+export declare const MEMORY_CATEGORY_DESCRIPTIONS: Record<MemoryCategory, string>;
+export declare const CATEGORY_COLORS: Record<MemoryCategory, string>;
+/**
+ * Format memory content with category tag
+ */
+export declare function formatMemoryContent(content: string, category: MemoryCategory, options?: {
+    failureReason?: string;
+    toolState?: string;
+    correctedTo?: string;
+}): string;
+/**
+ * Parse category from memory text
+ */
+export declare function parseCategory(text: string): {
+    category: MemoryCategory | null;
+    content: string;
+};
+//# sourceMappingURL=memory-categories.d.ts.map

package/dist/categories/memory-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-categories.d.ts","sourceRoot":"","sources":["../../src/categories/memory-categories.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,SAAS,GACT,UAAU,GACV,SAAS,GACT,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAYvE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAY1D,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAShG"}

package/dist/categories/memory-categories.js

@@ -0,0 +1,61 @@
+/**
+ * Memory Categories - Pattern from pi-hermes-memory
+ *
+ * Standardized memory types for organizing persistent knowledge.
+ */
+export const MEMORY_CATEGORY_DESCRIPTIONS = {
+    observation: 'General observations and facts',
+    summary: 'Summarized information',
+    decision: 'Decisions made during work',
+    pattern: 'Recurring patterns identified',
+    task: 'Task-related memories',
+    failure: 'What was tried but did not work',
+    correction: 'User corrections to agent behavior',
+    insight: 'Learning from experience',
+    preference: 'User preferences and style',
+    convention: 'Project conventions and standards',
+    'tool-quirk': 'Tool-specific behavior and quirks',
+};
+export const CATEGORY_COLORS = {
+    observation: '🔵',
+    summary: '📝',
+    decision: '✅',
+    pattern: '🔄',
+    task: '📋',
+    failure: '❌',
+    correction: '🔧',
+    insight: '💡',
+    preference: '❤️',
+    convention: '📐',
+    'tool-quirk': '🔧',
+};
+/**
+ * Format memory content with category tag
+ */
+export function formatMemoryContent(content, category, options) {
+    const parts = [`[${category}] ${content.trim()}`];
+    if (options?.failureReason) {
+        parts.push(`Failed: ${options.failureReason}`);
+    }
+    if (options?.toolState) {
+        parts.push(`Tool state: ${options.toolState}`);
+    }
+    if (options?.correctedTo) {
+        parts.push(`Corrected to: ${options.correctedTo}`);
+    }
+    return parts.join(' — ');
+}
+/**
+ * Parse category from memory text
+ */
+export function parseCategory(text) {
+    const match = text.match(/^\[([^\]]+)\]\s+(.*)$/);
+    if (match) {
+        const category = match[1];
+        if (MEMORY_CATEGORY_DESCRIPTIONS[category]) {
+            return { category, content: match[2] };
+        }
+    }
+    return { category: null, content: text };
+}
+//# sourceMappingURL=memory-categories.js.map

package/dist/categories/memory-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-categories.js","sourceRoot":"","sources":["../../src/categories/memory-categories.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,MAAM,CAAC,MAAM,4BAA4B,GAAmC;IAC1E,WAAW,EAAE,gCAAgC;IAC7C,OAAO,EAAE,wBAAwB;IACjC,QAAQ,EAAE,4BAA4B;IACtC,OAAO,EAAE,+BAA+B;IACxC,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,iCAAiC;IAC1C,UAAU,EAAE,oCAAoC;IAChD,OAAO,EAAE,0BAA0B;IACnC,UAAU,EAAE,4BAA4B;IACxC,UAAU,EAAE,mCAAmC;IAC/C,YAAY,EAAE,mCAAmC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,GAAG;IACZ,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,QAAwB,EACxB,OAIC;IAED,MAAM,KAAK,GAAa,CAAC,IAAI,QAAQ,KAAK,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE5D,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAClD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAmB,CAAC;QAC5C,IAAI,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/compound/analyzer.d.ts

@@ -0,0 +1,15 @@
+import type Database from "better-sqlite3";
+export interface AnalysisResult {
+    solutionsFound: number;
+    solutionsWritten: number;
+    duplicatesMerged: number;
+}
+/**
+ * Analyze a session at shutdown time:
+ * 1. Extract findings from session events
+ * 2. Route findings to bug/knowledge/decision types
+ * 3. Dedup against existing solutions
+ * 4. Write new solutions
+ */
+export declare function analyzeSession(db: Database.Database, cwd: string, sessionId: string, dedupThreshold?: number): AnalysisResult;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/compound/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/compound/analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAQ3C,MAAM,WAAW,cAAc;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAY,GAC1B,cAAc,CAoDhB"}

package/dist/compound/analyzer.js

@@ -0,0 +1,145 @@
+import * as crypto from "node:crypto";
+import { getSessionEvents } from "../store/events.ts";
+import { routeSessionFindings } from "./router.ts";
+import { extractBugSolution, extractDecision, extractKnowledge } from "./extractor.ts";
+import { findPotentialDuplicates, assessOverlap, shouldDedup } from "./dedup.ts";
+import { writeSolution } from "./writer.ts";
+import { indexContent } from "../store/fts5-index.ts";
+/**
+ * Analyze a session at shutdown time:
+ * 1. Extract findings from session events
+ * 2. Route findings to bug/knowledge/decision types
+ * 3. Dedup against existing solutions
+ * 4. Write new solutions
+ */
+export function analyzeSession(db, cwd, sessionId, dedupThreshold = 0.7) {
+    const events = getSessionEvents(db, sessionId);
+    if (events.length === 0)
+        return { solutionsFound: 0, solutionsWritten: 0, duplicatesMerged: 0 };
+    const findings = routeSessionFindings(events);
+    let solutionsFound = 0;
+    let solutionsWritten = 0;
+    let duplicatesMerged = 0;
+    for (const finding of findings) {
+        const solution = extractSolution(finding);
+        if (!solution)
+            continue;
+        solutionsFound++;
+        const title = buildTitle(finding, finding.events);
+        const solForDedup = {
+            title,
+            content: solutionContent(solution),
+            files: solution.files,
+            tags: solution.tags,
+        };
+        // Check for duplicates
+        const dupes = findPotentialDuplicates(db, title);
+        let isDuplicate = false;
+        for (const dupe of dupes) {
+            const dupeForCompare = {
+                title: dupe.title,
+                content: dupe.content,
+                files: dupe.files ? JSON.parse(dupe.files) : [],
+                tags: dupe.tags ? JSON.parse(dupe.tags) : [],
+            };
+            const overlap = assessOverlap(solForDedup, dupeForCompare);
+            if (shouldDedup(overlap, dedupThreshold)) {
+                isDuplicate = true;
+                duplicatesMerged++;
+                // Increment access count on the existing solution
+                db.prepare(`UPDATE solutions SET access_count = access_count + 1, last_accessed_at = ? WHERE title = ?`).run(new Date().toISOString(), dupe.title);
+                break;
+            }
+        }
+        if (!isDuplicate) {
+            writeSolutionToDb(db, title, solution);
+            writeSolution(cwd, solution, title);
+            solutionsWritten++;
+        }
+    }
+    return { solutionsFound, solutionsWritten, duplicatesMerged };
+}
+function extractSolution(finding) {
+    const events = finding.events;
+    switch (finding.type) {
+        case "bug": {
+            const error = events.find((e) => e.type === "error");
+            const fix = events.find((e) => e.type === "command_success") ?? null;
+            if (!error)
+                return null;
+            return extractBugSolution(error, fix);
+        }
+        case "decision": {
+            const decision = events.find((e) => e.type === "user_decision");
+            if (!decision)
+                return null;
+            return extractDecision(decision);
+        }
+        case "knowledge":
+            return extractKnowledge(events);
+        default:
+            return null;
+    }
+}
+function buildTitle(finding, events) {
+    switch (finding.type) {
+        case "bug": {
+            const error = events.find((e) => e.type === "error");
+            if (!error)
+                return "Unknown bug";
+            try {
+                const data = JSON.parse(error.data);
+                const msg = typeof data.errorMessage === "string" ? data.errorMessage : "error";
+                return msg.slice(0, 80);
+            }
+            catch {
+                return "Unknown bug";
+            }
+        }
+        case "decision": {
+            const d = events.find((e) => e.type === "user_decision");
+            if (!d)
+                return "Decision";
+            try {
+                const data = JSON.parse(d.data);
+                return typeof data.message_summary === "string" ? data.message_summary.slice(0, 80) : "Decision";
+            }
+            catch {
+                return "Decision";
+            }
+        }
+        case "knowledge": {
+            const files = events
+                .map((e) => { try {
+                return JSON.parse(e.data).file;
+            }
+            catch {
+                return "";
+            } })
+                .filter((f) => f.length > 0);
+            return files.length > 0 ? `Pattern: ${files.join(", ")}` : "Knowledge pattern";
+        }
+        default:
+            return "Unknown finding";
+    }
+}
+function solutionContent(solution) {
+    switch (solution.type) {
+        case "bug": return `${solution.problem}\n${solution.rootCause}\n${solution.fix}`;
+        case "knowledge": return `${solution.whenToUse}\n${solution.how}`;
+        case "decision": return `${solution.context}\n${solution.reasoning}`;
+    }
+}
+function writeSolutionToDb(db, title, solution) {
+    const id = crypto.randomUUID();
+    const now = new Date().toISOString();
+    const content = solutionContent(solution);
+    const overlapHash = crypto.createHash("sha256").update(title + content).digest("hex");
+    db.prepare(`
+		INSERT INTO solutions (id, problem_type, category, title, content, files, tags, severity, overlap_hash, created_at, updated_at)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`).run(id, solution.type, solution.type, title, content, JSON.stringify(solution.files), JSON.stringify(solution.tags), "medium", overlapHash, now, now);
+    // Index for search
+    indexContent(db, id, title, content, solution.type);
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/compound/analyzer.js.map

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

package/dist/compound/dedup.d.ts

@@ -0,0 +1,34 @@
+import type Database from "better-sqlite3";
+export interface OverlapAssessment {
+    problemOverlap: number;
+    rootCauseOverlap: number;
+    solutionOverlap: number;
+    filesOverlap: number;
+    preventionOverlap: number;
+}
+export interface SolutionForDedup {
+    title: string;
+    content: string;
+    files: string[];
+    tags: string[];
+}
+/**
+ * Assess overlap between a new solution and an existing solution.
+ * Uses token-based text similarity + file set intersection.
+ */
+export declare function assessOverlap(newSol: SolutionForDedup, existingSol: SolutionForDedup): OverlapAssessment;
+/**
+ * Determine if two solutions are duplicates using weighted 5-dimension check.
+ */
+export declare function shouldDedup(overlap: OverlapAssessment, threshold?: number): boolean;
+/**
+ * Find potential duplicates in the database using FTS5 search.
+ */
+export declare function findPotentialDuplicates(db: Database.Database, title: string): Array<{
+    id: string;
+    title: string;
+    content: string;
+    files: string;
+    tags: string;
+}>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/compound/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/compound/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,iBAAiB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAsCD;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,gBAAgB,GAC3B,iBAAiB,CAcnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO,CAQxF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYpF"}

package/dist/compound/dedup.js

@@ -0,0 +1,80 @@
+import { porterSearch } from "../store/search.ts";
+// ── Overlap assessment ─────────────────────────────────────────────────────────
+/**
+ * Compute text similarity between two strings using simple token overlap.
+ */
+function textSimilarity(a, b) {
+    const tokenize = (s) => new Set(s.toLowerCase().split(/\s+/).filter((t) => t.length > 2));
+    const setA = tokenize(a);
+    const setB = tokenize(b);
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    if (setA.size === 0 || setB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const token of setA) {
+        if (setB.has(token))
+            intersection++;
+    }
+    const union = setA.size + setB.size - intersection;
+    return union > 0 ? intersection / union : 0;
+}
+/**
+ * Compute file set overlap (Jaccard similarity).
+ */
+function fileOverlap(filesA, filesB) {
+    if (filesA.length === 0 && filesB.length === 0)
+        return 0;
+    if (filesA.length === 0 || filesB.length === 0)
+        return 0;
+    const setA = new Set(filesA);
+    const setB = new Set(filesB);
+    let intersection = 0;
+    for (const f of setA) {
+        if (setB.has(f))
+            intersection++;
+    }
+    const union = setA.size + setB.size - intersection;
+    return union > 0 ? intersection / union : 0;
+}
+/**
+ * Assess overlap between a new solution and an existing solution.
+ * Uses token-based text similarity + file set intersection.
+ */
+export function assessOverlap(newSol, existingSol) {
+    return {
+        problemOverlap: textSimilarity(newSol.title, existingSol.title),
+        rootCauseOverlap: textSimilarity(newSol.content.slice(0, 500), existingSol.content.slice(0, 500)),
+        solutionOverlap: textSimilarity(newSol.content, existingSol.content),
+        filesOverlap: fileOverlap(newSol.files, existingSol.files),
+        preventionOverlap: textSimilarity(newSol.tags.join(" "), existingSol.tags.join(" ")),
+    };
+}
+/**
+ * Determine if two solutions are duplicates using weighted 5-dimension check.
+ */
+export function shouldDedup(overlap, threshold = 0.7) {
+    const weighted = overlap.problemOverlap * 0.3 +
+        overlap.rootCauseOverlap * 0.3 +
+        overlap.solutionOverlap * 0.2 +
+        overlap.filesOverlap * 0.1 +
+        overlap.preventionOverlap * 0.1;
+    return weighted > threshold;
+}
+/**
+ * Find potential duplicates in the database using FTS5 search.
+ */
+export function findPotentialDuplicates(db, title) {
+    try {
+        const results = porterSearch(db, title, 5);
+        const ids = results.map((r) => r.id);
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map(() => "?").join(",");
+        return db.prepare(`SELECT id, title, content, files, tags FROM solutions WHERE id IN (${placeholders})`).all(...ids);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/dist/compound/dedup.js.map

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

package/dist/compound/extractor.d.ts

@@ -0,0 +1,47 @@
+import type { SessionEvent } from "../store/events.ts";
+export interface BugSolution {
+    type: "bug";
+    problem: string;
+    rootCause: string;
+    fix: string;
+    files: string[];
+    tags: string[];
+}
+export interface KnowledgeSolution {
+    type: "knowledge";
+    whenToUse: string;
+    how: string;
+    tradeoffs: {
+        pro: string[];
+        con: string[];
+    };
+    files: string[];
+    tags: string[];
+}
+export interface DecisionSolution {
+    type: "decision";
+    context: string;
+    options: Array<{
+        name: string;
+        pros: string[];
+        cons: string[];
+    }>;
+    choice: string;
+    reasoning: string;
+    files: string[];
+    tags: string[];
+}
+export type Solution = BugSolution | KnowledgeSolution | DecisionSolution;
+/**
+ * Extract a bug solution from error + fix events.
+ */
+export declare function extractBugSolution(errorEvent: SessionEvent, fixEvent: SessionEvent | null): BugSolution | null;
+/**
+ * Extract a knowledge pattern from file edit events.
+ */
+export declare function extractKnowledge(events: SessionEvent[]): KnowledgeSolution | null;
+/**
+ * Extract a decision from user decision events.
+ */
+export declare function extractDecision(event: SessionEvent): DecisionSolution | null;
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/compound/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAI1E;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,YAAY,GAAG,IAAI,GAC3B,WAAW,GAAG,IAAI,CA0BpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAejF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAgB5E"}

package/dist/compound/extractor.js

@@ -0,0 +1,82 @@
+// ── Extractors ─────────────────────────────────────────────────────────────────
+/**
+ * Extract a bug solution from error + fix events.
+ */
+export function extractBugSolution(errorEvent, fixEvent) {
+    let errorData;
+    try {
+        errorData = JSON.parse(errorEvent.data);
+    }
+    catch {
+        return null;
+    }
+    const errorMessage = typeof errorData.errorMessage === "string" ? errorData.errorMessage :
+        typeof errorData.message === "string" ? errorData.message : "Unknown error";
+    const tool = typeof errorData.tool === "string" ? errorData.tool : "unknown";
+    let fix = "No fix recorded.";
+    if (fixEvent) {
+        try {
+            const fixData = JSON.parse(fixEvent.data);
+            const output = typeof fixData.output_summary === "string" ? fixData.output_summary :
+                typeof fixData.command === "string" ? `Ran: ${fixData.command}` : "";
+            if (output)
+                fix = output;
+        }
+        catch { /* use default */ }
+    }
+    return {
+        type: "bug",
+        problem: errorMessage,
+        rootCause: `Error from tool: ${tool}`,
+        fix,
+        files: [],
+        tags: [tool, "auto-extracted"],
+    };
+}
+/**
+ * Extract a knowledge pattern from file edit events.
+ */
+export function extractKnowledge(events) {
+    if (events.length === 0)
+        return null;
+    const files = events
+        .map((e) => { try {
+        return JSON.parse(e.data).file;
+    }
+    catch {
+        return "";
+    } })
+        .filter((f) => f.length > 0);
+    return {
+        type: "knowledge",
+        whenToUse: `When working with: ${files.join(", ")}`,
+        how: "Pattern detected from file edit sequence.",
+        tradeoffs: { pro: [], con: [] },
+        files,
+        tags: ["auto-extracted"],
+    };
+}
+/**
+ * Extract a decision from user decision events.
+ */
+export function extractDecision(event) {
+    let data;
+    try {
+        data = JSON.parse(event.data);
+    }
+    catch {
+        return null;
+    }
+    const message = typeof data.message_summary === "string" ? data.message_summary :
+        typeof data.message === "string" ? data.message : "Decision made";
+    return {
+        type: "decision",
+        context: message,
+        options: [],
+        choice: message,
+        reasoning: "User decision captured from session.",
+        files: [],
+        tags: ["auto-extracted", "user-decision"],
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/compound/extractor.js.map

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

package/dist/compound/router.d.ts

@@ -0,0 +1,17 @@
+import type { SessionEvent } from "../store/events.ts";
+export type FindingType = "bug" | "knowledge" | "decision";
+export interface RoutedFinding {
+    type: FindingType;
+    confidence: number;
+    events: SessionEvent[];
+}
+/**
+ * Route session events to the appropriate finding type.
+ * Classifies as bug/knowledge/decision based on event patterns.
+ */
+export declare function routeFinding(events: SessionEvent[]): RoutedFinding | null;
+/**
+ * Route multiple sessions' events and return all routed findings.
+ */
+export declare function routeSessionFindings(events: SessionEvent[]): RoutedFinding[];
+//# sourceMappingURL=router.d.ts.map

package/dist/compound/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/compound/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,GAAG,IAAI,CA8BzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAgC5E"}