token-goat 2.9.30 → 2.9.31

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

@@ -0,0 +1,307 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  formatAge
+} from "./token-goat-chunk-SAMFDIS2.mjs";
+import {
+  findProject
+} from "./token-goat-chunk-4GBVPH3D.mjs";
+import {
+  LOCK_WAIT_MS_HARDENED,
+  atomicWriteText,
+  countNoun,
+  ensureDirSync,
+  withFileLock,
+  withRetryOnLock
+} from "./token-goat-chunk-HU4TORC5.mjs";
+import {
+  sleepSync
+} from "./token-goat-chunk-AM5V6GSX.mjs";
+import {
+  fenceUntrustedFileContent
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import {
+  dataDir
+} from "./token-goat-chunk-CO3UYX6G.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/project_memory.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+import * as path from "node:path";
+var MAX_ENTRIES = 30;
+var MAX_VALUE_LEN = 300;
+var MAX_TOTAL_CHARS = 4e3;
+var KEY_RE = /^[A-Za-z0-9_-]{1,80}$/;
+var SET_AT_RE = /^#\s*set\s+(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)$/;
+var ANCHOR_RE = /^#\s*anchor:\s*(\S.*)::([^:@\s]+)@([0-9a-f]{64})$/;
+function anchorLabel(status) {
+  if (status === "changed") return " (changed since note)";
+  if (status === "gone") return " (anchored symbol gone)";
+  return "";
+}
+function anchorLine(anchor) {
+  const line = `# anchor: ${anchor.file}::${anchor.symbol}@${anchor.sha}`;
+  const back = ANCHOR_RE.exec(line);
+  return back !== null && back[1] === anchor.file && back[2] === anchor.symbol ? line : null;
+}
+function noteMap() {
+  return /* @__PURE__ */ Object.create(null);
+}
+function ordinal(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function memoryPath(projectHash) {
+  return path.join(dataDir(), "projects", `${projectHash}_memory.toml`);
+}
+function validateKey(key) {
+  if (!KEY_RE.test(key)) {
+    throw new Error(
+      `Invalid memory key ${JSON.stringify(key)}: use only letters, digits, hyphens, underscores (max 80 chars)`
+    );
+  }
+}
+function parseTOML(content, unparsed = [], setAt = /* @__PURE__ */ new Map(), anchors = /* @__PURE__ */ new Map()) {
+  const result = noteMap();
+  let pendingSetAt;
+  let pendingAnchor;
+  for (const [i, line] of content.split("\n").entries()) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      continue;
+    }
+    if (trimmed.startsWith("#")) {
+      const time = SET_AT_RE.exec(trimmed)?.[1];
+      if (time !== void 0 && !Number.isNaN(Date.parse(time))) pendingSetAt = time;
+      const anchor = ANCHOR_RE.exec(trimmed);
+      if (anchor !== null) pendingAnchor = { file: anchor[1], symbol: anchor[2], sha: anchor[3] };
+      continue;
+    }
+    const entrySetAt = pendingSetAt;
+    const entryAnchor = pendingAnchor;
+    pendingSetAt = void 0;
+    pendingAnchor = void 0;
+    const match = trimmed.match(/^([A-Za-z0-9_-]+)\s*=\s*"(.*)"\s*$/s);
+    if (match) {
+      const [, key, value] = match;
+      if (key && value !== void 0) {
+        const unescaped = value.replace(/\\(u202[89]|[\\nrt"])/g, (_, c) => {
+          switch (c) {
+            case "u2028":
+              return "\u2028";
+            case "u2029":
+              return "\u2029";
+            case "\\":
+              return "\\";
+            case "n":
+              return "\n";
+            case "r":
+              return "\r";
+            case '"':
+              return '"';
+            default:
+              return _;
+          }
+        });
+        result[key] = unescaped;
+        if (entrySetAt === void 0) setAt.delete(key);
+        else setAt.set(key, entrySetAt);
+        if (entryAnchor === void 0) anchors.delete(key);
+        else anchors.set(key, entryAnchor);
+      }
+    } else {
+      unparsed.push(i + 1);
+    }
+  }
+  return result;
+}
+function loadRaw(filePath, forUpdate = false, setAt, anchors) {
+  let content = "";
+  try {
+    withRetryOnLock(() => {
+      content = fs.readFileSync(filePath, "utf-8");
+    });
+  } catch (err) {
+    if (err.code === "ENOENT") return noteMap();
+    throw err;
+  }
+  const unparsed = [];
+  const entries = parseTOML(content, unparsed, setAt, anchors);
+  if (forUpdate && unparsed.length > 0) {
+    const one = unparsed.length === 1;
+    throw new Error(`Not updating ${filePath}: ${one ? "line" : "lines"} ${unparsed.join(", ")} ${one ? "is" : "are"} not in the key = "value" form, and saving would drop ${one ? "it" : "them"}. Fix or remove ${one ? "it" : "them"}, then try again.`);
+  }
+  return entries;
+}
+function save(filePath, entries, setAt = /* @__PURE__ */ new Map(), anchors = /* @__PURE__ */ new Map()) {
+  const lines = [];
+  const sorted = Object.entries(entries).sort(([a], [b]) => ordinal(a, b));
+  for (const [k, v] of sorted) {
+    const escaped = v.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\r/g, "\\r").replace(/\n/g, "\\n").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+    const time = setAt.get(k);
+    if (time !== void 0) lines.push(`# set ${time}`);
+    const anchor = anchors.get(k);
+    const anchored = anchor === void 0 ? null : anchorLine(anchor);
+    if (anchored !== null) lines.push(anchored);
+    lines.push(`${k} = "${escaped}"`);
+  }
+  const content = lines.length > 0 ? lines.join("\n") + "\n" : "";
+  const dir = path.dirname(filePath);
+  ensureDirSync(dir);
+  atomicWriteText(filePath, content);
+}
+function loadEntries(projectHash) {
+  return loadRaw(memoryPath(projectHash));
+}
+function loadDatedEntries(projectHash) {
+  const setAt = /* @__PURE__ */ new Map();
+  const anchors = /* @__PURE__ */ new Map();
+  const entries = loadRaw(memoryPath(projectHash), false, setAt, anchors);
+  const result = noteMap();
+  for (const [key, value] of Object.entries(entries)) {
+    const note = { value };
+    const time = setAt.get(key);
+    if (time !== void 0) note.setAt = time;
+    const anchor = anchors.get(key);
+    if (anchor !== void 0) note.anchor = anchor;
+    result[key] = note;
+  }
+  return result;
+}
+function noteAgeLabel(note, now = Date.now()) {
+  if (note.setAt === void 0) return "";
+  return ` (set ${formatAge(Math.max(0, now - Date.parse(note.setAt)))} ago)`;
+}
+function oneLineNoteValue(value) {
+  return value.replace(/\r\n|[\r\n\u0085\u2028\u2029]/g, "\\n");
+}
+function byRecency(a, aSetAt, b, bSetAt) {
+  const ta = aSetAt === void 0 ? Number.NEGATIVE_INFINITY : Date.parse(aSetAt);
+  const tb = bSetAt === void 0 ? Number.NEGATIVE_INFINITY : Date.parse(bSetAt);
+  return ta !== tb ? ta > tb ? -1 : 1 : ordinal(a, b);
+}
+function setEntry(projectHash, key, value, anchor) {
+  validateKey(key);
+  const p = memoryPath(projectHash);
+  const dir = path.dirname(p);
+  ensureDirSync(dir);
+  const result = { evicted: [] };
+  const doSet = () => {
+    const setAt = /* @__PURE__ */ new Map();
+    const anchors = /* @__PURE__ */ new Map();
+    const entries = loadRaw(p, true, setAt, anchors);
+    const old = Object.hasOwn(entries, key) ? entries[key] : void 0;
+    if (old !== void 0) result.previous = old;
+    const isNewKey = !Object.hasOwn(entries, key);
+    if (isNewKey && Object.keys(entries).length >= MAX_ENTRIES) {
+      const keysToKeep = MAX_ENTRIES - 1;
+      const allKeys = Object.keys(entries).sort((a, b) => byRecency(a, setAt.get(a), b, setAt.get(b)));
+      for (const k of allKeys.slice(keysToKeep)) {
+        result.evicted.push(k);
+        delete entries[k];
+        setAt.delete(k);
+        anchors.delete(k);
+      }
+    }
+    entries[key] = value;
+    setAt.set(key, (/* @__PURE__ */ new Date()).toISOString());
+    if (anchor === void 0) anchors.delete(key);
+    else anchors.set(key, anchor);
+    save(p, entries, setAt, anchors);
+    return true;
+  };
+  underNotesLock(p, doSet);
+  return result;
+}
+function underNotesLock(p, update) {
+  const lockPath = `${p}.lock`;
+  ensureDirSync(path.dirname(p));
+  for (let attempt = 1; attempt <= 3; attempt++) {
+    if (withFileLock(lockPath, update, { waitMs: LOCK_WAIT_MS_HARDENED }) !== void 0) return;
+    if (fs.existsSync(lockPath)) break;
+    if (attempt < 3) sleepSync(50 * attempt);
+  }
+  throw new Error(`Could not lock ${p} for writing; no note was changed. Another token-goat process may be writing notes: try again.`);
+}
+function unsetEntry(projectHash, key) {
+  validateKey(key);
+  const p = memoryPath(projectHash);
+  let removed = false;
+  const doUnset = () => {
+    const setAt = /* @__PURE__ */ new Map();
+    const anchors = /* @__PURE__ */ new Map();
+    const entries = loadRaw(p, true, setAt, anchors);
+    if (Object.hasOwn(entries, key)) {
+      delete entries[key];
+      save(p, entries, setAt, anchors);
+      removed = true;
+    }
+    return true;
+  };
+  underNotesLock(p, doUnset);
+  return removed;
+}
+function clearAll(projectHash) {
+  const p = memoryPath(projectHash);
+  const doClear = () => {
+    if (fs.existsSync(p)) {
+      save(p, {});
+    }
+    return true;
+  };
+  underNotesLock(p, doClear);
+}
+function buildInjection(projectHash, root, statusOf) {
+  try {
+    const entries = loadDatedEntries(projectHash);
+    if (Object.keys(entries).length === 0) {
+      return null;
+    }
+    const now = Date.now();
+    const header = '### Project notes (`token-goat note set <key> "<finding>"`)';
+    const render = (shown2, skipped) => {
+      const parts = [header];
+      if (shown2.length > 0) parts.push(fenceUntrustedFileContent(shown2.join("\n")));
+      if (skipped > 0) parts.push(`- (+${countNoun(skipped, "more memory entry", "more memory entries")} omitted)`);
+      return parts.join("\n");
+    };
+    const entries_list = Object.entries(entries).sort(([a, na], [b, nb]) => byRecency(a, na.setAt, b, nb.setAt));
+    const shown = [];
+    for (const [key, note] of entries_list.slice(0, MAX_ENTRIES)) {
+      const val = note.value;
+      const display = val.length <= MAX_VALUE_LEN ? val : val.slice(0, MAX_VALUE_LEN) + "\u2026";
+      const flag = root === void 0 || statusOf === void 0 || note.anchor === void 0 ? "" : anchorLabel(statusOf(root, note.anchor));
+      const line = `- **${key}**${noteAgeLabel(note, now)}${flag}: ${oneLineNoteValue(display)}`;
+      if (render([...shown, line], entries_list.length - shown.length - 1).length > MAX_TOTAL_CHARS) break;
+      shown.push(line);
+    }
+    return render(shown, entries_list.length - shown.length);
+  } catch {
+    return null;
+  }
+}
+function projectNotesFor(cwd, statusOf) {
+  if (cwd === void 0) return null;
+  try {
+    const project = findProject(cwd);
+    return project === null ? null : buildInjection(project.hash, project.root, statusOf);
+  } catch {
+    return null;
+  }
+}
+
+export {
+  MAX_ENTRIES,
+  anchorLabel,
+  anchorLine,
+  loadEntries,
+  loadDatedEntries,
+  noteAgeLabel,
+  oneLineNoteValue,
+  setEntry,
+  unsetEntry,
+  clearAll,
+  projectNotesFor
+};

package/dist/{token-goat-chunk-ZEJVMUQH.mjs → token-goat-chunk-HLPW63A7.mjs}

@@ -2,10 +2,10 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   ensureDirSync
-} from "./token-goat-chunk-GOLEOXZP.mjs";
+} from "./token-goat-chunk-HU4TORC5.mjs";
 import {
   dataDir
-} from "./token-goat-chunk-VES7EL7O.mjs";
+} from "./token-goat-chunk-CO3UYX6G.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";

package/dist/{token-goat-chunk-GOLEOXZP.mjs → token-goat-chunk-HU4TORC5.mjs}

@@ -1,5 +1,8 @@
 import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
+import {
+  echoedValue
+} from "./token-goat-chunk-GGGG7RWB.mjs";
 import {
   foldPath,
   isInsideRoot,
@@ -14,7 +17,7 @@ import {
   dataDir,
   ensureStorageRootPrivate,
   isTokenGoatStorage
-} from "./token-goat-chunk-VES7EL7O.mjs";
+} from "./token-goat-chunk-CO3UYX6G.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -725,12 +728,14 @@ function runGit(args, opts = {}) {
   const result = spawnSync("git", fullArgs, {
     ...opts.cwd !== void 0 ? { cwd: opts.cwd } : {},
     ...opts.timeoutMs !== void 0 ? { timeout: opts.timeoutMs } : {},
+    ...opts.input !== void 0 ? { input: opts.input } : {},
     encoding: "utf-8",
     windowsHide: true,
     maxBuffer: 200 * 1024 * 1024
   });
   if (result.error) {
-    return { stdout: "", stderr: String(result.error.message ?? result.error), exitCode: -1 };
+    const timedOut = result.error.code === "ETIMEDOUT";
+    return { stdout: "", stderr: String(result.error.message ?? result.error), exitCode: -1, ...timedOut ? { timedOut } : {} };
   }
   return {
     stdout: result.stdout ?? "",
@@ -923,11 +928,21 @@ function containsLineRun(haystack, needle) {
   if (n.length === 0 || n.length > h.length) return false;
   return ("\n" + h + "\n").includes("\n" + n + "\n");
 }
+function isSequentialPagingChain(ranges, minChainLength = 3) {
+  if (ranges.length < minChainLength) return false;
+  const slice = ranges.slice(-minChainLength);
+  const steps = (isStep) => slice.every((curr, i) => i === 0 || isStep(slice[i - 1], curr));
+  const inReach = (gap) => gap >= -25 && gap <= 60;
+  return steps(([s1, e1], [s2]) => s2 > s1 && inReach(s2 - e1)) || steps(([s1], [s2, e2]) => s2 < s1 && inReach(s1 - e2));
+}
 var LOCK_WAIT_MS = 2e3;
 var LOCK_STALE_MS = 5e3;
 var LOCK_WAIT_MS_HARDENED = 15e3;
 var LOCK_LIVE_HOLDER_MAX_MS = 6e4;
 var LOCK_EPERM_RUN_MS = 1e3;
+function lockPollMs(attempt, waitMs) {
+  return Math.max(1, Math.min(20 * attempt, 200, Math.floor(waitMs / 50)));
+}
 function lockHolderAlive(token) {
   const pid = Number(/^(\d+):/.exec(token)?.[1]);
   if (!Number.isSafeInteger(pid) || pid <= 0 || pid === process.pid) return false;
@@ -978,8 +993,12 @@ function withFileLock(lockPath, fn, opts = {}) {
     } catch (err) {
       if (process.platform === "win32" && errnoCode(err) === "EPERM") {
         epermSince ??= Date.now();
-        if (Date.now() >= deadline || Date.now() - epermSince >= LOCK_EPERM_RUN_MS) return void 0;
-        sleepSync(Math.min(20 * ++attempt, 200));
+        if (Date.now() >= deadline) {
+          opts.onContended?.();
+          return void 0;
+        }
+        if (Date.now() - epermSince >= LOCK_EPERM_RUN_MS) return void 0;
+        sleepSync(lockPollMs(++attempt, waitMs));
         continue;
       }
       if (!isEExist(err)) return void 0;
@@ -993,8 +1012,11 @@ function withFileLock(lockPath, fn, opts = {}) {
       stale = false;
     }
     if (stale && stealAbandoned(lockPath, staleMs)) continue;
-    if (Date.now() >= deadline) return void 0;
-    sleepSync(Math.min(20 * ++attempt, 200));
+    if (Date.now() >= deadline) {
+      opts.onContended?.();
+      return void 0;
+    }
+    sleepSync(lockPollMs(++attempt, waitMs));
   }
   try {
     return fn();
@@ -1021,20 +1043,6 @@ function compileGrepMatcher(pattern) {
   const re = guarded.re;
   return (candidate) => re.test(candidate);
 }
-function grepFilteredToEmptyNotice(preFilterCount, grep, nounSingular, nounPlural) {
-  const noun = preFilterCount === 1 ? nounSingular : nounPlural;
-  const verb = preFilterCount === 1 ? "was" : "were";
-  const pronoun = preFilterCount === 1 ? "it" : "them";
-  return `  (all ${preFilterCount} ${noun} ${verb} filtered out by --grep ${grep} -- widen or drop the filter to see ${pronoun})`;
-}
-function filtersFilteredToEmptyNotice(preFilterCount, activeFilters, nounSingular, nounPlural, reassurance) {
-  const noun = preFilterCount === 1 ? nounSingular : nounPlural;
-  const cause = activeFilters.length === 0 ? "the active filter" : activeFilters.join(" + ");
-  const knob = activeFilters.length > 1 ? "filters" : "filter";
-  const verb = preFilterCount === 1 ? "was" : "were";
-  const tail = reassurance === void 0 ? "" : `; ${reassurance}`;
-  return `  (all ${preFilterCount} ${noun} ${verb} filtered out by ${cause}${tail} -- widen or drop the ${knob} to see them)`;
-}
 function countNoun(count, singular, plural = `${singular}s`) {
   return `${count} ${count === 1 ? singular : plural}`;
 }
@@ -1070,25 +1078,25 @@ function extractErrorMessage(err, fallback = "") {
 }
 function requireStrictInt(flag, raw) {
   if (!/^-?\d+$/.test(raw)) {
-    throw new Error(`${flag} must be a number, got: "${raw}"`);
+    throw new Error(`${flag} must be a number, got: ${echoedValue(raw)}`);
   }
   const n = Number.parseInt(raw, 10);
   if (!Number.isFinite(n)) {
-    throw new Error(`${flag} must be a number, got: "${raw}"`);
+    throw new Error(`${flag} must be a number, got: ${echoedValue(raw)}`);
   }
   return n;
 }
 function requireNonNegativeStrictInt(flag, raw) {
   const n = requireStrictInt(flag, raw);
   if (n < 0) {
-    throw new Error(`${flag} must be a non-negative number, got: "${raw}"`);
+    throw new Error(`${flag} must be a non-negative number, got: ${echoedValue(raw)}`);
   }
   return n;
 }
 function requirePositiveStrictInt(flag, raw) {
   const n = requireStrictInt(flag, raw);
   if (n <= 0) {
-    throw new Error(`${flag} must be a positive number, got: "${raw}"`);
+    throw new Error(`${flag} must be a positive number, got: ${echoedValue(raw)}`);
   }
   return n;
 }
@@ -1207,6 +1215,15 @@ function recordCreatedRootKey(filePath, rootKey) {
 function takeCreatedRootKey(filePath, rootKey) {
   return takeCreatedConfig(rootKeyMarker(filePath, rootKey));
 }
+function turnedOffMarker(filePath, key) {
+  return `${filePath}#turned-off=${key}:true`;
+}
+function recordTurnedOffSetting(filePath, key) {
+  recordCreatedConfig(turnedOffMarker(filePath, key));
+}
+function takeTurnedOffSetting(filePath, key) {
+  return takeCreatedConfig(turnedOffMarker(filePath, key));
+}
 function recordCreatedBackup(backupPath) {
   recordCreatedConfig(backupPath);
 }
@@ -1285,6 +1302,8 @@ export {
   takeCreatedConfig,
   recordCreatedRootKey,
   takeCreatedRootKey,
+  recordTurnedOffSetting,
+  takeTurnedOffSetting,
   removeCreatedBackups,
   ensureDirRecordingCreation,
   removeCreatedIfEmpty,
@@ -1327,14 +1346,13 @@ export {
   cappedSourceBytesSaved,
   IDENTICAL_READ_MIN_BODY_BYTES,
   containsLineRun,
+  isSequentialPagingChain,
   LOCK_WAIT_MS_HARDENED,
   withFileLock,
   stripLower,
   sanitizeIdForFilename,
   toKB,
   compileGrepMatcher,
-  grepFilteredToEmptyNotice,
-  filtersFilteredToEmptyNotice,
   countNoun,
   excludeTestsHiddenNote,
   countContentLines,

package/dist/{token-goat-chunk-Z57YODA2.mjs → token-goat-chunk-I7VKZZAW.mjs}

@@ -3,13 +3,13 @@ const require = __cjsRequire(import.meta.url);
 import {
   computeSymbolFingerprints,
   symbolNamesInFile
-} from "./token-goat-chunk-PU7V3FD6.mjs";
+} from "./token-goat-chunk-COPNXRJM.mjs";
 import {
   resolveIndexPath
 } from "./token-goat-chunk-FNFBKLRD.mjs";
 import {
   globalDbPath
-} from "./token-goat-chunk-VES7EL7O.mjs";
+} from "./token-goat-chunk-CO3UYX6G.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";

package/dist/{token-goat-chunk-NYKZLXMK.mjs → token-goat-chunk-IA6XSPE3.mjs}

@@ -8,14 +8,14 @@ import {
   isCodexInstalled,
   isCopilotCliInstalled,
   isInstalled
-} from "./token-goat-chunk-OJBNYTJP.mjs";
+} from "./token-goat-chunk-7MAOA6X4.mjs";
 import {
   loadConfig
-} from "./token-goat-chunk-7IN2MKDS.mjs";
+} from "./token-goat-chunk-7EZTZOMC.mjs";
 import {
   recordCreatedBy,
   upsertDelimitedBlock
-} from "./token-goat-chunk-GOLEOXZP.mjs";
+} from "./token-goat-chunk-HU4TORC5.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -130,13 +130,13 @@ function checkInstructionGates(rootDir = process.cwd()) {
     return {
       name: "Instruction gate",
       status: "warn",
-      message: `missing in ${unGated} and in the user-level instruction files 'token-goat install' writes (agents will bypass token-goat and read whole files). Run 'token-goat doctor --fix' to inject automatically.`
+      message: `missing in ${unGated} and in the user-level instruction files \`token-goat install\` writes (agents will bypass token-goat and read whole files). Run \`token-goat doctor --fix\` to inject automatically.`
     };
   }
   return {
     name: "Instruction gate",
     status: "warn",
-    message: "missing: no user-level instruction file carries it and no project instruction file was found (CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md). Run 'token-goat install', or 'token-goat doctor --fix' to create CLAUDE.md with the routing gate."
+    message: "missing: no user-level instruction file carries it and no project instruction file was found (CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md). Run `token-goat install`, or `token-goat doctor --fix` to create CLAUDE.md with the routing gate."
   };
 }
 function repairInstructionGates(rootDir = process.cwd()) {
@@ -192,7 +192,7 @@ function checkHarnessCacheEfficiency(rootDir = process.cwd()) {
     return {
       name: "Harness efficiency",
       status: "warn",
-      message: `${ideDetected.join(", ")} workspace detected without CLI harness config. IDE hooks cannot fold/trim built-in reads. If you also use a CLI agent, run 'token-goat install' for Claude Code, or 'token-goat install --codex' or '--copilot' for those.`
+      message: `${ideDetected.join(", ")} workspace detected without CLI harness config. IDE hooks cannot fold/trim built-in reads. If you also use a CLI agent, run \`token-goat install\` for Claude Code, or \`token-goat install --codex\` or '--copilot' for those.`
     };
   }
   if (cliDetected.length > 0) {