driftdetect-cortex 0.9.41

package/README.md

@@ -0,0 +1,75 @@
+# Drift Cortex
+
+> **"The only AI memory system that understands code as code, not text."**
+
+Drift Cortex is the memory layer for Drift, providing persistent, intelligent memory that makes AI agents truly understand your codebase.
+
+## Features
+
+- **9 Memory Types**: Core, Tribal, Procedural, Semantic, Episodic, PatternRationale, ConstraintOverride, DecisionContext, CodeSmell
+- **Bitemporal Tracking**: Know when you learned something AND when it was true
+- **Self-Healing Validation**: Memories stay synchronized with actual code
+- **Sleep-Inspired Consolidation**: Episodic memories compress into semantic knowledge
+- **Intent-Aware Retrieval**: Different intents weight different memory types
+- **Multi-Provider Embeddings**: Local (Transformers.js), OpenAI, Ollama
+
+## Installation
+
+```bash
+pnpm add driftdetect-cortex
+```
+
+## Quick Start
+
+```typescript
+import { Cortex } from 'driftdetect-cortex';
+
+// Initialize
+const cortex = await Cortex.create({
+  dbPath: '.drift/cortex/memory.db',
+  embeddingProvider: 'local', // or 'openai', 'ollama'
+});
+
+// Add tribal knowledge
+await cortex.add({
+  type: 'tribal',
+  topic: 'authentication',
+  knowledge: 'Never store JWT secrets in environment variables on the client',
+  severity: 'critical',
+});
+
+// Retrieve context-aware memories
+const memories = await cortex.retrieve({
+  intent: 'add_feature',
+  focus: 'user authentication',
+  maxTokens: 2000,
+});
+```
+
+## Memory Types
+
+| Type | Purpose | Half-Life |
+|------|---------|-----------|
+| Core | Project identity, preferences | ∞ |
+| Tribal | Institutional knowledge | 365 days |
+| Procedural | How-to procedures | 180 days |
+| Semantic | Consolidated knowledge | 90 days |
+| Episodic | Interaction history | 7 days |
+| PatternRationale | Why patterns exist | 180 days |
+| ConstraintOverride | Approved exceptions | 90 days |
+| DecisionContext | Human context for ADRs | 180 days |
+| CodeSmell | Patterns to avoid | 90 days |
+
+## MCP Tools
+
+- `drift_memory_status` - Health overview
+- `drift_memory_add` - Add new memory
+- `drift_memory_search` - Semantic search
+- `drift_memory_for_context` - Context-aware retrieval
+- `drift_why` - Complete "why" context
+- `drift_memory_validate` - Self-healing validation
+- `drift_memory_consolidate` - Trigger consolidation
+
+## License
+
+Apache-2.0

package/dist/cache/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cache Layer
+ *
+ * Multi-level caching for memory retrieval:
+ * - L1: In-memory hot cache
+ * - L2: Index cache
+ * - L3: Shard cache
+ * - Preloader for startup
+ */
+export * from './l1-memory.js';
+export * from './l2-index.js';
+export * from './l3-shard.js';
+export * from './preloader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,14 @@
+/**
+ * Cache Layer
+ *
+ * Multi-level caching for memory retrieval:
+ * - L1: In-memory hot cache
+ * - L2: Index cache
+ * - L3: Shard cache
+ * - Preloader for startup
+ */
+export * from './l1-memory.js';
+export * from './l2-index.js';
+export * from './l3-shard.js';
+export * from './preloader.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/cache/l1-memory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * L1 Memory Cache
+ *
+ * In-memory hot cache for frequently accessed memories.
+ */
+import type { Memory } from '../types/index.js';
+/**
+ * L1 memory cache
+ */
+export declare class L1MemoryCache {
+    private cache;
+    private maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Get a memory from cache
+     */
+    get(id: string): Memory | null;
+    /**
+     * Set a memory in cache
+     */
+    set(id: string, memory: Memory): void;
+    /**
+     * Delete a memory from cache
+     */
+    delete(id: string): void;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Evict least recently used entry
+     */
+    private evict;
+}
+//# sourceMappingURL=l1-memory.d.ts.map

package/dist/cache/l1-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1-memory.d.ts","sourceRoot":"","sources":["../../src/cache/l1-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAWhD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAAM;IAIzB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU9B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAarC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,KAAK;CAed"}

package/dist/cache/l1-memory.js

@@ -0,0 +1,76 @@
+/**
+ * L1 Memory Cache
+ *
+ * In-memory hot cache for frequently accessed memories.
+ */
+/**
+ * L1 memory cache
+ */
+export class L1MemoryCache {
+    cache = new Map();
+    maxSize;
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+    }
+    /**
+     * Get a memory from cache
+     */
+    get(id) {
+        const entry = this.cache.get(id);
+        if (entry) {
+            entry.accessCount++;
+            entry.lastAccessed = Date.now();
+            return entry.memory;
+        }
+        return null;
+    }
+    /**
+     * Set a memory in cache
+     */
+    set(id, memory) {
+        // Evict if at capacity
+        if (this.cache.size >= this.maxSize) {
+            this.evict();
+        }
+        this.cache.set(id, {
+            memory,
+            accessCount: 1,
+            lastAccessed: Date.now(),
+        });
+    }
+    /**
+     * Delete a memory from cache
+     */
+    delete(id) {
+        this.cache.delete(id);
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evict() {
+        let oldest = null;
+        let oldestTime = Infinity;
+        for (const [id, entry] of this.cache) {
+            if (entry.lastAccessed < oldestTime) {
+                oldest = id;
+                oldestTime = entry.lastAccessed;
+            }
+        }
+        if (oldest) {
+            this.cache.delete(oldest);
+        }
+    }
+}
+//# sourceMappingURL=l1-memory.js.map

package/dist/cache/l1-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1-memory.js","sourceRoot":"","sources":["../../src/cache/l1-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,OAAO,CAAS;IAExB,YAAY,OAAO,GAAG,GAAG;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,WAAW,EAAE,CAAC;YACpB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU,EAAE,MAAc;QAC5B,uBAAuB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YACjB,MAAM;YACN,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,KAAK;QACX,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,YAAY,GAAG,UAAU,EAAE,CAAC;gBACpC,MAAM,GAAG,EAAE,CAAC;gBACZ,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC;YAClC,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/cache/l2-index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * L2 Index Cache
+ *
+ * Caches index lookups (by type, pattern, file, etc.)
+ */
+/**
+ * L2 index cache
+ */
+export declare class L2IndexCache {
+    private cache;
+    private ttlMs;
+    constructor(ttlMs?: number);
+    /**
+     * Get cached index
+     */
+    get(key: string): string[] | null;
+    /**
+     * Set cached index
+     */
+    set(key: string, ids: string[]): void;
+    /**
+     * Invalidate a key
+     */
+    invalidate(key: string): void;
+    /**
+     * Invalidate all keys matching a pattern
+     */
+    invalidatePattern(pattern: string): void;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+}
+//# sourceMappingURL=l2-index.d.ts.map

package/dist/cache/l2-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2-index.d.ts","sourceRoot":"","sources":["../../src/cache/l2-index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,SAAQ;IAIzB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAUjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAOrC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/cache/l2-index.js

@@ -0,0 +1,65 @@
+/**
+ * L2 Index Cache
+ *
+ * Caches index lookups (by type, pattern, file, etc.)
+ */
+/**
+ * L2 index cache
+ */
+export class L2IndexCache {
+    cache = new Map();
+    ttlMs;
+    constructor(ttlMs = 60000) {
+        this.ttlMs = ttlMs;
+    }
+    /**
+     * Get cached index
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (entry && Date.now() - entry.timestamp < this.ttlMs) {
+            return entry.ids;
+        }
+        // Expired or not found
+        this.cache.delete(key);
+        return null;
+    }
+    /**
+     * Set cached index
+     */
+    set(key, ids) {
+        this.cache.set(key, {
+            ids,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Invalidate a key
+     */
+    invalidate(key) {
+        this.cache.delete(key);
+    }
+    /**
+     * Invalidate all keys matching a pattern
+     */
+    invalidatePattern(pattern) {
+        for (const key of this.cache.keys()) {
+            if (key.includes(pattern)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=l2-index.js.map

package/dist/cache/l2-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2-index.js","sourceRoot":"","sources":["../../src/cache/l2-index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,KAAK,CAAS;IAEtB,YAAY,KAAK,GAAG,KAAK;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,GAAG,CAAC;QACnB,CAAC;QACD,uBAAuB;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,GAAa;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAe;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/cache/l3-shard.d.ts

@@ -0,0 +1,40 @@
+/**
+ * L3 Shard Cache
+ *
+ * Caches memory shards for large result sets.
+ */
+import type { Memory } from '../types/index.js';
+/**
+ * L3 shard cache
+ */
+export declare class L3ShardCache {
+    private cache;
+    private ttlMs;
+    private maxShards;
+    constructor(ttlMs?: number, maxShards?: number);
+    /**
+     * Get cached shard
+     */
+    get(key: string): Memory[] | null;
+    /**
+     * Set cached shard
+     */
+    set(key: string, memories: Memory[]): void;
+    /**
+     * Invalidate a key
+     */
+    invalidate(key: string): void;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Evict oldest entry
+     */
+    private evictOldest;
+}
+//# sourceMappingURL=l3-shard.d.ts.map

package/dist/cache/l3-shard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l3-shard.d.ts","sourceRoot":"","sources":["../../src/cache/l3-shard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;gBAEd,KAAK,SAAS,EAAE,SAAS,SAAK;IAK1C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAUjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAY1C;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;CAepB"}

package/dist/cache/l3-shard.js

@@ -0,0 +1,77 @@
+/**
+ * L3 Shard Cache
+ *
+ * Caches memory shards for large result sets.
+ */
+/**
+ * L3 shard cache
+ */
+export class L3ShardCache {
+    cache = new Map();
+    ttlMs;
+    maxShards;
+    constructor(ttlMs = 300000, maxShards = 20) {
+        this.ttlMs = ttlMs;
+        this.maxShards = maxShards;
+    }
+    /**
+     * Get cached shard
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (entry && Date.now() - entry.timestamp < this.ttlMs) {
+            return entry.memories;
+        }
+        // Expired or not found
+        this.cache.delete(key);
+        return null;
+    }
+    /**
+     * Set cached shard
+     */
+    set(key, memories) {
+        // Evict if at capacity
+        if (this.cache.size >= this.maxShards) {
+            this.evictOldest();
+        }
+        this.cache.set(key, {
+            memories,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Invalidate a key
+     */
+    invalidate(key) {
+        this.cache.delete(key);
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Evict oldest entry
+     */
+    evictOldest() {
+        let oldest = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.timestamp < oldestTime) {
+                oldest = key;
+                oldestTime = entry.timestamp;
+            }
+        }
+        if (oldest) {
+            this.cache.delete(oldest);
+        }
+    }
+}
+//# sourceMappingURL=l3-shard.js.map

package/dist/cache/l3-shard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"l3-shard.js","sourceRoot":"","sources":["../../src/cache/l3-shard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,KAAK,CAAS;IACd,SAAS,CAAS;IAE1B,YAAY,KAAK,GAAG,MAAM,EAAE,SAAS,GAAG,EAAE;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,uBAAuB;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,QAAkB;QACjC,uBAAuB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,WAAW;QACjB,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,SAAS,GAAG,UAAU,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,CAAC;gBACb,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/cache/preloader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cache Preloader
+ *
+ * Preloads frequently accessed memories on startup.
+ */
+import type { IMemoryStorage } from '../storage/interface.js';
+import { L1MemoryCache } from './l1-memory.js';
+/**
+ * Cache preloader
+ */
+export declare class CachePreloader {
+    private storage;
+    private cache;
+    constructor(storage: IMemoryStorage, cache: L1MemoryCache);
+    /**
+     * Preload frequently accessed memories
+     */
+    preload(): Promise<number>;
+    /**
+     * Preload memories by type
+     */
+    preloadByType(types: string[]): Promise<number>;
+}
+//# sourceMappingURL=preloader.d.ts.map

package/dist/cache/preloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloader.d.ts","sourceRoot":"","sources":["../../src/cache/preloader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;gBADL,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa;IAG9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBhC;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAatD"}

package/dist/cache/preloader.js

@@ -0,0 +1,49 @@
+/**
+ * Cache Preloader
+ *
+ * Preloads frequently accessed memories on startup.
+ */
+import { L1MemoryCache } from './l1-memory.js';
+/**
+ * Cache preloader
+ */
+export class CachePreloader {
+    storage;
+    cache;
+    constructor(storage, cache) {
+        this.storage = storage;
+        this.cache = cache;
+    }
+    /**
+     * Preload frequently accessed memories
+     */
+    async preload() {
+        // Get most frequently accessed memories
+        const memories = await this.storage.search({
+            minAccessCount: 5,
+            orderBy: 'accessCount',
+            orderDir: 'desc',
+            limit: 50,
+        });
+        // Load into cache
+        for (const memory of memories) {
+            this.cache.set(memory.id, memory);
+        }
+        return memories.length;
+    }
+    /**
+     * Preload memories by type
+     */
+    async preloadByType(types) {
+        let loaded = 0;
+        for (const type of types) {
+            const memories = await this.storage.findByType(type, { limit: 20 });
+            for (const memory of memories) {
+                this.cache.set(memory.id, memory);
+                loaded++;
+            }
+        }
+        return loaded;
+    }
+}
+//# sourceMappingURL=preloader.js.map

package/dist/cache/preloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloader.js","sourceRoot":"","sources":["../../src/cache/preloader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,OAAuB,EACvB,KAAoB;QADpB,YAAO,GAAP,OAAO,CAAgB;QACvB,UAAK,GAAL,KAAK,CAAe;IAC3B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACzC,cAAc,EAAE,CAAC;YACjB,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,kBAAkB;QAClB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,KAAe;QACjC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3E,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAClC,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/causal/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Causal Graph Module
+ *
+ * Provides causal relationship tracking between memories,
+ * enabling "why" narratives and understanding of how
+ * knowledge evolved over time.
+ *
+ * @module causal
+ */
+export * from './storage/index.js';
+export * from './traversal/index.js';
+export * from './inference/index.js';
+export * from './narrative/index.js';
+export type { CausalRelation, CausalEdge, CausalChain, CausalNode, CausalEvidence, CausalInferenceResult, CausalInferenceStrategy, GraphTraversalOptions, CausalGraphStats, CreateCausalEdgeRequest, UpdateCausalEdgeRequest, } from '../types/causal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/causal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/causal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/causal/index.js

@@ -0,0 +1,18 @@
+/**
+ * Causal Graph Module
+ *
+ * Provides causal relationship tracking between memories,
+ * enabling "why" narratives and understanding of how
+ * knowledge evolved over time.
+ *
+ * @module causal
+ */
+// Storage
+export * from './storage/index.js';
+// Traversal
+export * from './traversal/index.js';
+// Inference
+export * from './inference/index.js';
+// Narrative
+export * from './narrative/index.js';
+//# sourceMappingURL=index.js.map

package/dist/causal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/causal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,sBAAsB,CAAC"}