token-goat 2.6.19 → 2.6.21

package/dist/token-goat-hook.mjs

@@ -49,7 +49,7 @@ var init_define_import_meta_env = __esm({
 import { createRequire } from "node:module";
 function resolveVersion() {
   if (true) {
-    return "2.6.19";
+    return "2.6.21";
   }
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");
@@ -286,6 +286,7 @@ const VALID_HOOK_EVENTS = new Set([
   'pre_compact',
   'user_prompt_submit',
   'subagent_stop',
+  'session_start',
 ])
 
 // Keep in sync with CLAUDE_CODE_EVENT_NAMES in src/hook_registry.ts -- the
@@ -300,6 +301,7 @@ const HOOK_EVENT_NAME_MAP = {
   pre_compact: 'PreCompact',
   user_prompt_submit: 'UserPromptSubmit',
   subagent_stop: 'SubagentStop',
+  session_start: 'SessionStart',
 }
 
 function stripTg(value) {
@@ -1368,8 +1370,8 @@ function normalizeDarwinSystemAlias(p) {
 }
 function resolveIndexPath(file2, base = process.cwd()) {
   const isWindowsAbsolute = (s) => /^[a-zA-Z]:[/\\]/.test(s);
-  const resolve20 = isWindowsAbsolute(file2) || isWindowsAbsolute(base) ? path2.win32.resolve : path2.resolve;
-  return normalizePath(resolve20(base, file2));
+  const resolve21 = isWindowsAbsolute(file2) || isWindowsAbsolute(base) ? path2.win32.resolve : path2.resolve;
+  return normalizePath(resolve21(base, file2));
 }
 function safeJoin(base, ...parts) {
   for (const part of parts) {
@@ -1896,6 +1898,43 @@ setInterval(tick, Number(ms))
   }
 });
 
+// src/bridges/guidance_block.ts
+function buildGuidanceBody(fallbackToolClause) {
+  return [
+    "## token-goat",
+    "",
+    "**Gate \u2014 before every file read, answer one question first: is there a token-goat command that returns just what I need?** If yes, run it. A read tool invoked without answering the gate is a violation, not an oversight. The gate is per file: batched or parallel reads do not exempt it.",
+    "",
+    `This gate decides *whether* to reach for a read tool at all. ${fallbackToolClause} only pick the *fallback* once token-goat has been ruled out for this read \u2014 they never authorize skipping the gate.`,
+    "",
+    "Exemptions (gate passes, read directly): the file is under ~200 lines and you need all of it; it was never indexed (new, untracked, or generated this turn); it is binary or an image; the target has no symbol handle (e.g. a literal mid-function).",
+    "",
+    "Failure shapes to catch yourself in, and the command that replaces each:",
+    '- grep/search with context flags to find a function body \u2192 `read "file::symbol"`',
+    '- paging one function with view/view_range \u2192 `read "file::symbol"`',
+    '- reading one heading of a large doc \u2192 `section "file::Heading"`',
+    "- searching for a symbol's callers \u2192 `refs file::symbol --callers`",
+    '- searching for a *concept* rather than a literal string \u2192 `semantic "description"`',
+    "- re-reading output you already captured \u2192 `bash-output`/`web-output` by ID",
+    "- `glob`/`ls **/*` to orient in an unfamiliar repo \u2192 `map --compact`",
+    "",
+    'Commands: `symbol NAME`, `read "file::symbol"`, `section "file::Heading"`, `semantic "description"`, `outline file`/`skeleton file`, `map --compact`, `refs file::symbol --callers`, `changed --symbol`, `config-get file KEY`, `bash-output`/`web-output`, `gdrive-sections <file-id>`.',
+    "",
+    "Sub-agent briefs must carry this gate verbatim: a sub-agent inherits none of this context and its reads spend the same token budget.",
+    "",
+    "`token-goat stats` \u2014 self-check. Flat counts during code work mean the gate is being skipped."
+  ].join("\n");
+}
+function buildGuidanceBlock(h) {
+  return [h.beginMarker, buildGuidanceBody(h.fallbackToolClause), h.endMarker].join("\n");
+}
+var init_guidance_block = __esm({
+  "src/bridges/guidance_block.ts"() {
+    "use strict";
+    init_define_import_meta_env();
+  }
+});
+
 // src/install.ts
 import * as fs2 from "node:fs";
 import * as os2 from "node:os";
@@ -2022,28 +2061,11 @@ function claudeMdPath() {
   return path4.join(os2.homedir(), ".claude", "CLAUDE.md");
 }
 function buildClaudeMdBlock() {
-  return [
-    CLAUDE_MD_BEGIN,
-    "## token-goat",
-    "",
-    "Prefer token-goat commands over reading whole files:",
-    "- `token-goat symbol NAME` -- find a function/class/type",
-    '- `token-goat read "file::symbol"` -- one function/method body',
-    '- `token-goat section "file::Heading"` -- one doc or config section',
-    '- `token-goat semantic "description"` -- find code by meaning',
-    "- `token-goat outline file` / `token-goat skeleton file` -- signatures without bodies",
-    "- `token-goat map --compact` -- project overview (low-token summary)",
-    "- `token-goat refs file::symbol --callers` -- find callers of a symbol",
-    "- `token-goat changed --symbol` -- symbols changed since a git ref",
-    "- `token-goat config-get file KEY` -- read one config value",
-    "- `token-goat bash-output` / `token-goat web-output` -- re-inspect cached output by ID",
-    "- `token-goat gdrive-sections <file-id>` -- outline a Google Doc by ID",
-    "",
-    "Use this before a full-file `Read` or wide `Grep`, and before opening a large image",
-    "(token-goat hooks shrink oversized images automatically). token-goat commands return",
-    "narrow slices, typically 85-97% smaller than the full file.",
-    CLAUDE_MD_END
-  ].join("\n");
+  return buildGuidanceBlock({
+    beginMarker: CLAUDE_MD_BEGIN,
+    endMarker: CLAUDE_MD_END,
+    fallbackToolClause: "Claude Code's own Read, Grep, and Glob preference rules"
+  });
 }
 function writeClaudeMdBlock(p) {
   return upsertDelimitedBlock(p, CLAUDE_MD_BEGIN, CLAUDE_MD_END, buildClaudeMdBlock());
@@ -2059,6 +2081,50 @@ function installClaudeMd() {
 function uninstallClaudeMd() {
   return stripClaudeMdBlock(claudeMdPath());
 }
+function findStrayClaudeMdBlocks(searchRoot) {
+  const root = searchRoot ?? path4.join(os2.homedir(), ".claude");
+  const canonical = path4.resolve(claudeMdPath());
+  const found = [];
+  if (!fs2.existsSync(root)) return found;
+  const SKIP_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".git"]);
+  const MAX_DEPTH = 6;
+  const hasRealBlock = (text) => {
+    let sawBegin = false;
+    for (const line of text.split(/\r?\n/)) {
+      const trimmed = line.trim();
+      if (trimmed === CLAUDE_MD_BEGIN) sawBegin = true;
+      else if (sawBegin && trimmed === CLAUDE_MD_END) return true;
+    }
+    return false;
+  };
+  const walk = (dir, depth) => {
+    if (depth > MAX_DEPTH) return;
+    let entries;
+    try {
+      entries = fs2.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = path4.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!SKIP_DIRS2.has(entry.name)) walk(full, depth + 1);
+        continue;
+      }
+      if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md")) continue;
+      if (path4.resolve(full) === canonical) continue;
+      let text;
+      try {
+        text = fs2.readFileSync(full, "utf8");
+      } catch {
+        continue;
+      }
+      if (hasRealBlock(text)) found.push(full);
+    }
+  };
+  walk(root, 0);
+  return found.sort();
+}
 function skillDir() {
   return path4.join(os2.homedir(), ".claude", "skills", "token-goat");
 }
@@ -2083,11 +2149,12 @@ function uninstallSkill() {
   fs2.rmSync(dir, { recursive: true, force: true });
   return true;
 }
-var HOOK_EVENT_MAP, COMMAND_MARKER, LEGACY_COMMAND_MARKERS, HOOK_MARKER_PATTERNS, CURRENT_MARKER_PATTERN, SettingsParseError, CLAUDE_MD_BEGIN, CLAUDE_MD_END, SKILL_MD_CONTENT;
+var HOOK_EVENT_MAP, COMMAND_MARKER, LEGACY_COMMAND_MARKERS, HOOK_MARKER_PATTERNS, CURRENT_MARKER_PATTERN, SettingsParseError, CLAUDE_MD_BEGIN, CLAUDE_MD_END, SKILL_MD_FRONTMATTER, SKILL_MD_CONTENT;
 var init_install = __esm({
   "src/install.ts"() {
     "use strict";
     init_define_import_meta_env();
+    init_guidance_block();
     init_paths();
     init_util2();
     HOOK_EVENT_MAP = [
@@ -2095,7 +2162,8 @@ var init_install = __esm({
       ["PostToolUse", "post_tool_use"],
       ["PreCompact", "pre_compact"],
       ["UserPromptSubmit", "user_prompt_submit"],
-      ["SubagentStop", "subagent_stop"]
+      ["SubagentStop", "subagent_stop"],
+      ["SessionStart", "session_start"]
     ];
     COMMAND_MARKER = "token-goat hook";
     LEGACY_COMMAND_MARKERS = ["tokenwise", "token_goat", "tg-hook", "token-goat-hook"];
@@ -2105,31 +2173,13 @@ var init_install = __esm({
     };
     CLAUDE_MD_BEGIN = "<!-- token-goat-begin -->";
     CLAUDE_MD_END = "<!-- token-goat-end -->";
-    SKILL_MD_CONTENT = `---
+    SKILL_MD_FRONTMATTER = `---
 name: token-goat
 description: Use before reading whole files or grepping wide. token-goat commands (symbol, read, section, semantic, outline, skeleton, map, refs, changed, config-get, bash-output, web-output, gdrive-sections) return narrow slices of code and docs at a fraction of the token cost.
----
+---`;
+    SKILL_MD_CONTENT = `${SKILL_MD_FRONTMATTER}
 
-# token-goat
-
-Prefer token-goat commands over reading whole files:
-- \`token-goat symbol NAME\` -- find a function/class/type
-- \`token-goat read "file::symbol"\` -- one function/method body
-- \`token-goat section "file::Heading"\` -- one doc or config section
-- \`token-goat semantic "description"\` -- find code by meaning
-- \`token-goat outline file\` / \`token-goat skeleton file\` -- signatures without bodies
-- \`token-goat map --compact\` -- project overview (low-token summary)
-- \`token-goat refs file::symbol --callers\` -- find callers of a symbol
-- \`token-goat changed --symbol\` -- symbols changed since a git ref
-- \`token-goat config-get file KEY\` -- read one config value
-- \`token-goat bash-output\` / \`token-goat web-output\` -- re-inspect cached output by ID
-- \`token-goat gdrive-sections <file-id>\` -- outline a Google Doc by ID
-
-Read is the right call when the file is under about 200 lines, was never indexed (new or
-untracked), or is an image (token-goat's hooks shrink oversized images automatically).
-
-Image shrinking and repeat-read hints run on their own via hooks -- you do not call those
-directly.
+${buildGuidanceBody("Claude Code's own Read, Grep, and Glob preference rules")}
 `;
   }
 });
@@ -2277,23 +2327,11 @@ function uninstallCodex() {
   return removedAny;
 }
 function buildAgentsBlock() {
-  return [
-    AGENTS_BEGIN,
-    "## token-goat",
-    "",
-    "Prefer token-goat commands over reading whole files:",
-    "- `token-goat symbol NAME` -- find a function/class/type",
-    '- `token-goat read "file::symbol"` -- one function/method body',
-    '- `token-goat section "file::Heading"` -- one doc or config section',
-    '- `token-goat semantic "description"` -- find code by meaning',
-    "- `token-goat outline file` / `token-goat skeleton file` -- signatures without bodies",
-    "",
-    "Use this before a full-file read via `shell` (cat/type), before previewing a diff with",
-    "`apply_patch`, and before a `view_image` on a large screenshot (token-goat hooks shrink",
-    "oversized images automatically). token-goat commands return narrow slices, typically",
-    "85-97% smaller than the full file.",
-    AGENTS_END
-  ].join("\n");
+  return buildGuidanceBlock({
+    beginMarker: AGENTS_BEGIN,
+    endMarker: AGENTS_END,
+    fallbackToolClause: "Codex's own `shell` (cat/type), `apply_patch` preview, and `view_image` preferences"
+  });
 }
 function writeAgentsBlock(p) {
   return upsertDelimitedBlock(p, AGENTS_BEGIN, AGENTS_END, buildAgentsBlock());
@@ -2310,6 +2348,7 @@ var init_codex_install = __esm({
     init_util2();
     init_install();
     init_codex();
+    init_guidance_block();
     init_matcher_group();
     CODEX_COMMAND_MARKER = "token-goat-shim";
     CODEX_MATCHERS = ["view_image|Bash", "apply_patch", "web_search"];
@@ -2677,6 +2716,22 @@ function copilotCliConfigPath(opts = {}) {
 function copilotCliScriptPath(opts = {}) {
   return path6.join(copilotCliHooksDir(opts), "token-goat-shim.js");
 }
+function copilotCliInstructionsPath(opts = {}) {
+  return path6.join(path6.dirname(copilotCliHooksDir(opts)), "copilot-instructions.md");
+}
+function buildCopilotInstructionsBlock() {
+  return buildGuidanceBlock({
+    beginMarker: COPILOT_INSTRUCTIONS_BEGIN,
+    endMarker: COPILOT_INSTRUCTIONS_END,
+    fallbackToolClause: "Copilot CLI's own `view`, `grep`, and `glob` tool-preference rules (and `Get-Content`/`Select-String`)"
+  });
+}
+function writeCopilotInstructionsBlock(p) {
+  return upsertDelimitedBlock(p, COPILOT_INSTRUCTIONS_BEGIN, COPILOT_INSTRUCTIONS_END, buildCopilotInstructionsBlock());
+}
+function stripCopilotInstructionsBlock(p) {
+  return stripDelimitedBlock(p, COPILOT_INSTRUCTIONS_BEGIN, COPILOT_INSTRUCTIONS_END);
+}
 function hookPowershellCommandFor(scriptPath, event) {
   return `& ${hookCommandFor(scriptPath, event)}`;
 }
@@ -2698,14 +2753,22 @@ function buildConfig(scriptPath) {
 function installCopilotCli(opts = {}) {
   const configPath2 = copilotCliConfigPath(opts);
   const scriptPath = copilotCliScriptPath(opts);
+  const instructionsPath = copilotCliInstructionsPath(opts);
   const scriptChanged = writeIfDifferent(scriptPath, COPILOT_CLI_HOOK_SCRIPT);
   const desiredText = JSON.stringify(buildConfig(scriptPath), null, 2) + "\n";
   const configChanged = writeIfDifferent(configPath2, desiredText, true);
-  return { configPath: configPath2, scriptPath, alreadyInstalled: !scriptChanged && !configChanged };
+  const instructionsChanged = writeCopilotInstructionsBlock(instructionsPath);
+  return {
+    configPath: configPath2,
+    scriptPath,
+    instructionsPath,
+    alreadyInstalled: !scriptChanged && !configChanged && !instructionsChanged
+  };
 }
 function uninstallCopilotCliScope(opts) {
   const configPath2 = copilotCliConfigPath(opts);
   const scriptPath = copilotCliScriptPath(opts);
+  const instructionsPath = copilotCliInstructionsPath(opts);
   let removedAny = false;
   try {
     fs4.unlinkSync(configPath2);
@@ -2717,6 +2780,9 @@ function uninstallCopilotCliScope(opts) {
     removedAny = true;
   } catch {
   }
+  if (stripCopilotInstructionsBlock(instructionsPath)) {
+    removedAny = true;
+  }
   return removedAny;
 }
 function uninstallCopilotCli(opts = {}) {
@@ -2727,13 +2793,14 @@ function uninstallCopilotCli(opts = {}) {
   const localRemoved = uninstallCopilotCliScope({ local: true });
   return userRemoved || localRemoved;
 }
-var COPILOT_CLI_HOOK_EVENTS, HOOK_TIMEOUT_SEC;
+var COPILOT_CLI_HOOK_EVENTS, COPILOT_INSTRUCTIONS_BEGIN, COPILOT_INSTRUCTIONS_END, HOOK_TIMEOUT_SEC;
 var init_copilot_cli_install = __esm({
   "src/bridges/copilot_cli_install.ts"() {
     "use strict";
     init_define_import_meta_env();
     init_util2();
     init_copilot_cli();
+    init_guidance_block();
     COPILOT_CLI_HOOK_EVENTS = [
       "preToolUse",
       "postToolUse",
@@ -2742,6 +2809,8 @@ var init_copilot_cli_install = __esm({
       "subagentStop",
       "userPromptSubmitted"
     ];
+    COPILOT_INSTRUCTIONS_BEGIN = "<!-- token-goat-begin -->";
+    COPILOT_INSTRUCTIONS_END = "<!-- token-goat-end -->";
     HOOK_TIMEOUT_SEC = 60;
   }
 });
@@ -3032,7 +3101,8 @@ var init_hook_registry = __esm({
       stop: "Stop",
       pre_compact: "PreCompact",
       user_prompt_submit: "UserPromptSubmit",
-      subagent_stop: "SubagentStop"
+      subagent_stop: "SubagentStop",
+      session_start: "SessionStart"
     };
     EVENTS_WITHOUT_ADDITIONAL_CONTEXT = /* @__PURE__ */ new Set([
       "notification",
@@ -3709,6 +3779,8 @@ function _buildConfig(raw, projectRaw = {}) {
   hi.cross_session_read_dedup_ttl_secs = envInt("TOKEN_GOAT_CROSS_SESSION_READ_DEDUP_TTL_SECS", hi.cross_session_read_dedup_ttl_secs, ...boundsOf("hints.cross_session_read_dedup_ttl_secs"));
   hi.mcp_dedup_ttl_secs = validatedInt(hi_raw["mcp_dedup_ttl_secs"], hi.mcp_dedup_ttl_secs, ...boundsOf("hints.mcp_dedup_ttl_secs"));
   hi.mcp_dedup_ttl_secs = envInt("TOKEN_GOAT_MCP_DEDUP_TTL_SECS", hi.mcp_dedup_ttl_secs, ...boundsOf("hints.mcp_dedup_ttl_secs"));
+  hi.session_start_reminder = validatedBool(hi_raw["session_start_reminder"], hi.session_start_reminder);
+  hi.session_start_reminder = envBool("TOKEN_GOAT_SESSION_START_REMINDER", hi.session_start_reminder);
   hi.min_session_hint_savings_bytes = envInt("TOKEN_GOAT_SESSION_HINT_MIN_BYTES", hi.min_session_hint_savings_bytes, ...boundsOf("hints.min_session_hint_savings_bytes"));
   const triggers_raw = hi_raw["prompt_triggers"];
   if (Array.isArray(triggers_raw)) {
@@ -3896,7 +3968,8 @@ function saveConfig(config2) {
       log_large_file_hint_outcomes: config2.hints.log_large_file_hint_outcomes,
       cross_session_read_dedup: config2.hints.cross_session_read_dedup,
       cross_session_read_dedup_ttl_secs: config2.hints.cross_session_read_dedup_ttl_secs,
-      mcp_dedup_ttl_secs: config2.hints.mcp_dedup_ttl_secs
+      mcp_dedup_ttl_secs: config2.hints.mcp_dedup_ttl_secs,
+      session_start_reminder: config2.hints.session_start_reminder
     },
     hooks: {
       watchdog_ms: config2.hooks.watchdog_ms
@@ -4074,7 +4147,8 @@ var init_config = __esm({
         log_large_file_hint_outcomes: false,
         cross_session_read_dedup: false,
         cross_session_read_dedup_ttl_secs: 2700,
-        mcp_dedup_ttl_secs: 45
+        mcp_dedup_ttl_secs: 45,
+        session_start_reminder: true
       },
       hooks: {
         watchdog_ms: 700
@@ -4254,6 +4328,7 @@ var init_config = __esm({
       "hints.cross_session_read_dedup": ["TOKEN_GOAT_CROSS_SESSION_READ_DEDUP"],
       "hints.cross_session_read_dedup_ttl_secs": ["TOKEN_GOAT_CROSS_SESSION_READ_DEDUP_TTL_SECS"],
       "hints.mcp_dedup_ttl_secs": ["TOKEN_GOAT_MCP_DEDUP_TTL_SECS"],
+      "hints.session_start_reminder": ["TOKEN_GOAT_SESSION_START_REMINDER"],
       "hints.min_session_hint_savings_bytes": ["TOKEN_GOAT_SESSION_HINT_MIN_BYTES"],
       "hooks.watchdog_ms": ["TOKEN_GOAT_HOOK_WATCHDOG_MS"],
       "webfetch.max_file_count": ["TOKEN_GOAT_WEB_CACHE_MAX_FILES"],
@@ -5763,6 +5838,7 @@ var init_stats = __esm({
       session_slice: SOURCE_READ,
       gdrive_sections: SOURCE_READ,
       pr_slice: SOURCE_READ,
+      compact_doc: SOURCE_READ,
       note_read: SOURCE_READ,
       note_list: SOURCE_READ,
       // note-add is a write (like insert-section/replace, which record no stat at all -- neither
@@ -5833,6 +5909,7 @@ var init_stats = __esm({
       "session-slice": /* @__PURE__ */ new Set(["session_slice"]),
       "gdrive-sections": /* @__PURE__ */ new Set(["gdrive_sections"]),
       "pr-slice": /* @__PURE__ */ new Set(["pr_slice"]),
+      "compact-doc": /* @__PURE__ */ new Set(["compact_doc"]),
       "note-add": /* @__PURE__ */ new Set(["note_write"]),
       "note-get": /* @__PURE__ */ new Set(["note_read"]),
       "note-list": /* @__PURE__ */ new Set(["note_list"]),
@@ -7343,23 +7420,23 @@ function isNoisePath(inputPath) {
     }
   }
   const slashIdx = p.lastIndexOf("/");
-  const basename19 = slashIdx >= 0 ? p.slice(slashIdx + 1) : p;
-  if (NOISE_BASENAMES.has(basename19)) {
+  const basename20 = slashIdx >= 0 ? p.slice(slashIdx + 1) : p;
+  if (NOISE_BASENAMES.has(basename20)) {
     return true;
   }
-  if (basename19.startsWith(".improve-state-") || basename19.startsWith("improve_commit_msg_")) {
+  if (basename20.startsWith(".improve-state-") || basename20.startsWith("improve_commit_msg_")) {
     return true;
   }
-  const dotIdx = basename19.lastIndexOf(".");
+  const dotIdx = basename20.lastIndexOf(".");
   if (dotIdx >= 0) {
-    const ext2 = basename19.slice(dotIdx);
+    const ext2 = basename20.slice(dotIdx);
     if (NOISE_EXTS.has(ext2)) {
       return true;
     }
   }
   for (const ext2 of NOISE_EXTS) {
     if (ext2.includes(".") && ext2.split(".").length > 2) {
-      if (basename19.endsWith(ext2)) {
+      if (basename20.endsWith(ext2)) {
         return true;
       }
     }
@@ -7931,11 +8008,11 @@ function buildPackageManifestHint(options) {
     return null;
   }
 }
-function _sanitizeHintPath(path63) {
-  if (typeof path63 !== "string") {
+function _sanitizeHintPath(path64) {
+  if (typeof path64 !== "string") {
     return "???";
   }
-  return path63.replace(/[\x00]/g, "").slice(0, 200);
+  return path64.replace(/[\x00]/g, "").slice(0, 200);
 }
 var HINT_PRIORITY_MEDIUM;
 var init_hints = __esm({
@@ -7947,15 +8024,15 @@ var init_hints = __esm({
 });
 
 // src/hints/lang_patterns.ts
-function isLockFile(basename19) {
-  return LOCK_FILE_NAMES.has(basename19.toLowerCase());
+function isLockFile(basename20) {
+  return LOCK_FILE_NAMES.has(basename20.toLowerCase());
 }
-function isManifestFile(basename19) {
-  const lower = basename19.toLowerCase();
+function isManifestFile(basename20) {
+  const lower = basename20.toLowerCase();
   if (MANIFEST_FILE_NAMES.has(lower)) return true;
   const dot = lower.lastIndexOf(".");
   if (dot !== -1 && MANIFEST_EXTENSIONS.has(lower.slice(dot))) return true;
-  if (MANIFEST_BASENAME_PATTERNS.some((re) => re.test(basename19))) return true;
+  if (MANIFEST_BASENAME_PATTERNS.some((re) => re.test(basename20))) return true;
   return false;
 }
 function pathSegments(filePath) {
@@ -8294,8 +8371,8 @@ function formatHeadingTree(headings, filePath) {
   }
   return lines2.join("\n");
 }
-function getWellKnownSections(basename19) {
-  return WELL_KNOWN_SECTIONS[basename19] ?? [];
+function getWellKnownSections(basename20) {
+  return WELL_KNOWN_SECTIONS[basename20] ?? [];
 }
 function extractChangelogVersionHint(content, filePath) {
   const lines2 = content.split("\n");
@@ -11006,16 +11083,16 @@ var init_file_type_handler = __esm({
 
 // src/skill_cache.ts
 import * as fs15 from "fs/promises";
-import { resolve as resolve5 } from "path";
+import { resolve as resolve6 } from "path";
 import { homedir as homedir7 } from "os";
-import { readdirSync as readdirSync7, readFileSync as readFileSync10, existsSync as existsSync13, statSync as statSync7, unlinkSync as unlinkSync8 } from "node:fs";
+import { readdirSync as readdirSync8, readFileSync as readFileSync11, existsSync as existsSync13, statSync as statSync7, unlinkSync as unlinkSync8 } from "node:fs";
 function skillOutputsDir() {
   if (_skillOutputsDirOverride) return _skillOutputsDirOverride;
-  return resolve5(dataDir(), SKILLS_OUTPUT_SUBDIR);
+  return resolve6(dataDir(), SKILLS_OUTPUT_SUBDIR);
 }
 function skillsSourceDir() {
   if (_skillsSourceDirOverride) return _skillsSourceDirOverride;
-  return resolve5(homedir7(), ".claude", "skills");
+  return resolve6(homedir7(), ".claude", "skills");
 }
 async function ensureSkillsDir() {
   try {
@@ -11158,7 +11235,7 @@ async function listOutputs() {
         continue;
       }
       try {
-        const content = await fs15.readFile(resolve5(dir, entry.name), "utf-8");
+        const content = await fs15.readFile(resolve6(dir, entry.name), "utf-8");
         const meta3 = JSON.parse(content);
         metas.push(meta3);
       } catch {
@@ -11192,7 +11269,7 @@ async function findCrossSessionEntry(skillName, contentSha) {
         continue;
       }
       const dir = skillOutputsDir();
-      const bodyPath = resolve5(dir, `${meta3.outputId}.txt`);
+      const bodyPath = resolve6(dir, `${meta3.outputId}.txt`);
       try {
         const bodyExists = await fs15.access(bodyPath).then(() => true).catch(() => false);
         if (bodyExists) {
@@ -11247,7 +11324,7 @@ async function storeOutput(sessionId, skillName, body, opts) {
       const truncBuf = buf.slice(truncStart);
       storedBody = truncBuf.toString("utf-8");
     }
-    await atomicWriteText(resolve5(dir, `${outId}.txt`), storedBody);
+    await atomicWriteText(resolve6(dir, `${outId}.txt`), storedBody);
     const meta3 = {
       outputId: outId,
       skillName: name2,
@@ -11257,7 +11334,7 @@ async function storeOutput(sessionId, skillName, body, opts) {
       truncated,
       sourcePath: opts?.sourcePath || ""
     };
-    await atomicWriteText(resolve5(dir, `${outId}.meta`), JSON.stringify(meta3, null, 2));
+    await atomicWriteText(resolve6(dir, `${outId}.meta`), JSON.stringify(meta3, null, 2));
     pruneSkillOutputs();
     return meta3;
   } catch {
@@ -11277,7 +11354,7 @@ async function storeCompact(sessionId, skillName, compactText, sourceSha) {
       text = `<!-- source_sha: ${sourceSha.slice(0, 12)} -->
 ${text}`;
     }
-    await atomicWriteText(resolve5(dir, fileId), text);
+    await atomicWriteText(resolve6(dir, fileId), text);
   } catch {
   }
 }
@@ -11293,11 +11370,11 @@ function getCompactAnySessionSync(skillName) {
     const suffix = compactSessionSuffix(skillName);
     if (!suffix) return null;
     const dir = skillOutputsDir();
-    const entries = readdirSync7(dir, { withFileTypes: true });
+    const entries = readdirSync8(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!matchesCompactSuffix(entry.name, entry.isFile(), suffix)) continue;
       try {
-        const text = readFileSync10(resolve5(dir, entry.name), "utf-8");
+        const text = readFileSync11(resolve6(dir, entry.name), "utf-8");
         if (text.trim()) return text;
       } catch {
         continue;
@@ -11325,7 +11402,7 @@ async function readSkillHits(skillName) {
     const name2 = safeSkillName(skillName);
     if (!name2) return { count: 0, lastTs: 0 };
     const dir = skillOutputsDir();
-    const hitsFile = resolve5(dir, `${sanitizeSkillId(name2)}.hits`);
+    const hitsFile = resolve6(dir, `${sanitizeSkillId(name2)}.hits`);
     const content = await fs15.readFile(hitsFile, "utf-8").catch(() => null);
     if (content) {
       const parsed = JSON.parse(content);
@@ -11375,7 +11452,7 @@ async function incrementSkillHit(skillName) {
     if (!name2) return;
     await ensureSkillsDir();
     const dir = skillOutputsDir();
-    const hitsFile = resolve5(dir, `${sanitizeSkillId(name2)}.hits`);
+    const hitsFile = resolve6(dir, `${sanitizeSkillId(name2)}.hits`);
     const lockPath = `${hitsFile}.lock`;
     await runExclusiveInProcess(lockPath, async () => {
       const locked = await acquireSkillHitLock(lockPath);
@@ -11422,14 +11499,14 @@ async function listSkills(sessionId) {
       let compactLen = 0;
       let compactText = "";
       try {
-        const stat2 = await fs15.stat(resolve5(dir, compactFileId));
+        const stat2 = await fs15.stat(resolve6(dir, compactFileId));
         compactLen = stat2.size;
-        compactText = await fs15.readFile(resolve5(dir, compactFileId), "utf-8").catch(() => "");
+        compactText = await fs15.readFile(resolve6(dir, compactFileId), "utf-8").catch(() => "");
       } catch {
         compactLen = 0;
       }
       const hasMarker = extractCompactFromMarker(
-        await fs15.readFile(resolve5(dir, `${meta3.outputId}.txt`), "utf-8").catch(() => "")
+        await fs15.readFile(resolve6(dir, `${meta3.outputId}.txt`), "utf-8").catch(() => "")
       ) !== null;
       const compactStale = isCompactStale(compactText, meta3.skillName, meta3.contentSha);
       const { count: hitCount } = await readSkillHits(meta3.skillName);
@@ -11465,7 +11542,7 @@ async function getSkillFilePath(skillName) {
   }
 }
 async function resolvePluginSkillPath(pluginName, skillSlug) {
-  const manifestPath = _pluginsManifestPathOverride ?? resolve5(homedir7(), ".claude", "plugins", "installed_plugins.json");
+  const manifestPath = _pluginsManifestPathOverride ?? resolve6(homedir7(), ".claude", "plugins", "installed_plugins.json");
   let raw;
   try {
     raw = await fs15.readFile(manifestPath, "utf8");
@@ -11488,7 +11565,7 @@ async function resolvePluginSkillPath(pluginName, skillSlug) {
       if (typeof entry !== "object" || entry === null) continue;
       const installPath = entry["installPath"];
       if (typeof installPath !== "string" || installPath === "") continue;
-      const diskPath = resolve5(installPath, "skills", skillSlug, "SKILL.md");
+      const diskPath = resolve6(installPath, "skills", skillSlug, "SKILL.md");
       try {
         await fs15.access(diskPath);
         return diskPath;
@@ -11507,7 +11584,7 @@ async function installedSkillPath(skillName) {
     const pluginPath = await resolvePluginSkillPath(name2.slice(0, colonIdx), name2.slice(colonIdx + 1));
     if (pluginPath !== null) return pluginPath;
   }
-  const diskPath = resolve5(skillsSourceDir(), name2, "SKILL.md");
+  const diskPath = resolve6(skillsSourceDir(), name2, "SKILL.md");
   try {
     await fs15.access(diskPath);
     return diskPath;
@@ -11522,16 +11599,16 @@ function pruneSkillOutputs(maxCount = DEFAULT_MAX_COUNT, maxAgeMs = DEFAULT_MAX_
     if (!existsSync13(dir)) return 0;
     const cutoff = Date.now() - maxAgeMs;
     const entries = [];
-    for (const file2 of readdirSync7(dir)) {
+    for (const file2 of readdirSync8(dir)) {
       if (!file2.endsWith(".meta")) continue;
       const outputId = file2.slice(0, -".meta".length);
       let ts;
       try {
-        const parsed = JSON.parse(readFileSync10(resolve5(dir, file2), "utf-8"));
+        const parsed = JSON.parse(readFileSync11(resolve6(dir, file2), "utf-8"));
         ts = parsed.ts;
       } catch {
         try {
-          ts = statSync7(resolve5(dir, file2)).mtimeMs;
+          ts = statSync7(resolve6(dir, file2)).mtimeMs;
         } catch {
           continue;
         }
@@ -11541,7 +11618,7 @@ function pruneSkillOutputs(maxCount = DEFAULT_MAX_COUNT, maxAgeMs = DEFAULT_MAX_
     const removeEntry = (outputId) => {
       for (const ext2 of [".meta", ".txt"]) {
         try {
-          unlinkSync8(resolve5(dir, `${outputId}${ext2}`));
+          unlinkSync8(resolve6(dir, `${outputId}${ext2}`));
         } catch {
         }
       }
@@ -11655,7 +11732,7 @@ async function ocrImage(input) {
   if (_ocrUnavailableThisProcess) return null;
   const entryPath = resolveTesseractEntry();
   if (entryPath === null) return null;
-  return new Promise((resolve20) => {
+  return new Promise((resolve21) => {
     let settled = false;
     let child;
     try {
@@ -11664,7 +11741,7 @@ async function ocrImage(input) {
       });
     } catch {
       _ocrUnavailableThisProcess = true;
-      resolve20(null);
+      resolve21(null);
       return;
     }
     const chunks = [];
@@ -11677,7 +11754,7 @@ async function ocrImage(input) {
         child.kill();
       } catch {
       }
-      resolve20(result);
+      resolve21(result);
     };
     const timer = setTimeout(() => finish(null, true), _ocrTimeoutMs);
     child.stdout?.on("data", (c) => chunks.push(c));
@@ -11813,19 +11890,19 @@ async function preReadImageHandler(event) {
   }
   const result = await shrinkImage(input, { sizeThresholdBytes: 0 });
   if (result === null) return passOutput();
-  const basename19 = path16.basename(filePath);
+  const basename20 = path16.basename(filePath);
   if (loadConfig().image_shrink.ocr_enabled) {
     const ocr = await ocrImage(result.data);
     if (ocr !== null && isTextHeavy(ocr, loadConfig().image_shrink.ocr_min_confidence)) {
       const textBytes = Buffer.byteLength(ocr.text, "utf8");
       const saved2 = Math.max(0, result.shrunkBytes - textBytes);
-      recordStat("image_ocr", saved2, Math.round(saved2 / 4), void 0, basename19);
-      return contextOutput(formatOcrSummary(ocr, basename19, result.originalBytes));
+      recordStat("image_ocr", saved2, Math.round(saved2 / 4), void 0, basename20);
+      return contextOutput(formatOcrSummary(ocr, basename20, result.originalBytes));
     }
   }
   const saved = result.originalBytes - result.shrunkBytes;
-  const { summary, dataUrl } = formatShrinkSummary(result, basename19);
-  recordStat("image_shrink", saved, Math.round(saved / 4), void 0, basename19);
+  const { summary, dataUrl } = formatShrinkSummary(result, basename20);
+  recordStat("image_shrink", saved, Math.round(saved / 4), void 0, basename20);
   return contextOutput(`${summary}
 ${dataUrl}`);
 }
@@ -12354,8 +12431,8 @@ var init_parser_types = __esm({
 // src/hooks_read.ts
 import * as fs19 from "node:fs";
 import * as path20 from "node:path";
-function isTsConfigFile(basename19) {
-  const lower = basename19.toLowerCase();
+function isTsConfigFile(basename20) {
+  const lower = basename20.toLowerCase();
   return /^tsconfig(\..+)?\.json$/i.test(lower) || lower === "jsconfig.json";
 }
 function largeFileDenyBytes() {
@@ -12455,18 +12532,18 @@ function describeSliceAdvice(slice, absPath) {
   }
   return "Use Read with offset/limit to sample specific sections.";
 }
-function isSourceExtension(basename19) {
-  if (SOURCE_EXT_RE.test(basename19)) return true;
-  const language = detectLanguage(basename19);
+function isSourceExtension(basename20) {
+  if (SOURCE_EXT_RE.test(basename20)) return true;
+  const language = detectLanguage(basename20);
   return language === "apex" || language === "salesforce_metadata" || language === "salesforce_markup";
 }
-function isDispatchedFileType(basename19) {
-  return DISPATCHED_FILE_TYPE_EXTS.has(path20.extname(basename19).slice(1).toLowerCase());
+function isDispatchedFileType(basename20) {
+  return DISPATCHED_FILE_TYPE_EXTS.has(path20.extname(basename20).slice(1).toLowerCase());
 }
-function surgicalHint(filePath, basename19, lineCount) {
+function surgicalHint(filePath, basename20, lineCount) {
   if (lineCount < loadConfig().hints.min_file_lines_for_hint) return "";
-  const isDocFile = /\.(md|mdx|rst|txt)$/i.test(basename19);
-  const isSectionFile = /\.(json|jsonc|css|scss|sass|less|yaml|yml|toml)$/i.test(basename19);
+  const isDocFile = /\.(md|mdx|rst|txt)$/i.test(basename20);
+  const isSectionFile = /\.(json|jsonc|css|scss|sass|less|yaml|yml|toml)$/i.test(basename20);
   if (isDocFile) {
     return 'Use `token-goat section "' + filePath + '::HeadingName"` to extract a part.';
   } else if (isSectionFile) {
@@ -12514,7 +12591,7 @@ function buildLineDiff(oldContent, newContent, label) {
   }
   return out2.join("\n");
 }
-function loadSnapshotDiff(sessionId, normalized, basename19) {
+function loadSnapshotDiff(sessionId, normalized, basename20) {
   const oldSnap = load(sessionId, normalized);
   if (oldSnap === null) return { kind: "none" };
   try {
@@ -12526,7 +12603,7 @@ function loadSnapshotDiff(sessionId, normalized, basename19) {
     const truncIdx = oldRaw.indexOf(TRUNC_MARKER);
     const oldContent = truncIdx >= 0 ? oldRaw.slice(0, truncIdx) : oldRaw;
     if (oldContent === currentContent) return { kind: "unchanged", currentContent };
-    const diff = buildLineDiff(oldContent, currentContent, basename19);
+    const diff = buildLineDiff(oldContent, currentContent, basename20);
     if (diff === "") return { kind: "none" };
     const savedBytes = Math.max(0, currentContent.length - diff.length);
     return { kind: "diff", diff, savedBytes, currentContent };
@@ -12599,8 +12676,8 @@ function preReadHandlerInner(event) {
       "node_modules is typically noise; use npm ls, npm outdated, or npm audit instead for dependency info. To force access, use: token-goat read node_modules/package/file.js::symbol-name or token-goat section node_modules/package/file.js::heading"
     );
   }
-  const basename19 = path20.basename(normalized);
-  if (isLockFile(basename19)) {
+  const basename20 = path20.basename(normalized);
+  if (isLockFile(basename20)) {
     return denyOutput(
       'Lock files are rarely useful to read in full. Use `token-goat section "' + normalized + '::<section>"` to extract a specific dependency, or read the relevant manifest instead.'
     );
@@ -12623,20 +12700,20 @@ function preReadHandlerInner(event) {
       return quietContextOutput(manifestHint.text);
     }
   }
-  if (isTsConfigFile(basename19) && wasFileReadThisSession(normalized)) {
+  if (isTsConfigFile(basename20) && wasFileReadThisSession(normalized)) {
     recordActualRead(event, normalized);
     return quietContextOutput(
-      "Already read " + basename19 + '. Use `token-goat section "' + normalized + '::compilerOptions"` to extract compiler options, or `token-goat config-get ' + normalized + " compilerOptions.target` for a single value."
+      "Already read " + basename20 + '. Use `token-goat section "' + normalized + '::compilerOptions"` to extract compiler options, or `token-goat config-get ' + normalized + " compilerOptions.target` for a single value."
     );
   }
-  if (isManifestFile(basename19) && wasFileReadThisSession(normalized)) {
+  if (isManifestFile(basename20) && wasFileReadThisSession(normalized)) {
     recordActualRead(event, normalized);
     return quietContextOutput(
-      "You've already read " + basename19 + '. Use `token-goat section "' + normalized + '::<field>"` or `token-goat config-get ' + normalized + " <key>` to extract just the value you need."
+      "You've already read " + basename20 + '. Use `token-goat section "' + normalized + '::<field>"` or `token-goat config-get ' + normalized + " <key>` to extract just the value you need."
     );
   }
   const skillName = detectSkillFile(normalized);
-  if (skillName && basename19 === "SKILL.md") {
+  if (skillName && basename20 === "SKILL.md") {
     try {
       const body = fs19.readFileSync(normalized, "utf-8");
       const bodySha = contentHash(body);
@@ -12666,7 +12743,7 @@ function preReadHandlerInner(event) {
       }
     }
   }
-  const isNotebook = /\.ipynb$/i.test(basename19);
+  const isNotebook = /\.ipynb$/i.test(basename20);
   if (event.toolName !== "Grep" && isNotebook) {
     try {
       const rawBytes = fs19.readFileSync(normalized);
@@ -12683,7 +12760,7 @@ function preReadHandlerInner(event) {
     } catch {
     }
   }
-  const isMarkdown = /\.(md|mdx|markdown|rst)$/i.test(basename19);
+  const isMarkdown = /\.(md|mdx|markdown|rst)$/i.test(basename20);
   if (event.toolName !== "Grep" && isMarkdown) {
     let fileContent = null;
     let markdownSize = null;
@@ -12701,9 +12778,9 @@ function preReadHandlerInner(event) {
         const alreadyRead = wasFileReadThisSession(normalized);
         const hintText = formatHeadingTree(headings, normalized);
         const headingTextsLower = new Set(headings.map((h) => h.text.trim().toLowerCase()));
-        const wellKnown = getWellKnownSections(basename19).filter((s) => headingTextsLower.has(s.trim().toLowerCase()));
+        const wellKnown = getWellKnownSections(basename20).filter((s) => headingTextsLower.has(s.trim().toLowerCase()));
         const wellKnownText = wellKnown.length > 0 ? "\nQuick access: " + wellKnown.map((s) => 'token-goat section "' + normalized + "::" + s + '"').join(" | ") : "";
-        const changelogExtra = basename19.toLowerCase() === "changelog.md" ? extractChangelogVersionHint(fileContent, normalized) : "";
+        const changelogExtra = basename20.toLowerCase() === "changelog.md" ? extractChangelogVersionHint(fileContent, normalized) : "";
         let message = hintText + wellKnownText + changelogExtra;
         const slice = estimateRequestedSlice(event, normalized);
         const gateSize = slice.kind === "bytes" && markdownSize !== null ? Math.min(slice.bytes, markdownSize) : markdownSize;
@@ -12724,19 +12801,19 @@ function preReadHandlerInner(event) {
   if (isMemoryMd && wasFileReadThisSession(normalized)) {
     recordActualRead(event, normalized);
     recordStat("session_hint", 0, 0);
-    const isMainMemory = basename19.toLowerCase() === "memory.md";
+    const isMainMemory = basename20.toLowerCase() === "memory.md";
     return denyOutput(
       isMainMemory ? "MEMORY.md was read this session. Its content is in the compact manifest as 'session memory'." : normalized + ' was already read this session. Memory files rarely change mid-session. Use `token-goat section "' + normalized + '::SectionHeading"` to extract one section.'
     );
   }
-  if (/^\.improve-state-.*\.json$/.test(basename19) && wasFileReadThisSession(normalized)) {
+  if (/^\.improve-state-.*\.json$/.test(basename20) && wasFileReadThisSession(normalized)) {
     recordActualRead(event, normalized);
     recordStat("session_hint", 0, 0);
     return denyOutput(
       "Orchestrator state already read this session. " + sessionArtifactRecall(normalized)
     );
   }
-  if (/^\.env(\.\w+)?$/.test(basename19) && wasFileReadThisSession(normalized)) {
+  if (/^\.env(\.\w+)?$/.test(basename20) && wasFileReadThisSession(normalized)) {
     recordActualRead(event, normalized);
     recordStat("session_hint", 0, 0);
     return denyOutput(
@@ -12753,19 +12830,19 @@ function preReadHandlerInner(event) {
         );
       }
       const artifactSessionId = getSessionId();
-      const snapDiff = loadSnapshotDiff(artifactSessionId, normalized, basename19);
+      const snapDiff = loadSnapshotDiff(artifactSessionId, normalized, basename20);
       if (snapDiff.kind === "unchanged") {
         recordActualRead(event, normalized);
         recordStat("session_hint", 0, 0);
         return denyOutput(
-          basename19 + " is unchanged since last read. " + sessionArtifactRecall(normalized)
+          basename20 + " is unchanged since last read. " + sessionArtifactRecall(normalized)
         );
       }
       if (snapDiff.kind === "diff") {
         recordActualRead(event, normalized);
         recordStat("session_hint", snapDiff.savedBytes, Math.round(snapDiff.savedBytes / 4));
         return denyOutput(
-          "Content changed since last read of " + basename19 + ". Here is what changed:\n\n```diff\n" + snapDiff.diff + "\n```\n\n" + sessionArtifactRecall(normalized)
+          "Content changed since last read of " + basename20 + ". Here is what changed:\n\n```diff\n" + snapDiff.diff + "\n```\n\n" + sessionArtifactRecall(normalized)
         );
       }
       recordActualRead(event, normalized);
@@ -12788,8 +12865,8 @@ function preReadHandlerInner(event) {
       return quietContextOutput(label + ": " + sessionArtifactRecall(normalized));
     }
   }
-  const isDocDiffable = /\.(md|mdx|markdown|rst|txt)$/i.test(basename19);
-  const isSourceDiffable = loadConfig().hints.serve_diff_on_reread && DIFFABLE_SOURCE_RE.test(basename19);
+  const isDocDiffable = /\.(md|mdx|markdown|rst|txt)$/i.test(basename20);
+  const isSourceDiffable = loadConfig().hints.serve_diff_on_reread && DIFFABLE_SOURCE_RE.test(basename20);
   if ((isDocDiffable || isSourceDiffable) && wasFileReadThisSession(normalized) && !isProtectedRecentRead(normalized, loadConfig().hints.protect_recent_reads)) {
     if (wasFileTruncatedThisSession(normalized)) {
       if (estimateTruncatedLineCount(normalized) >= loadConfig().hints.truncated_read_min_lines) {
@@ -12799,12 +12876,12 @@ function preReadHandlerInner(event) {
       }
     }
     const sessionId = getSessionId();
-    const snapDiff = loadSnapshotDiff(sessionId, normalized, basename19);
+    const snapDiff = loadSnapshotDiff(sessionId, normalized, basename20);
     if (snapDiff.kind === "unchanged") {
       recordActualRead(event, normalized);
       recordStat("session_hint", 0, 0);
       return denyOutput(
-        (basename19 + " is unchanged since last read. " + surgicalHint(normalized, basename19, countTextLines(snapDiff.currentContent))).trimEnd()
+        (basename20 + " is unchanged since last read. " + surgicalHint(normalized, basename20, countTextLines(snapDiff.currentContent))).trimEnd()
       );
     }
     if (snapDiff.kind === "diff") {
@@ -12812,7 +12889,7 @@ function preReadHandlerInner(event) {
         recordActualRead(event, normalized);
         recordStat("diff_hint", snapDiff.savedBytes, Math.round(snapDiff.savedBytes / 4));
         return denyOutput(
-          ("Content changed since last read of " + basename19 + ". Here is what changed:\n\n```diff\n" + snapDiff.diff + "\n```\n\n" + surgicalHint(normalized, basename19, countTextLines(snapDiff.currentContent))).trimEnd()
+          ("Content changed since last read of " + basename20 + ". Here is what changed:\n\n```diff\n" + snapDiff.diff + "\n```\n\n" + surgicalHint(normalized, basename20, countTextLines(snapDiff.currentContent))).trimEnd()
         );
       }
     }
@@ -12858,13 +12935,13 @@ function preReadHandlerInner(event) {
           return denyOutput(truncatedReadDenyMessage(normalized));
         }
       }
-      if (/\.(md|mdx|markdown|rst)$/i.test(basename19)) {
+      if (/\.(md|mdx|markdown|rst)$/i.test(basename20)) {
         recordStat("session_hint", rereadBytes, Math.round(rereadBytes / 4));
         return denyOutput(
           'Markdown file already read this session. Use `token-goat section "' + normalized + '::HeadingName"` to read one section. ' + editAnywayHint(normalized)
         );
       }
-      const isSourceExt = isSourceExtension(basename19);
+      const isSourceExt = isSourceExtension(basename20);
       if (isSourceExt && reads >= 2) {
         recordStat("read_count_deny", rereadBytes, Math.round(rereadBytes / 4));
         recordStat("session_hint", rereadBytes, Math.round(rereadBytes / 4));
@@ -13115,7 +13192,7 @@ function ensureTransformerLoaded() {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve20) => setTimeout(resolve20, ms));
+  return new Promise((resolve21) => setTimeout(resolve21, ms));
 }
 async function buildExtractorWithRetry(pipelineFn, modelName) {
   let lastError;
@@ -13799,8 +13876,8 @@ async function readOoxmlZip(filePath) {
   const data = fs20.readFileSync(filePath);
   return fflate.unzipSync(new Uint8Array(data));
 }
-function decodeZipEntry(entries, path63) {
-  const bytes = entries[path63];
+function decodeZipEntry(entries, path64) {
+  const bytes = entries[path64];
   if (bytes === void 0) return null;
   return new TextDecoder("utf-8").decode(bytes);
 }
@@ -14010,9 +14087,9 @@ async function notesPathFor(entries, slidePath) {
   }
   return null;
 }
-async function parseSlide(entries, path63) {
-  const xml = decodeZipEntry(entries, path63);
-  if (xml === null) throw new Error(`missing part: ${path63}`);
+async function parseSlide(entries, path64) {
+  const xml = decodeZipEntry(entries, path64);
+  if (xml === null) throw new Error(`missing part: ${path64}`);
   return parseOoxmlPart(xml);
 }
 async function notesTextFor(entries, notesPath) {
@@ -14028,8 +14105,8 @@ async function pptxOutline(filePath) {
   const { entries, slidePaths } = await listSlideParts(filePath);
   const out2 = [];
   for (let i = 0; i < slidePaths.length; i++) {
-    const path63 = slidePaths[i];
-    const parsed = await parseSlide(entries, path63);
+    const path64 = slidePaths[i];
+    const parsed = await parseSlide(entries, path64);
     const shapes = slideShapes(parsed);
     const titleShape = shapes.find((s) => {
       const t = shapePlaceholderType(s);
@@ -14038,7 +14115,7 @@ async function pptxOutline(filePath) {
     const title = titleShape !== void 0 ? shapeText(titleShape) : "";
     const allText = collectTextRuns(parsed, "a:t").join(" ");
     const bodyChars = Math.max(0, allText.length - title.length);
-    const hasNotes = (await notesTextFor(entries, await notesPathFor(entries, path63))).length > 0;
+    const hasNotes = (await notesTextFor(entries, await notesPathFor(entries, path64))).length > 0;
     out2.push({ slide: i + 1, title, bodyChars, hasNotes });
   }
   return out2;
@@ -14048,13 +14125,13 @@ async function pptxSlideText(filePath, slideNumber, includeNotes) {
   if (slideNumber < 1 || slideNumber > slidePaths.length) {
     throw new Error(`slide ${slideNumber} out of range (this deck has ${slidePaths.length} slides)`);
   }
-  const path63 = slidePaths[slideNumber - 1];
-  const parsed = await parseSlide(entries, path63);
+  const path64 = slidePaths[slideNumber - 1];
+  const parsed = await parseSlide(entries, path64);
   const shapes = slideShapes(parsed);
   const blocks = [...shapes.map(shapeText).filter((t) => t.length > 0), ...tableRowBlocks(parsed)];
   const lines2 = [`# Slide ${slideNumber}`, ...blocks];
   if (includeNotes) {
-    const notes = await notesTextFor(entries, await notesPathFor(entries, path63));
+    const notes = await notesTextFor(entries, await notesPathFor(entries, path64));
     if (notes.length > 0) lines2.push("", "## Speaker notes", notes);
   }
   return lines2.join("\n\n");
@@ -18160,6 +18237,77 @@ function loadParserCtor() {
   }
   return _parserCtor;
 }
+function boundSymbolBody(body) {
+  return body.length > MAX_SYMBOL_BODY_CHARS ? "" : body;
+}
+function boundSymbolDocstring(docstring) {
+  if (docstring.length <= MAX_SYMBOL_DOCSTRING_CHARS) return docstring;
+  let end = MAX_SYMBOL_DOCSTRING_CHARS - DOCSTRING_TRUNCATION_MARKER.length;
+  const cutsSurrogatePair = end > 0 && docstring.charCodeAt(end - 1) >= 55296 && docstring.charCodeAt(end - 1) <= 56319;
+  if (cutsSurrogatePair) end -= 1;
+  return docstring.slice(0, Math.max(0, end)) + DOCSTRING_TRUNCATION_MARKER;
+}
+function scanJsonValueEnd(content, start) {
+  const first2 = content[start];
+  if (first2 === void 0) return content.length;
+  if (first2 === '"') {
+    let escaping = false;
+    for (let j = start + 1; j < content.length; j++) {
+      const c = content[j];
+      if (escaping) {
+        escaping = false;
+        continue;
+      }
+      if (c === "\\") {
+        escaping = true;
+        continue;
+      }
+      if (c === '"') return j + 1;
+    }
+    return content.length;
+  }
+  if (first2 === "{" || first2 === "[") {
+    const stack = [];
+    let inStr = false;
+    let escaping = false;
+    for (let j = start; j < content.length; j++) {
+      const c = content[j];
+      if (inStr) {
+        if (escaping) {
+          escaping = false;
+          continue;
+        }
+        if (c === "\\") {
+          escaping = true;
+          continue;
+        }
+        if (c === '"') inStr = false;
+        continue;
+      }
+      if (c === '"') {
+        inStr = true;
+        continue;
+      }
+      if (c === "{" || c === "[") stack.push(c);
+      else if (c === "}" || c === "]") {
+        const open = stack.pop();
+        if (open !== (c === "}" ? "{" : "[")) return j;
+        if (stack.length === 0) return j + 1;
+      }
+    }
+    return content.length;
+  }
+  for (let j = start; j < content.length; j++) {
+    const c = content[j];
+    if (c === "," || c === "}" || c === "]" || c === "\n" || c === "\r") return j;
+  }
+  return content.length;
+}
+function countNewlines(s) {
+  let n = 0;
+  for (let i = 0; i < s.length; i++) if (s[i] === "\n") n++;
+  return n;
+}
 function loadGrammar(lang, filePath, content) {
   const useTsx = lang === "typescript" && filePath !== void 0 && path26.extname(filePath).toLowerCase() === ".tsx";
   const useCppHeader = lang === "c" && filePath !== void 0 && path26.extname(filePath).toLowerCase() === ".h" && content !== void 0 && CPP_HEADER_SNIFF_RE.test(content);
@@ -18701,12 +18849,12 @@ function extractMarkdownSymbols(content, filePath) {
 function extractJsonSymbols(content, filePath) {
   const out2 = [];
   try {
-    const lines2 = content.split(/\r?\n/);
     let depth = 0;
     let inString = false;
     let escaping = false;
     let strChars = [];
     let strStartLine = 1;
+    let strStartOffset = 0;
     let depthWhenStringOpened = 0;
     let line = 1;
     for (let i = 0; i < content.length; i++) {
@@ -18727,45 +18875,22 @@ function extractJsonSymbols(content, filePath) {
           inString = true;
           strChars = [];
           strStartLine = line;
+          strStartOffset = i;
           depthWhenStringOpened = depth;
         } else {
           inString = false;
           let k = i + 1;
-          let keyToColonNewlines = 0;
           while (k < content.length && /\s/.test(content[k] ?? "")) {
-            if (content[k] === "\n") keyToColonNewlines++;
             k++;
           }
           if (content[k] === ":" && depthWhenStringOpened === 1) {
             let v = k + 1;
-            let gapNewlines = 0;
             while (v < content.length && /\s/.test(content[v] ?? "")) {
-              if (content[v] === "\n") gapNewlines++;
               v++;
             }
-            let lineEnd = strStartLine;
-            let body = (lines2[strStartLine - 1] ?? "").trim();
-            if (content[v] === '"') {
-              let valueLine = line + keyToColonNewlines + gapNewlines;
-              let valueEscaping = false;
-              for (let j = v + 1; j < content.length; j++) {
-                const vch = content[j];
-                if (vch === "\n") valueLine++;
-                if (valueEscaping) {
-                  valueEscaping = false;
-                  continue;
-                }
-                if (vch === "\\") {
-                  valueEscaping = true;
-                  continue;
-                }
-                if (vch === '"') break;
-              }
-              lineEnd = valueLine;
-              if (lineEnd > strStartLine) {
-                body = lines2.slice(strStartLine - 1, lineEnd).join("\n").trim();
-              }
-            }
+            const valueEnd = scanJsonValueEnd(content, v);
+            const body = content.slice(strStartOffset, valueEnd);
+            const lineEnd = strStartLine + countNewlines(body);
             out2.push({
               filePath,
               name: strChars.join(""),
@@ -19237,7 +19362,7 @@ function writeParseResult(filePath, content, result, dbPath) {
     );
     for (const s of result.symbols) {
       if (s.name === "" || s.kind === "") continue;
-      insSym.run(s.filePath, s.name, s.kind, s.lineStart, s.lineEnd, s.body, s.docstring);
+      insSym.run(s.filePath, s.name, s.kind, s.lineStart, s.lineEnd, boundSymbolBody(s.body), boundSymbolDocstring(s.docstring));
     }
     const insRef = db.prepare(
       "INSERT INTO refs (file_path, name, line, col, context) VALUES (?, ?, ?, ?, ?)"
@@ -19382,7 +19507,7 @@ function safeMtime(filePath) {
     return 0;
   }
 }
-var _require4, _parserCtor, _grammarCache, CPP_HEADER_SNIFF_RE, TSJS_KIND_BY_TYPE, TSJS_FN_SCOPE_TYPES, PY_KIND_BY_TYPE, GO_KIND_BY_TYPE, GO_FN_SCOPE_TYPES, GO_LOCAL_KINDS, RUST_KIND_BY_TYPE, RUST_FN_SCOPE_TYPES, RUST_LOCAL_KINDS, RUBY_KIND_BY_TYPE, JAVA_KIND_BY_TYPE, CPP_KIND_BY_TYPE, REF_LANGUAGES, SCOPE_TYPES_BY_LANG, CALL_TYPES_BY_LANG, REF_NOISE_BY_LANG, JS_NOISE, EMPTY_STRING_SET, FALLBACK_PATTERNS, NO_TREE_SITTER_EXTRACTORS, DISABLED_EMBED_SHA_PREFIX, UNAVAILABLE_EMBED_SHA_PREFIX;
+var _require4, _parserCtor, _grammarCache, CPP_HEADER_SNIFF_RE, MAX_SYMBOL_BODY_CHARS, MAX_SYMBOL_DOCSTRING_CHARS, DOCSTRING_TRUNCATION_MARKER, TSJS_KIND_BY_TYPE, TSJS_FN_SCOPE_TYPES, PY_KIND_BY_TYPE, GO_KIND_BY_TYPE, GO_FN_SCOPE_TYPES, GO_LOCAL_KINDS, RUST_KIND_BY_TYPE, RUST_FN_SCOPE_TYPES, RUST_LOCAL_KINDS, RUBY_KIND_BY_TYPE, JAVA_KIND_BY_TYPE, CPP_KIND_BY_TYPE, REF_LANGUAGES, SCOPE_TYPES_BY_LANG, CALL_TYPES_BY_LANG, REF_NOISE_BY_LANG, JS_NOISE, EMPTY_STRING_SET, FALLBACK_PATTERNS, NO_TREE_SITTER_EXTRACTORS, DISABLED_EMBED_SHA_PREFIX, UNAVAILABLE_EMBED_SHA_PREFIX;
 var init_parser = __esm({
   "src/parser.ts"() {
     "use strict";
@@ -19428,6 +19553,9 @@ var init_parser = __esm({
     _require4 = createRequire5(import.meta.url);
     _grammarCache = /* @__PURE__ */ new Map();
     CPP_HEADER_SNIFF_RE = /\bclass\s+\w|\bnamespace\s+\w|\btemplate\s*<|::\s*\w|\b(?:public|private|protected)\s*:/;
+    MAX_SYMBOL_BODY_CHARS = 128 * 1024;
+    MAX_SYMBOL_DOCSTRING_CHARS = 16 * 1024;
+    DOCSTRING_TRUNCATION_MARKER = "\n[... docstring truncated by token-goat ...]";
     TSJS_KIND_BY_TYPE = /* @__PURE__ */ new Map([
       ["function_declaration", "function"],
       ["generator_function_declaration", "function"],
@@ -21275,8 +21403,8 @@ var require_command = __commonJS({
     init_define_import_meta_env();
     var EventEmitter = __require("node:events").EventEmitter;
     var childProcess = __require("node:child_process");
-    var path63 = __require("node:path");
-    var fs53 = __require("node:fs");
+    var path64 = __require("node:path");
+    var fs56 = __require("node:fs");
     var process4 = __require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -22208,11 +22336,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path63.resolve(baseDir, baseName);
-          if (fs53.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path63.extname(baseName))) return void 0;
+          const localBin = path64.resolve(baseDir, baseName);
+          if (fs56.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path64.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext2) => fs53.existsSync(`${localBin}${ext2}`)
+            (ext2) => fs56.existsSync(`${localBin}${ext2}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -22224,21 +22352,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs53.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs56.realpathSync(this._scriptPath);
           } catch (err2) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path63.resolve(
-            path63.dirname(resolvedScriptPath),
+          executableDir = path64.resolve(
+            path64.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path63.basename(
+            const legacyName = path64.basename(
               this._scriptPath,
-              path63.extname(this._scriptPath)
+              path64.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -22249,7 +22377,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path63.extname(executableFile));
+        launchWithNode = sourceExt.includes(path64.extname(executableFile));
         let proc;
         if (process4.platform !== "win32") {
           if (launchWithNode) {
@@ -23089,7 +23217,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path63.basename(filename, path63.extname(filename));
+        this._name = path64.basename(filename, path64.extname(filename));
         return this;
       }
       /**
@@ -23103,9 +23231,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path64) {
-        if (path64 === void 0) return this._executableDir;
-        this._executableDir = path64;
+      executableDir(path65) {
+        if (path65 === void 0) return this._executableDir;
+        this._executableDir = path65;
         return this;
       }
       /**
@@ -23341,7 +23469,7 @@ import * as readline from "node:readline";
 async function defaultConfirm(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   try {
-    const answer = await new Promise((resolve20) => rl.question(question, resolve20));
+    const answer = await new Promise((resolve21) => rl.question(question, resolve21));
     return /^y(es)?$/i.test(answer.trim());
   } finally {
     rl.close();
@@ -23880,7 +24008,8 @@ function walkProject(rootDir, opts = {}) {
   const excludeTests = opts.excludeTests === true;
   const includeEmbeddableDocuments = opts.includeEmbeddableDocuments === true;
   const extraSkipDirs = loadConfig().indexing.skip_dirs;
-  while (stack.length > 0 && files.length < MAX_FILES_SCANNED) {
+  const maxFiles = opts.maxFiles ?? MAX_FILES_SCANNED;
+  while (stack.length > 0 && files.length < maxFiles) {
     const dir = stack.pop();
     if (dir === void 0) break;
     let entries;
@@ -23903,7 +24032,7 @@ function walkProject(rootDir, opts = {}) {
         if (excludeTests && isTestFile(full)) continue;
         files.push(full);
         languages[lang] = (languages[lang] ?? 0) + 1;
-        if (files.length >= MAX_FILES_SCANNED) break;
+        if (files.length >= maxFiles) break;
       }
     }
   }
@@ -24043,9 +24172,9 @@ function formatMemSuggestions(projectRoot) {
   if (suggestions.length === 0) return "";
   const lines2 = ["", "## mem suggestions"];
   for (const s of suggestions) {
-    const basename19 = path33.basename(s.path);
+    const basename20 = path33.basename(s.path);
     lines2.push(
-      "Consider: mem import --from-md " + s.path + "  # migrates " + s.count + " preference-shaped lines from " + basename19 + " as pending facts for review"
+      "Consider: mem import --from-md " + s.path + "  # migrates " + s.count + " preference-shaped lines from " + basename20 + " as pending facts for review"
     );
   }
   return lines2.join(String.fromCharCode(10));
@@ -24116,7 +24245,7 @@ var init_repomap = __esm({
 });
 
 // src/section_reader.ts
-import { readFileSync as readFileSync26 } from "node:fs";
+import { readFileSync as readFileSync27 } from "node:fs";
 function parseHeadingSpec(spec, headers) {
   const m = /^(.*?)#(\d+)$/.exec(spec);
   if (m !== null && m[1] !== void 0 && m[2] !== void 0) {
@@ -24349,7 +24478,7 @@ function extractSection(text, headingSpec) {
 function readTextForSections(filePath) {
   let text;
   try {
-    text = readFileSync26(filePath, "utf-8");
+    text = readFileSync27(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -24413,7 +24542,7 @@ var init_section_reader = __esm({
 });
 
 // src/graph_commands.ts
-import * as fs33 from "node:fs";
+import * as fs34 from "node:fs";
 import * as os16 from "node:os";
 import * as path42 from "node:path";
 import { execFileSync, spawnSync as spawnSync4 } from "node:child_process";
@@ -24680,7 +24809,7 @@ function runDead(opts) {
 function runDeps(opts) {
   let text;
   try {
-    text = fs33.readFileSync(opts.file, "utf-8");
+    text = fs34.readFileSync(opts.file, "utf-8");
   } catch {
     emitErr(`Could not read: ${opts.file}`);
     return 1;
@@ -24694,22 +24823,22 @@ function runDeps(opts) {
     if (imp.startsWith("./") || imp.startsWith("../")) {
       const base = path42.resolve(dir, imp);
       let resolved = imp;
-      if (fs33.existsSync(base) && fs33.statSync(base).isFile()) {
+      if (fs34.existsSync(base) && fs34.statSync(base).isFile()) {
         resolved = base;
       } else {
         const baseExt = path42.extname(base);
         const bareBase = SOURCE_EXTENSIONS.includes(baseExt) ? base.slice(0, -baseExt.length) : base;
         for (const srcExt of SOURCE_EXTENSIONS) {
           const candidate = bareBase + srcExt;
-          if (fs33.existsSync(candidate)) {
+          if (fs34.existsSync(candidate)) {
             resolved = candidate;
             break;
           }
         }
-        if (resolved === imp && fs33.existsSync(base) && fs33.statSync(base).isDirectory()) {
+        if (resolved === imp && fs34.existsSync(base) && fs34.statSync(base).isDirectory()) {
           for (const srcExt of SOURCE_EXTENSIONS) {
             const candidate = path42.join(base, "index" + srcExt);
-            if (fs33.existsSync(candidate)) {
+            if (fs34.existsSync(candidate)) {
               resolved = candidate;
               break;
             }
@@ -25070,7 +25199,7 @@ function runArch(opts) {
   for (const file2 of files) {
     let text;
     try {
-      text = fs33.readFileSync(file2, "utf8");
+      text = fs34.readFileSync(file2, "utf8");
     } catch {
       continue;
     }
@@ -25202,7 +25331,7 @@ ANSWER:`;
     if (result.status === 0) {
       if (codexOutPath) {
         try {
-          answer = fs33.readFileSync(codexOutPath, "utf8").trim();
+          answer = fs34.readFileSync(codexOutPath, "utf8").trim();
         } catch {
         }
       } else {
@@ -25221,7 +25350,7 @@ ANSWER:`;
   } finally {
     if (codexOutPath) {
       try {
-        fs33.unlinkSync(codexOutPath);
+        fs34.unlinkSync(codexOutPath);
       } catch {
       }
     }
@@ -28076,23 +28205,23 @@ var init_pr_slice = __esm({
 });
 
 // src/sqlite_query.ts
-import * as fs34 from "node:fs";
+import * as fs35 from "node:fs";
 import Database2 from "better-sqlite3";
 function readMagicBytes(filePath) {
   let fd;
   try {
-    fd = fs34.openSync(filePath, "r");
+    fd = fs35.openSync(filePath, "r");
   } catch {
     return null;
   }
   try {
     const buf = Buffer.alloc(SQLITE_MAGIC.length);
-    const bytesRead = fs34.readSync(fd, buf, 0, buf.length, 0);
+    const bytesRead = fs35.readSync(fd, buf, 0, buf.length, 0);
     return bytesRead === buf.length ? buf : null;
   } catch {
     return null;
   } finally {
-    fs34.closeSync(fd);
+    fs35.closeSync(fd);
   }
 }
 function isSqliteFile(filePath) {
@@ -28100,7 +28229,7 @@ function isSqliteFile(filePath) {
   return magic !== null && magic.equals(SQLITE_MAGIC);
 }
 function openReadonlySqlite(filePath) {
-  if (!fs34.existsSync(filePath)) {
+  if (!fs35.existsSync(filePath)) {
     throw new Error(`file not found: ${filePath}`);
   }
   if (!isSqliteFile(filePath)) {
@@ -28821,12 +28950,12 @@ var init_conflict_query = __esm({
 });
 
 // src/screenshot.ts
-import fs35 from "node:fs";
+import fs36 from "node:fs";
 import path44 from "node:path";
 function findPlaywrightChromium(msPlaywrightDir) {
   let entries;
   try {
-    entries = fs35.readdirSync(msPlaywrightDir);
+    entries = fs36.readdirSync(msPlaywrightDir);
   } catch {
     return [];
   }
@@ -28865,13 +28994,13 @@ function platformCandidatePaths() {
   return candidates;
 }
 function resolveBrowserExecutablePath(explicit) {
-  if (explicit && fs35.existsSync(explicit)) return explicit;
+  if (explicit && fs36.existsSync(explicit)) return explicit;
   const cfgPath = loadConfig().screenshot.chrome_path;
-  if (cfgPath && fs35.existsSync(cfgPath)) return cfgPath;
+  if (cfgPath && fs36.existsSync(cfgPath)) return cfgPath;
   const envPath = process.env["TOKEN_GOAT_CHROME_PATH"];
-  if (envPath && fs35.existsSync(envPath)) return envPath;
+  if (envPath && fs36.existsSync(envPath)) return envPath;
   for (const candidate of platformCandidatePaths()) {
-    if (fs35.existsSync(candidate)) return candidate;
+    if (fs36.existsSync(candidate)) return candidate;
   }
   return null;
 }
@@ -28919,6 +29048,7 @@ var init_screenshot = __esm({
 });
 
 // src/notes.ts
+import * as fs37 from "node:fs";
 function toNoteRow(row) {
   return {
     id: row.id,
@@ -28935,7 +29065,17 @@ function pickEarliest(matches2) {
 }
 function resolveSymbolMatch(filePath, symbolName, dbPath = globalDbPath()) {
   const matches2 = querySymbols({ filePath, name: symbolName }, dbPath);
-  return matches2.length === 0 ? null : pickEarliest(matches2);
+  if (matches2.length === 0) return null;
+  const match2 = pickEarliest(matches2);
+  if (match2.body !== "") return match2;
+  return { ...match2, body: bodyFromSource(match2) };
+}
+function bodyFromSource(entry) {
+  try {
+    return fs37.readFileSync(entry.filePath, "utf8").split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
+  } catch {
+    return "";
+  }
 }
 function symbolNamesInFile(filePath, dbPath = globalDbPath()) {
   const symbols = querySymbols({ filePath, limit: 1e5 }, dbPath);
@@ -29181,11 +29321,11 @@ var init_ts_refs = __esm({
 });
 
 // src/read_commands.ts
-import * as fs36 from "node:fs";
+import * as fs38 from "node:fs";
 import * as path46 from "node:path";
 function fileExists(p) {
   try {
-    fs36.statSync(p);
+    fs38.statSync(p);
     return true;
   } catch {
     return false;
@@ -29193,14 +29333,14 @@ function fileExists(p) {
 }
 function readFileText(p) {
   try {
-    return fs36.readFileSync(p, "utf-8");
+    return fs38.readFileSync(p, "utf-8");
   } catch {
     return null;
   }
 }
 function readFileBytes(p) {
   try {
-    return fs36.readFileSync(p);
+    return fs38.readFileSync(p);
   } catch {
     return null;
   }
@@ -29265,7 +29405,7 @@ function sumFileSizes(filePaths) {
   let total = 0;
   for (const fp of new Set(filePaths)) {
     try {
-      total += fs36.statSync(fp).size;
+      total += fs38.statSync(fp).size;
     } catch {
     }
   }
@@ -29522,7 +29662,7 @@ function runRead(opts) {
   const match2 = resolution.entry;
   const fullSourceBytes = sumFileSizes([match2.filePath]);
   if (opts.json === true) {
-    const text2 = JSON.stringify(match2, null, 2);
+    const text2 = JSON.stringify({ ...match2, body: resolveBody(match2) }, null, 2);
     recordReadStat("read_replacement", fullSourceBytes, text2, opts.spec);
     return { text: text2, code: 0 };
   }
@@ -29547,7 +29687,7 @@ function runSection(opts) {
   const heading = opts.spec.slice(colonIdx + 2);
   const result = readSection(filePath, heading);
   if (result === null) {
-    if (!fs36.existsSync(filePath)) {
+    if (!fs38.existsSync(filePath)) {
       return { text: `File not found: '${filePath}'`, code: 1 };
     }
     const messages = [`Section '${heading}' not found in '${filePath}'`];
@@ -30303,7 +30443,7 @@ function runConflicts(opts) {
     const abs = path46.resolve(opts.path);
     let stat2;
     try {
-      stat2 = fs36.statSync(abs);
+      stat2 = fs38.statSync(abs);
     } catch {
       emitErr2(`Could not read: ${opts.path}`);
       return 1;
@@ -30338,7 +30478,7 @@ async function runPdfExtractText(file2, pagesSpec, layout = false) {
   if (!fileExists(file2)) {
     throw new Error(`Could not read: ${file2}`);
   }
-  const data = fs36.readFileSync(file2);
+  const data = fs38.readFileSync(file2);
   const result = await extractPdfText(new Uint8Array(data), pagesSpec, layout);
   return result.text;
 }
@@ -30346,14 +30486,14 @@ async function runPdfOutline(file2) {
   if (!fileExists(file2)) {
     throw new Error(`Could not read: ${file2}`);
   }
-  const data = fs36.readFileSync(file2);
+  const data = fs38.readFileSync(file2);
   return extractPdfOutline(new Uint8Array(data));
 }
 async function runPdfMeta(file2) {
   if (!fileExists(file2)) {
     throw new Error(`Could not read: ${file2}`);
   }
-  const data = fs36.readFileSync(file2);
+  const data = fs38.readFileSync(file2);
   return extractPdfMeta(new Uint8Array(data));
 }
 async function runScreenshot(url2, destPath, opts) {
@@ -30771,7 +30911,7 @@ function runGrep(opts) {
   const hits = [];
   function searchFile(filePath) {
     try {
-      const text = fs36.readFileSync(filePath, "utf-8");
+      const text = fs38.readFileSync(filePath, "utf-8");
       const lines2 = text.split(/\r?\n/);
       lines2.forEach((lineText, idx) => {
         if (regex.test(lineText)) {
@@ -30792,10 +30932,10 @@ function runGrep(opts) {
   }
   function searchDir(dir) {
     try {
-      for (const entry of fs36.readdirSync(dir)) {
+      for (const entry of fs38.readdirSync(dir)) {
         if (entry.startsWith(".")) continue;
         const full = path46.join(dir, entry);
-        const stat2 = fs36.statSync(full);
+        const stat2 = fs38.statSync(full);
         if (stat2.isDirectory()) {
           if (SKIP_DIRS.has(entry)) continue;
           if (opts.recursive !== false) searchDir(full);
@@ -30811,7 +30951,7 @@ function runGrep(opts) {
       emitErr2(`Path not found: ${searchPath}`);
       return 1;
     }
-    const stat2 = fs36.statSync(searchPath);
+    const stat2 = fs38.statSync(searchPath);
     if (stat2.isDirectory()) {
       searchDir(searchPath);
     } else {
@@ -31408,15 +31548,20 @@ function symbolHeader(s) {
 }
 async function runSemantic(query, opts) {
   if (opts.limit !== void 0 && opts.limit <= 0) {
-    return { text: `--limit must be a positive number, got: ${opts.limit}`, code: 1 };
+    const message = `--limit must be a positive number, got: ${opts.limit}`;
+    if (opts.json === true) {
+      return { text: JSON.stringify({ error: message }, null, 2), code: 1 };
+    }
+    return { text: message, code: 1 };
   }
   const n = opts.limit !== void 0 && Number.isFinite(opts.limit) ? opts.limit : 20;
   if (opts.projectRoot !== void 0) {
-    if (!path46.isAbsolute(opts.projectRoot) || !fs36.existsSync(opts.projectRoot) || !fs36.statSync(opts.projectRoot).isDirectory()) {
-      return {
-        text: `token-goat: projectRoot must be an absolute, existing directory, got '${opts.projectRoot}'`,
-        code: 1
-      };
+    if (!path46.isAbsolute(opts.projectRoot) || !fs38.existsSync(opts.projectRoot) || !fs38.statSync(opts.projectRoot).isDirectory()) {
+      const message = `token-goat: projectRoot must be an absolute, existing directory, got '${opts.projectRoot}'`;
+      if (opts.json === true) {
+        return { text: JSON.stringify({ error: message }, null, 2), code: 1 };
+      }
+      return { text: message, code: 1 };
     }
   }
   const rootDir = opts.projectRoot ?? resolveProjectRoot({ project: process.cwd() });
@@ -31431,6 +31576,21 @@ async function runSemantic(query, opts) {
   );
   const hits = mergeNearbyHits(rawHits).slice(0, n);
   if (hits.length > 0) {
+    if (opts.json === true) {
+      const items = hits.map((h) => ({
+        filePath: h.filePath,
+        name: null,
+        kind: null,
+        startLine: h.startLine,
+        endLine: h.endLine,
+        distance: h.distance,
+        preview: previewLines(h.text, 3)
+      }));
+      const capped = guardJsonRows(items);
+      const text3 = JSON.stringify({ source: "embeddings", ...capped }, null, 2);
+      recordReadStat("semantic_search", sumFileSizes(hits.map((h) => h.filePath)), text3, query);
+      return { text: text3, code: 0 };
+    }
     const blocks2 = hits.map(
       (h) => `# ${h.filePath}:${h.startLine}-${h.endLine} (distance ${h.distance.toFixed(3)})
 ${previewLines(h.text, 3)}`
@@ -31441,8 +31601,27 @@ ${previewLines(h.text, 3)}`
   }
   const results = searchSymbolsFts(query, n, void 0, rootDir);
   if (results.length === 0) {
+    if (opts.json === true) {
+      const text2 = JSON.stringify({ source: "fts", items: [], truncated: false, totalCount: 0 }, null, 2);
+      return { text: text2, code: 1 };
+    }
     return { text: `token-goat: no matches for '${query}'`, code: 1 };
   }
+  if (opts.json === true) {
+    const items = results.map((s) => ({
+      filePath: s.filePath,
+      name: s.name,
+      kind: s.kind,
+      startLine: s.lineStart,
+      endLine: s.lineEnd,
+      distance: null,
+      preview: previewLines(s.body, 3)
+    }));
+    const capped = guardJsonRows(items);
+    const text2 = JSON.stringify({ source: "fts", ...capped }, null, 2);
+    recordReadStat("semantic_search", sumFileSizes(results.map((s) => s.filePath)), text2, query);
+    return { text: text2, code: 0 };
+  }
   const blocks = results.map((s) => `${symbolHeader(s)}
 ${previewLines(s.body, 3)}`);
   const text = guardText(blocks.join("\n\n"), "semantic");
@@ -31798,10 +31977,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path63) {
-  if (!path63)
+function getElementAtPath(obj, path64) {
+  if (!path64)
     return obj;
-  return path63.reduce((acc, key) => acc?.[key], obj);
+  return path64.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -32129,11 +32308,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path63, issues) {
+function prefixIssues(path64, issues) {
   return issues.map((iss) => {
     var _a6;
     (_a6 = iss).path ?? (_a6.path = []);
-    iss.path.unshift(path63);
+    iss.path.unshift(path64);
     return iss;
   });
 }
@@ -32351,16 +32530,16 @@ function flattenError(error52, mapper = (issue2) => issue2.message) {
 }
 function formatError2(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error53, path63 = []) => {
+  const processError = (error53, path64 = []) => {
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path63, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path64, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path63, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path64, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path63, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path64, ...issue2.path]);
       } else {
-        const fullpath = [...path63, ...issue2.path];
+        const fullpath = [...path64, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -32387,17 +32566,17 @@ function formatError2(error52, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error52, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error53, path63 = []) => {
+  const processError = (error53, path64 = []) => {
     var _a6, _b;
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path63, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path64, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path63, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path64, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path63, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path64, ...issue2.path]);
       } else {
-        const fullpath = [...path63, ...issue2.path];
+        const fullpath = [...path64, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -32429,8 +32608,8 @@ function treeifyError(error52, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path63 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path63) {
+  const path64 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path64) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -45933,13 +46112,13 @@ function resolveRef(ref2, ctx) {
   if (!ref2.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path63 = ref2.slice(1).split("/").filter(Boolean);
-  if (path63.length === 0) {
+  const path64 = ref2.slice(1).split("/").filter(Boolean);
+  if (path64.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path63[0] === defsKey) {
-    const key = path63[1];
+  if (path64[0] === defsKey) {
+    const key = path64[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref2}`);
     }
@@ -47210,7 +47389,8 @@ var HOOK_EVENTS = [
   "stop",
   "pre_compact",
   "user_prompt_submit",
-  "subagent_stop"
+  "subagent_stop",
+  "session_start"
 ];
 
 // src/relay.ts
@@ -47234,7 +47414,7 @@ function grepIntInput(toolInput, key) {
 function grepSignature(toolInput) {
   const pattern = toolInput["pattern"];
   if (typeof pattern !== "string" || pattern === "") return null;
-  const path63 = typeof toolInput["path"] === "string" ? toolInput["path"] : "";
+  const path64 = typeof toolInput["path"] === "string" ? toolInput["path"] : "";
   const outputMode = typeof toolInput["output_mode"] === "string" ? toolInput["output_mode"] : "files_with_matches";
   const glob = typeof toolInput["glob"] === "string" ? toolInput["glob"] : "";
   const type = typeof toolInput["type"] === "string" ? toolInput["type"] : "";
@@ -47249,7 +47429,7 @@ function grepSignature(toolInput) {
   const offset = grepIntInput(toolInput, "offset");
   return JSON.stringify([
     pattern,
-    path63,
+    path64,
     outputMode,
     glob,
     type,
@@ -47283,8 +47463,8 @@ init_session();
 function globSignature(toolInput) {
   const pattern = toolInput["pattern"];
   if (typeof pattern !== "string" || pattern === "") return null;
-  const path63 = typeof toolInput["path"] === "string" ? toolInput["path"] : "";
-  return JSON.stringify([pattern, path63]);
+  const path64 = typeof toolInput["path"] === "string" ? toolInput["path"] : "";
+  return JSON.stringify([pattern, path64]);
 }
 var { post: postGlobHandler, pre: preGlobDedupHandler } = makeDedupHintHandlers({
   toolName: "Glob",
@@ -47371,7 +47551,7 @@ init_hook_registry();
 init_hooks_common();
 init_stats();
 init_config();
-import { readFileSync as readFileSync18, statSync as statSync14 } from "node:fs";
+import { readFileSync as readFileSync19, statSync as statSync14 } from "node:fs";
 var MAX_LINES_FOR_DIFF = 4e3;
 var MAX_OLD_FILE_BYTES_FOR_DIFF = 4 * 1024 * 1024;
 function splitLines(text) {
@@ -47409,7 +47589,7 @@ function preWriteRewriteHandler(event) {
     if (stat2.size > MAX_OLD_FILE_BYTES_FOR_DIFF) return passOutput();
     let oldContent;
     try {
-      oldContent = readFileSync18(filePath, "utf-8");
+      oldContent = readFileSync19(filePath, "utf-8");
     } catch {
       return passOutput();
     }
@@ -47453,8 +47633,8 @@ init_reset();
 init_util2();
 init_disk_cache();
 init_lang_patterns();
-import { readdirSync as readdirSync10, readFileSync as readFileSync19, statSync as statSync15 } from "fs";
-import { resolve as resolve7 } from "path";
+import { readdirSync as readdirSync11, readFileSync as readFileSync20, statSync as statSync15 } from "fs";
+import { resolve as resolve8 } from "path";
 
 // src/recall_index.ts
 init_define_import_meta_env();
@@ -47652,11 +47832,11 @@ function gitStateFingerprintSync(cwd) {
   }
 }
 var DIR_FINGERPRINT_LISTING_CAP_ENTRIES = 1e4;
-function dirStateFingerprintSync(path63) {
+function dirStateFingerprintSync(path64) {
   try {
-    const stat2 = statSync15(path63);
+    const stat2 = statSync15(path64);
     if (!stat2.isDirectory()) return null;
-    const entries = readdirSync10(path63);
+    const entries = readdirSync11(path64);
     if (entries.length <= DIR_FINGERPRINT_LISTING_CAP_ENTRIES) {
       return shortFingerprint(entries.slice().sort().join("\0"));
     }
@@ -47666,12 +47846,12 @@ function dirStateFingerprintSync(path63) {
   }
 }
 var FILE_FINGERPRINT_CONTENT_CAP_BYTES = 2 * 1024 * 1024;
-function fileStateFingerprintSync(path63) {
+function fileStateFingerprintSync(path64) {
   try {
-    const stat2 = statSync15(path63);
+    const stat2 = statSync15(path64);
     if (!stat2.isFile()) return null;
     if (stat2.size <= FILE_FINGERPRINT_CONTENT_CAP_BYTES) {
-      return shortFingerprint(readFileSync19(path63));
+      return shortFingerprint(readFileSync20(path64));
     }
     return shortFingerprint(`${stat2.mtimeMs}\0${stat2.size}`);
   } catch {
@@ -47687,7 +47867,7 @@ function depLockfileFingerprintSync(cmd, cwd) {
   if (!candidates) return null;
   for (const lockfile of candidates) {
     try {
-      const content = readFileSync19(resolve7(cwd, lockfile));
+      const content = readFileSync20(resolve8(cwd, lockfile));
       return shortFingerprint(content);
     } catch {
       continue;
@@ -47840,7 +48020,7 @@ function extractFirstPathArg(cmd, cwd, fallback) {
     const token2 = tokens[i];
     if (!token2.startsWith("-")) {
       if (!token2.startsWith("/")) {
-        return resolve7(cwd, token2);
+        return resolve8(cwd, token2);
       }
       return token2;
     }
@@ -47854,10 +48034,20 @@ function summarizeOutputDelta(oldOutput, newOutput) {
   const newLines = newOutput.split("\n");
   const oldIssueLines = oldLines.filter((l) => ISSUE_LINE_PATTERN.test(l));
   if (oldIssueLines.length > 0) {
-    const newIssueLineSet = new Set(newLines.filter((l) => ISSUE_LINE_PATTERN.test(l)));
+    const newIssueLines = newLines.filter((l) => ISSUE_LINE_PATTERN.test(l));
     const priorTotal = oldIssueLines.length;
-    const resolved = oldIssueLines.filter((l) => !newIssueLineSet.has(l)).length;
-    const remaining = newIssueLineSet.size;
+    const availableCounts = /* @__PURE__ */ new Map();
+    for (const l of newIssueLines) availableCounts.set(l, (availableCounts.get(l) ?? 0) + 1);
+    let resolved = 0;
+    for (const l of oldIssueLines) {
+      const avail = availableCounts.get(l) ?? 0;
+      if (avail > 0) {
+        availableCounts.set(l, avail - 1);
+      } else {
+        resolved++;
+      }
+    }
+    const remaining = newIssueLines.length;
     return `[token-goat: delta] ${resolved} of ${priorTotal} prior issues resolved; remaining: ${remaining}`;
   }
   return `[token-goat: delta] output changed: ${oldLines.length} -> ${newLines.length} lines`;
@@ -48134,14 +48324,15 @@ var {
 init_baseline();
 init_stats();
 init_repomap();
-import * as fs52 from "fs";
-import * as path62 from "path";
+import * as fs55 from "fs";
+import * as path63 from "path";
 import { homedir as homedir17 } from "os";
 
 // src/walk_index.ts
 init_define_import_meta_env();
 init_baseline();
 init_util2();
+import * as fs29 from "node:fs";
 import * as os9 from "node:os";
 import * as path35 from "node:path";
 function isWalkExcluded(file2) {
@@ -48151,7 +48342,11 @@ function isWalkExcluded(file2) {
   return false;
 }
 function assertWalkableRoot(root) {
-  const resolved = path35.resolve(root);
+  let resolved = path35.resolve(root);
+  try {
+    resolved = fs29.realpathSync.native(resolved);
+  } catch {
+  }
   const norm = foldPath(normalizePath(resolved));
   const fsRoot = foldPath(normalizePath(path35.parse(resolved).root));
   if (norm === fsRoot) {
@@ -48169,13 +48364,16 @@ function assertWalkableRoot(root) {
     }
   }
 }
-function collectWalkIndexFiles(root) {
+var MAX_FILES_SCANNED_FORCED = 5e5;
+function collectWalkIndexFiles(root, opts = {}) {
   const resolved = path35.resolve(root);
   assertWalkableRoot(resolved);
-  const { files } = walkProject(resolved, { includeEmbeddableDocuments: true });
-  if (files.length >= MAX_FILES_SCANNED) {
+  const force = opts.force === true;
+  const ceiling = force ? MAX_FILES_SCANNED_FORCED : MAX_FILES_SCANNED;
+  const { files } = walkProject(resolved, { includeEmbeddableDocuments: true, maxFiles: ceiling });
+  if (files.length >= ceiling) {
     throw new Error(
-      `'${resolved}' has too many source files (>= ${MAX_FILES_SCANNED}); refusing to walk-index \u2014 index a git repo or point at a narrower path`
+      `'${resolved}' has too many source files (walk stopped at ${ceiling}; the real total is at least that). ` + (force ? "Even --force-walk will not walk a tree this large \u2014 point at a narrower path." : `Index a git repo, point at a narrower path, or pass --force-walk to raise the cap to ${MAX_FILES_SCANNED_FORCED}.`)
     );
   }
   return files.filter((f) => !isWalkExcluded(f));
@@ -48199,7 +48397,7 @@ init_codex_install();
 
 // src/bridges/gemini_install.ts
 init_define_import_meta_env();
-import * as fs29 from "node:fs";
+import * as fs30 from "node:fs";
 import * as os10 from "node:os";
 import * as path36 from "node:path";
 init_install();
@@ -48222,7 +48420,7 @@ function geminiSettingsPath() {
 function readGeminiSettings(p, opts = {}) {
   let raw;
   try {
-    raw = fs29.readFileSync(p, "utf8");
+    raw = fs30.readFileSync(p, "utf8");
   } catch {
     return {};
   }
@@ -48336,7 +48534,7 @@ function uninstallGemini() {
 init_define_import_meta_env();
 init_install();
 init_util2();
-import * as fs30 from "node:fs";
+import * as fs31 from "node:fs";
 import * as os11 from "node:os";
 import * as path37 from "node:path";
 var QWEN_HOOK_EVENTS = ["PreToolUse", "PostToolUse", "PreCompact", "UserPromptSubmit", "SubagentStop"];
@@ -48355,7 +48553,7 @@ function qwenSettingsPath() {
 function readQwenSettings(p, opts = {}) {
   let raw;
   try {
-    raw = fs30.readFileSync(p, "utf8");
+    raw = fs31.readFileSync(p, "utf8");
   } catch {
     return {};
   }
@@ -49103,7 +49301,7 @@ function uninstallOpencode() {
 // src/bridges/openclaw_install.ts
 init_define_import_meta_env();
 init_util2();
-import * as fs31 from "node:fs";
+import * as fs32 from "node:fs";
 import * as os14 from "node:os";
 import * as path40 from "node:path";
 
@@ -49255,7 +49453,7 @@ function openclawEntrySidecarPath() {
 function readOpenclawConfig(p, opts = {}) {
   let raw;
   try {
-    raw = fs31.readFileSync(p, "utf8");
+    raw = fs32.readFileSync(p, "utf8");
   } catch {
     return {};
   }
@@ -49295,7 +49493,7 @@ function installOpenclaw() {
   const pluginPath = openclawPluginPath();
   let existingPlugin;
   try {
-    existingPlugin = fs31.readFileSync(pluginPath, "utf8");
+    existingPlugin = fs32.readFileSync(pluginPath, "utf8");
   } catch {
     existingPlugin = void 0;
   }
@@ -49336,12 +49534,12 @@ function uninstallOpenclaw() {
   const pluginPath = openclawPluginPath();
   let removed = false;
   try {
-    fs31.unlinkSync(pluginPath);
+    fs32.unlinkSync(pluginPath);
     removed = true;
   } catch {
   }
   try {
-    fs31.unlinkSync(openclawEntrySidecarPath());
+    fs32.unlinkSync(openclawEntrySidecarPath());
   } catch {
   }
   const settings = readOpenclawConfig(configPath2);
@@ -49442,12 +49640,12 @@ import * as os15 from "node:os";
 
 // src/shell.ts
 init_define_import_meta_env();
-import * as fs32 from "node:fs";
+import * as fs33 from "node:fs";
 import * as path41 from "node:path";
 var WSL_LAUNCHER_SEGMENTS = /* @__PURE__ */ new Set(["system32", "syswow64", "windowsapps"]);
 function isExecutable(p) {
   try {
-    return fs32.statSync(p).isFile();
+    return fs33.statSync(p).isFile();
   } catch {
     return false;
   }
@@ -63073,7 +63271,7 @@ var BRIDGE_CAPABILITY_MATRIX = [
     harness: "claudecode",
     label: "Claude Code",
     sourceFile: "src/install.ts (HOOK_EVENT_MAP)",
-    implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact", "user_prompt_submit", "subagent_stop"]),
+    implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact", "user_prompt_submit", "subagent_stop", "session_start"]),
     reasons: [{ events: ["notification", "stop"], reason: NO_SERVER_HANDLER_REASON }]
   },
   {
@@ -63081,14 +63279,26 @@ var BRIDGE_CAPABILITY_MATRIX = [
     label: "Codex CLI",
     sourceFile: "src/bridges/codex_install.ts (CODEX_HOOK_EVENTS, CODEX_GLOBAL_HOOK_EVENTS)",
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact", "user_prompt_submit", "subagent_stop"]),
-    reasons: [{ events: ["notification", "stop"], reason: NO_SERVER_HANDLER_REASON }]
+    reasons: [
+      { events: ["notification", "stop"], reason: NO_SERVER_HANDLER_REASON },
+      {
+        events: ["session_start"],
+        reason: "Codex CLI's hook config schema (CODEX_EVENT_ARG) has no session-start-equivalent event to map onto token-goat's session_start -- unlike Claude Code's real SessionStart hook"
+      }
+    ]
   },
   {
     harness: "grok",
     label: "Grok CLI",
     sourceFile: "src/bridges/grok_install.ts (GROK_HOOK_EVENTS)",
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact", "user_prompt_submit", "subagent_stop"]),
-    reasons: [{ events: ["notification", "stop"], reason: NO_SERVER_HANDLER_REASON }]
+    reasons: [
+      { events: ["notification", "stop"], reason: NO_SERVER_HANDLER_REASON },
+      {
+        events: ["session_start"],
+        reason: "GROK_HOOK_EVENTS (this row's explicit `install --grok` writer) mirrors install.ts's HOOK_EVENT_MAP as of the doc verification date -- Grok's real hooks doc has not been re-checked for SessionStart support since, so it is left unwired rather than guessed at (Grok's *default*, non---grok path still rides Claude Code's own settings.json directly and does receive session_start there, same as claudecode)"
+      }
+    ]
   },
   {
     harness: "copilot_cli",
@@ -63099,6 +63309,10 @@ var BRIDGE_CAPABILITY_MATRIX = [
       {
         events: ["notification"],
         reason: "Copilot CLI has a real 'notification' hook event, but copilot_cli.ts's COPILOT_TO_TG_EVENT deliberately leaves it (and sessionEnd/postToolUseFailure/subagentStart/errorOccurred/permissionRequest) unimplemented rather than guessed at"
+      },
+      {
+        events: ["session_start"],
+        reason: "COPILOT_TO_TG_EVENT has no session-start mapping wired yet -- left unimplemented rather than guessed at"
       }
     ]
   },
@@ -63109,7 +63323,7 @@ var BRIDGE_CAPABILITY_MATRIX = [
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact"]),
     reasons: [
       {
-        events: ["notification", "stop", "user_prompt_submit", "subagent_stop"],
+        events: ["notification", "stop", "user_prompt_submit", "subagent_stop", "session_start"],
         reason: `Gemini CLI's hooks integration only wires BeforeTool/AfterTool/PreCompress (README "Gemini CLI users")`
       }
     ]
@@ -63124,7 +63338,11 @@ var BRIDGE_CAPABILITY_MATRIX = [
         events: ["notification"],
         reason: "Only five Qwen Code events have a token-goat handler; every other real event (Notification, SessionEnd, PostToolUseFailure, StopFailure, SubagentStart, PermissionRequest, TodoCreated, TodoCompleted) is left unimplemented rather than guessed at (qwen_install.ts)"
       },
-      { events: ["stop"], reason: NO_SERVER_HANDLER_REASON }
+      { events: ["stop"], reason: NO_SERVER_HANDLER_REASON },
+      {
+        events: ["session_start"],
+        reason: "QWEN_EVENT_ARG has no session-start mapping wired yet -- left unimplemented rather than guessed at"
+      }
     ]
   },
   {
@@ -63134,7 +63352,7 @@ var BRIDGE_CAPABILITY_MATRIX = [
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact"]),
     reasons: [
       {
-        events: ["notification", "stop", "user_prompt_submit", "subagent_stop"],
+        events: ["notification", "stop", "user_prompt_submit", "subagent_stop", "session_start"],
         reason: "opencode's plugin API only exposes three relevant hooks -- tool.execute.before, tool.execute.after, experimental.session.compacting (opencode.ts module docstring, verified against opencode's real source)"
       }
     ]
@@ -63146,7 +63364,7 @@ var BRIDGE_CAPABILITY_MATRIX = [
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact"]),
     reasons: [
       {
-        events: ["notification", "stop", "user_prompt_submit", "subagent_stop"],
+        events: ["notification", "stop", "user_prompt_submit", "subagent_stop", "session_start"],
         reason: "OpenClaw's in-process plugin API only exposes before_tool_call/after_tool_call/before_compaction as api.on() handlers relevant here"
       }
     ]
@@ -63158,8 +63376,8 @@ var BRIDGE_CAPABILITY_MATRIX = [
     implemented: /* @__PURE__ */ new Set(["pre_tool_use", "post_tool_use", "pre_compact"]),
     reasons: [
       {
-        events: ["notification", "stop", "user_prompt_submit", "subagent_stop"],
-        reason: "pi's extension API subscribes to session_start/tool_call/tool_result/session_before_compact/session_compact, of which only tool_call/tool_result/session_before_compact map onto real HOOK_EVENTS names (pre_tool_use/post_tool_use/pre_compact)"
+        events: ["notification", "stop", "user_prompt_submit", "subagent_stop", "session_start"],
+        reason: "pi's extension API subscribes to session_start/tool_call/tool_result/session_before_compact/session_compact, of which only tool_call/tool_result/session_before_compact map onto real HOOK_EVENTS names (pre_tool_use/post_tool_use/pre_compact) -- pi's own session_start event is never forwarded to token-goat's callHook()"
       }
     ]
   }
@@ -63262,7 +63480,7 @@ init_csv_query();
 
 // src/sharepoint_resolve.ts
 init_define_import_meta_env();
-import * as fs37 from "node:fs";
+import * as fs39 from "node:fs";
 import * as os17 from "node:os";
 import * as path47 from "node:path";
 var TENANT_HOST_RE = /^([a-z0-9-]+?)(-my)?\.sharepoint\.com$/i;
@@ -63311,7 +63529,7 @@ function candidateRoots(env, home) {
   if (commercial !== void 0) roots.push(commercial);
   if (personal !== void 0 && personal !== commercial) roots.push(personal);
   try {
-    for (const entry of fs37.readdirSync(home, { withFileTypes: true })) {
+    for (const entry of fs39.readdirSync(home, { withFileTypes: true })) {
       if (entry.isDirectory() && /onedrive/i.test(entry.name)) {
         const full = path47.join(home, entry.name);
         if (!roots.includes(full)) roots.push(full);
@@ -63324,13 +63542,13 @@ function candidateRoots(env, home) {
 function tryLibraryPaths(root, libSegments, triedPaths) {
   const rawJoined = path47.join(root, ...libSegments);
   triedPaths.push(rawJoined);
-  if (fs37.existsSync(rawJoined)) return rawJoined;
+  if (fs39.existsSync(rawJoined)) return rawJoined;
   if (libSegments.length > 0) {
     const aliasedFirst = normalizeLibrarySegment(libSegments[0]);
     if (aliasedFirst !== libSegments[0]) {
       const aliasedJoined = path47.join(root, aliasedFirst, ...libSegments.slice(1));
       triedPaths.push(aliasedJoined);
-      if (fs37.existsSync(aliasedJoined)) return aliasedJoined;
+      if (fs39.existsSync(aliasedJoined)) return aliasedJoined;
     }
   }
   return null;
@@ -63344,7 +63562,7 @@ function resolveLocalPath(parsed, env = process.env, home = os17.homedir()) {
     if (found !== null) return { resolvedPath: found, triedPaths };
     if (parsed.siteType === "site" && parsed.siteName.length > 0) {
       try {
-        for (const entry of fs37.readdirSync(root, { withFileTypes: true })) {
+        for (const entry of fs39.readdirSync(root, { withFileTypes: true })) {
           if (!entry.isDirectory() || !entry.name.toLowerCase().includes(parsed.siteName.toLowerCase())) continue;
           const siteRoot = path47.join(root, entry.name);
           const siteFound = tryLibraryPaths(siteRoot, libSegments, triedPaths);
@@ -63407,7 +63625,7 @@ function extractVideoChapters(file2) {
 
 // src/transcript_extract.ts
 init_define_import_meta_env();
-import * as fs38 from "node:fs";
+import * as fs40 from "node:fs";
 var TIMESTAMP_RE = /(\d{1,2}:)?(\d{2}):(\d{2})[.,](\d{1,3})/;
 var CUE_LINE_RE = new RegExp(`^\\s*${TIMESTAMP_RE.source}\\s*-->\\s*${TIMESTAMP_RE.source}`);
 var V_TAG_RE = /^<v(?:\.\w+)?\s+([^>]+)>\s*(.*)$/;
@@ -63459,7 +63677,7 @@ function parseTranscript(content) {
   return cues;
 }
 function readTranscript(filePath) {
-  const content = fs38.readFileSync(filePath, "utf8");
+  const content = fs40.readFileSync(filePath, "utf8");
   return parseTranscript(content);
 }
 function formatTimestamp(seconds) {
@@ -63535,7 +63753,7 @@ init_constants();
 init_session();
 init_util2();
 init_ansi();
-import * as fs39 from "node:fs";
+import * as fs41 from "node:fs";
 import * as path48 from "node:path";
 function writeRaw(text) {
   const payload = colorStdout() ? text : stripAnsi(text);
@@ -63548,8 +63766,8 @@ function formatTopFiles(ranked) {
   if (ranked.length === 0) return "";
   const lines2 = ["Top files this session:"];
   for (const { path: filePath, count } of ranked) {
-    const basename19 = path48.basename(filePath);
-    lines2.push(`  ${count.toString().padStart(3)}x  ${basename19}  (${filePath})`);
+    const basename20 = path48.basename(filePath);
+    lines2.push(`  ${count.toString().padStart(3)}x  ${basename20}  (${filePath})`);
   }
   return lines2.join("\n");
 }
@@ -63566,11 +63784,11 @@ function renderTopSessionFiles(topN = 5) {
 function renderTopSessionFilesFromDisk(topN = 5, overrideSessionsDir) {
   try {
     const sessionsDir = overrideSessionsDir ?? path48.join(dataDir(), "sessions");
-    if (!fs39.existsSync(sessionsDir)) return "";
-    const files = fs39.readdirSync(sessionsDir).filter((f) => f.endsWith(".json")).map((f) => ({ name: f, mtime: fs39.statSync(path48.join(sessionsDir, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime).slice(0, 3);
+    if (!fs41.existsSync(sessionsDir)) return "";
+    const files = fs41.readdirSync(sessionsDir).filter((f) => f.endsWith(".json")).map((f) => ({ name: f, mtime: fs41.statSync(path48.join(sessionsDir, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime).slice(0, 3);
     for (const { name: name2 } of files) {
       try {
-        const raw = fs39.readFileSync(path48.join(sessionsDir, name2), "utf-8");
+        const raw = fs41.readFileSync(path48.join(sessionsDir, name2), "utf-8");
         const data = JSON.parse(raw);
         const filesList = data["files"];
         if (!Array.isArray(filesList)) continue;
@@ -63633,33 +63851,36 @@ init_constants();
 init_cli_context_stats();
 init_skill_cache();
 init_copilot_cli_install();
+init_install();
 init_ts_refs();
-import * as fs40 from "fs";
+init_parser();
+import * as fs42 from "fs";
 import * as path49 from "path";
 import { execSync, spawnSync as spawnSync7 } from "child_process";
 function checkWorkerRunning(dataDir2) {
   return dataDir2 !== void 0 ? isWorkerRunning(dataDir2) : isWorkerRunning();
 }
+var DB_SIZE_WARN_BYTES = 1024 * 1024 * 1024;
 function checkDbExists(dataDir2) {
   const dbPath = path49.join(dataDir2, "global.db");
-  if (!fs40.existsSync(dbPath)) {
+  if (!fs42.existsSync(dbPath)) {
     return {
       name: "Database",
       status: "warn",
       message: `global.db not found at ${dbPath}`
     };
   }
-  const sizeBytes = fs40.statSync(dbPath).size;
+  const sizeBytes = fs42.statSync(dbPath).size;
   const SQLITE_HEADER = "SQLite format 3\0";
   let header = "";
   try {
-    const fd = fs40.openSync(dbPath, "r");
+    const fd = fs42.openSync(dbPath, "r");
     try {
       const buf = Buffer.alloc(SQLITE_HEADER.length);
-      const bytesRead = fs40.readSync(fd, buf, 0, buf.length, 0);
+      const bytesRead = fs42.readSync(fd, buf, 0, buf.length, 0);
       header = buf.toString("latin1", 0, bytesRead);
     } finally {
-      fs40.closeSync(fd);
+      fs42.closeSync(fd);
     }
   } catch {
   }
@@ -63670,14 +63891,44 @@ function checkDbExists(dataDir2) {
       message: `global.db at ${dbPath} is not a valid SQLite file (${sizeBytes} bytes) \u2014 likely truncated or corrupt`
     };
   }
+  if (sizeBytes > DB_SIZE_WARN_BYTES) {
+    return {
+      name: "Database",
+      status: "warn",
+      message: `global.db is ${Math.round(sizeBytes / (1024 * 1024))} MB at ${dbPath} \u2014 far larger than a healthy index. Large writes against it can exceed the 15s busy_timeout and appear as "database is locked". Try 'token-goat reclaim-index' first (a plain VACUUM, cheap, can recover a useful amount on its own); only reach for 'token-goat reclaim-index --rebuild' if that isn't enough, since --rebuild reparses and re-embeds every indexed file across every project and can take a long time on a large multi-project index`
+    };
+  }
   return {
     name: "Database",
     status: "ok",
     message: `global.db exists (${toKB(sizeBytes)} KB)`
   };
 }
+function checkSymbolBodySize(dbPath) {
+  if (!fs42.existsSync(dbPath)) {
+    return { name: "Symbol body size", status: "ok", message: "no database yet" };
+  }
+  try {
+    const db = getDb(dbPath);
+    const row = db.prepare("SELECT LENGTH(body) as len, file_path as filePath FROM symbols WHERE LENGTH(body) > ? LIMIT 1").get(MAX_SYMBOL_BODY_CHARS);
+    if (row !== void 0) {
+      return {
+        name: "Symbol body size",
+        status: "warn",
+        message: `a stored symbol body in ${row.filePath} is ${row.len} chars, above the ${MAX_SYMBOL_BODY_CHARS}-char cap enforced by boundSymbolBody -- likely a pre-fix leftover from a minified/generated file. A plain 'token-goat reclaim-index' (VACUUM only) CANNOT remove these rows -- it only reclaims freed pages, it never deletes row content. Only 'token-goat reclaim-index --rebuild' drops and re-derives them under the cap (stop the worker first with 'token-goat worker stop', since reclaim-index refuses to run while it's live); --rebuild reparses and re-embeds every indexed file across every project and can take a long time on a large multi-project index`
+      };
+    }
+    return { name: "Symbol body size", status: "ok", message: "no stored symbol body exceeds the cap" };
+  } catch (err2) {
+    return {
+      name: "Symbol body size",
+      status: "warn",
+      message: `could not query symbol body size: ${extractErrorMessage(err2)}`
+    };
+  }
+}
 function checkSymbolCount(dbPath, rootDir) {
-  if (!fs40.existsSync(dbPath)) {
+  if (!fs42.existsSync(dbPath)) {
     return { name: "Symbols", status: "ok", message: "no database yet" };
   }
   try {
@@ -63716,7 +63967,7 @@ var DRAIN_HEARTBEAT_STALE_MS = 6e4;
 function checkDirtyQueueHealth(dataDir2) {
   let pendingCount = 0;
   try {
-    const raw = fs40.readFileSync(dirtyQueuePathFor(dataDir2), "utf8");
+    const raw = fs42.readFileSync(dirtyQueuePathFor(dataDir2), "utf8");
     pendingCount = raw.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).length;
   } catch {
   }
@@ -63732,7 +63983,7 @@ function checkDirtyQueueHealth(dataDir2) {
   }
   let heartbeatAgeMs = null;
   try {
-    heartbeatAgeMs = Date.now() - fs40.statSync(drainHeartbeatPathFor(dataDir2)).mtimeMs;
+    heartbeatAgeMs = Date.now() - fs42.statSync(drainHeartbeatPathFor(dataDir2)).mtimeMs;
   } catch {
   }
   if (heartbeatAgeMs !== null && heartbeatAgeMs > DRAIN_HEARTBEAT_STALE_MS) {
@@ -63772,7 +64023,7 @@ function checkTsCompiler() {
   };
 }
 function checkConfigValid(configPath2) {
-  if (!fs40.existsSync(configPath2)) {
+  if (!fs42.existsSync(configPath2)) {
     return {
       name: "Config",
       status: "warn",
@@ -63780,7 +64031,7 @@ function checkConfigValid(configPath2) {
     };
   }
   try {
-    const content = fs40.readFileSync(configPath2, "utf-8");
+    const content = fs42.readFileSync(configPath2, "utf-8");
     parse(content);
     return {
       name: "Config",
@@ -63807,9 +64058,9 @@ function formatDiskSpace(bytes) {
 }
 var LOW_DISK_WARN_BYTES = 1024 * 1024 * 1024;
 function checkDiskSpace(dataDir2) {
-  if (typeof fs40.statfsSync === "function") {
+  if (typeof fs42.statfsSync === "function") {
     try {
-      const stats = fs40.statfsSync(dataDir2);
+      const stats = fs42.statfsSync(dataDir2);
       const availableBytes = stats.bavail * stats.bsize;
       const status = availableBytes < LOW_DISK_WARN_BYTES ? "warn" : "ok";
       const suffix = status === "warn" ? " \u2014 running low, indexing/embeddings writes may start failing" : "";
@@ -63840,12 +64091,12 @@ function checkDiskSpace(dataDir2) {
   return { name: "Disk Space", status: "warn", message: "disk space check unavailable on this platform" };
 }
 function checkCopilotCli(configPath2, scriptPath) {
-  if (!fs40.existsSync(configPath2) || !fs40.existsSync(scriptPath)) {
+  if (!fs42.existsSync(configPath2) || !fs42.existsSync(scriptPath)) {
     return null;
   }
   let config2;
   try {
-    config2 = JSON.parse(fs40.readFileSync(configPath2, "utf-8"));
+    config2 = JSON.parse(fs42.readFileSync(configPath2, "utf-8"));
   } catch (err2) {
     return {
       name: "Copilot CLI",
@@ -63862,7 +64113,7 @@ function checkCopilotCli(configPath2, scriptPath) {
     };
   }
   const bakedExecPath = /^"([^"]+)"/.exec(preToolUseCommand)?.[1];
-  if (bakedExecPath !== void 0 && !fs40.existsSync(bakedExecPath)) {
+  if (bakedExecPath !== void 0 && !fs42.existsSync(bakedExecPath)) {
     return {
       name: "Copilot CLI",
       status: "fail",
@@ -63907,13 +64158,26 @@ function checkCopilotCli(configPath2, scriptPath) {
   }
   return { name: "Copilot CLI", status: "ok", message: "preToolUse hook invokes cleanly and returns valid JSON" };
 }
+function checkStrayClaudeMdBlocks(searchRoot) {
+  const strays = findStrayClaudeMdBlocks(searchRoot);
+  if (strays.length === 0) {
+    return { name: "CLAUDE.md block", status: "ok", message: "no stray copies outside CLAUDE.md" };
+  }
+  return {
+    name: "CLAUDE.md block",
+    status: "warn",
+    message: `${strays.length} stray cop${strays.length === 1 ? "y" : "ies"} outside CLAUDE.md (never refreshed by install, never removed by uninstall, will go stale): ${strays.join(", ")}`
+  };
+}
 function runDoctor(dataDir2, configPath2, rootDir) {
   const results = [];
   const actualDataDir = dataDir2 || dataDir();
   results.push(checkInstall());
   results.push(checkTsCompiler());
+  results.push(checkStrayClaudeMdBlocks());
   results.push(checkWorkerRunning(actualDataDir) ? { name: "Worker", status: "ok", message: "running" } : { name: "Worker", status: "warn", message: "not running" });
   results.push(checkDbExists(actualDataDir));
+  results.push(checkSymbolBodySize(path49.join(actualDataDir, "global.db")));
   results.push(checkSymbolCount(path49.join(actualDataDir, "global.db"), rootDir));
   results.push(checkDirtyQueueHealth(actualDataDir));
   const actualConfigPath = configPath2 || configPath();
@@ -63953,16 +64217,16 @@ async function runDoctorAndExit(opts) {
     try {
       const dir = skillOutputsDir();
       const pregenPath = path49.join(dir, "pregen.json");
-      if (fs40.existsSync(pregenPath)) {
-        const content = JSON.parse(fs40.readFileSync(pregenPath, "utf-8"));
+      if (fs42.existsSync(pregenPath)) {
+        const content = JSON.parse(fs42.readFileSync(pregenPath, "utf-8"));
         const pregenNames = new Set(content.names || []);
         const skillsSeen = /* @__PURE__ */ new Set();
         try {
-          const entries = fs40.readdirSync(dir, { withFileTypes: true });
+          const entries = fs42.readdirSync(dir, { withFileTypes: true });
           for (const entry of entries) {
             if (!entry.isFile() || !entry.name.endsWith(".meta")) continue;
             try {
-              const meta3 = JSON.parse(fs40.readFileSync(path49.join(dir, entry.name), "utf-8"));
+              const meta3 = JSON.parse(fs42.readFileSync(path49.join(dir, entry.name), "utf-8"));
               if (meta3.skillName && !pregenNames.has(meta3.skillName)) {
                 skillsSeen.add(meta3.skillName);
               }
@@ -64109,7 +64373,7 @@ async function getSectionContent(fileId, heading, opts = {}) {
 
 // src/pack.ts
 init_define_import_meta_env();
-import * as fs41 from "node:fs";
+import * as fs43 from "node:fs";
 import * as path51 from "node:path";
 
 // node_modules/minimatch/dist/esm/index.js
@@ -64137,14 +64401,14 @@ init_define_import_meta_env();
 init_define_import_meta_env();
 var balanced = (a, b, str) => {
   const ma = a instanceof RegExp ? maybeMatch(a, str) : a;
-  const mb = b instanceof RegExp ? maybeMatch(b, str) : b;
-  const r = ma !== null && mb != null && range(ma, mb, str);
+  const mb2 = b instanceof RegExp ? maybeMatch(b, str) : b;
+  const r = ma !== null && mb2 != null && range(ma, mb2, str);
   return r && {
     start: r[0],
     end: r[1],
     pre: str.slice(0, r[0]),
     body: str.slice(r[0] + ma.length, r[1]),
-    post: str.slice(r[1] + mb.length)
+    post: str.slice(r[1] + mb2.length)
   };
 };
 var maybeMatch = (reg, str) => {
@@ -65999,24 +66263,24 @@ function isPathWithinRoot(rootReal, resolvedPath) {
 function openWithinRoot(rootReal, p) {
   let fd;
   try {
-    fd = fs41.openSync(p, "r");
+    fd = fs43.openSync(p, "r");
   } catch {
     return null;
   }
   let ownershipTransferred = false;
   try {
-    const stat2 = fs41.fstatSync(fd);
+    const stat2 = fs43.fstatSync(fd);
     if (!stat2.isFile()) return null;
     let realPath;
     try {
-      realPath = fs41.realpathSync(p);
+      realPath = fs43.realpathSync(p);
     } catch {
       return "outside-root";
     }
     if (!isPathWithinRoot(rootReal, realPath)) return "outside-root";
     let realStat;
     try {
-      realStat = fs41.statSync(realPath);
+      realStat = fs43.statSync(realPath);
     } catch {
       return "outside-root";
     }
@@ -66026,7 +66290,7 @@ function openWithinRoot(rootReal, p) {
   } finally {
     if (!ownershipTransferred) {
       try {
-        fs41.closeSync(fd);
+        fs43.closeSync(fd);
       } catch {
       }
     }
@@ -66050,7 +66314,7 @@ function* resolveOpenCandidates(projectRoot, patterns, rootReal, ignorePatterns,
       continue;
     }
     if (ignorePatterns && matches(rel, ignorePatterns)) {
-      fs41.closeSync(opened.fd);
+      fs43.closeSync(opened.fd);
       continue;
     }
     yield { p, rel, fd: opened.fd, stat: opened.stat };
@@ -66071,18 +66335,17 @@ function advanceQuoteState(text, from, to, state) {
       backslashes++;
       continue;
     }
-    if (backslashes % 2 === 0) {
-      if (ch === '"') state.dq = !state.dq;
-      else if (ch === "'") state.sq = !state.sq;
-      else if (ch === "`") state.bt = !state.bt;
+    if (backslashes % 2 === 0 && (ch === '"' || ch === "'" || ch === "`")) {
+      if (state.open === null) state.open = ch;
+      else if (state.open === ch) state.open = null;
     }
     backslashes = 0;
   }
   return state;
 }
 function computeLineStartQuoteStates(content) {
-  const states = [{ dq: false, sq: false, bt: false }];
-  let state = { dq: false, sq: false, bt: false };
+  const states = [{ open: null }];
+  let state = { open: null };
   let lineStart = 0;
   for (let i = 0; i < content.length; i++) {
     if (content[i] === "\n") {
@@ -66096,9 +66359,9 @@ function computeLineStartQuoteStates(content) {
 function isInsideStringLiteral2(text, index, lineStates) {
   const lineStart = text.lastIndexOf("\n", index - 1) + 1;
   const lineNum = text.slice(0, lineStart).split("\n").length - 1;
-  const startState = lineStates[lineNum] ?? { dq: false, sq: false, bt: false };
+  const startState = lineStates[lineNum] ?? { open: null };
   const state = advanceQuoteState(text, lineStart, index, { ...startState });
-  return state.dq || state.sq || state.bt;
+  return state.open !== null;
 }
 function stripLineComments(content, pattern, lineStates) {
   return content.replace(
@@ -66177,7 +66440,7 @@ function collectFiles(projectRoot, patterns, opts = {}) {
   const rootResolved = path51.resolve(projectRoot);
   let rootReal;
   try {
-    rootReal = fs41.realpathSync(rootResolved);
+    rootReal = fs43.realpathSync(rootResolved);
   } catch {
     rootReal = rootResolved;
   }
@@ -66191,7 +66454,7 @@ function collectFiles(projectRoot, patterns, opts = {}) {
       }
       let content;
       try {
-        content = fs41.readFileSync(fd, "utf8");
+        content = fs43.readFileSync(fd, "utf8");
       } catch {
         result.skipped.push(`${rel} (unreadable)`);
         continue;
@@ -66213,13 +66476,13 @@ function collectFiles(projectRoot, patterns, opts = {}) {
       result.total_lines += lines2;
       result.total_tokens += tokens;
     } finally {
-      fs41.closeSync(fd);
+      fs43.closeSync(fd);
     }
   }
   return result;
 }
 function collectFromStdin(projectRoot, opts = {}) {
-  const input = fs41.readFileSync(0, "utf8");
+  const input = fs43.readFileSync(0, "utf8");
   const paths = input.split("\n").map((ln) => ln.trim()).filter((ln) => ln.length > 0);
   return collectFiles(projectRoot, paths, opts);
 }
@@ -66352,7 +66615,7 @@ function estimateBudget(projectRoot, patterns, opts = {}) {
   const rootResolved = path51.resolve(projectRoot);
   let rootReal;
   try {
-    rootReal = fs41.realpathSync(rootResolved);
+    rootReal = fs43.realpathSync(rootResolved);
   } catch {
     rootReal = rootResolved;
   }
@@ -66367,7 +66630,7 @@ function estimateBudget(projectRoot, patterns, opts = {}) {
       let lines2;
       let tokens;
       try {
-        const data = fs41.readFileSync(fd);
+        const data = fs43.readFileSync(fd);
         const sampleSize = Math.min(1e3, data.length);
         const sampleLines = (data.toString("utf8", 0, sampleSize).match(/\n/g) || []).length;
         lines2 = data.length > sampleSize ? Math.ceil(sampleLines * (data.length / sampleSize)) : sampleLines + 1;
@@ -66385,7 +66648,7 @@ function estimateBudget(projectRoot, patterns, opts = {}) {
       result.total_lines += lines2;
       result.total_tokens += tokens;
     } finally {
-      fs41.closeSync(fd);
+      fs43.closeSync(fd);
     }
   }
   result.entries.sort((a, b) => b.tokens - a.tokens);
@@ -66802,7 +67065,7 @@ function formatFailureDeltaJson(delta, runner) {
 init_define_import_meta_env();
 init_constants();
 init_util2();
-import * as fs42 from "node:fs";
+import * as fs44 from "node:fs";
 import * as path52 from "node:path";
 var KEY_RE = /^[A-Za-z0-9_-]{1,80}$/;
 var DEFAULT_FAILURES_STATE_KEY = "default";
@@ -66820,8 +67083,8 @@ function failuresStatePath(projectHash2, key) {
 function loadFailureSnapshot(projectHash2, key) {
   const p = failuresStatePath(projectHash2, key);
   try {
-    if (!fs42.existsSync(p)) return null;
-    const parsed = JSON.parse(fs42.readFileSync(p, "utf-8"));
+    if (!fs44.existsSync(p)) return null;
+    const parsed = JSON.parse(fs44.readFileSync(p, "utf-8"));
     if (typeof parsed !== "object" || parsed === null) return null;
     const obj = parsed;
     if (!Array.isArray(obj.signatures)) return null;
@@ -66860,14 +67123,14 @@ init_graph_commands();
 init_index_reader();
 init_paths();
 init_project();
-import * as fs44 from "fs";
+import * as fs46 from "fs";
 import * as path54 from "path";
 
 // src/project_memory.ts
 init_define_import_meta_env();
 init_constants();
 init_util2();
-import * as fs43 from "node:fs";
+import * as fs45 from "node:fs";
 import * as path53 from "node:path";
 var MAX_ENTRIES = 30;
 var KEY_RE2 = /^[A-Za-z0-9_-]{1,80}$/;
@@ -66917,10 +67180,10 @@ function parseTOML(content) {
 }
 function loadRaw(filePath) {
   try {
-    if (!fs43.existsSync(filePath)) {
+    if (!fs45.existsSync(filePath)) {
       return {};
     }
-    const content = fs43.readFileSync(filePath, "utf-8");
+    const content = fs45.readFileSync(filePath, "utf-8");
     return parseTOML(content);
   } catch {
     return {};
@@ -66978,7 +67241,7 @@ function unsetEntry(projectHash2, key) {
 function clearAll(projectHash2) {
   const p = memoryPath(projectHash2);
   const doClear = () => {
-    if (fs43.existsSync(p)) {
+    if (fs45.existsSync(p)) {
       save(p, {});
     }
     return true;
@@ -66991,8 +67254,8 @@ init_read_commands();
 init_session();
 init_util2();
 function readInput(src) {
-  if (src !== void 0) return fs44.readFileSync(src, "utf8");
-  return fs44.readFileSync(0, "utf8");
+  if (src !== void 0) return fs46.readFileSync(src, "utf8");
+  return fs46.readFileSync(0, "utf8");
 }
 function splitLines2(text) {
   return text.split(/\r?\n/);
@@ -67019,7 +67282,7 @@ function isInsideStringLiteral3(line, markerIndex) {
 function scanFileForTodos(filePath, kindSet) {
   let text;
   try {
-    text = fs44.readFileSync(filePath, "utf8");
+    text = fs46.readFileSync(filePath, "utf8");
   } catch {
     return [];
   }
@@ -67043,7 +67306,7 @@ function collectTodoFiles(patterns) {
     for (const p of patterns) {
       const abs = path54.resolve(p);
       try {
-        const stat2 = fs44.statSync(abs);
+        const stat2 = fs46.statSync(abs);
         if (stat2.isDirectory()) {
           results.push(...walkProject(abs).files);
         } else {
@@ -67475,7 +67738,7 @@ var LOCK_PRIORITY = [
   "Cargo.lock"
 ];
 function findLockfile(startPath) {
-  const stat2 = fs44.statSync(startPath, { throwIfNoEntry: false });
+  const stat2 = fs46.statSync(startPath, { throwIfNoEntry: false });
   if (stat2 !== void 0 && stat2.isFile()) {
     return { file: startPath, others: [] };
   }
@@ -67483,10 +67746,10 @@ function findLockfile(startPath) {
   const found = [];
   for (const name2 of LOCK_PRIORITY) {
     const candidate = path54.join(dir, name2);
-    if (fs44.existsSync(candidate)) found.push(candidate);
+    if (fs46.existsSync(candidate)) found.push(candidate);
   }
   try {
-    const entries = fs44.readdirSync(dir);
+    const entries = fs46.readdirSync(dir);
     for (const e of entries) {
       if (/^requirements.*\.txt$/.test(e)) {
         const p = path54.join(dir, e);
@@ -67687,7 +67950,7 @@ function parsePnpmLock(content) {
 }
 function parseLockFile(filePath) {
   const base = path54.basename(filePath);
-  const content = fs44.readFileSync(filePath, "utf8");
+  const content = fs46.readFileSync(filePath, "utf8");
   if (base === "package-lock.json") return { format: "npm", deps: parsePackageLockJson(content) };
   if (base === "yarn.lock") return { format: "yarn", deps: parseYarnLock(content) };
   if (base === "pnpm-lock.yaml") return { format: "pnpm", deps: parsePnpmLock(content) };
@@ -67760,7 +68023,7 @@ function cmdLockdepsPackage(lockfile, format, deps, query, json2) {
   }
   const primary = matches2.find((d) => d.kind === "direct") ?? matches2[0];
   const otherVersions = [...new Set(matches2.filter((d) => d.version !== primary.version).map((d) => d.version))];
-  const graph = format === "npm" ? buildNpmEdges(fs44.readFileSync(lockfile, "utf8")) : null;
+  const graph = format === "npm" ? buildNpmEdges(fs46.readFileSync(lockfile, "utf8")) : null;
   const graphAvailable = graph !== null;
   const dependsOn = graph !== null ? [...graph.edges.get(query) ?? []].sort() : [];
   const dependedOnBy = graph !== null ? findReverseDirectDeps(query, graph.edges, graph.directNames) : [];
@@ -67894,7 +68157,7 @@ function loadAllSessionReadCounts() {
   const totals = /* @__PURE__ */ new Map();
   let entries;
   try {
-    entries = fs44.readdirSync(sessionsDir, { withFileTypes: true });
+    entries = fs46.readdirSync(sessionsDir, { withFileTypes: true });
   } catch {
     return totals;
   }
@@ -67903,7 +68166,7 @@ function loadAllSessionReadCounts() {
     const filePath = path54.join(sessionsDir, entry.name);
     let raw;
     try {
-      raw = JSON.parse(fs44.readFileSync(filePath, "utf8"));
+      raw = JSON.parse(fs46.readFileSync(filePath, "utf8"));
     } catch {
       continue;
     }
@@ -67979,7 +68242,7 @@ function detectWalkMode(cwd) {
   if (project?.marker === ".git") return "git";
   let cur = cwd;
   while (true) {
-    if (fs44.existsSync(path54.join(cur, ".git"))) return "git";
+    if (fs46.existsSync(path54.join(cur, ".git"))) return "git";
     const parent = path54.dirname(cur);
     if (parent === cur) break;
     cur = parent;
@@ -68035,7 +68298,7 @@ init_overflow_guard();
 init_stats();
 init_util2();
 import { createRequire as createRequire7 } from "node:module";
-import * as fs45 from "node:fs";
+import * as fs47 from "node:fs";
 import * as path55 from "node:path";
 var _require6 = createRequire7(import.meta.url);
 var _ts2 = null;
@@ -68055,21 +68318,21 @@ function loadTs2() {
 }
 function dirExists(p) {
   try {
-    return fs45.statSync(p).isDirectory();
+    return fs47.statSync(p).isDirectory();
   } catch {
     return false;
   }
 }
 function fileExists2(p) {
   try {
-    return fs45.statSync(p).isFile();
+    return fs47.statSync(p).isFile();
   } catch {
     return false;
   }
 }
 function readFileTextOrNull(p) {
   try {
-    return fs45.readFileSync(p, "utf8");
+    return fs47.readFileSync(p, "utf8");
   } catch {
     return null;
   }
@@ -68077,7 +68340,7 @@ function readFileTextOrNull(p) {
 function listInstalledPackageNames(nodeModulesDir) {
   let entries;
   try {
-    entries = fs45.readdirSync(nodeModulesDir, { withFileTypes: true });
+    entries = fs47.readdirSync(nodeModulesDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -68087,7 +68350,7 @@ function listInstalledPackageNames(nodeModulesDir) {
     if (entry.name.startsWith("@")) {
       let scoped;
       try {
-        scoped = fs45.readdirSync(path55.join(nodeModulesDir, entry.name), { withFileTypes: true });
+        scoped = fs47.readdirSync(path55.join(nodeModulesDir, entry.name), { withFileTypes: true });
       } catch {
         continue;
       }
@@ -68109,7 +68372,7 @@ function findReadmeFile(pkgDir) {
 function findReadmeIn(dir) {
   let entries;
   try {
-    entries = fs45.readdirSync(dir, { withFileTypes: true });
+    entries = fs47.readdirSync(dir, { withFileTypes: true });
   } catch {
     return null;
   }
@@ -68247,7 +68510,7 @@ function runDepDocs(opts) {
     const hint = suggestions.length > 0 ? ` (did you mean: ${suggestions.join(", ")}?)` : "";
     return { text: `Package '${opts.packageName}' not found under ${nodeModulesDir}${hint}`, code: 1 };
   }
-  const pkgJsonRaw = fs45.readFileSync(pkgJsonPath, "utf8");
+  const pkgJsonRaw = fs47.readFileSync(pkgJsonPath, "utf8");
   let pkgJson;
   try {
     pkgJson = JSON.parse(pkgJsonRaw);
@@ -68331,11 +68594,11 @@ init_install();
 // src/webfetch.ts
 init_define_import_meta_env();
 init_constants();
-import { existsSync as existsSync32, readdirSync as readdirSync19, statSync as statSync26, unlinkSync as unlinkSync12 } from "fs";
+import { existsSync as existsSync32, readdirSync as readdirSync20, statSync as statSync26, unlinkSync as unlinkSync12 } from "fs";
 import * as http from "http";
 import * as https from "https";
 import { isIPv4, isIPv6 } from "net";
-import { resolve as resolve15, join as join40 } from "path";
+import { resolve as resolve16, join as join40 } from "path";
 import { URL as URL2 } from "url";
 import { promisify } from "util";
 import { lookup as dnsLookup } from "dns";
@@ -68504,10 +68767,10 @@ function cleanupStaleDownloads() {
   if (!existsSync32(cacheDir)) return 0;
   let removed = 0;
   try {
-    const files = readdirSync19(cacheDir);
+    const files = readdirSync20(cacheDir);
     for (const file2 of files) {
       if (file2.endsWith(".tmp")) {
-        const filePath = resolve15(cacheDir, file2);
+        const filePath = resolve16(cacheDir, file2);
         try {
           const stat2 = statSync26(filePath);
           if (Date.now() - stat2.mtimeMs < STALE_DOWNLOAD_AGE_MS) continue;
@@ -69067,6 +69330,121 @@ function cmdBaseline(opts) {
   process.stdout.write(out2 + String.fromCharCode(10));
 }
 
+// src/index_reclaim.ts
+init_define_import_meta_env();
+init_db();
+init_constants();
+init_worker();
+import * as fs48 from "node:fs";
+import * as path56 from "node:path";
+var DERIVED_TABLES = ["chunk_vectors", "chunks", "refs", "symbols", "files"];
+function indexSizeBytes(dbPath) {
+  let total = 0;
+  for (const p of [dbPath, `${dbPath}-wal`]) {
+    try {
+      total += fs48.statSync(p).size;
+    } catch {
+    }
+  }
+  return total;
+}
+function tableExists(db, table) {
+  const row = db.prepare(`SELECT 1 AS present FROM sqlite_master WHERE type IN ('table','view') AND name = ?`).get(table);
+  return row?.present === 1;
+}
+function reclaimIndex(dbPath, opts = {}) {
+  const rebuild = opts.rebuild === true;
+  const beforeBytes = indexSizeBytes(dbPath);
+  const db = getDb(dbPath);
+  const dropped = {};
+  if (rebuild) {
+    db.transaction(() => {
+      for (const table of DERIVED_TABLES) {
+        if (!tableExists(db, table)) continue;
+        const before = db.prepare(`SELECT count(*) AS c FROM "${table}"`).get().c;
+        db.prepare(`DELETE FROM "${table}"`).run();
+        dropped[table] = before;
+      }
+    })();
+    if (tableExists(db, "symbols_fts")) {
+      try {
+        db.prepare(`INSERT INTO symbols_fts(symbols_fts) VALUES('rebuild')`).run();
+      } catch {
+      }
+    }
+  }
+  const checkpointBusy = walCheckpointBusy(db);
+  const vacuumDeferred = !vacuumOrDefer(db);
+  const finalCheckpointBusy = walCheckpointBusy(db);
+  return {
+    beforeBytes,
+    afterBytes: indexSizeBytes(dbPath),
+    dropped,
+    rebuilt: rebuild,
+    checkpointBusy: checkpointBusy || finalCheckpointBusy,
+    vacuumDeferred
+  };
+}
+function vacuumOrDefer(db) {
+  try {
+    db.exec("VACUUM");
+    return true;
+  } catch (err2) {
+    const code = err2.code ?? "";
+    if (!code.startsWith("SQLITE_BUSY") && !code.startsWith("SQLITE_LOCKED")) throw err2;
+    return false;
+  }
+}
+function walCheckpointBusy(db) {
+  const rows = db.pragma("wal_checkpoint(TRUNCATE)");
+  return rows[0]?.busy === 1;
+}
+function mb(bytes) {
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function cmdReclaimIndex(opts) {
+  const dbPath = opts.dbPath ?? globalDbPath();
+  if (opts.force !== true && isWorkerRunning(path56.dirname(dbPath))) {
+    throw new Error(
+      "reclaim-index: the worker daemon is running and writing to this index. Stop it first with 'token-goat worker stop', then re-run. Pass --force to proceed anyway (results may be inaccurate if the worker is really live)."
+    );
+  }
+  const result = reclaimIndex(dbPath, { rebuild: opts.rebuild === true });
+  if (opts.json === true) {
+    process.stdout.write(JSON.stringify({ dbPath, ...result }, null, 2) + "\n");
+    return;
+  }
+  const freed = result.beforeBytes - result.afterBytes;
+  process.stdout.write(`reclaim-index: ${dbPath}
+`);
+  process.stdout.write(
+    `  ${mb(result.beforeBytes)} -> ${mb(result.afterBytes)} (freed ${mb(freed)})
+`
+  );
+  if (result.rebuilt) {
+    for (const [table, n] of Object.entries(result.dropped)) {
+      process.stdout.write(`  dropped ${n} row(s) from ${table}
+`);
+    }
+    process.stdout.write(
+      `  derived rows dropped -- run 'token-goat index' in each project to rebuild them
+`
+    );
+  }
+  if (result.vacuumDeferred) {
+    process.stdout.write(
+      `  note: VACUUM could not get an exclusive lock and was skipped, so on-disk size may be unchanged. The index itself was reclaimed; re-run 'token-goat reclaim-index' once nothing else is using the database to release the freed pages
+`
+    );
+  }
+  if (result.checkpointBusy) {
+    process.stdout.write(
+      `  note: a concurrent reader blocked WAL truncation, so some space may still be held in ${path56.basename(dbPath)}-wal
+`
+    );
+  }
+}
+
 // src/config_commands.ts
 init_define_import_meta_env();
 init_dist();
@@ -69076,13 +69454,14 @@ init_image_shrink();
 init_project();
 init_index_prune();
 init_disk_cache();
-import * as fs46 from "node:fs";
+import * as fs49 from "node:fs";
 import * as os18 from "node:os";
-import * as path56 from "node:path";
+import * as path57 from "node:path";
 init_util2();
 init_paths();
 init_ansi();
 init_constants();
+init_stats();
 function emit4(text) {
   const payload = colorStdout() ? text : stripAnsi(text);
   process.stdout.write(ensureNewline(payload));
@@ -69091,7 +69470,7 @@ function emitErr4(text) {
   process.stderr.write(ensureNewline(text));
 }
 function saveConfigSafe(cfg) {
-  ensureDirSync(path56.dirname(configPath()));
+  ensureDirSync(path57.dirname(configPath()));
   saveConfig(cfg);
 }
 function levenshtein(a, b, cap = 3) {
@@ -69251,7 +69630,7 @@ function cmdConfig(opts) {
       const parseErrAtLoad = getLastConfigParseError();
       if (parseErrAtLoad !== null) {
         try {
-          fs46.copyFileSync(configPath(), `${configPath()}.bak`);
+          fs49.copyFileSync(configPath(), `${configPath()}.bak`);
           emitErr4(`config set: warning: config.toml failed to parse (${parseErrAtLoad}); backed up the original to config.toml.bak and rewriting it from defaults`);
         } catch {
         }
@@ -69287,8 +69666,8 @@ function cmdConfig(opts) {
       saveConfigSafe(cfg);
       return coercedValue;
     };
-    ensureDirSync(path56.dirname(configPath()));
-    const lockPath = path56.join(path56.dirname(configPath()), ".config.lock");
+    ensureDirSync(path57.dirname(configPath()));
+    const lockPath = path57.join(path57.dirname(configPath()), ".config.lock");
     const lockResult = withFileLock(lockPath, applySet, { waitMs: LOCK_WAIT_MS_HARDENED });
     const coerced = lockResult === void 0 ? applySet() : lockResult;
     invalidateConfigCache();
@@ -69316,7 +69695,7 @@ function cmdConfig(opts) {
     let raw = {};
     let parseErr = null;
     try {
-      const text = fs46.readFileSync(cfgFile, "utf8");
+      const text = fs49.readFileSync(cfgFile, "utf8");
       raw = parse(text);
     } catch (e) {
       const code = e.code;
@@ -69399,7 +69778,7 @@ function cmdProject(opts) {
       emitErr4("project exclude requires a path argument");
       throw new Error("missing path");
     }
-    const target = path56.resolve(opts.pathArg);
+    const target = path57.resolve(opts.pathArg);
     const cfg = loadPersistedConfig();
     const targetFolded = foldPath(normalizePath(target));
     if (cfg.worker.blocked_roots.some((r) => foldPath(normalizePath(r)) === targetFolded)) {
@@ -69421,7 +69800,7 @@ function cmdProject(opts) {
     const before = cfg.worker.blocked_roots;
     const after = before.filter((r) => {
       try {
-        return fs46.existsSync(r);
+        return fs49.existsSync(r);
       } catch {
         return false;
       }
@@ -69463,19 +69842,27 @@ function cmdProject(opts) {
   emitErr4(`project: unknown action '${action}'. Use list, exclude, or prune.`);
   throw new Error(`unknown project action: ${action}`);
 }
+function recordCompactDocStat(fullSourceBytes, emittedText, detail) {
+  const bytesSaved = Math.max(1, fullSourceBytes - Buffer.byteLength(emittedText, "utf8"));
+  recordStat("compact_doc", bytesSaved, Math.round(bytesSaved / 4), void 0, detail);
+}
 function cmdCompactDoc(opts) {
-  const resolved = path56.resolve(opts.filePath);
+  const resolved = path57.resolve(opts.filePath);
   if (opts.heading !== void 0) {
     const result = compactDoc(resolved, opts.heading);
     if (result === null) {
       emitErr4(`compact-doc: could not read or compact '${resolved}'`);
       throw new Error(`could not compact: ${resolved}`);
     }
+    const legacyFullBytes = fs49.statSync(resolved).size;
     if (opts.json === true) {
-      emit4(JSON.stringify({ path: resolved, compact: result }, null, 2));
+      const jsonText = JSON.stringify({ path: resolved, compact: result }, null, 2);
+      emit4(jsonText);
+      recordCompactDocStat(legacyFullBytes, jsonText, resolved);
       return;
     }
     emit4(result);
+    recordCompactDocStat(legacyFullBytes, result, resolved);
     return;
   }
   let sentences;
@@ -69494,7 +69881,7 @@ function cmdCompactDoc(opts) {
   if (opts.force === true || opts.sentences !== void 0 || !fresh) {
     let sourceText;
     try {
-      sourceText = fs46.readFileSync(resolved, "utf-8");
+      sourceText = fs49.readFileSync(resolved, "utf-8");
     } catch {
       emitErr4(`compact-doc: could not read or compact '${resolved}'`);
       throw new Error(`could not compact: ${resolved}`);
@@ -69510,12 +69897,16 @@ function cmdCompactDoc(opts) {
     }
     body = existing;
   }
+  const extractiveFullBytes = fs49.statSync(resolved).size;
   if (opts.json === true) {
-    emit4(JSON.stringify({ path: resolved, compactPath, rebuilt, compact: body }, null, 2));
+    const jsonText = JSON.stringify({ path: resolved, compactPath, rebuilt, compact: body }, null, 2);
+    emit4(jsonText);
+    recordCompactDocStat(extractiveFullBytes, jsonText, resolved);
     return;
   }
   if (opts.show === true) {
     emit4(body);
+    recordCompactDocStat(extractiveFullBytes, body, resolved);
     return;
   }
   emit4(
@@ -69563,7 +69954,7 @@ async function cmdFetchImage(opts) {
     throw new Error(`fetch failed: ${opts.url}`, { cause: e });
   }
   const buf = fetched.body;
-  const outPath = opts.out ?? path56.join(os18.tmpdir(), `tg-fetch-${Date.now()}${extensionForContentType(fetched.contentType)}`);
+  const outPath = opts.out ?? path57.join(os18.tmpdir(), `tg-fetch-${Date.now()}${extensionForContentType(fetched.contentType)}`);
   const originalBytes = buf.length;
   let shrunkBytes;
   let outData;
@@ -69652,8 +70043,8 @@ init_cli_context_stats();
 init_memory_prune();
 init_project();
 init_confirm_apply();
-import * as fs47 from "node:fs";
-import * as path57 from "node:path";
+import * as fs50 from "node:fs";
+import * as path58 from "node:path";
 function removeExactDupLines(text, report) {
   if (report.exactDupLines.length === 0) return text;
   const toRemove = new Set(report.exactDupLines.map(([, dupIdx]) => dupIdx));
@@ -69711,7 +70102,7 @@ function printReport(reports, clusters) {
   } else {
     for (const cluster of clusters) {
       w(
-        `  [${cluster.method}, similarity ${cluster.similarity}, ~${cluster.tokens} tok] ${cluster.members.map((m) => path57.basename(m)).join(", ")}
+        `  [${cluster.method}, similarity ${cluster.similarity}, ~${cluster.tokens} tok] ${cluster.members.map((m) => path58.basename(m)).join(", ")}
 `
       );
     }
@@ -69726,7 +70117,7 @@ async function runMemoryCommand(opts = {}) {
   const claudeMds = findClaudeMdFiles(projectRoot);
   const reports = auditClaudeMd(claudeMds);
   const memoryMdPath = findMemoryMd(projectRoot);
-  const clusters = memoryMdPath !== null ? await findContentDuplicates(path57.dirname(memoryMdPath)) : [];
+  const clusters = memoryMdPath !== null ? await findContentDuplicates(path58.dirname(memoryMdPath)) : [];
   printReport(reports, clusters);
   if (opts.fix !== true) return;
   const changes = [];
@@ -69734,7 +70125,7 @@ async function runMemoryCommand(opts = {}) {
     if (report.exactDupLines.length === 0) continue;
     let before;
     try {
-      before = fs47.readFileSync(report.path, "utf-8");
+      before = fs50.readFileSync(report.path, "utf-8");
     } catch {
       continue;
     }
@@ -69773,34 +70164,34 @@ async function runMemoryCommand(opts = {}) {
 // src/cli_waste.ts
 init_define_import_meta_env();
 init_project();
-import * as fs49 from "node:fs";
-import * as path59 from "node:path";
+import * as fs52 from "node:fs";
+import * as path60 from "node:path";
 
 // src/waste.ts
 init_define_import_meta_env();
 init_overflow_guard();
-import * as fs48 from "node:fs";
+import * as fs51 from "node:fs";
 import * as os19 from "node:os";
-import * as path58 from "node:path";
+import * as path59 from "node:path";
 function projectTranscriptsDir(projectRoot) {
-  const rootStr = path58.resolve(projectRoot);
+  const rootStr = path59.resolve(projectRoot);
   const slug = rootStr.replace(/[^A-Za-z0-9]/g, "-");
-  return path58.join(os19.homedir(), ".claude", "projects", slug);
+  return path59.join(os19.homedir(), ".claude", "projects", slug);
 }
 function findLatestTranscript(projectRoot) {
   const dir = projectTranscriptsDir(projectRoot);
   let entries;
   try {
-    entries = fs48.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    entries = fs51.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
   } catch {
     return null;
   }
   let best = null;
   for (const name2 of entries) {
-    const full = path58.join(dir, name2);
+    const full = path59.join(dir, name2);
     let stat2;
     try {
-      stat2 = fs48.statSync(full);
+      stat2 = fs51.statSync(full);
     } catch {
       continue;
     }
@@ -69857,7 +70248,7 @@ function extractResultText(content) {
   return "";
 }
 function parseTranscript2(transcriptPath) {
-  const raw = fs48.readFileSync(transcriptPath, "utf-8");
+  const raw = fs51.readFileSync(transcriptPath, "utf-8");
   const calls = [];
   const resultTextById = /* @__PURE__ */ new Map();
   let seq = 0;
@@ -70050,7 +70441,7 @@ function printReport2(report) {
 }
 async function runWasteCommand(opts = {}) {
   const projectRoot = resolveProjectRoot(opts.project !== void 0 ? { project: opts.project } : {});
-  const transcriptPath = opts.transcript !== void 0 ? path59.resolve(opts.transcript) : findLatestTranscript(projectRoot);
+  const transcriptPath = opts.transcript !== void 0 ? path60.resolve(opts.transcript) : findLatestTranscript(projectRoot);
   if (transcriptPath === null) {
     if (opts.json === true) {
       process.stdout.write(`${JSON.stringify({ error: "no session transcript found", project: projectRoot })}
@@ -70064,7 +70455,7 @@ async function runWasteCommand(opts = {}) {
     process.exitCode = 1;
     return;
   }
-  if (!fs49.existsSync(transcriptPath)) {
+  if (!fs52.existsSync(transcriptPath)) {
     process.stderr.write(`token-goat: transcript not found: ${transcriptPath}
 `);
     process.exitCode = 1;
@@ -70082,18 +70473,18 @@ async function runWasteCommand(opts = {}) {
 // src/session_read.ts
 init_define_import_meta_env();
 init_compact();
-import * as fs50 from "node:fs";
-import * as path60 from "node:path";
+import * as fs53 from "node:fs";
+import * as path61 from "node:path";
 import * as readline2 from "node:readline";
 init_project();
 function resolveSessionTranscript(arg, opts = {}) {
   if (arg !== void 0 && arg !== "") {
-    if (fs50.existsSync(arg) && fs50.statSync(arg).isFile()) return arg;
+    if (fs53.existsSync(arg) && fs53.statSync(arg).isFile()) return arg;
     const projectRoot2 = resolveProjectRoot(opts.project !== void 0 ? { project: opts.project } : {});
     const dir = projectTranscriptsDir(projectRoot2);
     const byId = arg.endsWith(".jsonl") ? arg : `${arg}.jsonl`;
-    const candidate = path60.join(dir, byId);
-    if (fs50.existsSync(candidate) && fs50.statSync(candidate).isFile()) return candidate;
+    const candidate = path61.join(dir, byId);
+    if (fs53.existsSync(candidate) && fs53.statSync(candidate).isFile()) return candidate;
     return null;
   }
   const projectRoot = resolveProjectRoot(opts.project !== void 0 ? { project: opts.project } : {});
@@ -70151,7 +70542,7 @@ function toolCallsForBlocks(blocks) {
   return blocks.filter((b) => b.type === "tool_use" && b.name !== void 0).map((b) => b.name);
 }
 async function* streamTurns(transcriptPath) {
-  const input = fs50.createReadStream(transcriptPath, { encoding: "utf8" });
+  const input = fs53.createReadStream(transcriptPath, { encoding: "utf8" });
   const rl = readline2.createInterface({ input, crlfDelay: Infinity });
   try {
     let lineNumber = 0;
@@ -70252,15 +70643,15 @@ function formatSessionSlice(turns) {
 init_define_import_meta_env();
 init_project();
 init_disk_cache();
-import * as fs51 from "node:fs";
-import * as path61 from "node:path";
+import * as fs54 from "node:fs";
+import * as path62 from "node:path";
 function readMcpConfig(projectRoot) {
-  const configPath2 = path61.join(projectRoot, ".mcp.json");
+  const configPath2 = path62.join(projectRoot, ".mcp.json");
   try {
-    if (!fs51.existsSync(configPath2)) {
+    if (!fs54.existsSync(configPath2)) {
       return null;
     }
-    const content = fs51.readFileSync(configPath2, "utf-8");
+    const content = fs54.readFileSync(configPath2, "utf-8");
     const parsed = JSON.parse(content);
     return parsed.mcpServers || parsed;
   } catch {
@@ -70569,8 +70960,8 @@ function requirePositiveInt(flag, raw) {
 }
 async function cmdSemantic(query, opts) {
   const limit = opts.limit !== void 0 ? requireNonNegativeInt("--limit", opts.limit) : 20;
-  const { text, code } = await runSemantic(query, { limit });
-  (code === 0 ? out : err)(text);
+  const { text, code } = await runSemantic(query, { limit, ...opts.json === true ? { json: true } : {} });
+  (opts.json === true || code === 0 ? out : err)(text);
   process.exitCode = code;
 }
 async function cmdIndex(pathArg, opts = {}) {
@@ -70584,7 +70975,13 @@ async function cmdIndex(pathArg, opts = {}) {
         `no tracked files found under '${root}' (is it a git repo?). Pass --walk to index a non-git folder.`
       );
     }
-    files = collectWalkIndexFiles(root);
+    files = collectWalkIndexFiles(root, { force: opts.forceWalk === true });
+    if (opts.forceWalk === true) {
+      process.stderr.write(
+        `token-goat: --force-walk raised the walk cap to ${MAX_FILES_SCANNED_FORCED} files; indexing ${files.length} files may take a long time and produce a large index. Run 'token-goat doctor' afterwards to check index size.
+`
+      );
+    }
   }
   const blockedRoots = loadConfig().worker.blocked_roots;
   const ixCfg = loadConfig().indexing;
@@ -70671,8 +71068,8 @@ async function cmdMcpServe() {
   const server = createMcpServer2();
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  await new Promise((resolve20) => {
-    server.server.onclose = resolve20;
+  await new Promise((resolve21) => {
+    server.server.onclose = resolve21;
   });
 }
 async function cmdHook(event, opts) {
@@ -70689,6 +71086,9 @@ async function cmdInstall(opts) {
   out(
     claudeMdResult.alreadyInstalled ? `CLAUDE.md block already up to date \u2192 ${claudeMdResult.path}` : `Updated CLAUDE.md \u2192 ${claudeMdResult.path}`
   );
+  for (const stray of findStrayClaudeMdBlocks()) {
+    out(`WARNING: stray token-goat block in ${stray} \u2014 not managed by install/uninstall; delete it to avoid duplicate, stale guidance.`);
+  }
   const skillResult = installSkill();
   out(
     skillResult.alreadyInstalled ? `token-goat skill already up to date \u2192 ${skillResult.path}` : `Installed token-goat skill \u2192 ${skillResult.path}`
@@ -70738,7 +71138,7 @@ async function cmdInstall(opts) {
     if (copilotResult.alreadyInstalled) {
       out(`Copilot CLI integration already installed \u2192 ${copilotResult.configPath}`);
     } else {
-      out(`Installed token-goat Copilot CLI integration \u2192 ${copilotResult.configPath}, ${copilotResult.scriptPath}`);
+      out(`Installed token-goat Copilot CLI integration \u2192 ${copilotResult.configPath}, ${copilotResult.scriptPath}, ${copilotResult.instructionsPath}`);
     }
   }
   if (opts.opencode === true) {
@@ -70763,16 +71163,16 @@ async function cmdInstall(opts) {
     );
   }
   try {
-    const skillDir2 = path62.join(homedir17(), ".claude", "skills");
-    if (fs52.existsSync(skillDir2)) {
-      const entries = fs52.readdirSync(skillDir2, { withFileTypes: true });
+    const skillDir2 = path63.join(homedir17(), ".claude", "skills");
+    if (fs55.existsSync(skillDir2)) {
+      const entries = fs55.readdirSync(skillDir2, { withFileTypes: true });
       const skillNames = [];
       const sessionId = getSessionId();
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
-        const skillFile = path62.join(skillDir2, entry.name, "SKILL.md");
-        if (fs52.existsSync(skillFile)) {
-          const body = fs52.readFileSync(skillFile, "utf-8");
+        const skillFile = path63.join(skillDir2, entry.name, "SKILL.md");
+        if (fs55.existsSync(skillFile)) {
+          const body = fs55.readFileSync(skillFile, "utf-8");
           const compact = extractCompactFromMarker(body);
           if (compact === null) continue;
           const sourceSha = contentHash(body);
@@ -70782,10 +71182,10 @@ async function cmdInstall(opts) {
       }
       if (skillNames.length > 0) {
         const dir = skillOutputsDir();
-        await fs52.promises.mkdir(dir, { recursive: true });
-        const pregenPath = path62.join(dir, "pregen.json");
+        await fs55.promises.mkdir(dir, { recursive: true });
+        const pregenPath = path63.join(dir, "pregen.json");
         const pregenData = { ts: Date.now(), names: skillNames };
-        await fs52.promises.writeFile(pregenPath, JSON.stringify(pregenData, null, 2));
+        await fs55.promises.writeFile(pregenPath, JSON.stringify(pregenData, null, 2));
         out(`Pre-generated ${skillNames.length} skill compacts.`);
       }
     }
@@ -70798,6 +71198,9 @@ function cmdUninstall(opts) {
   out(removed ? `Removed token-goat hooks (${scope}).` : `No token-goat hooks to remove (${scope}).`);
   const claudeMdRemoved = uninstallClaudeMd();
   out(claudeMdRemoved ? "Removed token-goat block from CLAUDE.md." : "No token-goat block in CLAUDE.md to remove.");
+  for (const stray of findStrayClaudeMdBlocks()) {
+    out(`NOTE: a token-goat block remains in ${stray} \u2014 outside CLAUDE.md, so it was not removed. Delete it manually if unwanted.`);
+  }
   const skillRemoved = uninstallSkill();
   out(skillRemoved ? "Removed token-goat skill." : "No token-goat skill to remove.");
   const removals = [
@@ -70900,7 +71303,7 @@ ${formatSessionOutline(turns)}`;
 }
 function sessionTranscriptSize(transcriptPath) {
   try {
-    return fs52.statSync(transcriptPath).size;
+    return fs55.statSync(transcriptPath).size;
   } catch {
     return 0;
   }
@@ -71004,7 +71407,7 @@ function _applyFiltersAndPrint(content, opts) {
 }
 function fileSizeOrZero(filePath) {
   try {
-    return fs52.statSync(filePath).size;
+    return fs55.statSync(filePath).size;
   } catch {
     return 0;
   }
@@ -71019,11 +71422,11 @@ function cmdBashOutput(id, opts) {
     }
     let content;
     try {
-      const st = fs52.statSync(opts.file);
+      const st = fs55.statSync(opts.file);
       if (st.isFIFO() || st.isSocket()) {
         throw new CliError(`--file '${opts.file}' is a special file (FIFO or socket) \u2014 only regular files are supported`);
       }
-      content = fs52.readFileSync(opts.file, "utf-8");
+      content = fs55.readFileSync(opts.file, "utf-8");
     } catch (e) {
       if (e instanceof CliError) throw e;
       throw new CliError(`cannot read file: ${opts.file}`);
@@ -71359,7 +71762,7 @@ async function cmdSkillBody(name2, opts) {
   if (filePath === null) {
     throw new CliError(`skill '${name2}' not found`);
   }
-  const body = fs52.readFileSync(filePath, "utf-8");
+  const body = fs55.readFileSync(filePath, "utf-8");
   if (opts.compact === true) {
     out(extractCompactFromMarker(body) ?? body);
   } else {
@@ -71376,7 +71779,7 @@ async function cmdSkillCompact(name2, opts) {
     for (const skill of skills) {
       const filePath = await getSkillFilePath(skill.name);
       if (!filePath) continue;
-      const body2 = fs52.readFileSync(filePath, "utf-8");
+      const body2 = fs55.readFileSync(filePath, "utf-8");
       const compact2 = extractCompactFromMarker(body2);
       if (compact2 === null) continue;
       const sourceSha2 = contentHash(body2);
@@ -71397,19 +71800,19 @@ async function cmdSkillCompact(name2, opts) {
     if (!opts.path.trim()) {
       throw new CliError("--path cannot be empty");
     }
-    if (!fs52.existsSync(opts.path)) {
+    if (!fs55.existsSync(opts.path)) {
       throw new CliError(`skill file not found: ${opts.path}`);
     }
     try {
-      body = fs52.readFileSync(opts.path, "utf-8");
+      body = fs55.readFileSync(opts.path, "utf-8");
     } catch (e) {
       if (e.code === "ENOENT") {
         throw new CliError(`skill file not found: ${opts.path}`);
       }
       throw new CliError(`failed to read skill file '${opts.path}': ${extractErrorMessage(e)}`);
     }
-    cacheName = name2 ?? path62.basename(path62.dirname(path62.resolve(opts.path)));
-    sourcePath = path62.resolve(opts.path);
+    cacheName = name2 ?? path63.basename(path63.dirname(path63.resolve(opts.path)));
+    sourcePath = path63.resolve(opts.path);
   } else {
     if (name2 === void 0 || !name2.trim()) {
       throw new CliError("skill-compact requires a <name> or --path <file>");
@@ -71418,7 +71821,7 @@ async function cmdSkillCompact(name2, opts) {
     if (filePath === null) {
       throw new CliError(`skill '${name2}' not found`);
     }
-    body = fs52.readFileSync(filePath, "utf-8");
+    body = fs55.readFileSync(filePath, "utf-8");
     cacheName = name2;
     sourcePath = filePath;
   }
@@ -71527,8 +71930,8 @@ async function cmdSkillDiff(name2) {
   }
   const newer = versions[0];
   const older = versions[1];
-  const newerBody = await fs52.promises.readFile(path62.resolve(dir, `${newer.outputId}.txt`), "utf-8").catch(() => null);
-  const olderBody = await fs52.promises.readFile(path62.resolve(dir, `${older.outputId}.txt`), "utf-8").catch(() => null);
+  const newerBody = await fs55.promises.readFile(path63.resolve(dir, `${newer.outputId}.txt`), "utf-8").catch(() => null);
+  const olderBody = await fs55.promises.readFile(path63.resolve(dir, `${older.outputId}.txt`), "utf-8").catch(() => null);
   if (newerBody === null || olderBody === null) {
     out(`a cached version of '${name2}' was evicted while diffing -- try again`);
     return;
@@ -71557,7 +71960,7 @@ async function cmdSkillSection(nameHeading, headingArg) {
   if (!filePath) {
     throw new CliError(`skill '${skillName}' not found`);
   }
-  const body = fs52.readFileSync(filePath, "utf-8");
+  const body = fs55.readFileSync(filePath, "utf-8");
   const extracted = extractNamedSection(body, heading);
   if (!extracted) {
     process.exitCode = 1;
@@ -71567,7 +71970,7 @@ async function cmdSkillSection(nameHeading, headingArg) {
 }
 function atomicWriteBuffer(dest, data) {
   try {
-    if (fs52.statSync(dest).isDirectory()) {
+    if (fs55.statSync(dest).isDirectory()) {
       const e = Object.assign(new Error(`EISDIR: illegal operation on a directory, open '${dest}'`), { code: "EISDIR", path: dest });
       throw e;
     }
@@ -71575,23 +71978,23 @@ function atomicWriteBuffer(dest, data) {
     if (e.code !== "ENOENT") throw e;
   }
   const rnd = Math.random().toString(36).slice(2, 8);
-  const tmp = path62.join(path62.dirname(path62.resolve(dest)), `.tmp.${process.pid}.${rnd}`);
+  const tmp = path63.join(path63.dirname(path63.resolve(dest)), `.tmp.${process.pid}.${rnd}`);
   try {
-    fs52.writeFileSync(tmp, data, { mode: 384 });
+    fs55.writeFileSync(tmp, data, { mode: 384 });
     try {
-      const destMode = fs52.statSync(dest).mode;
-      fs52.chmodSync(tmp, destMode);
+      const destMode = fs55.statSync(dest).mode;
+      fs55.chmodSync(tmp, destMode);
     } catch (e) {
       if (e.code !== "ENOENT") throw e;
     }
     withRetryOnLock(() => {
       try {
-        fs52.renameSync(tmp, dest);
+        fs55.renameSync(tmp, dest);
       } catch (e) {
         if (e.code === "EXDEV") {
-          fs52.copyFileSync(tmp, dest);
+          fs55.copyFileSync(tmp, dest);
           try {
-            fs52.unlinkSync(tmp);
+            fs55.unlinkSync(tmp);
           } catch (ue) {
             process.stderr.write(`token-goat write-file: warning: could not remove temp file ${tmp}: ${ue.message}
 `);
@@ -71603,7 +72006,7 @@ function atomicWriteBuffer(dest, data) {
     });
   } catch (e) {
     try {
-      fs52.unlinkSync(tmp);
+      fs55.unlinkSync(tmp);
     } catch {
     }
     throw e;
@@ -71613,9 +72016,9 @@ function mapFsError(e, src, dest, srcLabel = "source") {
   const fe = e;
   if (fe.code === "ENOENT") {
     const errPath = fe.path ?? "";
-    const isSource = src !== void 0 && path62.resolve(errPath) === path62.resolve(src);
+    const isSource = src !== void 0 && path63.resolve(errPath) === path63.resolve(src);
     if (isSource) throw new CliError(`${srcLabel} file not found: ${src}`);
-    const destDir = dest ? path62.dirname(path62.resolve(dest)) : path62.dirname(path62.resolve(errPath || "."));
+    const destDir = dest ? path63.dirname(path63.resolve(dest)) : path63.dirname(path63.resolve(errPath || "."));
     throw new CliError(`destination directory does not exist: ${destDir}`);
   }
   if (fe.code === "ENOTDIR") {
@@ -71626,7 +72029,7 @@ function mapFsError(e, src, dest, srcLabel = "source") {
   }
   if (fe.code === "EISDIR") {
     const errPath = fe.path ?? "";
-    const isSource = src !== void 0 && (errPath === "" || path62.resolve(errPath) === path62.resolve(src));
+    const isSource = src !== void 0 && (errPath === "" || path63.resolve(errPath) === path63.resolve(src));
     if (isSource) throw new CliError(`source is a directory, not a file: ${src}`);
     throw new CliError(`destination is a directory, not a file: ${dest ?? (errPath || "(unknown)")}`);
   }
@@ -71695,7 +72098,7 @@ function validateWritablePath(dest, label) {
     throw new CliError(`${label} path contains a null byte`);
   }
   if (isWindows()) {
-    const base = path62.basename(dest);
+    const base = path63.basename(dest);
     const stem = base.replace(/\.[^.]*$/, "").toUpperCase();
     if (WIN_RESERVED.has(stem)) {
       throw new CliError(`${label} '${base}' is a reserved Windows device name`);
@@ -71725,7 +72128,7 @@ function readFileBoundedRaw(filePath, label, allowStdIn = false) {
     throw new CliError(`${label} ${filePath} requires piped input; use ${altLabel} for interactive use`);
   }
   try {
-    const st = fs52.statSync(filePath);
+    const st = fs55.statSync(filePath);
     if (st.isFIFO() || st.isSocket()) {
       throw new CliError(`${label} '${filePath}' is a special file (FIFO or socket) \u2014 only regular files are supported`);
     }
@@ -71733,7 +72136,7 @@ function readFileBoundedRaw(filePath, label, allowStdIn = false) {
     if (st.size > maxBytes) {
       throw new CliError(`${label} '${filePath}' exceeds size limit (${Math.round(st.size / 1024 / 1024)} MB); set TOKEN_GOAT_MAX_STDIN_MB to override`);
     }
-    return fs52.readFileSync(filePath);
+    return fs55.readFileSync(filePath);
   } catch (e) {
     if (e instanceof CliError) throw e;
     mapFsError(e, filePath, void 0, label);
@@ -71777,7 +72180,7 @@ function cmdNoteAdd(file2, opts) {
     throw new CliError("note content must be valid UTF-8 text");
   }
   const resolvedPath = resolveIndexPath(file2);
-  if (!fs52.existsSync(resolvedPath)) {
+  if (!fs55.existsSync(resolvedPath)) {
     throw new CliError(`File not found: '${resolvedPath}'`);
   }
   healStaleIndex(resolvedPath);
@@ -71834,7 +72237,7 @@ function cmdWriteFile(dest, opts) {
     throw new CliError(`TOKEN_GOAT_MAX_STDIN_MB must be a positive integer; got '${process.env["TOKEN_GOAT_MAX_STDIN_MB"] ?? ""}'`);
   }
   const maxBytes = maxMB * 1024 * 1024;
-  return new Promise((resolve20, reject) => {
+  return new Promise((resolve21, reject) => {
     const chunks = [];
     let totalBytes = 0;
     let settled = false;
@@ -71858,7 +72261,7 @@ function cmdWriteFile(dest, opts) {
       try {
         atomicWriteBuffer(dest, Buffer.concat(chunks));
         enqueueDirtyPathSafe(dest);
-        resolve20();
+        resolve21();
       } catch (e) {
         try {
           mapFsError(e, void 0, dest);
@@ -71961,7 +72364,7 @@ function cmdReplace(file2, opts) {
   const targetBuf = readFileBoundedRaw(file2, "target file", true);
   let preWriteStat;
   try {
-    preWriteStat = fs52.statSync(file2);
+    preWriteStat = fs55.statSync(file2);
   } catch {
   }
   const usingFrom = opts.oldFrom !== void 0 || opts.newFrom !== void 0;
@@ -72030,7 +72433,7 @@ ${diff}`
     }
     let preRenameStat;
     try {
-      preRenameStat = fs52.statSync(file2);
+      preRenameStat = fs55.statSync(file2);
     } catch {
     }
     if (preRenameStat !== void 0 && (preRenameStat.mtimeMs !== preWriteStat.mtimeMs || preRenameStat.size !== preWriteStat.size)) {
@@ -72061,7 +72464,7 @@ function cmdInsertSection(file2, opts) {
   }
   let preWriteStat;
   try {
-    preWriteStat = fs52.statSync(file2);
+    preWriteStat = fs55.statSync(file2);
   } catch {
   }
   const result = readSection(file2, opts.after);
@@ -72073,7 +72476,7 @@ function cmdInsertSection(file2, opts) {
   }
   let rawText;
   try {
-    rawText = fs52.readFileSync(file2, "utf-8");
+    rawText = fs55.readFileSync(file2, "utf-8");
   } catch (e) {
     mapFsError(e, void 0, file2);
   }
@@ -72088,7 +72491,7 @@ function cmdInsertSection(file2, opts) {
   if (preWriteStat !== void 0) {
     let preRenameStat;
     try {
-      preRenameStat = fs52.statSync(file2);
+      preRenameStat = fs55.statSync(file2);
     } catch {
     }
     if (preRenameStat !== void 0 && (preRenameStat.mtimeMs !== preWriteStat.mtimeMs || preRenameStat.size !== preWriteStat.size)) {
@@ -72126,25 +72529,25 @@ ${content}`;
 }
 function expandGlobs(root, patterns, globFnOverride) {
   const out2 = [];
-  const globFn = globFnOverride ?? fs52["globSync"];
+  const globFn = globFnOverride ?? fs55["globSync"];
   for (const p of patterns) {
     if (globFn !== void 0 && (p.includes("*") || p.includes("?") || p.includes("{"))) {
       try {
         const hits = globFn(p, { cwd: root });
-        for (const h of hits) out2.push(path62.isAbsolute(h) ? h : path62.join(root, h));
+        for (const h of hits) out2.push(path63.isAbsolute(h) ? h : path63.join(root, h));
         continue;
       } catch {
       }
     }
-    out2.push(path62.isAbsolute(p) ? p : path62.join(root, p));
+    out2.push(path63.isAbsolute(p) ? p : path63.join(root, p));
   }
   return out2;
 }
 function readIgnoreFile(root) {
-  const ignorePath = path62.join(root, ".tokengoatignore");
+  const ignorePath = path63.join(root, ".tokengoatignore");
   let raw;
   try {
-    raw = fs52.readFileSync(ignorePath, "utf8");
+    raw = fs55.readFileSync(ignorePath, "utf8");
   } catch {
     return void 0;
   }
@@ -72185,14 +72588,14 @@ function cmdPack(patterns, opts) {
   }
   let instruction;
   if (opts.instructionFile !== void 0) {
-    instruction = fs52.readFileSync(opts.instructionFile, "utf8");
+    instruction = fs55.readFileSync(opts.instructionFile, "utf8");
   }
   const formatted = formatPack(result, style, {
     ...opts.lineNumbers === true ? { line_numbers: true } : {},
     ...instruction !== void 0 ? { instruction } : {}
   });
   if (opts.output !== void 0) {
-    fs52.writeFileSync(opts.output, formatted, "utf8");
+    fs55.writeFileSync(opts.output, formatted, "utf8");
   } else {
     out(formatted);
   }
@@ -72210,7 +72613,7 @@ function cmdTokens(patterns, opts) {
   if (opts.tree === true) {
     const dirs = /* @__PURE__ */ new Map();
     for (const e of entries) {
-      const dir = path62.dirname(e.rel_path);
+      const dir = path63.dirname(e.rel_path);
       if (!dirs.has(dir)) dirs.set(dir, []);
       dirs.get(dir).push(e);
     }
@@ -72220,7 +72623,7 @@ function cmdTokens(patterns, opts) {
       const pct = result.total_tokens > 0 ? Math.round(dirTokens / result.total_tokens * 100) : 0;
       lines3.push(`${dir}/ (${dirTokens} tokens, ${pct}%)`);
       for (const e of dirEntries) {
-        lines3.push(`  ${path62.basename(e.rel_path).padEnd(30)}  ${String(e.tokens).padStart(8)} tokens`);
+        lines3.push(`  ${path63.basename(e.rel_path).padEnd(30)}  ${String(e.tokens).padStart(8)} tokens`);
       }
     }
     out(lines3.join("\n"));
@@ -72251,7 +72654,7 @@ function cmdBudget(patterns, opts) {
   }
 }
 function cmdFailures(src, opts) {
-  const text = src !== void 0 ? fs52.readFileSync(src, "utf8") : fs52.readFileSync(0, "utf8");
+  const text = src !== void 0 ? fs55.readFileSync(src, "utf8") : fs55.readFileSync(0, "utf8");
   const result = extractFailures(text, opts.runner !== void 0 ? { runner: opts.runner } : {});
   if (opts.delta !== true) {
     out(opts.json === true ? formatFailuresJson(result) : formatFailuresText(result));
@@ -72323,7 +72726,7 @@ function buildProgram() {
   ).option("-j, --json", "output as JSON").option("--list", "list all section headings in the file instead of reading one").action(
     (spec, opts) => opts.list === true ? runExit(() => runListSections({ file: spec, ...opts.json === true ? { json: true } : {} })) : runExitText(() => runSection({ spec, ...opts.json === true ? { json: true } : {} }))
   );
-  program2.command("semantic <query>").description("semantic search (falls back to full-text search)").option("-l, --limit <n>", "max results").action(guard(cmdSemantic));
+  program2.command("semantic <query>").description("semantic search (falls back to full-text search)").option("-l, --limit <n>", "max results").option("-j, --json", "output as JSON").action(guard(cmdSemantic));
   program2.command("skeleton <file>").description("list all symbols in a file without bodies").option("-j, --json", "output as JSON").option("--min-lines <n>", "only show symbols at least N lines long").option("--force-refresh", "reparse file from disk before querying (ignore stale index)").option("--stats", "add per-symbol reference count and doc-coverage flag").action(
     (file2, opts) => runExitText(
       () => runSkeleton({
@@ -72360,14 +72763,14 @@ function buildProgram() {
       })
     )
   );
-  program2.command("index [path]").description("parse all git-tracked files and (re)build the symbol index").option("--walk", "if not a git repo, index a bounded directory walk instead (skips .env / generated / oversized trees)").option("--force", "bypass the SHA-freshness cache and reindex every tracked file, even byte-identical ones (e.g. after a parser upgrade changes what gets extracted)").action(guard(cmdIndex));
+  program2.command("index [path]").description("parse all git-tracked files and (re)build the symbol index").option("--walk", "if not a git repo, index a bounded directory walk instead (skips .env / generated / oversized trees)").option("--force", "bypass the SHA-freshness cache and reindex every tracked file, even byte-identical ones (e.g. after a parser upgrade changes what gets extracted)").option("--force-walk", `with --walk, raise the ${MAX_FILES_SCANNED} source-file refusal to ${MAX_FILES_SCANNED_FORCED} for a folder you know is genuinely that large (slow; produces a large index)`).action(guard(cmdIndex));
   program2.command("map").description("project overview").option("-c, --compact", "compact, low-token summary").action(guard(cmdMap));
   program2.command("bridges-status").description("hook-event parity matrix across every AI-harness bridge (read-only static analysis, never invokes a real harness binary)").option("--json", "emit the matrix as JSON instead of text").action(guard(cmdBridgesStatus));
   program2.command("commands").description("machine-readable manifest of every registered command, its options, and its arguments").option("--json", "emit the manifest as JSON instead of text").action(guard(cmdCommands));
   program2.command("mcp-serve").description("run token-goat as an MCP stdio server exposing read/symbol/section/outline/skeleton/semantic tools").action(guard(cmdMcpServe));
   program2.command("hook <event>").description("hook relay entrypoint (reads JSON on stdin)").option("--harness <name>", "override harness detection for this invocation (sets TOKEN_GOAT_HARNESS_OVERRIDE)").action(guard(cmdHook));
-  program2.command("install").description("install hooks into Claude Code settings").option("-p, --project", "install into project scope instead of user scope").option("--codex", "also patch Codex CLI (~/.codex/config.toml, ~/.codex/AGENTS.md)").option("--gemini", "also patch Gemini CLI (~/.gemini/settings.json)").option("--qwen", "also patch Qwen Code (~/.qwen/settings.json)").option("--pi", "also drop a pi (pi-coding-agent) extension (~/.pi/agent/extensions/token-goat.ts)").option("--opencode", "also drop an opencode plugin (~/.config/opencode/plugins/token-goat.ts, %APPDATA%\\opencode\\plugins\\token-goat.ts on Windows)").option("--hermes", "verify token-goat hooks are present for Hermes Agent (writes nothing new)").option("--openclaw", "also register an OpenClaw plugin (~/.openclaw/openclaw.json, ~/.openclaw/plugins/token-goat.ts)").option("--copilot", "also register a Copilot CLI hook config (~/.copilot/hooks/token-goat.json, ~/.copilot/hooks/token-goat-shim.js)").option("--grok", "also register a Grok CLI (xAI Grok Build) hook config (~/.grok/hooks/token-goat.json, ~/.grok/hooks/token-goat-shim.js)").option("--local", "with --pi, install the project-local extension (<project>/.pi/extensions/token-goat.ts) instead of the global one").action(guard(cmdInstall));
-  program2.command("uninstall").description("remove token-goat hooks from Claude Code settings").option("-p, --project", "uninstall from project scope instead of user scope").option("--codex", "also strip the Codex CLI integration (~/.codex/config.toml, ~/.codex/AGENTS.md)").option("--gemini", "also strip the Gemini CLI integration (~/.gemini/settings.json)").option("--qwen", "also strip the Qwen Code integration (~/.qwen/settings.json)").option("--pi", "also remove the pi (pi-coding-agent) extension").option("--opencode", "also remove the opencode plugin").option("--hermes", "no-op verification flag for symmetry with install (removes no files)").option("--openclaw", "also remove the OpenClaw plugin and config entry").option("--copilot", "also remove the Copilot CLI hook config and shim script").option("--grok", "also remove the Grok CLI hook config and shim script").option("--local", "with --pi, remove the project-local extension instead of the global one").action(guard(cmdUninstall));
+  program2.command("install").description("install hooks into Claude Code settings").option("-p, --project", "install into project scope instead of user scope").option("--codex", "also patch Codex CLI (~/.codex/config.toml, ~/.codex/AGENTS.md)").option("--gemini", "also patch Gemini CLI (~/.gemini/settings.json)").option("--qwen", "also patch Qwen Code (~/.qwen/settings.json)").option("--pi", "also drop a pi (pi-coding-agent) extension (~/.pi/agent/extensions/token-goat.ts)").option("--opencode", "also drop an opencode plugin (~/.config/opencode/plugins/token-goat.ts, %APPDATA%\\opencode\\plugins\\token-goat.ts on Windows)").option("--hermes", "verify token-goat hooks are present for Hermes Agent (writes nothing new)").option("--openclaw", "also register an OpenClaw plugin (~/.openclaw/openclaw.json, ~/.openclaw/plugins/token-goat.ts)").option("--copilot", "also register a Copilot CLI hook config and routing block (~/.copilot/hooks/token-goat.json, ~/.copilot/hooks/token-goat-shim.js, ~/.copilot/copilot-instructions.md; with --local, <project>/.github/hooks/token-goat.json, <project>/.github/hooks/token-goat-shim.js, <project>/.github/copilot-instructions.md)").option("--grok", "also register a Grok CLI (xAI Grok Build) hook config (~/.grok/hooks/token-goat.json, ~/.grok/hooks/token-goat-shim.js)").option("--local", "with --pi, install the project-local extension (<project>/.pi/extensions/token-goat.ts) instead of the global one").action(guard(cmdInstall));
+  program2.command("uninstall").description("remove token-goat hooks from Claude Code settings").option("-p, --project", "uninstall from project scope instead of user scope").option("--codex", "also strip the Codex CLI integration (~/.codex/config.toml, ~/.codex/AGENTS.md)").option("--gemini", "also strip the Gemini CLI integration (~/.gemini/settings.json)").option("--qwen", "also strip the Qwen Code integration (~/.qwen/settings.json)").option("--pi", "also remove the pi (pi-coding-agent) extension").option("--opencode", "also remove the opencode plugin").option("--hermes", "no-op verification flag for symmetry with install (removes no files)").option("--openclaw", "also remove the OpenClaw plugin and config entry").option("--copilot", "also remove the Copilot CLI hook config and shim script, and strip the token-goat block from ~/.copilot/copilot-instructions.md (or <project>/.github/copilot-instructions.md with --local)").option("--grok", "also remove the Grok CLI hook config and shim script").option("--local", "with --pi, remove the project-local extension instead of the global one").action(guard(cmdUninstall));
   const worker = program2.command("worker").description("background indexer lifecycle");
   worker.command("start").description("start the background indexer").action(guard(cmdWorkerStart));
   worker.command("stop").description("stop the background indexer").action(guard(cmdWorkerStop));
@@ -72565,6 +72968,9 @@ function buildProgram() {
   program2.command("bash-history").description("list cached bash output entries, newest first").option("-l, --limit <n>", "max results (default: 30)").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdBashHistory(opts))());
   program2.command("web-history").description("list cached web-fetch output entries, newest first").option("-l, --limit <n>", "max results (default: 30)").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdWebHistory(opts))());
   program2.command("mcp-history").description("list cached MCP tool result entries, newest first").option("-l, --limit <n>", "max results (default: 30)").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdMcpHistory(opts))());
+  program2.command("reclaim-index").description("shrink an oversized symbol index: VACUUM, or --rebuild to drop derived rows so the next index run re-derives them").option("--rebuild", "also drop all derived rows (files/symbols/refs/chunks) so the next `token-goat index` reparses from scratch under current parser rules").option("--db-path <path>", "index database to reclaim (default: the global index)").option("--force", "proceed even if the worker daemon appears to be running").option("-j, --json", "output as JSON").action(
+    (opts) => guard(() => cmdReclaimIndex(opts))()
+  );
   program2.command("clean-cache").description("prune all cache subdirs to default retention limits (200 entries, 24 h)").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdCleanCache(opts))());
   program2.command("prune-cache").description("evict cache entries older than --max-age-hours or beyond --max-count (caller-specified bounds)").option("--max-count <n>", "max entries to keep per subdir (default: 200)").option("--max-age-hours <h>", "max age in hours to keep (default: 24)").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdPruneCache(opts))());
   program2.command("cache-audit").description("check settings.json hook installation and env-var gates that defeat token-goat caching").option("-j, --json", "output as JSON").action((opts) => guard(() => cmdCacheAudit(opts))());
@@ -72849,6 +73255,43 @@ function subagentStopHandler(event) {
 registerHook("user_prompt_submit", userPromptSubmitHandler);
 registerHook("subagent_stop", subagentStopHandler);
 
+// src/hooks_session_start.ts
+init_define_import_meta_env();
+init_hook_registry();
+init_hooks_common();
+init_config();
+init_index_reader();
+init_constants();
+var GENERIC_REMINDER = 'token-goat: prefer surgical reads over Read/Grep on this codebase -- `token-goat symbol <name>`, `token-goat read "file::symbol"`, `token-goat section "file::Heading"`, `token-goat semantic "description"`, `token-goat outline <file>`. Run `token-goat index .` if this project is not indexed yet.';
+function buildReminder(cwd) {
+  if (cwd === void 0) return GENERIC_REMINDER;
+  let symbolCount;
+  try {
+    symbolCount = countSymbols({ rootDir: cwd }, globalDbPath());
+  } catch {
+    return GENERIC_REMINDER;
+  }
+  if (symbolCount <= 0) return GENERIC_REMINDER;
+  return `token-goat: this project is indexed (${symbolCount} symbols). Prefer \`symbol <name>\`, \`read "file::symbol"\`, \`section "file::Heading"\`, \`semantic "description"\`, or \`outline <file>\` over a full Read/Grep.`;
+}
+function sessionStartHandler(event) {
+  try {
+    if (!loadConfig().hints.session_start_reminder) return passOutput();
+    let context = buildReminder(getCwd(event));
+    try {
+      const dbHealth = checkSymbolBodySize(globalDbPath());
+      if (dbHealth.status === "warn") {
+        context += ` token-goat: ${dbHealth.message}`;
+      }
+    } catch {
+    }
+    return contextOutput(context);
+  } catch {
+    return passOutput();
+  }
+}
+registerHook("session_start", sessionStartHandler);
+
 // src/hooks_fetch.ts
 init_define_import_meta_env();
 init_hook_registry();
@@ -73436,7 +73879,7 @@ function ab(pa, pb, join46) {
   return (data, i) => mapOuter(pa(data, i), (ma) => mapInner(pb(data, ma.position), (vb, j) => join46(ma.value, vb, data, i, j)));
 }
 function abc(pa, pb, pc, join46) {
-  return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb) => mapInner(pc(data, mb.position), (vc, j) => join46(ma.value, mb.value, vc, data, i, j))));
+  return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb2) => mapInner(pc(data, mb2.position), (vc, j) => join46(ma.value, mb2.value, vc, data, i, j))));
 }
 function ahead(p) {
   return (data, i) => mapOuter(p(data, i), (m1) => ({
@@ -77227,8 +77670,8 @@ function trimCharacterEnd(str, char) {
 function unicodeEscape(str) {
   return str.replace(/[\s\S]/g, (c) => "\\u" + c.charCodeAt().toString(16).padStart(4, "0"));
 }
-function get(obj, path63) {
-  for (const key of path63) {
+function get(obj, path64) {
+  for (const key of path64) {
     if (!obj) {
       return void 0;
     }
@@ -78429,8 +78872,8 @@ function withBrackets(str, brackets) {
   const rbr = typeof brackets[1] === "string" ? brackets[1] : "]";
   return lbr + str + rbr;
 }
-function pathRewrite(path63, rewriter, baseUrl, metadata, elem) {
-  const modifiedPath = typeof rewriter === "function" ? rewriter(path63, metadata, elem) : path63;
+function pathRewrite(path64, rewriter, baseUrl, metadata, elem) {
+  const modifiedPath = typeof rewriter === "function" ? rewriter(path64, metadata, elem) : path64;
   return modifiedPath[0] === "/" && baseUrl ? trimCharacterEnd(baseUrl, "/") + modifiedPath : modifiedPath;
 }
 function formatImage(elem, walk, builder, formatOptions) {
@@ -78754,9 +79197,9 @@ function handleDeprecatedOptions(options) {
     options.selectors.push(...tagDefinitions);
     options.selectors = mergeDuplicatesPreferLast(options.selectors, (s) => s.selector);
   }
-  function set2(obj, path63, value) {
-    const valueKey = path63.pop();
-    for (const key of path63) {
+  function set2(obj, path64, value) {
+    const valueKey = path64.pop();
+    for (const key of path64) {
       let nested = obj[key];
       if (!nested) {
         nested = {};
@@ -79036,9 +79479,10 @@ init_lang_patterns();
 init_stats();
 init_config();
 init_parser_types();
+init_project();
 init_util2();
 init_hooks_index();
-import { statSync as statSync30, existsSync as existsSync38 } from "node:fs";
+import { statSync as statSync32, existsSync as existsSync38 } from "node:fs";
 function stripCdPrefix(cmd) {
   const stripped = cmd.replace(/^(?:cd\s+(?:"[^"]*"|'[^']*'|\S+)\s*&&\s*)+/, "");
   return stripped.trim() || cmd;
@@ -79128,19 +79572,19 @@ var ORIG_HEAD_ELIGIBLE_GIT_RE = /^\s*git\s+(?:pull|merge|rebase)\b/i;
 var ORIG_HEAD_REFLOG_MSG_RE = /^(merge\s|rebase\s\(|pull\s)/i;
 function isTempPath(fp) {
   const norm = fp.replace(/\\/g, "/");
-  return /^\/tmp\//i.test(norm) || /\/var\/folders\//i.test(norm) || /AppData\/Local\/Temp\//i.test(norm) || norm.startsWith("/c/Users/") && norm.includes("/AppData/Local/Temp/");
+  return /^\/tmp\//i.test(norm) || /\/var\/folders\//i.test(norm) || /AppData\/Local\/Temp\//i.test(norm) || norm.startsWith("/c/Users/") && norm.includes("/AppData/Local/Temp/") || isUnderSystemTemp(fp);
 }
 function isOrchestratorStateFile(filePath) {
-  const basename19 = (filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1)) ?? filePath;
-  return /^\.improve-state-/.test(basename19);
+  const basename20 = (filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1)) ?? filePath;
+  return /^\.improve-state-/.test(basename20);
 }
 function extractCatSourceFile(cmd) {
   const m = /^cat\s+(\S+\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|css|scss|sass|less))\s*$/.exec(cmd);
   return m?.[1] ?? null;
 }
 function classifyFileExtensions(filePath) {
-  const basename19 = (filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1)) ?? filePath;
-  const isEnvFile = /^\.env(\.\w+)?$/i.test(basename19);
+  const basename20 = (filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1)) ?? filePath;
+  const isEnvFile = /^\.env(\.\w+)?$/i.test(basename20);
   const hasKnownExt = /\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|css|scss|sass|less|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties|sql|ps1|psm1|env)$/i.test(filePath);
   if (!hasKnownExt && !isEnvFile) return null;
   const isSql = /\.sql$/i.test(filePath);
@@ -79185,7 +79629,7 @@ var PS_GETCONTENT_INNER_RE = /^(?:Get-Content|gc|cat|type)(?:\s+(?:-[a-zA-Z]+|--
 var PS_TEMP_READ_FLOOD_BYTES = 16 * 1024;
 function isLargeFileOnDisk(filePath, floor) {
   try {
-    return statSync30(filePath).size >= floor;
+    return statSync32(filePath).size >= floor;
   } catch {
     return false;
   }
@@ -80057,7 +80501,7 @@ function preBashHandlerInner(event) {
     const prevResolvedPath = prevPath !== null ? resolveIndexPath(prevPath, preHookCwd ?? process.cwd()) : null;
     if (prevPath !== null && prevResolvedPath !== null && !existsSync38(prevResolvedPath)) {
       clearCurlDownload(curlDl.url);
-    } else if (prevPath !== null && prevResolvedPath !== null && statSync30(prevResolvedPath).size >= loadConfig().hints.bash_dedup_min_bytes) {
+    } else if (prevPath !== null && prevResolvedPath !== null && statSync32(prevResolvedPath).size >= loadConfig().hints.bash_dedup_min_bytes) {
       recordStat("session_hint", 0, 0);
       return denyOutput(
         "Already downloaded to " + prevPath + " earlier this session. Use `rg '<pattern>' " + prevPath + '` to search it, or `token-goat read "' + prevPath + '::SectionName"` to read a part of it.'
@@ -80994,7 +81438,7 @@ init_session();
 init_compact();
 init_util2();
 init_stats();
-var BRIEFING_TARGET_TOKENS = 300;
+var BRIEFING_TARGET_TOKENS = 450;
 function buildSubagentBriefing() {
   try {
     const head = [];
@@ -81022,7 +81466,7 @@ function buildSubagentBriefing() {
     }
     const tail = [];
     tail.push("");
-    tail.push('Prefer surgical reads over full-file dumps: `token-goat symbol <name>` / `token-goat read "file::symbol"` / `token-goat section "file::<heading>"` are cheaper alternatives that are already cached by the hook system.');
+    tail.push('Before your first read of any file, check for a token-goat command that returns just what you need and run it instead of a full-file read or wide grep: `token-goat symbol <name>`, `token-goat read "file::symbol"`, `token-goat section "file::<heading>"`. Skipping that check is a violation, not an oversight; the only exemptions are a file under ~200 lines you need whole, a never-indexed file, or an image.');
     const withCacheIds = head.join("\n") + cacheIdsBlock + "\n" + tail.join("\n");
     if (estimateTokens(withCacheIds) <= BRIEFING_TARGET_TOKENS) {
       return withCacheIds;
@@ -81114,7 +81558,7 @@ init_image_shrink();
 var DEFAULT_STDIN_TIMEOUT_MS = 5e3;
 var MAX_STDIN_BYTES = 64 * 1024 * 1024;
 function readStdinJson(timeoutMs = DEFAULT_STDIN_TIMEOUT_MS, maxBytes = MAX_STDIN_BYTES) {
-  return new Promise((resolve20, reject) => {
+  return new Promise((resolve21, reject) => {
     const chunks = [];
     let totalBytes = 0;
     let settled = false;
@@ -81149,7 +81593,7 @@ function readStdinJson(timeoutMs = DEFAULT_STDIN_TIMEOUT_MS, maxBytes = MAX_STDI
           return;
         }
         try {
-          resolve20(JSON.parse(text));
+          resolve21(JSON.parse(text));
         } catch (err2) {
           reject(err2 instanceof Error ? err2 : new Error(String(err2)));
         }