@gramatr/mcp 0.11.12 → 0.11.15

package/dist/daemon/server.js

@@ -0,0 +1,322 @@
+/**
+ * server.ts — Unix socket IPC server for the gramatr daemon.
+ *
+ * Accepts newline-delimited JSON-RPC 2.0 connections. Each connection
+ * can send one request and receives one response. Connections are
+ * short-lived (hook processes are short-lived); no multiplexing needed.
+ *
+ * Error codes:
+ *   -32600  Invalid request
+ *   -32601  Method not found
+ *   -32603  Internal error
+ */
+import { createServer } from 'node:net';
+import { createInterface } from 'node:readline';
+import { callRemoteTool } from '../proxy/remote-client.js';
+import { sessionRegistry } from './session-registry.js';
+import { projectCache } from './project-cache.js';
+import { sqliteOwner } from './sqlite-owner.js';
+import { VERSION } from '../hooks/lib/version.js';
+const contextStore = new Map();
+const activeSockets = new Set();
+let _server = null;
+// ── db/query forwarding ───────────────────────────────────────────────────────
+/**
+ * Route read-only SQLite operations through the daemon's owned connection.
+ *
+ * Implements the same queries as hook-state.ts without importing that module
+ * (which would open a competing DB connection). Results are returned as plain
+ * JSON-serialisable objects so they can be sent over the IPC socket.
+ *
+ * Hook processes that set GRAMATR_USE_DAEMON_DB=1 (detected via daemon.active
+ * sentinel) may call this method to avoid opening the file directly.
+ * Sprint 3 will wire the async IPC call path in hook-state.ts.
+ */
+function handleDbQuery(operation, args) {
+    const db = sqliteOwner.getDb();
+    if (!db)
+        return null;
+    try {
+        switch (operation) {
+            case 'getSessionContext': {
+                const sessionId = args['session_id'];
+                if (sessionId && sessionId !== 'unknown') {
+                    const scoped = db
+                        .prepare('SELECT * FROM session_context WHERE session_id = ? ORDER BY updated_at DESC LIMIT 1')
+                        .get(sessionId);
+                    if (scoped)
+                        return scoped;
+                }
+                return (db
+                    .prepare('SELECT * FROM session_context ORDER BY updated_at DESC LIMIT 1')
+                    .get() ?? null);
+            }
+            case 'getLastSessionForProject': {
+                const projectId = args['project_id'];
+                if (!projectId)
+                    return null;
+                return (db
+                    .prepare(`
+              SELECT session_id, interaction_id, entity_id, client_type, agent_name, ended_at
+              FROM session_log
+              WHERE project_id = ?
+              ORDER BY id DESC
+              LIMIT 1
+            `)
+                    .get(projectId) ?? null);
+            }
+            case 'getLocalProjectByDirectory': {
+                const directory = args['directory'];
+                if (!directory)
+                    return null;
+                return (db
+                    .prepare('SELECT * FROM projects WHERE directory = ? ORDER BY updated_at DESC LIMIT 1')
+                    .get(directory) ?? null);
+            }
+            default: {
+                throw Object.assign(new Error(`db/query: unknown operation: ${String(operation)}`), { code: -32601 });
+            }
+        }
+    }
+    catch (err) {
+        if (err !== null && typeof err === 'object' && 'code' in err)
+            throw err;
+        // Wrap unexpected DB errors as internal errors.
+        throw Object.assign(new Error(`db/query(${String(operation)}) failed: ${err instanceof Error ? err.message : String(err)}`), { code: -32603 });
+    }
+}
+// ── Request dispatch ──────────────────────────────────────────────────────────
+/**
+ * Route a JSON-RPC 2.0 request to the appropriate handler.
+ * Exported so the HTTP fallback server can share the same dispatch logic.
+ */
+export async function dispatchRpcRequest(req) {
+    const { method, params } = req;
+    switch (method) {
+        case 'tool/call': {
+            const name = params.name;
+            const args = (params.arguments ?? {});
+            if (typeof name !== 'string' || !name) {
+                throw Object.assign(new Error('tool/call requires params.name (string)'), { code: -32600 });
+            }
+            return callRemoteTool(name, args);
+        }
+        case 'session/register': {
+            const sessionId = params.session_id;
+            if (typeof sessionId !== 'string' || !sessionId) {
+                throw Object.assign(new Error('session/register requires params.session_id (string)'), { code: -32600 });
+            }
+            sessionRegistry.register(sessionId);
+            return { ok: true };
+        }
+        case 'session/release': {
+            const sessionId = params.session_id;
+            if (typeof sessionId !== 'string' || !sessionId) {
+                throw Object.assign(new Error('session/release requires params.session_id (string)'), { code: -32600 });
+            }
+            sessionRegistry.release(sessionId);
+            return { ok: true };
+        }
+        case 'session/context/get': {
+            const sessionId = params.session_id;
+            // Try SQLite first (survives daemon restart if same DB file is re-opened).
+            const db = sqliteOwner.getDb();
+            if (db && typeof sessionId === 'string' && sessionId) {
+                try {
+                    const row = db
+                        .prepare('SELECT * FROM session_context WHERE session_id = ? ORDER BY updated_at DESC LIMIT 1')
+                        .get(sessionId);
+                    if (row)
+                        return { value: row };
+                }
+                catch {
+                    // Fall through to in-memory store below.
+                }
+            }
+            // Fall back to in-memory map (populated before DB was available or on DB error).
+            const value = typeof sessionId === 'string' ? contextStore.get(sessionId) ?? null : null;
+            return { value };
+        }
+        case 'session/context/set': {
+            const sessionId = params.session_id;
+            if (typeof sessionId !== 'string' || !sessionId) {
+                throw Object.assign(new Error('session/context/set requires params.session_id (string)'), { code: -32600 });
+            }
+            const ctx = params.context;
+            // Always write to in-memory store first (fastest, daemon-lifetime guarantee).
+            contextStore.set(sessionId, ctx);
+            // Also persist to SQLite via daemon's own connection — same SQL as
+            // hook-state.ts:setSessionContext. Do NOT import hook-state.ts here;
+            // that module opens its own DB connection which would fight with ours.
+            const dbForSet = sqliteOwner.getDb();
+            if (dbForSet && ctx !== null && typeof ctx === 'object') {
+                const c = ctx;
+                try {
+                    dbForSet
+                        .prepare(`
+              INSERT OR REPLACE INTO session_context
+                (session_id, project_id, interaction_id, entity_id, project_name,
+                 git_root, git_branch, git_remote, working_directory,
+                 session_start, updated_at, client_type, agent_name, platform, arch)
+              VALUES
+                (@session_id, @project_id, @interaction_id, @entity_id, @project_name,
+                 @git_root, @git_branch, @git_remote, @working_directory,
+                 @session_start, @updated_at, @client_type, @agent_name, @platform, @arch)
+            `)
+                        .run({
+                        '@session_id': c['session_id'] ?? sessionId,
+                        '@project_id': c['project_id'] ?? null,
+                        '@interaction_id': c['interaction_id'] ?? null,
+                        '@entity_id': c['entity_id'] ?? null,
+                        '@project_name': c['project_name'] ?? null,
+                        '@git_root': c['git_root'] ?? null,
+                        '@git_branch': c['git_branch'] ?? null,
+                        '@git_remote': c['git_remote'] ?? null,
+                        '@working_directory': c['working_directory'] ?? null,
+                        '@session_start': c['session_start'] ?? null,
+                        '@updated_at': c['updated_at'] ?? new Date().toISOString(),
+                        '@client_type': c['client_type'] ?? null,
+                        '@agent_name': c['agent_name'] ?? null,
+                        '@platform': c['platform'] ?? null,
+                        '@arch': c['arch'] ?? null,
+                    });
+                }
+                catch {
+                    // Non-fatal — in-memory store is the source of truth for daemon's lifetime.
+                }
+            }
+            // Reset idle checkpoint timer on write activity.
+            sqliteOwner.resetIdleTimer();
+            return { ok: true };
+        }
+        case 'db/query': {
+            const { operation, args } = params;
+            const result = handleDbQuery(operation, args);
+            return result;
+        }
+        case 'daemon/ping': {
+            return {
+                ok: true,
+                version: VERSION,
+                pid: process.pid,
+                uptime: process.uptime(),
+                sessions: sessionRegistry.count(),
+            };
+        }
+        case 'daemon/shutdown': {
+            // Schedule shutdown after response is sent
+            setImmediate(() => {
+                if (_server) {
+                    _server.emit('daemon-shutdown');
+                }
+            });
+            return { ok: true };
+        }
+        case 'project/resolve': {
+            const p = params;
+            let entry = null;
+            if (p.git_remote)
+                entry = projectCache.getByRemote(p.git_remote);
+            if (!entry && p.directory)
+                entry = projectCache.getByDirectory(p.directory);
+            if (!entry && p.slug)
+                entry = projectCache.getBySlug(p.slug);
+            return entry
+                ? { found: true, project_id: entry.id, slug: entry.slug }
+                : { found: false };
+        }
+        case 'project/cache-set': {
+            projectCache.set(params);
+            return { ok: true };
+        }
+        default: {
+            throw Object.assign(new Error(`Method not found: ${String(method)}`), { code: -32601 });
+        }
+    }
+}
+// ── Connection handler ────────────────────────────────────────────────────────
+function handleConnection(socket) {
+    activeSockets.add(socket);
+    socket.once('close', () => activeSockets.delete(socket));
+    // Reset the idle checkpoint timer on every incoming connection.
+    sqliteOwner.resetIdleTimer();
+    const rl = createInterface({ input: socket, crlfDelay: Infinity });
+    rl.once('line', async (line) => {
+        rl.close();
+        let req;
+        let id = 0;
+        const sendError = (code, message, data) => {
+            const resp = {
+                jsonrpc: '2.0',
+                id,
+                error: { code, message, ...(data !== undefined ? { data } : {}) },
+            };
+            try {
+                socket.write(JSON.stringify(resp) + '\n');
+            }
+            catch {
+                // Socket may already be closed
+            }
+            finally {
+                socket.end();
+            }
+        };
+        const sendResult = (result) => {
+            const resp = { jsonrpc: '2.0', id, result };
+            try {
+                socket.write(JSON.stringify(resp) + '\n');
+            }
+            catch {
+                // Socket may already be closed
+            }
+            finally {
+                socket.end();
+            }
+        };
+        // Parse JSON-RPC request
+        try {
+            req = JSON.parse(line);
+            id = req.id ?? 0;
+        }
+        catch {
+            sendError(-32600, 'Invalid JSON in request');
+            return;
+        }
+        if (!req || req.jsonrpc !== '2.0' || !req.method) {
+            sendError(-32600, 'Invalid JSON-RPC 2.0 request');
+            return;
+        }
+        // Dispatch
+        try {
+            const result = await dispatchRpcRequest(req);
+            sendResult(result);
+        }
+        catch (err) {
+            const isRpcError = err !== null && typeof err === 'object' && 'code' in err;
+            const code = isRpcError ? err.code : -32603;
+            const message = err instanceof Error ? err.message : String(err);
+            sendError(code, message);
+        }
+    });
+    // Errors on the socket itself — just remove and destroy
+    socket.on('error', () => {
+        activeSockets.delete(socket);
+        try {
+            socket.destroy();
+        }
+        catch { /* ignore */ }
+    });
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+export function createDaemonServer() {
+    const server = createServer(handleConnection);
+    _server = server;
+    server.on('error', (err) => {
+        process.stderr.write(`[gramatr-daemon] server error: ${err.message}\n`);
+    });
+    return server;
+}
+export function getActiveSockets() {
+    return activeSockets;
+}
+//# sourceMappingURL=server.js.map

package/dist/daemon/server.js.map

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

package/dist/daemon/session-registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * session-registry.ts — Reference-counted session tracking for the gramatr daemon.
+ *
+ * Sessions are tracked in-memory only (no SQLite in Sprint 1).
+ * When the last session is released, a 30-second grace timer fires
+ * the onEmpty callback so the daemon can checkpoint WAL and exit.
+ */
+interface SessionRegistration {
+    sessionId: string;
+    registeredAt: number;
+    lastHeartbeatAt: number;
+}
+declare class SessionRegistry {
+    private sessions;
+    private shutdownTimer;
+    private onEmptyFn;
+    private readonly GRACE_MS;
+    setOnEmpty(fn: () => void): void;
+    register(sessionId: string): void;
+    release(sessionId: string): void;
+    count(): number;
+    list(): SessionRegistration[];
+}
+export declare const sessionRegistry: SessionRegistry;
+export {};
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/daemon/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../../src/daemon/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAajC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOhC,KAAK,IAAI,MAAM;IAIf,IAAI,IAAI,mBAAmB,EAAE;CAG9B;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/daemon/session-registry.js

@@ -0,0 +1,42 @@
+/**
+ * session-registry.ts — Reference-counted session tracking for the gramatr daemon.
+ *
+ * Sessions are tracked in-memory only (no SQLite in Sprint 1).
+ * When the last session is released, a 30-second grace timer fires
+ * the onEmpty callback so the daemon can checkpoint WAL and exit.
+ */
+class SessionRegistry {
+    sessions = new Map();
+    shutdownTimer = null;
+    onEmptyFn = null;
+    GRACE_MS = 30_000;
+    setOnEmpty(fn) {
+        this.onEmptyFn = fn;
+    }
+    register(sessionId) {
+        this.sessions.set(sessionId, {
+            sessionId,
+            registeredAt: Date.now(),
+            lastHeartbeatAt: Date.now(),
+        });
+        // Cancel any pending shutdown timer — a new session arrived
+        if (this.shutdownTimer !== null) {
+            clearTimeout(this.shutdownTimer);
+            this.shutdownTimer = null;
+        }
+    }
+    release(sessionId) {
+        this.sessions.delete(sessionId);
+        if (this.sessions.size === 0 && this.onEmptyFn !== null) {
+            this.shutdownTimer = setTimeout(this.onEmptyFn, this.GRACE_MS);
+        }
+    }
+    count() {
+        return this.sessions.size;
+    }
+    list() {
+        return [...this.sessions.values()];
+    }
+}
+export const sessionRegistry = new SessionRegistry();
+//# sourceMappingURL=session-registry.js.map

package/dist/daemon/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../../src/daemon/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,eAAe;IACX,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAClD,aAAa,GAAyC,IAAI,CAAC;IAC3D,SAAS,GAAwB,IAAI,CAAC;IAC7B,QAAQ,GAAG,MAAM,CAAC;IAEnC,UAAU,CAAC,EAAc;QACvB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;YAC3B,SAAS;YACT,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE;SAC5B,CAAC,CAAC;QACH,4DAA4D;QAC5D,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACxD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/daemon/sqlite-owner.d.ts

@@ -0,0 +1,55 @@
+/**
+ * sqlite-owner.ts — The daemon's owned SQLite connection.
+ *
+ * The daemon holds the single long-lived DatabaseSync connection to
+ * ~/.gramatr/state.db. It is NOT an exclusive lock — hook processes can
+ * still open WAL-mode concurrent readers/writers. The daemon becomes the
+ * one reliable checkpointer because short-lived hook processes exit before
+ * running checkpoints themselves (fix for #1296).
+ *
+ * Checkpoint lifecycle:
+ *   PASSIVE  — every 30 s of idle (no active sessions; timer resets on activity)
+ *   TRUNCATE — on graceful shutdown (SIGTERM, SIGINT, idle-empty)
+ *
+ * When GRAMATR_STATE_DB=:memory: (tests), open() and checkpoints are skipped.
+ */
+import { DatabaseSync } from 'node:sqlite';
+export declare class SqliteOwner {
+    private db;
+    private idleTimer;
+    private readonly IDLE_CHECKPOINT_MS;
+    /**
+     * Open the database connection and start the idle checkpoint interval.
+     *
+     * No-op when GRAMATR_STATE_DB=:memory:.
+     */
+    open(): void;
+    /**
+     * Run PRAGMA wal_checkpoint(PASSIVE) — allows readers/writers to continue.
+     * Pages are only checkpointed when no reader is blocking; safe to call anytime.
+     */
+    passiveCheckpoint(): void;
+    /**
+     * Run PRAGMA wal_checkpoint(TRUNCATE) — waits for readers then zeroes the WAL.
+     * Called on graceful shutdown to leave the DB in a clean state.
+     */
+    truncateCheckpoint(): void;
+    /**
+     * Reset (restart) the 30-second idle passive-checkpoint interval.
+     * Call this on any activity (new connection, session register/release, context set).
+     */
+    resetIdleTimer(): void;
+    /**
+     * Run a TRUNCATE checkpoint then close the connection.
+     * Called in gracefulShutdown() before the process exits.
+     */
+    close(): void;
+    /**
+     * Expose the underlying DatabaseSync for direct SQL in server.ts handlers.
+     * Returns null when the DB is not open (memory mode or open() failed).
+     */
+    getDb(): DatabaseSync | null;
+}
+/** Module singleton — imported by server.ts and index.ts. */
+export declare const sqliteOwner: SqliteOwner;
+//# sourceMappingURL=sqlite-owner.d.ts.map

package/dist/daemon/sqlite-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-owner.d.ts","sourceRoot":"","sources":["../../src/daemon/sqlite-owner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAE7C;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAgCZ;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IASzB;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAS1B;;;OAGG;IACH,cAAc,IAAI,IAAI;IAiBtB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAcb;;;OAGG;IACH,KAAK,IAAI,YAAY,GAAG,IAAI;CAG7B;AAED,6DAA6D;AAC7D,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/daemon/sqlite-owner.js

@@ -0,0 +1,133 @@
+/**
+ * sqlite-owner.ts — The daemon's owned SQLite connection.
+ *
+ * The daemon holds the single long-lived DatabaseSync connection to
+ * ~/.gramatr/state.db. It is NOT an exclusive lock — hook processes can
+ * still open WAL-mode concurrent readers/writers. The daemon becomes the
+ * one reliable checkpointer because short-lived hook processes exit before
+ * running checkpoints themselves (fix for #1296).
+ *
+ * Checkpoint lifecycle:
+ *   PASSIVE  — every 30 s of idle (no active sessions; timer resets on activity)
+ *   TRUNCATE — on graceful shutdown (SIGTERM, SIGINT, idle-empty)
+ *
+ * When GRAMATR_STATE_DB=:memory: (tests), open() and checkpoints are skipped.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { getStateDatabasePath } from './db-path.js';
+export class SqliteOwner {
+    db = null;
+    idleTimer = null;
+    IDLE_CHECKPOINT_MS = 30_000;
+    /**
+     * Open the database connection and start the idle checkpoint interval.
+     *
+     * No-op when GRAMATR_STATE_DB=:memory:.
+     */
+    open() {
+        const path = getStateDatabasePath();
+        // Skip filesystem operations for in-memory test databases.
+        if (path === ':memory:')
+            return;
+        // Ensure the parent directory exists.
+        try {
+            const dir = dirname(path);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+        }
+        catch {
+            // Non-fatal — if we can't create the dir we'll fall through and let
+            // DatabaseSync throw, which we also catch below.
+        }
+        try {
+            this.db = new DatabaseSync(path);
+            // Ensure WAL mode is set — safe to re-run if hook-state.ts already set it.
+            this.db.exec('PRAGMA journal_mode = WAL');
+            this.db.exec('PRAGMA synchronous = NORMAL');
+        }
+        catch (err) {
+            // Non-fatal — daemon degrades without the checkpoint lifecycle.
+            process.stderr.write(`[gramatr-daemon] sqlite-owner: failed to open ${path}: ${String(err)}\n`);
+            this.db = null;
+            return;
+        }
+        this.resetIdleTimer();
+    }
+    /**
+     * Run PRAGMA wal_checkpoint(PASSIVE) — allows readers/writers to continue.
+     * Pages are only checkpointed when no reader is blocking; safe to call anytime.
+     */
+    passiveCheckpoint() {
+        if (!this.db)
+            return;
+        try {
+            this.db.exec('PRAGMA wal_checkpoint(PASSIVE)');
+        }
+        catch {
+            // Non-fatal — WAL file will be checkpointed on next opportunity.
+        }
+    }
+    /**
+     * Run PRAGMA wal_checkpoint(TRUNCATE) — waits for readers then zeroes the WAL.
+     * Called on graceful shutdown to leave the DB in a clean state.
+     */
+    truncateCheckpoint() {
+        if (!this.db)
+            return;
+        try {
+            this.db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+        }
+        catch {
+            // Non-fatal — passive checkpoint already ran; truncate is best-effort.
+        }
+    }
+    /**
+     * Reset (restart) the 30-second idle passive-checkpoint interval.
+     * Call this on any activity (new connection, session register/release, context set).
+     */
+    resetIdleTimer() {
+        if (this.idleTimer !== null) {
+            clearInterval(this.idleTimer);
+            this.idleTimer = null;
+        }
+        if (!this.db)
+            return;
+        this.idleTimer = setInterval(() => {
+            this.passiveCheckpoint();
+        }, this.IDLE_CHECKPOINT_MS);
+        // setInterval keeps the event loop alive — unref so it doesn't prevent exit.
+        if (typeof this.idleTimer === 'object' && this.idleTimer !== null && 'unref' in this.idleTimer) {
+            this.idleTimer.unref();
+        }
+    }
+    /**
+     * Run a TRUNCATE checkpoint then close the connection.
+     * Called in gracefulShutdown() before the process exits.
+     */
+    close() {
+        if (this.idleTimer !== null) {
+            clearInterval(this.idleTimer);
+            this.idleTimer = null;
+        }
+        this.truncateCheckpoint();
+        try {
+            this.db?.close();
+        }
+        catch {
+            // Non-fatal — process is exiting anyway.
+        }
+        this.db = null;
+    }
+    /**
+     * Expose the underlying DatabaseSync for direct SQL in server.ts handlers.
+     * Returns null when the DB is not open (memory mode or open() failed).
+     */
+    getDb() {
+        return this.db;
+    }
+}
+/** Module singleton — imported by server.ts and index.ts. */
+export const sqliteOwner = new SqliteOwner();
+//# sourceMappingURL=sqlite-owner.js.map

package/dist/daemon/sqlite-owner.js.map

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

package/dist/daemon/startup.d.ts

@@ -0,0 +1,51 @@
+/**
+ * startup.ts — Daemon lifecycle helpers.
+ *
+ * Two halves:
+ *   Daemon side  — writePidFile, removePidFile, removeSocketFile, path helpers
+ *   Hook side    — isDaemonRunning, launchDaemon, waitForSocket
+ *
+ * The lock file (O_CREAT|O_EXCL) prevents races when multiple hooks fire
+ * simultaneously at session start. Only one process wins the lock and
+ * launches the daemon; the rest see 'already-launching'.
+ */
+export declare function getDaemonSocketPath(): string;
+export declare function getDaemonPidPath(): string;
+export declare function getDaemonLockPath(): string;
+export declare function getDaemonHttpPortPath(): string;
+export declare function getDaemonTokenPath(): string;
+/** Write HTTP fallback credentials (port + auth token) to disk at 0600 perms. */
+export declare function writeHttpCredentials(port: number, token: string): void;
+/** Remove HTTP fallback credential files on daemon shutdown. */
+export declare function removeHttpCredentials(): void;
+/** Read HTTP fallback credentials. Returns null if either file is missing or malformed. */
+export declare function readHttpCredentials(): {
+    port: number;
+    token: string;
+} | null;
+export declare function writePidFile(): void;
+export declare function removePidFile(): void;
+export declare function removeSocketFile(): void;
+/**
+ * Returns true if the daemon process is alive AND the socket file exists.
+ * Uses `process.kill(pid, 0)` as a lightweight liveness probe.
+ */
+export declare function isDaemonRunning(): boolean;
+/**
+ * Launch the daemon as a detached background process.
+ *
+ * Uses a lock file (O_CREAT|O_EXCL) to prevent simultaneous launches when
+ * multiple hooks fire at the same time.
+ *
+ * Returns:
+ *   'launched'          — daemon successfully spawned
+ *   'already-launching' — another process holds the lock
+ *   'already-running'   — daemon is already alive
+ */
+export declare function launchDaemon(): 'launched' | 'already-launching' | 'already-running';
+/**
+ * Poll for the daemon socket to appear, up to maxWaitMs milliseconds.
+ * Used by session-start after launchDaemon() to wait for the socket to be ready.
+ */
+export declare function waitForSocket(maxWaitMs?: number): Promise<boolean>;
+//# sourceMappingURL=startup.d.ts.map