@optave/codegraph 3.10.0 → 3.11.1

package/dist/domain/graph/builder/stages/native-db-lifecycle.js

@@ -0,0 +1,77 @@
+/**
+ * NativeDatabase connection lifecycle helpers.
+ *
+ * The Rust orchestrator and the JS pipeline stages both juggle the same
+ * `nativeDb` handle (rusqlite) alongside `ctx.db` (better-sqlite3). These
+ * helpers centralise the open/close/reopen sequence so both call sites
+ * preserve the same WAL-safety invariants:
+ *
+ *   - Always checkpoint WAL before closing rusqlite — otherwise better-sqlite3's
+ *     internal WAL index can drift and surface as SQLITE_CORRUPT on the next
+ *     read (#715, #736).
+ *   - Always reopen better-sqlite3 after rusqlite writes to drop the stale
+ *     page cache.
+ *
+ * Lives in its own module so `tryNativeOrchestrator` (in `native-orchestrator.ts`)
+ * and the JS pipeline stages driver (in `pipeline.ts`) can share the helpers
+ * without either file importing the other.
+ */
+import { openDb } from '../../../../db/index.js';
+import { debug } from '../../../../infrastructure/logger.js';
+import { loadNative } from '../../../../infrastructure/native.js';
+import { toErrorMessage } from '../../../../shared/errors.js';
+/** Checkpoint WAL through rusqlite and close the native connection. */
+export function closeNativeDb(ctx, label) {
+    if (!ctx.nativeDb)
+        return;
+    try {
+        ctx.nativeDb.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+    }
+    catch (e) {
+        debug(`${label} WAL checkpoint failed: ${toErrorMessage(e)}`);
+    }
+    try {
+        ctx.nativeDb.close();
+    }
+    catch (e) {
+        debug(`${label} nativeDb close failed: ${toErrorMessage(e)}`);
+    }
+    ctx.nativeDb = undefined;
+}
+/** Try to reopen the native connection for a given pipeline phase. */
+export function reopenNativeDb(ctx, label) {
+    if ((ctx.opts.engine ?? 'auto') === 'wasm')
+        return;
+    const native = loadNative();
+    if (!native?.NativeDatabase)
+        return;
+    try {
+        ctx.nativeDb = native.NativeDatabase.openReadWrite(ctx.dbPath);
+    }
+    catch (e) {
+        debug(`reopen nativeDb for ${label} failed: ${toErrorMessage(e)}`);
+        ctx.nativeDb = undefined;
+    }
+}
+/** Close nativeDb and clear stale references in engineOpts. */
+export function suspendNativeDb(ctx, label) {
+    closeNativeDb(ctx, label);
+    if (ctx.engineOpts?.nativeDb) {
+        ctx.engineOpts.nativeDb = undefined;
+    }
+}
+/**
+ * After native writes, reopen the JS db connection to get a fresh page cache.
+ * Rusqlite WAL truncation invalidates better-sqlite3's internal WAL index,
+ * causing SQLITE_CORRUPT on the next read (#715, #736).
+ */
+export function refreshJsDb(ctx) {
+    try {
+        ctx.db.close();
+    }
+    catch (e) {
+        debug(`refreshJsDb close failed: ${toErrorMessage(e)}`);
+    }
+    ctx.db = openDb(ctx.dbPath);
+}
+//# sourceMappingURL=native-db-lifecycle.js.map

package/dist/domain/graph/builder/stages/native-db-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-db-lifecycle.js","sourceRoot":"","sources":["../../../../../src/domain/graph/builder/stages/native-db-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,GAAoB,EAAE,KAAa;IAC/D,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO;IAC1B,IAAI,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,KAAK,2BAA2B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,KAAK,2BAA2B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAoB,EAAE,KAAa;IAChE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,MAAM;QAAE,OAAO;IACnD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,cAAc;QAAE,OAAO;IACpC,IAAI,CAAC;QACH,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,KAAK,CAAC,uBAAuB,KAAK,YAAY,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,GAAoB,EAAE,KAAa;IACjE,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,IAAI,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;QAC7B,GAAG,CAAC,UAAU,CAAC,QAAQ,GAAG,SAAS,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,IAAI,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,KAAK,CAAC,6BAA6B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/domain/graph/builder/stages/native-orchestrator.d.ts

@@ -0,0 +1,62 @@
+import type { BuildResult } from '../../../../types.js';
+import type { PipelineContext } from '../context.js';
+/**
+ * Inputs to {@link computeWasmOnlyStaleFiles}. Sets are passed in so the helper
+ * is pure and unit-testable independently of `getInstalledWasmExtensions` and
+ * the `NATIVE_SUPPORTED_EXTENSIONS` global state.
+ */
+export interface WasmOnlyStaleFilesInput {
+    /** Distinct `file` values from the `nodes` table. */
+    existingNodes: ReadonlySet<string>;
+    /** Distinct `file` values from the `file_hashes` table. */
+    existingHashes: ReadonlySet<string>;
+    /** Relative paths currently on disk (from `collectFilesUtil`). */
+    expected: ReadonlySet<string>;
+    /** Lowercased extensions whose WASM grammar is installed. */
+    installedExts: ReadonlySet<string>;
+    /** Extensions covered by the Rust addon — Rust owns deletion for these. */
+    nativeSupported: ReadonlySet<string>;
+}
+/**
+ * Compute the WASM-only files present in the DB but missing from disk (#1073).
+ *
+ * Returns relative paths that:
+ *   - appear in `existingNodes` or `existingHashes` (in DB),
+ *   - are absent from `expected` (not on disk),
+ *   - have an extension installed for WASM, AND
+ *   - have an extension NOT covered by `nativeSupported` — Rust's
+ *     `purge_changed_files` handles deletion for natively-supported extensions
+ *     via its own `detect_removed_files`, so the caller must not double-purge.
+ *
+ * Extensions are lowercased before lookup to match the registry and Rust's
+ * `LanguageKind::from_extension` (which normalises case for the languages
+ * where both cases are conventional, e.g. R's `.r` / `.R`).
+ *
+ * DB paths are forced to forward slashes before comparison with `expected`
+ * (which is always normalised). The on-disk invariant is that DB rows are
+ * written with forward slashes, but a stale row written by older code on
+ * Windows could carry back-slashes — normalising here makes the comparison
+ * platform-safe and prevents false-positive purges of live rows. We replace
+ * `\\` explicitly (rather than calling `normalizePath`, which only touches
+ * `path.sep`) so the defence works when running on POSIX against a DB that
+ * was migrated from Windows.
+ *
+ * Exported for unit testing.
+ */
+export declare function computeWasmOnlyStaleFiles(input: WasmOnlyStaleFilesInput): string[];
+/**
+ * Try the native build orchestrator.
+ *
+ * Returns:
+ *   - `BuildResult` on success (caller should return it directly).
+ *   - `'early-exit'` when the orchestrator detected no changes (caller should return undefined).
+ *   - `undefined` when native is unavailable or skipped (caller should fall through to the JS pipeline).
+ *
+ * Encapsulates the orchestrator-selection strategy: open `NativeDatabase`,
+ * invoke `nativeDb.buildGraph()` (the Rust pipeline), and run post-native
+ * structure + analysis fallbacks. Lives in its own file to keep the Rust
+ * orchestrator entry point separated from the JS-side `buildGraph()` driver
+ * in `pipeline.ts`.
+ */
+export declare function tryNativeOrchestrator(ctx: PipelineContext): Promise<BuildResult | undefined | 'early-exit'>;
+//# sourceMappingURL=native-orchestrator.d.ts.map

package/dist/domain/graph/builder/stages/native-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-orchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/domain/graph/builder/stages/native-orchestrator.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA2CrD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,2DAA2D;IAC3D,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,kEAAkE;IAClE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,6DAA6D;IAC7D,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,2EAA2E;IAC3E,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAoTD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAsBlF;AA4RD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC,CAuLjD"}