cortex-mcp 1.0.1

package/dist/memory/memory-decay.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupMemories = cleanupMemories;
+const types_1 = require("../types");
+const config_1 = require("../config/config");
+const memory_cache_1 = require("./memory-cache");
+function cleanupMemories(memoryStore) {
+    const now = Date.now();
+    const DAY = 24 * 60 * 60 * 1000;
+    try {
+        let cleaned = 0;
+        // 1. Deactivate INSIGHT memories > 14 days with 0 access
+        const insights = memoryStore.getByType(types_1.MemoryType.INSIGHT, 5000);
+        for (const m of insights) {
+            if (m.accessCount === 0 && now - m.createdAt > config_1.CONFIG.INSIGHT_MAX_AGE_DAYS * DAY) {
+                memoryStore.deactivate(m.id);
+                cleaned++;
+            }
+        }
+        // 2. Deactivate any memory > 30 days with 0 access
+        const all = memoryStore.getActive(5000);
+        for (const m of all) {
+            if (m.accessCount === 0 && now - m.createdAt > config_1.CONFIG.UNUSED_MAX_AGE_DAYS * DAY) {
+                memoryStore.deactivate(m.id);
+                cleaned++;
+            }
+        }
+        // 3. Cap at MEMORY_CAP active memories
+        const active = memoryStore.getActive(5000);
+        if (active.length > config_1.CONFIG.MEMORY_CAP) {
+            const sorted = active.sort((a, b) => a.importance - b.importance);
+            const toRemove = sorted.slice(0, active.length - config_1.CONFIG.MEMORY_CAP);
+            for (const m of toRemove) {
+                memoryStore.deactivate(m.id);
+                cleaned++;
+            }
+        }
+        // 4. NEW: Duplicate detection — find memories with identical intents
+        const activeAfterClean = memoryStore.getActive(5000);
+        const intentMap = new Map();
+        for (const m of activeAfterClean) {
+            const key = m.intent.toLowerCase().trim();
+            const existing = intentMap.get(key);
+            if (existing) {
+                existing.push(m);
+            }
+            else {
+                intentMap.set(key, [m]);
+            }
+        }
+        // Merge duplicates — keep highest importance, boost it
+        for (const [, dupes] of intentMap) {
+            if (dupes.length <= 1)
+                continue;
+            // Sort by importance desc, keep the first
+            dupes.sort((a, b) => b.importance - a.importance);
+            const keeper = dupes[0];
+            // Strengthen the keeper (repeated = more important)
+            const strengthBoost = Math.min(dupes.length * 0.05, 0.3);
+            memoryStore.update(keeper.id, {
+                importance: Math.min(keeper.importance + strengthBoost, 1.0),
+                accessCount: keeper.accessCount + dupes.length - 1,
+            });
+            // Deactivate the rest
+            for (let i = 1; i < dupes.length; i++) {
+                memoryStore.deactivate(dupes[i].id, keeper.id);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            console.log(`  🧹 Decay: cleaned ${cleaned} stale/duplicate memories`);
+            (0, memory_cache_1.invalidateCache)();
+        }
+    }
+    catch (err) {
+        console.error('  [ERROR] Cleanup error:', err.message);
+    }
+}
+//# sourceMappingURL=memory-decay.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Memory Quality — Filters, contradiction detection, and quality gates.
+ *
+ * Prevents junk memories from polluting the database.
+ * Detects contradictions between memories.
+ */
+import { MemoryStore } from '../db/memory-store';
+import { MemoryType } from '../types';
+/**
+ * Check if a memory is worth storing.
+ * Returns null if good, or a rejection reason if bad.
+ */
+export declare function qualityCheck(intent: string, type: string): string | null;
+/**
+ * Check if a new memory contradicts existing ones.
+ * Returns the contradicting memory if found.
+ */
+export declare function findContradiction(memoryStore: MemoryStore, newIntent: string, newType: MemoryType): {
+    contradicts: string;
+    existingId: string;
+    existingIntent: string;
+} | null;
+/**
+ * Store a memory with quality + contradiction checks.
+ * Returns the stored memory or null if rejected.
+ */
+export declare function storeWithQuality(memoryStore: MemoryStore, params: {
+    type: MemoryType;
+    intent: string;
+    action?: string;
+    reason?: string;
+    importance: number;
+    confidence: number;
+    tags: string[];
+    relatedFiles?: string[];
+}): any | null;
+//# sourceMappingURL=memory-quality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-quality.d.ts","sourceRoot":"","sources":["../../src/memory/memory-quality.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAetC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8ExE;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,GACpB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4E5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE;IACJ,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GACF,GAAG,GAAG,IAAI,CAqCZ"}

package/dist/memory/memory-quality.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qualityCheck = qualityCheck;
+exports.findContradiction = findContradiction;
+exports.storeWithQuality = storeWithQuality;
+const types_1 = require("../types");
+// --- Quality Gate ---
+const TOO_GENERIC = new Set([
+    'use best practices',
+    'follow conventions',
+    'write clean code',
+    'be careful',
+    'test your code',
+    'read the docs',
+    'check the documentation',
+    'handle errors',
+    'add error handling',
+]);
+/**
+ * Check if a memory is worth storing.
+ * Returns null if good, or a rejection reason if bad.
+ */
+function qualityCheck(intent, type) {
+    // Too short
+    if (!intent || intent.trim().length < 15) {
+        return 'Too short (< 15 chars)';
+    }
+    // Too long (probably pasted a whole paragraph)
+    if (intent.length > 500) {
+        return 'Too long (> 500 chars)';
+    }
+    // Too generic
+    const normalized = intent.toLowerCase().trim();
+    if (TOO_GENERIC.has(normalized)) {
+        return 'Too generic';
+    }
+    // All caps (yelling / noise)
+    if (intent === intent.toUpperCase() && intent.length > 20) {
+        return 'All caps noise';
+    }
+    // Repeated characters (spam)
+    if (/(.)\1{5,}/.test(intent)) {
+        return 'Repeated characters';
+    }
+    // Only URLs or paths
+    if (/^https?:\/\/\S+$/.test(intent.trim())) {
+        return 'Just a URL';
+    }
+    // Raw JSON blobs (artifact metadata, config objects, etc.)
+    if (normalized.startsWith('{') || normalized.startsWith('[')) {
+        return 'Raw JSON blob';
+    }
+    // Mostly JSON-like content (has lots of quotes and colons)
+    const jsonIndicators = (intent.match(/[{}[\]:]/g) || []).length;
+    if (jsonIndicators > 6 && jsonIndicators / intent.length > 0.05) {
+        return 'JSON-like content';
+    }
+    // AI response artifacts ("AI response: { artifactType...}")
+    if (normalized.startsWith('ai response:') || normalized.startsWith('ai correction:')) {
+        return 'AI response artifact';
+    }
+    // Hallucination guard noise ("Hallucination detected: Referenced file not found:")
+    if (normalized.startsWith('hallucination')) {
+        return 'Hallucination guard noise';
+    }
+    // Document dumps (markdown headers — these are full documents, not memories)
+    if (normalized.startsWith('# ') && intent.length > 100) {
+        return 'Markdown document dump';
+    }
+    // Prefixed noise patterns from extractors
+    const noisePrefixes = ['bug analysis:', 'self-test:', 'test memory', 'roundtrip-'];
+    for (const prefix of noisePrefixes) {
+        if (normalized.startsWith(prefix)) {
+            return `Noise prefix: ${prefix}`;
+        }
+    }
+    // Multi-line content (real memories are single ideas, not paragraphs)
+    const lineCount = intent.split('\n').filter(l => l.trim().length > 0).length;
+    if (lineCount > 3) {
+        return 'Multi-line document (not a single memory)';
+    }
+    // File path dumps (just listing file references)
+    if (normalized.startsWith('file ') && normalized.includes(' was reverted')) {
+        return 'File revert notice';
+    }
+    return null; // Passes quality gate
+}
+// --- Contradiction Detection ---
+/**
+ * Check if a new memory contradicts existing ones.
+ * Returns the contradicting memory if found.
+ */
+function findContradiction(memoryStore, newIntent, newType) {
+    // Only check decisions, corrections, conventions against each other
+    const typesToCheck = [types_1.MemoryType.DECISION, types_1.MemoryType.CORRECTION, types_1.MemoryType.CONVENTION];
+    if (!typesToCheck.includes(newType))
+        return null;
+    const newLower = newIntent.toLowerCase();
+    // Strategy 1: Direct word-level contradiction
+    // "use X" vs "don't use X", "always Y" vs "never Y"
+    const useMatch = newLower.match(/\b(?:use|choose|pick|go with|switch to)\s+(\w+(?:\s+\w+)?)/);
+    const dontUseMatch = newLower.match(/\b(?:don'?t|never|avoid|stop)\s+(?:use|using)\s+(\w+(?:\s+\w+)?)/);
+    if (useMatch || dontUseMatch) {
+        const keyword = (useMatch?.[1] || dontUseMatch?.[1] || '').toLowerCase();
+        if (keyword.length < 3)
+            return null;
+        // Search existing memories for the opposite
+        for (const type of typesToCheck) {
+            const existing = memoryStore.getByType(type, 100);
+            for (const m of existing) {
+                const existLower = m.intent.toLowerCase();
+                if (useMatch) {
+                    // New says "use X", check if existing says "don't use X"
+                    if (existLower.includes(keyword) &&
+                        /\b(?:don'?t|never|avoid|stop)\s+(?:use|using)/i.test(existLower)) {
+                        return {
+                            contradicts: `New says "use ${keyword}" but existing says "${m.intent}"`,
+                            existingId: m.id,
+                            existingIntent: m.intent,
+                        };
+                    }
+                }
+                if (dontUseMatch) {
+                    // New says "don't use X", check if existing says "use X"
+                    if (existLower.includes(keyword) &&
+                        /\b(?:use|choose|pick|go with)\b/i.test(existLower) &&
+                        !/\b(?:don'?t|never|avoid)\b/i.test(existLower)) {
+                        return {
+                            contradicts: `New says "don't use ${keyword}" but existing says "${m.intent}"`,
+                            existingId: m.id,
+                            existingIntent: m.intent,
+                        };
+                    }
+                }
+            }
+        }
+    }
+    // Strategy 2: Same topic, different conclusion
+    // If two DECISION memories mention the same noun but have different verbs
+    if (newType === types_1.MemoryType.DECISION) {
+        const decisions = memoryStore.getByType(types_1.MemoryType.DECISION, 200);
+        for (const existing of decisions) {
+            const existLower = existing.intent.toLowerCase();
+            // Extract key nouns (words > 4 chars, not stopwords)
+            const stopwords = new Set(['should', 'would', 'could', 'about', 'their', 'these', 'those', 'which', 'there', 'where', 'while']);
+            const newNouns = newLower.split(/\s+/).filter(w => w.length > 4 && !stopwords.has(w));
+            const existNouns = existLower.split(/\s+/).filter(w => w.length > 4 && !stopwords.has(w));
+            // Count overlapping nouns
+            const overlap = newNouns.filter(w => existNouns.includes(w));
+            if (overlap.length >= 2) {
+                // Same topic detected. Check if conclusion differs.
+                // Simple: if both are decisions about the same topic, flag it
+                return {
+                    contradicts: `Possible contradiction: both discuss "${overlap.join(', ')}"`,
+                    existingId: existing.id,
+                    existingIntent: existing.intent,
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Store a memory with quality + contradiction checks.
+ * Returns the stored memory or null if rejected.
+ */
+function storeWithQuality(memoryStore, params) {
+    // Quality gate
+    const rejection = qualityCheck(params.intent, params.type);
+    if (rejection) {
+        console.log(`  [REJECT] Memory rejected: ${rejection} -- "${params.intent.slice(0, 60)}"`);
+        return null;
+    }
+    // Contradiction check
+    const contradiction = findContradiction(memoryStore, params.intent, params.type);
+    if (contradiction) {
+        console.log(`  [WARN] Contradiction: ${contradiction.contradicts}`);
+        console.log(`  [WARN] Existing: "${contradiction.existingIntent.slice(0, 80)}"`);
+        // Store the NEW one but mark the OLD as less important
+        memoryStore.update(contradiction.existingId, {
+            importance: 0.3, // Demote old contradicting memory
+            tags: ['contradicted'],
+        });
+        console.log(`  [WARN] Demoted old memory, storing new one`);
+    }
+    // Store
+    return memoryStore.add({
+        type: params.type,
+        intent: params.intent.slice(0, 300),
+        action: params.action || `Stored: ${params.intent.slice(0, 200)}`,
+        reason: params.reason || undefined,
+        relatedFiles: params.relatedFiles || [],
+        tags: params.tags,
+        confidence: params.confidence,
+        importance: params.importance,
+        timestamp: Date.now(),
+        isActive: true,
+        accessCount: 0,
+        createdAt: Date.now(),
+        id: '',
+    });
+}
+//# sourceMappingURL=memory-quality.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-quality.js","sourceRoot":"","sources":["../../src/memory/memory-quality.ts"],"names":[],"mappings":";;AA0BA,oCA8EC;AAQD,8CAgFC;AAMD,4CAiDC;AAhPD,oCAAsC;AAEtC,uBAAuB;AACvB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACxB,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,eAAe;IACf,yBAAyB;IACzB,eAAe;IACf,oBAAoB;CACvB,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAgB,YAAY,CAAC,MAAc,EAAE,IAAY;IACrD,YAAY;IACZ,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,cAAc;IACd,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACxD,OAAO,gBAAgB,CAAC;IAC5B,CAAC;IAED,6BAA6B;IAC7B,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,qBAAqB,CAAC;IACjC,CAAC;IAED,qBAAqB;IACrB,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACzC,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,2DAA2D;IAC3D,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,2DAA2D;IAC3D,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAChE,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAC9D,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED,4DAA4D;IAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnF,OAAO,sBAAsB,CAAC;IAClC,CAAC;IAED,mFAAmF;IACnF,IAAI,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,OAAO,2BAA2B,CAAC;IACvC,CAAC;IAED,6EAA6E;IAC7E,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACrD,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,0CAA0C;IAC1C,MAAM,aAAa,GAAG,CAAC,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACnF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,iBAAiB,MAAM,EAAE,CAAC;QACrC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7E,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,2CAA2C,CAAC;IACvD,CAAC;IAED,iDAAiD;IACjD,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACzE,OAAO,oBAAoB,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,sBAAsB;AACvC,CAAC;AAED,kCAAkC;AAElC;;;GAGG;AACH,SAAgB,iBAAiB,CAC7B,WAAwB,EACxB,SAAiB,EACjB,OAAmB;IAEnB,oEAAoE;IACpE,MAAM,YAAY,GAAG,CAAC,kBAAU,CAAC,QAAQ,EAAE,kBAAU,CAAC,UAAU,EAAE,kBAAU,CAAC,UAAU,CAAC,CAAC;IACzF,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAEzC,8CAA8C;IAC9C,oDAAoD;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAC9F,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAExG,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACzE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,4CAA4C;QAC5C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBAE1C,IAAI,QAAQ,EAAE,CAAC;oBACX,yDAAyD;oBACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAC5B,gDAAgD,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;wBACpE,OAAO;4BACH,WAAW,EAAE,iBAAiB,OAAO,wBAAwB,CAAC,CAAC,MAAM,GAAG;4BACxE,UAAU,EAAE,CAAC,CAAC,EAAE;4BAChB,cAAc,EAAE,CAAC,CAAC,MAAM;yBAC3B,CAAC;oBACN,CAAC;gBACL,CAAC;gBAED,IAAI,YAAY,EAAE,CAAC;oBACf,yDAAyD;oBACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAC5B,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC;wBACnD,CAAC,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;wBAClD,OAAO;4BACH,WAAW,EAAE,uBAAuB,OAAO,wBAAwB,CAAC,CAAC,MAAM,GAAG;4BAC9E,UAAU,EAAE,CAAC,CAAC,EAAE;4BAChB,cAAc,EAAE,CAAC,CAAC,MAAM;yBAC3B,CAAC;oBACN,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,0EAA0E;IAC1E,IAAI,OAAO,KAAK,kBAAU,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,kBAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACjD,qDAAqD;YACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAChI,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1F,0BAA0B;YAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,oDAAoD;gBACpD,8DAA8D;gBAC9D,OAAO;oBACH,WAAW,EAAE,yCAAyC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC3E,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,cAAc,EAAE,QAAQ,CAAC,MAAM;iBAClC,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAC5B,WAAwB,EACxB,MASC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,QAAQ,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,sBAAsB;IACtB,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACjF,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACjF,uDAAuD;QACvD,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE;YACzC,UAAU,EAAE,GAAG,EAAE,kCAAkC;YACnD,IAAI,EAAE,CAAC,cAAc,CAAC;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ;IACR,OAAO,WAAW,CAAC,GAAG,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,WAAW,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QACjE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;QAClC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,EAAE,EAAE,EAAE;KACT,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { ScoredMemory } from '../types';
+export interface RankedResult {
+    memory: any;
+    score: number;
+}
+/**
+ * Merge FTS + Vector results, deduplicate, boost by type + recency + access.
+ */
+export declare function rankResults(ftsResults: ScoredMemory[], vectorResults: RankedResult[], maxResults: number, currentFile?: string): RankedResult[];
+/**
+ * Format ranked results into a readable text block for the AI.
+ */
+export declare function formatResults(ranked: RankedResult[], queryText: string): string;
+//# sourceMappingURL=memory-ranker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ranker.d.ts","sourceRoot":"","sources":["../../src/memory/memory-ranker.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,UAAU,EAAE,YAAY,EAAE,EAC1B,aAAa,EAAE,YAAY,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,YAAY,EAAE,CAgDhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ/E"}

package/dist/memory/memory-ranker.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rankResults = rankResults;
+exports.formatResults = formatResults;
+/**
+ * Memory Ranker — Scoring, merging, and ranking search results.
+ * Extracted from standalone.ts L713-885.
+ *
+ * NEW: Recency bias — newer memories score higher.
+ * NEW: File-aware ranking — if query mentions a file, related memories boost.
+ */
+const config_1 = require("../config/config");
+/**
+ * Merge FTS + Vector results, deduplicate, boost by type + recency + access.
+ */
+function rankResults(ftsResults, vectorResults, maxResults, currentFile) {
+    const seen = new Set();
+    const merged = [];
+    const now = Date.now();
+    const DAY = 24 * 60 * 60 * 1000;
+    for (const r of ftsResults) {
+        if (seen.has(r.memory.id))
+            continue;
+        seen.add(r.memory.id);
+        const boost = config_1.CONFIG.TYPE_BOOST[r.memory.type] || 1.0;
+        const accessBoost = 1 + (r.memory.accessCount || 0) * 0.1;
+        // NEW: Recency bias — memories from last 24h get 1.5x, last 7d get 1.2x
+        const ageMs = now - (r.memory.createdAt || r.memory.timestamp || 0);
+        const recencyBoost = ageMs < DAY ? 1.5 : ageMs < 7 * DAY ? 1.2 : 1.0;
+        // NEW: File-aware boost — if memory is related to current file, boost 1.5x
+        const fileBoost = currentFile && r.memory.relatedFiles?.some((f) => f.includes(currentFile) || currentFile.includes(f)) ? 1.5 : 1.0;
+        merged.push({
+            memory: r.memory,
+            score: r.score * boost * accessBoost * recencyBoost * fileBoost,
+        });
+    }
+    for (const r of vectorResults) {
+        if (seen.has(r.memory.id))
+            continue;
+        seen.add(r.memory.id);
+        const boost = config_1.CONFIG.TYPE_BOOST[r.memory.type] || 1.0;
+        const accessBoost = 1 + (r.memory.accessCount || 0) * 0.1;
+        const ageMs = now - (r.memory.createdAt || r.memory.timestamp || 0);
+        const recencyBoost = ageMs < DAY ? 1.5 : ageMs < 7 * DAY ? 1.2 : 1.0;
+        const fileBoost = currentFile && r.memory.relatedFiles?.some((f) => f.includes(currentFile) || currentFile.includes(f)) ? 1.5 : 1.0;
+        merged.push({
+            memory: r.memory,
+            score: r.score * boost * accessBoost * recencyBoost * fileBoost,
+        });
+    }
+    merged.sort((a, b) => b.score - a.score);
+    return merged.slice(0, maxResults);
+}
+/**
+ * Format ranked results into a readable text block for the AI.
+ */
+function formatResults(ranked, queryText) {
+    const lines = [];
+    for (const r of ranked) {
+        lines.push(`[${r.memory.type}] ${r.memory.intent}`);
+        if (r.memory.action)
+            lines.push(`  → ${r.memory.action}`);
+        if (r.memory.reason)
+            lines.push(`  Why: ${r.memory.reason}`);
+    }
+    return lines.join('\n') || `No memories matching "${queryText}"`;
+}
+//# sourceMappingURL=memory-ranker.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { MemoryStore } from '../db/memory-store';
+export interface KnowledgeGap {
+    path: string;
+    type: 'file' | 'directory';
+    fileCount?: number;
+}
+/** Detect knowledge gaps in the project */
+export declare function detectKnowledgeGaps(memoryStore: MemoryStore, workspaceRoot: string): KnowledgeGap[];
+/** Format knowledge gaps for injection */
+export declare function formatKnowledgeGaps(gaps: KnowledgeGap[]): string;
+//# sourceMappingURL=meta-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-memory.d.ts","sourceRoot":"","sources":["../../src/memory/meta-memory.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,GACtB,YAAY,EAAE,CA8ChB;AAED,0CAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAahE"}

package/dist/memory/meta-memory.js

@@ -0,0 +1,141 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectKnowledgeGaps = detectKnowledgeGaps;
+exports.formatKnowledgeGaps = formatKnowledgeGaps;
+/**
+ * Meta-Memory — Knows what the brain DOESN'T know.
+ *
+ * Scans the project's source files and compares against stored memories.
+ * Files/directories with zero memories = knowledge gaps.
+ *
+ * Like how a student knows "I haven't studied chapter 5 yet" —
+ * self-awareness about what's missing is as important as what's known.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Detect knowledge gaps in the project */
+function detectKnowledgeGaps(memoryStore, workspaceRoot) {
+    const gaps = [];
+    // Get all memories' related files
+    const knownFiles = new Set();
+    const active = memoryStore.getActive(500);
+    for (const m of active) {
+        if (m.relatedFiles) {
+            for (const f of m.relatedFiles) {
+                knownFiles.add(normalize(f));
+            }
+        }
+        // Also check intent for file references
+        const fileRefs = m.intent.match(/[\w\-\/]+\.(ts|js|tsx|jsx|py|css|json|sql)/g);
+        if (fileRefs) {
+            for (const ref of fileRefs) {
+                knownFiles.add(normalize(ref));
+            }
+        }
+    }
+    // Scan project source directories
+    const srcDirs = ['src', 'lib', 'app', 'pages', 'components', 'api', 'server'];
+    for (const dir of srcDirs) {
+        const dirPath = path.join(workspaceRoot, dir);
+        if (!fs.existsSync(dirPath))
+            continue;
+        const files = getSourceFiles(dirPath, workspaceRoot);
+        const unknownFiles = files.filter(f => !knownFiles.has(normalize(f)));
+        if (unknownFiles.length > 0 && unknownFiles.length === files.length) {
+            // Entire directory unknown
+            gaps.push({
+                path: dir,
+                type: 'directory',
+                fileCount: unknownFiles.length,
+            });
+        }
+        else if (unknownFiles.length > 2) {
+            // Some files unknown
+            for (const f of unknownFiles.slice(0, 5)) {
+                gaps.push({ path: f, type: 'file' });
+            }
+        }
+    }
+    return gaps.slice(0, 10); // Limit to top 10 gaps
+}
+/** Format knowledge gaps for injection */
+function formatKnowledgeGaps(gaps) {
+    if (gaps.length === 0)
+        return '';
+    const lines = ['## 🧩 Knowledge Gaps (no memories about these)'];
+    for (const gap of gaps) {
+        if (gap.type === 'directory') {
+            lines.push(`- 📁 **${gap.path}/** (${gap.fileCount} files, no context)`);
+        }
+        else {
+            lines.push(`- 📄 ${gap.path}`);
+        }
+    }
+    lines.push('\n> *Consider running `scan_project` or explaining these areas to build context.*');
+    return lines.join('\n');
+}
+/** Get source files from a directory */
+function getSourceFiles(dir, root, depth = 0) {
+    if (depth > 3)
+        return [];
+    const ignore = new Set(['node_modules', '.git', 'dist', 'coverage', '__tests__', '__mocks__', '.next']);
+    const exts = new Set(['.ts', '.js', '.tsx', '.jsx', '.py', '.css', '.sql']);
+    const files = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (ignore.has(entry.name) || entry.name.startsWith('.'))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...getSourceFiles(full, root, depth + 1));
+            }
+            else {
+                const ext = path.extname(entry.name);
+                if (exts.has(ext) && !entry.name.endsWith('.d.ts')) {
+                    files.push(path.relative(root, full).replace(/\\/g, '/'));
+                }
+            }
+        }
+    }
+    catch { }
+    return files;
+}
+/** Normalize file paths for comparison */
+function normalize(filePath) {
+    return filePath.toLowerCase().replace(/\\/g, '/').replace(/^\.\//, '');
+}
+//# sourceMappingURL=meta-memory.js.map

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

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

package/dist/memory/session-tracker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Session Tracker — Automatically builds session summaries.
+ *
+ * Tracks what was discussed, what files were changed, what decisions were made,
+ * and what's unfinished. Stores a compressed session summary when the session ends.
+ *
+ * This is the key missing piece that prevents "where did we leave off?" re-explanation.
+ */
+import { MemoryStore } from '../db/memory-store';
+export interface SessionData {
+    startTime: number;
+    topics: Set<string>;
+    decisions: string[];
+    filesChanged: Set<string>;
+    failedAttempts: string[];
+    businessRules: string[];
+    gotchas: string[];
+    currentTasks: string[];
+    autoLearnCount: number;
+    lastUpdateTime: number;
+}
+export declare function startSession(): void;
+export declare function getSession(): SessionData | null;
+/** Feed data into the running session — called by auto_learn and other tools */
+export declare function feedSession(data: {
+    topic?: string;
+    decision?: string;
+    fileChanged?: string;
+    failedAttempt?: string;
+    businessRule?: string;
+    gotcha?: string;
+    currentTask?: string;
+    type?: string;
+}): void;
+/** Build and store the session summary */
+export declare function endSession(memoryStore: MemoryStore): string | null;
+/** Get the last N session summaries for injection at conversation start */
+export declare function getRecentSessions(memoryStore: MemoryStore, count?: number): string[];
+//# sourceMappingURL=session-tracker.d.ts.map

package/dist/memory/session-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.d.ts","sourceRoot":"","sources":["../../src/memory/session-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,YAAY,IAAI,IAAI,CAanC;AAED,wBAAgB,UAAU,IAAI,WAAW,GAAG,IAAI,CAE/C;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAaP;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CA+DlE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CA2BvF"}