squish-memory 0.7.0

package/dist/core/memory/entity-extractor.js

@@ -0,0 +1,336 @@
+/**
+ * Entity Extractor
+ * Extracts named entities from memory content
+ * Supports people, files, functions, dates, locations, concepts, tools, and patterns
+ */
+import { getDb } from '../../db/index.js';
+import { getSchema } from '../../db/schema.js';
+import { eq, and } from 'drizzle-orm';
+import { logger } from '../../core/logger.js';
+// Regex patterns for entity detection
+const PATTERNS = {
+    // File paths: src/components/Button.tsx, ./config.json, /var/log/app.log
+    filePath: /(?:^|[^\w])(?:\.?\/[\w.-]*[\w.-]*(?:\/[\w.-]+)*|[\w.-]+\.(?:ts|tsx|js|jsx|py|rb|go|java|cpp|c|h|json|yaml|yml|env|md|txt|csv|sql|graphql))\b/gm,
+    // Functions/methods: `functionName()`, `object.method()`, `Class.staticMethod()`
+    functionCall: /\b([a-zA-Z_$][a-zA-Z0-9_$]*)\s*(?=\()/g,
+    // Classes: `class ClassName`, `new ClassName()`, `extends ClassName`
+    className: /\b(?:class|new|extends|implements)\s+([A-Z][a-zA-Z0-9_$]*)\b/g,
+    // Common names (capitalized words not at sentence start)
+    personName: /(?:^|[^.\w])\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)\b(?![^.\w])/g,
+    // Capitalized concepts: `Machine Learning`, `React Hooks`
+    concept: /\b(?:[A-Z][a-z]+\s+)+(?:System|Architecture|Pattern|Model|Algorithm|Framework|Library|Process|Concept|Theory|Method)\b/g,
+    // Technologies/Tools: React, Node.js, PostgreSQL, Docker, Kubernetes
+    tool: /\b(?:React|Vue|Angular|Node\.?js?|Express|Django|Flask|FastAPI|PostgreSQL|MongoDB|Redis|Docker|Kubernetes|Terraform|AWS|Azure|GCP|GitHub|GitLab|Jenkins|Figma|Sketch|Adobe|Webpack|Vite|npm|yarn|pnpm|TypeScript|JavaScript|Python|Go|Rust|Java|C\+\+|C#)\b/g,
+    // Design patterns: `singleton pattern`, `factory method`, `observer pattern`
+    designPattern: /\b(?:abstract\s+)?(?:factory|singleton|observer|decorator|strategy|adapter|bridge|facade|proxy|chain\s+of\s+responsibility|composite|template\s+method|visitor|builder|prototype|memento|interpreter|command|state|mediator)\s+(?:pattern|method)\b/gi,
+    // Techniques/Methodologies: `memoization`, `caching`, `lazy loading`, `debouncing`
+    technique: /\b(?:memoization|caching|lazy\s+loading|debouncing|throttling|currying|composition|recursion|iteration|hashing|indexing|sharding|replication|optimization|refactoring|testing|debugging|profiling|monitoring|logging)\b/gi,
+    // Quoted concepts and important terms
+    quotedConcept: /["`]([^"`]+)["`]/g,
+    // ISO dates
+    date: /\b(\d{4}-\d{2}-\d{2})(?:T\d{2}:\d{2}:\d{2})?\b/g,
+    // Common code keywords and variables
+    codeVariable: /\b(?:const|let|var|function|async|await|return|import|export|class|interface|type|enum)\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\b/g,
+};
+/**
+ * Extract entities from content
+ */
+export async function extractEntities(content) {
+    const entities = [];
+    const seenKeys = new Set(); // Deduplicate entities
+    // Extract file paths
+    const filePaths = Array.from(content.matchAll(PATTERNS.filePath));
+    for (const match of filePaths) {
+        const name = match[0].trim();
+        const key = `file:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'file',
+                confidence: 0.9,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+                normalized: normalizePath(name),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract function calls
+    const functionCalls = Array.from(content.matchAll(PATTERNS.functionCall));
+    for (const match of functionCalls) {
+        const name = match[1];
+        const key = `function:${name}`;
+        if (!seenKeys.has(key) && name.length > 2) {
+            entities.push({
+                name,
+                type: 'function',
+                confidence: 0.85,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract class names
+    const classNames = Array.from(content.matchAll(PATTERNS.className));
+    for (const match of classNames) {
+        const name = match[1];
+        const key = `class:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'class',
+                confidence: 0.95,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract technologies/tools
+    const tools = Array.from(content.matchAll(PATTERNS.tool));
+    for (const match of tools) {
+        const name = match[0];
+        const key = `tool:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'tool',
+                confidence: 0.9,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract design patterns
+    const patterns = Array.from(content.matchAll(PATTERNS.designPattern));
+    for (const match of patterns) {
+        const name = match[0];
+        const key = `pattern:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'pattern',
+                confidence: 0.92,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract techniques/methodologies
+    const techniques = Array.from(content.matchAll(PATTERNS.technique));
+    for (const match of techniques) {
+        const name = match[0];
+        const key = `technique:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'technique',
+                confidence: 0.88,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract dates
+    const dates = Array.from(content.matchAll(PATTERNS.date));
+    for (const match of dates) {
+        const name = match[0];
+        const key = `date:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'date',
+                confidence: 0.95,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract quoted important concepts
+    const quotedConcepts = Array.from(content.matchAll(PATTERNS.quotedConcept));
+    for (const match of quotedConcepts) {
+        const name = match[1];
+        const key = `concept:${name}`;
+        if (!seenKeys.has(key) && name.length > 2) {
+            entities.push({
+                name,
+                type: 'concept',
+                confidence: 0.8,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Extract capitalized concepts
+    const concepts = Array.from(content.matchAll(PATTERNS.concept));
+    for (const match of concepts) {
+        const name = match[0];
+        const key = `concept:${name}`;
+        if (!seenKeys.has(key)) {
+            entities.push({
+                name,
+                type: 'concept',
+                confidence: 0.75,
+                startIndex: match.index || 0,
+                endIndex: (match.index || 0) + match[0].length,
+                context: extractContext(content, match.index || 0),
+            });
+            seenKeys.add(key);
+        }
+    }
+    // Sort by start index
+    entities.sort((a, b) => a.startIndex - b.startIndex);
+    logger.debug('Entities extracted', {
+        count: entities.length,
+        byType: countByType(entities),
+    });
+    return entities;
+}
+/**
+ * Link extracted entities to memory records
+ * Creates entity records in the knowledge graph
+ */
+export async function linkEntitiesToMemories(memoryId, entities) {
+    if (entities.length === 0)
+        return;
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        // Get memory to find project
+        const memories = await db
+            .select()
+            .from(schema.memories)
+            .where(eq(schema.memories.id, memoryId))
+            .limit(1);
+        if (memories.length === 0)
+            return;
+        const memory = memories[0];
+        // Insert unique entities into the knowledge graph
+        for (const entity of entities) {
+            try {
+                // Check if entity already exists
+                const existing = await db
+                    .select()
+                    .from(schema.entities)
+                    .where(and(eq(schema.entities.projectId, memory.projectId), eq(schema.entities.name, entity.name), eq(schema.entities.type, entity.type)))
+                    .limit(1);
+                if (existing.length === 0) {
+                    // Insert new entity with metadata in properties
+                    await db.insert(schema.entities).values({
+                        name: entity.name,
+                        type: entity.type,
+                        projectId: memory.projectId,
+                        description: entity.context,
+                        properties: {
+                            confidence: entity.confidence,
+                            extractedFrom: memoryId,
+                            normalized: entity.normalized,
+                        },
+                    });
+                }
+            }
+            catch (error) {
+                logger.error('Error inserting entity', { entity, error });
+            }
+        }
+        logger.debug('Entities linked to memory', {
+            memoryId,
+            entityCount: entities.length,
+        });
+    }
+    catch (error) {
+        logger.error('Error linking entities to memories', error);
+    }
+}
+/**
+ * Get entities extracted from a memory based on properties
+ */
+export async function getMemoryEntities(memoryId) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        // Find all entities with this memory ID in properties
+        const allEntities = await db.select().from(schema.entities);
+        const entities = [];
+        for (const entity of allEntities) {
+            const props = entity.properties;
+            if (props && props.extractedFrom === memoryId) {
+                entities.push({
+                    name: entity.name,
+                    type: entity.type,
+                    confidence: props.confidence || 0.8,
+                    startIndex: 0,
+                    endIndex: 0,
+                    context: entity.description || '',
+                    normalized: props.normalized,
+                });
+            }
+        }
+        return entities;
+    }
+    catch (error) {
+        logger.error('Error getting memory entities', error);
+        return [];
+    }
+}
+/**
+ * Get all entities for a project
+ */
+export async function getProjectEntities(projectId, type) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        let query = db.select().from(schema.entities).where(eq(schema.entities.projectId, projectId));
+        if (type) {
+            query = query.where(eq(schema.entities.type, type));
+        }
+        return await query;
+    }
+    catch (error) {
+        logger.error('Error getting project entities', error);
+        return [];
+    }
+}
+/**
+ * Extract context around entity
+ */
+function extractContext(content, index, contextLength = 50) {
+    const start = Math.max(0, index - contextLength);
+    const end = Math.min(content.length, index + contextLength);
+    return content.substring(start, end).trim();
+}
+/**
+ * Normalize file path
+ */
+function normalizePath(path) {
+    return path
+        .trim()
+        .replace(/^\.\//, '')
+        .toLowerCase()
+        .replace(/\\/g, '/');
+}
+/**
+ * Count entities by type
+ */
+function countByType(entities) {
+    const counts = {};
+    for (const entity of entities) {
+        counts[entity.type] = (counts[entity.type] || 0) + 1;
+    }
+    return counts;
+}
+//# sourceMappingURL=entity-extractor.js.map

package/dist/core/memory/entity-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-extractor.js","sourceRoot":"","sources":["../../../core/memory/entity-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAyB9C,sCAAsC;AACtC,MAAM,QAAQ,GAAG;IACf,yEAAyE;IACzE,QAAQ,EAAE,gJAAgJ;IAE1J,iFAAiF;IACjF,YAAY,EAAE,wCAAwC;IAEtD,qEAAqE;IACrE,SAAS,EAAE,+DAA+D;IAE1E,yDAAyD;IACzD,UAAU,EAAE,6DAA6D;IAEzE,0DAA0D;IAC1D,OAAO,EAAE,yHAAyH;IAElI,qEAAqE;IACrE,IAAI,EAAE,8PAA8P;IAEpQ,6EAA6E;IAC7E,aAAa,EAAE,uPAAuP;IAEtQ,mFAAmF;IACnF,SAAS,EAAE,2NAA2N;IAEtO,sCAAsC;IACtC,aAAa,EAAE,mBAAmB;IAElC,YAAY;IACZ,IAAI,EAAE,iDAAiD;IAEvD,qCAAqC;IACrC,YAAY,EAAE,yHAAyH;CACxI,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,uBAAuB;IAE3D,qBAAqB;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,QAAQ,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;gBAClD,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;aAChC,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,YAAY,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,SAAS,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,WAAW,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,aAAa,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5E,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,WAAW,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,WAAW,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBAC5B,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;gBAC9C,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;aACnD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAErD,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;QACjC,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;KAC9B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,QAA2B;IAE3B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,MAAO,EAAU;aAC/B,MAAM,EAAE;aACR,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;aACrB,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;aACvC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEZ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE3B,kDAAkD;QAClD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,iCAAiC;gBACjC,MAAM,QAAQ,GAAG,MAAO,EAAU;qBAC/B,MAAM,EAAE;qBACR,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;qBACrB,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAC/C,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EACrC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CACtC,CACF;qBACA,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEZ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,gDAAgD;oBAChD,MAAO,EAAU,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;wBAC/C,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,WAAW,EAAE,MAAM,CAAC,OAAO;wBAC3B,UAAU,EAAE;4BACV,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,aAAa,EAAE,QAAQ;4BACvB,UAAU,EAAE,MAAM,CAAC,UAAU;yBAC9B;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;YACxC,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,MAAM;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,sDAAsD;QACtD,MAAM,WAAW,GAAG,MAAO,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErE,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAqC,CAAC;YAC3D,IAAI,KAAK,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAkB;oBAC/B,UAAU,EAAG,KAAK,CAAC,UAAqB,IAAI,GAAG;oBAC/C,UAAU,EAAE,CAAC;oBACb,QAAQ,EAAE,CAAC;oBACX,OAAO,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;oBACjC,UAAU,EAAE,KAAK,CAAC,UAAgC;iBACnD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,IAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,IAAI,KAAK,GAAS,EAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAE5G,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,KAAK,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,KAAa,EAAE,gBAAwB,EAAE;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAA2B;IAC9C,MAAM,MAAM,GAAG,EAAgC,CAAC;IAEhD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/memory/entity-resolver.d.ts

@@ -0,0 +1,23 @@
+export interface ExtractedEntities {
+    primary: string[];
+    secondary: string[];
+    queryType: 'factual' | 'relational' | 'temporal';
+}
+/**
+ * Extract entities from a query using Claude
+ * NO FALLBACKS - real extraction or throw
+ */
+export declare function extractQueryEntities(query: string, callClaudeFn: (prompt: string, maxTokens: number) => Promise<string>): Promise<ExtractedEntities>;
+/**
+ * Score memory relevance based on entity matching
+ * Returns boost factor (0-1)
+ */
+export declare function scoreEntityMatch(memoryEntities: string[], queryEntities: string[]): number;
+/**
+ * Filter and boost memories by entity relevance
+ */
+export declare function filterByEntities(memories: any[], queryEntities: string[]): Array<{
+    memory: any;
+    entityBoost: number;
+}>;
+//# sourceMappingURL=entity-resolver.d.ts.map

package/dist/core/memory/entity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-resolver.d.ts","sourceRoot":"","sources":["../../../core/memory/entity-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACnE,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,EAAE,EACf,aAAa,EAAE,MAAM,EAAE,GACtB,KAAK,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAe7C"}

package/dist/core/memory/entity-resolver.js

@@ -0,0 +1,64 @@
+/**
+ * Extract entities from a query using Claude
+ * NO FALLBACKS - real extraction or throw
+ */
+export async function extractQueryEntities(query, callClaudeFn) {
+    const prompt = `Extract entities from this question. Return ONLY JSON:
+{
+  "primary": ["Alice", "project name"],
+  "secondary": ["team", "budget"],
+  "queryType": "factual"
+}
+
+Question: ${query}`;
+    const response = await callClaudeFn(prompt, 500);
+    const jsonMatch = response.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+        throw new Error('No JSON in entity extraction');
+    }
+    const parsed = JSON.parse(jsonMatch[0]);
+    return {
+        primary: parsed.primary || [],
+        secondary: parsed.secondary || [],
+        queryType: parsed.queryType || 'factual',
+    };
+}
+/**
+ * Score memory relevance based on entity matching
+ * Returns boost factor (0-1)
+ */
+export function scoreEntityMatch(memoryEntities, queryEntities) {
+    if (!queryEntities.length || !memoryEntities.length) {
+        return 0.5; // Neutral if no entities
+    }
+    const querySet = new Set(queryEntities.map(e => e.toLowerCase()));
+    const memorySet = new Set(memoryEntities.map(e => e.toLowerCase()));
+    // Count matches
+    let matches = 0;
+    for (const entity of querySet) {
+        if (memorySet.has(entity)) {
+            matches++;
+        }
+    }
+    // Calculate boost (0-1)
+    const matchRatio = matches / querySet.size;
+    return 0.5 + (matchRatio * 0.5); // 0.5 to 1.0
+}
+/**
+ * Filter and boost memories by entity relevance
+ */
+export function filterByEntities(memories, queryEntities) {
+    if (!queryEntities.length) {
+        // No entities to filter by, return all with neutral boost
+        return memories.map(m => ({ memory: m, entityBoost: 0.5 }));
+    }
+    return memories.map(memory => {
+        const memoryEntities = memory.metadata?.entities || [];
+        const boost = scoreEntityMatch(memoryEntities, queryEntities);
+        return {
+            memory,
+            entityBoost: boost,
+        };
+    });
+}
+//# sourceMappingURL=entity-resolver.js.map

package/dist/core/memory/entity-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-resolver.js","sourceRoot":"","sources":["../../../core/memory/entity-resolver.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAa,EACb,YAAoE;IAEpE,MAAM,MAAM,GAAG;;;;;;;YAOL,KAAK,EAAE,CAAC;IAElB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAsB,CAAC;IAE7D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;KACzC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,cAAwB,EACxB,aAAuB;IAEvB,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACpD,OAAO,GAAG,CAAC,CAAC,yBAAyB;IACvC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEpE,gBAAgB;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3C,OAAO,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAe,EACf,aAAuB;IAEvB,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAC1B,0DAA0D;QAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QAC3B,MAAM,cAAc,GAAI,MAAM,CAAC,QAAQ,EAAE,QAAqB,IAAI,EAAE,CAAC;QACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAE9D,OAAO;YACL,MAAM;YACN,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/memory/fact-extractor.d.ts

@@ -0,0 +1,24 @@
+import type { RememberInput } from './memories.js';
+export interface ExtractedFact {
+    content: string;
+    confidence: number;
+    entities: string[];
+    relation?: string;
+}
+export interface FactExtractionResult {
+    facts: ExtractedFact[];
+    summary: string;
+    entities: string[];
+}
+/**
+ * Extract facts from conversation text using Claude API
+ *
+ * This function MUST return valid facts or throw an error.
+ * NO FALLBACKS - we need real extraction to reach 90% accuracy.
+ */
+export declare function extractFacts(text: string, callClaude: (prompt: string, maxTokens: number) => Promise<string>): Promise<FactExtractionResult>;
+/**
+ * Convert extracted facts to memory inputs
+ */
+export declare function factsToMemoryInputs(sourceMemory: RememberInput, extraction: FactExtractionResult, sourceId: string): RememberInput[];
+//# sourceMappingURL=fact-extractor.d.ts.map

package/dist/core/memory/fact-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-extractor.d.ts","sourceRoot":"","sources":["../../../core/memory/fact-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACjE,OAAO,CAAC,oBAAoB,CAAC,CAuE/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,aAAa,EAC3B,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,MAAM,GACf,aAAa,EAAE,CAejB"}

package/dist/core/memory/fact-extractor.js

@@ -0,0 +1,89 @@
+/**
+ * Extract facts from conversation text using Claude API
+ *
+ * This function MUST return valid facts or throw an error.
+ * NO FALLBACKS - we need real extraction to reach 90% accuracy.
+ */
+export async function extractFacts(text, callClaude) {
+    if (!text || text.length < 50) {
+        // Too short for meaningful extraction - return as single fact
+        return {
+            facts: [{ content: text.trim(), confidence: 1.0, entities: [] }],
+            summary: text.trim(),
+            entities: []
+        };
+    }
+    const prompt = `Extract atomic facts from this conversation. 
+
+Requirements:
+- Extract specific, verifiable facts (names, dates, numbers, relationships)
+- Each fact should be a standalone statement
+- Identify entities (people, organizations, projects, locations)
+- Note temporal information and relationships
+
+Return ONLY valid JSON in this exact format:
+{"facts":[{"content":"fact statement","confidence":0.95,"entities":["Name"],"relation":"optional"}],"summary":"brief summary","entities":["all","entities"]}
+
+Text to analyze:
+${text.substring(0, 4000)}`;
+    const response = await callClaude(prompt, 2000);
+    // Extract JSON - look for the first { and last }
+    const startIdx = response.indexOf('{');
+    const endIdx = response.lastIndexOf('}');
+    if (startIdx === -1 || endIdx === -1 || startIdx >= endIdx) {
+        throw new Error(`Fact extraction failed: No valid JSON found in response. Response: ${response.substring(0, 200)}`);
+    }
+    const jsonStr = response.substring(startIdx, endIdx + 1);
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch (parseError) {
+        throw new Error(`Fact extraction failed: JSON parse error. JSON: ${jsonStr.substring(0, 200)}`);
+    }
+    // Validate facts array exists and has content
+    if (!parsed.facts || !Array.isArray(parsed.facts)) {
+        throw new Error(`Fact extraction failed: Missing 'facts' array in response. Keys: ${Object.keys(parsed).join(', ')}`);
+    }
+    // Filter and clean facts
+    const validFacts = parsed.facts
+        .filter((f) => f && typeof f.content === 'string' && f.content.trim().length > 10)
+        .map((f) => ({
+        content: f.content.trim(),
+        confidence: Math.max(0, Math.min(1, typeof f.confidence === 'number' ? f.confidence : 0.8)),
+        entities: Array.isArray(f.entities) ? f.entities.filter((e) => typeof e === 'string') : [],
+        relation: typeof f.relation === 'string' ? f.relation : undefined
+    }));
+    if (validFacts.length === 0) {
+        throw new Error(`Fact extraction failed: No valid facts after filtering. Original count: ${parsed.facts.length}`);
+    }
+    return {
+        facts: validFacts,
+        summary: typeof parsed.summary === 'string' && parsed.summary.trim()
+            ? parsed.summary.trim()
+            : text.substring(0, 200),
+        entities: Array.isArray(parsed.entities)
+            ? parsed.entities.filter((e) => typeof e === 'string')
+            : []
+    };
+}
+/**
+ * Convert extracted facts to memory inputs
+ */
+export function factsToMemoryInputs(sourceMemory, extraction, sourceId) {
+    return extraction.facts.map((fact, index) => ({
+        content: fact.content,
+        type: 'fact',
+        metadata: {
+            sourceMemoryId: sourceId,
+            extractedAt: new Date().toISOString(),
+            entities: fact.entities,
+            relation: fact.relation,
+            confidence: Math.floor(fact.confidence * 100),
+            factIndex: index
+        },
+        tags: [...(sourceMemory.tags || []), 'extracted-fact', ...fact.entities],
+        project: sourceMemory.project
+    }));
+}
+//# sourceMappingURL=fact-extractor.js.map

package/dist/core/memory/fact-extractor.js.map

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

package/dist/core/memory/hybrid-retrieval.d.ts

@@ -0,0 +1,30 @@
+import { HybridScorerOptions } from './hybrid-scorer.js';
+import { SearchInput, MemoryRecord } from './memories.js';
+export interface HybridSearchOptions extends SearchInput {
+    candidateLimit?: number;
+    resultLimit?: number;
+    hybridOptions?: HybridScorerOptions;
+    queryEntities?: string[];
+}
+export interface HybridSearchResult extends MemoryRecord {
+    hybridScore: number;
+    semanticScore: number;
+    recencyScore: number;
+    coactivationScore: number;
+    importanceScore: number;
+    entityBoost: number;
+    rank: number;
+}
+/**
+ * Hybrid search with multi-factor re-ranking + entity filtering
+ *
+ * Algorithm:
+ * 1. Fetch N candidates using vector similarity
+ * 2. Filter/boost by entity relevance (Phase 3)
+ * 3. Re-rank using hybrid scoring (semantic + recency + coactivation + importance)
+ * 4. Return top M results
+ *
+ * This provides better relevance than pure vector search
+ */
+export declare function hybridSearch(options: HybridSearchOptions): Promise<HybridSearchResult[]>;
+//# sourceMappingURL=hybrid-retrieval.d.ts.map

package/dist/core/memory/hybrid-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-retrieval.d.ts","sourceRoot":"","sources":["../../../core/memory/hybrid-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAkB,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG1E,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0D/B"}