@monoes/memory 1.0.0 → 1.0.2

package/dist/controller-registry.js

@@ -1,11 +1,11 @@
 /**
- * ControllerRegistry - Central controller lifecycle management for AgentDB v1
+ * ControllerRegistry - Central controller lifecycle management for memory backend
  *
- * Wraps the AgentDB class and adds CLI-specific controllers from @monomind/memory.
+ * Wraps the LanceDB backend and adds CLI-specific controllers from @monomind/memory.
  * Manages initialization (level-based ordering), health checks, and graceful shutdown.
  *
  * Per ADR-053: Replaces memory-initializer.js's raw sql.js usage with a unified
- * controller ecosystem routing all memory operations through AgentDB v1.
+ * controller ecosystem routing all memory operations through LanceDB.
  *
  * @module @monomind/memory/controller-registry
  */
@@ -35,9 +35,11 @@ export const INIT_LEVELS = [
     // Level 6: Session management
     { level: 6, controllers: ['federatedSession', 'graphAdapter'] },
 ];
+/** Pre-computed reverse of INIT_LEVELS for shutdown ordering. */
+const SHUTDOWN_LEVELS = [...INIT_LEVELS].reverse();
 // ===== ControllerRegistry =====
 /**
- * Central registry for AgentDB v1 controller lifecycle management.
+ * Central registry for memory backend controller lifecycle management.
  *
  * Handles:
  * - Level-based initialization ordering (levels 0-6)
@@ -67,7 +69,6 @@ export const INIT_LEVELS = [
  */
 export class ControllerRegistry extends EventEmitter {
     controllers = new Map();
-    agentdb = null;
     backend = null;
     config = {};
     initialized = false;
@@ -85,9 +86,7 @@ export class ControllerRegistry extends EventEmitter {
         this.initialized = true; // Set early to prevent concurrent re-entry
         this.config = config;
         const startTime = performance.now();
-        // Step 1: Initialize AgentDB (the core)
-        await this.initAgentDB(config);
-        // Step 2: Set up the backend
+        // Step 1: Set up the backend
         this.backend = config.backend || null;
         // Step 3: Initialize controllers level by level
         for (const level of INIT_LEVELS) {
@@ -129,9 +128,8 @@ export class ControllerRegistry extends EventEmitter {
     async shutdown() {
         if (!this.initialized)
             return;
-        // Shutdown in reverse level order
-        const reverseLevels = [...INIT_LEVELS].reverse();
-        for (const level of reverseLevels) {
+        // Shutdown in reverse level order (SHUTDOWN_LEVELS is pre-computed at module load)
+        for (const level of SHUTDOWN_LEVELS) {
             const controllersToShutdown = level.controllers
                 .filter((name) => {
                 const entry = this.controllers.get(name);
@@ -139,18 +137,6 @@ export class ControllerRegistry extends EventEmitter {
             });
             await Promise.allSettled(controllersToShutdown.map((name) => this.shutdownController(name)));
         }
-        // Shutdown AgentDB
-        if (this.agentdb) {
-            try {
-                if (typeof this.agentdb.close === 'function') {
-                    await this.agentdb.close();
-                }
-            }
-            catch {
-                // Best-effort cleanup
-            }
-            this.agentdb = null;
-        }
         this.controllers.clear();
         this.initialized = false;
         this.emit('shutdown');
@@ -160,41 +146,17 @@ export class ControllerRegistry extends EventEmitter {
      * Returns null if the controller is not initialized or unavailable.
      */
     get(name) {
-        // First check CLI-layer controllers
         const entry = this.controllers.get(name);
         if (entry?.enabled && entry?.instance) {
             return entry.instance;
         }
-        // Fall back to AgentDB internal controllers
-        if (this.agentdb && typeof this.agentdb.getController === 'function') {
-            try {
-                const controller = this.agentdb.getController(name);
-                if (controller)
-                    return controller;
-            }
-            catch {
-                // Controller not available in AgentDB
-            }
-        }
         return null;
     }
     /**
      * Check if a controller is enabled and initialized.
      */
     isEnabled(name) {
-        const entry = this.controllers.get(name);
-        if (entry?.enabled)
-            return true;
-        // Check AgentDB internal controllers
-        if (this.agentdb && typeof this.agentdb.getController === 'function') {
-            try {
-                return this.agentdb.getController(name) !== null;
-            }
-            catch {
-                return false;
-            }
-        }
-        return false;
+        return this.controllers.get(name)?.enabled ?? false;
     }
     /**
      * Aggregate health check across all controllers.
@@ -213,16 +175,7 @@ export class ControllerRegistry extends EventEmitter {
                 error: entry.error,
             });
         }
-        // Check AgentDB health
-        let agentdbAvailable = false;
-        if (this.agentdb) {
-            try {
-                agentdbAvailable = typeof this.agentdb.getController === 'function';
-            }
-            catch {
-                agentdbAvailable = false;
-            }
-        }
+        const lancedbAvailable = this.backend !== null;
         const active = controllerHealth.filter((c) => c.status === 'healthy').length;
         const unavailable = controllerHealth.filter((c) => c.status === 'unavailable').length;
         let status = 'healthy';
@@ -235,7 +188,7 @@ export class ControllerRegistry extends EventEmitter {
         return {
             status,
             controllers: controllerHealth,
-            agentdbAvailable,
+            lancedbAvailable,
             initTimeMs: this.initTimeMs,
             timestamp: Date.now(),
             activeControllers: active,
@@ -243,11 +196,8 @@ export class ControllerRegistry extends EventEmitter {
         };
     }
     /**
-     * Get the underlying AgentDB instance.
+     * Get the underlying memory backend instance.
      */
-    getAgentDB() {
-        return this.agentdb;
-    }
     /**
      * Get the memory backend.
      */
@@ -282,57 +232,6 @@ export class ControllerRegistry extends EventEmitter {
         }));
     }
     // ===== Private Methods =====
-    /**
-     * Initialize AgentDB instance with dynamic import and fallback chain.
-     */
-    async initAgentDB(config) {
-        try {
-            // Validate dbPath to prevent path traversal
-            const dbPath = config.dbPath || ':memory:';
-            if (dbPath !== ':memory:') {
-                // Use dynamic import instead of require() — require() is not defined in ESM
-                // context and silently kills initAgentDB(), disabling all 15+ controllers (#1492).
-                const { resolve: resolvePath } = await import('node:path');
-                const resolved = resolvePath(dbPath);
-                if (resolved.includes('..')) {
-                    this.emit('agentdb:unavailable', { reason: 'Invalid dbPath' });
-                    return;
-                }
-            }
-            const agentdbModule = await import('agentdb');
-            const AgentDBClass = agentdbModule.AgentDB || agentdbModule.default;
-            if (!AgentDBClass) {
-                this.emit('agentdb:unavailable', { reason: 'No AgentDB class found' });
-                return;
-            }
-            this.agentdb = new AgentDBClass({ dbPath });
-            // Suppress agentdb's noisy info-level output during init
-            // using stderr redirect instead of monkey-patching console.log
-            const origLog = console.log;
-            const suppressFilter = (args) => {
-                const msg = String(args[0] ?? '');
-                return msg.includes('Transformers.js') ||
-                    msg.includes('better-sqlite3') ||
-                    msg.includes('[AgentDB]');
-            };
-            console.log = (...args) => {
-                if (!suppressFilter(args))
-                    origLog.apply(console, args);
-            };
-            try {
-                await this.agentdb.initialize();
-            }
-            finally {
-                console.log = origLog;
-            }
-            this.emit('agentdb:initialized');
-        }
-        catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            this.emit('agentdb:unavailable', { reason: msg.substring(0, 200) });
-            this.agentdb = null;
-        }
-    }
     /**
      * Check whether a controller should be initialized based on config.
      */
@@ -354,13 +253,13 @@ export class ControllerRegistry extends EventEmitter {
             // Graph — enabled if backend available
             case 'memoryGraph':
                 return !!(this.config.memory?.memoryGraph || this.backend);
-            // Security — enabled if AgentDB available
+            // Security — enabled if LanceDB available
             case 'mutationGuard':
             case 'attestationLog':
             case 'vectorBackend':
             case 'guardedVectorBackend':
-                return this.agentdb !== null;
-            // AgentDB-internal controllers — only if AgentDB available
+                return this.backend !== null;
+            // Memory-internal controllers — only if backend available
             case 'skills':
             case 'reflexion':
             case 'causalGraph':
@@ -376,10 +275,10 @@ export class ControllerRegistry extends EventEmitter {
             case 'contextSynthesizer':
             case 'rvfOptimizer':
             case 'mmrDiversityRanker':
-                return this.agentdb !== null;
-            // SemanticRouter — auto-enable if agentdb available (exported since alpha.10)
+                return this.backend !== null;
+            // SemanticRouter — auto-enable if backend available (exported since alpha.10)
             case 'semanticRouter':
-                return this.agentdb !== null;
+                return this.backend !== null;
             // Optional controllers
             case 'hybridSearch':
             case 'agentMemoryScope':
@@ -426,8 +325,8 @@ export class ControllerRegistry extends EventEmitter {
     }
     /**
      * Factory method to create a controller instance.
-     * Handles CLI-layer controllers; AgentDB-internal controllers are
-     * accessed via agentdb.getController().
+     * Handles CLI-layer controllers; internal controllers are
+     * accessed via backend.getController().
      */
     async createController(name) {
         switch (name) {
@@ -436,11 +335,16 @@ export class ControllerRegistry extends EventEmitter {
                 if (!this.backend)
                     return null;
                 const config = this.config.memory?.learningBridge || {};
+                let embedder = config.embedder;
                 const bridge = new LearningBridge(this.backend, {
                     sonaMode: config.sonaMode || this.config.neural?.sonaMode || 'balanced',
                     confidenceDecayRate: config.confidenceDecayRate,
                     accessBoostAmount: config.accessBoostAmount,
                     consolidationThreshold: config.consolidationThreshold,
+                    embedder,
+                    // Thread the real vector dimension so SONA and the embedder agree
+                    // (backend MiniLM produces 384-dim vectors, not SONA's 768 hidden width).
+                    embeddingDim: this.config.dimension ?? config.embeddingDim,
                     enabled: true,
                 });
                 return bridge;
@@ -480,314 +384,39 @@ export class ControllerRegistry extends EventEmitter {
             case 'agentMemoryScope':
                 // Agent memory scope — placeholder, activated when explicitly enabled
                 return null;
-            case 'semanticRouter': {
-                // SemanticRouter exported from agentdb 3.0.0-alpha.10 (ADR-062)
-                // Constructor: () — requires initialize() after construction
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const SR = agentdbModule.SemanticRouter;
-                    if (!SR)
-                        return null;
-                    const router = new SR();
-                    await router.initialize();
-                    return router;
-                }
-                catch {
-                    return null;
-                }
-            }
+            case 'semanticRouter':
+                return null;
             case 'sonaTrajectory':
-                // Delegate to AgentDB's SonaTrajectoryService if available
-                if (this.agentdb && typeof this.agentdb.getController === 'function') {
-                    try {
-                        return this.agentdb.getController('sonaTrajectory');
-                    }
-                    catch {
-                        return null;
-                    }
-                }
                 return null;
-            case 'hierarchicalMemory': {
-                // HierarchicalMemory exported from agentdb 3.0.0-alpha.10 (ADR-066 Phase P2-3)
-                // Constructor: (db, embedder, vectorBackend?, graphBackend?, config?)
-                if (!this.agentdb)
-                    return this.createTieredMemoryStub();
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const HM = agentdbModule.HierarchicalMemory;
-                    if (!HM)
-                        return this.createTieredMemoryStub();
-                    const embedder = this.createEmbeddingService();
-                    const hm = new HM(this.agentdb.database, embedder);
-                    await hm.initializeDatabase();
-                    return hm;
-                }
-                catch {
-                    return this.createTieredMemoryStub();
-                }
-            }
-            case 'memoryConsolidation': {
-                // MemoryConsolidation exported from agentdb 3.0.0-alpha.10 (ADR-066 Phase P2-3)
-                // Constructor: (db, hierarchicalMemory, embedder, vectorBackend?, graphBackend?, config?)
-                if (!this.agentdb)
-                    return this.createConsolidationStub();
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const MC = agentdbModule.MemoryConsolidation;
-                    if (!MC)
-                        return this.createConsolidationStub();
-                    // Get the HierarchicalMemory instance (must be initialized at level 1 before us at level 3)
-                    const hm = this.get('hierarchicalMemory');
-                    if (!hm || typeof hm.recall !== 'function' || typeof hm.store !== 'function') {
-                        return this.createConsolidationStub();
-                    }
-                    const embedder = this.createEmbeddingService();
-                    const mc = new MC(this.agentdb.database, hm, embedder);
-                    await mc.initializeDatabase();
-                    return mc;
-                }
-                catch {
-                    return this.createConsolidationStub();
-                }
-            }
+            case 'hierarchicalMemory':
+                return this.createTieredMemoryStub();
+            case 'memoryConsolidation':
+                return this.createConsolidationStub();
             case 'federatedSession':
                 // Federated session — placeholder for Phase 4
                 return null;
-            // ----- AgentDB-internal controllers (via getController) -----
-            // AgentDB.getController() only supports: reflexion/memory, skills, causalGraph/causal
-            case 'reasoningBank': {
-                // ReasoningBank is exported directly, not via getController
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const RB = agentdbModule.ReasoningBank;
-                    if (!RB)
-                        return null;
-                    const embedder = this.createEmbeddingService();
-                    return new RB(this.agentdb.database, embedder);
-                }
-                catch {
-                    return null;
-                }
-            }
+            // ----- internal controllers (via getController) -----
+            // legacy backend.getController() only supports: reflexion/memory, skills, causalGraph/causal
+            case 'reasoningBank':
             case 'skills':
             case 'reflexion':
-            case 'causalGraph': {
-                if (!this.agentdb || typeof this.agentdb.getController !== 'function')
-                    return null;
-                try {
-                    return this.agentdb.getController(name) ?? null;
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'causalRecall': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const CR = agentdbModule.CausalRecall;
-                    if (!CR)
-                        return null;
-                    return new CR(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'learningSystem': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const LS = agentdbModule.LearningSystem;
-                    if (!LS)
-                        return null;
-                    return new LS(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'explainableRecall': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const ER = agentdbModule.ExplainableRecall;
-                    if (!ER)
-                        return null;
-                    return new ER(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'nightlyLearner': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const NL = agentdbModule.NightlyLearner;
-                    if (!NL)
-                        return null;
-                    return new NL(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'graphTransformer': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const GT = agentdbModule.CausalMemoryGraph;
-                    if (!GT)
-                        return null;
-                    return new GT(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            // ----- Direct-instantiation controllers -----
-            case 'batchOperations': {
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const BO = agentdbModule.BatchOperations;
-                    if (!BO)
-                        return null;
-                    const embedder = this.config.embeddingGenerator || null;
-                    return new BO(this.agentdb.database, embedder);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'contextSynthesizer': {
-                // ContextSynthesizer.synthesize is static — return the class itself
-                try {
-                    const agentdbModule = await import('agentdb');
-                    return agentdbModule.ContextSynthesizer ?? null;
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'mmrDiversityRanker': {
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const MMR = agentdbModule.MMRDiversityRanker;
-                    if (!MMR)
-                        return null;
-                    return new MMR();
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'mutationGuard': {
-                // MutationGuard exported from agentdb 3.0.0-alpha.10 (ADR-060)
-                // Constructor: (config?) where config.dimension, config.maxElements, config.enableWasmProofs
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const MG = agentdbModule.MutationGuard;
-                    if (!MG)
-                        return null;
-                    return new MG({ dimension: this.config.dimension || 384 });
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'attestationLog': {
-                // AttestationLog exported from agentdb 3.0.0-alpha.10 (ADR-060)
-                // Constructor: (db) — uses database for append-only audit log
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const AL = agentdbModule.AttestationLog;
-                    if (!AL)
-                        return null;
-                    return new AL(this.agentdb.database);
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'gnnService': {
-                // GNNService exported from agentdb 3.0.0-alpha.10 (ADR-062)
-                // Constructor: (config?) — requires initialize() after construction
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const GNN = agentdbModule.GNNService;
-                    if (!GNN)
-                        return null;
-                    const gnn = new GNN({ inputDim: this.config.dimension || 384 });
-                    await gnn.initialize();
-                    return gnn;
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'rvfOptimizer': {
-                // RVFOptimizer exported from agentdb 3.0.0-alpha.10 (ADR-062/065)
-                // Constructor: (config?) — no-arg for defaults
-                try {
-                    const agentdbModule = await import('agentdb');
-                    const RVF = agentdbModule.RVFOptimizer;
-                    if (!RVF)
-                        return null;
-                    return new RVF();
-                }
-                catch {
-                    return null;
-                }
-            }
-            case 'guardedVectorBackend': {
-                // GuardedVectorBackend exported from agentdb 3.0.0-alpha.10 (ADR-060)
-                // Constructor: (innerBackend, mutationGuard, attestationLog?)
-                // Requires vectorBackend and mutationGuard to be initialized first (level 2)
-                if (!this.agentdb)
-                    return null;
-                try {
-                    const vb = this.get('vectorBackend');
-                    const guard = this.get('mutationGuard');
-                    if (!vb || !guard)
-                        return null;
-                    const agentdbModule = await import('agentdb');
-                    const GVB = agentdbModule.GuardedVectorBackend;
-                    if (!GVB)
-                        return null;
-                    const log = this.get('attestationLog');
-                    return new GVB(vb, guard, log || undefined);
-                }
-                catch {
-                    return null;
-                }
-            }
+            case 'causalGraph':
+            case 'causalRecall':
+            case 'learningSystem':
+            case 'explainableRecall':
+            case 'nightlyLearner':
+            case 'graphTransformer':
+            case 'batchOperations':
+            case 'contextSynthesizer':
+            case 'mmrDiversityRanker':
+            case 'mutationGuard':
+            case 'attestationLog':
+            case 'gnnService':
+            case 'rvfOptimizer':
+            case 'guardedVectorBackend':
             case 'vectorBackend':
-            case 'graphAdapter': {
-                // These are accessed via AgentDB internal state, not direct construction
-                if (!this.agentdb)
-                    return null;
-                try {
-                    if (typeof this.agentdb.getController === 'function') {
-                        return this.agentdb.getController(name) ?? null;
-                    }
-                }
-                catch { /* fallthrough */ }
+            case 'graphAdapter':
                 return null;
-            }
             default:
                 return null;
         }
@@ -840,7 +469,7 @@ export class ControllerRegistry extends EventEmitter {
     }
     /**
      * Lightweight in-memory tiered store (fallback when HierarchicalMemory
-     * cannot be initialized from agentdb).
+     * cannot be initialized from legacy module).
      * Enforces per-tier size limits to prevent unbounded memory growth.
      */
     createTieredMemoryStub() {
@@ -883,7 +512,7 @@ export class ControllerRegistry extends EventEmitter {
     }
     /**
      * No-op consolidation stub (fallback when MemoryConsolidation
-     * cannot be initialized from agentdb).
+     * cannot be initialized from legacy module).
      */
     createConsolidationStub() {
         return {