token-goat 2.9.30 → 2.9.31

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

@@ -0,0 +1,307 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  evaluateVerification
+} from "./token-goat-chunk-2WLPWKHV.mjs";
+import {
+  claimsCommittedChange
+} from "./token-goat-chunk-PUO5INXP.mjs";
+import "./token-goat-chunk-2XBMMDBD.mjs";
+import "./token-goat-chunk-PFWIMH2E.mjs";
+import "./token-goat-chunk-GWFLAUMQ.mjs";
+import "./token-goat-chunk-PJZXIS3G.mjs";
+import "./token-goat-chunk-OBOFIHKN.mjs";
+import "./token-goat-chunk-NOSS5VWY.mjs";
+import "./token-goat-chunk-SAMFDIS2.mjs";
+import {
+  sessionSidecarPath
+} from "./token-goat-chunk-WBA5SKT4.mjs";
+import "./token-goat-chunk-CIMQ2BB3.mjs";
+import "./token-goat-chunk-WDH44VAU.mjs";
+import "./token-goat-chunk-BPGCUMR7.mjs";
+import "./token-goat-chunk-KQBLRPBN.mjs";
+import "./token-goat-chunk-4ZBFWLXF.mjs";
+import {
+  sessionStateKey
+} from "./token-goat-chunk-C75NA7PL.mjs";
+import {
+  contextOutput,
+  getCwd,
+  passOutput
+} from "./token-goat-chunk-76FGDLRO.mjs";
+import "./token-goat-chunk-GL3ETKSC.mjs";
+import "./token-goat-chunk-NISNMD7T.mjs";
+import "./token-goat-chunk-EVMZJ27Z.mjs";
+import "./token-goat-chunk-IK2DRMFX.mjs";
+import {
+  recordStat
+} from "./token-goat-chunk-U4WHMG6Y.mjs";
+import "./token-goat-chunk-GVB2MUST.mjs";
+import "./token-goat-chunk-XB5KKOCG.mjs";
+import "./token-goat-chunk-OUKDTVNU.mjs";
+import "./token-goat-chunk-4GILLLWY.mjs";
+import "./token-goat-chunk-BFCWY73P.mjs";
+import "./token-goat-chunk-KGEFFSHD.mjs";
+import "./token-goat-chunk-XX6O25RN.mjs";
+import "./token-goat-chunk-HAVAOB3S.mjs";
+import "./token-goat-chunk-F6PAUIEK.mjs";
+import "./token-goat-chunk-65N4RHP4.mjs";
+import "./token-goat-chunk-X2SUP3EI.mjs";
+import {
+  redactSecrets
+} from "./token-goat-chunk-T5P5ACNQ.mjs";
+import {
+  loadConfig
+} from "./token-goat-chunk-7EZTZOMC.mjs";
+import {
+  getHarnessName
+} from "./token-goat-chunk-QYHO5CPH.mjs";
+import "./token-goat-chunk-4GBVPH3D.mjs";
+import "./token-goat-chunk-YZAAZU2S.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
+import "./token-goat-chunk-Y4AFKTHK.mjs";
+import {
+  atomicWriteText,
+  ensureDirSync,
+  isWithinQuietHours,
+  runGit,
+  withFileLock
+} from "./token-goat-chunk-HU4TORC5.mjs";
+import {
+  echoedCommand,
+  nameSubject
+} from "./token-goat-chunk-GGGG7RWB.mjs";
+import "./token-goat-chunk-AM5V6GSX.mjs";
+import "./token-goat-chunk-FNFBKLRD.mjs";
+import "./token-goat-chunk-CO3UYX6G.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/agent_receipt.ts
+init_define_import_meta_env();
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+// src/change_claim.ts
+init_define_import_meta_env();
+var CHANGE_VERBS = "fixed|implemented|added|created|wrote|written|refactored|updated|changed|edited|modified|deleted|removed|patched|resolved|replaced|improved|applied|renamed|rewrote|rewritten";
+var OPENER_VERBS = "fixed|implemented|added|created|wrote|refactored|updated|changed|edited|modified|deleted|removed|patched|replaced|renamed|rewrote";
+var NOT_AN_EDIT_OBJECT = "(?![ \\t]+(?:(?:the|a|an|my|our|this|these|some)[ \\t]+)?(?:summary|report|review|analysis|findings?|notes?|plan|mind|understanding|that|following[ \\t]+(?:findings?|notes?|observations?|points?|issues?[ \\t]+(?:I|we)[ \\t]+(?:found|noticed|saw)))\\b)";
+var FENCED_BLOCK_RE = /```[\s\S]*?(?:```|$)|~~~[\s\S]*?(?:~~~|$)/g;
+var QUOTED_LINE_RE = /^(?:[ \t]*>.*|(?: {4}|\t)(?![ \t]*(?:[-*•]|\d+[.)])[ \t]).*)$/gm;
+var DIFF_EVIDENCE_RE = /^[ \t]*(?:@@|diff --git)|^[ \t]*\+[ \t].*\n[ \t]*[+-][ \t]|^[ \t]*-[ \t].*\n[ \t]*\+[ \t]/m;
+var DIFF_LINE_RE = /^[ \t]*(?:[+-][ \t]|@@).*$/gm;
+var FIRST_PERSON_CLAIM_RE = new RegExp(
+  `(?<!\\b(?:if|whether|when|unless|should|would|could)[ \\t]+)\\b(?:I|we)(?:['\u2019]ve|[ \\t]+have)?[ \\t]+(?:(?:also|then|just|now|already|both)[ \\t]+)*(?:(?:${CHANGE_VERBS})\\b(?![ \\t]+up\\b)(?![ \\t]*(?::[ \\t]*)?(?:nothing|none|anything|no|not|neither)\\b)${NOT_AN_EDIT_OBJECT}|made[ \\t]+(?:(?:the|some|several|a[ \\t]+few|these|those|following|minor|small)[ \\t]+)*(?:changes?|edits?|modifications?|fixes|updates?)\\b)`,
+  "i"
+);
+var OPENER_CLAIM_RE = new RegExp(`^[ \\t]{0,3}(?:${OPENER_VERBS})${NOT_AN_EDIT_OBJECT}[ \\t]+(?:(?:the|a|an|this|these|my|our)[ \\t]|\`[^\`\\n]+\`|[\\w./-]+\\.[A-Za-z]{1,5}\\b)`, "im");
+var CHANGES_HEADER_RE = /(?:^|\n)[ \t]*(?:#{1,6}[ \t]*)?[*_]*(?:changes(?: made)?|what (?:I|we) (?:changed|did)|files (?:changed|modified|edited))[*_]*[ \t]*(?::[*_]*[ \t]*|(?=\n))([^\n]*(?:\n[ \t]*(?:[-*•]|\d+[.)])[ \t]+[^\n]*)*)/i;
+var NEGATED_LIST_RE = /^[([]?\s*(?:none|nothing|n\/a|na|no|not|zero|0|[-–—]+)\b|^[-–—]+\s*$/i;
+var NOT_A_REPORT_ITEM_RE = /^(?:recommend|suggest|propos|consider|could|should)|\b(?:only read|read[- ]only|no (?:changes|edits)|made no (?:changes|edits))\b/i;
+function claimsOwnChange(report) {
+  const text = report.replace(FENCED_BLOCK_RE, "").replace(QUOTED_LINE_RE, "").replace(/\n[ \t]*(?=\n)/g, "");
+  const header = CHANGES_HEADER_RE.exec(text);
+  if (header !== null) {
+    const listed = (header[1] ?? "").trim().replace(/^(?:[-*•]|\d+[.)])[ \t]*/, "");
+    const firstItem = listed.split("\n")[0] ?? "";
+    if (listed !== "" && !NEGATED_LIST_RE.test(listed) && !NOT_A_REPORT_ITEM_RE.test(firstItem)) return true;
+  }
+  const prose = DIFF_EVIDENCE_RE.test(text) ? text.replace(DIFF_LINE_RE, "") : text;
+  return FIRST_PERSON_CLAIM_RE.test(prose) || OPENER_CLAIM_RE.test(prose);
+}
+
+// src/agent_receipt.ts
+var RECEIPTS_SUFFIX = ".agent-receipts";
+var MAX_RECEIPTS = 16;
+var MAX_NAMED_FILES = 3;
+var GIT_STATUS_TIMEOUT_MS = 5e3;
+var LINE_PREFIX = "token-goat:";
+var RECEIPT_TTL_MS = 30 * 60 * 1e3;
+var RECEIPTS_LOCK_SUFFIX = ".agent-receipts.lock";
+var RECEIPT_LOCK_WAIT_MS = 2e3;
+function capReceipts(receipts) {
+  let excess = receipts.length - MAX_RECEIPTS;
+  if (excess <= 0) return receipts;
+  const dropped = /* @__PURE__ */ new Set();
+  for (const wantClean of [true, false]) {
+    for (const r of receipts) {
+      if (excess > 0 && r.text === "" === wantClean && !dropped.has(r)) {
+        dropped.add(r);
+        excess--;
+      }
+    }
+  }
+  return receipts.filter((r) => !dropped.has(r));
+}
+function reportHash(trimmedReport) {
+  return createHash("sha256").update(trimmedReport).digest("hex").slice(0, 16);
+}
+function receiptLines(state, claimsChangeWithoutEdit) {
+  const lines = [];
+  if (state.failingUnresolved && state.latestRun !== void 0) {
+    lines.push(`${LINE_PREFIX} this subagent's last check failed: ${echoedCommand(state.latestRun.command)} (exit ${state.latestRun.exitCode}).`);
+  }
+  if (state.editedSinceLastPass.length > 0) {
+    const named = state.editedSinceLastPass.slice(0, MAX_NAMED_FILES).map((name) => nameSubject("file", name)).join(", ");
+    const more = state.editedSinceLastPass.length - MAX_NAMED_FILES;
+    lines.push(`${LINE_PREFIX} this subagent edited after its last passing check: ${named}${more > 0 ? ` (+${more} more)` : ""}.`);
+  }
+  if (claimsChangeWithoutEdit) lines.push(`${LINE_PREFIX} the report claims a change, but this subagent recorded no edit and the working tree is clean.`);
+  return lines;
+}
+function claimsChangeTheTreeLacks(report, cwd) {
+  if (cwd === null || !claimsOwnChange(report) || claimsCommittedChange(report)) return false;
+  const result = runGit(["status", "--porcelain"], { cwd, timeoutMs: GIT_STATUS_TIMEOUT_MS });
+  return result.exitCode === 0 && result.stdout.trim() === "";
+}
+function receiptForStoppedAgent(event, redactedReport) {
+  const config = loadConfig().hints;
+  if (!config.agent_receipt || isWithinQuietHours(config.quiet_hours)) return null;
+  const state = evaluateVerification(sessionStateKey(event));
+  const claimsWithoutEdit = !state.editedAnyFile && claimsChangeTheTreeLacks(redactedReport, getCwd(event) || null);
+  const lines = receiptLines(state, claimsWithoutEdit);
+  return lines.length === 0 ? null : lines.join("\n");
+}
+function readReceipts(target) {
+  try {
+    const parsed = JSON.parse(readFileSync(target, "utf8"));
+    if (!Array.isArray(parsed)) return [];
+    const oldest = Date.now() - RECEIPT_TTL_MS;
+    return parsed.filter(
+      (r) => r !== null && typeof r === "object" && typeof r.hash === "string" && typeof r.length === "number" && typeof r.text === "string" && typeof r.at === "number" && r.at >= oldest
+    );
+  } catch {
+    return [];
+  }
+}
+function withReceipts(sessionId, create, work) {
+  const target = sessionSidecarPath(sessionId, RECEIPTS_SUFFIX);
+  const lockPath = sessionSidecarPath(sessionId, RECEIPTS_LOCK_SUFFIX);
+  if (target === null || lockPath === null) return null;
+  if (!create && (!existsSync(target) || readReceipts(target).length === 0)) return null;
+  try {
+    ensureDirSync(dirname(target));
+    const held = withFileLock(
+      lockPath,
+      () => {
+        const receipts = readReceipts(target);
+        const before = JSON.stringify(receipts);
+        const out = work(receipts);
+        const after = JSON.stringify(capReceipts(receipts));
+        if (after !== before) atomicWriteText(target, after);
+        return { out };
+      },
+      { waitMs: RECEIPT_LOCK_WAIT_MS }
+    );
+    return held === void 0 ? null : held.out;
+  } catch {
+    return null;
+  }
+}
+function parkAgentReceipt(sessionId, redactedReport, text, agentId) {
+  const trimmed = redactedReport.trim();
+  if (trimmed === "") return;
+  const entry = { hash: reportHash(trimmed), length: trimmed.length, text: redactSecrets(text).text, at: Date.now(), ...agentId ? { agentId } : {} };
+  withReceipts(sessionId, true, (receipts) => {
+    receipts.push(entry);
+  });
+}
+var AGENT_ID_TRAILER_RE = /\bagentId:\s*([A-Za-z0-9_-]{6,})/g;
+function trailerAgentId(resultText) {
+  const matches = [...resultText.slice(-600).matchAll(AGENT_ID_TRAILER_RE)];
+  return matches.at(-1)?.[1];
+}
+function takeAgentReceipt(sessionId, resultText, agentId) {
+  const trimmed = resultText.trim();
+  const wantedId = agentId ?? trailerAgentId(trimmed);
+  const endsReport = (r) => r.length === trimmed.length || trimmed[r.length] === "\n" || trimmed[r.length] === "\r";
+  const sameText = (r) => r.length <= trimmed.length && endsReport(r) && reportHash(trimmed.slice(0, r.length)) === r.hash;
+  return withReceipts(sessionId, false, (receipts) => {
+    const byId = wantedId === void 0 ? -1 : receipts.findIndex((r) => r.agentId === wantedId);
+    if (byId >= 0 && (agentId !== void 0 || sameText(receipts[byId]))) return receipts.splice(byId, 1)[0]?.text || null;
+    if (agentId !== void 0) return null;
+    const candidates = receipts.map((r, i) => ({ r, i })).filter(({ r }) => sameText(r) && (wantedId === void 0 || r.agentId === void 0));
+    if (candidates.length === 0 || candidates.some(({ r }) => r.text !== candidates[0].r.text)) return null;
+    return receipts.splice(candidates[0].i, 1)[0]?.text || null;
+  });
+}
+function subagentReceiptHandler(event) {
+  try {
+    const raw = event.raw["last_assistant_message"];
+    if (getHarnessName() === "copilot_cli" || !event.sessionId || typeof raw !== "string" || raw === "" || event.raw["stop_hook_active"] === true) return passOutput();
+    const report = redactSecrets(raw).text;
+    const text = receiptForStoppedAgent(event, report);
+    if (text !== null || loadConfig().hints.agent_receipt) parkAgentReceipt(event.sessionId, report, text ?? "", event.agentId);
+    return passOutput();
+  } catch {
+    return passOutput();
+  }
+}
+function subagentStopHandler(event) {
+  try {
+    const cwd = getCwd(event);
+    if (!event.sessionId || !cwd) return passOutput();
+    const message = typeof event.raw["last_assistant_message"] === "string" ? event.raw["last_assistant_message"] : "";
+    if (!claimsOwnChange(message) || claimsCommittedChange(message)) return passOutput();
+    const result = runGit(["status", "--porcelain"], { cwd, timeoutMs: loadConfig().hints.git_hint_max_ms });
+    if (result.exitCode === 0 && result.stdout.trim() === "") {
+      console.warn(`subagent-stop: possible hallucination \u2014 session=${event.sessionId} but git status is clean`);
+    }
+    return passOutput();
+  } catch {
+    return passOutput();
+  }
+}
+function completedSubagents(toolResponse) {
+  let parsed = toolResponse;
+  if (typeof toolResponse === "string") {
+    try {
+      parsed = JSON.parse(toolResponse);
+    } catch {
+      return [];
+    }
+  }
+  const status = parsed !== null && typeof parsed === "object" ? parsed["status"] : void 0;
+  if (status === null || typeof status !== "object") return [];
+  const out = [];
+  for (const [agentId, value] of Object.entries(status)) {
+    const report = value !== null && typeof value === "object" ? value["completed"] : void 0;
+    if (typeof report === "string" && report !== "") out.push({ agentId, report });
+  }
+  return out;
+}
+function waitAgentReceipts(sessionId, toolResponse) {
+  const finished = completedSubagents(toolResponse);
+  const blocks = [];
+  for (const { agentId, report } of finished) {
+    const text = takeAgentReceipt(sessionId, redactSecrets(report).text, agentId);
+    if (text !== null) blocks.push(finished.length > 1 ? `${LINE_PREFIX} agent ${echoedCommand(agentId)}:
+${text}` : text);
+  }
+  return blocks;
+}
+function waitAgentHandler(event) {
+  try {
+    if (!event.sessionId) return passOutput();
+    const blocks = waitAgentReceipts(event.sessionId, event.raw["tool_response"]);
+    if (blocks.length === 0) return passOutput();
+    recordStat("agent_receipt", 0, 0, void 0, "agent");
+    return contextOutput(blocks.join("\n"));
+  } catch {
+    return passOutput();
+  }
+}
+export {
+  claimsChangeTheTreeLacks,
+  parkAgentReceipt,
+  receiptForStoppedAgent,
+  receiptLines,
+  subagentReceiptHandler,
+  subagentStopHandler,
+  takeAgentReceipt,
+  waitAgentHandler,
+  waitAgentReceipts
+};

package/dist/{token-goat-chunk-H2PHHGM5.mjs → token-goat-chunk-CIMQ2BB3.mjs}

@@ -2,20 +2,20 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   registerHook
-} from "./token-goat-chunk-P4QMM4WK.mjs";
-import {
-  ensureWorkerAlive
-} from "./token-goat-chunk-5KDMCMF2.mjs";
+} from "./token-goat-chunk-C75NA7PL.mjs";
 import {
   passOutput
-} from "./token-goat-chunk-VPBBTSJR.mjs";
+} from "./token-goat-chunk-76FGDLRO.mjs";
+import {
+  ensureWorkerAlive
+} from "./token-goat-chunk-F6PAUIEK.mjs";
 import {
   isUnderSystemTemp
-} from "./token-goat-chunk-7IN2MKDS.mjs";
+} from "./token-goat-chunk-4GBVPH3D.mjs";
 import {
   atomicWriteBytes,
   ensureDirSync
-} from "./token-goat-chunk-GOLEOXZP.mjs";
+} from "./token-goat-chunk-HU4TORC5.mjs";
 import {
   foldPath
 } from "./token-goat-chunk-AM5V6GSX.mjs";
@@ -25,7 +25,7 @@ import {
 } from "./token-goat-chunk-FNFBKLRD.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";
@@ -113,19 +113,47 @@ function appendDirtyQueueFile(filePath, absPaths) {
 }
 function appendDirtyQueuePaths(dir, absPaths) {
   if (absPaths.length === 0) return true;
-  const queuePath = dirtyQueuePathFor(dir);
+  return appendToClaimableFile(dirtyQueuePathFor(dir), renderDirtyQueueLines(absPaths));
+}
+function appendToClaimableFile(queuePath, body) {
   const queueDir = path.dirname(queuePath);
   try {
     ensureDirSync(queueDir);
   } catch (e) {
     if (e.code !== "EEXIST" || !fs.existsSync(queueDir)) throw e;
   }
-  const body = renderDirtyQueueLines(absPaths);
   for (let attempt = 0; attempt < 3; attempt++) {
     if (appendToLiveQueue(queuePath, `${dirtyQueueLeadingNewline(queuePath)}${body}`)) return true;
   }
   return false;
 }
+function reconcileRequestPathFor(dir) {
+  return path.join(dir, "queue", "reconcile.txt");
+}
+function appendReconcileRequest(dir, projectDir) {
+  return appendToClaimableFile(reconcileRequestPathFor(dir), `${JSON.stringify(projectDir)}
+`);
+}
+function parseReconcileRequests(raw) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "") continue;
+    let dir;
+    try {
+      dir = JSON.parse(trimmed);
+    } catch {
+      continue;
+    }
+    if (typeof dir !== "string" || dir === "") continue;
+    const key = foldPath(normalizePath(dir));
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(dir);
+  }
+  return out;
+}
 
 // src/hooks_index.ts
 init_define_import_meta_env();
@@ -148,7 +176,8 @@ function enqueueDirtyPathsSafe(filePaths, opts) {
       resolved.push(r);
     }
     if (resolved.length === 0) return 0;
-    appendDirtyPaths(resolved);
+    if (opts?.dir !== void 0) appendDirtyQueuePaths(opts.dir, resolved);
+    else appendDirtyPaths(resolved);
   } catch {
     return 0;
   }
@@ -158,6 +187,18 @@ function enqueueDirtyPathsSafe(filePaths, opts) {
   }
   return resolved.length;
 }
+function requestReconcileSafe(projectDir) {
+  try {
+    if (!appendReconcileRequest(dataDir(), projectDir)) return false;
+  } catch {
+    return false;
+  }
+  try {
+    ensureWorkerAlive();
+  } catch {
+  }
+  return true;
+}
 function getDirtyPaths() {
   return getDirtyPathsFor(dataDir());
 }
@@ -182,7 +223,11 @@ export {
   getDirtyPathsFor,
   appendDirtyQueueFile,
   appendDirtyQueuePaths,
+  reconcileRequestPathFor,
+  appendReconcileRequest,
+  parseReconcileRequests,
   appendDirtyPath,
   enqueueDirtyPathSafe,
-  enqueueDirtyPathsSafe
+  enqueueDirtyPathsSafe,
+  requestReconcileSafe
 };

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

@@ -5,8 +5,11 @@ import {
 } from "./token-goat-chunk-3BTK54F3.mjs";
 import {
   compileGuardedRegexCached,
-  filtersFilteredToEmptyNotice
-} from "./token-goat-chunk-GOLEOXZP.mjs";
+  countNoun
+} from "./token-goat-chunk-HU4TORC5.mjs";
+import {
+  echoedValue
+} from "./token-goat-chunk-GGGG7RWB.mjs";
 import {
   displaySafeText
 } from "./token-goat-chunk-FNFBKLRD.mjs";
@@ -16,6 +19,39 @@ import {
 
 // src/csv_query.ts
 init_define_import_meta_env();
+
+// src/query_notices.ts
+init_define_import_meta_env();
+function headElidedNotice(hidden, noun) {
+  return `...(${countNoun(hidden, `more ${noun}`)} elided; use --head to see more)`;
+}
+function traversalLimitNotice(matched) {
+  if (matched === 0) return "...(no matches: the search stopped at this tool's traversal limit before finding any, so the part of the document it did not reach may still hold some. Narrow the path to search less of the document.)";
+  return "...(the search stopped early at this tool's traversal limit; these are not necessarily all the matches. Narrow the path to search less of the document.)";
+}
+
+// src/filter_notice.ts
+init_define_import_meta_env();
+function allOfCount(count, singular, plural = `${singular}s`) {
+  return count === 1 ? `the only ${singular}` : `all ${count} ${plural}`;
+}
+function filteredSubject(count, singular, plural) {
+  const one = count === 1;
+  return { subject: `${allOfCount(count, singular, plural)} ${one ? "was" : "were"}`, pronoun: one ? "it" : "them" };
+}
+function grepFilteredToEmptyNotice(preFilterCount, grep, nounSingular, nounPlural) {
+  const { subject, pronoun } = filteredSubject(preFilterCount, nounSingular, nounPlural);
+  return `  (${subject} filtered out by --grep ${displaySafeText(grep)} -- widen or drop the filter to see ${pronoun})`;
+}
+function filtersFilteredToEmptyNotice(preFilterCount, activeFilters, nounSingular, nounPlural, reassurance) {
+  const { subject, pronoun } = filteredSubject(preFilterCount, nounSingular, nounPlural);
+  const cause = activeFilters.length === 0 ? "the active filter" : activeFilters.map(displaySafeText).join(" + ");
+  const knob = activeFilters.length > 1 ? "filters" : "filter";
+  const tail = reassurance === void 0 ? "" : `; ${reassurance}`;
+  return `  (${subject} filtered out by ${cause}${tail} -- widen or drop the ${knob} to see ${pronoun})`;
+}
+
+// src/csv_query.ts
 var DELIMITER_CANDIDATES = [",", "	", ";", "|"];
 var DELIMITER_SAMPLE_ROWS = 5;
 function detectDelimiter(content) {
@@ -80,7 +116,7 @@ function parseWhereSpecs(specs) {
     const op = m[2];
     const value = m[3];
     if ((op === ">" || op === "<" || op === ">=" || op === "<=") && value.trim() === "") {
-      throw new Error(`invalid --where spec: ${spec} (missing comparison value after '${op}')`);
+      throw new Error(`invalid --where spec: ${spec} (missing comparison value after ${echoedValue(op)})`);
     }
     if (op === "~=") {
       const guarded = compileGuardedRegexCached(value);
@@ -174,7 +210,7 @@ function formatCsvTable(result, activeFilters = []) {
     ...result.rows.map((r) => r.map(quoteCsvCell).join(","))
   ];
   if (result.totalRows > result.rows.length) {
-    lines.push(`...(${result.totalRows - result.rows.length} more rows elided; use --head to see more)`);
+    lines.push(headElidedNotice(result.totalRows - result.rows.length, "row"));
   }
   if (result.totalRows === 0 && result.preFilterRows > 0) {
     lines.push(filtersFilteredToEmptyNotice(result.preFilterRows, activeFilters, "data row", "data rows"));
@@ -229,6 +265,12 @@ function formatCsvProfile(profiles) {
 }
 
 export {
+  headElidedNotice,
+  traversalLimitNotice,
+  allOfCount,
+  filteredSubject,
+  grepFilteredToEmptyNotice,
+  filtersFilteredToEmptyNotice,
   parseWhereSpecs,
   queryCsv,
   quoteCsvCell,

package/dist/{token-goat-chunk-VES7EL7O.mjs → token-goat-chunk-CO3UYX6G.mjs}

@@ -8,7 +8,7 @@ import {
 init_define_import_meta_env();
 import { createRequire } from "node:module";
 function readManifest() {
-  if (true) return JSON.parse('{"version":"2.9.30","name":"token-goat","bugs":{"url":"https://github.com/DFKHelper/token-goat/issues"}}');
+  if (true) return JSON.parse('{"version":"2.9.31","name":"token-goat","bugs":{"url":"https://github.com/DFKHelper/token-goat/issues"}}');
   try {
     return createRequire(import.meta.url)("../package.json");
   } catch {

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

@@ -0,0 +1,154 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  FIND_SCAN_LIMIT,
+  findParentName,
+  findSymbolCandidates
+} from "./token-goat-chunk-4SC7UJYV.mjs";
+import {
+  indexedSourceText
+} from "./token-goat-chunk-QH7YVYOY.mjs";
+import {
+  querySymbols
+} from "./token-goat-chunk-IK2DRMFX.mjs";
+import {
+  getDb,
+  pathEqClause
+} from "./token-goat-chunk-GVB2MUST.mjs";
+import {
+  fingerprintContent
+} from "./token-goat-chunk-4GBVPH3D.mjs";
+import {
+  foldPath
+} from "./token-goat-chunk-AM5V6GSX.mjs";
+import {
+  globalDbPath
+} from "./token-goat-chunk-CO3UYX6G.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/notes.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+var WHOLE_FILE_NOTE_SYMBOL = "";
+function toNoteRow(row) {
+  return {
+    id: row.id,
+    filePath: row.file_path,
+    symbol: row.symbol,
+    content: row.content,
+    fingerprint: row.fingerprint,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function declarationGroups(rows, dbPath) {
+  const fileSymbols = /* @__PURE__ */ new Map();
+  const groups = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    let siblings = fileSymbols.get(row.filePath);
+    if (siblings === void 0) {
+      siblings = querySymbols({ filePath: row.filePath, limit: FIND_SCAN_LIMIT }, dbPath);
+      fileSymbols.set(row.filePath, siblings);
+    }
+    const parent = findParentName(row, siblings);
+    const key = JSON.stringify([row.filePath, parent]);
+    const group = groups.get(key);
+    if (group === void 0) groups.set(key, { parent, rows: [row] });
+    else group.rows.push(row);
+  }
+  return [...groups.values()];
+}
+function groupEntry(group) {
+  const rows = [...group].sort((x, y) => x.lineStart - y.lineStart);
+  const first = rows[0];
+  if (rows.length === 1 && first.body !== "") return first;
+  const body = rows.map((r) => r.body !== "" ? r.body : bodyFromSource(r)).join("\n");
+  return { ...first, lineEnd: Math.max(...rows.map((r) => r.lineEnd)), body };
+}
+function resolveSymbolMatch(filePath, symbolName, dbPath = globalDbPath()) {
+  const { candidates, displaySymbol } = findSymbolCandidates(filePath, filePath, symbolName, void 0, dbPath);
+  const seen = /* @__PURE__ */ new Set();
+  const distinct = candidates.filter((c) => {
+    const key = `${c.filePath}|${c.lineStart}|${c.lineEnd}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+  if (distinct.length === 0) return { kind: "none" };
+  if (distinct.length === 1) return { kind: "ok", entry: groupEntry(distinct) };
+  const groups = declarationGroups(distinct, dbPath);
+  if (groups.length === 1) return { kind: "ok", entry: groupEntry(groups[0].rows) };
+  const fileLevel = groups.find((g) => g.parent === null);
+  if (fileLevel !== void 0 && !symbolName.includes(".")) return { kind: "ok", entry: groupEntry(fileLevel.rows) };
+  const declarations = groups.map((g) => ({ entry: groupEntry(g.rows), qualifiedName: g.parent === null ? displaySymbol : `${g.parent}.${displaySymbol}` })).sort((x, y) => x.entry.lineStart - y.entry.lineStart);
+  return { kind: "ambiguous", symbol: displaySymbol, candidates: declarations };
+}
+function bodyFromSource(entry) {
+  try {
+    return indexedSourceText(entry.filePath, fs.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: -1 }, dbPath);
+  return [...new Set(symbols.map((s) => s.name))].sort();
+}
+function computeFileFingerprint(filePath, dbPath = globalDbPath()) {
+  const symbols = querySymbols({ filePath, limit: -1 }, dbPath);
+  const manifest = symbols.map((s) => `${s.name}:${s.kind}:${s.lineStart}-${s.lineEnd}`).sort().join("\n");
+  return fingerprintContent(manifest);
+}
+function computeSymbolFingerprints(filePath, symbolName, dbPath = globalDbPath()) {
+  const match = resolveSymbolMatch(filePath, symbolName, dbPath);
+  if (match.kind === "none") return [];
+  return (match.kind === "ok" ? [match.entry] : match.candidates.map((c) => c.entry)).map((e) => fingerprintContent(e.body));
+}
+function upsertNote(filePath, symbol, content, fingerprint, dbPath = globalDbPath()) {
+  const db = getDb(dbPath);
+  const now = Date.now() / 1e3;
+  db.transaction(() => {
+    const updated = db.prepare(`UPDATE notes SET content = ?, fingerprint = ?, updated_at = ? WHERE ${pathEqClause("file_path")} AND symbol = ?`).run(content, fingerprint, now, foldPath(filePath), symbol);
+    if (updated.changes > 0) return;
+    db.prepare("INSERT INTO notes (file_path, symbol, content, fingerprint, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(
+      filePath,
+      symbol,
+      content,
+      fingerprint,
+      now,
+      now
+    );
+  }).immediate();
+}
+function getNote(filePath, symbol, dbPath = globalDbPath()) {
+  const db = getDb(dbPath);
+  const row = db.prepare(
+    `SELECT id, file_path, symbol, content, fingerprint, created_at, updated_at FROM notes WHERE ${pathEqClause("file_path")} AND symbol = ?`
+  ).get(foldPath(filePath), symbol);
+  return row === void 0 ? null : toNoteRow(row);
+}
+function listNotes(dbPath = globalDbPath()) {
+  const db = getDb(dbPath);
+  const rows = db.prepare(
+    "SELECT id, file_path, symbol, content, fingerprint, created_at, updated_at FROM notes ORDER BY file_path, symbol"
+  ).all();
+  return rows.map(toNoteRow);
+}
+function isNoteStale(note, dbPath = globalDbPath()) {
+  if (note.symbol !== WHOLE_FILE_NOTE_SYMBOL) return !computeSymbolFingerprints(note.filePath, note.symbol, dbPath).includes(note.fingerprint);
+  return computeFileFingerprint(note.filePath, dbPath) !== note.fingerprint;
+}
+
+export {
+  WHOLE_FILE_NOTE_SYMBOL,
+  resolveSymbolMatch,
+  symbolNamesInFile,
+  computeFileFingerprint,
+  computeSymbolFingerprints,
+  upsertNote,
+  getNote,
+  listNotes,
+  isNoteStale
+};