token-goat 2.9.16 → 2.9.17

package/README.md

@@ -341,12 +341,9 @@ Per-harness setup for Codex, Gemini, Qwen, Kimi, opencode, OpenClaw, pi, Copilot
 
 ## CLI
 
-You rarely type these yourself. Installation writes a routing guide into the agent's instructions, and the agent picks the command that answers its question: a surgical read (`read`, `symbol`, `section`, `skeleton`), a search (`semantic`, `refs`), orientation in an unfamiliar repo (`map`, `arch`, `affected`), recall of output it already has (`bash-output`, `web-output`, `mcp-output`), or a bounded reader for a PDF, Word file, slide deck, workbook, SQLite database, HTML document or image.
+You rarely type these yourself. Installation writes a routing guide into the agent's instructions, and the agent picks the command that answers its question: a surgical read (`read`, `symbol`, `locate`, `section`, `skeleton`), a search (`semantic`, `refs`), orientation in an unfamiliar repo (`map`, `arch`, `affected`), recall of output it already has (`bash-output`, `web-output`, `mcp-output`), or a bounded reader for a PDF, Word file, slide deck, workbook, SQLite database, HTML document or image.
 
-One command is for people working on token-goat rather than for agents: `token-goat bench` replays a
-corpus of captured shell output through the real compression path and reports how much smaller the
-result got, alongside a count of the lines each case is not allowed to lose. Deleting output makes
-the first number look better, so the second one is what keeps the first honest.
+One command is for people working on token-goat rather than for agents: `token-goat bench` replays a corpus of captured shell output through the real compression path and reports how much smaller the result got, alongside a count of the lines each case is not allowed to lose. Deleting output makes the first number look better, so the second one is what keeps the first honest.
 
 Every command, with its flags, its output, and the comparison workflows that chain them: **[CLI reference](docs/cli.md)**. For architectural analysis, empirical evaluations, and technical answers to common engineering questions: **[Architecture & Technical Q&A](docs/architecture-qa.html)**.
 

package/dist/{token-goat-chunk-DMQ32ZSR.mjs → token-goat-chunk-26YUO7MP.mjs}

@@ -2,11 +2,11 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   getDb
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   getHarnessName,
   loadConfig
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
@@ -19,7 +19,7 @@ import {
   ensureDirSync,
   sanitizeIdForFilename,
   tokenGoatHome
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   displaySafeText
 } from "./token-goat-chunk-ERTXEKB6.mjs";

package/dist/{token-goat-chunk-GMXBQS6O.mjs → token-goat-chunk-2M33Q3O4.mjs}

@@ -4,7 +4,7 @@ import {
   canRunWrappedShell,
   clipToDeliveryCap,
   deliveredOutputBytes
-} from "./token-goat-chunk-UXHDBVUR.mjs";
+} from "./token-goat-chunk-GLOM5W5C.mjs";
 import {
   DEFAULT_RECONCILE_BUDGET_MS,
   HOOK_EVENTS,
@@ -17,7 +17,7 @@ import {
   readStdinJson,
   reconcileProject,
   storeWebOutput
-} from "./token-goat-chunk-UMXD2M7O.mjs";
+} from "./token-goat-chunk-HRUGS6CO.mjs";
 import {
   BODY_FIRST_TOOL_RESPONSE_KEYS,
   GENERIC_SERVED_OUTPUT_KEY,
@@ -144,7 +144,7 @@ import {
   wasFileReadThisSession,
   wasHintShown,
   withPreservedBlocks
-} from "./token-goat-chunk-XOHTFRDH.mjs";
+} from "./token-goat-chunk-PKNOHVWP.mjs";
 import {
   BASH_OUTPUT_SUBDIR,
   commandHash,
@@ -167,26 +167,26 @@ import {
   splitOwnTrailingNotices,
   storeBashOutput,
   summarizeOutputDelta
-} from "./token-goat-chunk-5USHO7B6.mjs";
+} from "./token-goat-chunk-C26ZBGBC.mjs";
 import {
   recordStat,
   redactSecrets,
   savedTokensFromBytes,
   storeBlob,
   stripAnsiEscapes
-} from "./token-goat-chunk-DMQ32ZSR.mjs";
+} from "./token-goat-chunk-26YUO7MP.mjs";
 import {
   extractMarkdownHeadings,
   formatHeadingTreeParts
-} from "./token-goat-chunk-BFNTLGVA.mjs";
+} from "./token-goat-chunk-73GXYYZR.mjs";
 import {
   countSymbols
-} from "./token-goat-chunk-63QWJ6UM.mjs";
+} from "./token-goat-chunk-BK3RPPTK.mjs";
 import {
   detectLanguage,
   getDb,
   languageHasFlag
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   detectHarness,
   envBool,
@@ -196,7 +196,7 @@ import {
   isUnderSystemTemp,
   loadConfig,
   shortFingerprint
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   ENV_KEYS,
   IDENTICAL_READ_MIN_BODY_BYTES,
@@ -207,6 +207,7 @@ import {
   countNoun,
   dataDir,
   ensureDirSync,
+  escapeRegExp,
   escapesOntoNetworkThroughLinks,
   extractErrorMessage,
   foldPath,
@@ -215,7 +216,7 @@ import {
   isInsideRoot,
   runGit,
   toKB
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   UNTRUSTED_TOOL_TAG,
   displaySafePath,
@@ -945,7 +946,7 @@ init_define_import_meta_env();
 var TRACKED_SKILL = "token-goat";
 var MAX_COMMANDS_SHOWN = 8;
 async function currentCommandNames() {
-  const { buildProgram } = await import("./token-goat-chunk-QMZMHQRR.mjs");
+  const { buildProgram } = await import("./token-goat-chunk-G75WIVFM.mjs");
   return flattenCommandNames(buildCommandManifest(buildProgram()));
 }
 async function recordSkillVersionSnapshot(sessionId, skillName) {
@@ -1234,8 +1235,10 @@ function reconcileNote(cwd, indexed) {
     const budgetMs = envInt(ENV_KEYS.RECONCILE_BUDGET_MS, DEFAULT_RECONCILE_BUDGET_MS, 0, 6e4);
     const result = reconcileProject({ cwd, budgetMs });
     if (isReconcileClean(result) && !result.budgetExhausted) return null;
+    const upgraded = result.parserStale + result.embedStale;
+    const edited = result.changed.length - upgraded;
     const parts = [];
-    if (result.changed.length > 0) parts.push(`${result.changed.length} changed`);
+    if (edited > 0) parts.push(`${edited} changed`);
     if (result.added.length > 0) parts.push(`${result.added.length} new`);
     if (result.removed.length > 0) parts.push(`${result.removed.length} removed`);
     const breakdown = parts.length > 1 ? ` (${parts.join(", ")})` : "";
@@ -1244,7 +1247,11 @@ function reconcileNote(cwd, indexed) {
     if (total === 0) {
       return `token-goat: index drift check${truncated} found nothing in the part it had time to scan. Symbol lookups may be briefly stale.`;
     }
-    return `token-goat: reindexing ${countNoun(total, "file")} that changed outside this session${breakdown}${truncated}. Symbol lookups may be briefly stale.`;
+    const drifted = total - upgraded;
+    const clauses = [];
+    if (drifted > 0) clauses.push(`${countNoun(drifted, "file")} that changed outside this session${breakdown}`);
+    if (upgraded > 0) clauses.push(`${countNoun(upgraded, "file")} unchanged on disk but indexed by an older version of token-goat`);
+    return `token-goat: reindexing ${clauses.join(" and ")}${truncated}. Symbol lookups may be briefly stale.`;
   } catch {
     return null;
   }
@@ -1773,11 +1780,11 @@ function toRegExp(r, i) {
     if (r.str.length === 0) {
       throw new Error(`Rule #${i} ("${r.name}") has empty "str" property, which is not allowed.`);
     }
-    return new RegExp(escapeRegExp(r.str), "y");
+    return new RegExp(escapeRegExp2(r.str), "y");
   }
-  return new RegExp(escapeRegExp(r.name), "y");
+  return new RegExp(escapeRegExp2(r.name), "y");
 }
-function escapeRegExp(str) {
+function escapeRegExp2(str) {
   return str.replace(/[-[\]{}()*+!<=:?./\\^$|#\s,]/g, "\\$&");
 }
 function toSticky(re) {
@@ -7705,10 +7712,7 @@ function splitShellSegments(cmd) {
 }
 function isTempPath(fp) {
   const norm = fp.replace(/\\/g, "/");
-  return /^\/tmp\//i.test(norm) || /\/var\/folders\//i.test(norm) || // Anchored to a local drive root on purpose. Unanchored, this clause said yes to
-  // `//host/share/AppData/Local/Temp/x.md`, and the caller's answer to yes is to stat the path --
-  // which on Windows opens an SMB session to whatever host a command named. A temp directory is
-  // somewhere on a local volume; nothing that starts with two separators is one.
+  return /^\/tmp\//i.test(norm) || /\/var\/folders\//i.test(norm) || // Anchored to a local drive root on purpose. Unanchored, this clause said yes to `//host/share/AppData/Local/Temp/x.md`, and the caller's answer to yes is to stat the path -- which on Windows opens an SMB session to whatever host a command named. A temp directory is somewhere on a local volume; nothing that starts with two separators is one.
   /^[a-z]:\/(?:[^/]+\/)*AppData\/Local\/Temp\//i.test(norm) || norm.startsWith("/c/Users/") && norm.includes("/AppData/Local/Temp/") || isUnderSystemTemp(fp);
 }
 function isOrchestratorStateFile(filePath) {
@@ -8256,6 +8260,7 @@ function extractNodeFileRead(cmd) {
     const filePath = readSync2[1];
     if (isOrchestratorStateFile(filePath)) return null;
     if (isTempPath(filePath)) return null;
+    if (new RegExp(`(?:writeFileSync|appendFileSync)\\(\\s*['"]${escapeRegExp(filePath)}['"]`).test(cmd)) return null;
     const { isDoc, isConfig, isSql } = classifyDocConfig(filePath);
     return { filePath, isDoc, isConfig, isSql };
   }
@@ -8521,10 +8526,7 @@ var CURL_VALUE_FLAGS = /* @__PURE__ */ new Set([
   "--range",
   "-r",
   "--interface",
-  // Options whose own value is a URL or a host. Leaving these out was the same defect as reading
-  // the first URL in the string: `curl --doh-url https://doh/ -o f https://target` answered with
-  // the DoH resolver rather than the file being fetched. `--url-query` belongs here too -- it
-  // appends query data to the request, it does not name the request target.
+  // Options whose own value is a URL or a host. Leaving these out was the same defect as reading the first URL in the string: `curl --doh-url https://doh/ -o f https://target` answered with the DoH resolver rather than the file being fetched. `--url-query` belongs here too -- it appends query data to the request, it does not name the request target.
   "--url-query",
   "--doh-url",
   "--preproxy",
@@ -9988,7 +9990,8 @@ function recordBashFileReadsForSessionCache(cmd, cwd) {
 }
 async function maybeEmitLargeUncompressedHint(cmd, output, exitCode, cwd, isUnwrapped, event, ansiResult) {
   const outputBytes = Buffer.byteLength(output, "utf-8");
-  if (outputBytes < 4096 || process.env["TOKEN_GOAT_BASH_COMPRESS"] === "0" || exitCode !== null && exitCode !== 0 || event.raw["_tg_harness"] !== "vscode" && (isCompressibleSingleCommand(cmd) || !isUnwrapped)) {
+  if (outputBytes < 4096 || process.env["TOKEN_GOAT_BASH_COMPRESS"] === "0" || exitCode !== null && exitCode !== 0 || // token-goat's own output is already the narrow form; telling the model to compress it is noise.
+  /^\s*token-goat\s/.test(cmd) || event.raw["_tg_harness"] !== "vscode" && (isCompressibleSingleCommand(cmd) || !isUnwrapped)) {
     return null;
   }
   const key = `bash-uncompressed-4k:${event.sessionId ?? ""}:${shortFingerprint(cmd)}`;
@@ -9997,7 +10000,8 @@ async function maybeEmitLargeUncompressedHint(cmd, output, exitCode, cwd, isUnwr
   recordStat("session_hint", 0, 0);
   const id = await storeBashOutput(cmd, output, exitCode ?? 0, cwd);
   const kb = Math.round(outputBytes / 1024);
-  const msg = `[tg] Output was ${kb}KB uncompressed. For large tool outputs, run with 'token-goat compress -c "${displaySafeText(cmd)}"' or inspect via 'token-goat bash-output ${id}'.`;
+  const compressable = !/["`$\r\n]/.test(cmd);
+  const msg = `[tg] Output was ${kb}KB uncompressed; \`token-goat bash-output ${id}\` recalls it` + (compressable ? `, and \`token-goat compress -c "${displaySafeText(cmd)}"\` compresses the next run.` : ".");
   if (ansiResult !== null && ansiResult.hookType === "rewriteOutput") {
     return emitRewrite(msg + "\n" + fenceUntrusted(ansiResult.updatedOutput, UNTRUSTED_TOOL_TAG), "large uncompressed output hint", void 0, "counted-elsewhere");
   }

package/dist/{token-goat-chunk-H3DXI6VD.mjs → token-goat-chunk-2VASS5VR.mjs}

@@ -13,7 +13,7 @@ import {
   foldPath,
   projectConfigPath,
   runGit
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   normalizeDarwinSystemAlias
 } from "./token-goat-chunk-ERTXEKB6.mjs";

package/dist/{token-goat-chunk-OCI25AXY.mjs → token-goat-chunk-2XA5ZW4T.mjs}

@@ -6,11 +6,11 @@ import {
   pptxOutline,
   pptxSlideText,
   pptxTextGrep
-} from "./token-goat-chunk-2IEIBVVD.mjs";
-import "./token-goat-chunk-MA5BZ2KI.mjs";
+} from "./token-goat-chunk-W2GUUQAQ.mjs";
+import "./token-goat-chunk-66224KCZ.mjs";
 import "./token-goat-chunk-XTQAOTSO.mjs";
 import "./token-goat-chunk-AH6QILZM.mjs";
-import "./token-goat-chunk-3H6FQT62.mjs";
+import "./token-goat-chunk-UBZCON6N.mjs";
 import "./token-goat-chunk-ERTXEKB6.mjs";
 import "./token-goat-chunk-Y4AFKTHK.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";

package/dist/{token-goat-chunk-4DC6DDIB.mjs → token-goat-chunk-5WB7GDH4.mjs}

@@ -20,17 +20,17 @@ import {
   setOcrTimeoutForTesting,
   setTesseractEntryForTesting,
   verifyOcrLangCache
-} from "./token-goat-chunk-EJCY6KHO.mjs";
-import "./token-goat-chunk-DMQ32ZSR.mjs";
-import "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-CICJFVIH.mjs";
+import "./token-goat-chunk-26YUO7MP.mjs";
+import "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   DEFAULT_OCR_LANG,
   isSupportedOcrLang,
   resolveOcrLangs
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import "./token-goat-chunk-EEIDFMEM.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-3H6FQT62.mjs";
+import "./token-goat-chunk-UBZCON6N.mjs";
 import "./token-goat-chunk-ERTXEKB6.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";
 import "./token-goat-chunk-A37V4PBF.mjs";

package/dist/{token-goat-chunk-MA5BZ2KI.mjs → token-goat-chunk-66224KCZ.mjs}

@@ -12,7 +12,7 @@ import {
 } from "./token-goat-chunk-AH6QILZM.mjs";
 import {
   pushAll
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   DocumentRefusedError,
   MAX_DOCUMENT_WORK_MILLIS

package/dist/{token-goat-chunk-BFNTLGVA.mjs → token-goat-chunk-73GXYYZR.mjs}

@@ -4,7 +4,7 @@ import {
   pathEqClause,
   projectScopeClause,
   querySymbols
-} from "./token-goat-chunk-63QWJ6UM.mjs";
+} from "./token-goat-chunk-BK3RPPTK.mjs";
 import {
   TREE_SITTER_LANGUAGES,
   _detectOpenQuote,
@@ -21,11 +21,11 @@ import {
   stripJsComments,
   stripStringLiterals,
   stripXmlComments
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   fingerprintContent,
   loadConfig
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
@@ -39,7 +39,7 @@ import {
   foldPath,
   globalDbPath,
   isCaseInsensitiveFs
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   displaySafeText,
   normalizePath
@@ -74,11 +74,11 @@ async function extractEmbeddableDocumentText(filePath) {
       return text;
     }
     case ".docx":
-      return await (await import("./token-goat-chunk-VVIYEFBI.mjs")).docxText(filePath);
+      return await (await import("./token-goat-chunk-EKGVCAES.mjs")).docxText(filePath);
     case ".pptx":
-      return await (await import("./token-goat-chunk-OCI25AXY.mjs")).pptxAllSlidesText(filePath, true);
+      return await (await import("./token-goat-chunk-2XA5ZW4T.mjs")).pptxAllSlidesText(filePath, true);
     case ".xlsx":
-      return await (await import("./token-goat-chunk-ZEHFYJ7Z.mjs")).allSheetsHeadText(filePath, XLSX_SHEET_ROW_CAP);
+      return await (await import("./token-goat-chunk-RFFUCQK7.mjs")).allSheetsHeadText(filePath, XLSX_SHEET_ROW_CAP);
     default:
       return null;
   }
@@ -1413,7 +1413,7 @@ function _pathPriorityPenalty(filePath) {
 
 // src/parser_fingerprint.ts
 init_define_import_meta_env();
-var PARSER_FINGERPRINT = "e70e91822f151d92";
+var PARSER_FINGERPRINT = "0d80572d3abdfb19";
 
 // src/parser.ts
 init_define_import_meta_env();
@@ -1996,6 +1996,28 @@ function extractTsJsSymbols(root, filePath, lines2) {
         out.push(makeSymbol(filePath, fieldName.text, "method", node, lines2, "c"));
       }
     }
+    if (node.type === "method_definition" && node.parent?.type === "object") {
+      const name = nodeName(node);
+      if (name !== null && name !== "") {
+        out.push(makeSymbol(filePath, name, "method", node, lines2, "c"));
+      }
+    }
+    if (node.type === "pair" && node.parent?.type === "object") {
+      const key = node.childForFieldName("key");
+      const value = node.childForFieldName("value");
+      if (key !== null && value !== null) {
+        const keyName = key.type === "identifier" || key.type === "property_identifier" || key.type === "string" ? key.text.replace(/^['"]|['"]$/g, "") : null;
+        if (keyName !== null && keyName !== "") {
+          const isFn = value.type === "arrow_function" || value.type === "function_expression" || value.type === "function";
+          const isObjectOrArray = value.type === "object" || value.type === "array";
+          if (isFn) {
+            out.push(makeSymbol(filePath, keyName, "method", node, lines2, "c"));
+          } else if (isObjectOrArray && node.endPosition.row - node.startPosition.row >= 1) {
+            out.push(makeSymbol(filePath, keyName, "config", node, lines2, "c"));
+          }
+        }
+      }
+    }
     const childInside = insideFunction || TSJS_FN_SCOPE_TYPES.has(node.type);
     for (const child of node.namedChildren) {
       visit(child, childInside);
@@ -3672,7 +3694,7 @@ function parseSourceSymbolsTreeSitterOnly(content, filePath, language) {
 var REGEX_ADAPTERS_SLOT = /* @__PURE__ */ Symbol.for("token-goat.regex-adapters");
 var adapterSlot = globalThis;
 async function loadRegexExtractors() {
-  adapterSlot[REGEX_ADAPTERS_SLOT] ??= await import("./token-goat-chunk-MIL62GMN.mjs");
+  adapterSlot[REGEX_ADAPTERS_SLOT] ??= await import("./token-goat-chunk-GPCCYQSS.mjs");
 }
 function regexAdapters() {
   const loaded = adapterSlot[REGEX_ADAPTERS_SLOT];

package/dist/{token-goat-chunk-ULA4WCED.mjs → token-goat-chunk-7EGKXBWT.mjs}

@@ -3,7 +3,7 @@ const require = __cjsRequire(import.meta.url);
 import {
   deliveredOutputBytes,
   wrappedShell
-} from "./token-goat-chunk-UXHDBVUR.mjs";
+} from "./token-goat-chunk-GLOM5W5C.mjs";
 import {
   ToolFilter,
   capTokens,
@@ -14,18 +14,18 @@ import {
   selectFilter,
   shlexSplit,
   storeBashOutputSync
-} from "./token-goat-chunk-5USHO7B6.mjs";
+} from "./token-goat-chunk-C26ZBGBC.mjs";
 import {
   recordStat
-} from "./token-goat-chunk-DMQ32ZSR.mjs";
-import "./token-goat-chunk-63QWJ6UM.mjs";
-import "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-26YUO7MP.mjs";
+import "./token-goat-chunk-BK3RPPTK.mjs";
+import "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   loadConfig
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import "./token-goat-chunk-EEIDFMEM.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-3H6FQT62.mjs";
+import "./token-goat-chunk-UBZCON6N.mjs";
 import "./token-goat-chunk-ERTXEKB6.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";
 import {

package/dist/{token-goat-chunk-Z5VPAXTC.mjs → token-goat-chunk-7VQMOBPQ.mjs}

@@ -56,6 +56,7 @@ import {
   runJsonOutline,
   runJsonQuery,
   runListSections,
+  runLocate,
   runLog,
   runNoteGet,
   runNoteList,
@@ -90,7 +91,7 @@ import {
   symbolNamesInFile,
   upsertNote,
   warnIfFilesStale
-} from "./token-goat-chunk-2PCFAQAS.mjs";
+} from "./token-goat-chunk-IDHWKNKZ.mjs";
 import {
   DEFAULT_RECONCILE_BUDGET_MS,
   HOOK_EVENTS,
@@ -107,7 +108,7 @@ import {
   readStdinJson,
   runReconcile,
   storeWebOutput
-} from "./token-goat-chunk-UMXD2M7O.mjs";
+} from "./token-goat-chunk-HRUGS6CO.mjs";
 import {
   AGENT_SALT_MARKER,
   CONTEXT_AUTOCOMPACT_TOKENS,
@@ -243,7 +244,7 @@ import {
   visualStudioUserMcpPath,
   walkProject,
   writeCompact
-} from "./token-goat-chunk-XOHTFRDH.mjs";
+} from "./token-goat-chunk-PKNOHVWP.mjs";
 import {
   BASH_OUTPUT_SUBDIR,
   CompressedOutput,
@@ -261,7 +262,7 @@ import {
   listRecentRecall,
   normalizeCommandForCacheKey,
   searchRecall
-} from "./token-goat-chunk-5USHO7B6.mjs";
+} from "./token-goat-chunk-C26ZBGBC.mjs";
 import {
   C,
   DEFAULT_MAX_AGE_MS,
@@ -283,19 +284,19 @@ import {
   savedTokensFromBytes,
   stripAnsi,
   summarize
-} from "./token-goat-chunk-DMQ32ZSR.mjs";
+} from "./token-goat-chunk-26YUO7MP.mjs";
 import {
   docxOutline,
   docxTables,
   docxText,
   formatDocxTables
-} from "./token-goat-chunk-NQZCSVN2.mjs";
+} from "./token-goat-chunk-CPHVXKNU.mjs";
 import {
   pptxNotesText,
   pptxOutline,
   pptxSlideText,
   pptxTextGrep
-} from "./token-goat-chunk-2IEIBVVD.mjs";
+} from "./token-goat-chunk-W2GUUQAQ.mjs";
 import {
   formatXlsxColumns,
   formatXlsxRange,
@@ -304,11 +305,11 @@ import {
   querySheet,
   rangeSheet,
   xlsxColumns
-} from "./token-goat-chunk-NAMH252H.mjs";
+} from "./token-goat-chunk-THBLW56G.mjs";
 import {
   formatCsvTable,
   parseWhereSpecs
-} from "./token-goat-chunk-GIMGT34T.mjs";
+} from "./token-goat-chunk-KZPO4DWC.mjs";
 import {
   PARSER_FINGERPRINT,
   embeddingBackendLoadError,
@@ -331,11 +332,11 @@ import {
   readSection,
   treeSitterCoreAvailable,
   treeSitterCoreLoadError
-} from "./token-goat-chunk-BFNTLGVA.mjs";
+} from "./token-goat-chunk-73GXYYZR.mjs";
 import {
   getFileEntry,
   querySymbols
-} from "./token-goat-chunk-63QWJ6UM.mjs";
+} from "./token-goat-chunk-BK3RPPTK.mjs";
 import {
   TREE_SITTER_LANGUAGES,
   detectLanguage,
@@ -346,7 +347,7 @@ import {
   matchGroovySlashy,
   nonTreeSitterLanguageCount,
   redactIfDotenv
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   CONFIG_KEY_ENV_OVERRIDES,
   PROJECT_LOCKED_KEYS,
@@ -375,7 +376,7 @@ import {
   stringify,
   validateEnumField,
   validateNumericField
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   ENV_KEYS,
   LOCK_WAIT_MS_HARDENED,
@@ -435,7 +436,7 @@ import {
   withRetryOnLock,
   writeIfDifferent,
   writeJsonSettings
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   UNTRUSTED_FILE_TAG,
   UNTRUSTED_TOOL_TAG,
@@ -8038,7 +8039,7 @@ async function runDoctorAndExit(opts) {
     }
   }
   try {
-    const { checkUpdateStatus } = await import("./token-goat-chunk-M2R4UQ3B.mjs");
+    const { checkUpdateStatus } = await import("./token-goat-chunk-RB24DBBS.mjs");
     const update = await checkUpdateStatus(1500);
     if (update.updateAvailable && update.latest) {
       console.log(`
@@ -15307,6 +15308,16 @@ function registerAnalysisCommands(program2, guard) {
       })
     )
   );
+  program2.command("locate <spec>").description("locate symbol or landmark with exact line spans (supports name or file::name, with fuzzy fallback)").option("-j, --json", "output as JSON").option("-l, --limit <n>", "max results (default: 25)").option("-f, --file <path>", "restrict search to a specific file").action(
+    (spec, opts) => runExit(
+      () => runLocate({
+        spec,
+        ...opts.file !== void 0 ? { file: opts.file } : {},
+        ...opts.json === true ? { json: true } : {},
+        ...opts.limit !== void 0 ? { limit: requireNonNegativeInt("--limit", opts.limit) } : {}
+      })
+    )
+  );
   program2.command("grep <pattern> [paths...]").description("regex search over files, caching nothing (session-aware grep)").option("-j, --json", "output as JSON").option("--max-lines <n>", "max matching lines to print").option("--no-recursive", "do not descend into subdirectories").option("-C, --context <n>", "lines of context to show before and after each match").option("--symbol", "annotate each hit with its enclosing symbol (name and kind)").action(
     (pattern, paths, opts) => runExit(
       () => runGrep({
@@ -20066,7 +20077,7 @@ async function cmdMcpServe() {
   let StdioServerTransport;
   try {
     ;
-    ({ createMcpServer } = await import("./token-goat-chunk-NOBZV7PM.mjs"));
+    ({ createMcpServer } = await import("./token-goat-chunk-YFGEUIEO.mjs"));
     ({ StdioServerTransport } = await import("./token-goat-chunk-EVC4TOLE.mjs"));
   } catch (err2) {
     process.stderr.write(
@@ -20091,7 +20102,7 @@ async function cmdHook(event, opts) {
   if (typeof opts.harness === "string" && opts.harness.length > 0) {
     process.env[ENV_KEYS.HARNESS_OVERRIDE] = opts.harness;
   }
-  const { relay } = await import("./token-goat-chunk-LJL6FGDS.mjs");
+  const { relay } = await import("./token-goat-chunk-CKIJWTRQ.mjs");
   await relay(event);
 }
 function projectHooksCommitNote(pathFiles, hooksConfigPath) {
@@ -20128,7 +20139,7 @@ async function cmdInstall(opts) {
   if (opts.project === true && opts.user === true) {
     throw new Error("install takes either -p/--project or --user, not both.");
   }
-  await import("./token-goat-chunk-LJL6FGDS.mjs");
+  await import("./token-goat-chunk-CKIJWTRQ.mjs");
   const scope = opts.project === true ? "project" : "user";
   if (wantsClaudeCodeBase(opts)) {
     const result = installHooks(scope);
@@ -20718,7 +20729,7 @@ async function cmdCompress(commandArgs, opts = {}) {
       process.exitCode = 1;
       return;
     }
-    const bashRunner = await import("./token-goat-chunk-ULA4WCED.mjs");
+    const bashRunner = await import("./token-goat-chunk-7EGKXBWT.mjs");
     if (opts.compress === false) {
       process.exitCode = bashRunner.runRaw(command, parseTimeout(opts.timeout, bashRunner.DEFAULT_TIMEOUT_SECONDS));
       return;
@@ -20968,7 +20979,7 @@ function buildProgram() {
   program2.command("compress [command...]").alias("bash").alias("run").description("run a shell command (under a POSIX shell / bash) and emit a compressed view of its output").allowUnknownOption(true).option("-c, --cmd <command>", "the shell command to run, as one string (use / for paths across platforms)").option("--cmd-b64 <payload>", "the shell command as a base64-encoded string (preserves quotes, backslashes, and symbols across platforms)").option("-f, --filter <name>", "filter name (auto-detected from the command when omitted)").option("--timeout <seconds>", "wall-clock timeout in seconds (0 = built-in default)").option("--no-compress", "stream output raw without compression (debug the wrapper)").option("--profile <name>", "compression profile: aggressive | balanced | minimal").option("--max-tokens <n>", "post-compress token cap (0 = no cap)").option("-q, --quiet-success", "on exit code 0, emit only [tg: ok] summary and store full output for recall via bash-output").option("--native", "use native platform shell (e.g. cmd.exe on Windows) instead of bash, preserving Windows path backslashes").action(cmdCompress);
   program2.command("upgrade").alias("update").description("check for updates and upgrade token-goat to the latest version").option("--check", "check whether an update is available without installing").option("-j, --json", "emit version check status as JSON").action(
     (opts) => guard(async () => {
-      const { cmdUpgrade } = await import("./token-goat-chunk-M2R4UQ3B.mjs");
+      const { cmdUpgrade } = await import("./token-goat-chunk-RB24DBBS.mjs");
       await cmdUpgrade(opts, () => cmdInstall({}));
     })()
   );

package/dist/{token-goat-chunk-63QWJ6UM.mjs → token-goat-chunk-BK3RPPTK.mjs}

@@ -2,12 +2,12 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   getDb
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   foldPath,
   globalDbPath,
   isCaseInsensitiveFs
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   normalizePath
 } from "./token-goat-chunk-ERTXEKB6.mjs";

package/dist/{token-goat-chunk-5USHO7B6.mjs → token-goat-chunk-C26ZBGBC.mjs}

@@ -9,24 +9,24 @@ import {
   savedTokensFromBytes,
   storeBlob,
   stripAnsiEscapes
-} from "./token-goat-chunk-DMQ32ZSR.mjs";
+} from "./token-goat-chunk-26YUO7MP.mjs";
 import {
   sanitizeFtsQuery
-} from "./token-goat-chunk-63QWJ6UM.mjs";
+} from "./token-goat-chunk-BK3RPPTK.mjs";
 import {
   getDb
-} from "./token-goat-chunk-R3X5TCPB.mjs";
+} from "./token-goat-chunk-MWSVUKVV.mjs";
 import {
   loadConfig,
   shortFingerprint
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
 import {
   globalDbPath,
   runGit
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   normalizePath,
   resolveIndexPath

package/dist/{token-goat-chunk-EJCY6KHO.mjs → token-goat-chunk-CICJFVIH.mjs}

@@ -5,11 +5,11 @@ import {
   isSupportedOcrLang,
   loadConfig,
   resolveOcrLangs
-} from "./token-goat-chunk-H3DXI6VD.mjs";
+} from "./token-goat-chunk-2VASS5VR.mjs";
 import {
   ensureDirSync,
   tokenGoatHome
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import {
   fenceUntrustedOcrText
 } from "./token-goat-chunk-ERTXEKB6.mjs";