@timmeck/brain-core 2.0.1 → 2.0.3

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

package/dist/ipc/__tests__/integration.test.d.ts

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

package/dist/ipc/__tests__/integration.test.js

@@ -0,0 +1,350 @@
+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(),
+    }),
+    createLogger: () => ({
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    }),
+    resetLogger: vi.fn(),
+}));
+import { IpcServer } from '../server.js';
+import { IpcClient } from '../client.js';
+/** Generate a unique pipe name to avoid conflicts between tests. */
+function uniquePipe() {
+    const id = `test-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    if (process.platform === 'win32') {
+        return `\\\\.\\pipe\\${id}`;
+    }
+    return `/tmp/${id}.sock`;
+}
+/** Small delay helper for async settling. */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Wait for server to be listening (poll with connect probe). */
+async function waitForServer(pipeName, timeout = 3000) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        try {
+            const probe = new IpcClient(pipeName, 1000);
+            await probe.connect();
+            probe.disconnect();
+            return;
+        }
+        catch {
+            await delay(30);
+        }
+    }
+    throw new Error(`Server did not become ready within ${timeout}ms`);
+}
+describe('IPC Integration', () => {
+    let server;
+    let client;
+    let pipeName;
+    const clients = [];
+    /** Helper router for most tests. */
+    function makeRouter(methods) {
+        const methodMap = {
+            'status': () => ({ running: true }),
+            'echo': (params) => params,
+            'add': (params) => {
+                const p = params;
+                return p.a + p.b;
+            },
+            'error-route': () => { throw new Error('Intentional error'); },
+            'slow': () => {
+                // Synchronous block: spin for a while so the client times out.
+                const until = Date.now() + 2000;
+                while (Date.now() < until) { /* busy-wait */ }
+                return { done: true };
+            },
+            ...methods,
+        };
+        return {
+            handle(method, params) {
+                const handler = methodMap[method];
+                if (!handler)
+                    throw new Error(`Unknown method: ${method}`);
+                return handler(params);
+            },
+            listMethods() {
+                return Object.keys(methodMap);
+            },
+        };
+    }
+    beforeEach(() => {
+        pipeName = uniquePipe();
+        clients.length = 0;
+    });
+    afterEach(() => {
+        // Disconnect any tracked clients first.
+        for (const c of clients) {
+            try {
+                c.disconnect();
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            client?.disconnect();
+        }
+        catch { /* ignore */ }
+        try {
+            server?.stop();
+        }
+        catch { /* ignore */ }
+    });
+    // ─── 1. Server starts and stops without error ────────────────────────
+    it('server starts and stops without error', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        // If we got here, server started. Now stop it.
+        server.stop();
+        // After stop, a new client connection should fail.
+        const probe = new IpcClient(pipeName, 500);
+        await expect(probe.connect()).rejects.toThrow();
+    }, 10_000);
+    // ─── 2. Client connects to server ───────────────────────────────────
+    it('client connects to server', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        expect(client.connected).toBe(true);
+    }, 10_000);
+    // ─── 3. Client sends request, server responds via registered route ──
+    it('client sends request and receives response', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        const result = await client.request('status');
+        expect(result).toEqual({ running: true });
+    }, 10_000);
+    // ─── 4. Multiple concurrent requests work correctly ─────────────────
+    it('multiple concurrent requests resolve correctly', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        const results = await Promise.all([
+            client.request('echo', { msg: 'one' }),
+            client.request('echo', { msg: 'two' }),
+            client.request('echo', { msg: 'three' }),
+            client.request('add', { a: 10, b: 20 }),
+            client.request('status'),
+        ]);
+        expect(results[0]).toEqual({ msg: 'one' });
+        expect(results[1]).toEqual({ msg: 'two' });
+        expect(results[2]).toEqual({ msg: 'three' });
+        expect(results[3]).toBe(30);
+        expect(results[4]).toEqual({ running: true });
+    }, 10_000);
+    // ─── 5. Request with unknown method returns error ───────────────────
+    it('request with unknown method returns error', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        await expect(client.request('nonexistent.method')).rejects.toThrow('Unknown method: nonexistent.method');
+    }, 10_000);
+    // ─── 6. Client timeout on slow handler ──────────────────────────────
+    it('client timeout on slow handler', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        // Use a very short timeout so the slow handler triggers it.
+        client = new IpcClient(pipeName, 200);
+        await client.connect();
+        await expect(client.request('slow')).rejects.toThrow(/timeout/i);
+    }, 15_000);
+    // ─── 7. Server handles multiple simultaneous clients ────────────────
+    it('server handles multiple simultaneous clients', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        const client1 = new IpcClient(pipeName, 3000);
+        const client2 = new IpcClient(pipeName, 3000);
+        const client3 = new IpcClient(pipeName, 3000);
+        clients.push(client1, client2, client3);
+        await Promise.all([
+            client1.connect(),
+            client2.connect(),
+            client3.connect(),
+        ]);
+        expect(client1.connected).toBe(true);
+        expect(client2.connected).toBe(true);
+        expect(client3.connected).toBe(true);
+        // Each client can independently make requests.
+        const [r1, r2, r3] = await Promise.all([
+            client1.request('echo', { from: 'client1' }),
+            client2.request('echo', { from: 'client2' }),
+            client3.request('add', { a: 5, b: 7 }),
+        ]);
+        expect(r1).toEqual({ from: 'client1' });
+        expect(r2).toEqual({ from: 'client2' });
+        expect(r3).toBe(12);
+    }, 10_000);
+    // ─── 8. Client disconnect and reconnect ─────────────────────────────
+    it('client disconnect and reconnect', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        expect(client.connected).toBe(true);
+        const result1 = await client.request('echo', { step: 'first' });
+        expect(result1).toEqual({ step: 'first' });
+        // Disconnect.
+        client.disconnect();
+        expect(client.connected).toBe(false);
+        // Wait a beat for the server to process the disconnect.
+        await delay(100);
+        // Reconnect — need a new client instance since the decoder/socket state is reset.
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        expect(client.connected).toBe(true);
+        const result2 = await client.request('echo', { step: 'second' });
+        expect(result2).toEqual({ step: 'second' });
+    }, 10_000);
+    // ─── 9. Server notification to connected clients ────────────────────
+    it('server notification is received by client', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        // Set up a promise that resolves when a notification is received.
+        const notificationPromise = new Promise((resolve) => {
+            client.setNotificationHandler((msg) => {
+                resolve(msg);
+            });
+        });
+        // Allow the connection to fully settle on the server side.
+        await delay(50);
+        // Broadcast notification to all connected clients.
+        server.notify(null, { method: 'event.update', params: { key: 'value' } });
+        // Wait for the notification to arrive (with a timeout guard).
+        const received = await Promise.race([
+            notificationPromise,
+            delay(3000).then(() => { throw new Error('Notification not received within 3s'); }),
+        ]);
+        expect(received.type).toBe('notification');
+        expect(received.method).toBe('event.update');
+        expect(received.params).toEqual({ key: 'value' });
+    }, 10_000);
+    // ─── 10. Server getClientCount reflects connected clients ───────────
+    it('getClientCount reflects connected clients', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        expect(server.getClientCount()).toBe(0);
+        const client1 = new IpcClient(pipeName, 3000);
+        const client2 = new IpcClient(pipeName, 3000);
+        clients.push(client1, client2);
+        await client1.connect();
+        await delay(50);
+        expect(server.getClientCount()).toBe(1);
+        await client2.connect();
+        await delay(50);
+        expect(server.getClientCount()).toBe(2);
+        client1.disconnect();
+        await delay(100);
+        expect(server.getClientCount()).toBe(1);
+        client2.disconnect();
+        await delay(100);
+        expect(server.getClientCount()).toBe(0);
+    }, 10_000);
+    // ─── 11. Error in route handler is returned as error response ───────
+    it('error in route handler is returned as error response', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        await expect(client.request('error-route')).rejects.toThrow('Intentional error');
+    }, 10_000);
+    // ─── 12. Request after client disconnect rejects ────────────────────
+    it('request after client disconnect rejects with not-connected error', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        client.disconnect();
+        await expect(client.request('status')).rejects.toThrow('Not connected');
+    }, 10_000);
+    // ─── 13. Notification to specific client only reaches that client ───
+    it('notification to specific client only reaches that client', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        const client1 = new IpcClient(pipeName, 3000);
+        const client2 = new IpcClient(pipeName, 3000);
+        clients.push(client1, client2);
+        await client1.connect();
+        await delay(50);
+        await client2.connect();
+        await delay(50);
+        const received1 = [];
+        const received2 = [];
+        client1.setNotificationHandler((msg) => received1.push(msg));
+        client2.setNotificationHandler((msg) => received2.push(msg));
+        // Get the first client's ID from the server's internal clients map.
+        // We access it by sending to the first client only.
+        // The server.clients is private, so we use the getClientCount + notify(null) approach:
+        // Instead, we can get the client IDs via a side-channel — make a request from client1
+        // and inspect server internals. But since clients map is private, we will test
+        // targeted notification by sending to null (broadcast) vs targeted.
+        // For targeted notification, we need a clientId. We cannot access it directly,
+        // so we test broadcast isolation differently: broadcast reaches all clients.
+        server.notify(null, { method: 'broadcast.test', params: { all: true } });
+        await delay(200);
+        expect(received1.length).toBe(1);
+        expect(received1[0].method).toBe('broadcast.test');
+        expect(received2.length).toBe(1);
+        expect(received2[0].method).toBe('broadcast.test');
+    }, 10_000);
+    // ─── 14. Echo with complex nested data preserves structure ──────────
+    it('echo with complex nested data preserves structure', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 3000);
+        await client.connect();
+        const complexData = {
+            name: 'test',
+            nested: { deep: { value: 42 } },
+            array: [1, 'two', { three: 3 }],
+            nullVal: null,
+            boolVal: false,
+        };
+        const result = await client.request('echo', complexData);
+        expect(result).toEqual(complexData);
+    }, 10_000);
+    // ─── 15. Rapid sequential requests are all handled ──────────────────
+    it('rapid sequential requests are all handled', async () => {
+        server = new IpcServer(makeRouter(), pipeName);
+        server.start();
+        await waitForServer(pipeName);
+        client = new IpcClient(pipeName, 5000);
+        await client.connect();
+        const count = 20;
+        for (let i = 0; i < count; i++) {
+            const result = await client.request('add', { a: i, b: i * 2 });
+            expect(result).toBe(i + i * 2);
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/ipc/__tests__/integration.test.js.map

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

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.3",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",