@timmeck/brain-core 2.0.1 → 2.0.2

package/dist/db/__tests__/connection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/db/__tests__/connection.test.js

@@ -0,0 +1,135 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+vi.mock('../../utils/logger.js', () => ({
+    getLogger: () => ({
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    }),
+}));
+import { createConnection } from '../connection.js';
+describe('createConnection', () => {
+    const tmpDbs = [];
+    /** Helper: generate a unique temp DB path. */
+    function tmpDbPath(suffix = '') {
+        const p = path.join(os.tmpdir(), `brain-core-test-${Date.now()}-${Math.random().toString(36).slice(2)}${suffix}.db`);
+        tmpDbs.push(p);
+        return p;
+    }
+    afterEach(() => {
+        // Clean up any temp DB files we created
+        for (const p of tmpDbs) {
+            try {
+                fs.unlinkSync(p);
+            }
+            catch {
+                // ignore if already deleted
+            }
+            // WAL / SHM sidecars
+            for (const ext of ['-wal', '-shm']) {
+                try {
+                    fs.unlinkSync(p + ext);
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        tmpDbs.length = 0;
+    });
+    it('returns a usable Database instance', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        expect(db).toBeDefined();
+        // Verify we can execute a simple query
+        const row = db.prepare('SELECT 1 AS val').get();
+        expect(row.val).toBe(1);
+        db.close();
+    });
+    it('creates the parent directory if it does not exist', () => {
+        const nested = path.join(os.tmpdir(), `brain-core-test-nested-${Date.now()}`, 'sub', 'dir', 'test.db');
+        tmpDbs.push(nested);
+        const db = createConnection(nested);
+        expect(fs.existsSync(path.dirname(nested))).toBe(true);
+        db.close();
+        // cleanup the nested dir
+        fs.rmSync(path.join(os.tmpdir(), path.basename(path.dirname(path.dirname(path.dirname(nested))))), {
+            recursive: true,
+            force: true,
+        });
+    });
+    it('sets journal_mode to WAL', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        const result = db.pragma('journal_mode');
+        expect(result[0].journal_mode.toLowerCase()).toBe('wal');
+        db.close();
+    });
+    it('sets synchronous to NORMAL (1)', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        const result = db.pragma('synchronous');
+        // NORMAL = 1
+        expect(result[0].synchronous).toBe(1);
+        db.close();
+    });
+    it('sets cache_size to 10000', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        const result = db.pragma('cache_size');
+        // Negative means KB, positive means pages; the source sets 10000 (pages)
+        expect(result[0].cache_size).toBe(10000);
+        db.close();
+    });
+    it('enables foreign_keys', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        const result = db.pragma('foreign_keys');
+        expect(result[0].foreign_keys).toBe(1);
+        db.close();
+    });
+    it('works with an in-memory database path (:memory:)', () => {
+        // :memory: has dirname "." which already exists, so no mkdir needed
+        const db = createConnection(':memory:');
+        const row = db.prepare('SELECT 42 AS answer').get();
+        expect(row.answer).toBe(42);
+        db.close();
+    });
+    it('supports creating tables and inserting data', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+        db.prepare('INSERT INTO test (name) VALUES (?)').run('hello');
+        const row = db.prepare('SELECT name FROM test WHERE id = 1').get();
+        expect(row.name).toBe('hello');
+        db.close();
+    });
+    it('enforces foreign key constraints', () => {
+        const dbPath = tmpDbPath();
+        const db = createConnection(dbPath);
+        db.exec(`
+      CREATE TABLE parent (id INTEGER PRIMARY KEY);
+      CREATE TABLE child (id INTEGER PRIMARY KEY, parent_id INTEGER REFERENCES parent(id));
+    `);
+        // Inserting a child with a non-existent parent should fail
+        expect(() => {
+            db.prepare('INSERT INTO child (parent_id) VALUES (?)').run(999);
+        }).toThrow();
+        db.close();
+    });
+    it('can open the same file path twice without error', () => {
+        const dbPath = tmpDbPath();
+        const db1 = createConnection(dbPath);
+        const db2 = createConnection(dbPath);
+        db1.exec('CREATE TABLE shared (id INTEGER PRIMARY KEY)');
+        db1.prepare('INSERT INTO shared (id) VALUES (1)').run();
+        const row = db2.prepare('SELECT id FROM shared WHERE id = 1').get();
+        expect(row.id).toBe(1);
+        db1.close();
+        db2.close();
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/dist/db/__tests__/connection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.test.js","sourceRoot":"","sources":["../../../src/db/__tests__/connection.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;KACf,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,8CAA8C;IAC9C,SAAS,SAAS,CAAC,MAAM,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CACjB,EAAE,CAAC,MAAM,EAAE,EACX,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,CACnF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IAED,SAAS,CAAC,GAAG,EAAE;QACb,wCAAwC;QACxC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;YACD,qBAAqB;YACrB,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACzB,uCAAuC;QACvC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,EAAqB,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,EAAE,CAAC,MAAM,EAAE,EACX,0BAA0B,IAAI,CAAC,GAAG,EAAE,EAAE,EACtC,KAAK,EACL,KAAK,EACL,SAAS,CACV,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpB,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,EAAE,CAAC,KAAK,EAAE,CAAC;QAEX,yBAAyB;QACzB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YACjG,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAA+B,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1D,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAA8B,CAAC;QACrE,aAAa;QACb,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAA6B,CAAC;QACnE,yEAAyE;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAA+B,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,oEAAoE;QACpE,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAwB,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEpC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACjE,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAsB,CAAC;QACvF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEpC,EAAE,CAAC,IAAI,CAAC;;;KAGP,CAAC,CAAC;QAEH,2DAA2D;QAC3D,MAAM,CAAC,GAAG,EAAE;YACV,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAEb,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAErC,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACzD,GAAG,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAE,CAAC;QAExD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAoB,CAAC;QACtF,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEvB,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/memory/__tests__/base-memory-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/memory/__tests__/base-memory-engine.test.js

@@ -0,0 +1,233 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+vi.mock('../../utils/logger.js', () => ({
+    getLogger: () => ({
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    }),
+}));
+vi.mock('../../embeddings/engine.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        BaseEmbeddingEngine: actual.BaseEmbeddingEngine,
+    };
+});
+import { BaseMemoryEngine } from '../base-memory-engine.js';
+import { BaseEmbeddingEngine } from '../../embeddings/engine.js';
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                           */
+/* ------------------------------------------------------------------ */
+const DEFAULT_CONFIG = {
+    intervalMs: 1000,
+    expiryCheckEnabled: true,
+    consolidationEnabled: true,
+    importanceDecayDays: 30,
+};
+/** Build a minimal MemoryRecord with overrides. */
+function makeMemory(overrides = {}) {
+    return {
+        id: 1,
+        project_id: null,
+        session_id: null,
+        category: 'fact',
+        key: null,
+        content: 'test memory',
+        importance: 5,
+        source: 'explicit',
+        tags: null,
+        expires_at: null,
+        superseded_by: null,
+        active: 1,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+        embedding: null,
+        ...overrides,
+    };
+}
+/**
+ * Concrete subclass of the abstract BaseMemoryEngine for testing.
+ * Allows tests to control what getActiveMemoriesWithEmbeddings() and textSearch() return.
+ */
+class TestMemoryEngine extends BaseMemoryEngine {
+    cycleCount = 0;
+    memoriesWithEmbeddings = [];
+    textSearchResults = [];
+    textSearchCalls = [];
+    runCycle() {
+        this.cycleCount++;
+    }
+    getActiveMemoriesWithEmbeddings() {
+        return this.memoriesWithEmbeddings;
+    }
+    textSearch(query, limit) {
+        this.textSearchCalls.push({ query, limit });
+        return this.textSearchResults.slice(0, limit);
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Tests                                                             */
+/* ------------------------------------------------------------------ */
+describe('BaseMemoryEngine', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    /* ---------- Timer lifecycle ---------- */
+    it('start() runs cycles at the configured interval', () => {
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        engine.start();
+        expect(engine.cycleCount).toBe(0);
+        vi.advanceTimersByTime(1000);
+        expect(engine.cycleCount).toBe(1);
+        vi.advanceTimersByTime(2000);
+        expect(engine.cycleCount).toBe(3);
+        engine.stop();
+    });
+    it('stop() halts the timer so no further cycles run', () => {
+        const engine = new TestMemoryEngine({ ...DEFAULT_CONFIG, intervalMs: 500 });
+        engine.start();
+        vi.advanceTimersByTime(500);
+        expect(engine.cycleCount).toBe(1);
+        engine.stop();
+        vi.advanceTimersByTime(5000);
+        expect(engine.cycleCount).toBe(1);
+    });
+    it('stop() is safe to call multiple times', () => {
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        engine.start();
+        engine.stop();
+        expect(() => engine.stop()).not.toThrow();
+    });
+    it('stop() is safe to call without start()', () => {
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        expect(() => engine.stop()).not.toThrow();
+    });
+    it('errors in runCycle are caught and do not crash the timer', () => {
+        class FailingEngine extends BaseMemoryEngine {
+            getActiveMemoriesWithEmbeddings() {
+                return [];
+            }
+            textSearch() {
+                return [];
+            }
+            runCycle() {
+                throw new Error('cycle explosion');
+            }
+        }
+        const engine = new FailingEngine(DEFAULT_CONFIG);
+        engine.start();
+        // Should not throw despite runCycle throwing
+        expect(() => vi.advanceTimersByTime(1000)).not.toThrow();
+        engine.stop();
+    });
+    /* ---------- setEmbeddingEngine ---------- */
+    it('setEmbeddingEngine attaches an embedding engine', () => {
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        const embeddingEngine = new BaseEmbeddingEngine({ enabled: true });
+        engine.setEmbeddingEngine(embeddingEngine);
+        // Verify it was set (access via semanticRecall behavior below)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        expect(engine.embeddingEngine).toBe(embeddingEngine);
+    });
+    /* ---------- semanticRecall ---------- */
+    it('semanticRecall falls back to textSearch when no embedding engine is set', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        const expected = [makeMemory({ id: 1, content: 'hello' })];
+        engine.textSearchResults = expected;
+        const results = await engine.semanticRecall('hello', 5);
+        expect(results).toEqual(expected);
+        expect(engine.textSearchCalls).toEqual([{ query: 'hello', limit: 5 }]);
+    });
+    it('semanticRecall falls back to textSearch when embedding engine is not ready', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        const embeddingEngine = new BaseEmbeddingEngine({ enabled: true });
+        // isReady() returns false because we never initialized
+        engine.setEmbeddingEngine(embeddingEngine);
+        const expected = [makeMemory({ id: 2, content: 'fallback' })];
+        engine.textSearchResults = expected;
+        const results = await engine.semanticRecall('query');
+        expect(results).toEqual(expected);
+        expect(engine.textSearchCalls.length).toBe(1);
+    });
+    it('semanticRecall uses embeddings and sorts by similarity when engine is ready', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        // Create a mock embedding engine that is "ready"
+        const mockEmbeddingEngine = {
+            isReady: () => true,
+            embed: vi.fn(),
+        };
+        // Query vector: [1, 0]
+        const queryVec = new Float32Array([1, 0]);
+        mockEmbeddingEngine.embed.mockResolvedValue(queryVec);
+        engine.setEmbeddingEngine(mockEmbeddingEngine);
+        // Memory A embedding: [0, 1] -> similarity = 0
+        // Memory B embedding: [0.6, 0.8] -> similarity = 0.6
+        // Memory C embedding: [1, 0] -> similarity = 1.0
+        const memA = makeMemory({
+            id: 1,
+            content: 'orthogonal',
+            embedding: BaseEmbeddingEngine.serialize(new Float32Array([0, 1])),
+        });
+        const memB = makeMemory({
+            id: 2,
+            content: 'partial',
+            embedding: BaseEmbeddingEngine.serialize(new Float32Array([0.6, 0.8])),
+        });
+        const memC = makeMemory({
+            id: 3,
+            content: 'identical',
+            embedding: BaseEmbeddingEngine.serialize(new Float32Array([1, 0])),
+        });
+        engine.memoriesWithEmbeddings = [memA, memB, memC];
+        const results = await engine.semanticRecall('test query', 10);
+        // Should be sorted by similarity descending: C, B, A
+        expect(results.map(r => r.id)).toEqual([3, 2, 1]);
+        // textSearch should NOT have been called
+        expect(engine.textSearchCalls.length).toBe(0);
+    });
+    it('semanticRecall respects the limit parameter', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        const mockEmbeddingEngine = {
+            isReady: () => true,
+            embed: vi.fn().mockResolvedValue(new Float32Array([1, 0])),
+        };
+        engine.setEmbeddingEngine(mockEmbeddingEngine);
+        engine.memoriesWithEmbeddings = [
+            makeMemory({ id: 1, embedding: BaseEmbeddingEngine.serialize(new Float32Array([1, 0])) }),
+            makeMemory({ id: 2, embedding: BaseEmbeddingEngine.serialize(new Float32Array([0.9, 0.1])) }),
+            makeMemory({ id: 3, embedding: BaseEmbeddingEngine.serialize(new Float32Array([0.5, 0.5])) }),
+        ];
+        const results = await engine.semanticRecall('query', 2);
+        expect(results.length).toBe(2);
+    });
+    it('semanticRecall falls back to textSearch when embed() throws', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        const mockEmbeddingEngine = {
+            isReady: () => true,
+            embed: vi.fn().mockRejectedValue(new Error('embedding failed')),
+        };
+        engine.setEmbeddingEngine(mockEmbeddingEngine);
+        const expected = [makeMemory({ id: 10, content: 'text fallback' })];
+        engine.textSearchResults = expected;
+        const results = await engine.semanticRecall('broken query', 5);
+        expect(results).toEqual(expected);
+        expect(engine.textSearchCalls).toEqual([{ query: 'broken query', limit: 5 }]);
+    });
+    it('semanticRecall uses default limit of 10', async () => {
+        vi.useRealTimers();
+        const engine = new TestMemoryEngine(DEFAULT_CONFIG);
+        engine.textSearchResults = [];
+        await engine.semanticRecall('query');
+        expect(engine.textSearchCalls).toEqual([{ query: 'query', limit: 10 }]);
+    });
+});
+//# sourceMappingURL=base-memory-engine.test.js.map

package/dist/memory/__tests__/base-memory-engine.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",