@gramatr/mcp 0.11.11 → 0.11.14

package/dist/daemon/index.js

@@ -0,0 +1,126 @@
+/**
+ * daemon/index.ts — Entry point for `gramatr-mcp daemon start`.
+ *
+ * Starts the Unix socket IPC server, writes the PID file, removes the lock
+ * file (unblocking hook processes waiting on waitForSocket), registers
+ * graceful shutdown handlers, and emits a ready message to stderr.
+ *
+ * Sprint 2: sqliteOwner.open() / .close() for WAL checkpoint lifecycle,
+ *           daemon.active sentinel for cross-process signaling.
+ * Sprint 3: projectCache.load() / .save() for in-process project identity.
+ */
+import { unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createDaemonServer, dispatchRpcRequest } from './server.js';
+import { startHttpFallback } from './http-server.js';
+import { writePidFile, removePidFile, removeSocketFile, getDaemonSocketPath, getDaemonLockPath, writeHttpCredentials, removeHttpCredentials, } from './startup.js';
+import { sessionRegistry } from './session-registry.js';
+import { sqliteOwner } from './sqlite-owner.js';
+import { closeDb } from '../hooks/lib/hook-state.js';
+import { getGramatrDirFromEnv, getGramatrStateDatabaseFromEnv, getHomeDir } from '../config-runtime.js';
+import { getStateDatabasePath } from './db-path.js';
+import { projectCache, getProjectCachePath } from './project-cache.js';
+function getGramatrDir() {
+    return getGramatrDirFromEnv() ?? join(getHomeDir(), '.gramatr');
+}
+function getSentinelPath() {
+    return join(getGramatrDir(), 'daemon.active');
+}
+function writeSentinel() {
+    // Skip when running in-memory (tests).
+    if (getStateDatabasePath() === ':memory:')
+        return;
+    try {
+        writeFileSync(getSentinelPath(), String(process.pid), 'utf8');
+    }
+    catch {
+        // Non-fatal — sentinel is a best-effort signal.
+    }
+}
+function removeSentinel() {
+    try {
+        unlinkSync(getSentinelPath());
+    }
+    catch {
+        // Already gone or never written.
+    }
+}
+let _httpServer = null;
+export async function startDaemon() {
+    const sockPath = getDaemonSocketPath();
+    const server = createDaemonServer();
+    // Start listening on the Unix socket
+    await new Promise((resolve, reject) => {
+        server.listen(sockPath, () => resolve());
+        server.once('error', reject);
+    });
+    writePidFile();
+    // Open the daemon's owned SQLite connection and start the checkpoint cycle.
+    sqliteOwner.open();
+    // Restore project identity cache from disk (skip in :memory: test mode)
+    if (getGramatrStateDatabaseFromEnv() !== ':memory:') {
+        projectCache.load(getProjectCachePath());
+    }
+    // Remove the lock file now that the socket is ready.
+    // This unblocks any hook that is polling waitForSocket().
+    try {
+        unlinkSync(getDaemonLockPath());
+    }
+    catch {
+        // Already gone — another racer may have cleaned it up
+    }
+    // Start localhost HTTP fallback (Tier 2 IPC — works on all platforms including Windows)
+    try {
+        const { port, token, server: hs } = await startHttpFallback(dispatchRpcRequest);
+        _httpServer = hs;
+        writeHttpCredentials(port, token);
+        process.stderr.write(`[gramatr-daemon] HTTP fallback on 127.0.0.1:${port}\n`);
+    }
+    catch (err) {
+        // Non-fatal — hooks fall back to remote HTTP if localhost HTTP unavailable
+        process.stderr.write(`[gramatr-daemon] HTTP fallback unavailable: ${err.message}\n`);
+    }
+    // Write daemon.active sentinel so hook processes know the daemon owns the DB.
+    writeSentinel();
+    // Graceful shutdown when the last session releases (+ 30s grace)
+    sessionRegistry.setOnEmpty(() => {
+        gracefulShutdown(server, 'idle');
+    });
+    // Handle the internal daemon/shutdown method (emitted via setImmediate)
+    server.on('daemon-shutdown', () => {
+        gracefulShutdown(server, 'requested');
+    });
+    process.on('SIGTERM', () => gracefulShutdown(server, 'SIGTERM'));
+    process.on('SIGINT', () => gracefulShutdown(server, 'SIGINT'));
+    process.stderr.write(`[gramatr-daemon] listening on ${sockPath} (pid ${process.pid})\n`);
+}
+async function gracefulShutdown(server, reason) {
+    process.stderr.write(`[gramatr-daemon] shutting down (${reason})\n`);
+    server.close();
+    _httpServer?.close();
+    removeHttpCredentials();
+    // Persist project identity cache to disk (skip in :memory: test mode)
+    if (getGramatrStateDatabaseFromEnv() !== ':memory:') {
+        projectCache.save(getProjectCachePath());
+    }
+    // TRUNCATE checkpoint via daemon's owned connection — must run before closeDb().
+    try {
+        sqliteOwner.close();
+    }
+    catch {
+        // Non-fatal
+    }
+    // closeDb() handles any hook-state.ts DB connection that may be open in
+    // this process (e.g. from tools invoked directly in the daemon process).
+    try {
+        closeDb();
+    }
+    catch {
+        // Non-fatal
+    }
+    removeSentinel();
+    removePidFile();
+    removeSocketFile();
+    process.exit(0);
+}
+//# sourceMappingURL=index.js.map

package/dist/daemon/index.js.map

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

package/dist/daemon/ipc-protocol.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ipc-protocol.ts — Types for the gramatr daemon IPC protocol.
+ *
+ * Newline-delimited JSON-RPC 2.0 over a Unix domain socket.
+ * One JSON object per line; no framing beyond the newline terminator.
+ *
+ * This file is types-only — no runtime code.
+ */
+export interface DaemonRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: DaemonMethod;
+    params: Record<string, unknown>;
+}
+export interface DaemonResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type DaemonMethod = 'tool/call' | 'session/register' | 'session/release' | 'session/context/get' | 'session/context/set' | 'project/resolve' | 'project/cache-set' | 'db/query' | 'daemon/ping' | 'daemon/shutdown';
+/**
+ * Parameters for the db/query IPC method.
+ *
+ * Forwards the three most-called read operations to the daemon's owned
+ * SQLite connection. Hook processes check for the daemon.active sentinel
+ * file before routing through IPC (Sprint 3 will wire the async call path).
+ */
+export interface DbQueryParams {
+    operation: 'getSessionContext' | 'getLastSessionForProject' | 'getLocalProjectByDirectory';
+    args: Record<string, unknown>;
+}
+export declare const DAEMON_UNAVAILABLE: unique symbol;
+export type DaemonUnavailable = typeof DAEMON_UNAVAILABLE;
+/** Parameters for the `project/resolve` IPC method. */
+export interface ProjectResolveParams {
+    git_remote?: string;
+    directory?: string;
+    slug?: string;
+}
+/** Response shape for a successful `project/resolve` hit. */
+export interface ProjectResolveHit {
+    found: true;
+    project_id: string;
+    slug: string;
+}
+/** Response shape for a `project/resolve` miss. */
+export interface ProjectResolveMiss {
+    found: false;
+}
+export type ProjectResolveResult = ProjectResolveHit | ProjectResolveMiss;
+//# sourceMappingURL=ipc-protocol.d.ts.map

package/dist/daemon/ipc-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-protocol.d.ts","sourceRoot":"","sources":["../../src/daemon/ipc-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,GACrB,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,UAAU,GACV,aAAa,GACb,iBAAiB,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EACL,mBAAmB,GACnB,0BAA0B,GAC1B,4BAA4B,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC;AAI1D,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC"}

package/dist/daemon/ipc-protocol.js

@@ -0,0 +1,10 @@
+/**
+ * ipc-protocol.ts — Types for the gramatr daemon IPC protocol.
+ *
+ * Newline-delimited JSON-RPC 2.0 over a Unix domain socket.
+ * One JSON object per line; no framing beyond the newline terminator.
+ *
+ * This file is types-only — no runtime code.
+ */
+export const DAEMON_UNAVAILABLE = Symbol('DAEMON_UNAVAILABLE');
+//# sourceMappingURL=ipc-protocol.js.map

package/dist/daemon/ipc-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-protocol.js","sourceRoot":"","sources":["../../src/daemon/ipc-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2CH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/daemon/project-cache.d.ts

@@ -0,0 +1,63 @@
+/**
+ * project-cache.ts — In-process project identity cache for the gramatr daemon.
+ *
+ * The most expensive operation in session-start is resolving
+ * `git remote → project_id`. This module caches the result in the daemon
+ * process so repeated lookups are Map lookups (~0ms) rather than SQLite or
+ * remote server calls.
+ *
+ * The cache is keyed on three lookup axes simultaneously:
+ *   - git remote URL  (e.g. "git@github.com:org/repo.git")
+ *   - working directory (e.g. "/home/user/work/myproject")
+ *   - project slug    (e.g. "org/repo")
+ *
+ * On daemon start: restored from ~/.gramatr/project-cache.json (warm start).
+ * On daemon shutdown: persisted to the same file.
+ * Skip load/save when GRAMATR_STATE_DB === ':memory:' (test mode).
+ */
+export interface ProjectEntry {
+    id: string;
+    slug: string;
+    gitRemote: string | null;
+    directory: string | null;
+    cachedAt: number;
+}
+declare class ProjectCache {
+    private byRemote;
+    private byDirectory;
+    private bySlug;
+    /** Add or update a project entry in all applicable index maps. */
+    set(entry: ProjectEntry): void;
+    /** Look up by git remote URL. Returns null on cache miss or TTL expiry. */
+    getByRemote(remote: string): ProjectEntry | null;
+    /** Look up by working directory path. Returns null on cache miss or TTL expiry. */
+    getByDirectory(dir: string): ProjectEntry | null;
+    /** Look up by project slug. Returns null on cache miss or TTL expiry. */
+    getBySlug(slug: string): ProjectEntry | null;
+    /**
+     * Remove a project entry from all index maps by project ID.
+     * Scans all maps — O(n) but the cache is small and invalidation is rare.
+     */
+    invalidate(id: string): void;
+    /** Total number of unique project entries (by slug). */
+    size(): number;
+    /**
+     * Persist the cache to a JSON file on shutdown.
+     * Silently skips on write errors — the cache is advisory only.
+     */
+    save(path: string): void;
+    /**
+     * Restore the cache from a JSON file on startup.
+     * Silently skips on read/parse errors — cache starts empty.
+     */
+    load(path: string): void;
+    private _isExpired;
+}
+export declare const projectCache: ProjectCache;
+/**
+ * Returns the filesystem path for the project cache JSON file.
+ * Uses GRAMATR_DIR env override when available, otherwise ~/.gramatr/.
+ */
+export declare function getProjectCachePath(): string;
+export {};
+//# sourceMappingURL=project-cache.d.ts.map

package/dist/daemon/project-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-cache.d.ts","sourceRoot":"","sources":["../../src/daemon/project-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,MAAM,CAAmC;IAEjD,kEAAkE;IAClE,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAM9B,2EAA2E;IAC3E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKhD,mFAAmF;IACnF,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKhD,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK5C;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAY5B,wDAAwD;IACxD,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAaxB;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAiBxB,OAAO,CAAC,UAAU;CAGnB;AAkBD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C"}

package/dist/daemon/project-cache.js

@@ -0,0 +1,139 @@
+/**
+ * project-cache.ts — In-process project identity cache for the gramatr daemon.
+ *
+ * The most expensive operation in session-start is resolving
+ * `git remote → project_id`. This module caches the result in the daemon
+ * process so repeated lookups are Map lookups (~0ms) rather than SQLite or
+ * remote server calls.
+ *
+ * The cache is keyed on three lookup axes simultaneously:
+ *   - git remote URL  (e.g. "git@github.com:org/repo.git")
+ *   - working directory (e.g. "/home/user/work/myproject")
+ *   - project slug    (e.g. "org/repo")
+ *
+ * On daemon start: restored from ~/.gramatr/project-cache.json (warm start).
+ * On daemon shutdown: persisted to the same file.
+ * Skip load/save when GRAMATR_STATE_DB === ':memory:' (test mode).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { getGramatrDirFromEnv, getHomeDir } from '../config-runtime.js';
+// 24-hour TTL — projects don't change identity frequently
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+// ── Cache class ───────────────────────────────────────────────────────────────
+class ProjectCache {
+    byRemote = new Map();
+    byDirectory = new Map();
+    bySlug = new Map();
+    /** Add or update a project entry in all applicable index maps. */
+    set(entry) {
+        if (entry.gitRemote)
+            this.byRemote.set(entry.gitRemote, entry);
+        if (entry.directory)
+            this.byDirectory.set(entry.directory, entry);
+        this.bySlug.set(entry.slug, entry);
+    }
+    /** Look up by git remote URL. Returns null on cache miss or TTL expiry. */
+    getByRemote(remote) {
+        const entry = this.byRemote.get(remote);
+        return entry && !this._isExpired(entry) ? entry : null;
+    }
+    /** Look up by working directory path. Returns null on cache miss or TTL expiry. */
+    getByDirectory(dir) {
+        const entry = this.byDirectory.get(dir);
+        return entry && !this._isExpired(entry) ? entry : null;
+    }
+    /** Look up by project slug. Returns null on cache miss or TTL expiry. */
+    getBySlug(slug) {
+        const entry = this.bySlug.get(slug);
+        return entry && !this._isExpired(entry) ? entry : null;
+    }
+    /**
+     * Remove a project entry from all index maps by project ID.
+     * Scans all maps — O(n) but the cache is small and invalidation is rare.
+     */
+    invalidate(id) {
+        for (const [key, entry] of this.byRemote) {
+            if (entry.id === id)
+                this.byRemote.delete(key);
+        }
+        for (const [key, entry] of this.byDirectory) {
+            if (entry.id === id)
+                this.byDirectory.delete(key);
+        }
+        for (const [key, entry] of this.bySlug) {
+            if (entry.id === id)
+                this.bySlug.delete(key);
+        }
+    }
+    /** Total number of unique project entries (by slug). */
+    size() {
+        return this.bySlug.size;
+    }
+    /**
+     * Persist the cache to a JSON file on shutdown.
+     * Silently skips on write errors — the cache is advisory only.
+     */
+    save(path) {
+        try {
+            const dir = dirname(path);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            // De-duplicate: slug map is canonical (every entry is in bySlug)
+            const entries = [...this.bySlug.values()].filter((e) => !this._isExpired(e));
+            writeFileSync(path, JSON.stringify(entries, null, 2), 'utf8');
+        }
+        catch {
+            // Non-fatal — cache miss on next start is safe
+        }
+    }
+    /**
+     * Restore the cache from a JSON file on startup.
+     * Silently skips on read/parse errors — cache starts empty.
+     */
+    load(path) {
+        try {
+            if (!existsSync(path))
+                return;
+            const raw = readFileSync(path, 'utf8');
+            const entries = JSON.parse(raw);
+            if (!Array.isArray(entries))
+                return;
+            for (const item of entries) {
+                if (!isProjectEntry(item))
+                    continue;
+                if (this._isExpired(item))
+                    continue;
+                this.set(item);
+            }
+        }
+        catch {
+            // Non-fatal — cache starts empty
+        }
+    }
+    _isExpired(entry) {
+        return Date.now() - entry.cachedAt > CACHE_TTL_MS;
+    }
+}
+// ── Type guard ────────────────────────────────────────────────────────────────
+function isProjectEntry(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const o = v;
+    return (typeof o.id === 'string' &&
+        typeof o.slug === 'string' &&
+        typeof o.cachedAt === 'number' &&
+        (o.gitRemote === null || typeof o.gitRemote === 'string') &&
+        (o.directory === null || typeof o.directory === 'string'));
+}
+// ── Singleton ─────────────────────────────────────────────────────────────────
+export const projectCache = new ProjectCache();
+/**
+ * Returns the filesystem path for the project cache JSON file.
+ * Uses GRAMATR_DIR env override when available, otherwise ~/.gramatr/.
+ */
+export function getProjectCachePath() {
+    const dir = getGramatrDirFromEnv() ?? join(getHomeDir(), '.gramatr');
+    return join(dir, 'project-cache.json');
+}
+//# sourceMappingURL=project-cache.js.map

package/dist/daemon/project-cache.js.map

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

package/dist/daemon/server.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 { type Server, type Socket } from 'node:net';
+import type { DaemonRequest } from './ipc-protocol.js';
+/**
+ * Route a JSON-RPC 2.0 request to the appropriate handler.
+ * Exported so the HTTP fallback server can share the same dispatch logic.
+ */
+export declare function dispatchRpcRequest(req: DaemonRequest): Promise<unknown>;
+export declare function createDaemonServer(): Server;
+export declare function getActiveSockets(): Set<Socket>;
+//# sourceMappingURL=server.d.ts.map

package/dist/daemon/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAuD,MAAM,mBAAmB,CAAC;AA8F5G;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA+J7E;AAgFD,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C;AAED,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE9C"}