token-goat 2.9.26 → 2.9.29

package/dist/{token-goat-chunk-5BQ7W7D7.mjs → token-goat-chunk-PKRWMHVP.mjs}

@@ -25,10 +25,11 @@ import {
   runSemantic,
   runSkeleton,
   runSymbol,
+  statThroughHandle,
   withPinnedReads
-} from "./token-goat-chunk-RH27ZSPF.mjs";
-import "./token-goat-chunk-5M3NRJD2.mjs";
-import "./token-goat-chunk-DA43OE7L.mjs";
+} from "./token-goat-chunk-NMBWLRHW.mjs";
+import "./token-goat-chunk-VZQEWRVH.mjs";
+import "./token-goat-chunk-PQ53BSCF.mjs";
 import {
   buildProjectMap,
   formatProjectMap,
@@ -37,54 +38,66 @@ import {
   getProjectIndexCounts,
   isWorkerRunning,
   mapLookupBytesSaved
-} from "./token-goat-chunk-MBDJR6HU.mjs";
-import "./token-goat-chunk-4GEDH2WU.mjs";
-import "./token-goat-chunk-VVROQBQJ.mjs";
-import "./token-goat-chunk-M6CVNHTW.mjs";
+} from "./token-goat-chunk-RTMVLHWX.mjs";
+import "./token-goat-chunk-L7H3U27L.mjs";
+import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-E5TK5DNO.mjs";
+import "./token-goat-chunk-ZER6EAXZ.mjs";
+import "./token-goat-chunk-EUSDXRXU.mjs";
+import "./token-goat-chunk-H5J3C56Q.mjs";
+import "./token-goat-chunk-TDUT2CL6.mjs";
 import {
   claudeConfigDir
-} from "./token-goat-chunk-G6EYO5CD.mjs";
-import "./token-goat-chunk-43JFN26X.mjs";
+} from "./token-goat-chunk-ONXH6NZ5.mjs";
+import "./token-goat-chunk-O6I2XU4P.mjs";
+import "./token-goat-chunk-D4ETHJD6.mjs";
+import "./token-goat-chunk-52NSDWYY.mjs";
+import "./token-goat-chunk-2WOUYWLM.mjs";
 import {
   recordStat,
   savedTokensFromBytes
-} from "./token-goat-chunk-D2X7XN5M.mjs";
-import "./token-goat-chunk-LKSXAMJB.mjs";
-import "./token-goat-chunk-L43RKNHA.mjs";
+} from "./token-goat-chunk-CIQ2FTY3.mjs";
+import "./token-goat-chunk-SE6E4BKJ.mjs";
+import "./token-goat-chunk-DNSPXQXQ.mjs";
 import "./token-goat-chunk-3BTK54F3.mjs";
 import "./token-goat-chunk-XTQAOTSO.mjs";
 import "./token-goat-chunk-AH6QILZM.mjs";
-import "./token-goat-chunk-LHUP4DXZ.mjs";
+import "./token-goat-chunk-PGTH2U4C.mjs";
 import {
   checkEmbeddingPreflight,
   embeddingsDepsAvailable
-} from "./token-goat-chunk-7EPYB34H.mjs";
-import "./token-goat-chunk-IKZLSRII.mjs";
+} from "./token-goat-chunk-VMFWNHGR.mjs";
+import "./token-goat-chunk-435UQTKD.mjs";
 import {
   getDb
-} from "./token-goat-chunk-7SXPJOSZ.mjs";
+} from "./token-goat-chunk-7CPMDFGB.mjs";
 import {
-  envStrList,
   loadConfig,
   resolveProjectRoot
-} from "./token-goat-chunk-LRIZ7K3F.mjs";
-import "./token-goat-chunk-EEIDFMEM.mjs";
-import "./token-goat-chunk-OSUFN2FV.mjs";
+} from "./token-goat-chunk-TGOXNAHW.mjs";
+import "./token-goat-chunk-XB5KKOCG.mjs";
+import "./token-goat-chunk-YZAAZU2S.mjs";
 import {
-  ENV_KEYS,
-  VERSION,
-  dataDir,
-  extractErrorMessage,
-  foldCaseForContainment,
-  globalDbPath
-} from "./token-goat-chunk-6E2IDLHF.mjs";
+  envStrList
+} from "./token-goat-chunk-IVE6U7KV.mjs";
+import {
+  extractErrorMessage
+} from "./token-goat-chunk-XYWPOSCN.mjs";
+import {
+  foldCaseForContainment
+} from "./token-goat-chunk-TCQANXYC.mjs";
 import {
   displaySafeJson,
   normalizePath
 } from "./token-goat-chunk-NMTKNYGF.mjs";
+import {
+  ENV_KEYS,
+  VERSION,
+  dataDir,
+  globalDbPath
+} from "./token-goat-chunk-MELOKFDJ.mjs";
 import "./token-goat-chunk-Y4AFKTHK.mjs";
-import "./token-goat-chunk-GMOUBOX4.mjs";
-import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-JTKCQMQA.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -98,6 +111,7 @@ var TOKEN_GOAT_RETRY_RE = /token-goat (\w[\w-]*) "([^"]+)"/g;
 var MCP_MAX_LIMIT = 1e3;
 var MCP_MAX_CONTEXT_LINES = 50;
 var MCP_MAX_OUTPUT_LINES = 1e4;
+var MCP_MAX_MIN_LINES = 1e5;
 var RETRY_PARAM_BY_COMMAND = {
   read: "spec",
   section: "spec",
@@ -216,6 +230,12 @@ function assertRootAllowed(resolvedRoot) {
 }
 var NO_CHECK_PINS = [];
 function identityOf(p) {
+  try {
+    return fileIdentity(statThroughHandle(p));
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT" || code === "ENOTDIR") return null;
+  }
   try {
     return fileIdentity(fs.statSync(p, { bigint: true }));
   } catch {
@@ -325,7 +345,7 @@ function mcpToolAllowlist() {
   return names.length === 0 ? null : new Set(names);
 }
 async function createMcpServer() {
-  const [{ McpServer }, { z }] = await Promise.all([import("./token-goat-chunk-XBESNWEX.mjs"), import("./token-goat-chunk-CHLHM42P.mjs")]);
+  const [{ McpServer }, { z }] = await Promise.all([import("./token-goat-chunk-6AK46ZT7.mjs"), import("./token-goat-chunk-CHLHM42P.mjs")]);
   const server = new McpServer({ name: "token-goat", version: VERSION });
   const allowlist = mcpToolAllowlist();
   if (allowlist !== null) {
@@ -344,10 +364,7 @@ async function createMcpServer() {
       }
     }, 0).unref();
   }
-  const makeProjectRootField = (verb) => z.string().optional().describe(
-    `absolute path to the workspace root to scope this ${verb} to; defaults to the MCP server process's cwd, which is not always the actual workspace root for MCP clients -- pass this explicitly when it might differ`
-  );
-  const projectRootField = makeProjectRootField("lookup");
+  const projectRootField = z.string().optional().describe("absolute workspace root; defaults to the server's cwd, which may not be the workspace, so pass it when unsure");
   server.registerTool(
     "symbol",
     {
@@ -391,9 +408,9 @@ async function createMcpServer() {
   server.registerTool(
     "read",
     {
-      description: "Read one symbol's full body, given a spec of the form file::symbol, or a line range file@N-M / file@N, or a bare file path. Pass a comma-separated spec (file::a,b) to fetch several symbols' bodies from one file in a single call.",
+      description: "Read a symbol's full body (file::symbol), several from one file (file::a,b), a line range (file@N-M, file@N), or a file.",
       inputSchema: {
-        spec: z.string().describe("file::symbol, file@N-M, file@N, a bare file path, or comma-separated file::a,b for a merged multi-symbol view"),
+        spec: z.string().describe("file::symbol, file::a,b, file@N-M, file@N, or a file path"),
         json: z.boolean().optional().describe("output as JSON"),
         forceRefresh: z.boolean().optional().describe("reparse file from disk before querying (ignore stale index)"),
         stats: z.boolean().optional().describe("add per-symbol reference count and doc-coverage flag"),
@@ -456,7 +473,7 @@ async function createMcpServer() {
       inputSchema: {
         file: z.string().describe("file path"),
         json: z.boolean().optional().describe("output as JSON"),
-        minLines: z.number().int().optional().describe("only show symbols at least N lines long"),
+        minLines: z.number().int().nonnegative().max(MCP_MAX_MIN_LINES).optional().describe("only show symbols at least N lines long"),
         forceRefresh: z.boolean().optional().describe("reparse file from disk before querying (ignore stale index)"),
         stats: z.boolean().optional().describe("add per-symbol reference count and doc-coverage flag"),
         projectRoot: projectRootField
@@ -490,7 +507,7 @@ async function createMcpServer() {
       inputSchema: {
         file: z.string().describe("file path"),
         json: z.boolean().optional().describe("output as JSON"),
-        minLines: z.number().int().optional().describe("only show symbols at least N lines long"),
+        minLines: z.number().int().nonnegative().max(MCP_MAX_MIN_LINES).optional().describe("only show symbols at least N lines long"),
         forceRefresh: z.boolean().optional().describe("reparse file from disk before querying (ignore stale index)"),
         stats: z.boolean().optional().describe("add per-symbol reference count and doc-coverage flag"),
         projectRoot: projectRootField
@@ -520,16 +537,16 @@ async function createMcpServer() {
   server.registerTool(
     "semantic",
     {
-      description: "Semantic search over the indexed project (falls back to full-text search when no embedding index is available). Scoped to projectRoot if given, else the MCP server process's own cwd -- which may not be the actual workspace root for a client that launched the server from elsewhere, so pass projectRoot explicitly when in doubt.",
+      description: "Semantic search over the indexed project; falls back to full-text search without an embedding index.",
       inputSchema: {
         query: z.string().describe("natural-language search query"),
         limit: z.number().int().positive().max(MCP_MAX_LIMIT).optional().describe("max results (default: 20)"),
-        grep: z.string().optional().describe("filter to hits whose file path matches this regex (literal substring if it does not compile as regex); matched against the path as rendered, same convention as refs --grep"),
-        excludeTests: z.boolean().optional().describe("hide hits whose file is a test file (opt-in; default output is unchanged)"),
-        preflight: z.boolean().optional().describe("run semantic embedding preflight check and return status"),
-        warm: z.boolean().optional().describe("warm up the embedding model session in memory before query execution"),
+        grep: z.string().optional().describe("only hits whose file path matches this regex (a literal substring if it is not valid regex)"),
+        excludeTests: z.boolean().optional().describe("hide hits in test files"),
+        preflight: z.boolean().optional().describe("report whether embeddings are ready, instead of searching"),
+        warm: z.boolean().optional().describe("load the embedding model before the query"),
         json: z.boolean().optional().describe("output as JSON"),
-        projectRoot: makeProjectRootField("search")
+        projectRoot: projectRootField
       },
       // openWorldHint stays false although a first call on a machine with no cached model downloads one over the network: what this tool interacts with is the local index, and the download provisions the tool rather than being the tool reaching out. A client reading `true` here would take it as "this searches the internet", which is the wrong warning.
       annotations: { readOnlyHint: true, openWorldHint: false }
@@ -553,9 +570,9 @@ async function createMcpServer() {
   server.registerTool(
     "index_status",
     {
-      description: 'Report whether the index for a project can be trusted right now: whether it has ever been indexed at all, current file/symbol counts, dirty-reindex-queue depth, whether the background worker is alive, and whether embeddings are available (semantic silently degrades to full-text search without them). Call this after an unexpectedly empty result from another token-goat tool (symbol/read/semantic/refs/brief/...) to tell apart "no match" from "the index is not ready yet" -- an MCP-only client has no hook layer to warn about this on its own, so an empty tool result and a stale/unindexed project look identical without this check.',
+      description: 'Whether the project index can be trusted now: indexed at all, file and symbol counts, reindex queue depth, worker alive, and embeddings available (without them semantic falls back to full-text search). Call it when another token-goat tool returns nothing, to tell "no match" from "index not ready".',
       inputSchema: {
-        projectRoot: makeProjectRootField("check")
+        projectRoot: projectRootField
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
@@ -615,13 +632,13 @@ async function createMcpServer() {
   server.registerTool(
     "refs",
     {
-      description: "Find references to one or more symbols (spec: file::symbol, symbol, or comma-separated a,b,c / file::a,b for a merged multi-symbol view). For an unambiguous TypeScript symbol, automatically type-resolves candidates via the TypeScript compiler API to drop same-named-different-symbol false positives; falls back to name-based matching when that is not possible.",
+      description: "Find references to symbols. An unambiguous TypeScript symbol is type-resolved, dropping same-named symbols; anything else matches by name.",
       inputSchema: {
-        spec: z.string().describe("file::symbol, symbol, or comma-separated a,b,c / file::a,b for a merged multi-symbol view"),
+        spec: z.string().describe("file::symbol, symbol, a,b,c, or file::a,b"),
         callers: z.boolean().optional().describe("group references by their enclosing caller symbol"),
         limit: z.number().int().positive().max(MCP_MAX_LIMIT).optional().describe("max results"),
         top: z.number().int().positive().max(MCP_MAX_LIMIT).optional().describe(
-          "for a high-fanout symbol, group references by file (count only) and show only the top N files by reference count instead of a per-line dump"
+          "list only the top N files by reference count, instead of every reference"
         ),
         json: z.boolean().optional().describe("output as JSON"),
         projectRoot: projectRootField
@@ -651,15 +668,15 @@ async function createMcpServer() {
   server.registerTool(
     "brief",
     {
-      description: "One-shot symbol orientation: signature, location, token count, body, callers, and containing doc section, in a single call (spec: file::symbol; comma-separated file::a,b for a merged multi-symbol view; cross-file a.ts::x,b.ts::y is also supported -- unlike refs, a bare symbol name with no file is not accepted). Prefer this over separate read + refs calls when the goal is to understand a symbol, not just fetch its source: it folds the work of read (body) and refs --callers (call sites) into one result, at a fraction of the combined round-trip cost.",
+      description: "Understand a symbol in one call: signature, location, token count, body, callers and containing doc section. Prefer it to read plus refs. Spec file::symbol, file::a,b or a.ts::x,b.ts::y; a bare name without a file is not accepted.",
       inputSchema: {
-        spec: z.string().describe("file::symbol; comma-separated file::a,b for a merged multi-symbol view; cross-file a.ts::x,b.ts::y is also supported"),
+        spec: z.string().describe("file::symbol, file::a,b, or a.ts::x,b.ts::y"),
         limit: z.number().int().positive().max(MCP_MAX_LIMIT).optional().describe("max callers to show (default: 20)"),
         json: z.boolean().optional().describe("output as JSON"),
-        context: z.number().int().nonnegative().max(MCP_MAX_CONTEXT_LINES).optional().describe("lines of call-site source to show before and after each caller (default 0)"),
-        excludeTests: z.boolean().optional().describe("hide callers whose call site lives in a test file (opt-in; default output is unchanged)"),
-        grep: z.string().optional().describe("only show callers whose enclosing symbol name matches this regex (literal substring if it is not valid regex)"),
-        projectRoot: makeProjectRootField("orient")
+        context: z.number().int().nonnegative().max(MCP_MAX_CONTEXT_LINES).optional().describe("call-site lines to show around each caller (default 0)"),
+        excludeTests: z.boolean().optional().describe("hide callers in test files"),
+        grep: z.string().optional().describe("only callers whose enclosing symbol matches this regex (a literal substring if it is not valid regex)"),
+        projectRoot: projectRootField
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
@@ -690,7 +707,7 @@ async function createMcpServer() {
       description: "Project overview: file count, languages, headline symbols, and recently modified files.",
       inputSchema: {
         compact: z.boolean().optional().describe("compact, low-token summary"),
-        projectRoot: makeProjectRootField("overview")
+        projectRoot: projectRootField
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
@@ -739,7 +756,7 @@ async function createMcpServer() {
         recursive: z.boolean().optional().describe("descend into subdirectories (default: true)"),
         context: z.number().int().nonnegative().max(MCP_MAX_CONTEXT_LINES).optional().describe("lines of context to show before and after each match"),
         // runGrep takes no projectRoot of its own (its `path` array is its scope), so this field only names the root the confinement check is made against -- without it, a search rooted anywhere but the server process's cwd is refused.
-        projectRoot: makeProjectRootField("search")
+        projectRoot: projectRootField
       },
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
@@ -846,7 +863,7 @@ async function createMcpServer() {
       inputSchema: {
         name: z.string().regex(/^[A-Za-z0-9._-]{1,128}$/).describe("handoff name"),
         text: z.string().max(CONTENT_MAX_INPUT_CHARS).describe("handoff text"),
-        projectRoot: makeProjectRootField("scope")
+        projectRoot: projectRootField
       },
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -862,7 +879,7 @@ async function createMcpServer() {
       inputSchema: {
         name: z.string().regex(/^[A-Za-z0-9._-]{1,128}$/).describe("handoff name"),
         full: z.boolean().optional().describe("return full text instead of a compact payload"),
-        projectRoot: makeProjectRootField("scope")
+        projectRoot: projectRootField
       },
       // Reads like a read, and is not one: resolving compactly runs the handoff text back through compressText, which stores the compact payload so the recovery id it hands back can be redeemed. A measurement, not a reading of this code -- the guard hashes the store's bytes around every tool call, and this is the tool it caught.
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }

package/dist/{token-goat-chunk-DA43OE7L.mjs → token-goat-chunk-PQ53BSCF.mjs}

@@ -2,7 +2,7 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   Database
-} from "./token-goat-chunk-OSUFN2FV.mjs";
+} from "./token-goat-chunk-XB5KKOCG.mjs";
 import {
   displaySafeText
 } from "./token-goat-chunk-NMTKNYGF.mjs";

package/dist/{token-goat-chunk-STYRLQIW.mjs → token-goat-chunk-PYSUADX4.mjs}

@@ -3,7 +3,7 @@ const require = __cjsRequire(import.meta.url);
 import {
   queryCsv,
   quoteCsvCell
-} from "./token-goat-chunk-L43RKNHA.mjs";
+} from "./token-goat-chunk-DNSPXQXQ.mjs";
 import {
   NotAnOfficeDocumentError,
   assertOoxmlWithinDeadline,
@@ -12,7 +12,7 @@ import {
   ooxmlWorkDeadline,
   parseOoxmlPart,
   readOoxmlZip
-} from "./token-goat-chunk-RIB6XY2V.mjs";
+} from "./token-goat-chunk-UXSXQQIY.mjs";
 import {
   displaySafeText
 } from "./token-goat-chunk-NMTKNYGF.mjs";