tldr-experts 0.3.1 → 0.5.0

package/dist/hooks/{chunk-zdxgragg.js → chunk-14zn51kh.js}

@@ -1,6 +1,3 @@
-import {
-  parseHandoff
-} from "./chunk-458wgg9j.js";
 import {
   MAX_PLAN_STORIES,
   MAX_STORIES_PER_WAVE,
@@ -11,10 +8,7 @@ import {
   requirePattern,
   requireStringList,
   requireVersion1
-} from "./chunk-0z27twdk.js";
-import {
-  classifySrc
-} from "./chunk-sznsenee.js";
+} from "./chunk-hcrbr430.js";
 import {
   asDocument,
   isRecord,
@@ -27,11 +21,17 @@ import {
   requireVersion,
   result
 } from "./chunk-39zh2e44.js";
+import {
+  parseHandoff
+} from "./chunk-q8d3sff9.js";
 import {
   PROJECT_FRAMEWORK_DIR,
+  SRC_PATTERNS,
+  classifySrc,
   listRunDirs,
-  parseYaml
-} from "./chunk-ztczwtj0.js";
+  parseYaml,
+  readableSource
+} from "./chunk-a6rpj2cp.js";
 
 // src/hooks/lib/runFile.ts
 import { existsSync, readFileSync } from "node:fs";
@@ -67,7 +67,8 @@ function loadRunView(runDir) {
             status: str(s?.status),
             expert: typeof s?.expert === "string" ? s.expert : null,
             budget_usd: typeof s?.budget_usd === "number" ? s.budget_usd : null,
-            cost_usd: typeof s?.cost_usd === "number" ? s.cost_usd : null
+            cost_usd: typeof s?.cost_usd === "number" ? s.cost_usd : null,
+            tasks: tasksOf(s?.tasks)
           });
         }
       }
@@ -81,10 +82,69 @@ function loadRunView(runDir) {
     scope: str(doc.scope),
     status: str(doc.status),
     updated_at: str(doc.updated_at),
+    attended_by: typeof doc.attended_by === "string" && doc.attended_by !== "" ? doc.attended_by : null,
     cursor,
     phases
   };
 }
+function tasksOf(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.map((task) => ({
+    cost_usd: typeof task?.cost_usd === "number" ? task.cost_usd : null,
+    metered: task?.metered !== false,
+    tokens: typeof task?.tokens === "number" ? task.tokens : null
+  }));
+}
+function isAttendedByHostView(view) {
+  return view.attended_by === "host";
+}
+function runSpend(view) {
+  let meteredUsd = 0;
+  let hostTokens = 0;
+  let unmeteredTasks = 0;
+  for (const phase of view.phases) {
+    for (const stage of phase.stages) {
+      for (const task of stage.tasks) {
+        if (task.cost_usd !== null)
+          meteredUsd += task.cost_usd;
+        if (!task.metered || task.cost_usd === null)
+          unmeteredTasks += 1;
+        if (task.tokens !== null)
+          hostTokens += task.tokens;
+      }
+    }
+  }
+  return { meteredUsd: Math.round(meteredUsd * 100) / 100, hostTokens, unmeteredTasks };
+}
+function hostTokensIn(view, phaseId) {
+  let tokens = 0;
+  for (const phase of view.phases) {
+    if (phaseId !== null && phase.id !== phaseId)
+      continue;
+    for (const stage of phase.stages) {
+      for (const task of stage.tasks) {
+        if (task.tokens !== null)
+          tokens += task.tokens;
+      }
+    }
+  }
+  return tokens;
+}
+function renderRunEconomies(view) {
+  const spend = runSpend(view);
+  const attended = isAttendedByHostView(view);
+  if (spend.hostTokens === 0 && spend.unmeteredTasks === 0 && !attended)
+    return null;
+  const parts = [`$${spend.meteredUsd.toFixed(2)} metered`];
+  if (spend.hostTokens > 0)
+    parts.push(`${String(spend.hostTokens)} host tokens`);
+  if (spend.unmeteredTasks > 0) {
+    parts.push(`${String(spend.unmeteredTasks)} unmetered turn${spend.unmeteredTasks === 1 ? "" : "s"}`);
+  }
+  const who = attended ? " (attended_by: host — the framework does not spawn on this run)" : "";
+  return `spend so far: ${parts.join(" + ")}${who}. ` + "The dollar figure is METERED spend only; host tokens are a different currency and are never converted.";
+}
 function isTerminal(status) {
   return TERMINAL_STATUSES.includes(status);
 }
@@ -126,6 +186,8 @@ function nowRfc3339() {
 
 // src/core/budget/RunBudget.ts
 var ON_EXCEED = ["block", "warn"];
+var ON_HOST_TOKENS_EXCEED = ["warn", "block"];
+var DEFAULT_ON_HOST_TOKENS_EXCEED = "warn";
 var ECONOMIES = ["metered-usd", "host-tokens"];
 var DEFAULT_ECONOMY = "metered-usd";
 var DEFAULT_WARN_AT_PCT = 80;
@@ -158,6 +220,12 @@ function validateRunBudget(input) {
   if (doc.economy !== undefined && doc.economy !== null) {
     requireEnum(doc.economy, ECONOMIES, "economy", issues);
   }
+  if (doc.on_host_tokens_exceed !== undefined && doc.on_host_tokens_exceed !== null) {
+    requireEnum(doc.on_host_tokens_exceed, ON_HOST_TOKENS_EXCEED, "on_host_tokens_exceed", issues);
+  }
+  if (doc.ceiling_host_tokens !== undefined && doc.ceiling_host_tokens !== null) {
+    requireNumber(doc.ceiling_host_tokens, "ceiling_host_tokens", issues);
+  }
   if (doc.warn_at_pct !== undefined) {
     requireNumber(doc.warn_at_pct, "warn_at_pct", issues);
     const pct = doc.warn_at_pct;
@@ -171,7 +239,9 @@ function validateRunBudget(input) {
   if (phases.length > MAX_PHASES) {
     issues.push({ path: "phases", message: `${phases.length} phases exceeds the ${MAX_PHASES} cap` });
   }
+  const runEconomy = ECONOMIES.includes(doc.economy) ? doc.economy : DEFAULT_ECONOMY;
   let sum = 0;
+  let tokenSum = 0;
   phases.forEach((phase, i) => {
     const path = `phases[${i}]`;
     if (!isRecord(phase)) {
@@ -185,12 +255,27 @@ function validateRunBudget(input) {
     if (phase.economy !== undefined && phase.economy !== null) {
       requireEnum(phase.economy, ECONOMIES, `${path}.economy`, issues);
     }
+    if (phase.ceiling_host_tokens !== undefined && phase.ceiling_host_tokens !== null) {
+      requireNumber(phase.ceiling_host_tokens, `${path}.ceiling_host_tokens`, issues);
+    }
+    const economy = ECONOMIES.includes(phase.economy) ? phase.economy : runEconomy;
+    if (economy === "host-tokens") {
+      const tokens = typeof phase.ceiling_host_tokens === "number" ? phase.ceiling_host_tokens : typeof phase.ceiling_usd === "number" ? phase.ceiling_usd : 0;
+      tokenSum += tokens;
+      return;
+    }
     if (typeof phase.ceiling_usd === "number")
       sum += phase.ceiling_usd;
   });
   if (typeof doc.ceiling_usd === "number" && sum > doc.ceiling_usd + 0.000000001) {
     issues.push({ path: "phases", message: `phase ceilings sum to ${sum} > ceiling_usd ${doc.ceiling_usd}` });
   }
+  if (typeof doc.ceiling_host_tokens === "number" && tokenSum > doc.ceiling_host_tokens + 0.000000001) {
+    issues.push({
+      path: "phases",
+      message: `phase host-token ceilings sum to ${tokenSum} > ceiling_host_tokens ${doc.ceiling_host_tokens}`
+    });
+  }
   return result(issues, deprecations);
 }
 function asRunBudget(input) {
@@ -203,14 +288,27 @@ function asRunBudget(input) {
     warn_at_pct: doc.warn_at_pct ?? DEFAULT_WARN_AT_PCT,
     on_exceed: doc.on_exceed ?? "block",
     economy: doc.economy ?? DEFAULT_ECONOMY,
+    on_host_tokens_exceed: doc.on_host_tokens_exceed ?? DEFAULT_ON_HOST_TOKENS_EXCEED,
+    ceiling_host_tokens: doc.ceiling_host_tokens ?? null,
     phases: (doc.phases ?? []).map((phase) => ({
       id: phase.id,
       ceiling_usd: phase.ceiling_usd,
       spent_usd: phase.spent_usd,
-      economy: phase.economy ?? null
+      economy: phase.economy ?? null,
+      ceiling_host_tokens: phase.ceiling_host_tokens ?? null
     }))
   };
 }
+function hostTokenCeiling(budget, phaseId) {
+  if (budget === null || !isHostTokens(budget, phaseId))
+    return null;
+  if (phaseId !== undefined && phaseId !== null) {
+    const phase = budget.phases.find((entry) => entry.id === phaseId);
+    if (phase !== undefined)
+      return phase.ceiling_host_tokens ?? phase.ceiling_usd;
+  }
+  return budget.ceiling_host_tokens ?? budget.ceiling_usd;
+}
 
 // src/core/budget/remainingWork.ts
 import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
@@ -326,6 +424,12 @@ var SKIPPED_DIRS = new Set([
   "test-results"
 ]);
 
+// src/core/plan/branchModel.ts
+var BRANCH_MODELS = ["per-epic", "integration"];
+function isBranchModelKind(value) {
+  return typeof value === "string" && BRANCH_MODELS.includes(value);
+}
+
 // src/core/experts/expertDocument.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 import { join as join3 } from "node:path";
@@ -889,6 +993,21 @@ function stackExpertNames(root, repos) {
   return names;
 }
 
+// src/core/text/srcGrammarContract.ts
+var KINDS = {
+  file: { shape: "`[repo:]path:line[-line]`", example: "api:src/Selector.ts:241" },
+  doc: { shape: "`https://` + a non-space URL", example: "https://example.com/spec" },
+  answer: { shape: `\`Q<n>\` (${readableSource(SRC_PATTERNS.answer)})`, example: "Q3" },
+  fact: { shape: `\`F<nnn>\` (${readableSource(SRC_PATTERNS.fact)})`, example: "F102" },
+  cmd: { shape: `\`$ <command> → exit <n>\` (${readableSource(SRC_PATTERNS.cmd)})`, example: "$ bun test → exit 0" },
+  graph: { shape: "`graph:<node id>`", example: "graph:hunt-engine" },
+  absent: { shape: "`absent:<the path you looked at>`", example: "absent:docs/retention.md" },
+  aidlc: {
+    shape: `\`aidlc:<file>:<line>\` or \`aidlc:<file>#Q<n>\` (${readableSource(SRC_PATTERNS.aidlcLine)})`,
+    example: "aidlc:intents/260821/design.md:14"
+  }
+};
+
 // src/core/build/prompts.ts
 var MAX_TOUCHED_BYTES = 64 * 1024;
 
@@ -1082,6 +1201,8 @@ function round(n) {
 }
 
 // src/core/build/review.ts
+var VERDICT_WORDS = ["approve", "fixlist", "changes"];
+var VERDICT_ENUM = VERDICT_WORDS.join("|");
 var REVIEWER_FAILED = "the reviewer sub-agent failed";
 function looksLikeReviewerError(detail) {
   const text = detail.trim();
@@ -1096,6 +1217,9 @@ function looksLikeSpawnError(detail) {
 var MAX_ATTEMPTS = 2;
 var REVIEWER_SHARE = 0.25;
 var REVIEWER_FLOOR_USD = 1;
+function developerPriceDivisor(attempt) {
+  return attempt <= 1 ? 1 + REVIEWER_SHARE : MAX_ATTEMPTS * (1 + REVIEWER_SHARE);
+}
 function remainingWork(input) {
   try {
     return measure(input);
@@ -1111,6 +1235,7 @@ function staticOnly(input) {
     staticUsd: input.stageBudgetUsd,
     clamped: false,
     economy: input.economy ?? DEFAULT_ECONOMY,
+    attended: input.attended === true,
     stories: [],
     done: 0,
     total: 0,
@@ -1119,6 +1244,7 @@ function staticOnly(input) {
 }
 function measure(input) {
   const economy = input.economy ?? DEFAULT_ECONOMY;
+  const hostPaysDeveloper = economy === "host-tokens" || input.attended === true;
   const fallback = {
     basis: "static",
     usd: input.stageBudgetUsd,
@@ -1126,6 +1252,7 @@ function measure(input) {
     staticUsd: input.stageBudgetUsd,
     clamped: false,
     economy,
+    attended: input.attended === true,
     stories: [],
     done: 0,
     total: 0,
@@ -1157,9 +1284,12 @@ function measure(input) {
     if (attemptsLeft === 0)
       continue;
     const developerTurns = Math.max(attemptsLeft - (story.status === "review" ? 1 : 0), 0);
-    const developerCapUsd = economy === "host-tokens" ? 0 : caps.developer(story.id);
+    const firstTurn = MAX_ATTEMPTS - developerTurns + 1;
+    const developerCapsUsd = Array.from({ length: developerTurns }, (_unused, i) => hostPaysDeveloper ? 0 : caps.developer(story.id, firstTurn + i));
+    const developerCapUsd = developerCapsUsd[0] ?? 0;
     const reviewerCapUsd = caps.reviewer(story.id);
-    const usd = round2(developerCapUsd * developerTurns + reviewerCapUsd * attemptsLeft);
+    const developerUsd = developerCapsUsd.reduce((sum, cap) => sum + cap, 0);
+    const usd = round2(developerUsd + reviewerCapUsd * attemptsLeft);
     if (usd <= 0 && developerTurns === 0 && attemptsLeft === 0)
       continue;
     stories.push({
@@ -1168,6 +1298,7 @@ function measure(input) {
       developerTurns,
       reviews: attemptsLeft,
       developerCapUsd,
+      developerCapsUsd,
       reviewerCapUsd,
       usd
     });
@@ -1182,6 +1313,7 @@ function measure(input) {
     staticUsd: input.stageBudgetUsd,
     clamped,
     economy,
+    attended: input.attended === true,
     stories,
     done: progress.done,
     total: progress.total,
@@ -1206,11 +1338,11 @@ class CapMath {
     this.scale = input.stageBudgetUsd <= 0 || sum <= input.stageBudgetUsd ? 1 : input.stageBudgetUsd / sum;
     this.maxBudgetUsd = this.agentCap(1);
   }
-  developer(storyId) {
+  developer(storyId, attempt) {
     const price = this.priceOf(storyId);
     if (price === null)
       return this.agentCap(1 / this.worstCaseShares());
-    return this.agentCap(this.shareOf(price / (MAX_ATTEMPTS * (1 + REVIEWER_SHARE))));
+    return this.agentCap(this.shareOf(price / developerPriceDivisor(attempt)));
   }
   reviewer(storyId) {
     const price = this.priceOf(storyId);
@@ -1314,6 +1446,20 @@ function wouldExceed(budget, phaseId, estimate) {
 function round3(n) {
   return Math.round(n * 1e6) / 1e6;
 }
+function wouldExceedHostTokens(budget, phaseId, spentTokens) {
+  const ceiling = hostTokenCeiling(budget, phaseId);
+  if (ceiling === null)
+    return null;
+  const phase = phaseId === null ? undefined : budget.phases.find((p) => p.id === phaseId);
+  const over = ceiling > 0 && spentTokens > ceiling;
+  return {
+    over,
+    blocked: over && budget.on_host_tokens_exceed === "block",
+    scope: phase === undefined ? "run" : "phase",
+    spent: spentTokens,
+    ceiling
+  };
+}
 
 // src/core/run/gatePolicy.ts
 var GATE_POLICIES = ["human", "auto", "agent"];
@@ -1450,6 +1596,12 @@ function validateRunFile(input) {
           requireString(branch, `build.epic_branch[${i}]`, issues);
         });
       }
+      if (doc.build.branch_model !== undefined && !isBranchModelKind(doc.build.branch_model)) {
+        issues.push({
+          path: "build.branch_model",
+          message: `expected one of ${BRANCH_MODELS.join(" | ")}`
+        });
+      }
     } else {
       issues.push({ path: "build", message: "expected a mapping" });
     }
@@ -1479,6 +1631,9 @@ function validateRunFile(input) {
   }
   if (doc.attended_by !== undefined)
     requireEnum(doc.attended_by, ATTENDED_BY, "attended_by", issues);
+  if (doc.keep_worktrees !== undefined && typeof doc.keep_worktrees !== "boolean") {
+    issues.push({ path: "keep_worktrees", message: `expected a boolean, got ${typeof doc.keep_worktrees}` });
+  }
   if (!requireArray(doc.phases, "phases", issues))
     return result(issues, deprecations);
   const phases = doc.phases;
@@ -1652,4 +1807,4 @@ function shortBy(estimate, remaining) {
   return Math.max(0.01, Math.ceil((estimate - remaining) * 100) / 100);
 }
 
-export { loadRunView, cursorStage, openRunViews, newestActiveRun, currentActor, nowRfc3339, DEFAULT_ECONOMY, economyFor, isHostTokens, validateRunBudget, asRunBudget, expertsDir, loadExperts, readExpertDomain, pathsIntersect, parseEvidence, evidencePath, gateEvidencePath, stackExpertNames, remainingWork, wouldExceed, isTerminal2 as isTerminal, isFinished, isAttendedByHost, flatten, stageAt, deriveRunStatus, derivePhaseStatus, validateRunFile, asRunFile, raiseCommand, shortBy };
+export { loadRunView, isAttendedByHostView, runSpend, hostTokensIn, renderRunEconomies, cursorStage, openRunViews, newestActiveRun, currentActor, nowRfc3339, DEFAULT_ON_HOST_TOKENS_EXCEED, DEFAULT_ECONOMY, economyFor, isHostTokens, validateRunBudget, asRunBudget, expertsDir, loadExperts, readExpertDomain, pathsIntersect, parseEvidence, evidencePath, gateEvidencePath, stackExpertNames, remainingWork, wouldExceed, wouldExceedHostTokens, isTerminal2 as isTerminal, isFinished, isAttendedByHost, flatten, stageAt, deriveRunStatus, derivePhaseStatus, validateRunFile, asRunFile, raiseCommand, shortBy };

package/dist/hooks/{chunk-xpxe94qe.js → chunk-3w55tp71.js}

@@ -1,5 +1,6 @@
 import {
   DEFAULT_ECONOMY,
+  DEFAULT_ON_HOST_TOKENS_EXCEED,
   asRunBudget,
   asRunFile,
   cursorStage,
@@ -7,6 +8,7 @@ import {
   deriveRunStatus,
   flatten,
   isAttendedByHost,
+  isAttendedByHostView,
   isFinished,
   isTerminal,
   nowRfc3339,
@@ -14,34 +16,37 @@ import {
   stageAt,
   validateRunBudget,
   validateRunFile
-} from "./chunk-zdxgragg.js";
+} from "./chunk-14zn51kh.js";
 import {
   EventLog
-} from "./chunk-ybacnpxd.js";
+} from "./chunk-sae7sqty.js";
 import {
+  backupPathFor,
   isAlive,
   readLock,
   withWorkspaceLock,
   workspaceRootOfRunDir,
+  writeAtomic,
   yamlScalar
-} from "./chunk-9kkm6q0t.js";
+} from "./chunk-qw73rdbr.js";
 import {
   noteDeprecations,
   openBlocks,
   parseQuestions
-} from "./chunk-3t91gvpp.js";
+} from "./chunk-nadqsr3w.js";
 import {
   listRunDirs,
-  parseYaml
-} from "./chunk-ztczwtj0.js";
+  parseYaml,
+  parseYamlRepairing
+} from "./chunk-a6rpj2cp.js";
 
 // src/core/statusline/runSnapshot.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 import { join as join2 } from "node:path";
 
 // src/core/run/RunStore.ts
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { basename, dirname, join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
 
 // src/core/run/emitRunYaml.ts
 function inlineList(values) {
@@ -121,7 +126,8 @@ function emitRunYaml(run) {
     lines.push(`triage: {split: ${yamlScalar(run.triage.split)}, depends_on: ${inlineList(run.triage.depends_on)}}`);
   }
   if (run.build !== undefined && run.build.epic_branch.length > 0) {
-    lines.push(`build: {epic_branch: ${inlineList(run.build.epic_branch)}}`);
+    const model = run.build.branch_model === undefined ? "" : `, branch_model: ${yamlScalar(run.build.branch_model)}`;
+    lines.push(`build: {epic_branch: ${inlineList(run.build.epic_branch)}${model}}`);
   }
   if (run.cancelled !== undefined) {
     lines.push(`cancelled: {by: ${yamlScalar(run.cancelled.by)}, at: ${yamlScalar(run.cancelled.at)}, ` + `note: ${yamlScalar(run.cancelled.note)}}`);
@@ -129,6 +135,9 @@ function emitRunYaml(run) {
   if (run.attended_by !== undefined) {
     lines.push(`attended_by: ${yamlScalar(run.attended_by)}`);
   }
+  if (run.keep_worktrees === true) {
+    lines.push("keep_worktrees: true");
+  }
   if (run.gates_policy !== undefined && Object.keys(run.gates_policy).length > 0) {
     lines.push(`gates_policy: ${gatesPolicy(run.gates_policy)}`);
   }
@@ -159,16 +168,22 @@ function emitBudgetYaml(budget) {
     `warn_at_pct: ${budget.warn_at_pct}`,
     `on_exceed: ${yamlScalar(budget.on_exceed)}`,
     ...budget.economy === DEFAULT_ECONOMY ? [] : [`economy: ${yamlScalar(budget.economy)}`],
+    ...budget.on_host_tokens_exceed === DEFAULT_ON_HOST_TOKENS_EXCEED ? [] : [`on_host_tokens_exceed: ${yamlScalar(budget.on_host_tokens_exceed)}`],
+    ...budget.ceiling_host_tokens === null ? [] : [`ceiling_host_tokens: ${tokens(budget.ceiling_host_tokens)}`],
     "phases:"
   ];
   for (const phase of budget.phases) {
     const economy = phase.economy === null ? "" : `, economy: ${yamlScalar(phase.economy)}`;
-    lines.push(`  - {id: ${yamlScalar(phase.id)}, ceiling_usd: ${money(phase.ceiling_usd)}, ` + `spent_usd: ${money(phase.spent_usd)}${economy}}`);
+    const hostTokens = phase.ceiling_host_tokens === null ? "" : `, ceiling_host_tokens: ${tokens(phase.ceiling_host_tokens)}`;
+    lines.push(`  - {id: ${yamlScalar(phase.id)}, ceiling_usd: ${money(phase.ceiling_usd)}, ` + `spent_usd: ${money(phase.spent_usd)}${economy}${hostTokens}}`);
   }
   return `${lines.join(`
 `)}
 `;
 }
+function tokens(value) {
+  return String(Math.trunc(value));
+}
 
 // src/core/run/RunStore.ts
 class RunStoreError extends Error {
@@ -190,8 +205,8 @@ class RunStore {
     const runPath = join(runDir, "run.yml");
     if (!existsSync(runPath))
       throw new RunStoreError(`no run.yml in ${runDir}`);
-    const doc = parseYaml(readFileSync(runPath, "utf8"));
-    const validation = validateRunFile(doc);
+    const run = parseStateFile(runPath);
+    const validation = validateRunFile(run.doc);
     noteDeprecations(runPath, validation);
     if (!validation.ok) {
       const first = validation.issues[0];
@@ -200,14 +215,30 @@ class RunStore {
     const budgetPath = join(runDir, "budget.yml");
     if (!existsSync(budgetPath))
       throw new RunStoreError(`no budget.yml in ${runDir}`);
-    const budgetDoc = parseYaml(readFileSync(budgetPath, "utf8"));
-    const budgetValidation = validateRunBudget(budgetDoc);
+    const budget = parseStateFile(budgetPath);
+    const budgetValidation = validateRunBudget(budget.doc);
     noteDeprecations(budgetPath, budgetValidation);
     if (!budgetValidation.ok) {
       const first = budgetValidation.issues[0];
       throw new RunStoreError(`invalid budget.yml (${budgetPath}): ${first?.path ?? ""} ${first?.message ?? "schema error"}`);
     }
-    return new RunStore(runDir, asRunFile(doc), asRunBudget(budgetDoc), EventLog.forRun(runDir));
+    const store = new RunStore(runDir, asRunFile(run.doc), asRunBudget(budget.doc), EventLog.forRun(runDir));
+    if (run.repaired || budget.repaired)
+      store.healOnDisk(run.repaired, budget.repaired);
+    return store;
+  }
+  healOnDisk(runRepaired, budgetRepaired) {
+    try {
+      withWorkspaceLock(workspaceRootOfRunDir(this.runDir), () => {
+        if (runRepaired)
+          writeAtomic(join(this.runDir, "run.yml"), emitRunYaml(this.current));
+        if (budgetRepaired)
+          writeAtomic(join(this.runDir, "budget.yml"), emitBudgetYaml(this.currentBudget));
+      });
+      const which = [runRepaired ? "run.yml" : "", budgetRepaired ? "budget.yml" : ""].filter((name) => name !== "").join(" and ");
+      process.stderr.write(`tldrx: ${this.runDir}: ${which} held text broken across lines by an emitter bug ` + "since fixed. It was repaired in memory and rewritten correctly; the version that was " + `on disk is beside it as .bak. Nothing else about the run was changed.
+`);
+    } catch {}
   }
   static find(root, runId) {
     const dir = listRunDirs(root).find((d) => basename(d) === runId);
@@ -309,7 +340,12 @@ class RunStore {
         ...onDisk,
         phases: this.currentBudget.phases.map((mine) => {
           const theirs = onDisk.phases.find((p) => p.id === mine.id);
-          return theirs === undefined ? mine : { ...mine, ceiling_usd: theirs.ceiling_usd };
+          return theirs === undefined ? mine : {
+            ...mine,
+            ceiling_usd: theirs.ceiling_usd,
+            ceiling_host_tokens: theirs.ceiling_host_tokens,
+            economy: theirs.economy
+          };
         })
       };
     } catch {
@@ -317,18 +353,21 @@ class RunStore {
     }
   }
 }
-function writeAtomic(path, content) {
-  const temp = `${path}.tmp-${String(process.pid)}`;
-  mkdirSync(dirname(path), { recursive: true });
+function parseStateFile(path) {
+  const text = readFileSync(path, "utf8");
   try {
-    writeFileSync(temp, content, "utf8");
-    renameSync(temp, path);
+    return parseYamlRepairing(text);
   } catch (error) {
-    try {
-      if (existsSync(temp))
-        rmSync(temp, { force: true });
-    } catch {}
-    throw error;
+    const backup = backupPathFor(path);
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new RunStoreError([
+      `${path} does not parse: ${detail}`,
+      "  every tldrx command on this run reads that file first, so all of them fail until it does",
+      existsSync(backup) ? `  the version the last save replaced is at ${backup} — recovery is MANUAL and tldrx ` + "will not do it for you:" + `
+    diff it, and if that version is the one you want, copy it back over ${basename(path)}` : `  there is no ${basename(backup)} beside it — this file has not been written since ` + "backups arrived, so there is no previous version to go back to",
+      "  a hand-edit is the other way out, and it is the only one that keeps work the backup predates"
+    ].join(`
+`));
   }
 }
 function rollUp(run) {
@@ -458,7 +497,7 @@ function fromTolerantRead(root) {
     openCount: open.length,
     autoGates: 0,
     staleStages: 0,
-    attendedByHost: false,
+    attendedByHost: isAttendedByHostView(view),
     source: "tolerant"
   };
 }
@@ -542,6 +581,9 @@ function stageAtCursor(run, cursor) {
   return null;
 }
 function waitingFor(run, runDir) {
+  if (run.cancelled !== undefined && run.cancelled !== null) {
+    return { kind: "cancelled", message: cancelledMessage(run.cancelled), questions: [] };
+  }
   const cursor = run.cursor;
   if (cursor === null) {
     return { kind: "blocked", message: "run.yml records no cursor, so nothing can say where it is", questions: [] };
@@ -612,6 +654,12 @@ function waitingFor(run, runDir) {
       };
   }
 }
+function cancelledMessage(cancelled) {
+  const by = cancelled.by.trim() === "" ? "someone" : cancelled.by.trim();
+  const when = cancelled.at.trim() === "" ? "" : ` at ${cancelled.at.trim()}`;
+  const note = cancelled.note.trim();
+  return `run cancelled by ${by}${when}${note === "" ? "" : ` — ${note}`}`;
+}
 function openQuestionIds2(path) {
   if (!existsSync5(path))
     return [];

package/dist/hooks/{chunk-afamdvyn.js → chunk-5556vjt5.js}

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