@timmeck/brain-core 2.36.85 → 2.36.87

package/dist/memory/retrieval-maintenance.js

@@ -0,0 +1,201 @@
+// ── Retrieval Maintenance Engine ──────────────────────────
+//
+// Offline maintenance for memory retrieval quality.
+// Runs periodically (every 2h) to:
+//   1. Mark cold memories as archive candidates
+//   2. Build pre-computed candidate sets for fast typed retrieval
+//
+// Design principle (ChatGPT): "Retrieval online einfach halten, Struktur offline pflegen."
+import { getLogger } from '../utils/logger.js';
+// ── Intent Definitions ────────────────────────────────────
+const INTENT_DEFINITIONS = {
+    decision_lookup: { categories: ['decision'], minImportance: 3 },
+    project_context: { categories: ['context', 'fact'], minImportance: 3 },
+    user_preference_lookup: { categories: ['preference', 'constraint'], minImportance: 2 },
+    open_problem_lookup: { categories: ['open_question', 'goal'], minImportance: 2 },
+};
+// ── Engine ────────────────────────────────────────────────
+export class RetrievalMaintenanceEngine {
+    db;
+    config;
+    log = getLogger();
+    timer = null;
+    totalRuns = 0;
+    lastRunAt = null;
+    constructor(db, config = {}) {
+        this.db = db;
+        this.config = {
+            coldThresholdDays: config.coldThresholdDays ?? 30,
+            minImportanceForProtection: config.minImportanceForProtection ?? 4,
+            candidateSetSize: config.candidateSetSize ?? 50,
+        };
+        this.ensureTable();
+    }
+    /** Start periodic maintenance (default: every 2h). */
+    start(intervalMs = 2 * 60 * 60 * 1000) {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            try {
+                this.runMaintenance();
+            }
+            catch (err) {
+                this.log.debug(`[retrieval-maintenance] Cycle error: ${err.message}`);
+            }
+        }, intervalMs);
+        this.log.info(`[retrieval-maintenance] Started (interval: ${Math.round(intervalMs / 3600000)}h)`);
+    }
+    /** Stop periodic maintenance. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            this.log.info('[retrieval-maintenance] Stopped');
+        }
+    }
+    /** Main cycle — call periodically (every 2h). */
+    runMaintenance() {
+        const start = Date.now();
+        const archiveCandidatesMarked = this.markArchiveCandidates();
+        const candidateReport = this.refreshCandidateSets();
+        this.totalRuns++;
+        this.lastRunAt = new Date().toISOString();
+        const durationMs = Date.now() - start;
+        this.log.info(`[retrieval-maintenance] Run #${this.totalRuns}: ${archiveCandidatesMarked} archive candidates, ${candidateReport.setsCreated} sets refreshed (${durationMs}ms)`);
+        return {
+            archiveCandidatesMarked,
+            candidateSetsRefreshed: candidateReport.setsCreated,
+            durationMs,
+        };
+    }
+    /**
+     * Cold Memory Detection.
+     * Mark as archive_candidate = 1 when:
+     * - created_at > coldThresholdDays AND
+     * - access_count = 0 AND use_count = 0 AND
+     * - importance < minImportanceForProtection
+     *
+     * Safety: No automatic deletion, only marking.
+     */
+    markArchiveCandidates() {
+        try {
+            // Reset existing candidates that no longer qualify (accessed since last run)
+            this.db.prepare(`
+        UPDATE conversation_memories SET archive_candidate = 0
+        WHERE archive_candidate = 1 AND (access_count > 0 OR use_count > 0 OR importance >= ?)
+      `).run(this.config.minImportanceForProtection);
+            // Mark new cold memories
+            const result = this.db.prepare(`
+        UPDATE conversation_memories SET archive_candidate = 1
+        WHERE active = 1
+          AND archive_candidate = 0
+          AND created_at < datetime('now', '-' || ? || ' days')
+          AND access_count = 0
+          AND use_count = 0
+          AND importance < ?
+      `).run(this.config.coldThresholdDays, this.config.minImportanceForProtection);
+            return result.changes;
+        }
+        catch (err) {
+            this.log.debug(`[retrieval-maintenance] markArchiveCandidates error: ${err.message}`);
+            return 0;
+        }
+    }
+    /** Refresh pre-computed candidate sets for typed retrieval. */
+    refreshCandidateSets() {
+        let setsCreated = 0;
+        let totalMemories = 0;
+        // Per-category sets
+        const categories = ['preference', 'decision', 'context', 'fact', 'goal', 'lesson', 'constraint', 'open_question'];
+        for (const cat of categories) {
+            const count = this.buildCandidateSet('category', cat, [cat]);
+            if (count > 0) {
+                setsCreated++;
+                totalMemories += count;
+            }
+        }
+        // Per-intent sets
+        for (const [intent, def] of Object.entries(INTENT_DEFINITIONS)) {
+            const count = this.buildCandidateSet('intent', intent, def.categories, def.minImportance);
+            if (count > 0) {
+                setsCreated++;
+                totalMemories += count;
+            }
+        }
+        return { setsCreated, totalMemories };
+    }
+    /** Get current status. */
+    getStatus() {
+        let totalArchiveCandidates = 0;
+        let candidateSets = 0;
+        try {
+            const archiveRow = this.db.prepare('SELECT COUNT(*) as cnt FROM conversation_memories WHERE archive_candidate = 1').get();
+            totalArchiveCandidates = archiveRow?.cnt ?? 0;
+        }
+        catch { /* table may not have column yet */ }
+        try {
+            const setsRow = this.db.prepare('SELECT COUNT(*) as cnt FROM retrieval_candidate_sets').get();
+            candidateSets = setsRow?.cnt ?? 0;
+        }
+        catch { /* table may not exist */ }
+        return {
+            lastRunAt: this.lastRunAt,
+            totalRuns: this.totalRuns,
+            totalArchiveCandidates,
+            candidateSets,
+        };
+    }
+    /** Get a candidate set by type and key. Returns memory IDs. */
+    getCandidateSet(setType, setKey) {
+        try {
+            const row = this.db.prepare('SELECT memory_ids FROM retrieval_candidate_sets WHERE set_type = ? AND set_key = ?').get(setType, setKey);
+            if (!row)
+                return [];
+            return JSON.parse(row.memory_ids);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ── Private ─────────────────────────────────────────────
+    ensureTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS retrieval_candidate_sets (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        set_type TEXT NOT NULL,
+        set_key TEXT NOT NULL,
+        memory_ids TEXT NOT NULL DEFAULT '[]',
+        set_size INTEGER NOT NULL DEFAULT 0,
+        refreshed_at TEXT DEFAULT (datetime('now')),
+        UNIQUE(set_type, set_key)
+      );
+    `);
+    }
+    buildCandidateSet(setType, setKey, categories, minImportance = 1) {
+        try {
+            const placeholders = categories.map(() => '?').join(',');
+            const rows = this.db.prepare(`
+        SELECT id FROM conversation_memories
+        WHERE active = 1
+          AND archive_candidate = 0
+          AND category IN (${placeholders})
+          AND importance >= ?
+        ORDER BY importance DESC, use_count DESC, access_count DESC
+        LIMIT ?
+      `).all(...categories, minImportance, this.config.candidateSetSize);
+            const ids = rows.map(r => r.id);
+            this.db.prepare(`
+        INSERT INTO retrieval_candidate_sets (set_type, set_key, memory_ids, set_size, refreshed_at)
+        VALUES (?, ?, ?, ?, datetime('now'))
+        ON CONFLICT(set_type, set_key)
+        DO UPDATE SET memory_ids = excluded.memory_ids, set_size = excluded.set_size, refreshed_at = datetime('now')
+      `).run(setType, setKey, JSON.stringify(ids), ids.length);
+            return ids.length;
+        }
+        catch (err) {
+            this.log.debug(`[retrieval-maintenance] buildCandidateSet error for ${setType}/${setKey}: ${err.message}`);
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=retrieval-maintenance.js.map

package/dist/memory/retrieval-maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-maintenance.js","sourceRoot":"","sources":["../../src/memory/retrieval-maintenance.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,oDAAoD;AACpD,mCAAmC;AACnC,gDAAgD;AAChD,kEAAkE;AAClE,EAAE;AACF,2FAA2F;AAG3F,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA+B/C,6DAA6D;AAE7D,MAAM,kBAAkB,GAAoE;IAC1F,eAAe,EAAE,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;IAC/D,eAAe,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;IACtE,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;IACtF,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;CACjF,CAAC;AAEF,6DAA6D;AAE7D,MAAM,OAAO,0BAA0B;IACpB,EAAE,CAAoB;IACtB,MAAM,CAAuC;IAC7C,GAAG,GAAG,SAAS,EAAE,CAAC;IAC3B,KAAK,GAA0C,IAAI,CAAC;IACpD,SAAS,GAAG,CAAC,CAAC;IACd,SAAS,GAAkB,IAAI,CAAC;IAExC,YAAY,EAAqB,EAAE,SAAqC,EAAE;QACxE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG;YACZ,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,EAAE;YACjD,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,CAAC;YAClE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,EAAE;SAChD,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACnC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wCAAyC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,8CAA8C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,CAAC;IAED,iCAAiC;IACjC,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,cAAc;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,MAAM,uBAAuB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAEpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE1C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,KAAK,uBAAuB,wBAAwB,eAAe,CAAC,WAAW,oBAAoB,UAAU,KAAK,CAAC,CAAC;QAEhL,OAAO;YACL,uBAAuB;YACvB,sBAAsB,EAAE,eAAe,CAAC,WAAW;YACnD,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,qBAAqB;QACnB,IAAI,CAAC;YACH,6EAA6E;YAC7E,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAGf,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;YAE/C,yBAAyB;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;OAQ9B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;YAE9E,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wDAAyD,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACjG,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,oBAAoB;QAClB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,oBAAoB;QACpB,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QAClH,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAAC,WAAW,EAAE,CAAC;gBAAC,aAAa,IAAI,KAAK,CAAC;YAAC,CAAC;QAC3D,CAAC;QAED,kBAAkB;QAClB,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC1F,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAAC,WAAW,EAAE,CAAC;gBAAC,aAAa,IAAI,KAAK,CAAC;YAAC,CAAC;QAC3D,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,0BAA0B;IAC1B,SAAS;QACP,IAAI,sBAAsB,GAAG,CAAC,CAAC;QAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAChC,+EAA+E,CAChF,CAAC,GAAG,EAAiC,CAAC;YACvC,sBAAsB,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC,CAAC,mCAAmC,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC7B,sDAAsD,CACvD,CAAC,GAAG,EAAiC,CAAC;YACvC,aAAa,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAErC,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,sBAAsB;YACtB,aAAa;SACd,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,eAAe,CAAC,OAAe,EAAE,MAAc;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,oFAAoF,CACrF,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAuC,CAAC;YAC7D,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,2DAA2D;IAEnD,WAAW;QACjB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;KAUZ,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,OAAe,EAAE,MAAc,EAAE,UAAoB,EAAE,aAAa,GAAG,CAAC;QAChG,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;6BAIN,YAAY;;;;OAIlC,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAA0B,CAAC;YAE5F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEhC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;OAKf,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAEzD,OAAO,GAAG,CAAC,MAAM,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uDAAuD,OAAO,IAAI,MAAM,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACtH,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/memory/types.d.ts

@@ -1,4 +1,4 @@
-export type MemoryCategory = 'preference' | 'decision' | 'context' | 'fact' | 'goal' | 'lesson';
+export type MemoryCategory = 'preference' | 'decision' | 'context' | 'fact' | 'goal' | 'lesson' | 'constraint' | 'open_question';
 export type MemorySource = 'explicit' | 'inferred' | 'hook';
 export type SessionOutcome = 'completed' | 'paused' | 'abandoned';
 export interface MemoryRecord {

package/dist/retention/index.d.ts

@@ -0,0 +1,2 @@
+export { RetentionPolicyEngine } from './retention-engine.js';
+export type { RetentionConfig, RetentionReport, RetentionStatus, TableReport, ProtectionSummary, TableSizeInfo, } from './retention-engine.js';

package/dist/retention/index.js

@@ -0,0 +1,2 @@
+export { RetentionPolicyEngine } from './retention-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/retention/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/retention/retention-engine.d.ts

@@ -0,0 +1,77 @@
+/**
+ * RetentionPolicyEngine — intelligent DB cleanup with protection rules.
+ * Targets: rag_vectors (cache TTL), conversation_memories (value-based),
+ * compressed_clusters (age TTL), insights (lifecycle supplement).
+ *
+ * Every method supports dry-run (count only) or live (actual DELETE).
+ */
+import type Database from 'better-sqlite3';
+export interface RetentionConfig {
+    /** rag_vectors TTL in days. Default: 30 */
+    ragVectorTTLDays: number;
+    /** Minimum importance for vector protection. Default: 6 */
+    ragVectorProtectionImportance: number;
+    /** conversation_memories: days without access + low importance. Default: 90 */
+    memoryTTLDays: number;
+    /** Minimum importance for memory protection. Default: 4 */
+    memoryProtectionImportance: number;
+    /** compressed_clusters TTL. Default: 60 */
+    clusterTTLDays: number;
+    /** insights: archived insights TTL. Default: 120 */
+    insightTTLDays: number;
+    /** Max rows per batch (safety). Default: 10000 */
+    batchLimit: number;
+}
+export interface TableReport {
+    before: number;
+    affected: number;
+    protected: number;
+    estimatedMB: number;
+}
+export interface ProtectionSummary {
+    byImportance: number;
+    byUseCount: number;
+    byReferences: number;
+    byConsolidation: number;
+}
+export interface RetentionReport {
+    dryRun: boolean;
+    timestamp: string;
+    tables: {
+        rag_vectors: TableReport;
+        conversation_memories: TableReport;
+        compressed_clusters: TableReport;
+        insights: TableReport;
+    };
+    totalRowsAffected: number;
+    estimatedSpaceMB: number;
+    protectedRows: ProtectionSummary;
+    durationMs: number;
+}
+export interface TableSizeInfo {
+    table: string;
+    rowCount: number;
+    estimatedMB: number;
+}
+export interface RetentionStatus {
+    totalRuns: number;
+    lastReport: RetentionReport | null;
+    config: RetentionConfig;
+}
+export declare class RetentionPolicyEngine {
+    private readonly db;
+    private readonly config;
+    private readonly log;
+    private lastReport;
+    private totalRuns;
+    constructor(db: Database.Database, config?: Partial<RetentionConfig>);
+    run(dryRun?: boolean): RetentionReport;
+    cleanRagVectors(dryRun: boolean, protectedRows?: ProtectionSummary): TableReport;
+    cleanMemories(dryRun: boolean, protectedRows?: ProtectionSummary): TableReport;
+    cleanClusters(dryRun: boolean): TableReport;
+    cleanInsights(dryRun: boolean): TableReport;
+    getStatus(): RetentionStatus;
+    getLastReport(): RetentionReport | null;
+    getTableSizes(): TableSizeInfo[];
+    private countRows;
+}

package/dist/retention/retention-engine.js

@@ -0,0 +1,325 @@
+import { getLogger } from '../utils/logger.js';
+const DEFAULT_CONFIG = {
+    ragVectorTTLDays: 30,
+    ragVectorProtectionImportance: 6,
+    memoryTTLDays: 90,
+    memoryProtectionImportance: 4,
+    clusterTTLDays: 60,
+    insightTTLDays: 120,
+    batchLimit: 10_000,
+};
+// ── Engine ──────────────────────────────────────────────────
+export class RetentionPolicyEngine {
+    db;
+    config;
+    log = getLogger();
+    lastReport = null;
+    totalRuns = 0;
+    constructor(db, config) {
+        this.db = db;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ── Main Entry ────────────────────────────────────────────
+    run(dryRun = true) {
+        const start = Date.now();
+        const protectedRows = { byImportance: 0, byUseCount: 0, byReferences: 0, byConsolidation: 0 };
+        const ragReport = this.cleanRagVectors(dryRun, protectedRows);
+        const memReport = this.cleanMemories(dryRun, protectedRows);
+        const clusterReport = this.cleanClusters(dryRun);
+        const insightReport = this.cleanInsights(dryRun);
+        const report = {
+            dryRun,
+            timestamp: new Date().toISOString(),
+            tables: {
+                rag_vectors: ragReport,
+                conversation_memories: memReport,
+                compressed_clusters: clusterReport,
+                insights: insightReport,
+            },
+            totalRowsAffected: ragReport.affected + memReport.affected + clusterReport.affected + insightReport.affected,
+            estimatedSpaceMB: +(ragReport.estimatedMB + memReport.estimatedMB + clusterReport.estimatedMB + insightReport.estimatedMB).toFixed(2),
+            protectedRows,
+            durationMs: Date.now() - start,
+        };
+        this.lastReport = report;
+        this.totalRuns++;
+        const mode = dryRun ? 'DRY-RUN' : 'LIVE';
+        this.log.info(`[retention] ${mode}: ${report.totalRowsAffected} rows affected (~${report.estimatedSpaceMB} MB), ${report.durationMs}ms`);
+        return report;
+    }
+    // ── rag_vectors ───────────────────────────────────────────
+    cleanRagVectors(dryRun, protectedRows) {
+        const cfg = this.config;
+        const before = this.countRows('rag_vectors');
+        // Protected: vectors linked to important/active/used memories
+        // We need to check if conversation_memories table exists and has the right columns
+        let protectedCount = 0;
+        try {
+            // Count vectors whose linked memory is protected (importance >= threshold OR use_count > 0 OR active+not-archive)
+            const protectedRow = this.db.prepare(`
+        SELECT COUNT(DISTINCT rv.id) as cnt FROM rag_vectors rv
+        INNER JOIN conversation_memories cm ON rv.source_id = cm.id AND rv.collection = 'conversation_memories'
+        WHERE rv.created_at < datetime('now', ?)
+          AND (cm.importance >= ? OR cm.use_count > 0 OR (cm.active = 1 AND cm.archive_candidate = 0))
+      `).get(`-${cfg.ragVectorTTLDays} days`, cfg.ragVectorProtectionImportance);
+            protectedCount = protectedRow?.cnt ?? 0;
+            if (protectedRows) {
+                // Break down protection reasons
+                const byImp = this.db.prepare(`
+          SELECT COUNT(DISTINCT rv.id) as cnt FROM rag_vectors rv
+          INNER JOIN conversation_memories cm ON rv.source_id = cm.id AND rv.collection = 'conversation_memories'
+          WHERE rv.created_at < datetime('now', ?) AND cm.importance >= ?
+        `).get(`-${cfg.ragVectorTTLDays} days`, cfg.ragVectorProtectionImportance);
+                protectedRows.byImportance += byImp?.cnt ?? 0;
+                const byUse = this.db.prepare(`
+          SELECT COUNT(DISTINCT rv.id) as cnt FROM rag_vectors rv
+          INNER JOIN conversation_memories cm ON rv.source_id = cm.id AND rv.collection = 'conversation_memories'
+          WHERE rv.created_at < datetime('now', ?) AND cm.use_count > 0
+        `).get(`-${cfg.ragVectorTTLDays} days`);
+                protectedRows.byUseCount += byUse?.cnt ?? 0;
+            }
+        }
+        catch {
+            // conversation_memories table may not exist — skip protection checks
+        }
+        // Deletable: old vectors NOT linked to important memories
+        // Strategy: delete old vectors where linked memory is deleted/inactive/low-importance+unused
+        let affected = 0;
+        try {
+            if (dryRun) {
+                const row = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM rag_vectors rv
+          WHERE rv.created_at < datetime('now', ?)
+            AND NOT EXISTS (
+              SELECT 1 FROM conversation_memories cm
+              WHERE cm.id = rv.source_id AND rv.collection = 'conversation_memories'
+                AND (cm.importance >= ? OR cm.use_count > 0 OR (cm.active = 1 AND cm.archive_candidate = 0))
+            )
+          LIMIT ?
+        `).get(`-${cfg.ragVectorTTLDays} days`, cfg.ragVectorProtectionImportance, cfg.batchLimit);
+                // The LIMIT in subquery doesn't work for COUNT, use a different approach
+                const countRow = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM (
+            SELECT rv.id FROM rag_vectors rv
+            WHERE rv.created_at < datetime('now', ?)
+              AND NOT EXISTS (
+                SELECT 1 FROM conversation_memories cm
+                WHERE cm.id = rv.source_id AND rv.collection = 'conversation_memories'
+                  AND (cm.importance >= ? OR cm.use_count > 0 OR (cm.active = 1 AND cm.archive_candidate = 0))
+              )
+            LIMIT ?
+          )
+        `).get(`-${cfg.ragVectorTTLDays} days`, cfg.ragVectorProtectionImportance, cfg.batchLimit);
+                affected = countRow.cnt;
+            }
+            else {
+                const result = this.db.prepare(`
+          DELETE FROM rag_vectors WHERE id IN (
+            SELECT rv.id FROM rag_vectors rv
+            WHERE rv.created_at < datetime('now', ?)
+              AND NOT EXISTS (
+                SELECT 1 FROM conversation_memories cm
+                WHERE cm.id = rv.source_id AND rv.collection = 'conversation_memories'
+                  AND (cm.importance >= ? OR cm.use_count > 0 OR (cm.active = 1 AND cm.archive_candidate = 0))
+              )
+            LIMIT ?
+          )
+        `).run(`-${cfg.ragVectorTTLDays} days`, cfg.ragVectorProtectionImportance, cfg.batchLimit);
+                affected = Number(result.changes);
+            }
+        }
+        catch (err) {
+            this.log.debug(`[retention] rag_vectors cleanup skipped: ${err.message}`);
+        }
+        // Estimate ~10KB per vector (embedding blob + metadata)
+        return { before, affected, protected: protectedCount, estimatedMB: +(affected * 10 / 1024).toFixed(2) };
+    }
+    // ── conversation_memories ─────────────────────────────────
+    cleanMemories(dryRun, protectedRows) {
+        const cfg = this.config;
+        const before = this.countRows('conversation_memories');
+        // Count protected rows (meeting any protection criterion but past TTL)
+        let protectedCount = 0;
+        try {
+            const protectedRow = this.db.prepare(`
+        SELECT COUNT(*) as cnt FROM conversation_memories
+        WHERE archive_candidate = 1
+          AND created_at < datetime('now', ?)
+          AND (importance >= ? OR use_count > 0 OR source = 'inferred'
+               OR (access_count > 0 AND last_accessed_at > datetime('now', '-30 days')))
+      `).get(`-${cfg.memoryTTLDays} days`, cfg.memoryProtectionImportance);
+            protectedCount = protectedRow.cnt;
+            if (protectedRows) {
+                const byImp = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM conversation_memories
+          WHERE archive_candidate = 1 AND created_at < datetime('now', ?) AND importance >= ?
+        `).get(`-${cfg.memoryTTLDays} days`, cfg.memoryProtectionImportance);
+                protectedRows.byImportance += byImp.cnt;
+                const byUse = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM conversation_memories
+          WHERE archive_candidate = 1 AND created_at < datetime('now', ?) AND use_count > 0
+        `).get(`-${cfg.memoryTTLDays} days`);
+                protectedRows.byUseCount += byUse.cnt;
+                const byRef = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM conversation_memories
+          WHERE archive_candidate = 1 AND created_at < datetime('now', ?)
+            AND access_count > 0 AND last_accessed_at > datetime('now', '-30 days')
+        `).get(`-${cfg.memoryTTLDays} days`);
+                protectedRows.byReferences += byRef.cnt;
+                const byCons = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM conversation_memories
+          WHERE archive_candidate = 1 AND created_at < datetime('now', ?) AND source = 'inferred'
+        `).get(`-${cfg.memoryTTLDays} days`);
+                protectedRows.byConsolidation += byCons.cnt;
+            }
+        }
+        catch {
+            // table may not exist
+        }
+        // Deletable: archive_candidate=1, past TTL, no protection criteria met
+        let affected = 0;
+        try {
+            if (dryRun) {
+                const row = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM (
+            SELECT id FROM conversation_memories
+            WHERE archive_candidate = 1
+              AND created_at < datetime('now', ?)
+              AND importance < ?
+              AND use_count = 0
+              AND source != 'inferred'
+              AND NOT (access_count > 0 AND last_accessed_at > datetime('now', '-30 days'))
+            LIMIT ?
+          )
+        `).get(`-${cfg.memoryTTLDays} days`, cfg.memoryProtectionImportance, cfg.batchLimit);
+                affected = row.cnt;
+            }
+            else {
+                const result = this.db.prepare(`
+          DELETE FROM conversation_memories WHERE id IN (
+            SELECT id FROM conversation_memories
+            WHERE archive_candidate = 1
+              AND created_at < datetime('now', ?)
+              AND importance < ?
+              AND use_count = 0
+              AND source != 'inferred'
+              AND NOT (access_count > 0 AND last_accessed_at > datetime('now', '-30 days'))
+            LIMIT ?
+          )
+        `).run(`-${cfg.memoryTTLDays} days`, cfg.memoryProtectionImportance, cfg.batchLimit);
+                affected = Number(result.changes);
+            }
+        }
+        catch (err) {
+            this.log.debug(`[retention] conversation_memories cleanup skipped: ${err.message}`);
+        }
+        // Estimate ~3KB per memory row (content + tags + metadata)
+        return { before, affected, protected: protectedCount, estimatedMB: +(affected * 3 / 1024).toFixed(2) };
+    }
+    // ── compressed_clusters ───────────────────────────────────
+    cleanClusters(dryRun) {
+        const cfg = this.config;
+        const before = this.countRows('compressed_clusters');
+        let affected = 0;
+        try {
+            if (dryRun) {
+                const row = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM (
+            SELECT id FROM compressed_clusters
+            WHERE created_at < datetime('now', ?)
+            LIMIT ?
+          )
+        `).get(`-${cfg.clusterTTLDays} days`, cfg.batchLimit);
+                affected = row.cnt;
+            }
+            else {
+                const result = this.db.prepare(`
+          DELETE FROM compressed_clusters WHERE id IN (
+            SELECT id FROM compressed_clusters
+            WHERE created_at < datetime('now', ?)
+            LIMIT ?
+          )
+        `).run(`-${cfg.clusterTTLDays} days`, cfg.batchLimit);
+                affected = Number(result.changes);
+            }
+        }
+        catch (err) {
+            this.log.debug(`[retention] compressed_clusters cleanup skipped: ${err.message}`);
+        }
+        // Estimate ~2KB per cluster (summary + member_ids JSON)
+        return { before, affected, protected: 0, estimatedMB: +(affected * 2 / 1024).toFixed(2) };
+    }
+    // ── insights (supplement to lifecycle.ts) ─────────────────
+    cleanInsights(dryRun) {
+        const cfg = this.config;
+        const before = this.countRows('insights');
+        let affected = 0;
+        try {
+            if (dryRun) {
+                const row = this.db.prepare(`
+          SELECT COUNT(*) as cnt FROM (
+            SELECT id FROM insights
+            WHERE lifecycle = 'archived' AND created_at < datetime('now', ?)
+            LIMIT ?
+          )
+        `).get(`-${cfg.insightTTLDays} days`, cfg.batchLimit);
+                affected = row.cnt;
+            }
+            else {
+                const result = this.db.prepare(`
+          DELETE FROM insights WHERE id IN (
+            SELECT id FROM insights
+            WHERE lifecycle = 'archived' AND created_at < datetime('now', ?)
+            LIMIT ?
+          )
+        `).run(`-${cfg.insightTTLDays} days`, cfg.batchLimit);
+                affected = Number(result.changes);
+            }
+        }
+        catch (err) {
+            this.log.debug(`[retention] insights cleanup skipped: ${err.message}`);
+        }
+        // Estimate ~1KB per insight
+        return { before, affected, protected: 0, estimatedMB: +(affected * 1 / 1024).toFixed(2) };
+    }
+    // ── Status & Reports ──────────────────────────────────────
+    getStatus() {
+        return {
+            totalRuns: this.totalRuns,
+            lastReport: this.lastReport,
+            config: { ...this.config },
+        };
+    }
+    getLastReport() {
+        return this.lastReport;
+    }
+    getTableSizes() {
+        const tables = ['rag_vectors', 'conversation_memories', 'compressed_clusters', 'insights'];
+        const sizes = [];
+        for (const table of tables) {
+            const rowCount = this.countRows(table);
+            // Estimate per-row sizes
+            const kbPerRow = table === 'rag_vectors' ? 10
+                : table === 'conversation_memories' ? 3
+                    : table === 'compressed_clusters' ? 2
+                        : 1;
+            sizes.push({
+                table,
+                rowCount,
+                estimatedMB: +(rowCount * kbPerRow / 1024).toFixed(2),
+            });
+        }
+        return sizes;
+    }
+    // ── Helpers ───────────────────────────────────────────────
+    countRows(table) {
+        try {
+            const row = this.db.prepare(`SELECT COUNT(*) as cnt FROM ${table}`).get();
+            return row?.cnt ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=retention-engine.js.map

package/dist/retention/retention-engine.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "2.36.85",
+  "version": "2.36.87",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",