@monoes/memory 1.0.15 → 1.0.17

package/dist/controller-registry.d.ts

@@ -1,206 +0,0 @@
-/**
- * ControllerRegistry - Central controller lifecycle management for memory backend
- *
- * Wraps the configured memory backend (SQLite via better-sqlite3/sql.js as of
- * 2026-07; LanceDB support was fully removed) 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 a single backend.
- *
- * @module @monomind/memory/controller-registry
- */
-import { EventEmitter } from 'node:events';
-import type { IMemoryBackend, EmbeddingGenerator, SONAMode } from './types.js';
-import type { CacheConfig } from './types.js';
-/**
- * Memory controllers
- */
-export type MemoryControllerName = 'reasoningBank' | 'skills' | 'reflexion' | 'causalGraph' | 'causalRecall' | 'learningSystem' | 'explainableRecall' | 'nightlyLearner' | 'graphTransformer' | 'mutationGuard' | 'attestationLog' | 'vectorBackend' | 'graphAdapter';
-/**
- * CLI-layer controllers (from @monomind/memory or new)
- */
-export type CLIControllerName = 'learningBridge' | 'tieredCache' | 'hybridSearch' | 'federatedSession' | 'semanticRouter' | 'sonaTrajectory' | 'hierarchicalMemory' | 'memoryConsolidation' | 'batchOperations' | 'contextSynthesizer' | 'gnnService' | 'sonaOptimizer' | 'mmrDiversityRanker' | 'guardedVectorBackend';
-/**
- * All controller names
- */
-export type ControllerName = MemoryControllerName | CLIControllerName;
-/**
- * Initialization level for dependency ordering
- */
-export interface InitLevel {
-    level: number;
-    controllers: ControllerName[];
-}
-/**
- * Individual controller health status
- */
-export interface ControllerHealth {
-    name: ControllerName;
-    status: 'healthy' | 'degraded' | 'unavailable';
-    initTimeMs: number;
-    error?: string;
-}
-/**
- * Aggregated health report for all controllers
- */
-export interface RegistryHealthReport {
-    status: 'healthy' | 'degraded' | 'unhealthy';
-    controllers: ControllerHealth[];
-    storageBackendAvailable: boolean;
-    initTimeMs: number;
-    timestamp: number;
-    activeControllers: number;
-    totalControllers: number;
-}
-/**
- * Runtime configuration for controller activation
- */
-export interface RuntimeConfig {
-    /** Database path for the memory backend (SQLite as of 2026-07) */
-    dbPath?: string;
-    /** Vector dimension (default: 384 for MiniLM) */
-    dimension?: number;
-    /** Embedding generator function */
-    embeddingGenerator?: EmbeddingGenerator;
-    /** Memory backend config */
-    memory?: {
-        enableHNSW?: boolean;
-        tieredCache?: Partial<CacheConfig>;
-    };
-    /** Neural config */
-    neural?: {
-        enabled?: boolean;
-        modelPath?: string;
-        sonaMode?: SONAMode;
-    };
-    /** Controllers to explicitly enable/disable */
-    controllers?: Partial<Record<ControllerName, boolean>>;
-    /** Backend instance to use (if pre-created) */
-    backend?: IMemoryBackend;
-}
-/**
- * Level-based initialization order per ADR-053.
- * Controllers at each level can be initialized in parallel.
- * Each level must complete before the next begins.
- */
-export declare const INIT_LEVELS: InitLevel[];
-/**
- * Central registry for memory backend controller lifecycle management.
- *
- * Handles:
- * - Level-based initialization ordering (levels 0-6)
- * - Graceful degradation (each controller fails independently)
- * - Config-driven activation (controllers only instantiate when enabled)
- * - Health check aggregation across all controllers
- * - Ordered shutdown (reverse initialization order)
- *
- * @example
- * ```typescript
- * const registry = new ControllerRegistry();
- * await registry.initialize({
- *   dbPath: './data/memory.db',
- *   dimension: 384,
- *   memory: {
- *     enableHNSW: true,
- *     learningBridge: { sonaMode: 'balanced' },
- * *   },
- * });
- *
- * const reasoning = registry.get<ReasoningBank>('reasoningBank');
- *
- * await registry.shutdown();
- * ```
- */
-export declare class ControllerRegistry extends EventEmitter {
-    private controllers;
-    private backend;
-    private config;
-    private initialized;
-    private initTimeMs;
-    /**
-     * Initialize all controllers in level-based order.
-     *
-     * Each level's controllers are initialized in parallel within the level.
-     * Failures are isolated: a controller that fails to init is marked as
-     * unavailable but does not block other controllers.
-     */
-    initialize(config?: RuntimeConfig): Promise<void>;
-    /**
-     * Shutdown all controllers in reverse initialization order.
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Get a controller instance by name.
-     * Returns null if the controller is not initialized or unavailable.
-     */
-    get<T>(name: ControllerName): T | null;
-    /**
-     * Check if a controller is enabled and initialized.
-     */
-    isEnabled(name: ControllerName): boolean;
-    /**
-     * Aggregate health check across all controllers.
-     */
-    healthCheck(): Promise<RegistryHealthReport>;
-    /**
-     * Get the underlying memory backend instance.
-     */
-    /**
-     * Get the memory backend.
-     */
-    getBackend(): IMemoryBackend | null;
-    /**
-     * Check if the registry is initialized.
-     */
-    isInitialized(): boolean;
-    /**
-     * Get the number of active (successfully initialized) controllers.
-     */
-    getActiveCount(): number;
-    /**
-     * List all registered controller names and their status.
-     */
-    listControllers(): Array<{
-        name: ControllerName;
-        enabled: boolean;
-        level: number;
-    }>;
-    /**
-     * Check whether a controller should be initialized based on config.
-     */
-    private isControllerEnabled;
-    /**
-     * Initialize a single controller with error isolation.
-     */
-    private initController;
-    /**
-     * Factory method to create a controller instance.
-     * Handles CLI-layer controllers; internal controllers are
-     * accessed via backend.getController().
-     */
-    private createController;
-    /**
-     * Shutdown a single controller gracefully.
-     */
-    private shutdownController;
-    /**
-     * Create an EmbeddingService for controllers that need it.
-     * Uses the config's embedding generator or creates a minimal local service.
-     */
-    private createEmbeddingService;
-    /**
-     * Lightweight in-memory tiered store (fallback when HierarchicalMemory
-     * cannot be initialized from legacy module).
-     * Enforces per-tier size limits to prevent unbounded memory growth.
-     */
-    private createTieredMemoryStub;
-    /**
-     * No-op consolidation stub (fallback when MemoryConsolidation
-     * cannot be initialized from legacy module).
-     */
-    private createConsolidationStub;
-}
-export default ControllerRegistry;
-//# sourceMappingURL=controller-registry.d.ts.map

package/dist/controller-registry.d.ts.map

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