@optave/codegraph 3.2.0 → 3.3.1

package/dist/infrastructure/registry.js

@@ -0,0 +1,157 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { debug, warn } from './logger.js';
+export const REGISTRY_PATH = process.env.CODEGRAPH_REGISTRY_PATH || path.join(os.homedir(), '.codegraph', 'registry.json');
+/** Default TTL: entries not accessed within 30 days are pruned. */
+export const DEFAULT_TTL_DAYS = 30;
+/**
+ * Load the registry from disk.
+ * Returns `{ repos: {} }` on missing or corrupt file.
+ */
+export function loadRegistry(registryPath = REGISTRY_PATH) {
+    try {
+        const raw = fs.readFileSync(registryPath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (!data || typeof data.repos !== 'object')
+            return { repos: {} };
+        return data;
+    }
+    catch {
+        return { repos: {} };
+    }
+}
+/**
+ * Persist the registry to disk (atomic write via temp + rename).
+ * Creates the parent directory if needed.
+ */
+export function saveRegistry(registry, registryPath = REGISTRY_PATH) {
+    const dir = path.dirname(registryPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${registryPath}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(registry, null, 2), 'utf-8');
+    fs.renameSync(tmp, registryPath);
+}
+/**
+ * Register a project directory. Idempotent.
+ * Name defaults to `path.basename(rootDir)`.
+ *
+ * When no explicit name is provided and the basename already exists
+ * pointing to a different path, auto-suffixes (`api` → `api-2`, `api-3`, …).
+ * Re-registering the same path updates in place. Explicit names always overwrite.
+ */
+export function registerRepo(rootDir, name, registryPath = REGISTRY_PATH) {
+    const absRoot = path.resolve(rootDir);
+    const baseName = name || path.basename(absRoot);
+    const registry = loadRegistry(registryPath);
+    let repoName = baseName;
+    // Auto-suffix only when no explicit name was provided
+    if (!name) {
+        const existing = registry.repos[baseName];
+        if (existing && path.resolve(existing.path) !== absRoot) {
+            // Basename collision with a different path — find next available suffix
+            let suffix = 2;
+            while (registry.repos[`${baseName}-${suffix}`]) {
+                const entry = registry.repos[`${baseName}-${suffix}`];
+                if (path.resolve(entry.path) === absRoot) {
+                    // Already registered under this suffixed name — update in place
+                    repoName = `${baseName}-${suffix}`;
+                    break;
+                }
+                suffix++;
+            }
+            if (repoName === baseName) {
+                repoName = `${baseName}-${suffix}`;
+            }
+        }
+    }
+    const now = new Date().toISOString();
+    registry.repos[repoName] = {
+        path: absRoot,
+        dbPath: path.join(absRoot, '.codegraph', 'graph.db'),
+        addedAt: registry.repos[repoName]?.addedAt || now,
+        lastAccessedAt: now,
+    };
+    saveRegistry(registry, registryPath);
+    debug(`Registered repo "${repoName}" at ${absRoot}`);
+    return { name: repoName, entry: registry.repos[repoName] };
+}
+/**
+ * Remove a repo from the registry. Returns false if not found.
+ */
+export function unregisterRepo(name, registryPath = REGISTRY_PATH) {
+    const registry = loadRegistry(registryPath);
+    if (!registry.repos[name])
+        return false;
+    delete registry.repos[name];
+    saveRegistry(registry, registryPath);
+    return true;
+}
+/**
+ * List all registered repos, sorted by name.
+ */
+export function listRepos(registryPath = REGISTRY_PATH) {
+    const registry = loadRegistry(registryPath);
+    return Object.entries(registry.repos)
+        .map(([name, entry]) => ({
+        name,
+        path: entry.path,
+        dbPath: entry.dbPath,
+        addedAt: entry.addedAt,
+        lastAccessedAt: entry.lastAccessedAt || entry.addedAt,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Resolve a repo name to its database path.
+ * Returns undefined if the repo is not found or its DB file is missing.
+ */
+export function resolveRepoDbPath(name, registryPath = REGISTRY_PATH) {
+    const registry = loadRegistry(registryPath);
+    const entry = registry.repos[name];
+    if (!entry)
+        return undefined;
+    if (!fs.existsSync(entry.dbPath)) {
+        warn(`Registry: database missing for "${name}" at ${entry.dbPath}`);
+        return undefined;
+    }
+    // Touch lastAccessedAt on successful resolution
+    entry.lastAccessedAt = new Date().toISOString();
+    saveRegistry(registry, registryPath);
+    return entry.dbPath;
+}
+/**
+ * Remove registry entries whose repo directory no longer exists on disk,
+ * or that haven't been accessed within `ttlDays` days.
+ * Returns an array of `{ name, path, reason }` for each pruned entry.
+ *
+ * When `dryRun` is true, entries are identified but not removed from disk.
+ */
+export function pruneRegistry(registryPath = REGISTRY_PATH, ttlDays = DEFAULT_TTL_DAYS, excludeNames = [], dryRun = false) {
+    const registry = loadRegistry(registryPath);
+    const pruned = [];
+    const cutoff = Date.now() - ttlDays * 24 * 60 * 60 * 1000;
+    const excludeSet = new Set(excludeNames.filter((n) => typeof n === 'string' && n.trim().length > 0));
+    for (const [name, entry] of Object.entries(registry.repos)) {
+        if (excludeSet.has(name))
+            continue;
+        if (!fs.existsSync(entry.path)) {
+            pruned.push({ name, path: entry.path, reason: 'missing' });
+            if (!dryRun)
+                delete registry.repos[name];
+            continue;
+        }
+        const lastAccess = Date.parse(entry.lastAccessedAt || entry.addedAt);
+        if (lastAccess < cutoff) {
+            pruned.push({ name, path: entry.path, reason: 'expired' });
+            if (!dryRun)
+                delete registry.repos[name];
+        }
+    }
+    if (!dryRun && pruned.length > 0) {
+        saveRegistry(registry, registryPath);
+    }
+    return pruned;
+}
+//# sourceMappingURL=registry.js.map

package/dist/infrastructure/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/infrastructure/registry.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GACxB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;AAEhG,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,YAAY,GAAG,aAAa;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,GAAG,YAAY,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,sDAAsD;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YACxD,wEAAwE;YACxE,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;gBACtD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;oBACzC,gEAAgE;oBAChE,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACnC,MAAM;gBACR,CAAC;gBACD,MAAM,EAAE,CAAC;YACX,CAAC;YACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,QAAQ,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG;QACzB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC;QACpD,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,IAAI,GAAG;QACjD,cAAc,EAAE,GAAG;KACpB,CAAC;IAEF,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,KAAK,CAAC,oBAAoB,QAAQ,QAAQ,OAAO,EAAE,CAAC,CAAC;IACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,YAAY,GAAG,aAAa;IACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO;KACtD,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa;IAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,mCAAmC,IAAI,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,gDAAgD;IAChD,KAAK,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAY,GAAG,aAAa,EAC5B,OAAO,GAAG,gBAAgB,EAC1B,YAAY,GAAG,EAAE,EACjB,MAAM,GAAG,KAAK;IAEd,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CACzE,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,UAAU,GAAG,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/infrastructure/result-formatter.d.ts

@@ -0,0 +1,2 @@
+export { outputResult } from "../presentation/result-formatter.js";
+//# sourceMappingURL=result-formatter.d.ts.map

package/dist/infrastructure/result-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/result-formatter.js"],"names":[],"mappings":""}

package/dist/infrastructure/result-formatter.js

@@ -0,0 +1,3 @@
+// Re-export from presentation layer — this file exists for backward compatibility.
+export { outputResult } from '../presentation/result-formatter.js';
+//# sourceMappingURL=result-formatter.js.map

package/dist/infrastructure/result-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.js","sourceRoot":"","sources":["../../src/infrastructure/result-formatter.js"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/infrastructure/test-filter.d.ts

@@ -0,0 +1,5 @@
+/** Check whether a file path looks like a test file. */
+export function isTestFile(filePath: any): boolean;
+/** Pattern matching test/spec/stories files. */
+export const TEST_PATTERN: RegExp;
+//# sourceMappingURL=test-filter.d.ts.map

package/dist/infrastructure/test-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-filter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/test-filter.js"],"names":[],"mappings":"AAGA,wDAAwD;AACxD,mDAEC;AAND,gDAAgD;AAChD,kCAA6E"}

package/dist/infrastructure/test-filter.js

@@ -0,0 +1,7 @@
+/** Pattern matching test/spec/stories files. */
+export const TEST_PATTERN = /\.(test|spec)\.|__test__|__tests__|\.stories\./;
+/** Check whether a file path looks like a test file. */
+export function isTestFile(filePath) {
+    return TEST_PATTERN.test(filePath);
+}
+//# sourceMappingURL=test-filter.js.map

package/dist/infrastructure/test-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-filter.js","sourceRoot":"","sources":["../../src/infrastructure/test-filter.js"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAE7E,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,QAAQ;IACjC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/infrastructure/update-check.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Minimal semver comparison. Returns -1, 0, or 1.
+ * Only handles numeric x.y.z (no pre-release tags).
+ */
+export function semverCompare(a: any, b: any): 0 | 1 | -1;
+/**
+ * Check whether a newer version of codegraph is available.
+ *
+ * Returns `{ current, latest }` if an update is available, `null` otherwise.
+ * Silently returns null on any error — never affects CLI operation.
+ *
+ * Options:
+ *   cachePath — override cache file location (for testing)
+ *   _fetchLatest — override the fetch function (for testing)
+ */
+export function checkForUpdates(currentVersion: any, options?: {}): Promise<{
+    current: any;
+    latest: any;
+} | null>;
+/**
+ * Print a visible update notification box to stderr.
+ */
+export function printUpdateNotification(current: any, latest: any): void;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/infrastructure/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/infrastructure/update-check.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,0DAUC;AAqED;;;;;;;;;GASG;AACH;;;UAmCC;AAED;;GAEG;AACH,yEAaC"}

package/dist/infrastructure/update-check.js

@@ -0,0 +1,150 @@
+import fs from 'node:fs';
+import https from 'node:https';
+import os from 'node:os';
+import path from 'node:path';
+const CACHE_PATH = process.env.CODEGRAPH_UPDATE_CACHE_PATH ||
+    path.join(os.homedir(), '.codegraph', 'update-check.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const FETCH_TIMEOUT_MS = 3000;
+const REGISTRY_URL = 'https://registry.npmjs.org/@optave/codegraph/latest';
+/**
+ * Minimal semver comparison. Returns -1, 0, or 1.
+ * Only handles numeric x.y.z (no pre-release tags).
+ */
+export function semverCompare(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const na = pa[i] || 0;
+        const nb = pb[i] || 0;
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Load the cached update-check result from disk.
+ * Returns null on missing or corrupt file.
+ */
+function loadCache(cachePath = CACHE_PATH) {
+    try {
+        const raw = fs.readFileSync(cachePath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (!data || typeof data.lastCheckedAt !== 'number' || typeof data.latestVersion !== 'string') {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the cache to disk (atomic write via temp + rename).
+ */
+function saveCache(cache, cachePath = CACHE_PATH) {
+    const dir = path.dirname(cachePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${cachePath}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(cache), 'utf-8');
+    fs.renameSync(tmp, cachePath);
+}
+/**
+ * Fetch the latest version string from the npm registry.
+ * Returns the version string or null on failure.
+ */
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get(REGISTRY_URL, { timeout: FETCH_TIMEOUT_MS, headers: { Accept: 'application/json' } }, (res) => {
+            if (res.statusCode !== 200) {
+                res.resume();
+                resolve(null);
+                return;
+            }
+            let body = '';
+            res.setEncoding('utf-8');
+            res.on('data', (chunk) => {
+                body += chunk;
+            });
+            res.on('end', () => {
+                try {
+                    const data = JSON.parse(body);
+                    resolve(typeof data.version === 'string' ? data.version : null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(null);
+        });
+    });
+}
+/**
+ * Check whether a newer version of codegraph is available.
+ *
+ * Returns `{ current, latest }` if an update is available, `null` otherwise.
+ * Silently returns null on any error — never affects CLI operation.
+ *
+ * Options:
+ *   cachePath — override cache file location (for testing)
+ *   _fetchLatest — override the fetch function (for testing)
+ */
+export async function checkForUpdates(currentVersion, options = {}) {
+    // Suppress in non-interactive / CI contexts
+    if (process.env.CI)
+        return null;
+    if (process.env.NO_UPDATE_CHECK)
+        return null;
+    if (!process.stderr.isTTY)
+        return null;
+    if (currentVersion.includes('-'))
+        return null;
+    const cachePath = options.cachePath || CACHE_PATH;
+    const fetchFn = options._fetchLatest || fetchLatestVersion;
+    try {
+        const cache = loadCache(cachePath);
+        // Cache is fresh — use it
+        if (cache && Date.now() - cache.lastCheckedAt < CACHE_TTL_MS) {
+            if (semverCompare(currentVersion, cache.latestVersion) < 0) {
+                return { current: currentVersion, latest: cache.latestVersion };
+            }
+            return null;
+        }
+        // Cache is stale or missing — fetch
+        const latest = await fetchFn();
+        if (!latest)
+            return null;
+        // Update cache regardless of result
+        saveCache({ lastCheckedAt: Date.now(), latestVersion: latest }, cachePath);
+        if (semverCompare(currentVersion, latest) < 0) {
+            return { current: currentVersion, latest };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Print a visible update notification box to stderr.
+ */
+export function printUpdateNotification(current, latest) {
+    const msg1 = `Update available: ${current} → ${latest}`;
+    const msg2 = 'Run `npm i -g @optave/codegraph` to update';
+    const width = Math.max(msg1.length, msg2.length) + 4;
+    const top = `┌${'─'.repeat(width)}┐`;
+    const bot = `└${'─'.repeat(width)}┘`;
+    const pad1 = ' '.repeat(width - msg1.length - 2);
+    const pad2 = ' '.repeat(width - msg2.length - 2);
+    const line1 = `│  ${msg1}${pad1}│`;
+    const line2 = `│  ${msg2}${pad2}│`;
+    process.stderr.write(`\n${top}\n${line1}\n${line2}\n${bot}\n\n`);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/infrastructure/update-check.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { startMCPServer } from "./server.js";
+export { buildToolList, TOOLS } from "./tool-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.js"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+export { startMCPServer } from './server.js';
+export { buildToolList, TOOLS } from './tool-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/middleware.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Initialize MCP defaults from config. Call once at server startup.
+ * @param {object} [configMcpDefaults] - config.mcp.defaults overrides
+ */
+export function initMcpDefaults(configMcpDefaults?: object): void;
+/**
+ * Reset MCP defaults back to the base defaults. Useful for test isolation.
+ */
+export function resetMcpDefaults(): void;
+/**
+ * Resolve effective limit for a tool call.
+ * @param {object} args - Tool arguments
+ * @param {string} toolName - Tool name (for default lookup)
+ * @returns {number}
+ */
+export function effectiveLimit(args: object, toolName: string): number;
+/**
+ * Resolve effective offset for a tool call.
+ * @param {object} args - Tool arguments
+ * @returns {number}
+ */
+export function effectiveOffset(args: object): number;
+import { MCP_DEFAULTS } from '../shared/paginate.js';
+import { MCP_MAX_LIMIT } from '../shared/paginate.js';
+export { MCP_DEFAULTS, MCP_MAX_LIMIT };
+//# sourceMappingURL=middleware.d.ts.map

package/dist/mcp/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/mcp/middleware.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH,oDAFW,MAAM,QAIhB;AAED;;GAEG;AACH,yCAEC;AAED;;;;;GAKG;AACH,qCAJW,MAAM,YACN,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,sCAHW,MAAM,GACJ,MAAM,CAIlB;6BAvC2D,uBAAuB;8BAAvB,uBAAuB"}

package/dist/mcp/middleware.js

@@ -0,0 +1,38 @@
+/**
+ * MCP middleware helpers — pagination defaults and limits.
+ */
+import { getMcpDefaults, MCP_DEFAULTS, MCP_MAX_LIMIT } from '../shared/paginate.js';
+export { MCP_DEFAULTS, MCP_MAX_LIMIT };
+/** Resolved MCP defaults (may include config overrides). Set via initMcpDefaults(). */
+let resolvedDefaults = MCP_DEFAULTS;
+/**
+ * Initialize MCP defaults from config. Call once at server startup.
+ * @param {object} [configMcpDefaults] - config.mcp.defaults overrides
+ */
+export function initMcpDefaults(configMcpDefaults) {
+    resolvedDefaults = getMcpDefaults(configMcpDefaults);
+}
+/**
+ * Reset MCP defaults back to the base defaults. Useful for test isolation.
+ */
+export function resetMcpDefaults() {
+    resolvedDefaults = MCP_DEFAULTS;
+}
+/**
+ * Resolve effective limit for a tool call.
+ * @param {object} args - Tool arguments
+ * @param {string} toolName - Tool name (for default lookup)
+ * @returns {number}
+ */
+export function effectiveLimit(args, toolName) {
+    return Math.min(args.limit ?? resolvedDefaults[toolName] ?? 100, MCP_MAX_LIMIT);
+}
+/**
+ * Resolve effective offset for a tool call.
+ * @param {object} args - Tool arguments
+ * @returns {number}
+ */
+export function effectiveOffset(args) {
+    return args.offset ?? 0;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/mcp/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/mcp/middleware.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAEvC,uFAAuF;AACvF,IAAI,gBAAgB,GAAG,YAAY,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,iBAAiB;IAC/C,gBAAgB,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,gBAAgB,GAAG,YAAY,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAI,EAAE,QAAQ;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,aAAa,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI;IAClC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,2 @@
+export function startMCPServer(customDbPath: any, options?: {}): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.js"],"names":[],"mappings":"AA2FA,+EAmDC"}

package/dist/mcp/server.js

@@ -0,0 +1,120 @@
+/**
+ * MCP (Model Context Protocol) server for codegraph.
+ * Exposes codegraph queries as tools that AI coding assistants can call.
+ *
+ * Requires: npm install @modelcontextprotocol/sdk
+ */
+import { createRequire } from 'node:module';
+import { findDbPath } from '../db/index.js';
+import { loadConfig } from '../infrastructure/config.js';
+import { CodegraphError, ConfigError } from '../shared/errors.js';
+import { MCP_MAX_LIMIT } from '../shared/paginate.js';
+import { initMcpDefaults } from './middleware.js';
+import { buildToolList } from './tool-registry.js';
+import { TOOL_HANDLERS } from './tools/index.js';
+/**
+ * Start the MCP server.
+ * This function requires @modelcontextprotocol/sdk to be installed.
+ *
+ * @param {string} [customDbPath] - Path to a specific graph.db
+ * @param {object} [options]
+ * @param {boolean} [options.multiRepo] - Enable multi-repo access (default: false)
+ * @param {string[]} [options.allowedRepos] - Restrict access to these repo names only
+ */
+async function loadMCPSdk() {
+    try {
+        const sdk = await import('@modelcontextprotocol/sdk/server/index.js');
+        const transport = await import('@modelcontextprotocol/sdk/server/stdio.js');
+        const types = await import('@modelcontextprotocol/sdk/types.js');
+        return {
+            Server: sdk.Server,
+            StdioServerTransport: transport.StdioServerTransport,
+            ListToolsRequestSchema: types.ListToolsRequestSchema,
+            CallToolRequestSchema: types.CallToolRequestSchema,
+        };
+    }
+    catch {
+        throw new ConfigError('MCP server requires @modelcontextprotocol/sdk.\nInstall it with: npm install @modelcontextprotocol/sdk');
+    }
+}
+function createLazyLoaders() {
+    let _queries;
+    let _Database;
+    return {
+        async getQueries() {
+            if (!_queries)
+                _queries = await import('../domain/queries.js');
+            return _queries;
+        },
+        getDatabase() {
+            if (!_Database) {
+                const require = createRequire(import.meta.url);
+                _Database = require('better-sqlite3');
+            }
+            return _Database;
+        },
+    };
+}
+async function resolveDbPath(customDbPath, args, allowedRepos) {
+    let dbPath = customDbPath || undefined;
+    if (args.repo) {
+        if (allowedRepos && !allowedRepos.includes(args.repo)) {
+            throw new ConfigError(`Repository "${args.repo}" is not in the allowed repos list.`);
+        }
+        const { resolveRepoDbPath } = await import('../infrastructure/registry.js');
+        const resolved = resolveRepoDbPath(args.repo);
+        if (!resolved)
+            throw new ConfigError(`Repository "${args.repo}" not found in registry or its database is missing.`);
+        dbPath = resolved;
+    }
+    return dbPath;
+}
+function validateMultiRepoAccess(multiRepo, name, args) {
+    if (!multiRepo && args.repo) {
+        throw new ConfigError('Multi-repo access is disabled. Restart with `codegraph mcp --multi-repo` to access other repositories.');
+    }
+    if (!multiRepo && name === 'list_repos') {
+        throw new ConfigError('Multi-repo access is disabled. Restart with `codegraph mcp --multi-repo` to list repositories.');
+    }
+}
+export async function startMCPServer(customDbPath, options = {}) {
+    const { allowedRepos } = options;
+    const multiRepo = options.multiRepo || !!allowedRepos;
+    // Apply config-based MCP page-size overrides
+    const config = options.config || loadConfig();
+    initMcpDefaults(config.mcp?.defaults);
+    const { Server, StdioServerTransport, ListToolsRequestSchema, CallToolRequestSchema } = await loadMCPSdk();
+    // Connect transport FIRST so the server can receive the client's
+    // `initialize` request while heavy modules (queries, better-sqlite3)
+    // are still loading.  These are lazy-loaded on the first tool call
+    // and cached for subsequent calls.
+    const { getQueries, getDatabase } = createLazyLoaders();
+    const server = new Server({ name: 'codegraph', version: '1.0.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: buildToolList(multiRepo),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            validateMultiRepoAccess(multiRepo, name, args);
+            const dbPath = await resolveDbPath(customDbPath, args, allowedRepos);
+            const toolEntry = TOOL_HANDLERS.get(name);
+            if (!toolEntry) {
+                return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+            }
+            const ctx = { dbPath, getQueries, getDatabase, findDbPath, allowedRepos, MCP_MAX_LIMIT };
+            const result = await toolEntry.handler(args, ctx);
+            if (result?.content)
+                return result;
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            const code = err instanceof CodegraphError ? err.code : 'UNKNOWN_ERROR';
+            const text = err instanceof CodegraphError ? `[${code}] ${err.message}` : `Error: ${err.message}`;
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tool-registry.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Build the tool list based on multi-repo mode.
+ * @param {boolean} multiRepo - If true, inject `repo` prop into each tool and append `list_repos`
+ * @returns {object[]}
+ */
+export function buildToolList(multiRepo: boolean): object[];
+export const TOOLS: object[];
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.js"],"names":[],"mappings":"AAg0BA;;;;GAIG;AACH,yCAHW,OAAO,GACL,MAAM,EAAE,CAcpB;AAGD,6BAAyC"}