@lzehrung/codegraph 2.3.10 → 2.3.12

package/codegraph-skill/codegraph/SKILL.md

@@ -255,7 +255,7 @@ Lifecycle commands accept either one positional project path or `--root <path>`,
 
 ## Installation
 
-For normal CLI and MCP use, install from public npm with Node.js 22.16 or newer:
+For normal CLI and MCP use, install from public npm with Node.js 22.16 or newer. Disk cache uses Node's standard-library `node:sqlite` module; builds below 22.16 may load it without the statement APIs Codegraph needs and then disable disk cache after one warning.
 
 ```bash
 npm install -g @lzehrung/codegraph

package/dist/bin/cli.js

@@ -13556,6 +13556,7 @@ __export(git_exports, {
   listChangedFiles: () => listChangedFiles,
   listGitExcludeFiles: () => listGitExcludeFiles,
   listGitIgnoreFiles: () => listGitIgnoreFiles,
+  listGitStageSpecialPaths: () => listGitStageSpecialPaths,
   listGitSubmoduleDirectories: () => listGitSubmoduleDirectories,
   listTrackedFiles: () => listTrackedFiles,
   listUntrackedFiles: () => listUntrackedFiles,
@@ -13994,7 +13995,7 @@ async function listTrackedFiles(projectRoot, opts) {
 async function listGitIgnoreFiles(projectRoot, opts) {
   if (!(opts?.gitAvailable ?? true))
     return [];
-  const pathspec = [".gitignore", ":(glob)**/.gitignore"];
+  const pathspec = [".gitignore", ":(glob)**/.gitignore", ...opts?.excludePathspecs ?? []];
   const commands = [
     ["ls-files", "--cached", "-z", "--", ...pathspec],
     ["ls-files", "--others", "--exclude-standard", "-z", "--", ...pathspec],
@@ -14017,31 +14018,49 @@ async function listGitIgnoreFiles(projectRoot, opts) {
   }
   return Array.from(new Set(out));
 }
-async function listGitSubmoduleDirectories(projectRoot, opts) {
+function parseGitStageSpecialPaths(projectRoot, stdout) {
+  const gitlinks = [];
+  const symlinks = [];
+  for (const record2 of stdout.split("\0").filter(Boolean)) {
+    const tabIndex = record2.indexOf("	");
+    if (tabIndex < 0)
+      continue;
+    const rel = record2.slice(tabIndex + 1);
+    if (!rel)
+      continue;
+    const abs = normalizePath(path8.resolve(projectRoot, rel));
+    if (record2.startsWith("160000 "))
+      gitlinks.push(abs);
+    else if (record2.startsWith("120000 "))
+      symlinks.push(abs);
+  }
+  return { gitlinks, symlinks };
+}
+async function listGitStageSpecialPaths(projectRoot, opts) {
   if (!(opts?.gitAvailable ?? true))
-    return [];
+    return { gitlinks: [], symlinks: [] };
   const args = ["ls-files", "--stage", "-z"];
   try {
     const { stdout } = await runGit(projectRoot, args, { maxBuffer: 64 * 1024 * 1024 });
-    const direct = [];
-    for (const record2 of stdout.split("\0").filter(Boolean)) {
-      if (!record2.startsWith("160000 "))
-        continue;
-      const tabIndex = record2.indexOf("	");
-      if (tabIndex < 0)
-        continue;
-      const rel = record2.slice(tabIndex + 1);
-      if (rel)
-        direct.push(normalizePath(path8.resolve(projectRoot, rel)));
-    }
-    if (!opts?.recurse || !direct.length)
-      return Array.from(new Set(direct));
-    const nested = await Promise.all(direct.map(async (directory) => await listGitSubmoduleDirectories(directory, opts)));
-    return Array.from(/* @__PURE__ */ new Set([...direct, ...nested.flat()]));
+    const direct = parseGitStageSpecialPaths(projectRoot, stdout);
+    if (!opts?.recurse || !direct.gitlinks.length) {
+      return {
+        gitlinks: Array.from(new Set(direct.gitlinks)),
+        symlinks: Array.from(new Set(direct.symlinks))
+      };
+    }
+    const nested = await Promise.all(direct.gitlinks.map(async (directory) => await listGitStageSpecialPaths(directory, opts)));
+    return {
+      gitlinks: Array.from(/* @__PURE__ */ new Set([...direct.gitlinks, ...nested.flatMap((entry) => entry.gitlinks)])),
+      symlinks: Array.from(/* @__PURE__ */ new Set([...direct.symlinks, ...nested.flatMap((entry) => entry.symlinks)]))
+    };
   } catch (error51) {
     throw createGitError(projectRoot, args, error51);
   }
 }
+async function listGitSubmoduleDirectories(projectRoot, opts) {
+  return (await listGitStageSpecialPaths(projectRoot, opts)).gitlinks;
+}
 async function listGitExcludeFiles(projectRoot, opts) {
   if (!(opts?.gitAvailable ?? true))
     return [];
@@ -14209,13 +14228,49 @@ function isPresent(value) {
 function normalizeGlobPattern(globPattern) {
   return globPattern.trim().replace(/\\/g, "/");
 }
+function defaultIgnoreGitExcludePathspecs(includeGlobs = []) {
+  const activeIgnores = includeGlobs.length ? DEFAULT_PROJECT_FILE_IGNORES.filter((ignoreGlob) => !isIgnoreGlobReopenedByIncludes(ignoreGlob, includeGlobs)) : DEFAULT_PROJECT_FILE_IGNORES;
+  return activeIgnores.map((globPattern) => `:(exclude,glob)${normalizeGlobPattern(globPattern)}`);
+}
+function couldBeDirectorySymlink(filePath) {
+  const basename2 = path9.posix.basename(normalizePath(filePath));
+  if (DIRECTORY_METADATA_BASENAMES.has(basename2.toLowerCase()))
+    return true;
+  const extension = path9.posix.extname(basename2);
+  if (!extension)
+    return true;
+  return DIRECTORY_METADATA_EXTENSIONS.has(extension.toLowerCase());
+}
+function globLiteralPrefix(globPattern) {
+  const prefix = [];
+  let seenLiteral = false;
+  for (const segment of globPattern.split("/")) {
+    if (!segment)
+      continue;
+    if (!seenLiteral && segment === "**")
+      continue;
+    if (segment.includes("*") || segment.includes("?"))
+      break;
+    seenLiteral = true;
+    prefix.push(segment);
+  }
+  return prefix;
+}
+function isSegmentPrefix(prefix, pathSegments) {
+  if (!prefix.length || prefix.length > pathSegments.length)
+    return false;
+  return prefix.every((segment, index) => pathSegments[index] === segment);
+}
 function isIgnoreGlobReopenedByIncludes(ignoreGlob, includeGlobs) {
-  const literalSegments = ignoreGlob.split("/").filter((segment) => segment && !segment.includes("*"));
-  if (!literalSegments.length)
+  const ignoreLiterals = ignoreGlob.split("/").filter((segment) => segment && !segment.includes("*"));
+  if (!ignoreLiterals.length)
     return false;
   return includeGlobs.some((includeGlob) => {
     const includeSegments = includeGlob.split("/");
-    return literalSegments.every((segment) => includeSegments.includes(segment));
+    if (ignoreLiterals.every((segment) => includeSegments.includes(segment)))
+      return true;
+    const includePrefix = globLiteralPrefix(includeGlob);
+    return isSegmentPrefix(includePrefix, ignoreLiterals) || isSegmentPrefix(ignoreLiterals, includePrefix);
   });
 }
 function isLocationIndependentGlob(globPattern) {
@@ -14428,7 +14483,7 @@ function collectCandidateAncestorDirectories(root, files) {
   }
   return directories;
 }
-async function findGitIgnoreSources(sourceRoots) {
+async function findGitIgnoreSources(sourceRoots, excludePathspecs = defaultIgnoreGitExcludePathspecs()) {
   const roots = Array.from(new Map(sourceRoots.map(({ path: sourceRoot, repositoryRoot }) => [
     fileIdentityKey(sourceRoot),
     { path: normalizePath(sourceRoot), repositoryRoot: normalizePath(repositoryRoot) }
@@ -14436,7 +14491,7 @@ async function findGitIgnoreSources(sourceRoots) {
   const sources = [];
   for (const { path: sourceRoot, repositoryRoot } of roots) {
     const [gitignoreFiles, excludeFiles] = await Promise.all([
-      listGitIgnoreFiles(sourceRoot),
+      listGitIgnoreFiles(sourceRoot, { excludePathspecs }),
       listGitExcludeFiles(sourceRoot)
     ]);
     sources.push(...gitignoreFiles.map((file2) => ({
@@ -14452,7 +14507,7 @@ async function findGitIgnoreSources(sourceRoots) {
   }
   return sources;
 }
-async function listGitCandidateFiles(root, logLevel) {
+async function listGitCandidateFiles(root, logLevel, opts) {
   try {
     const realRoot = normalizePath(await fsp5.realpath(root));
     const gitRoot = await isGitRepo(root) ? root : realRoot;
@@ -14463,11 +14518,12 @@ async function listGitCandidateFiles(root, logLevel) {
     const gitRepositoryRoot = await getGitRepositoryRoot(gitRoot);
     if (!gitRepositoryRoot)
       return null;
-    const [tracked, untracked, submoduleDirectories] = await Promise.all([
+    const [tracked, untracked, stageSpecial] = await Promise.all([
       listTrackedFiles(gitRoot, { recurseSubmodules: true, ...logLevel === void 0 ? {} : { logLevel } }),
       listUntrackedFiles(gitRoot, { respectGitignore: true }),
-      listGitSubmoduleDirectories(gitRoot, { recurse: true })
+      listGitStageSpecialPaths(gitRoot, { recurse: true })
     ]);
+    const submoduleDirectories = stageSpecial.gitlinks;
     const submoduleRoots = await Promise.all(submoduleDirectories.map(async (logicalPath) => ({
       logicalPath: normalizePath(logicalPath),
       physicalPath: normalizePath(await fsp5.realpath(logicalPath).catch(() => logicalPath))
@@ -14476,6 +14532,8 @@ async function listGitCandidateFiles(root, logLevel) {
     const rawFiles = Array.from(/* @__PURE__ */ new Set([...tracked, ...untracked, ...submoduleUntracked.flat()])).sort();
     const needsLogicalRemap = normalizePath(gitRoot) !== normalizePath(root);
     const files = Array.from(new Set(rawFiles.map((file2) => needsLogicalRemap && isFilePathWithinRoot(realRoot, file2) ? normalizePath(path9.resolve(root, path9.relative(realRoot, file2))) : normalizePath(file2)))).sort();
+    const remapGitPath = (file2) => needsLogicalRemap && isFilePathWithinRoot(realRoot, file2) ? normalizePath(path9.resolve(root, path9.relative(realRoot, file2))) : normalizePath(file2);
+    const symlinkCandidatePaths = Array.from(/* @__PURE__ */ new Set([...stageSpecial.symlinks.map(remapGitPath), ...files.filter((file2) => couldBeDirectorySymlink(file2))])).sort();
     const gitignoreRoots = [gitRepositoryRoot, ...submoduleRoots.map(({ physicalPath }) => physicalPath)].map(normalizePath);
     const sourceRoots = [
       { path: root, repositoryRoot: gitRepositoryRoot },
@@ -14488,7 +14546,8 @@ async function listGitCandidateFiles(root, logLevel) {
     ];
     return {
       files,
-      gitignoreFiles: await findGitIgnoreSources(sourceRoots),
+      symlinkCandidatePaths,
+      gitignoreFiles: await findGitIgnoreSources(sourceRoots, defaultIgnoreGitExcludePathspecs(opts?.includeGlobs ?? [])),
       gitignoreRoots,
       gitignoreAliases: sourceRoots
     };
@@ -14522,7 +14581,7 @@ async function listProjectFilesInternal(projectRoot, patterns = DEFAULT_PROJECT_
     const useGitignore = options?.useGitignore ?? true;
     const realRoot = await fsp5.realpath(root);
     const attemptedGitCandidates = useGitignore && options?.gitignoreRoot === void 0 && normalizePath(realRoot) === normalizePath(root);
-    const gitCandidates = attemptedGitCandidates ? await listGitCandidateFiles(root, options?.logLevel) : null;
+    const gitCandidates = attemptedGitCandidates ? await listGitCandidateFiles(root, options?.logLevel, { includeGlobs }) : null;
     if (attemptedGitCandidates) {
       options?.onGitCandidatesDiscovered?.(gitCandidates);
     }
@@ -14551,7 +14610,7 @@ async function listProjectFilesInternal(projectRoot, patterns = DEFAULT_PROJECT_
     const reportSourcePathChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking source file paths", current, total }) : void 0;
     const symlinkOptions = {
       globRoot,
-      ...gitCandidates ? { candidatePaths: gitCandidates.files } : {},
+      ...gitCandidates ? { candidatePaths: gitCandidates.symlinkCandidatePaths } : {},
       ...options?.knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: options.knownSymlinkDirectories } : {},
       ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {},
       ...reportSourceSymlinkChecks ? { onPathCheckProgress: reportSourceSymlinkChecks } : {}
@@ -14663,7 +14722,9 @@ async function resolveSafeSymlinkDirectories(root, realRoot, ignore, options) {
       const relativePath3 = normalizePath(path9.relative(root, candidatePath));
       if (!isRelativePathInside(relativePath3))
         return false;
-      return !ignoreMatchers.some((matcher) => matcher(relativePath3));
+      if (ignoreMatchers.some((matcher) => matcher(relativePath3)))
+        return false;
+      return true;
     });
     const discovered2 = await verifySafeSymlinkDirectories(root, realRoot, candidatePaths, options.onPathCheckProgress);
     options.onSymlinkDirectoriesDiscovered?.(discovered2, "git-candidates");
@@ -14803,7 +14864,7 @@ async function discoverProjectFilesInternal(projectRoot, options) {
         return normalizePath(realPath) === filePath || !isIgnoredByGitignore(realPath, gitignoreIndex, isDirectory2);
       }).map(({ filePath }) => filePath);
       const symlinkOptions = {
-        candidatePaths: gitCandidates.files,
+        candidatePaths: gitCandidates.symlinkCandidatePaths,
         ...options?.knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: options.knownSymlinkDirectories } : {},
         ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {},
         ...reportMetadataSymlinkChecks ? { onPathCheckProgress: reportMetadataSymlinkChecks } : {}
@@ -14884,7 +14945,7 @@ async function discoverProjectFilesInternal(projectRoot, options) {
     throw new Error(`Failed to discover project files in ${root}: ${stringifyUnknown(error51)}`);
   }
 }
-var import_fast_glob2, import_picomatch, DEFAULT_PROJECT_FILE_IGNORES, DEFAULT_PROJECT_MANIFESTS, DEFAULT_PROJECT_PATTERNS, REALPATH_FILTER_CONCURRENCY, EMPTY_GITIGNORE_INDEX;
+var import_fast_glob2, import_picomatch, DEFAULT_PROJECT_FILE_IGNORES, DEFAULT_PROJECT_MANIFESTS, DEFAULT_PROJECT_PATTERNS, REALPATH_FILTER_CONCURRENCY, DIRECTORY_METADATA_EXTENSIONS, DIRECTORY_METADATA_BASENAMES, EMPTY_GITIGNORE_INDEX;
 var init_projectFiles = __esm({
   "dist/util/projectFiles.js"() {
     "use strict";
@@ -14986,6 +15047,23 @@ var init_projectFiles = __esm({
       ...DEFAULT_PROJECT_MANIFESTS.map((name) => `**/${name}`)
     ];
     REALPATH_FILTER_CONCURRENCY = 64;
+    DIRECTORY_METADATA_EXTENSIONS = /* @__PURE__ */ new Set();
+    DIRECTORY_METADATA_BASENAMES = /* @__PURE__ */ new Set();
+    for (const definition of PROJECT_FILE_DEFINITIONS) {
+      if (definition.kind !== "dir")
+        continue;
+      for (const pattern of definition.patterns) {
+        if (!pattern.includes("*") && !pattern.includes("?")) {
+          DIRECTORY_METADATA_BASENAMES.add(pattern.toLowerCase());
+          continue;
+        }
+        const trimmed = pattern.replaceAll("*", "").replaceAll("?", "");
+        const lastDot = trimmed.lastIndexOf(".");
+        if (lastDot < 0)
+          continue;
+        DIRECTORY_METADATA_EXTENSIONS.add(trimmed.slice(lastDot).toLowerCase());
+      }
+    }
     EMPTY_GITIGNORE_INDEX = {
       hasRules: false,
       repositoryRoots: [],
@@ -31824,6 +31902,48 @@ function isNodeSqliteUnavailableError(error51) {
   const message = errorMessage(error51);
   return /node:sqlite|No such built-in module:\s*node:sqlite|setReturnArrays is not a function|columns is not a function/i.test(message);
 }
+function markNodeSqliteUnavailable(error51) {
+  if (nodeSqliteUnsupportedError)
+    return;
+  nodeSqliteUnsupportedError = error51 instanceof Error ? error51 : new Error(String(error51));
+}
+function nodeSqliteUnavailableError() {
+  return nodeSqliteUnsupportedError ?? sqliteLoadError;
+}
+function requireNodeSqliteStatement(statement) {
+  const candidate = statement;
+  if (typeof candidate.setReturnArrays !== "function") {
+    throw new TypeError("setReturnArrays is not a function");
+  }
+  if (typeof candidate.columns !== "function") {
+    throw new TypeError("columns is not a function");
+  }
+  return candidate;
+}
+function isNodeSqliteUsable() {
+  if (nodeSqliteUnavailableError()) {
+    nodeSqliteUsable = false;
+    return false;
+  }
+  if (nodeSqliteUsable !== void 0)
+    return nodeSqliteUsable;
+  try {
+    const sqlite = loadNodeSqlite();
+    const probe = new sqlite.DatabaseSync(":memory:");
+    try {
+      const statement = requireNodeSqliteStatement(probe.prepare("SELECT 1"));
+      statement.setReturnArrays(false);
+      statement.columns();
+      nodeSqliteUsable = true;
+    } finally {
+      probe.close();
+    }
+  } catch (error51) {
+    markNodeSqliteUnavailable(error51);
+    nodeSqliteUsable = false;
+  }
+  return nodeSqliteUsable;
+}
 function canInstallReadonlyAuthorizer(constants2) {
   return READONLY_AUTHORIZER_CONSTANTS.every((name) => typeof constants2[name] === "number");
 }
@@ -31836,7 +31956,7 @@ function isReadOnlySqliteError(error51) {
   const message = error51.message.toLowerCase();
   return message.includes("not authorized") || message.includes("read-only") || message.includes("readonly") || message.includes("attempt to write");
 }
-var requireNodeModule, sqliteModule, reportedReadonlyAuthorizerDegradation, sqliteLoadError, READONLY_AUTHORIZER_CONSTANTS, isSqliteValueArray, normalizeParams, SqliteStatement, SqliteDatabase;
+var requireNodeModule, sqliteModule, reportedReadonlyAuthorizerDegradation, sqliteLoadError, nodeSqliteUnsupportedError, nodeSqliteUsable, READONLY_AUTHORIZER_CONSTANTS, isSqliteValueArray, normalizeParams, SqliteStatement, SqliteDatabase;
 var init_sqlite_driver = __esm({
   "dist/sqlite-driver.js"() {
     "use strict";
@@ -31900,6 +32020,9 @@ var init_sqlite_driver = __esm({
       db;
       statements = /* @__PURE__ */ new Map();
       constructor(filePath, options) {
+        if (!isNodeSqliteUsable()) {
+          throw nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+        }
         const sqlite = loadNodeSqlite();
         this.db = new sqlite.DatabaseSync(filePath, {
           readOnly: options?.readonly,
@@ -31925,9 +32048,15 @@ var init_sqlite_driver = __esm({
         const cached2 = this.statements.get(sql);
         if (cached2)
           return cached2;
-        const statement = new SqliteStatement(this.db.prepare(sql));
-        this.statements.set(sql, statement);
-        return statement;
+        try {
+          const statement = new SqliteStatement(this.db.prepare(sql));
+          this.statements.set(sql, statement);
+          return statement;
+        } catch (error51) {
+          if (isNodeSqliteUnavailableError(error51))
+            markNodeSqliteUnavailable(error51);
+          throw error51;
+        }
       }
       transaction(fn) {
         return () => {
@@ -32582,10 +32711,16 @@ function clearMemoryCacheForProject(projectRoot) {
   }
 }
 function reportMissingNodeSqlite(logLevel, error51) {
+  markNodeSqliteUnavailable(error51);
   if (warnedMissingNodeSqlite)
     return;
   warnedMissingNodeSqlite = true;
-  logWithLevel(logLevel, "error", "Disk cache requires the Node.js built-in node:sqlite module. Use Node.js >= 22.16, or set --cache off/memory.", error51);
+  const missingStatementApi = /setReturnArrays is not a function|columns is not a function/i.test(errorMessage(error51));
+  let detail = "The built-in node:sqlite module is unavailable (requires Node.js >= 22.16).";
+  if (missingStatementApi) {
+    detail = "The built-in node:sqlite module is missing statement APIs Codegraph needs (requires Node.js >= 22.16).";
+  }
+  logWithLevel(logLevel, "warn", `Warning: Disk cache disabled for this run. ${detail} Pass --cache memory or --cache off to skip this check.`);
 }
 function cacheRelativePath(projectRoot, file2) {
   const root = path37.resolve(projectRoot);
@@ -32605,6 +32740,11 @@ function diskCacheDatabasePath(projectRoot, opts) {
 function diskModuleCacheExists(projectRoot, opts) {
   if ((opts?.cache ?? "off") !== "disk")
     return false;
+  if (!isNodeSqliteUsable()) {
+    const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+    reportMissingNodeSqlite(opts?.logLevel, error51);
+    return false;
+  }
   return fs17.existsSync(diskCacheDatabasePath(projectRoot, opts));
 }
 function createModuleCacheTable(db) {
@@ -32655,6 +32795,11 @@ function getDiskModuleCache(projectRoot, opts) {
   const existing = diskModuleCaches.get(dbPath);
   if (existing)
     return existing;
+  if (!isNodeSqliteUsable()) {
+    const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+    reportMissingNodeSqlite(opts?.logLevel, error51);
+    throw error51;
+  }
   fs17.mkdirSync(path37.dirname(dbPath), { recursive: true });
   let db;
   try {
@@ -32665,26 +32810,37 @@ function getDiskModuleCache(projectRoot, opts) {
     }
     throw error51;
   }
-  db.pragma("journal_mode = WAL");
-  db.pragma("synchronous = NORMAL");
-  ensureModuleCacheSchema(db, projectRoot);
-  db.exec("CREATE TEMP TABLE IF NOT EXISTS live_module_cache_files(file TEXT PRIMARY KEY) WITHOUT ROWID;");
-  const cache = {
-    db,
-    load: db.prepare("SELECT sig, version, payload FROM module_cache WHERE file = ?"),
-    write: db.prepare(`INSERT INTO module_cache (file, sig, version, payload, updated_at)
+  try {
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = NORMAL");
+    ensureModuleCacheSchema(db, projectRoot);
+    db.exec("CREATE TEMP TABLE IF NOT EXISTS live_module_cache_files(file TEXT PRIMARY KEY) WITHOUT ROWID;");
+    const cache = {
+      db,
+      load: db.prepare("SELECT sig, version, payload FROM module_cache WHERE file = ?"),
+      write: db.prepare(`INSERT INTO module_cache (file, sig, version, payload, updated_at)
        VALUES (?, ?, ?, ?, ?)
        ON CONFLICT(file) DO UPDATE SET
          sig = excluded.sig,
          version = excluded.version,
          payload = excluded.payload,
          updated_at = excluded.updated_at`),
-    clearLiveFiles: db.prepare("DELETE FROM live_module_cache_files"),
-    insertLiveFile: db.prepare("INSERT OR IGNORE INTO live_module_cache_files(file) VALUES (?)"),
-    pruneStaleFiles: db.prepare("DELETE FROM module_cache WHERE NOT EXISTS (SELECT 1 FROM live_module_cache_files WHERE file = module_cache.file)")
-  };
-  diskModuleCaches.set(dbPath, cache);
-  return cache;
+      clearLiveFiles: db.prepare("DELETE FROM live_module_cache_files"),
+      insertLiveFile: db.prepare("INSERT OR IGNORE INTO live_module_cache_files(file) VALUES (?)"),
+      pruneStaleFiles: db.prepare("DELETE FROM module_cache WHERE NOT EXISTS (SELECT 1 FROM live_module_cache_files WHERE file = module_cache.file)")
+    };
+    diskModuleCaches.set(dbPath, cache);
+    return cache;
+  } catch (error51) {
+    try {
+      db.close();
+    } catch {
+    }
+    if (isNodeSqliteUnavailableError(error51)) {
+      reportMissingNodeSqlite(opts?.logLevel, error51);
+    }
+    throw error51;
+  }
 }
 function closeDiskCacheDatabase(projectRoot, opts) {
   clearMemoryCacheForProject(projectRoot);
@@ -32705,6 +32861,11 @@ function closeDiskCacheDatabase(projectRoot, opts) {
 function pruneDiskModuleCache(projectRoot, liveFiles, opts) {
   if ((opts?.cache ?? "off") !== "disk")
     return 0;
+  if (!isNodeSqliteUsable()) {
+    const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+    reportMissingNodeSqlite(opts?.logLevel, error51);
+    return 0;
+  }
   if (!diskModuleCacheExists(projectRoot, opts))
     return 0;
   try {
@@ -32722,6 +32883,10 @@ function pruneDiskModuleCache(projectRoot, liveFiles, opts) {
     }
     return deleted;
   } catch (error51) {
+    if (isNodeSqliteUnavailableError(error51)) {
+      reportMissingNodeSqlite(opts?.logLevel, error51);
+      return 0;
+    }
     logWithLevel(opts?.logLevel, "warn", "Warning: Failed to prune module cache:", error51);
     return 0;
   }
@@ -32882,6 +33047,13 @@ function tryLoadFromCache(projectRoot, file2, sig, opts, report, diskCacheAvaila
         cacheReport.misses += 1;
       return null;
     }
+    if (!isNodeSqliteUsable()) {
+      const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+      reportMissingNodeSqlite(opts?.logLevel, error51);
+      if (cacheEnabled && cacheReport)
+        cacheReport.misses += 1;
+      return null;
+    }
     try {
       const cache = getDiskModuleCache(projectRoot, opts);
       const row = cache.load.get(cacheRelativePath(projectRoot, file2));
@@ -32914,6 +33086,11 @@ function writeModulesToCache(projectRoot, writes, opts) {
       lruMapSet(memoryCache, memoryCacheKey(projectRoot, write.file), { version: PARSED_CACHE_VERSION, sig: write.sig, mod: write.mod }, MAX_MEMORY_CACHE_ENTRIES);
     }
   } else if (mode === "disk") {
+    if (!isNodeSqliteUsable()) {
+      const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+      reportMissingNodeSqlite(opts?.logLevel, error51);
+      return;
+    }
     try {
       const cache = getDiskModuleCache(projectRoot, opts);
       const now = Date.now();
@@ -32949,6 +33126,7 @@ var init_module_cache = __esm({
     init_languages();
     init_treeSitterNative();
     init_logging();
+    init_errors();
     init_sqlite_driver();
     init_bloomFilter();
     init_sqliteSchema();
@@ -33183,6 +33361,11 @@ function maintainDuplicateUnitDiskCache(index) {
 function duplicateUnitDiskCache(index) {
   if (index.cacheMode !== "disk" || !index.cacheRootDir)
     return null;
+  if (!isNodeSqliteUsable()) {
+    const error51 = nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+    reportMissingNodeSqlite(void 0, error51);
+    return null;
+  }
   const dbPath = duplicateUnitCacheDatabasePathForRoot(index.cacheRootDir);
   let entry = duplicateUnitDiskDatabases.get(dbPath);
   if (!entry) {

package/dist/bin/rawQueryWorker.js

@@ -4,6 +4,28 @@ const require = __codegraphCreateRequire(import.meta.url);
 
 // dist/sqlite-driver.js
 import { createRequire } from "node:module";
+
+// dist/util/errors.js
+function errorMessage(error) {
+  if (error instanceof Error)
+    return error.message;
+  if (typeof error === "string")
+    return error;
+  if (error === null || error === void 0)
+    return String(error);
+  if (typeof error === "object") {
+    try {
+      const serialized = JSON.stringify(error);
+      if (serialized)
+        return serialized;
+    } catch {
+      return String(error);
+    }
+  }
+  return String(error);
+}
+
+// dist/sqlite-driver.js
 var requireNodeModule = createRequire(import.meta.url);
 var sqliteModule;
 var reportedReadonlyAuthorizerDegradation = false;
@@ -28,6 +50,54 @@ function loadNodeSqlite() {
     throw sqliteLoadError;
   }
 }
+function isNodeSqliteUnavailableError(error) {
+  const message = errorMessage(error);
+  return /node:sqlite|No such built-in module:\s*node:sqlite|setReturnArrays is not a function|columns is not a function/i.test(message);
+}
+var nodeSqliteUnsupportedError;
+function markNodeSqliteUnavailable(error) {
+  if (nodeSqliteUnsupportedError)
+    return;
+  nodeSqliteUnsupportedError = error instanceof Error ? error : new Error(String(error));
+}
+function nodeSqliteUnavailableError() {
+  return nodeSqliteUnsupportedError ?? sqliteLoadError;
+}
+var nodeSqliteUsable;
+function requireNodeSqliteStatement(statement) {
+  const candidate = statement;
+  if (typeof candidate.setReturnArrays !== "function") {
+    throw new TypeError("setReturnArrays is not a function");
+  }
+  if (typeof candidate.columns !== "function") {
+    throw new TypeError("columns is not a function");
+  }
+  return candidate;
+}
+function isNodeSqliteUsable() {
+  if (nodeSqliteUnavailableError()) {
+    nodeSqliteUsable = false;
+    return false;
+  }
+  if (nodeSqliteUsable !== void 0)
+    return nodeSqliteUsable;
+  try {
+    const sqlite = loadNodeSqlite();
+    const probe = new sqlite.DatabaseSync(":memory:");
+    try {
+      const statement = requireNodeSqliteStatement(probe.prepare("SELECT 1"));
+      statement.setReturnArrays(false);
+      statement.columns();
+      nodeSqliteUsable = true;
+    } finally {
+      probe.close();
+    }
+  } catch (error) {
+    markNodeSqliteUnavailable(error);
+    nodeSqliteUsable = false;
+  }
+  return nodeSqliteUsable;
+}
 var READONLY_AUTHORIZER_CONSTANTS = [
   "SQLITE_DENY",
   "SQLITE_FUNCTION",
@@ -91,6 +161,9 @@ var SqliteDatabase = class {
   db;
   statements = /* @__PURE__ */ new Map();
   constructor(filePath, options) {
+    if (!isNodeSqliteUsable()) {
+      throw nodeSqliteUnavailableError() ?? new Error("node:sqlite is unavailable");
+    }
     const sqlite = loadNodeSqlite();
     this.db = new sqlite.DatabaseSync(filePath, {
       readOnly: options?.readonly,
@@ -116,9 +189,15 @@ var SqliteDatabase = class {
     const cached = this.statements.get(sql);
     if (cached)
       return cached;
-    const statement = new SqliteStatement(this.db.prepare(sql));
-    this.statements.set(sql, statement);
-    return statement;
+    try {
+      const statement = new SqliteStatement(this.db.prepare(sql));
+      this.statements.set(sql, statement);
+      return statement;
+    } catch (error) {
+      if (isNodeSqliteUnavailableError(error))
+        markNodeSqliteUnavailable(error);
+      throw error;
+    }
   }
   transaction(fn) {
     return () => {

package/dist/duplicates/unitCache.d.ts.map

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