tldr-experts 0.28.1 → 0.30.0

package/README.md

@@ -335,6 +335,8 @@ back on the registry is 0.3.0.
 
 | Version | Date | Status | Contains |
 |---|---|---|---|
+| 0.30.0 | 2026-09-15 | `beta` | Seventeen changes that keep an unattended run moving instead of stranding. A cached Build refusal says so and a relaunch re-measures it (#339); a rate-limit warning is read instead of dropped, so a Build parks before the wall (#298); the plan-over-stage advisory speaks only past 2× (#302); a stage death stops recommending a retry the budget refuses (#232); a DoD command is measured twice, a fix-list finding is checked against the epic tip, and an over-long sha is refused by name (#163); a formatting slip gets one bounded repair turn (#288); five Checks stop asking the reviewer for what it can't do (#195); a Codex review no longer dies before it runs (#148); `tldrx init` probes four commands at once (#180); `tldrx ship` refuses a merged diff nobody judged (#311). Docs: the zero-touch recipe pairs `run auto` with `--wait-gates`/`--wait-answers` (#342). |
+| 0.29.0 | 2026-09-15 | `beta` | Sixteen changes that make an unattended run trust its own gates and its own numbers. Verdict integrity: a reviewer's `changes` must cite evidence (#326), a re-reviewed story's `changes` is consumed instead of parking it (#327), and a story blocked on a stale fix list settles `done` once resolved (#329). Fix-list flow: a headless fix list now buys its own fix round, and an approving reviewer's signature closes what it was shown (#327). Money and phase sizing: `run auto` rebalances a blocked phase's shortfall out of finished phases by default (#330), the `budget-gate` hook stops denying the launch that would fix the shortfall (#321), a Build gate no longer stops on paths outside the declared surface but carries them into the PR instead (#331), a parallel wave no longer hands two developers the same unspent money (#325), `budget show`/`run estimate`/the budget-gate hook price remaining work off the stage's own `attempts:` (#214), `run auto --until-done` states a token refusal in tokens rather than invented dollar words (#270), a Watch turn is recorded as unmetered rather than a false `$0.00` (#224), and a Watch spawn now records the ceiling it was given (#190). Dependency and safety: a Build gate names the story a dependent waits on (#303), the conflict-turn marker guard names unreadable paths, bounds its scan, and covers modified files too (#324), a developer's array-valued `notes` is joined instead of silently dropped (#217), and the Plan prompt states its per-item character cap where each field is described so an over-cap finding survives into the retry (#328). |
 | 0.28.1 | 2026-09-15 | `beta` | Two fixes so a reopened story's reason reaches the agents that need it. The developer and reviewer prompts now carry `## Why this story was reopened` — who signed it, whether it's a fix round, the note verbatim — off the same ledger value #308 reads, instead of the note reaching only a report line and #308's check (closes #322). `tldrx note --help` now says an operator note reaches no agent and names `dispatch-notes.md` as the channel that does (closes #151). |
 | 0.28.0 | 2026-09-15 | `beta` | Four changes that keep an unattended run moving instead of stranding on a person. A story whose merge-up to its epic conflicts in at most three of its own touched files gets one automated conflict turn instead of a person, guarded against committing conflict markers (#286). `story reopen` on a blocked story now releases every dependent it alone was holding, in the same command (#312). Seed's `Recommended:` line and the loop's question parser now share one grammar, so a citation-only recommendation no longer parks a run that `seed check` had already passed (#323). And an `absent:` needle over `facts.yml` no longer trips on a fact's own recording metadata, while an `auto` gate refused only by failed checks gets one automatic re-run before waiting for a person (#231). |
 | 0.27.0 | 2026-09-14 | `beta` | Five changes for unattended runs, from a planning audit and live field measurement. The `plan` check now refuses a plan with more waves than the framework carries per run (unless `waves.yml` names a `wave_cap_reason`), refuses a story scheduled before its `depends_on` allows, and flags a dod command siblings carry that one story doesn't (#316–#319). `tldrx run auto --rebalance-finished` moves a blocked phase's exact shortfall out of a finished phase's unspent ceiling before refusing, through `budget raise --take-from` itself, so the run ceiling never grows and no grant is ever assumed; every money refusal now names the unspent total and the exact command to fix it (#314). `tldrx ship` fetches and merges the base into the epic and re-runs the `done` stories' DoD before opening a PR, so a stale or red epic refuses instead of shipping a PR that comes back red (#315). A reviewer's budget floor rises from $1.00 to $2.00, matching what completed reviews actually cost, so a review no longer dies mid-diff on a floor that was never measured (#307). And a developer whose DoD goes red gets the story's next attempt instead of blocking on the first miss, with the kept output handed to the next attempt and the bound counted from `events.jsonl` so it holds across process restarts; a refused developer, a cap death, or a broken dod command still blocks immediately (#313). |

package/dist/hooks/answer-capture.js

@@ -1,24 +1,23 @@
 #!/usr/bin/env node
 import {
   conflictOf
-} from "./chunk-c62y35wh.js";
+} from "./chunk-fbmj1bk6.js";
 import {
   FactsStore,
   formatJaccard
-} from "./chunk-48ctk154.js";
+} from "./chunk-gr83pq7x.js";
 import {
   parseHookInput,
   readStdin
-} from "./chunk-khjm356r.js";
+} from "./chunk-z9hv47ps.js";
 import {
   EventLog,
   PHASE_ID_RE
-} from "./chunk-abswp1vt.js";
+} from "./chunk-77x6v0gg.js";
 import {
   PHASE_IDS
-} from "./chunk-veffvzw5.js";
-import"./chunk-g7wz339n.js";
-import"./chunk-zvxgdssb.js";
+} from "./chunk-g4d2v4jc.js";
+import"./chunk-857jhjmb.js";
 import {
   ADVISORY_KEY,
   MAX_FACT_CHARS,
@@ -28,7 +27,7 @@ import {
   renderQuestionBlock,
   replaceBlock,
   serializeQuestions
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 import {
   ITERATION_ONLY_SLOT,
   PROJECT_FRAMEWORK_DIR,
@@ -38,7 +37,7 @@ import {
   isScopedTemplate,
   parseYaml,
   scopedSlotOf
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/hooks/answer-capture.ts
 import { existsSync as existsSync5 } from "fs";

package/dist/hooks/budget-gate.js

@@ -1,31 +1,36 @@
 #!/usr/bin/env node
 import {
   budgetGateDeny
-} from "./chunk-q3d4xdhb.js";
+} from "./chunk-mg3aj0sa.js";
 import {
   allow,
   deny,
   readPayload,
   runHook,
   toolInput
-} from "./chunk-tna1bz8r.js";
-import"./chunk-khjm356r.js";
+} from "./chunk-pne7afnf.js";
+import"./chunk-z9hv47ps.js";
 import {
+  REBALANCE_SOURCE,
+  applyRebalance,
   asRunBudget,
   currentActor,
+  describeRebalance,
   economyFor,
   isHostTokens,
   nowRfc3339,
+  planRebalance,
   raiseCommand,
+  raiseGrantVerdict,
   remainingWork,
   shortBy,
   validateRunBudget,
   wouldExceed,
   wouldExceedHostTokens
-} from "./chunk-e618k6te.js";
+} from "./chunk-zpch8e2j.js";
 import {
   EventLog
-} from "./chunk-abswp1vt.js";
+} from "./chunk-77x6v0gg.js";
 import {
   cursorStage,
   hostTokensIn,
@@ -34,18 +39,20 @@ import {
   newestActiveRun,
   renderRunEconomies,
   runSpend
-} from "./chunk-hws2gnxj.js";
-import"./chunk-g7wz339n.js";
+} from "./chunk-0d4csx4s.js";
+import {
+  buildStageDefaults
+} from "./chunk-g4d2v4jc.js";
 import {
   noteDeprecations
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 import {
   PROJECT_WORK_DIR,
   findWorkspaceRoot,
   locateWork,
   parseYaml,
   stageYamlPath
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/hooks/budget-gate.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "node:fs";
@@ -72,6 +79,8 @@ function loadRunBudget(runDir) {
 // src/hooks/budget-gate.ts
 var SPAWN_RE = /^(claude -p|tldrx next|tldrx run auto|tldrx expert train|tldrx seed triage)\b/;
 var RUN_ARG_RE = /--run[= ]([\w.-]+)/;
+var RUN_AUTO_RE = /^tldrx run auto\b/;
+var NO_REBALANCE_RE = /(?:^|\s)--no-rebalance-finished(?:[\s=]|$)/;
 var DEFAULT_TRAIN_USD = 2;
 var DEFAULT_FULL_TRAIN_USD = 3;
 var DEFAULT_TRIAGE_USD = 1;
@@ -116,6 +125,7 @@ await runHook("budget-gate", async () => {
   const attended = isAttendedByHostView(view);
   const stage = cursorStage(view);
   const declared = stage?.budget_usd ?? stageBudgetFromLibrary(root, view.cursor.stage);
+  const attempts = buildStageDefaults(root, view.scope, view.cursor.stage).attempts;
   const work = declared === null ? null : remainingWork({
     runDir: view.dir,
     phaseId: view.cursor.phase,
@@ -124,7 +134,8 @@ await runHook("budget-gate", async () => {
     perAgentMaxUsd: budget.per_agent_max_usd,
     maxUsd: null,
     economy: economyFor(budget, view.cursor.phase),
-    attended
+    attended,
+    attempts
   });
   const estimate = estimateFor(command, work === null ? null : work.usd);
   if (estimate <= 0)
@@ -156,7 +167,7 @@ ${economies}`}`);
 `);
     return;
   }
-  const decision = wouldExceed(budget, view.cursor.phase, estimate);
+  const decision = wouldExceed(budget, view.cursor.phase, estimate, attempts);
   if (!decision.blocked)
     return;
   if (attended) {
@@ -176,6 +187,15 @@ ${economies}`}`);
 `);
     return;
   }
+  if (decision.scope === "phase" && RUN_AUTO_RE.test(command) && !NO_REBALANCE_RE.test(command)) {
+    const short = shortBy(estimate, decision.remaining);
+    const covered = finishedPhasesCover(view.dir, budget, view.cursor.phase, short);
+    if (covered !== null) {
+      process.stderr.write(`tldrx hook budget-gate: ${view.cursor.phase} has $${decision.remaining.toFixed(2)} left of ` + `$${decision.ceiling.toFixed(2)} and the stage estimate is $${estimate.toFixed(2)} — NOT refusing: ` + `\`run auto\` rebalances finished phases before it refuses, and ${covered}, which covers the ` + `$${short.toFixed(2)} shortfall. The loop makes that move on its own record (\`budget.raised\`, ` + `source: ${REBALANCE_SOURCE}); launch with --no-rebalance-finished to be refused here instead.` + `${economies === null ? "" : ` ${economies}`}
+`);
+      return;
+    }
+  }
   new EventLog(join2(view.dir, "events.jsonl")).tryAppend({
     ts: nowRfc3339(),
     run: view.run,
@@ -226,6 +246,22 @@ function estimateFor(command, stageBudget) {
   }
   return stageBudget ?? 0;
 }
+function finishedPhasesCover(runDir, budget, phaseId, shortUsd) {
+  try {
+    const doc = parseYaml(readFileSync2(join2(runDir, "run.yml"), "utf8"));
+    if (doc === null || !Array.isArray(doc.phases))
+      return null;
+    const plan = planRebalance(budget, doc, phaseId, shortUsd);
+    if (plan.moves.length === 0)
+      return null;
+    const applied = applyRebalance(budget, plan);
+    if (applied.outcomes.some((outcome) => raiseGrantVerdict(budget, outcome).exceeds))
+      return null;
+    return describeRebalance(plan);
+  } catch {
+    return null;
+  }
+}
 function failClosed(command, why) {
   deny(`[tldrx] budget-gate: refusing \`${command.slice(0, 80)}\` — this gate could not read the budget ` + `it is supposed to enforce (${why}).
 ` + "It fails CLOSED: a spend nothing can check is exactly the one that must not start. Fix the run's " + "budget.yml, or pass `--run <id>` so the gate knows which run to charge.");

package/dist/hooks/{chunk-hws2gnxj.js → chunk-0d4csx4s.js}

@@ -1,7 +1,7 @@
 import {
   listRunDirs,
   parseYaml
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/hooks/lib/runFile.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-abswp1vt.js → chunk-77x6v0gg.js}

@@ -2,7 +2,7 @@ import {
   GATE_POLICIES,
   validateGatesPolicy,
   validateStagePolicy
-} from "./chunk-g7wz339n.js";
+} from "./chunk-g4d2v4jc.js";
 import {
   asDocument,
   isRecord,
@@ -15,7 +15,7 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/core/events/EventLog.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
@@ -39,6 +39,7 @@ var EVENT_TYPES = [
   "task.done",
   "agent.spawned",
   "agent.result",
+  "agent.rate_limited",
   "question.asked",
   "question.answered",
   "gate.requested",
@@ -54,6 +55,7 @@ var EVENT_TYPES = [
   "story.review_retried",
   "story.work_rescued",
   "story.touches_widened",
+  "plan.fix_round",
   "epic.released",
   "worktree.foreign_work_aside",
   "worktree.foreign_work_restored",

package/dist/hooks/{chunk-zrwq6r7k.js → chunk-7xascvee.js}

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

package/dist/hooks/{chunk-zvxgdssb.js → chunk-857jhjmb.js}

@@ -1,7 +1,7 @@
 import {
   PROJECT_FRAMEWORK_DIR,
   PROJECT_WORK_DIR
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.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-c62y35wh.js → chunk-fbmj1bk6.js}

@@ -1,15 +1,15 @@
 import {
   findDuplicate
-} from "./chunk-48ctk154.js";
+} from "./chunk-gr83pq7x.js";
 import {
   evidencePath,
   gateEvidencePath,
   parseEvidence
-} from "./chunk-abswp1vt.js";
+} from "./chunk-77x6v0gg.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 
 // src/core/distill/distill.ts
 var CONFLICT_THRESHOLD = 0.6;

package/dist/hooks/{chunk-veffvzw5.js → chunk-g4d2v4jc.js}

@@ -1,9 +1,3 @@
-import {
-  GatePolicyError,
-  STAGE_TUNING_DEFAULTS,
-  parseWorkflowGates,
-  readStageTuning
-} from "./chunk-g7wz339n.js";
 import {
   PROJECT_FRAMEWORK_DIR,
   STAGES_DIR,
@@ -12,12 +6,109 @@ import {
   isRecord,
   loadWorkspace,
   parseYaml
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/core/run/workflowPreset.ts
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
+// src/core/run/stagePolicy.ts
+function validateStagePolicy(value, stageIds, issues, spec) {
+  if (value === undefined || value === null)
+    return;
+  if (!isRecord(value)) {
+    issues.push({
+      path: spec.field,
+      message: `expected a mapping of stage id -> ${spec.policies.join(" | ")}`
+    });
+    return;
+  }
+  const known = new Set(stageIds);
+  for (const [key, raw] of Object.entries(value)) {
+    if (typeof raw !== "string" || !spec.policies.includes(raw)) {
+      issues.push({
+        path: `${spec.field}.${key}`,
+        message: `expected one of ${spec.policies.join(" | ")}, got ${JSON.stringify(raw)}`
+      });
+    }
+    if (known.size > 0 && !known.has(key)) {
+      issues.push({ path: `${spec.field}.${key}`, message: `names no stage in this run` });
+    }
+  }
+}
+
+// src/core/run/gatePolicy.ts
+var GATE_POLICIES = ["human", "auto", "agent"];
+var RESERVED_GATE_KEYS = ["collapse"];
+
+class GatePolicyError extends Error {
+}
+function isGatePolicy(value) {
+  return typeof value === "string" && GATE_POLICIES.includes(value);
+}
+function parseWorkflowGates(value, stageIds, source) {
+  if (value === undefined || value === null)
+    return {};
+  if (!isRecord(value)) {
+    throw new GatePolicyError(`${source}: gates must be a mapping of stage id -> ${GATE_POLICIES.join(" | ")}`);
+  }
+  const known = new Set(stageIds);
+  const out = {};
+  for (const [key, raw] of Object.entries(value)) {
+    if (RESERVED_GATE_KEYS.includes(key))
+      continue;
+    if (!known.has(key)) {
+      throw new GatePolicyError(`${source}: gates names '${key}', which is not one of this workflow's stages (${stageIds.join(", ")})`);
+    }
+    if (!isGatePolicy(raw)) {
+      throw new GatePolicyError(`${source}: gates.${key} must be ${GATE_POLICIES.join(" | ")}, got ${JSON.stringify(raw)}`);
+    }
+    out[key] = raw;
+  }
+  return out;
+}
+function validateGatesPolicy(value, stageIds, issues) {
+  validateStagePolicy(value, stageIds, issues, { field: "gates_policy", policies: GATE_POLICIES });
+}
+
+// src/core/schemas/stageTuning.ts
+var STAGE_TUNING_DEFAULTS = {
+  attempts: 2,
+  fixlistRounds: 1,
+  reviewerShare: 0.25,
+  gateSignerShare: 0.25,
+  storyCapMultiplier: 3,
+  storyCapFloorUsd: 4
+};
+var STAGE_TUNING_RANGES = {
+  attempts: { key: "attempts", min: 1, max: 5, integer: true },
+  fixlistRounds: { key: "fixlist_rounds", min: 0, max: 3, integer: true },
+  reviewerShare: { key: "reviewer_share", min: 0, max: 1, integer: false },
+  gateSignerShare: { key: "gate_signer_share", min: 0, max: 1, integer: false },
+  storyCapMultiplier: { key: "story_cap_multiplier", min: 1, max: 20, integer: false },
+  storyCapFloorUsd: { key: "story_cap_floor_usd", min: 0, max: 200, integer: false }
+};
+var FIELDS = Object.keys(STAGE_TUNING_RANGES);
+function inTuningRange(range, value) {
+  if (!Number.isFinite(value))
+    return false;
+  if (range.integer && !Number.isInteger(value))
+    return false;
+  return value >= range.min && value <= range.max;
+}
+function readStageTuning(doc) {
+  if (!isRecord(doc))
+    return STAGE_TUNING_DEFAULTS;
+  const out = { ...STAGE_TUNING_DEFAULTS };
+  for (const field of FIELDS) {
+    const range = STAGE_TUNING_RANGES[field];
+    const value = doc[range.key];
+    if (typeof value === "number" && inTuningRange(range, value))
+      out[field] = value;
+  }
+  return out;
+}
+
 // src/core/schemas/stage.ts
 var EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 function isEffortLevel(value) {
@@ -30,11 +121,11 @@ var PRECONDITION_TIMEOUT_S = 60;
 var PHASE_IDS = ["01-what", "02-how", "03-plan", "04-build", "05-watch"];
 var PHASE_SEGMENT_RE = /^0[1-5]-[a-z]+$/;
 var DEFAULT_TIMEOUT_S = 7200;
-function buildStageDefaults(root, scope) {
+function buildStageDefaults(root, scope, stageId) {
   const fallback = { attempts: STAGE_TUNING_DEFAULTS.attempts, timeoutS: DEFAULT_TIMEOUT_S };
   try {
     const preset = loadWorkflowPreset(root, scope);
-    const stage = preset.stages.find((s) => s.phase === PHASE_IDS[3]);
+    const stage = (stageId === undefined ? undefined : preset.stages.find((s) => s.id === stageId)) ?? preset.stages.find((s) => s.phase === PHASE_IDS[3]);
     if (stage === undefined)
       return fallback;
     return { attempts: stage.attempts, timeoutS: stage.timeout_s };
@@ -275,4 +366,4 @@ function isString(value) {
   return typeof value === "string";
 }
 
-export { PHASE_IDS, DEFAULT_TIMEOUT_S, buildStageDefaults };
+export { validateStagePolicy, GATE_POLICIES, validateGatesPolicy, STAGE_TUNING_DEFAULTS, PHASE_IDS, DEFAULT_TIMEOUT_S, buildStageDefaults };

package/dist/hooks/{chunk-48ctk154.js → chunk-gr83pq7x.js}

@@ -3,7 +3,7 @@ import {
   withWorkspaceLock,
   workspaceRootOfFactsPath,
   writeAtomic
-} from "./chunk-zvxgdssb.js";
+} from "./chunk-857jhjmb.js";
 import {
   FACT_CONFIDENCES,
   FACT_DECIDERS,
@@ -15,7 +15,7 @@ import {
   isLive,
   isRetired,
   noteDeprecations
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 import {
   SRC_PATTERNS,
   asDocument,
@@ -28,7 +28,7 @@ import {
   requireString,
   requireVersion,
   result
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/core/facts/FactsStore.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/{chunk-q3d4xdhb.js → chunk-mg3aj0sa.js}

@@ -3,7 +3,7 @@ import {
   EMPTY_SECTION_RULE,
   noneBullet,
   srcRule
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.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-tna1bz8r.js → chunk-pne7afnf.js}

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

package/dist/hooks/{chunk-fjeefnqr.js → chunk-przta0a0.js}

@@ -9,7 +9,7 @@ import {
   spentBasis,
   tallyOf,
   validateRunBudget
-} from "./chunk-e618k6te.js";
+} from "./chunk-zpch8e2j.js";
 import {
   EventLog,
   OUTCOME_NOT_RECORDED,
@@ -22,12 +22,12 @@ import {
   isTerminal,
   stageAt,
   validateRunFile
-} from "./chunk-abswp1vt.js";
+} from "./chunk-77x6v0gg.js";
 import {
   cursorStage,
   isAttendedByHostView,
   openRunViews
-} from "./chunk-hws2gnxj.js";
+} from "./chunk-0d4csx4s.js";
 import {
   backupPathFor,
   isAlive,
@@ -36,20 +36,21 @@ import {
   workspaceRootOfRunDir,
   writeAtomic,
   yamlScalar
-} from "./chunk-zvxgdssb.js";
+} from "./chunk-857jhjmb.js";
 import {
   isAdvisory,
   noteDeprecations,
   openBlocks,
   parseQuestions
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 import {
   FRAMEWORK_ROOT,
+  MAX_ITEM_CHARS,
   PLAN_STATUSES,
   listRunDirs,
   parseYaml,
   parseYamlRepairing
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
@@ -634,7 +635,7 @@ var WAVE_CAP_REASON_KEY = "wave_cap_reason";
 var PLAN_SHAPE_RULES = [
   {
     issue: "#316",
-    text: `**At most ${String(MAX_WAVES_PER_RUN)} waves** (patch for ${RUN_SIZE_ISSUES} — the framework's measured ` + "carry today, not a design preference). A later wave waits on every earlier merge, so each extra wave is " + "a stall: a 4-wave plan left 2 stories never attempted. The `plan` check refuses more unless the root of " + `\`${WAVES_FILE}\` records \`${WAVE_CAP_REASON_KEY}: "<why these stories cannot share a wave>"\`.`
+    text: `**At most ${String(MAX_WAVES_PER_RUN)} waves** (patch for ${RUN_SIZE_ISSUES} — the framework's measured ` + "carry today, not a design preference). A later wave waits on every earlier merge, so each extra wave is " + "a stall: a 4-wave plan left 2 stories never attempted. The `plan` check refuses more unless the root of " + `\`${WAVES_FILE}\` records \`${WAVE_CAP_REASON_KEY}: "<why these stories cannot share a wave>"\` — one sentence ` + `on one line, at most ${String(MAX_ITEM_CHARS)} characters (#328).`
   },
   {
     issue: "#316",
@@ -663,6 +664,9 @@ var LINE_BREAK_NOTE = `\`${LINE_BREAK_MARK}\` marks a line break inside a quoted
 var FINDING_STATUS_RE = new RegExp(`—\\s+(${PLAN_STATUSES.join("|")})\\s+—`);
 var FINDING_REASON_RE = new RegExp(`—\\s+(?:${PLAN_STATUSES.join("|")})\\s+—\\s+[^:]*:\\s*(\\S.*)$`);
 
+// src/core/build/dependencyHold.ts
+var NOT_A_HOLD_REASON = "its block is not a dependency hold — a reviewer, a DoD or a developer recorded it, " + "and reopening a dependency does not answer that; `tldrx story reopen <id>` does";
+
 // src/core/run/runOutcome.ts
 var BUILD_HANDOFF = join3(BUILD_PHASE, "handoff.md");
 var NO_BUILD_PHASE = "this run's workflow has no Build phase, so no story could be delivered";
@@ -877,8 +881,33 @@ function hasPreparedBundle(runDir, stageId) {
   return preparedBundles(runDir, stageId).length > 0;
 }
 
+// src/core/run/lastStart.ts
+function lastStageStartMode(runDir, stageId) {
+  const events = EventLog.forRun(runDir).readAll().events;
+  for (let index = events.length - 1;index >= 0; index -= 1) {
+    const event = events[index];
+    if (event === undefined)
+      continue;
+    if (event.type !== "stage.started" || event.stage !== stageId)
+      continue;
+    const mode = event.payload.mode;
+    return typeof mode === "string" && mode !== "" ? mode : null;
+  }
+  return null;
+}
+function startedHeadless(runDir, stageId) {
+  return lastStageStartMode(runDir, stageId) === "headless";
+}
+
 // src/core/run/waiting.ts
-var MOVABLE_KINDS = ["gate", "answer", "ready", "failed", "prepared"];
+var MOVABLE_KINDS = [
+  "gate",
+  "answer",
+  "ready",
+  "failed",
+  "prepared",
+  "interrupted"
+];
 function isMovable(kind) {
   return MOVABLE_KINDS.includes(kind);
 }
@@ -948,6 +977,13 @@ function waitingFor(run, runDir) {
           questions: open
         };
       }
+      if (startedHeadless(runDir, entry.stage.id)) {
+        return {
+          kind: "interrupted",
+          message: `${entry.phase.id}/${entry.stage.id} was interrupted — its headless turn's process is gone — ` + `\`tldrx run auto ${basename2(runDir)}\``,
+          questions: open
+        };
+      }
       if (hasPreparedBundle(runDir, entry.stage.id)) {
         return {
           kind: "prepared",

package/dist/hooks/{chunk-f6t1xc3f.js → chunk-qmp5p77c.js}

@@ -7548,7 +7548,7 @@ function requireStringList(value, path, issues, rules = {}) {
     if (item.length > MAX_ITEM_CHARS) {
       issues.push({
         path: at,
-        message: `${item.length} characters exceeds the ${MAX_ITEM_CHARS}-character cap on one list item ` + "— split it into several items"
+        message: `${item.length} characters (cap ${MAX_ITEM_CHARS}) — split it into several items`
       });
     }
     if (rules.pattern !== undefined && !rules.pattern.test(item)) {
@@ -9202,4 +9202,4 @@ function noneBullet(lookedAt) {
   return `- none [src: absent:${lookedAt}]`;
 }
 
-export { runtime, parseYaml, parseYamlRepairing, FRAMEWORK_ROOT, STAGES_DIR, WORKFLOWS_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, PLAN_STATUSES, MAX_WAVES, MAX_STORIES_PER_WAVE, MAX_PLAN_STORIES, requireStringList, requirePattern, requireVersion1, parseFrontMatter, allowlistIssue, ITERATION_ONLY_SLOT, scopedSlotOf, isScopedTemplate, readStory, DodCommandRefused, runDodCommand, commandProbeIssues, 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, WORKFLOWS_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, PLAN_STATUSES, MAX_ITEM_CHARS, MAX_WAVES, MAX_STORIES_PER_WAVE, MAX_PLAN_STORIES, requireStringList, requirePattern, requireVersion1, parseFrontMatter, allowlistIssue, ITERATION_ONLY_SLOT, scopedSlotOf, isScopedTemplate, 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/{chunk-khy21x6e.js → chunk-yanmz0vz.js}

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

package/dist/hooks/{chunk-khjm356r.js → chunk-z9hv47ps.js}

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