@monoes/memory 1.0.15 → 1.0.16

package/dist/index.js

@@ -1,342 +1,28 @@
 /**
- * @monomind/memory - V1 Unified Memory System
+ * @monomind/memory - Persistent Memory Backends for Monomind
  *
- * Provides a unified memory interface with ANN indexing for fast vector
- * search — SQLite-backed (better-sqlite3, sql.js WASM fallback) as of
- * 2026-07. LanceDB support was fully removed (was already unreachable from
- * the live bridge path; the migration escape hatch for legacy LanceDB stores
- * is gone too — migrate before upgrading past this point if you still have
- * one). UnifiedMemoryService below is backed by SQLiteBackend. It is still
- * not the live CLI memory path — the CLI's
- * memory-bridge.ts talks to SQLiteBackend/SqlJsBackend directly and does not
- * go through this class — but external @monomind/memory consumers who
- * instantiate it now get the current engine, not the legacy adapter.
+ * Provides SQLite-backed memory engines (better-sqlite3 native driver with
+ * sql.js WASM fallback), dense vector embeddings storage, pure-JS HNSW indexing,
+ * document chunking/retrieval, and cross-session checkpointers.
  *
  * @module @monomind/memory
- *
- * @example
- * ```typescript
- * import { UnifiedMemoryService, query, QueryTemplates } from '@monomind/memory';
- *
- * // Initialize the memory service
- * const memory = new UnifiedMemoryService({
- *   dimensions: 1536,
- *   cacheEnabled: true,
- *   embeddingGenerator: async (text) => embeddings.embed(text),
- * });
- *
- * await memory.initialize();
- *
- * // Store entries
- * await memory.store({
- *   key: 'auth-patterns',
- *   content: 'OAuth 2.0 implementation patterns for secure authentication',
- *   tags: ['auth', 'security', 'patterns'],
- * });
- *
- * // Semantic search
- * const results = await memory.semanticSearch('user authentication best practices', 5);
- *
- * // Query with fluent builder
- * const entries = await memory.query(
- *   query()
- *     .semantic('security vulnerabilities')
- *     .inNamespace('security')
- *     .withTags(['critical'])
- *     .threshold(0.8)
- *     .limit(10)
- *     .build()
- * );
- * ```
  */
-// Utility Functions and Constants (runtime values)
+// Utility Functions and Constants
 export { generateMemoryId, createDefaultEntry, PERFORMANCE_TARGETS, } from './types.js';
-// ===== Controller Registry (ADR-053) =====
-export { ControllerRegistry, INIT_LEVELS } from './controller-registry.js';
 // ===== Core Components =====
-export { SQLiteBackend } from './sqlite-backend.js';
+import { SQLiteBackend } from './sqlite-backend.js';
+export { SQLiteBackend };
 export { SqlJsBackend } from './sqljs-backend.js';
 export { HNSWIndex } from './hnsw-index.js';
-export { CacheManager, TieredCacheManager } from './cache-manager.js';
+export { CacheManager } from './cache-manager.js';
 export { QueryBuilder, query, QueryTemplates } from './query-builder.js';
 export { MemoryMigrator, createMigrator, migrateMultipleSources } from './migration.js';
-export { createDatabase, getPlatformInfo, getAvailableProviders } from './database-provider.js';
-// ===== Graph Checkpointing (Task 08) =====
+// ===== Graph Checkpointing =====
 export { SwarmCheckpointer } from './checkpointer.js';
-// ===== Per-Agent Knowledge Base (Task 28) =====
+// ===== Document Chunker & Knowledge Base =====
 export { chunkDocument, KnowledgeStore, KnowledgeRetriever } from './knowledge/index.js';
-// ===== Unified Memory Service =====
-import { EventEmitter } from 'node:events';
-import { createDefaultEntry, } from './types.js';
-import { SQLiteBackend } from './sqlite-backend.js';
-import { MemoryMigrator } from './migration.js';
-/**
- * Unified Memory Service
- *
- * High-level interface for the V1 memory system, backed by SQLiteBackend.
- * Provides a simple API for common operations with automatic embedding support.
- *
- * RETENTION NOTE (2026-07) — read before deleting this as "dead code":
- *
- * This class, the four `create*Service` factories below, and the package's
- * default export have ZERO callers inside this monorepo. The live CLI memory
- * path is `packages/@monomind/cli/src/memory/memory-bridge.ts`, which
- * constructs SQLiteBackend/SqlJsBackend directly and never touches this class.
- * Every in-repo import of `@monoes/memory` pulls a *different* symbol
- * (SwarmCheckpointer, SQLiteBackend, HNSWIndex, chunkDocument).
- *
- * It is nevertheless RETAINED DELIBERATELY, not by accident: `@monoes/memory`
- * is published to npm, and this is its documented headline API, its module
- * docblock example, and its `export default`. Deleting it is a breaking change
- * to a published package's primary entry point, which is a different decision
- * from removing unreachable *internal* code — and the usual justification for
- * deleting dead code (it has silently rotted) does not apply here, because
- * `src/index.test.ts` now covers the whole surface: lifecycle, the full
- * IMemoryBackend implementation, every convenience method, sharing, and all
- * four factories.
- *
- * If you do decide to remove it, treat it as a semver-major change to
- * @monoes/memory and delete `src/index.test.ts` with it.
- */
-export class UnifiedMemoryService extends EventEmitter {
-    adapter;
-    config;
-    initialized = false;
-    constructor(config = {}) {
-        super();
-        this.config = {
-            dimensions: 1536,
-            autoEmbed: true,
-            ...config,
-        };
-        this.adapter = new SQLiteBackend({
-            databasePath: this.config.persistenceEnabled === false ? ':memory:' : (this.config.persistencePath ?? ':memory:'),
-            defaultNamespace: this.config.defaultNamespace ?? 'default',
-            embeddingGenerator: this.config.embeddingGenerator,
-        });
-        // Forward adapter events
-        this.adapter.on('entry:stored', (data) => this.emit('entry:stored', data));
-        this.adapter.on('entry:updated', (data) => this.emit('entry:updated', data));
-        this.adapter.on('entry:deleted', (data) => this.emit('entry:deleted', data));
-    }
-    // ===== Lifecycle =====
-    async initialize() {
-        if (this.initialized)
-            return;
-        await this.adapter.initialize();
-        this.initialized = true;
-        this.emit('initialized');
-    }
-    async shutdown() {
-        if (!this.initialized)
-            return;
-        await this.adapter.shutdown();
-        this.initialized = false;
-        this.emit('shutdown');
-    }
-    // ===== IMemoryBackend Implementation =====
-    async store(entry) {
-        return this.adapter.store(entry);
-    }
-    async get(id) {
-        return this.adapter.get(id);
-    }
-    async getByKey(namespace, key) {
-        return this.adapter.getByKey(namespace, key);
-    }
-    async update(id, update) {
-        return this.adapter.update(id, update);
-    }
-    async delete(id) {
-        return this.adapter.delete(id);
-    }
-    async query(query) {
-        return this.adapter.query(query);
-    }
-    async search(embedding, options) {
-        return this.adapter.search(embedding, options);
-    }
-    async bulkInsert(entries) {
-        return this.adapter.bulkInsert(entries);
-    }
-    async bulkDelete(ids) {
-        return this.adapter.bulkDelete(ids);
-    }
-    async count(namespace) {
-        return this.adapter.count(namespace);
-    }
-    async listNamespaces() {
-        return this.adapter.listNamespaces();
-    }
-    async clearNamespace(namespace) {
-        return this.adapter.clearNamespace(namespace);
-    }
-    async getStats() {
-        return this.adapter.getStats();
-    }
-    async healthCheck() {
-        return this.adapter.healthCheck();
-    }
-    // ===== Convenience Methods =====
-    /**
-     * Store an entry from simple input
-     */
-    async storeEntry(input) {
-        const entry = createDefaultEntry(input);
-        await this.adapter.store(entry);
-        return entry;
-    }
-    /**
-     * Semantic search by content string
-     */
-    async semanticSearch(content, k = 10, threshold) {
-        const gen = this.config.embeddingGenerator;
-        if (!gen)
-            return [];
-        const embedding = await gen(content);
-        return this.adapter.search(embedding, { k, threshold });
-    }
-    /**
-     * Find similar entries to a given entry
-     */
-    async findSimilar(id, k = 5) {
-        const entry = await this.get(id);
-        if (!entry || !entry.embedding) {
-            return [];
-        }
-        const results = await this.search(entry.embedding, { k: k + 1 });
-        // Filter out the source entry
-        return results.filter((r) => r.entry.id !== id).slice(0, k);
-    }
-    /**
-     * Get or create an entry
-     */
-    async getOrCreate(namespace, key, creator) {
-        const existing = await this.getByKey(namespace, key);
-        if (existing)
-            return existing;
-        const input = await creator();
-        return this.storeEntry({ ...input, namespace, key });
-    }
-    /**
-     * Append content to an existing entry
-     */
-    async appendContent(id, content) {
-        const entry = await this.get(id);
-        if (!entry)
-            return null;
-        return this.update(id, {
-            content: entry.content + '\n' + content,
-        });
-    }
-    /**
-     * Add tags to an existing entry
-     */
-    async addTags(id, tags) {
-        const entry = await this.get(id);
-        if (!entry)
-            return null;
-        const newTags = [...new Set([...entry.tags, ...tags])];
-        return this.update(id, { tags: newTags });
-    }
-    /**
-     * Remove tags from an existing entry
-     */
-    async removeTags(id, tags) {
-        const entry = await this.get(id);
-        if (!entry)
-            return null;
-        const newTags = entry.tags.filter((t) => !tags.includes(t));
-        return this.update(id, { tags: newTags });
-    }
-    // ===== Migration =====
-    /**
-     * Migrate from a legacy memory source
-     */
-    async migrateFrom(source, sourcePath, options = {}) {
-        const migrator = new MemoryMigrator(this.adapter, { source, sourcePath, ...options }, this.config.embeddingGenerator);
-        // Forward migration events
-        migrator.on('migration:started', (data) => this.emit('migration:started', data));
-        migrator.on('migration:progress', (data) => this.emit('migration:progress', data));
-        migrator.on('migration:completed', (data) => this.emit('migration:completed', data));
-        migrator.on('migration:failed', (data) => this.emit('migration:failed', data));
-        migrator.on('migration:error', (data) => this.emit('migration:error', data));
-        migrator.on('migration:warning', (data) => this.emit('migration:warning', data));
-        return migrator.migrate();
-    }
-    // ===== Cross-Agent Memory Sharing =====
-    /**
-     * Share an entry with another agent
-     */
-    async shareWith(id, agentId) {
-        const entry = await this.get(id);
-        if (!entry)
-            return null;
-        const sharedWith = entry.metadata.sharedWith || [];
-        if (!sharedWith.includes(agentId)) {
-            sharedWith.push(agentId);
-        }
-        return this.update(id, {
-            metadata: { ...entry.metadata, sharedWith },
-        });
-    }
-    /**
-     * Get entries shared with a specific agent
-     */
-    async getSharedWith(agentId) {
-        const all = await this.query({ type: 'hybrid', limit: 10000 });
-        return all.filter((entry) => {
-            const sharedWith = entry.metadata.sharedWith || [];
-            return sharedWith.includes(agentId);
-        });
-    }
-    // ===== Utility =====
-    /**
-     * Get the underlying adapter for advanced operations
-     */
-    getAdapter() {
-        return this.adapter;
-    }
-    /**
-     * Check if the service is initialized
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-}
-// ===== Factory Functions =====
-/**
- * Create a simple in-memory service (for testing)
- */
-export function createInMemoryService() {
-    return new UnifiedMemoryService({ persistenceEnabled: false });
-}
-/**
- * Create a persistent memory service
- */
-export function createPersistentService(path) {
-    return new UnifiedMemoryService({ persistenceEnabled: true, persistencePath: path });
-}
-/**
- * Create a memory service with embedding support
- */
-export function createEmbeddingService(embeddingGenerator, dimensions = 1536) {
-    return new UnifiedMemoryService({ embeddingGenerator, dimensions, autoEmbed: true });
-}
-/**
- * Create a SQLite-backed memory service with persistence
- */
-export function createHybridService(databasePath, embeddingGenerator, dimensions = 1536) {
-    return new UnifiedMemoryService({
-        embeddingGenerator,
-        dimensions,
-        autoEmbed: true,
-        persistenceEnabled: true,
-        persistencePath: databasePath,
-    });
-}
-// ===== Prompt Version Management (Task 24) =====
+// ===== Prompt Version Management =====
 export { PromptVersionStore } from './prompt-version-store.js';
 // Default export
-export default UnifiedMemoryService;
+export default SQLiteBackend;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuDH,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExF,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,gDAAgD;AAChD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAUzF,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAO/D,iBAAiB;AACjB,eAAe,aAAa,CAAC"}

package/dist/sqlite-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-backend.d.ts","sourceRoot":"","sources":["../src/sqlite-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAElB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;uCAImC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAYD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,YAAY,CAAsB;IAE1C,YAAY,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EASpD;IAED,UAAgB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAkC/C;CACF;eAEc,aAAa"}
+{"version":3,"file":"sqlite-backend.d.ts","sourceRoot":"","sources":["../src/sqlite-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAElB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;uCAImC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAYD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,YAAY,CAAsB;IAE1C,YAAY,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EASpD;IAED,UAAgB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAkC/C;CACF;eAEc,aAAa"}

package/dist/sqlite-backend.js

@@ -10,9 +10,8 @@
  *
  * @module v1/memory/sqlite-backend
  */
-// better-sqlite3 is an OPTIONAL dependency — sql.js is the documented fallback,
-// and database-provider.ts recommends it outright on Windows, where node-gyp
-// routinely fails to build native modules. This import must therefore be lazy.
+// better-sqlite3 is an OPTIONAL dependency — sql.js is the documented fallback
+// on platforms where native compilation is unavailable. This import must therefore be lazy.
 //
 // It used to be a static top-level import, and because index.ts re-exports
 // SQLiteBackend, that made `import '@monoes/memory'` throw

package/dist/sqlite-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-backend.js","sourceRoot":"","sources":["../src/sqlite-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,2EAA2E;AAC3E,2DAA2D;AAC3D,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,2CAA2C;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAoCrE,MAAM,cAAc,GAAwB;IAC1C,YAAY,EAAE,UAAU;IACxB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,KAAK;IACd,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IACnC,YAAY,CAAsB;IAE1C,YAAY,MAAM,GAAiC,EAAE;QACnD,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAChD,KAAK,CAAC;YACJ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,UAAU;QAMxB,IAAI,QAA2E,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC3C,QAAQ,GAAI,GAA+C,CAAC,OAAO,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,6DAA6D;YAC7D,oDAAoD;YACpD,MAAM,IAAI,KAAK,CACb,wFAAwF;gBACxF,IAAK,KAAe,CAAC,OAAO,wDAAwD;gBACpF,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE;YACtD,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,GAAG,CAAC;YAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;QACxG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC/B,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAClC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,kBAAkB,CAAC,EAAW,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"sqlite-backend.js","sourceRoot":"","sources":["../src/sqlite-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+EAA+E;AAC/E,4FAA4F;AAC5F,EAAE;AACF,2EAA2E;AAC3E,2DAA2D;AAC3D,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,2CAA2C;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAoCrE,MAAM,cAAc,GAAwB;IAC1C,YAAY,EAAE,UAAU;IACxB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,KAAK;IACd,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IACnC,YAAY,CAAsB;IAE1C,YAAY,MAAM,GAAiC,EAAE;QACnD,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAChD,KAAK,CAAC;YACJ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,UAAU;QAMxB,IAAI,QAA2E,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC3C,QAAQ,GAAI,GAA+C,CAAC,OAAO,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,6DAA6D;YAC7D,oDAAoD;YACpD,MAAM,IAAI,KAAK,CACb,wFAAwF;gBACxF,IAAK,KAAe,CAAC,OAAO,wDAAwD;gBACpF,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE;YACtD,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,GAAG,CAAC;YAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;QACxG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC/B,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAClC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,kBAAkB,CAAC,EAAW,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/memory",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "type": "module",
   "description": "Memory module - JSON pattern store, SQLite + embeddings backend, and a standalone pure-JS HNSW index; not a single unified backend",
   "main": "dist/index.js",

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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"}