tldr-experts 0.14.1 → 0.14.2

package/CHANGELOG.md

@@ -1,6 +1,29 @@
 # Changelog
 
 
+## 0.14.2 — 2026-09-09
+
+### Fixed
+
+- **A stage's `claim-sources` check reads the disk it is judging, not a snapshot taken stages
+  ago (#206).** `src/core/text/srcToken.ts` memoises the question and fact indexes at MODULE
+  scope, keyed by run dir and workspace root, and nothing outside `test/` ever dropped them —
+  `clearSrcCaches()` had 20 call sites, all in tests. `tldrx run auto` is one Node process for a
+  whole run (`runAuto.ts`, no re-exec per stage), so the FIRST citation resolved anywhere in the
+  run froze both indexes at whatever was on disk at that instant, and every later stage's check
+  judged its own outputs against that frozen view. Measured live on three real workspaces at
+  0.14.1: a `how` stage refused with `no such question Q2 … declared: Q1` over Q2–Q4 it had
+  itself written into `02-how/questions.md` minutes earlier, and another refused with
+  `it has 145 live fact(s)` over a `facts.yml` that held 148 — the three extra facts written by
+  the owner's own answers two seconds BEFORE the stage started. Roughly $11 of paid turns thrown
+  away for ids that were real the whole time. The indexes are now refreshed inside
+  `toSrcContext` — the one place a citation context is built, and a place every caller reaches
+  exactly once per check, gate or hook invocation — so the memoisation that pays for itself (one
+  document's forty citations read `facts.yml` once) is kept and the memory that outlives the
+  check is not. The git blob memo is deliberately left per-process: its cap bounds forks, not
+  staleness. Resolution rules are unchanged; what changed is when the checker last looked.
+
+
 ## 0.14.1 — 2026-09-09
 
 ### Fixed

package/README.md

@@ -316,6 +316,7 @@ back on the registry is 0.3.0.
 
 | Version | Date | Status | Contains |
 |---|---|---|---|
+| 0.14.2 | 2026-09-09 | `beta` | every citation check starts from a fresh view of `questions.md` and `facts.yml`: `srcToken.ts` memoised both indexes at module scope and nothing outside `test/` ever dropped them, so in `tldrx run auto` — one Node process for a whole run — the FIRST citation resolved anywhere froze the view every later stage was then judged against; measured on three real unattended workspaces at 0.14.1, a `how` stage refused with `no such question Q2 … declared: Q1` over questions it had itself written minutes earlier, and another refused over `145 live fact(s)` when `facts.yml` held 148, the three extra written by the owner's answers two seconds before the stage started — roughly $11 of paid turns thrown away for ids that were real the whole time; the indexes are now refreshed inside `toSrcContext`, the one place a citation context is built and a place every caller reaches exactly once per check, gate or hook, so a document's forty citations still read `facts.yml` once while nothing survives the check that read it |
 | 0.14.1 | 2026-09-09 | `beta` | an auto gate that says what holds it and closes itself, and three derivations cut to one: measured on a real workspace at 0.14.0, the first `run auto --wait-answers 4h --wait-gates 4h` with a notify hook finished its What stage for $1.98 with every declared check green and told the owner *"waiting at a auto gate that did not close by itself — a person signs it"* — no reason, because `evaluateAutoGate` had computed exactly that sentence into a stdout line nobody was watching while `gate.requested` was appended a hundred lines BEFORE the verdict existed; the verdict is now taken one statement earlier and `why`/`held_by` ride the event to the phone (present only for an `auto` policy, since `held_by: []` on a `human` gate would read as "checked, and nothing held it"), the questions that hold a gate are notified BEFORE the gate downstream of them so the owner stops being told to sign a thing before being told what it is, and an `auto` gate whose only blocker was an open question stops permanently degrading into a `human` one — each poll re-runs the seven conditions off disk and signs through the same `approve` door `next` uses, never for `human` and never for `agent`, a person's `approve` or `reject` still landing first; a question can carry its own `Recommended: <letter> — <why> [src: …]`, parsed tolerantly so an older note reads as not recorded rather than refusing; `tldrx facts add --repo <name>` is now checked against `workspace.yml` through the ONE leaf `answer --repo` already refused on, because the unvalidated flag wrote `repos: [ghost]` at exit 0 and every prompt or filter keyed on a real repo name was then silently blind to that fact; the five phase ids are written out in one file instead of three — `PHASE_IDS`, `QUESTION_PHASES`, and an inline literal walked by `questions lint` that `QUESTION_PHASES`' own doc comment claimed could not exist — pinned from both ends, because an identical second copy and a copy that has already drifted redden different guards and neither alone is enough; a training test stops running on bun's fixed 5000 ms after a spawn probe, validated first against a file the heuristic already claimed (87 spawns recorded, so the instrument can see the thing), found it spawning three real children unclaimed by any marker, with the 14 further unclaimed files filed rather than fixed; and `release-check.sh` refuses a rewritten released section — every dated heading whose tag is present must equal `git show vX.Y.Z:CHANGELOG.md` byte for byte, three sections having drifted with nothing checking, and an amendment recorded in `CHANGELOG.amendments` must still contain the tag's section as an ordered subsequence and may only add lines that exist verbatim in its source sha, after a reviewer proved the first version of that check happily passed an invented bullet |
 | 0.14.0 | 2026-09-09 | `beta` | an `agent` gate the engine can actually close, and three computations of the same answer cut to one: `gates_policy: agent` named who MAY sign a gate but nothing in the engine produced the evidence note it is signed over — measured on 0.13.1, an owner ran `tldrx run gates set what:agent`, was told "an agent may now close it", and the loop stopped at the next gate anyway with exit 4 — so `run auto` now spawns one bounded **gate signer** when a stage's checks pass under an `agent` policy: the stage's own model and effort, a quarter of its per-agent ceiling, a tool allowance that reads anything and writes exactly one file, and a prompt carrying the stage's declared outputs, the seven `auto` conditions as measured and the §2.8 skeleton `gate template` itself renders — the note going through the UNCHANGED `approve --as-agent` path, so a refusal, a note that does not validate, a signer that wrote nothing and a signer that died are one outcome, pending for a person with the reason named on stdout and now in the `gate.requested` summary, and there is no flag to turn it on because an `agent` policy is already the owner's recorded decision; the turn is recorded like any other (`role: gate-signer`, a `run.yml` task row, a row in `tldrx cost`) and taken BEFORE the stage moves to `awaiting_gate`, because the other order had a person sign the gate the engine was mid-signing, three runs out of three; and the suite stops being run three times per change — the pre-merge reviewer now runs only the test files that cover its diff plus `typecheck`, never the full `bun test`, since the wave re-runs every gate on the MERGED tree anyway, `publish.yml` refuses unless `ci` has a `success` run for the same sha instead of recomputing typecheck/tests/build (~87 min/week of runner time, with a `cancelled` ci run failing by name and the remedy), `ci` cancels a run a newer push has already superseded (25 of 122 push runs began under 10 minutes apart), the docs deploy finally fires on `src/cli/helpText.ts` so a help-registry change stops deploying nothing while the published CLI reference goes stale, and `AGENTS.md` §2 now says out loud that a slash in a branch name is a directory, which is what the review-record gate builds |
 | 0.13.1 | 2026-09-08 | `beta` | a stage prompt that opens by saying what to do: every stage prompt now leads with a generated brief — who the reader is, which stage of which run, that the template below is to be FILLED, the exact path of every declared output, and that a question goes in the questions file rather than back to an operator who is not there — because on a real workspace at 0.13.0 a What sub-agent read its 66,452-byte prompt, found no request in it, wrote none of its six declared outputs and asked what to do, $0.29 spent; the brief is generated from the same `outputs:` list `pending.json` records, so it cannot name a path the commit will not look for, and the failure was never a regression — the spliced citation grammar grew the stage section 5,007 B → 13,180 B and the missing instruction was finally outnumbered; and the `N runs are open` nudge, the one imperative-shaped sentence in that agent's window and the one it duly answered, stops reaching sub-agents at all — `spawnAgent` marks every child it spawns and `session-start` emits nothing when it sees the marker, an absent marker still being a human's session and behaving exactly as before |

package/dist/hooks/answer-capture.js

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import {
   conflictOf
-} from "./chunk-djsf80bc.js";
+} from "./chunk-w8qm1jbn.js";
 import {
   FactsStore,
   formatJaccard
-} from "./chunk-yn87xw4f.js";
+} from "./chunk-mzwqb08p.js";
 import {
   parseHookInput,
   readStdin
-} from "./chunk-cyzm0n45.js";
+} from "./chunk-tpz0zb0t.js";
 import {
   PHASE_IDS
 } from "./chunk-dzkg8c68.js";
 import {
   EventLog,
   PHASE_ID_RE
-} from "./chunk-ek3tsewd.js";
-import"./chunk-693npq3d.js";
+} from "./chunk-dnat9z30.js";
+import"./chunk-db7wf3hy.js";
 import {
   ADVISORY_KEY,
   MAX_FACT_CHARS,
@@ -27,7 +27,7 @@ import {
   renderQuestionBlock,
   replaceBlock,
   serializeQuestions
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   ITERATION_ONLY_SLOT,
   PROJECT_FRAMEWORK_DIR,
@@ -35,7 +35,7 @@ import {
   commandProbeIssues,
   factsPath,
   parseYaml
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/answer-capture.ts
 import { existsSync as existsSync5 } from "fs";

package/dist/hooks/budget-gate.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   budgetGateDeny
-} from "./chunk-vnnmbjkz.js";
+} from "./chunk-dxk7eaqn.js";
 import {
   allow,
   deny,
   readPayload,
   runHook,
   toolInput
-} from "./chunk-5m3f8wme.js";
-import"./chunk-cyzm0n45.js";
+} from "./chunk-gvz0rzb9.js";
+import"./chunk-tpz0zb0t.js";
 import {
   asRunBudget,
   currentActor,
@@ -29,20 +29,20 @@ import {
   validateRunBudget,
   wouldExceed,
   wouldExceedHostTokens
-} from "./chunk-g73p9wgp.js";
+} from "./chunk-fefnr71h.js";
 import {
   EventLog
-} from "./chunk-ek3tsewd.js";
+} from "./chunk-dnat9z30.js";
 import {
   noteDeprecations
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   PROJECT_WORK_DIR,
   findWorkspaceRoot,
   locateWork,
   parseYaml,
   stageYamlPath
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/budget-gate.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "node:fs";

package/dist/hooks/{chunk-9zee1zpr.js → chunk-97zs34wb.js}

@@ -10,7 +10,7 @@ import {
   spentBasis,
   tallyOf,
   validateRunBudget
-} from "./chunk-g73p9wgp.js";
+} from "./chunk-fefnr71h.js";
 import {
   EventLog,
   asRunFile,
@@ -22,7 +22,7 @@ import {
   isTerminal,
   stageAt,
   validateRunFile
-} from "./chunk-ek3tsewd.js";
+} from "./chunk-dnat9z30.js";
 import {
   backupPathFor,
   isAlive,
@@ -31,19 +31,19 @@ import {
   workspaceRootOfRunDir,
   writeAtomic,
   yamlScalar
-} from "./chunk-693npq3d.js";
+} from "./chunk-db7wf3hy.js";
 import {
   isAdvisory,
   noteDeprecations,
   openBlocks,
   parseQuestions
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   FRAMEWORK_ROOT,
   listRunDirs,
   parseYaml,
   parseYamlRepairing
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";

package/dist/hooks/{chunk-381n8p4g.js → chunk-bqmstq21.js}

@@ -3,7 +3,7 @@ import {
   parseSrcToken,
   srcToken,
   withoutSrcToken
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/text/questions.ts
 var REQUIRED_METADATA_KEYS = ["id", "status", "area", "asked_by", "asked_at"];

package/dist/hooks/{chunk-693npq3d.js → chunk-db7wf3hy.js}

@@ -1,7 +1,7 @@
 import {
   PROJECT_FRAMEWORK_DIR,
   PROJECT_WORK_DIR
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/lock/workspaceLock.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, openSync, readFileSync as readFileSync2, rmSync as rmSync2, writeSync, closeSync } from "node:fs";

package/dist/hooks/{chunk-ek3tsewd.js → chunk-dnat9z30.js}

@@ -10,7 +10,7 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/events/EventLog.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";

package/dist/hooks/{chunk-vnnmbjkz.js → chunk-dxk7eaqn.js}

@@ -3,7 +3,7 @@ import {
   EMPTY_SECTION_RULE,
   noneBullet,
   srcRule
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/lib/messages.ts
 var GRAMMAR = "[src: <repo:path:line> | https://… | Q<n> | F<n> | $ <cmd> → exit <n> | graph:<node> | absent:<path>]";

package/dist/hooks/{chunk-g73p9wgp.js → chunk-fefnr71h.js}

@@ -23,7 +23,7 @@ import {
   requireVersion,
   requireVersion1,
   result
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/lib/runFile.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-5m3f8wme.js → chunk-gvz0rzb9.js}

@@ -1,7 +1,7 @@
 import {
   parseHookInput,
   readStdin
-} from "./chunk-cyzm0n45.js";
+} from "./chunk-tpz0zb0t.js";
 
 // src/hooks/lib/decide.ts
 function deny(reason) {

package/dist/hooks/{chunk-yn87xw4f.js → chunk-mzwqb08p.js}

@@ -3,7 +3,7 @@ import {
   withWorkspaceLock,
   workspaceRootOfFactsPath,
   writeAtomic
-} from "./chunk-693npq3d.js";
+} from "./chunk-db7wf3hy.js";
 import {
   FACT_CONFIDENCES,
   FACT_KINDS,
@@ -14,7 +14,7 @@ import {
   isLive,
   isRetired,
   noteDeprecations
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   SRC_PATTERNS,
   asDocument,
@@ -27,7 +27,7 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/facts/FactsStore.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-a0y3ze46.js → chunk-r95h9ynf.js}

@@ -1,6 +1,6 @@
 import {
   toolInput
-} from "./chunk-5m3f8wme.js";
+} from "./chunk-gvz0rzb9.js";
 
 // src/hooks/lib/wouldBe.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-cyzm0n45.js → chunk-tpz0zb0t.js}

@@ -1,6 +1,6 @@
 import {
   runtime
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/hooks/passthrough.ts
 async function readStdin() {

package/dist/hooks/{chunk-djsf80bc.js → chunk-w8qm1jbn.js}

@@ -1,15 +1,15 @@
 import {
   findDuplicate
-} from "./chunk-yn87xw4f.js";
+} from "./chunk-mzwqb08p.js";
 import {
   evidencePath,
   gateEvidencePath,
   parseEvidence
-} from "./chunk-ek3tsewd.js";
+} from "./chunk-dnat9z30.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 
 // src/core/distill/distill.ts
 var CONFLICT_THRESHOLD = 0.6;

package/dist/hooks/{chunk-xe36zh9a.js → chunk-wwwmkey4.js}

@@ -7756,268 +7756,13 @@ function lastMeaningfulLine(output, max = 200) {
 }
 
 // src/hooks/lib/workspace.ts
-import { existsSync as existsSync2, readdirSync, readFileSync, statSync as statSync2 } from "node:fs";
-import { basename, dirname as dirname3, isAbsolute, join as join2, resolve, sep } from "node:path";
-
-// src/core/detect/probeCommands.ts
-var PROBE_STATUSES = ["ok", "failed", "timed-out", "unspawnable", "not-probed", "skipped"];
-
-// src/core/schemas/workspace.ts
-function commandProbeIssues(probe, path) {
-  if (!isRecord(probe))
-    return [{ path, message: "expected a mapping" }];
-  const issues = [];
-  if (!PROBE_STATUSES.includes(probe.status)) {
-    issues.push({ path: `${path}.status`, message: `expected one of ${PROBE_STATUSES.join(" | ")}` });
-  }
-  if (typeof probe.verified !== "boolean") {
-    issues.push({ path: `${path}.verified`, message: "expected a boolean" });
-  }
-  if (probe.exit_code !== null && typeof probe.exit_code !== "number") {
-    issues.push({ path: `${path}.exit_code`, message: "expected a number or null" });
-  }
-  if (typeof probe.at !== "string" || probe.at === "") {
-    issues.push({ path: `${path}.at`, message: "expected a non-empty RFC3339 string" });
-  }
-  if (typeof probe.reason !== "string" || probe.reason === "") {
-    issues.push({ path: `${path}.reason`, message: "expected a non-empty sentence saying why" });
-  }
-  return issues;
-}
-
-// src/hooks/lib/workspace.ts
-var RUN_YML = "run.yml";
-function locateWork(filePath) {
-  if (filePath === "")
-    return null;
-  const abs = isAbsolute(filePath) ? filePath : resolve(filePath);
-  const parts = abs.split(sep);
-  const at = parts.lastIndexOf(PROJECT_WORK_DIR);
-  if (at === -1 || at + 1 >= parts.length)
-    return null;
-  const run = parts[at + 1] ?? "";
-  if (run === "")
-    return null;
-  return {
-    root: parts.slice(0, at).join(sep) || sep,
-    runDir: parts.slice(0, at + 2).join(sep),
-    run,
-    relative: parts.slice(at + 2).join("/")
-  };
-}
-function findWorkspaceRoot(start) {
-  let current = isAbsolute(start) ? start : resolve(start);
-  for (let i = 0;i < 64; i++) {
-    if (existsSync2(join2(current, PROJECT_FRAMEWORK_DIR)))
-      return current;
-    const parent = dirname3(current);
-    if (parent === current)
-      return null;
-    current = parent;
-  }
-  return null;
-}
-var FALLBACK_DEFAULT_BRANCH = "main";
-function commandRolesOf(doc) {
-  const out = new Map;
-  const list = doc?.repos;
-  if (!Array.isArray(list))
-    return out;
-  for (const entry of list) {
-    if (typeof entry?.name !== "string")
-      continue;
-    const roles = new Map;
-    const cmds = entry.commands;
-    if (cmds !== null && typeof cmds === "object") {
-      for (const [role, value] of Object.entries(cmds)) {
-        if (typeof value !== "string" || value.trim() === "")
-          continue;
-        roles.set(role, value);
-      }
-    }
-    out.set(entry.name, roles);
-  }
-  return out;
-}
-function commandProbesOf(doc) {
-  const out = new Map;
-  const list = doc?.repos;
-  if (!Array.isArray(list))
-    return out;
-  for (const entry of list) {
-    if (typeof entry?.name !== "string")
-      continue;
-    const probes = new Map;
-    const raw = entry.command_probes;
-    if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
-      for (const [slot, value] of Object.entries(raw)) {
-        if (commandProbeIssues(value, slot).length > 0)
-          continue;
-        probes.set(slot, value);
-      }
-    }
-    out.set(entry.name, probes);
-  }
-  return out;
-}
-function loadWorkspace(root) {
-  const repos = new Map;
-  const commands = new Set;
-  const repoCommands = new Map;
-  const commandRoles = new Map;
-  const commandProbes = new Map;
-  const iterationCommands = new Set;
-  const defaultBranches = new Map;
-  let seedTriageThresholdTokens = null;
-  const empty = () => ({
-    root,
-    repos,
-    commands,
-    repoCommands,
-    commandRoles,
-    commandProbes,
-    iterationCommands,
-    defaultBranches,
-    seedTriageThresholdTokens
-  });
-  const path = join2(root, PROJECT_FRAMEWORK_DIR, "workspace.yml");
-  if (!existsSync2(path))
-    return empty();
-  let doc;
-  try {
-    doc = parseYaml(readFileSync(path, "utf8"));
-  } catch {
-    return empty();
-  }
-  const triage = doc?.seed_triage;
-  if (triage !== null && typeof triage === "object") {
-    const tokens = triage.threshold_tokens;
-    if (typeof tokens === "number" && Number.isFinite(tokens) && tokens > 0) {
-      seedTriageThresholdTokens = tokens;
-    }
-  }
-  const list = doc?.repos;
-  if (!Array.isArray(list))
-    return empty();
-  const declared = commandRolesOf(doc);
-  const measured = commandProbesOf(doc);
-  for (const entry of list) {
-    if (typeof entry?.name !== "string")
-      continue;
-    repos.set(entry.name, typeof entry.path === "string" ? entry.path : ".");
-    defaultBranches.set(entry.name, typeof entry.default_branch === "string" && entry.default_branch !== "" ? entry.default_branch : FALLBACK_DEFAULT_BRANCH);
-    const own = [];
-    const roles = declared.get(entry.name) ?? new Map;
-    for (const value of roles.values()) {
-      commands.add(value);
-      if (!own.includes(value))
-        own.push(value);
-    }
-    repoCommands.set(entry.name, own);
-    commandRoles.set(entry.name, roles);
-    const fast = roles.get(ITERATION_ONLY_SLOT);
-    if (fast !== undefined)
-      iterationCommands.add(fast);
-    commandProbes.set(entry.name, measured.get(entry.name) ?? new Map);
-  }
-  return empty();
-}
-function toSrcContext(workspace, runDir, options = {}) {
-  return {
-    root: workspace.root,
-    repos: workspace.repos,
-    commands: workspace.commands,
-    runDir: runDir ?? null,
-    epicWorktrees: epicWorktreesOf(workspace, runDir ?? null),
-    epicRefs: options.epicRefs === true ? epicRefsOf(workspace, runDir ?? null) : []
-  };
-}
-function epicRefsOf(workspace, runDir) {
-  if (runDir === null || runDir === "")
-    return [];
-  const path = join2(runDir, RUN_YML);
-  if (!existsSync2(path))
-    return [];
-  let doc;
-  try {
-    doc = parseYaml(readFileSync(path, "utf8"));
-  } catch {
-    return [];
-  }
-  const recorded = doc?.build?.epic_branch;
-  if (!Array.isArray(recorded))
-    return [];
-  const branches = [];
-  for (const entry of recorded) {
-    if (typeof entry === "string" && entry !== "" && !branches.includes(entry))
-      branches.push(entry);
-  }
-  if (branches.length === 0)
-    return [];
-  const refs = [];
-  for (const [repo, rel] of workspace.repos) {
-    const dir = join2(workspace.root, rel);
-    for (const ref of branches)
-      refs.push({ repo, dir, ref });
-  }
-  return refs;
-}
-function epicWorktreesOf(workspace, runDir) {
-  if (runDir === null || runDir === "")
-    return [];
-  const runId = basename(runDir);
-  if (runId === "")
-    return [];
-  const trees = [];
-  for (const repo of workspace.repos.keys()) {
-    const dir = join2(workspace.root, PROJECT_FRAMEWORK_DIR, PROJECT_WORKTREES_DIR, repo);
-    if (!existsSync2(dir))
-      continue;
-    let entries;
-    try {
-      entries = readdirSync(dir);
-    } catch {
-      continue;
-    }
-    for (const name of entries.slice().sort()) {
-      if (!isEpicWorktreeOf(name, runId))
-        continue;
-      const abs = join2(dir, name);
-      try {
-        if (statSync2(abs).isDirectory())
-          trees.push({ repo, dir: abs });
-      } catch {}
-    }
-  }
-  return trees;
-}
-function repoPath(workspace, name) {
-  const rel = workspace.repos.get(name);
-  return rel === undefined ? null : join2(workspace.root, rel);
-}
-function factsPath(root) {
-  return join2(root, PROJECT_FRAMEWORK_DIR, "memory", "facts.yml");
-}
-function stageYamlPath(root, stage) {
-  return join2(root, PROJECT_FRAMEWORK_DIR, "stages", stage, "stage.yml");
-}
-function listRunDirs(root) {
-  const work = join2(root, PROJECT_WORK_DIR);
-  if (!existsSync2(work))
-    return [];
-  const dirs = [];
-  for (const entry of readdirSync(work)) {
-    const dir = join2(work, entry);
-    if (existsSync2(join2(dir, RUN_YML)) && statSync2(dir).isDirectory())
-      dirs.push(dir);
-  }
-  return dirs.sort().reverse();
-}
+import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync3 } from "node:fs";
+import { basename, dirname as dirname3, isAbsolute as isAbsolute2, join as join3, resolve, sep as sep2 } from "node:path";
 
 // src/core/text/srcToken.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync3 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join3, normalize, relative, sep as sep2 } from "node:path";
+import { existsSync as existsSync2, readdirSync, readFileSync, statSync as statSync2 } from "node:fs";
+import { isAbsolute, join as join2, normalize, relative, sep } from "node:path";
 var LINE_RE = /^\d{1,9}$/;
 var LINE_RANGE_RE = /^(\d{1,9})-(\d{1,9})$/;
 var ANSWER_RE = /^Q\d{1,6}$/;
@@ -8359,7 +8104,7 @@ function resolveSrc(ref, ctx, section, claim = "") {
       const bases = pathBases(ref.repo, ref.path, ctx);
       let short = null;
       for (const base of bases) {
-        if (!existsSync3(base.abs) || !statSync3(base.abs).isFile())
+        if (!existsSync2(base.abs) || !statSync2(base.abs).isFile())
           continue;
         const lines = countLines(base.abs);
         const highest = ref.endLine ?? ref.startLine;
@@ -8480,7 +8225,7 @@ var EMPTY_PROBE_MAX_BYTES = 64 * 1024;
 function searchForNeedle(abs, needle, path) {
   let stat;
   try {
-    stat = statSync3(abs);
+    stat = statSync2(abs);
   } catch {
     return OK;
   }
@@ -8492,7 +8237,7 @@ function searchForNeedle(abs, needle, path) {
   }
   let text;
   try {
-    text = readFileSync2(abs, "utf8");
+    text = readFileSync(abs, "utf8");
   } catch {
     return noted(`${path} could not be read here to search for \`${needle}\``);
   }
@@ -8509,14 +8254,14 @@ function searchForNeedle(abs, needle, path) {
 function whatIsThere(abs) {
   let stat;
   try {
-    stat = statSync3(abs);
+    stat = statSync2(abs);
   } catch {
     return null;
   }
   if (stat.isDirectory()) {
     let entries;
     try {
-      entries = readdirSync2(abs);
+      entries = readdirSync(abs);
     } catch {
       return "a directory this check could not read";
     }
@@ -8532,7 +8277,7 @@ function whatIsThere(abs) {
     return `${String(stat.size)} bytes`;
   let text;
   try {
-    text = readFileSync2(abs, "utf8");
+    text = readFileSync(abs, "utf8");
   } catch {
     return `${String(stat.size)} bytes`;
   }
@@ -8553,7 +8298,7 @@ function absentBases(path, ctx) {
 }
 function firstExisting(bases) {
   for (const base of bases) {
-    if (existsSync3(base.abs))
+    if (existsSync2(base.abs))
       return base.abs;
   }
   return null;
@@ -8563,14 +8308,14 @@ function isNegativeClaim(text) {
   return NEGATIVE_RE.test(text);
 }
 function pathBases(repo, path, ctx) {
-  if (isAbsolute2(path)) {
+  if (isAbsolute(path)) {
     return [{ label: "the absolute path as written", abs: normalize(path) }];
   }
   if (repo !== null) {
     const rel2 = ctx.repos.get(repo) ?? "";
     return [
       ...epicBases(ctx, repo, path),
-      { label: repoLabel(repo, rel2), abs: normalize(join3(ctx.root, rel2, path)) }
+      { label: repoLabel(repo, rel2), abs: normalize(join2(ctx.root, rel2, path)) }
     ];
   }
   const bases = [];
@@ -8579,15 +8324,15 @@ function pathBases(repo, path, ctx) {
   const rel = named === "" ? undefined : ctx.repos.get(named);
   if (rel !== undefined)
     bases.push(...epicBases(ctx, named, path.slice(slash + 1)));
-  bases.push({ label: "workspace root", abs: normalize(join3(ctx.root, path)) });
+  bases.push({ label: "workspace root", abs: normalize(join2(ctx.root, path)) });
   const runDir = ctx.runDir ?? null;
   if (runDir !== null && runDir !== "") {
-    bases.push({ label: `run dir ${displayPath(ctx.root, runDir)}`, abs: normalize(join3(runDir, path)) });
+    bases.push({ label: `run dir ${displayPath(ctx.root, runDir)}`, abs: normalize(join2(runDir, path)) });
   }
   if (rel !== undefined) {
     bases.push({
       label: repoLabel(named, rel),
-      abs: normalize(join3(ctx.root, rel, path.slice(slash + 1)))
+      abs: normalize(join2(ctx.root, rel, path.slice(slash + 1)))
     });
   }
   return bases;
@@ -8600,7 +8345,7 @@ function epicBases(ctx, repo, path) {
       continue;
     bases.push({
       label: `epic worktree ${displayPath(ctx.root, tree.dir)}`,
-      abs: normalize(join3(tree.dir, path)),
+      abs: normalize(join2(tree.dir, path)),
       unmerged: `the epic worktree ${displayPath(ctx.root, tree.dir)}`
     });
   }
@@ -8612,13 +8357,13 @@ function repoLabel(name, rel) {
 }
 function displayPath(root, dir) {
   const rel = relative(root, dir);
-  return rel === "" || rel.startsWith("..") ? dir : rel.split(sep2).join("/");
+  return rel === "" || rel.startsWith("..") ? dir : rel.split(sep).join("/");
 }
 function countLines(path) {
   const cached = lineCountCache.get(path);
   if (cached !== undefined)
     return cached;
-  const count = countTextLines(readFileSync2(path, "utf8"));
+  const count = countTextLines(readFileSync(path, "utf8"));
   lineCountCache.set(path, count);
   return count;
 }
@@ -8684,7 +8429,7 @@ function resolveOnEpicRefs(ref, ctx) {
 }
 function epicTargets(ref, ctx) {
   const refs = ctx.epicRefs ?? [];
-  if (refs.length === 0 || isAbsolute2(ref.path))
+  if (refs.length === 0 || isAbsolute(ref.path))
     return [];
   const out = [];
   const push = (repo, path) => {
@@ -8727,17 +8472,17 @@ function loadFacts(root) {
   const cached = factsCache.get(root);
   if (cached !== undefined)
     return cached;
-  const index = readFacts(join3(root, PROJECT_FRAMEWORK_DIR, "memory", "facts.yml"));
+  const index = readFacts(join2(root, PROJECT_FRAMEWORK_DIR, "memory", "facts.yml"));
   factsCache.set(root, index);
   return index;
 }
 function readFacts(path) {
-  if (!existsSync3(path))
+  if (!existsSync2(path))
     return null;
   const live2 = new Set;
   const retired = new Set;
   try {
-    const doc = parseYaml(readFileSync2(path, "utf8"));
+    const doc = parseYaml(readFileSync(path, "utf8"));
     const rows = doc?.facts;
     if (!Array.isArray(rows))
       return { live: live2, retired };
@@ -8787,10 +8532,10 @@ function loadGraphNodes(root) {
   return ids;
 }
 function readGraphNodes(root) {
-  const roots = [join3(root, PROJECT_FRAMEWORK_DIR, "graphify-out"), join3(root, "graphify-out")];
+  const roots = [join2(root, PROJECT_FRAMEWORK_DIR, "graphify-out"), join2(root, "graphify-out")];
   const files = [];
   for (const dir of roots) {
-    if (!existsSync3(dir))
+    if (!existsSync2(dir))
       continue;
     files.push(...findFiles(dir, (name) => name === "graph.json", MAX_SCAN_DEPTH));
   }
@@ -8820,8 +8565,8 @@ function loadMapTokens(root) {
   const cached = mapCache.get(root);
   if (cached !== undefined)
     return cached;
-  const dir = join3(root, PROJECT_FRAMEWORK_DIR, "map");
-  if (!existsSync3(dir)) {
+  const dir = join2(root, PROJECT_FRAMEWORK_DIR, "map");
+  if (!existsSync2(dir)) {
     mapCache.set(root, null);
     return null;
   }
@@ -8843,13 +8588,13 @@ function loadDeclaredUrls(ctx) {
   const url = /https:\/\/[^\s)\]"'`<>]+/g;
   const runDir = ctx.runDir ?? "";
   const dirs = [
-    join3(ctx.root, PROJECT_FRAMEWORK_DIR, "map"),
-    join3(ctx.root, PROJECT_FRAMEWORK_DIR, "knowledge"),
-    join3(ctx.root, PROJECT_FRAMEWORK_DIR, "experts"),
+    join2(ctx.root, PROJECT_FRAMEWORK_DIR, "map"),
+    join2(ctx.root, PROJECT_FRAMEWORK_DIR, "knowledge"),
+    join2(ctx.root, PROJECT_FRAMEWORK_DIR, "experts"),
     ...runDir === "" ? [] : [runDir]
   ];
   for (const dir of dirs) {
-    if (!existsSync3(dir))
+    if (!existsSync2(dir))
       continue;
     for (const file of findFiles(dir, (name) => name.endsWith(".md") && name !== "handoff.md", MAX_SCAN_DEPTH)) {
       for (const match of readCapped(file).matchAll(url)) {
@@ -8867,7 +8612,7 @@ function findFiles(dir, accept, depth) {
       return;
     let entries;
     try {
-      entries = readdirSync2(current);
+      entries = readdirSync(current);
     } catch {
       return;
     }
@@ -8878,10 +8623,10 @@ function findFiles(dir, accept, depth) {
         continue;
       if (name === "node_modules")
         continue;
-      const abs = join3(current, name);
+      const abs = join2(current, name);
       let isDir;
       try {
-        isDir = statSync3(abs).isDirectory();
+        isDir = statSync2(abs).isDirectory();
       } catch {
         continue;
       }
@@ -8896,12 +8641,276 @@ function findFiles(dir, accept, depth) {
 }
 function readCapped(path) {
   try {
-    const text = readFileSync2(path, "utf8");
+    const text = readFileSync(path, "utf8");
     return text.length > MAX_SCAN_BYTES ? text.slice(0, MAX_SCAN_BYTES) : text;
   } catch {
     return "";
   }
 }
+function refreshSrcIndexes() {
+  lineCountCache.clear();
+  factsCache.clear();
+  questionsCache.clear();
+  graphCache.clear();
+  mapCache.clear();
+  urlCache.clear();
+}
+
+// src/core/detect/probeCommands.ts
+var PROBE_STATUSES = ["ok", "failed", "timed-out", "unspawnable", "not-probed", "skipped"];
+
+// src/core/schemas/workspace.ts
+function commandProbeIssues(probe, path) {
+  if (!isRecord(probe))
+    return [{ path, message: "expected a mapping" }];
+  const issues = [];
+  if (!PROBE_STATUSES.includes(probe.status)) {
+    issues.push({ path: `${path}.status`, message: `expected one of ${PROBE_STATUSES.join(" | ")}` });
+  }
+  if (typeof probe.verified !== "boolean") {
+    issues.push({ path: `${path}.verified`, message: "expected a boolean" });
+  }
+  if (probe.exit_code !== null && typeof probe.exit_code !== "number") {
+    issues.push({ path: `${path}.exit_code`, message: "expected a number or null" });
+  }
+  if (typeof probe.at !== "string" || probe.at === "") {
+    issues.push({ path: `${path}.at`, message: "expected a non-empty RFC3339 string" });
+  }
+  if (typeof probe.reason !== "string" || probe.reason === "") {
+    issues.push({ path: `${path}.reason`, message: "expected a non-empty sentence saying why" });
+  }
+  return issues;
+}
+
+// src/hooks/lib/workspace.ts
+var RUN_YML = "run.yml";
+function locateWork(filePath) {
+  if (filePath === "")
+    return null;
+  const abs = isAbsolute2(filePath) ? filePath : resolve(filePath);
+  const parts = abs.split(sep2);
+  const at = parts.lastIndexOf(PROJECT_WORK_DIR);
+  if (at === -1 || at + 1 >= parts.length)
+    return null;
+  const run = parts[at + 1] ?? "";
+  if (run === "")
+    return null;
+  return {
+    root: parts.slice(0, at).join(sep2) || sep2,
+    runDir: parts.slice(0, at + 2).join(sep2),
+    run,
+    relative: parts.slice(at + 2).join("/")
+  };
+}
+function findWorkspaceRoot(start) {
+  let current = isAbsolute2(start) ? start : resolve(start);
+  for (let i = 0;i < 64; i++) {
+    if (existsSync3(join3(current, PROJECT_FRAMEWORK_DIR)))
+      return current;
+    const parent = dirname3(current);
+    if (parent === current)
+      return null;
+    current = parent;
+  }
+  return null;
+}
+var FALLBACK_DEFAULT_BRANCH = "main";
+function commandRolesOf(doc) {
+  const out = new Map;
+  const list = doc?.repos;
+  if (!Array.isArray(list))
+    return out;
+  for (const entry of list) {
+    if (typeof entry?.name !== "string")
+      continue;
+    const roles = new Map;
+    const cmds = entry.commands;
+    if (cmds !== null && typeof cmds === "object") {
+      for (const [role, value] of Object.entries(cmds)) {
+        if (typeof value !== "string" || value.trim() === "")
+          continue;
+        roles.set(role, value);
+      }
+    }
+    out.set(entry.name, roles);
+  }
+  return out;
+}
+function commandProbesOf(doc) {
+  const out = new Map;
+  const list = doc?.repos;
+  if (!Array.isArray(list))
+    return out;
+  for (const entry of list) {
+    if (typeof entry?.name !== "string")
+      continue;
+    const probes = new Map;
+    const raw = entry.command_probes;
+    if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+      for (const [slot, value] of Object.entries(raw)) {
+        if (commandProbeIssues(value, slot).length > 0)
+          continue;
+        probes.set(slot, value);
+      }
+    }
+    out.set(entry.name, probes);
+  }
+  return out;
+}
+function loadWorkspace(root) {
+  const repos = new Map;
+  const commands = new Set;
+  const repoCommands = new Map;
+  const commandRoles = new Map;
+  const commandProbes = new Map;
+  const iterationCommands = new Set;
+  const defaultBranches = new Map;
+  let seedTriageThresholdTokens = null;
+  const empty = () => ({
+    root,
+    repos,
+    commands,
+    repoCommands,
+    commandRoles,
+    commandProbes,
+    iterationCommands,
+    defaultBranches,
+    seedTriageThresholdTokens
+  });
+  const path = join3(root, PROJECT_FRAMEWORK_DIR, "workspace.yml");
+  if (!existsSync3(path))
+    return empty();
+  let doc;
+  try {
+    doc = parseYaml(readFileSync2(path, "utf8"));
+  } catch {
+    return empty();
+  }
+  const triage = doc?.seed_triage;
+  if (triage !== null && typeof triage === "object") {
+    const tokens = triage.threshold_tokens;
+    if (typeof tokens === "number" && Number.isFinite(tokens) && tokens > 0) {
+      seedTriageThresholdTokens = tokens;
+    }
+  }
+  const list = doc?.repos;
+  if (!Array.isArray(list))
+    return empty();
+  const declared = commandRolesOf(doc);
+  const measured = commandProbesOf(doc);
+  for (const entry of list) {
+    if (typeof entry?.name !== "string")
+      continue;
+    repos.set(entry.name, typeof entry.path === "string" ? entry.path : ".");
+    defaultBranches.set(entry.name, typeof entry.default_branch === "string" && entry.default_branch !== "" ? entry.default_branch : FALLBACK_DEFAULT_BRANCH);
+    const own = [];
+    const roles = declared.get(entry.name) ?? new Map;
+    for (const value of roles.values()) {
+      commands.add(value);
+      if (!own.includes(value))
+        own.push(value);
+    }
+    repoCommands.set(entry.name, own);
+    commandRoles.set(entry.name, roles);
+    const fast = roles.get(ITERATION_ONLY_SLOT);
+    if (fast !== undefined)
+      iterationCommands.add(fast);
+    commandProbes.set(entry.name, measured.get(entry.name) ?? new Map);
+  }
+  return empty();
+}
+function toSrcContext(workspace, runDir, options = {}) {
+  refreshSrcIndexes();
+  return {
+    root: workspace.root,
+    repos: workspace.repos,
+    commands: workspace.commands,
+    runDir: runDir ?? null,
+    epicWorktrees: epicWorktreesOf(workspace, runDir ?? null),
+    epicRefs: options.epicRefs === true ? epicRefsOf(workspace, runDir ?? null) : []
+  };
+}
+function epicRefsOf(workspace, runDir) {
+  if (runDir === null || runDir === "")
+    return [];
+  const path = join3(runDir, RUN_YML);
+  if (!existsSync3(path))
+    return [];
+  let doc;
+  try {
+    doc = parseYaml(readFileSync2(path, "utf8"));
+  } catch {
+    return [];
+  }
+  const recorded = doc?.build?.epic_branch;
+  if (!Array.isArray(recorded))
+    return [];
+  const branches = [];
+  for (const entry of recorded) {
+    if (typeof entry === "string" && entry !== "" && !branches.includes(entry))
+      branches.push(entry);
+  }
+  if (branches.length === 0)
+    return [];
+  const refs = [];
+  for (const [repo, rel] of workspace.repos) {
+    const dir = join3(workspace.root, rel);
+    for (const ref of branches)
+      refs.push({ repo, dir, ref });
+  }
+  return refs;
+}
+function epicWorktreesOf(workspace, runDir) {
+  if (runDir === null || runDir === "")
+    return [];
+  const runId = basename(runDir);
+  if (runId === "")
+    return [];
+  const trees = [];
+  for (const repo of workspace.repos.keys()) {
+    const dir = join3(workspace.root, PROJECT_FRAMEWORK_DIR, PROJECT_WORKTREES_DIR, repo);
+    if (!existsSync3(dir))
+      continue;
+    let entries;
+    try {
+      entries = readdirSync2(dir);
+    } catch {
+      continue;
+    }
+    for (const name of entries.slice().sort()) {
+      if (!isEpicWorktreeOf(name, runId))
+        continue;
+      const abs = join3(dir, name);
+      try {
+        if (statSync3(abs).isDirectory())
+          trees.push({ repo, dir: abs });
+      } catch {}
+    }
+  }
+  return trees;
+}
+function repoPath(workspace, name) {
+  const rel = workspace.repos.get(name);
+  return rel === undefined ? null : join3(workspace.root, rel);
+}
+function factsPath(root) {
+  return join3(root, PROJECT_FRAMEWORK_DIR, "memory", "facts.yml");
+}
+function stageYamlPath(root, stage) {
+  return join3(root, PROJECT_FRAMEWORK_DIR, "stages", stage, "stage.yml");
+}
+function listRunDirs(root) {
+  const work = join3(root, PROJECT_WORK_DIR);
+  if (!existsSync3(work))
+    return [];
+  const dirs = [];
+  for (const entry of readdirSync2(work)) {
+    const dir = join3(work, entry);
+    if (existsSync3(join3(dir, RUN_YML)) && statSync3(dir).isDirectory())
+      dirs.push(dir);
+  }
+  return dirs.sort().reverse();
+}
 
 // src/core/text/handoff.ts
 var HANDOFF_SECTIONS = ["Findings", "Decisions", "Unknowns", "Evidence ledger"];
@@ -9129,4 +9138,4 @@ function noneBullet(lookedAt) {
   return `- none [src: absent:${lookedAt}]`;
 }
 
-export { runtime, parseYaml, parseYamlRepairing, FRAMEWORK_ROOT, STAGES_DIR, TEMPLATES_DIR, PROJECT_FRAMEWORK_DIR, PROJECT_WORK_DIR, result, requireVersion, isRecord, requireKeys, requireEnum, requireArray, requireNumber, requireString, requireRecord, asDocument, STORY_ID_RE, WAVE_ID_RE, MAX_WAVES, MAX_STORIES_PER_WAVE, MAX_PLAN_STORIES, requireStringList, requirePattern, requireVersion1, parseFrontMatter, ITERATION_ONLY_SLOT, readStory, DodCommandRefused, runDodCommand, commandProbeIssues, SRC_SEPARATOR, srcToken, readableSource, SRC_PATTERNS, srcRule, parseSrcToken, withoutSrcToken, classifySrc, locateWork, findWorkspaceRoot, loadWorkspace, toSrcContext, repoPath, factsPath, stageYamlPath, listRunDirs, parseHandoff, isHandoff, BULLET_RULE, EMPTY_SECTION_RULE, validateHandoff, validateCitations, noneBullet };
+export { runtime, parseYaml, parseYamlRepairing, FRAMEWORK_ROOT, STAGES_DIR, TEMPLATES_DIR, PROJECT_FRAMEWORK_DIR, PROJECT_WORK_DIR, SRC_SEPARATOR, srcToken, readableSource, SRC_PATTERNS, srcRule, parseSrcToken, withoutSrcToken, classifySrc, result, requireVersion, isRecord, requireKeys, requireEnum, requireArray, requireNumber, requireString, requireRecord, asDocument, STORY_ID_RE, WAVE_ID_RE, MAX_WAVES, MAX_STORIES_PER_WAVE, MAX_PLAN_STORIES, requireStringList, requirePattern, requireVersion1, parseFrontMatter, ITERATION_ONLY_SLOT, readStory, DodCommandRefused, runDodCommand, commandProbeIssues, locateWork, findWorkspaceRoot, loadWorkspace, toSrcContext, repoPath, factsPath, stageYamlPath, listRunDirs, parseHandoff, isHandoff, BULLET_RULE, EMPTY_SECTION_RULE, validateHandoff, validateCitations, noneBullet };

package/dist/hooks/claim-sources.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-a0y3ze46.js";
+} from "./chunk-r95h9ynf.js";
 import {
   claimSourcesDeny,
   claimSourcesEmptySectionDeny,
   claimSourcesMalformedDeny,
   claimSourcesUnresolvedDeny
-} from "./chunk-vnnmbjkz.js";
+} from "./chunk-dxk7eaqn.js";
 import {
   allow,
   deny,
@@ -16,8 +16,8 @@ import {
   postContext,
   readPayload,
   runHook
-} from "./chunk-5m3f8wme.js";
-import"./chunk-cyzm0n45.js";
+} from "./chunk-gvz0rzb9.js";
+import"./chunk-tpz0zb0t.js";
 import {
   isHandoff,
   loadWorkspace,
@@ -25,7 +25,7 @@ import {
   toSrcContext,
   validateCitations,
   validateHandoff
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/claim-sources.ts
 await runHook("claim-sources", async () => {

package/dist/hooks/dod-gate.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-a0y3ze46.js";
+} from "./chunk-r95h9ynf.js";
 import {
   dodGateDeny,
   dodGateInternalErrorDeny,
   dodGateMissingBlockDeny,
   dodGateRefusedCommandDeny
-} from "./chunk-vnnmbjkz.js";
+} from "./chunk-dxk7eaqn.js";
 import {
   allow,
   deny,
@@ -15,8 +15,8 @@ import {
   filePathOf,
   isWriteOrEdit,
   readPayload
-} from "./chunk-5m3f8wme.js";
-import"./chunk-cyzm0n45.js";
+} from "./chunk-gvz0rzb9.js";
+import"./chunk-tpz0zb0t.js";
 import {
   DodCommandRefused,
   loadWorkspace,
@@ -24,7 +24,7 @@ import {
   readStory,
   repoPath,
   runDodCommand
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/dod-gate.ts
 import { basename, join } from "node:path";

package/dist/hooks/no-reask.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-a0y3ze46.js";
+} from "./chunk-r95h9ynf.js";
 import {
   noReAskDeny
-} from "./chunk-vnnmbjkz.js";
+} from "./chunk-dxk7eaqn.js";
 import {
   FactsStore
-} from "./chunk-yn87xw4f.js";
+} from "./chunk-mzwqb08p.js";
 import {
   allow,
   deny,
@@ -15,17 +15,17 @@ import {
   isWriteOrEdit,
   readPayload,
   runHook
-} from "./chunk-5m3f8wme.js";
-import"./chunk-cyzm0n45.js";
-import"./chunk-693npq3d.js";
+} from "./chunk-gvz0rzb9.js";
+import"./chunk-tpz0zb0t.js";
+import"./chunk-db7wf3hy.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   factsPath,
   locateWork
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/hooks/no-reask.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/session-start.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   questionsCard
-} from "./chunk-djsf80bc.js";
-import"./chunk-yn87xw4f.js";
+} from "./chunk-w8qm1jbn.js";
+import"./chunk-mzwqb08p.js";
 import {
   allow,
   readPayload,
   runHook,
   sessionContext
-} from "./chunk-5m3f8wme.js";
-import"./chunk-cyzm0n45.js";
+} from "./chunk-gvz0rzb9.js";
+import"./chunk-tpz0zb0t.js";
 import {
   RunStore,
   closedByMachine,
@@ -18,7 +18,7 @@ import {
   openQuestions,
   runSnapshot,
   whatIsWaiting
-} from "./chunk-9zee1zpr.js";
+} from "./chunk-97zs34wb.js";
 import"./chunk-dzkg8c68.js";
 import {
   expertsDir,
@@ -27,13 +27,13 @@ import {
   pathsIntersect,
   readExpertDomain,
   stackExpertNames
-} from "./chunk-g73p9wgp.js";
-import"./chunk-ek3tsewd.js";
-import"./chunk-693npq3d.js";
+} from "./chunk-fefnr71h.js";
+import"./chunk-dnat9z30.js";
+import"./chunk-db7wf3hy.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-381n8p4g.js";
+} from "./chunk-bqmstq21.js";
 import {
   PROJECT_FRAMEWORK_DIR,
   PROJECT_WORK_DIR,
@@ -43,7 +43,7 @@ import {
   isRecord,
   listRunDirs,
   parseYaml
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/status/PendingItem.ts
 function isPending(item) {

package/dist/hooks/statusline.js

@@ -2,16 +2,16 @@
 import {
   bar,
   runSnapshot
-} from "./chunk-9zee1zpr.js";
+} from "./chunk-97zs34wb.js";
 import"./chunk-dzkg8c68.js";
-import"./chunk-g73p9wgp.js";
-import"./chunk-ek3tsewd.js";
-import"./chunk-693npq3d.js";
-import"./chunk-381n8p4g.js";
+import"./chunk-fefnr71h.js";
+import"./chunk-dnat9z30.js";
+import"./chunk-db7wf3hy.js";
+import"./chunk-bqmstq21.js";
 import {
   findWorkspaceRoot,
   runtime
-} from "./chunk-xe36zh9a.js";
+} from "./chunk-wwwmkey4.js";
 
 // src/core/statusline/renderStatusLine.ts
 var NO_SESSION_DATA = "[tldrx] no session data";

package/dist/tldrx.js

@@ -9001,6 +9001,14 @@ function readCapped(path) {
     return "";
   }
 }
+function refreshSrcIndexes() {
+  lineCountCache.clear();
+  factsCache.clear();
+  questionsCache.clear();
+  graphCache.clear();
+  mapCache.clear();
+  urlCache.clear();
+}
 
 // src/core/facts/validateFactsFile.ts
 var ID_RE = SRC_PATTERNS.fact;
@@ -10738,6 +10746,7 @@ function loadWorkspace(root) {
   return empty();
 }
 function toSrcContext(workspace, runDir, options = {}) {
+  refreshSrcIndexes();
   return {
     root: workspace.root,
     repos: workspace.repos,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tldr-experts",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "tldr-experts: an evidence-first, file-based AI development framework - five stages, a gate on every one, and every claim cited or refused. Installs the `tldrx` (and `tldr-experts`) command. Beta.",
   "license": "MIT",
   "author": "Alan Martinez",

package/plugin/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$doc": "Shape verified from https://code.claude.com/docs/en/plugins.md (Quickstart > Create the plugin manifest). Fields used here: name, description, version, author.name. Only plugin.json goes inside .claude-plugin/; skills/, agents/ and hooks/ live at the plugin root.",
   "name": "tldrx",
   "description": "tldr-experts: an evidence-first, file-based AI development framework. Five stages, a gate on every one, every claim cited or refused. Beta.",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "author": {
     "name": "Alan Martinez"
   }