crbro-memory 2.4.0 → 2.5.0

package/dist/daemon/proxy.js

@@ -0,0 +1,412 @@
+"use strict";
+// ─── The proxy: what a client actually launches in daemon mode ────
+//
+// An MCP client starts `crbro-memory` and speaks JSON-RPC on stdio, as it
+// always has. In daemon mode that process loads no index and no model: it
+// finds the daemon (or starts it), proves who it is, and from then on copies
+// lines — client to daemon, daemon to client. It reads each line only to keep
+// three things it needs on the worst day:
+//
+//   · the client's `initialize`, so that if the daemon dies the handshake can
+//     be replayed against its replacement without the client ever knowing;
+//   · which requests are in flight, so each gets an error instead of a
+//     silence that would hang the conversation until a timeout;
+//   · nothing else.
+//
+// And if no daemon can be had at all, the backend is a server inside this
+// process — CRBRO exactly as it was before 2.5. The daemon is an optimisation;
+// the memory is not allowed to depend on it.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectDaemon = connectDaemon;
+exports.controlDaemon = controlDaemon;
+exports.spawnDetachedDaemon = spawnDetachedDaemon;
+exports.runProxy = runProxy;
+const node_net_1 = __importDefault(require("node:net"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const lines_js_1 = require("./lines.js");
+const endpoint_js_1 = require("./endpoint.js");
+const CONNECT_TIMEOUT_MS = 1_500;
+const HANDSHAKE_TIMEOUT_MS = 4_000;
+const SPAWN_WAIT_MS = 12_000;
+const POLL_MS = 200;
+/** Daemon connections lost inside this window before the proxy stops trusting daemons for the rest of its life. */
+const FLAP_WINDOW_MS = 60_000;
+const FLAP_LIMIT = 3;
+/** After the client closes its end: how long calls already accepted may take to finish before we leave anyway. */
+const DRAIN_TIMEOUT_MS = 30_000;
+/**
+ * Connect to the daemon of this brain and build, and get through the
+ * handshake. Null on any failure; 'config-mismatch' when the daemon is
+ * genuine but was started with settings that are not this client's.
+ */
+async function connectDaemon(brainRoot, build = (0, endpoint_js_1.buildId)(), options = {}) {
+    const state = await (0, endpoint_js_1.readState)(brainRoot, build);
+    if (!state)
+        return null;
+    const socket = await new Promise(resolve => {
+        const s = node_net_1.default.connect(state.endpoint);
+        const t = setTimeout(() => { s.destroy(); resolve(null); }, CONNECT_TIMEOUT_MS);
+        s.once('connect', () => { clearTimeout(t); resolve(s); });
+        s.once('error', () => { clearTimeout(t); resolve(null); });
+    });
+    if (!socket)
+        return null;
+    socket.setNoDelay(true);
+    let sink = () => undefined;
+    const lines = new lines_js_1.LineReader(line => sink(line), () => socket.destroy());
+    socket.on('data', chunk => lines.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk));
+    socket.on('error', () => undefined);
+    const next = () => new Promise(resolve => {
+        const t = setTimeout(() => resolve(null), HANDSHAKE_TIMEOUT_MS);
+        const done = (v) => { clearTimeout(t); socket.off('close', onClose); resolve(v); };
+        const onClose = () => done(null);
+        socket.once('close', onClose);
+        sink = line => { sink = () => undefined; try {
+            done(JSON.parse(line));
+        }
+        catch {
+            done(null);
+        } };
+    });
+    const fail = () => { socket.destroy(); return null; };
+    const nonce = (0, endpoint_js_1.newNonce)();
+    socket.write(`${JSON.stringify({ crbro: 'hello', protocol: endpoint_js_1.DAEMON_PROTOCOL, nonce })}\n`);
+    const hello = await next();
+    // The daemon proves itself FIRST: a process that merely took the pipe's name learns nothing from us.
+    if (!hello || hello.crbro !== 'hello' || !(0, endpoint_js_1.sameProof)(String(hello.proof || ''), (0, endpoint_js_1.proof)(state.token, 'daemon', nonce)))
+        return fail();
+    // Its nonce is what our proof is bound to: one we could be talked into reusing is no nonce at all.
+    if (typeof hello.nonce !== 'string' || !/^[0-9a-f]{32,128}$/.test(hello.nonce) || hello.nonce === nonce)
+        return fail();
+    if (options.checkConfig !== false && typeof hello.config === 'string' && hello.config !== (0, endpoint_js_1.configFingerprint)()) {
+        socket.destroy();
+        return 'config-mismatch';
+    }
+    socket.write(`${JSON.stringify({ crbro: 'auth', proof: (0, endpoint_js_1.proof)(state.token, 'client', hello.nonce), ...(options.resumed ? { resumed: true } : {}) })}\n`);
+    const ready = await next();
+    if (!ready || ready.crbro !== 'ready')
+        return fail();
+    return { socket, reader: on => { sink = on; }, state, hello };
+}
+/** One control exchange: `status` or `stop`. Null when there is no daemon to talk to. */
+async function controlDaemon(brainRoot, op, build) {
+    const c = await connectDaemon(brainRoot, build, { checkConfig: false });
+    if (!c || c === 'config-mismatch')
+        return null;
+    return new Promise(resolve => {
+        const t = setTimeout(() => { c.socket.destroy(); resolve(null); }, HANDSHAKE_TIMEOUT_MS);
+        c.reader(line => { clearTimeout(t); try {
+            resolve(JSON.parse(line));
+        }
+        catch {
+            resolve(null);
+        } c.socket.end(); });
+        c.socket.write(`${JSON.stringify({ crbro: 'control', op })}\n`);
+    });
+}
+/** The production way to start a daemon: detached, silent, surviving this process. */
+function spawnDetachedDaemon(brainRoot) {
+    const entry = node_path_1.default.join(__dirname, '..', 'index.js');
+    const child = (0, node_child_process_1.spawn)(process.execPath, [entry, '--daemon'], {
+        detached: true, stdio: 'ignore', windowsHide: true,
+        // Not the client's working directory: on Windows a process pins its cwd,
+        // and the project the client was opened in could not be renamed or
+        // deleted for as long as the daemon lived.
+        cwd: node_os_1.default.homedir(),
+        env: { ...process.env, CRBRO_PATH: brainRoot, CRBRO_DAEMON: '' },
+    });
+    child.on('error', () => undefined);
+    child.unref();
+}
+/** 'unusable': a daemon exists but is not for us, or cannot be had — do not wait for one, and do not ask again. */
+async function daemonBackend(o, ev, resumed) {
+    const build = o.build ?? (0, endpoint_js_1.buildId)();
+    let c = await connectDaemon(o.brainRoot, build, { resumed });
+    if (!c && o.spawnDaemon) {
+        const since = Date.now() - 1_000;
+        try {
+            await o.spawnDaemon();
+        }
+        catch (err) {
+            o.log?.(`could not start a daemon: ${err.message}`);
+        }
+        const until = Date.now() + (o.spawnWaitMs ?? SPAWN_WAIT_MS);
+        while (!c && Date.now() < until) {
+            await new Promise(r => setTimeout(r, POLL_MS));
+            c = await connectDaemon(o.brainRoot, build, { resumed });
+            if (!c) {
+                const why = await (0, endpoint_js_1.blockedSince)(o.brainRoot, build, since);
+                if (why) {
+                    o.log?.(`the daemon could not take its endpoint (${why}): serving from this process`);
+                    return 'unusable';
+                }
+            }
+        }
+    }
+    if (c === 'config-mismatch') {
+        o.log?.('a daemon is running with other settings than this client\'s (CRBRO_SEMANTIC, CRBRO_BACKUP_DIR…): serving from this process so they keep their meaning');
+        return 'unusable';
+    }
+    if (!c)
+        return null;
+    const { socket, reader } = c;
+    let closing = false;
+    reader(ev.onLine);
+    socket.on('close', () => { if (!closing)
+        ev.onClose(); });
+    return {
+        kind: 'daemon',
+        send: line => { if (!socket.destroyed)
+            socket.write(`${line}\n`); },
+        // Wait for the pipe to really close: the caller exits the process next, and
+        // an exit right after end() can cut the last write on a Windows pipe.
+        close: () => new Promise(resolve => {
+            closing = true;
+            if (socket.destroyed)
+                return resolve();
+            socket.once('close', () => resolve());
+            socket.end();
+            setTimeout(() => { socket.destroy(); resolve(); }, 2_000).unref();
+        }),
+    };
+}
+/** CRBRO as it was before daemons: the whole server, in this process. */
+async function localBackend(ev, resumed) {
+    const { createEngines, createServer } = await import('../server.js');
+    const { sessionScope, newTally } = await import('../engine/cortex.js');
+    const engines = createEngines();
+    const transport = new lines_js_1.LoopbackTransport(ev.onLine);
+    await createServer(engines).connect(transport);
+    // After a lost daemon this server starts with an empty tally that the
+    // conversation's earlier writes are not in: mark it, so consolidate says so.
+    const scope = resumed ? { tally: newTally(), resumed: true } : null;
+    return {
+        kind: 'local',
+        send: line => (scope ? sessionScope.run(scope, () => transport.receive(line)) : transport.receive(line)),
+        close: async () => {
+            await new Promise(r => setImmediate(r)); // let a notification that was just delivered run
+            try {
+                await engines.searchEngine.flush();
+            }
+            catch { /* derived data */ }
+        },
+    };
+}
+function runProxy(o) {
+    const log = o.log ?? (() => undefined);
+    const isEnabled = o.isEnabled ?? (() => true);
+    const makeLocal = o.local ?? localBackend;
+    let backend = null;
+    let connecting = true;
+    let inputEnded = false; // the client closed its end: no more requests, but what it asked for is still owed
+    let ended = false; // we are done: nothing more is written, nothing more is started
+    let reconnects = 0;
+    let trustDaemons = true;
+    const losses = [];
+    let initialize = null;
+    let initialized = null;
+    const inflight = new Set();
+    const waiting = []; // client lines held while there is no usable backend
+    let replayId = null; // id of the initialize we are replaying, while its answer is pending
+    let replays = 0;
+    let drainTimer = null;
+    let resolveClosed;
+    let rejectClosed;
+    const closed = new Promise((res, rej) => { resolveClosed = res; rejectClosed = rej; });
+    const toClient = (line) => { if (!ended)
+        o.output.write(`${line}\n`); };
+    /** Leave — but only once every call the client made has been answered and written out. */
+    const maybeFinish = () => {
+        if (ended || !inputEnded || connecting || waiting.length > 0 || inflight.size > 0)
+            return;
+        void shutdown();
+    };
+    const shutdown = async () => {
+        if (ended)
+            return;
+        if (drainTimer)
+            clearTimeout(drainTimer);
+        try {
+            await backend?.close();
+        }
+        catch { /* leaving anyway */ }
+        // stdout on a Windows pipe is asynchronous: the caller exits the process
+        // next, and the last answer must be out of our hands before it does.
+        await new Promise(resolve => { try {
+            o.output.write('', () => resolve());
+        }
+        catch {
+            resolve();
+        } });
+        ended = true;
+        resolveClosed();
+    };
+    const fromBackend = (line) => {
+        let m = null;
+        try {
+            m = JSON.parse(line);
+        }
+        catch { /* not ours to judge: pass it on */ }
+        if (m && replayId !== null && m.id === replayId && m.method === undefined) {
+            // The replacement answered the replayed handshake. The client already
+            // has the original answer; this one stops here.
+            replayId = null;
+            if (initialized && backend)
+                backend.send(initialized);
+            connecting = false;
+            drain();
+            return;
+        }
+        if (m && m.id !== undefined && m.id !== null && m.method === undefined)
+            inflight.delete(m.id);
+        toClient(line);
+        maybeFinish();
+    };
+    const drain = () => {
+        while (backend && !connecting && waiting.length)
+            backend.send(waiting.shift());
+        maybeFinish();
+    };
+    const fromClient = (line) => {
+        let m = null;
+        try {
+            m = JSON.parse(line);
+        }
+        catch { /* the backend will answer the parse error */ }
+        if (m?.method === 'initialize')
+            initialize = m;
+        else if (m?.method === 'notifications/initialized')
+            initialized = line;
+        if (m && m.method !== undefined && m.id !== undefined && m.id !== null)
+            inflight.add(m.id);
+        if (backend && !connecting)
+            backend.send(line);
+        else
+            waiting.push(line);
+    };
+    const events = {
+        onLine: fromBackend,
+        onClose: () => { void lost(); },
+    };
+    /** No backend of any kind could be had. Say so on every call that is owed an answer, and stop — as the classic server does when it cannot start. */
+    const fatal = (err) => {
+        if (ended)
+            return;
+        log(`no backend could be started: ${err.message}`);
+        const ids = new Set(inflight);
+        for (const l of waiting) {
+            try {
+                const q = JSON.parse(l);
+                if (q?.method !== undefined && q.id !== undefined && q.id !== null)
+                    ids.add(q.id);
+            }
+            catch { /* not a request */ }
+        }
+        for (const id of ids)
+            toClient(JSON.stringify({ jsonrpc: '2.0', id, error: { code: -32000, message: `CRBRO could not start: ${err.message}` } }));
+        inflight.clear();
+        waiting.length = 0;
+        ended = true;
+        rejectClosed(err);
+    };
+    async function acquire(first) {
+        connecting = true;
+        backend = null;
+        let b = null;
+        // Asked every time, not once at launch: `crbro daemon off` removes the
+        // flag and stops the daemon, and a proxy that only knew how to respawn one
+        // undid it within 200 ms.
+        if (trustDaemons && isEnabled()) {
+            const d = await daemonBackend(o, events, !first);
+            if (d === 'unusable')
+                trustDaemons = false;
+            else
+                b = d;
+        }
+        if (!b) {
+            if (trustDaemons && isEnabled())
+                log('no daemon reachable: serving from this process');
+            b = await makeLocal(events, !first);
+        }
+        if (ended) {
+            await b.close();
+            return;
+        }
+        backend = b;
+        if (!first && initialize) {
+            // Same request the client once sent, under an id of our own.
+            replayId = `crbro-replay-${++replays}`;
+            b.send(JSON.stringify({ ...initialize, id: replayId }));
+            return; // `connecting` stays true until the replayed handshake is answered
+        }
+        connecting = false;
+        drain();
+    }
+    async function lost() {
+        if (ended)
+            return;
+        reconnects++;
+        const now = Date.now();
+        losses.push(now);
+        while (losses.length && now - losses[0] > FLAP_WINDOW_MS)
+            losses.shift();
+        if (losses.length >= FLAP_LIMIT) {
+            trustDaemons = false;
+            log('daemon lost three times in a minute: staying in-process');
+        }
+        // Whatever was waiting for an answer will not get one from a dead process.
+        // What never left this proxy is not in that position: it is still queued,
+        // and answering it here too would hand the client two replies to one id.
+        const queued = new Set();
+        for (const line of waiting) {
+            try {
+                const q = JSON.parse(line);
+                if (q?.id !== undefined && q.id !== null)
+                    queued.add(q.id);
+            }
+            catch { /* not a request */ }
+        }
+        for (const id of [...inflight]) {
+            if (queued.has(id))
+                continue;
+            inflight.delete(id);
+            toClient(JSON.stringify({ jsonrpc: '2.0', id, error: { code: -32000, message: 'CRBRO restarted while this call was running. Nothing was lost on disk; call it again.' } }));
+        }
+        replayId = null;
+        backend = null;
+        // The client has gone and is owed nothing more: a replacement would serve nobody.
+        if (inputEnded && waiting.length === 0 && inflight.size === 0) {
+            connecting = false;
+            void shutdown();
+            return;
+        }
+        try {
+            await acquire(false);
+        }
+        catch (err) {
+            fatal(err);
+        }
+    }
+    const reader = new lines_js_1.LineReader(fromClient, () => undefined);
+    o.input.on('data', (chunk) => reader.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk));
+    const onInputEnd = () => {
+        if (inputEnded)
+            return;
+        inputEnded = true;
+        // A client that sends its last crbro_learn and closes stdin at once is
+        // still owed that write and its answer — the classic server gives both.
+        drainTimer = setTimeout(() => { log('gave up waiting for the last answers'); void shutdown(); }, o.drainTimeoutMs ?? DRAIN_TIMEOUT_MS);
+        drainTimer.unref();
+        maybeFinish();
+    };
+    o.input.on('end', onInputEnd);
+    o.input.on('close', onInputEnd);
+    void acquire(true).catch(err => fatal(err));
+    return { closed, backendKind: () => (backend ? backend.kind : 'none'), reconnects: () => reconnects };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/daemon/proxy.js.map

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

package/dist/engine/backup.d.ts

@@ -0,0 +1,68 @@
+import { BrainPaths } from './brain.js';
+export declare const BACKUP_FORMAT = 1;
+export declare const DEFAULT_KEEP = 7;
+/** consolidate makes one on its own when the newest is older than this. */
+export declare const AUTO_BACKUP_INTERVAL_MS: number;
+export interface BackupBundle {
+    format: number;
+    created: string;
+    brain_path: string;
+    counts: {
+        files: number;
+        neurons: number;
+        sessions: number;
+        synapses: number;
+        bytes: number;
+    };
+    /** POSIX-style relative path → file content. */
+    files: Record<string, string>;
+}
+export interface BackupInfo {
+    file: string;
+    path: string;
+    created: string;
+    size_bytes: number;
+}
+export interface BackupResult extends BackupInfo {
+    counts: BackupBundle['counts'];
+    rotated_out: string[];
+    dir: string;
+}
+/**
+ * Where backups go: a sibling of the brain they belong to — `~/.crbro` →
+ * `~/.crbro-backups/brain`.
+ *
+ * Outside the brain, so deleting the brain does not delete its backups. And
+ * derived from the brain's own path rather than fixed under the home folder,
+ * because rotation keeps the newest N of whatever is in the folder: two brains
+ * (CRBRO_PATH, or a test's temporary one) sharing a folder would rotate each
+ * other's backups out.
+ */
+export declare function resolveBackupDir(brainRoot: string, env?: NodeJS.ProcessEnv, home?: string): string;
+export declare function listBackups(dir: string): Promise<BackupInfo[]>;
+export declare function createBackup(paths: BrainPaths, opts?: {
+    dir?: string;
+    keep?: number;
+    now?: Date;
+}): Promise<BackupResult>;
+export declare function readBackup(file: string): Promise<BackupBundle>;
+/**
+ * Unpack a backup into a directory that must not already hold a brain.
+ * Never writes over a live brain: swapping directories is a decision a person
+ * makes with both of them in front of them.
+ */
+export declare function restoreBackup(file: string, into: string): Promise<{
+    into: string;
+    files: number;
+}>;
+/** Called by consolidate: a backup nobody has to remember to make. Never throws. */
+export declare function autoBackupIfDue(paths: BrainPaths, opts?: {
+    dir?: string;
+    now?: Date;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    made: boolean;
+    reason: string;
+    file?: string;
+}>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/engine/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/engine/backup.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKxC,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAO3D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9F,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,MAAqB,GAC1B,MAAM,CAOR;AA8BD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAkBpE;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GACrD,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAUpE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBxG;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAC/D,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3D"}