@open-tomato/rafa 0.9.0 → 0.9.1

package/dist/index.js

@@ -1914,7 +1914,7 @@ async function report(args, repoRoot) {
   }
 }
 // package.json
-var version = "0.9.0";
+var version = "0.9.1";
 
 // src/modules/manifest.ts
 var MANIFEST_VERSION = 1;
@@ -3503,8 +3503,8 @@ function createGhIssueBoard(options) {
 }
 
 // src/board/issue.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync6, statSync as statSync4, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, resolve as resolve5 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync6, statSync as statSync5, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, resolve as resolve6 } from "path";
 
 // src/board/naming.ts
 import path2 from "path";
@@ -3584,8 +3584,72 @@ function notesPath(specsDir, issue) {
   return path2.join(specsDir, notesFileName(issue));
 }
 
+// src/board/previous-copy.ts
+import { linkSync, mkdirSync as mkdirSync2, readdirSync as readdirSync3, statSync as statSync4, unlinkSync } from "fs";
+import { basename as basename3, extname, join as join5, resolve as resolve5 } from "path";
+var PREFIX2 = "board previous copy";
+var PREVIOUS_DIR_NAME = "previous";
+var COPY_EXTENSION = ".md";
+var FIRST_SUFFIX = 2;
+function previousDir(specsDir) {
+  return join5(specsDir, PREVIOUS_DIR_NAME);
+}
+function two(value) {
+  return String(value).padStart(2, "0");
+}
+function previousTimestamp(mtime) {
+  const date = `${String(mtime.getUTCFullYear()).padStart(4, "0")}${two(mtime.getUTCMonth() + 1)}${two(mtime.getUTCDate())}`;
+  const time = `${two(mtime.getUTCHours())}${two(mtime.getUTCMinutes())}${two(mtime.getUTCSeconds())}`;
+  return `${date}T${time}Z`;
+}
+function previousCopyName(savedName, timestamp, attempt) {
+  const stem = basename3(savedName, extname(savedName));
+  const suffix = attempt < FIRST_SUFFIX ? "" : `-${String(attempt)}`;
+  return `${stem}.${timestamp}${suffix}${COPY_EXTENSION}`;
+}
+function isTaken(error) {
+  return error instanceof Error && "code" in error && error.code === "EEXIST";
+}
+function linkUnderFreeName(source, directory, savedName, timestamp) {
+  for (let attempt = 1;; attempt += 1) {
+    const name = previousCopyName(savedName, timestamp, attempt);
+    try {
+      linkSync(source, join5(directory, name));
+      return name;
+    } catch (error) {
+      if (!isTaken(error))
+        throw error;
+    }
+  }
+}
+function movePreviousCopy(options) {
+  const { repoRoot, specsDir, path: path3 } = options;
+  const source = resolve5(repoRoot, path3);
+  const directory = previousDir(specsDir);
+  const absoluteDirectory = resolve5(repoRoot, directory);
+  const savedName = basename3(path3);
+  let name;
+  try {
+    const timestamp = previousTimestamp(statSync4(source).mtime);
+    mkdirSync2(absoluteDirectory, { recursive: true });
+    name = linkUnderFreeName(source, absoluteDirectory, savedName, timestamp);
+  } catch (error) {
+    throw new Error(`${PREFIX2}: ${path3} could not be moved to ${directory}: ${messageOf(error)}`, { cause: error });
+  }
+  const moved = {
+    path: join5(directory, name),
+    absolute: join5(absoluteDirectory, name)
+  };
+  try {
+    unlinkSync(source);
+  } catch (error) {
+    throw new Error(`${PREFIX2}: ${path3} was copied to ${moved.path} but could not be removed: ${messageOf(error)}`, { cause: error });
+  }
+  return moved;
+}
+
 // src/board/issue.ts
-var PREFIX2 = "board issue";
+var PREFIX3 = "board issue";
 var ISSUE_VIEW_FIELDS = "number,title,body,state,labels,author";
 var SPEC_LABEL = "type:spec";
 var ISSUE_REFUSAL_EXIT = 2;
@@ -3596,7 +3660,7 @@ function detailOf3(result, command) {
 }
 function issueNumber2(value) {
   if (!Number.isSafeInteger(value) || value < 1) {
-    throw new TypeError(`${PREFIX2}: the read refused issue number ${describeValue(value)}, expected a positive whole number`);
+    throw new TypeError(`${PREFIX3}: the read refused issue number ${describeValue(value)}, expected a positive whole number`);
   }
   return String(value);
 }
@@ -3631,11 +3695,11 @@ function readViewedIssue(stdout, number, command) {
   try {
     payload = JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX2}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX3}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
   const problem = viewProblem(payload, number);
   if (problem !== null)
-    throw new Error(`${PREFIX2}: ${command} answered ${problem}`);
+    throw new Error(`${PREFIX3}: ${command} answered ${problem}`);
   const checked = payload;
   return {
     number,
@@ -3653,7 +3717,7 @@ function createGhSpecIssueReader(options) {
     const command = `gh issue view ${number} --json ${ISSUE_VIEW_FIELDS}`;
     const result = await gh(["issue", "view", number, "--json", ISSUE_VIEW_FIELDS]);
     if (!result.ok)
-      throw new Error(`${PREFIX2}: ${detailOf3(result, command)}`);
+      throw new Error(`${PREFIX3}: ${detailOf3(result, command)}`);
     return readViewedIssue(result.stdout, issue, command);
   };
 }
@@ -3691,10 +3755,91 @@ ${local}`
 `)}
 `;
 }
+var NOTES_SEPARATOR = `
+
+${LOCAL_NOTES_HEADING}
+
+`;
+var HEADING = /^#{1,6}(?:[ \t]|$)/u;
+var FENCE = /^ {0,3}(?:`{3,}|~{3,})/u;
+function commonLines(before, after) {
+  let previous = new Uint32Array(after.length + 1);
+  for (const line of before) {
+    const row = new Uint32Array(after.length + 1);
+    after.forEach((other, index) => {
+      row[index + 1] = line === other ? (previous[index] ?? 0) + 1 : Math.max(previous[index + 1] ?? 0, row[index] ?? 0);
+    });
+    previous = row;
+  }
+  return previous[after.length] ?? 0;
+}
+function headingName(line) {
+  const text = line.replace(/^#+/u, "").replace(/[ \t]+#+[ \t]*$/u, "").trim();
+  return text === "" ? line.trim() : text;
+}
+function headingSections(lines) {
+  const sections = new Map;
+  let fenced = false;
+  let current = null;
+  const close = () => {
+    if (current === null)
+      return;
+    sections.set(current.key, [...sections.get(current.key) ?? [], current.lines.join(`
+`)]);
+  };
+  for (const line of lines) {
+    if (FENCE.test(line))
+      fenced = !fenced;
+    if (fenced || !HEADING.test(line)) {
+      current?.lines.push(line);
+      continue;
+    }
+    close();
+    current = { key: line.trim(), lines: [] };
+  }
+  close();
+  return sections;
+}
+function changedHeadings(before, after) {
+  const old = headingSections(before);
+  const now = headingSections(after);
+  const keys = [...now.keys(), ...[...old.keys()].filter((key) => !now.has(key))];
+  const changed = keys.filter((key) => JSON.stringify(old.get(key) ?? []) !== JSON.stringify(now.get(key) ?? []));
+  return [...new Set(changed.map(headingName))];
+}
+function bodyChangeLine(before, after) {
+  const old = before.split(`
+`);
+  const now = after.split(`
+`);
+  const common = commonLines(old, now);
+  const headings = changedHeadings(old, now);
+  const clause = headings.length === 0 ? "no heading changed" : `headings changed: ${headings.join(", ")}`;
+  return `issue body: +${String(now.length - common)} -${String(old.length - common)} lines; ${clause}`;
+}
+function notesChangeLine(path3) {
+  return `local notes: ${path3} changed since the saved copy`;
+}
+function readSnapshotChange(options) {
+  const { saved, body, notes, notesPath: path3 } = options;
+  if (saved === snapshotText(body, notes))
+    return { kind: "unchanged", bodyLine: null, notesLine: null };
+  const now = normalise(body);
+  if (saved === `${now}
+` || saved.startsWith(`${now}${NOTES_SEPARATOR}`)) {
+    return { kind: "notes", bodyLine: null, notesLine: notesChangeLine(path3) };
+  }
+  const split = saved.lastIndexOf(NOTES_SEPARATOR);
+  const oldBody = split === -1 ? saved : saved.slice(0, split);
+  const oldNotes = split === -1 ? "" : normalise(saved.slice(split + NOTES_SEPARATOR.length)).trim();
+  const newNotes = notes === null ? "" : normalise(notes).trim();
+  const bodyLine = bodyChangeLine(normalise(oldBody), now);
+  return oldNotes === newNotes ? { kind: "body", bodyLine, notesLine: null } : { kind: "both", bodyLine, notesLine: notesChangeLine(path3) };
+}
 function readIfFile(file, what) {
   if (!existsSync7(file))
     return null;
-  if (!statSync4(file).isFile()) {
+  if (!statSync5(file).isFile()) {
     throw new CommandExit(ISSUE_REFUSAL_EXIT, `${what} ${file} is not a file, and a spec is one`);
   }
   try {
@@ -3704,7 +3849,7 @@ function readIfFile(file, what) {
   }
 }
 function readLocalNotes(repoRoot, specsDir, issue) {
-  return readIfFile(resolve5(repoRoot, notesPath(specsDir, issue)), "the local notes");
+  return readIfFile(resolve6(repoRoot, notesPath(specsDir, issue)), "the local notes");
 }
 function snapshotDiffersMessage(path3, issue) {
   return `${path3} is a snapshot of issue #${String(issue)} that no longer matches it:` + " the issue body, or the local notes appended to it, changed since the snapshot was written;" + ` pass ${REFRESH_FLAG} to plan from the issue as it reads now, or --spec=${path3} to plan from` + " the snapshot as it stands";
@@ -3721,27 +3866,38 @@ function writeSpecSnapshot(options) {
   }
   const local = readLocalNotes(repoRoot, specsDir, issue.number);
   const text = snapshotText(issue.body, local);
-  const absolute = resolve5(repoRoot, path3);
+  const absolute = resolve6(repoRoot, path3);
   const existing = readIfFile(absolute, "the spec snapshot");
   const written = {
     path: path3,
     absolute,
     action: "created",
     notes: local === null ? null : notes,
+    previous: null,
     text
   };
   if (existing === text)
     return { ...written, action: "unchanged" };
-  if (existing !== null && !refresh) {
+  const action = rewriteAction(existing, issue.body, local, notes, refresh);
+  if (action === null) {
     throw new CommandExit(ISSUE_REFUSAL_EXIT, snapshotDiffersMessage(path3, issue.number));
   }
+  const previous = action === "created" ? null : movePreviousCopy({ repoRoot, specsDir, path: path3 }).path;
   try {
-    mkdirSync2(dirname2(absolute), { recursive: true });
+    mkdirSync3(dirname2(absolute), { recursive: true });
     writeFileSync2(absolute, text);
   } catch (error) {
-    throw new Error(`${PREFIX2}: the snapshot ${path3} could not be written: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX3}: the snapshot ${path3} could not be written: ${messageOf(error)}`, { cause: error });
   }
-  return existing === null ? written : { ...written, action: "refreshed" };
+  return { ...written, action, previous };
+}
+function rewriteAction(existing, body, notes, notesFile, refresh) {
+  if (existing === null)
+    return "created";
+  const { kind } = readSnapshotChange({ saved: existing, body, notes, notesPath: notesFile });
+  if (kind === "notes")
+    return "notes-rebuilt";
+  return refresh ? "refreshed" : null;
 }
 
 // src/board/leak.ts
@@ -3843,7 +3999,7 @@ function requireNoLeak(source, body) {
 }
 
 // src/board/roadmap.ts
-var PREFIX3 = "board roadmap";
+var PREFIX4 = "board roadmap";
 var ROADMAP_TITLE = "Roadmap";
 var ROADMAP_SETTING = "roadmap.issue";
 var ROADMAP_REFUSAL_EXIT = 2;
@@ -3852,7 +4008,7 @@ var OPEN_PULL_REQUEST_LIMIT = 100;
 var PR_LIST_FIELDS = "number,headRefName,body";
 var ISSUE_LIST_FIELDS = "number,title";
 var TASK_LINE = /^\s*[-*+]\s+\[([ xX])\]\s+#(\d+)\s*(.*)$/u;
-var FENCE = /^\s*(?:`{3,}|~{3,})/u;
+var FENCE2 = /^\s*(?:`{3,}|~{3,})/u;
 var WHY_SEPARATOR = /^[-:,.\u2013\u2014]\s*/u;
 var CLOSING = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\b\s*:?\s*#(\d+)\b/giu;
 function whyOf(rest) {
@@ -3862,7 +4018,7 @@ function parseRoadmapBody(body) {
   let lines = [];
   let fenced = false;
   body.split(/\r\n?|\n/u).forEach((text, index) => {
-    if (FENCE.test(text)) {
+    if (FENCE2.test(text)) {
       fenced = !fenced;
       return;
     }
@@ -3893,24 +4049,24 @@ function parseRows(stdout, command) {
   try {
     payload = JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX3}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX4}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
   if (!Array.isArray(payload)) {
-    throw new Error(`${PREFIX3}: ${command} answered ${describeValue(payload)}, expected a list`);
+    throw new Error(`${PREFIX4}: ${command} answered ${describeValue(payload)}, expected a list`);
   }
   return payload;
 }
 function rowNumber(row, key, command, where) {
   const value = isMapping(row) ? row[key] : null;
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1) {
-    throw new Error(`${PREFIX3}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a positive whole number`);
+    throw new Error(`${PREFIX4}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a positive whole number`);
   }
   return value;
 }
 function rowText(row, key, command, where) {
   const value = isMapping(row) ? row[key] : null;
   if (typeof value !== "string") {
-    throw new Error(`${PREFIX3}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a string`);
+    throw new Error(`${PREFIX4}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a string`);
   }
   return value;
 }
@@ -3922,7 +4078,7 @@ function createGhRoadmapSearch(options) {
   return async () => {
     const result = await gh(args);
     if (!result.ok)
-      throw new Error(`${PREFIX3}: ${detailOf4(result, command)}`);
+      throw new Error(`${PREFIX4}: ${detailOf4(result, command)}`);
     return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
       number: rowNumber(row, "number", command, `issue ${String(index)}`),
       title: rowText(row, "title", command, `issue ${String(index)}`)
@@ -3957,7 +4113,7 @@ function createGhOpenPullRequests(options) {
   return async () => {
     const result = await gh(args);
     if (!result.ok)
-      throw new Error(`${PREFIX3}: ${detailOf4(result, command)}`);
+      throw new Error(`${PREFIX4}: ${detailOf4(result, command)}`);
     return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
       number: rowNumber(row, "number", command, `pull request ${String(index)}`),
       headRefName: rowText(row, "headRefName", command, `pull request ${String(index)}`),
@@ -4216,8 +4372,74 @@ function declinedMessage(alternative) {
   return `#${String(alternative)} was not planned, and nothing was written`;
 }
 
+// src/board/snapshot-settle.ts
+import { existsSync as existsSync8, readFileSync as readFileSync7, statSync as statSync6 } from "fs";
+import { resolve as resolve7 } from "path";
+var PREFIX5 = "board snapshot settle";
+var DATE_LENGTH = 10;
+function savedCopyDate(savedAt) {
+  return savedAt.toISOString().slice(0, DATE_LENGTH);
+}
+function refreshQuestion(issue, savedAt) {
+  return `Issue #${String(issue)} changed since the saved copy of ${savedCopyDate(savedAt)}.` + " Plan from it as it reads now? [y/N] ";
+}
+function notesRebuiltLine(path3, issue, previous) {
+  return `local notes changed; rebuilt ${path3} from issue #${String(issue)} and the notes,` + ` the old copy is at ${previous}`;
+}
+function readSavedCopy(absolute, path3) {
+  if (!existsSync8(absolute))
+    return null;
+  try {
+    const stat = statSync6(absolute);
+    if (!stat.isFile())
+      return null;
+    return { text: readFileSync7(absolute, "utf8"), savedAt: stat.mtime };
+  } catch (error) {
+    throw new Error(`${PREFIX5}: the saved copy ${path3} could not be read: ${messageOf(error)}`, { cause: error });
+  }
+}
+function printChange(change, output) {
+  for (const line of [change.bodyLine, change.notesLine]) {
+    if (line !== null)
+      output.info(line);
+  }
+}
+async function settleSpecSnapshot(options) {
+  const { repoRoot, specsDir, issue, refresh, output } = options;
+  const write = (rewrite) => writeSpecSnapshot({ repoRoot, specsDir, issue, refresh: rewrite });
+  const path3 = specPath(specsDir, issue.number, issue.title);
+  const notes = notesPath(specsDir, issue.number);
+  if (path3 === notes)
+    return write(refresh);
+  const saved = readSavedCopy(resolve7(repoRoot, path3), path3);
+  if (saved === null)
+    return write(refresh);
+  const change = readSnapshotChange({
+    saved: saved.text,
+    body: issue.body,
+    notes: readLocalNotes(repoRoot, specsDir, issue.number),
+    notesPath: notes
+  });
+  if (change.kind === "unchanged")
+    return write(refresh);
+  printChange(change, output);
+  if (change.kind === "notes") {
+    const rebuilt = write(refresh);
+    if (rebuilt.previous !== null)
+      output.info(notesRebuiltLine(rebuilt.path, issue.number, rebuilt.previous));
+    return rebuilt;
+  }
+  if (refresh)
+    return write(true);
+  const offer = options.offerRefresh ?? null;
+  const accepted = offer !== null && await offer({ issue: issue.number, path: path3, savedAt: saved.savedAt });
+  if (!accepted)
+    throw new CommandExit(ISSUE_REFUSAL_EXIT, snapshotDiffersMessage(path3, issue.number));
+  return write(true);
+}
+
 // src/board/spec-source.ts
-var PREFIX4 = "board spec source";
+var PREFIX6 = "board spec source";
 var SOURCE_FLAGS = [SPEC_FLAG, ISSUE_FLAG, NEXT_FLAG];
 var SOURCE_REFUSAL_EXIT = 1;
 function severalSourcesMessage(given) {
@@ -4336,7 +4558,7 @@ async function settleBlockedPick(options) {
 async function pickRoadmapIssue(request, options, issues, output) {
   const seams = options.roadmap;
   if (seams === undefined) {
-    throw new TypeError(`${PREFIX4}: ${NEXT_FLAG} was resolved with no roadmap seams`);
+    throw new TypeError(`${PREFIX6}: ${NEXT_FLAG} was resolved with no roadmap seams`);
   }
   const roadmap = await resolveRoadmapIssue({
     configured: request.roadmap ?? seams.configured,
@@ -4409,7 +4631,14 @@ async function resolveSpecSource(options) {
     output.info(dryRunLine(describeIssue(read)));
     return stopped("dry-run");
   }
-  const snapshot = writeSpecSnapshot({ repoRoot, specsDir, issue: read, refresh });
+  const snapshot = await settleSpecSnapshot({
+    repoRoot,
+    specsDir,
+    issue: read,
+    refresh,
+    offerRefresh: options.offerRefresh ?? null,
+    output
+  });
   return Object.freeze({
     outcome: "spec",
     spec: Object.freeze({
@@ -4482,6 +4711,7 @@ async function resolvePlanSpec(options) {
   const offer = offerReady === null || options.dryRun ? undefined : (issue) => offerReady({ issue, gh, trust: trust(), output });
   const offerAlternative = options.offerAlternative ?? null;
   const alternative = offerAlternative === null || options.dryRun ? undefined : offerAlternative;
+  const offerRefresh = options.dryRun ? null : options.offerRefresh ?? null;
   const resolution = await resolveSpecSource({
     request: options.request,
     refresh: options.refresh,
@@ -4491,6 +4721,7 @@ async function resolvePlanSpec(options) {
     findSpec: options.findSpec,
     issues: createGhSpecIssueReader({ gh }),
     inspect: (issue) => inspectSpecIssue(issue, trust(), offer),
+    offerRefresh,
     roadmap: {
       configured: options.roadmapIssue,
       search: createGhRoadmapSearch({ gh }),
@@ -4516,15 +4747,15 @@ async function resolvePlanSpec(options) {
 import { createInterface as createInterface2 } from "readline";
 
 // src/project/roots.ts
-import { accessSync, constants, readFileSync as readFileSync7, statSync as statSync5 } from "fs";
+import { accessSync, constants, readFileSync as readFileSync8, statSync as statSync7 } from "fs";
 
 // src/project/scope.ts
-import { existsSync as existsSync8, realpathSync as realpathSync2 } from "fs";
-import { dirname as dirname3, isAbsolute as isAbsolute2, join as join5 } from "path";
+import { existsSync as existsSync9, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join6 } from "path";
 var SCOPE_DIR = dirname3(CONFIG_FILE);
 var INIT_COMMAND = "rafa init";
 var DISK_FILE_SYSTEM = Object.freeze({
-  exists: (path3) => existsSync8(path3),
+  exists: (path3) => existsSync9(path3),
   realpath: (path3) => realpathSync2(path3)
 });
 
@@ -4535,7 +4766,7 @@ class ScopeError extends Error {
   }
 }
 function scopeAt(base) {
-  return { dir: join5(base, SCOPE_DIR), configFile: configFilePath(base) };
+  return { dir: join6(base, SCOPE_DIR), configFile: configFilePath(base) };
 }
 function initHint(start, passedUserConfig = null) {
   const passed2 = passedUserConfig === null ? [] : [`${passedUserConfig} is the user scope's config and marks no project`];
@@ -4612,8 +4843,8 @@ var MONOREPO_MARKER_FILES = Object.freeze([
 ]);
 var DISK_ROOTS_FILE_SYSTEM = Object.freeze({
   ...DISK_FILE_SYSTEM,
-  readFile: (path3) => readFileSync7(path3, "utf8"),
-  isDirectory: (path3) => statSync5(path3).isDirectory(),
+  readFile: (path3) => readFileSync8(path3, "utf8"),
+  isDirectory: (path3) => statSync7(path3).isDirectory(),
   assertWritable: (path3) => accessSync(path3, constants.W_OK)
 });
 
@@ -4731,8 +4962,8 @@ function formatRows(rows) {
 `);
 }
 function defaultSleep(ms) {
-  return new Promise((resolve6) => {
-    setTimeout(resolve6, ms);
+  return new Promise((resolve8) => {
+    setTimeout(resolve8, ms);
   });
 }
 async function waitForChecks(options) {
@@ -4877,7 +5108,7 @@ function compareUrl(remote, branch) {
   return `https://${segments[0] ?? host}/${path3}/compare/${encodeBranch(branch)}${COMPARE_QUERY}`;
 }
 // src/pr/gh.ts
-var PREFIX5 = "gh pull requests";
+var PREFIX7 = "gh pull requests";
 var REPO_PATH3 = "{owner}/{repo}";
 var SUMMARY_FIELDS = "author,baseRefName,headRefName,isCrossRepository,number,state,title,updatedAt,url";
 var DETAIL_FIELDS = `${SUMMARY_FIELDS},body,headRefOid,labels,mergeStateStatus,mergeable`;
@@ -4906,16 +5137,16 @@ function detailOf5(result, command) {
   return result.ok ? `${command} exited 0 and wrote nothing` : `${command} exited non-zero and wrote nothing`;
 }
 function failure2(command, result) {
-  return new Error(`${PREFIX5}: ${command} failed: ${detailOf5(result, command)}`);
+  return new Error(`${PREFIX7}: ${command} failed: ${detailOf5(result, command)}`);
 }
 function refuse3(command, problem) {
-  throw new Error(`${PREFIX5}: ${command} answered ${problem}`);
+  throw new Error(`${PREFIX7}: ${command} answered ${problem}`);
 }
 function parseJson2(stdout, command) {
   try {
     return JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX5}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX7}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
 }
 function readString2(value, command, where) {
@@ -5018,7 +5249,7 @@ function readWorkflowCount(stdout) {
 }
 function pullNumber(value, member) {
   if (!Number.isSafeInteger(value) || value < 1) {
-    throw new TypeError(`${PREFIX5}: ${member} refused pull request number ${describeValue(value)},` + " expected a positive whole number");
+    throw new TypeError(`${PREFIX7}: ${member} refused pull request number ${describeValue(value)},` + " expected a positive whole number");
   }
   return String(value);
 }
@@ -5026,13 +5257,13 @@ function textArgument(value, member, what, whole) {
   const bad = typeof value !== "string" || value === "" || whole && !(WHOLE_NUMBER.test(value) && Number.isSafeInteger(Number(value)));
   if (bad) {
     const expected2 = whole ? "a positive whole number with no leading zero" : "a non-empty string";
-    throw new TypeError(`${PREFIX5}: ${member} refused ${what} ${describeValue(value)}, expected ${expected2}`);
+    throw new TypeError(`${PREFIX7}: ${member} refused ${what} ${describeValue(value)}, expected ${expected2}`);
   }
   return value;
 }
 function bodyText(value, member) {
   if (typeof value !== "string") {
-    throw new TypeError(`${PREFIX5}: ${member} refused a body ${describeValue(value)}, expected a string`);
+    throw new TypeError(`${PREFIX7}: ${member} refused a body ${describeValue(value)}, expected a string`);
   }
   return value;
 }
@@ -5102,7 +5333,7 @@ function createGhPullRequests(options) {
     merge: async (number, method) => {
       const target = pullNumber(number, "merge");
       if (!isMergeMethod(method)) {
-        throw new TypeError(`${PREFIX5}: merge refused method ${describeValue(method)},` + ` expected one of: ${MERGE_METHODS.join(", ")}`);
+        throw new TypeError(`${PREFIX7}: merge refused method ${describeValue(method)},` + ` expected one of: ${MERGE_METHODS.join(", ")}`);
       }
       const command = `gh pr merge ${target} --${method}`;
       const result = await gh(["pr", "merge", target, `--${method}`]);
@@ -5418,19 +5649,19 @@ function parseArgs(argv, spec = {}) {
 
 // src/commands/loop/loop-sessions.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { join as join7, relative } from "path";
+import { join as join8, relative } from "path";
 
 // src/loop/sessions.ts
 import {
-  linkSync,
-  mkdirSync as mkdirSync3,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync8,
+  linkSync as linkSync2,
+  mkdirSync as mkdirSync4,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync9,
   renameSync as renameSync2,
   rmSync,
   writeFileSync as writeFileSync3
 } from "fs";
-import { basename as basename3, dirname as dirname4, join as join6 } from "path";
+import { basename as basename4, dirname as dirname4, join as join7 } from "path";
 var SESSION_STATES = Object.freeze(["running", "paused", "stopped", "done"]);
 var RUNS_DIR = "runs";
 var RECORD_EXTENSION = ".json";
@@ -5470,13 +5701,13 @@ function isSessionId(value) {
   return SESSION_ID_PATTERN.test(value);
 }
 function runsDir(root) {
-  return join6(scopeAt(root).dir, RUNS_DIR);
+  return join7(scopeAt(root).dir, RUNS_DIR);
 }
 function sessionFilePath(root, sessionId) {
   if (!isSessionId(sessionId)) {
     throw new Error(`session record: unusable session id ${JSON.stringify(sessionId)}`);
   }
-  return join6(runsDir(root), `${sessionId}${RECORD_EXTENSION}`);
+  return join7(runsDir(root), `${sessionId}${RECORD_EXTENSION}`);
 }
 function describeValue3(value) {
   return value === undefined ? "missing" : JSON.stringify(value) ?? String(value);
@@ -5507,7 +5738,7 @@ function sessionIdProblem(sessionId, file) {
   if (typeof sessionId !== "string" || !isSessionId(sessionId)) {
     return `sessionId is ${describeValue3(sessionId)}, expected a plain file name`;
   }
-  return basename3(file) === `${sessionId}${RECORD_EXTENSION}` ? null : `sessionId ${JSON.stringify(sessionId)} is not the file's name`;
+  return basename4(file) === `${sessionId}${RECORD_EXTENSION}` ? null : `sessionId ${JSON.stringify(sessionId)} is not the file's name`;
 }
 function planStubProblem(planStub2) {
   return planStub2 === null || typeof planStub2 === "string" && isStampableStub(planStub2) ? null : `planStub is ${describeValue3(planStub2)}, expected null or a plan stub`;
@@ -5578,7 +5809,7 @@ function readState2(record, isAlive = isPidAlive) {
 function readRecordFile(file) {
   let text;
   try {
-    text = readFileSync8(file, "utf8");
+    text = readFileSync9(file, "utf8");
   } catch (error) {
     throw new SessionRecordError(file, `cannot be read: ${messageOf(error)}`);
   }
@@ -5586,7 +5817,7 @@ function readRecordFile(file) {
 }
 function recordNames(dir) {
   try {
-    return readdirSync3(dir);
+    return readdirSync4(dir);
   } catch (error) {
     if (errorCode(error) === "ENOENT")
       return [];
@@ -5599,7 +5830,7 @@ function byStart(a, b) {
 function readSessions(root, seams = {}) {
   const dir = runsDir(root);
   const isAlive = seams.isAlive ?? isPidAlive;
-  const records = recordNames(dir).filter((name) => name.endsWith(RECORD_EXTENSION)).map((name) => readRecordFile(join6(dir, name))).map((record) => Object.freeze({ ...record, state: readState2(record, isAlive) }));
+  const records = recordNames(dir).filter((name) => name.endsWith(RECORD_EXTENSION)).map((name) => readRecordFile(join7(dir, name))).map((record) => Object.freeze({ ...record, state: readState2(record, isAlive) }));
   return Object.freeze(records.sort(byStart));
 }
 function readSession(root, sessionId, seams = {}) {
@@ -5625,13 +5856,13 @@ function checkRecord(record, file) {
 }
 function writeRecordFile(file, record, isNew) {
   checkRecord(record, file);
-  mkdirSync3(dirname4(file), { recursive: true });
+  mkdirSync4(dirname4(file), { recursive: true });
   const temporary = `${file}.${process.pid}.tmp`;
   writeFileSync3(temporary, `${JSON.stringify(record, null, 2)}
 `);
   try {
     if (isNew)
-      linkSync(temporary, file);
+      linkSync2(temporary, file);
     else
       renameSync2(temporary, file);
   } finally {
@@ -5708,7 +5939,7 @@ function readRecords(root, seams) {
 }
 
 // src/next/sources.ts
-var PREFIX6 = "rafa next";
+var PREFIX8 = "rafa next";
 var DEFAULT_BASE_BRANCH = "main";
 var DEFAULT_NEXT_SOURCE_SEAMS = Object.freeze({});
 function memoiseIssues2(issues) {
@@ -5746,7 +5977,7 @@ function ghNextBoard(options) {
 }
 function nextProject(context) {
   if (context.project === null)
-    throw new Error(`${PREFIX6} runs inside a project, and was handed none`);
+    throw new Error(`${PREFIX8} runs inside a project, and was handed none`);
   return context.project;
 }
 function nextConfig(project, warn) {
@@ -5756,7 +5987,7 @@ function nextConfig(project, warn) {
     if (!(error instanceof ConfigError))
       throw error;
     throw new CommandExit(1, [
-      `\u274C ${PREFIX6}: the config cannot be used:`,
+      `\u274C ${PREFIX8}: the config cannot be used:`,
       ...error.problems.map((problem) => `   ${problem}`)
     ].join(`
 `));
@@ -5786,22 +6017,22 @@ function openNextSources(context, seams = DEFAULT_NEXT_SOURCE_SEAMS) {
 }
 
 // src/commands/plan/list.ts
-import { existsSync as existsSync9, readdirSync as readdirSync4, readFileSync as readFileSync9 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync10, readdirSync as readdirSync5, readFileSync as readFileSync10 } from "fs";
+import { join as join9 } from "path";
 var USAGE2 = "rafa plan list";
 function listing(dir, stub) {
-  const plan = join8(dir, planFileName(stub, false));
-  const trackerPath = join8(dir, planFileName(stub, true));
+  const plan = join9(dir, planFileName(stub, false));
+  const trackerPath = join9(dir, planFileName(stub, true));
   const tracker = isFile(trackerPath) ? trackerPath : null;
-  const planModel = parsePlan(readFileSync9(plan, "utf8"));
-  const counted2 = tracker === null ? planModel : parsePlan(readFileSync9(tracker, "utf8"));
+  const planModel = parsePlan(readFileSync10(plan, "utf8"));
+  const counted2 = tracker === null ? planModel : parsePlan(readFileSync10(tracker, "utf8"));
   return { stub, plan, tracker, tasks: countTasks(counted2.tasks), issues: planModel.issues.length };
 }
 function listPlans(plans) {
   const dir = plans.path;
-  if (!existsSync9(dir))
+  if (!existsSync10(dir))
     return { dir, plans: [] };
-  const stubs = readdirSync4(dir).filter((name) => isFile(join8(dir, name))).map((name) => stubOfPlanFile(name)).filter((stub) => stub !== null).sort((a, b) => a.localeCompare(b));
+  const stubs = readdirSync5(dir).filter((name) => isFile(join9(dir, name))).map((name) => stubOfPlanFile(name)).filter((stub) => stub !== null).sort((a, b) => a.localeCompare(b));
   return { dir, plans: stubs.map((stub) => listing(dir, stub)) };
 }
 function rowNotes(plan) {
@@ -5996,7 +6227,7 @@ function branchLabel(world) {
 }
 
 // src/next/state.ts
-var PREFIX7 = "rafa next";
+var PREFIX9 = "rafa next";
 var MAX_NAMED_FILES = 5;
 var NEXT_PRECONDITIONS = Object.freeze([
   "tree-modified",
@@ -6274,7 +6505,7 @@ async function readNextState(sources) {
     if (found !== null)
       return answer(found, world.problems());
   }
-  throw new Error(`${PREFIX7}: no row of the table answered, and the last row answers for every reading`);
+  throw new Error(`${PREFIX9}: no row of the table answered, and the last row answers for every reading`);
 }
 
 // src/next/hint.ts
@@ -6300,8 +6531,8 @@ function wantsHint(flags) {
 }
 var DEFAULT_HINT_SEAMS = Object.freeze({});
 function afterDelay(ms) {
-  return new Promise((resolve6) => {
-    setTimeout(resolve6, ms).unref();
+  return new Promise((resolve8) => {
+    setTimeout(resolve8, ms).unref();
   });
 }
 function silenced() {
@@ -6355,10 +6586,10 @@ async function nextStepHint(context, seams = DEFAULT_HINT_SEAMS) {
 }
 
 // src/next/actions.ts
-var PREFIX8 = "rafa next";
+var PREFIX10 = "rafa next";
 function needed(state, value, what) {
   if (value === null) {
-    throw new Error(`${PREFIX8}: state "${state.id}" proposes "${state.action}" and names no ${what}`);
+    throw new Error(`${PREFIX10}: state "${state.id}" proposes "${state.action}" and names no ${what}`);
   }
   return String(value);
 }
@@ -6408,12 +6639,12 @@ function actionContext(caller, command, argv) {
 async function runAction(caller, state) {
   const invocation = actionInvocation(state);
   if (invocation === null) {
-    throw new Error(`${PREFIX8}: the action "${state.action}" of state "${state.id}" runs no registered command`);
+    throw new Error(`${PREFIX10}: the action "${state.action}" of state "${state.id}" runs no registered command`);
   }
   const spec = ACTION_COMMANDS[invocation.action];
   const command = caller.registry.find(spec.subject, spec.action);
   if (command === undefined) {
-    throw new CommandExit(1, `\u274C ${PREFIX8}: the "${invocation.action}" step runs "rafa ${invocation.command}", which is registered by nothing`);
+    throw new CommandExit(1, `\u274C ${PREFIX10}: the "${invocation.action}" step runs "rafa ${invocation.command}", which is registered by nothing`);
   }
   await command.run(actionContext(caller, command, invocation.argv));
 }
@@ -6452,7 +6683,7 @@ async function endWithNextStep(context, seams = DEFAULT_ENDING_SEAMS) {
 }
 
 // src/adapters/tracker/resolve.ts
-var PREFIX9 = "tracker chain";
+var PREFIX11 = "tracker chain";
 var FAILURE_SEPARATOR = "; ";
 function warnThroughActiveOutput(message) {
   activeOutput().warn(message);
@@ -6493,9 +6724,9 @@ async function resolveTracker(options) {
     }
     attempts = [...attempts, Object.freeze({ kind, ok: false, reason: outcome.reason })];
     failures = [...failures, `${kind}: ${outcome.reason}`];
-    log(`${PREFIX9}: ${kind} unavailable: ${outcome.reason}`);
+    log(`${PREFIX11}: ${kind} unavailable: ${outcome.reason}`);
   }
-  throw new Error(`${PREFIX9}: no tracker available; tried ${failures.join(FAILURE_SEPARATOR)}`);
+  throw new Error(`${PREFIX11}: no tracker available; tried ${failures.join(FAILURE_SEPARATOR)}`);
 }
 
 // src/commands/issue/issue-tracker.ts
@@ -6738,6 +6969,23 @@ function createPlanReadyOffer(seams = DEFAULT_OFFER_SEAMS) {
   };
 }
 
+// src/commands/plan/refresh-offer.ts
+var DEFAULT_REFRESH_OFFER_SEAMS = Object.freeze({});
+function createPlanRefreshOffer(seams = DEFAULT_REFRESH_OFFER_SEAMS) {
+  const isTerminal = seams.isTerminal ?? (() => process.stdin.isTTY === true);
+  if (!isTerminal())
+    return null;
+  const openPrompter = seams.openPrompter ?? (() => createLinePrompter(process.stdin, process.stderr));
+  return async (request) => {
+    const prompter = lazyPrompter(openPrompter);
+    try {
+      return await prompter.ask(refreshQuestion(request.issue, request.savedAt));
+    } finally {
+      prompter.close();
+    }
+  };
+}
+
 // src/commands/plan/spec-route.ts
 function specCandidates(specArg, specsDir) {
   if (path3.isAbsolute(specArg))
@@ -6767,10 +7015,11 @@ async function resolveCreateSpec(options, seams = DEFAULT_ROUTE_SEAMS) {
   const source = readSpecSourceFlags(options.args);
   if (source.request === null)
     throw new CommandExit(SOURCE_REFUSAL_EXIT, usageRefusal(specsDir));
-  const resolve6 = seams.resolve ?? resolvePlanSpec;
+  const resolve8 = seams.resolve ?? resolvePlanSpec;
   const makeReadyOffer = seams.makeReadyOffer ?? createPlanReadyOffer;
   const makeAlternativeOffer = seams.makeAlternativeOffer ?? createPlanBlockedOffer;
-  return await resolve6({
+  const makeRefreshOffer = seams.makeRefreshOffer ?? createPlanRefreshOffer;
+  return await resolve8({
     request: source.request,
     refresh: source.refresh,
     dryRun: source.dryRun,
@@ -6780,7 +7029,8 @@ async function resolveCreateSpec(options, seams = DEFAULT_ROUTE_SEAMS) {
     trustedAuthors: options.trustedAuthors,
     findSpec: (spec) => findSpec(repoRoot, spec, specsDir),
     offerReady: makeReadyOffer(),
-    offerAlternative: makeAlternativeOffer()
+    offerAlternative: makeAlternativeOffer(),
+    offerRefresh: makeRefreshOffer()
   });
 }
 
@@ -6791,13 +7041,13 @@ import { homedir as homedir3 } from "os";
 var RAFA_VERSION = version;
 
 // src/notices/notices.ts
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync10, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname5, join as join9 } from "path";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname5, join as join10 } from "path";
 var NOTICE_IDS = Object.freeze(["alpha", "danger"]);
 var FEEDBACK_URL = "https://github.com/open-tomato/rafa/issues/new/choose";
 var ROADMAP_URL = "https://github.com/open-tomato/rafa/issues/31";
 function noticesPath(home) {
-  return join9(home, ".rafa", "notices.json");
+  return join10(home, ".rafa", "notices.json");
 }
 function isNoticeId(value) {
   return typeof value === "string" && NOTICE_IDS.includes(value);
@@ -6805,7 +7055,7 @@ function isNoticeId(value) {
 function readDismissed(home) {
   let raw;
   try {
-    raw = readFileSync10(noticesPath(home), "utf8");
+    raw = readFileSync11(noticesPath(home), "utf8");
   } catch {
     return [];
   }
@@ -6824,7 +7074,7 @@ function readDismissed(home) {
 function writeDismissed(home, ids) {
   const all = NOTICE_IDS.filter((id) => ids.includes(id) || readDismissed(home).includes(id));
   const path4 = noticesPath(home);
-  mkdirSync4(dirname5(path4), { recursive: true });
+  mkdirSync5(dirname5(path4), { recursive: true });
   writeFileSync4(path4, `${JSON.stringify({ dismissed: all }, null, 2)}
 `);
 }
@@ -7514,7 +7764,7 @@ import { randomUUID as randomUUID7 } from "crypto";
 
 // src/effort/store/absences.ts
 import { randomUUID as randomUUID3 } from "crypto";
-import { existsSync as existsSync10 } from "fs";
+import { existsSync as existsSync11 } from "fs";
 var ABSENCE_REASONS = {
   "no-block": true,
   "unclosed-block": true,
@@ -7573,13 +7823,13 @@ function writeReportAbsence(repoRoot, write, seams = {}) {
     write.outcome,
     collectedAt
   ];
-  const appended = withSqliteStore(path5, !existsSync10(path5), (db) => db.query(INSERT_ABSENCE).run(...values).changes);
+  const appended = withSqliteStore(path5, !existsSync11(path5), (db) => db.query(INSERT_ABSENCE).run(...values).changes);
   return { path: path5, appended, skipped: 1 - appended };
 }
 
 // src/effort/store/changes.ts
 import { randomUUID as randomUUID4 } from "crypto";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 var INSERT_CHANGE = `
   INSERT INTO changes (
     id, session_id, plan_stub, task_line,
@@ -7658,7 +7908,7 @@ var SELECT_PLAN_CHANGES = `
 `;
 function readPlanChanges(repoRoot, planStub2) {
   const path5 = sqliteStorePath(repoRoot);
-  if (!existsSync11(path5))
+  if (!existsSync12(path5))
     return [];
   const rows = withSqliteStore(path5, false, (db) => db.query(SELECT_PLAN_CHANGES).all(planStub2));
   return rows.map((row) => ({
@@ -7891,8 +8141,8 @@ function describeTaskReportRecord(record) {
 }
 
 // src/utils/progress.ts
-import { existsSync as existsSync12, writeFileSync as writeFileSync5 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync13, writeFileSync as writeFileSync5 } from "fs";
+import { join as join11 } from "path";
 var PROGRESS_FILE_NAME = "progress.txt";
 var PROGRESS_CAP_BYTES = 16000;
 var LISTED_FIELDS = [
@@ -7934,7 +8184,7 @@ var ESCAPED_CODE_POINTS = new Set([
   8233
 ]);
 function progressFilePath(repoRoot) {
-  return join10(repoRoot, PROGRESS_FILE_NAME);
+  return join11(repoRoot, PROGRESS_FILE_NAME);
 }
 function escapeValue(value) {
   let escaped = "";
@@ -7995,7 +8245,7 @@ function renderProgressText(findings, capBytes = PROGRESS_CAP_BYTES) {
 }
 function readProgressFindings(repoRoot, planStub2) {
   const path5 = sqliteStorePath(repoRoot);
-  if (!existsSync12(path5))
+  if (!existsSync13(path5))
     return [];
   const rows = withSqliteStore(path5, false, (db) => {
     const query = db.query(SELECT_FINDINGS);
@@ -8022,16 +8272,16 @@ function writeProgress(repoRoot, planStub2) {
 
 // src/start/preflight.ts
 import { randomUUID as randomUUID6 } from "crypto";
-import { existsSync as existsSync13, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync13 } from "fs";
 import { homedir as homedir5 } from "os";
-import { basename as basename4 } from "path";
+import { basename as basename5 } from "path";
 
 // src/preflight/first-dispatch.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 var TICKED_TASK = /^- \[[xX]\] (.+)/;
 function readIfReadable(path5) {
   try {
-    return readFileSync11(path5, "utf8");
+    return readFileSync12(path5, "utf8");
   } catch {
     return null;
   }
@@ -8064,11 +8314,11 @@ function knownMissingNotice(lines) {
 }
 function agentSourcePath(planPath) {
   const tracker = trackerPathFor(planPath);
-  return existsSync13(tracker) ? tracker : planPath;
+  return existsSync14(tracker) ? tracker : planPath;
 }
 function readIfReadable2(path5) {
   try {
-    return readFileSync12(path5, "utf8");
+    return readFileSync13(path5, "utf8");
   } catch {
     return null;
   }
@@ -8084,7 +8334,7 @@ function refuseUnresolvableAgents(options) {
   if (missing.length === 0)
     return;
   throw new CommandExit(1, [
-    `\u274C Refusing to start: ${basename4(path5)} names ${missing.length} agent(s) no loaded scope` + ` defines (loop.settingSources: ${settingSources.join(", ")}).`,
+    `\u274C Refusing to start: ${basename5(path5)} names ${missing.length} agent(s) no loaded scope` + ` defines (loop.settingSources: ${settingSources.join(", ")}).`,
     ...missing.map((agent) => `   ${missingAgentLine(agent)}`),
     "   Nothing was checked and nothing was dispatched."
   ].join(`
@@ -8117,7 +8367,7 @@ function skippedStartLine(item, tracker) {
   return `\u23ED start-only item ${item.kind} ${JSON.stringify(item.name)} was not checked:` + " it is probed on a first dispatch alone," + ` and ${tracker} already holds a ticked task`;
 }
 function announceSkippedStart(planPath, skipped) {
-  const tracker = basename4(trackerPathFor(planPath));
+  const tracker = basename5(trackerPathFor(planPath));
   const output = activeOutput();
   for (const [index, item] of skipped.entries()) {
     const lead = index === 0 ? `
@@ -8136,7 +8386,7 @@ function startTier(planPath, items) {
 function announceReminders(planPath, reminders) {
   if (reminders.length === 0)
     return;
-  const file = basename4(prerequisitesPathForPlan(planPath) ?? planPath);
+  const file = basename5(prerequisitesPathForPlan(planPath) ?? planPath);
   const output = activeOutput();
   output.info(`
 \uD83D\uDCCC ${file} names ${reminders.length} step(s) the preflight does not check:`);
@@ -8372,14 +8622,14 @@ async function holdWhilePaused(options) {
 }
 
 // src/start/plan-path.ts
-import { existsSync as existsSync14 } from "fs";
-import { resolve as resolve6 } from "path";
+import { existsSync as existsSync15 } from "fs";
+import { resolve as resolve8 } from "path";
 var DEFAULT_PLAN_FILE = "PLAN.md";
 function resolvePlanPath(repoRoot, planDir, planArg) {
   if (planArg)
-    return resolve6(repoRoot, planArg);
-  const inPlanDir = resolve6(repoRoot, planDir, DEFAULT_PLAN_FILE);
-  return existsSync14(inPlanDir) ? inPlanDir : resolve6(repoRoot, DEFAULT_PLAN_FILE);
+    return resolve8(repoRoot, planArg);
+  const inPlanDir = resolve8(repoRoot, planDir, DEFAULT_PLAN_FILE);
+  return existsSync15(inPlanDir) ? inPlanDir : resolve8(repoRoot, DEFAULT_PLAN_FILE);
 }
 
 // src/utils/git.ts
@@ -8562,7 +8812,7 @@ async function handleRedChecks(io, branch, prNumber, rows) {
 }
 
 // src/release/prepare.ts
-import { readFileSync as readFileSync14, writeFileSync as writeFileSync7 } from "fs";
+import { readFileSync as readFileSync15, writeFileSync as writeFileSync7 } from "fs";
 
 // src/release/changelog.ts
 var RELEASE_HEADING_FIELDS = ["version", "date", "title"];
@@ -8747,17 +8997,17 @@ function changelogDate(now) {
 }
 
 // src/release/enabled.ts
-import { statSync as statSync6 } from "fs";
-import { resolve as resolve7 } from "path";
+import { statSync as statSync8 } from "fs";
+import { resolve as resolve9 } from "path";
 function isRegularFile(full) {
   try {
-    return statSync6(full).isFile();
+    return statSync8(full).isFile();
   } catch {
     return false;
   }
 }
 function readFile(repoRoot, path5) {
-  const resolved = resolve7(repoRoot, path5);
+  const resolved = resolve9(repoRoot, path5);
   return { path: path5, resolved, present: isRegularFile(resolved) };
 }
 function resolveReleaseEnabled(settings, repoRoot) {
@@ -8794,7 +9044,7 @@ function resolveReleaseLevel(declared, notes) {
 }
 
 // src/release/version.ts
-import { readFileSync as readFileSync13, writeFileSync as writeFileSync6 } from "fs";
+import { readFileSync as readFileSync14, writeFileSync as writeFileSync6 } from "fs";
 var RELEASE_REMOTE = "origin";
 var RELEASE_BASE_BRANCH = "main";
 var VERSION_SHAPE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$/;
@@ -8886,7 +9136,7 @@ function writeManifestVersion(path5, next) {
   const unwritten = { path: path5, written: false, previous: null, version: next };
   let text;
   try {
-    text = readFileSync13(path5, "utf8");
+    text = readFileSync14(path5, "utf8");
   } catch (error) {
     return { ...unwritten, problem: `${path5} could not be read: ${messageOf(error)}` };
   }
@@ -8989,7 +9239,7 @@ function planVersion(input, versionFile, level) {
 }
 function textOf(path5) {
   try {
-    return readFileSync14(path5, "utf8");
+    return readFileSync15(path5, "utf8");
   } catch {
     return null;
   }
@@ -9102,7 +9352,7 @@ function changelogFailure(failed3, versionEdit, restored) {
 }
 
 // src/release/verify.ts
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "fs";
+import { readFileSync as readFileSync16, writeFileSync as writeFileSync8 } from "fs";
 function changelogInsertionSpan(before, after) {
   const beforeLines = before.split(`
 `);
@@ -9119,7 +9369,7 @@ function changelogInsertionSpan(before, after) {
 }
 function textOf2(path5) {
   try {
-    return readFileSync15(path5, "utf8");
+    return readFileSync16(path5, "utf8");
   } catch {
     return null;
   }
@@ -9601,11 +9851,11 @@ function announcePlanIssues(planContent) {
 }
 
 // src/start/runtime.ts
-import { existsSync as existsSync15, readdirSync as readdirSync5, realpathSync as realpathSync3, statSync as statSync7 } from "fs";
+import { existsSync as existsSync16, readdirSync as readdirSync6, realpathSync as realpathSync3, statSync as statSync9 } from "fs";
 import { homedir as homedir6 } from "os";
-import { isAbsolute as isAbsolute3, join as join11, relative as relative3, resolve as resolve8, sep } from "path";
+import { isAbsolute as isAbsolute3, join as join12, relative as relative3, resolve as resolve10, sep } from "path";
 var RUNTIME_FLAG = "--runtime";
-var RUNTIME_SUBDIR = join11(".rafa", "runtime");
+var RUNTIME_SUBDIR = join12(".rafa", "runtime");
 var RUNTIME_ENTRY = "cli.js";
 var SOURCE_DIR = "src";
 var RUNTIME_COMMAND = ["start"];
@@ -9622,7 +9872,7 @@ function resolveRuntime(value, places) {
     throw refusal3([`\u274C Refusing to start: \`--runtime\` names no runtime. Spell it ${SPELLING}.`]);
   }
   const isVersion = VERSION_SHAPE2.test(value);
-  const named = isVersion ? join11(places.home, RUNTIME_SUBDIR, value, RUNTIME_ENTRY) : resolve8(places.cwd, value);
+  const named = isVersion ? join12(places.home, RUNTIME_SUBDIR, value, RUNTIME_ENTRY) : resolve10(places.cwd, value);
   refuseInsideSource(value, named, places);
   const entry = entryOf(value, named, isVersion, places.home);
   const real = realpathSync3(entry);
@@ -9633,7 +9883,7 @@ function entryOf(value, named, isVersion, home) {
   if (isVersion) {
     if (isFile2(named))
       return named;
-    const root = join11(home, RUNTIME_SUBDIR);
+    const root = join12(home, RUNTIME_SUBDIR);
     const installed = installedVersions(root);
     throw refusal3([
       `\u274C Refusing to start: \`--runtime=${value}\` names no installed runtime: ${named} is no file.`,
@@ -9642,7 +9892,7 @@ function entryOf(value, named, isVersion, home) {
   }
   if (isFile2(named))
     return named;
-  const inside = join11(named, RUNTIME_ENTRY);
+  const inside = join12(named, RUNTIME_ENTRY);
   if (isDirectory(named) && isFile2(inside))
     return inside;
   throw refusal3([
@@ -9660,8 +9910,8 @@ function refuseInsideSource(value, path5, places) {
   ]);
 }
 function sourceDirs({ cwd, root }) {
-  const dirs = [join11(cwd, SOURCE_DIR), join11(root, SOURCE_DIR)];
-  const real = dirs.filter((dir) => existsSync15(dir)).map((dir) => realpathSync3(dir));
+  const dirs = [join12(cwd, SOURCE_DIR), join12(root, SOURCE_DIR)];
+  const real = dirs.filter((dir) => existsSync16(dir)).map((dir) => realpathSync3(dir));
   return [...new Set([...dirs, ...real])];
 }
 function isInside(path5, dir) {
@@ -9670,21 +9920,21 @@ function isInside(path5, dir) {
 }
 function installedVersions(root) {
   try {
-    return readdirSync5(root).filter((name) => isFile2(join11(root, name, RUNTIME_ENTRY))).sort((a, b) => a.localeCompare(b));
+    return readdirSync6(root).filter((name) => isFile2(join12(root, name, RUNTIME_ENTRY))).sort((a, b) => a.localeCompare(b));
   } catch {
     return [];
   }
 }
 function isFile2(path5) {
   try {
-    return statSync7(path5).isFile();
+    return statSync9(path5).isFile();
   } catch {
     return false;
   }
 }
 function isDirectory(path5) {
   try {
-    return statSync7(path5).isDirectory();
+    return statSync9(path5).isDirectory();
   } catch {
     return false;
   }
@@ -9715,7 +9965,7 @@ function realOrResolved(path5) {
   try {
     return realpathSync3(path5);
   } catch {
-    return resolve8(path5);
+    return resolve10(path5);
   }
 }
 async function runRuntime(entry, words, run) {
@@ -9801,11 +10051,11 @@ function eventOf(line) {
 }
 
 // src/triage/triage.ts
-import { basename as basename5, join as join12 } from "path";
+import { basename as basename6, join as join13 } from "path";
 
 // src/effort/store/tracker-refs.ts
 import { randomUUID as randomUUID9 } from "crypto";
-import { existsSync as existsSync16 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 var SELECT_HELD = `
   SELECT seq, tracker_ref FROM findings
   WHERE session_id = ? AND artifact = ?
@@ -9928,7 +10178,7 @@ function writeTrackerRef(repoRoot, write, seams = {}) {
     wanted.json,
     collectedAt
   ];
-  const [action, stored] = withSqliteStore(path5, !existsSync16(path5), (db) => {
+  const [action, stored] = withSqliteStore(path5, !existsSync17(path5), (db) => {
     const place = db.transaction(() => placeRef(db, path5, write, wanted, insertValues));
     return place.immediate();
   });
@@ -9937,14 +10187,14 @@ function writeTrackerRef(repoRoot, write, seams = {}) {
 function readTrackerRef(repoRoot, artifact) {
   checkArtifact("read", artifact);
   const path5 = sqliteStorePath(repoRoot);
-  if (!existsSync16(path5))
+  if (!existsSync17(path5))
     return null;
   const oldest = withSqliteStore(path5, false, (db) => db.query(SELECT_OLDEST).get(artifact));
   return oldest === null ? null : heldRefOf(path5, oldest.seq, oldest.tracker_ref).ref;
 }
 
 // src/triage/triage.ts
-var PRIVATE_TRIAGE_DIR = join12(".rafa", "triage", "private");
+var PRIVATE_TRIAGE_DIR = join13(".rafa", "triage", "private");
 var SECRET_ENV_NAMES = ["GITHUB_TOKEN", "ANTHROPIC_API_KEY", "LINEAR_API_KEY"];
 var TRIAGE_MODULE = "unassigned";
 var BLOCKER_SEPARATOR = "; ";
@@ -9955,7 +10205,7 @@ var MIN_FENCE_LENGTH = 3;
 var ISSUE_OPENING = "An out-of-scope bug a rafa task session reported. The loop filed it and" + " dispatches no task for it: a plan that wants it fixed declares a task.";
 var COMMENT_OPENING = "Reported again by a rafa task session.";
 function privateTriageDir(repoRoot) {
-  return join12(repoRoot, PRIVATE_TRIAGE_DIR);
+  return join13(repoRoot, PRIVATE_TRIAGE_DIR);
 }
 function createPrivateTriageTracker(repoRoot, options = {}) {
   return createLocalTracker({
@@ -10018,7 +10268,7 @@ function oneLine3(text) {
   return text.replace(/\s+/g, " ").trim();
 }
 function bugKeyOf(trackerPath, artifact) {
-  return `${basename5(trackerPath)}${KEY_SEPARATOR}${oneLine3(artifact)}`;
+  return `${basename6(trackerPath)}${KEY_SEPARATOR}${oneLine3(artifact)}`;
 }
 function fenced(value) {
   const runs = Array.from(value.matchAll(/`+/g), (run) => run[0].length);
@@ -10252,9 +10502,9 @@ function describeStartTriage(result) {
   };
 }
 async function resolvePublicTracker(options, redact) {
-  const resolve9 = options.resolve ?? resolveTracker;
+  const resolve11 = options.resolve ?? resolveTracker;
   try {
-    const { tracker, attempts } = await resolve9({
+    const { tracker, attempts } = await resolve11({
       config: options.config,
       context: { repoRoot: options.repoRoot }
     });
@@ -10425,8 +10675,8 @@ function msUntil(startAt, now = new Date) {
   return target.getTime() - now.getTime();
 }
 function sleepFor(ms) {
-  return new Promise((resolve9) => {
-    setTimeout(resolve9, ms);
+  return new Promise((resolve11) => {
+    setTimeout(resolve11, ms);
   });
 }
 async function deferUntil(startAt, now = new Date, sleep = sleepFor) {