@hivehub/rulebook 5.5.2 → 5.8.0

package/dist/memory/legacy-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-migrator.d.ts","sourceRoot":"","sources":["../../src/memory/legacy-migrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqHD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,cAAc,CAAC,CAmDzB"}

package/dist/memory/legacy-migrator.js

@@ -0,0 +1,185 @@
+/**
+ * One-shot legacy SQLite → markdown migrator.
+ *
+ * Lazily imported only when an existing `memory.db` is detected on the
+ * first `MemoryManager.initialize()`. Reads memories + sessions from the
+ * legacy DB (using `better-sqlite3` if available, otherwise `sql.js` as a
+ * fallback) and writes one markdown file per row via `FileStore`.
+ *
+ * After the manager renames `memory.db` → `memory.db.legacy` neither
+ * sql.js nor better-sqlite3 is loaded again at runtime. The migrator
+ * itself isolates those imports inside try-blocks so a missing native
+ * binary is non-fatal — the user keeps the markdown migration that
+ * already succeeded for the rows the fallback could read.
+ */
+import { existsSync, readFileSync } from 'fs';
+async function openDb(dbPath) {
+    try {
+        // better-sqlite3 is an optional native dep — keep the import indirect so
+        // tsc does not require its type declarations when the package is absent
+        // (matches the sql.js pattern below).
+        const moduleName = 'better-sqlite3';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(moduleName);
+        const Database = mod.default ?? mod;
+        const db = new Database(dbPath, { readonly: true });
+        return db;
+    }
+    catch {
+        // Fall through to sql.js
+    }
+    try {
+        // sql.js is deprecated as a runtime dep in v5.6 (file-based store).
+        // It is only used by the legacy migrator and only when the user has it
+        // installed locally. Indirect dynamic import keeps the TS compile clean
+        // even when the package is absent from node_modules.
+        const moduleName = 'sql.js';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const sqlMod = await import(moduleName);
+        const initSqlJs = sqlMod.default ?? sqlMod;
+        const SQL = await initSqlJs();
+        if (!existsSync(dbPath))
+            return null;
+        const raw = new SQL.Database(readFileSync(dbPath));
+        return {
+            prepare: (sql) => ({
+                all: (...params) => {
+                    let processed = sql;
+                    for (const p of params) {
+                        if (p === null || p === undefined)
+                            processed = processed.replace('?', 'NULL');
+                        else if (typeof p === 'string')
+                            processed = processed.replace('?', `'${p.replace(/'/g, "''")}'`);
+                        else
+                            processed = processed.replace('?', String(p));
+                    }
+                    const result = raw.exec(processed);
+                    if (!result.length)
+                        return [];
+                    const cols = result[0].columns;
+                    return result[0].values.map((row) => {
+                        const obj = {};
+                        cols.forEach((c, i) => {
+                            obj[c] = row[i];
+                        });
+                        return obj;
+                    });
+                },
+            }),
+            close: () => raw.close(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+const KNOWN_TYPES = new Set([
+    'bugfix',
+    'feature',
+    'refactor',
+    'decision',
+    'discovery',
+    'change',
+    'observation',
+]);
+function rowToMemory(row) {
+    const id = typeof row.id === 'string' ? row.id : null;
+    const rawType = typeof row.type === 'string' ? row.type : 'observation';
+    const type = (KNOWN_TYPES.has(rawType) ? rawType : 'observation');
+    const title = typeof row.title === 'string' ? row.title : null;
+    if (!id || !title)
+        return null;
+    let tags = [];
+    try {
+        if (typeof row.tags === 'string')
+            tags = JSON.parse(row.tags);
+    }
+    catch {
+        tags = [];
+    }
+    return {
+        id,
+        type,
+        title,
+        summary: typeof row.summary === 'string' ? row.summary : undefined,
+        content: typeof row.content === 'string' ? row.content : '',
+        project: typeof row.project === 'string' ? row.project : '',
+        tags,
+        sessionId: typeof row.session_id === 'string' ? row.session_id : undefined,
+        createdAt: typeof row.created_at === 'number' ? row.created_at : Date.now(),
+        updatedAt: typeof row.updated_at === 'number' ? row.updated_at : Date.now(),
+        accessedAt: typeof row.accessed_at === 'number' ? row.accessed_at : Date.now(),
+    };
+}
+function rowToSession(row) {
+    const id = typeof row.id === 'string' ? row.id : null;
+    const startedAt = typeof row.started_at === 'number' ? row.started_at : null;
+    if (!id || startedAt === null)
+        return null;
+    const status = row.status === 'completed' ? 'completed' : 'active';
+    return {
+        id,
+        project: typeof row.project === 'string' ? row.project : '',
+        status,
+        startedAt,
+        endedAt: typeof row.ended_at === 'number' ? row.ended_at : undefined,
+        summary: typeof row.summary === 'string' ? row.summary : undefined,
+        toolCalls: typeof row.tool_calls === 'number' ? row.tool_calls : 0,
+    };
+}
+/**
+ * Migrate every row of a legacy memory.db into the file-based store.
+ * Idempotent against the FileStore: if a memory id already exists on disk
+ * it is overwritten with the legacy content (same id → same partition).
+ */
+export async function migrateLegacyDb(dbPath, fileStore) {
+    if (!existsSync(dbPath))
+        return { memories: 0, sessions: 0 };
+    const db = await openDb(dbPath);
+    if (!db)
+        return { memories: 0, sessions: 0 };
+    let memories = 0;
+    let sessions = 0;
+    try {
+        const memoryRows = db
+            .prepare(`SELECT id, type, title, content, project, tags, session_id, created_at, updated_at, accessed_at
+         FROM memories`)
+            .all();
+        for (const row of memoryRows) {
+            const m = rowToMemory(row);
+            if (!m)
+                continue;
+            await fileStore.saveMemory(m);
+            memories++;
+        }
+    }
+    catch {
+        // memories table may not exist on partial DBs
+    }
+    try {
+        const sessionRows = db
+            .prepare(`SELECT id, project, status, started_at, ended_at, summary, tool_calls
+         FROM sessions`)
+            .all();
+        for (const row of sessionRows) {
+            const s = rowToSession(row);
+            if (!s)
+                continue;
+            await fileStore.saveSession(s);
+            sessions++;
+        }
+    }
+    catch {
+        // sessions table may not exist
+    }
+    if (db.close) {
+        try {
+            db.close();
+        }
+        catch {
+            // ignore
+        }
+    }
+    return { memories, sessions };
+}
+//# sourceMappingURL=legacy-migrator.js.map

package/dist/memory/legacy-migrator.js.map

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

package/dist/memory/memory-manager.d.ts

@@ -1,35 +1,33 @@
 /**
- * Memory Manager - Main Orchestrator
+ * Memory Manager - File-backed orchestrator (v5.6).
  *
- * Public API that ties all sub-components together:
- * MemoryStore, MemoryVectorizer, HNSWIndex, MemorySearch, MemoryCache.
- * Uses lazy initialization to avoid loading WASM until first use.
+ * Public API kept stable for callers (saveMemory, searchMemories,
+ * getTimeline, getFullDetails, startSession, endSession, getStats,
+ * cleanup, exportMemories, plus the indexer code-graph methods).
+ *
+ * Internally uses the FileStore + FileSearch implementations under
+ * `.rulebook/memory/{memories,sessions,codegraph}/...` instead of
+ * SQLite + HNSW. On startup, an existing legacy `memory.db` is
+ * auto-detected and migrated to markdown one time, then renamed to
+ * `memory.db.legacy`.
  */
 import type { Memory, MemoryConfig, MemorySearchOptions, MemorySearchResult, MemorySession, MemoryStats, MemoryType, TimelineEntry } from './memory-types.js';
+import type { CodeNode, CodeEdge } from '../core/indexer/indexer-types.js';
 export declare class MemoryManager {
     private store;
-    private index;
     private search;
-    private cache;
     private initialized;
-    private hnswInsertCount;
-    private readonly dbPath;
-    private readonly hnswPath;
+    private migrated;
+    /** Resolved root for the file-based store (sibling of legacy `memory.db`). */
+    private readonly memoryRoot;
+    /** Path to the legacy DB file, used for one-shot migration on first init. */
+    private readonly legacyDbPath;
     private readonly maxSizeBytes;
-    private readonly dimensions;
-    private saveCount;
-    private static readonly EVICTION_CHECK_INTERVAL;
     constructor(projectRoot: string, config: MemoryConfig);
     private initPromise;
     private ensureInitialized;
     private doInit;
-    private doInitInner;
-    /**
-     * Strip <private>...</private> tags from content before storing
-     */
     private filterPrivate;
-    private saveHnswIfNeeded;
-    private saveHnswToDisk;
     saveMemory(input: {
         type: MemoryType;
         title: string;
@@ -47,18 +45,21 @@ export declare class MemoryManager {
     startSession(project: string): Promise<MemorySession>;
     endSession(sessionId: string, summary?: string): Promise<void>;
     getStats(): Promise<MemoryStats>;
-    cleanup(force?: boolean): Promise<{
+    /**
+     * Age-based retention. With no `maxAgeDays` arg, this is a no-op (the
+     * legacy LRU byte-budget eviction was removed in v5.6).
+     */
+    cleanup(arg?: boolean | {
+        maxAgeDays?: number;
+    }): Promise<{
         evictedCount: number;
         freedBytes: number;
     }>;
     exportMemories(format?: 'json' | 'csv'): Promise<string>;
-    saveCodeNode(node: import('../core/indexer/indexer-types.js').CodeNode): Promise<void>;
-    saveCodeEdge(edge: import('../core/indexer/indexer-types.js').CodeEdge): Promise<void>;
+    saveCodeNode(node: CodeNode): Promise<void>;
+    saveCodeEdge(edge: CodeEdge): Promise<void>;
     deleteCodeNodesByFile(filePath: string): Promise<void>;
     close(): Promise<void>;
 }
-/**
- * Factory function
- */
 export declare function createMemoryManager(projectRoot: string, config: MemoryConfig): MemoryManager;
 //# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,mBAAmB,CAAC;AAW3B,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAK;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAM;gBAEzC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;IAUrD,OAAO,CAAC,WAAW,CAA8B;YAEnC,iBAAiB;YAajB,MAAM;YAaN,WAAW;IA0BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAchB,UAAU,CAAC,KAAK,EAAE;QACtB,IAAI,EAAE,UAAU,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK3E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3E,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAerD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAwBhC,OAAO,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAStF,cAAc,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBhE,YAAY,CAAC,IAAI,EAAE,OAAO,kCAAkC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtF,YAAY,CAAC,IAAI,EAAE,OAAO,kCAAkC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtF,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,aAAa,CAE5F"}
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAO3E,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IAEzB,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;IAQrD,OAAO,CAAC,WAAW,CAA8B;YAEnC,iBAAiB;YAWjB,MAAM;IAyBpB,OAAO,CAAC,aAAa;IAMf,UAAU,CAAC,KAAK,EAAE;QACtB,IAAI,EAAE,UAAU,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0Bb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO7C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK3E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3E,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAarD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAetC;;;OAGG;IACG,OAAO,CACX,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBlD,cAAc,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBhE,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,aAAa,CAE5F"}

package/dist/memory/memory-manager.js

@@ -1,51 +1,48 @@
 /**
- * Memory Manager - Main Orchestrator
+ * Memory Manager - File-backed orchestrator (v5.6).
  *
- * Public API that ties all sub-components together:
- * MemoryStore, MemoryVectorizer, HNSWIndex, MemorySearch, MemoryCache.
- * Uses lazy initialization to avoid loading WASM until first use.
+ * Public API kept stable for callers (saveMemory, searchMemories,
+ * getTimeline, getFullDetails, startSession, endSession, getStats,
+ * cleanup, exportMemories, plus the indexer code-graph methods).
+ *
+ * Internally uses the FileStore + FileSearch implementations under
+ * `.rulebook/memory/{memories,sessions,codegraph}/...` instead of
+ * SQLite + HNSW. On startup, an existing legacy `memory.db` is
+ * auto-detected and migrated to markdown one time, then renamed to
+ * `memory.db.legacy`.
  */
 import { randomUUID } from 'crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { HNSWIndex } from './hnsw-index.js';
-import { MemoryCache } from './memory-cache.js';
-import { MemorySearch } from './memory-search.js';
-import { MemoryStore } from './memory-store.js';
-import { vectorize } from './memory-vectorizer.js';
+import { existsSync } from 'fs';
+import { rename } from 'fs/promises';
+import { join, dirname } from 'path';
+import { FileStore } from './file-store.js';
+import { FileSearch } from './file-search.js';
 const DEFAULT_DB_PATH = '.rulebook/memory/memory.db';
-const DEFAULT_HNSW_PATH = '.rulebook/memory/vectors.hnsw';
-const DEFAULT_MAX_SIZE = 524288000; // 500MB
-const DEFAULT_DIMENSIONS = 256;
-const HNSW_SAVE_THRESHOLD = 100;
+const DEFAULT_MAX_SIZE = 524288000; // 500MB — kept for getStats compatibility
 const PRIVATE_TAG_REGEX = /<private>[\s\S]*?<\/private>/g;
 export class MemoryManager {
     store = null;
-    index = null;
     search = null;
-    cache = null;
     initialized = false;
-    hnswInsertCount = 0;
-    dbPath;
-    hnswPath;
+    migrated = false;
+    /** Resolved root for the file-based store (sibling of legacy `memory.db`). */
+    memoryRoot;
+    /** Path to the legacy DB file, used for one-shot migration on first init. */
+    legacyDbPath;
     maxSizeBytes;
-    dimensions;
-    saveCount = 0;
-    static EVICTION_CHECK_INTERVAL = 50;
     constructor(projectRoot, config) {
-        this.dbPath = join(projectRoot, config.dbPath ?? DEFAULT_DB_PATH);
-        this.hnswPath = join(projectRoot, config.dbPath ? config.dbPath.replace(/\.db$/, '.hnsw') : DEFAULT_HNSW_PATH);
+        const dbRel = config.dbPath ?? DEFAULT_DB_PATH;
+        const dbAbs = join(projectRoot, dbRel);
+        this.legacyDbPath = dbAbs;
+        this.memoryRoot = dirname(dbAbs);
         this.maxSizeBytes = config.maxSizeBytes ?? DEFAULT_MAX_SIZE;
-        this.dimensions = config.vectorDimensions ?? DEFAULT_DIMENSIONS;
     }
     initPromise = null;
     async ensureInitialized() {
         if (this.initialized)
             return;
-        // Deduplicate concurrent init calls (e.g. multiple tool calls hitting memory at once)
         if (!this.initPromise) {
             this.initPromise = this.doInit().catch((err) => {
-                // Reset so next call retries instead of getting stuck on a rejected promise
                 this.initPromise = null;
                 throw err;
             });
@@ -53,56 +50,29 @@ export class MemoryManager {
         await this.initPromise;
     }
     async doInit() {
-        const INIT_TIMEOUT_MS = parseInt(process.env.RULEBOOK_MEMORY_INIT_TIMEOUT_MS ?? '8000', 10);
-        const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error(`Memory initialization timed out after ${INIT_TIMEOUT_MS}ms`)), INIT_TIMEOUT_MS));
-        await Promise.race([this.doInitInner(), timeout]);
-    }
-    async doInitInner() {
-        // Initialize store (loads WASM sql.js — can be slow on first load)
-        this.store = new MemoryStore(this.dbPath);
+        this.store = new FileStore(this.memoryRoot);
         await this.store.initialize();
-        // Initialize HNSW index
-        if (existsSync(this.hnswPath)) {
+        this.search = new FileSearch(this.store);
+        // One-shot legacy DB migration. The runtime never reads SQLite again.
+        if (!this.migrated && existsSync(this.legacyDbPath)) {
             try {
-                const data = readFileSync(this.hnswPath);
-                this.index = HNSWIndex.deserialize(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+                const { migrateLegacyDb } = await import('./legacy-migrator.js');
+                await migrateLegacyDb(this.legacyDbPath, this.store);
+                await rename(this.legacyDbPath, this.legacyDbPath + '.legacy');
+                this.store.invalidateCaches();
             }
-            catch {
-                this.index = new HNSWIndex({ dimensions: this.dimensions });
+            catch (err) {
+                // Non-fatal: surface but keep the manager functional.
+                console.error('[MemoryManager] legacy DB migration failed; continuing with file-only store:', err instanceof Error ? err.message : String(err));
             }
+            this.migrated = true;
         }
-        else {
-            this.index = new HNSWIndex({ dimensions: this.dimensions });
-        }
-        // Initialize search and cache
-        this.search = new MemorySearch(this.store, this.index, this.dimensions);
-        this.cache = new MemoryCache(this.store, this.index, this.maxSizeBytes);
         this.initialized = true;
     }
-    /**
-     * Strip <private>...</private> tags from content before storing
-     */
     filterPrivate(content) {
         return content.replace(PRIVATE_TAG_REGEX, '[REDACTED]');
     }
-    saveHnswIfNeeded() {
-        this.hnswInsertCount++;
-        if (this.hnswInsertCount >= HNSW_SAVE_THRESHOLD) {
-            this.saveHnswToDisk();
-            this.hnswInsertCount = 0;
-        }
-    }
-    saveHnswToDisk() {
-        if (!this.index || this.index.size === 0)
-            return;
-        const dir = join(this.hnswPath, '..');
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        const buffer = this.index.serialize();
-        writeFileSync(this.hnswPath, Buffer.from(buffer));
-    }
-    // --- Public API ---
+    // ── public API ─────────────────────────────────────────────────────
     async saveMemory(input) {
         await this.ensureInitialized();
         const now = Date.now();
@@ -119,35 +89,26 @@ export class MemoryManager {
             updatedAt: now,
             accessedAt: now,
         };
-        this.store.saveMemory(memory);
-        // Vectorize using title + summary (if available) + content for better semantic relevance
-        const textToVectorize = [memory.title, memory.summary || memory.content.substring(0, 300)]
-            .filter(Boolean)
-            .join(' ');
-        const vec = vectorize(textToVectorize, this.dimensions);
-        this.index.add(memory.id, vec);
-        this.saveHnswIfNeeded();
-        // Check cache limits periodically (not on every save — getDbSizeBytes is cheap now
-        // but eviction itself is expensive and rarely needed)
-        this.saveCount++;
-        if (this.saveCount >= MemoryManager.EVICTION_CHECK_INTERVAL) {
-            this.saveCount = 0;
-            this.cache.checkAndEvict();
+        await this.store.saveMemory(memory);
+        // Refresh the inverted-index sidecar lazily for large corpora.
+        try {
+            await this.search.maybeRebuildIndex();
+        }
+        catch {
+            // non-fatal — search falls back to in-memory build per call
         }
         return memory;
     }
     async getMemory(id) {
         await this.ensureInitialized();
-        const memory = this.store.getMemory(id);
-        if (memory) {
-            this.store.updateAccessedAt(id);
-        }
+        const memory = await this.store.getMemory(id);
+        if (memory)
+            await this.store.updateAccessedAt(id);
         return memory;
     }
     async deleteMemory(id) {
         await this.ensureInitialized();
-        this.store.deleteMemory(id);
-        this.index.remove(id);
+        await this.store.deleteMemory(id);
     }
     async searchMemories(options) {
         await this.ensureInitialized();
@@ -170,43 +131,62 @@ export class MemoryManager {
             startedAt: Date.now(),
             toolCalls: 0,
         };
-        this.store.createSession(session);
+        await this.store.saveSession(session);
         return session;
     }
     async endSession(sessionId, summary) {
         await this.ensureInitialized();
-        this.store.endSession(sessionId, summary);
+        const existing = await this.store.getSession(sessionId);
+        if (!existing)
+            return;
+        existing.status = 'completed';
+        existing.endedAt = Date.now();
+        if (summary !== undefined)
+            existing.summary = summary;
+        await this.store.saveSession(existing);
     }
     async getStats() {
         await this.ensureInitialized();
-        const dbSize = this.store.getDbSizeBytes();
-        const memoryCount = this.store.getMemoryCount();
-        const sessionCount = this.store.getSessionCount();
+        const stats = await this.store.getStats();
         return {
-            dbSizeBytes: dbSize,
-            memoryCount,
-            sessionCount,
-            oldestMemory: this.store.getOldestMemoryTimestamp(),
-            newestMemory: this.store.getNewestMemoryTimestamp(),
+            dbSizeBytes: stats.totalBytes,
+            memoryCount: stats.memoryCount,
+            sessionCount: stats.sessionCount,
+            fileCount: stats.fileCount,
+            oldestMemory: stats.oldestMemory,
+            newestMemory: stats.newestMemory,
             maxSizeBytes: this.maxSizeBytes,
-            usagePercent: (dbSize / this.maxSizeBytes) * 100,
-            indexHealth: this.index.size === memoryCount
-                ? 'good'
-                : Math.abs(this.index.size - memoryCount) < memoryCount * 0.1
-                    ? 'degraded'
-                    : 'needs-rebuild',
+            usagePercent: this.maxSizeBytes > 0 ? (stats.totalBytes / this.maxSizeBytes) * 100 : 0,
         };
     }
-    async cleanup(force = false) {
+    /**
+     * Age-based retention. With no `maxAgeDays` arg, this is a no-op (the
+     * legacy LRU byte-budget eviction was removed in v5.6).
+     */
+    async cleanup(arg) {
         await this.ensureInitialized();
-        if (force) {
-            return this.cache.forceEvict();
+        const maxAgeDays = typeof arg === 'object' && arg !== null ? arg.maxAgeDays : undefined;
+        if (maxAgeDays === undefined || maxAgeDays <= 0) {
+            return { evictedCount: 0, freedBytes: 0 };
         }
-        return this.cache.checkAndEvict();
+        const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+        const all = await this.store.listAllMemories();
+        let evicted = 0;
+        let freed = 0;
+        const before = (await this.store.getStats()).totalBytes;
+        for (const m of all) {
+            if (m.createdAt < cutoff) {
+                await this.store.deleteMemory(m.id);
+                evicted++;
+            }
+        }
+        const after = (await this.store.getStats()).totalBytes;
+        freed = Math.max(0, before - after);
+        return { evictedCount: evicted, freedBytes: freed };
     }
     async exportMemories(format = 'json') {
         await this.ensureInitialized();
-        const memories = this.store.listMemories({ limit: 1000 });
+        const memories = await this.store.listMemories({ limit: 10000 });
         if (format === 'csv') {
             const header = 'id,type,title,content,project,tags,createdAt,updatedAt';
             const rows = memories.map((m) => `"${m.id}","${m.type}","${m.title.replace(/"/g, '""')}","${m.content.replace(/"/g, '""')}","${m.project}","${m.tags.join(';')}",${m.createdAt},${m.updatedAt}`);
@@ -214,52 +194,29 @@ export class MemoryManager {
         }
         return JSON.stringify(memories, null, 2);
     }
-    // --- Background Indexer Graph Persistence ---
+    // ── background indexer code-graph (JSONL log) ─────────────────────
     async saveCodeNode(node) {
         await this.ensureInitialized();
-        // Check if hash is exactly the same to avoid re-vectorizing unchanged chunks
-        const existingHash = this.store.getCodeNodeByHash(node.id);
-        if (existingHash === node.hash) {
-            return; // Unchanged
-        }
-        this.store.saveCodeNode(node);
-        // Vectorize code chunks for FTS/HNSW semantic search
-        const textToVectorize = [node.name, node.summary || '', node.content].filter(Boolean).join(' ');
-        // Important: We prepend an identifier so search knows it's a code node
-        const vecId = `__code__${node.id}`;
-        const vec = vectorize(textToVectorize, this.dimensions);
-        this.index.add(vecId, vec);
-        this.saveHnswIfNeeded();
+        const existing = await this.store.getCodeNodeHash(node.id);
+        if (existing === node.hash)
+            return;
+        await this.store.appendCodeNode(node);
     }
     async saveCodeEdge(edge) {
         await this.ensureInitialized();
-        this.store.saveCodeEdge(edge);
+        await this.store.appendCodeEdge(edge);
     }
     async deleteCodeNodesByFile(filePath) {
         await this.ensureInitialized();
-        // Query node IDs before deleting from SQLite so we can also clean HNSW
-        const nodeIds = this.store.getCodeNodeIdsByFile(filePath);
-        this.store.deleteCodeNodesByFile(filePath);
-        // Remove corresponding vectors from HNSW to prevent orphan accumulation
-        for (const id of nodeIds) {
-            this.index.remove(`__code__${id}`);
-        }
+        await this.store.deleteCodeNodesByFile(filePath);
     }
     async close() {
-        if (this.store) {
-            this.store.close();
-        }
-        this.saveHnswToDisk();
         this.initialized = false;
         this.store = null;
-        this.index = null;
         this.search = null;
-        this.cache = null;
+        this.initPromise = null;
     }
 }
-/**
- * Factory function
- */
 export function createMemoryManager(projectRoot, config) {
     return new MemoryManager(projectRoot, config);
 }