tldr-experts 0.28.0 → 0.29.0

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-kx45kt9n.js → chunk-ggjxes7m.js}

@@ -9,7 +9,7 @@ import {
   spentBasis,
   tallyOf,
   validateRunBudget
-} from "./chunk-xhd77h0p.js";
+} from "./chunk-w3d9kxcp.js";
 import {
   EventLog,
   OUTCOME_NOT_RECORDED,
@@ -22,12 +22,12 @@ import {
   isTerminal,
   stageAt,
   validateRunFile
-} from "./chunk-abswp1vt.js";
+} from "./chunk-t6gbx3jg.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";

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-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-abswp1vt.js → chunk-t6gbx3jg.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";

package/dist/hooks/{chunk-xhd77h0p.js → chunk-w3d9kxcp.js}

@@ -1,6 +1,6 @@
 import {
   STAGE_TUNING_DEFAULTS
-} from "./chunk-g7wz339n.js";
+} from "./chunk-g4d2v4jc.js";
 import {
   MAX_PLAN_STORIES,
   MAX_STORIES_PER_WAVE,
@@ -25,7 +25,7 @@ import {
   requireVersion,
   requireVersion1,
   result
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/hooks/lib/actor.ts
 function currentActor() {
@@ -737,6 +737,9 @@ var KINDS = {
   }
 };
 
+// src/core/build/git.ts
+var MARKER_SCAN_MAX_BYTES = 4 * 1024 * 1024;
+
 // src/core/build/fixlist.ts
 var MAX_FIXLIST_ROUNDS = STAGE_TUNING_DEFAULTS.fixlistRounds;
 var FINDING_KINDS = ["correctness", "security", "docs", "style"];
@@ -1245,12 +1248,194 @@ function wouldExceedHostTokens(budget, phaseId, spentTokens) {
   };
 }
 
-// src/core/budget/rebalance.ts
-var SETTLED = new Set(["done", "skipped"]);
+// src/core/budget/grant.ts
+function grantFor(budget, phaseId) {
+  if (phaseId !== undefined && phaseId !== null) {
+    const phase = budget.phases.find((p) => p.id === phaseId);
+    if (phase?.authorized_usd != null && budget.authorized_by !== null) {
+      return { usd: phase.authorized_usd, factId: budget.authorized_by, level: "phase" };
+    }
+  }
+  if (budget.authorized_usd === null || budget.authorized_by === null)
+    return null;
+  return { usd: budget.authorized_usd, factId: budget.authorized_by, level: "run" };
+}
+function wouldExceedGrant(budget, phaseId, resultingCeilingUsd) {
+  const grant = grantFor(budget, phaseId);
+  if (grant === null) {
+    return { exceeds: false, blocked: false, grant: null, sentence: null };
+  }
+  const exceeds = resultingCeilingUsd > grant.usd + 0.000000001;
+  const policy = budget.on_grant_exceed;
+  if (!exceeds)
+    return { exceeds: false, blocked: false, grant, sentence: null };
+  return {
+    exceeds: true,
+    blocked: policy === "block",
+    grant,
+    sentence: `$${resultingCeilingUsd.toFixed(2)} is above the $${grant.usd.toFixed(2)} authorized ` + `by ${grant.factId} (${grant.level} grant)` + (policy === "block" ? " — refused; raise the grant first, or record a new decision." : ".")
+  };
+}
+
+// src/core/budget/raiseBudget.ts
+class BudgetRaiseError extends Error {
+}
+var MIN_RAISE_USD = 0.01;
+var MAX_RAISE_USD = 1000;
+function raiseBudget(budget, request) {
+  const amount = round5(request.amountUsd);
+  if (!Number.isFinite(amount) || amount < MIN_RAISE_USD) {
+    throw new BudgetRaiseError(`the amount must be at least ${money(MIN_RAISE_USD)}, got ${money(request.amountUsd)}`);
+  }
+  if (amount > MAX_RAISE_USD) {
+    throw new BudgetRaiseError(`${money(amount)} exceeds the ${money(MAX_RAISE_USD)} cap for a single raise`);
+  }
+  const target = budget.phases.find((p) => p.id === request.phaseId);
+  if (target === undefined) {
+    throw new BudgetRaiseError(`no phase \`${request.phaseId}\` in budget.yml — it has ${budget.phases.map((p) => p.id).join(", ")}`);
+  }
+  const takeFrom = request.takeFrom ?? null;
+  if (takeFrom !== null && takeFrom === request.phaseId) {
+    throw new BudgetRaiseError(`--take-from ${takeFrom} is the same phase — that moves nothing`);
+  }
+  let donor = null;
+  if (takeFrom !== null) {
+    donor = budget.phases.find((p) => p.id === takeFrom) ?? null;
+    if (donor === null) {
+      throw new BudgetRaiseError(`no phase \`${takeFrom}\` in budget.yml — it has ${budget.phases.map((p) => p.id).join(", ")}`);
+    }
+    const left = round5(donor.ceiling_usd - donor.spent_usd);
+    if (amount > left) {
+      throw new BudgetRaiseError(`${takeFrom} has only ${money(left)} unspent of its ${money(donor.ceiling_usd)} ceiling — ` + `taking ${money(amount)} would put its ceiling below what it has already spent`);
+    }
+  }
+  const phases = budget.phases.map((phase) => {
+    if (phase.id === request.phaseId)
+      return { ...phase, ceiling_usd: round5(phase.ceiling_usd + amount) };
+    if (donor !== null && phase.id === donor.id)
+      return { ...phase, ceiling_usd: round5(phase.ceiling_usd - amount) };
+    return phase;
+  });
+  const sum = round5(phases.reduce((total, p) => total + p.ceiling_usd, 0));
+  const runCeiling = sum > budget.ceiling_usd ? sum : budget.ceiling_usd;
+  const next = { ...budget, ceiling_usd: runCeiling, phases };
+  if (round5(totalSpent(next)) > runCeiling) {
+    throw new BudgetRaiseError("the run has already spent more than the resulting ceiling — raise the run ceiling first");
+  }
+  return {
+    budget: next,
+    phaseId: request.phaseId,
+    amountUsd: amount,
+    takeFrom,
+    phaseCeilingBefore: target.ceiling_usd,
+    phaseCeilingAfter: round5(target.ceiling_usd + amount),
+    takeFromCeilingBefore: donor === null ? null : donor.ceiling_usd,
+    takeFromCeilingAfter: donor === null ? null : round5(donor.ceiling_usd - amount),
+    runCeilingBefore: budget.ceiling_usd,
+    runCeilingAfter: runCeiling,
+    runCeilingGrew: runCeiling > budget.ceiling_usd
+  };
+}
+function raiseGrantVerdict(budget, outcome) {
+  const phaseGrant = grantFor(budget, outcome.phaseId);
+  return phaseGrant !== null && phaseGrant.level === "phase" ? wouldExceedGrant(budget, outcome.phaseId, outcome.phaseCeilingAfter) : wouldExceedGrant(budget, null, outcome.runCeilingAfter);
+}
+function money(amount) {
+  return `$${amount.toFixed(2)}`;
+}
+function round5(n) {
+  return Math.round(n * 100) / 100;
+}
 
 // src/core/budget/budgetView.ts
 function raiseCommand(runId, phaseId, amountUsd) {
   return `tldrx budget raise ${phaseId} ${amountUsd.toFixed(2)} --run ${runId}`;
 }
 
-export { currentActor, nowRfc3339, spentBasis, tallyOf, DEFAULT_ON_HOST_TOKENS_EXCEED, DEFAULT_ON_GRANT_EXCEED, DEFAULT_ECONOMY, economyFor, isHostTokens, validateRunBudget, asRunBudget, expertsDir, loadExperts, readExpertDomain, pathsIntersect, stackExpertNames, WAVES_FILE, BUILD_PHASE2 as BUILD_PHASE, shortBy, remainingWork, wouldExceed, wouldExceedHostTokens, raiseCommand };
+// src/core/budget/rebalance.ts
+var REBALANCE_SOURCE = "run auto --rebalance-finished";
+var SETTLED = new Set(["done", "skipped"]);
+function planRebalance(budget, run, targetPhaseId, shortUsd) {
+  const donors = [];
+  const excluded = [];
+  for (const phase of budget.phases) {
+    if (phase.id === targetPhaseId)
+      continue;
+    const reason = notADonor(budget, run, phase.id);
+    if (reason !== null) {
+      excluded.push({ phaseId: phase.id, reason });
+      continue;
+    }
+    const unspent = round6(phase.ceiling_usd - phase.spent_usd);
+    if (unspent < 0.01) {
+      excluded.push({ phaseId: phase.id, reason: `finished with no unspent ceiling ($${phase.spent_usd.toFixed(2)} of $${phase.ceiling_usd.toFixed(2)})` });
+      continue;
+    }
+    donors.push({ phaseId: phase.id, unspentUsd: unspent });
+  }
+  const short = round6(shortUsd);
+  const finishedUnspentUsd = round6(donors.reduce((sum, d) => sum + d.unspentUsd, 0));
+  const uncoveredUsd = round6(Math.max(0, short - finishedUnspentUsd));
+  const moves = [];
+  if (uncoveredUsd === 0 && short > 0) {
+    let left = short;
+    for (const donor of donors) {
+      if (left <= 0)
+        break;
+      const take = round6(Math.min(donor.unspentUsd, left));
+      moves.push({ takeFrom: donor.phaseId, amountUsd: take });
+      left = round6(left - take);
+    }
+  }
+  return { targetPhaseId, shortUsd: short, donors, excluded, finishedUnspentUsd, moves, uncoveredUsd };
+}
+function applyRebalance(budget, plan) {
+  let current = budget;
+  const outcomes = [];
+  for (const move of plan.moves) {
+    const outcome = raiseBudget(current, { phaseId: plan.targetPhaseId, amountUsd: move.amountUsd, takeFrom: move.takeFrom });
+    outcomes.push(outcome);
+    current = outcome.budget;
+  }
+  return { budget: current, outcomes };
+}
+function describeRebalance(plan) {
+  if (plan.donors.length === 0) {
+    return `no finished phase holds unspent ceiling` + (plan.excluded.length === 0 ? "" : ` (${plan.excluded.map((e) => `${e.phaseId}: ${e.reason}`).join("; ")})`);
+  }
+  const held = plan.donors.map((d) => `${d.phaseId} $${d.unspentUsd.toFixed(2)}`).join(", ");
+  return `finished phase(s) hold $${plan.finishedUnspentUsd.toFixed(2)} unspent (${held})`;
+}
+function unfinishedReason(run, phaseId) {
+  const phase = run.phases.find((p) => p.id === phaseId);
+  if (phase === undefined || phase.stages.length === 0)
+    return null;
+  const open = phase.stages.filter((s) => !SETTLED.has(s.status));
+  if (open.length > 0) {
+    return `not finished — ${open.map((s) => `${s.id} is ${s.status}`).join(", ")}`;
+  }
+  const stale = phase.stages.filter((s) => s.stale === true);
+  if (stale.length > 0)
+    return `not finished — ${stale.map((s) => s.id).join(", ")} is stale and will run again`;
+  return null;
+}
+function notADonor(budget, run, phaseId) {
+  const phase = run.phases.find((p) => p.id === phaseId);
+  if (phase === undefined || phase.stages.length === 0)
+    return "no stage of it in run.yml, so nothing proves it finished";
+  const unfinished = unfinishedReason(run, phaseId);
+  if (unfinished !== null)
+    return unfinished;
+  if (economyFor(budget, phaseId) !== "metered-usd")
+    return "priced in host-tokens, which are not dollars";
+  const unmetered = tallyOf(phase.stages.flatMap((s) => s.tasks)).unmetered;
+  if (unmetered > 0) {
+    return `${String(unmetered)} unmetered turn(s), so its spend is a lower bound and its unspent figure is not a proof`;
+  }
+  return null;
+}
+function round6(n) {
+  return Math.round(n * 100) / 100;
+}
+
+export { currentActor, nowRfc3339, spentBasis, tallyOf, DEFAULT_ON_HOST_TOKENS_EXCEED, DEFAULT_ON_GRANT_EXCEED, DEFAULT_ECONOMY, economyFor, isHostTokens, validateRunBudget, asRunBudget, expertsDir, loadExperts, readExpertDomain, pathsIntersect, stackExpertNames, WAVES_FILE, BUILD_PHASE2 as BUILD_PHASE, shortBy, remainingWork, wouldExceed, wouldExceedHostTokens, raiseGrantVerdict, REBALANCE_SOURCE, planRebalance, applyRebalance, describeRebalance, raiseCommand };

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() {

package/dist/hooks/claim-sources.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   wouldBeContent
-} from "./chunk-zrwq6r7k.js";
+} from "./chunk-7xascvee.js";
 import {
   claimSourcesDeny,
   claimSourcesEmptySectionDeny,
   claimSourcesMalformedDeny,
   claimSourcesUnresolvedDeny
-} from "./chunk-q3d4xdhb.js";
+} from "./chunk-mg3aj0sa.js";
 import {
   allow,
   deny,
@@ -16,8 +16,8 @@ import {
   postContext,
   readPayload,
   runHook
-} from "./chunk-tna1bz8r.js";
-import"./chunk-khjm356r.js";
+} from "./chunk-pne7afnf.js";
+import"./chunk-z9hv47ps.js";
 import {
   isHandoff,
   loadWorkspace,
@@ -25,7 +25,7 @@ import {
   toSrcContext,
   validateCitations,
   validateHandoff
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.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-zrwq6r7k.js";
+} from "./chunk-7xascvee.js";
 import {
   dodGateDeny,
   dodGateInternalErrorDeny,
   dodGateMissingBlockDeny,
   dodGateRefusedCommandDeny
-} from "./chunk-q3d4xdhb.js";
+} from "./chunk-mg3aj0sa.js";
 import {
   allow,
   deny,
@@ -15,16 +15,15 @@ import {
   filePathOf,
   isWriteOrEdit,
   readPayload
-} from "./chunk-tna1bz8r.js";
-import"./chunk-khjm356r.js";
+} from "./chunk-pne7afnf.js";
+import"./chunk-z9hv47ps.js";
+import {
+  loadRunView
+} from "./chunk-0d4csx4s.js";
 import {
   DEFAULT_TIMEOUT_S,
   buildStageDefaults
-} from "./chunk-veffvzw5.js";
-import {
-  loadRunView
-} from "./chunk-hws2gnxj.js";
-import"./chunk-g7wz339n.js";
+} from "./chunk-g4d2v4jc.js";
 import {
   DodCommandRefused,
   loadWorkspace,
@@ -32,7 +31,7 @@ import {
   readStory,
   repoPath,
   runDodCommand
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.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-zrwq6r7k.js";
+} from "./chunk-7xascvee.js";
 import {
   noReAskDeny
-} from "./chunk-q3d4xdhb.js";
+} from "./chunk-mg3aj0sa.js";
 import {
   FactsStore
-} from "./chunk-48ctk154.js";
+} from "./chunk-gr83pq7x.js";
 import {
   allow,
   deny,
@@ -15,17 +15,17 @@ import {
   isWriteOrEdit,
   readPayload,
   runHook
-} from "./chunk-tna1bz8r.js";
-import"./chunk-khjm356r.js";
-import"./chunk-zvxgdssb.js";
+} from "./chunk-pne7afnf.js";
+import"./chunk-z9hv47ps.js";
+import"./chunk-857jhjmb.js";
 import {
   openBlocks,
   parseQuestions
-} from "./chunk-khy21x6e.js";
+} from "./chunk-yanmz0vz.js";
 import {
   factsPath,
   locateWork
-} from "./chunk-f6t1xc3f.js";
+} from "./chunk-qmp5p77c.js";
 
 // src/hooks/no-reask.ts
 import { existsSync, readFileSync } from "node:fs";