token-goat 2.9.11 → 2.9.13

package/dist/{token-goat-chunk-LKOYKSID.mjs → token-goat-chunk-U7X6LQD2.mjs}

@@ -1,30 +1,5 @@
 import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
-import {
-  IMPORT_RE,
-  extractAbap,
-  extractAbl,
-  extractAsm,
-  extractBatch,
-  extractCShader,
-  extractCmake,
-  extractCobol,
-  extractErlang,
-  extractFortran,
-  extractGroovy,
-  extractJcl,
-  extractMatlab,
-  extractNatural,
-  extractObjc,
-  extractPascal,
-  extractPerl,
-  extractPli,
-  extractRpg,
-  extractSas,
-  extractSolidity,
-  extractThrift,
-  stripLeadingAttributes
-} from "./token-goat-chunk-2ZUPQYLO.mjs";
 import {
   DEFAULT_QUERY_LIMIT,
   ImageDecodeError,
@@ -53,20 +28,14 @@ import {
   getTrackedFiles,
   indexFileSync,
   isAvailable,
-  isBlobStale,
   isImagePath,
   isIndexEmptyForProject,
-  isOcrEngineAvailable,
   isPrivateIpv4Octets,
   isPrivateIpv6Groups,
-  isTextHeavy,
   isTreeSitterAvailable,
   listSections,
-  loadBlob,
   locatePdfPages,
   mergeNearbyHits,
-  ocrImage,
-  ocrIntegrityFailed,
   parseIpv6Groups,
   parseWhereSpecs,
   pathEqClause,
@@ -84,21 +53,34 @@ import {
   searchSemantic,
   searchSymbolsFts,
   shrinkImage,
-  storeBlob,
   unzipBounded,
   urlPolicyDenialReason,
   walkProject
-} from "./token-goat-chunk-SY7WTZMW.mjs";
+} from "./token-goat-chunk-ZZI3IDQZ.mjs";
+import {
+  capJsonRows,
+  estimateTokens,
+  trimToBudget
+} from "./token-goat-chunk-JOXLE672.mjs";
+import {
+  isOcrEngineAvailable,
+  isTextHeavy,
+  ocrImage,
+  ocrIntegrityFailed
+} from "./token-goat-chunk-YOA4N6WA.mjs";
+import {
+  isBlobStale,
+  loadBlob,
+  storeBlob
+} from "./token-goat-chunk-UM47DRD3.mjs";
 import {
   Database,
   FILENAME_LANGUAGE,
   TREE_SITTER_LANGUAGES,
   basenameImportsExtension,
-  capJsonRows,
   colorStdout,
   detectLanguage,
   detectLanguageOfFile,
-  estimateTokens,
   fileIsAbsent,
   findProject,
   fingerprintContent,
@@ -115,13 +97,38 @@ import {
   savedTokensFromBytes,
   shortFingerprint,
   stripAnsi,
-  trimToBudget,
   unsupportedLanguageName
-} from "./token-goat-chunk-AAEYU2U2.mjs";
+} from "./token-goat-chunk-UMXJN7DI.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
 import {
+  IMPORT_RE,
+  extractAbap,
+  extractAbl,
+  extractAsm,
+  extractBatch,
+  extractCShader,
+  extractCmake,
+  extractCobol,
+  extractErlang,
+  extractFortran,
+  extractGroovy,
+  extractJcl,
+  extractMatlab,
+  extractNatural,
+  extractObjc,
+  extractPascal,
+  extractPerl,
+  extractPli,
+  extractRpg,
+  extractSas,
+  extractSolidity,
+  extractThrift,
+  stripLeadingAttributes
+} from "./token-goat-chunk-B3CTCQTH.mjs";
+import {
+  NOTEBOOK_CELL_LINES_SUFFIX,
   PER_FILE_COUNTERFACTUAL_CEILING,
   UNTRUSTED_FILE_TAG,
   UNTRUSTED_GITHUB_TAG,
@@ -143,8 +150,10 @@ import {
   filtersFilteredToEmptyNotice,
   foldCaseForContainment,
   foldPath,
+  formatSymbolLocation,
   globalDbPath,
   grepFilteredToEmptyNotice,
+  indexedSourceText,
   isAblSource,
   isInsideRoot,
   isMatlabSource,
@@ -154,6 +163,7 @@ import {
   isPerlSource,
   isPrologSource,
   isTestFile,
+  isVirtualIndexedPath,
   normalizePath,
   pushAll,
   redactUrlQuery,
@@ -166,9 +176,10 @@ import {
   stripBom,
   supportRequestLine,
   toDisplayPath,
+  virtualIndexedScopeNote,
   windowsCmdQuoteArg,
   withExtension
-} from "./token-goat-chunk-YCKCFYTM.mjs";
+} from "./token-goat-chunk-QKXBGBQR.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -285,18 +296,101 @@ function formatJsonOutline(outline) {
   }
   return lines.join("\n");
 }
+var MAX_RECURSIVE_NODES = 5e4;
+var MAX_RECURSIVE_DEPTH = 100;
+function collectRecursiveKey(root, keyName, out, budget) {
+  const seen = /* @__PURE__ */ new Set();
+  function walk(val, depth) {
+    if (depth > MAX_RECURSIVE_DEPTH) {
+      budget.exhausted = true;
+      return;
+    }
+    if (val === null || typeof val !== "object") return;
+    if (seen.has(val)) return;
+    seen.add(val);
+    if (budget.nodesLeft <= 0) {
+      budget.exhausted = true;
+      return;
+    }
+    budget.nodesLeft--;
+    if (Array.isArray(val)) {
+      for (let i = 0; i < val.length; i++) {
+        walk(val[i], depth + 1);
+        if (budget.nodesLeft <= 0) {
+          if (i < val.length - 1) budget.exhausted = true;
+          return;
+        }
+      }
+    } else {
+      const obj = val;
+      if (Object.prototype.hasOwnProperty.call(obj, keyName)) {
+        out.push(obj[keyName]);
+      }
+      const keys = Object.keys(obj);
+      for (let i = 0; i < keys.length; i++) {
+        walk(obj[keys[i]], depth + 1);
+        if (budget.nodesLeft <= 0) {
+          if (i < keys.length - 1) budget.exhausted = true;
+          return;
+        }
+      }
+    }
+  }
+  walk(root, 0);
+}
+function getNestedField(obj, fieldPath) {
+  if (obj === null || typeof obj !== "object") return void 0;
+  if (Object.prototype.hasOwnProperty.call(obj, fieldPath)) {
+    return obj[fieldPath];
+  }
+  const parts = fieldPath.split(".");
+  let cur = obj;
+  for (const part of parts) {
+    if (cur === null || typeof cur !== "object") return void 0;
+    if (!Object.prototype.hasOwnProperty.call(cur, part)) return void 0;
+    cur = cur[part];
+  }
+  return cur;
+}
 function parseJsonPath(spec) {
   const ops = [];
   const n = spec.length;
   let i = 0;
   while (i < n) {
+    if (spec[i] === "." && i + 1 < n && spec[i + 1] === ".") {
+      i += 2;
+      let j2 = i;
+      while (j2 < n && spec[j2] !== "." && spec[j2] !== "[") j2++;
+      if (j2 === i) throw new Error(`invalid path spec: expected property name after '..' in '${spec}'`);
+      ops.push({ kind: "recursive_key", name: spec.slice(i, j2) });
+      i = j2;
+      continue;
+    }
     const ch = spec[i];
     if (ch === ".") {
       i++;
       continue;
     }
     if (ch === "[") {
-      const close = spec.indexOf("]", i);
+      let inQuote = null;
+      let close = -1;
+      for (let k = i + 1; k < n; k++) {
+        const c = spec[k];
+        if (inQuote !== null) {
+          if (c === "\\") {
+            k++;
+            continue;
+          }
+          if (c === inQuote) {
+            inQuote = null;
+          }
+        } else if (c === '"' || c === "'") {
+          inQuote = c;
+        } else if (c === "]") {
+          close = k;
+          break;
+        }
+      }
       if (close === -1) throw new Error(`invalid path spec: unterminated '[' in '${spec}'`);
       const inner = spec.slice(i + 1, close);
       if (inner === "*") {
@@ -304,9 +398,34 @@ function parseJsonPath(spec) {
       } else if (/^-?\d+$/.test(inner)) {
         ops.push({ kind: "index", index: Number(inner) });
       } else {
-        const m = /^([^=]+)=(.*)$/.exec(inner);
-        if (!m) throw new Error(`invalid bracket expression '[${inner}]' in path spec: '${spec}' (expected [n], [*], or [field=value])`);
-        ops.push({ kind: "filter", field: m[1].trim(), value: m[2] });
+        let expr = inner.trim();
+        if (expr.startsWith("?(") && expr.endsWith(")")) {
+          expr = expr.slice(2, -1).trim();
+        }
+        if (expr.startsWith("@.")) {
+          expr = expr.slice(2).trim();
+        }
+        const m = /^([^=]+)==?(.*)$/.exec(expr);
+        if (!m) {
+          const bareOperator = /[<>]/.exec(expr);
+          if (bareOperator !== null) {
+            throw new Error(`unsupported comparison operator '${bareOperator[0]}' in '[${inner}]' of path spec '${spec}': this grammar filters by equality only ([field=value])`);
+          }
+          throw new Error(`invalid bracket expression '[${inner}]' in path spec: '${spec}' (expected [n], [*], or [field=value])`);
+        }
+        let field = m[1].trim();
+        if (field.startsWith("@.")) field = field.slice(2).trim();
+        const swallowedOperator = /[!<>]$/.exec(field);
+        if (swallowedOperator !== null) {
+          throw new Error(`unsupported comparison operator '${swallowedOperator[0]}=' in '[${inner}]' of path spec '${spec}': this grammar filters by equality only ([field=value])`);
+        }
+        let rawVal = m[2].trim();
+        if (rawVal.startsWith('"') && rawVal.endsWith('"') || rawVal.startsWith("'") && rawVal.endsWith("'")) {
+          if (rawVal.length >= 2) {
+            rawVal = rawVal.slice(1, -1).replace(/\\(["'\\])/g, "$1");
+          }
+        }
+        ops.push({ kind: "filter", field, value: rawVal });
       }
       i = close + 1;
       continue;
@@ -322,6 +441,7 @@ function parseJsonPath(spec) {
 function evalJsonPath(data, ops) {
   let current = [data];
   let fanned = false;
+  const budget = { nodesLeft: MAX_RECURSIVE_NODES, exhausted: false };
   for (const op of ops) {
     const next = [];
     for (const item of current) {
@@ -331,6 +451,9 @@ function evalJsonPath(data, ops) {
         } else if (!fanned) {
           throw new Error(`path not found: key '${op.name}' does not exist on ${jsonType(item)} value`);
         }
+      } else if (op.kind === "recursive_key") {
+        fanned = true;
+        collectRecursiveKey(item, op.name, next, budget);
       } else if (op.kind === "index") {
         if (Array.isArray(item)) {
           const idx = op.index < 0 ? item.length + op.index : op.index;
@@ -353,8 +476,11 @@ function evalJsonPath(data, ops) {
         fanned = true;
         if (Array.isArray(item)) {
           for (const el of item) {
-            if (typeof el === "object" && el !== null && !Array.isArray(el) && String(el[op.field]) === op.value) {
-              next.push(el);
+            if (typeof el === "object" && el !== null && !Array.isArray(el)) {
+              const val = getNestedField(el, op.field);
+              if (val !== void 0 && String(val) === op.value) {
+                next.push(el);
+              }
             }
           }
         }
@@ -362,7 +488,7 @@ function evalJsonPath(data, ops) {
     }
     current = next;
   }
-  return { fanned, items: current };
+  return { fanned, items: current, truncated: budget.exhausted };
 }
 function queryJson(data, spec) {
   return evalJsonPath(data, parseJsonPath(spec));
@@ -4406,7 +4532,7 @@ function quoteIdent(name) {
 function getSqliteSchema(filePath) {
   const db = openReadonlySqlite(filePath);
   try {
-    const objects = db.prepare("SELECT name, type FROM sqlite_master WHERE type IN ('table','view') AND name NOT LIKE 'sqlite_%' ORDER BY name").all();
+    const objects = db.prepare("SELECT name, type FROM sqlite_master WHERE type IN ('table','view') AND name NOT LIKE 'sqlite\\_%' ESCAPE '\\' ORDER BY name").all();
     const tables = objects.map((o) => {
       const columns = db.prepare(`PRAGMA table_info(${quoteIdent(o.name)})`).all().map(
         (c) => ({
@@ -4461,6 +4587,50 @@ function formatSqliteSchema(result) {
     return lines.join("\n");
   }).join("\n\n");
 }
+function getSqliteTables(filePath) {
+  const db = openReadonlySqlite(filePath);
+  try {
+    const objects = db.prepare(
+      // ESCAPE makes every `_` literal; see getSqliteSchema above. Here it costs three tables rather than one, since `%_fts_%` and `%_vec0_%` exist to hide the shadow tables FTS5 and sqlite-vec create beside a virtual table, and unescaped they also hide anything of the shape `my_ftsx_cache`.
+      "SELECT name, type FROM sqlite_master WHERE type IN ('table','view') AND name NOT LIKE 'sqlite\\_%' ESCAPE '\\' AND name NOT LIKE '%\\_fts\\_%' ESCAPE '\\' AND name NOT LIKE '%\\_vec0\\_%' ESCAPE '\\' ORDER BY name"
+    ).all();
+    return objects.map((o) => {
+      let columnCount;
+      try {
+        const cols = db.prepare(`PRAGMA table_info(${quoteIdent(o.name)})`).all();
+        columnCount = cols.length;
+      } catch {
+        columnCount = 0;
+      }
+      let rowCount;
+      try {
+        const row = db.prepare(`SELECT COUNT(*) AS c FROM ${quoteIdent(o.name)}`).get();
+        rowCount = row.c;
+      } catch {
+        rowCount = null;
+      }
+      return {
+        name: o.name,
+        kind: o.type === "view" ? "view" : "table",
+        rowCount,
+        columnCount
+      };
+    });
+  } finally {
+    db.close();
+  }
+}
+function formatSqliteTables(tables) {
+  if (tables.length === 0) return "(no tables or views found)";
+  return tables.map((t) => {
+    const parts = [t.kind];
+    if (t.rowCount !== null) {
+      parts.push(`${t.rowCount.toLocaleString()} row${t.rowCount === 1 ? "" : "s"}`);
+    }
+    parts.push(`${t.columnCount} col${t.columnCount === 1 ? "" : "s"}`);
+    return `${displaySafeText(t.name)}  (${parts.join(", ")})`;
+  }).join("\n");
+}
 var FORBIDDEN_KEYWORDS = [
   "INSERT",
   "UPDATE",
@@ -5420,7 +5590,7 @@ function resolveSymbolMatch(filePath, symbolName, dbPath = globalDbPath()) {
 }
 function bodyFromSource(entry) {
   try {
-    return fs3.readFileSync(entry.filePath, "utf8").split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
+    return indexedSourceText(entry.filePath, fs3.readFileSync(entry.filePath, "utf8")).split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
   } catch {
     return "";
   }
@@ -5617,7 +5787,7 @@ function refMatchesDefinition(ts, checker, sourceFile, ref, symbolName, defSymbo
   }
   const node = findIdentifierNearPosition(ts, sourceFile, line0, position, symbolName);
   if (node === null) return null;
-  let symbol = checker.getSymbolAtLocation(node);
+  let symbol = ts.isShorthandPropertyAssignment(node.parent) ? checker.getShorthandAssignmentValueSymbol(node.parent) : checker.getSymbolAtLocation(node);
   if (symbol === void 0) return null;
   if (symbol.flags & ts.SymbolFlags.Alias) {
     try {
@@ -5835,7 +6005,7 @@ function resolveBody(entry) {
   if (entry.body !== "") return entry.body;
   const source = readFileText(entry.filePath);
   if (source === null) return entry.body;
-  return source.split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
+  return indexedSourceText(entry.filePath, source).split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
 }
 var STALE_WARNING = "\u26A0 STALE: index is older than the file on disk (worker hasn't reindexed yet \u2014 retry shortly, or read the file directly)";
 var DELETED_WARNING = "\u26A0 DELETED: this file is no longer on disk \u2014 what follows is what the index last saw of it";
@@ -6240,7 +6410,7 @@ function runSymbol(opts) {
       const exactMatches = rawSymbols.filter((s) => s.name === opts.name);
       if (exactMatches.length > 0) {
         const shown = exactMatches.slice(0, DIDYOUMEAN_LIMIT);
-        const where = shown.map((s) => `${s.kind} at ${toDisplayPath(rootDir, s.filePath)}:${s.lineStart}`).join("; ");
+        const where = shown.map((s) => `${s.kind} at ${formatSymbolLocation(toDisplayPath(rootDir, s.filePath), s.lineStart)}`).join("; ");
         const more = exactMatches.length > shown.length ? ` (+${exactMatches.length - shown.length} more)` : "";
         const flags = [opts.kind !== void 0 ? "--kind" : null, opts.file !== void 0 ? "--file" : null].filter((f) => f !== null);
         const widen = flags.length > 0 ? `drop ${flags.join("/")} to see it` : "widen the search scope to see it";
@@ -6300,7 +6470,7 @@ ${emptyIndexMessage(emptyIndexRoot)}`;
   const blocks = results.map((sym) => {
     const statsStr = formatStatsSuffix(refCounts, sym);
     const goneTag = fileIsGone(sym.filePath) ? `  ${DELETED_TAG}` : "";
-    const header = `# ${sym.name} (${sym.kind}) \u2014 ${toDisplayPath(symbolDisplayRoot, sym.filePath)}:${sym.lineStart}-${sym.lineEnd}${statsStr}${goneTag}`;
+    const header = `# ${sym.name} (${sym.kind}) \u2014 ${formatSymbolLocation(toDisplayPath(symbolDisplayRoot, sym.filePath), sym.lineStart, sym.lineEnd)}${statsStr}${goneTag}`;
     const body = resolveBody(sym);
     const bodyLines = body.split(/\r?\n/);
     const preview = bodyLines.slice(0, SYMBOL_PREVIEW_LINES).join("\n");
@@ -7332,7 +7502,8 @@ function runOutline(opts) {
     const bodyLen = sym.lineEnd - sym.lineStart + 1;
     const docFirst = hasRealDocstring(sym.docstring) ? `  # ${clipDocSummary(sym.docstring.split("\n")[0] ?? "")}` : "";
     const statsStr = formatStatsSuffix(refCounts, sym);
-    lines.push(`  ${rangeStr}  ${kindStr}  ${sym.name}  (${bodyLen}\u2113)${docFirst}${statsStr}`);
+    const notebookSuffix = isVirtualIndexedPath(sym.filePath) ? NOTEBOOK_CELL_LINES_SUFFIX : "";
+    lines.push(`  ${rangeStr}  ${kindStr}  ${sym.name}  (${bodyLen}\u2113)${docFirst}${statsStr}${notebookSuffix}`);
   }
   const text = guardText(staleWarning(resolved) + lines.join("\n"), "symbol");
   recordReadStat("outline", fullSourceBytes, text, opts.file);
@@ -7473,7 +7644,7 @@ function runQueryCommand(opts, parse, formatLabel, guardTag, kind) {
     const headTruncated = limited.length < totalCount;
     if (opts.json === true) {
       const capped = guardJsonRows(limited);
-      const jsonText = displaySafeJson({ items: capped.items, truncated: capped.truncated || headTruncated, totalCount }, 0);
+      const jsonText = displaySafeJson({ items: capped.items, truncated: capped.truncated || headTruncated || result.truncated, totalCount }, 0);
       emit(jsonText);
       recordReadStat(kind, fullSourceBytes, jsonText, opts.file);
     } else {
@@ -7481,6 +7652,9 @@ function runQueryCommand(opts, parse, formatLabel, guardTag, kind) {
       if (headTruncated) {
         lines.push(`...(${totalCount - limited.length} more items elided; use --head to see more)`);
       }
+      if (result.truncated) {
+        lines.push(`...(the search stopped early at this tool's traversal limit; these are not necessarily all the matches. Narrow the path to search less of the document.)`);
+      }
       const plainText = lines.join("\n");
       emitGuarded(plainText, guardTag);
       recordReadStat(kind, fullSourceBytes, plainText, opts.file);
@@ -8093,6 +8267,25 @@ function runSqliteSchema(opts) {
     return 1;
   }
 }
+function runSqliteTables(opts) {
+  try {
+    const tables = getSqliteTables(opts.file);
+    const fullSourceBytes = sumFileSizes([opts.file]);
+    if (opts.json === true) {
+      const jsonText = displaySafeJson(tables, 0);
+      emit(jsonText);
+      recordReadStat("sqlite_tables", fullSourceBytes, jsonText, opts.file);
+    } else {
+      const text = formatSqliteTables(tables);
+      emit(text);
+      recordReadStat("sqlite_tables", fullSourceBytes, text, opts.file);
+    }
+    return 0;
+  } catch (e) {
+    emitErr(extractErrorMessage(e));
+    return 1;
+  }
+}
 function runSqliteQuery(opts) {
   let head;
   try {
@@ -8254,7 +8447,7 @@ async function runImageMeta(file) {
     shrunkBytes: shrink !== null ? shrink.shrunkBytes : null
   };
 }
-async function runImageText(file) {
+async function runImageText(file, lang) {
   if (!fileExists(file)) {
     throw new Error(`Could not read: ${file}`);
   }
@@ -8262,7 +8455,7 @@ async function runImageText(file) {
     throw new Error(`Not an image file: ${file}`);
   }
   const data = fs4.readFileSync(file);
-  const ocr = await ocrImage(data);
+  const ocr = await ocrImage(data, lang);
   if (ocr === null) {
     if (ocrIntegrityFailed()) {
       throw new Error(`${file} was not OCRed: the cached language model failed its checksum and was discarded, so the next run re-downloads it`);
@@ -8349,7 +8542,7 @@ ${emptyIndexMessage(rootDir2)}`, code: 1 };
   const bodyLen = match.lineEnd - match.lineStart + 1;
   const lines = [
     // This header is token-goat's own line quoting a repo-chosen name, kind and path, so it is escaped. `body` below it is the source the reader asked for and stays byte-for-byte.
-    `# ${displaySafeText(match.name)}  ${displaySafeText(match.kind)}  ${displaySafeText(toDisplayPath(rootDir, match.filePath))}:${match.lineStart}-${match.lineEnd}`,
+    `# ${displaySafeText(match.name)}  ${displaySafeText(match.kind)}  ${formatSymbolLocation(displaySafeText(toDisplayPath(rootDir, match.filePath)), match.lineStart, match.lineEnd)}`,
     `# ${countNoun(bodyLen, "line")} (~${Math.ceil(body.length / 4)} tok)`,
     body,
     ""
@@ -8669,7 +8862,7 @@ function runChanged(opts = {}) {
     for (const f of changedFiles) {
       const fileSymbols = querySymbols({ filePath: resolveIndexPath(f, projectRoot), limit: FIND_SCAN_LIMIT });
       const hunks = hunksByFile.get(f);
-      const scoped = hunks === void 0 ? fileSymbols : fileSymbols.filter((s) => hunks.some((h) => h.start <= s.lineEnd && h.end >= s.lineStart));
+      const scoped = hunks === void 0 || isVirtualIndexedPath(f) ? fileSymbols : fileSymbols.filter((s) => hunks.some((h) => h.start <= s.lineEnd && h.end >= s.lineStart));
       allSymbols.push(...scoped);
     }
     if (allSymbols.length === 0) {
@@ -8685,9 +8878,9 @@ function runChanged(opts = {}) {
       recordReadStat("changed_lookup", symbolFullBytes, text, ref);
       return 0;
     }
-    const symbolText = allSymbols.map((s) => `${s.name} (${s.kind}) \u2014 ${toDisplayPath(projectRoot, s.filePath)}:${s.lineStart}`).join("\n");
+    const symbolText = allSymbols.map((s) => `${s.name} (${s.kind}) \u2014 ${formatSymbolLocation(toDisplayPath(projectRoot, s.filePath), s.lineStart)}`).join("\n");
     for (const s of allSymbols) {
-      emit(`${displaySafeText(s.name)} (${displaySafeText(s.kind)}) \u2014 ${displaySafeText(toDisplayPath(projectRoot, s.filePath))}:${s.lineStart}`);
+      emit(`${displaySafeText(s.name)} (${displaySafeText(s.kind)}) \u2014 ${formatSymbolLocation(displaySafeText(toDisplayPath(projectRoot, s.filePath)), s.lineStart)}`);
     }
     recordReadStat("changed_lookup", symbolFullBytes, symbolText, ref);
     return 0;
@@ -8800,7 +8993,8 @@ function runDiff(opts) {
     return 0;
   }
   const { hunks } = splitDiffHunks(diffResult.stdout);
-  const overlapping = hunks.filter((h) => h.start <= match.lineEnd && h.end >= match.lineStart);
+  const diffFileScoped = isVirtualIndexedPath(match.filePath);
+  const overlapping = diffFileScoped ? hunks : hunks.filter((h) => h.start <= match.lineEnd && h.end >= match.lineStart);
   if (overlapping.length === 0) {
     emit(`No changes to '${displaySafeText(match.name)}' (lines ${match.lineStart}-${match.lineEnd}) in '${displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath))}'.`);
     return 0;
@@ -8822,8 +9016,9 @@ function runDiff(opts) {
     );
     return 0;
   }
-  const header = `# ${displaySafeText(match.name)} (${displaySafeText(match.kind)}) \u2014 ${displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath))}:${match.lineStart}-${match.lineEnd}`;
-  emit(guardText([header, ...overlapping.map((h) => h.text)].join("\n"), "diff"));
+  const header = `# ${displaySafeText(match.name)} (${displaySafeText(match.kind)}) \u2014 ${formatSymbolLocation(displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath)), match.lineStart, match.lineEnd)}`;
+  const diffNote = diffFileScoped ? [virtualIndexedScopeNote(displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath)), "these hunks cover the whole file rather than this symbol alone")] : [];
+  emit(guardText([header, ...diffNote, ...overlapping.map((h) => h.text)].join("\n"), "diff"));
   return 0;
 }
 var DEFAULT_LOG_MAX_COUNT = 20;
@@ -8873,7 +9068,8 @@ function runLog(opts) {
   if (match === null) return 1;
   const cwd = opts.projectRoot ?? process.cwd();
   const maxCount = opts.maxCount ?? DEFAULT_LOG_MAX_COUNT;
-  const logArgs = [
+  const fileScoped = isVirtualIndexedPath(match.filePath);
+  const logArgs = fileScoped ? ["log", `--max-count=${maxCount}`, ...opts.ref !== void 0 ? [opts.ref] : [], "--", match.filePath] : [
     "log",
     `-L${match.lineStart},${match.lineEnd}:${match.filePath}`,
     `--max-count=${maxCount}`,
@@ -8911,8 +9107,9 @@ function runLog(opts) {
     );
     return 0;
   }
-  const header = `# ${displaySafeText(match.name)} (${displaySafeText(match.kind)}) \u2014 ${displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath))}:${match.lineStart}-${match.lineEnd}`;
-  emit(guardText([header, logResult.stdout].join("\n"), "diff"));
+  const header = `# ${displaySafeText(match.name)} (${displaySafeText(match.kind)}) \u2014 ${formatSymbolLocation(displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath)), match.lineStart, match.lineEnd)}`;
+  const logNote = fileScoped ? [virtualIndexedScopeNote(displaySafeText(toDisplayPath(getDisplayRoot(opts.projectRoot), match.filePath)), "this history covers the whole file rather than this symbol alone")] : [];
+  emit(guardText([header, ...logNote, logResult.stdout].join("\n"), "diff"));
   return 0;
 }
 function foldRealpath(p) {
@@ -9051,9 +9248,12 @@ function runGrep(opts) {
         syms = querySymbols({ filePath: resolveIndexPath(hit.file), limit: ALL_SYMBOLS_IN_FILE_LIMIT });
         symbolsByFile.set(hit.file, syms);
       }
-      const enc = enclosingSymbol(syms, hit.line);
+      const enc = isVirtualIndexedPath(hit.file) ? null : enclosingSymbol(syms, hit.line);
       hit.symbol = enc === null ? null : { name: enc.name, kind: enc.kind, lineStart: enc.lineStart, lineEnd: enc.lineEnd };
     }
+    for (const file of new Set(truncated.map((h) => h.file).filter(isVirtualIndexedPath))) {
+      emit(virtualIndexedScopeNote(displaySafeText(file), "a match in it cannot be attributed to a symbol and these hits carry no label"));
+    }
   }
   if (opts.json === true) {
     const payload = { items: truncated, truncated: hits.length > maxLines, totalCount: hits.length };
@@ -11142,7 +11342,7 @@ function runTypes(opts) {
     emit2(`${countNoun(filtered.length, "type declaration")} (${excludeTestsHiddenNote(suppressed)})`);
   }
   for (const r of filtered) {
-    emit2(`${displaySafeText(r.name)}	${displaySafeText(r.kind)}	${displaySafeText(toDisplayPath(rootDir, r.filePath))}:${r.lineStart}`);
+    emit2(`${displaySafeText(r.name)}	${displaySafeText(r.kind)}	${formatSymbolLocation(displaySafeText(toDisplayPath(rootDir, r.filePath)), r.lineStart)}`);
   }
   if (cappedOut > 0) {
     emitErr2(`Showing ${filtered.length} of ${eligibleCount} type declarations (--limit is per kind; raise it to see the rest).`);
@@ -11197,7 +11397,7 @@ function runScope(opts) {
     return 0;
   }
   for (const s of enclosing) {
-    emit2(`${displaySafeText(s.name)}	${displaySafeText(s.kind)}	${displaySafeText(toDisplayPath(scopeDisplayRoot, s.filePath))}:${s.lineStart}-${s.lineEnd}`);
+    emit2(`${displaySafeText(s.name)}	${displaySafeText(s.kind)}	${formatSymbolLocation(displaySafeText(toDisplayPath(scopeDisplayRoot, s.filePath)), s.lineStart, s.lineEnd)}`);
   }
   return 0;
 }
@@ -11330,7 +11530,7 @@ function runSimilar(opts) {
     emit2(displaySafeJson(results.map((h) => ({ name: h.name, kind: h.kind, file: h.filePath, line: h.lineStart }))));
     return 0;
   }
-  for (const h of results) emit2(`${displaySafeText(h.name)}	${displaySafeText(h.kind)}	${displaySafeText(toDisplayPath(rootDir, h.filePath))}:${h.lineStart}`);
+  for (const h of results) emit2(`${displaySafeText(h.name)}	${displaySafeText(h.kind)}	${formatSymbolLocation(displaySafeText(toDisplayPath(rootDir, h.filePath)), h.lineStart)}`);
   return 0;
 }
 function runContextFor(opts) {
@@ -11766,6 +11966,7 @@ export {
   resolveBody,
   healStaleIndex,
   warnIfFilesStale,
+  guardJsonRows,
   findSpecSeparator,
   rankSimilarNames,
   filterSimilarHeadings,
@@ -11795,6 +11996,7 @@ export {
   runZipRead,
   runPrSlice,
   runSqliteSchema,
+  runSqliteTables,
   runSqliteQuery,
   runCoverageReportGaps,
   runConflicts,