token-goat 2.9.28 → 2.9.29

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

@@ -0,0 +1,295 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  serveOne,
+  swapEnv
+} from "./token-goat-chunk-S4VSXURL.mjs";
+import {
+  relayInProcess
+} from "./token-goat-chunk-QO3LXVVR.mjs";
+import "./token-goat-chunk-IVWI2OCK.mjs";
+import "./token-goat-chunk-DNRPXHYH.mjs";
+import "./token-goat-chunk-RTMVLHWX.mjs";
+import "./token-goat-chunk-L7H3U27L.mjs";
+import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-E4ZOJIZK.mjs";
+import "./token-goat-chunk-E5TK5DNO.mjs";
+import "./token-goat-chunk-ZER6EAXZ.mjs";
+import "./token-goat-chunk-44BM7DDQ.mjs";
+import "./token-goat-chunk-EUSDXRXU.mjs";
+import "./token-goat-chunk-G7IWXCFF.mjs";
+import "./token-goat-chunk-H5J3C56Q.mjs";
+import "./token-goat-chunk-TDUT2CL6.mjs";
+import "./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 "./token-goat-chunk-CIQ2FTY3.mjs";
+import {
+  PROTOCOL_VERSION,
+  SERVER_SLOTS,
+  bundleEntryFiles,
+  configStamp,
+  endpointFor,
+  ensureServerKey,
+  mac,
+  macMatches,
+  nonce,
+  readFrames,
+  removeMarker,
+  serverKeyPath,
+  touchMarker,
+  writeFrame
+} from "./token-goat-chunk-DPNLUJWB.mjs";
+import "./token-goat-chunk-3BTK54F3.mjs";
+import "./token-goat-chunk-VMFWNHGR.mjs";
+import "./token-goat-chunk-435UQTKD.mjs";
+import "./token-goat-chunk-7CPMDFGB.mjs";
+import {
+  hookServerEnabled
+} from "./token-goat-chunk-TGOXNAHW.mjs";
+import "./token-goat-chunk-XB5KKOCG.mjs";
+import {
+  clearPerRequestCaches
+} from "./token-goat-chunk-YZAAZU2S.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
+import "./token-goat-chunk-XYWPOSCN.mjs";
+import "./token-goat-chunk-TCQANXYC.mjs";
+import "./token-goat-chunk-NMTKNYGF.mjs";
+import {
+  VERSION,
+  configPath,
+  ensureDataDirPrivate
+} from "./token-goat-chunk-MELOKFDJ.mjs";
+import "./token-goat-chunk-Y4AFKTHK.mjs";
+import "./token-goat-chunk-JTKCQMQA.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/hook_server.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+import * as net from "node:net";
+import * as os from "node:os";
+var IDLE_EXIT_MS = { primary: 30 * 6e4, overflow: 3 * 6e4 };
+var KEY_CHECK_MS = 2e3;
+var HANDSHAKE_IDLE_MS = 1e4;
+function bundleStamp() {
+  return bundleEntryFiles().map((f) => {
+    try {
+      const st = fs.statSync(f);
+      return `${st.size}:${st.mtimeMs}`;
+    } catch {
+      return "-";
+    }
+  }).join("|");
+}
+var enabledMemo;
+function stillEnabled() {
+  const key = `${process.env["TOKEN_GOAT_HOOK_SERVER"] ?? ""}|${configPath()}|${configStamp()}`;
+  if (enabledMemo?.key !== key) enabledMemo = { key, enabled: hookServerEnabled() };
+  return enabledMemo.enabled;
+}
+function retirementReason(loadedStamp) {
+  if (bundleStamp() !== loadedStamp) return "bundle replaced";
+  if (!stillEnabled()) return "disabled";
+  return void 0;
+}
+async function handle(request, runCli, send) {
+  clearPerRequestCaches();
+  if (request.kind === "cli") {
+    const res = await serveOne({ id: 0, argv: request.argv, cwd: request.cwd, env: request.env }, runCli, clearPerRequestCaches);
+    return send({ ok: true, stdout: res.stdout, stderr: res.stderr, status: res.status });
+  }
+  const startedAt = performance.now();
+  const cwdBefore = process.cwd();
+  const restoreEnv = swapEnv(request.env);
+  const afterReply = [];
+  try {
+    process.chdir(request.cwd);
+    const payload = JSON.parse(request.input);
+    const stdout = await relayInProcess(request.event, payload, request.harnessWaitMs, { elapsedMs: () => request.elapsedMs + (performance.now() - startedAt), afterReply: (work) => afterReply.push(work) });
+    send({ ok: true, stdout });
+    for (const work of afterReply) work();
+  } finally {
+    restoreEnv();
+    try {
+      process.chdir(cwdBefore);
+    } catch {
+    }
+    clearPerRequestCaches();
+  }
+}
+function listen(server, endpoint) {
+  const tryListen = () => new Promise((resolve) => {
+    server.once("error", resolve);
+    server.listen({ path: endpoint, readableAll: false, writableAll: false }, () => {
+      server.removeListener("error", resolve);
+      resolve(void 0);
+    });
+  });
+  return tryListen().then(async (err) => {
+    if (err === void 0) return true;
+    if (err.code !== "EADDRINUSE" || process.platform === "win32") return false;
+    const alive = await new Promise((resolve) => {
+      const probe = net.connect(endpoint);
+      probe.once("connect", () => {
+        probe.destroy();
+        resolve(true);
+      });
+      probe.once("error", () => resolve(false));
+    });
+    if (alive) return false;
+    fs.rmSync(endpoint, { force: true });
+    return await tryListen() === void 0;
+  });
+}
+async function runHookServer(slot, runCli) {
+  if (!Number.isInteger(slot) || slot < 0 || slot >= SERVER_SLOTS) throw new Error(`--slot must be an integer from 0 to ${SERVER_SLOTS - 1}`);
+  if (!hookServerEnabled()) {
+    touchMarker("disabled", configStamp());
+    return;
+  }
+  ensureDataDirPrivate();
+  const key = ensureServerKey();
+  const keyPath = serverKeyPath();
+  const loadedStamp = bundleStamp();
+  const endpoint = endpointFor(slot);
+  process.chdir(os.tmpdir());
+  const status = { pid: process.pid, slot, version: VERSION, startedAt: Date.now(), lastUsedAt: Date.now(), served: 0, errors: 0 };
+  let busy = false;
+  let retiring = false;
+  let idleTimer;
+  const flushing = /* @__PURE__ */ new Set();
+  const awaitingRequest = /* @__PURE__ */ new Set();
+  const endWith = (socket, frame) => {
+    const flushed = new Promise((resolve) => {
+      socket.once("close", () => resolve());
+      writeFrame(socket, frame);
+      socket.end(() => resolve());
+    });
+    flushing.add(flushed);
+    void flushed.then(() => flushing.delete(flushed));
+  };
+  let socketIno;
+  const ownsEndpoint = () => {
+    if (socketIno === void 0) return true;
+    try {
+      return fs.statSync(endpoint, { bigint: true, throwIfNoEntry: false })?.ino === socketIno;
+    } catch {
+      return true;
+    }
+  };
+  const server = net.createServer((socket) => serveConnection(socket));
+  const exitOnceFlushed = () => void Promise.all(flushing).then(() => process.exit(0));
+  const stop = () => {
+    retiring = true;
+    if (idleTimer !== void 0) clearTimeout(idleTimer);
+    if (ownsEndpoint()) server.close();
+    for (const socket of awaitingRequest) endWith(socket, { t: "stale" });
+    awaitingRequest.clear();
+    if (!busy) exitOnceFlushed();
+  };
+  const armIdle = () => {
+    if (idleTimer !== void 0) clearTimeout(idleTimer);
+    idleTimer = setTimeout(stop, slot === 0 ? IDLE_EXIT_MS.primary : IDLE_EXIT_MS.overflow);
+  };
+  function serveConnection(socket) {
+    let nc = "";
+    let ns = "";
+    socket.setTimeout(HANDSHAKE_IDLE_MS, () => socket.destroy());
+    socket.on("error", () => socket.destroy());
+    socket.once("close", () => awaitingRequest.delete(socket));
+    const onMessage = (msg) => {
+      if (msg["t"] === "hello" && nc === "") {
+        if (msg["v"] !== PROTOCOL_VERSION || typeof msg["nc"] !== "string" || msg["nc"] === "") return void socket.destroy();
+        const reason = retiring ? "retiring" : retirementReason(loadedStamp);
+        if (reason !== void 0) {
+          if (reason === "disabled") touchMarker("disabled", configStamp());
+          if (reason === "bundle replaced") removeMarker(`spawn-${slot}`);
+          writeFrame(socket, { t: "stale" });
+          socket.end(() => {
+            if (!retiring) stop();
+          });
+          return;
+        }
+        if (busy && msg["ctl"] !== true) {
+          writeFrame(socket, { t: "busy" });
+          return void socket.end();
+        }
+        nc = msg["nc"];
+        ns = nonce();
+        writeFrame(socket, { t: "challenge", v: PROTOCOL_VERSION, ns, mac: mac(key, "S", nc, ns) });
+        awaitingRequest.add(socket);
+        return;
+      }
+      if (msg["t"] === "req" && ns !== "") {
+        const body = msg["body"];
+        if (typeof body !== "string" || !macMatches(mac(key, "C", nc, ns, body), msg["mac"])) return void socket.destroy();
+        if (!awaitingRequest.delete(socket)) return;
+        let request;
+        let parseError;
+        try {
+          request = JSON.parse(body);
+        } catch (e) {
+          parseError = e;
+        }
+        const kind = request?.kind;
+        if (kind === "status" || kind === "stop") {
+          const resBody = JSON.stringify({ ok: true, info: { ...status } });
+          endWith(socket, { t: "res", mac: mac(key, "R", nc, ns, resBody), body: resBody });
+          if (kind === "stop" && !retiring) stop();
+          return;
+        }
+        if (busy || retiring) {
+          writeFrame(socket, { t: retiring ? "stale" : "busy" });
+          return void socket.end();
+        }
+        busy = true;
+        socket.setTimeout(0);
+        let replied = false;
+        const reply = (res) => {
+          if (replied) return;
+          replied = true;
+          const resBody = JSON.stringify(res);
+          endWith(socket, { t: "res", mac: mac(key, "R", nc, ns, resBody), body: resBody });
+        };
+        void (async () => {
+          try {
+            if (request === void 0) throw parseError;
+            await handle(request, runCli, reply);
+            status.served++;
+          } catch (e) {
+            status.errors++;
+            reply({ ok: false, error: e instanceof Error ? e.message : String(e) });
+          }
+          busy = false;
+          status.lastUsedAt = Date.now();
+          if (retiring) stop();
+          else armIdle();
+        })();
+        return;
+      }
+      socket.destroy();
+    };
+    readFrames(socket, onMessage, () => void 0);
+  }
+  if (!await listen(server, endpoint)) return;
+  if (process.platform !== "win32") socketIno = fs.statSync(endpoint, { bigint: true }).ino;
+  removeMarker("failed");
+  setInterval(() => {
+    if (!fs.existsSync(keyPath) || !ownsEndpoint()) stop();
+  }, KEY_CHECK_MS).unref();
+  if (process.platform !== "win32") {
+    try {
+      fs.chmodSync(endpoint, 384);
+    } catch {
+    }
+  }
+  armIdle();
+}
+export {
+  runHookServer
+};

package/dist/{token-goat-chunk-66LODAUT.mjs → token-goat-chunk-PGTH2U4C.mjs}

@@ -10,7 +10,7 @@ import {
   stripMultilineStringSpan,
   stripNestedBlockCommentSpan,
   stripStringLiterals
-} from "./token-goat-chunk-M56BWPBN.mjs";
+} from "./token-goat-chunk-7CPMDFGB.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";

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

@@ -25,10 +25,11 @@ import {
   runSemantic,
   runSkeleton,
   runSymbol,
+  statThroughHandle,
   withPinnedReads
-} from "./token-goat-chunk-VWZKZPSR.mjs";
-import "./token-goat-chunk-4STDIGYC.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,59 +38,66 @@ import {
   getProjectIndexCounts,
   isWorkerRunning,
   mapLookupBytesSaved
-} from "./token-goat-chunk-6Z5ULNE5.mjs";
-import "./token-goat-chunk-IZXKVT4A.mjs";
-import "./token-goat-chunk-RJH64KQH.mjs";
-import "./token-goat-chunk-MMLMALWK.mjs";
-import "./token-goat-chunk-6CCQDAYY.mjs";
-import "./token-goat-chunk-GGLEE35R.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-MAMQPC43.mjs";
-import "./token-goat-chunk-HXNAC4ZF.mjs";
-import "./token-goat-chunk-BJBRGPBX.mjs";
-import "./token-goat-chunk-4JMWPWCS.mjs";
-import "./token-goat-chunk-4RN64ZND.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-MVSWBNMD.mjs";
-import "./token-goat-chunk-LKSXAMJB.mjs";
-import "./token-goat-chunk-YWSP6IU7.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-66LODAUT.mjs";
+import "./token-goat-chunk-PGTH2U4C.mjs";
 import {
   checkEmbeddingPreflight,
   embeddingsDepsAvailable
-} from "./token-goat-chunk-D5ICEPSB.mjs";
-import "./token-goat-chunk-HUDC5GS5.mjs";
+} from "./token-goat-chunk-VMFWNHGR.mjs";
+import "./token-goat-chunk-435UQTKD.mjs";
 import {
   getDb
-} from "./token-goat-chunk-M56BWPBN.mjs";
+} from "./token-goat-chunk-7CPMDFGB.mjs";
 import {
-  envStrList,
   loadConfig,
   resolveProjectRoot
-} from "./token-goat-chunk-CC2PYJM7.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-L45ZQRT7.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";
@@ -103,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",
@@ -221,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 {
@@ -330,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) {
@@ -349,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",
     {
@@ -396,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"),
@@ -461,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
@@ -495,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
@@ -525,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 }
@@ -558,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 }
     },
@@ -620,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
@@ -656,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 }
     },
@@ -695,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 }
     },
@@ -744,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 }
     },
@@ -851,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 }
     },
@@ -867,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-RSS3TLXU.mjs → token-goat-chunk-PYSUADX4.mjs}

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