optave-codegraph 3.13.0

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAC/C,gBAAgB,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,WAAW,CAAC;IACrD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IACzE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IAClF,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC"}

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { run } from './cli/index.js';
+import { disposeParsers } from './domain/parser.js';
+import { CodegraphError, toErrorMessage } from './shared/errors.js';
+/**
+ * After the CLI command finishes, tear down any cached WASM parsers and the
+ * worker thread pool. The WASM parse worker (see `domain/wasm-worker-pool.ts`)
+ * keeps the event loop alive until `worker.terminate()` is called, so without
+ * this teardown short-lived commands like `codegraph build` would hang for
+ * minutes before Node gives up — surfacing in CI as `spawnSync ETIMEDOUT`
+ * even though the command's work is already complete.
+ *
+ * `disposeParsers` is safe to call when the pool was never instantiated
+ * (e.g. native engine, or commands that never parse): it no-ops cleanly.
+ */
+async function shutdown() {
+    try {
+        await disposeParsers();
+    }
+    catch {
+        /* don't mask the real exit status over a teardown failure */
+    }
+}
+run()
+    .then(shutdown)
+    .catch(async (err) => {
+    if (err instanceof CodegraphError) {
+        console.error(`codegraph [${err.code}]: ${err.message}`);
+        if (err.file)
+            console.error(`  file: ${err.file}`);
+    }
+    else {
+        console.error(`codegraph: fatal error — ${toErrorMessage(err)}`);
+    }
+    await shutdown();
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC;AAED,GAAG,EAAE;KACF,IAAI,CAAC,QAAQ,CAAC;KACd,KAAK,CAAC,KAAK,EAAE,GAAY,EAAE,EAAE;IAC5B,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,GAAG,CAAC,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,QAAQ,EAAE,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/db/better-sqlite3.d.ts

@@ -0,0 +1,4 @@
+import type Database from 'better-sqlite3';
+/** Return the `better-sqlite3` Database constructor, loading it on first call. */
+export declare function getDatabase(): typeof Database;
+//# sourceMappingURL=better-sqlite3.d.ts.map

package/dist/db/better-sqlite3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sqlite3.d.ts","sourceRoot":"","sources":["../../src/db/better-sqlite3.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,kFAAkF;AAClF,wBAAgB,WAAW,IAAI,OAAO,QAAQ,CAK7C"}

package/dist/db/better-sqlite3.js

@@ -0,0 +1,19 @@
+/**
+ * Lazy-loaded better-sqlite3 constructor.
+ *
+ * Centralises the `createRequire` + cache pattern so every call site that
+ * needs a JS-side SQLite handle can `import { getDatabase } from '…/db/better-sqlite3.js'`
+ * instead of duplicating the boilerplate.  The native engine path (NativeDatabase /
+ * rusqlite) never touches this module.
+ */
+import { createRequire } from 'node:module';
+const _require = createRequire(import.meta.url);
+let _Database;
+/** Return the `better-sqlite3` Database constructor, loading it on first call. */
+export function getDatabase() {
+    if (!_Database) {
+        _Database = _require('better-sqlite3');
+    }
+    return _Database;
+}
+//# sourceMappingURL=better-sqlite3.js.map

package/dist/db/better-sqlite3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sqlite3.js","sourceRoot":"","sources":["../../src/db/better-sqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,IAAI,SAAsC,CAAC;AAE3C,kFAAkF;AAClF,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,QAAQ,CAAC,gBAAgB,CAAoB,CAAC;IAC5D,CAAC;IACD,OAAO,SAAU,CAAC;AACpB,CAAC"}

package/dist/db/connection.d.ts

@@ -0,0 +1,82 @@
+import type { BetterSqlite3Database, NativeDatabase } from '../types.js';
+import { Repository } from './repository/base.js';
+/** DB instance with optional advisory lock path. */
+export type LockedDatabase = BetterSqlite3Database & {
+    __lockPath?: string;
+};
+/**
+ * Return the git worktree/repo root for the given directory (or cwd).
+ * Uses `git rev-parse --show-toplevel` which returns the correct root
+ * for both regular repos and git worktrees.
+ * Results are cached per-process when called without arguments.
+ * The cache is keyed on cwd so it invalidates if the working directory changes
+ * (e.g. MCP server serving multiple sessions).
+ */
+export declare function findRepoRoot(fromDir?: string): string | null;
+/** Reset the cached repo root (for testing). */
+export declare function _resetRepoRootCache(): void;
+export declare function acquireAdvisoryLock(dbPath: string): void;
+export declare function releaseAdvisoryLock(lockPath: string): void;
+export declare function openDb(dbPath: string): LockedDatabase;
+export declare function closeDb(db: LockedDatabase): void;
+/**
+ * Synchronously close any DB handles queued by `closeDbDeferred()`.
+ * Call before deleting DB files or in test teardown to avoid EBUSY on Windows.
+ */
+export declare function flushDeferredClose(): void;
+/**
+ * Schedule DB close on the next event loop tick. Useful for incremental
+ * builds where the WAL checkpoint in db.close() is expensive (~250ms on
+ * Windows) and doesn't need to block the caller.
+ *
+ * The advisory lock is released immediately so subsequent opens succeed.
+ * The actual handle close (+ WAL checkpoint) happens asynchronously.
+ * Call `flushDeferredClose()` before deleting the DB file.
+ */
+export declare function closeDbDeferred(db: LockedDatabase): void;
+/** A better-sqlite3 handle optionally paired with a NativeDatabase. */
+export interface LockedDatabasePair {
+    db: LockedDatabase;
+    nativeDb?: NativeDatabase;
+}
+/** Close both handles: NativeDatabase first (fast), then better-sqlite3 (releases lock). */
+export declare function closeDbPair(pair: LockedDatabasePair): void;
+/** Close NativeDatabase immediately, defer better-sqlite3 WAL checkpoint. */
+export declare function closeDbPairDeferred(pair: LockedDatabasePair): void;
+export declare function findDbPath(customPath?: string): string;
+/** Open a database in readonly mode, with a user-friendly error if the DB doesn't exist. */
+export declare function openReadonlyOrFail(customPath?: string): BetterSqlite3Database;
+/**
+ * Open a Repository from either an injected instance or a DB path.
+ *
+ * When `opts.repo` is a Repository instance, returns it directly (no DB opened).
+ * When the native engine is available, opens a NativeDatabase (rusqlite) and
+ * wraps it in NativeRepository. Otherwise falls back to better-sqlite3 via
+ * SqliteRepository.
+ */
+export declare function openRepo(customDbPath?: string, opts?: {
+    repo?: Repository;
+    engine?: 'native' | 'wasm' | 'auto';
+}): {
+    repo: Repository;
+    close(): void;
+};
+/**
+ * Open a readonly DB with an optional NativeDatabase alongside it.
+ *
+ * Returns the better-sqlite3 handle (for backwards compat) plus an optional
+ * NativeDatabase for modules that can use batched Rust query methods.
+ * Callers should use nativeDb when available and fall back to db.prepare().
+ *
+ * @param opts.engine - Per-call engine override: 'native' | 'wasm' | 'auto'.
+ *   When omitted, falls back to config.build.engine then 'auto', mirroring
+ *   the priority chain used by openRepo().
+ */
+export declare function openReadonlyWithNative(customPath?: string, opts?: {
+    engine?: 'native' | 'wasm' | 'auto';
+}): {
+    db: BetterSqlite3Database;
+    nativeDb: NativeDatabase | undefined;
+    close(): void;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAwClD,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAK7E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B5D;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAYD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkBxD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS1D;AAmBD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAYrD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAGhD;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAmBxD;AAOD,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,cAAc,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAS1D;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CASlE;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CA+CtD;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAoB7E;AA6BD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;CAAO,GACpE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CA4CrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;CAAO,GACjD;IACD,EAAE,EAAE,qBAAqB,CAAC;IAC1B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf,CAyCA"}

package/dist/db/connection.js

@@ -0,0 +1,444 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadConfig } from '../infrastructure/config.js';
+import { debug, warn } from '../infrastructure/logger.js';
+import { getNative, isNativeAvailable } from '../infrastructure/native.js';
+import { DbError, toErrorMessage } from '../shared/errors.js';
+import { getDatabase } from './better-sqlite3.js';
+import { Repository } from './repository/base.js';
+import { NativeRepository } from './repository/native-repository.js';
+import { SqliteRepository } from './repository/sqlite-repository.js';
+/** Lazy-loaded package version (read once from package.json). */
+let _packageVersion;
+function getPackageVersion() {
+    if (_packageVersion !== undefined)
+        return _packageVersion;
+    try {
+        const connDir = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.join(connDir, '..', '..', 'package.json');
+        _packageVersion = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'))
+            .version;
+    }
+    catch (e) {
+        debug(`Failed to read package version: ${toErrorMessage(e)}`);
+        _packageVersion = '';
+    }
+    return _packageVersion;
+}
+/** Warn once per process when DB version mismatches the running codegraph version. */
+let _versionWarned = false;
+/** Check and warn (once) if the running codegraph version differs from the DB build version. */
+function warnOnVersionMismatch(getBuildVersion) {
+    if (_versionWarned)
+        return;
+    _versionWarned = true;
+    try {
+        const buildVersion = getBuildVersion();
+        const currentVersion = getPackageVersion();
+        if (buildVersion && currentVersion && buildVersion !== currentVersion) {
+            warn(`DB was built with codegraph v${buildVersion}, running v${currentVersion}. Consider: codegraph build --no-incremental`);
+        }
+    }
+    catch (e) {
+        debug(`Version mismatch check skipped (build_meta may not exist): ${toErrorMessage(e)}`);
+    }
+}
+let _cachedRepoRoot; // undefined = not computed, null = not a git repo
+let _cachedRepoRootCwd; // cwd at the time the cache was populated
+/**
+ * Return the git worktree/repo root for the given directory (or cwd).
+ * Uses `git rev-parse --show-toplevel` which returns the correct root
+ * for both regular repos and git worktrees.
+ * Results are cached per-process when called without arguments.
+ * The cache is keyed on cwd so it invalidates if the working directory changes
+ * (e.g. MCP server serving multiple sessions).
+ */
+export function findRepoRoot(fromDir) {
+    const dir = fromDir || process.cwd();
+    if (!fromDir && _cachedRepoRoot !== undefined && _cachedRepoRootCwd === dir) {
+        return _cachedRepoRoot;
+    }
+    let root = null;
+    try {
+        const raw = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd: dir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Use realpathSync to resolve symlinks (macOS /var → /private/var) and
+        // 8.3 short names (Windows RUNNER~1 → runneradmin) so the ceiling path
+        // matches the realpathSync'd dir in findDbPath.
+        try {
+            root = fs.realpathSync(raw);
+        }
+        catch (e) {
+            debug(`realpathSync failed for git root "${raw}", using resolve: ${toErrorMessage(e)}`);
+            root = path.resolve(raw);
+        }
+    }
+    catch (e) {
+        debug(`git rev-parse failed for "${dir}": ${toErrorMessage(e)}`);
+        root = null;
+    }
+    if (!fromDir) {
+        _cachedRepoRoot = root;
+        _cachedRepoRootCwd = dir;
+    }
+    return root;
+}
+/** Reset the cached repo root (for testing). */
+export function _resetRepoRootCache() {
+    _cachedRepoRoot = undefined;
+    _cachedRepoRootCwd = undefined;
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        debug(`PID ${pid} not alive: ${e.code || toErrorMessage(e)}`);
+        return false;
+    }
+}
+export function acquireAdvisoryLock(dbPath) {
+    const lockPath = `${dbPath}.lock`;
+    try {
+        if (fs.existsSync(lockPath)) {
+            const content = fs.readFileSync(lockPath, 'utf-8').trim();
+            const pid = Number(content);
+            if (pid && pid !== process.pid && isProcessAlive(pid)) {
+                warn(`Another process (PID ${pid}) may be using this database. Proceeding with caution.`);
+            }
+        }
+    }
+    catch (e) {
+        debug(`Advisory lock read failed: ${toErrorMessage(e)}`);
+    }
+    try {
+        fs.writeFileSync(lockPath, String(process.pid), 'utf-8');
+    }
+    catch (e) {
+        debug(`Advisory lock write failed: ${toErrorMessage(e)}`);
+    }
+}
+export function releaseAdvisoryLock(lockPath) {
+    try {
+        const content = fs.readFileSync(lockPath, 'utf-8').trim();
+        if (Number(content) === process.pid) {
+            fs.unlinkSync(lockPath);
+        }
+    }
+    catch (e) {
+        debug(`Advisory lock release failed for ${lockPath}: ${toErrorMessage(e)}`);
+    }
+}
+/**
+ * Check if two paths refer to the same directory.
+ * Handles Windows 8.3 short names (RUNNER~1 vs runneradmin) and macOS
+ * symlinks (/tmp vs /private/tmp) where string comparison fails.
+ */
+function isSameDirectory(a, b) {
+    if (path.resolve(a) === path.resolve(b))
+        return true;
+    try {
+        const sa = fs.statSync(a);
+        const sb = fs.statSync(b);
+        return sa.dev === sb.dev && sa.ino === sb.ino;
+    }
+    catch (e) {
+        debug(`isSameDirectory stat failed: ${toErrorMessage(e)}`);
+        return false;
+    }
+}
+export function openDb(dbPath) {
+    // Flush any deferred DB close from a previous build (avoids WAL contention)
+    flushDeferredClose();
+    const dir = path.dirname(dbPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    acquireAdvisoryLock(dbPath);
+    const Database = getDatabase();
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    db.__lockPath = `${dbPath}.lock`;
+    return db;
+}
+export function closeDb(db) {
+    db.close();
+    if (db.__lockPath)
+        releaseAdvisoryLock(db.__lockPath);
+}
+/** Pending deferred-close DB handles (not yet closed). */
+const _deferredDbs = [];
+/**
+ * Synchronously close any DB handles queued by `closeDbDeferred()`.
+ * Call before deleting DB files or in test teardown to avoid EBUSY on Windows.
+ */
+export function flushDeferredClose() {
+    while (_deferredDbs.length > 0) {
+        const db = _deferredDbs.pop();
+        try {
+            db.close();
+        }
+        catch (e) {
+            debug(`Deferred DB close failed (handle may already be closed): ${toErrorMessage(e)}`);
+        }
+    }
+}
+/**
+ * Schedule DB close on the next event loop tick. Useful for incremental
+ * builds where the WAL checkpoint in db.close() is expensive (~250ms on
+ * Windows) and doesn't need to block the caller.
+ *
+ * The advisory lock is released immediately so subsequent opens succeed.
+ * The actual handle close (+ WAL checkpoint) happens asynchronously.
+ * Call `flushDeferredClose()` before deleting the DB file.
+ */
+export function closeDbDeferred(db) {
+    // Release the advisory lock immediately so the next open can proceed
+    if (db.__lockPath) {
+        releaseAdvisoryLock(db.__lockPath);
+        db.__lockPath = undefined;
+    }
+    _deferredDbs.push(db);
+    // Defer the expensive WAL checkpoint to after the caller returns
+    setImmediate(() => {
+        const idx = _deferredDbs.indexOf(db);
+        if (idx !== -1) {
+            _deferredDbs.splice(idx, 1);
+            try {
+                db.close();
+            }
+            catch (e) {
+                debug(`Deferred DB close failed (may already be closed by flush): ${toErrorMessage(e)}`);
+            }
+        }
+    });
+}
+/** Close both handles: NativeDatabase first (fast), then better-sqlite3 (releases lock). */
+export function closeDbPair(pair) {
+    if (pair.nativeDb) {
+        try {
+            pair.nativeDb.close();
+        }
+        catch (e) {
+            debug(`closeDbPair: native close failed: ${toErrorMessage(e)}`);
+        }
+    }
+    closeDb(pair.db);
+}
+/** Close NativeDatabase immediately, defer better-sqlite3 WAL checkpoint. */
+export function closeDbPairDeferred(pair) {
+    if (pair.nativeDb) {
+        try {
+            pair.nativeDb.close();
+        }
+        catch (e) {
+            debug(`closeDbPairDeferred: native close failed: ${toErrorMessage(e)}`);
+        }
+    }
+    closeDbDeferred(pair.db);
+}
+export function findDbPath(customPath) {
+    if (customPath)
+        return path.resolve(customPath);
+    const rawCeiling = findRepoRoot();
+    // Normalize ceiling with realpathSync to resolve 8.3 short names (Windows
+    // RUNNER~1 → runneradmin) and symlinks (macOS /var → /private/var).
+    // findRepoRoot already applies realpathSync internally, but the git output
+    // may still contain short names on some Windows CI environments.
+    let ceiling;
+    if (rawCeiling) {
+        try {
+            ceiling = fs.realpathSync(rawCeiling);
+        }
+        catch (e) {
+            debug(`realpathSync failed for ceiling "${rawCeiling}": ${toErrorMessage(e)}`);
+            ceiling = rawCeiling;
+        }
+    }
+    else {
+        ceiling = null;
+    }
+    // Resolve symlinks (e.g. macOS /var → /private/var) so dir matches ceiling from git
+    let dir;
+    try {
+        dir = fs.realpathSync(process.cwd());
+    }
+    catch (e) {
+        debug(`realpathSync failed for cwd: ${toErrorMessage(e)}`);
+        dir = process.cwd();
+    }
+    while (true) {
+        const candidate = path.join(dir, '.codegraph', 'graph.db');
+        if (fs.existsSync(candidate))
+            return candidate;
+        if (ceiling && isSameDirectory(dir, ceiling)) {
+            debug(`findDbPath: stopped at git ceiling ${ceiling}`);
+            break;
+        }
+        // Outside a git repo, cwd is the first (and only) directory we'll check.
+        // Walking past it risks attaching to a stale .codegraph/ in an unrelated
+        // parent — e.g. /private/tmp/.codegraph/ leaking into every /tmp/foo/ run,
+        // or $HOME/.codegraph/ leaking into every scratch dir under $HOME.
+        if (!ceiling) {
+            debug(`findDbPath: no git ceiling, stopping at ${dir}`);
+            break;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    const base = ceiling || process.cwd();
+    return path.join(base, '.codegraph', 'graph.db');
+}
+/** Open a database in readonly mode, with a user-friendly error if the DB doesn't exist. */
+export function openReadonlyOrFail(customPath) {
+    const dbPath = findDbPath(customPath);
+    if (!fs.existsSync(dbPath)) {
+        throw new DbError(`No codegraph database found at ${dbPath}.\nRun "codegraph build" first to analyze your codebase.`, { file: dbPath });
+    }
+    const Database = getDatabase();
+    const db = new Database(dbPath, { readonly: true });
+    db.pragma('busy_timeout = 5000');
+    warnOnVersionMismatch(() => {
+        const row = db
+            .prepare('SELECT value FROM build_meta WHERE key = ?')
+            .get('codegraph_version');
+        return row?.value;
+    });
+    return db;
+}
+/** Open a NativeRepository via rusqlite, throwing DbError if the DB file is missing. */
+function openRepoNative(customDbPath) {
+    const dbPath = findDbPath(customDbPath);
+    if (!fs.existsSync(dbPath)) {
+        throw new DbError(`No codegraph database found at ${dbPath}.\nRun "codegraph build" first to analyze your codebase.`, { file: dbPath });
+    }
+    const native = getNative();
+    const ndb = native.NativeDatabase.openReadonly(dbPath);
+    try {
+        warnOnVersionMismatch(() => ndb.getBuildMeta('codegraph_version'));
+        const repo = new NativeRepository(ndb, dbPath);
+        return {
+            repo,
+            close() {
+                repo.closeFallback();
+                ndb.close();
+            },
+        };
+    }
+    catch (innerErr) {
+        ndb.close();
+        throw innerErr;
+    }
+}
+/**
+ * Open a Repository from either an injected instance or a DB path.
+ *
+ * When `opts.repo` is a Repository instance, returns it directly (no DB opened).
+ * When the native engine is available, opens a NativeDatabase (rusqlite) and
+ * wraps it in NativeRepository. Otherwise falls back to better-sqlite3 via
+ * SqliteRepository.
+ */
+export function openRepo(customDbPath, opts = {}) {
+    if (opts.repo != null) {
+        if (!(opts.repo instanceof Repository)) {
+            throw new TypeError(`openRepo: opts.repo must be a Repository instance, got ${Object.prototype.toString.call(opts.repo)}`);
+        }
+        return { repo: opts.repo, close() { } };
+    }
+    // Derive rootDir from customDbPath so loadConfig reads the right project config.
+    // Convention: customDbPath = <rootDir>/.codegraph/graph.db
+    const rootDir = customDbPath ? path.dirname(path.dirname(path.resolve(customDbPath))) : undefined;
+    // Respect explicit engine selection: opts.engine > config.build.engine > auto.
+    // config.build.engine is already populated from CODEGRAPH_ENGINE env by applyEnvOverrides,
+    // so this covers both the env-var path and the .codegraphrc.json config-file path.
+    // This ensures --engine wasm and benchmark workers bypass the native path.
+    const engine = opts.engine ?? loadConfig(rootDir).build.engine ?? 'auto';
+    // Try native rusqlite path first (Phase 6.14)
+    if (engine !== 'wasm' && isNativeAvailable()) {
+        try {
+            return openRepoNative(customDbPath);
+        }
+        catch (e) {
+            // Re-throw user-visible errors (e.g. DB not found) — only silently
+            // fall back for native-engine failures (e.g. incompatible native binary).
+            if (e instanceof DbError)
+                throw e;
+            // Re-throw locking/busy errors — falling back to better-sqlite3 would
+            // hit the same contention (and potentially hang without busy_timeout).
+            const msg = toErrorMessage(e);
+            if (/\b(busy|locked|SQLITE_BUSY|SQLITE_LOCKED)\b/i.test(msg)) {
+                throw new DbError(`Database is busy (another process may be writing): ${msg}`, {});
+            }
+            debug(`openRepo: native path failed, falling back to better-sqlite3: ${msg}`);
+        }
+    }
+    const db = openReadonlyOrFail(customDbPath);
+    return {
+        repo: new SqliteRepository(db),
+        close() {
+            db.close();
+        },
+    };
+}
+/**
+ * Open a readonly DB with an optional NativeDatabase alongside it.
+ *
+ * Returns the better-sqlite3 handle (for backwards compat) plus an optional
+ * NativeDatabase for modules that can use batched Rust query methods.
+ * Callers should use nativeDb when available and fall back to db.prepare().
+ *
+ * @param opts.engine - Per-call engine override: 'native' | 'wasm' | 'auto'.
+ *   When omitted, falls back to config.build.engine then 'auto', mirroring
+ *   the priority chain used by openRepo().
+ */
+export function openReadonlyWithNative(customPath, opts = {}) {
+    const db = openReadonlyOrFail(customPath);
+    // Derive rootDir from customPath so loadConfig reads the right project config,
+    // consistent with openRepo(). Convention: customPath = <rootDir>/.codegraph/graph.db
+    const rootDir = customPath ? path.dirname(path.dirname(path.resolve(customPath))) : undefined;
+    // Respect explicit engine selection: opts.engine > config.build.engine > auto.
+    // config.build.engine covers both CODEGRAPH_ENGINE env (via applyEnvOverrides)
+    // and the .codegraphrc.json config-file path. Mirrors openRepo() priority chain.
+    const engine = opts.engine ?? loadConfig(rootDir).build.engine ?? 'auto';
+    let nativeDb;
+    if (engine !== 'wasm' && isNativeAvailable()) {
+        try {
+            const dbPath = findDbPath(customPath);
+            const native = getNative();
+            nativeDb = native.NativeDatabase.openReadonly(dbPath);
+        }
+        catch (e) {
+            const msg = toErrorMessage(e);
+            if (/\b(busy|locked|SQLITE_BUSY|SQLITE_LOCKED)\b/i.test(msg)) {
+                debug(`openReadonlyWithNative: native path busy, skipping native DB: ${msg}`);
+            }
+            else {
+                debug(`openReadonlyWithNative: native path failed: ${msg}`);
+            }
+        }
+    }
+    return {
+        db,
+        nativeDb,
+        close() {
+            db.close();
+            if (nativeDb) {
+                try {
+                    nativeDb.close();
+                }
+                catch (e) {
+                    debug(`openReadonlyWithNative: native close failed: ${toErrorMessage(e)}`);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

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

package/dist/db/index.d.ts

@@ -0,0 +1,6 @@
+export type { LockedDatabase, LockedDatabasePair } from './connection.js';
+export { acquireAdvisoryLock, closeDb, closeDbDeferred, closeDbPair, closeDbPairDeferred, findDbPath, findRepoRoot, flushDeferredClose, openDb, openReadonlyOrFail, openReadonlyWithNative, openRepo, releaseAdvisoryLock, } from './connection.js';
+export { getBuildMeta, initSchema, MIGRATIONS, setBuildMeta } from './migrations.js';
+export { fanInJoinSQL, fanOutJoinSQL, kindInClause, NodeQuery, testFilterSQL, } from './query-builder.js';
+export { bulkNodeIdsByFile, countCrossFileCallers, countEdges, countFiles, countNodes, deleteCfgForNode, findAllIncomingEdges, findAllOutgoingEdges, findCalleeNames, findCallees, findCallerNames, findCallers, findCrossFileCallTargets, findDistinctCallers, findFileNodes, findImplementors, findImportDependents, findImportSources, findImportTargets, findInterfaces, findIntraFileCallEdges, findNodeById, findNodeByQualifiedName, findNodeChildren, findNodesByFile, findNodesByScope, findNodesForTriage, findNodesWithFanIn, getCallableNodes, getCallEdges, getCfgBlocks, getCfgEdges, getClassHierarchy, getCoChangeMeta, getComplexityForNode, getEmbeddingCount, getEmbeddingMeta, getFileNodesAll, getFunctionNodeId, getImportEdges, getLineCountForNode, getMaxEndLineForFile, getNodeId, hasCfgTables, hasCoChanges, hasDataflowTable, hasDataflowVertices, hasEmbeddings, InMemoryRepository, iterateFunctionNodes, listFunctionNodes, purgeFileData, purgeFilesData, Repository, SqliteRepository, upsertCoChangeMeta, } from './repository/index.js';
+//# sourceMappingURL=index.d.ts.map