token-goat 2.9.18 → 2.9.19

package/dist/{token-goat-chunk-34OUJ2IE.mjs → token-goat-chunk-NYFYIRG3.mjs}

@@ -4,24 +4,24 @@ import {
   buildEvent,
   relay,
   relayInProcess
-} from "./token-goat-chunk-WFX2V3OF.mjs";
-import "./token-goat-chunk-RHHFEXKF.mjs";
+} from "./token-goat-chunk-HPMMLV37.mjs";
+import "./token-goat-chunk-MU6I4IDI.mjs";
 import {
   MAX_STDIN_BYTES,
   readStdinJson
-} from "./token-goat-chunk-V3ZWBEHM.mjs";
-import "./token-goat-chunk-BFEWOMA3.mjs";
-import "./token-goat-chunk-CTOYJ232.mjs";
-import "./token-goat-chunk-HPOFR6QX.mjs";
+} from "./token-goat-chunk-2GTB5RBZ.mjs";
+import "./token-goat-chunk-FQYMZASI.mjs";
+import "./token-goat-chunk-7DGTVBWP.mjs";
+import "./token-goat-chunk-S7RFIX4Y.mjs";
 import "./token-goat-chunk-3BTK54F3.mjs";
-import "./token-goat-chunk-W3E65QOW.mjs";
-import "./token-goat-chunk-I67CPTDD.mjs";
-import "./token-goat-chunk-L7VCX33I.mjs";
-import "./token-goat-chunk-CA6V36KW.mjs";
+import "./token-goat-chunk-EP7TCWHM.mjs";
+import "./token-goat-chunk-IBTFGZBX.mjs";
+import "./token-goat-chunk-JNIFSVWM.mjs";
+import "./token-goat-chunk-SOKAPOOC.mjs";
 import "./token-goat-chunk-EEIDFMEM.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-QIDLJGXZ.mjs";
-import "./token-goat-chunk-ERTXEKB6.mjs";
+import "./token-goat-chunk-ZGQXRYKE.mjs";
+import "./token-goat-chunk-NMTKNYGF.mjs";
 import "./token-goat-chunk-Y4AFKTHK.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";
 import "./token-goat-chunk-RRNZMM3A.mjs";

package/dist/{token-goat-chunk-4EXFN2AW.mjs → token-goat-chunk-OZRSREKR.mjs}

@@ -11,9 +11,9 @@ import {
   openReadonlySqlite,
   runReadOnlySqliteQuery,
   validateReadOnlySelect
-} from "./token-goat-chunk-LMFO66YD.mjs";
+} from "./token-goat-chunk-DA43OE7L.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-ERTXEKB6.mjs";
+import "./token-goat-chunk-NMTKNYGF.mjs";
 import "./token-goat-chunk-A37V4PBF.mjs";
 export {
   SQLITE_QUERY_ROW_CAP,

package/dist/token-goat-chunk-P46RTOAQ.mjs

@@ -0,0 +1,27 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  DEFAULT_HEARTBEAT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_SECONDS,
+  MAX_CAPTURE_BYTES,
+  run,
+  runRaw
+} from "./token-goat-chunk-MU6I4IDI.mjs";
+import "./token-goat-chunk-7DGTVBWP.mjs";
+import "./token-goat-chunk-S7RFIX4Y.mjs";
+import "./token-goat-chunk-IBTFGZBX.mjs";
+import "./token-goat-chunk-JNIFSVWM.mjs";
+import "./token-goat-chunk-SOKAPOOC.mjs";
+import "./token-goat-chunk-EEIDFMEM.mjs";
+import "./token-goat-chunk-OSUFN2FV.mjs";
+import "./token-goat-chunk-ZGQXRYKE.mjs";
+import "./token-goat-chunk-NMTKNYGF.mjs";
+import "./token-goat-chunk-GMOUBOX4.mjs";
+import "./token-goat-chunk-A37V4PBF.mjs";
+export {
+  DEFAULT_HEARTBEAT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_SECONDS,
+  MAX_CAPTURE_BYTES,
+  run,
+  runRaw
+};

package/dist/{token-goat-chunk-QML7ITHJ.mjs → token-goat-chunk-PIAESKVU.mjs}

@@ -5,7 +5,7 @@ import {
   isTextHeavy,
   ocrImage,
   ocrIntegrityFailed
-} from "./token-goat-chunk-H3FONFBO.mjs";
+} from "./token-goat-chunk-F24NE3FO.mjs";
 import {
   formatSqliteQueryTable,
   formatSqliteSchema,
@@ -13,9 +13,10 @@ import {
   getSqliteSchema,
   getSqliteTables,
   runReadOnlySqliteQuery
-} from "./token-goat-chunk-LMFO66YD.mjs";
+} from "./token-goat-chunk-DA43OE7L.mjs";
 import {
   ImageDecodeError,
+  LARGE_SYMBOL_LINE_THRESHOLD,
   NOTEBOOK_CELL_LINES_SUFFIX,
   SKIP_DIRS,
   canShrinkFormat,
@@ -28,13 +29,14 @@ import {
   getEmbeddingCoverage,
   getTrackedFiles,
   indexedSourceText,
-  isImagePath,
+  isIgnoredIndexPath,
   isIndexEmptyForProject,
   isPrivateIpv4Octets,
   isPrivateIpv6Groups,
   isVirtualIndexedPath,
   parseIpv6Groups,
   probeImageMeta,
+  resolveLineRegions,
   scanAndRecord,
   searchEvidenceSemantically,
   shrinkImage,
@@ -42,7 +44,7 @@ import {
   urlPolicyDenialReason,
   virtualIndexedScopeNote,
   walkProject
-} from "./token-goat-chunk-BFEWOMA3.mjs";
+} from "./token-goat-chunk-FQYMZASI.mjs";
 import {
   colorStdout,
   isBlobStale,
@@ -52,7 +54,7 @@ import {
   savedTokensFromBytes,
   storeBlob,
   stripAnsi
-} from "./token-goat-chunk-HPOFR6QX.mjs";
+} from "./token-goat-chunk-S7RFIX4Y.mjs";
 import {
   extractPdfMeta,
   extractPdfOutline,
@@ -66,7 +68,7 @@ import {
   parseWhereSpecs,
   profileCsv,
   queryCsv
-} from "./token-goat-chunk-EPXNOKIV.mjs";
+} from "./token-goat-chunk-KWM6KBPA.mjs";
 import {
   MAX_ZIP_INPUT_BYTES,
   MAX_ZIP_OUTPUT_BYTES,
@@ -101,7 +103,7 @@ import {
   extractSolidity,
   extractThrift,
   stripLeadingAttributes
-} from "./token-goat-chunk-GRI6HWX3.mjs";
+} from "./token-goat-chunk-NJKNAC37.mjs";
 import {
   MAX_OVER_FETCH,
   OVER_FETCH_FACTOR,
@@ -109,12 +111,13 @@ import {
   findContainingSection,
   indexFileSync,
   isAvailable,
+  isImagePath,
   isTreeSitterAvailable,
   listSections,
   mergeNearbyHits,
   readSection,
   searchSemantic
-} from "./token-goat-chunk-W3E65QOW.mjs";
+} from "./token-goat-chunk-EP7TCWHM.mjs";
 import {
   DEFAULT_QUERY_LIMIT,
   countRefs,
@@ -127,7 +130,7 @@ import {
   queryRefsByContext,
   querySymbols,
   searchSymbolsFts
-} from "./token-goat-chunk-I67CPTDD.mjs";
+} from "./token-goat-chunk-IBTFGZBX.mjs";
 import {
   FILENAME_LANGUAGE,
   TREE_SITTER_LANGUAGES,
@@ -146,7 +149,7 @@ import {
   partialRefsReason,
   redactIfDotenv,
   unsupportedLanguageName
-} from "./token-goat-chunk-L7VCX33I.mjs";
+} from "./token-goat-chunk-JNIFSVWM.mjs";
 import {
   fileIsAbsent,
   findProject,
@@ -156,7 +159,7 @@ import {
   loadConfig,
   resolveProjectRoot,
   shortFingerprint
-} from "./token-goat-chunk-CA6V36KW.mjs";
+} from "./token-goat-chunk-SOKAPOOC.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
@@ -188,7 +191,7 @@ import {
   supportRequestLine,
   windowsCmdQuoteArg,
   withExtension
-} from "./token-goat-chunk-QIDLJGXZ.mjs";
+} from "./token-goat-chunk-ZGQXRYKE.mjs";
 import {
   UNTRUSTED_FILE_TAG,
   UNTRUSTED_GITHUB_TAG,
@@ -200,7 +203,7 @@ import {
   normalizePath,
   resolveIndexPath,
   toDisplayPath
-} from "./token-goat-chunk-ERTXEKB6.mjs";
+} from "./token-goat-chunk-NMTKNYGF.mjs";
 import {
   compileGuardedRegex
 } from "./token-goat-chunk-GMOUBOX4.mjs";
@@ -2263,6 +2266,11 @@ function runCallers(opts) {
   if (opts.excludeTests === true && suppressed > 0) {
     emit3(`${countNoun(entries.length, "caller")} found (${excludeTestsHiddenNote(suppressed)})`);
   }
+  const overflowed = sqlTruncated || entries.length < filtered.length;
+  if (overflowed) {
+    const totalCallers = sqlTruncated ? countRefs({ name, rootDir }) : filtered.length;
+    emitErr3(`Showing the first ${entries.length} of ${countNoun(totalCallers, "caller")} (raise --limit to see the rest).`);
+  }
   for (const e of entries) {
     const displayPath = toDisplayPath(rootDir, e.file);
     emit3(`${e.caller}	${displayPath}:${e.line}`);
@@ -10314,6 +10322,16 @@ function runListSections(opts) {
 init_define_import_meta_env();
 import * as fs11 from "node:fs";
 import * as path11 from "node:path";
+function htmlIdSectionFallback(filePath, heading) {
+  if (detectLanguage(filePath) !== "html") return null;
+  healStaleIndex(filePath);
+  const hit = querySymbols({ name: stripHtmlIdSpelling(heading, filePath), filePath, kind: "html_id", limit: 1 })[0];
+  if (hit === void 0) return null;
+  const text = readFileText(filePath);
+  if (text === null) return null;
+  const lines = text.split("\n");
+  return { heading: hit.name, content: lines.slice(hit.lineStart - 1, hit.lineEnd).join("\n"), lineStart: hit.lineStart, lineEnd: hit.lineEnd };
+}
 var AMBIGUOUS_HEADING_LIMIT = 10;
 function literalHeadingExists(filePath, heading) {
   const ordinalMatch = /^([^#\r\n]+)#(\d+)$/.exec(heading);
@@ -10335,7 +10353,7 @@ function runSection(opts) {
     const multiHeadings = heading.split(",").map((h) => h.trim()).filter((h) => h.length > 0);
     if (multiHeadings.length > 1) return runSectionMulti(specFilePath, filePath, multiHeadings, opts);
   }
-  const result = readSection(filePath, heading, readFileText);
+  const result = readSection(filePath, heading, readFileText) ?? htmlIdSectionFallback(filePath, heading);
   if (result === null) {
     if (!fs11.existsSync(filePath)) {
       return { text: `File not found: '${filePath}'`, code: 1 };
@@ -10797,6 +10815,7 @@ function runSymbol(opts) {
   }
   const matchesGrep = opts.grep !== void 0 ? compileGrepMatcher(opts.grep) : void 0;
   const excludeTests = opts.excludeTests === true;
+  const excludeVendored = opts.excludeVendored === true;
   const baseConfined = confinedProjectRoot();
   const confinedRoot = opts.projectRoot !== void 0 && baseConfined !== null && isProjectRootAllowed(opts.projectRoot, baseConfined) ? confinedProjectRoot(opts.projectRoot) ?? baseConfined : baseConfined;
   if (baseConfined !== null) {
@@ -10809,13 +10828,13 @@ function runSymbol(opts) {
     }
   }
   const queryOpts = {};
-  if (opts.name !== void 0) queryOpts.name = opts.name;
   if (opts.file !== void 0) {
     queryOpts.filePath = resolveIndexPath(opts.file, opts.projectRoot ?? process.cwd());
     healStaleIndex(queryOpts.filePath);
   }
+  if (opts.name !== void 0) queryOpts.name = queryOpts.filePath !== void 0 ? stripHtmlIdSpelling(opts.name, queryOpts.filePath) : opts.name;
   if (opts.kind !== void 0) queryOpts.kind = opts.kind;
-  if (matchesGrep !== void 0 || excludeTests) {
+  if (matchesGrep !== void 0 || excludeTests || excludeVendored) {
     queryOpts.limit = FIND_SCAN_LIMIT2;
   } else if (opts.limit !== void 0) {
     queryOpts.limit = opts.limit;
@@ -10831,8 +10850,8 @@ function runSymbol(opts) {
   }
   const preFilterCount = rawResults.length;
   const effectiveLimit = opts.limit ?? 100;
-  const anyClientFilter = matchesGrep !== void 0 || excludeTests;
-  const filtered = anyClientFilter ? rawResults.filter((s) => (matchesGrep === void 0 || matchesGrep(s.name)) && !(excludeTests && isTestFile(s.filePath))) : rawResults;
+  const anyClientFilter = matchesGrep !== void 0 || excludeTests || excludeVendored;
+  const filtered = anyClientFilter ? rawResults.filter((s) => (matchesGrep === void 0 || matchesGrep(s.name)) && !(excludeTests && isTestFile(s.filePath)) && !(excludeVendored && isIgnoredIndexPath(s.filePath))) : rawResults;
   const results = anyClientFilter ? filtered.slice(0, effectiveLimit) : filtered;
   const hiddenByExcludeTests = excludeTests ? rawResults.filter((s) => (matchesGrep === void 0 || matchesGrep(s.name)) && isTestFile(s.filePath)).length : 0;
   if (excludeTests && filtered.length === 0 && hiddenByExcludeTests > 0) {
@@ -10957,6 +10976,8 @@ function truncationNotice(shown, limit, total, plural, flag) {
 function runRead(opts) {
   const range = parseLineRange(opts.spec);
   if (range !== null) return runLineRange(range, opts);
+  const region = parseColonLineSpec(opts.spec);
+  if (region !== null) return runLineRegion(region, opts);
   const crossFilePairs = parseCrossFileMultiSpec(opts.spec);
   if (crossFilePairs !== null) return runReadMulti(crossFilePairs, opts);
   const { file, symbol } = parseReadSpec(opts.spec);
@@ -11046,8 +11067,7 @@ Query subtree: token-goat json-query ${file} '<path>'`);
       {
         ...match,
         body: resolveBody(match),
-        // The text branch below prepends staleWarning's DELETED line; without this the JSON form
-        // would be the one surface that still passes a deleted file's body off as a live read.
+        // The text branch below prepends staleWarning's DELETED line; without this the JSON form would be the one surface that still passes a deleted file's body off as a live read.
         ...fileIsGone(match.filePath) ? { deleted: true } : {},
         ...refCounts !== void 0 ? { refCount: refCounts.get(match.name) ?? 0 } : {}
       }
@@ -11063,7 +11083,9 @@ Query subtree: token-goat json-query ${file} '<path>'`);
     body
   ];
   const warning = staleWarning(match.filePath);
-  const text = guardText(warning + trimBlankLines(lines).join("\n"), "symbol");
+  const narrowerSliceHint = bodyLen > LARGE_SYMBOL_LINE_THRESHOLD ? `
+# for a narrower slice: token-goat grep "<pattern>" ${file} -C 15 --symbol` : "";
+  const text = guardText(warning + trimBlankLines(lines).join("\n"), "symbol") + narrowerSliceHint;
   if (opts.suppressStat !== true) recordReadStat("read_replacement", fullSourceBytes, text, opts.spec);
   return { text, code: 0 };
 }
@@ -12142,7 +12164,7 @@ function parseMultiFileSpec(spec) {
 function extraFileArgsNote(command, first, extras, opts = {}) {
   const noun = opts.noun ?? "file";
   const head = `Note: ${extras.length} extra ${noun} argument(s) ignored (${extras.join(", ")}).`;
-  if (opts.mergeable === false) return `${head} ${command} takes one ${noun} at a time.`;
+  if (opts.mergeable === false) return `${head} Run ${command} once per ${noun}.`;
   return `${head} ${command} reads one ${noun}, or a comma-separated list: token-goat ${command} "${[first, ...extras].join(",")}"`;
 }
 function parseLineRange(spec) {
@@ -12154,6 +12176,22 @@ function parseLineRange(spec) {
   const end = m[3] !== void 0 ? parseInt(m[3], 10) : start;
   return { file: m[1], start, end };
 }
+function parseColonLineSpec(spec) {
+  const colonIdx = spec.lastIndexOf(":");
+  if (colonIdx <= 0) return null;
+  const suffix = spec.slice(colonIdx + 1);
+  if (!/^\d+(?:-\d+)?$/.test(suffix)) return null;
+  const file = spec.slice(0, colonIdx);
+  if (file === "") return null;
+  if (/^[A-Za-z]$/.test(file)) return null;
+  const pastDrive = /^[A-Za-z]:/.test(file) ? file.slice(2) : file;
+  if (pastDrive === "" || pastDrive.includes(":")) return null;
+  if (fileExists3(spec)) return null;
+  const dash = suffix.indexOf("-");
+  const start = parseInt(dash === -1 ? suffix : suffix.slice(0, dash), 10);
+  const end = dash === -1 ? start : parseInt(suffix.slice(dash + 1), 10);
+  return { file, start, end };
+}
 function parseColonLineRange(symbol) {
   const m = /^(\d+)(?:[-:,](\d+))?$/.exec(symbol);
   if (m === null) return null;
@@ -12161,6 +12199,19 @@ function parseColonLineRange(symbol) {
   const end = m[2] !== void 0 ? parseInt(m[2], 10) : start;
   return { start, end };
 }
+function readSpecsMergeable(specs) {
+  if (specs.length < 2) return true;
+  const joined = specs.join(",");
+  if (parseLineRange(joined) !== null) return false;
+  if (parseColonLineSpec(joined) !== null) return false;
+  if (parseCrossFileMultiSpec(joined) !== null) return true;
+  const { symbol } = parseReadSpec(joined);
+  return symbol !== void 0 && symbol !== "" && symbol.includes(",") && parseColonLineRange(symbol) === null;
+}
+function namedSpecsMergeable(specs) {
+  if (specs.length < 2) return true;
+  return specs.every((spec) => spec.includes("::"));
+}
 function runLineRange(range, opts) {
   const { file, start, end } = range;
   const diskPath = resolveAgainstProjectRoot(file, opts.projectRoot);
@@ -12193,6 +12244,64 @@ function runLineRange(range, opts) {
     code: 0
   };
 }
+function runLineRegion(range, opts) {
+  const { file, start, end } = range;
+  if (start < 1) return { text: `Invalid line range: start must be >= 1 (got ${start})`, code: 1 };
+  if (end < start) return { text: `Invalid line range: end (${end}) is before start (${start})`, code: 1 };
+  const resolved = resolveIndexPath(file, opts.projectRoot ?? process.cwd());
+  const confined = confinementRefusal("This file", resolved, confinedProjectRoot(opts.projectRoot));
+  if (confined !== null) return { text: confined, code: 1 };
+  const text = readFileText(resolveAgainstProjectRoot(file, opts.projectRoot));
+  if (text === null) return { text: `Could not read: ${file}`, code: 1 };
+  const allLines = text.split(/\r?\n/);
+  if (allLines.length > 1 && allLines[allLines.length - 1] === "") allLines.pop();
+  if (start > allLines.length) {
+    return { text: `Line ${start} is past end of file (${countNoun(allLines.length, "line")}): ${file}`, code: 1 };
+  }
+  if (opts.forceRefresh === true) {
+    indexFileSyncPinned(resolved, globalDbPath());
+    enqueueDirtyPathSafe(resolved, { alreadyResolved: true });
+  } else {
+    healStaleIndex(resolved);
+  }
+  const symbols = querySymbols({ filePath: resolved, limit: FIND_SCAN_LIMIT3 });
+  const regions = resolveLineRegions(symbols, allLines.length, start, end);
+  const asked = start === end ? `${start}` : `${start}-${end}`;
+  if (regions.length === 0) {
+    return {
+      text: `No indexed symbols in '${file}', so line ${asked} cannot be resolved to a region.
+Read the raw lines instead: token-goat read "${file}@${asked}"`,
+      code: 1
+    };
+  }
+  const slice = (r) => allLines.slice(r.start - 1, Math.min(r.end, allLines.length)).join("\n");
+  if (opts.json === true) {
+    return {
+      text: displaySafeJson({
+        file,
+        requested: { start, end },
+        regions: regions.map((r) => ({
+          kind: r.kind,
+          label: r.label,
+          start: r.start,
+          end: Math.min(r.end, allLines.length),
+          lines: allLines.slice(r.start - 1, Math.min(r.end, allLines.length))
+        }))
+      }),
+      code: 0
+    };
+  }
+  const blocks = [];
+  if (regions.length > 1) blocks.push(`# ${file}:${asked} -> ${countNoun(regions.length, "region")}`);
+  regions.forEach((r, i) => {
+    const body = slice(r);
+    const tag = regions.length > 1 ? `[${i + 1}/${regions.length}] ` : `${file}:${asked} -> `;
+    const span = `lines ${r.start}-${Math.min(r.end, allLines.length)} of ${allLines.length}`;
+    blocks.push(`# ${tag}${r.label}  ${span} (~${Math.ceil(body.length / 4)} tok)
+${body}`);
+  });
+  return { text: guardText(staleWarning(resolved) + blocks.join("\n\n"), "lines"), code: 0 };
+}
 function findParentName(entry, fileSymbols) {
   let best = null;
   for (const s of fileSymbols) {
@@ -12267,13 +12376,17 @@ function fileConfinementRefusal(label, file, projectRoot) {
   if (root === null) return null;
   return confinementRefusal(label, resolveIndexPath(file, projectRoot ?? process.cwd()), root);
 }
+function stripHtmlIdSpelling(name, filePath) {
+  return name.startsWith("#") && detectLanguage(filePath) === "html" ? name.slice(1) : name;
+}
 function resolveSymbolSpec(spec, forceRefresh, projectRoot) {
   const { file, symbol: rawSymbol } = parseReadSpec(spec);
   if (rawSymbol === void 0 || rawSymbol === "") return { kind: "none" };
   const anchorMatch = /^(.+)@(\d+)$/.exec(rawSymbol);
-  const symbol = anchorMatch !== null ? anchorMatch[1] : rawSymbol;
+  const anchorSymbol = anchorMatch !== null ? anchorMatch[1] : rawSymbol;
   const lineAnchor = anchorMatch !== null ? parseInt(anchorMatch[2], 10) : void 0;
   const resolved = resolveIndexPath(file, projectRoot ?? process.cwd());
+  const symbol = stripHtmlIdSpelling(anchorSymbol, resolved);
   const confined = confinementRefusal("This file", resolved, confinedProjectRoot(projectRoot));
   if (confined !== null) return { kind: "confined", message: confined };
   if (forceRefresh === true) {
@@ -12541,6 +12654,9 @@ export {
   didYouMean,
   extraFileArgsNote,
   parseLineRange,
+  parseColonLineSpec,
+  readSpecsMergeable,
+  namedSpecsMergeable,
   runSkeleton,
   runOutline,
   runBrief,