@open-tomato/rafa 0.40.0 → 0.41.0

package/dist/{index-j7kjj0dd.js → index-snf04fpt.js}

@@ -39,6 +39,7 @@ import {
   NO_NEXT_STEP,
   NoSessionRefusal,
   ORIGIN_FIELD,
+  PLACEHOLDER_REASON,
   PREVIOUS_COPY_WARN_ABOVE,
   PROJECT_SCOPE_FIX,
   PROVENANCE_FIELD,
@@ -93,6 +94,7 @@ import {
   branchName,
   buildReport,
   buildSettle,
+  buildVerifyPrompt,
   bundledAgentsDirectory,
   byName,
   cancelMoveReason,
@@ -134,6 +136,7 @@ import {
   createPlanDirNames,
   createPlanRefsVerifier,
   createStartPreflightClaim,
+  criteriaToAsk,
   crossRepositoryRefusal,
   defaultCleanupSeams,
   developmentApplied,
@@ -150,9 +153,10 @@ import {
   epicTickSentence,
   estimateEta,
   etaLine,
-  eventsFilePath,
+  eventsFileOf,
   expectTwoArguments,
   failingRows,
+  fenceFor,
   fetchClaimBranches,
   findReadinessGaps,
   fingerprintText,
@@ -235,6 +239,7 @@ import {
   parseRoadmapBody,
   parseSemanticVersion,
   parseTreePaths,
+  parseVerifyPlan,
   parseWorkingTree,
   parseWorktrees,
   pathDirectories,
@@ -273,6 +278,7 @@ import {
   readEpicDependents,
   readEpicProblems,
   readEpics,
+  readEventsFrom,
   readGuard,
   readHomeAfterLoop,
   readIssueFacts,
@@ -303,6 +309,7 @@ import {
   readTextFlag,
   readTrees,
   readTrendInputs,
+  readVerifyPrompt,
   readWaiting,
   ready_default,
   receiptProblem,
@@ -320,6 +327,7 @@ import {
   renderDependentComment,
   renderDoctorEffortSync,
   renderDoctorRefs,
+  renderEpicBody,
   renderHorizonComment,
   renderMoveComment,
   renderParkedPullRequestComment,
@@ -367,6 +375,7 @@ import {
   skillItem,
   skippedFieldWarning,
   sourceItem,
+  splitCriteria,
   stackPaths,
   stacksFromEccSkillName,
   stageOf,
@@ -400,7 +409,7 @@ import {
   worktreesHolding,
   writeSession,
   writeShippedFile
-} from "./index-zcbj07aq.js";
+} from "./index-wjsarzf5.js";
 import {
   PROBE_TIMEOUT_MS,
   loadPlanPrerequisites,
@@ -412,7 +421,7 @@ import {
   runPreflight,
   splitBlockerComment,
   trackerPathFor
-} from "./index-krpmxpkh.js";
+} from "./index-zg0qsb5b.js";
 import {
   ACTION_HEADING,
   CAUSE_HEADING,
@@ -523,7 +532,7 @@ import {
   versionLine,
   writeFrontmatter,
   writePositionFile
-} from "./index-8veaj0t9.js";
+} from "./index-cd0wzc12.js";
 import {
   CONFIG_DEFAULTS,
   CONFIG_FILE,
@@ -542,7 +551,7 @@ import {
   readItemBytes,
   readRafaBlocks,
   resolveTiers
-} from "./index-334y39tn.js";
+} from "./index-3jpz9nr3.js";
 import {
   promotable
 } from "./index-d6d0942q.js";
@@ -2168,7 +2177,7 @@ import { join as join4, relative as relative2 } from "path";
 var SEARCH_PROMPT_PREFIX = "# Inventory search instructions";
 var SEARCH_BLOCK_FENCE = "rafa:search";
 var MIN_FENCE_LENGTH = 3;
-function fenceFor(text) {
+function fenceFor2(text) {
   const longestRun = Math.max(0, ...(text.match(/`+/g) ?? []).map((run) => run.length));
   return "`".repeat(Math.max(MIN_FENCE_LENGTH, longestRun + 1));
 }
@@ -2184,7 +2193,7 @@ var EXAMPLE_BLOCK = [
 ];
 function renderSearchPrompt(input) {
   const plural2 = `${input.kind}s`;
-  const fence = fenceFor(input.question);
+  const fence = fenceFor2(input.question);
   const candidates = input.candidates.map((candidate) => `- ${candidate.name}: \`${candidate.file}\``);
   return [
     SEARCH_PROMPT_PREFIX,
@@ -8820,7 +8829,7 @@ function optionalString(record, key) {
 }
 
 // src/commands/stretch/item.ts
-import { closeSync as closeSync2, mkdirSync as mkdirSync6, openSync as openSync2, readdirSync as readdirSync3, readFileSync as readFileSync15, statSync as statSync6 } from "fs";
+import { closeSync, mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync3, readFileSync as readFileSync15, statSync as statSync6 } from "fs";
 import { dirname as dirname6, join as join20, posix } from "path";
 
 // src/stretch/operators.ts
@@ -8995,83 +9004,6 @@ function lineText(argv) {
 // src/commands/stretch/item-merge.ts
 import { readFileSync as readFileSync14 } from "fs";
 
-// src/loop/events-file.ts
-import { closeSync, fstatSync, openSync, readSync } from "fs";
-var NEWLINE = 10;
-function eventsFileOf(root, record) {
-  return eventsFilePath(root, record.sessionId);
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function parseEventLine(line) {
-  let value;
-  try {
-    value = JSON.parse(line);
-  } catch {
-    return null;
-  }
-  if (!isPlainObject(value))
-    return null;
-  const { name: name2, summary, data, ts } = value;
-  if (typeof name2 !== "string" || typeof summary !== "string" || typeof ts !== "string")
-    return null;
-  if (!isPlainObject(data))
-    return null;
-  return Object.freeze({ name: name2, summary, data: Object.freeze({ ...data }), ts });
-}
-function bytesFrom(fd, offset) {
-  const length = fstatSync(fd).size - offset;
-  if (length <= 0)
-    return null;
-  const buffer = Buffer.alloc(length);
-  let filled = 0;
-  while (filled < length) {
-    const read = readSync(fd, buffer, filled, length - filled, offset + filled);
-    if (read === 0)
-      break;
-    filled += read;
-  }
-  return buffer.subarray(0, filled);
-}
-function readTail(file, offset) {
-  let fd;
-  try {
-    fd = openSync(file, "r");
-  } catch (error) {
-    if (errorCode(error) === "ENOENT")
-      return "absent";
-    throw error;
-  }
-  try {
-    return bytesFrom(fd, offset);
-  } finally {
-    closeSync(fd);
-  }
-}
-function readEventsFrom(file, offset) {
-  if (!Number.isSafeInteger(offset) || offset < 0) {
-    throw new RangeError(`events file: unusable offset ${String(offset)}`);
-  }
-  const tail = readTail(file, offset);
-  if (tail === "absent")
-    return Object.freeze({ kind: "absent" });
-  const end = tail?.lastIndexOf(NEWLINE) ?? -1;
-  if (tail === null || end < 0) {
-    return Object.freeze({ kind: "read", events: Object.freeze([]), malformed: 0, offset });
-  }
-  const lines = tail.subarray(0, end).toString("utf8").split(`
-`);
-  const parsed = lines.map(parseEventLine);
-  const events = parsed.filter((event) => event !== null);
-  return Object.freeze({
-    kind: "read",
-    events: Object.freeze(events),
-    malformed: parsed.length - events.length,
-    offset: offset + end + 1
-  });
-}
-
 // src/stretch/items.ts
 import { appendFileSync, mkdirSync as mkdirSync4, readFileSync as readFileSync11 } from "fs";
 import { dirname as dirname3, join as join17 } from "path";
@@ -10194,7 +10126,7 @@ async function spawnOnTerminal(argv, cwd, env) {
 function spawnDetached(argv, cwd, env, logPath) {
   let fd;
   try {
-    fd = openSync2(logPath, "a");
+    fd = openSync(logPath, "a");
   } catch {
     return null;
   }
@@ -10205,7 +10137,7 @@ function spawnDetached(argv, cwd, env, logPath) {
   } catch {
     return null;
   } finally {
-    closeSync2(fd);
+    closeSync(fd);
   }
 }
 function defaultStretchItemSeams() {
@@ -13159,48 +13091,7 @@ var cancel_default = createEpicCancelCommand();
 
 // src/commands/epic/close.ts
 import { randomUUID as randomUUID3 } from "crypto";
-import { join as join28 } from "path";
-
-// src/board/epic-template.ts
-import { existsSync as existsSync8, readFileSync as readFileSync18 } from "fs";
-import { dirname as dirname8, join as join25 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var MODULE_DIR2 = dirname8(fileURLToPath2(import.meta.url));
-var EPIC_TEMPLATE_FILE = "epic.md";
-var CRITERIA_PLACEHOLDERS = Object.freeze([
-  "- Placeholder: one line per thing that makes this epic finished," + " written so a check against main can tell whether it holds."
-]);
-var PLACEHOLDER_REASON = "the line is still the epic template's placeholder, so there is nothing to check";
-function epicTemplateSource(moduleDir = MODULE_DIR2) {
-  return join25(moduleDir, TEMPLATES_DIRNAME, EPIC_TEMPLATE_FILE);
-}
-function readEpicTemplate(moduleDir = MODULE_DIR2) {
-  const source = epicTemplateSource(moduleDir);
-  if (!existsSync8(source)) {
-    throw new Error(`epic template: the epic issue template is missing: no file at ${source}`);
-  }
-  return readFileSync18(source, "utf8");
-}
-function placeholderCriteria(criteria) {
-  if (criteria === null)
-    return Object.freeze([]);
-  const held = criteria.split(/\r\n?|\n/u).map((line) => line.trim()).filter((line) => CRITERIA_PLACEHOLDERS.includes(line));
-  return Object.freeze(held.map((text) => Object.freeze({ text, reason: PLACEHOLDER_REASON })));
-}
-function renderEpicBody(template = readEpicTemplate()) {
-  const read = readEpicBody(template);
-  if (read.criteria === null) {
-    throw new Error("epic template: the template carries no acceptance criteria section with a placeholder under it");
-  }
-  const missing = CRITERIA_PLACEHOLDERS.length - placeholderCriteria(read.criteria).length;
-  if (missing > 0) {
-    throw new Error(`epic template: the acceptance criteria section has lost ${String(missing)} of its placeholder lines`);
-  }
-  if (read.lines.length > 0) {
-    throw new Error(`epic template: the template carries ${String(read.lines.length)} checklist lines; a new epic has none`);
-  }
-  return template;
-}
+import { join as join26 } from "path";
 
 // src/effort/epic-cost.ts
 var MEMBERSHIP_NOTE = "cost follows membership at close time: it counts the sessions of the issues in the epic now, " + "so work on an issue moved out is not counted and work on an issue moved in is";
@@ -13269,211 +13160,9 @@ function renderEpicCost(cost, estimate) {
   ];
 }
 
-// src/epic/verify-plan.ts
-import { existsSync as existsSync9, readFileSync as readFileSync19 } from "fs";
-import { dirname as dirname9, join as join26 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var MODULE_DIR3 = dirname9(fileURLToPath3(import.meta.url));
-var VERIFY_PROMPT_FILE = "epic-verify-prompt.md";
-var VERIFY_BLOCK_FENCE = "rafa:verify";
-var VERIFY_PROMPT_SLOTS = ["EPIC_NUMBER", "EPIC_TITLE", "CRITERIA"];
-var SKIPPED_REASON = "the verification plan did not answer it";
-var FENCE2 = /^\s*(?:`{3,}|~{3,})/u;
-var LIST_ITEM = /^( {0,3})(?:[-*+]|\d{1,9}[.)])(?:\s|$)/u;
-var INDENTED = /^\s/u;
-var MIN_FENCE_LENGTH2 = 3;
-var VERIFY_KIND = VERIFY_BLOCK_FENCE.slice("rafa:".length);
-var SLOT_PATTERN = new RegExp(`\\{(${VERIFY_PROMPT_SLOTS.join("|")})\\}`, "gu");
-var ANSWER_KEYS = ["check", "uncheckable"];
-function opensCriterion(text, state) {
-  const item = LIST_ITEM.exec(text);
-  if (item !== null) {
-    const indent = item[1]?.length ?? 0;
-    state.topIndent ??= indent;
-    return indent <= state.topIndent;
-  }
-  return state.afterBlank && !INDENTED.test(text);
-}
-function splitCriteria(criteria) {
-  if (criteria === null)
-    return Object.freeze([]);
-  const gathered = [];
-  const state = { fenced: false, afterBlank: false, topIndent: null };
-  for (const text of criteria.split(/\r\n?|\n/u)) {
-    const insideFence = state.fenced;
-    if (FENCE2.test(text))
-      state.fenced = !state.fenced;
-    if (!insideFence && text.trim() === "") {
-      state.afterBlank = true;
-      gathered.at(-1)?.push(text);
-      continue;
-    }
-    const current = gathered.at(-1);
-    const opens = !insideFence && opensCriterion(text, state);
-    if (current === undefined || opens) {
-      gathered.push([text]);
-    } else {
-      current.push(text);
-    }
-    state.afterBlank = false;
-  }
-  const numbered = gathered.map((lines, index) => {
-    const text = lines.join(`
-`).trim();
-    return Object.freeze({ number: index + 1, text, placeholder: CRITERIA_PLACEHOLDERS.includes(text) });
-  });
-  return Object.freeze(numbered);
-}
-function criteriaToAsk(criteria) {
-  return Object.freeze(criteria.filter((criterion) => !criterion.placeholder));
-}
-function verifyPromptCandidates(moduleDir = MODULE_DIR3) {
-  return [join26(moduleDir, VERIFY_PROMPT_FILE), join26(dirname9(moduleDir), VERIFY_PROMPT_FILE)];
-}
-function readVerifyPrompt(moduleDir = MODULE_DIR3) {
-  const candidates = verifyPromptCandidates(moduleDir);
-  const found = candidates.find((candidate) => existsSync9(candidate));
-  if (found === undefined) {
-    throw new Error(`epic verify prompt: the verification prompt is missing: no file at ${candidates.join(" or ")}`);
-  }
-  return readFileSync19(found, "utf8");
-}
-function fenceFor2(text) {
-  const longestRun = Math.max(0, ...(text.match(/`+/gu) ?? []).map((run) => run.length));
-  return "`".repeat(Math.max(MIN_FENCE_LENGTH2, longestRun + 1));
-}
-function renderCriterion(criterion) {
-  const fence = fenceFor2(criterion.text);
-  return [`### Criterion ${String(criterion.number)}`, "", `${fence}text`, criterion.text, fence].join(`
-`);
-}
-function buildVerifyPrompt(template, input) {
-  const missing = VERIFY_PROMPT_SLOTS.find((slot) => !template.includes(`{${slot}}`));
-  if (missing !== undefined) {
-    throw new Error(`epic verify prompt: the template carries no {${missing}} slot`);
-  }
-  const values = {
-    EPIC_NUMBER: String(input.epic),
-    EPIC_TITLE: input.title.replace(/\s+/gu, " ").trim(),
-    CRITERIA: criteriaToAsk(input.criteria).map(renderCriterion).join(`
-
-`)
-  };
-  return template.replace(SLOT_PATTERN, (_whole, slot) => values[slot]);
-}
-function isMapping3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function fieldOf2(mapping, key) {
-  return Object.entries(mapping).find(([own]) => own === key)?.[1];
-}
-function describeValue3(value) {
-  if (typeof value === "string")
-    return JSON.stringify(value);
-  if (value === null || value === undefined)
-    return "nothing";
-  if (Array.isArray(value))
-    return "a list";
-  if (typeof value === "object")
-    return "a mapping";
-  return `the ${typeof value} ${String(value)}`;
-}
-function messageOf4(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function absent2(reason, block, text) {
-  return Object.freeze({ present: false, reason, block, text });
-}
-function readEntry(item, field, asked) {
-  if (!isMapping3(item))
-    return { problem: `${field} is ${describeValue3(item)}, not a mapping`, number: null };
-  const number = fieldOf2(item, "criterion");
-  if (typeof number !== "number" || !Number.isInteger(number) || number < 1) {
-    return { problem: `${field}.criterion is ${describeValue3(number)}, not a criterion number from 1`, number: null };
-  }
-  if (!asked.has(number)) {
-    return { problem: `${field}.criterion ${String(number)} is no criterion the plan was asked about`, number: null };
-  }
-  const carried = ANSWER_KEYS.filter((key2) => fieldOf2(item, key2) !== undefined);
-  const [key] = carried;
-  if (carried.length !== 1 || key === undefined) {
-    const count = carried.length === 0 ? "neither" : "both";
-    return { problem: `${field} carries ${count} check and uncheckable`, number };
-  }
-  const value = fieldOf2(item, key);
-  if (typeof value !== "string" || value.trim() === "") {
-    return { problem: `${field}.${key} is ${describeValue3(value)}, not a non-blank string`, number };
-  }
-  return { answer: { number, key, text: value.trim() } };
-}
-function verdictFor(criterion, answer, problem) {
-  if (criterion.placeholder) {
-    return { kind: "uncheckable", criterion, reason: PLACEHOLDER_REASON, source: "placeholder" };
-  }
-  if (answer?.key === "check")
-    return { kind: "check", criterion, check: answer.text };
-  if (answer?.key === "uncheckable")
-    return { kind: "uncheckable", criterion, reason: answer.text, source: "answer" };
-  const reason = problem === undefined ? SKIPPED_REASON : `${SKIPPED_REASON}: its entry was dropped, as ${problem}`;
-  return { kind: "uncheckable", criterion, reason, source: "skipped" };
-}
-function readVerdicts(items, criteria, block) {
-  const asked = new Set(criteriaToAsk(criteria).map((criterion) => criterion.number));
-  const answers = new Map;
-  const problems = new Map;
-  const issues = [];
-  for (const [index, item] of items.entries()) {
-    const field = `criteria[${String(index)}]`;
-    const reading = readEntry(item, field, asked);
-    if ("problem" in reading) {
-      issues.push(Object.freeze({ field, text: `${reading.problem}; dropped` }));
-      if (reading.number !== null && !problems.has(reading.number))
-        problems.set(reading.number, reading.problem);
-      continue;
-    }
-    if (answers.has(reading.answer.number)) {
-      const text = `${field} answers criterion ${String(reading.answer.number)} a second time; dropped`;
-      issues.push(Object.freeze({ field, text }));
-      continue;
-    }
-    answers.set(reading.answer.number, reading.answer);
-  }
-  const verdicts = criteria.map((criterion) => Object.freeze(verdictFor(criterion, answers.get(criterion.number), problems.get(criterion.number))));
-  return Object.freeze({
-    present: true,
-    verdicts: Object.freeze(verdicts),
-    block,
-    issues: Object.freeze(issues)
-  });
-}
-function parseVerifyPlan(output, criteria) {
-  const block = readRafaBlocks(output).filter((each) => each.kind === VERIFY_KIND).at(-1);
-  if (block === undefined) {
-    return absent2("no-block", null, `the session output holds no ${VERIFY_BLOCK_FENCE} block`);
-  }
-  const at = `${VERIFY_BLOCK_FENCE} block at line ${String(block.span.first)}`;
-  if (!block.closed) {
-    return absent2("unclosed-block", block, `${at} is never closed, so it is not read`);
-  }
-  let document;
-  try {
-    document = Bun.YAML.parse(block.body);
-  } catch (error) {
-    return absent2("malformed-block", block, `${at} is not valid YAML (${messageOf4(error)})`);
-  }
-  if (!isMapping3(document)) {
-    return absent2("malformed-block", block, `${at} holds ${describeValue3(document)}, not a mapping`);
-  }
-  const listed2 = fieldOf2(document, "criteria") ?? [];
-  if (!Array.isArray(listed2)) {
-    return absent2("malformed-block", block, `${at} has criteria ${describeValue3(listed2)}, not a list`);
-  }
-  return readVerdicts(listed2, criteria, block);
-}
-
 // src/epic/verify-run.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { join as join27 } from "path";
+import { join as join25 } from "path";
 var CHECK_TOOLS = ["Read", "Grep", "Glob", "Bash"];
 var DEFAULT_VERIFY_REMOTE = "origin";
 var CHECK_PROMPT_PREFIX = "# Epic acceptance check instructions";
@@ -13482,7 +13171,7 @@ var CHECK_RESULTS = ["pass", "fail"];
 var WORKTREE_PREFIX = "epic-";
 var VERDICT_KIND = VERDICT_BLOCK_FENCE.slice("rafa:".length);
 function verifyWorktreePath(home, epic) {
-  return join27(home, WORKTREES_SUBDIR, `${WORKTREE_PREFIX}${String(epic)}`);
+  return join25(home, WORKTREES_SUBDIR, `${WORKTREE_PREFIX}${String(epic)}`);
 }
 function fetchStep(remote) {
   return { id: "fetch", args: ["fetch", remote] };
@@ -13513,7 +13202,7 @@ function checkFlags(sessionId) {
   return [SESSION_ID_FLAG, sessionId, "--tools", CHECK_TOOLS.join(",")];
 }
 function renderCheckPrompt(input) {
-  const fence = fenceFor2(input.check);
+  const fence = fenceFor(input.check);
   return [
     CHECK_PROMPT_PREFIX,
     "",
@@ -13554,13 +13243,13 @@ function renderCheckPrompt(input) {
   ].join(`
 `);
 }
-function isMapping4(value) {
+function isMapping3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function fieldOf3(mapping, key) {
+function fieldOf2(mapping, key) {
   return Object.entries(mapping).find(([own]) => own === key)?.[1];
 }
-function describeValue4(value) {
+function describeValue3(value) {
   if (typeof value === "string")
     return JSON.stringify(value);
   if (value === null || value === undefined)
@@ -13574,7 +13263,7 @@ function describeValue4(value) {
 function isResultWord(value) {
   return CHECK_RESULTS.some((word) => word === value);
 }
-function absent3(text, block) {
+function absent2(text, block) {
   return Object.freeze({ present: false, text, block });
 }
 function readVerdictBody(block, at) {
@@ -13582,29 +13271,29 @@ function readVerdictBody(block, at) {
   try {
     document = Bun.YAML.parse(block.body);
   } catch (error) {
-    return absent3(`${at} is not valid YAML (${messageOf(error)})`, block);
+    return absent2(`${at} is not valid YAML (${messageOf(error)})`, block);
   }
-  if (!isMapping4(document)) {
-    return absent3(`${at} holds ${describeValue4(document)}, not a mapping`, block);
+  if (!isMapping3(document)) {
+    return absent2(`${at} holds ${describeValue3(document)}, not a mapping`, block);
   }
-  const result2 = fieldOf3(document, "result");
+  const result2 = fieldOf2(document, "result");
   if (!isResultWord(result2)) {
-    return absent3(`${at} has result ${describeValue4(result2)}, not ${CHECK_RESULTS.join(" or ")}`, block);
+    return absent2(`${at} has result ${describeValue3(result2)}, not ${CHECK_RESULTS.join(" or ")}`, block);
   }
-  const evidence = fieldOf3(document, "evidence");
+  const evidence = fieldOf2(document, "evidence");
   if (typeof evidence !== "string" || evidence.trim() === "") {
-    return absent3(`${at} has evidence ${describeValue4(evidence)}, not a non-blank string`, block);
+    return absent2(`${at} has evidence ${describeValue3(evidence)}, not a non-blank string`, block);
   }
   return Object.freeze({ present: true, result: result2, evidence: evidence.trim(), block });
 }
 function parseCheckVerdict(output) {
   const block = readRafaBlocks(output).filter((each) => each.kind === VERDICT_KIND).at(-1);
   if (block === undefined) {
-    return absent3(`the session output holds no ${VERDICT_BLOCK_FENCE} block`, null);
+    return absent2(`the session output holds no ${VERDICT_BLOCK_FENCE} block`, null);
   }
   const at = `${VERDICT_BLOCK_FENCE} block at line ${String(block.span.first)}`;
   if (!block.closed)
-    return absent3(`${at} is never closed, so it is not read`, block);
+    return absent2(`${at} is never closed, so it is not read`, block);
   return readVerdictBody(block, at);
 }
 function readCheck(check, sessionId, session) {
@@ -13764,7 +13453,7 @@ async function planVerification(input) {
   return Object.freeze({ status: "planned", sessionId, verdicts: reading.verdicts, issues: reading.issues });
 }
 function closeTriageFile(root, epic) {
-  return join28(root, ".rafa", `epic-${String(epic)}-close`);
+  return join26(root, ".rafa", `epic-${String(epic)}-close`);
 }
 function failedCheckArtifact(epic, criterion) {
   return `epic ${ref7(epic)} acceptance criterion: ${oneLine3(criterion.text)}`;
@@ -14367,13 +14056,13 @@ function createEpicPromoteCommand(seams = {}) {
 var promote_default = createEpicPromoteCommand();
 
 // src/commands/init.ts
-import { existsSync as existsSync12, readFileSync as readFileSync23 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync21 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join32, relative as relative6, sep as sep3 } from "path";
+import { join as join30, relative as relative6, sep as sep3 } from "path";
 
 // src/agents/vendorable.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync20 } from "fs";
-import { isAbsolute as isAbsolute3, join as join29 } from "path";
+import { readdirSync as readdirSync4, readFileSync as readFileSync18 } from "fs";
+import { isAbsolute as isAbsolute3, join as join27 } from "path";
 function planFiles(dir) {
   let entries;
   try {
@@ -14385,7 +14074,7 @@ function planFiles(dir) {
 }
 function readText3(path) {
   try {
-    return readFileSync20(path, "utf8");
+    return readFileSync18(path, "utf8");
   } catch {
     return null;
   }
@@ -14395,7 +14084,7 @@ function rafaHolds(roster, name2) {
   return item?.holders.some((holder) => holder.source === "rafa") === true;
 }
 function vendorableAgents(scan) {
-  const dir = isAbsolute3(scan.planDir) ? scan.planDir : join29(scan.repoRoot, scan.planDir);
+  const dir = isAbsolute3(scan.planDir) ? scan.planDir : join27(scan.repoRoot, scan.planDir);
   const roots = {
     repoRoot: scan.repoRoot,
     home: scan.home,
@@ -14404,7 +14093,7 @@ function vendorableAgents(scan) {
   const roster = resolveAgentRoster(roots, scan.settings);
   const found = [];
   for (const file of planFiles(dir)) {
-    const path = join29(dir, file);
+    const path = join27(dir, file);
     const markdown = readText3(path);
     if (markdown === null)
       continue;
@@ -14430,13 +14119,13 @@ function vendorableAgentWarnings(agents, root) {
 
 // src/project/gitignore.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync10, mkdirSync as mkdirSync7, readFileSync as readFileSync21, writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname10, isAbsolute as isAbsolute4, join as join30 } from "path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync7, readFileSync as readFileSync19, writeFileSync as writeFileSync6 } from "fs";
+import { dirname as dirname8, isAbsolute as isAbsolute4, join as join28 } from "path";
 var GITIGNORE_FILE = ".gitignore";
 var DIGEST_NAME = "tracking.digest";
 var PRIVATE_TRIAGE = "triage/private";
 var CACHE_DIR = "cache";
-var TRACKING_DIGEST_FILE = join30(SCOPE_DIR, DIGEST_NAME);
+var TRACKING_DIGEST_FILE = join28(SCOPE_DIR, DIGEST_NAME);
 var BLOCK_BEGIN = "# >>> rafa tracking: rafa rewrites the lines up to the end marker";
 var BLOCK_END = "# <<< rafa tracking";
 var SUB_PATHS = [
@@ -14525,13 +14214,13 @@ function attempt2(file, failure3, act) {
   }
 }
 function readIfPresent2(file) {
-  if (!existsSync10(file))
+  if (!existsSync8(file))
     return null;
-  return attempt2(file, "cannot be read", () => readFileSync21(file, "utf8"));
+  return attempt2(file, "cannot be read", () => readFileSync19(file, "utf8"));
 }
 function writeTrackingGitignore(root, flags) {
   requireAbsolute(root);
-  const file = join30(root, GITIGNORE_FILE);
+  const file = join28(root, GITIGNORE_FILE);
   const text = readIfPresent2(file);
   const next = withTrackingBlock(text, flags, file);
   if (next === text)
@@ -14553,7 +14242,7 @@ function trackingDigest(flags) {
 }
 function exposureNotice(root) {
   return [
-    `tracking.all is true, so ${join30(root, GITIGNORE_FILE)} no longer ignores ${SCOPE_DIR}/` + " and a commit can carry what it holds, including:",
+    `tracking.all is true, so ${join28(root, GITIGNORE_FILE)} no longer ignores ${SCOPE_DIR}/` + " and a commit can carry what it holds, including:",
     "  - unpatched issues described in specs and plans",
     "  - effort rows with model names and token counts",
     "  - instincts that may quote error output",
@@ -14566,7 +14255,7 @@ function printWarning(message) {
 }
 function noticeTrackingChange(root, flags, print2 = printWarning) {
   requireAbsolute(root);
-  const digestFile = join30(root, TRACKING_DIGEST_FILE);
+  const digestFile = join28(root, TRACKING_DIGEST_FILE);
   const recorded = `${trackingDigest(flags)}
 `;
   if (readIfPresent2(digestFile) === recorded) {
@@ -14575,7 +14264,7 @@ function noticeTrackingChange(root, flags, print2 = printWarning) {
   if (flags.trackingAll)
     print2(exposureNotice(root));
   attempt2(digestFile, "cannot be written", () => {
-    mkdirSync7(dirname10(digestFile), { recursive: true });
+    mkdirSync7(dirname8(digestFile), { recursive: true });
     writeFileSync6(digestFile, recorded);
   });
   return { digestFile, changed: true, printed: flags.trackingAll };
@@ -14665,14 +14354,14 @@ async function promptForRoot(found, prompter, seams) {
 }
 
 // src/project/scaffold.ts
-import { existsSync as existsSync11, lstatSync, mkdirSync as mkdirSync8, statSync as statSync7, writeFileSync as writeFileSync8 } from "fs";
-import { join as join31 } from "path";
+import { existsSync as existsSync9, lstatSync, mkdirSync as mkdirSync8, statSync as statSync7, writeFileSync as writeFileSync8 } from "fs";
+import { join as join29 } from "path";
 
 // src/commands/init-release.ts
 import { writeFileSync as writeFileSync7 } from "fs";
 
 // src/release/setting.ts
-import { readFileSync as readFileSync22 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 var RELEASE_ENABLED_SETTING = "release.enabled";
 function releaseEnabledIn(text, path) {
   return parseConfigText(text, path).values.releaseEnabled ?? null;
@@ -14681,7 +14370,7 @@ function readReleaseSetting(root) {
   const path = configFilePath(root);
   let text;
   try {
-    text = readFileSync22(path, "utf8");
+    text = readFileSync20(path, "utf8");
   } catch (error) {
     return { enabled: null, text: "", problem: `${path} could not be read: ${messageOf(error)}` };
   }
@@ -14900,6 +14589,13 @@ var CONFIG_SETTINGS_LINES = Object.freeze([
   "# loop:",
   `#   settingSources: ${CONFIG_DEFAULTS.settingSources.join(",")}   # a comma-separated subset of user, project, local`,
   `#   worktreeDir: ${CONFIG_DEFAULTS.loopWorktreeDir}   # where a loop adds its worktrees, read from the project root`,
+  `#   retries: ${String(CONFIG_DEFAULTS.loopRetries)}               # 1..3 | false, times in a row a run re-enters its loop after a retry-safe stop`,
+  `#   retriesOnContinue: ${String(CONFIG_DEFAULTS.loopRetriesOnContinue)}         # 1..3 | false, the retries a --continue run opens when --retry is not typed`,
+  "#   continue:",
+  `#     criteria: ${CONFIG_DEFAULTS.loopContinueCriteria}   # the project's own criteria for a --continue decision`,
+  `#     criteriaMode: ${CONFIG_DEFAULTS.loopContinueCriteriaMode}         # extend | replace, how the project criteria meet the bundled base`,
+  "#   forceWrapUp:",
+  `#     maxNewFailures: ${String(CONFIG_DEFAULTS.loopForceWrapUpMaxNewFailures)}       # 1..50 | false, new suite failures --force-wrap-up tolerates`,
   "#   wrapUp:",
   `#     retries: ${String(CONFIG_DEFAULTS.loopWrapUpRetries)}                 # 1..3 | false, wrap-up sessions rerun before rafa opens a missing PR itself`,
   "# pr:",
@@ -14995,7 +14691,7 @@ class ScaffoldError extends Error {
 }
 function layoutOf2(base, tree) {
   const scope = scopeAt(base);
-  return { dirs: [scope.dir, ...tree.map((name2) => join31(scope.dir, name2))], configFile: configFilePath(base) };
+  return { dirs: [scope.dir, ...tree.map((name2) => join29(scope.dir, name2))], configFile: configFilePath(base) };
 }
 function occupied(path) {
   return lstatSync(path, { throwIfNoEntry: false }) !== undefined;
@@ -15006,7 +14702,7 @@ function isDirectory2(path) {
 function directoryConflict(dir) {
   if (!occupied(dir) || isDirectory2(dir))
     return null;
-  return existsSync11(dir) ? `${dir} is not a directory` : `${dir} is a link to nothing`;
+  return existsSync9(dir) ? `${dir} is not a directory` : `${dir} is a link to nothing`;
 }
 function layoutConflicts(layout) {
   const [scopeDir, ...tree] = layout.dirs;
@@ -15014,7 +14710,7 @@ function layoutConflicts(layout) {
   if (opening !== null)
     return [opening];
   const dirs = tree.flatMap((dir) => directoryConflict(dir) ?? []);
-  const file = occupied(layout.configFile) && !existsSync11(layout.configFile) ? [`${layout.configFile} is a link to nothing`] : [];
+  const file = occupied(layout.configFile) && !existsSync9(layout.configFile) ? [`${layout.configFile} is a link to nothing`] : [];
   return [...dirs, ...file];
 }
 function scaffoldConflicts(root, home) {
@@ -15028,7 +14724,7 @@ function attempt3(path, failure3, act) {
   }
 }
 function ensureDirectory(path) {
-  if (existsSync11(path))
+  if (existsSync9(path))
     return { path, kind: "directory", change: "unchanged" };
   attempt3(path, "cannot be created", () => {
     mkdirSync8(path, { recursive: true });
@@ -15036,7 +14732,7 @@ function ensureDirectory(path) {
   return { path, kind: "directory", change: "created" };
 }
 function ensureFile(path, text) {
-  if (existsSync11(path))
+  if (existsSync9(path))
     return { path, kind: "file", change: "unchanged" };
   attempt3(path, "cannot be written", () => {
     writeFileSync8(path, text, { encoding: "utf8", flag: "wx" });
@@ -15181,9 +14877,9 @@ function resolvedConfig2(root, home, warn3) {
   }
 }
 function checkGitignore(root, flags) {
-  const file = join32(root, GITIGNORE_FILE);
+  const file = join30(root, GITIGNORE_FILE);
   try {
-    const text = existsSync12(file) ? readFileSync23(file, "utf8") : null;
+    const text = existsSync10(file) ? readFileSync21(file, "utf8") : null;
     withTrackingBlock(text, flags, file);
   } catch (error) {
     const message = error instanceof GitignoreError ? error.message : `rafa init: ${file} cannot be read (${messageOf(error)})`;
@@ -15215,8 +14911,8 @@ function initialise(root, start2, home, context, entry) {
   const resolved = resolvedConfig2(root.path, home, warn3);
   const config = resolved.config;
   checkGitignore(root.path, config);
-  const configExisted = existsSync12(configFilePath(root.path));
-  const digestExisted = existsSync12(join32(root.path, TRACKING_DIGEST_FILE));
+  const configExisted = existsSync10(configFilePath(root.path));
+  const digestExisted = existsSync10(join30(root.path, TRACKING_DIGEST_FILE));
   const project = writeProjectScope(root.path);
   const tracking = applyTracking(root.path, config, warn3);
   const writes = [...project, ...trackingWrites(tracking, digestExisted), ...writeUserScope(home)];
@@ -16102,8 +15798,8 @@ function createInstinctShowCommand() {
 var show_default3 = createInstinctShowCommand();
 
 // src/commands/issue/check.ts
-import { readdirSync as readdirSync5, readFileSync as readFileSync24, statSync as statSync8 } from "fs";
-import { join as join33, resolve as resolve9 } from "path";
+import { readdirSync as readdirSync5, readFileSync as readFileSync22, statSync as statSync8 } from "fs";
+import { join as join31, resolve as resolve9 } from "path";
 var CHECK_USAGE = "rafa issue check <n> [--stamp]";
 var STAMP_FLAG = "stamp";
 var ISSUE_NUMBER8 = /^[1-9]\d*$/u;
@@ -16139,7 +15835,7 @@ function copyNames(dir, issue) {
   }
   const prefix = `${boardId(issue)}-`;
   const notes = notesFileName(issue);
-  return names.filter((name2) => name2.startsWith(prefix) && name2.endsWith(SPEC_EXTENSION) && name2 !== notes).filter((name2) => name2.length > prefix.length + SPEC_EXTENSION.length).filter((name2) => statSync8(join33(dir, name2)).isFile()).sort();
+  return names.filter((name2) => name2.startsWith(prefix) && name2.endsWith(SPEC_EXTENSION) && name2 !== notes).filter((name2) => name2.length > prefix.length + SPEC_EXTENSION.length).filter((name2) => statSync8(join31(dir, name2)).isFile()).sort();
 }
 function findSavedCopy(root, specsDir, issue) {
   const names = copyNames(resolve9(root, specsDir), issue);
@@ -16149,11 +15845,11 @@ function findSavedCopy(root, specsDir, issue) {
   if (names.length > 1) {
     throw new CommandExit(1, [
       `\u274C Issue #${String(issue)} has ${String(names.length)} saved copies under ${specsDir}; remove the stale one:`,
-      ...names.map((name2) => `   ${join33(specsDir, name2)}`)
+      ...names.map((name2) => `   ${join31(specsDir, name2)}`)
     ].join(`
 `));
   }
-  const path = join33(specsDir, only);
+  const path = join31(specsDir, only);
   return { path, absolute: resolve9(root, path) };
 }
 function liveText(live) {
@@ -16202,7 +15898,7 @@ async function readReferences(absolute, issue, verify, stamp) {
     return rows.map((row2) => checkedRef(row2, row2.stamp));
   }
   const once2 = memoiseVerifier(verify);
-  const before = await readRefsText({ copy: readFileSync24(absolute, "utf8"), issue, verify: once2 });
+  const before = await readRefsText({ copy: readFileSync22(absolute, "utf8"), issue, verify: once2 });
   const after = await restampCopyRefs({ path: absolute, issue, verify: once2 });
   return before.rows.map((row2, index) => checkedRef(row2, after.rows[index]?.stamp ?? null));
 }
@@ -16555,8 +16251,8 @@ function createIssueCreateCommand(seams = DEFAULT_ISSUE_SEAMS) {
 var create_default = createIssueCreateCommand();
 
 // src/commands/issue/edit-run.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync9, writeFileSync as writeFileSync9 } from "fs";
-import { join as join35 } from "path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync9, writeFileSync as writeFileSync9 } from "fs";
+import { join as join33 } from "path";
 
 // src/board/issue-edit-body.ts
 var TRAILING_WHITESPACE = /\s+$/u;
@@ -16611,7 +16307,7 @@ function originalPartHolds(before, after, block) {
 
 // src/board/issue-edit-state.ts
 import { readdirSync as readdirSync6, statSync as statSync9 } from "fs";
-import { join as join34, resolve as resolve10 } from "path";
+import { join as join32, resolve as resolve10 } from "path";
 function isClaimed(labels) {
   return labels.includes(CLAIMED_LABEL) || labels.includes(IN_DEVELOPMENT_LABEL);
 }
@@ -16684,7 +16380,7 @@ function findSavedCopies(root, specsDir, issue) {
       return [];
     throw error;
   }
-  return names.filter((name2) => isSavedCopyName(name2, issue)).filter((name2) => statSync9(join34(dir, name2)).isFile()).sort().map((name2) => join34(specsDir, name2));
+  return names.filter((name2) => isSavedCopyName(name2, issue)).filter((name2) => statSync9(join32(dir, name2)).isFile()).sort().map((name2) => join32(specsDir, name2));
 }
 
 // src/board/issue-edit-text.ts
@@ -16708,7 +16404,7 @@ function requireEditText(input) {
 var EDIT_USAGE = "rafa issue edit <n> (--append-file=<file> | --append=<text>) --reason=<text>" + " [--while-in-development] | (--replace-file=<file> [--title=<text>] | --title=<text>) [--dry-run]";
 var EDIT_REFUSAL_EXIT = TRUST_REFUSAL_EXIT;
 var EDIT_CONFLICT_EXIT = 1;
-var EDIT_SCRATCH_DIR = join35(".rafa", "scratch");
+var EDIT_SCRATCH_DIR = join33(".rafa", "scratch");
 var STDIN_PATH2 = "-";
 var ISSUE_NUMBER9 = /^[1-9]\d*$/u;
 var TRAILING_WHITESPACE2 = /\s+$/u;
@@ -16957,20 +16653,20 @@ function writeHeld(found, planned, reread) {
 }
 function conflictPaths(issue, stamp, attempt4) {
   const suffix = attempt4 === 1 ? "" : `-${String(attempt4)}`;
-  const name2 = (side) => join35(EDIT_SCRATCH_DIR, `${boardId(issue)}-edit-${side}-${stamp}${suffix}.md`);
+  const name2 = (side) => join33(EDIT_SCRATCH_DIR, `${boardId(issue)}-edit-${side}-${stamp}${suffix}.md`);
   return { before: name2("before"), after: name2("after") };
 }
 function saveConflictBodies(root, issue, now, before, after) {
-  mkdirSync9(join35(root, EDIT_SCRATCH_DIR), { recursive: true });
+  mkdirSync9(join33(root, EDIT_SCRATCH_DIR), { recursive: true });
   const stamp = fileStamp(now);
   let attempt4 = 1;
   let paths = conflictPaths(issue, stamp, attempt4);
-  while (existsSync13(join35(root, paths.before)) || existsSync13(join35(root, paths.after))) {
+  while (existsSync11(join33(root, paths.before)) || existsSync11(join33(root, paths.after))) {
     attempt4 += 1;
     paths = conflictPaths(issue, stamp, attempt4);
   }
-  writeFileSync9(join35(root, paths.before), before, { flag: "wx" });
-  writeFileSync9(join35(root, paths.after), after, { flag: "wx" });
+  writeFileSync9(join33(root, paths.before), before, { flag: "wx" });
+  writeFileSync9(join33(root, paths.after), after, { flag: "wx" });
   return paths;
 }
 function heldOutcome(request, state) {
@@ -17496,7 +17192,7 @@ var wrapped = wrapPhaseZeroCommand({
   subject: "loop",
   action: "start",
   summary: "run a plan task by task, then wrap up, open the PR and wait for CI",
-  description: "Walks the tracker of a plan one task at a time, each in a Claude Code session whose work" + " is committed once it exits, and retries blocked tasks first. After the last task a wrap-up" + " session promotes findings, syncs with main, pushes and opens or updates the PR, and the loop" + " then waits on its checks, spending repair sessions on a red or conflicting PR. With no" + " `--plan` it runs `PLAN.md` in `plan.dir`, `.rafa/plans` unless the config names another, or" + " `PLAN.md` at the project root when that one does not exist. Before any session it checks the" + " prerequisites the config and the plan's `PREREQUISITES-<stub>.md` name, halting when a required" + " one fails and naming each failed optional one known-missing in every task prompt, and warns once" + " for each migration the effort store holds that this rafa does not know and that is additive. It" + " refuses to start while `RAFA_EFFORT_DIR` is set, since a loop records to the project's own" + " store. Started on" + " `main` or `master` it offers to create the plan's `feat/<stub>` from the latest" + " `origin/<base>` and run there, `--create-branch` answering that without asking, and refuses" + " the run when the offer is not taken. `--as-worktree` runs the plan in a worktree of its own on" + " that branch instead, leaving the main checkout as it is, and is refused beside" + " `--create-branch`. Each run writes its session record to `.rafa/runs/<session-id>.json`:" + " the plan, the branch, the pid, the start, the state and the running task, and under `--roadmap`" + " the hop away, when one is. It refuses a plan whose" + " record names another branch, and a plan a session is still running. `rafa loop stop`, `pause`," + " `resume`, `status` and `list` reach the run through that record. A run holds its terminal: until" + " phase 6 it refuses `--detached`. With `--runtime` the whole run goes on in that installed rafa," + " never in a `src/` directory.",
+  description: "Walks the tracker of a plan one task at a time, each in a Claude Code session whose work" + " is committed once it exits, and retries blocked tasks first. After the last task a wrap-up" + " session promotes findings, syncs with main, pushes and opens or updates the PR, and the loop" + " then waits on its checks, spending repair sessions on a red or conflicting PR. With no" + " `--plan` it runs `PLAN.md` in `plan.dir`, `.rafa/plans` unless the config names another, or" + " `PLAN.md` at the project root when that one does not exist. Before any session it checks the" + " prerequisites the config and the plan's `PREREQUISITES-<stub>.md` name, halting when a required" + " one fails and naming each failed optional one known-missing in every task prompt, and warns once" + " for each migration the effort store holds that this rafa does not know and that is additive. It" + " refuses to start while `RAFA_EFFORT_DIR` is set, since a loop records to the project's own" + " store. Started on" + " `main` or `master` it offers to create the plan's `feat/<stub>` from the latest" + " `origin/<base>` and run there, `--create-branch` answering that without asking, and refuses" + " the run when the offer is not taken. `--as-worktree` runs the plan in a worktree of its own on" + " that branch instead, leaving the main checkout as it is, and is refused beside" + " `--create-branch`. Each run writes its session record to `.rafa/runs/<session-id>.json`:" + " the plan, the branch, the pid, the start, the state and the running task, and under `--roadmap`" + " the hop away, when one is. It refuses a plan whose" + " record names another branch, and a plan a session is still running. `rafa loop stop`, `pause`," + " `resume`, `status` and `list` reach the run through that record. With `--retry` or" + " `loop.retries` it goes back into its loop instead of stopping, at most that many times in a row," + " after a red suite step, a task session that exited nonzero, or one that left neither a report nor" + " a commit; a later task done, neither the stopped one nor a repair, starts the count over. With `--continue` a stop that would end the run is handed to a decision instead: retry the" + " task with a new approach, stop with exit code 20, jump over it or defer it until a later task is" + " done; a run left with only passed-over tasks ends with exit code 22 and no wrap-up unless" + " `--force-wrap-up`, and under `--output=json` a decision the line does not name ends the run with" + " exit code 21 and the decision prompt. A run holds its terminal: until" + " phase 6 it refuses `--detached`. With `--runtime` the whole run goes on in that installed rafa," + " never in a `src/` directory.",
   args: [],
   flags: [
     {
@@ -17542,6 +17238,36 @@ var wrapped = wrapPhaseZeroCommand({
       type: "number",
       default: DEFAULT_CI_ATTEMPTS
     },
+    {
+      name: "retry",
+      description: "Goes back into the loop instead of stopping, at most this many times in a row, 1 to 3," + " after a red suite step, a task session that exited nonzero but not on its budget, or one that" + " left neither a report nor a commit. The count starts over once a later task is done, neither" + " the stopped one nor a repair. A report that blocks its task, a refused commit, a moved" + " checkout and an interrupt still stop the run. Outranks `loop.retries` in" + " `.rafa/config.yaml`, `false` unless the config names a count; any other value is refused" + " before the run starts.",
+      type: "number"
+    },
+    {
+      name: "continue",
+      description: "Hands a stop that would end the run to a decision instead: a report that holds its task at" + " once, and a retry-safe stop once its retries are spent. One read-only decision session picks" + " `retry` (with a new approach), `stop`, `jump` (pass the task over this run) or `defer` (pass" + " it over until a later task is done), by the bundled criteria and `loop.continue.criteria`." + " The retries are `loop.retriesOnContinue` unless `--retry` names a count.",
+      type: "boolean"
+    },
+    {
+      name: "decide",
+      description: "Names the decision on the line, `retry`, `stop`, `jump` or `defer`, applied once to the first" + " decision point the run meets, so no decision session is spawned for it. Needs `--continue`.",
+      type: "string"
+    },
+    {
+      name: "approach",
+      description: "The new approach a `--decide=retry` hands the task's next session; required by it and" + " read beside nothing else.",
+      type: "string"
+    },
+    {
+      name: "after",
+      description: "The tracker line, counted from 1, of the task a `--decide=defer` waits on; required by it" + " and read beside nothing else.",
+      type: "number"
+    },
+    {
+      name: "force-wrap-up",
+      description: "Wraps up a `--continue` run left with only passed-over tasks anyway, as a draft pull request" + " listing them, once the pre-wrap-up suite step finds no more new failures than" + " `loop.forceWrapUp.maxNewFailures` tolerates. Needs `--continue`.",
+      type: "boolean"
+    },
     {
       name: "create-branch",
       description: "On `main` or `master`, creates `feat/<plan-stub>` from the latest `origin/<base>`" + " and runs the plan there without asking, or switches to that branch when it already" + " exists. Refuses rather than move when a tracked file is modified, the fetch fails or the" + " base has diverged from its remote.",
@@ -17588,7 +17314,7 @@ var wrapped = wrapPhaseZeroCommand({
   outputs: ["text", "json", "events"],
   spends: {
     when: "always",
-    what: "one session per task, one for the wrap-up and up to `loop.wrapUp.retries` more when it opens no pull request, and repair sessions while CI is red"
+    what: "one session per task, one for the wrap-up and up to `loop.wrapUp.retries` more when it opens no pull request," + " repair sessions while CI is red, the sessions of up to `--retry` (`loop.retries`) more passes of the loop" + " in a row after the stops it retries, and under `--continue` one read-only decision session per decision"
   }
 }, start);
 var loopStart = Object.freeze({
@@ -18829,7 +18555,7 @@ var wrapped2 = wrapPhaseZeroCommand({
 var create_default2 = endingWith(wrapped2);
 
 // src/commands/plan/risk.ts
-import { readFileSync as readFileSync25 } from "fs";
+import { readFileSync as readFileSync23 } from "fs";
 import { resolve as resolve11 } from "path";
 var COMMAND6 = "rafa plan risk";
 var USAGE34 = "rafa plan risk [<plan>] [--strict]";
@@ -18857,7 +18583,7 @@ function strictRefusal(report3) {
 }
 async function readRisk(path, project, config, context, seams) {
   const makeRunners = seams.runners ?? spawningRunners;
-  return assessPlanRisk({ path, text: readFileSync25(path, "utf8") }, {
+  return assessPlanRisk({ path, text: readFileSync23(path, "utf8") }, {
     repoRoot: project.root,
     home: project.home,
     settingSources: config.settingSources,
@@ -18940,8 +18666,8 @@ function createPlanRiskCommand(seams = {}) {
 var risk_default = createPlanRiskCommand();
 
 // src/commands/plan/show.ts
-import { readFileSync as readFileSync26 } from "fs";
-import { join as join36 } from "path";
+import { readFileSync as readFileSync24 } from "fs";
+import { join as join34 } from "path";
 var USAGE35 = "rafa plan show <stub> [--tracker]";
 var COMMAND7 = "rafa plan show";
 function readTrackerFlag(value) {
@@ -18959,10 +18685,10 @@ function showPlan(plans, stub, tracker) {
     throw new CommandExit(1, `\u274C "${stub}" is no plan stub: a stub is letters, digits, ".", "_" and "-"`);
   }
   const name2 = planFileName(stub, tracker);
-  const file = join36(plans.path, name2);
+  const file = join34(plans.path, name2);
   if (!isFile(file))
-    throw new CommandExit(1, missingText(stub, tracker, join36(plans.label, name2)));
-  const model = parsePlan(readFileSync26(file, "utf8"));
+    throw new CommandExit(1, missingText(stub, tracker, join34(plans.label, name2)));
+  const model = parsePlan(readFileSync24(file, "utf8"));
   const { header } = model;
   return {
     stub,
@@ -18985,7 +18711,7 @@ function taskLine(task) {
   return `  ${checkbox(task.status)} ${task.text}`;
 }
 function renderShownPlan(shown, dirLabel) {
-  const relative9 = join36(dirLabel, planFileName(shown.stub, shown.tracker));
+  const relative9 = join34(dirLabel, planFileName(shown.stub, shown.tracker));
   const fileLabel = shown.tracker ? "Tracker" : "File";
   const lines = [`Plan: ${shown.stub}`, `${fileLabel}: ${relative9}`];
   if (shown.header.issue !== null)
@@ -19981,7 +19707,7 @@ async function refreshProjectAfterMerge(options) {
 
 // src/commands/pr/merge-loop-worktree.ts
 import { copyFileSync as copyFileSync3, mkdirSync as mkdirSync10, realpathSync as realpathSync3, statSync as statSync10 } from "fs";
-import { dirname as dirname11, isAbsolute as isAbsolute6, join as join37, relative as relative9, resolve as resolve12, sep as sep4 } from "path";
+import { dirname as dirname9, isAbsolute as isAbsolute6, join as join35, relative as relative9, resolve as resolve12, sep as sep4 } from "path";
 var REFUSAL_PREFIX = "rafa pr merge refuses";
 var INDENT4 = "   ";
 var LIVE_STATES = new Set(["running", "paused"]);
@@ -19991,7 +19717,7 @@ function defaultLoopWorktreeSeams(mainCheckout) {
     gitAt: createGitRunner,
     modifiedAt: (path) => statSync10(path, { throwIfNoEntry: false })?.mtime ?? null,
     copyFile: (from, to) => {
-      mkdirSync10(dirname11(to), { recursive: true });
+      mkdirSync10(dirname9(to), { recursive: true });
       copyFileSync3(from, to);
     },
     realPath: (path) => {
@@ -20026,7 +19752,7 @@ function freeLoopWorktree(seams, reading, holder) {
   const files = [];
   for (const name2 of planFileNames(holder.stub)) {
     const from = resolve12(holder.path, reading.planDir, name2);
-    const to = join37(into, name2);
+    const to = join35(into, name2);
     try {
       files.push({ name: name2, from, to, outcome: copyPlanFile(seams, from, to) });
     } catch (error) {
@@ -20281,7 +20007,7 @@ function workflowNamesBase(workflowText, base) {
   return readWorkflow(document, base) !== false;
 }
 function readWorkflow(document, base) {
-  if (!isPlainObject2(document) || !("on" in document))
+  if (!isPlainObject(document) || !("on" in document))
     return UNKNOWN;
   const on = document.on;
   if (typeof on === "string")
@@ -20291,7 +20017,7 @@ function readWorkflow(document, base) {
       return UNKNOWN;
     return on.includes(PULL_REQUEST_EVENT);
   }
-  if (!isPlainObject2(on))
+  if (!isPlainObject(on))
     return UNKNOWN;
   if (!(PULL_REQUEST_EVENT in on))
     return false;
@@ -20300,7 +20026,7 @@ function readWorkflow(document, base) {
 function readPullRequestTrigger(trigger, base) {
   if (trigger === null || trigger === undefined)
     return true;
-  if (!isPlainObject2(trigger))
+  if (!isPlainObject(trigger))
     return UNKNOWN;
   const branches = trigger.branches;
   const ignored = trigger["branches-ignore"];
@@ -20401,7 +20127,7 @@ function regexSourceOf(pattern) {
 function escapeRegex(char) {
   return char.replace(REGEX_SPECIAL, "\\$&");
 }
-function isPlainObject2(value) {
+function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -20995,7 +20721,7 @@ var FOLLOW_UP_TASKS = Object.freeze({
   "ci-test": "A test failed. Read the excerpt below, reproduce the named test" + " locally, and fix the implementation rather than the assertion unless the" + " assertion is itself wrong. Run the gates and push.",
   "ci-other": "A step nothing recognised failed. Read the excerpt below, work out" + " from the step name what that job does, and fix it; there is no pinned plan" + " for this class, so nothing has been assumed about the fix."
 });
-var MIN_FENCE_LENGTH3 = 3;
+var MIN_FENCE_LENGTH2 = 3;
 function isUsableCap(value) {
   return value !== undefined && Number.isInteger(value) && value > 0;
 }
@@ -21010,7 +20736,7 @@ function excerptLines(evidence, maxLines) {
 }
 function fencedBlock(body, language) {
   const runs = Array.from(body.matchAll(/`+/g), (run) => run[0].length);
-  const fence = "`".repeat(Math.max(MIN_FENCE_LENGTH3, ...runs.map((length) => length + 1)));
+  const fence = "`".repeat(Math.max(MIN_FENCE_LENGTH2, ...runs.map((length) => length + 1)));
   const text = body.endsWith(`
 `) || body === "" ? body : `${body}
 `;
@@ -21110,7 +20836,7 @@ function findTriageComment(comments) {
 function read(value) {
   return { value, problem: null };
 }
-function absent4() {
+function absent3() {
   return { value: null, problem: null };
 }
 function unusable(key, value, expected) {
@@ -21119,7 +20845,7 @@ function unusable(key, value, expected) {
 function readText4(fields, key) {
   const value = fields[key];
   if (value === undefined)
-    return absent4();
+    return absent3();
   if (typeof value !== "string")
     return unusable(key, value, `text; write it quoted, as ${key}: "..."`);
   const trimmed = value.trim();
@@ -21128,19 +20854,19 @@ function readText4(fields, key) {
 function readBoolean(fields, key) {
   const value = fields[key];
   if (value === undefined)
-    return absent4();
+    return absent3();
   return typeof value === "boolean" ? read(value) : unusable(key, value, "true or false");
 }
 function readCount(fields, key) {
   const value = fields[key];
   if (value === undefined)
-    return absent4();
+    return absent3();
   return typeof value === "number" && Number.isInteger(value) && value >= 0 ? read(value) : unusable(key, value, "a whole number from 0");
 }
 function readPaths(fields, key) {
   const value = fields[key];
   if (value === undefined)
-    return absent4();
+    return absent3();
   if (!Array.isArray(value))
     return unusable(key, value, "a list of quoted paths");
   const paths = value.filter((item) => typeof item === "string" && item.trim() !== "");
@@ -22340,10 +22066,10 @@ function withTaskBudget(plan2, usd) {
 }
 
 // src/pr/plans/load.ts
-import { existsSync as existsSync14, readFileSync as readFileSync27 } from "fs";
-import { dirname as dirname12, join as join38 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
-var MODULE_DIR4 = dirname12(fileURLToPath4(import.meta.url));
+import { existsSync as existsSync12, readFileSync as readFileSync25 } from "fs";
+import { dirname as dirname10, join as join36 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var MODULE_DIR2 = dirname10(fileURLToPath2(import.meta.url));
 var PINNED_PLANS_DIRNAME = "plans";
 var PINNED_PLAN_CLASSES = Object.freeze([
   ...SIMPLE_TRIAGE_CLASSES,
@@ -22358,22 +22084,22 @@ function hasPinnedPlan(triageClass) {
 function pinnedPlanCandidates(moduleDir, triageClass) {
   const name2 = pinnedPlanFileName(triageClass);
   return [
-    join38(moduleDir, PINNED_PLANS_DIRNAME, name2),
-    join38(moduleDir, name2)
+    join36(moduleDir, PINNED_PLANS_DIRNAME, name2),
+    join36(moduleDir, name2)
   ];
 }
 function readPinnedPlan(triageClass, lookup = {}) {
   if (!hasPinnedPlan(triageClass)) {
     throw new Error(`No pinned resolve plan ships for ${triageClass}; ` + `one ships for ${PINNED_PLAN_CLASSES.join(", ")}`);
   }
-  const candidates = pinnedPlanCandidates(lookup.moduleDir ?? MODULE_DIR4, triageClass);
-  const found = candidates.find((candidate) => existsSync14(candidate));
+  const candidates = pinnedPlanCandidates(lookup.moduleDir ?? MODULE_DIR2, triageClass);
+  const found = candidates.find((candidate) => existsSync12(candidate));
   if (found === undefined) {
     throw new Error(`The pinned resolve plan for ${triageClass} is missing: ` + `no file at ${candidates.join(" or ")}`);
   }
-  return readFileSync27(found, "utf8");
+  return readFileSync25(found, "utf8");
 }
-var SLOT_PATTERN2 = /\{[A-Z][A-Z0-9_]*\}/g;
+var SLOT_PATTERN = /\{[A-Z][A-Z0-9_]*\}/g;
 var CONFLICT_SENTENCE_SLOT = "CONFLICT_SENTENCE";
 var CONFLICT_FILES_SLOT = "CONFLICT_FILES";
 var NO_CONFLICT_FILES = "the paths `git status` reports as conflicted";
@@ -22383,7 +22109,7 @@ var FAILING_LOG_EXCERPT_LINES = FOLLOW_UP_EXCERPT_LINES;
 var NO_FAILING_LOG = "No failing-job log was carried into this plan. Read it yourself with" + " `gh run view <run-id> --log-failed` before changing anything, and say that" + " the excerpt was missing rather than guessing what failed.";
 function fillPinnedPlan(template, values) {
   const missing = [];
-  const filled = template.replaceAll(SLOT_PATTERN2, (token) => {
+  const filled = template.replaceAll(SLOT_PATTERN, (token) => {
     const name2 = token.slice(1, -1);
     const value = values[name2];
     if (value === undefined) {
@@ -22514,19 +22240,19 @@ function readAttemptRepeat(input) {
 
 // src/commands/pr/resolve-loop.ts
 import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync10 } from "fs";
-import { join as join39 } from "path";
-var RESOLVE_SUBDIR = join39(".rafa", "resolve");
+import { join as join37 } from "path";
+var RESOLVE_SUBDIR = join37(".rafa", "resolve");
 var RUN_PREFIX = "pr-";
 var ATTEMPT_PREFIX = "attempt-";
 var LOOP_WORDS = Object.freeze(["loop", "start"]);
 var CHILD_OUTPUT = "text";
 function resolveRunDir(home, number, attempt4) {
-  return join39(home, RESOLVE_SUBDIR, `${RUN_PREFIX}${number}`, `${ATTEMPT_PREFIX}${attempt4}`);
+  return join37(home, RESOLVE_SUBDIR, `${RUN_PREFIX}${number}`, `${ATTEMPT_PREFIX}${attempt4}`);
 }
 function writeResolvePlan(write) {
   const dir = resolveRunDir(write.home, write.number, write.attempt);
   mkdirSync11(dir, { recursive: true });
-  const path = join39(dir, pinnedPlanFileName(write.triageClass));
+  const path = join37(dir, pinnedPlanFileName(write.triageClass));
   writeFileSync10(path, write.plan, "utf8");
   return path;
 }
@@ -22567,8 +22293,8 @@ async function runResolveLoop(run, seams = {}) {
 }
 
 // src/pr/triage/version-convert.ts
-import { mkdirSync as mkdirSync12, readFileSync as readFileSync28, writeFileSync as writeFileSync11 } from "fs";
-import { dirname as dirname13, join as join40, posix as posix2 } from "path";
+import { mkdirSync as mkdirSync12, readFileSync as readFileSync26, writeFileSync as writeFileSync11 } from "fs";
+import { dirname as dirname11, join as join38, posix as posix2 } from "path";
 var FALLBACK_PLAN_PREFIX = "pr-";
 var UNUSABLE_PLAN_CHARACTERS = /[^A-Za-z0-9._-]+/g;
 var UNUSABLE_PLAN_START = /^[^A-Za-z0-9]+/;
@@ -22680,7 +22406,7 @@ function planConversion(input, problems) {
   }
   let branchVersionText;
   try {
-    branchVersionText = readFileSync28(join40(input.worktree, settings.releaseVersionFile), "utf8");
+    branchVersionText = readFileSync26(join38(input.worktree, settings.releaseVersionFile), "utf8");
   } catch (error) {
     return refused2(`${settings.releaseVersionFile} could not be read in the worktree: ${messageOf(error)}`, problems);
   }
@@ -22706,9 +22432,9 @@ function writeConversion(input, plan2) {
     [input.settings.releaseChangelog, plan2.changelogText]
   ];
   for (const [path, text] of writes) {
-    const target = join40(input.worktree, path);
+    const target = join38(input.worktree, path);
     try {
-      mkdirSync12(dirname13(target), { recursive: true });
+      mkdirSync12(dirname11(target), { recursive: true });
       writeFileSync11(target, text);
     } catch (error) {
       return `${path} could not be written in the worktree, which may hold part of the conversion: ${messageOf(error)}`;
@@ -23707,9 +23433,9 @@ function tagSettle(worktree, mode, delivered) {
 }
 
 // src/release/settle-worktree.ts
-import { existsSync as existsSync15, mkdtempSync as mkdtempSync2, realpathSync as realpathSync4, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync13, mkdtempSync as mkdtempSync2, realpathSync as realpathSync4, rmSync as rmSync3 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join41 } from "path";
+import { join as join39 } from "path";
 var SETTLE_SCRATCH_PREFIX = "rafa-settle-";
 var WORKTREE_DIRECTORY = "base";
 function removeScratch(git, scratch, path) {
@@ -23726,14 +23452,14 @@ function removeScratch(git, scratch, path) {
       problems.push(`the worktree record of ${path} could not be pruned: ${gitSaid(pruned)}`);
     }
   }
-  if (problems.length === 0 && existsSync15(scratch)) {
+  if (problems.length === 0 && existsSync13(scratch)) {
     problems.push(`the scratch directory ${scratch} is still there`);
   }
   return problems.length === 0 ? null : problems.join("; ");
 }
 function makeScratch(root) {
   try {
-    return realpathSync4(mkdtempSync2(join41(root, SETTLE_SCRATCH_PREFIX)));
+    return realpathSync4(mkdtempSync2(join39(root, SETTLE_SCRATCH_PREFIX)));
   } catch (error) {
     return { ok: false, problem: `no scratch directory could be made under ${root}: ${messageOf(error)}`, leftover: null };
   }
@@ -23755,7 +23481,7 @@ function addWorktree(options) {
   const scratch = makeScratch(options.scratchRoot ?? tmpdir2());
   if (typeof scratch !== "string")
     return scratch;
-  const path = join41(scratch, WORKTREE_DIRECTORY);
+  const path = join39(scratch, WORKTREE_DIRECTORY);
   const added = git(["worktree", "add", "--detach", path, commit]);
   if (!added.ok) {
     return {
@@ -24144,8 +23870,8 @@ function createReleaseSettleCommand(seams = DEFAULT_RELEASE_SETTLE_SEAMS) {
 var settle_default = createReleaseSettleCommand();
 
 // src/commands/release/tag.ts
-import { readFileSync as readFileSync29 } from "fs";
-import { join as join42 } from "path";
+import { readFileSync as readFileSync27 } from "fs";
+import { join as join40 } from "path";
 
 // src/release/tag-push.ts
 var LOCAL_REMOTE = ".";
@@ -24221,13 +23947,13 @@ function readBranch2(git) {
 }
 function textOf(path) {
   try {
-    return readFileSync29(path, "utf8");
+    return readFileSync27(path, "utf8");
   } catch {
     return null;
   }
 }
 function readVersion(root, configured) {
-  const resolved = join42(root, configured);
+  const resolved = join40(root, configured);
   const text = textOf(resolved);
   if (text === null) {
     return {
@@ -24241,7 +23967,7 @@ function readVersion(root, configured) {
   return version2 === null ? { path: configured, text, version: null, problem: `${resolved} declares no version this can read` } : { path: configured, text, version: version2, problem: null };
 }
 function readNewestRelease(root, configured) {
-  const resolved = join42(root, configured);
+  const resolved = join40(root, configured);
   const text = textOf(resolved);
   if (text === null) {
     return { path: configured, version: null, problem: `the changelog could not be read at ${resolved}` };
@@ -24525,16 +24251,16 @@ var roadmap_default = createRoadmapCommand();
 
 // src/commands/skill/backfill.ts
 import { statSync as statSync12 } from "fs";
-import { join as join47, resolve as resolve15 } from "path";
+import { join as join45, resolve as resolve15 } from "path";
 
 // src/backfill/backup.ts
-import { copyFileSync as copyFileSync4, existsSync as existsSync16, mkdirSync as mkdirSync13 } from "fs";
-import { dirname as dirname14, isAbsolute as isAbsolute7, join as join44, relative as relative10, resolve as resolve13, sep as sep5 } from "path";
+import { copyFileSync as copyFileSync4, existsSync as existsSync14, mkdirSync as mkdirSync13 } from "fs";
+import { dirname as dirname12, isAbsolute as isAbsolute7, join as join42, relative as relative10, resolve as resolve13, sep as sep5 } from "path";
 
 // src/backfill/proposal-file.ts
-import { readdirSync as readdirSync7, readFileSync as readFileSync30 } from "fs";
-import { join as join43 } from "path";
-var BACKFILL_PATH = join43(".rafa", "backfill");
+import { readdirSync as readdirSync7, readFileSync as readFileSync28 } from "fs";
+import { join as join41 } from "path";
+var BACKFILL_PATH = join41(".rafa", "backfill");
 var PROPOSAL_FILE_PREFIX = "proposals-";
 var PROPOSAL_FILE_EXTENSION = ".yaml";
 var SHA256_PATTERN = /^[0-9a-f]{64}$/;
@@ -24560,7 +24286,7 @@ var PROPOSAL_FILE_HEADER = [
 ].join(`
 `);
 function proposalPath(dir, batch) {
-  return join43(dir, `${PROPOSAL_FILE_PREFIX}${String(batch).padStart(2, "0")}${PROPOSAL_FILE_EXTENSION}`);
+  return join41(dir, `${PROPOSAL_FILE_PREFIX}${String(batch).padStart(2, "0")}${PROPOSAL_FILE_EXTENSION}`);
 }
 function isProposalFileName(name2) {
   return name2.startsWith(PROPOSAL_FILE_PREFIX) && name2.endsWith(PROPOSAL_FILE_EXTENSION);
@@ -24696,9 +24422,9 @@ function readProposalFiles(dir) {
     return [];
   }
   return names.filter((name2) => isProposalFileName(name2)).sort((left, right) => left.localeCompare(right)).map((name2) => {
-    const path = join43(dir, name2);
+    const path = join41(dir, name2);
     try {
-      return { path, result: parseProposalFile(readFileSync30(path, "utf8")) };
+      return { path, result: parseProposalFile(readFileSync28(path, "utf8")) };
     } catch (error) {
       return { path, result: unreadable2(`the file cannot be read (${error instanceof Error ? error.message : String(error)})`) };
     }
@@ -24706,10 +24432,10 @@ function readProposalFiles(dir) {
 }
 
 // src/backfill/backup.ts
-var BACKUP_PATH = join44(BACKFILL_PATH, "backup");
+var BACKUP_PATH = join42(BACKFILL_PATH, "backup");
 var BACKUP_KINDS = ["copied", "kept", "tracked", "outside", "missing"];
 function backupDirectory(base) {
-  return join44(base, BACKUP_PATH);
+  return join42(base, BACKUP_PATH);
 }
 function isUnder(root, path) {
   const step = relative10(resolve13(root), resolve13(path));
@@ -24718,7 +24444,7 @@ function isUnder(root, path) {
 function backupPathFor(path, root, backupDir) {
   if (!isUnder(root, path))
     return null;
-  return join44(backupDir, relative10(resolve13(root), resolve13(path)));
+  return join42(backupDir, relative10(resolve13(root), resolve13(path)));
 }
 function backupFile(path, options) {
   if (options.repoRoot !== null && isUnder(options.repoRoot, path)) {
@@ -24727,11 +24453,11 @@ function backupFile(path, options) {
   const backup = backupPathFor(path, options.root, options.backupDir);
   if (backup === null)
     return { path, kind: "outside", backup: null };
-  if (!existsSync16(path))
+  if (!existsSync14(path))
     return { path, kind: "missing", backup: null };
-  if (existsSync16(backup))
+  if (existsSync14(backup))
     return { path, kind: "kept", backup };
-  mkdirSync13(dirname14(backup), { recursive: true });
+  mkdirSync13(dirname12(backup), { recursive: true });
   copyFileSync4(path, backup);
   return { path, kind: "copied", backup };
 }
@@ -24754,7 +24480,7 @@ function countBackups(results) {
 }
 
 // src/backfill/derive.ts
-import { readFileSync as readFileSync31, writeFileSync as writeFileSync12 } from "fs";
+import { readFileSync as readFileSync29, writeFileSync as writeFileSync12 } from "fs";
 import { basename as basename7 } from "path";
 var DERIVED_FIELDS = ["stack", "paths", "when_to_use"];
 function renderWhenToUse(trigger, prevents) {
@@ -24880,7 +24606,7 @@ function planFile(entry, options) {
   }
   let original;
   try {
-    original = readFileSync31(entry.path, "utf8");
+    original = readFileSync29(entry.path, "utf8");
   } catch (error) {
     return inert(entry, "skipped", `the file cannot be read (${error instanceof Error ? error.message : String(error)})`);
   }
@@ -24924,7 +24650,7 @@ function planDerivation(root, options) {
 function applyFile(action, options) {
   if (action.text === null || action.original === null)
     return action;
-  const current = readFileSync31(action.path, "utf8");
+  const current = readFileSync29(action.path, "utf8");
   if (current !== action.original) {
     return {
       ...action,
@@ -24955,7 +24681,7 @@ function applyDerivation(plan2, options) {
 }
 
 // src/backfill/proposal-batch.ts
-import { readFileSync as readFileSync32 } from "fs";
+import { readFileSync as readFileSync30 } from "fs";
 import { relative as relative11 } from "path";
 
 // src/demote/report.ts
@@ -25254,7 +24980,7 @@ function readCandidate(root, entry) {
     return null;
   let text;
   try {
-    text = readFileSync32(entry.path, "utf8");
+    text = readFileSync30(entry.path, "utf8");
   } catch {
     return null;
   }
@@ -25360,8 +25086,8 @@ function parseSessionAnswer(stdout) {
 }
 
 // src/backfill/propose.ts
-import { mkdirSync as mkdirSync14, readFileSync as readFileSync33, writeFileSync as writeFileSync13 } from "fs";
-import { join as join45, resolve as resolve14 } from "path";
+import { mkdirSync as mkdirSync14, readFileSync as readFileSync31, writeFileSync as writeFileSync13 } from "fs";
+import { join as join43, resolve as resolve14 } from "path";
 var PROPOSAL_ACTION_KINDS = [
   "applied",
   "unchanged",
@@ -25510,7 +25236,7 @@ function writeRow(path, row2, original, options) {
   };
 }
 function applyRow(root, row2, options) {
-  const path = join45(root, ...row2.path.split("/"));
+  const path = join43(root, ...row2.path.split("/"));
   if (row2.status === UNANSWERED_ROW) {
     return inert2(path, row2, "unanswered", row2.note ?? "the row carries no answer");
   }
@@ -25519,7 +25245,7 @@ function applyRow(root, row2, options) {
   }
   let original;
   try {
-    original = readFileSync33(path, "utf8");
+    original = readFileSync31(path, "utf8");
   } catch {
     return inert2(path, row2, "refused", "the file the row names is gone");
   }
@@ -25547,7 +25273,7 @@ function applyProposals(files, root, options) {
   for (const file of files) {
     const refusal19 = fileRefusal(file, root);
     for (const row2 of file.rows) {
-      const action = refusal19 === null ? applyRow(root, row2, options) : inert2(join45(root, ...row2.path.split("/")), row2, "refused", refusal19);
+      const action = refusal19 === null ? applyRow(root, row2, options) : inert2(join43(root, ...row2.path.split("/")), row2, "refused", refusal19);
       actions.push(action);
       if (row2.trigger !== null && action.kind !== "refused" && action.kind !== "unanswered") {
         triggers[row2.name] = row2.trigger;
@@ -25558,13 +25284,13 @@ function applyProposals(files, root, options) {
 }
 
 // src/demote/select.ts
-import { readdirSync as readdirSync8, readFileSync as readFileSync34, realpathSync as realpathSync5, statSync as statSync11 } from "fs";
-import { basename as basename8, dirname as dirname15, join as join46 } from "path";
+import { readdirSync as readdirSync8, readFileSync as readFileSync32, realpathSync as realpathSync5, statSync as statSync11 } from "fs";
+import { basename as basename8, dirname as dirname13, join as join44 } from "path";
 var SKILLS_DIRECTORY = "skills";
 var CLAUDE_DIRECTORY = ".claude";
 var AUTO_EXTRACTED_ORIGIN = "auto-extracted";
-var DEMOTED_PATH = join46(".rafa", "demoted");
-var INSTINCTS_PATH = join46(".rafa", "instincts");
+var DEMOTED_PATH = join44(".rafa", "demoted");
+var INSTINCTS_PATH = join44(".rafa", "instincts");
 var REPORT_FILE = "report.md";
 function realOrSelf(path) {
   try {
@@ -25583,18 +25309,18 @@ function samePath(left, right) {
 function resolveDemotionScope(dir, home) {
   if (basename8(dir) !== SKILLS_DIRECTORY)
     return null;
-  const claude = dirname15(dir);
+  const claude = dirname13(dir);
   if (basename8(claude) !== CLAUDE_DIRECTORY)
     return null;
-  const base = dirname15(claude);
-  const demotedDir = join46(base, DEMOTED_PATH);
+  const base = dirname13(claude);
+  const demotedDir = join44(base, DEMOTED_PATH);
   return {
     scope: samePath(base, home) ? "user" : "project",
     dir,
     base,
     demotedDir,
-    instinctsDir: join46(base, INSTINCTS_PATH),
-    reportPath: join46(demotedDir, REPORT_FILE)
+    instinctsDir: join44(base, INSTINCTS_PATH),
+    reportPath: join44(demotedDir, REPORT_FILE)
   };
 }
 function entryKind(path) {
@@ -25620,7 +25346,7 @@ function readSelected(absolute, path, entries) {
   let text;
   let mtime;
   try {
-    text = readFileSync34(absolute, "utf8");
+    text = readFileSync32(absolute, "utf8");
     mtime = statSync11(absolute).mtime.toISOString();
   } catch {
     return null;
@@ -25636,14 +25362,14 @@ function selectsLearned(text, scope) {
   return origin === AUTO_EXTRACTED_ORIGIN;
 }
 function selectLearned(scope) {
-  const dir = join46(scope.dir, LEARNED_DIRECTORY);
+  const dir = join44(scope.dir, LEARNED_DIRECTORY);
   if (entryKind(dir) !== "directory")
     return [];
   const selected = [];
   for (const name2 of visibleNames(dir)) {
     if (!name2.endsWith(MARKDOWN_EXTENSION) || name2 === MARKDOWN_EXTENSION)
       continue;
-    const absolute = join46(dir, name2);
+    const absolute = join44(dir, name2);
     if (entryKind(absolute) !== "file")
       continue;
     const file = readSelected(absolute, `${LEARNED_DIRECTORY}/${name2}`, undefined);
@@ -25657,10 +25383,10 @@ function selectSkillFiles(scope) {
   for (const name2 of visibleNames(scope.dir)) {
     if (name2 === LEARNED_DIRECTORY)
       continue;
-    const skillDir = join46(scope.dir, name2);
+    const skillDir = join44(scope.dir, name2);
     if (entryKind(skillDir) !== "directory")
       continue;
-    const absolute = join46(skillDir, SKILL_FILE);
+    const absolute = join44(skillDir, SKILL_FILE);
     if (entryKind(absolute) !== "file")
       continue;
     const file = readSelected(absolute, `${name2}/${SKILL_FILE}`, visibleNames(skillDir));
@@ -25845,7 +25571,7 @@ function reviewedProposals(dir) {
   return read2.flatMap((entry) => entry.result.file === null ? [] : [entry.result.file]);
 }
 function rowPaths(files, root) {
-  return files.flatMap((file) => file.status !== REVIEWED_FILE ? [] : file.rows.filter((row2) => row2.status === ANSWERED_ROW).map((row2) => join47(root, ...row2.path.split("/"))));
+  return files.flatMap((file) => file.status !== REVIEWED_FILE ? [] : file.rows.filter((row2) => row2.status === ANSWERED_ROW).map((row2) => join45(root, ...row2.path.split("/"))));
 }
 function runApply(context, scope, backfillDir, projectRoot2) {
   const options = checkOptions(context, projectRoot2);
@@ -25891,7 +25617,7 @@ async function runBackfill(context, seams) {
   const dir = readBackfillDirectory(context.args, seams.cwd);
   const projectRoot2 = readConsumerRoot(context.flags["project"], seams.cwd);
   const scope = backfillScopeOf(dir, projectOf11(context).home);
-  const backfillDir = join47(scope.base, BACKFILL_PATH);
+  const backfillDir = join45(scope.base, BACKFILL_PATH);
   if (mode === "propose") {
     await runPropose(context, scope, backfillDir, seams);
     return;
@@ -26005,13 +25731,13 @@ function createSkillCheckCommand(seams = DEFAULT_CHECK_SEAMS) {
 var check_default3 = createSkillCheckCommand();
 
 // src/commands/skill/demote.ts
-import { existsSync as existsSync18, mkdirSync as mkdirSync16, readFileSync as readFileSync36, statSync as statSync14, writeFileSync as writeFileSync15 } from "fs";
-import { dirname as dirname17, resolve as resolve16 } from "path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync16, readFileSync as readFileSync34, statSync as statSync14, writeFileSync as writeFileSync15 } from "fs";
+import { dirname as dirname15, resolve as resolve16 } from "path";
 
 // src/demote/apply.ts
-import { copyFileSync as copyFileSync5, existsSync as existsSync17, mkdirSync as mkdirSync15, mkdtempSync as mkdtempSync3, readdirSync as readdirSync9, readFileSync as readFileSync35, renameSync as renameSync2, rmSync as rmSync4, statSync as statSync13, unlinkSync, writeFileSync as writeFileSync14 } from "fs";
+import { copyFileSync as copyFileSync5, existsSync as existsSync15, mkdirSync as mkdirSync15, mkdtempSync as mkdtempSync3, readdirSync as readdirSync9, readFileSync as readFileSync33, renameSync as renameSync2, rmSync as rmSync4, statSync as statSync13, unlinkSync, writeFileSync as writeFileSync14 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
-import { dirname as dirname16, join as join48 } from "path";
+import { dirname as dirname14, join as join46 } from "path";
 var DEMOTION_ACTION_KINDS = [
   "demoted",
   "kept",
@@ -26032,13 +25758,13 @@ function learnedSkillName(path) {
   return base.slice(0, -MARKDOWN_EXTENSION.length);
 }
 function sourcePath(scope, path) {
-  return join48(scope.dir, ...path.split("/"));
+  return join46(scope.dir, ...path.split("/"));
 }
 function demotedPath(scope, path) {
-  return join48(scope.demotedDir, ...path.split("/"));
+  return join46(scope.demotedDir, ...path.split("/"));
 }
 function promotedPath(scope, path) {
-  return join48(scope.dir, learnedSkillName(path), SKILL_FILE);
+  return join46(scope.dir, learnedSkillName(path), SKILL_FILE);
 }
 function takenInstinctIds(dir) {
   let names;
@@ -26051,7 +25777,7 @@ function takenInstinctIds(dir) {
 }
 function readText5(path) {
   try {
-    return statSync13(path).isFile() ? readFileSync35(path, "utf8") : null;
+    return statSync13(path).isFile() ? readFileSync33(path, "utf8") : null;
   } catch {
     return null;
   }
@@ -26079,7 +25805,7 @@ function planKept(scope, row2, file) {
     return inert3(row2.path, "procedure", "kept", "procedure-shaped: left where it is, for the backfill");
   }
   const to = promotedPath(scope, row2.path);
-  if (existsSync17(to) || existsSync17(dirname16(to))) {
+  if (existsSync15(to) || existsSync15(dirname14(to))) {
     return inert3(row2.path, "procedure", "refused", `kept as a skill, but ${to} is already there`);
   }
   return {
@@ -26093,7 +25819,7 @@ function planKept(scope, row2, file) {
   };
 }
 function checkCandidate(dir, id2, text, pathDirs) {
-  const path = join48(dir, `${id2}${MARKDOWN_EXTENSION}`);
+  const path = join46(dir, `${id2}${MARKDOWN_EXTENSION}`);
   writeFileSync14(path, text, "utf8");
   const report5 = checkFile(path, "instinct", { projectRoot: null, pathDirs });
   return failureLines2(report5.issues);
@@ -26114,11 +25840,11 @@ function planDemoted(scope, row2, file, context) {
   if (failures.length > 0) {
     return inert3(row2.path, "observation", "refused", `the record ${id2} fails the checker \u2014 ${failures.join("; ")}`);
   }
-  const destination = join48(scope.instinctsDir, `${id2}${MARKDOWN_EXTENSION}`);
+  const destination = join46(scope.instinctsDir, `${id2}${MARKDOWN_EXTENSION}`);
   const kept = demotedPath(scope, row2.path);
-  if (existsSync17(destination))
+  if (existsSync15(destination))
     return inert3(row2.path, "observation", "refused", `${destination} is already there`);
-  if (existsSync17(kept))
+  if (existsSync15(kept))
     return inert3(row2.path, "observation", "refused", `${kept} is already there`);
   context.taken.push(id2);
   return {
@@ -26161,7 +25887,7 @@ function countActions(actions) {
   return counts;
 }
 function planDemotion(report5, scope, seams = DEFAULT_APPLY_SEAMS) {
-  const temp = mkdtempSync3(join48(tmpdir3(), "rafa-demote-"));
+  const temp = mkdtempSync3(join46(tmpdir3(), "rafa-demote-"));
   const taken = [...takenInstinctIds(scope.instinctsDir)];
   try {
     const actions = report5.rows.map((row2) => planRow(scope, row2, { temp, taken, seams }));
@@ -26171,7 +25897,7 @@ function planDemotion(report5, scope, seams = DEFAULT_APPLY_SEAMS) {
   }
 }
 function moveFile(move3) {
-  mkdirSync15(dirname16(move3.to), { recursive: true });
+  mkdirSync15(dirname14(move3.to), { recursive: true });
   try {
     renameSync2(move3.from, move3.to);
   } catch {
@@ -26182,7 +25908,7 @@ function moveFile(move3) {
 function applyDemotion(plan2) {
   for (const action of plan2.actions) {
     if (action.write !== null) {
-      mkdirSync15(dirname16(action.write.path), { recursive: true });
+      mkdirSync15(dirname14(action.write.path), { recursive: true });
       writeFileSync14(action.write.path, action.write.text, "utf8");
     }
     if (action.move !== null)
@@ -26280,9 +26006,9 @@ function verdictLine2(report5) {
   return `${String(report5.rows.length)} file(s): ${parts.join(", ")}`;
 }
 function previousReport(path, context) {
-  if (!existsSync18(path))
+  if (!existsSync16(path))
     return null;
-  const parsed = parseDemotionReport(readFileSync36(path, "utf8"));
+  const parsed = parseDemotionReport(readFileSync34(path, "utf8"));
   if (parsed.report !== null)
     return parsed.report;
   context.output.warn(`the report already at ${path} does not parse, so no override in it is carried forward:` + ` ${parsed.issues.map((issue2) => `line ${String(issue2.line)} ${issue2.code}`).join(", ")}`);
@@ -26291,7 +26017,7 @@ function previousReport(path, context) {
 function runWrite(context, scope) {
   const files = selectSources(scope);
   const report5 = buildDemotionReport(files, previousReport(scope.reportPath, context));
-  mkdirSync16(dirname17(scope.reportPath), { recursive: true });
+  mkdirSync16(dirname15(scope.reportPath), { recursive: true });
   writeFileSync15(scope.reportPath, writeDemotionReport(report5), "utf8");
   const result2 = {
     applied: false,
@@ -26315,10 +26041,10 @@ function runWrite(context, scope) {
     context.output.info(line);
 }
 function reviewedReport(scope) {
-  if (!existsSync18(scope.reportPath)) {
+  if (!existsSync16(scope.reportPath)) {
     throw new CommandExit(1, `\u274C No report at ${scope.reportPath}; run "rafa skill demote ${scope.dir}" first, then review it`);
   }
-  const parsed = parseDemotionReport(readFileSync36(scope.reportPath, "utf8"));
+  const parsed = parseDemotionReport(readFileSync34(scope.reportPath, "utf8"));
   if (parsed.report === null) {
     const lines = parsed.issues.map((issue2) => `   line ${String(issue2.line)} ${issue2.code}: ${issue2.message}`);
     throw new CommandExit(1, [`\u274C ${scope.reportPath} does not parse:`, ...lines].join(`
@@ -26691,7 +26417,7 @@ function statusData(sections) {
 }
 
 // src/status/sections.ts
-import { existsSync as existsSync19 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 
 // src/status/blocked-count.ts
 async function labelsCount(options) {
@@ -26951,7 +26677,7 @@ function nextOfPlace(current, epic, walk) {
   return epic?.members.some((member) => member.number === line.issue) === true ? line.issue : null;
 }
 function hasBoards(root, listing2) {
-  if (existsSync19(positionFilePath(root)))
+  if (existsSync17(positionFilePath(root)))
     return true;
   return listing2.some((issue2) => issue2.state === "OPEN" && issue2.labels.includes(ROADMAP_LABEL));
 }
@@ -27126,8 +26852,8 @@ function createStatusCommand(seams = DEFAULT_STATUS_SEAMS) {
 var status_default4 = createStatusCommand();
 
 // src/commands/stretch/end.ts
-import { existsSync as existsSync20, mkdirSync as mkdirSync17, readFileSync as readFileSync37, writeFileSync as writeFileSync16 } from "fs";
-import { dirname as dirname18, join as join49 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync17, readFileSync as readFileSync35, writeFileSync as writeFileSync16 } from "fs";
+import { dirname as dirname16, join as join47 } from "path";
 var COMMAND_NAME19 = "rafa stretch end";
 var STRETCH_END_USAGE = "rafa stretch end [--dry-run]";
 var REPORT_FILE2 = "report.md";
@@ -27135,10 +26861,10 @@ var BODY_FILE = "pr-body.md";
 var REFUSED_EXIT10 = 1;
 var FAILED_EXIT6 = 2;
 function reportPath(root, n) {
-  return join49(stretchFolder(root, n), REPORT_FILE2);
+  return join47(stretchFolder(root, n), REPORT_FILE2);
 }
 function bodyPath(root, n) {
-  return join49(stretchFolder(root, n), BODY_FILE);
+  return join47(stretchFolder(root, n), BODY_FILE);
 }
 function endTitle(n) {
   return `Stretch ${String(n)}`;
@@ -27174,11 +26900,11 @@ function requireStretchBase2(prBase) {
 }
 function readReport(root, n) {
   const path = reportPath(root, n);
-  if (!existsSync20(path)) {
+  if (!existsSync18(path)) {
     throw refusal19(`there is no ${path}: write the stretch report first, since it is the pull request's body. Nothing was run.`);
   }
   try {
-    return readFileSync37(path, "utf8");
+    return readFileSync35(path, "utf8");
   } catch (error) {
     throw refusal19(`${path} could not be read: ${messageOf(error)}. Nothing was run.`);
   }
@@ -27191,11 +26917,11 @@ function recordText(record, name2, path) {
 }
 function readStretchRecord(root, n) {
   const path = stretchRecordPath(root, n);
-  if (!existsSync20(path))
+  if (!existsSync18(path))
     return null;
   let value;
   try {
-    value = JSON.parse(readFileSync37(path, "utf8"));
+    value = JSON.parse(readFileSync35(path, "utf8"));
   } catch (error) {
     throw refusal19(`${path} could not be read as JSON: ${messageOf(error)}. Nothing was run.`);
   }
@@ -27240,7 +26966,7 @@ function putBack(context, input, merged2) {
   const path = configFilePath(input.root);
   let edit;
   try {
-    edit = withConfigSetting(readFileSync37(path, "utf8"), PR_BASE_KEY, value, path);
+    edit = withConfigSetting(readFileSync35(path, "utf8"), PR_BASE_KEY, value, path);
   } catch (error) {
     const why = error instanceof ConfigSetRefusal ? `${PR_BASE_KEY} cannot be set: ${error.message}` : `${path} could not be read: ${messageOf(error)}`;
     throw refusal19(`${why}. Nothing was set.`);
@@ -27277,7 +27003,7 @@ async function openEnd(context, input, body, seams) {
     return;
   }
   try {
-    mkdirSync17(dirname18(path), { recursive: true });
+    mkdirSync17(dirname16(path), { recursive: true });
     writeFileSync16(path, body, "utf8");
   } catch (error) {
     throw failure4(`${path} could not be written: ${messageOf(error)}. No pull request was opened.`);
@@ -27362,8 +27088,8 @@ function createUpdateStub(spec) {
 var board_default = createUpdateStub({ action: "board", summary: "apply the board's newest setup and its migrations", issue: 717 });
 
 // src/project/lock.ts
-import { existsSync as existsSync21, lstatSync as lstatSync2, readFileSync as readFileSync38, writeFileSync as writeFileSync17 } from "fs";
-import { join as join50 } from "path";
+import { existsSync as existsSync19, lstatSync as lstatSync2, readFileSync as readFileSync36, writeFileSync as writeFileSync17 } from "fs";
+import { join as join48 } from "path";
 var LOCK_FILE = "rafa.lock";
 var LOCKFILE_VERSION = 1;
 
@@ -27371,7 +27097,7 @@ class ProjectLockError extends Error {
   name = "ProjectLockError";
 }
 function lockPath(root) {
-  return join50(root, LOCK_FILE);
+  return join48(root, LOCK_FILE);
 }
 function projectLockText(version2) {
   const lock = { lockfileVersion: LOCKFILE_VERSION, rafa: version2 };
@@ -27404,14 +27130,14 @@ function lockOf(value) {
 }
 function readProjectLock(root) {
   const path = lockPath(root);
-  if (!existsSync21(path)) {
+  if (!existsSync19(path)) {
     if (isLink(path))
       refuse10("is a link to nothing");
     return null;
   }
   let text;
   try {
-    text = readFileSync38(path, "utf8");
+    text = readFileSync36(path, "utf8");
   } catch (error) {
     refuse10(`could not be read: ${messageOf(error)}`);
   }
@@ -27428,11 +27154,11 @@ function writeProjectLock(root, version2) {
 }
 
 // src/project/update-current.ts
-import { existsSync as existsSync22 } from "fs";
-import { join as join51 } from "path";
+import { existsSync as existsSync20 } from "fs";
+import { join as join49 } from "path";
 var DEPRECATIONS = Object.freeze([]);
 function missingFolders(root) {
-  return PROJECT_TREE.map((name2) => join51(SCOPE_DIR, name2)).filter((relative12) => !existsSync22(join51(root, relative12)));
+  return PROJECT_TREE.map((name2) => join49(SCOPE_DIR, name2)).filter((relative12) => !existsSync20(join49(root, relative12)));
 }
 async function readBoard3(access) {
   if (access.gh === null)
@@ -27485,7 +27211,7 @@ class UpdateStepError extends Error {
   }
 }
 function foldersNowThere(plan2) {
-  return plan2.folders.filter((relative12) => existsSync22(join51(plan2.root, relative12)));
+  return plan2.folders.filter((relative12) => existsSync20(join49(plan2.root, relative12)));
 }
 function writeFolders(plan2) {
   if (plan2.folders.length === 0)