token-goat 2.9.29 → 2.9.30

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

@@ -0,0 +1,25 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/types.ts
+init_define_import_meta_env();
+var HOOK_EVENTS = [
+  "pre_tool_use",
+  "post_tool_use",
+  "notification",
+  "stop",
+  "pre_compact",
+  "post_compact",
+  "user_prompt_submit",
+  "subagent_stop",
+  "subagent_start",
+  "session_start",
+  "post_tool_use_failure"
+];
+
+export {
+  HOOK_EVENTS
+};

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

@@ -0,0 +1,47 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  WorkerAlreadyRunningError,
+  WorkerDataDirUnwritableError,
+  appendWorkerErrorLog,
+  claimWorkerPidFile,
+  currentDaemonStamp,
+  dataDirWriteRefusal,
+  drainHeartbeatPathFor,
+  ensureWorkerAlive,
+  isWorkerRunning,
+  oneLogLine,
+  readPidFile,
+  resolvePollIntervalMs,
+  startDetachedWorker,
+  stopWorker,
+  workerErrorLogPath,
+  workerPidPath,
+  workerStampPath,
+  writeDrainHeartbeat
+} from "./token-goat-chunk-5KDMCMF2.mjs";
+import "./token-goat-chunk-GOLEOXZP.mjs";
+import "./token-goat-chunk-AM5V6GSX.mjs";
+import "./token-goat-chunk-FNFBKLRD.mjs";
+import "./token-goat-chunk-VES7EL7O.mjs";
+import "./token-goat-chunk-A37V4PBF.mjs";
+export {
+  WorkerAlreadyRunningError,
+  WorkerDataDirUnwritableError,
+  appendWorkerErrorLog,
+  claimWorkerPidFile,
+  currentDaemonStamp,
+  dataDirWriteRefusal,
+  drainHeartbeatPathFor,
+  ensureWorkerAlive,
+  isWorkerRunning,
+  oneLogLine,
+  readPidFile,
+  resolvePollIntervalMs,
+  startDetachedWorker,
+  stopWorker,
+  workerErrorLogPath,
+  workerPidPath,
+  workerStampPath,
+  writeDrainHeartbeat
+};

package/dist/{token-goat-chunk-2WOUYWLM.mjs → token-goat-chunk-KWPNJBDH.mjs}

@@ -2,7 +2,7 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   stripAnsiEscapes
-} from "./token-goat-chunk-CIQ2FTY3.mjs";
+} from "./token-goat-chunk-HAVAOB3S.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -36,12 +36,24 @@ function clipWideLines(text, maxChars = INPUT_MAX_LINE_CHARS) {
   let clipped = 0;
   const out = text.split("\n").map((line) => {
     if (line.length <= maxChars) return line;
+    const marker = CLIPPED_MARKER_RE.exec(line);
+    if (marker && line.length - marker[0].length <= maxChars) return line;
     clipped += 1;
     const keep = Math.floor(maxChars / 2);
     return line.slice(0, keep) + ` ... [${line.length - maxChars} chars clipped] ... ` + line.slice(line.length - (maxChars - keep));
   });
   return clipped === 0 ? text : out.join("\n");
 }
+function isWholeJsonDocument(text) {
+  const t = text.trim();
+  if (t[0] !== "{" && t[0] !== "[") return false;
+  try {
+    JSON.parse(t);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function clampKeepingEnds(text, maxBytes) {
   const buf = Buffer.from(text, "utf8");
   if (buf.length <= maxBytes) return null;
@@ -195,7 +207,7 @@ function dedupeConsecutive(lines, opts = {}) {
   let count = 0;
   const flush = () => {
     if (prev === null) return;
-    if (count >= minRun) out.push(fmt(prev, count));
+    if (count >= minRun) out.push(prev.trim() === "" ? "" : fmt(prev, count));
     else for (let i = 0; i < count; i++) out.push(prev);
   };
   for (const line of lines) {
@@ -206,7 +218,7 @@ function dedupeConsecutive(lines, opts = {}) {
       out.push(line);
       continue;
     }
-    if (line === prev) {
+    if (line === prev || prev !== null && prev.trim() === "" && line.trim() === "") {
       count += 1;
       continue;
     }
@@ -723,6 +735,7 @@ function shlexSplit(cmd) {
   if (has) tokens.push(cur);
   return tokens;
 }
+var CLIP_MIN_OVERFLOW = 64;
 function capLongLines(lines, maxChars = FALLBACK_MAX_LINE_CHARS) {
   return lines.map((line) => {
     if (line.length <= maxChars) return line;
@@ -732,6 +745,7 @@ function capLongLines(lines, maxChars = FALLBACK_MAX_LINE_CHARS) {
     const high = line.charCodeAt(cut - 1);
     const low = line.charCodeAt(cut);
     if (high >= 55296 && high <= 56319 && low >= 56320 && low <= 57343) cut -= 1;
+    if (line.length - cut <= CLIP_MIN_OVERFLOW) return line;
     const carried = priorClip !== null && priorClip.index >= cut ? Number(priorClip[1]) - priorClip[0].length : 0;
     return `${line.slice(0, cut)}  \u2026 [${line.length - cut + carried} chars elided]`;
   });
@@ -907,14 +921,18 @@ export {
   DEFAULT_MAX_LINES,
   DEFAULT_MAX_BYTES,
   MAX_INSPECT_BYTES,
+  DEFAULT_MAX_INPUT_BYTES,
+  FALLBACK_MAX_LINE_CHARS,
   LONG_LINE_MAX_CHARS,
   getMaxInputBytes,
   INPUT_MAX_LINE_CHARS,
   clipWideLines,
+  isWholeJsonDocument,
   clampKeepingEnds,
   compressionMarker,
   combineStreams,
   ERROR_SIGNAL_RE,
+  TABLE_ROW_ANOMALY_RE,
   TIMESTAMP_PREFIX_RE,
   REDIRECT_TOKEN_RE,
   maskQuotedSpans,
@@ -924,9 +942,13 @@ export {
   hasUnquotedOperator,
   splitOwnTrailingNotices,
   safeDecode,
+  sanitizeControlChars,
+  stripProgress,
   normalise,
   hasHighEntropyToken,
   dedupeConsecutive,
+  dedupeNumericRuns,
+  truncateMiddle,
   truncateMiddleSmart,
   capBytes,
   capTokens,
@@ -945,6 +967,8 @@ export {
   resolvePackageManagerScript,
   shlexSplit,
   capLongLines,
+  GREP_MAX_LINE_CHARS,
+  grepLiteralPattern,
   clipLongMatchLine,
   clipGrepLines,
   fallbackTruncate,

package/dist/{token-goat-chunk-DPNLUJWB.mjs → token-goat-chunk-LOBGHXPB.mjs}

@@ -3,7 +3,7 @@ const require = __cjsRequire(import.meta.url);
 import {
   configPath,
   dataDir
-} from "./token-goat-chunk-MELOKFDJ.mjs";
+} from "./token-goat-chunk-VES7EL7O.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -19,20 +19,35 @@ var PROTOCOL_VERSION = 1;
 var SERVER_SLOTS = 3;
 var MAX_FRAME_BYTES = 64 * 1024 * 1024;
 var KEY_BYTES = 32;
-function bundleDir() {
-  const dir = path.dirname(fileURLToPath(import.meta.url));
+var HARNESS_PROTOCOL_VERSION = 2;
+function challengeMacV2(key, nc, ns, harness, noop, noops) {
+  return mac(key, "S", nc, ns, harness, noop, ...noops.flat());
+}
+function requestMacV2(key, nc, ns, harness, body) {
+  return mac(key, "C", nc, ns, harness, body);
+}
+function outFrameMac(key, nc, ns, seq, data) {
+  return mac(key, "O", nc, ns, String(seq), data);
+}
+function doneFrameMac(key, nc, ns, stdout, exit, n) {
+  return mac(key, "D", nc, ns, stdout, String(exit), String(n));
+}
+function resolveBundleDir(dir) {
   try {
     return fs.realpathSync.native(dir);
   } catch {
     return dir;
   }
 }
-function endpointId(dir) {
+function bundleDir() {
+  return resolveBundleDir(path.dirname(fileURLToPath(import.meta.url)));
+}
+function endpointId(dir, bundle) {
   const fold = (p) => process.platform === "win32" ? p.toLowerCase() : p;
-  return crypto.createHash("sha256").update(`${fold(dir)}\0${fold(bundleDir())}`).digest("hex").slice(0, 16);
+  return crypto.createHash("sha256").update(`${fold(dir)}\0${fold(bundle)}`).digest("hex").slice(0, 16);
 }
-function endpointFor(slot, dir = dataDir()) {
-  const id = `${endpointId(dir)}-${slot}`;
+function endpointFor(slot, dir = dataDir(), bundle = bundleDir()) {
+  const id = `${endpointId(dir, bundle)}-${slot}`;
   if (process.platform === "win32") return String.raw`\\.\pipe\token-goat-hooks-` + id;
   const inData = path.join(dir, `hooks-${id}.sock`);
   if (Buffer.byteLength(inData) < 100) return inData;
@@ -103,7 +118,9 @@ function mac(key, ...parts) {
 }
 function macMatches(expected, actual) {
   if (typeof actual !== "string" || actual.length !== expected.length) return false;
-  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(actual));
+  const want = Buffer.from(expected);
+  const got = Buffer.from(actual);
+  return want.length === got.length && crypto.timingSafeEqual(want, got);
 }
 function writeFrame(socket, message) {
   socket.write(encodeFrame(message));
@@ -198,6 +215,11 @@ function launcherPath() {
 export {
   PROTOCOL_VERSION,
   SERVER_SLOTS,
+  HARNESS_PROTOCOL_VERSION,
+  challengeMacV2,
+  requestMacV2,
+  outFrameMac,
+  doneFrameMac,
   endpointFor,
   serverKeyPath,
   readServerKey,

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

@@ -0,0 +1,37 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  MAX_RESUME_CHARS,
+  MAX_RESUME_TOKENS,
+  buildResumePacket
+} from "./token-goat-chunk-FZ3NEW5O.mjs";
+import "./token-goat-chunk-Q5VTGRH7.mjs";
+import "./token-goat-chunk-Y776AENC.mjs";
+import "./token-goat-chunk-SJHWVNDQ.mjs";
+import "./token-goat-chunk-AFLYLHDH.mjs";
+import "./token-goat-chunk-BPGCUMR7.mjs";
+import "./token-goat-chunk-C63JQV5K.mjs";
+import "./token-goat-chunk-JB6QN6VF.mjs";
+import "./token-goat-chunk-EVMZJ27Z.mjs";
+import "./token-goat-chunk-HYBFA5X3.mjs";
+import "./token-goat-chunk-ARDNEC2U.mjs";
+import "./token-goat-chunk-3Z5S4KGM.mjs";
+import "./token-goat-chunk-VL3YIFHZ.mjs";
+import "./token-goat-chunk-XB5KKOCG.mjs";
+import "./token-goat-chunk-4FVIAHSI.mjs";
+import "./token-goat-chunk-7IN2MKDS.mjs";
+import "./token-goat-chunk-U4N3BN2W.mjs";
+import "./token-goat-chunk-YZAAZU2S.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
+import "./token-goat-chunk-GOLEOXZP.mjs";
+import "./token-goat-chunk-AM5V6GSX.mjs";
+import "./token-goat-chunk-FNFBKLRD.mjs";
+import "./token-goat-chunk-VES7EL7O.mjs";
+import "./token-goat-chunk-KWPNJBDH.mjs";
+import "./token-goat-chunk-HAVAOB3S.mjs";
+import "./token-goat-chunk-A37V4PBF.mjs";
+export {
+  MAX_RESUME_CHARS,
+  MAX_RESUME_TOKENS,
+  buildResumePacket
+};

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

@@ -0,0 +1,13 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/delivering_deny.ts
+init_define_import_meta_env();
+var DELIVERS_CONTENT_RE = /is inlined below instead of the full body|headings below instead of the full body|in place of the full file/;
+
+export {
+  DELIVERS_CONTENT_RE
+};

package/dist/{token-goat-chunk-DNSPXQXQ.mjs → token-goat-chunk-N2NMER56.mjs}

@@ -4,14 +4,12 @@ import {
   parse
 } from "./token-goat-chunk-3BTK54F3.mjs";
 import {
+  compileGuardedRegexCached,
   filtersFilteredToEmptyNotice
-} from "./token-goat-chunk-XYWPOSCN.mjs";
+} from "./token-goat-chunk-GOLEOXZP.mjs";
 import {
   displaySafeText
-} from "./token-goat-chunk-NMTKNYGF.mjs";
-import {
-  compileGuardedRegexCached
-} from "./token-goat-chunk-JTKCQMQA.mjs";
+} from "./token-goat-chunk-FNFBKLRD.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -21,12 +19,11 @@ init_define_import_meta_env();
 var DELIMITER_CANDIDATES = [",", "	", ";", "|"];
 var DELIMITER_SAMPLE_ROWS = 5;
 function detectDelimiter(content) {
-  const slice = content.slice(0, 1e4);
-  if (slice.trim() === "") return ",";
+  if (content.trim() === "") return ",";
   for (const cand of DELIMITER_CANDIDATES) {
     let rows;
     try {
-      rows = parse(slice, { columns: false, skip_empty_lines: true, trim: true, delimiter: cand, bom: true, relax_quotes: true, to: DELIMITER_SAMPLE_ROWS });
+      rows = parse(content, { columns: false, skip_empty_lines: true, trim: true, delimiter: cand, bom: true, relax_quotes: true, to: DELIMITER_SAMPLE_ROWS });
     } catch {
       continue;
     }
@@ -39,7 +36,9 @@ function parseRecords(content, opts) {
   const delimiter = opts.delimiter ?? detectDelimiter(content);
   if (opts.noHeader === true) {
     const rows = parse(content, { columns: false, skip_empty_lines: true, trim: true, delimiter, bom: true, relax_column_count: true, relax_quotes: true });
-    return rows.map((row) => Object.fromEntries(row.map((cell, i) => [`col${i + 1}`, cell])));
+    const width = rows.reduce((max, row) => Math.max(max, row.length), 0);
+    const columns = Array.from({ length: width }, (_, i) => `col${i + 1}`);
+    return { records: rows.map((row) => Object.fromEntries(columns.map((name, i) => [name, row[i] ?? ""]))), columns };
   }
   const header = csvHeader(content, { ...opts, delimiter });
   const dupes = header.filter((name, i) => name !== "" && header.indexOf(name) !== i);
@@ -49,14 +48,25 @@ function parseRecords(content, opts) {
       `duplicate column ${unique.length === 1 ? "name" : "names"} in header: ${unique.join(", ")} \u2014 rename the duplicates or pass --no-header to address columns positionally as col1, col2, \u2026`
     );
   }
-  return parse(content, { columns: true, skip_empty_lines: true, trim: true, delimiter, bom: true, relax_column_count: true, relax_quotes: true });
+  const records = parse(content, { columns: () => header, skip_empty_lines: true, trim: true, delimiter, bom: true, relax_column_count: true, relax_quotes: true });
+  return { records, columns: header };
+}
+function nameBlankHeaders(raw) {
+  const taken = new Set(raw.filter((name) => name !== ""));
+  return raw.map((name, i) => {
+    if (name !== "") return name;
+    let synth = `col${i + 1}`;
+    while (taken.has(synth)) synth += "_";
+    taken.add(synth);
+    return synth;
+  });
 }
 function csvHeader(content, opts) {
   if (opts.noHeader === true) return [];
   const delimiter = opts.delimiter ?? detectDelimiter(content);
   try {
     const rows = parse(content, { columns: false, skip_empty_lines: true, trim: true, delimiter, bom: true, to: 1, relax_quotes: true });
-    return rows[0] ?? [];
+    return nameBlankHeaders(rows[0] ?? []);
   } catch {
     return [];
   }
@@ -128,8 +138,8 @@ function matchesWhere(row, where) {
   }
 }
 function queryCsv(content, opts) {
-  const records = parseRecords(content, opts);
-  const allColumns = records.length > 0 ? Object.keys(records[0]) : [];
+  const { records, columns: allHeader } = parseRecords(content, opts);
+  const allColumns = records.length > 0 ? allHeader : [];
   const realHeader = records.length > 0 ? allColumns : csvHeader(content, opts);
   const columns = opts.columns && opts.columns.length > 0 ? opts.columns : allColumns;
   for (const c of columns) {
@@ -172,8 +182,8 @@ function formatCsvTable(result, activeFilters = []) {
   return lines.join("\n");
 }
 function profileCsv(content, opts = {}) {
-  const records = parseRecords(content, opts);
-  const columns = records.length > 0 ? Object.keys(records[0]) : [];
+  const { records, columns: allHeader } = parseRecords(content, opts);
+  const columns = records.length > 0 ? allHeader : [];
   return columns.map((col) => {
     const values = records.map((r) => r[col] ?? "");
     const nullCount = values.filter((v) => v.trim() === "").length;

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

@@ -0,0 +1,218 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  buildGuidanceBlock,
+  claudeMdPath,
+  codexAgentsPath,
+  copilotCliInstructionsPath,
+  isCodexInstalled,
+  isCopilotCliInstalled,
+  isInstalled
+} from "./token-goat-chunk-OJBNYTJP.mjs";
+import {
+  loadConfig
+} from "./token-goat-chunk-7IN2MKDS.mjs";
+import {
+  recordCreatedBy,
+  upsertDelimitedBlock
+} from "./token-goat-chunk-GOLEOXZP.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/cli_doctor_guidance.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+import * as path from "node:path";
+var INSTRUCTION_GATE_BEGIN = "<!-- token-goat-begin -->";
+var INSTRUCTION_GATE_END = "<!-- token-goat-end -->";
+var CODEX_GATE_BEGIN = "<!-- token-goat-codex-begin -->";
+var CODEX_GATE_END = "<!-- token-goat-codex-end -->";
+function findInstructionGateCandidates(rootDir = process.cwd()) {
+  const candidates = [];
+  const claudeMdPath2 = path.join(rootDir, "CLAUDE.md");
+  const claudeMdExists = fs.existsSync(claudeMdPath2);
+  let claudeMdHasGate = false;
+  if (claudeMdExists) {
+    try {
+      const content = fs.readFileSync(claudeMdPath2, "utf8");
+      claudeMdHasGate = content.includes(INSTRUCTION_GATE_BEGIN) && content.includes(INSTRUCTION_GATE_END);
+    } catch {
+    }
+  }
+  candidates.push({
+    filename: "CLAUDE.md",
+    relativePath: "CLAUDE.md",
+    fullPath: claudeMdPath2,
+    harnessName: "Claude Code",
+    exists: claudeMdExists,
+    hasGate: claudeMdHasGate,
+    beginMarker: INSTRUCTION_GATE_BEGIN,
+    endMarker: INSTRUCTION_GATE_END,
+    fallbackToolClause: "Claude Code's own Read, Grep, and Glob preference rules"
+  });
+  const agentsMdPath = path.join(rootDir, "AGENTS.md");
+  const agentsMdExists = fs.existsSync(agentsMdPath);
+  let agentsMdHasGate = false;
+  if (agentsMdExists) {
+    try {
+      const content = fs.readFileSync(agentsMdPath, "utf8");
+      agentsMdHasGate = content.includes(CODEX_GATE_BEGIN) && content.includes(CODEX_GATE_END) || content.includes(INSTRUCTION_GATE_BEGIN) && content.includes(INSTRUCTION_GATE_END);
+    } catch {
+    }
+  }
+  candidates.push({
+    filename: "AGENTS.md",
+    relativePath: "AGENTS.md",
+    fullPath: agentsMdPath,
+    harnessName: "Codex / AGENTS.md",
+    exists: agentsMdExists,
+    hasGate: agentsMdHasGate,
+    beginMarker: CODEX_GATE_BEGIN,
+    endMarker: CODEX_GATE_END,
+    fallbackToolClause: "Codex's native `exec`, `apply_patch`, and `view_image` tools (shell commands like `cat`/`type` run inside `exec`)"
+  });
+  const copilotInstructionsPath = path.join(rootDir, ".github", "copilot-instructions.md");
+  const copilotInstructionsExists = fs.existsSync(copilotInstructionsPath);
+  let copilotInstructionsHasGate = false;
+  if (copilotInstructionsExists) {
+    try {
+      const content = fs.readFileSync(copilotInstructionsPath, "utf8");
+      copilotInstructionsHasGate = content.includes(INSTRUCTION_GATE_BEGIN) && content.includes(INSTRUCTION_GATE_END);
+    } catch {
+    }
+  }
+  candidates.push({
+    filename: "copilot-instructions.md",
+    relativePath: path.join(".github", "copilot-instructions.md"),
+    fullPath: copilotInstructionsPath,
+    harnessName: "GitHub Copilot CLI",
+    exists: copilotInstructionsExists,
+    hasGate: copilotInstructionsHasGate,
+    beginMarker: INSTRUCTION_GATE_BEGIN,
+    endMarker: INSTRUCTION_GATE_END,
+    fallbackToolClause: "Copilot CLI's native `view`, `grep`, and `glob` tools (with PowerShell commands `Get-Content`/`Select-String` as search fallbacks)"
+  });
+  return candidates;
+}
+function fileHasGate(fullPath, markers) {
+  let content;
+  try {
+    content = fs.readFileSync(fullPath, "utf8");
+  } catch {
+    return false;
+  }
+  return markers.some(([begin, end]) => content.includes(begin) && content.includes(end));
+}
+function findActiveGlobalGates() {
+  const globals = [
+    { fullPath: claudeMdPath(), markers: [[INSTRUCTION_GATE_BEGIN, INSTRUCTION_GATE_END]] },
+    { fullPath: codexAgentsPath(), markers: [[CODEX_GATE_BEGIN, CODEX_GATE_END], [INSTRUCTION_GATE_BEGIN, INSTRUCTION_GATE_END]] },
+    { fullPath: copilotCliInstructionsPath(), markers: [[INSTRUCTION_GATE_BEGIN, INSTRUCTION_GATE_END]] }
+  ];
+  return globals.filter((g) => fileHasGate(g.fullPath, g.markers)).map((g) => g.fullPath);
+}
+function checkInstructionGates(rootDir = process.cwd()) {
+  const candidates = findInstructionGateCandidates(rootDir);
+  const existingFiles = candidates.filter((c) => c.exists);
+  const gatedFiles = existingFiles.filter((c) => c.hasGate);
+  const activeGlobal = findActiveGlobalGates();
+  if (gatedFiles.length > 0 || activeGlobal.length > 0) {
+    const names = [...activeGlobal, ...gatedFiles.map((c) => c.relativePath)].join(", ");
+    return {
+      name: "Instruction gate",
+      status: "ok",
+      message: `active in ${names}`
+    };
+  }
+  if (existingFiles.length > 0) {
+    const unGated = existingFiles.map((c) => c.relativePath).join(", ");
+    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.`
+    };
+  }
+  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."
+  };
+}
+function repairInstructionGates(rootDir = process.cwd()) {
+  const repairs = [];
+  const errors = [];
+  const candidates = findInstructionGateCandidates(rootDir);
+  if (candidates.some((c) => c.hasGate) || findActiveGlobalGates().length > 0) return { repairs, errors };
+  const existingUngated = candidates.filter((c) => c.exists);
+  const fallback = candidates[0];
+  if (!fallback) return { repairs, errors };
+  const targets = existingUngated.length > 0 ? existingUngated : [fallback];
+  const cfg = loadConfig(rootDir);
+  const gdrive = cfg.gdrive?.enabled ?? true;
+  for (const target of targets) {
+    try {
+      const block = buildGuidanceBlock({
+        beginMarker: target.beginMarker,
+        endMarker: target.endMarker,
+        fallbackToolClause: target.fallbackToolClause,
+        gdrive
+      });
+      recordCreatedBy([target.fullPath], () => {
+        fs.mkdirSync(path.dirname(target.fullPath), { recursive: true });
+        upsertDelimitedBlock(target.fullPath, target.beginMarker, target.endMarker, block);
+      });
+      repairs.push(`Injected token-goat routing gate into ${target.relativePath}`);
+    } catch (e) {
+      errors.push(`Failed to inject routing gate into ${target.relativePath}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return { repairs, errors };
+}
+function checkHarnessCacheEfficiency(rootDir = process.cwd()) {
+  const hasVscode = fs.existsSync(path.join(rootDir, ".vscode"));
+  const hasIdea = fs.existsSync(path.join(rootDir, ".idea"));
+  const hasCursor = fs.existsSync(path.join(rootDir, ".cursor")) || fs.existsSync(path.join(rootDir, ".cursorrules"));
+  const hasVs = fs.existsSync(path.join(rootDir, ".vs"));
+  const ideDetected = [
+    hasVscode && "VS Code",
+    hasIdea && "JetBrains",
+    hasCursor && "Cursor",
+    hasVs && "Visual Studio"
+  ].filter(Boolean);
+  const hasClaude = fs.existsSync(path.join(rootDir, ".claude")) || fs.existsSync(path.join(rootDir, "CLAUDE.md"));
+  const hasCopilot = fs.existsSync(path.join(rootDir, ".github", "hooks")) || fs.existsSync(path.join(rootDir, ".github", "copilot-instructions.md"));
+  const hasCodex = fs.existsSync(path.join(rootDir, ".codex")) || fs.existsSync(path.join(rootDir, "AGENTS.md"));
+  const cliDetected = [
+    (hasClaude || isInstalled("user")) && "Claude Code",
+    (hasCopilot || isCopilotCliInstalled()) && "Copilot CLI",
+    (hasCodex || isCodexInstalled()) && "Codex"
+  ].filter(Boolean);
+  if (ideDetected.length > 0 && cliDetected.length === 0) {
+    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.`
+    };
+  }
+  if (cliDetected.length > 0) {
+    return {
+      name: "Harness efficiency",
+      status: "ok",
+      message: `CLI harness configured (${cliDetected.join(", ")})`
+    };
+  }
+  return null;
+}
+
+export {
+  INSTRUCTION_GATE_BEGIN,
+  INSTRUCTION_GATE_END,
+  CODEX_GATE_BEGIN,
+  CODEX_GATE_END,
+  findInstructionGateCandidates,
+  findActiveGlobalGates,
+  checkInstructionGates,
+  repairInstructionGates,
+  checkHarnessCacheEfficiency
+};