@open-tomato/rafa 0.33.0 → 0.34.1

package/dist/cli.js

@@ -850,6 +850,34 @@ var init_config_schema_tests = __esm(() => {
   };
 });
 
+// src/config-schema-triage.ts
+function isThreshold(raw) {
+  return typeof raw === "number" && Number.isFinite(raw) && raw > 0 && raw <= SIMILARITY_THRESHOLD_MAX;
+}
+function isCandidateCount(raw) {
+  return typeof raw === "number" && Number.isSafeInteger(raw) && raw >= SIMILARITY_CANDIDATES_MIN && raw <= SIMILARITY_CANDIDATES_MAX;
+}
+var SIMILARITY_THRESHOLD_MAX = 1, SIMILARITY_CANDIDATES_MIN = 1, SIMILARITY_CANDIDATES_MAX = 10, similarityThreshold = (raw, at) => raw === false || isThreshold(raw) ? { value: raw, problems: [], extras: [] } : refused(at, raw, `false or a number above 0 and at most ${String(SIMILARITY_THRESHOLD_MAX)}`), similarityCandidates = (raw, at) => isCandidateCount(raw) ? { value: raw, problems: [], extras: [] } : refused(at, raw, `a whole number from ${String(SIMILARITY_CANDIDATES_MIN)} to ${String(SIMILARITY_CANDIDATES_MAX)}`), TRIAGE_DEFAULTS, TRIAGE_SETTINGS;
+var init_config_schema_triage = __esm(() => {
+  init_config_sections();
+  TRIAGE_DEFAULTS = Object.freeze({
+    triageSimilarityThreshold: 0.3,
+    triageSimilarityCandidates: 3
+  });
+  TRIAGE_SETTINGS = {
+    triageSimilarityThreshold: {
+      key: "triage.similarity.threshold",
+      read: similarityThreshold,
+      cli: false
+    },
+    triageSimilarityCandidates: {
+      key: "triage.similarity.candidates",
+      read: similarityCandidates,
+      cli: false
+    }
+  };
+});
+
 // src/config-schema-wrap-up.ts
 function isRetryCount(raw) {
   return typeof raw === "number" && Number.isSafeInteger(raw) && raw >= WRAP_UP_RETRIES_MIN && raw <= WRAP_UP_RETRIES_MAX;
@@ -1065,6 +1093,7 @@ var init_config_schema = __esm(() => {
   init_config_schema_hub();
   init_config_schema_release();
   init_config_schema_tests();
+  init_config_schema_triage();
   init_config_schema_wrap_up();
   init_config_sections();
   init_routing();
@@ -1101,6 +1130,7 @@ var init_config_schema = __esm(() => {
     roadmapIssue: null,
     claimsStaleAfter: "3d",
     claimsAhead: "off",
+    ...TRIAGE_DEFAULTS,
     ...RELEASE_DEFAULTS,
     cleanupStaleDays: 30,
     cleanupWorktreeIdleDays: 7,
@@ -1188,6 +1218,7 @@ var init_config_schema = __esm(() => {
     roadmapIssue: { key: "roadmap.issue", read: issueNumber, cli: false },
     claimsStaleAfter: { key: "claims.staleAfter", read: claimsStaleAfter, cli: false },
     claimsAhead: { key: "claims.ahead", read: claimsAhead, cli: false },
+    ...TRIAGE_SETTINGS,
     ...RELEASE_SETTINGS,
     cleanupStaleDays: { key: "cleanup.staleDays", read: dayCount, cli: false },
     cleanupWorktreeIdleDays: {
@@ -1297,6 +1328,8 @@ function readLayer(rawOf, atOf) {
     roadmapIssue: read("roadmapIssue"),
     claimsStaleAfter: read("claimsStaleAfter"),
     claimsAhead: read("claimsAhead"),
+    triageSimilarityThreshold: read("triageSimilarityThreshold"),
+    triageSimilarityCandidates: read("triageSimilarityCandidates"),
     releaseEnabled: read("releaseEnabled"),
     releaseVersionFile: read("releaseVersionFile"),
     releaseChangelog: read("releaseChangelog"),
@@ -1360,7 +1393,13 @@ function sortKeys(document, path) {
   }
   return { named, extras, problems };
 }
+function tabIndentProblems(text2, path) {
+  return text2.split(/\r?\n/).flatMap((line, index) => TAB_INDENTED_LINE.test(line) ? [`${path}: line ${index + 1} is indented with a tab; YAML indents with spaces only`] : []);
+}
 function parseYaml(text2, path) {
+  const tabProblems = tabIndentProblems(text2, path);
+  if (tabProblems.length > 0)
+    throw new ConfigError(tabProblems);
   try {
     return Bun.YAML.parse(text2);
   } catch (error) {
@@ -1461,7 +1500,7 @@ function resolveConfig(layers = {}) {
     warnings
   };
 }
-var ConfigError, MAP_SETTINGS;
+var ConfigError, TAB_INDENTED_LINE, MAP_SETTINGS;
 var init_config = __esm(() => {
   init_config_schema_hub();
   init_config_schema();
@@ -1477,6 +1516,7 @@ var init_config = __esm(() => {
       this.problems = problems;
     }
   };
+  TAB_INDENTED_LINE = /^[ \t]*\t[ \t]*[^\s#]/;
   MAP_SETTINGS = new Set([
     "tiersSkills",
     "tiersAgents",
@@ -2193,7 +2233,7 @@ function restoreRunningCommand(previous) {
 var running = null;
 
 // package.json
-var name = "@open-tomato/rafa", version = "0.33.0";
+var name = "@open-tomato/rafa", version = "0.34.1";
 var init_package = () => {};
 
 // src/cli/version.ts
@@ -6522,11 +6562,18 @@ var init_store = __esm(() => {
 // src/effort/store/location.ts
 import { existsSync as existsSync6, realpathSync as realpathSync4 } from "fs";
 import { tmpdir } from "os";
-import { isAbsolute as isAbsolute9, join as join15, relative as relative4, resolve as resolve2, sep } from "path";
+import { basename as basename4, dirname as dirname10, isAbsolute as isAbsolute9, join as join15, relative as relative4, resolve as resolve2, sep } from "path";
 function canonical(path) {
   const resolved = resolve2(path);
   return existsSync6(resolved) ? realpathSync4(resolved) : resolved;
 }
+function realPathOf(path) {
+  const resolved = resolve2(path);
+  if (existsSync6(resolved))
+    return realpathSync4(resolved);
+  const parent = dirname10(resolved);
+  return parent === resolved ? resolved : join15(realPathOf(parent), basename4(resolved));
+}
 function isWithin(path, dir) {
   const between = relative4(resolve2(dir), resolve2(path));
   const climbsOut = between === ".." || between.startsWith(`..${sep}`);
@@ -6551,7 +6598,7 @@ function isTestProcess(main = Bun.main, env = process.env) {
   return main.endsWith(TEST_ENTRY_SUFFIX) || env[TEST_PROCESS_VARIABLE] === "1";
 }
 function isUnderTempDir(path, tempDir = tmpdir()) {
-  return isWithin(path, tempDir) || isWithin(path, canonical(tempDir));
+  return isWithin(path, tempDir) || isWithin(realPathOf(path), realPathOf(tempDir));
 }
 function currentProbe() {
   return { main: Bun.main, env: process.env, tempDir: tmpdir() };
@@ -6618,7 +6665,7 @@ var init_ndjson = __esm(() => {
 
 // src/runtime/identity.ts
 import { existsSync as existsSync7, readFileSync as readFileSync13, realpathSync as realpathSync5 } from "fs";
-import { dirname as dirname10, join as join17, resolve as resolve3 } from "path";
+import { dirname as dirname11, join as join17, resolve as resolve3 } from "path";
 function realOrResolved(path) {
   const resolved = resolve3(path);
   return existsSync7(resolved) ? realpathSync5(resolved) : resolved;
@@ -6641,7 +6688,7 @@ function nearestRafaPackage(start) {
     const manifest = join17(dir, MANIFEST);
     if (existsSync7(manifest) && manifestName(manifest) === name)
       return dir;
-    const parent = dirname10(dir);
+    const parent = dirname11(dir);
     if (parent === dir)
       return null;
     dir = parent;
@@ -6649,7 +6696,7 @@ function nearestRafaPackage(start) {
 }
 function readRuntimeIdentity(entry = Bun.main) {
   const real = realOrResolved(entry);
-  const packageDir = nearestRafaPackage(dirname10(real));
+  const packageDir = nearestRafaPackage(dirname11(real));
   if (packageDir !== null && existsSync7(join17(packageDir, CHECKOUT_ENTRY))) {
     return { kind: "development", entry: real, checkout: packageDir };
   }
@@ -6663,16 +6710,16 @@ var init_identity2 = __esm(() => {
 
 // src/effort/store/development-build.ts
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute10 } from "path";
+import { basename as basename5, dirname as dirname12, isAbsolute as isAbsolute10 } from "path";
 function appliedByName(identity) {
   return identity.kind === "development" ? `${RAFA_VERSION}${DEVELOPMENT_MARK}${identity.checkout}` : RAFA_VERSION;
 }
 function storeProjectRoot(path) {
-  const storeDir = dirname11(path);
-  const scopeDir = dirname11(storeDir);
-  if (basename4(storeDir) !== EFFORT_DIR_NAME || basename4(scopeDir) !== SCOPE_DIR)
+  const storeDir = dirname12(path);
+  const scopeDir = dirname12(storeDir);
+  if (basename5(storeDir) !== EFFORT_DIR_NAME || basename5(scopeDir) !== SCOPE_DIR)
     return null;
-  return dirname11(scopeDir);
+  return dirname12(scopeDir);
 }
 function isOwnedStore(path, env, tempDir) {
   if (isUnderTempDir(path, tempDir))
@@ -7401,7 +7448,7 @@ var init_store_identity = __esm(() => {
 
 // src/effort/store/store-meta.ts
 import { randomUUID as randomUUID3 } from "crypto";
-import { dirname as dirname12 } from "path";
+import { dirname as dirname13 } from "path";
 function toStoredInteger(value) {
   return BigInt.asIntN(STORED_INTEGER_BITS, value);
 }
@@ -7424,7 +7471,7 @@ function readStoreMeta(db) {
   };
 }
 function projectFor(storePath, recorded, seams) {
-  const read = (seams.readProject ?? readProjectIdentity)(dirname12(storePath));
+  const read = (seams.readProject ?? readProjectIdentity)(dirname13(storePath));
   if (read.rootCommit !== null)
     return { rootCommit: read.rootCommit, remote: read.remote };
   if (recorded === null)
@@ -7467,7 +7514,7 @@ var init_store_meta = __esm(() => {
 
 // src/effort/store/sqlite.ts
 import { existsSync as existsSync8, mkdirSync as mkdirSync6 } from "fs";
-import { dirname as dirname13, join as join18 } from "path";
+import { dirname as dirname14, join as join18 } from "path";
 import { Database } from "bun:sqlite";
 function sqliteStorePath(repoRoot) {
   return join18(effortStoreDir(repoRoot), SQLITE_STORE_FILE_NAME);
@@ -7496,7 +7543,7 @@ function batchEntries(kind, rows2) {
 function withSqliteStore(path, access, create, use, identity = {}) {
   guardTestProcess(path);
   if (create)
-    mkdirSync6(dirname13(path), { recursive: true });
+    mkdirSync6(dirname14(path), { recursive: true });
   const db = new Database(path, { readwrite: true, create });
   try {
     db.run(`PRAGMA busy_timeout = ${String(activeStoreSettings().busyTimeoutMs)}`);
@@ -8667,7 +8714,7 @@ var init_migrate = __esm(() => {
 import { randomUUID as randomUUID4 } from "crypto";
 import { existsSync as existsSync13, mkdtempSync, rmSync as rmSync7 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
-import { dirname as dirname14, join as join20 } from "path";
+import { dirname as dirname15, join as join20 } from "path";
 import { Database as Database5, SQLiteError as SQLiteError2 } from "bun:sqlite";
 function refuseNdjson(backend) {
   if (backend !== "ndjson")
@@ -8714,7 +8761,7 @@ function recordedMeta(path) {
 }
 function refuseOtherProject(options) {
   const other = recordedMeta(options.otherPath);
-  const here = recordedMeta(options.path)?.projectRootCommit ?? (options.readProject ?? readProjectIdentity)(dirname14(options.path)).rootCommit;
+  const here = recordedMeta(options.path)?.projectRootCommit ?? (options.readProject ?? readProjectIdentity)(dirname15(options.path)).rootCommit;
   const there = other?.projectRootCommit ?? null;
   if (here !== null && there !== null && here !== there) {
     throw new MergeRefusal("other-project", `REFUSED \u2014 ${options.otherPath} is the effort store of another project (root commit ${there});` + ` this store's project has root commit ${here}. ${NOTHING_MERGED}`);
@@ -10255,28 +10302,49 @@ function viewedIssue(stdout, number) {
   const checked = payload;
   return { ...checked, labels: labelNames(checked.labels) ?? [] };
 }
-function listedIssues(stdout) {
-  const command = "gh issue list";
-  const payload = parseJson(stdout, command);
+function listedRows(stdout) {
+  const payload = parseJson(stdout, LIST_COMMAND);
   if (!Array.isArray(payload)) {
-    throw new Error(`${PREFIX2}: ${command} answered ${describeValue(payload)}, expected a list`);
+    throw new Error(`${PREFIX2}: ${LIST_COMMAND} answered ${describeValue(payload)}, expected a list`);
   }
-  return payload.map((row2, index) => {
-    const refuse2 = (problem) => new Error(`${PREFIX2}: ${command} answered row ${index} ${problem}`);
-    if (!isMapping(row2))
-      throw refuse2(`${describeValue(row2)}, expected a mapping`);
-    const { number, url } = row2;
-    const labels = labelNames(row2["labels"]);
-    if (typeof number !== "number" || !isIssueNumber3(String(number))) {
-      throw refuse2(`with number ${describeValue(number)}, expected an issue number`);
-    }
-    if (typeof url !== "string")
-      throw refuse2(`with url ${describeValue(url)}, expected a string`);
-    if (labels === null)
-      throw refuse2("with labels that are not a list of named labels");
-    return { number, url, labels };
+  return payload;
+}
+function rowRefusal(index, problem) {
+  return new Error(`${PREFIX2}: ${LIST_COMMAND} answered row ${index} ${problem}`);
+}
+function listedRow(row2, index) {
+  if (!isMapping(row2))
+    throw rowRefusal(index, `${describeValue(row2)}, expected a mapping`);
+  const { number, url } = row2;
+  const labels = labelNames(row2["labels"]);
+  if (typeof number !== "number" || !isIssueNumber3(String(number))) {
+    throw rowRefusal(index, `with number ${describeValue(number)}, expected an issue number`);
+  }
+  if (typeof url !== "string")
+    throw rowRefusal(index, `with url ${describeValue(url)}, expected a string`);
+  if (labels === null)
+    throw rowRefusal(index, "with labels that are not a list of named labels");
+  return { number, url, labels };
+}
+function listedIssues(stdout) {
+  return listedRows(stdout).map(listedRow);
+}
+function listedOpenIssues(stdout) {
+  return listedRows(stdout).map((row2, index) => {
+    const listed3 = listedRow(row2, index);
+    const { title: title2, body } = row2;
+    if (typeof title2 !== "string")
+      throw rowRefusal(index, `with title ${describeValue(title2)}, expected a string`);
+    if (typeof body !== "string")
+      throw rowRefusal(index, `with body ${describeValue(body)}, expected a string`);
+    return { ...listed3, title: title2, body };
   });
 }
+function refOfRow(row2) {
+  const module = labelValue(row2.labels, GITHUB_LABELS.modulePrefix);
+  const ref = { opt: 0, kind: "github", externalId: String(row2.number), url: row2.url };
+  return module === undefined ? ref : { ...ref, module };
+}
 function labelValue(labels, prefix) {
   return labels.find((label) => label.startsWith(prefix))?.slice(prefix.length);
 }
@@ -10290,7 +10358,7 @@ function moduleOfLabels(labels) {
 function stateOf(viewed) {
   if (viewed.state === "OPEN")
     return "todo";
-  return viewed.stateReason === NOT_PLANNED ? "cancelled" : "done";
+  return viewed.stateReason !== null && CANCELLED_REASONS.has(viewed.stateReason) ? "cancelled" : "done";
 }
 function issueOf2(ref, viewed) {
   const priority = labelValue(viewed.labels, GITHUB_LABELS.priorityPrefix);
@@ -10401,12 +10469,26 @@ function createGithubTracker(options) {
         ...optionalFlag("--label", moduleLabel),
         ...optionalFlag("--label", typeLabel),
         ...optionalFlag("--search", query.text)
-      ], "gh issue list");
-      return listedIssues(stdout).map((row2) => {
-        const module = labelValue(row2.labels, GITHUB_LABELS.modulePrefix);
-        const ref = { opt: 0, kind: "github", externalId: String(row2.number), url: row2.url };
-        return module === undefined ? ref : { ...ref, module };
-      });
+      ], LIST_COMMAND);
+      return listedIssues(stdout).map(refOfRow);
+    },
+    openIssues: async (type) => {
+      if (!isOneOf2(ISSUE_TYPES, type)) {
+        throw new TypeError(`${PREFIX2}: openIssues refused type ${describeValue(type)}, expected one of: ${ISSUE_TYPES.join(", ")}`);
+      }
+      const stdout = await run([
+        "issue",
+        "list",
+        "--state",
+        "open",
+        "--json",
+        OPEN_LIST_FIELDS,
+        "--limit",
+        String(OPEN_ISSUES_LIMIT),
+        "--label",
+        `${GITHUB_LABELS.typePrefix}${type}`
+      ], LIST_COMMAND);
+      return listedOpenIssues(stdout).map((row2) => ({ ref: refOfRow(row2), title: row2.title, body: row2.body }));
     },
     comment: async (ref, body) => {
       const number = issueNumberOfRef(ref);
@@ -10437,7 +10519,7 @@ function createGithubTracker(options) {
   };
   return Object.freeze(tracker);
 }
-var PREFIX2 = "github tracker", GITHUB_LABELS, VIEW_FIELDS = "number,title,body,state,stateReason,labels,url", LIST_FIELDS = "number,url,labels", DEFAULT_FIND_LIMIT = 30, NOT_PLANNED = "NOT_PLANNED", ISSUE_NUMBER, REPO_PART, CREATED_ISSUE_URL, REST_STATES, TIMED_OUT, DRAFT_CHECKS;
+var PREFIX2 = "github tracker", GITHUB_LABELS, VIEW_FIELDS = "number,title,body,state,stateReason,labels,url", LIST_COMMAND = "gh issue list", LIST_FIELDS = "number,url,labels", OPEN_LIST_FIELDS = "number,url,labels,title,body", OPEN_ISSUES_LIMIT = 1000, DEFAULT_FIND_LIMIT = 30, CANCELLED_REASONS, ISSUE_NUMBER, REPO_PART, CREATED_ISSUE_URL, REST_STATES, TIMED_OUT, DRAFT_CHECKS;
 var init_github = __esm(() => {
   init_config_sections();
   init_issue_values();
@@ -10448,6 +10530,7 @@ var init_github = __esm(() => {
     needsTriage: "needs-triage",
     blockedByPrefix: "blocked-by:OPT-"
   });
+  CANCELLED_REASONS = new Set(["NOT_PLANNED", "DUPLICATE"]);
   ISSUE_NUMBER = /^[1-9]\d*$/;
   REPO_PART = /^[\w.-]+$/;
   CREATED_ISSUE_URL = /^https:\/\/[^\s/]+\/[\w.-]+\/[\w.-]+\/issues\/([1-9]\d*)$/;
@@ -10601,7 +10684,7 @@ function parseLocalIssue(contents, sourcePath) {
 function warnThroughActiveOutput2(message) {
   activeOutput().warn(message);
 }
-async function listLocalIssues(issuesDir, warn = warnThroughActiveOutput2) {
+async function listLocalIssues(issuesDir, warn = warnThroughActiveOutput2, reader = "find") {
   const numbers = await issueNumbers(issuesDir);
   const settled = await Promise.allSettled(numbers.map(async (number) => {
     const path = issuePath(issuesDir, number);
@@ -10616,7 +10699,7 @@ async function listLocalIssues(issuesDir, warn = warnThroughActiveOutput2) {
   return settled.flatMap((result) => {
     if (result.status === "fulfilled")
       return [result.value];
-    warn(`${messageOf(result.reason)}; find skipped it`);
+    warn(`${messageOf(result.reason)}; ${reader} skipped it`);
     return [];
   });
 }
@@ -10702,6 +10785,14 @@ function createLocalTracker(options) {
       const matched = (await listLocalIssues(issuesDir, warn)).filter(({ record }) => matchesQuery(record, query));
       return matched.slice(0, query.limit ?? matched.length).map(({ number, record }) => refFor(number, record.draft.opt));
     },
+    openIssues: async (type) => {
+      const open = (await listLocalIssues(issuesDir, warn, "openIssues")).filter(({ record }) => record.draft.type === type && !CLOSED_STATES.has(record.state));
+      return open.map(({ number, record }) => ({
+        ref: refFor(number, record.draft.opt),
+        title: record.draft.title,
+        body: record.draft.body
+      }));
+    },
     comment: async (ref, body) => {
       const { number, record } = await read(ref);
       await rewrite(number, { ...record, comments: [...record.comments, `${now()}: ${body}`] });
@@ -10714,13 +10805,14 @@ function createLocalTracker(options) {
   };
   return Object.freeze(tracker);
 }
-var PREFIX3 = "local tracker", FRONTMATTER, ISSUE_NUMBER2, ISSUE_EXTENSION = ".md", FIELD_CHECKS;
+var PREFIX3 = "local tracker", FRONTMATTER, ISSUE_NUMBER2, CLOSED_STATES, ISSUE_EXTENSION = ".md", FIELD_CHECKS;
 var init_local2 = __esm(() => {
   init_config_sections();
   init_active();
   init_issue_values();
   FRONTMATTER = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
   ISSUE_NUMBER2 = /^[1-9]\d*$/;
+  CLOSED_STATES = new Set(["done", "released", "cancelled"]);
   FIELD_CHECKS = {
     opt: [isFiniteNumber, "a number"],
     type: [oneOf3(ISSUE_TYPES), `one of: ${ISSUE_TYPES.join(", ")}`],
@@ -13037,7 +13129,7 @@ var init_store2 = __esm(() => {
 
 // src/effort/session-log.ts
 import { createReadStream } from "fs";
-import { basename as basename5 } from "path";
+import { basename as basename6 } from "path";
 import { createInterface } from "readline";
 function emptyUsageTotals() {
   return {
@@ -13065,7 +13157,7 @@ function bump(counts, key) {
   counts[key] = (counts[key] ?? 0) + 1;
 }
 function sessionIdFromPath(filePath) {
-  return basename5(filePath).replace(/\.jsonl$/i, "");
+  return basename6(filePath).replace(/\.jsonl$/i, "");
 }
 async function* readLines(filePath) {
   const stream = createReadStream(filePath, { encoding: "utf8" });
@@ -13786,7 +13878,7 @@ var init_skill_invocations = __esm(() => {
 
 // src/effort/skill-use.ts
 import { existsSync as existsSync17, readdirSync as readdirSync6 } from "fs";
-import { dirname as dirname15, join as join27 } from "path";
+import { dirname as dirname16, join as join27 } from "path";
 function asObject4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
@@ -13798,7 +13890,7 @@ function parseRecord4(line) {
   }
 }
 function subagentLogPaths(sessionLogPath) {
-  const dir = join27(dirname15(sessionLogPath), sessionIdFromPath(sessionLogPath), "subagents");
+  const dir = join27(dirname16(sessionLogPath), sessionIdFromPath(sessionLogPath), "subagents");
   if (!existsSync17(dir))
     return [];
   return readdirSync6(dir, { withFileTypes: true }).filter((entry) => entry.isFile() && SUBAGENT_LOG_NAME.test(entry.name)).map((entry) => join27(dir, entry.name)).sort((a, b) => a.localeCompare(b));
@@ -14425,7 +14517,7 @@ var init_dispatches = __esm(() => {
 });
 
 // src/preflight/prerequisites-md.ts
-import { basename as basename6, dirname as dirname16, join as join29 } from "path";
+import { basename as basename7, dirname as dirname17, join as join29 } from "path";
 function inferSectionTag(header) {
   if (SECTION_AUTO_RE.test(header))
     return "auto";
@@ -14563,10 +14655,10 @@ function mergePlanPrerequisites(settings, content) {
   });
 }
 function prerequisitesPathForPlan(planPath) {
-  const stub = PLAN_FILE_RE.exec(basename6(planPath))?.[1];
+  const stub = PLAN_FILE_RE.exec(basename7(planPath))?.[1];
   if (stub === undefined)
     return null;
-  return join29(dirname16(planPath), `PREREQUISITES-${stub}.md`);
+  return join29(dirname17(planPath), `PREREQUISITES-${stub}.md`);
 }
 async function readIfPresent2(path) {
   try {
@@ -16363,6 +16455,27 @@ var init_handout = __esm(() => {
   EMPTY_RESOLUTION = { loadedTiers: [], items: [], collisions: [] };
 });
 
+// src/start/inherited-notice.ts
+function oneLine5(text2) {
+  return text2.replace(/\s+/g, " ").trim();
+}
+function failureLine(failure2) {
+  return `- \`${oneLine5(failure2.file)}\`: ${oneLine5(failure2.name)}`;
+}
+function renderInheritedSection(failures) {
+  if (failures.length === 0)
+    return "";
+  const listed3 = failures.slice(0, INHERITED_LIST_CAP).map(failureLine);
+  const rest = failures.length - listed3.length;
+  const more = rest > 0 ? [`- ...and ${rest} more.`] : [];
+  return [INHERITED_HEADING, INHERITED_SENTENCE, ...listed3, ...more].join(`
+`);
+}
+var INHERITED_HEADING = "## Failures this run inherited", INHERITED_SENTENCE, INHERITED_LIST_CAP = 20;
+var init_inherited_notice = __esm(() => {
+  INHERITED_SENTENCE = "These tests were already failing when this run started. " + "They need no proof that they predate your task: do not run `git stash` or check out a clean worktree of `main` to show it. " + "A bug you report for one of them, by its file and case, is recognised as inherited and files nothing.";
+});
+
 // src/effort/store/preflight.ts
 import { existsSync as existsSync24 } from "fs";
 function refusedWrite6(reason) {
@@ -17227,7 +17340,7 @@ var init_blocked = __esm(() => {
 
 // src/commands/plan/validate.ts
 import { readFileSync as readFileSync21 } from "fs";
-import { basename as basename7, resolve as resolve11 } from "path";
+import { basename as basename8, resolve as resolve11 } from "path";
 function readFileOrNull(path) {
   return path !== null && isFile(path) ? readFileSync21(path, "utf8") : null;
 }
@@ -17236,7 +17349,7 @@ function checkStoreRules(file, markdown) {
   return findStoreRuleProblems({
     plan: markdown,
     prerequisites: readFileOrNull(prerequisitesPath),
-    prerequisitesName: basename7(prerequisitesPath ?? "PREREQUISITES-<stub>.md")
+    prerequisitesName: basename8(prerequisitesPath ?? "PREREQUISITES-<stub>.md")
   });
 }
 function validatePlan(file) {
@@ -17552,7 +17665,7 @@ var init_review_stamp = __esm(() => {
 
 // src/board/gate.ts
 import { existsSync as existsSync26, mkdirSync as mkdirSync8, readFileSync as readFileSync22, renameSync as renameSync5, statSync as statSync10, writeFileSync as writeFileSync7 } from "fs";
-import { basename as basename8, dirname as dirname17, join as join31, resolve as resolve12 } from "path";
+import { basename as basename9, dirname as dirname18, join as join31, resolve as resolve12 } from "path";
 function readGateFlags(args) {
   return {
     skipReview: args.includes(SKIP_REVIEW_FLAG),
@@ -17592,8 +17705,8 @@ function isWrittenFile(repoRoot, path) {
   return existsSync26(full) && statSync10(full).isFile();
 }
 function rejectedPath(path) {
-  const parent = dirname17(path);
-  return parent === "." ? join31(REJECTED_DIR, basename8(path)) : join31(parent, REJECTED_DIR, basename8(path));
+  const parent = dirname18(path);
+  return parent === "." ? join31(REJECTED_DIR, basename9(path)) : join31(parent, REJECTED_DIR, basename9(path));
 }
 function moveWritten(options, output, reason) {
   for (const path of [options.planPath, options.prerequisitesPath]) {
@@ -17601,7 +17714,7 @@ function moveWritten(options, output, reason) {
       continue;
     const destination = rejectedPath(path);
     try {
-      mkdirSync8(resolve12(options.repoRoot, dirname17(destination)), { recursive: true });
+      mkdirSync8(resolve12(options.repoRoot, dirname18(destination)), { recursive: true });
       renameSync5(resolve12(options.repoRoot, path), resolve12(options.repoRoot, destination));
       output.info(`\uD83D\uDDC3  Moved ${path} to ${destination}: ${reason}`);
     } catch (error) {
@@ -18064,7 +18177,7 @@ var init_naming = __esm(() => {
 
 // src/board/previous-copy.ts
 import { linkSync as linkSync2, mkdirSync as mkdirSync9, readdirSync as readdirSync8, statSync as statSync11, unlinkSync } from "fs";
-import { basename as basename9, extname, join as join32, resolve as resolve13 } from "path";
+import { basename as basename10, extname, join as join32, resolve as resolve13 } from "path";
 function previousDir(specsDir) {
   return join32(specsDir, PREVIOUS_DIR_NAME);
 }
@@ -18077,7 +18190,7 @@ function previousTimestamp(mtime) {
   return `${date}T${time}Z`;
 }
 function previousCopyName(savedName, timestamp, attempt) {
-  const stem = basename9(savedName, extname(savedName));
+  const stem = basename10(savedName, extname(savedName));
   const suffix = attempt < FIRST_SUFFIX ? "" : `-${String(attempt)}`;
   return `${stem}.${timestamp}${suffix}${COPY_EXTENSION}`;
 }
@@ -18101,7 +18214,7 @@ function movePreviousCopy(options) {
   const source = resolve13(repoRoot, path2);
   const directory2 = previousDir(specsDir);
   const absoluteDirectory = resolve13(repoRoot, directory2);
-  const savedName = basename9(path2);
+  const savedName = basename10(path2);
   let name2;
   try {
     const timestamp = previousTimestamp(statSync11(source).mtime);
@@ -18141,7 +18254,7 @@ var init_previous_copy = __esm(() => {
 
 // src/board/issue.ts
 import { existsSync as existsSync27, mkdirSync as mkdirSync10, readFileSync as readFileSync23, statSync as statSync12, writeFileSync as writeFileSync8 } from "fs";
-import { dirname as dirname18, resolve as resolve14 } from "path";
+import { dirname as dirname19, resolve as resolve14 } from "path";
 function detailOf3(result, command) {
   const written = result.stderr.trim() || result.stdout.trim();
   return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
@@ -18366,7 +18479,7 @@ function writeSpecSnapshot(options) {
   }
   const previous = action === "created" ? null : movePreviousCopy({ repoRoot, specsDir, path: path2 }).path;
   try {
-    mkdirSync10(dirname18(absolute), { recursive: true });
+    mkdirSync10(dirname19(absolute), { recursive: true });
     writeFileSync8(absolute, text2);
   } catch (error) {
     throw new Error(`${PREFIX5}: the snapshot ${path2} could not be written: ${messageOf(error)}`, { cause: error });
@@ -19021,6 +19134,11 @@ function createGhPullRequests(options) {
       const text2 = textArgument(title2, "editTitle", "title", false);
       await succeed(["pr", "edit", target, "--title", text2], `gh pr edit ${target} --title <title>`);
     },
+    editBase: async (number, base) => {
+      const target = pullNumber(number, "editBase");
+      const branch = textArgument(base, "editBase", "base", false);
+      await succeed(["pr", "edit", target, "--base", branch], `gh pr edit ${target} --base ${branch}`);
+    },
     editBody: async (number, body) => {
       const target = pullNumber(number, "editBody");
       const text2 = bodyText(body, "editBody");
@@ -19918,7 +20036,7 @@ var init_setup_config = __esm(() => {
 
 // src/board/setup.ts
 import { existsSync as existsSync28, lstatSync, mkdirSync as mkdirSync11, readFileSync as readFileSync25, statSync as statSync13, writeFileSync as writeFileSync9 } from "fs";
-import { dirname as dirname19, join as join33 } from "path";
+import { dirname as dirname20, join as join33 } from "path";
 import { fileURLToPath } from "url";
 function boardChanged(report) {
   return report.parts.some((part) => part.outcome === "created");
@@ -20030,7 +20148,7 @@ function writeShippedFile(root, file) {
   }
   try {
     const text2 = file.read();
-    mkdirSync11(dirname19(path2), { recursive: true });
+    mkdirSync11(dirname20(path2), { recursive: true });
     writeFileSync9(path2, text2, { encoding: "utf8", flag: "wx" });
     return partOf("template", name2, "created", `written from ${file.source}`);
   } catch (error) {
@@ -20226,7 +20344,7 @@ var init_setup = __esm(() => {
   init_readiness();
   init_roadmap();
   init_setup_config();
-  MODULE_DIR = dirname19(fileURLToPath(import.meta.url));
+  MODULE_DIR = dirname20(fileURLToPath(import.meta.url));
   ROADMAP_LABEL = `${GITHUB_LABELS.typePrefix}roadmap`;
   BOARD_LABELS = Object.freeze([
     {
@@ -20975,7 +21093,7 @@ var init_roadmap_board = __esm(() => {
 
 // src/board/board-cache.ts
 import { mkdirSync as mkdirSync12, readFileSync as readFileSync26, renameSync as renameSync6, writeFileSync as writeFileSync10 } from "fs";
-import { dirname as dirname20, join as join34 } from "path";
+import { dirname as dirname21, join as join34 } from "path";
 function changedArgs(watermark) {
   return Object.freeze([
     "api",
@@ -21028,7 +21146,7 @@ function fileOf(cache) {
 function writeCache(path2, cache) {
   const temporary = `${path2}.${String(process.pid)}.tmp`;
   try {
-    mkdirSync12(dirname20(path2), { recursive: true });
+    mkdirSync12(dirname21(path2), { recursive: true });
     writeFileSync10(temporary, `${JSON.stringify(fileOf(cache))}
 `);
     renameSync6(temporary, path2);
@@ -21960,7 +22078,7 @@ var init_preflight_sync = __esm(() => {
 import { randomUUID as randomUUID10 } from "crypto";
 import { existsSync as existsSync30, readFileSync as readFileSync27 } from "fs";
 import { homedir as homedir4 } from "os";
-import { basename as basename10, join as join35 } from "path";
+import { basename as basename11, join as join35 } from "path";
 function knownMissingNotice(lines) {
   return lines.length === 0 ? [] : [...lines, KNOWN_MISSING_SENTENCE];
 }
@@ -22007,7 +22125,7 @@ function refuseUnresolvableAgents(options) {
   if (missing2.length === 0 && colliding.length === 0 && unresolved.length === 0)
     return;
   throw new CommandExit(1, [
-    `\u274C Refusing to start: ${basename10(path2)} ${refusedNames(missing2.length, colliding.length, unresolved.length)}` + ` (loop.settingSources: ${settings.settingSources.join(", ")}; tiers.rafa: ${settings.tiersRafa}).`,
+    `\u274C Refusing to start: ${basename11(path2)} ${refusedNames(missing2.length, colliding.length, unresolved.length)}` + ` (loop.settingSources: ${settings.settingSources.join(", ")}; tiers.rafa: ${settings.tiersRafa}).`,
     ...missing2.map((agent) => `   ${missingAgentLine(agent)}`),
     ...colliding.map((skill) => `   ${skillCollisionLine(skill)}`),
     ...unresolved.map((skill) => `   ${unresolvedSkillLine(skill)}`),
@@ -22025,11 +22143,11 @@ function refuseStoreRuleBreaks(planPath) {
   const problems = findStoreRuleProblems({
     plan: markdown,
     prerequisites,
-    prerequisitesName: basename10(prerequisitesPath ?? "PREREQUISITES-<stub>.md")
+    prerequisitesName: basename11(prerequisitesPath ?? "PREREQUISITES-<stub>.md")
   });
   if (problems.length === 0)
     return;
-  const file = basename10(path2);
+  const file = basename11(path2);
   throw new CommandExit(1, [
     `\u274C Refusing to start: ${file} breaks ${problems.length} effort-store rule(s) that \`rafa plan validate\` checks.`,
     ...problems.map((problem) => `   ${storeRuleLine(file, problem)}`),
@@ -22062,7 +22180,7 @@ async function loadItems(options) {
 function refuseMalformedItems(planPath, items) {
   if (items.malformed.length === 0)
     return;
-  const file = basename10(prerequisitesPathForPlan(planPath) ?? planPath);
+  const file = basename11(prerequisitesPathForPlan(planPath) ?? planPath);
   const [head = "", ...rest] = malformedPrerequisiteLines(file, items.malformed);
   throw new CommandExit(1, [
     `\u274C Refusing to start: ${head}`,
@@ -22075,7 +22193,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, skipped2) {
-  const tracker = basename10(trackerPathFor(planPath));
+  const tracker = basename11(trackerPathFor(planPath));
   const output = activeOutput();
   for (const [index, item] of skipped2.entries()) {
     const lead = index === 0 ? `
@@ -22094,7 +22212,7 @@ function startTier(planPath, items) {
 function announceReminders(planPath, reminders) {
   if (reminders.length === 0)
     return;
-  const file = basename10(prerequisitesPathForPlan(planPath) ?? planPath);
+  const file = basename11(prerequisitesPathForPlan(planPath) ?? planPath);
   const output = activeOutput();
   output.info(`
 \uD83D\uDCCC ${file} names ${reminders.length} step(s) the preflight does not check:`);
@@ -22245,16 +22363,16 @@ function baseLines(base) {
   return [`${BASE_PROMPT_PREFIX}${base}: run \`bun test --changed=${base}\` for the tests your changes reach.`];
 }
 function sectionLines(sections2) {
-  return [sections2.skills, sections2.lessons].filter((section2) => section2.trim().length > 0).flatMap((section2) => [section2, ""]);
+  return [sections2.skills, sections2.lessons, sections2.inherited].filter((section2) => section2.trim().length > 0).flatMap((section2) => [section2, ""]);
 }
-function buildTaskPrompt(taskText, promptContent, planText, knownMissing = [], blocker = null, sections2 = NO_TASK_SECTIONS, base = null) {
+function buildTaskPrompt(taskText, promptContent, planText, knownMissing = [], blocker = null, sections2 = NO_TASK_SECTIONS, base = null, inherited = []) {
   return [
     `Your scoped task is: ${taskText}`,
     "Consider tasks listed above this one in the plan checklist as completed. Do not re-evaluate or re-do them. Focus only on the scoped task.",
     ...blockerLines(blocker),
     ...baseLines(base),
     "",
-    ...sectionLines(sections2),
+    ...sectionLines({ ...sections2, inherited: renderInheritedSection(inherited) }),
     promptContent,
     planText,
     ...knownMissingNotice(knownMissing)
@@ -22296,7 +22414,7 @@ async function dispatchTask(options) {
   const resolution = options.serving === null ? EMPTY_RESOLUTION : resolveSessionTiers(options.serving);
   const task = taskInputFor(taskInfo, taskText, declaration, options.planContent);
   const handed = await handOut(options.handout, task, resolution, options.repoRoot);
-  const prompt = withStamp(buildTaskPrompt(taskText, options.promptContent, injection.text, options.knownMissing, taskInfo.blocker ?? null, { skills: renderSkillsSection(handed.skills), lessons: renderLessonsSection(handed.lessons) }, options.base));
+  const prompt = withStamp(buildTaskPrompt(taskText, options.promptContent, injection.text, options.knownMissing, taskInfo.blocker ?? null, { skills: renderSkillsSection(handed.skills), lessons: renderLessonsSection(handed.lessons) }, options.base, options.inherited));
   const served2 = serveForSession(options.serving, resolution);
   const sessionId = (options.newSessionId ?? randomUUID11)();
   const session = await run(prompt, flags, sessionId, options.settingSources, served2, options.checkout);
@@ -22415,6 +22533,7 @@ var init_dispatch = __esm(() => {
   init_progress();
   init_tracker();
   init_handout();
+  init_inherited_notice();
   init_preflight2();
   init_serving();
   init_stamp2();
@@ -22636,7 +22755,7 @@ var QUOTE_WINDOW = 3;
 // src/inventory/search/scratch.ts
 import { copyFileSync as copyFileSync2, mkdirSync as mkdirSync13, mkdtempSync as mkdtempSync2, rmSync as rmSync8 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
-import { basename as basename11, join as join36 } from "path";
+import { basename as basename12, join as join36 } from "path";
 function safeName(name2) {
   return name2 !== "" && name2 !== "." && name2 !== ".." && !/[\\/]/.test(name2);
 }
@@ -22661,7 +22780,7 @@ function createScratchCopy(candidates, root = tmpdir4()) {
     for (const { name: name2, path: path2 } of candidates) {
       const target = join36(dir, name2);
       mkdirSync13(target);
-      const copy = join36(target, basename11(path2));
+      const copy = join36(target, basename12(path2));
       copyFileSync2(path2, copy);
       paths.set(name2, copy);
     }
@@ -23086,7 +23205,7 @@ var init_show2 = __esm(() => {
 
 // src/commands/agent/vendor.ts
 import { copyFileSync as copyFileSync3, existsSync as existsSync32, mkdirSync as mkdirSync14, readFileSync as readFileSync28, writeFileSync as writeFileSync11 } from "fs";
-import { basename as basename12, join as join38 } from "path";
+import { basename as basename13, join as join38 } from "path";
 function readForce(value) {
   if (value === undefined || value === false || value === "false")
     return false;
@@ -23152,7 +23271,7 @@ function planCopies(names, project, force, entry) {
       problems.push(`   agent "${name2}": no definition under ${searched} carries that name`);
       continue;
     }
-    const to = join38(dir, basename12(holder.definition.path));
+    const to = join38(dir, basename13(holder.definition.path));
     const replaced = existsSync32(to);
     if (replaced && !force) {
       problems.push(`   agent "${name2}": ${to} is already there; pass --force to replace it`);
@@ -33135,7 +33254,7 @@ import {
   statSync as statSync20,
   symlinkSync
 } from "fs";
-import { basename as basename13, delimiter as delimiter4, dirname as dirname21, join as join49, relative as relative11, resolve as resolve21 } from "path";
+import { basename as basename14, delimiter as delimiter4, dirname as dirname22, join as join49, relative as relative11, resolve as resolve21 } from "path";
 function exitCodeFor(outcome2) {
   switch (outcome2.kind) {
     case "done":
@@ -33241,7 +33360,7 @@ function swapIn2(staging, to) {
   rmSync9(outgoing, { recursive: true, force: true });
 }
 function relink(linkPath, target) {
-  mkdirSync16(dirname21(linkPath), { recursive: true });
+  mkdirSync16(dirname22(linkPath), { recursive: true });
   const temporary = temporaryName(linkPath);
   rmSync9(temporary, { force: true });
   try {
@@ -33264,7 +33383,7 @@ function runBuild(repoRoot, lines) {
     cwd: repoRoot,
     env: {
       ...process.env,
-      PATH: [dirname21(process.execPath), process.env["PATH"] ?? ""].join(delimiter4)
+      PATH: [dirname22(process.execPath), process.env["PATH"] ?? ""].join(delimiter4)
     },
     stdin: "ignore",
     stdout: stdio,
@@ -33356,7 +33475,7 @@ function replaceFile(source, target) {
   }
 }
 function temporaryName(path3) {
-  return join49(dirname21(path3), `.${basename13(path3)}.snapshot-${process.pid}`);
+  return join49(dirname22(path3), `.${basename14(path3)}.snapshot-${process.pid}`);
 }
 var LINK_NAME = "rafa", FORCE_FLAG = "--force", EXIT_DONE = 0, EXIT_REFUSED = 1, EXIT_COULD_NOT_RUN = 2, TRACKER_NAME, NOTHING_DONE = "nothing was built, copied or linked", AFTERMATH, StageFailure;
 var init_install = __esm(() => {
@@ -35691,6 +35810,47 @@ function hasBranch(refs, stub) {
   const branch = `${BRANCH_PREFIX2}${stub}`;
   return refs.some((ref7) => ref7 === branch || ref7.endsWith(`/${branch}`));
 }
+function readBranchTips(sources, remote, stub, note) {
+  const branch = `${BRANCH_PREFIX2}${stub}`;
+  const tips = [];
+  for (const ref7 of [`refs/heads/${branch}`, `refs/remotes/${remote}/${branch}`]) {
+    const resolved = sources.git(["rev-parse", "--verify", "--quiet", `${ref7}^{commit}`]);
+    const said = gitSaid(resolved);
+    if (resolved.ok && resolved.stdout.trim() !== "") {
+      tips.push(ref7);
+    } else if (said !== "") {
+      note(`\`${ref7}\` could not be read, so its plan reads as started: ${said}`);
+      return null;
+    }
+  }
+  return tips;
+}
+function readBranchMessages(sources, ref7, note) {
+  const result = sources.git(["log", "-z", "--format=%B", `${sources.base}..${ref7}`]);
+  if (!result.ok) {
+    note(`the commits of \`${ref7}\` past \`${sources.base}\` could not be read, so its plan reads as started: ${gitSaid(result)}`);
+    return null;
+  }
+  return result.stdout.split("\x00").map((message) => message.trim()).filter((message) => message !== "");
+}
+function claimsOnly(messages) {
+  return messages.length > 0 && messages.every((message) => parseClaimMessage(message).kind === "ownership");
+}
+function hasStartedBranch(sources, remote, refs, stub, note) {
+  if (!hasBranch(refs, stub))
+    return false;
+  const tips = readBranchTips(sources, remote, stub, note);
+  if (tips === null)
+    return true;
+  if (tips.length === 0) {
+    note(`\`${BRANCH_PREFIX2}${stub}\` is on ${remote} but not fetched here, so its commits were not read and its plan reads as started`);
+    return true;
+  }
+  return tips.some((ref7) => {
+    const messages = readBranchMessages(sources, ref7, note);
+    return messages === null || !claimsOnly(messages);
+  });
+}
 function openWorld(sources) {
   let problems = [];
   const note = (problem) => {
@@ -35715,7 +35875,7 @@ function openWorld(sources) {
     tracked: once2(() => readTracked(sources, note)),
     checkout: once2(() => readCheckout(sources, note)),
     branchPlan: once2(() => readBranchPlan(branch(), plans())),
-    unstartedPlan: once2(() => plans().find((plan) => !hasRun(runs(), plan.stub) && !hasBranch(refs(), plan.stub)) ?? null),
+    unstartedPlan: once2(() => plans().find((plan) => !hasRun(runs(), plan.stub) && !hasStartedBranch(sources, remote, refs(), plan.stub, note)) ?? null),
     openPull: once2(() => readOpenPull(sources, branch(), note)),
     roadmap,
     picked: once2(async () => {
@@ -35743,6 +35903,7 @@ function branchLabel(world) {
 var DETACHED = "HEAD", PORCELAIN_PATH_AT = 3;
 var init_readings = __esm(() => {
   init_roadmap();
+  init_record3();
   init_loop_sessions();
   init_list5();
   init_plan_files();
@@ -35752,7 +35913,7 @@ var init_readings = __esm(() => {
 });
 
 // src/next/hop-rows.ts
-function oneLine5(text2) {
+function oneLine6(text2) {
   return text2.replace(/\s+/g, " ").trim();
 }
 function ref7(issue4) {
@@ -35793,7 +35954,7 @@ async function readGate(roadmap, pullRequest) {
   } catch (error) {
     return {
       state: "unknown",
-      reason: `could not read the owner gate of ${ref7(pullRequest)}: ${oneLine5(messageOf(error))}`,
+      reason: `could not read the owner gate of ${ref7(pullRequest)}: ${oneLine6(messageOf(error))}`,
       owners: []
     };
   }
@@ -35829,7 +35990,7 @@ async function readPrOwnerReview(world) {
     id: "pr-owner-review",
     action: "none",
     reading: `waiting on ${ref7(issue4 ?? pullRequest)} (owner review)`,
-    proposal: `leave ${ref7(pullRequest)} to its owner's review, which rafa does not merge past: ${oneLine5(gate.reason)}`,
+    proposal: `leave ${ref7(pullRequest)} to its owner's review, which rafa does not merge past: ${oneLine6(gate.reason)}`,
     pullRequest,
     ...issue4 === null ? {} : { issue: issue4 }
   };
@@ -35979,7 +36140,7 @@ function nameFiles(paths) {
   const hidden = paths.length - shown2.length;
   return hidden > 0 ? `${shown2.join(", ")} and ${hidden} more` : shown2.join(", ");
 }
-function oneLine6(text2) {
+function oneLine7(text2) {
   return text2.replace(/\s+/g, " ").trim();
 }
 function treeLabel(checkout) {
@@ -36005,7 +36166,7 @@ async function readPullsUnusable(world) {
     return {
       id: "pulls-unusable",
       action: "none",
-      reading: `the \`${world.sources.pulls.kind}\` pull request provider could not be asked: ${oneLine6(messageOf(error))}`,
+      reading: `the \`${world.sources.pulls.kind}\` pull request provider could not be asked: ${oneLine7(messageOf(error))}`,
       proposal: "run `rafa doctor` to see what the provider needs, then read the state again"
     };
   }
@@ -38083,7 +38244,7 @@ var init_doctor_epics = __esm(() => {
 
 // src/board/epic-guard.ts
 import { existsSync as existsSync43, readFileSync as readFileSync46 } from "fs";
-import { dirname as dirname22, join as join56 } from "path";
+import { dirname as dirname23, join as join56 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function epicGuardSource(moduleDir = MODULE_DIR2) {
   return join56(moduleDir, TEMPLATES_DIRNAME, EPIC_GUARD_FILE);
@@ -38106,7 +38267,7 @@ function writeEpicGuard(root, moduleDir = MODULE_DIR2) {
 var MODULE_DIR2, EPIC_GUARD_PATH, EPIC_GUARD_FILE = "epic-guard.yml";
 var init_epic_guard = __esm(() => {
   init_setup();
-  MODULE_DIR2 = dirname22(fileURLToPath2(import.meta.url));
+  MODULE_DIR2 = dirname23(fileURLToPath2(import.meta.url));
   EPIC_GUARD_PATH = join56(".github", "workflows", "epic-guard.yml");
 });
 
@@ -38862,7 +39023,7 @@ var init_doctor_relations = __esm(() => {
 });
 
 // src/commands/doctor-render.ts
-import { basename as basename14, relative as relative13, sep as sep4 } from "path";
+import { basename as basename15, relative as relative13, sep as sep4 } from "path";
 function shownPath(path3, root) {
   return path3.startsWith(`${root}${sep4}`) ? relative13(root, path3) : path3;
 }
@@ -38881,7 +39042,7 @@ function headLine2(preflight) {
     const checked2 = checkedPhrase(count2, automatic, "from the config ");
     return `Preflight with no plan, none being at ${where}: ${checked2}, no run started.`;
   }
-  const merged = prerequisitesFile === null ? "" : `, with ${basename14(prerequisitesFile)} merged in`;
+  const merged = prerequisitesFile === null ? "" : `, with ${basename15(prerequisitesFile)} merged in`;
   const checked = checkedPhrase(count2, automatic, "");
   return `Preflight for ${shownPath(plan, root)}${merged}: ${checked}, no run started.`;
 }
@@ -38903,7 +39064,7 @@ function reminderLines(preflight) {
   if (reminders.length === 0 || prerequisitesFile === null)
     return [];
   return [
-    `${basename14(prerequisitesFile)} names ${plural(reminders.length, "step")} the preflight does not check:`,
+    `${basename15(prerequisitesFile)} names ${plural(reminders.length, "step")} the preflight does not check:`,
     ...reminders.map((reminder) => `  line ${String(reminder.line)}: ${reminder.description}`)
   ];
 }
@@ -40926,7 +41087,7 @@ var init_doctor_release = __esm(() => {
 
 // src/commands/doctor-tiers.ts
 import { readFileSync as readFileSync48, realpathSync as realpathSync12 } from "fs";
-import { basename as basename15, dirname as dirname23 } from "path";
+import { basename as basename16, dirname as dirname24 } from "path";
 function readTextFile(path4) {
   try {
     return readFileSync48(path4, "utf8");
@@ -40934,7 +41095,7 @@ function readTextFile(path4) {
     return null;
   }
 }
-function realPathOf(path4) {
+function realPathOf2(path4) {
   try {
     return realpathSync12(path4);
   } catch {
@@ -40984,9 +41145,9 @@ function keptHolder(item) {
   return [item.winner, ...item.copies].find((holder) => holder.source === "rafa") ?? item.winner;
 }
 function deletion(holder) {
-  return holder.kind === "skill" && basename15(holder.path) === SKILL_FILE2 ? `delete ${dirname23(holder.path)} (only its ${SKILL_FILE2} was compared)` : `delete ${holder.path}`;
+  return holder.kind === "skill" && basename16(holder.path) === SKILL_FILE2 ? `delete ${dirname24(holder.path)} (only its ${SKILL_FILE2} was compared)` : `delete ${holder.path}`;
 }
-function copyRows(items, realPath = realPathOf) {
+function copyRows(items, realPath = realPathOf2) {
   return items.flatMap((item) => {
     if (item.state !== "served" || item.copies.length === 0)
       return [];
@@ -41028,7 +41189,7 @@ function doctorTierRows(inventory, installed, readers = {}) {
     ...unreviewedRows(inventory.records, readText7),
     ...cliVersionRows(installed),
     ...skillUseVersionRows(installed),
-    ...copyRows(inventory.resolution.items, readers.realPath ?? realPathOf),
+    ...copyRows(inventory.resolution.items, readers.realPath ?? realPathOf2),
     ...noProvenanceRows(inventory, readText7)
   ];
 }
@@ -41076,7 +41237,7 @@ var init_doctor_tiers = __esm(() => {
 });
 
 // src/commands/doctor.ts
-import { basename as basename16, resolve as resolve24 } from "path";
+import { basename as basename17, resolve as resolve24 } from "path";
 function refusal6(lines2) {
   return new CommandExit(1, [...lines2, NOTHING_CHECKED].join(`
 `));
@@ -41140,7 +41301,7 @@ async function loadItems2(plan, config) {
 function refuseMalformedItems2(plan, items) {
   if (plan === null || items.malformed.length === 0)
     return;
-  const file = basename16(prerequisitesPathForPlan(plan) ?? plan);
+  const file = basename17(prerequisitesPathForPlan(plan) ?? plan);
   const [head = "", ...rest] = malformedPrerequisiteLines(file, items.malformed);
   throw refusal6([
     `rafa doctor: ${head}`,
@@ -41165,7 +41326,7 @@ function readStartTier(plan, items) {
     return { tier: NO_START_TIER, items: NO_ITEMS3 };
   if (isFirstDispatch(plan))
     return { tier: { checked: start.length, skipped: 0, tracker: null }, items: start };
-  const tracker = basename16(trackerPathFor(plan));
+  const tracker = basename17(trackerPathFor(plan));
   return { tier: { checked: 0, skipped: start.length, tracker }, items: NO_ITEMS3 };
 }
 async function checkPreflight(context, project, seams) {
@@ -41655,7 +41816,7 @@ function formatTaskReports(report) {
   const rows2 = tallies.map(tallyCells);
   return [...lines2, ...alignRows(TASK_REPORT_COLUMNS, rows2, TASK_REPORT_RIGHT_ALIGNED)];
 }
-function oneLine7(text2) {
+function oneLine8(text2) {
   return text2.replace(/\s+/g, " ").trim();
 }
 function haltCells(halt2, check) {
@@ -41665,7 +41826,7 @@ function haltCells(halt2, check) {
     `${check.kind} ${JSON.stringify(check.item)}`,
     check.outcome,
     formatCount(check.durationMs),
-    oneLine7(check.failure)
+    oneLine8(check.failure)
   ];
 }
 function formatPreflightHalts(report) {
@@ -41836,7 +41997,7 @@ function outlierLines(outliers) {
     `outliers: ${plural(outliers.sessions.length, "recent session")} over ${formatMinutes(outliers.limitMinutes)} min` + " (baseline median + 3 robust SD)"
   ];
   for (const session of outliers.sessions.slice(0, OUTLIERS_LISTED)) {
-    lines2.push(`  ${formatMinutes(session.minutes)} min  ${formatTokens(session.outputTokens)} out` + `  ${session.outcome ?? "no report"}  ${session.loop}`, `    ${oneLine7(session.taskText ?? "").slice(0, TASK_TEXT_CHARS)}`);
+    lines2.push(`  ${formatMinutes(session.minutes)} min  ${formatTokens(session.outputTokens)} out` + `  ${session.outcome ?? "no report"}  ${session.loop}`, `    ${oneLine8(session.taskText ?? "").slice(0, TASK_TEXT_CHARS)}`);
   }
   if (outliers.sessions.length > OUTLIERS_LISTED) {
     lines2.push(`  and ${outliers.sessions.length - OUTLIERS_LISTED} more in --output=json`);
@@ -42303,7 +42464,7 @@ function budgetedSessions(rows2, budgets) {
 
 // src/effort/report-skills-format.ts
 function matchedCell(matches) {
-  const texts = [...new Set(matches.map(({ text: text2 }) => oneLine7(text2)))];
+  const texts = [...new Set(matches.map(({ text: text2 }) => oneLine8(text2)))];
   return texts.length === 0 ? "-" : texts.join(" / ");
 }
 function skillSignalCell(row3) {
@@ -42327,7 +42488,7 @@ function skillCells(row3) {
 function lessonCells(row3) {
   return [
     row3.id,
-    row3.artifact === null ? "unknown" : oneLine7(row3.artifact),
+    row3.artifact === null ? "unknown" : oneLine8(row3.artifact),
     formatCount(row3.injected),
     formatCount(row3.recurred),
     matchedCell(row3.matches),
@@ -42347,7 +42508,7 @@ function formatMetric2(value) {
 function formatPlanCi(reading2) {
   if (reading2 === null)
     return `${PLAN_CI_LABEL}: not read`;
-  const failing = reading2.failing.length === 0 ? "" : `, failing: ${reading2.failing.map(oneLine7).join(", ")}`;
+  const failing = reading2.failing.length === 0 ? "" : `, failing: ${reading2.failing.map(oneLine8).join(", ")}`;
   const sha = reading2.headSha.slice(0, SHORT_SHA_LENGTH);
   return `${PLAN_CI_LABEL}: ${reading2.verdict} on #${reading2.pr} at ${sha}, read ${reading2.readAt}${failing}`;
 }
@@ -45640,7 +45801,7 @@ var init_cancel = __esm(() => {
 
 // src/board/epic-template.ts
 import { existsSync as existsSync46, readFileSync as readFileSync51 } from "fs";
-import { dirname as dirname24, join as join68 } from "path";
+import { dirname as dirname25, join as join68 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 function epicTemplateSource(moduleDir = MODULE_DIR3) {
   return join68(moduleDir, TEMPLATES_DIRNAME, EPIC_TEMPLATE_FILE);
@@ -45676,7 +45837,7 @@ var MODULE_DIR3, EPIC_TEMPLATE_FILE = "epic.md", CRITERIA_PLACEHOLDERS, PLACEHOL
 var init_epic_template = __esm(() => {
   init_epic_body();
   init_setup();
-  MODULE_DIR3 = dirname24(fileURLToPath3(import.meta.url));
+  MODULE_DIR3 = dirname25(fileURLToPath3(import.meta.url));
   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."
   ]);
@@ -45757,7 +45918,7 @@ var init_epic_cost = __esm(() => {
 
 // src/epic/verify-plan.ts
 import { existsSync as existsSync47, readFileSync as readFileSync52 } from "fs";
-import { dirname as dirname25, join as join69 } from "path";
+import { dirname as dirname26, join as join69 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function opensCriterion(text2, state) {
   const item = LIST_ITEM2.exec(text2);
@@ -45802,7 +45963,7 @@ function criteriaToAsk(criteria) {
   return Object.freeze(criteria.filter((criterion) => !criterion.placeholder));
 }
 function verifyPromptCandidates(moduleDir = MODULE_DIR4) {
-  return [join69(moduleDir, VERIFY_PROMPT_FILE), join69(dirname25(moduleDir), VERIFY_PROMPT_FILE)];
+  return [join69(moduleDir, VERIFY_PROMPT_FILE), join69(dirname26(moduleDir), VERIFY_PROMPT_FILE)];
 }
 function readVerifyPrompt(moduleDir = MODULE_DIR4) {
   const candidates = verifyPromptCandidates(moduleDir);
@@ -45948,7 +46109,7 @@ var MODULE_DIR4, VERIFY_PROMPT_FILE = "epic-verify-prompt.md", VERIFY_BLOCK_FENC
 var init_verify_plan = __esm(() => {
   init_epic_template();
   init_blocks();
-  MODULE_DIR4 = dirname25(fileURLToPath4(import.meta.url));
+  MODULE_DIR4 = dirname26(fileURLToPath4(import.meta.url));
   VERIFY_PROMPT_SLOTS = ["EPIC_NUMBER", "EPIC_TITLE", "CRITERIA"];
   FENCE5 = /^\s*(?:`{3,}|~{3,})/u;
   LIST_ITEM2 = /^( {0,3})(?:[-*+]|\d{1,9}[.)])(?:\s|$)/u;
@@ -46153,9 +46314,371 @@ var init_verify_run = __esm(() => {
   VERDICT_KIND = VERDICT_BLOCK_FENCE.slice("rafa:".length);
 });
 
+// src/suite/baseline.ts
+import { existsSync as existsSync48, mkdirSync as mkdirSync17, readFileSync as readFileSync53, renameSync as renameSync9, writeFileSync as writeFileSync17 } from "fs";
+import { basename as basename18, dirname as dirname27, join as join71 } from "path";
+function baselinePathFor(trackerPath) {
+  const match = PLAN_FILE_NAME2.exec(basename18(trackerPath));
+  if (match === null) {
+    throw new RangeError(`baselinePathFor: ${trackerPath} is not a PLAN or PLAN_TRACKER file`);
+  }
+  return join71(dirname27(trackerPath), `${BASELINE_FILE_PREFIX}${match[1] ?? ""}.json`);
+}
+function copyFailure(failure6) {
+  return failure6.message === undefined ? { file: failure6.file, name: failure6.name } : { file: failure6.file, name: failure6.name, message: failure6.message };
+}
+function baselineOf(result2, recordedAt, commit) {
+  return {
+    version: BASELINE_VERSION,
+    recordedAt: recordedAt.toISOString(),
+    commit,
+    command: [...result2.command],
+    exitCode: result2.exitCode,
+    summary: result2.summary,
+    failures: result2.failures.map(copyFailure),
+    errors: result2.errors,
+    junit: result2.junit
+  };
+}
+function writeBaseline(path4, baseline) {
+  mkdirSync17(dirname27(path4), { recursive: true });
+  const temporary = `${path4}.${process.pid}.tmp`;
+  writeFileSync17(temporary, `${JSON.stringify(baseline, null, 2)}
+`, "utf8");
+  renameSync9(temporary, path4);
+}
+function isStringOrNull(value) {
+  return value === null || typeof value === "string";
+}
+function isFailure2(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const record = value;
+  const message = record["message"];
+  return typeof record["file"] === "string" && typeof record["name"] === "string" && (message === undefined || typeof message === "string");
+}
+function badField(record) {
+  const checks = [
+    ["recordedAt", (value) => typeof value === "string"],
+    ["commit", isStringOrNull],
+    ["command", (value) => Array.isArray(value) && value.every((part) => typeof part === "string")],
+    ["exitCode", (value) => Number.isInteger(value)],
+    ["summary", isStringOrNull],
+    ["failures", (value) => Array.isArray(value) && value.every(isFailure2)],
+    ["errors", (value) => value === null || Number.isInteger(value)],
+    ["junit", (value) => JUNIT_READINGS.includes(value)]
+  ];
+  const failed3 = checks.find(([key, check]) => !check(record[key]));
+  return failed3?.[0] ?? null;
+}
+function asBaseline(parsed) {
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return { state: "unreadable", reason: "not a JSON object" };
+  }
+  const record = parsed;
+  if (record["version"] !== BASELINE_VERSION) {
+    return { state: "unreadable", reason: `version ${JSON.stringify(record["version"])}, expected ${BASELINE_VERSION}` };
+  }
+  const bad = badField(record);
+  if (bad !== null)
+    return { state: "unreadable", reason: `field ${bad} is missing or malformed` };
+  return { state: "read", baseline: parsed };
+}
+function readBaseline(path4) {
+  if (!existsSync48(path4))
+    return { state: "missing" };
+  let text2;
+  try {
+    text2 = readFileSync53(path4, "utf8");
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    return { state: "unreadable", reason };
+  }
+  try {
+    return asBaseline(JSON.parse(text2));
+  } catch {
+    return { state: "unreadable", reason: "not JSON" };
+  }
+}
+function failureKey2(failure6) {
+  return JSON.stringify([failure6.file, failure6.name]);
+}
+function splitFailures(failures, baseline) {
+  const held = new Set((baseline?.failures ?? []).map(failureKey2));
+  return {
+    fresh: failures.filter((failure6) => !held.has(failureKey2(failure6))),
+    known: failures.filter((failure6) => held.has(failureKey2(failure6)))
+  };
+}
+var BASELINE_VERSION = 1, BASELINE_FILE_PREFIX = "SUITE_BASELINE", PLAN_FILE_NAME2, JUNIT_READINGS;
+var init_baseline = __esm(() => {
+  PLAN_FILE_NAME2 = /^PLAN(?:_TRACKER)?(-.+)?\.md$/;
+  JUNIT_READINGS = ["read", "missing", "unreadable"];
+});
+
+// src/triage/test-failure.ts
+function caseLineOf(line, index) {
+  const fail = FAIL_LINE.exec(line);
+  if (fail !== null)
+    return { index, name: fail[1], file: null };
+  const fileCase = FILE_CASE_LINE.exec(line);
+  return fileCase === null ? null : { index, name: fileCase[2], file: fileCase[1] };
+}
+function linesOf3(text2) {
+  return text2.split(/\r?\n/);
+}
+function caseLinesOf(lines2) {
+  return lines2.map((line, index) => caseLineOf(line, index)).filter((found) => found !== null);
+}
+function testFilesIn(text2) {
+  return text2.match(TEST_FILE_ANYWHERE) ?? [];
+}
+function firstEvidence(lines2) {
+  const found = lines2.find((line) => caseLineOf(line, 0) === null && !NOISE_LINES.some((noise) => noise.test(line)));
+  return found === undefined ? null : found.trim().replace(ERROR_PREFIX, "");
+}
+function testFileOf(found, artifactLines, what) {
+  if (found.file !== null)
+    return found.file;
+  const above = artifactLines.slice(0, found.index);
+  const header = above.map((line) => FILE_HEADER.exec(line)?.[1]).filter((file) => file !== undefined).at(-1);
+  const before = testFilesIn(above.join(`
+`));
+  const after = testFilesIn(artifactLines.slice(found.index).join(`
+`));
+  return header ?? before.at(-1) ?? after[0] ?? testFilesIn(what)[0] ?? null;
+}
+function evidenceOf(found, artifactLines) {
+  if (found === null)
+    return firstEvidence(artifactLines);
+  const cases = caseLinesOf(artifactLines);
+  const previous = cases.filter((other) => other.index < found.index).at(-1);
+  const next = cases.find((other) => other.index > found.index);
+  const before = artifactLines.slice(previous === undefined ? 0 : previous.index + 1, found.index);
+  const after = artifactLines.slice(found.index + 1, next === undefined ? artifactLines.length : next.index);
+  return firstEvidence(before) ?? firstEvidence(after);
+}
+function testFailureOf(bug) {
+  const artifactLines = linesOf3(bug.artifact ?? "");
+  const what = bug.what ?? "";
+  const inArtifact = caseLinesOf(artifactLines)[0];
+  if (inArtifact !== undefined) {
+    return {
+      file: testFileOf(inArtifact, artifactLines, what),
+      name: inArtifact.name,
+      evidence: evidenceOf(inArtifact, artifactLines)
+    };
+  }
+  const inWhat = caseLinesOf(linesOf3(what))[0];
+  if (inWhat === undefined)
+    return null;
+  return {
+    file: inWhat.file ?? testFilesIn(bug.artifact ?? "")[0] ?? testFilesIn(what)[0] ?? null,
+    name: inWhat.name,
+    evidence: evidenceOf(null, artifactLines)
+  };
+}
+var TEST_FILE = "(?:/?(?:[\\w.@+-]+/)*)[\\w.@+-]+\\.(?:test|spec)\\.[cm]?[jt]sx?", TEST_FILE_ANYWHERE, FAIL_LINE, FILE_CASE_LINE, FILE_HEADER, NOISE_LINES, ERROR_PREFIX;
+var init_test_failure = __esm(() => {
+  TEST_FILE_ANYWHERE = new RegExp(`(?<![\\w.@+/-])${TEST_FILE}(?![\\w])`, "g");
+  FAIL_LINE = /^\s*\(fail\)\s+(.+?)(?:\s+\[\d+(?:\.\d+)?m?s\])?\s*$/;
+  FILE_CASE_LINE = new RegExp(`^\\s*(${TEST_FILE})\\s+>\\s+(.+?)\\s*$`);
+  FILE_HEADER = new RegExp(`^\\s*(${TEST_FILE}):\\s*$`);
+  NOISE_LINES = [
+    /^\s*$/,
+    FILE_HEADER,
+    /^\s*\d+\s+\|/,
+    /^\s*\^+\s*$/,
+    /^\s*at\s/,
+    /^\s*bun test v/
+  ];
+  ERROR_PREFIX = /^error:\s+/;
+});
+
+// src/triage/bug-key.ts
+import { basename as basename19 } from "path";
+function hasText2(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function artifactOf(bug) {
+  return hasText2(bug.artifact) && textProblem(bug.artifact) === null ? bug.artifact : null;
+}
+function oneLine9(text2) {
+  return text2.replace(/\s+/g, " ").trim();
+}
+function strippedText(text2) {
+  const taken = text2.replace(COMMIT_HASH, "").replace(FOLDER_PREFIX, "").replace(NUMBER, "");
+  return oneLine9(taken);
+}
+function keyText(text2) {
+  const stripped = strippedText(text2);
+  return stripped.length > 0 ? stripped : oneLine9(text2);
+}
+function testFailureKeyOf(failure6) {
+  const test = failure6.file === null ? oneLine9(failure6.name) : `${basename19(failure6.file)}${CASE_SEPARATOR}${oneLine9(failure6.name)}`;
+  return failure6.evidence === null ? test : `${test}${KEY_SEPARATOR}${keyText(failure6.evidence)}`;
+}
+function bugKeyOf(trackerPath, artifact, what = null) {
+  const failure6 = testFailureOf({ what, artifact });
+  return failure6 === null ? `${basename19(trackerPath)}${KEY_SEPARATOR}${keyText(artifact)}` : testFailureKeyOf(failure6);
+}
+function legacyBugKeyOf(trackerPath, artifact) {
+  return `${basename19(trackerPath)}${KEY_SEPARATOR}${oneLine9(artifact)}`;
+}
+var KEY_SEPARATOR = ": ", CASE_SEPARATOR = " > ", COMMIT_HASH, FOLDER_PREFIX, NUMBER;
+var init_bug_key = __esm(() => {
+  init_findings();
+  init_test_failure();
+  COMMIT_HASH = /\b[0-9a-f]{7,40}\b/gi;
+  FOLDER_PREFIX = /[^\s'"`()[\]{}<>,;|]*\//g;
+  NUMBER = /\d+/g;
+});
+
+// src/triage/inherited.ts
+import { basename as basename20 } from "path";
+function isOpenIssueState(state) {
+  return !CLOSED_ISSUE_STATES.includes(state);
+}
+function sameFailure(failure6, baseline) {
+  const { file, evidence } = failure6;
+  if (file === null)
+    return false;
+  const sameTest = basename20(file) === basename20(baseline.file) && oneLine9(failure6.name) === oneLine9(baseline.name);
+  const message = baseline.message ?? null;
+  if (!sameTest || !hasText2(message))
+    return sameTest;
+  return evidence !== null && keyText(evidence).includes(keyText(message));
+}
+function inheritedFailureOf(bug, failures) {
+  const failure6 = testFailureOf(bug);
+  if (failure6 === null)
+    return null;
+  return failures.find((baseline) => sameFailure(failure6, baseline)) ?? null;
+}
+var CLOSED_ISSUE_STATES;
+var init_inherited = __esm(() => {
+  init_bug_key();
+  init_test_failure();
+  CLOSED_ISSUE_STATES = ["done", "released", "cancelled"];
+});
+
+// src/triage/issue-text.ts
+function fenced(value) {
+  const runs = Array.from(value.matchAll(/`+/g), (run) => run[0].length);
+  const fence = "`".repeat(Math.max(MIN_FENCE_LENGTH3, ...runs.map((length) => length + 1)));
+  const body = value.endsWith(`
+`) ? value : `${value}
+`;
+  return `${fence}
+${body}${fence}`;
+}
+function issueTitle2(redactedWhat) {
+  const line = oneLine9(redactedWhat);
+  const points = Array.from(line);
+  if (points.length <= TITLE_MAX_LENGTH)
+    return line;
+  const kept = points.slice(0, TITLE_MAX_LENGTH - TITLE_CUT.length).join("");
+  return `${kept.trimEnd()}${TITLE_CUT}`;
+}
+function scoreText(score) {
+  return score.toFixed(2);
+}
+function similarCommentOpening(score, threshold) {
+  return `${COMMENT_OPENING} No key found this issue: the report's words match its first report` + ` at a Jaccard similarity of ${scoreText(score)}, at or above the threshold of` + ` ${String(threshold)}, so it is taken for the same bug.`;
+}
+function possibleDuplicatesSection(duplicates2, redact) {
+  const intro = `No open bug scored at or above the similarity threshold of ${String(duplicates2.threshold)}.`;
+  const listed4 = duplicates2.nearest.length === 0 ? "No open bug shares a word with this one." : duplicates2.nearest.map(({ issue: issue4, score }) => `- ${issueNameOf(issue4.ref)} (score ${scoreText(score)})`).join(`
+`);
+  return `## Possible duplicates
+
+${redact(`${intro}
+
+${listed4}`)}`;
+}
+function issueNameOf(ref14) {
+  return ref14.url ?? `${ref14.kind} issue ${ref14.externalId}`;
+}
+function supersedesSection(closed, redact) {
+  const sentence = `This bug came back after ${issueNameOf(closed)} was closed as completed;` + " this issue is filed in its place.";
+  return `## Supersedes
+
+${redact(sentence)}`;
+}
+function section2(heading, value, absent6, redact) {
+  const shown2 = value === null ? absent6 : fenced(redact(value));
+  return `## ${heading}
+
+${shown2}`;
+}
+function issueText(opening, values, redact) {
+  return [
+    opening,
+    ...values.supersedes === undefined ? [] : [supersedesSection(values.supersedes, redact)],
+    section2("What", values.what, "", redact),
+    section2("Artifact", values.artifact, "The report gave no artifact, so a recurrence files again.", redact),
+    ...values.refs === null ? [] : [values.refs],
+    section2("Recurrence key", values.key, "The report gave no artifact, so this bug has no key.", redact),
+    section2("Plan", values.planStub, "The dispatch resolved no plan stub.", redact),
+    section2("Task", values.taskText, "", redact),
+    section2("Feedback", values.feedback, "The report gave no feedback.", redact),
+    ...values.duplicates === undefined ? [] : [possibleDuplicatesSection(values.duplicates, redact)]
+  ].join(`
+
+`) + `
+`;
+}
+var TITLE_MAX_LENGTH = 120, TITLE_CUT = "...", MIN_FENCE_LENGTH3 = 3, ISSUE_OPENING, COMMENT_OPENING = "Reported again by a rafa task session.";
+var init_issue_text = __esm(() => {
+  init_bug_key();
+  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.";
+});
+
+// src/triage/local-paths.ts
+import { realpathSync as realpathSync13 } from "fs";
+import { resolve as resolve29 } from "path";
+function literalPattern(text2) {
+  return text2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function forms(path4) {
+  const given = resolve29(path4);
+  try {
+    const real = realpathSync13(given);
+    return real === given ? [given] : [given, real];
+  } catch {
+    return [given];
+  }
+}
+function isRoot(path4) {
+  return path4.length > 1;
+}
+function localPathRedactor(repoRoot, home) {
+  const asHome = (pattern) => ({ pattern, under: `${HOME_MARKER}/`, bare: HOME_MARKER });
+  const asRepo = (pattern) => ({ pattern, under: "", bare: "." });
+  const literals = [
+    ...forms(repoRoot).filter(isRoot).map((root) => asRepo(literalPattern(root))),
+    ...forms(home).filter(isRoot).map((root) => asHome(literalPattern(root)))
+  ];
+  const roots = [
+    ...[...literals].sort((a, b) => b.pattern.length - a.pattern.length),
+    asHome(HOME_PATTERN)
+  ];
+  const alternatives = roots.map(({ pattern }) => `(${pattern})(?:${UNDER}|${PATH_END})`);
+  const matcher = new RegExp(`${PATH_START}(?:${alternatives.join("|")})`, "g");
+  return (text2) => text2.replace(matcher, (...groups) => {
+    const index = roots.findIndex((_, at) => groups[1 + at * 2] !== undefined);
+    const root = roots[index];
+    return groups[2 + index * 2] === undefined ? root.bare : root.under;
+  });
+}
+var HOME_MARKER = "[redacted: HOME]", SEGMENT = "[^/\\s'\"`()<>:,;]+", HOME_PATTERN, PATH_START = "(?:(?<![\\w.\\-])|(?<=(?:^|\\s)-[A-Za-z]))", UNDER = "(/)(?=[^\\s'\"`()<>])", PATH_END = "(?![\\w\\-]|\\.[\\w.\\-/])";
+var init_local_paths = __esm(() => {
+  HOME_PATTERN = `(?:/${SEGMENT})*?/(?:Users|home)/${SEGMENT}`;
+});
+
 // src/effort/store/tracker-refs.ts
 import { randomUUID as randomUUID15 } from "crypto";
-import { existsSync as existsSync48 } from "fs";
+import { existsSync as existsSync49 } from "fs";
 function refused3(call, reason) {
   return new Error(`effort store: tracker ref ${call} ${reason}; ${REFUSAL_TAILS[call]}`);
 }
@@ -46217,7 +46740,7 @@ function heldRefOf(path4, seq, text2) {
     return stored;
   throw new Error(`effort store: ${path4}: findings row ${seq} holds a tracker_ref ${stored};` + " no writer stores one");
 }
-function placeRef(db, path4, write, wanted, insertValues) {
+function placeRef(db, path4, write, wanted, superseded, insertValues) {
   const held = db.query(SELECT_HELD2).get(write.dispatch.sessionId, write.artifact);
   if (held === null) {
     db.query(INSERT_REF).run(...insertValues());
@@ -46228,14 +46751,27 @@ function placeRef(db, path4, write, wanted, insertValues) {
     return ["attached", wanted.ref];
   }
   const kept = heldRefOf(path4, held.seq, held.tracker_ref);
+  if (kept.json === superseded?.json)
+    throw new SupersedeInSessionRefusal(path4, held.seq);
   return kept.json === wanted.json ? ["held", kept.ref] : ["conflict", kept.ref];
 }
+function supersededOf(write, wanted) {
+  if (write.supersedes === undefined)
+    return null;
+  const superseded = storedRefOf(write.supersedes);
+  if (typeof superseded === "string")
+    throw refused3("write", `supersedes a reference ${superseded}`);
+  if (superseded.json === wanted.json)
+    throw refused3("write", "supersedes the reference it writes");
+  return superseded;
+}
 function writeTrackerRef(repoRoot, write, seams = {}) {
   checkDispatch("tracker ref", write.dispatch, write.outcome);
   checkArtifact2("write", write.artifact);
   const wanted = storedRefOf(write.ref);
   if (typeof wanted === "string")
     throw refused3("write", `has a reference ${wanted}`);
+  const superseded = supersededOf(write, wanted);
   const path4 = sqliteStorePath(repoRoot);
   const { sessionId, planStub: planStub2, taskLine: taskLine2 } = write.dispatch;
   const collectedAt = (seams.now ?? (() => new Date))().toISOString();
@@ -46250,8 +46786,8 @@ function writeTrackerRef(repoRoot, write, seams = {}) {
     wanted.json,
     collectedAt
   ];
-  const [action, stored] = withSqliteStore(path4, "write", !existsSync48(path4), (db) => {
-    const place2 = db.transaction(() => placeRef(db, path4, write, wanted, insertValues));
+  const [action, stored] = withSqliteStore(path4, "write", !existsSync49(path4), (db) => {
+    const place2 = db.transaction(() => placeRef(db, path4, write, wanted, superseded, insertValues));
     return place2.immediate();
   });
   return { path: path4, action, stored };
@@ -46259,20 +46795,15 @@ function writeTrackerRef(repoRoot, write, seams = {}) {
 function readTrackerRef(repoRoot, artifact) {
   checkArtifact2("read", artifact);
   const path4 = sqliteStorePath(repoRoot);
-  if (!existsSync48(path4))
+  if (!existsSync49(path4))
     return null;
-  const oldest = withSqliteStore(path4, "read", false, (db) => db.query(SELECT_OLDEST).get(artifact));
-  return oldest === null ? null : heldRefOf(path4, oldest.seq, oldest.tracker_ref).ref;
+  const newest = withSqliteStore(path4, "read", false, (db) => db.query(SELECT_NEWEST).get(artifact));
+  return newest === null ? null : heldRefOf(path4, newest.seq, newest.tracker_ref).ref;
 }
 var SELECT_HELD2 = `
   SELECT seq, tracker_ref FROM findings
   WHERE session_id = ? AND artifact = ?
-`, INSERT_REF, ATTACH_REF = "UPDATE findings SET tracker_ref = ? WHERE seq = ? AND tracker_ref IS NULL", SELECT_OLDEST = `
-  SELECT seq, tracker_ref FROM findings
-  WHERE artifact = ? AND tracker_ref IS NOT NULL
-  ORDER BY seq
-  LIMIT 1
-`, REFUSAL_TAILS, REF_FIELDS;
+`, INSERT_REF, ATTACH_REF = "UPDATE findings SET tracker_ref = ? WHERE seq = ? AND tracker_ref IS NULL", NEWEST_FIRST, SELECT_NEWEST, REFUSAL_TAILS, REF_FIELDS, SupersedeInSessionRefusal;
 var init_tracker_refs = __esm(() => {
   init_findings();
   init_origins();
@@ -46285,6 +46816,13 @@ var init_tracker_refs = __esm(() => {
     ${STAMPED_COLUMNS}
   )
   VALUES (?, ?, ?, ?, ?, ?, ?, ?, ${stampedValues("findings")})
+`;
+  NEWEST_FIRST = ACROSS_STORES_ORDER.split(",").map((term) => `${term.trim()} DESC`).join(", ");
+  SELECT_NEWEST = `
+  SELECT seq, tracker_ref FROM findings
+  WHERE artifact = ? AND tracker_ref IS NOT NULL
+  ORDER BY ${NEWEST_FIRST}
+  LIMIT 1
 `;
   REFUSAL_TAILS = { write: "nothing written", read: "nothing opened" };
   REF_FIELDS = [
@@ -46295,48 +46833,16 @@ var init_tracker_refs = __esm(() => {
     ["module", optionalText3],
     ["repo", optionalText3]
   ];
-});
-
-// src/triage/local-paths.ts
-import { realpathSync as realpathSync13 } from "fs";
-import { resolve as resolve29 } from "path";
-function literalPattern(text2) {
-  return text2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function forms(path4) {
-  const given = resolve29(path4);
-  try {
-    const real = realpathSync13(given);
-    return real === given ? [given] : [given, real];
-  } catch {
-    return [given];
-  }
-}
-function isRoot(path4) {
-  return path4.length > 1;
-}
-function localPathRedactor(repoRoot, home) {
-  const asHome = (pattern) => ({ pattern, under: `${HOME_MARKER}/`, bare: HOME_MARKER });
-  const asRepo = (pattern) => ({ pattern, under: "", bare: "." });
-  const literals = [
-    ...forms(repoRoot).filter(isRoot).map((root) => asRepo(literalPattern(root))),
-    ...forms(home).filter(isRoot).map((root) => asHome(literalPattern(root)))
-  ];
-  const roots = [
-    ...[...literals].sort((a, b) => b.pattern.length - a.pattern.length),
-    asHome(HOME_PATTERN)
-  ];
-  const alternatives = roots.map(({ pattern }) => `(${pattern})(?:${UNDER}|${PATH_END})`);
-  const matcher = new RegExp(`${PATH_START}(?:${alternatives.join("|")})`, "g");
-  return (text2) => text2.replace(matcher, (...groups) => {
-    const index = roots.findIndex((_, at) => groups[1 + at * 2] !== undefined);
-    const root = roots[index];
-    return groups[2 + index * 2] === undefined ? root.bare : root.under;
-  });
-}
-var HOME_MARKER = "[redacted: HOME]", SEGMENT = "[^/\\s'\"`()<>:,;]+", HOME_PATTERN, PATH_START = "(?:(?<![\\w.\\-])|(?<=(?:^|\\s)-[A-Za-z]))", UNDER = "(/)(?=[^\\s'\"`()<>])", PATH_END = "(?![\\w\\-]|\\.[\\w.\\-/])";
-var init_local_paths = __esm(() => {
-  HOME_PATTERN = `(?:/${SEGMENT})*?/(?:Users|home)/${SEGMENT}`;
+  SupersedeInSessionRefusal = class SupersedeInSessionRefusal extends Error {
+    path;
+    seq;
+    constructor(path4, seq) {
+      super(`effort store: ${path4}: tracker ref write supersedes the reference findings row ${seq} holds` + " for this session and artifact, and findings_by_artifact holds one row per session and" + " artifact; nothing written");
+      this.name = "SupersedeInSessionRefusal";
+      this.path = path4;
+      this.seq = seq;
+    }
+  };
 });
 
 // src/triage/refs-section.ts
@@ -46406,11 +46912,77 @@ var init_refs_section = __esm(() => {
   };
 });
 
+// src/triage/similarity.ts
+import { basename as basename21 } from "path";
+function wordSetOf(text2) {
+  const words = strippedText(text2).toLowerCase().split(NON_WORD2).filter((word) => word.length > 0);
+  return new Set(words);
+}
+function reportWordsOf(report2) {
+  return wordSetOf(`${report2.what ?? ""}
+${report2.artifact ?? ""}`);
+}
+function jaccard(a, b) {
+  const shared = [...a].filter((word) => b.has(word)).length;
+  const all = a.size + b.size - shared;
+  return all === 0 ? 0 : shared / all;
+}
+function fencedValueAt(lines2, start) {
+  const open = lines2.slice(start).findIndex((line) => line.trim().length > 0);
+  if (open === -1)
+    return null;
+  const fence = lines2[start + open];
+  if (!FENCE_LINE6.test(fence))
+    return null;
+  const body = lines2.slice(start + open + 1);
+  const close = body.indexOf(fence);
+  return close === -1 ? null : body.slice(0, close).join(`
+`);
+}
+function sectionValueOf(body, heading) {
+  const lines2 = body.split(/\r?\n/);
+  const at = lines2.findIndex((line) => HEADING_LINE3.exec(line)?.[1]?.trim() === heading);
+  return at === -1 ? null : fencedValueAt(lines2, at + 1);
+}
+function issueTextOf(body) {
+  return {
+    what: sectionValueOf(body, "What"),
+    artifact: sectionValueOf(body, "Artifact")
+  };
+}
+function testFileOf2(text2) {
+  const file = testFailureOf(text2)?.file ?? testFilesIn(text2.artifact ?? "")[0] ?? testFilesIn(text2.what ?? "")[0] ?? null;
+  return file === null ? null : basename21(file);
+}
+function namesOtherTestFile(reportFile, issueFile) {
+  return reportFile !== null && issueFile !== null && reportFile !== issueFile;
+}
+function nearestOpenBugs(report2, openBugs) {
+  const words = reportWordsOf(report2);
+  const reportFile = testFileOf2(report2);
+  const scored = openBugs.flatMap((issue4) => {
+    const text2 = issueTextOf(issue4.body);
+    if (namesOtherTestFile(reportFile, testFileOf2(text2)))
+      return [];
+    const score = jaccard(words, reportWordsOf(text2));
+    return score > 0 ? [{ issue: issue4, score }] : [];
+  });
+  return [...scored].sort((a, b) => b.score - a.score);
+}
+var NON_WORD2, FENCE_LINE6, HEADING_LINE3;
+var init_similarity = __esm(() => {
+  init_bug_key();
+  init_test_failure();
+  NON_WORD2 = /\W+/;
+  FENCE_LINE6 = /^`{3,}$/;
+  HEADING_LINE3 = /^## (.+)$/;
+});
+
 // src/triage/triage.ts
 import { homedir as homedir9 } from "os";
-import { basename as basename17, join as join71 } from "path";
+import { join as join72 } from "path";
 function privateTriageDir(repoRoot) {
-  return join71(repoRoot, PRIVATE_TRIAGE_DIR);
+  return join72(repoRoot, PRIVATE_TRIAGE_DIR);
 }
 function createPrivateTriageTracker(repoRoot, options = {}) {
   return createLocalTracker({
@@ -46445,9 +47017,6 @@ function redactSecrets(text2, secrets) {
   const pattern = new RegExp(values.map(literalPattern2).join("|"), "g");
   return text2.replace(pattern, (value) => `[redacted: ${nameByValue.get(value)}]`);
 }
-function hasText2(value) {
-  return typeof value === "string" && value.trim().length > 0;
-}
 function blockerTextOf(blockers) {
   const texts = blockers.map((blocker) => blocker.what).filter(hasText2);
   return texts.length === 0 ? null : texts.join(BLOCKER_SEPARATOR);
@@ -46466,57 +47035,11 @@ function triageBlockers(options) {
     return { text: text2, written: false, problem: `the blocker was not written: ${messageOf(error)}` };
   }
 }
-function artifactOf(bug) {
-  return hasText2(bug.artifact) && textProblem(bug.artifact) === null ? bug.artifact : null;
-}
-function oneLine8(text2) {
-  return text2.replace(/\s+/g, " ").trim();
-}
-function bugKeyOf(trackerPath, artifact) {
-  return `${basename17(trackerPath)}${KEY_SEPARATOR}${oneLine8(artifact)}`;
-}
-function fenced(value) {
-  const runs = Array.from(value.matchAll(/`+/g), (run) => run[0].length);
-  const fence = "`".repeat(Math.max(MIN_FENCE_LENGTH3, ...runs.map((length) => length + 1)));
-  const body = value.endsWith(`
-`) ? value : `${value}
-`;
-  return `${fence}
-${body}${fence}`;
-}
-function issueTitle2(redactedWhat) {
-  const line = oneLine8(redactedWhat);
-  const points = Array.from(line);
-  if (points.length <= TITLE_MAX_LENGTH)
-    return line;
-  const kept = points.slice(0, TITLE_MAX_LENGTH - TITLE_CUT.length).join("");
-  return `${kept.trimEnd()}${TITLE_CUT}`;
-}
-function section2(heading, value, absent6, redact) {
-  const shown2 = value === null ? absent6 : fenced(redact(value));
-  return `## ${heading}
-
-${shown2}`;
-}
-function issueText(opening, values, redact) {
-  return [
-    opening,
-    section2("What", values.what, "", redact),
-    section2("Artifact", values.artifact, "The report gave no artifact, so a recurrence files again.", redact),
-    ...values.refs === null ? [] : [values.refs],
-    section2("Recurrence key", values.key, "The report gave no artifact, so this bug has no key.", redact),
-    section2("Plan", values.planStub, "The dispatch resolved no plan stub.", redact),
-    section2("Task", values.taskText, "", redact),
-    section2("Feedback", values.feedback, "The report gave no feedback.", redact)
-  ].join(`
-
-`) + `
-`;
-}
 async function filingFor(what, bug, options, local, redact, verifyRefs) {
   const reported2 = artifactOf(bug);
   const artifact = reported2 === null ? null : local(reported2);
-  const searchText = artifact === null ? null : bugKeyOf(options.trackerPath, redact(artifact));
+  const searchText = artifact === null ? null : bugKeyOf(options.trackerPath, redact(artifact), redact(what));
+  const key = artifact === null ? null : bugKeyOf(options.trackerPath, artifact, local(what));
   const refs2 = await buildRefsSection(artifact === null ? null : redact(artifact), verifyRefs);
   const values = {
     what,
@@ -46540,10 +47063,23 @@ async function filingFor(what, bug, options, local, redact, verifyRefs) {
     },
     comment: issueText(COMMENT_OPENING, values, redact),
     searchText,
-    key: artifact === null ? null : bugKeyOf(options.trackerPath, artifact),
-    legacyKey: reported2 === null || reported2 === artifact ? null : bugKeyOf(options.trackerPath, reported2)
+    key,
+    legacyKeys: legacyKeysOf(options.trackerPath, key, reported2, artifact),
+    values,
+    compared: { what: local(what), artifact }
   };
 }
+function legacyKeysOf(trackerPath, key, reported2, artifact) {
+  if (key === null || reported2 === null || artifact === null)
+    return [];
+  const keys = [legacyBugKeyOf(trackerPath, artifact), legacyBugKeyOf(trackerPath, reported2)];
+  return [...new Set(keys)].filter((legacy) => legacy !== key);
+}
+function similarityStepOf(options) {
+  const threshold = options.similarity?.triageSimilarityThreshold;
+  const candidates = options.similarity?.triageSimilarityCandidates;
+  return typeof threshold === "number" && typeof candidates === "number" ? { threshold, candidates } : null;
+}
 async function step(run, name2, action) {
   try {
     return { ok: true, value: await action() };
@@ -46563,47 +47099,109 @@ function resultOf5(run, action, fields = {}) {
     ...fields
   };
 }
-async function settle2(run, action, ref14, foundBy) {
+async function settle2(run, action, ref14, foundBy, supersedes) {
   const { store } = run.route;
   const { key } = run.filing;
   if (store === null || key === null)
     return resultOf5(run, action, { ref: ref14, foundBy });
-  const stored = await step(run, "storing the reference", () => store(key, ref14));
+  const stored = await step(run, "storing the reference", () => store(key, ref14, supersedes));
   return stored.ok ? resultOf5(run, action, { ref: ref14, foundBy, stored: stored.value }) : resultOf5(run, action, { ref: ref14, foundBy, problem: stored.problem });
 }
-async function fileNew(run) {
-  const created = await step(run, `the ${run.route.channel} tracker create`, () => run.route.tracker.create(run.filing.draft));
-  return created.ok ? settle2(run, "filed", created.value, null) : resultOf5(run, "failed", { problem: created.problem });
+async function fileNew(run, extras = {}) {
+  const { filing } = run;
+  const draft = extras.supersedes === undefined && extras.duplicates === undefined ? filing.draft : { ...filing.draft, body: issueText(ISSUE_OPENING, { ...filing.values, ...extras }, run.redact) };
+  const created = await step(run, `the ${run.route.channel} tracker create`, () => run.route.tracker.create(draft));
+  return created.ok ? settle2(run, "filed", created.value, null, extras.supersedes) : resultOf5(run, "failed", { problem: created.problem });
 }
-async function commentOn2(run, ref14, foundBy) {
-  const commented = await step(run, `the ${run.route.channel} tracker comment`, () => run.route.tracker.comment(ref14, run.filing.comment));
+async function commentOn2(run, ref14, foundBy, action = "commented", comment = run.filing.comment) {
+  const commented = await step(run, `the ${run.route.channel} tracker comment`, () => run.route.tracker.comment(ref14, comment));
   if (!commented.ok)
     return resultOf5(run, "failed", { ref: ref14, foundBy, problem: commented.problem });
-  return foundBy === "store" ? resultOf5(run, "commented", { ref: ref14, foundBy }) : settle2(run, "commented", ref14, foundBy);
+  return foundBy === "store" ? resultOf5(run, action, { ref: ref14, foundBy }) : settle2(run, action, ref14, foundBy);
 }
-async function triageBug(run) {
+async function lookUp2(run, key, searchText) {
   const { route, filing } = run;
-  const { key, searchText } = filing;
-  if (key === null || searchText === null)
-    return fileNew(run);
   const { readStored } = route;
   if (readStored !== null) {
-    for (const storedKey of [key, filing.legacyKey]) {
-      if (storedKey === null)
-        continue;
+    for (const storedKey of [key, ...filing.legacyKeys]) {
       const stored = await step(run, "reading the stored reference", () => readStored(storedKey));
       if (!stored.ok)
-        return resultOf5(run, "failed", { problem: stored.problem });
+        return stored;
       if (stored.value !== null && stored.value.kind === route.tracker.kind) {
-        return commentOn2(run, stored.value, "store");
+        return { ok: true, value: { ref: stored.value, foundBy: "store" } };
       }
     }
   }
   const found = await step(run, `the ${route.channel} tracker find`, () => route.tracker.find({ text: searchText, type: "bug" }));
   if (!found.ok)
-    return resultOf5(run, "failed", { problem: found.problem });
+    return found;
   const [match] = found.value;
-  return match === undefined ? fileNew(run) : commentOn2(run, match, "find");
+  return {
+    ok: true,
+    value: match === undefined ? null : { ref: match, foundBy: "find" }
+  };
+}
+async function answerRecurrence(run, { ref: ref14, foundBy }) {
+  if (!run.route.readsState)
+    return commentOn2(run, ref14, foundBy);
+  const issue4 = await step(run, `the ${run.route.channel} tracker get`, () => run.route.tracker.get(ref14));
+  if (!issue4.ok)
+    return resultOf5(run, "failed", { ref: ref14, foundBy, problem: issue4.problem });
+  return COMPLETED_ISSUE_STATES.includes(issue4.value.state) ? fileNew(run, { supersedes: ref14 }) : commentOn2(run, ref14, foundBy);
+}
+async function commentOnNearest(run, nearest, threshold) {
+  const opening = similarCommentOpening(nearest.score, threshold);
+  const comment = issueText(opening, run.filing.values, run.redact);
+  const result2 = await commentOn2(run, nearest.issue.ref, "similarity", "commented", comment);
+  return { ...result2, score: nearest.score };
+}
+async function answerMiss(run) {
+  const { tracker, similarity } = run.route;
+  const list = tracker.openIssues;
+  if (similarity === null || list === undefined)
+    return fileNew(run);
+  const listed4 = await step(run, `the ${run.route.channel} tracker openIssues`, () => list.call(tracker, "bug"));
+  if (!listed4.ok)
+    return resultOf5(run, "failed", { problem: listed4.problem });
+  const nearest = nearestOpenBugs(run.filing.compared, listed4.value);
+  const [first] = nearest;
+  return first !== undefined && first.score >= similarity.threshold ? commentOnNearest(run, first, similarity.threshold) : fileNew(run, { duplicates: { threshold: similarity.threshold, nearest: nearest.slice(0, similarity.candidates) } });
+}
+async function triageBug(run) {
+  const { key, searchText } = run.filing;
+  if (key === null || searchText === null)
+    return fileNew(run);
+  const found = await lookUp2(run, key, searchText);
+  if (!found.ok)
+    return resultOf5(run, "failed", { problem: found.problem });
+  return found.value === null ? answerMiss(run) : answerRecurrence(run, found.value);
+}
+async function triageInherited(run, commented) {
+  const { key, searchText } = run.filing;
+  if (key === null || searchText === null || commented.has(key))
+    return resultOf5(run, "inherited");
+  const found = await lookUp2(run, key, searchText);
+  if (!found.ok)
+    return resultOf5(run, "failed", { problem: found.problem });
+  if (found.value === null)
+    return resultOf5(run, "inherited");
+  const { ref: ref14, foundBy } = found.value;
+  const issue4 = await step(run, `the ${run.route.channel} tracker get`, () => run.route.tracker.get(ref14));
+  if (!issue4.ok)
+    return resultOf5(run, "failed", { ref: ref14, foundBy, problem: issue4.problem });
+  if (!isOpenIssueState(issue4.value.state))
+    return resultOf5(run, "inherited");
+  const result2 = await commentOn2(run, ref14, foundBy, "inherited");
+  if (result2.action === "inherited")
+    commented.add(key);
+  return result2;
+}
+function localBug(bug, what, local) {
+  const artifact = artifactOf(bug);
+  return {
+    what: local(what),
+    artifact: artifact === null ? null : local(artifact)
+  };
 }
 function skippedRow(index, channel, problem) {
   return { index, channel, action: "skipped", ref: null, foundBy: null, stored: null, problem };
@@ -46632,14 +47230,24 @@ async function triageReport(options) {
       channel: "public",
       tracker: options.tracker,
       readStored: (key) => readTrackerRef(repoRoot, key),
-      store: (key, ref14) => writeTrackerRef(repoRoot, {
+      store: (key, ref14, supersedes) => writeTrackerRef(repoRoot, {
         dispatch: options.dispatch,
         outcome: options.outcome,
         artifact: key,
-        ref: ref14
-      }, options.seams).action
+        ref: ref14,
+        ...supersedes === undefined ? {} : { supersedes }
+      }, options.seams).action,
+      readsState: true,
+      similarity: similarityStepOf(options)
     },
-    private: { channel: "private", tracker: privateTracker, readStored: null, store: null }
+    private: {
+      channel: "private",
+      tracker: privateTracker,
+      readStored: null,
+      store: null,
+      readsState: false,
+      similarity: null
+    }
   };
   const bugs = [];
   for (const [index, bug] of options.report.outOfScopeBugs.entries()) {
@@ -46655,26 +47263,97 @@ async function triageReport(options) {
       continue;
     }
     const filing = await filingFor(what, bug, options, local, redact, verifyRefs);
-    bugs.push(await triageBug({ route, index, filing, redact }));
+    const run = { route, index, filing, redact };
+    const { inherited } = options;
+    const isInherited = route.channel === "public" && inherited !== undefined && inheritedFailureOf(localBug(bug, what, local), inherited.failures) !== null;
+    bugs.push(isInherited ? await triageInherited(run, inherited.commented) : await triageBug(run));
   }
   return { blocker, bugs };
 }
-var PRIVATE_TRIAGE_DIR, SECRET_ENV_NAMES, TRIAGE_MODULE = "unassigned", BLOCKER_SEPARATOR = "; ", KEY_SEPARATOR = ": ", TITLE_MAX_LENGTH = 120, TITLE_CUT = "...", MIN_FENCE_LENGTH3 = 3, ISSUE_OPENING, COMMENT_OPENING = "Reported again by a rafa task session.";
+var PRIVATE_TRIAGE_DIR, SECRET_ENV_NAMES, TRIAGE_MODULE = "unassigned", BLOCKER_SEPARATOR = "; ", COMPLETED_ISSUE_STATES;
 var init_triage2 = __esm(() => {
   init_local2();
   init_config_sections();
-  init_findings();
   init_tracker_refs();
   init_tracker();
+  init_bug_key();
+  init_inherited();
+  init_issue_text();
   init_local_paths();
   init_machine_fault();
   init_refs_section();
-  PRIVATE_TRIAGE_DIR = join71(".rafa", "triage", "private");
+  init_similarity();
+  init_bug_key();
+  init_issue_text();
+  PRIVATE_TRIAGE_DIR = join72(".rafa", "triage", "private");
   SECRET_ENV_NAMES = ["GITHUB_TOKEN", "ANTHROPIC_API_KEY", "LINEAR_API_KEY"];
-  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.";
+  COMPLETED_ISSUE_STATES = ["done", "released"];
+});
+
+// src/start/loop-events.ts
+import { join as join73 } from "path";
+function quoted3(text2) {
+  return `"${oneLine(text2).replaceAll('"', "\\\"")}"`;
+}
+function taskKind(position, verb) {
+  return padKind(`task ${position.index}/${position.total} ${verb}`);
+}
+function minutes(durationMs) {
+  return `${Math.max(1, Math.round(durationMs / MINUTE_MS))}m`;
+}
+function summaryOf3(event) {
+  switch (event.kind) {
+    case "task-start":
+      return `${taskKind(event.position, "start")}${quoted3(event.text)}`;
+    case "task-done":
+      return event.tokens === null ? `${taskKind(event.position, "done")}${minutes(event.durationMs)}` : `${taskKind(event.position, "done")}${minutes(event.durationMs)}  ${Math.round(event.tokens / TOKENS_PER_K)}k tokens`;
+    case "task-blocked":
+      return `${taskKind(event.position, "blocked")}${oneLine(event.reason)}`;
+    case "wrap-up":
+      return `${padKind("wrap-up")}${event.phase}`;
+    case "pr":
+      return `pr #${event.number} opened`;
+    case "no-pr":
+      return `${padKind("no pr")}${oneLine(event.reason)}`;
+    case "halt":
+      return `${padKind("halt")}${oneLine(event.reason)}`;
+    case "inherited":
+      return `${padKind("inherited")}${oneLine(`${event.file} > ${event.name}`)}`;
+  }
+}
+function emitLoopEvent(event, now = () => new Date) {
+  const { kind, ...data } = event;
+  activeOutput().emit({ type: "event", name: kind, summary: summaryOf3(event), data, ts: now().toISOString() });
+}
+async function unlessText(read) {
+  return activeOutputMode() === "text" ? null : read();
+}
+function taskPosition(trackerContent, lineNum) {
+  const { tasks } = parsePlan(trackerContent);
+  return { index: tasks.findIndex((task) => task.lineNum === lineNum) + 1, total: tasks.length };
+}
+async function taskTokens(checkout, sessionId, home) {
+  try {
+    const { usage } = await readSessionLog(join73(sessionLogDir(checkout, home), `${sessionId}.jsonl`));
+    return usage.inputTokens + usage.cacheCreationInputTokens + usage.outputTokens;
+  } catch {
+    return null;
+  }
+}
+var MINUTE_MS = 60000, TOKENS_PER_K = 1000;
+var init_loop_events = __esm(() => {
+  init_active();
+  init_collect();
+  init_session_log();
+  init_plan();
 });
 
 // src/start/triage.ts
+import { homedir as homedir10 } from "os";
+function foundByText(bug) {
+  const found = FOUND_BY[bug.foundBy ?? "find"];
+  return bug.score === undefined ? found : `${found} (score ${scoreText(bug.score)})`;
+}
 function unresolvedTracker(kind, reason) {
   const refuse13 = () => Promise.reject(new Error(reason));
   return Object.freeze({
@@ -46697,7 +47376,15 @@ function hasTriage(report2) {
 function issueName2(ref14) {
   return ref14.url ?? `${ref14.kind} issue ${ref14.externalId}`;
 }
-function bugLines(bug) {
+function failureName(failure6) {
+  return `${failure6.file} > ${failure6.name}`;
+}
+function inheritedNote(bug, name2, where, failure6) {
+  const test = failure6 === undefined ? "a red test the run started with" : `the run-start failure ${failureName(failure6)}`;
+  const comment = bug.ref === null ? "" : `, and ${issueName2(bug.ref)} on ${where}, found by ${foundByText(bug)}, was commented on`;
+  return `${name2}: inherited: ${test}; nothing was filed${comment}.`;
+}
+function bugLines(bug, inherited) {
   const name2 = `out_of_scope_bugs[${bug.index}]`;
   const where = `the ${bug.channel} tracker`;
   if (bug.action === "skipped") {
@@ -46708,16 +47395,17 @@ function bugLines(bug) {
     return { notes: [], warnings: [warning] };
   }
   const issue4 = bug.ref === null ? "an issue" : issueName2(bug.ref);
-  const note = bug.action === "filed" ? `${name2}: filed on ${where} as ${issue4}.` : `${name2}: recurs in ${issue4} on ${where}, found by ${FOUND_BY[bug.foundBy ?? "find"]}; commented on it.`;
+  const reached = bug.action === "filed" ? `${name2}: filed on ${where} as ${issue4}.` : `${name2}: recurs in ${issue4} on ${where}, found by ${foundByText(bug)}; commented on it.`;
+  const note = bug.action === "inherited" ? inheritedNote(bug, name2, where, inherited) : reached;
   const problem = bug.problem === null ? [] : [`${name2}: ${bug.problem}`];
   const conflict = bug.stored === "conflict" ? [`${name2}: the store keeps another reference for its artifact, in place of ${issue4}.`] : [];
   return { notes: [note], warnings: [...problem, ...conflict] };
 }
-function describeStartTriage(result2) {
+function describeStartTriage(result2, inherited = new Map) {
   const { blocker } = result2;
   const blockerNotes = blocker.written ? ["blockers: written onto the task line, for the next dispatch of this task."] : [];
   const blockerWarnings = blocker.problem === null ? [] : [`blockers: ${blocker.problem}`];
-  const bugs = result2.bugs.map(bugLines);
+  const bugs = result2.bugs.map((bug) => bugLines(bug, inherited.get(bug.index)));
   const prefixed = (lines2) => lines2.map((line) => `${LINE_PREFIX}${line}`);
   return {
     notes: prefixed([...blockerNotes, ...bugs.flatMap((lines2) => lines2.notes)]),
@@ -46741,10 +47429,42 @@ async function resolvePublicTracker(options, redact) {
     return unresolvedTracker(options.config.trackerDefault, reason);
   }
 }
+function baselinePathOrNull(trackerPath) {
+  try {
+    return baselinePathFor(trackerPath);
+  } catch {
+    return null;
+  }
+}
+function runStartFailures(trackerPath) {
+  const path4 = baselinePathOrNull(trackerPath);
+  const reading2 = path4 === null ? null : readBaseline(path4);
+  return reading2?.state === "read" && reading2.baseline.junit === "read" ? reading2.baseline.failures : [];
+}
+function inheritedByIndex(result2, report2, failures, local, redact) {
+  const named3 = result2.bugs.flatMap((bug) => {
+    const reported2 = report2.outOfScopeBugs[bug.index];
+    if (bug.action !== "inherited" || reported2 === undefined || !hasText2(reported2.what))
+      return [];
+    const artifact = artifactOf(reported2);
+    const failure6 = inheritedFailureOf({
+      what: local(reported2.what),
+      artifact: artifact === null ? null : local(artifact)
+    }, failures);
+    return failure6 === null ? [] : [[bug.index, { file: redact(failure6.file), name: redact(failure6.name) }]];
+  });
+  return new Map(named3);
+}
 function createStartTriage(options) {
   const secrets = namedSecrets(options.config, options.env ?? process.env);
   const redact = (text2) => redactSecrets(text2, secrets);
+  const local = localPathRedactor(options.repoRoot, homedir10());
   let publicTracker = null;
+  let inherited = null;
+  const inheritedFor = (trackerPath) => {
+    inherited ??= { failures: runStartFailures(trackerPath), commented: new Set };
+    return inherited;
+  };
   const trackerFor = (report2) => {
     if (!report2.outOfScopeBugs.some(filesPublicly)) {
       return Promise.resolve(unresolvedTracker(options.config.trackerDefault, NOT_RESOLVED_REASON));
@@ -46757,6 +47477,7 @@ function createStartTriage(options) {
     if (!reading2.present || !hasTriage(reading2.report))
       return null;
     const { report: report2 } = reading2;
+    const run = inheritedFor(input.trackerPath);
     const result2 = await triageReport({
       repoRoot: options.repoRoot,
       trackerPath: input.trackerPath,
@@ -46771,13 +47492,18 @@ function createStartTriage(options) {
       tracker: await trackerFor(report2),
       privateTracker: options.privateTracker,
       secrets,
-      seams: options.seams
+      seams: options.seams,
+      inherited: run,
+      similarity: options.config
     });
-    const { notes, warnings } = describeStartTriage(result2);
+    const named3 = inheritedByIndex(result2, report2, run.failures, local, redact);
+    const { notes, warnings } = describeStartTriage(result2, named3);
     for (const note of notes)
       activeOutput().info(`${INDENT6}${note}`);
     for (const warning of warnings)
       activeOutput().warn(`${INDENT6}${warning}`);
+    for (const failure6 of named3.values())
+      emitLoopEvent({ kind: "inherited", file: failure6.file, name: failure6.name });
     return result2;
   };
   return async (input) => {
@@ -46795,24 +47521,31 @@ var init_triage3 = __esm(() => {
   init_resolve2();
   init_config_sections();
   init_parse();
+  init_baseline();
+  init_bug_key();
+  init_inherited();
+  init_issue_text();
+  init_local_paths();
   init_triage2();
+  init_loop_events();
   FOUND_BY = {
     store: "its stored reference",
-    find: "a tracker find"
+    find: "a tracker find",
+    similarity: "word similarity"
   };
 });
 
 // src/commands/epic/close.ts
 import { randomUUID as randomUUID16 } from "crypto";
-import { join as join72 } from "path";
+import { join as join74 } from "path";
 function ref14(issue4) {
   return `#${String(issue4)}`;
 }
-function oneLine9(text2) {
+function oneLine10(text2) {
   return text2.replace(/\s+/gu, " ").trim();
 }
 function criterionName(criterion) {
-  return `criterion ${String(criterion.number)}: ${oneLine9(criterion.text)}`;
+  return `criterion ${String(criterion.number)}: ${oneLine10(criterion.text)}`;
 }
 function criteria(count2) {
   return count2 === 1 ? "1 criterion" : `${String(count2)} criteria`;
@@ -46836,7 +47569,7 @@ function refuseOpenMembers(number, members) {
   const open = members.filter((member) => member.state === "OPEN");
   if (open.length === 0)
     return;
-  const named3 = open.map((member) => `${ref14(member.number)} ${oneLine9(member.title)}`).join(", ");
+  const named3 = open.map((member) => `${ref14(member.number)} ${oneLine10(member.title)}`).join(", ");
   throw refusal10(`Epic ${ref14(number)} has ${String(open.length)} open ${open.length === 1 ? "member" : "members"}: ${named3}. The gate checks an epic only once every member is closed: close them, or move them` + " out with rafa epic move <issue> --to=<epic>. No session was started");
 }
 function labelsEpicToClose(issues, epic) {
@@ -46905,10 +47638,10 @@ async function planVerification(input) {
   return Object.freeze({ status: "planned", sessionId, verdicts: reading2.verdicts, issues: reading2.issues });
 }
 function closeTriageFile(root, epic) {
-  return join72(root, ".rafa", `epic-${String(epic)}-close`);
+  return join74(root, ".rafa", `epic-${String(epic)}-close`);
 }
 function failedCheckArtifact(epic, criterion) {
-  return `epic ${ref14(epic)} acceptance criterion: ${oneLine9(criterion.text)}`;
+  return `epic ${ref14(epic)} acceptance criterion: ${oneLine10(criterion.text)}`;
 }
 function failedCheckReport(epic, failure6, commit) {
   const { criterion } = failure6.check;
@@ -46932,7 +47665,7 @@ function failedCheckReport(epic, failure6, commit) {
     skillsUsed: [],
     blockers: [],
     outOfScopeBugs: [Object.freeze({
-      what: `Epic ${ref14(epic)} acceptance criterion ${String(criterion.number)} fails against main: ${oneLine9(criterion.text)}`,
+      what: `Epic ${ref14(epic)} acceptance criterion ${String(criterion.number)} fails against main: ${oneLine10(criterion.text)}`,
       artifact: failedCheckArtifact(epic, criterion),
       security: false,
       extras: []
@@ -46953,6 +47686,9 @@ function bugLine(criterion, bug) {
     case "commented": {
       return { text: `${which}: recurs in ${bug.ref === null ? "an issue" : issueName3(bug.ref)} on the ${bug.channel} tracker; commented on it.`, warn: false };
     }
+    case "inherited": {
+      return { text: `${which}: not filed: a test failure the run started with.`, warn: false };
+    }
     case "skipped": {
       return { text: `${which}: not filed: ${bug.problem ?? "no reason given"}.`, warn: true };
     }
@@ -46990,7 +47726,8 @@ async function fileFailures(run, epic, failures, commit) {
         tracker,
         privateTracker: run.seams.privateTracker,
         secrets,
-        seams: run.seams.findings
+        seams: run.seams.findings,
+        similarity: run.config
       });
       for (const bug of result2.bugs) {
         const line = bugLine(criterion, bug);
@@ -47021,9 +47758,9 @@ async function weighResults(run, epic, ran) {
     if (result2.kind === "unanswered")
       warn3(run, `No answer for ${name2} \u2014 ${result2.reason}`);
     else if (result2.result === "pass")
-      say(run, `\u2713 Passed ${name2} \u2014 ${oneLine9(result2.evidence)}`);
+      say(run, `\u2713 Passed ${name2} \u2014 ${oneLine10(result2.evidence)}`);
     else
-      warn3(run, `\u2717 Failed ${name2} \u2014 ${oneLine9(result2.evidence)}`);
+      warn3(run, `\u2717 Failed ${name2} \u2014 ${oneLine10(result2.evidence)}`);
   }
   if (!ran.removal.ok) {
     const said = ran.removal.said === "" ? "git said nothing" : ran.removal.said;
@@ -47557,8 +48294,8 @@ var init_promote = __esm(() => {
 });
 
 // src/agents/vendorable.ts
-import { readdirSync as readdirSync17, readFileSync as readFileSync53 } from "fs";
-import { isAbsolute as isAbsolute17, join as join73 } from "path";
+import { readdirSync as readdirSync17, readFileSync as readFileSync54 } from "fs";
+import { isAbsolute as isAbsolute17, join as join75 } from "path";
 function planFiles(dir) {
   let entries;
   try {
@@ -47570,7 +48307,7 @@ function planFiles(dir) {
 }
 function readText7(path4) {
   try {
-    return readFileSync53(path4, "utf8");
+    return readFileSync54(path4, "utf8");
   } catch {
     return null;
   }
@@ -47580,7 +48317,7 @@ function rafaHolds(roster, name2) {
   return item?.holders.some((holder) => holder.source === "rafa") === true;
 }
 function vendorableAgents(scan) {
-  const dir = isAbsolute17(scan.planDir) ? scan.planDir : join73(scan.repoRoot, scan.planDir);
+  const dir = isAbsolute17(scan.planDir) ? scan.planDir : join75(scan.repoRoot, scan.planDir);
   const roots = {
     repoRoot: scan.repoRoot,
     home: scan.home,
@@ -47589,7 +48326,7 @@ function vendorableAgents(scan) {
   const roster = resolveAgentRoster(roots, scan.settings);
   const found = [];
   for (const file of planFiles(dir)) {
-    const path4 = join73(dir, file);
+    const path4 = join75(dir, file);
     const markdown = readText7(path4);
     if (markdown === null)
       continue;
@@ -47619,8 +48356,8 @@ var init_vendorable = __esm(() => {
 
 // src/project/gitignore.ts
 import { createHash as createHash7 } from "crypto";
-import { existsSync as existsSync49, mkdirSync as mkdirSync17, readFileSync as readFileSync54, writeFileSync as writeFileSync17 } from "fs";
-import { dirname as dirname26, isAbsolute as isAbsolute18, join as join74 } from "path";
+import { existsSync as existsSync50, mkdirSync as mkdirSync18, readFileSync as readFileSync55, writeFileSync as writeFileSync18 } from "fs";
+import { dirname as dirname28, isAbsolute as isAbsolute18, join as join76 } from "path";
 function trackingEntry(flags) {
   if (flags.trackingAll) {
     return [
@@ -47696,19 +48433,19 @@ function attempt3(file, failure6, act) {
   }
 }
 function readIfPresent4(file) {
-  if (!existsSync49(file))
+  if (!existsSync50(file))
     return null;
-  return attempt3(file, "cannot be read", () => readFileSync54(file, "utf8"));
+  return attempt3(file, "cannot be read", () => readFileSync55(file, "utf8"));
 }
 function writeTrackingGitignore(root, flags) {
   requireAbsolute2(root);
-  const file = join74(root, GITIGNORE_FILE);
+  const file = join76(root, GITIGNORE_FILE);
   const text2 = readIfPresent4(file);
   const next = withTrackingBlock(text2, flags, file);
   if (next === text2)
     return { file, change: "unchanged" };
   attempt3(file, "cannot be written", () => {
-    writeFileSync17(file, next);
+    writeFileSync18(file, next);
   });
   const change = text2 === null ? "created" : "updated";
   return { file, change };
@@ -47724,7 +48461,7 @@ function trackingDigest(flags) {
 }
 function exposureNotice(root) {
   return [
-    `tracking.all is true, so ${join74(root, GITIGNORE_FILE)} no longer ignores ${SCOPE_DIR}/` + " and a commit can carry what it holds, including:",
+    `tracking.all is true, so ${join76(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",
@@ -47737,7 +48474,7 @@ function printWarning2(message) {
 }
 function noticeTrackingChange(root, flags, print2 = printWarning2) {
   requireAbsolute2(root);
-  const digestFile = join74(root, TRACKING_DIGEST_FILE);
+  const digestFile = join76(root, TRACKING_DIGEST_FILE);
   const recorded = `${trackingDigest(flags)}
 `;
   if (readIfPresent4(digestFile) === recorded) {
@@ -47746,8 +48483,8 @@ function noticeTrackingChange(root, flags, print2 = printWarning2) {
   if (flags.trackingAll)
     print2(exposureNotice(root));
   attempt3(digestFile, "cannot be written", () => {
-    mkdirSync17(dirname26(digestFile), { recursive: true });
-    writeFileSync17(digestFile, recorded);
+    mkdirSync18(dirname28(digestFile), { recursive: true });
+    writeFileSync18(digestFile, recorded);
   });
   return { digestFile, changed: true, printed: flags.trackingAll };
 }
@@ -47762,7 +48499,7 @@ var init_gitignore = __esm(() => {
   init_hop_record();
   init_position();
   init_scope();
-  TRACKING_DIGEST_FILE = join74(SCOPE_DIR, DIGEST_NAME);
+  TRACKING_DIGEST_FILE = join76(SCOPE_DIR, DIGEST_NAME);
   SUB_PATHS = [
     { flag: "trackingSpecs", dir: "specs" },
     { flag: "trackingPlans", dir: "plans" }
@@ -47777,8 +48514,8 @@ var init_gitignore = __esm(() => {
 
 // src/project/roots.ts
 import { spawnSync as spawnSync5 } from "child_process";
-import { accessSync, constants as constants2, readFileSync as readFileSync55, statSync as statSync25 } from "fs";
-import { isAbsolute as isAbsolute19, join as join75, resolve as resolve30 } from "path";
+import { accessSync, constants as constants2, readFileSync as readFileSync56, statSync as statSync25 } from "fs";
+import { isAbsolute as isAbsolute19, join as join77, resolve as resolve30 } from "path";
 function gitToplevel(dir) {
   const result2 = spawnSync5("git", ["rev-parse", "--show-toplevel"], {
     cwd: dir,
@@ -47881,8 +48618,8 @@ function readManifest2(file, fs3) {
   }
 }
 function readDir(dir, fs3) {
-  const manifest = readManifest2(join75(dir, PACKAGE_JSON), fs3);
-  const files = MONOREPO_MARKER_FILES.filter((name2) => fs3.exists(join75(dir, name2)));
+  const manifest = readManifest2(join77(dir, PACKAGE_JSON), fs3);
+  const files = MONOREPO_MARKER_FILES.filter((name2) => fs3.exists(join77(dir, name2)));
   const markers = manifest.marks ? [PACKAGE_JSON, ...files] : files;
   return { ...manifest, dir, markers };
 }
@@ -47935,7 +48672,7 @@ var init_roots = __esm(() => {
   ]);
   DISK_ROOTS_FILE_SYSTEM = Object.freeze({
     ...DISK_FILE_SYSTEM,
-    readFile: (path4) => readFileSync55(path4, "utf8"),
+    readFile: (path4) => readFileSync56(path4, "utf8"),
     isDirectory: (path4) => statSync25(path4).isDirectory(),
     assertWritable: (path4) => accessSync(path4, constants2.W_OK)
   });
@@ -48031,7 +48768,7 @@ var init_root_choice = __esm(() => {
 });
 
 // src/release/setting.ts
-import { readFileSync as readFileSync56 } from "fs";
+import { readFileSync as readFileSync57 } from "fs";
 function releaseEnabledIn(text2, path4) {
   return parseConfigText(text2, path4).values.releaseEnabled ?? null;
 }
@@ -48039,7 +48776,7 @@ function readReleaseSetting(root) {
   const path4 = configFilePath(root);
   let text2;
   try {
-    text2 = readFileSync56(path4, "utf8");
+    text2 = readFileSync57(path4, "utf8");
   } catch (error) {
     return { enabled: null, text: "", problem: `${path4} could not be read: ${messageOf(error)}` };
   }
@@ -48112,7 +48849,7 @@ var init_setting = __esm(() => {
 });
 
 // src/commands/init-release.ts
-import { writeFileSync as writeFileSync18 } from "fs";
+import { writeFileSync as writeFileSync19 } from "fs";
 function releaseQuestion(versionFile, changelog) {
   return `Bump ${versionFile} and add a ${changelog} entry with every pull request? [Y/n] `;
 }
@@ -48164,7 +48901,7 @@ function writeSetting(root, text2, enabled) {
     return `the file this run would have written reads ${RELEASE_ENABLED_SETTING} as ${describeValue(read)}`;
   }
   try {
-    writeFileSync18(path4, written3, "utf8");
+    writeFileSync19(path4, written3, "utf8");
   } catch (error) {
     return `it could not be written: ${messageOf(error)}`;
   }
@@ -48227,8 +48964,8 @@ var init_init_release = __esm(() => {
 });
 
 // src/project/scaffold.ts
-import { existsSync as existsSync50, lstatSync as lstatSync2, mkdirSync as mkdirSync18, statSync as statSync26, writeFileSync as writeFileSync19 } from "fs";
-import { join as join76 } from "path";
+import { existsSync as existsSync51, lstatSync as lstatSync2, mkdirSync as mkdirSync19, statSync as statSync26, writeFileSync as writeFileSync20 } from "fs";
+import { join as join78 } from "path";
 function globsLine(patterns) {
   return `[${patterns.map((pattern) => JSON.stringify(pattern)).join(", ")}]`;
 }
@@ -48244,7 +48981,7 @@ function userConfigText() {
 }
 function layoutOf2(base, tree) {
   const scope = scopeAt(base);
-  return { dirs: [scope.dir, ...tree.map((name2) => join76(scope.dir, name2))], configFile: configFilePath(base) };
+  return { dirs: [scope.dir, ...tree.map((name2) => join78(scope.dir, name2))], configFile: configFilePath(base) };
 }
 function occupied(path4) {
   return lstatSync2(path4, { throwIfNoEntry: false }) !== undefined;
@@ -48255,7 +48992,7 @@ function isDirectory3(path4) {
 function directoryConflict(dir) {
   if (!occupied(dir) || isDirectory3(dir))
     return null;
-  return existsSync50(dir) ? `${dir} is not a directory` : `${dir} is a link to nothing`;
+  return existsSync51(dir) ? `${dir} is not a directory` : `${dir} is a link to nothing`;
 }
 function layoutConflicts(layout) {
   const [scopeDir, ...tree] = layout.dirs;
@@ -48263,7 +49000,7 @@ function layoutConflicts(layout) {
   if (opening !== null)
     return [opening];
   const dirs = tree.flatMap((dir) => directoryConflict(dir) ?? []);
-  const file = occupied(layout.configFile) && !existsSync50(layout.configFile) ? [`${layout.configFile} is a link to nothing`] : [];
+  const file = occupied(layout.configFile) && !existsSync51(layout.configFile) ? [`${layout.configFile} is a link to nothing`] : [];
   return [...dirs, ...file];
 }
 function scaffoldConflicts(root, home) {
@@ -48277,18 +49014,18 @@ function attempt4(path4, failure6, act) {
   }
 }
 function ensureDirectory(path4) {
-  if (existsSync50(path4))
+  if (existsSync51(path4))
     return { path: path4, kind: "directory", change: "unchanged" };
   attempt4(path4, "cannot be created", () => {
-    mkdirSync18(path4, { recursive: true });
+    mkdirSync19(path4, { recursive: true });
   });
   return { path: path4, kind: "directory", change: "created" };
 }
 function ensureFile(path4, text2) {
-  if (existsSync50(path4))
+  if (existsSync51(path4))
     return { path: path4, kind: "file", change: "unchanged" };
   attempt4(path4, "cannot be written", () => {
-    writeFileSync19(path4, text2, { encoding: "utf8", flag: "wx" });
+    writeFileSync20(path4, text2, { encoding: "utf8", flag: "wx" });
   });
   return { path: path4, kind: "file", change: "created" };
 }
@@ -48366,6 +49103,10 @@ var init_scaffold = __esm(() => {
     "# claims:",
     `#   staleAfter: ${CONFIG_DEFAULTS.claimsStaleAfter}                # 36h | 3d | disabled; how long a rafa:claimed claim stands before a takeover`,
     `#   ahead: ${CONFIG_DEFAULTS.claimsAhead}                     # off | allow; whether a claim may reach one issue ahead`,
+    "# triage:",
+    "#   similarity:",
+    `#     threshold: ${String(CONFIG_DEFAULTS.triageSimilarityThreshold)}             # above 0 and at most 1 | false; the least score at which triage comments on the nearest open bug`,
+    `#     candidates: ${String(CONFIG_DEFAULTS.triageSimilarityCandidates)}              # 1..10, the nearest issues a new bug lists as Possible duplicates`,
     "# release:",
     `#   enabled: ${String(CONFIG_DEFAULTS.releaseEnabled)}               # true | false | auto, which is on when both files below exist`,
     `#   versionFile: ${CONFIG_DEFAULTS.releaseVersionFile}`,
@@ -48422,9 +49163,9 @@ var init_scaffold = __esm(() => {
 });
 
 // src/commands/init.ts
-import { existsSync as existsSync51, readFileSync as readFileSync57 } from "fs";
-import { homedir as homedir10 } from "os";
-import { join as join77, relative as relative15, sep as sep6 } from "path";
+import { existsSync as existsSync52, readFileSync as readFileSync58 } from "fs";
+import { homedir as homedir11 } from "os";
+import { join as join79, relative as relative15, sep as sep6 } from "path";
 function refusal12(lines2) {
   return new CommandExit(1, [...lines2, NOTHING_WRITTEN2].join(`
 `));
@@ -48522,9 +49263,9 @@ function resolvedConfig3(root, home, warn4) {
   }
 }
 function checkGitignore(root, flags) {
-  const file = join77(root, GITIGNORE_FILE);
+  const file = join79(root, GITIGNORE_FILE);
   try {
-    const text2 = existsSync51(file) ? readFileSync57(file, "utf8") : null;
+    const text2 = existsSync52(file) ? readFileSync58(file, "utf8") : null;
     withTrackingBlock(text2, flags, file);
   } catch (error) {
     const message = error instanceof GitignoreError ? error.message : `rafa init: ${file} cannot be read (${messageOf(error)})`;
@@ -48556,8 +49297,8 @@ function initialise(root, start, home, context, entry) {
   const resolved = resolvedConfig3(root.path, home, warn4);
   const config = resolved.config;
   checkGitignore(root.path, config);
-  const configExisted = existsSync51(configFilePath(root.path));
-  const digestExisted = existsSync51(join77(root.path, TRACKING_DIGEST_FILE));
+  const configExisted = existsSync52(configFilePath(root.path));
+  const digestExisted = existsSync52(join79(root.path, TRACKING_DIGEST_FILE));
   const project = writeProjectScope(root.path);
   const tracking = applyTracking(root.path, config, warn4);
   const writes = [...project, ...trackingWrites(tracking, digestExisted), ...writeUserScope(home)];
@@ -48766,7 +49507,7 @@ var init_init = __esm(() => {
   init_init_release();
   DEFAULT_INIT_SEAMS = Object.freeze({
     cwd: () => process.cwd(),
-    home: () => homedir10(),
+    home: () => homedir11(),
     entry: () => Bun.main,
     isTerminal: () => process.stdin.isTTY === true,
     openPrompter: () => createLinePrompter(process.stdin, process.stderr),
@@ -49174,7 +49915,7 @@ Usage: ${USAGE24}`);
     return "blessed";
   return conflicts ? "conflicts" : "all";
 }
-function oneLine10(text2) {
+function oneLine11(text2) {
   return text2.trim().replace(/\s+/gu, " ");
 }
 function byConfidence2(left, right) {
@@ -49207,7 +49948,7 @@ function conflictLines(conflict) {
   const width = Math.max(...conflict.records.map((record) => record.id.length));
   return [
     `  ${conflict.scope}  ${conflict.trigger}`,
-    ...conflict.records.map((record) => lessonLine2("    ", record, width, oneLine10(record.action)))
+    ...conflict.records.map((record) => lessonLine2("    ", record, width, oneLine11(record.action)))
   ];
 }
 function renderConflicts(result2) {
@@ -49486,8 +50227,8 @@ var init_show4 = __esm(() => {
 });
 
 // src/commands/issue/check.ts
-import { readdirSync as readdirSync18, readFileSync as readFileSync58, statSync as statSync27 } from "fs";
-import { join as join78, resolve as resolve33 } from "path";
+import { readdirSync as readdirSync18, readFileSync as readFileSync59, statSync as statSync27 } from "fs";
+import { join as join80, resolve as resolve33 } from "path";
 function readCheckIssue(args) {
   if (args.length > 1) {
     throw lineRefusal(`Expected one issue number, got ${String(args.length)}: ${args.join(" ")}`, CHECK_USAGE);
@@ -49515,7 +50256,7 @@ function copyNames(dir, issue4) {
   }
   const prefix = `${boardId(issue4)}-`;
   const notes = notesFileName(issue4);
-  return names2.filter((name2) => name2.startsWith(prefix) && name2.endsWith(SPEC_EXTENSION) && name2 !== notes).filter((name2) => name2.length > prefix.length + SPEC_EXTENSION.length).filter((name2) => statSync27(join78(dir, name2)).isFile()).sort();
+  return names2.filter((name2) => name2.startsWith(prefix) && name2.endsWith(SPEC_EXTENSION) && name2 !== notes).filter((name2) => name2.length > prefix.length + SPEC_EXTENSION.length).filter((name2) => statSync27(join80(dir, name2)).isFile()).sort();
 }
 function findSavedCopy(root, specsDir, issue4) {
   const names2 = copyNames(resolve33(root, specsDir), issue4);
@@ -49525,11 +50266,11 @@ function findSavedCopy(root, specsDir, issue4) {
   if (names2.length > 1) {
     throw new CommandExit(1, [
       `\u274C Issue #${String(issue4)} has ${String(names2.length)} saved copies under ${specsDir}; remove the stale one:`,
-      ...names2.map((name2) => `   ${join78(specsDir, name2)}`)
+      ...names2.map((name2) => `   ${join80(specsDir, name2)}`)
     ].join(`
 `));
   }
-  const path4 = join78(specsDir, only);
+  const path4 = join80(specsDir, only);
   return { path: path4, absolute: resolve33(root, path4) };
 }
 function liveText(live) {
@@ -49578,7 +50319,7 @@ async function readReferences(absolute, issue4, verify, stamp2) {
     return rows2.map((row3) => checkedRef(row3, row3.stamp));
   }
   const once4 = memoiseVerifier(verify);
-  const before = await readRefsText({ copy: readFileSync58(absolute, "utf8"), issue: issue4, verify: once4 });
+  const before = await readRefsText({ copy: readFileSync59(absolute, "utf8"), issue: issue4, verify: once4 });
   const after = await restampCopyRefs({ path: absolute, issue: issue4, verify: once4 });
   return before.rows.map((row3, index) => checkedRef(row3, after.rows[index]?.stamp ?? null));
 }
@@ -50503,10 +51244,10 @@ var init_pr_lifecycle = __esm(() => {
 });
 
 // src/notices/notices.ts
-import { mkdirSync as mkdirSync19, readFileSync as readFileSync59, writeFileSync as writeFileSync20 } from "fs";
-import { dirname as dirname27, join as join79 } from "path";
+import { mkdirSync as mkdirSync20, readFileSync as readFileSync60, writeFileSync as writeFileSync21 } from "fs";
+import { dirname as dirname29, join as join81 } from "path";
 function noticesPath(home) {
-  return join79(home, ".rafa", "notices.json");
+  return join81(home, ".rafa", "notices.json");
 }
 function isNoticeId(value) {
   return typeof value === "string" && NOTICE_IDS.includes(value);
@@ -50514,7 +51255,7 @@ function isNoticeId(value) {
 function readDismissed(home) {
   let raw;
   try {
-    raw = readFileSync59(noticesPath(home), "utf8");
+    raw = readFileSync60(noticesPath(home), "utf8");
   } catch {
     return [];
   }
@@ -50533,8 +51274,8 @@ function readDismissed(home) {
 function writeDismissed(home, ids) {
   const all = NOTICE_IDS.filter((id3) => ids.includes(id3) || readDismissed(home).includes(id3));
   const path4 = noticesPath(home);
-  mkdirSync19(dirname27(path4), { recursive: true });
-  writeFileSync20(path4, `${JSON.stringify({ dismissed: all }, null, 2)}
+  mkdirSync20(dirname29(path4), { recursive: true });
+  writeFileSync21(path4, `${JSON.stringify({ dismissed: all }, null, 2)}
 `);
 }
 function pendingNotices(dismissed) {
@@ -50599,9 +51340,9 @@ var init_notices = __esm(() => {
 });
 
 // src/notices/run.ts
-import { homedir as homedir11 } from "os";
+import { homedir as homedir12 } from "os";
 async function requireNoticesAnswered() {
-  const outcome2 = await offerNotices({ home: homedir11(), version: RAFA_VERSION }, {
+  const outcome2 = await offerNotices({ home: homedir12(), version: RAFA_VERSION }, {
     isTerminal: () => process.stdin.isTTY === true,
     openPrompter: () => createLinePrompter(process.stdin, process.stderr),
     warn: (line) => {
@@ -50653,9 +51394,9 @@ var init_budget = __esm(() => {
 });
 
 // src/start/checkout-guard.ts
-import { existsSync as existsSync52, realpathSync as realpathSync14 } from "fs";
+import { existsSync as existsSync53, realpathSync as realpathSync14 } from "fs";
 function realDirOf(path4) {
-  if (!existsSync52(path4))
+  if (!existsSync53(path4))
     return null;
   try {
     return realpathSync14(path4);
@@ -51232,62 +51973,6 @@ var init_commit2 = __esm(() => {
   DROPPED_BLOCKER_FIELD = /^blockers\[\d+\]$/;
 });
 
-// src/start/loop-events.ts
-import { join as join80 } from "path";
-function quoted3(text2) {
-  return `"${oneLine(text2).replaceAll('"', "\\\"")}"`;
-}
-function taskKind(position, verb) {
-  return padKind(`task ${position.index}/${position.total} ${verb}`);
-}
-function minutes(durationMs) {
-  return `${Math.max(1, Math.round(durationMs / MINUTE_MS))}m`;
-}
-function summaryOf3(event) {
-  switch (event.kind) {
-    case "task-start":
-      return `${taskKind(event.position, "start")}${quoted3(event.text)}`;
-    case "task-done":
-      return event.tokens === null ? `${taskKind(event.position, "done")}${minutes(event.durationMs)}` : `${taskKind(event.position, "done")}${minutes(event.durationMs)}  ${Math.round(event.tokens / TOKENS_PER_K)}k tokens`;
-    case "task-blocked":
-      return `${taskKind(event.position, "blocked")}${oneLine(event.reason)}`;
-    case "wrap-up":
-      return `${padKind("wrap-up")}${event.phase}`;
-    case "pr":
-      return `pr #${event.number} opened`;
-    case "no-pr":
-      return `${padKind("no pr")}${oneLine(event.reason)}`;
-    case "halt":
-      return `${padKind("halt")}${oneLine(event.reason)}`;
-  }
-}
-function emitLoopEvent(event, now = () => new Date) {
-  const { kind, ...data } = event;
-  activeOutput().emit({ type: "event", name: kind, summary: summaryOf3(event), data, ts: now().toISOString() });
-}
-async function unlessText(read) {
-  return activeOutputMode() === "text" ? null : read();
-}
-function taskPosition(trackerContent, lineNum) {
-  const { tasks } = parsePlan(trackerContent);
-  return { index: tasks.findIndex((task) => task.lineNum === lineNum) + 1, total: tasks.length };
-}
-async function taskTokens(checkout, sessionId, home) {
-  try {
-    const { usage } = await readSessionLog(join80(sessionLogDir(checkout, home), `${sessionId}.jsonl`));
-    return usage.inputTokens + usage.cacheCreationInputTokens + usage.outputTokens;
-  } catch {
-    return null;
-  }
-}
-var MINUTE_MS = 60000, TOKENS_PER_K = 1000;
-var init_loop_events = __esm(() => {
-  init_active();
-  init_collect();
-  init_session_log();
-  init_plan();
-});
-
 // src/start/pause.ts
 function storedState2(repoRoot, sessionId) {
   try {
@@ -51547,9 +52232,9 @@ var init_worktree_dir = () => {};
 
 // src/start/worktree.ts
 import { realpathSync as realpathSync15 } from "fs";
-import { join as join81, resolve as resolve35 } from "path";
+import { join as join82, resolve as resolve35 } from "path";
 function worktreePathFor(projectRoot3, worktreeDir, stub) {
-  return join81(worktreeDirAt(projectRoot3, worktreeDir), stub);
+  return join82(worktreeDirAt(projectRoot3, worktreeDir), stub);
 }
 function addStep2(route, plan, path4) {
   const label = `add the worktree for ${plan.branch} at ${path4}`;
@@ -51733,104 +52418,6 @@ var init_run_checkout = __esm(() => {
   init_worktree2();
 });
 
-// src/suite/baseline.ts
-import { existsSync as existsSync53, mkdirSync as mkdirSync20, readFileSync as readFileSync60, renameSync as renameSync9, writeFileSync as writeFileSync21 } from "fs";
-import { basename as basename18, dirname as dirname28, join as join82 } from "path";
-function baselinePathFor(trackerPath) {
-  const match = PLAN_FILE_NAME2.exec(basename18(trackerPath));
-  if (match === null) {
-    throw new RangeError(`baselinePathFor: ${trackerPath} is not a PLAN or PLAN_TRACKER file`);
-  }
-  return join82(dirname28(trackerPath), `${BASELINE_FILE_PREFIX}${match[1] ?? ""}.json`);
-}
-function baselineOf(result2, recordedAt, commit) {
-  return {
-    version: BASELINE_VERSION,
-    recordedAt: recordedAt.toISOString(),
-    commit,
-    command: [...result2.command],
-    exitCode: result2.exitCode,
-    summary: result2.summary,
-    failures: result2.failures.map((failure6) => ({ file: failure6.file, name: failure6.name })),
-    errors: result2.errors,
-    junit: result2.junit
-  };
-}
-function writeBaseline(path4, baseline) {
-  mkdirSync20(dirname28(path4), { recursive: true });
-  const temporary = `${path4}.${process.pid}.tmp`;
-  writeFileSync21(temporary, `${JSON.stringify(baseline, null, 2)}
-`, "utf8");
-  renameSync9(temporary, path4);
-}
-function isStringOrNull(value) {
-  return value === null || typeof value === "string";
-}
-function isFailure2(value) {
-  if (typeof value !== "object" || value === null)
-    return false;
-  const record = value;
-  return typeof record["file"] === "string" && typeof record["name"] === "string";
-}
-function badField(record) {
-  const checks = [
-    ["recordedAt", (value) => typeof value === "string"],
-    ["commit", isStringOrNull],
-    ["command", (value) => Array.isArray(value) && value.every((part) => typeof part === "string")],
-    ["exitCode", (value) => Number.isInteger(value)],
-    ["summary", isStringOrNull],
-    ["failures", (value) => Array.isArray(value) && value.every(isFailure2)],
-    ["errors", (value) => value === null || Number.isInteger(value)],
-    ["junit", (value) => JUNIT_READINGS.includes(value)]
-  ];
-  const failed4 = checks.find(([key, check]) => !check(record[key]));
-  return failed4?.[0] ?? null;
-}
-function asBaseline(parsed) {
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    return { state: "unreadable", reason: "not a JSON object" };
-  }
-  const record = parsed;
-  if (record["version"] !== BASELINE_VERSION) {
-    return { state: "unreadable", reason: `version ${JSON.stringify(record["version"])}, expected ${BASELINE_VERSION}` };
-  }
-  const bad = badField(record);
-  if (bad !== null)
-    return { state: "unreadable", reason: `field ${bad} is missing or malformed` };
-  return { state: "read", baseline: parsed };
-}
-function readBaseline(path4) {
-  if (!existsSync53(path4))
-    return { state: "missing" };
-  let text2;
-  try {
-    text2 = readFileSync60(path4, "utf8");
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    return { state: "unreadable", reason };
-  }
-  try {
-    return asBaseline(JSON.parse(text2));
-  } catch {
-    return { state: "unreadable", reason: "not JSON" };
-  }
-}
-function failureKey2(failure6) {
-  return JSON.stringify([failure6.file, failure6.name]);
-}
-function splitFailures(failures, baseline) {
-  const held = new Set((baseline?.failures ?? []).map(failureKey2));
-  return {
-    fresh: failures.filter((failure6) => !held.has(failureKey2(failure6))),
-    known: failures.filter((failure6) => held.has(failureKey2(failure6)))
-  };
-}
-var BASELINE_VERSION = 1, BASELINE_FILE_PREFIX = "SUITE_BASELINE", PLAN_FILE_NAME2, JUNIT_READINGS;
-var init_baseline = __esm(() => {
-  PLAN_FILE_NAME2 = /^PLAN(?:_TRACKER)?(-.+)?\.md$/;
-  JUNIT_READINGS = ["read", "missing", "unreadable"];
-});
-
 // src/suite/owns.ts
 function none(reason, detail) {
   return Object.freeze({ owns: null, reason, detail });
@@ -51914,7 +52501,7 @@ var init_owns = __esm(() => {
 
 // src/suite/run.ts
 import { existsSync as existsSync54, mkdirSync as mkdirSync21, readFileSync as readFileSync61, rmSync as rmSync11 } from "fs";
-import { dirname as dirname29, isAbsolute as isAbsolute21 } from "path";
+import { dirname as dirname30, isAbsolute as isAbsolute21 } from "path";
 function readNoTestFiles(stderr) {
   return NO_TEST_FILES_LINE.test(stderr);
 }
@@ -51978,8 +52565,18 @@ function closeCase(walk) {
   if (open === null || !open.failed)
     return;
   const held = walk.failures.some((failure6) => failure6.file === open.file && failure6.name === open.name);
-  if (!held)
-    walk.failures.push({ file: open.file, name: open.name });
+  if (held)
+    return;
+  walk.failures.push(open.message === undefined ? { file: open.file, name: open.name } : { file: open.file, name: open.name, message: open.message });
+}
+function firstMessageLine(message) {
+  const line = message?.split(/\r?\n/, 1)[0]?.trim() ?? "";
+  return line === "" ? undefined : line;
+}
+function failCase(open, attributes) {
+  open.failed = true;
+  if (open.message === undefined)
+    open.message = firstMessageLine(attributes["message"]);
 }
 function openCase(walk, attributes) {
   const [fileSuite, ...describes] = walk.suites;
@@ -52006,7 +52603,7 @@ function takeTag(walk, match) {
     return;
   }
   if ((element === "failure" || element === "error") && closing !== "/" && walk.open !== null)
-    walk.open.failed = true;
+    failCase(walk.open, attributes);
 }
 function parseJunitFailures(xml) {
   if (!/<testsuites\b/.test(xml) || !xml.includes("</testsuites>"))
@@ -52046,7 +52643,7 @@ async function runSuite(options) {
     throw new RangeError("runSuite: an empty path list would run the whole project; leave paths out for that");
   }
   const command = suiteCommand(options.junitFile, options.paths, options.changedSince);
-  mkdirSync21(dirname29(options.junitFile), { recursive: true });
+  mkdirSync21(dirname30(options.junitFile), { recursive: true });
   rmSync11(options.junitFile, { force: true });
   const spawn = options.spawn ?? spawnSuite;
   const env = suiteEnv(options.env ?? process.env);
@@ -52181,7 +52778,7 @@ var init_scope2 = __esm(() => {
 // src/start/suite-step.ts
 import { existsSync as existsSync56, mkdirSync as mkdirSync22, readFileSync as readFileSync63, renameSync as renameSync10, writeFileSync as writeFileSync22 } from "fs";
 import { constants as constants3 } from "os";
-import { basename as basename19, dirname as dirname30, join as join84 } from "path";
+import { basename as basename22, dirname as dirname31, join as join84 } from "path";
 function seamsOf(context) {
   const seams = context.seams ?? {};
   return {
@@ -52200,8 +52797,8 @@ function junitFileFor(repoRoot, sessionId, kind) {
 }
 function stageLedgerPathFor(trackerPath) {
   const baselinePath = baselinePathFor(trackerPath);
-  const name2 = basename19(baselinePath).replace(BASELINE_FILE_PREFIX, STAGE_LEDGER_PREFIX);
-  return join84(dirname30(baselinePath), name2);
+  const name2 = basename22(baselinePath).replace(BASELINE_FILE_PREFIX, STAGE_LEDGER_PREFIX);
+  return join84(dirname31(baselinePath), name2);
 }
 function isLedgerEntry(value) {
   if (typeof value !== "object" || value === null)
@@ -52235,11 +52832,11 @@ function readStageLedger(path4) {
   }
   if (typeof parsed !== "string")
     return parsed;
-  activeOutput().warn(`\u26A0\uFE0F  ${basename19(path4)} does not read (${parsed}); every finished stage's step is taken again.`);
+  activeOutput().warn(`\u26A0\uFE0F  ${basename22(path4)} does not read (${parsed}); every finished stage's step is taken again.`);
   return [];
 }
 function writeStageLedger(path4, entries) {
-  mkdirSync22(dirname30(path4), { recursive: true });
+  mkdirSync22(dirname31(path4), { recursive: true });
   const temporary = `${path4}.${process.pid}.tmp`;
   writeFileSync22(temporary, `${JSON.stringify({ version: STAGE_LEDGER_VERSION, stages: entries }, null, 2)}
 `, "utf8");
@@ -52254,7 +52851,7 @@ function addToLedger(trackerPath, added) {
   try {
     writeStageLedger(path4, [...entries, ...fresh]);
   } catch (error) {
-    activeOutput().warn(`\u26A0\uFE0F  Could not write ${basename19(path4)} (${messageOf(error)}); the next run takes these stage steps again.`);
+    activeOutput().warn(`\u26A0\uFE0F  Could not write ${basename22(path4)} (${messageOf(error)}); the next run takes these stage steps again.`);
   }
 }
 function sameStage(a, b) {
@@ -52389,11 +52986,11 @@ async function ensureBaseline(context) {
   const reading2 = readBaseline(path4);
   if (reading2.state === "read") {
     const known = reading2.baseline.failures.length;
-    activeOutput().info(`\uD83D\uDCCF Suite baseline reused from ${basename19(path4)} (${reading2.baseline.recordedAt}): ${known} known failure(s).`);
+    activeOutput().info(`\uD83D\uDCCF Suite baseline reused from ${basename22(path4)} (${reading2.baseline.recordedAt}): ${known} known failure(s).`);
     return { baseline: reading2.baseline, step: null, interrupted: false };
   }
   if (reading2.state === "unreadable")
-    activeOutput().warn(`\u26A0\uFE0F  ${basename19(path4)} does not read (${reading2.reason}); recording the baseline again.`);
+    activeOutput().warn(`\u26A0\uFE0F  ${basename22(path4)} does not read (${reading2.reason}); recording the baseline again.`);
   const commit = readHead(seams.git);
   const result2 = await runOne(context, seams, "baseline", {});
   const baseline = baselineOf(result2, seams.now(), commit);
@@ -52403,7 +53000,7 @@ async function ensureBaseline(context) {
   try {
     writeBaseline(path4, baseline);
   } catch (error) {
-    activeOutput().warn(`\u26A0\uFE0F  Could not write ${basename19(path4)} (${messageOf(error)}); the next run records the baseline again.`);
+    activeOutput().warn(`\u26A0\uFE0F  Could not write ${basename22(path4)} (${messageOf(error)}); the next run records the baseline again.`);
   }
   const outcome2 = settleStep(context, seams, settling);
   const covered = completeStages(readFileSync63(context.trackerPath, "utf8"));
@@ -52614,9 +53211,34 @@ var init_suite_steps_run = __esm(() => {
   init_suite_step();
 });
 
+// src/start/pr-retarget.ts
+function retargetedLine(number, from, to) {
+  return `\u21AA Retargeted pull request #${String(number)} from ${from} to ${to} (pr.base).`;
+}
+function refusedRetargetLine(number, from, to, detail) {
+  return `\u26A0\uFE0F  Could not retarget pull request #${String(number)} from ${from} to ${to} (pr.base): ${detail}. Retarget it by hand; the run carries on to the CI wait.`;
+}
+async function retargetPullRequest(pull2, base, seams) {
+  const from = pull2.baseRefName;
+  if (from === base)
+    return { kind: "unchanged" };
+  try {
+    await seams.pulls.editBase(pull2.number, base);
+  } catch (error) {
+    const detail = messageOf(error);
+    seams.output.warn(refusedRetargetLine(pull2.number, from, base, detail));
+    return { kind: "refused", from, to: base, detail };
+  }
+  seams.output.info(retargetedLine(pull2.number, from, base));
+  return { kind: "retargeted", from, to: base };
+}
+var init_pr_retarget = __esm(() => {
+  init_config_sections();
+});
+
 // src/release/prepare.ts
 import { mkdirSync as mkdirSync23, readFileSync as readFileSync64, writeFileSync as writeFileSync23 } from "fs";
-import { dirname as dirname31, join as join85, posix as posix5 } from "path";
+import { dirname as dirname32, join as join85, posix as posix5 } from "path";
 function levelFields(reading2) {
   return { level: reading2.level, levelSource: reading2.source, notesLevel: reading2.notesLevel };
 }
@@ -52682,7 +53304,7 @@ function nameOf2(path4) {
 }
 function writeFragment(path4, resolved, text2) {
   try {
-    mkdirSync23(dirname31(resolved), { recursive: true });
+    mkdirSync23(dirname32(resolved), { recursive: true });
     writeFileSync23(resolved, text2);
     return null;
   } catch (error) {
@@ -52999,18 +53621,18 @@ function announceBody(write, count2) {
   }
   out.info(`   ${noun} ${verb} now in the body of pull request #${write.number}.`);
 }
-async function writeBody(io, repoRoot, write) {
-  const reading2 = io.readProvider(repoRoot);
+async function writeBody(io, input, write) {
+  const reading2 = io.readProvider(input.repoRoot);
   if (reading2.provider !== "gh") {
     const problem2 = noProviderProblem(reading2);
     activeOutput().info(`   No pull request body carries ${JSON.stringify(write.lines.join(" "))}: ${problem2}.`);
     return unwritten(null, problem2);
   }
-  const body = await carryIntoBody(io.pulls(repoRoot), io.currentBranch(), write);
+  const body = await carryIntoBody(io.pulls(input.repoRoot), input.branch, write);
   announceBody(body, write.lines.length);
   return body;
 }
-async function reportFailure(io, repoRoot, outcome2, sentence, facts) {
+async function reportFailure(io, input, outcome2, sentence, facts) {
   const out = activeOutput();
   if (outcome2 === "skipped") {
     out.info(`
@@ -53021,7 +53643,7 @@ async function reportFailure(io, repoRoot, outcome2, sentence, facts) {
   }
   const parts = { forecast: null, levelReport: facts.levelReport };
   const block2 = releaseBodyBlock(parts);
-  const body = await writeBody(io, repoRoot, { sentence, block: block2, lines: [sentence, ...releaseBodyLines(parts)] });
+  const body = await writeBody(io, input, { sentence, block: block2, lines: [sentence, ...releaseBodyLines(parts)] });
   return { outcome: outcome2, sentence, forecast: null, body, ...facts };
 }
 async function reportForecast(io, input, forecast, facts) {
@@ -53031,12 +53653,12 @@ async function reportForecast(io, input, forecast, facts) {
     out.warn(`   \u26A0\uFE0F  ${problem2}`);
   const parts = { forecast, levelReport: facts.levelReport };
   const block2 = releaseBodyBlock(parts);
-  const body = await writeBody(io, input.repoRoot, { sentence: null, block: block2, lines: releaseBodyLines(parts) });
+  const body = await writeBody(io, input, { sentence: null, block: block2, lines: releaseBodyLines(parts) });
   return { outcome: "released", sentence: null, forecast, body, ...facts };
 }
 async function finishRelease(input, seams = {}) {
   const io = { ...RELEASE_STAGE_SEAMS, ...seams };
-  const { preparation, repoRoot, settings } = input;
+  const { preparation, repoRoot, branch, settings } = input;
   if (preparation === null)
     return NO_RELEASE;
   const levelReport = releaseLevelReport({
@@ -53046,31 +53668,30 @@ async function finishRelease(input, seams = {}) {
   });
   const none2 = { fragment: null, subject: null, sha: null, levelReport };
   if (preparation.kind === "skipped") {
-    return reportFailure(io, repoRoot, "skipped", preparation.sentence, none2);
+    return reportFailure(io, input, "skipped", preparation.sentence, none2);
   }
   const git = io.git(repoRoot);
   const verification = io.verify(preparation, { git, settings });
   if (verification.kind === "refused") {
-    return reportFailure(io, repoRoot, "refused", verification.sentence, none2);
+    return reportFailure(io, input, "refused", verification.sentence, none2);
   }
   const fragment = verification.path;
   const subject = releaseSubject(preparation);
   const commit = commitFragment(git, fragment, subject);
   if (!commit.committed) {
-    return reportFailure(io, repoRoot, "uncommitted", commit.sentence, { ...none2, fragment, subject });
+    return reportFailure(io, input, "uncommitted", commit.sentence, { ...none2, fragment, subject });
   }
   const out = activeOutput();
   const sha = commit.sha;
   const facts = { fragment, subject, sha, levelReport };
   out.info(`
 \uD83D\uDCE6 Committed ${commitName(sha, subject)} over ${fragment}.`);
-  const branch = io.currentBranch();
   const pushed = io.push(repoRoot, branch);
   if (!pushed.ok) {
     const said = pushed.output.trim() === "" ? "" : `: ${pushed.output.trim().split(`
 `)[0] ?? ""}`;
     const sentence = `${commitName(sha, subject)} was made but could not be pushed to ${branch}${said}`;
-    return reportFailure(io, repoRoot, "unpushed", sentence, facts);
+    return reportFailure(io, input, "unpushed", sentence, facts);
   }
   out.info(`   Pushed it to ${branch}.`);
   const forecast = io.forecast({ git, settings, prepared: preparation, verified: verification, now: io.now() });
@@ -53088,7 +53709,6 @@ var init_release_stage = __esm(() => {
   init_prepare();
   init_verify2();
   init_version2();
-  init_git3();
   RELEASE_STAGE_SEAMS = {
     prepare: prepareRelease,
     verify: verifyRelease,
@@ -53098,7 +53718,6 @@ var init_release_stage = __esm(() => {
     push: pushBranch,
     pulls: ghPullRequestsIn,
     readProvider: (repoRoot) => resolvePrProvider({ configured: null, dir: repoRoot }),
-    currentBranch: getCurrentBranch,
     now: () => new Date
   };
   PLAN_HEADING = /^# +(.+)$/;
@@ -53432,7 +54051,7 @@ var init_promoted_check = __esm(() => {
 
 // src/start/wrap-up.ts
 import { posix as posix8 } from "path";
-function buildWrapUpPrompt(branch, planContent, openPullRequest = null, release = null, lessons = []) {
+function buildWrapUpPrompt(branch, base, planContent, openPullRequest = null, release = null, lessons = []) {
   return [
     "* Read `@progress.txt` in full.",
     "* `@progress.txt` above names the file `progress.txt` at the repo root; the `@` is a reference marker, never part of a path. Do not create or write a file whose name starts with `@`.",
@@ -53445,7 +54064,7 @@ function buildWrapUpPrompt(branch, planContent, openPullRequest = null, release
     "* If the merge touched `bun.lock` or any `package.json`, run `bun install --frozen-lockfile` and require it to pass BEFORE pushing. It is the one-second local reproduction of the CI install step, and it catches a lockfile that no longer matches the merged manifests \u2014 the failure mode where every CI job dies at its first step and nothing downstream runs. When it fails, do NOT hand-edit the lockfile: restore the base's copy (`git checkout origin/main -- bun.lock`), run a plain `bun install` so this branch's own dependencies are re-added, and confirm the frozen run then passes.",
     ...releaseBullets(release),
     `* Commit these changes and push them to the CURRENT branch (${branch}). Never create a branch here: the work under review is this branch's, and a second branch splits one plan across two reviews.`,
-    pullRequestStep(branch, openPullRequest),
+    pullRequestStep(branch, base, openPullRequest),
     "* Do not include Claude attribution in the commit or PR message.",
     ...lessonsSection(lessons),
     "",
@@ -53455,15 +54074,15 @@ function buildWrapUpPrompt(branch, planContent, openPullRequest = null, release
   ].join(`
 `);
 }
-function oneLine11(text2) {
+function oneLine12(text2) {
   return text2.trim().replace(/\s+/g, " ");
 }
 function lessonLines(lesson) {
-  const artifact = lesson.artifact === undefined || oneLine11(lesson.artifact) === "" ? "none" : oneLine11(lesson.artifact);
+  const artifact = lesson.artifact === undefined || oneLine12(lesson.artifact) === "" ? "none" : oneLine12(lesson.artifact);
   return [
     `- \`${lesson.id}\``,
-    `  - trigger: ${oneLine11(lesson.trigger)}`,
-    `  - action: ${oneLine11(lesson.action)}`,
+    `  - trigger: ${oneLine12(lesson.trigger)}`,
+    `  - action: ${oneLine12(lesson.action)}`,
     `  - artifact: ${artifact}`
   ];
 }
@@ -53488,8 +54107,8 @@ function lessonsSection(lessons) {
     "```"
   ];
 }
-function pullRequestStep(branch, openPullRequest) {
-  return openPullRequest === null ? `* No open PR was found for ${branch}: open one with \`gh pr create\`. If it answers that a PR already exists, push to that PR and update its body with \`gh pr edit\`; never open a second PR from a new branch.` : `* PR #${openPullRequest} is already open for ${branch}, likely opened by the plan's close-out: push to it and update its body with \`gh pr edit ${openPullRequest}\` so the description covers the promotions this session committed.`;
+function pullRequestStep(branch, base, openPullRequest) {
+  return openPullRequest === null ? `* No open PR was found for ${branch}: open one with \`gh pr create --base ${base}\`. If it answers that a PR already exists, push to that PR and update its body with \`gh pr edit\`; never open a second PR from a new branch.` : `* PR #${openPullRequest} is already open for ${branch}, likely opened by the plan's close-out: push to it and update its body with \`gh pr edit ${openPullRequest}\` so the description covers the promotions this session committed.`;
 }
 function releaseBullets(release) {
   if (release === null)
@@ -53551,11 +54170,11 @@ async function lessonsToPromote(learning) {
     return [];
   }
 }
-async function preserveProgress(planContent, settingSources, release, serving, learning, checkout) {
+async function preserveProgress(planContent, settingSources, release, serving, learning, base, checkout) {
   const branch = getCurrentBranch(checkout);
   const openPullRequest = await openPullRequestNumber(checkout, branch);
   return runWrapUpSession({
-    buildPrompt: (lessons) => buildWrapUpPrompt(branch, planContent, openPullRequest, release, lessons),
+    buildPrompt: (lessons) => buildWrapUpPrompt(branch, base, planContent, openPullRequest, release, lessons),
     settingSources,
     serving,
     learning,
@@ -53620,8 +54239,8 @@ function missingPullRequestBullet(branch, previousMessage) {
   return [opening, "  Its final message follows, quoted:", "", ...quoted4(previousMessage), ""];
 }
 function buildWrapUpRetryPrompt(retry) {
-  const base = buildWrapUpPrompt(retry.branch, retry.planContent, null, retry.release, retry.lessons);
-  const [classifierKey, ...rest] = base.split(`
+  const first = buildWrapUpPrompt(retry.branch, retry.base, retry.planContent, null, retry.release, retry.lessons);
+  const [classifierKey, ...rest] = first.split(`
 `);
   return [
     classifierKey,
@@ -53631,9 +54250,9 @@ function buildWrapUpRetryPrompt(retry) {
 `);
 }
 function retryWrapUp(run) {
-  const { branch, planContent, previousMessage } = run;
+  const { branch, base, planContent, previousMessage } = run;
   return runWrapUpSession({
-    buildPrompt: (lessons) => buildWrapUpRetryPrompt({ branch, planContent, release: null, lessons, previousMessage }),
+    buildPrompt: (lessons) => buildWrapUpRetryPrompt({ branch, base, planContent, release: null, lessons, previousMessage }),
     settingSources: run.settingSources,
     serving: run.serving,
     learning: run.learning,
@@ -53678,8 +54297,9 @@ async function runWrapUp(input) {
     planStub: planStub2,
     planContent
   });
+  const base = resolveBaseBranch(createGitRunner(checkout), settings.prBase);
   emitLoopEvent({ kind: "wrap-up", phase: "session" });
-  const finalMessage = await preserveProgress(planContent, settingSources, release, serving, wrapUpLearning, checkout);
+  const finalMessage = await preserveProgress(planContent, settingSources, release, serving, wrapUpLearning, base, checkout);
   if (activeOutputMode() !== "text") {
     const pullRequest = await openPullRequestNumber(checkout, expected2.branch);
     emitLoopEvent(pullRequest === null ? { kind: "no-pr", reason: `no open pull request for ${expected2.branch}` } : { kind: "pr", number: pullRequest });
@@ -53693,13 +54313,14 @@ async function runWrapUp(input) {
     dir: checkout
   });
   emitLoopEvent({ kind: "wrap-up", phase: "release" });
-  const finish2 = await finishRelease({ repoRoot: checkout, settings, preparation: release }, { readProvider: readProvider2 });
+  const finish2 = await finishRelease({ repoRoot: checkout, branch: expected2.branch, settings, preparation: release }, { readProvider: readProvider2 });
   if (readProvider2().provider !== "none") {
-    const delivery = await deliverPullRequest({ branch: expected2.branch, retries: settings.loopWrapUpRetries, previousMessage: finalMessage }, deliverySeamsIn({ ...input, fragment: finish2.fragment }));
+    const delivery = await deliverPullRequest({ branch: expected2.branch, retries: settings.loopWrapUpRetries, previousMessage: finalMessage }, deliverySeamsIn({ ...input, base, fragment: finish2.fragment }));
     if (delivery.kind === "interrupted")
       return;
     if (delivery.kind === "blocked")
       throw new CommandExit(1, delivery.message);
+    await retargetPullRequest(delivery.pull, base, { pulls: ghPullRequestsIn(checkout), output: activeOutput() });
   }
   if (ciWait) {
     emitLoopEvent({ kind: "wrap-up", phase: "ci" });
@@ -53792,6 +54413,7 @@ function deliverySeamsIn(context) {
     retry: (previousMessage) => retryWrapUp({
       previousMessage,
       branch: expected2.branch,
+      base: context.base,
       planContent: context.planContent,
       settingSources: context.settingSources,
       serving: context.serving,
@@ -53801,7 +54423,7 @@ function deliverySeamsIn(context) {
     openRunnerPullRequest: async () => {
       const runnerInput = runnerPrInputFor({
         branch: expected2.branch,
-        base: resolveBaseBranch(createGitRunner(checkout), context.settings.prBase),
+        base: context.base,
         planContent: context.planContent,
         planStub: context.planStub,
         notes: fragmentNotesIn(checkout, context.fragment)
@@ -53826,6 +54448,7 @@ var init_wrap_up_run = __esm(() => {
   init_checkout_watch();
   init_loop_events();
   init_pr_lifecycle();
+  init_pr_retarget();
   init_release_stage();
   init_runner_pr();
   init_wrap_up_retry();
@@ -53868,7 +54491,7 @@ var init_schedule = __esm(() => {
 
 // src/start.ts
 import fs3 from "fs";
-import { homedir as homedir12 } from "os";
+import { homedir as homedir13 } from "os";
 import path5 from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 async function start(args, repoRoot) {
@@ -53879,7 +54502,7 @@ async function start(args, repoRoot) {
     return;
   let runConfig;
   try {
-    runConfig = loadRunConfig({ root: repoRoot, home: homedir12() }, args);
+    runConfig = loadRunConfig({ root: repoRoot, home: homedir13() }, args);
   } catch (error) {
     if (!(error instanceof ConfigError))
       throw error;
@@ -53910,7 +54533,7 @@ async function start(args, repoRoot) {
   let expected2 = openCheckoutExpectation({ projectRoot: repoRoot, checkout, branch });
   await announceRiskTotal({
     repoRoot,
-    home: homedir12(),
+    home: homedir13(),
     planPath,
     config: runConfig.config,
     environment: process.env
@@ -53935,16 +54558,16 @@ async function start(args, repoRoot) {
         tiersRafa: runConfig.config.tiersRafa,
         tiersSkills: runConfig.config.tiersSkills,
         tiersAgents: runConfig.config.tiersAgents,
-        home: homedir12()
+        home: homedir13()
       },
-      sync: { resolved: runConfig, home: homedir12() },
+      sync: { resolved: runConfig, home: homedir13() },
       claim: createStartPreflightClaim(repoRoot, runConfig.config),
       drift: createStartPreflightDrift(repoRoot, runConfig.config)
     });
-    const serving = { root: repoRoot, run: session.id, home: homedir12(), settings: runConfig.config };
+    const serving = { root: repoRoot, run: session.id, home: homedir13(), settings: runConfig.config };
     const learning = {
       kind: runConfig.config.learningAdapter,
-      home: homedir12(),
+      home: homedir13(),
       blessMinConfidence: runConfig.config.learningBlessMinConfidence
     };
     const handout = {
@@ -53960,7 +54583,7 @@ async function start(args, repoRoot) {
     };
     const hubContact = createHubContact({
       root: repoRoot,
-      home: homedir12(),
+      home: homedir13(),
       resolved: runConfig,
       warn: (message) => activeOutput().warn(message),
       sessionId: session.id
@@ -54039,9 +54662,10 @@ async function start(args, repoRoot) {
         inject: injectMode,
         repoRoot,
         checkout,
-        home: homedir12(),
+        home: homedir13(),
         settingSources,
         knownMissing,
+        inherited: runStartFailures(trackerPath),
         serving,
         handout,
         base
@@ -55605,7 +56229,7 @@ var init_review_gate = __esm(() => {
 
 // src/plan.ts
 import fs5 from "fs";
-import { homedir as homedir13 } from "os";
+import { homedir as homedir14 } from "os";
 import path8 from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 function argValue2(args, flag2) {
@@ -55767,7 +56391,7 @@ function resolvePlanConfig(repoRoot, home) {
   }
 }
 async function plan(args, repoRoot, registry = CORE_ADAPTER_REGISTRY) {
-  const home = homedir13();
+  const home = homedir14();
   const config = resolvePlanConfig(repoRoot, home);
   const {
     settingSources,
@@ -56860,8 +57484,16 @@ var init_merge_guard = __esm(() => {
 });
 
 // src/pr/unchecked.ts
-function uncheckedCaseOf(workflowCount) {
-  return workflowCount === 0 ? "no-workflow" : "workflows-exist";
+function uncheckedCaseOf(workflowCount, baseWorkflows = null) {
+  if (workflowCount === 0)
+    return "no-workflow";
+  if (workflowCount !== null && baseWorkflows !== null && !baseWorkflows.runsOnPullRequests) {
+    return "no-pull-request-workflow";
+  }
+  return "workflows-exist";
+}
+function noPullRequestWorkflowLine(base) {
+  return `no workflow runs on pull requests into ${base}`;
 }
 function workflowCountLine(workflowCount) {
   if (workflowCount === null)
@@ -56875,24 +57507,177 @@ function skipChecksCommand(number) {
 function uncheckedQuestion(number) {
   return `Merge #${number} with no checks? [y/N]`;
 }
-function uncheckedComment(workflowCount) {
-  return `${UNCHECKED_MERGE_SENTENCE}
+function uncheckedComment(workflowCount, baseLine = null) {
+  const countLine2 = workflowCountLine(workflowCount);
+  const paragraphs = baseLine === null ? [UNCHECKED_MERGE_SENTENCE, countLine2] : [UNCHECKED_MERGE_SENTENCE, countLine2, baseLine];
+  return paragraphs.join(`
 
-${workflowCountLine(workflowCount)}`;
+`);
 }
-function readUnchecked(number, workflowCount) {
-  const which = uncheckedCaseOf(workflowCount);
-  const warning = which === "no-workflow" ? NO_WORKFLOW_WARNING : WORKFLOWS_EXIST_WARNING;
+function warningOf2(which, baseWorkflows) {
+  if (which === "no-workflow")
+    return NO_WORKFLOW_WARNING;
+  if (which === "no-pull-request-workflow" && baseWorkflows !== null)
+    return noPullRequestWorkflowLine(baseWorkflows.base);
+  return WORKFLOWS_EXIST_WARNING;
+}
+function readUnchecked(number, workflowCount, baseWorkflows = null) {
+  const which = uncheckedCaseOf(workflowCount, baseWorkflows);
+  const warning = warningOf2(which, baseWorkflows);
+  const isBaseCase = which === "no-pull-request-workflow";
   return Object.freeze({
     case: which,
     warning: Object.freeze([workflowCountLine(workflowCount), warning]),
-    yesMayAnswer: which === "no-workflow",
+    yesMayAnswer: which !== "workflows-exist",
     question: uncheckedQuestion(number),
-    comment: uncheckedComment(workflowCount)
+    comment: uncheckedComment(workflowCount, isBaseCase ? warning : null)
   });
 }
 var NO_WORKFLOW_WARNING = "nothing on GitHub has tested this branch; you are relying on the checks run locally", WORKFLOWS_EXIST_WARNING = "CI may not have started (a path filter, a draft, Actions disabled, or it has not registered yet); this is probably not what you want", UNCHECKED_MERGE_SENTENCE = "Merged with no checks reported, by rafa pr merge --skip-checks.";
 
+// src/pr/workflow-triggers.ts
+function workflowsRunOnPullRequestsInto(workflowTexts, base) {
+  return workflowTexts.some((text2) => workflowNamesBase(text2, base));
+}
+function workflowNamesBase(workflowText, base) {
+  let document;
+  try {
+    document = Bun.YAML.parse(workflowText);
+  } catch {
+    return true;
+  }
+  return readWorkflow(document, base) !== false;
+}
+function readWorkflow(document, base) {
+  if (!isPlainObject(document) || !("on" in document))
+    return UNKNOWN;
+  const on = document.on;
+  if (typeof on === "string")
+    return on === PULL_REQUEST_EVENT;
+  if (Array.isArray(on)) {
+    if (!on.every((event) => typeof event === "string"))
+      return UNKNOWN;
+    return on.includes(PULL_REQUEST_EVENT);
+  }
+  if (!isPlainObject(on))
+    return UNKNOWN;
+  if (!(PULL_REQUEST_EVENT in on))
+    return false;
+  return readPullRequestTrigger(on[PULL_REQUEST_EVENT], base);
+}
+function readPullRequestTrigger(trigger, base) {
+  if (trigger === null || trigger === undefined)
+    return true;
+  if (!isPlainObject(trigger))
+    return UNKNOWN;
+  const branches = trigger.branches;
+  const ignored = trigger["branches-ignore"];
+  if (branches !== undefined && ignored !== undefined)
+    return UNKNOWN;
+  if (branches !== undefined)
+    return readBranches2(branches, base);
+  if (ignored !== undefined)
+    return readBranchesIgnore(ignored, base);
+  return true;
+}
+function readBranches2(filter, base) {
+  const patterns = patternListOf(filter);
+  if (patterns === null)
+    return UNKNOWN;
+  let named4 = false;
+  for (const pattern of patterns) {
+    const negated = pattern.startsWith("!");
+    const matches = branchPatternMatches(negated ? pattern.slice(1) : pattern, base);
+    if (matches === null)
+      return UNKNOWN;
+    if (matches)
+      named4 = !negated;
+  }
+  return named4;
+}
+function readBranchesIgnore(filter, base) {
+  const patterns = patternListOf(filter);
+  if (patterns === null || patterns.some((pattern) => pattern.startsWith("!")))
+    return UNKNOWN;
+  let anyMatch = false;
+  for (const pattern of patterns) {
+    const matches = branchPatternMatches(pattern, base);
+    if (matches === null)
+      return UNKNOWN;
+    anyMatch = anyMatch || matches;
+  }
+  return !anyMatch;
+}
+function patternListOf(filter) {
+  if (typeof filter === "string")
+    return [filter];
+  if (Array.isArray(filter) && filter.every((pattern) => typeof pattern === "string"))
+    return filter;
+  return null;
+}
+function branchPatternMatches(pattern, branch) {
+  const source = regexSourceOf(pattern);
+  if (source === null)
+    return null;
+  try {
+    return new RegExp(`^${source}$`).test(branch);
+  } catch {
+    return null;
+  }
+}
+function regexSourceOf(pattern) {
+  let source = "";
+  let quantifiable = false;
+  let index = 0;
+  while (index < pattern.length) {
+    const char = pattern.charAt(index);
+    if (char === "*") {
+      const isDouble = pattern.charAt(index + 1) === "*";
+      source += isDouble ? ".*" : "[^/]*";
+      index += isDouble ? 2 : 1;
+      quantifiable = false;
+    } else if (char === "?" || char === "+") {
+      if (!quantifiable)
+        return null;
+      source += char;
+      index += 1;
+      quantifiable = false;
+    } else if (char === "[") {
+      const close = pattern.indexOf("]", index + 1);
+      if (close === -1)
+        return null;
+      const body = pattern.slice(index + 1, close);
+      if (!BRACKET_BODY.test(body))
+        return null;
+      source += `[${body}]`;
+      index = close + 1;
+      quantifiable = true;
+    } else if (char === "\\") {
+      if (index + 1 >= pattern.length)
+        return null;
+      source += escapeRegex(pattern.charAt(index + 1));
+      index += 2;
+      quantifiable = true;
+    } else {
+      source += escapeRegex(char);
+      index += 1;
+      quantifiable = true;
+    }
+  }
+  return source;
+}
+function escapeRegex(char) {
+  return char.replace(REGEX_SPECIAL, "\\$&");
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var PULL_REQUEST_EVENT = "pull_request", UNKNOWN = "unknown", BRACKET_BODY, REGEX_SPECIAL;
+var init_workflow_triggers = __esm(() => {
+  BRACKET_BODY = /^[A-Za-z0-9-]+$/;
+  REGEX_SPECIAL = /[.*+?^${}()|[\]\\/]/g;
+});
+
 // src/commands/pr/merge-unchecked.ts
 function refusal13(head, reading2, summary, tail) {
   return new CommandExit(1, [
@@ -56910,10 +57695,37 @@ async function workflowCountOf(pulls) {
     return null;
   }
 }
+function workflowBlobsOf(listing2) {
+  return listing2.split("\x00").map((entry) => LS_TREE_ENTRY2.exec(entry)).filter((match) => match !== null).filter(([, type, , path9]) => type === "blob" && WORKFLOW_ENDINGS.some((ending) => path9?.endsWith(ending) === true)).map(([, , oid]) => oid ?? "");
+}
+function readBaseWorkflows(git, base) {
+  if (base === "" || base.startsWith("-"))
+    return null;
+  if (!git(["fetch", "origin", base]).ok)
+    return null;
+  const listed4 = git(["ls-tree", "--full-tree", "-z", `origin/${base}`, WORKFLOWS_DIR]);
+  if (!listed4.ok)
+    return null;
+  const blobs = workflowBlobsOf(listed4.stdout);
+  if (blobs.length === 0)
+    return null;
+  const shown2 = blobs.map((oid) => git(["cat-file", "blob", oid]));
+  if (shown2.some((result2) => !result2.ok))
+    return null;
+  const texts = shown2.map((result2) => result2.stdout);
+  return Object.freeze({ base, runsOnPullRequests: workflowsRunOnPullRequestsInto(texts, base) });
+}
+function baseWorkflowsOf(options, workflowCount) {
+  const { git, base } = options;
+  if (workflowCount === null || workflowCount === 0 || git === undefined || base === undefined)
+    return null;
+  return readBaseWorkflows(git, base);
+}
 async function readUncheckedMerge(options) {
   const { pulls, number, yes, summary } = options;
   const workflowCount = await workflowCountOf(pulls);
-  const reading2 = readUnchecked(number, workflowCount);
+  const baseWorkflows = baseWorkflowsOf(options, workflowCount);
+  const reading2 = readUnchecked(number, workflowCount, baseWorkflows);
   if (yes && !reading2.yesMayAnswer) {
     throw refusal13(`rafa pr merge refuses --yes for #${number} with no checks: workflows exist, or their count could not be read.`, reading2, summary, "That is more likely a fault than a choice, so a person has to answer. Run it again without --yes on a terminal.");
   }
@@ -56922,7 +57734,7 @@ async function readUncheckedMerge(options) {
     const tail = reading2.yesMayAnswer ? "Merge it without the question with --yes." : "--yes is refused here, so run it on a terminal and answer it.";
     throw refusal13(`rafa pr merge asks before merging #${number} with no checks, and standard input is no terminal.`, reading2, summary, tail);
   }
-  return Object.freeze({ workflowCount, reading: reading2, yes });
+  return Object.freeze({ workflowCount, baseWorkflows, reading: reading2, yes });
 }
 function isYes2(answer5) {
   return answer5 !== null && YES_ANSWERS5.includes(answer5.trim().toLowerCase());
@@ -56956,12 +57768,15 @@ async function postUncheckedComment(pulls, number, unchecked, warn4) {
     return null;
   }
 }
-var INDENT12 = "   ", YES_ANSWERS5;
+var INDENT12 = "   ", YES_ANSWERS5, WORKFLOWS_DIR = ".github/workflows/", WORKFLOW_ENDINGS, LS_TREE_ENTRY2;
 var init_merge_unchecked = __esm(() => {
   init_command();
   init_confirm();
   init_config_sections();
+  init_workflow_triggers();
   YES_ANSWERS5 = ["y", "yes"];
+  WORKFLOW_ENDINGS = [".yml", ".yaml"];
+  LS_TREE_ENTRY2 = /^\d+ (\w+) ([0-9a-f]+)\t(.+)$/s;
 });
 
 // src/commands/pr/merge.ts
@@ -57108,8 +57923,8 @@ async function reportAfterCleanUp(context, pr, seams, detail) {
   return { unblocked: null, freed };
 }
 async function askToMerge(context, pr, seams, ask) {
-  const { number, summary, yes, skipChecks } = ask;
-  const unchecked = skipChecks ? await readUncheckedMerge({ pulls: pr.pulls, number, yes, summary, isTerminal: seams.isTerminal }) : null;
+  const { number, summary, yes, skipChecks, base, git } = ask;
+  const unchecked = skipChecks ? await readUncheckedMerge({ pulls: pr.pulls, number, yes, summary, isTerminal: seams.isTerminal, base, git }) : null;
   if (unchecked === null && !yes)
     requireTerminal(seams, summary);
   context.output.info(summary);
@@ -57174,7 +57989,7 @@ async function runMerge2(context, seams) {
     openPrompter: prompterOf(seams)
   });
   const summary = summaryLine2(detail, method);
-  const answer5 = guard.go ? await askToMerge(context, pr, seams, { number: detail.number, summary, yes, skipChecks }) : { go: false, unchecked: null };
+  const answer5 = guard.go ? await askToMerge(context, pr, seams, { number: detail.number, summary, yes, skipChecks, base: detail.baseRefName, git }) : { go: false, unchecked: null };
   const answered3 = {
     number: detail.number,
     source: pick.source,
@@ -57238,7 +58053,7 @@ function createPrMergeCommand(seams = DEFAULT_MERGE_SEAMS) {
     subject: "pr",
     action: "merge",
     summary: "merge a pull request and clean up both branches",
-    description: "Merges one pull request through the GitHub CLI and then, in code, switches to the base branch," + " pulls it fast-forward only, deletes the head branch locally and on the remote where it is still there," + " and prunes, reporting each step; a head branch this checkout has no local branch for is reported as a" + " skipped local delete, and the rest still run. Refuses before it asks anything on a dirty working tree, on a pull" + " request that is not green or does not merge, and on a head branch checked out in another worktree. It" + " shows the pull request, its branches and the method and asks `Merge? [y/N]`; `--yes` skips the question," + " and without a terminal and without `--yes` it refuses. A pull request that reports no checks at all is" + " refused unless `--skip-checks` is given, which is refused on any pull request that does report checks;" + " with it the command reads how many workflows the repository defines, prints a warning for that case, asks" + " `Merge #<n> with no checks? [y/N]` (which `--yes` answers only where the repository defines no workflow)," + " and after the merge posts one comment on the pull request saying so. Where the release runs, the release" + " guard reads the branch before the question: a `collision` is refused unless" + " `dangerous.acceptVersionCollision` is true, and `pr.versionCollision` sets whether a `missing` or" + " `stale` branch merges silently, with a warning, after its own question, or not at all. A step that fails never undoes the merge: it" + " prints what is left as commands to paste and exits 1. After the merge it ticks the `Closes #<n>` line of" + " every issue the pull request closes on every open board whose checklist lists it, or on the roadmap issue while no issue carries `type:roadmap`, warning rather than failing when that write" + ' does not land. It ends by reading every open issue whose "Blocked by:" line names an issue this pull' + " request closes, asking whether to remove `spec:blocked` from each one whose blockers have all closed;" + " `--yes` does not answer that question, and every failure of that reading is a warning. With" + " board.relationships set to native it ticks no epic checklist and, in place of that reading, prints the" + " open issues the merge freed, whose blockers GitHub clears by itself, asking nothing and writing nothing. With" + " `--output=json` the pull request, the method, the steps that ran, the follow-ups, the roadmap tick and" + " the unblock reading, or the freed issues in native mode, are the data of the terminal result event. Refuses with exit code 2 where" + " `pr.provider` is not `gh`.",
+    description: "Merges one pull request through the GitHub CLI and then, in code, switches to the base branch," + " pulls it fast-forward only, deletes the head branch locally and on the remote where it is still there," + " and prunes, reporting each step; a head branch this checkout has no local branch for is reported as a" + " skipped local delete, and the rest still run. Refuses before it asks anything on a dirty working tree, on a pull" + " request that is not green or does not merge, and on a head branch checked out in another worktree. It" + " shows the pull request, its branches and the method and asks `Merge? [y/N]`; `--yes` skips the question," + " and without a terminal and without `--yes` it refuses. A pull request that reports no checks at all is" + " refused unless `--skip-checks` is given, which is refused on any pull request that does report checks;" + " with it the command reads how many workflows the repository defines, prints a warning for that case, asks" + " `Merge #<n> with no checks? [y/N]` (which `--yes` answers only where the repository defines no workflow, or" + " where no workflow file on the base has a `pull_request` trigger naming it)," + " and after the merge posts one comment on the pull request saying so. Where the release runs, the release" + " guard reads the branch before the question: a `collision` is refused unless" + " `dangerous.acceptVersionCollision` is true, and `pr.versionCollision` sets whether a `missing` or" + " `stale` branch merges silently, with a warning, after its own question, or not at all. A step that fails never undoes the merge: it" + " prints what is left as commands to paste and exits 1. After the merge it ticks the `Closes #<n>` line of" + " every issue the pull request closes on every open board whose checklist lists it, or on the roadmap issue while no issue carries `type:roadmap`, warning rather than failing when that write" + ' does not land. It ends by reading every open issue whose "Blocked by:" line names an issue this pull' + " request closes, asking whether to remove `spec:blocked` from each one whose blockers have all closed;" + " `--yes` does not answer that question, and every failure of that reading is a warning. With" + " board.relationships set to native it ticks no epic checklist and, in place of that reading, prints the" + " open issues the merge freed, whose blockers GitHub clears by itself, asking nothing and writing nothing. With" + " `--output=json` the pull request, the method, the steps that ran, the follow-ups, the roadmap tick and" + " the unblock reading, or the freed issues in native mode, are the data of the terminal result event. Refuses with exit code 2 where" + " `pr.provider` is not `gh`.",
     args: [
       {
         name: "n",
@@ -57254,7 +58069,7 @@ function createPrMergeCommand(seams = DEFAULT_MERGE_SEAMS) {
       },
       {
         name: "skip-checks",
-        description: "Merge a pull request that reports no checks at all, after a warning and its own question." + " Refused where the pull request reports any check; `--yes` beside it is refused where the repository" + " defines a workflow or its workflow count could not be read.",
+        description: "Merge a pull request that reports no checks at all, after a warning and its own question." + " Refused where the pull request reports any check; `--yes` beside it is refused where the repository" + " defines a workflow that may run on pull requests into the base, or its workflow count could not be read.",
         type: "boolean"
       },
       {
@@ -57358,7 +58173,7 @@ function readFailedStep(lines2) {
     const head = groupStep(line.text);
     if (head !== undefined)
       group = head;
-    if (!line.text.startsWith(ERROR_PREFIX))
+    if (!line.text.startsWith(ERROR_PREFIX2))
       continue;
     if (line.step !== undefined)
       return { name: line.step, source: "step-column" };
@@ -57398,7 +58213,7 @@ function readFailedLog(text2, options = {}) {
     total: lines2.length
   };
 }
-var FAILED_LOG_TAIL_LINES = 40, UNKNOWN_STEP = "UNKNOWN STEP", GROUP_STEP_PREFIX = "##[group]Run ", ERROR_PREFIX = "##[error]", COLUMN = "\t", BOM = "\uFEFF", TIMESTAMP, COLOUR, PREFIX34 = "pr triage evidence";
+var FAILED_LOG_TAIL_LINES = 40, UNKNOWN_STEP = "UNKNOWN STEP", GROUP_STEP_PREFIX = "##[group]Run ", ERROR_PREFIX2 = "##[error]", COLUMN = "\t", BOM = "\uFEFF", TIMESTAMP, COLOUR, PREFIX34 = "pr triage evidence";
 var init_evidence = __esm(() => {
   init_config_sections();
   TIMESTAMP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z /;
@@ -58595,7 +59410,7 @@ var init_triage_guard = __esm(() => {
 function ignoredLines(ignored) {
   return ignored.map((comment) => `${INDENT15}${comment.reason}`);
 }
-function evidenceOf(reading2) {
+function evidenceOf2(reading2) {
   return reading2.logs?.chosen?.evidence;
 }
 function workflowCountOf2(reading2) {
@@ -58632,7 +59447,7 @@ function noFiles(reading2) {
   return "none; the head merges cleanly";
 }
 function excerptBlock(reading2) {
-  const evidence = evidenceOf(reading2);
+  const evidence = evidenceOf2(reading2);
   if (evidence === undefined)
     return [];
   const excerpt2 = excerptLines(evidence);
@@ -58775,7 +59590,7 @@ var init_budget2 = __esm(() => {
 
 // src/pr/plans/load.ts
 import { existsSync as existsSync57, readFileSync as readFileSync69 } from "fs";
-import { dirname as dirname32, join as join87 } from "path";
+import { dirname as dirname33, join as join87 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 function pinnedPlanFileName(triageClass) {
   return `resolve-${triageClass}.md`;
@@ -58853,7 +59668,7 @@ var MODULE_DIR5, PINNED_PLANS_DIRNAME = "plans", PINNED_PLAN_CLASSES, SLOT_PATTE
 var init_load2 = __esm(() => {
   init_classes();
   init_follow_up();
-  MODULE_DIR5 = dirname32(fileURLToPath7(import.meta.url));
+  MODULE_DIR5 = dirname33(fileURLToPath7(import.meta.url));
   PINNED_PLAN_CLASSES = Object.freeze([
     ...SIMPLE_TRIAGE_CLASSES,
     ...DEPENDENCY_BUMP_SIMPLE_CLASSES
@@ -59003,7 +59818,7 @@ var init_resolve_loop = __esm(() => {
 
 // src/pr/triage/version-convert.ts
 import { mkdirSync as mkdirSync25, readFileSync as readFileSync70, writeFileSync as writeFileSync26 } from "fs";
-import { dirname as dirname33, join as join89, posix as posix9 } from "path";
+import { dirname as dirname34, join as join89, posix as posix9 } from "path";
 function conversionLevel(from, to) {
   if (from === null)
     return null;
@@ -59139,7 +59954,7 @@ function writeConversion(input, plan2) {
   for (const [path9, text2] of writes) {
     const target = join89(input.worktree, path9);
     try {
-      mkdirSync25(dirname33(target), { recursive: true });
+      mkdirSync25(dirname34(target), { recursive: true });
       writeFileSync26(target, text2);
     } catch (error) {
       return `${path9} could not be written in the worktree, which may hold part of the conversion: ${messageOf(error)}`;
@@ -59345,7 +60160,7 @@ function resolveCommentBody(run, detail, assessment, attempts, resolved, workflo
     at: run.now(),
     attempts,
     resolved,
-    evidence: evidenceOf(run.reading),
+    evidence: evidenceOf2(run.reading),
     workflowCount
   });
   return isDependabotBranch(detail) ? `${body}
@@ -59423,7 +60238,7 @@ async function endOfAttempt(run, before, waited) {
     reading: reading2,
     outcome: { triageClass: assessment.triageClass, step: assessment.step },
     assessment,
-    evidence: fresh === null ? before.evidence : evidenceOf(reading2),
+    evidence: fresh === null ? before.evidence : evidenceOf2(reading2),
     green,
     unchanged: reading2.rerun.decision === "already-assessed" ? ATTEMPT_OUTCOME_UNCHANGED : null
   };
@@ -59432,7 +60247,7 @@ function stopLines(run, reason, end, removal) {
   const prompt = end.reading.prompt ?? buildFollowUpPrompt({
     pr: end.reading.detail,
     assessment: end.assessment,
-    evidence: evidenceOf(end.reading)
+    evidence: evidenceOf2(end.reading)
   });
   return [
     `\u26D4 rafa pr triage --resolve gave up on #${run.number}: ${reason}.`,
@@ -59505,7 +60320,7 @@ async function runAttempts(run, detail, first) {
   const runLoop = run.runLoop ?? runResolveLoop;
   const state = {
     assessment: first,
-    evidence: evidenceOf(run.reading),
+    evidence: evidenceOf2(run.reading),
     reading: run.reading,
     previous: null,
     spent: spentAttempts(run.reading.attempts),
@@ -59696,7 +60511,7 @@ async function commentOn3(options, reading2, existing) {
     at: options.at,
     attempts: reading2.attempts,
     resolved: RESOLVED,
-    evidence: evidenceOf(reading2),
+    evidence: evidenceOf2(reading2),
     workflowCount: workflowCountOf2(reading2)
   });
   try {
@@ -61260,7 +62075,7 @@ var init_proposal_file = __esm(() => {
 
 // src/backfill/backup.ts
 import { copyFileSync as copyFileSync5, existsSync as existsSync59, mkdirSync as mkdirSync26 } from "fs";
-import { dirname as dirname34, isAbsolute as isAbsolute24, join as join93, relative as relative19, resolve as resolve37, sep as sep8 } from "path";
+import { dirname as dirname35, isAbsolute as isAbsolute24, join as join93, relative as relative19, resolve as resolve37, sep as sep8 } from "path";
 function backupDirectory(base) {
   return join93(base, BACKUP_PATH);
 }
@@ -61284,7 +62099,7 @@ function backupFile(path9, options) {
     return { path: path9, kind: "missing", backup: null };
   if (existsSync59(backup))
     return { path: path9, kind: "kept", backup };
-  mkdirSync26(dirname34(backup), { recursive: true });
+  mkdirSync26(dirname35(backup), { recursive: true });
   copyFileSync5(path9, backup);
   return { path: path9, kind: "copied", backup };
 }
@@ -61314,7 +62129,7 @@ var init_backup = __esm(() => {
 
 // src/backfill/derive.ts
 import { readFileSync as readFileSync73, writeFileSync as writeFileSync27 } from "fs";
-import { basename as basename20 } from "path";
+import { basename as basename23 } from "path";
 function renderWhenToUse(trigger, prevents) {
   return `${sentenceEnded(trigger)} Prevents: ${prevents}`;
 }
@@ -61424,8 +62239,8 @@ function fileChanges(name2, data, body, options) {
   return { changes, notes };
 }
 function planFile(entry, options) {
-  if (basename20(entry.path) !== SKILL_FILE) {
-    return inert(entry, "skipped", `${basename20(entry.path)} is no ${SKILL_FILE}, so it registers no skill`);
+  if (basename23(entry.path) !== SKILL_FILE) {
+    return inert(entry, "skipped", `${basename23(entry.path)} is no ${SKILL_FILE}, so it registers no skill`);
   }
   if (entry.name === null) {
     return inert(entry, "skipped", "its place implies no skill name, so no stack can be derived from it");
@@ -62138,7 +62953,7 @@ var init_propose = __esm(() => {
 
 // src/demote/select.ts
 import { readdirSync as readdirSync21, readFileSync as readFileSync76, realpathSync as realpathSync17, statSync as statSync28 } from "fs";
-import { basename as basename21, dirname as dirname35, join as join95 } from "path";
+import { basename as basename24, dirname as dirname36, join as join95 } from "path";
 function realOrSelf(path9) {
   try {
     return realpathSync17(path9);
@@ -62154,12 +62969,12 @@ function samePath(left, right) {
   return resolved === other || resolved.toLowerCase() === other.toLowerCase();
 }
 function resolveDemotionScope(dir, home) {
-  if (basename21(dir) !== SKILLS_DIRECTORY)
+  if (basename24(dir) !== SKILLS_DIRECTORY)
     return null;
-  const claude = dirname35(dir);
-  if (basename21(claude) !== CLAUDE_DIRECTORY)
+  const claude = dirname36(dir);
+  if (basename24(claude) !== CLAUDE_DIRECTORY)
     return null;
-  const base = dirname35(claude);
+  const base = dirname36(claude);
   const demotedDir = join95(base, DEMOTED_PATH);
   return {
     scope: samePath(base, home) ? "user" : "project",
@@ -62604,7 +63419,7 @@ var init_check3 = __esm(() => {
 // src/demote/apply.ts
 import { copyFileSync as copyFileSync6, existsSync as existsSync60, mkdirSync as mkdirSync28, mkdtempSync as mkdtempSync4, readdirSync as readdirSync22, readFileSync as readFileSync77, renameSync as renameSync11, rmSync as rmSync13, statSync as statSync30, unlinkSync as unlinkSync2, writeFileSync as writeFileSync29 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
-import { dirname as dirname36, join as join97 } from "path";
+import { dirname as dirname37, join as join97 } from "path";
 function isLearnedPath(path9) {
   const segments = path9.split("/");
   return segments.length === 2 && segments[0] === LEARNED_DIRECTORY && (segments[1] ?? "").endsWith(MARKDOWN_EXTENSION);
@@ -62661,7 +63476,7 @@ function planKept(scope, row3, file) {
     return inert3(row3.path, "procedure", "kept", "procedure-shaped: left where it is, for the backfill");
   }
   const to = promotedPath(scope, row3.path);
-  if (existsSync60(to) || existsSync60(dirname36(to))) {
+  if (existsSync60(to) || existsSync60(dirname37(to))) {
     return inert3(row3.path, "procedure", "refused", `kept as a skill, but ${to} is already there`);
   }
   return {
@@ -62753,7 +63568,7 @@ function planDemotion(report5, scope, seams = DEFAULT_APPLY_SEAMS) {
   }
 }
 function moveFile(move3) {
-  mkdirSync28(dirname36(move3.to), { recursive: true });
+  mkdirSync28(dirname37(move3.to), { recursive: true });
   try {
     renameSync11(move3.from, move3.to);
   } catch {
@@ -62764,7 +63579,7 @@ function moveFile(move3) {
 function applyDemotion(plan2) {
   for (const action of plan2.actions) {
     if (action.write !== null) {
-      mkdirSync28(dirname36(action.write.path), { recursive: true });
+      mkdirSync28(dirname37(action.write.path), { recursive: true });
       writeFileSync29(action.write.path, action.write.text, "utf8");
     }
     if (action.move !== null)
@@ -62830,7 +63645,7 @@ var init_draft = __esm(() => {
 
 // src/commands/skill/demote.ts
 import { existsSync as existsSync61, mkdirSync as mkdirSync29, readFileSync as readFileSync78, statSync as statSync31, writeFileSync as writeFileSync30 } from "fs";
-import { dirname as dirname37, resolve as resolve40 } from "path";
+import { dirname as dirname38, resolve as resolve40 } from "path";
 function readApply(value) {
   if (value === undefined || value === false || value === "false")
     return false;
@@ -62892,7 +63707,7 @@ function previousReport(path9, context) {
 function runWrite(context, scope) {
   const files = selectSources(scope);
   const report5 = buildDemotionReport(files, previousReport(scope.reportPath, context));
-  mkdirSync29(dirname37(scope.reportPath), { recursive: true });
+  mkdirSync29(dirname38(scope.reportPath), { recursive: true });
   writeFileSync30(scope.reportPath, writeDemotionReport(report5), "utf8");
   const result2 = {
     applied: false,
@@ -63797,6 +64612,504 @@ var init_status4 = __esm(() => {
   status_default3 = createStatusCommand();
 });
 
+// src/commands/update/stub.ts
+function stubMessage(action, issue5) {
+  return `rafa update ${action} is a feature in development, tracked in ${ISSUES_URL}/${String(issue5)}.` + " Nothing was changed.";
+}
+function createUpdateStub(spec) {
+  const command = {
+    name: `update ${spec.action}`,
+    subject: "update",
+    action: spec.action,
+    summary: `${spec.summary} (in development, #${String(spec.issue)})`,
+    description: `${spec.summary}. In development: it refuses with exit code 1, naming #${String(spec.issue)},` + " and changes nothing.",
+    args: [],
+    flags: [],
+    examples: [{ cmd: `rafa update ${spec.action}`, note: `Refuses, naming #${String(spec.issue)}; changes nothing.` }],
+    outputs: ["text", "json"],
+    needsProject: false,
+    ...spec.hidden === true ? { hidden: true } : {},
+    run: () => Promise.reject(new CommandExit(1, stubMessage(spec.action, spec.issue)))
+  };
+  return Object.freeze(command);
+}
+var ISSUES_URL = "https://github.com/open-tomato/rafa/issues";
+var init_stub = __esm(() => {
+  init_command();
+});
+
+// src/commands/update/board.ts
+var board_default;
+var init_board = __esm(() => {
+  init_stub();
+  board_default = createUpdateStub({ action: "board", summary: "apply the board's newest setup and its migrations", issue: 717 });
+});
+
+// src/project/lock.ts
+import { existsSync as existsSync63, lstatSync as lstatSync3, readFileSync as readFileSync79, writeFileSync as writeFileSync31 } from "fs";
+import { join as join98 } from "path";
+function lockPath(root) {
+  return join98(root, LOCK_FILE);
+}
+function projectLockText(version2) {
+  const lock = { lockfileVersion: LOCKFILE_VERSION, rafa: version2 };
+  return `${JSON.stringify(lock, null, 2)}
+`;
+}
+function isLink(path9) {
+  try {
+    return lstatSync3(path9).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function refuse16(problem2) {
+  throw new ProjectLockError(`${LOCK_FILE} ${problem2}`);
+}
+function lockOf(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    refuse16("holds no JSON object");
+  const record = value;
+  const format = record["lockfileVersion"];
+  if (format !== LOCKFILE_VERSION) {
+    refuse16(`is in lockfileVersion ${String(format)}, and this rafa reads ${String(LOCKFILE_VERSION)}: a newer rafa wrote it`);
+  }
+  const rafa = record["rafa"];
+  if (typeof rafa !== "string" || parseSemanticVersion(rafa) === null) {
+    refuse16(`names rafa ${JSON.stringify(rafa)}, which is no version`);
+  }
+  return { lockfileVersion: LOCKFILE_VERSION, rafa };
+}
+function readProjectLock(root) {
+  const path9 = lockPath(root);
+  if (!existsSync63(path9)) {
+    if (isLink(path9))
+      refuse16("is a link to nothing");
+    return null;
+  }
+  let text2;
+  try {
+    text2 = readFileSync79(path9, "utf8");
+  } catch (error) {
+    refuse16(`could not be read: ${messageOf(error)}`);
+  }
+  let value;
+  try {
+    value = JSON.parse(text2);
+  } catch {
+    refuse16("is not JSON");
+  }
+  return lockOf(value);
+}
+function writeProjectLock(root, version2) {
+  writeFileSync31(lockPath(root), projectLockText(version2), "utf8");
+}
+var LOCK_FILE = "rafa.lock", LOCKFILE_VERSION = 1, ProjectLockError;
+var init_lock = __esm(() => {
+  init_config_sections();
+  init_version2();
+  ProjectLockError = class ProjectLockError extends Error {
+    name = "ProjectLockError";
+  };
+});
+
+// src/project/update-current.ts
+import { existsSync as existsSync64 } from "fs";
+import { join as join99 } from "path";
+function missingFolders(root) {
+  return PROJECT_TREE.map((name2) => join99(SCOPE_DIR, name2)).filter((relative21) => !existsSync64(join99(root, relative21)));
+}
+async function readBoard3(access) {
+  if (access.gh === null)
+    return { kind: "skipped", reason: access.reason };
+  try {
+    const held = await listBoardLabels(access.gh);
+    return { kind: "labels", missing: missingBoardLabels(held).map((label) => label.name) };
+  } catch (error) {
+    return { kind: "skipped", reason: messageOf(error) };
+  }
+}
+function lockChangeOf(range) {
+  if (range.kind === "adopt")
+    return "created";
+  return range.kind === "patch" ? "updated" : "unchanged";
+}
+function fromOf(range) {
+  if (range.kind === "patch")
+    return range.from;
+  if (range.kind === "same")
+    return range.to;
+  return null;
+}
+async function readUpdatePlan(roots, range, board) {
+  const { root, lockRoot } = roots;
+  return {
+    root,
+    lockRoot,
+    from: fromOf(range),
+    to: range.to,
+    folders: missingFolders(root),
+    board: await readBoard3(board),
+    deprecations: DEPRECATIONS,
+    lock: lockChangeOf(range)
+  };
+}
+function planChanges(plan2) {
+  const labels = plan2.board.kind === "labels" ? plan2.board.missing.length : 0;
+  return plan2.folders.length > 0 || labels > 0 || plan2.deprecations.length > 0 || plan2.lock !== "unchanged";
+}
+function foldersNowThere(plan2) {
+  return plan2.folders.filter((relative21) => existsSync64(join99(plan2.root, relative21)));
+}
+function writeFolders(plan2) {
+  if (plan2.folders.length === 0)
+    return [];
+  try {
+    return writeProjectScope(plan2.root).filter((write) => write.change === "created").map((write) => write.path);
+  } catch (error) {
+    throw new UpdateStepError("folders", messageOf(error), foldersNowThere(plan2));
+  }
+}
+function createdLabels(parts) {
+  return parts.filter((part) => part.outcome === "created").map((part) => `label ${part.name}`);
+}
+async function applyUpdatePlan(plan2, gh) {
+  const folders = writeFolders(plan2);
+  const labels = gh !== null && plan2.board.kind === "labels" && plan2.board.missing.length > 0 ? await setUpLabels(gh) : [];
+  if (plan2.lock !== "unchanged") {
+    try {
+      writeProjectLock(plan2.lockRoot, plan2.to);
+    } catch (error) {
+      throw new UpdateStepError("lock", messageOf(error), [...folders, ...createdLabels(labels)]);
+    }
+  }
+  return { folders, labels, lock: plan2.lock };
+}
+var DEPRECATIONS, UpdateStepError;
+var init_update_current = __esm(() => {
+  init_setup();
+  init_config_sections();
+  init_lock();
+  init_scaffold();
+  init_scope();
+  DEPRECATIONS = Object.freeze([]);
+  UpdateStepError = class UpdateStepError extends Error {
+    step;
+    written;
+    name = "UpdateStepError";
+    constructor(step2, message, written3) {
+      super(message);
+      this.step = step2;
+      this.written = written3;
+    }
+  };
+});
+
+// src/project/update-range.ts
+function refused6(reason, message) {
+  return { kind: "refused", reason, message };
+}
+function readCurrentRange(recorded, installed) {
+  const to = parseSemanticVersion(installed);
+  if (to === null)
+    return refused6("unreadable", `the installed rafa answers "${installed}", which is no version`);
+  if (recorded === null)
+    return { kind: "adopt", to: installed };
+  const from = parseSemanticVersion(recorded);
+  if (from === null)
+    return refused6("unreadable", `the project records rafa "${recorded}", which is no version`);
+  const order = compareVersions(to, from);
+  if (order < 0) {
+    return refused6("older", `the installed rafa ${installed} is older than the project's ${recorded}, and no downgrade runs before 1.0.0`);
+  }
+  if (to.major !== from.major) {
+    return refused6("newer-major", `the installed rafa ${installed} is a newer major than the project's ${recorded}; that move is rafa update latest`);
+  }
+  if (to.minor !== from.minor) {
+    return refused6("newer-minor", `the installed rafa ${installed} is a newer minor than the project's ${recorded}; that move is rafa update next`);
+  }
+  return order === 0 ? { kind: "same", to: installed } : { kind: "patch", from: recorded, to: installed };
+}
+var init_update_range = __esm(() => {
+  init_status();
+  init_version2();
+});
+
+// src/commands/update/current.ts
+function checkoutLockRoot(root, dir) {
+  const run = Bun.spawnSync(["git", "rev-parse", "--show-toplevel"], { cwd: dir, stdout: "pipe", stderr: "pipe" });
+  if (run.exitCode !== 0)
+    return root;
+  const top = run.stdout.toString().trim();
+  return top !== "" && mainCheckoutOf(top) === root ? top : root;
+}
+function readSwitch4(context, name2) {
+  const value = context.flags[name2];
+  if (value === undefined || value === false || value === "false")
+    return false;
+  if (value === true || value === "true")
+    return true;
+  throw new CommandExit(1, `\u274C --${name2} takes no value, and read "${String(value)}" as one
+Usage: ${USAGE47}`);
+}
+function couldNotRun(problem2) {
+  return new CommandExit(2, `FAIL \u2014 ${problem2}
+nothing was changed.`);
+}
+function projectOf17(context) {
+  if (context.project === null)
+    throw new Error("rafa update current runs inside a project, and was handed none");
+  return context.project;
+}
+function boardAccess(project, seams) {
+  let configured;
+  try {
+    configured = loadConfig({ root: project.root, home: project.home }, {}, () => {}).config.prProvider;
+  } catch (error) {
+    throw couldNotRun(`config: ${messageOf(error)}`);
+  }
+  const provider = resolvePrProvider({ configured, dir: project.root, readRemote: seams.readRemote }).provider;
+  return provider === "gh" ? { gh: seams.openGh(project.root), reason: "" } : { gh: null, reason: `pr.provider is ${provider}, so there is no GitHub board` };
+}
+function foldersText(plan2) {
+  if (plan2.folders.length === 0)
+    return "nothing missing";
+  return `create ${plan2.folders.join(", ")}`;
+}
+function boardText2(plan2) {
+  if (plan2.board.kind === "skipped")
+    return `skipped: ${plan2.board.reason}`;
+  if (plan2.board.missing.length === 0)
+    return "every label present";
+  return `create labels ${plan2.board.missing.join(", ")}`;
+}
+function deprecationsText(plan2) {
+  if (plan2.deprecations.length === 0)
+    return "none registered yet (#718)";
+  return `${String(plan2.deprecations.length)} to run`;
+}
+function lockText(plan2) {
+  const where = plan2.lockRoot === plan2.root ? "" : ` in ${plan2.lockRoot}`;
+  if (plan2.lock === "unchanged")
+    return `unchanged at ${plan2.to}${where}`;
+  if (plan2.lock === "created")
+    return `create at ${plan2.to}${where}`;
+  return `update ${String(plan2.from)} \u2192 ${plan2.to}${where}`;
+}
+function planLines2(plan2) {
+  const from = plan2.from ?? `no ${LOCK_FILE}`;
+  return [
+    `rafa update current: ${plan2.root}, from ${from} to ${plan2.to}`,
+    `  folders       ${foldersText(plan2)}`,
+    `  board         ${boardText2(plan2)}`,
+    `  deprecations  ${deprecationsText(plan2)}`,
+    `  ${LOCK_FILE}     ${lockText(plan2)}`
+  ];
+}
+function appliedLines(applied, plan2, context) {
+  for (const path9 of applied.folders)
+    context.output.info(`created ${path9}`);
+  for (const part of applied.labels) {
+    if (part.outcome === "created")
+      context.output.info(`created label ${part.name}`);
+    if (part.outcome === "refused")
+      context.output.warn(`label ${part.name} was not created: ${part.detail}`);
+  }
+  if (applied.lock !== "unchanged")
+    context.output.info(`wrote ${LOCK_FILE} at ${plan2.to}`);
+}
+async function confirmed3(yes, seams) {
+  if (yes)
+    return true;
+  if (!seams.isTerminal()) {
+    throw new CommandExit(1, "REFUSED \u2014 rafa update current asks before it changes anything, and there is no" + " terminal to ask on. Run it with --dry-run to see the changes, then with --yes to apply them." + `
+nothing was changed.`);
+  }
+  const prompter = seams.openPrompter();
+  try {
+    const answer5 = await prompter.ask(APPLY_QUESTION);
+    return answer5 !== null && YES_ANSWERS7.includes(answer5.trim().toLowerCase());
+  } finally {
+    prompter.close();
+  }
+}
+function readRange2(root, installed) {
+  let recorded;
+  try {
+    recorded = readProjectLock(root)?.rafa ?? null;
+  } catch (error) {
+    throw couldNotRun(messageOf(error));
+  }
+  const range = readCurrentRange(recorded, installed);
+  if (range.kind === "refused")
+    throw new CommandExit(1, `REFUSED \u2014 ${range.message}
+nothing was changed.`);
+  return range;
+}
+function refuseConflicts(project) {
+  const conflicts2 = scaffoldConflicts(project.root, project.home);
+  if (conflicts2.length === 0)
+    return;
+  throw couldNotRun(`the project scope cannot be written:
+${conflicts2.map((conflict) => `  ${conflict}`).join(`
+`)}`);
+}
+function stoppedPartWay(error) {
+  const kept = error.written.length === 0 ? "Nothing was written before it." : `Already written, and kept: ${error.written.join(", ")}.`;
+  return new CommandExit(2, `FAIL \u2014 ${error.step}: ${error.message}
+stopped part-way. ${kept}` + `
+Fix the cause and run rafa update current again: each step writes only what is missing.`);
+}
+async function applyAndReport(plan2, gh, context) {
+  let applied;
+  try {
+    applied = await applyUpdatePlan(plan2, gh);
+  } catch (error) {
+    if (error instanceof UpdateStepError)
+      throw stoppedPartWay(error);
+    throw error;
+  }
+  appliedLines(applied, plan2, context);
+  return applied;
+}
+function refusedLabels(applied) {
+  const refused7 = applied.labels.filter((part) => part.outcome === "refused");
+  if (refused7.length === 0)
+    return null;
+  return new CommandExit(1, `${String(refused7.length)} board label(s) were not created; everything else was applied.` + " Run rafa update current again once gh can create them.");
+}
+function stopLine2(plan2, dryRun) {
+  if (!planChanges(plan2))
+    return "Nothing to change.";
+  if (dryRun)
+    return "Dry run: nothing was written. Run rafa update current to apply it.";
+  return null;
+}
+async function runUpdateCurrent(context, seams) {
+  expectNoArgument(context.args, USAGE47);
+  const dryRun = readSwitch4(context, "dry-run");
+  const yes = readSwitch4(context, "yes");
+  const project = projectOf17(context);
+  const lockRoot = seams.lockRootOf(project.root);
+  const range = readRange2(lockRoot, seams.installed);
+  refuseConflicts(project);
+  const access = boardAccess(project, seams);
+  const plan2 = await readUpdatePlan({ root: project.root, lockRoot }, range, access);
+  for (const line of planLines2(plan2))
+    context.output.info(line);
+  const finish2 = (applied2) => {
+    if (context.outputMode === "json")
+      context.output.result({ plan: plan2, applied: applied2 });
+  };
+  const stop = stopLine2(plan2, dryRun);
+  if (stop !== null) {
+    context.output.info(stop);
+    finish2(null);
+    return;
+  }
+  context.output.warn("rafa cannot roll these changes back. Run it with --dry-run first to only see them.");
+  if (!await confirmed3(yes, seams)) {
+    context.output.info("Nothing was changed.");
+    finish2(null);
+    return;
+  }
+  const applied = await applyAndReport(plan2, access.gh, context);
+  finish2(applied);
+  const refusal16 = refusedLabels(applied);
+  if (refusal16 !== null)
+    throw refusal16;
+}
+function createUpdateCurrentCommand(seams = DEFAULT_UPDATE_CURRENT_SEAMS) {
+  const command = {
+    name: "update current",
+    subject: "update",
+    action: "current",
+    summary: "bring this project to the installed rafa, within its patch range",
+    description: "Brings the project to the installed rafa when the installed version shares the major and" + ` minor of the version \`${LOCK_FILE}\` records at the project root, and is the same patch or newer.` + " A project with no lock is adopted at the installed version. It creates the missing `.rafa/` folders" + " and the missing board labels on a GitHub board, runs the deprecations step (none registered yet)," + ` and writes \`${LOCK_FILE}\`. It prints every change first; \`--dry-run\` stops there. Otherwise it` + " warns that the changes cannot be rolled back and asks once, `--yes` answering; with no terminal and" + " no `--yes` it refuses with exit code 1. A newer minor or major, or an installed rafa older than the" + " lock, refuses with exit code 1, and so does a board label `gh` would not create, once everything" + " else is applied. A lock or config that cannot be read, or a `.rafa/` path holding something else," + " exits 2 before anything is asked; a folder or the lock that cannot be written exits 2 naming the" + " step and what was already written. In a linked worktree the lock is the worktree's, on its branch." + " With `--output=json` the plan and what was applied are the data of the terminal result event.",
+    args: [],
+    flags: [
+      { name: "dry-run", description: "Print every change and write nothing.", type: "boolean" },
+      { name: "yes", description: "Apply the changes without asking.", type: "boolean" }
+    ],
+    examples: [
+      { cmd: "rafa update current --dry-run", note: "Lists the folders, labels and lock it would write, and writes nothing." },
+      { cmd: "rafa update current --yes", note: "Applies them without asking, as a script or a loop host runs it." }
+    ],
+    outputs: ["text", "json"],
+    run: async (context) => runUpdateCurrent(context, seams)
+  };
+  return Object.freeze(command);
+}
+var USAGE47 = "rafa update current [--dry-run] [--yes]", APPLY_QUESTION = "Apply these changes? [y/N] ", YES_ANSWERS7, DEFAULT_UPDATE_CURRENT_SEAMS, current_default2;
+var init_current2 = __esm(() => {
+  init_github();
+  init_command();
+  init_confirm();
+  init_version();
+  init_config_load();
+  init_config_sections();
+  init_provider();
+  init_lock();
+  init_scaffold();
+  init_update_current();
+  init_update_range();
+  init_worktree_root();
+  init_project_id();
+  init_plan_files();
+  YES_ANSWERS7 = ["y", "yes"];
+  DEFAULT_UPDATE_CURRENT_SEAMS = Object.freeze({
+    installed: RAFA_VERSION,
+    openGh: (root) => createGhRunner({ cwd: root }),
+    readRemote: gitRemoteUrl,
+    isTerminal: () => process.stdin.isTTY === true,
+    openPrompter: () => createLinePrompter(process.stdin, process.stderr),
+    lockRootOf: (root) => checkoutLockRoot(root, process.cwd())
+  });
+  current_default2 = createUpdateCurrentCommand();
+});
+
+// src/commands/update/latest.ts
+var latest_default;
+var init_latest = __esm(() => {
+  init_stub();
+  latest_default = createUpdateStub({ action: "latest", summary: "move this project to the newest version", issue: 716 });
+});
+
+// src/commands/update/next.ts
+var next_default2;
+var init_next2 = __esm(() => {
+  init_stub();
+  next_default2 = createUpdateStub({ action: "next", summary: "move this project to the newest minor of its major", issue: 716 });
+});
+
+// src/commands/update/port.ts
+var port_default;
+var init_port = __esm(() => {
+  init_stub();
+  port_default = createUpdateStub({ action: "port", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+});
+
+// src/commands/update/project.ts
+var project_default;
+var init_project = __esm(() => {
+  init_stub();
+  project_default = createUpdateStub({ action: "project", summary: "move this project to a version, with its migrations", issue: 716 });
+});
+
+// src/commands/update/rafa.ts
+var rafa_default;
+var init_rafa = __esm(() => {
+  init_stub();
+  rafa_default = createUpdateStub({ action: "rafa", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+});
+
+// src/commands/update/self.ts
+var self_default;
+var init_self = __esm(() => {
+  init_stub();
+  self_default = createUpdateStub({ action: "self", summary: "update rafa itself, from npm, a pinned version or another source", issue: 715 });
+});
+
 // src/usage.ts
 async function usage(_args) {
   const pct = await getClaudeUsagePercent();
@@ -63928,6 +65241,14 @@ var init_commands2 = __esm(() => {
   init_show8();
   init_status4();
   init_switch();
+  init_board();
+  init_current2();
+  init_latest();
+  init_next2();
+  init_port();
+  init_project();
+  init_rafa();
+  init_self();
   init_usage2();
   CORE_SUBJECTS = Object.freeze([
     { name: "plan", summary: "create plans from specs; list, show and validate them; read their risk and needs" },
@@ -63942,7 +65263,8 @@ var init_commands2 = __esm(() => {
     { name: "release", summary: "read the release state of the project; settle the waiting fragments into a version; tag the commit that set it" },
     { name: "board", summary: "list the boards with their owner, epic count, and which is current and home" },
     { name: "epic", summary: "show one epic's issues as the Roadmap table; create an epic; defer or promote it; move an issue to it; close it through the gate or cancel it" },
-    { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" }
+    { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" },
+    { name: "update", summary: "bring this project to the installed rafa; the other updates are in development" }
   ]);
   CORE_COMMANDS = Object.freeze([
     create_default2,
@@ -64014,6 +65336,14 @@ var init_commands2 = __esm(() => {
     hand_default,
     accept_default,
     take_default,
+    current_default2,
+    self_default,
+    project_default,
+    rafa_default,
+    port_default,
+    board_default,
+    next_default2,
+    latest_default,
     status_default3,
     next_default,
     roadmap_default,
@@ -64029,7 +65359,7 @@ var init_commands2 = __esm(() => {
 });
 
 // src/rafa.ts
-import { homedir as homedir14 } from "os";
+import { homedir as homedir15 } from "os";
 
 // src/cli/dispatch.ts
 init_active();
@@ -64644,12 +65974,12 @@ init_config_sections();
 init_sessions();
 init_scope();
 init_sections2();
-import { mkdirSync as mkdirSync30, readFileSync as readFileSync79, renameSync as renameSync12, writeFileSync as writeFileSync31 } from "fs";
-import { dirname as dirname38, join as join98 } from "path";
+import { mkdirSync as mkdirSync30, readFileSync as readFileSync80, renameSync as renameSync12, writeFileSync as writeFileSync32 } from "fs";
+import { dirname as dirname39, join as join100 } from "path";
 var SEEN_FILE = "status-seen.json";
 var SEEN_VERSION = 1;
 function seenFilePath(root) {
-  return join98(scopeAt(root).dir, SEEN_FILE);
+  return join100(scopeAt(root).dir, SEEN_FILE);
 }
 function readSeenSessions(root, isAlive) {
   const sessions = {};
@@ -64704,7 +66034,7 @@ function asSnapshot(value) {
 function readSeenFile(root) {
   let text2;
   try {
-    text2 = readFileSync79(seenFilePath(root), "utf8");
+    text2 = readFileSync80(seenFilePath(root), "utf8");
   } catch {
     return null;
   }
@@ -64716,9 +66046,9 @@ function readSeenFile(root) {
 }
 function writeSeenFile(root, snapshot) {
   const file = seenFilePath(root);
-  mkdirSync30(dirname38(file), { recursive: true });
+  mkdirSync30(dirname39(file), { recursive: true });
   const temporary = `${file}.${String(process.pid)}.tmp`;
-  writeFileSync31(temporary, `${JSON.stringify(snapshot, null, 2)}
+  writeFileSync32(temporary, `${JSON.stringify(snapshot, null, 2)}
 `);
   renameSync12(temporary, file);
 }
@@ -64761,7 +66091,7 @@ function createStatusHook(seams = {}) {
 }
 
 // src/rafa.ts
-var modules = await loadInvocationModules({ cwd: process.cwd(), home: homedir14() });
+var modules = await loadInvocationModules({ cwd: process.cwd(), home: homedir15() });
 var { exitCode } = await dispatch(process.argv.slice(2), {
   registry: CORE_REGISTRY,
   renderHelp,