claude-cortex 1.0.0

package/dist/worker/brain-worker.js

@@ -0,0 +1,261 @@
+/**
+ * Brain Worker
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Background worker that performs brain-like maintenance operations:
+ * - Light tick (5 min): Prune activation cache, check predictive consolidation
+ * - Medium tick (30 min): Discover missing links, scan for contradictions
+ *
+ * This transforms the memory system from reactive to continuously organic.
+ */
+import { DEFAULT_WORKER_CONFIG, } from './types.js';
+import { pruneActivationCache } from '../memory/activation.js';
+import { getMemoryStats } from '../memory/store.js';
+import { consolidate } from '../memory/consolidate.js';
+import { detectContradictions, linkContradictions, } from '../memory/contradiction.js';
+import { discoverMissingLinks, findUnlinkedMemories } from './link-discovery.js';
+import { shouldTriggerPredictiveConsolidation } from './predictive-consolidation.js';
+import { emitWorkerLightTick, emitWorkerMediumTick, emitPredictiveConsolidation, } from '../api/events.js';
+/**
+ * Brain Worker Class
+ *
+ * Manages background processing timers and operations.
+ * Designed to be started by the visualization server and run continuously.
+ */
+export class BrainWorker {
+    lightTimer = null;
+    mediumTimer = null;
+    isRunning = false;
+    config;
+    // Statistics tracking
+    stats = {
+        lightTicks: 0,
+        mediumTicks: 0,
+        consolidations: 0,
+    };
+    // Timestamps
+    lastLightTick = null;
+    lastMediumTick = null;
+    lastConsolidation = null;
+    /**
+     * Create a new BrainWorker
+     *
+     * @param config - Partial configuration to override defaults
+     */
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_WORKER_CONFIG, ...config };
+    }
+    /**
+     * Start the background worker
+     * Sets up interval timers for light and medium ticks
+     */
+    start() {
+        if (this.isRunning) {
+            console.log('[BrainWorker] Already running');
+            return;
+        }
+        this.isRunning = true;
+        console.log('[BrainWorker] Starting background worker');
+        console.log(`[BrainWorker] Light tick interval: ${this.config.lightTickIntervalMs / 1000}s`);
+        console.log(`[BrainWorker] Medium tick interval: ${this.config.mediumTickIntervalMs / 1000}s`);
+        // Light tick every 5 minutes (by default)
+        this.lightTimer = setInterval(() => this.lightTick(), this.config.lightTickIntervalMs);
+        // Medium tick every 30 minutes (by default)
+        this.mediumTimer = setInterval(() => this.mediumTick(), this.config.mediumTickIntervalMs);
+        // Run initial light tick after a short delay (10 seconds)
+        // This allows the server to fully initialize first
+        setTimeout(() => {
+            if (this.isRunning) {
+                this.lightTick();
+            }
+        }, 10000);
+    }
+    /**
+     * Stop the background worker
+     * Clears all interval timers
+     */
+    stop() {
+        if (!this.isRunning) {
+            console.log('[BrainWorker] Not running');
+            return;
+        }
+        this.isRunning = false;
+        if (this.lightTimer) {
+            clearInterval(this.lightTimer);
+            this.lightTimer = null;
+        }
+        if (this.mediumTimer) {
+            clearInterval(this.mediumTimer);
+            this.mediumTimer = null;
+        }
+        console.log('[BrainWorker] Stopped');
+    }
+    /**
+     * Check if the worker is currently running
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * Light tick - runs every 5 minutes
+     *
+     * Operations:
+     * 1. Prune stale activation cache entries
+     * 2. Check if predictive consolidation should run
+     */
+    async lightTick() {
+        const result = {
+            activationsPruned: 0,
+            predictiveConsolidation: null,
+            timestamp: new Date(),
+        };
+        try {
+            // 1. Prune activation cache
+            result.activationsPruned = pruneActivationCache();
+            // 2. Check if predictive consolidation is needed
+            const stats = getMemoryStats();
+            const decision = shouldTriggerPredictiveConsolidation(stats, this.config);
+            if (decision.shouldRun) {
+                console.log(`[BrainWorker] Predictive consolidation triggered: ${decision.reason}`);
+                result.predictiveConsolidation = consolidate();
+                this.lastConsolidation = new Date();
+                this.stats.consolidations++;
+                // Emit event for dashboard
+                emitPredictiveConsolidation({
+                    trigger: decision.reason,
+                    urgency: decision.urgency,
+                    result: result.predictiveConsolidation,
+                });
+            }
+            // Update stats
+            this.lastLightTick = result.timestamp;
+            this.stats.lightTicks++;
+            // Emit light tick event
+            emitWorkerLightTick(result);
+            // Log summary
+            if (result.activationsPruned > 0 || result.predictiveConsolidation) {
+                console.log(`[BrainWorker] Light tick: pruned ${result.activationsPruned} activations` +
+                    (result.predictiveConsolidation
+                        ? `, consolidated ${result.predictiveConsolidation.consolidated}`
+                        : ''));
+            }
+        }
+        catch (e) {
+            console.error('[BrainWorker] Light tick failed:', e);
+        }
+        return result;
+    }
+    /**
+     * Medium tick - runs every 30 minutes
+     *
+     * Operations:
+     * 1. Discover and create missing links
+     * 2. Scan for contradictions
+     */
+    async mediumTick() {
+        const result = {
+            linksDiscovered: 0,
+            contradictionsFound: 0,
+            contradictionsLinked: 0,
+            memoriesScanned: 0,
+            timestamp: new Date(),
+        };
+        try {
+            // 1. Link discovery - find unlinked memories and create relationships
+            const unlinked = findUnlinkedMemories(this.config.maxLinksPerCycle);
+            result.memoriesScanned = unlinked.length;
+            result.linksDiscovered = discoverMissingLinks(this.config.maxLinksPerCycle);
+            // 2. Contradiction scan
+            const contradictions = detectContradictions({
+                minScore: 0.5,
+                limit: this.config.contradictionScanLimit,
+            });
+            result.contradictionsFound = contradictions.length;
+            result.contradictionsLinked = linkContradictions(contradictions);
+            // Update stats
+            this.lastMediumTick = result.timestamp;
+            this.stats.mediumTicks++;
+            // Emit medium tick event
+            emitWorkerMediumTick(result);
+            // Log summary
+            console.log(`[BrainWorker] Medium tick: scanned ${result.memoriesScanned} memories, ` +
+                `discovered ${result.linksDiscovered} links, ` +
+                `found ${result.contradictionsFound} contradictions`);
+        }
+        catch (e) {
+            console.error('[BrainWorker] Medium tick failed:', e);
+        }
+        return result;
+    }
+    /**
+     * Get current worker status
+     */
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            lastLightTick: this.lastLightTick,
+            lastMediumTick: this.lastMediumTick,
+            lastConsolidation: this.lastConsolidation,
+            stats: { ...this.stats },
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     * Note: Changes won't affect running timers until restart
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    // Manual triggers for testing and API endpoints
+    /**
+     * Manually trigger a light tick
+     * Useful for testing or immediate cache pruning
+     */
+    triggerLightTick() {
+        return this.lightTick();
+    }
+    /**
+     * Manually trigger a medium tick
+     * Useful for testing or immediate link discovery
+     */
+    triggerMediumTick() {
+        return this.mediumTick();
+    }
+}
+// Default singleton instance (optional - server can create its own)
+let defaultWorker = null;
+/**
+ * Get or create the default worker instance
+ */
+export function getDefaultWorker() {
+    if (!defaultWorker) {
+        defaultWorker = new BrainWorker();
+    }
+    return defaultWorker;
+}
+/**
+ * Start the default worker if not already running
+ */
+export function startDefaultWorker() {
+    const worker = getDefaultWorker();
+    if (!worker.isActive()) {
+        worker.start();
+    }
+    return worker;
+}
+/**
+ * Stop the default worker
+ */
+export function stopDefaultWorker() {
+    if (defaultWorker) {
+        defaultWorker.stop();
+    }
+}
+//# sourceMappingURL=brain-worker.js.map

package/dist/worker/brain-worker.js.map

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

package/dist/worker/link-discovery.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Link Discovery Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Finds memories that have no links and discovers relationships
+ * for them during background worker cycles.
+ */
+import { Memory } from '../memory/types.js';
+/**
+ * Find memories that have no outgoing links
+ * These are candidates for relationship discovery
+ *
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with no outgoing links
+ */
+export declare function findUnlinkedMemories(limit?: number): Memory[];
+/**
+ * Find memories with few links (under-linked)
+ * These might benefit from additional connections
+ *
+ * @param maxLinks - Maximum number of existing links to qualify
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with fewer than maxLinks links
+ */
+export declare function findUnderlinkedMemories(maxLinks?: number, limit?: number): Memory[];
+/**
+ * Discover and create links for unlinked memories
+ * Called during medium tick to build the knowledge graph organically
+ *
+ * @param limit - Maximum number of memories to process per cycle
+ * @returns Number of new links created
+ */
+export declare function discoverMissingLinks(limit?: number): number;
+/**
+ * Get statistics about memory link coverage
+ * Useful for dashboard visualization
+ *
+ * @returns Object with link coverage stats
+ */
+export declare function getLinkCoverageStats(): {
+    totalMemories: number;
+    memoriesWithLinks: number;
+    memoriesWithoutLinks: number;
+    averageLinksPerMemory: number;
+};
+//# sourceMappingURL=link-discovery.d.ts.map

package/dist/worker/link-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-discovery.d.ts","sourceRoot":"","sources":["../../src/worker/link-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,EAAE,CAcjE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,GAAE,MAAU,EACpB,KAAK,GAAE,MAAW,GACjB,MAAM,EAAE,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CA8B/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAuBA"}

package/dist/worker/link-discovery.js

@@ -0,0 +1,103 @@
+/**
+ * Link Discovery Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Finds memories that have no links and discovers relationships
+ * for them during background worker cycles.
+ */
+import { getDatabase } from '../database/init.js';
+import { rowToMemory, detectRelationships, createMemoryLink, } from '../memory/store.js';
+/**
+ * Find memories that have no outgoing links
+ * These are candidates for relationship discovery
+ *
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with no outgoing links
+ */
+export function findUnlinkedMemories(limit = 10) {
+    const db = getDatabase();
+    // Find memories that are not the source of any link
+    // Prioritize by salience (important memories should be linked first)
+    const rows = db.prepare(`
+    SELECT m.* FROM memories m
+    LEFT JOIN memory_links ml ON m.id = ml.source_id
+    WHERE ml.id IS NULL
+    ORDER BY m.salience DESC, m.last_accessed DESC
+    LIMIT ?
+  `).all(limit);
+    return rows.map(rowToMemory);
+}
+/**
+ * Find memories with few links (under-linked)
+ * These might benefit from additional connections
+ *
+ * @param maxLinks - Maximum number of existing links to qualify
+ * @param limit - Maximum number of memories to return
+ * @returns Array of Memory objects with fewer than maxLinks links
+ */
+export function findUnderlinkedMemories(maxLinks = 2, limit = 10) {
+    const db = getDatabase();
+    // Find memories with fewer than maxLinks total links (as source or target)
+    const rows = db.prepare(`
+    SELECT m.*, COUNT(ml.id) as link_count
+    FROM memories m
+    LEFT JOIN memory_links ml ON m.id = ml.source_id OR m.id = ml.target_id
+    GROUP BY m.id
+    HAVING link_count < ?
+    ORDER BY m.salience DESC
+    LIMIT ?
+  `).all(maxLinks, limit);
+    return rows.map(rowToMemory);
+}
+/**
+ * Discover and create links for unlinked memories
+ * Called during medium tick to build the knowledge graph organically
+ *
+ * @param limit - Maximum number of memories to process per cycle
+ * @returns Number of new links created
+ */
+export function discoverMissingLinks(limit = 10) {
+    const unlinked = findUnlinkedMemories(limit);
+    let linksCreated = 0;
+    for (const memory of unlinked) {
+        try {
+            // Find up to 3 related memories
+            const relationships = detectRelationships(memory, 3);
+            for (const rel of relationships) {
+                const link = createMemoryLink(memory.id, rel.targetId, rel.relationship, rel.strength);
+                if (link) {
+                    linksCreated++;
+                }
+            }
+        }
+        catch (e) {
+            // Log but don't stop - continue with other memories
+            console.error(`[BrainWorker] Link discovery failed for memory ${memory.id}:`, e);
+        }
+    }
+    return linksCreated;
+}
+/**
+ * Get statistics about memory link coverage
+ * Useful for dashboard visualization
+ *
+ * @returns Object with link coverage stats
+ */
+export function getLinkCoverageStats() {
+    const db = getDatabase();
+    const totalMemories = db.prepare('SELECT COUNT(*) as count FROM memories').get().count;
+    const memoriesWithLinks = db.prepare(`
+    SELECT COUNT(DISTINCT source_id) as count FROM memory_links
+  `).get().count;
+    const totalLinks = db.prepare('SELECT COUNT(*) as count FROM memory_links').get().count;
+    return {
+        totalMemories,
+        memoriesWithLinks,
+        memoriesWithoutLinks: totalMemories - memoriesWithLinks,
+        averageLinksPerMemory: totalMemories > 0
+            ? totalLinks / totalMemories
+            : 0,
+    };
+}
+//# sourceMappingURL=link-discovery.js.map

package/dist/worker/link-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-discovery.js","sourceRoot":"","sources":["../../src/worker/link-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE;IACrD,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,oDAAoD;IACpD,qEAAqE;IACrE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;GAMvB,CAAC,CAAC,GAAG,CAAC,KAAK,CAA8B,CAAC;IAE3C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,CAAC,EACpB,QAAgB,EAAE;IAElB,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,2EAA2E;IAC3E,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;;GAQvB,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAA8B,CAAC;IAErD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE;IACrD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAErD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,gBAAgB,CAC3B,MAAM,CAAC,EAAE,EACT,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,QAAQ,CACb,CAAC;gBACF,IAAI,IAAI,EAAE,CAAC;oBACT,YAAY,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oDAAoD;YACpD,OAAO,CAAC,KAAK,CACX,kDAAkD,MAAM,CAAC,EAAE,GAAG,EAC9D,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAMlC,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,MAAM,aAAa,GAAI,EAAE,CAAC,OAAO,CAC/B,wCAAwC,CACzC,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAEpC,MAAM,iBAAiB,GAAI,EAAE,CAAC,OAAO,CAAC;;GAErC,CAAC,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAErC,MAAM,UAAU,GAAI,EAAE,CAAC,OAAO,CAC5B,4CAA4C,CAC7C,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;IAEpC,OAAO;QACL,aAAa;QACb,iBAAiB;QACjB,oBAAoB,EAAE,aAAa,GAAG,iBAAiB;QACvD,qBAAqB,EAAE,aAAa,GAAG,CAAC;YACtC,CAAC,CAAC,UAAU,GAAG,aAAa;YAC5B,CAAC,CAAC,CAAC;KACN,CAAC;AACJ,CAAC"}

package/dist/worker/predictive-consolidation.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Predictive Consolidation Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Determines when to run consolidation early based on memory pressure
+ * and activity patterns, rather than waiting for the 4-hour cycle.
+ */
+import { WorkerConfig, PredictiveDecision } from './types.js';
+/**
+ * Memory statistics type (matches getMemoryStats return type)
+ */
+export interface MemoryStats {
+    total: number;
+    shortTerm: number;
+    longTerm: number;
+    episodic: number;
+    byCategory: Record<string, number>;
+    averageSalience: number;
+}
+/**
+ * Determine if consolidation should run early
+ * More intelligent than just waiting for the 4-hour cycle
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Decision object with shouldRun, reason, and urgency
+ */
+export declare function shouldTriggerPredictiveConsolidation(stats: MemoryStats, config: WorkerConfig): PredictiveDecision;
+/**
+ * Get detailed memory pressure information
+ * Useful for dashboard visualization and debugging
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Object with detailed pressure metrics
+ */
+export declare function getMemoryPressure(stats: MemoryStats, config: WorkerConfig): {
+    stmFullness: number;
+    totalFullness: number;
+    ltmFullness: number;
+    isWarning: boolean;
+    isCritical: boolean;
+    recommendation: string;
+};
+//# sourceMappingURL=predictive-consolidation.d.ts.map

package/dist/worker/predictive-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive-consolidation.d.ts","sourceRoot":"","sources":["../../src/worker/predictive-consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,kBAAkB,CA8DpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAwBA"}

package/dist/worker/predictive-consolidation.js

@@ -0,0 +1,110 @@
+/**
+ * Predictive Consolidation Module
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Determines when to run consolidation early based on memory pressure
+ * and activity patterns, rather than waiting for the 4-hour cycle.
+ */
+import { getDatabase } from '../database/init.js';
+/**
+ * Memory limits (from DEFAULT_CONFIG)
+ */
+const MAX_SHORT_TERM = 100;
+const MAX_LONG_TERM = 1000;
+const MAX_TOTAL = MAX_SHORT_TERM + MAX_LONG_TERM;
+/**
+ * Determine if consolidation should run early
+ * More intelligent than just waiting for the 4-hour cycle
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Decision object with shouldRun, reason, and urgency
+ */
+export function shouldTriggerPredictiveConsolidation(stats, config) {
+    const stmFullness = stats.shortTerm / MAX_SHORT_TERM;
+    const totalFullness = stats.total / MAX_TOTAL;
+    // Critical: Over 85% STM capacity - consolidate immediately
+    if (stmFullness > config.stmCriticalThreshold) {
+        return {
+            shouldRun: true,
+            reason: `STM at ${(stmFullness * 100).toFixed(0)}% (critical threshold)`,
+            urgency: 'critical',
+        };
+    }
+    // High: Over 80% total capacity
+    if (totalFullness > config.totalMemoryWarningThreshold) {
+        return {
+            shouldRun: true,
+            reason: `Total memory at ${(totalFullness * 100).toFixed(0)}% capacity`,
+            urgency: 'high',
+        };
+    }
+    // Medium: Over 70% STM + high recent activity
+    if (stmFullness > config.stmWarningThreshold) {
+        const db = getDatabase();
+        // Check recent activity (memories created in last 30 minutes)
+        const recentActivity = db.prepare(`
+      SELECT COUNT(*) as count FROM memories
+      WHERE created_at > datetime('now', '-30 minutes')
+    `).get();
+        if (recentActivity.count >= config.highActivityThreshold) {
+            return {
+                shouldRun: true,
+                reason: `STM at ${(stmFullness * 100).toFixed(0)}% with high activity (${recentActivity.count} recent memories)`,
+                urgency: 'medium',
+            };
+        }
+        // Check if many memories are below deletion threshold
+        // These are candidates for cleanup
+        const lowScoreCount = db.prepare(`
+      SELECT COUNT(*) as count FROM memories
+      WHERE type = 'short_term' AND decayed_score < 0.25
+    `).get();
+        if (lowScoreCount.count > 15) {
+            return {
+                shouldRun: true,
+                reason: `${lowScoreCount.count} STM memories below salience threshold`,
+                urgency: 'medium',
+            };
+        }
+    }
+    // No consolidation needed
+    return {
+        shouldRun: false,
+        reason: 'No consolidation triggers met',
+        urgency: 'low',
+    };
+}
+/**
+ * Get detailed memory pressure information
+ * Useful for dashboard visualization and debugging
+ *
+ * @param stats - Current memory statistics
+ * @param config - Worker configuration
+ * @returns Object with detailed pressure metrics
+ */
+export function getMemoryPressure(stats, config) {
+    const stmFullness = stats.shortTerm / MAX_SHORT_TERM;
+    const ltmFullness = stats.longTerm / MAX_LONG_TERM;
+    const totalFullness = stats.total / MAX_TOTAL;
+    const isCritical = stmFullness > config.stmCriticalThreshold;
+    const isWarning = stmFullness > config.stmWarningThreshold ||
+        totalFullness > config.totalMemoryWarningThreshold;
+    let recommendation = 'Memory levels healthy';
+    if (isCritical) {
+        recommendation = 'Immediate consolidation recommended';
+    }
+    else if (isWarning) {
+        recommendation = 'Consider running consolidation soon';
+    }
+    return {
+        stmFullness,
+        totalFullness,
+        ltmFullness,
+        isWarning,
+        isCritical,
+        recommendation,
+    };
+}
+//# sourceMappingURL=predictive-consolidation.js.map

package/dist/worker/predictive-consolidation.js.map

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