token-goat 2.9.29 → 2.9.30

package/dist/{token-goat-chunk-G23DWHV4.mjs → token-goat-chunk-664RTTUV.mjs}

@@ -4,26 +4,30 @@ import {
   CONTENT_DELIVERED_REASON,
   classifyToolError,
   errorPrefix
-} from "./token-goat-chunk-E4ZOJIZK.mjs";
-import "./token-goat-chunk-E5TK5DNO.mjs";
-import "./token-goat-chunk-ZER6EAXZ.mjs";
-import "./token-goat-chunk-EUSDXRXU.mjs";
-import "./token-goat-chunk-TDUT2CL6.mjs";
-import "./token-goat-chunk-52NSDWYY.mjs";
-import "./token-goat-chunk-2WOUYWLM.mjs";
-import "./token-goat-chunk-CIQ2FTY3.mjs";
-import "./token-goat-chunk-7CPMDFGB.mjs";
-import "./token-goat-chunk-TGOXNAHW.mjs";
+} from "./token-goat-chunk-PEPTHRFF.mjs";
+import "./token-goat-chunk-MNWKPRAL.mjs";
+import "./token-goat-chunk-APGZXSPS.mjs";
+import "./token-goat-chunk-COBQGL5S.mjs";
+import "./token-goat-chunk-ATCPY7EQ.mjs";
+import "./token-goat-chunk-VPBBTSJR.mjs";
+import "./token-goat-chunk-C63JQV5K.mjs";
+import "./token-goat-chunk-JB6QN6VF.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-XYWPOSCN.mjs";
-import "./token-goat-chunk-TCQANXYC.mjs";
+import "./token-goat-chunk-GOLEOXZP.mjs";
+import "./token-goat-chunk-AM5V6GSX.mjs";
 import {
   displaySafeText
-} from "./token-goat-chunk-NMTKNYGF.mjs";
-import "./token-goat-chunk-MELOKFDJ.mjs";
-import "./token-goat-chunk-JTKCQMQA.mjs";
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import "./token-goat-chunk-VES7EL7O.mjs";
+import "./token-goat-chunk-KWPNJBDH.mjs";
+import "./token-goat-chunk-HAVAOB3S.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -78,6 +82,15 @@ function newToolErrorAccumulator() {
     finish() {
       const topUnknown = [...unknownPrefixes.values()].sort((a, b) => b.count - a.count || byCodeUnit(a.tool, b.tool) || byCodeUnit(a.prefix, b.prefix)).slice(0, UNKNOWN_PREFIX_LIMIT);
       return { byTool: sortTallies(tools), byModel: sortTallies(models), unknownPrefixes: topUnknown };
+    },
+    checkpoint() {
+      const saved = structuredClone([[...tools], [...models], [...unknownPrefixes]]);
+      return () => {
+        for (const [live, copy] of [[tools, saved[0]], [models, saved[1]], [unknownPrefixes, saved[2]]]) {
+          live.clear();
+          for (const [k, v] of copy) live.set(k, v);
+        }
+      };
     }
   };
 }

package/dist/token-goat-chunk-67TQJ76B.mjs

@@ -0,0 +1,57 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  recordStat
+} from "./token-goat-chunk-3Z5S4KGM.mjs";
+import {
+  loadConfig
+} from "./token-goat-chunk-7IN2MKDS.mjs";
+import {
+  fenceUntrustedContent,
+  scanForInjectionPatterns
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/untrusted_fence.ts
+init_define_import_meta_env();
+function injectionFencingEnabled() {
+  try {
+    return loadConfig().injection.enabled;
+  } catch {
+    return true;
+  }
+}
+function fenceUntrusted(text, tag) {
+  if (!injectionFencingEnabled()) return text;
+  return fenceUntrustedContent(text, scanAndRecord(text), tag);
+}
+function fenceUntrustedSpans(spans, tag) {
+  const joined = spans.map((s) => s.text).join("");
+  if (!injectionFencingEnabled()) return joined;
+  return fenceUntrustedContent(spans, scanAndRecord(spans.filter((s) => s.own !== true).map((s) => s.text).join("")), tag);
+}
+function fenceWithMatches(text, matches, tag) {
+  if (!injectionFencingEnabled()) return text;
+  return tag === void 0 ? fenceUntrustedContent(text, matches) : fenceUntrustedContent(text, matches, tag);
+}
+function scanAndRecord(text) {
+  if (!injectionFencingEnabled()) return [];
+  let matches;
+  try {
+    matches = scanForInjectionPatterns(text);
+  } catch {
+    matches = [];
+  }
+  if (matches.length > 0) recordStat("injection_detected", 0, 0, void 0, matches.join(","));
+  return matches;
+}
+
+export {
+  injectionFencingEnabled,
+  fenceUntrusted,
+  fenceUntrustedSpans,
+  fenceWithMatches,
+  scanAndRecord
+};

package/dist/token-goat-chunk-6QMAS7AB.mjs

@@ -0,0 +1,42 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  DEFAULT_HEARTBEAT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_SECONDS,
+  MAX_CAPTURE_BYTES,
+  resolveFilter,
+  run,
+  runRaw,
+  spawnTarget,
+  unknownFilterNotice
+} from "./token-goat-chunk-7F2UBPD3.mjs";
+import "./token-goat-chunk-54K3EUV3.mjs";
+import "./token-goat-chunk-COBQGL5S.mjs";
+import "./token-goat-chunk-AFLYLHDH.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 {
+  DEFAULT_HEARTBEAT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_SECONDS,
+  MAX_CAPTURE_BYTES,
+  resolveFilter,
+  run,
+  runRaw,
+  spawnTarget,
+  unknownFilterNotice
+};

package/dist/token-goat-chunk-7BXSNBY5.mjs

@@ -0,0 +1,253 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  getTrackedFiles
+} from "./token-goat-chunk-FBNQNSJK.mjs";
+import {
+  enqueueDirtyPathsSafe
+} from "./token-goat-chunk-H2PHHGM5.mjs";
+import {
+  indexedPathSpellingIsStale,
+  parserFingerprintForLanguage
+} from "./token-goat-chunk-RHXKCZX3.mjs";
+import {
+  getProjectFileEntries,
+  projectScopeClause
+} from "./token-goat-chunk-HYBFA5X3.mjs";
+import {
+  getDb
+} from "./token-goat-chunk-VL3YIFHZ.mjs";
+import {
+  fingerprintFile,
+  getDisplayRoot,
+  indexedFileIsGone
+} from "./token-goat-chunk-7IN2MKDS.mjs";
+import {
+  countNoun
+} from "./token-goat-chunk-GOLEOXZP.mjs";
+import {
+  foldPath
+} from "./token-goat-chunk-AM5V6GSX.mjs";
+import {
+  displaySafeJson,
+  normalizePath,
+  resolveIndexPath,
+  toDisplayPath
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import {
+  globalDbPath
+} from "./token-goat-chunk-VES7EL7O.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/reconcile.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+var DEFAULT_RECONCILE_BUDGET_MS = 1500;
+function readReconcileCursor(dbPath, root) {
+  try {
+    const row = getDb(dbPath).prepare("SELECT last_scanned_path FROM reconcile_cursor WHERE root = ?").get(root);
+    return row?.last_scanned_path ?? null;
+  } catch {
+    return null;
+  }
+}
+function writeReconcileCursor(dbPath, root, lastScannedPath) {
+  try {
+    getDb(dbPath).prepare(
+      "INSERT INTO reconcile_cursor (root, last_scanned_path, updated_at) VALUES (?, ?, ?) ON CONFLICT(root) DO UPDATE SET last_scanned_path = excluded.last_scanned_path, updated_at = excluded.updated_at"
+    ).run(root, lastScannedPath, Date.now());
+  } catch {
+  }
+}
+function clearReconcileCursor(dbPath, root) {
+  try {
+    getDb(dbPath).prepare("DELETE FROM reconcile_cursor WHERE root = ?").run(root);
+  } catch {
+  }
+}
+function runReconcile(opts = {}) {
+  const raw = reconcileProject(opts);
+  const root = getDisplayRoot(opts.cwd ?? process.cwd());
+  const display = (paths) => paths.map((p) => toDisplayPath(root, p)).sort();
+  const result = {
+    ...raw,
+    changed: display(raw.changed),
+    added: display(raw.added),
+    removed: display(raw.removed)
+  };
+  if (opts.json === true) {
+    process.stdout.write(`${displaySafeJson(result)}
+`);
+    return 0;
+  }
+  const unqueued = opts.dryRun === true ? 0 : result.changed.length + result.added.length + result.removed.length - result.enqueued;
+  const noneQueued = unqueued > 0 && result.enqueued === 0;
+  const lines = [];
+  if (isReconcileClean(result)) {
+    if (!result.trackedUnavailable) {
+      lines.push(`Index matches disk: ${countNoun(result.scanned, "file")} checked in ${result.elapsedMs}ms.`);
+    }
+  } else {
+    const verb = opts.dryRun === true ? "would reindex" : noneQueued ? "not queued" : "queued for reindexing";
+    const dropVerb = opts.dryRun === true ? "would drop from the index" : noneQueued ? "not queued" : "queued for removal";
+    if (result.changed.length > 0) lines.push(`${countNoun(result.changed.length, "file")} changed since indexing (${verb}):`);
+    for (const f of result.changed) lines.push(`  ~ ${f}`);
+    if (result.added.length > 0) lines.push(`${countNoun(result.added.length, "file")} not in the index (${verb}):`);
+    for (const f of result.added) lines.push(`  + ${f}`);
+    if (result.removed.length > 0) lines.push(`${countNoun(result.removed.length, "file")} indexed but gone from disk (${dropVerb}):`);
+    for (const f of result.removed) lines.push(`  - ${f}`);
+    lines.push(`Checked ${countNoun(result.scanned, "file")} in ${result.elapsedMs}ms.`);
+  }
+  if (result.mtimeOnly > 0) {
+    lines.push(`${countNoun(result.mtimeOnly, "file")} had a newer timestamp but identical content, so ${result.mtimeOnly === 1 ? "it was" : "they were"} left alone.`);
+  }
+  if (result.parserStale > 0) {
+    const reparseVerb = opts.dryRun === true ? "would reparse" : noneQueued ? "not queued" : "queued for reparse";
+    lines.push(`${countNoun(result.parserStale, "file")} of the above ${result.parserStale === 1 ? "was" : "were"} unchanged on disk but indexed by an older parser (${reparseVerb}).`);
+  }
+  if (result.embedStale > 0) {
+    const reembedVerb = opts.dryRun === true ? "would re-embed" : noneQueued ? "not queued" : "queued for re-embedding";
+    lines.push(`${countNoun(result.embedStale, "file")} of the above ${result.embedStale === 1 ? "was" : "were"} unchanged on disk but held out-of-date embeddings (${reembedVerb}).`);
+  }
+  if (unqueued > 0) {
+    lines.push(`${countNoun(unqueued, "file")} of the above could not be queued for reindexing: the queue takes nothing under the OS temp dir, and nothing at all when it cannot be written. Run token-goat index here to bring the index up to date.`);
+  }
+  if (result.trackedUnavailable) {
+    lines.push("This project has an index but git listed no files in it, so nothing on disk was compared against it and changed or new files could not be found. Files gone from disk were still detected. Run token-goat inside the repository, or reindex with --walk if this directory is deliberately not under git.");
+  }
+  if (result.budgetExhausted) {
+    lines.push(`Stopped at the ${result.elapsedMs}ms budget with ${countNoun(result.unscanned, "file")} unchecked, so there may be more drift; deletions were not computed at all, because an unchecked file is indistinguishable from a deleted one. Raise --budget-ms for a complete sweep.`);
+  }
+  process.stdout.write(`${lines.join("\n")}
+`);
+  return 0;
+}
+function isReconcileClean(r) {
+  return r.changed.length === 0 && r.added.length === 0 && r.removed.length === 0;
+}
+function reconcileProject(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const budgetMs = opts.budgetMs ?? DEFAULT_RECONCILE_BUDGET_MS;
+  const calledAt = Date.now();
+  const dbPath = opts.dbPath ?? globalDbPath();
+  const tracked = getTrackedFiles(cwd);
+  const projectRoot = resolveIndexPath(".", cwd);
+  const indexed = getProjectFileEntries(projectRoot, dbPath);
+  const chunkScope = projectScopeClause("file_path");
+  const chunked = new Set(
+    getDb(dbPath).prepare(`SELECT DISTINCT file_path FROM chunks WHERE ${chunkScope.clause}`).pluck().all(...chunkScope.params(projectRoot)).map((p) => foldPath(normalizePath(p)))
+  );
+  const startedAt = Date.now();
+  let scanOrder = tracked;
+  const cursorPath = tracked.length > 0 ? readReconcileCursor(dbPath, projectRoot) : null;
+  if (cursorPath !== null) {
+    const cursorFolded = foldPath(normalizePath(cursorPath));
+    const cursorIdx = tracked.findIndex((f) => foldPath(normalizePath(f)) === cursorFolded);
+    if (cursorIdx !== -1) {
+      scanOrder = [...tracked.slice(cursorIdx + 1), ...tracked.slice(0, cursorIdx + 1)];
+    }
+  }
+  const changed = [];
+  const added = [];
+  const seenOnDisk = /* @__PURE__ */ new Set();
+  let mtimeOnly = 0;
+  let parserStale = 0;
+  let embedStale = 0;
+  let scanned = 0;
+  let budgetExhausted = false;
+  let lastScanned = null;
+  for (const file of scanOrder) {
+    if (Date.now() - startedAt >= budgetMs) {
+      budgetExhausted = true;
+      break;
+    }
+    scanned++;
+    lastScanned = file;
+    const normalized = normalizePath(file);
+    const folded = foldPath(normalized);
+    seenOnDisk.add(folded);
+    const entry = indexed.get(folded);
+    if (entry === void 0) {
+      added.push(file);
+      continue;
+    }
+    if (entry.parserSha !== parserFingerprintForLanguage(entry.language)) {
+      changed.push(file);
+      parserStale++;
+      continue;
+    }
+    if (entry.embedSha === "" && chunked.has(folded)) {
+      changed.push(file);
+      embedStale++;
+      continue;
+    }
+    if (normalizePath(entry.filePath).slice(projectRoot.length) !== normalized.slice(projectRoot.length) && indexedPathSpellingIsStale(entry.filePath, file)) {
+      changed.push(file);
+      continue;
+    }
+    let mtimeMs;
+    try {
+      mtimeMs = fs.statSync(file).mtimeMs;
+    } catch {
+      changed.push(file);
+      continue;
+    }
+    if (entry.mtime !== 0 && mtimeMs / 1e3 === entry.mtime) continue;
+    const diskSha = fingerprintFile(file);
+    if (diskSha === null) {
+      changed.push(file);
+      continue;
+    }
+    if (diskSha === entry.sha) {
+      mtimeOnly++;
+      continue;
+    }
+    changed.push(file);
+  }
+  const trackedUnavailable = tracked.length === 0 && indexed.size > 0;
+  const removed = [];
+  if (!budgetExhausted) {
+    for (const [folded, entry] of indexed) {
+      if (seenOnDisk.has(folded)) continue;
+      if (Date.now() - startedAt >= budgetMs) {
+        budgetExhausted = true;
+        removed.length = 0;
+        break;
+      }
+      if (indexedFileIsGone(entry.filePath)) removed.push(entry.filePath);
+    }
+  }
+  let enqueued = 0;
+  if (opts.dryRun !== true) {
+    const toEnqueue = [...changed, ...added, ...removed].map((p) => resolveIndexPath(p, cwd));
+    enqueued = enqueueDirtyPathsSafe(toEnqueue, { alreadyResolved: true });
+    if (budgetExhausted) {
+      if (lastScanned !== null) writeReconcileCursor(dbPath, projectRoot, lastScanned);
+    } else if (tracked.length > 0) {
+      clearReconcileCursor(dbPath, projectRoot);
+    }
+  }
+  return {
+    scanned,
+    changed,
+    added,
+    removed,
+    mtimeOnly,
+    parserStale,
+    embedStale,
+    budgetExhausted,
+    trackedUnavailable,
+    unscanned: Math.max(0, tracked.length - scanned),
+    enqueued,
+    elapsedMs: Date.now() - calledAt
+  };
+}
+
+export {
+  DEFAULT_RECONCILE_BUDGET_MS,
+  runReconcile,
+  isReconcileClean,
+  reconcileProject
+};

package/dist/{token-goat-chunk-IVWI2OCK.mjs → token-goat-chunk-7F2UBPD3.mjs}

@@ -2,28 +2,32 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   deliveredOutputBytes
-} from "./token-goat-chunk-L7H3U27L.mjs";
+} from "./token-goat-chunk-54K3EUV3.mjs";
 import {
   PassthroughFilter,
+  TOOL_FILTERS,
   compressedTokensSaved,
   deliverCompressed,
   dispatchArgv,
   filterByName,
   selectFilter
-} from "./token-goat-chunk-ZER6EAXZ.mjs";
+} from "./token-goat-chunk-COBQGL5S.mjs";
 import {
   storeBashOutputSync
-} from "./token-goat-chunk-O6I2XU4P.mjs";
-import {
-  capTokens,
-  shlexSplit
-} from "./token-goat-chunk-2WOUYWLM.mjs";
+} from "./token-goat-chunk-AFLYLHDH.mjs";
 import {
   recordStat
-} from "./token-goat-chunk-CIQ2FTY3.mjs";
+} from "./token-goat-chunk-3Z5S4KGM.mjs";
 import {
   loadConfig
-} from "./token-goat-chunk-TGOXNAHW.mjs";
+} from "./token-goat-chunk-7IN2MKDS.mjs";
+import {
+  displaySafeText
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import {
+  capTokens,
+  shlexSplit
+} from "./token-goat-chunk-KWPNJBDH.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -185,6 +189,8 @@ function resolveFilter(command, filterName, cwd) {
   if (filterName) {
     const named = filterByName(filterName);
     if (named !== null) return { filter: named, argv };
+    const filter = split === null ? null : selectFilter(split, effectiveCwd);
+    return { filter, argv, unknownFilter: filterName };
   }
   if (split === null) return { filter: null, argv };
   return { filter: selectFilter(split, effectiveCwd), argv };
@@ -201,7 +207,7 @@ function spawnTarget(command, nativeShell, shellType) {
         "-NoProfile",
         "-NonInteractive",
         "-Command",
-        "$c = $env:TG_CMD; Remove-Item Env:\\TG_CMD -ErrorAction SilentlyContinue; [scriptblock]::Create($c).Invoke(); if ($LASTEXITCODE -ne $null -and $LASTEXITCODE -ne 0) { exit $LASTEXITCODE }"
+        `$TgC = $env:TG_CMD; Remove-Item Env:TG_CMD -ErrorAction SilentlyContinue; $global:TgOk = $true; $TgN = [Environment]::NewLine; $TgK = 'if ($global:TgOk = $?) { }'; $TgT = $null; $TgE = $null; $TgA = [System.Management.Automation.Language.Parser]::ParseInput($TgC, [ref]$TgT, [ref]$TgE); $TgX = [System.Collections.Generic.List[object]]::new(); $TgL = [System.Collections.Generic.List[string]]::new(); $TgTop = { param($n) $p = $n.Parent; while ($p -isnot [System.Management.Automation.Language.ScriptBlockAst]) { $p = $p.Parent }; [object]::ReferenceEquals($p, $TgA) }; if ($TgE.Count -eq 0) { if ($TgA.EndBlock.Unnamed) { $TgX.Add([pscustomobject]@{ P = $TgC.Length; O = 0; L = 0; T = ($TgN + $TgK) }) }; foreach ($TgB in @($TgA.BeginBlock, $TgA.ProcessBlock, $TgA.EndBlock, $TgA.CleanBlock)) { if ($TgB -and -not $TgB.Unnamed) { $TgX.Add([pscustomobject]@{ P = ($TgB.Extent.EndOffset - 1); O = 0; L = 0; T = ($TgN + $TgK + $TgN) }) } }; foreach ($TgR in $TgA.FindAll({ param($n) $n -is [System.Management.Automation.Language.ReturnStatementAst] -and (& $TgTop $n) }, $true)) { if ($TgR.Pipeline -and $TgR.Pipeline.GetPureExpression()) { $TgX.Add([pscustomobject]@{ P = $TgR.Extent.StartOffset; O = 1; L = 6; T = '$TgW = (' }); $TgX.Add([pscustomobject]@{ P = $TgR.Extent.EndOffset; O = 1; L = 0; T = '), $?; $global:TgOk = $TgW[1]; return $TgW[0]' }) } else { $TgX.Add([pscustomobject]@{ P = $TgR.Extent.StartOffset; O = 1; L = 6; T = 'return $(' }); $TgX.Add([pscustomobject]@{ P = $TgR.Extent.EndOffset; O = 1; L = 0; T = $(if ($TgR.Pipeline) { '; ' + $TgK + ')' } else { $TgK + ')' }) }) } }; $TgD = @($TgA.FindAll({ param($n) $n -is [System.Management.Automation.Language.LabeledStatementAst] -and $n.Label }, $true) | ForEach-Object { $_.Label } | Select-Object -Unique); foreach ($TgR in $TgA.FindAll({ param($n) ($n -is [System.Management.Automation.Language.BreakStatementAst] -or $n -is [System.Management.Automation.Language.ContinueStatementAst]) -and (& $TgTop $n) }, $true)) { $TgX.Add([pscustomobject]@{ P = $TgR.Extent.StartOffset; O = 0; L = 0; T = ($TgK + '; ') }); if ($TgR.Label -is [System.Management.Automation.Language.StringConstantExpressionAst]) { if ($TgR.Label.Value -eq '') { } elseif ($TgD -contains $TgR.Label.Value) { $TgL.Add($TgR.Label.Value) } else { $TgX.Add([pscustomobject]@{ P = $TgR.Label.Extent.StartOffset; O = 1; L = $TgR.Label.Extent.Text.Length; T = 'TgEsc' }); $TgL.Add('TgEsc') } } elseif ($TgR.Label) { $TgX.Add([pscustomobject]@{ P = $TgR.Label.Extent.StartOffset; O = 1; L = $TgR.Label.Extent.Text.Length; T = ('$(if ((-not [string]($TgV = (' + $TgR.Label.Extent.Text + '))) -or (@(' + (($TgD | ForEach-Object { "'" + $_ + "'" }) -join ',') + ') -contains $TgV)) { $TgV } else { ''TgEsc'' }; if (-not $global:TgOk) { Microsoft.PowerShell.Utility\\Write-Error TgRestore -ErrorAction Ignore })') }); foreach ($TgI in $TgD) { $TgL.Add($TgI) }; $TgL.Add('TgEsc') } }; foreach ($TgR in $TgA.FindAll({ param($n) $n -is [System.Management.Automation.Language.TryStatementAst] -and $n.Finally -and $n.Finally.Statements.Count -gt 0 -and (& $TgTop $n) }, $true)) { $TgX.Add([pscustomobject]@{ P = ($TgR.Finally.Extent.EndOffset - 1); O = 0; L = 0; T = ($TgN + $TgK + $TgN) }) } } else { throw [System.Management.Automation.ParseException]::new($TgE) }; $TgS = $TgC; foreach ($TgI in ($TgX | Sort-Object -Property @{ Expression = 'P'; Descending = $true }, @{ Expression = 'O'; Descending = $false })) { $TgS = $TgS.Substring(0, $TgI.P) + $TgI.T + $TgS.Substring($TgI.P + $TgI.L) }; $TgO = $(if ($PSVersionTable.PSVersion.Major -lt 6) { 'do { @() | & ([scriptblock]::Create($TgS)) } while ($false)' } else { 'do { & ([scriptblock]::Create($TgS)) } while ($false)' }); foreach ($TgI in ($TgL | Select-Object -Unique)) { $TgO = ':' + $TgI + ' do { ' + $TgO + ' } while ($false)' }; . ([scriptblock]::Create($TgO)); if ($global:TgOk) { exit 0 } else { exit 1 }`
       ],
       shell: false,
       cmdEnv: { TG_CMD: command }
@@ -235,9 +241,19 @@ function resolveCompressLimits() {
     return { maxLines: 1e3, maxBytes: 64 * 1024 };
   }
 }
+function unknownFilterNotice(name, fallback) {
+  const typed = name.toLowerCase();
+  const names = ["generic", "passthrough", ...new Set(TOOL_FILTERS.map((f) => f.name))];
+  const near = names.filter((n) => n.split("-").some((word) => word.startsWith(typed)) || typed.startsWith(n)).slice(0, 5);
+  const instead = fallback === null ? "running it uncompressed" : `auto-detected ${fallback.name}`;
+  const hint = near.length > 0 ? `; did you mean ${near.join(", ")}?` : "";
+  return `[token-goat: no filter named "${displaySafeText(name)}", ${instead}${hint}]
+`;
+}
 async function run(command, opts = {}) {
   const timeout = opts.timeout ?? DEFAULT_TIMEOUT_SECONDS;
-  const { filter, argv } = resolveFilter(command, opts.filterName, opts.cwd);
+  const { filter, argv, unknownFilter } = resolveFilter(command, opts.filterName, opts.cwd);
+  if (unknownFilter !== void 0) (opts.writeStderr ?? ((s) => process.stderr.write(s)))(unknownFilterNotice(unknownFilter, filter));
   if (filter === null) {
     if ((opts.maxTokens ?? 0) > 0 || opts.quietSuccess) {
       return wrapAndCompress(command, argv, new PassthroughFilter(), timeout, resolveProfile(opts.compressionProfile), opts);
@@ -258,6 +274,11 @@ function passthrough(command, timeout, cwd, env, nativeShell, shellType) {
     stdio: "inherit"
   });
   if (isTimeout(result.error)) return 124;
+  if (result.error) {
+    process.stderr.write(`[token-goat: ${displaySafeText(result.error.message)}]
+`);
+    return 127;
+  }
   if (result.status !== null) return result.status;
   if (result.signal) return signalExitCode(result.signal);
   return 0;
@@ -297,7 +318,12 @@ async function wrapAndCompress(command, argv, filter, timeout, profile, opts) {
   };
   child.stdout?.on("data", onData(stdoutSink));
   child.stderr?.on("data", onData(stderrSink));
+  let spawnError = null;
   const { code, signal } = await new Promise((resolve) => {
+    child.on("error", (e) => {
+      spawnError = e;
+      resolve({ code: 127, signal: null });
+    });
     child.on("close", (code2, signal2) => resolve({ code: code2, signal: signal2 }));
   });
   heartbeat.stop();
@@ -308,6 +334,7 @@ async function wrapAndCompress(command, argv, filter, timeout, profile, opts) {
     stdoutText += `
 [token-goat: capture capped at ${MAX_CAPTURE_BYTES / (1024 * 1024)} MiB]`;
   }
+  if (spawnError !== null) stderrText = (stderrText ? stderrText + "\n" : "") + `[token-goat: ${displaySafeText(spawnError.message)}]`;
   let exitCode;
   if (timedOut) {
     exitCode = 124;
@@ -363,6 +390,8 @@ export {
   MAX_CAPTURE_BYTES,
   DEFAULT_HEARTBEAT_INTERVAL_MS,
   resolveFilter,
+  spawnTarget,
+  unknownFilterNotice,
   run,
   runRaw
 };