@open-tomato/rafa 0.21.0 → 0.22.0

package/dist/{index-pzpk59ma.js → index-e30zazs6.js}

@@ -31,6 +31,7 @@ import {
   gitRemoteUrl,
   interruptClaudeSessions,
   mergeFrontmatter,
+  moduleOfLabels,
   normalizeRemote,
   parseInstinct,
   planFilePath,
@@ -42,11 +43,12 @@ import {
   scanLayout,
   selectEffortStore,
   sqliteStorePath,
+  typeOfLabels,
   withSqliteStore,
   writeFrontmatter,
   writeInstinct,
   writeSqliteStore
-} from "./index-am92b8qp.js";
+} from "./index-ae290g0m.js";
 import {
   CHANGE_LEVELS,
   CONFIG_DEFAULTS,
@@ -5129,7 +5131,7 @@ async function report(args, repoRoot) {
 
 // package.json
 var name = "@open-tomato/rafa";
-var version = "0.21.0";
+var version = "0.22.0";
 
 // src/modules/manifest.ts
 var MANIFEST_VERSION = 1;
@@ -5672,6 +5674,690 @@ var planListCommand = {
 };
 var list_default = Object.freeze(planListCommand);
 
+// src/board/blocked.ts
+var SPEC_BLOCKED_LABEL = "spec:blocked";
+var BLOCKED_BY_FIELD = "Blocked by";
+var FENCE_LINE = /^ {0,3}(?:```|~~~)/u;
+var FIELD_LINE = /^ {0,3}(?:[-*+]\s+)?[*_]{0,2}blocked\s+by[*_]{0,2}\s*:(.*)$/iu;
+var ISSUE_ID = /#(\d+)/gu;
+var FOREIGN_ID = /[A-Za-z0-9][A-Za-z0-9-]*\/[A-Za-z0-9._-]+#\d+/gu;
+var REMEDY = `name them as "${BLOCKED_BY_FIELD}: #24 #26", or take the ${SPEC_BLOCKED_LABEL} label off`;
+function hasSpecBlockedLabel(labels) {
+  return labels.some((label) => label.trim().toLowerCase() === SPEC_BLOCKED_LABEL);
+}
+function findFieldLine(body) {
+  const lines = body.split(`
+`).map((line) => line.replace(/\r$/u, ""));
+  let fenced = false;
+  for (const [index, line] of lines.entries()) {
+    if (FENCE_LINE.test(line)) {
+      fenced = !fenced;
+      continue;
+    }
+    if (fenced)
+      continue;
+    const found = FIELD_LINE.exec(line);
+    if (found === null)
+      continue;
+    return { number: index + 1, text: (found[1] ?? "").trim() };
+  }
+  return null;
+}
+function idsIn(text) {
+  const found = [];
+  for (const match of text.matchAll(ISSUE_ID)) {
+    const id = Number(match[1]);
+    if (!Number.isSafeInteger(id) || id < 1 || found.includes(id))
+      continue;
+    found.push(id);
+  }
+  return found;
+}
+function foreignIn(text) {
+  const found = [];
+  for (const [token] of text.matchAll(FOREIGN_ID)) {
+    if (!found.includes(token))
+      found.push(token);
+  }
+  return found;
+}
+var NAMED_NOTHING = { ids: [], foreign: [] };
+function reading(kind, issue3, found, named, unknown) {
+  return {
+    kind,
+    issue: issue3,
+    line: found?.number ?? null,
+    text: found?.text ?? null,
+    blockers: named.ids,
+    foreign: named.foreign,
+    unknown
+  };
+}
+function readBlockedBy(issue3, body, known) {
+  const found = findFieldLine(body);
+  if (found === null)
+    return reading("no-line", issue3, null, NAMED_NOTHING, []);
+  const foreign = foreignIn(found.text);
+  const ids = idsIn(found.text.replace(FOREIGN_ID, " "));
+  const named = { ids, foreign };
+  if (ids.length === 0)
+    return reading("no-ids", issue3, found, named, []);
+  const unknown = known === undefined ? [] : ids.filter((id) => id !== issue3 && !known.has(id));
+  if (ids.includes(issue3))
+    return reading("self-reference", issue3, found, named, unknown);
+  if (unknown.length > 0)
+    return reading("unknown-issue", issue3, found, named, unknown);
+  return reading("blocked", issue3, found, named, unknown);
+}
+function nameIds(ids) {
+  return ids.map((id) => `#${String(id)}`).join(" ");
+}
+function faultClause(read) {
+  const at = `on line ${String(read.line ?? 0)}`;
+  if (read.kind === "no-line") {
+    return `is labelled ${SPEC_BLOCKED_LABEL} and its body carries no "${BLOCKED_BY_FIELD}:" line`;
+  }
+  if (read.kind === "no-ids" && read.foreign.length > 0) {
+    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming only issues on other repositories: ${read.foreign.join(" ")}`;
+  }
+  if (read.kind === "no-ids") {
+    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming no issue: "${read.text ?? ""}"`;
+  }
+  if (read.kind === "self-reference") {
+    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming itself`;
+  }
+  return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming ${nameIds(read.unknown)}, which the board has no issue for`;
+}
+function blockedFaultMessage(read) {
+  if (read.kind === "blocked") {
+    throw new TypeError(`board blocked: #${String(read.issue)} names ${nameIds(read.blockers)} and has no fault to report`);
+  }
+  return `#${String(read.issue)} ${faultClause(read)}; ${REMEDY}`;
+}
+
+// src/board/naming.ts
+import path from "path";
+var ID_PREFIX = "rafa";
+var BRANCH_PREFIX = "feat";
+var SPEC_EXTENSION = ".md";
+var NOTES_SUFFIX = "-notes";
+var MAX_SLUG_WORDS = 4;
+var MIN_SLUG_WORDS = 2;
+var FALLBACK_SLUG = "untitled";
+var STOP_WORDS = new Set([
+  "a",
+  "an",
+  "and",
+  "as",
+  "at",
+  "be",
+  "by",
+  "for",
+  "from",
+  "in",
+  "into",
+  "is",
+  "it",
+  "its",
+  "of",
+  "on",
+  "or",
+  "that",
+  "the",
+  "this",
+  "to",
+  "with"
+]);
+var CLAUSE_BREAK = /[,;:([\u2013\u2014]|\s-\s/u;
+var LEADING_ID = /^\s*#?rafa[-\s]?\d+\s*[-:.\u2013\u2014]?\s*/iu;
+var NON_WORD = /[^a-z0-9]+/gu;
+function requireIssueNumber(issue3) {
+  if (!Number.isInteger(issue3) || issue3 <= 0) {
+    throw new RangeError(`An issue number must be a positive integer, not ${String(issue3)}.`);
+  }
+  return issue3;
+}
+function wordsOf(title) {
+  return title.toLowerCase().replace(NON_WORD, " ").split(" ").filter((word) => word !== "");
+}
+function withoutStopWords(words) {
+  const kept = words.filter((word) => !STOP_WORDS.has(word));
+  return kept.length > 0 ? kept : words;
+}
+function slugFromTitle(title) {
+  const withoutId = title.replace(LEADING_ID, "");
+  const [firstClause = ""] = withoutId.split(CLAUSE_BREAK);
+  const whole = withoutStopWords(wordsOf(withoutId));
+  const clause = withoutStopWords(wordsOf(firstClause));
+  const chosen = clause.length >= MIN_SLUG_WORDS ? clause : whole;
+  if (chosen.length === 0)
+    return FALLBACK_SLUG;
+  return chosen.slice(0, MAX_SLUG_WORDS).join("-");
+}
+function boardId(issue3) {
+  return `${ID_PREFIX}-${requireIssueNumber(issue3)}`;
+}
+function planStub(issue3, title) {
+  return `${boardId(issue3)}-${slugFromTitle(title)}`;
+}
+function specFileName(issue3, title) {
+  return `${planStub(issue3, title)}${SPEC_EXTENSION}`;
+}
+function specPath(specsDir, issue3, title) {
+  return path.join(specsDir, specFileName(issue3, title));
+}
+function notesFileName(issue3) {
+  return `${boardId(issue3)}${NOTES_SUFFIX}${SPEC_EXTENSION}`;
+}
+function notesPath(specsDir, issue3) {
+  return path.join(specsDir, notesFileName(issue3));
+}
+
+// src/board/roadmap.ts
+var PREFIX = "board roadmap";
+var ROADMAP_TITLE = "Roadmap";
+var ROADMAP_SETTING = "roadmap.issue";
+var ROADMAP_REFUSAL_EXIT = 2;
+var DEFAULT_REMOTE = "origin";
+var OPEN_PULL_REQUEST_LIMIT = 100;
+var PR_LIST_FIELDS = "number,headRefName,body";
+var ISSUE_LIST_FIELDS = "number,title";
+var TASK_LINE = /^\s*[-*+]\s+\[([ xX])\]\s+#(\d+)\s*(.*)$/u;
+var FENCE = /^\s*(?:`{3,}|~{3,})/u;
+var WHY_SEPARATOR = /^[-:,.\u2013\u2014]\s*/u;
+var CLOSING = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\b\s*:?\s*#(\d+)\b/giu;
+function whyOf(rest) {
+  return rest.trim().replace(WHY_SEPARATOR, "").trim();
+}
+function parseRoadmapBody(body) {
+  let lines = [];
+  let fenced = false;
+  body.split(/\r\n?|\n/u).forEach((text, index) => {
+    if (FENCE.test(text)) {
+      fenced = !fenced;
+      return;
+    }
+    if (fenced)
+      return;
+    const found = TASK_LINE.exec(text);
+    if (found === null)
+      return;
+    const [, box = "", digits = "", rest = ""] = found;
+    const issue3 = Number.parseInt(digits, 10);
+    if (!Number.isSafeInteger(issue3) || issue3 < 1)
+      return;
+    lines = [...lines, {
+      issue: issue3,
+      ticked: box.trim() !== "",
+      why: whyOf(rest),
+      lineNumber: index + 1
+    }];
+  });
+  return Object.freeze(lines);
+}
+function detailOf(result, command) {
+  const written = result.stderr.trim() || result.stdout.trim();
+  return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
+}
+function parseRows(stdout, command) {
+  let payload;
+  try {
+    payload = JSON.parse(stdout);
+  } catch (error) {
+    throw new Error(`${PREFIX}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+  }
+  if (!Array.isArray(payload)) {
+    throw new Error(`${PREFIX}: ${command} answered ${describeValue(payload)}, expected a list`);
+  }
+  return payload;
+}
+function rowNumber(row, key, command, where) {
+  const value = isMapping(row) ? row[key] : null;
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1) {
+    throw new Error(`${PREFIX}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a positive whole number`);
+  }
+  return value;
+}
+function rowText(row, key, command, where) {
+  const value = isMapping(row) ? row[key] : null;
+  if (typeof value !== "string") {
+    throw new Error(`${PREFIX}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a string`);
+  }
+  return value;
+}
+function createGhRoadmapSearch(options) {
+  const { gh } = options;
+  const search = `${ROADMAP_TITLE} in:title`;
+  const args = ["issue", "list", "--state", "open", "--search", search, "--json", ISSUE_LIST_FIELDS];
+  const command = `gh issue list --state open --search "${search}" --json ${ISSUE_LIST_FIELDS}`;
+  return async () => {
+    const result = await gh(args);
+    if (!result.ok)
+      throw new Error(`${PREFIX}: ${detailOf(result, command)}`);
+    return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
+      number: rowNumber(row, "number", command, `issue ${String(index)}`),
+      title: rowText(row, "title", command, `issue ${String(index)}`)
+    })));
+  };
+}
+function noRoadmapMessage() {
+  return `no open issue is titled ${ROADMAP_TITLE}, so there is no roadmap to read;` + ` run rafa init --board to open one, or set ${ROADMAP_SETTING} to the issue that holds the order`;
+}
+function severalRoadmapsMessage(numbers) {
+  const named = numbers.map((number) => `#${String(number)}`).join(", ");
+  return `${String(numbers.length)} open issues are titled ${ROADMAP_TITLE} (${named}),` + ` so which one holds the order is not this command to guess; set ${ROADMAP_SETTING} to it`;
+}
+async function resolveRoadmapIssue(options) {
+  const { configured, search } = options;
+  if (configured !== null)
+    return configured;
+  const wanted = ROADMAP_TITLE.toLowerCase();
+  const titled = (await search()).filter((issue3) => issue3.title.trim().toLowerCase() === wanted);
+  if (titled.length === 0)
+    throw new CommandExit(ROADMAP_REFUSAL_EXIT, noRoadmapMessage());
+  if (titled.length > 1) {
+    throw new CommandExit(ROADMAP_REFUSAL_EXIT, severalRoadmapsMessage(titled.map((issue3) => issue3.number)));
+  }
+  return titled[0]?.number ?? 0;
+}
+function createGhOpenPullRequests(options) {
+  const { gh } = options;
+  const limit = String(OPEN_PULL_REQUEST_LIMIT);
+  const args = ["pr", "list", "--state", "open", "--json", PR_LIST_FIELDS, "--limit", limit];
+  const command = `gh pr list --state open --json ${PR_LIST_FIELDS} --limit ${limit}`;
+  return async () => {
+    const result = await gh(args);
+    if (!result.ok)
+      throw new Error(`${PREFIX}: ${detailOf(result, command)}`);
+    return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
+      number: rowNumber(row, "number", command, `pull request ${String(index)}`),
+      headRefName: rowText(row, "headRefName", command, `pull request ${String(index)}`),
+      body: rowText(row, "body", command, `pull request ${String(index)}`)
+    })));
+  };
+}
+function closedIssuesIn(body) {
+  return Object.freeze([...body.matchAll(CLOSING)].map((found) => Number.parseInt(found[1] ?? "", 10)).filter((issue3) => Number.isSafeInteger(issue3) && issue3 > 0));
+}
+function branchClaims(ref, issue3) {
+  const claim = `${BRANCH_PREFIX}/${boardId(issue3)}`;
+  return new RegExp(`(?:^|/)${claim}(?:-|$)`, "u").test(ref);
+}
+function outputLines(stdout) {
+  return stdout.split(`
+`).map((line) => line.trim()).filter((line) => line !== "");
+}
+function scanClaimBranches(git, remote = DEFAULT_REMOTE) {
+  const local = git(["for-each-ref", "--format=%(refname)", "refs/heads", "refs/remotes"]);
+  const pushed = git(["ls-remote", "--heads", remote]);
+  const localRefs = local.ok ? outputLines(local.stdout) : [];
+  const pushedRefs = pushed.ok ? outputLines(pushed.stdout).map((line) => line.split("\t").at(-1) ?? "") : [];
+  const problems = [
+    local.ok ? "" : `the branches of this checkout could not be read, so a branch held only here was not seen: ${detailOf(local, "git for-each-ref")}`,
+    pushed.ok ? "" : `the branches on ${remote} could not be read, so a branch pushed but not fetched was not seen: ${detailOf(pushed, `git ls-remote --heads ${remote}`)}`
+  ].filter((problem) => problem !== "");
+  return Object.freeze({
+    refs: Object.freeze([...localRefs, ...pushedRefs].filter((ref) => ref !== "")),
+    problems: Object.freeze(problems)
+  });
+}
+function createRoadmapReadings(options) {
+  const { issues, branches, pullRequests } = options;
+  let open = null;
+  return Object.freeze({
+    isClosed: async (issue3) => (await issues(issue3)).state === "CLOSED",
+    branchFor: (issue3) => branches.refs.find((ref) => branchClaims(ref, issue3)) ?? null,
+    pullRequestFor: async (issue3) => {
+      open = open ?? pullRequests();
+      const closing = (await open).find((pull) => closedIssuesIn(pull.body).includes(issue3));
+      return closing?.number ?? null;
+    }
+  });
+}
+function skipSentence(skip) {
+  const id = `#${String(skip.line.issue)}`;
+  if (skip.reason === "ticked")
+    return `${id} done: ticked on the roadmap`;
+  if (skip.reason === "closed")
+    return `${id} done: the issue is closed`;
+  return skip.reason === "branch" ? `${id} taken: branch ${skip.detail} exists` : `${id} taken: PR ${skip.detail} open`;
+}
+async function readRoadmapSkip(line, readings) {
+  if (line.ticked)
+    return { line, reason: "ticked", detail: "" };
+  if (await readings.isClosed(line.issue))
+    return { line, reason: "closed", detail: "" };
+  const branch = readings.branchFor(line.issue);
+  if (branch !== null)
+    return { line, reason: "branch", detail: branch };
+  const pull = await readings.pullRequestFor(line.issue);
+  return pull === null ? null : { line, reason: "pull-request", detail: `#${String(pull)}` };
+}
+async function pickNextRoadmapLine(lines, readings) {
+  let skipped2 = [];
+  for (const line of lines) {
+    const skip = await readRoadmapSkip(line, readings);
+    if (skip === null)
+      return Object.freeze({ line, skipped: Object.freeze(skipped2) });
+    skipped2 = [...skipped2, skip];
+  }
+  return Object.freeze({ line: null, skipped: Object.freeze(skipped2) });
+}
+function exhaustedMessage(roadmap, skipped2) {
+  const id = `issue #${String(roadmap)}`;
+  return skipped2.length === 0 ? `the roadmap, ${id}, carries no "- [ ] #<n>" line; add the next spec to its task list` : `every line of the roadmap, ${id}, is done or taken (${String(skipped2.length)} of them);` + " open the next spec issue and add it to the task list";
+}
+
+// src/board/epic-body.ts
+var ESTIMATE_FIELD = "Estimate";
+var DATE_FIELD = "Date";
+var OWNS_FIELD = "Owns";
+var DATE_SHAPE = "YYYY-MM-DD";
+var FENCE2 = /^\s*(?:`{3,}|~{3,})/u;
+var HEADING = /^ {0,3}(#{1,6})\s+(.*?)\s*#*\s*$/u;
+var CRITERIA_TITLE = /^acceptance\s+criteria\s*:?$/iu;
+var ISO_DAY = /^(\d{4})-(\d{2})-(\d{2})$/u;
+var OWNS_SEPARATOR = /[\s,]+/u;
+function bodyLines(body) {
+  let fenced = false;
+  return body.split(/\r\n?|\n/u).map((text) => {
+    if (FENCE2.test(text)) {
+      fenced = !fenced;
+      return { text, fenced: true };
+    }
+    return { text, fenced };
+  });
+}
+function fieldPattern(name2) {
+  return new RegExp(`^ {0,3}(?:[-*+]\\s+)?[*_]{0,2}${name2}[*_]{0,2}\\s*:[*_]{0,2}(.*)$`, "iu");
+}
+function findField(lines, name2) {
+  const pattern = fieldPattern(name2);
+  for (const [index, line] of lines.entries()) {
+    if (line.fenced)
+      continue;
+    const found = pattern.exec(line.text);
+    if (found !== null)
+      return { number: index + 1, text: (found[1] ?? "").trim() };
+  }
+  return null;
+}
+function headingLevel(line) {
+  if (line.fenced)
+    return 0;
+  return HEADING.exec(line.text)?.[1]?.length ?? 0;
+}
+function findCriteria(lines) {
+  const start = lines.findIndex((line) => headingLevel(line) > 0 && CRITERIA_TITLE.test(HEADING.exec(line.text)?.[2] ?? ""));
+  const opening = lines[start];
+  if (opening === undefined)
+    return null;
+  const level = headingLevel(opening);
+  const after = lines.slice(start + 1);
+  const end = after.findIndex((line) => {
+    const found = headingLevel(line);
+    return found > 0 && found <= level;
+  });
+  const section = end === -1 ? after : after.slice(0, end);
+  return {
+    number: start + 1,
+    text: section.map((line) => line.text).join(`
+`).trim()
+  };
+}
+function isCalendarDay(text) {
+  const found = ISO_DAY.exec(text);
+  if (found === null)
+    return false;
+  const [, year = "", month = "", day = ""] = found;
+  const date = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+  return date.toISOString().slice(0, DATE_SHAPE.length) === text;
+}
+function ownedFolders(text) {
+  const named = text.replaceAll("`", " ").split(OWNS_SEPARATOR).filter((folder) => folder !== "");
+  return [...new Set(named)];
+}
+function absent(kind, found) {
+  return { kind, line: found?.number ?? null, text: found?.text ?? null };
+}
+function readEpicBody(body) {
+  const lines = bodyLines(body);
+  const criteria = findCriteria(lines);
+  const estimate = findField(lines, ESTIMATE_FIELD);
+  const date = findField(lines, DATE_FIELD);
+  const owns = findField(lines, OWNS_FIELD);
+  const hasCriteria = criteria !== null && criteria.text !== "";
+  const hasEstimate = estimate !== null && estimate.text !== "";
+  const isDated = date !== null && isCalendarDay(date.text);
+  const problems = [
+    hasCriteria ? null : absent("no-criteria", criteria),
+    hasEstimate ? null : absent("no-estimate", estimate),
+    date === null || isDated ? null : { kind: "malformed-date", line: date.number, text: date.text }
+  ];
+  return Object.freeze({
+    criteria: hasCriteria ? criteria.text : null,
+    estimate: hasEstimate ? estimate.text : null,
+    date: isDated ? date.text : null,
+    owns: Object.freeze(owns === null ? [] : ownedFolders(owns.text)),
+    lines: parseRoadmapBody(body),
+    problems: Object.freeze(problems.filter((problem) => problem !== null))
+  });
+}
+
+// src/board/epics.ts
+var EPIC_LABEL_PREFIX = "epic:";
+var NOT_PLANNED_REASON = "NOT_PLANNED";
+var NO_REASON = "the board listing failed and gave no reason";
+var NO_PROGRESS = Object.freeze({ done: 0, total: 0, notPlanned: 0 });
+function epicSlugsOf(labels) {
+  const slugs = labels.filter((label) => label.startsWith(EPIC_LABEL_PREFIX)).map((label) => label.slice(EPIC_LABEL_PREFIX.length));
+  return Object.freeze([...new Set(slugs)]);
+}
+function isNotPlanned(issue3) {
+  return issue3.state === "CLOSED" && issue3.stateReason === NOT_PLANNED_REASON;
+}
+function groupByEpicLabel(issues) {
+  const groups = new Map;
+  const sorted = [...issues].sort((left, right) => left.number - right.number);
+  for (const issue3 of sorted) {
+    if (issue3.type === "epic")
+      continue;
+    for (const slug of epicSlugsOf(issue3.labels)) {
+      groups.set(slug, [...groups.get(slug) ?? [], issue3]);
+    }
+  }
+  return groups;
+}
+function progressOf(members) {
+  const counted = members.filter((member) => !isNotPlanned(member));
+  return Object.freeze({
+    done: counted.filter((member) => member.state === "CLOSED").length,
+    total: counted.length,
+    notPlanned: members.length - counted.length
+  });
+}
+function countedStarted(members, claims) {
+  return members.some((member) => !isNotPlanned(member) && (member.state === "CLOSED" || claims.has(member.number)));
+}
+function computedState(members, progress, claims) {
+  if (members.length === 0)
+    return "empty";
+  if (progress.total > 0 && progress.done === progress.total)
+    return "done";
+  return countedStarted(members, claims) ? "in-progress" : "backlog";
+}
+function storedState(epic, members, claims) {
+  if (epic.state === "OPEN")
+    return "open";
+  if (!isNotPlanned(epic))
+    return "closed";
+  const started = countedStarted(members, claims) || members.some((member) => claims.has(member.number));
+  return started ? "cancelled" : "discarded";
+}
+function disagreementOf(number, state, stored) {
+  const id = `epic #${String(number)}`;
+  if (state === "done" && stored === "open")
+    return `done, but ${id} is still open`;
+  if (state !== "done" && state !== "unknown" && stored === "closed")
+    return `${state}, but ${id} is closed`;
+  return null;
+}
+function localDay(date) {
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${String(date.getFullYear())}-${month}-${day}`;
+}
+function ownersOf(blocker, view) {
+  if (blocker.type === "epic")
+    return [blocker.number];
+  return epicSlugsOf(blocker.labels).flatMap((slug) => view.epicsBySlug.get(slug) ?? []);
+}
+function blockedByOf(self, members, view) {
+  const owners = members.filter((member) => member.state === "OPEN").map((member) => readBlockedBy(member.number, member.body, view.known)).filter((reading2) => reading2.kind === "blocked").flatMap((reading2) => reading2.blockers).map((blocker) => view.byNumber.get(blocker)).filter((blocker) => blocker?.state === "OPEN").flatMap((blocker) => ownersOf(blocker, view)).filter((owner) => owner !== self);
+  return Object.freeze([...new Set(owners)].sort((left, right) => left - right));
+}
+function epicOf(epic, view) {
+  const slug = epicSlugsOf(epic.labels)[0] ?? null;
+  const members = slug === null ? [] : view.groups.get(slug) ?? [];
+  const body = readEpicBody(epic.body);
+  const progress = progressOf(members);
+  const state = computedState(members, progress, view.claims);
+  const stored = storedState(epic, members, view.claims);
+  return Object.freeze({
+    number: epic.number,
+    title: epic.title,
+    slug,
+    body,
+    members: Object.freeze([...members]),
+    state,
+    reason: null,
+    progress,
+    blockedBy: blockedByOf(epic.number, members, view),
+    late: body.date !== null && body.date < view.today && state !== "done",
+    stored,
+    disagreement: disagreementOf(epic.number, state, stored)
+  });
+}
+function readEpics(input) {
+  if (input.issues === null) {
+    return Object.freeze({ epics: Object.freeze([]), unknown: input.reason ?? NO_REASON });
+  }
+  const epicIssues = input.issues.filter((issue3) => issue3.type === "epic").sort((left, right) => left.number - right.number);
+  const epicsBySlug = new Map;
+  for (const epic of epicIssues) {
+    const slug = epicSlugsOf(epic.labels)[0];
+    if (slug !== undefined)
+      epicsBySlug.set(slug, [...epicsBySlug.get(slug) ?? [], epic.number]);
+  }
+  const view = {
+    groups: groupByEpicLabel(input.issues),
+    byNumber: new Map(input.issues.map((issue3) => [issue3.number, issue3])),
+    epicsBySlug,
+    known: new Set(input.issues.map((issue3) => issue3.number)),
+    claims: input.claims,
+    today: localDay(input.today)
+  };
+  return Object.freeze({
+    epics: Object.freeze(epicIssues.map((epic) => epicOf(epic, view))),
+    unknown: null
+  });
+}
+
+// src/board/epic-problems.ts
+var HORIZON_LABEL_PREFIX = "horizon:";
+var EPIC_PROBLEM_KINDS = Object.freeze([
+  "several-epic-labels",
+  "orphan-label",
+  "horizon",
+  "unlabelled-checklist",
+  "unlisted-member"
+]);
+function byNumber(issues) {
+  return [...issues].sort((left, right) => left.number - right.number);
+}
+function severalEpicLabels(issues) {
+  return issues.flatMap((issue3) => {
+    const slugs = epicSlugsOf(issue3.labels);
+    const [slug] = slugs;
+    return slug === undefined || slugs.length < 2 ? [] : [{ kind: "several-epic-labels", issue: issue3.number, slug, slugs }];
+  });
+}
+function orphanLabels(groups, owned) {
+  return [...groups.entries()].filter(([slug]) => !owned.has(slug)).flatMap(([slug, carriers]) => carriers.map((carrier) => ({
+    kind: "orphan-label",
+    issue: carrier.number,
+    slug
+  })));
+}
+function horizons(epics) {
+  return epics.flatMap((epic) => {
+    const found = epic.labels.filter((label) => label.startsWith(HORIZON_LABEL_PREFIX));
+    return found.length === 1 ? [] : [{
+      kind: "horizon",
+      issue: epic.number,
+      slug: epicSlugsOf(epic.labels)[0] ?? null,
+      horizons: Object.freeze(found)
+    }];
+  });
+}
+function orderProblems(epic, slug, listed, members) {
+  const lines = parseRoadmapBody(epic.body);
+  const named = new Set(lines.map((line) => line.issue));
+  const seen = new Set;
+  const unlabelled = lines.flatMap((line) => {
+    const spec = listed.get(line.issue);
+    if (seen.has(line.issue) || spec === undefined || spec.type === "epic")
+      return [];
+    seen.add(line.issue);
+    return epicSlugsOf(spec.labels).includes(slug) ? [] : [{ kind: "unlabelled-checklist", issue: line.issue, slug, epic: epic.number, lineNumber: line.lineNumber }];
+  });
+  const unlisted = members.filter((member) => member.type !== "bug" && !named.has(member.number)).map((member) => ({ kind: "unlisted-member", issue: member.number, slug, epic: epic.number }));
+  return [...unlabelled, ...unlisted];
+}
+function compareProblems(left, right) {
+  const kind = EPIC_PROBLEM_KINDS.indexOf(left.kind) - EPIC_PROBLEM_KINDS.indexOf(right.kind);
+  if (kind !== 0)
+    return kind;
+  if (left.issue !== right.issue)
+    return left.issue - right.issue;
+  return (left.slug ?? "").localeCompare(right.slug ?? "");
+}
+function readEpicProblems(issues) {
+  const sorted = byNumber(issues);
+  const epics = sorted.filter((issue3) => issue3.type === "epic");
+  const groups = groupByEpicLabel(sorted);
+  const listed = new Map(sorted.map((issue3) => [issue3.number, issue3]));
+  const owned = new Set(epics.flatMap((epic) => epicSlugsOf(epic.labels).slice(0, 1)));
+  const order = epics.flatMap((epic) => {
+    const slug = epicSlugsOf(epic.labels)[0];
+    return slug === undefined ? [] : orderProblems(epic, slug, listed, groups.get(slug) ?? []);
+  });
+  const problems = [
+    ...severalEpicLabels(sorted),
+    ...orphanLabels(groups, owned),
+    ...horizons(epics),
+    ...order
+  ].sort(compareProblems);
+  return Object.freeze(problems);
+}
+function epicProblemMessage(problem) {
+  const id = `#${String(problem.issue)}`;
+  switch (problem.kind) {
+    case "several-epic-labels": {
+      const labels = problem.slugs.map((slug) => `${EPIC_LABEL_PREFIX}${slug}`).join(", ");
+      return `${id} carries ${String(problem.slugs.length)} epic labels (${labels}); an issue belongs to one epic, so remove all but one`;
+    }
+    case "orphan-label":
+      return `${id} carries ${EPIC_LABEL_PREFIX}${problem.slug}, which no type:epic issue carries; fix the slug or open the epic`;
+    case "horizon":
+      return problem.horizons.length === 0 ? `epic ${id} carries no ${HORIZON_LABEL_PREFIX} label; add one of horizon:now, horizon:next or horizon:later` : `epic ${id} carries ${String(problem.horizons.length)} horizon labels (${problem.horizons.join(", ")}); keep one`;
+    case "unlabelled-checklist":
+      return `${id} is on epic #${String(problem.epic)}'s checklist on line ${String(problem.lineNumber)}` + ` but does not carry ${EPIC_LABEL_PREFIX}${problem.slug}; label it or take it off the checklist`;
+    case "unlisted-member":
+      return `${id} carries ${EPIC_LABEL_PREFIX}${problem.slug} but is not on epic #${String(problem.epic)}'s checklist;` + " it is walked last, by issue number, until it is added";
+  }
+}
+
 // src/board/gate.ts
 import { existsSync as existsSync13, mkdirSync as mkdirSync3, readFileSync as readFileSync11, renameSync as renameSync2, statSync as statSync5, writeFileSync as writeFileSync4 } from "fs";
 import { basename as basename5, dirname as dirname7, join as join10, resolve as resolve6 } from "path";
@@ -5704,7 +6390,7 @@ var LIST_HEADINGS = [
 var PREAMBLE_HEADING = "the opening";
 var MARKER_PREFIX = "rafa:";
 var HEADING_LINE = /^ {0,3}(#{1,6})\s+(.*)$/u;
-var FENCE_LINE = /^ {0,3}(?:```|~~~)/u;
+var FENCE_LINE2 = /^ {0,3}(?:```|~~~)/u;
 var LIST_ITEM = /^ {0,3}(?:[-*+]|\d+[.)])\s+\S/u;
 var CODE_SPAN2 = /`[^`]*`/gu;
 var CODE_TICK = "`";
@@ -5717,7 +6403,7 @@ var PLACEHOLDER_SHAPES = [
   { token: "TODO", pattern: /\bTODO\b/u },
   { token: "???", pattern: /\?{3,}/u }
 ];
-var REMEDY = "fill each gap in the spec and rerun";
+var REMEDY2 = "fill each gap in the spec and rerun";
 function codeSpanEnd(text, limit) {
   const open = text.indexOf(CODE_TICK);
   if (open === -1 || open > limit)
@@ -5783,7 +6469,7 @@ function readLines2(body) {
   let fenced = false;
   raw.forEach((text, index) => {
     const number = index + 1;
-    const isFence = FENCE_LINE.test(text);
+    const isFence = FENCE_LINE2.test(text);
     if (fenced || !carried && isFence) {
       fenced = !fenced || !isFence;
       lines.push(fencedLine(number, text));
@@ -5914,7 +6600,7 @@ function readinessRefusalMessage(source, gaps) {
     throw new TypeError(`board readiness: ${source} carries no gap, and has no refusal to name`);
   }
   const named = gaps.map(describeGap).join(", ");
-  return `${source} is not ready to plan from: ${named}; ${REMEDY}`;
+  return `${source} is not ready to plan from: ${named}; ${REMEDY2}`;
 }
 function requireCompleteSpec(source, body) {
   const gaps = findReadinessGaps(body);
@@ -5927,13 +6613,13 @@ function requireCompleteSpec(source, body) {
 var REPO_PATH = "{owner}/{repo}";
 var TRUSTED_PERMISSIONS = ["admin", "maintain", "write"];
 var TRUST_REFUSAL_EXIT = 2;
-var REMEDY2 = Object.freeze({
+var REMEDY3 = Object.freeze({
   issue: "a member must open the spec",
   "pull request": "a member must open the pull request"
 });
 var UNREPORTED = "the lookup wrote nothing";
-function failureDetail(reading) {
-  const detail = reading.permission?.detail ?? "";
+function failureDetail(reading2) {
+  const detail = reading2.permission?.detail ?? "";
   return detail === "" ? UNREPORTED : detail;
 }
 function isTrustedPermission(value) {
@@ -5945,7 +6631,7 @@ function stringOrNull(value) {
 function lookupFailed(login, detail) {
   return { login, permission: null, roleName: null, detail };
 }
-function detailOf(result, command) {
+function detailOf2(result, command) {
   const written = result.stderr.trim() || result.stdout.trim();
   return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
 }
@@ -5955,11 +6641,11 @@ function createGhPermissions(options) {
     if (!isGitHubLogin(login)) {
       return lookupFailed(login, `${describeValue(login)} is not a GitHub login, so no permission was read`);
     }
-    const path = `repos/${REPO_PATH}/collaborators/${login}/permission`;
-    const command = `gh api ${path}`;
-    const result = await gh(["api", path]);
+    const path2 = `repos/${REPO_PATH}/collaborators/${login}/permission`;
+    const command = `gh api ${path2}`;
+    const result = await gh(["api", path2]);
     if (!result.ok)
-      return lookupFailed(login, detailOf(result, command));
+      return lookupFailed(login, detailOf2(result, command));
     let payload;
     try {
       payload = JSON.parse(result.stdout);
@@ -6019,25 +6705,25 @@ function readBoardTrust(trust, login) {
   });
 }
 async function requireTrustedBoardAuthor(item, trust, login) {
-  const reading = await readBoardTrust(trust, login);
-  requireTrustedAuthor({ kind: item.kind, number: item.number, repo: trust.repo }, reading);
-  return reading;
+  const reading2 = await readBoardTrust(trust, login);
+  requireTrustedAuthor({ kind: item.kind, number: item.number, repo: trust.repo }, reading2);
+  return reading2;
 }
-function trustRefusalClause(repo, reading) {
-  if (reading.trusted) {
-    throw new TypeError(`board trust: ${reading.login} is trusted, and has no refusal to name`);
+function trustRefusalClause(repo, reading2) {
+  if (reading2.trusted) {
+    throw new TypeError(`board trust: ${reading2.login} is trusted, and has no refusal to name`);
   }
-  return reading.refusal === "lookup-failed" ? `whose write access to ${repo} could not be read (${failureDetail(reading)})` : `who has no write access to ${repo}`;
+  return reading2.refusal === "lookup-failed" ? `whose write access to ${repo} could not be read (${failureDetail(reading2)})` : `who has no write access to ${repo}`;
 }
-function trustRefusalMessage(item, reading) {
-  const because = trustRefusalClause(item.repo, reading);
-  const opened = `${item.kind} #${String(item.number)} was opened by ${reading.login}`;
-  return `${opened}, ${because}; ${REMEDY2[item.kind]}`;
+function trustRefusalMessage(item, reading2) {
+  const because = trustRefusalClause(item.repo, reading2);
+  const opened = `${item.kind} #${String(item.number)} was opened by ${reading2.login}`;
+  return `${opened}, ${because}; ${REMEDY3[item.kind]}`;
 }
-function requireTrustedAuthor(item, reading) {
-  if (reading.trusted)
+function requireTrustedAuthor(item, reading2) {
+  if (reading2.trusted)
     return;
-  throw new CommandExit(TRUST_REFUSAL_EXIT, trustRefusalMessage(item, reading));
+  throw new CommandExit(TRUST_REFUSAL_EXIT, trustRefusalMessage(item, reading2));
 }
 
 // src/board/review-comment.ts
@@ -6080,21 +6766,21 @@ function assumedReviewCommentBody(gaps) {
 function specReviewComments(comments) {
   return [...comments].reverse().filter((comment) => comment.body.includes(SPEC_REVIEW_MARKER));
 }
-function ignoredReviewCommentMessage(comment, reading, repo) {
-  const who = `was written by ${reading.login}, ${trustRefusalClause(repo, reading)}`;
+function ignoredReviewCommentMessage(comment, reading2, repo) {
+  const who = `was written by ${reading2.login}, ${trustRefusalClause(repo, reading2)}`;
   return `the ${SPEC_REVIEW_COMMENT_NAME} comment ${comment.id} ${who};` + " it was left alone and the gaps went in a comment of their own";
 }
 async function readTrustedSpecReviewComment(comments, trust) {
   const trustOf = memoisedTrust(trust);
   const ignored = [];
   for (const comment of specReviewComments(comments)) {
-    const reading = await trustOf(comment.author);
-    if (reading.trusted)
+    const reading2 = await trustOf(comment.author);
+    if (reading2.trusted)
       return { comment, ignored };
     ignored.push({
       id: comment.id,
       author: comment.author,
-      reason: ignoredReviewCommentMessage(comment, reading, trust.repo)
+      reason: ignoredReviewCommentMessage(comment, reading2, trust.repo)
     });
   }
   return { comment: null, ignored };
@@ -6235,50 +6921,50 @@ function describeGap2(gap) {
 function remedyFor(issue3) {
   return issue3 === null ? "   Close the gaps in the spec, then plan from it again." : `   Close the gaps, label the issue ${SPEC_READY_LABEL} again, and plan from it again.`;
 }
-function specNotReadyMessage(source, reading, gaps, issue3 = null) {
+function specNotReadyMessage(source, reading2, gaps, issue3 = null) {
   return [
-    `\u274C ${source} is not ready to plan from: ${reading}`,
+    `\u274C ${source} is not ready to plan from: ${reading2}`,
     ...gaps.map(describeGap2),
     remedyFor(issue3)
   ].join(`
 `);
 }
-function unreadReviewWarning(reading, planPath) {
-  return `${reading}; ${planPath} reads as written, so the plan stands unreviewed`;
+function unreadReviewWarning(reading2, planPath) {
+  return `${reading2}; ${planPath} reads as written, so the plan stands unreviewed`;
 }
-function assumedReviewWarning(reading, planPath) {
-  return `${reading}, none of them blocking; ${planPath} is written under the assumptions the review named`;
+function assumedReviewWarning(reading2, planPath) {
+  return `${reading2}, none of them blocking; ${planPath} is written under the assumptions the review named`;
 }
-function unreadReviewMessage(source, reading, planIssues) {
+function unreadReviewMessage(source, reading2, planIssues) {
   return [
-    `\u274C ${source}: no plan stands \u2014 ${reading}, and the plan the session wrote does not read as written:`,
+    `\u274C ${source}: no plan stands \u2014 ${reading2}, and the plan the session wrote does not read as written:`,
     ...planIssues.map((line) => `   ${line}`),
     "   Plan from the spec again."
   ].join(`
 `);
 }
-function isWrittenFile(repoRoot, path) {
-  const full = resolve6(repoRoot, path);
+function isWrittenFile(repoRoot, path2) {
+  const full = resolve6(repoRoot, path2);
   return existsSync13(full) && statSync5(full).isFile();
 }
 var NOT_READY_REASON = "the planner judged the spec not ready, so no plan stands.";
 var UNREAD_REASON = "no review came back and the plan does not read as written, so no plan stands.";
 var REJECTED_DIR = "rejected";
-function rejectedPath(path) {
-  const parent = dirname7(path);
-  return parent === "." ? join10(REJECTED_DIR, basename5(path)) : join10(parent, REJECTED_DIR, basename5(path));
+function rejectedPath(path2) {
+  const parent = dirname7(path2);
+  return parent === "." ? join10(REJECTED_DIR, basename5(path2)) : join10(parent, REJECTED_DIR, basename5(path2));
 }
 function moveWritten(options, output, reason) {
-  for (const path of [options.planPath, options.prerequisitesPath]) {
-    if (!isWrittenFile(options.repoRoot, path))
+  for (const path2 of [options.planPath, options.prerequisitesPath]) {
+    if (!isWrittenFile(options.repoRoot, path2))
       continue;
-    const destination = rejectedPath(path);
+    const destination = rejectedPath(path2);
     try {
       mkdirSync3(resolve6(options.repoRoot, dirname7(destination)), { recursive: true });
-      renameSync2(resolve6(options.repoRoot, path), resolve6(options.repoRoot, destination));
-      output.info(`\uD83D\uDDC3  Moved ${path} to ${destination}: ${reason}`);
+      renameSync2(resolve6(options.repoRoot, path2), resolve6(options.repoRoot, destination));
+      output.info(`\uD83D\uDDC3  Moved ${path2} to ${destination}: ${reason}`);
     } catch (error) {
-      output.warn(`${path} was written against a refused review and could not be moved: ${messageOf(error)}`);
+      output.warn(`${path2} was written against a refused review and could not be moved: ${messageOf(error)}`);
     }
   }
 }
@@ -6390,37 +7076,37 @@ async function enforceSpecReview(options) {
 }
 
 // src/board/issue-board.ts
-var PREFIX = "board issue";
+var PREFIX2 = "board issue";
 var REPO_PATH2 = "{owner}/{repo}";
 var COMMENT_ID = /^[1-9]\d*$/;
-function detailOf2(result, command) {
+function detailOf3(result, command) {
   const written = result.stderr.trim() || result.stdout.trim();
   return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
 }
 function failure(command, result) {
-  return new Error(`${PREFIX}: ${detailOf2(result, command)}`);
+  return new Error(`${PREFIX2}: ${detailOf3(result, command)}`);
 }
 function issueNumber(value, member) {
   if (!Number.isSafeInteger(value) || value < 1) {
-    throw new TypeError(`${PREFIX}: ${member} refused issue number ${describeValue(value)}, expected a positive whole number`);
+    throw new TypeError(`${PREFIX2}: ${member} refused issue number ${describeValue(value)}, expected a positive whole number`);
   }
   return String(value);
 }
 function commentId(value) {
   if (typeof value !== "string" || !COMMENT_ID.test(value)) {
-    throw new TypeError(`${PREFIX}: editComment refused comment id ${describeValue(value)},` + " expected a positive whole number with no leading zero");
+    throw new TypeError(`${PREFIX2}: editComment refused comment id ${describeValue(value)},` + " expected a positive whole number with no leading zero");
   }
   return value;
 }
 function commentBody2(value, member) {
   if (typeof value !== "string") {
-    throw new TypeError(`${PREFIX}: ${member} refused a body ${describeValue(value)}, expected a string`);
+    throw new TypeError(`${PREFIX2}: ${member} refused a body ${describeValue(value)}, expected a string`);
   }
   return value;
 }
 function labelName(value, member, what) {
   if (typeof value !== "string" || value === "" || value.startsWith("-")) {
-    throw new TypeError(`${PREFIX}: ${member} refused ${what} ${describeValue(value)},` + " expected a non-empty name that does not open with a hyphen");
+    throw new TypeError(`${PREFIX2}: ${member} refused ${what} ${describeValue(value)},` + " expected a non-empty name that does not open with a hyphen");
   }
   return value;
 }
@@ -6428,20 +7114,20 @@ function parseJson(stdout, command) {
   try {
     return JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX2}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
 }
 function readComment(value, command, where) {
   if (!isMapping(value)) {
-    throw new Error(`${PREFIX}: ${command} answered ${where} as ${describeValue(value)}, expected a mapping`);
+    throw new Error(`${PREFIX2}: ${command} answered ${where} as ${describeValue(value)}, expected a mapping`);
   }
   const id = value["id"];
   if (typeof id !== "number" || !Number.isSafeInteger(id) || id < 1) {
-    throw new Error(`${PREFIX}: ${command} answered ${where}.id as ${describeValue(id)}, expected a positive whole number`);
+    throw new Error(`${PREFIX2}: ${command} answered ${where}.id as ${describeValue(id)}, expected a positive whole number`);
   }
   const body = value["body"];
   if (typeof body !== "string") {
-    throw new Error(`${PREFIX}: ${command} answered ${where}.body as ${describeValue(body)}, expected a string`);
+    throw new Error(`${PREFIX2}: ${command} answered ${where}.body as ${describeValue(body)}, expected a string`);
   }
   const user = value["user"];
   const login = isMapping(user) ? user["login"] : null;
@@ -6462,26 +7148,26 @@ function createGhIssueBoard(options) {
   const commentsPath = (number) => `repos/${REPO_PATH2}/issues/${number}/comments`;
   const board = {
     comments: async (issue3) => {
-      const path = commentsPath(issueNumber(issue3, "comments"));
-      const command = `gh api ${path}`;
-      const rows = parseJson(await succeed(["api", path], command), command);
+      const path2 = commentsPath(issueNumber(issue3, "comments"));
+      const command = `gh api ${path2}`;
+      const rows = parseJson(await succeed(["api", path2], command), command);
       if (!Array.isArray(rows)) {
-        throw new Error(`${PREFIX}: ${command} answered ${describeValue(rows)}, expected a list of comments`);
+        throw new Error(`${PREFIX2}: ${command} answered ${describeValue(rows)}, expected a list of comments`);
       }
       return rows.map((row, index) => readComment(row, command, `comment ${String(index)}`));
     },
     comment: async (issue3, body) => {
-      const path = commentsPath(issueNumber(issue3, "comment"));
+      const path2 = commentsPath(issueNumber(issue3, "comment"));
       const text = commentBody2(body, "comment");
-      const command = `gh api -X POST ${path}`;
-      const stdout = await succeed(["api", path, "-X", "POST", "-f", `body=${text}`], command);
+      const command = `gh api -X POST ${path2}`;
+      const stdout = await succeed(["api", path2, "-X", "POST", "-f", `body=${text}`], command);
       return readComment(parseJson(stdout, command), command, "the comment");
     },
     editComment: async (id, body) => {
-      const path = `repos/${REPO_PATH2}/issues/comments/${commentId(id)}`;
+      const path2 = `repos/${REPO_PATH2}/issues/comments/${commentId(id)}`;
       const text = commentBody2(body, "editComment");
-      const command = `gh api -X PATCH ${path}`;
-      const stdout = await succeed(["api", path, "-X", "PATCH", "-f", `body=${text}`], command);
+      const command = `gh api -X PATCH ${path2}`;
+      const stdout = await succeed(["api", path2, "-X", "PATCH", "-f", `body=${text}`], command);
       return readComment(parseJson(stdout, command), command, "the comment");
     },
     swapLabels: async (issue3, removed, added) => {
@@ -6518,7 +7204,7 @@ class RefsBlockError extends Error {
   }
 }
 var SECTION_HEADING = /^ {0,3}##(?:[ \t]|$)/u;
-var FENCE_LINE2 = /^ {0,3}(`{3,}|~{3,})(.*)$/u;
+var FENCE_LINE3 = /^ {0,3}(`{3,}|~{3,})(.*)$/u;
 var SHA256 = /^[0-9a-f]{64}$/u;
 var OBJECT_ID = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u;
 var ESCAPED = /[>\p{C}\p{Zl}\p{Zp}]/gu;
@@ -6550,7 +7236,7 @@ function sections(body) {
   let fence = null;
   for (const line of body.split(`
 `)) {
-    const found = FENCE_LINE2.exec(line);
+    const found = FENCE_LINE3.exec(line);
     const run = found?.[1] ?? "";
     if (fence === null && found !== null) {
       fence = { char: run.charAt(0), length: run.length };
@@ -6755,92 +7441,14 @@ ${REFS_BLOCK_CLOSE}
 `, after) ? copy.slice(after + 1) : copy.slice(after);
   return Object.freeze({ stamps: parseStamps(copy.slice(inner, end + 1)), body });
 }
-function carryRefsBlock(copy, text) {
-  return writeRefsBlock(text, copy === null ? null : readRefsBlock(copy).stamps);
-}
-
-// src/board/naming.ts
-import path from "path";
-var ID_PREFIX = "rafa";
-var BRANCH_PREFIX = "feat";
-var SPEC_EXTENSION = ".md";
-var NOTES_SUFFIX = "-notes";
-var MAX_SLUG_WORDS = 4;
-var MIN_SLUG_WORDS = 2;
-var FALLBACK_SLUG = "untitled";
-var STOP_WORDS = new Set([
-  "a",
-  "an",
-  "and",
-  "as",
-  "at",
-  "be",
-  "by",
-  "for",
-  "from",
-  "in",
-  "into",
-  "is",
-  "it",
-  "its",
-  "of",
-  "on",
-  "or",
-  "that",
-  "the",
-  "this",
-  "to",
-  "with"
-]);
-var CLAUSE_BREAK = /[,;:([\u2013\u2014]|\s-\s/u;
-var LEADING_ID = /^\s*#?rafa[-\s]?\d+\s*[-:.\u2013\u2014]?\s*/iu;
-var NON_WORD = /[^a-z0-9]+/gu;
-function requireIssueNumber(issue3) {
-  if (!Number.isInteger(issue3) || issue3 <= 0) {
-    throw new RangeError(`An issue number must be a positive integer, not ${String(issue3)}.`);
-  }
-  return issue3;
-}
-function wordsOf(title) {
-  return title.toLowerCase().replace(NON_WORD, " ").split(" ").filter((word) => word !== "");
-}
-function withoutStopWords(words) {
-  const kept = words.filter((word) => !STOP_WORDS.has(word));
-  return kept.length > 0 ? kept : words;
-}
-function slugFromTitle(title) {
-  const withoutId = title.replace(LEADING_ID, "");
-  const [firstClause = ""] = withoutId.split(CLAUSE_BREAK);
-  const whole = withoutStopWords(wordsOf(withoutId));
-  const clause = withoutStopWords(wordsOf(firstClause));
-  const chosen = clause.length >= MIN_SLUG_WORDS ? clause : whole;
-  if (chosen.length === 0)
-    return FALLBACK_SLUG;
-  return chosen.slice(0, MAX_SLUG_WORDS).join("-");
-}
-function boardId(issue3) {
-  return `${ID_PREFIX}-${requireIssueNumber(issue3)}`;
-}
-function planStub(issue3, title) {
-  return `${boardId(issue3)}-${slugFromTitle(title)}`;
-}
-function specFileName(issue3, title) {
-  return `${planStub(issue3, title)}${SPEC_EXTENSION}`;
-}
-function specPath(specsDir, issue3, title) {
-  return path.join(specsDir, specFileName(issue3, title));
-}
-function notesFileName(issue3) {
-  return `${boardId(issue3)}${NOTES_SUFFIX}${SPEC_EXTENSION}`;
-}
-function notesPath(specsDir, issue3) {
-  return path.join(specsDir, notesFileName(issue3));
-}
+function carryRefsBlock(copy, text) {
+  return writeRefsBlock(text, copy === null ? null : readRefsBlock(copy).stamps);
+}
 
 // src/board/previous-copy.ts
 import { linkSync as linkSync2, mkdirSync as mkdirSync4, readdirSync as readdirSync7, statSync as statSync6, unlinkSync } from "fs";
 import { basename as basename6, extname, join as join11, resolve as resolve7 } from "path";
-var PREFIX2 = "board previous copy";
+var PREFIX3 = "board previous copy";
 var PREVIOUS_DIR_NAME = "previous";
 var PREVIOUS_COPY_WARN_ABOVE = 50;
 var COPY_EXTENSION = ".md";
@@ -6888,7 +7496,7 @@ function movePreviousCopy(options) {
     mkdirSync4(absoluteDirectory, { recursive: true });
     name2 = linkUnderFreeName(source, absoluteDirectory, savedName, timestamp);
   } catch (error) {
-    throw new Error(`${PREFIX2}: ${path2} could not be moved to ${directory}: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX3}: ${path2} could not be moved to ${directory}: ${messageOf(error)}`, { cause: error });
   }
   const moved = {
     path: join11(directory, name2),
@@ -6897,7 +7505,7 @@ function movePreviousCopy(options) {
   try {
     unlinkSync(source);
   } catch (error) {
-    throw new Error(`${PREFIX2}: ${path2} was copied to ${moved.path} but could not be removed: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX3}: ${path2} was copied to ${moved.path} but could not be removed: ${messageOf(error)}`, { cause: error });
   }
   return moved;
 }
@@ -6911,23 +7519,23 @@ function countPreviousCopies(repoRoot, specsDir) {
   } catch (error) {
     if (isMissing(error))
       return 0;
-    throw new Error(`${PREFIX2}: ${directory} could not be read: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX3}: ${directory} could not be read: ${messageOf(error)}`, { cause: error });
   }
 }
 
 // src/board/issue.ts
-var PREFIX3 = "board issue";
+var PREFIX4 = "board issue";
 var ISSUE_VIEW_FIELDS = "number,title,body,state,labels,author";
 var SPEC_LABEL = "type:spec";
 var ISSUE_REFUSAL_EXIT = 2;
 var LOCAL_NOTES_HEADING = "## Local notes";
-function detailOf3(result, command) {
+function detailOf4(result, command) {
   const written = result.stderr.trim() || result.stdout.trim();
   return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
 }
 function issueNumber2(value) {
   if (!Number.isSafeInteger(value) || value < 1) {
-    throw new TypeError(`${PREFIX3}: the read refused issue number ${describeValue(value)}, expected a positive whole number`);
+    throw new TypeError(`${PREFIX4}: the read refused issue number ${describeValue(value)}, expected a positive whole number`);
   }
   return String(value);
 }
@@ -6962,11 +7570,11 @@ function readViewedIssue(stdout, number, command) {
   try {
     payload = JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX3}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX4}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
   const problem = viewProblem(payload, number);
   if (problem !== null)
-    throw new Error(`${PREFIX3}: ${command} answered ${problem}`);
+    throw new Error(`${PREFIX4}: ${command} answered ${problem}`);
   const checked = payload;
   return {
     number,
@@ -6984,7 +7592,7 @@ function createGhSpecIssueReader(options) {
     const command = `gh issue view ${number} --json ${ISSUE_VIEW_FIELDS}`;
     const result = await gh(["issue", "view", number, "--json", ISSUE_VIEW_FIELDS]);
     if (!result.ok)
-      throw new Error(`${PREFIX3}: ${detailOf3(result, command)}`);
+      throw new Error(`${PREFIX4}: ${detailOf4(result, command)}`);
     return readViewedIssue(result.stdout, issue3, command);
   };
 }
@@ -7027,8 +7635,8 @@ var NOTES_SEPARATOR = `
 ${LOCAL_NOTES_HEADING}
 
 `;
-var HEADING = /^#{1,6}(?:[ \t]|$)/u;
-var FENCE = /^ {0,3}(?:`{3,}|~{3,})/u;
+var HEADING2 = /^#{1,6}(?:[ \t]|$)/u;
+var FENCE3 = /^ {0,3}(?:`{3,}|~{3,})/u;
 function commonLines(before, after) {
   let previous = new Uint32Array(after.length + 1);
   for (const line of before) {
@@ -7055,9 +7663,9 @@ function headingSections(lines) {
 `)]);
   };
   for (const line of lines) {
-    if (FENCE.test(line))
+    if (FENCE3.test(line))
       fenced = !fenced;
-    if (fenced || !HEADING.test(line)) {
+    if (fenced || !HEADING2.test(line)) {
       current?.lines.push(line);
       continue;
     }
@@ -7155,7 +7763,7 @@ function writeSpecSnapshot(options) {
     mkdirSync5(dirname8(absolute), { recursive: true });
     writeFileSync5(absolute, text);
   } catch (error) {
-    throw new Error(`${PREFIX3}: the snapshot ${path2} could not be written: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX4}: the snapshot ${path2} could not be written: ${messageOf(error)}`, { cause: error });
   }
   return { ...written, action, previous };
 }
@@ -7220,368 +7828,159 @@ var SHAPES = [
   { name: "unix-home", kind: "home-path", pattern: /(?<![\w.-])(\/(?:Users|home)\/)([A-Za-z0-9._-]+)/giu },
   { name: "windows-home", kind: "home-path", pattern: /(?<![\w.-])([A-Za-z]:\\Users\\)([A-Za-z0-9._-]+)/giu },
   { name: "github-token", kind: "token", pattern: /\b(gh[pousr]_)([A-Za-z0-9]{20,})\b/gu },
-  { name: "github-fine-grained", kind: "token", pattern: /\b(github_pat_)([A-Za-z0-9_]{20,})\b/gu },
-  { name: "aws-key-id", kind: "token", pattern: /\b(A[KS]IA)([A-Z0-9]{16})\b/gu },
-  { name: "secret-key", kind: "token", pattern: /(?<![\w-])(sk-(?:ant-)?)([A-Za-z0-9_-]{20,})(?![\w-])/gu },
-  { name: "slack-token", kind: "token", pattern: /(?<![\w-])(xox[abeoprs]-)([A-Za-z0-9-]{12,})(?![\w-])/gu },
-  { name: "google-api-key", kind: "token", pattern: /(?<![\w-])(AIza)([A-Za-z0-9_-]{35})(?![\w-])/gu }
-];
-var KIND_LABEL = Object.freeze({
-  "home-path": "a home path",
-  token: "a token"
-});
-var REMEDY3 = "the board is public, so move it to the local notes file beside the spec and edit the body";
-function holdsPlaceholderWord(secret) {
-  const lowered = secret.toLowerCase();
-  return PLACEHOLDER_WORDS.some((word) => lowered.includes(word));
-}
-function isTooPlainForAToken(secret) {
-  return new Set(secret).size < MIN_TOKEN_CHARSET;
-}
-function isPlaceholder(kind, secret) {
-  if (holdsPlaceholderWord(secret))
-    return true;
-  if (kind === "home-path")
-    return PLACEHOLDER_USERS.has(secret.toLowerCase());
-  return isTooPlainForAToken(secret);
-}
-function maskedEvidence(keep) {
-  return `${keep}${MASK}`;
-}
-function findLeaksInLine(line, number) {
-  const found = [];
-  for (const shape of SHAPES) {
-    const pattern = new RegExp(shape.pattern.source, shape.pattern.flags);
-    let match = pattern.exec(line);
-    while (match !== null) {
-      const [, keep = "", secret = ""] = match;
-      if (!isPlaceholder(shape.kind, secret)) {
-        found.push({
-          kind: shape.kind,
-          shape: shape.name,
-          line: number,
-          evidence: maskedEvidence(keep)
-        });
-      }
-      match = pattern.exec(line);
-    }
-  }
-  return found;
-}
-function findLeaks(body) {
-  return body.split(/\r?\n/u).flatMap((line, index) => findLeaksInLine(line, index + 1));
-}
-function describeFinding(finding) {
-  return `line ${String(finding.line)} holds ${KIND_LABEL[finding.kind]} (${finding.evidence})`;
-}
-function leakRefusalMessage(source, findings) {
-  if (findings.length === 0) {
-    throw new TypeError(`board leak: ${source} carries no leak, and has no refusal to name`);
-  }
-  const named = findings.map(describeFinding).join(", ");
-  return `${source} names a machine path or a credential: ${named}; ${REMEDY3}`;
-}
-function requireNoLeak(source, body) {
-  const findings = findLeaks(body);
-  if (findings.length === 0)
-    return;
-  throw new CommandExit(LEAK_REFUSAL_EXIT, leakRefusalMessage(source, findings));
-}
-
-// src/board/roadmap.ts
-var PREFIX4 = "board roadmap";
-var ROADMAP_TITLE = "Roadmap";
-var ROADMAP_SETTING = "roadmap.issue";
-var ROADMAP_REFUSAL_EXIT = 2;
-var DEFAULT_REMOTE = "origin";
-var OPEN_PULL_REQUEST_LIMIT = 100;
-var PR_LIST_FIELDS = "number,headRefName,body";
-var ISSUE_LIST_FIELDS = "number,title";
-var TASK_LINE = /^\s*[-*+]\s+\[([ xX])\]\s+#(\d+)\s*(.*)$/u;
-var FENCE2 = /^\s*(?:`{3,}|~{3,})/u;
-var WHY_SEPARATOR = /^[-:,.\u2013\u2014]\s*/u;
-var CLOSING = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\b\s*:?\s*#(\d+)\b/giu;
-function whyOf(rest) {
-  return rest.trim().replace(WHY_SEPARATOR, "").trim();
-}
-function parseRoadmapBody(body) {
-  let lines = [];
-  let fenced = false;
-  body.split(/\r\n?|\n/u).forEach((text, index) => {
-    if (FENCE2.test(text)) {
-      fenced = !fenced;
-      return;
-    }
-    if (fenced)
-      return;
-    const found = TASK_LINE.exec(text);
-    if (found === null)
-      return;
-    const [, box = "", digits = "", rest = ""] = found;
-    const issue3 = Number.parseInt(digits, 10);
-    if (!Number.isSafeInteger(issue3) || issue3 < 1)
-      return;
-    lines = [...lines, {
-      issue: issue3,
-      ticked: box.trim() !== "",
-      why: whyOf(rest),
-      lineNumber: index + 1
-    }];
-  });
-  return Object.freeze(lines);
-}
-function detailOf4(result, command) {
-  const written = result.stderr.trim() || result.stdout.trim();
-  return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
-}
-function parseRows(stdout, command) {
-  let payload;
-  try {
-    payload = JSON.parse(stdout);
-  } catch (error) {
-    throw new Error(`${PREFIX4}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
-  }
-  if (!Array.isArray(payload)) {
-    throw new Error(`${PREFIX4}: ${command} answered ${describeValue(payload)}, expected a list`);
-  }
-  return payload;
-}
-function rowNumber(row, key, command, where) {
-  const value = isMapping(row) ? row[key] : null;
-  if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1) {
-    throw new Error(`${PREFIX4}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a positive whole number`);
-  }
-  return value;
-}
-function rowText(row, key, command, where) {
-  const value = isMapping(row) ? row[key] : null;
-  if (typeof value !== "string") {
-    throw new Error(`${PREFIX4}: ${command} answered ${where}.${key} as ${describeValue(value)}, expected a string`);
-  }
-  return value;
-}
-function createGhRoadmapSearch(options) {
-  const { gh } = options;
-  const search = `${ROADMAP_TITLE} in:title`;
-  const args = ["issue", "list", "--state", "open", "--search", search, "--json", ISSUE_LIST_FIELDS];
-  const command = `gh issue list --state open --search "${search}" --json ${ISSUE_LIST_FIELDS}`;
-  return async () => {
-    const result = await gh(args);
-    if (!result.ok)
-      throw new Error(`${PREFIX4}: ${detailOf4(result, command)}`);
-    return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
-      number: rowNumber(row, "number", command, `issue ${String(index)}`),
-      title: rowText(row, "title", command, `issue ${String(index)}`)
-    })));
-  };
-}
-function noRoadmapMessage() {
-  return `no open issue is titled ${ROADMAP_TITLE}, so there is no roadmap to read;` + ` run rafa init --board to open one, or set ${ROADMAP_SETTING} to the issue that holds the order`;
-}
-function severalRoadmapsMessage(numbers) {
-  const named = numbers.map((number) => `#${String(number)}`).join(", ");
-  return `${String(numbers.length)} open issues are titled ${ROADMAP_TITLE} (${named}),` + ` so which one holds the order is not this command to guess; set ${ROADMAP_SETTING} to it`;
-}
-async function resolveRoadmapIssue(options) {
-  const { configured, search } = options;
-  if (configured !== null)
-    return configured;
-  const wanted = ROADMAP_TITLE.toLowerCase();
-  const titled = (await search()).filter((issue3) => issue3.title.trim().toLowerCase() === wanted);
-  if (titled.length === 0)
-    throw new CommandExit(ROADMAP_REFUSAL_EXIT, noRoadmapMessage());
-  if (titled.length > 1) {
-    throw new CommandExit(ROADMAP_REFUSAL_EXIT, severalRoadmapsMessage(titled.map((issue3) => issue3.number)));
-  }
-  return titled[0]?.number ?? 0;
-}
-function createGhOpenPullRequests(options) {
-  const { gh } = options;
-  const limit = String(OPEN_PULL_REQUEST_LIMIT);
-  const args = ["pr", "list", "--state", "open", "--json", PR_LIST_FIELDS, "--limit", limit];
-  const command = `gh pr list --state open --json ${PR_LIST_FIELDS} --limit ${limit}`;
-  return async () => {
-    const result = await gh(args);
-    if (!result.ok)
-      throw new Error(`${PREFIX4}: ${detailOf4(result, command)}`);
-    return Object.freeze(parseRows(result.stdout, command).map((row, index) => ({
-      number: rowNumber(row, "number", command, `pull request ${String(index)}`),
-      headRefName: rowText(row, "headRefName", command, `pull request ${String(index)}`),
-      body: rowText(row, "body", command, `pull request ${String(index)}`)
-    })));
-  };
-}
-function closedIssuesIn(body) {
-  return Object.freeze([...body.matchAll(CLOSING)].map((found) => Number.parseInt(found[1] ?? "", 10)).filter((issue3) => Number.isSafeInteger(issue3) && issue3 > 0));
-}
-function branchClaims(ref, issue3) {
-  const claim = `${BRANCH_PREFIX}/${boardId(issue3)}`;
-  return new RegExp(`(?:^|/)${claim}(?:-|$)`, "u").test(ref);
-}
-function outputLines(stdout) {
-  return stdout.split(`
-`).map((line) => line.trim()).filter((line) => line !== "");
-}
-function scanClaimBranches(git, remote = DEFAULT_REMOTE) {
-  const local = git(["for-each-ref", "--format=%(refname)", "refs/heads", "refs/remotes"]);
-  const pushed = git(["ls-remote", "--heads", remote]);
-  const localRefs = local.ok ? outputLines(local.stdout) : [];
-  const pushedRefs = pushed.ok ? outputLines(pushed.stdout).map((line) => line.split("\t").at(-1) ?? "") : [];
-  const problems = [
-    local.ok ? "" : `the branches of this checkout could not be read, so a branch held only here was not seen: ${detailOf4(local, "git for-each-ref")}`,
-    pushed.ok ? "" : `the branches on ${remote} could not be read, so a branch pushed but not fetched was not seen: ${detailOf4(pushed, `git ls-remote --heads ${remote}`)}`
-  ].filter((problem) => problem !== "");
-  return Object.freeze({
-    refs: Object.freeze([...localRefs, ...pushedRefs].filter((ref) => ref !== "")),
-    problems: Object.freeze(problems)
-  });
-}
-function createRoadmapReadings(options) {
-  const { issues, branches, pullRequests } = options;
-  let open = null;
-  return Object.freeze({
-    isClosed: async (issue3) => (await issues(issue3)).state === "CLOSED",
-    branchFor: (issue3) => branches.refs.find((ref) => branchClaims(ref, issue3)) ?? null,
-    pullRequestFor: async (issue3) => {
-      open = open ?? pullRequests();
-      const closing = (await open).find((pull) => closedIssuesIn(pull.body).includes(issue3));
-      return closing?.number ?? null;
-    }
-  });
-}
-function skipSentence(skip) {
-  const id = `#${String(skip.line.issue)}`;
-  if (skip.reason === "ticked")
-    return `${id} done: ticked on the roadmap`;
-  if (skip.reason === "closed")
-    return `${id} done: the issue is closed`;
-  return skip.reason === "branch" ? `${id} taken: branch ${skip.detail} exists` : `${id} taken: PR ${skip.detail} open`;
-}
-async function readRoadmapSkip(line, readings) {
-  if (line.ticked)
-    return { line, reason: "ticked", detail: "" };
-  if (await readings.isClosed(line.issue))
-    return { line, reason: "closed", detail: "" };
-  const branch = readings.branchFor(line.issue);
-  if (branch !== null)
-    return { line, reason: "branch", detail: branch };
-  const pull = await readings.pullRequestFor(line.issue);
-  return pull === null ? null : { line, reason: "pull-request", detail: `#${String(pull)}` };
-}
-async function pickNextRoadmapLine(lines, readings) {
-  let skipped2 = [];
-  for (const line of lines) {
-    const skip = await readRoadmapSkip(line, readings);
-    if (skip === null)
-      return Object.freeze({ line, skipped: Object.freeze(skipped2) });
-    skipped2 = [...skipped2, skip];
-  }
-  return Object.freeze({ line: null, skipped: Object.freeze(skipped2) });
+  { name: "github-fine-grained", kind: "token", pattern: /\b(github_pat_)([A-Za-z0-9_]{20,})\b/gu },
+  { name: "aws-key-id", kind: "token", pattern: /\b(A[KS]IA)([A-Z0-9]{16})\b/gu },
+  { name: "secret-key", kind: "token", pattern: /(?<![\w-])(sk-(?:ant-)?)([A-Za-z0-9_-]{20,})(?![\w-])/gu },
+  { name: "slack-token", kind: "token", pattern: /(?<![\w-])(xox[abeoprs]-)([A-Za-z0-9-]{12,})(?![\w-])/gu },
+  { name: "google-api-key", kind: "token", pattern: /(?<![\w-])(AIza)([A-Za-z0-9_-]{35})(?![\w-])/gu }
+];
+var KIND_LABEL = Object.freeze({
+  "home-path": "a home path",
+  token: "a token"
+});
+var REMEDY4 = "the board is public, so move it to the local notes file beside the spec and edit the body";
+function holdsPlaceholderWord(secret) {
+  const lowered = secret.toLowerCase();
+  return PLACEHOLDER_WORDS.some((word) => lowered.includes(word));
 }
-function exhaustedMessage(roadmap, skipped2) {
-  const id = `issue #${String(roadmap)}`;
-  return skipped2.length === 0 ? `the roadmap, ${id}, carries no "- [ ] #<n>" line; add the next spec to its task list` : `every line of the roadmap, ${id}, is done or taken (${String(skipped2.length)} of them);` + " open the next spec issue and add it to the task list";
+function isTooPlainForAToken(secret) {
+  return new Set(secret).size < MIN_TOKEN_CHARSET;
 }
-
-// src/board/blocked.ts
-var SPEC_BLOCKED_LABEL = "spec:blocked";
-var BLOCKED_BY_FIELD = "Blocked by";
-var FENCE_LINE3 = /^ {0,3}(?:```|~~~)/u;
-var FIELD_LINE = /^ {0,3}(?:[-*+]\s+)?[*_]{0,2}blocked\s+by[*_]{0,2}\s*:(.*)$/iu;
-var ISSUE_ID = /#(\d+)/gu;
-var FOREIGN_ID = /[A-Za-z0-9][A-Za-z0-9-]*\/[A-Za-z0-9._-]+#\d+/gu;
-var REMEDY4 = `name them as "${BLOCKED_BY_FIELD}: #24 #26", or take the ${SPEC_BLOCKED_LABEL} label off`;
-function hasSpecBlockedLabel(labels) {
-  return labels.some((label) => label.trim().toLowerCase() === SPEC_BLOCKED_LABEL);
+function isPlaceholder(kind, secret) {
+  if (holdsPlaceholderWord(secret))
+    return true;
+  if (kind === "home-path")
+    return PLACEHOLDER_USERS.has(secret.toLowerCase());
+  return isTooPlainForAToken(secret);
 }
-function findFieldLine(body) {
-  const lines = body.split(`
-`).map((line) => line.replace(/\r$/u, ""));
-  let fenced = false;
-  for (const [index, line] of lines.entries()) {
-    if (FENCE_LINE3.test(line)) {
-      fenced = !fenced;
-      continue;
-    }
-    if (fenced)
-      continue;
-    const found = FIELD_LINE.exec(line);
-    if (found === null)
-      continue;
-    return { number: index + 1, text: (found[1] ?? "").trim() };
-  }
-  return null;
+function maskedEvidence(keep) {
+  return `${keep}${MASK}`;
 }
-function idsIn(text) {
+function findLeaksInLine(line, number) {
   const found = [];
-  for (const match of text.matchAll(ISSUE_ID)) {
-    const id = Number(match[1]);
-    if (!Number.isSafeInteger(id) || id < 1 || found.includes(id))
-      continue;
-    found.push(id);
+  for (const shape of SHAPES) {
+    const pattern = new RegExp(shape.pattern.source, shape.pattern.flags);
+    let match = pattern.exec(line);
+    while (match !== null) {
+      const [, keep = "", secret = ""] = match;
+      if (!isPlaceholder(shape.kind, secret)) {
+        found.push({
+          kind: shape.kind,
+          shape: shape.name,
+          line: number,
+          evidence: maskedEvidence(keep)
+        });
+      }
+      match = pattern.exec(line);
+    }
   }
   return found;
 }
-function foreignIn(text) {
-  const found = [];
-  for (const [token] of text.matchAll(FOREIGN_ID)) {
-    if (!found.includes(token))
-      found.push(token);
+function findLeaks(body) {
+  return body.split(/\r?\n/u).flatMap((line, index) => findLeaksInLine(line, index + 1));
+}
+function describeFinding(finding) {
+  return `line ${String(finding.line)} holds ${KIND_LABEL[finding.kind]} (${finding.evidence})`;
+}
+function leakRefusalMessage(source, findings) {
+  if (findings.length === 0) {
+    throw new TypeError(`board leak: ${source} carries no leak, and has no refusal to name`);
   }
-  return found;
+  const named = findings.map(describeFinding).join(", ");
+  return `${source} names a machine path or a credential: ${named}; ${REMEDY4}`;
 }
-var NAMED_NOTHING = { ids: [], foreign: [] };
-function reading(kind, issue3, found, named, unknown) {
-  return {
-    kind,
-    issue: issue3,
-    line: found?.number ?? null,
-    text: found?.text ?? null,
-    blockers: named.ids,
-    foreign: named.foreign,
-    unknown
-  };
+function requireNoLeak(source, body) {
+  const findings = findLeaks(body);
+  if (findings.length === 0)
+    return;
+  throw new CommandExit(LEAK_REFUSAL_EXIT, leakRefusalMessage(source, findings));
 }
-function readBlockedBy(issue3, body, known) {
-  const found = findFieldLine(body);
-  if (found === null)
-    return reading("no-line", issue3, null, NAMED_NOTHING, []);
-  const foreign = foreignIn(found.text);
-  const ids = idsIn(found.text.replace(FOREIGN_ID, " "));
-  const named = { ids, foreign };
-  if (ids.length === 0)
-    return reading("no-ids", issue3, found, named, []);
-  const unknown = known === undefined ? [] : ids.filter((id) => id !== issue3 && !known.has(id));
-  if (ids.includes(issue3))
-    return reading("self-reference", issue3, found, named, unknown);
-  if (unknown.length > 0)
-    return reading("unknown-issue", issue3, found, named, unknown);
-  return reading("blocked", issue3, found, named, unknown);
+
+// src/board/roadmap-board.ts
+var PREFIX5 = "board listing";
+var BOARD_LIST_FIELDS = "number,title,body,state,stateReason,labels";
+var BOARD_LISTING_LIMIT = 1000;
+function listingArgs(limit) {
+  return ["issue", "list", "--state", "all", "--limit", String(limit), "--json", BOARD_LIST_FIELDS];
 }
-function nameIds(ids) {
-  return ids.map((id) => `#${String(id)}`).join(" ");
+function boardListingCommand(limit) {
+  return `gh ${listingArgs(limit).join(" ")}`;
 }
-function faultClause(read) {
-  const at = `on line ${String(read.line ?? 0)}`;
-  if (read.kind === "no-line") {
-    return `is labelled ${SPEC_BLOCKED_LABEL} and its body carries no "${BLOCKED_BY_FIELD}:" line`;
+function detailOf5(result, command) {
+  const written = result.stderr.trim() || result.stdout.trim();
+  return written === "" ? `${command} failed and wrote nothing` : `${command} failed: ${written}`;
+}
+function labelsProblem(value) {
+  if (!Array.isArray(value))
+    return `labels ${describeValue(value)}, expected a list of named labels`;
+  const bad = value.findIndex((label) => !isMapping(label) || typeof label["name"] !== "string");
+  return bad === -1 ? null : `labels[${bad}] ${describeValue(value[bad])}, expected a mapping with a string name`;
+}
+function rowProblem(row) {
+  if (!isMapping(row))
+    return `${describeValue(row)}, expected a mapping`;
+  const { number, title, body, state, stateReason, labels } = row;
+  if (typeof number !== "number" || !Number.isSafeInteger(number) || number < 1) {
+    return `number ${describeValue(number)}, expected a positive whole number`;
   }
-  if (read.kind === "no-ids" && read.foreign.length > 0) {
-    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming only issues on other repositories: ${read.foreign.join(" ")}`;
+  if (typeof title !== "string")
+    return `title ${describeValue(title)}, expected a string`;
+  if (typeof body !== "string")
+    return `body ${describeValue(body)}, expected a string`;
+  if (state !== "OPEN" && state !== "CLOSED")
+    return `state ${describeValue(state)}, expected "OPEN" or "CLOSED"`;
+  if (stateReason !== null && typeof stateReason !== "string") {
+    return `stateReason ${describeValue(stateReason)}, expected a string or null`;
   }
-  if (read.kind === "no-ids") {
-    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming no issue: "${read.text ?? ""}"`;
+  return labelsProblem(labels);
+}
+function reasonOf(value) {
+  return value === "" ? null : value;
+}
+function issueOf2(row) {
+  const labels = row["labels"].map((label) => label.name);
+  return Object.freeze({
+    number: row["number"],
+    title: row["title"],
+    body: row["body"],
+    state: row["state"],
+    stateReason: reasonOf(row["stateReason"]),
+    labels: Object.freeze(labels),
+    type: typeOfLabels(labels),
+    module: moduleOfLabels(labels)
+  });
+}
+function parseBoardListing(stdout, command) {
+  let payload;
+  try {
+    payload = JSON.parse(stdout);
+  } catch (error) {
+    throw new Error(`${PREFIX5}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
-  if (read.kind === "self-reference") {
-    return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming itself`;
+  if (!Array.isArray(payload)) {
+    throw new Error(`${PREFIX5}: ${command} answered ${describeValue(payload)}, expected a list`);
   }
-  return `has a "${BLOCKED_BY_FIELD}:" line ${at} naming ${nameIds(read.unknown)}, which the board has no issue for`;
+  const issues = payload.map((row, index) => {
+    const problem = rowProblem(row);
+    if (problem !== null)
+      throw new Error(`${PREFIX5}: ${command} answered row ${index} with ${problem}`);
+    return issueOf2(row);
+  });
+  return Object.freeze(issues);
 }
-function blockedFaultMessage(read) {
-  if (read.kind === "blocked") {
-    throw new TypeError(`board blocked: #${String(read.issue)} names ${nameIds(read.blockers)} and has no fault to report`);
+function createGhBoardListing(options) {
+  const { gh, limit = BOARD_LISTING_LIMIT } = options;
+  if (!Number.isSafeInteger(limit) || limit < 1) {
+    throw new TypeError(`${PREFIX5}: limit ${describeValue(limit)}, expected a positive whole number`);
   }
-  return `#${String(read.issue)} ${faultClause(read)}; ${REMEDY4}`;
+  const args = listingArgs(limit);
+  const command = boardListingCommand(limit);
+  return async () => {
+    const result = await gh(args);
+    if (!result.ok)
+      throw new Error(`${PREFIX5}: ${detailOf5(result, command)}`);
+    return parseBoardListing(result.stdout, command);
+  };
 }
 
 // src/board/blocked-line.ts
@@ -7678,10 +8077,139 @@ function declinedMessage(alternative) {
   return `#${String(alternative)} was not planned, and nothing was written`;
 }
 
+// src/board/epic-walk.ts
+var PREFIX6 = "board epic walk";
+var NOW_HORIZON_LABEL = `${HORIZON_LABEL_PREFIX}now`;
+var NO_CLAIMS = new Set;
+var UNREAD_DAY = new Date(0);
+var LINE_BREAK = /\r\n?|\n/u;
+function listOnce(listing2) {
+  let read = null;
+  return () => {
+    read = read ?? listing2();
+    return read;
+  };
+}
+function isEpicIssue(issue3) {
+  return typeOfLabels(issue3.labels) === "epic";
+}
+function isNowEpic(labels) {
+  const horizons2 = labels.filter((label) => label.startsWith(HORIZON_LABEL_PREFIX));
+  return horizons2.length === 1 && horizons2[0] === NOW_HORIZON_LABEL;
+}
+function epicOnListing(number, listing2) {
+  const epic = readEpics({ issues: listing2, claims: NO_CLAIMS, today: UNREAD_DAY }).epics.find((read) => read.number === number);
+  const row = listing2.find((issue3) => issue3.number === number);
+  if (epic === undefined || row === undefined) {
+    throw new Error(`${PREFIX6}: epic #${String(number)} is not on the board listing, so its members cannot be read;` + " the listing reads the newest issues only, and an epic it leaves out is not walked as if it had none");
+  }
+  return { epic, row };
+}
+function epicLines(epic, row) {
+  const checklist = epic.body?.lines ?? [];
+  const listed = new Set(checklist.map((item) => item.issue));
+  const labelOnly = epic.members.filter((member) => member.state === "OPEN" && !listed.has(member.number));
+  const past = row.body.split(LINE_BREAK).length;
+  const extra = labelOnly.map((member, index) => Object.freeze({
+    issue: member.number,
+    ticked: false,
+    why: member.title,
+    lineNumber: past + index + 1
+  }));
+  return Object.freeze({
+    checklist,
+    labelOnly: Object.freeze([...labelOnly]),
+    lines: Object.freeze([...checklist, ...extra])
+  });
+}
+function descended(line, epic, row) {
+  const { checklist, labelOnly, lines } = epicLines(epic, row);
+  return {
+    epic: Object.freeze({
+      line,
+      number: epic.number,
+      title: epic.title,
+      slug: epic.slug,
+      progress: epic.progress,
+      checklist,
+      labelOnly
+    }),
+    lines
+  };
+}
+async function readEpicLine(line, issue3, listing2) {
+  if (issue3.state === "CLOSED")
+    return { skip: { line, reason: "closed", detail: "" } };
+  if (!isNowEpic(issue3.labels)) {
+    const horizons2 = issue3.labels.filter((label) => label.startsWith(HORIZON_LABEL_PREFIX));
+    return { skip: { line, reason: "horizon", detail: horizons2.join(", ") } };
+  }
+  const { epic, row } = epicOnListing(line.issue, await listing2());
+  if (epic.state === "done") {
+    const { done, total } = epic.progress;
+    return { skip: { line, reason: "done", detail: `${String(done)}/${String(total)}` } };
+  }
+  return descended(line, epic, row);
+}
+function stoppedAt(lines, index, passed2, metEpic) {
+  return metEpic ? Object.freeze({ lines: Object.freeze(lines.slice(index)), passed: Object.freeze(passed2), epic: null }) : Object.freeze({ lines, passed: Object.freeze([]), epic: null });
+}
+async function descendRoadmap(lines, seams) {
+  const listing2 = listOnce(seams.listing);
+  let passed2 = [];
+  let metEpic = false;
+  for (const [index, line] of lines.entries()) {
+    const issue3 = line.ticked ? null : await seams.issues(line.issue);
+    if (issue3 === null || !isEpicIssue(issue3)) {
+      const skip = await readRoadmapSkip(line, seams.readings);
+      if (skip === null)
+        return stoppedAt(lines, index, passed2, metEpic);
+      passed2 = [...passed2, { kind: "line", skip }];
+      continue;
+    }
+    metEpic = true;
+    const outcome = await readEpicLine(line, issue3, listing2);
+    if ("skip" in outcome) {
+      passed2 = [...passed2, { kind: "epic", skip: outcome.skip }];
+      continue;
+    }
+    return Object.freeze({ lines: outcome.lines, passed: Object.freeze(passed2), epic: outcome.epic });
+  }
+  return stoppedAt(lines, lines.length, passed2, metEpic);
+}
+async function pickDescendedLine(lines, seams) {
+  const descent = await descendRoadmap(lines, seams);
+  const pick = await pickNextRoadmapLine(descent.lines, seams.readings);
+  return Object.freeze({ descent, pick, dry: descent.epic !== null && pick.line === null });
+}
+function epicSkipSentence(skip) {
+  const id = `epic #${String(skip.line.issue)}`;
+  if (skip.reason === "closed")
+    return `${id} done: the epic is closed`;
+  if (skip.reason === "done")
+    return `${id} done: every member is closed (${skip.detail})`;
+  return skip.detail === "" ? `${id} passed: it carries no ${HORIZON_LABEL_PREFIX} label, and only a ${NOW_HORIZON_LABEL} epic is walked into` : `${id} passed: it carries ${skip.detail}, and only a ${NOW_HORIZON_LABEL} epic is walked into`;
+}
+function descentPassSentence(pass) {
+  return pass.kind === "line" ? skipSentence(pass.skip) : epicSkipSentence(pass.skip);
+}
+function epicHeaderSentence(epic) {
+  const { done, total } = epic.progress;
+  return `walking into epic #${String(epic.number)} ${epic.title} (${String(done)}/${String(total)} done):` + " its checklist, then its labelled members missing from it";
+}
+function labelOnlySentence(epic, member) {
+  const label = epic.slug === null ? "its label" : `${EPIC_LABEL_PREFIX}${epic.slug}`;
+  return `#${String(member.number)} ${member.title} carries ${label} but is not on epic #${String(epic.number)}'s checklist;` + " it is walked after the checklist, by issue number";
+}
+function dryEpicSentence(epic) {
+  const { done, total } = epic.progress;
+  return `epic #${String(epic.number)} ${epic.title} has run dry: every line of its checklist and every open member it labels` + ` is done or taken, though the epic is not done (${String(done)}/${String(total)});` + " the walk stops here and does not move on to another epic";
+}
+
 // src/board/snapshot-settle.ts
 import { existsSync as existsSync15, readFileSync as readFileSync13, statSync as statSync8 } from "fs";
 import { resolve as resolve9 } from "path";
-var PREFIX5 = "board snapshot settle";
+var PREFIX7 = "board snapshot settle";
 var DATE_LENGTH = 10;
 function savedCopyDate(savedAt) {
   return savedAt.toISOString().slice(0, DATE_LENGTH);
@@ -7701,7 +8229,7 @@ function readSavedCopy(absolute, path2) {
       return null;
     return { text: readFileSync13(absolute, "utf8"), savedAt: stat.mtime };
   } catch (error) {
-    throw new Error(`${PREFIX5}: the saved copy ${path2} could not be read: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX7}: the saved copy ${path2} could not be read: ${messageOf(error)}`, { cause: error });
   }
 }
 function printChange(change, output) {
@@ -7745,7 +8273,7 @@ async function settleSpecSnapshot(options) {
 }
 
 // src/board/spec-source.ts
-var PREFIX6 = "board spec source";
+var PREFIX8 = "board spec source";
 var SOURCE_FLAGS = [SPEC_FLAG, ISSUE_FLAG, NEXT_FLAG];
 var SOURCE_REFUSAL_EXIT = 1;
 function severalSourcesMessage(given) {
@@ -7809,6 +8337,15 @@ function roadmapHeaderLine(roadmap) {
 function skipLine(skip) {
   return `   \u23ED  ${skipSentence(skip)}`;
 }
+function descentPassLine(pass) {
+  return `   \u23ED  ${descentPassSentence(pass)}`;
+}
+function epicHeaderLine(epic) {
+  return `   \uD83E\uDDED ${epicHeaderSentence(epic)}`;
+}
+function labelOnlyLine(epic, member) {
+  return `   \uD83C\uDFF7  ${labelOnlySentence(epic, member)}`;
+}
 function pickLine(line) {
   const id = `\u25B6 Next on the roadmap: issue #${String(line.issue)}`;
   return line.why === "" ? id : `${id} \u2014 ${line.why}`;
@@ -7864,7 +8401,7 @@ async function settleBlockedPick(options) {
 async function pickRoadmapIssue(request, options, issues, output) {
   const seams = options.roadmap;
   if (seams === undefined) {
-    throw new TypeError(`${PREFIX6}: ${NEXT_FLAG} was resolved with no roadmap seams`);
+    throw new TypeError(`${PREFIX8}: ${NEXT_FLAG} was resolved with no roadmap seams`);
   }
   const roadmap = await resolveRoadmapIssue({
     configured: request.roadmap ?? seams.configured,
@@ -7880,15 +8417,29 @@ async function pickRoadmapIssue(request, options, issues, output) {
     branches,
     pullRequests: seams.pullRequests
   });
-  const lines = parseRoadmapBody(read.body);
-  const pick = await pickNextRoadmapLine(lines, readings);
-  pick.skipped.forEach((skip) => output.info(skipLine(skip)));
+  const walked = await pickDescendedLine(parseRoadmapBody(read.body), { issues, readings, listing: seams.listing });
+  printDescent(walked, output);
+  const { descent, pick } = walked;
+  if (descent.epic !== null && walked.dry) {
+    output.info(dryEpicSentence(descent.epic));
+    return { stop: "exhausted" };
+  }
   if (pick.line === null) {
-    output.info(exhaustedMessage(roadmap, pick.skipped));
+    output.info(exhaustedMessage(roadmap, [...descent.passed, ...pick.skipped]));
     return { stop: "exhausted" };
   }
   output.info(pickLine(pick.line));
-  return settlePick(pick.line, { lines, issues, readings, seams, output });
+  return settlePick(pick.line, { lines: descent.lines, issues, readings, seams, output });
+}
+function printDescent(walked, output) {
+  const { descent, pick } = walked;
+  descent.passed.forEach((pass) => output.info(descentPassLine(pass)));
+  const { epic } = descent;
+  if (epic !== null) {
+    output.info(epicHeaderLine(epic));
+    epic.labelOnly.forEach((member) => output.info(labelOnlyLine(epic, member)));
+  }
+  pick.skipped.forEach((skip) => output.info(skipLine(skip)));
 }
 async function settlePick(line, settlement) {
   const { issues } = settlement;
@@ -8034,6 +8585,7 @@ async function resolvePlanSpec(options) {
       search: createGhRoadmapSearch({ gh }),
       git,
       pullRequests: createGhOpenPullRequests({ gh }),
+      listing: createGhBoardListing({ gh }),
       inspectRoadmap: (issue3) => inspectRoadmapIssue(issue3, trust()),
       offerAlternative: alternative
     },
@@ -8399,7 +8951,7 @@ function compareUrl(remote, branch) {
   return `https://${segments[0] ?? host}/${path2}/compare/${encodeBranch(branch)}${COMPARE_QUERY}`;
 }
 // src/pr/gh.ts
-var PREFIX7 = "gh pull requests";
+var PREFIX9 = "gh pull requests";
 var REPO_PATH3 = "{owner}/{repo}";
 var SUMMARY_FIELDS = "author,baseRefName,headRefName,isCrossRepository,number,state,title,updatedAt,url";
 var DETAIL_FIELDS = `${SUMMARY_FIELDS},body,headRefOid,labels,mergeStateStatus,mergeable`;
@@ -8423,23 +8975,23 @@ var MERGEABILITY = new Map([
   ["CONFLICTING", "conflicting"],
   ["UNKNOWN", "unknown"]
 ]);
-function detailOf5(result, command) {
+function detailOf6(result, command) {
   const written = result.stderr.trim() || result.stdout.trim();
   if (written !== "")
     return written;
   return result.ok ? `${command} exited 0 and wrote nothing` : `${command} exited non-zero and wrote nothing`;
 }
 function failure2(command, result) {
-  return new Error(`${PREFIX7}: ${command} failed: ${detailOf5(result, command)}`);
+  return new Error(`${PREFIX9}: ${command} failed: ${detailOf6(result, command)}`);
 }
 function refuse3(command, problem) {
-  throw new Error(`${PREFIX7}: ${command} answered ${problem}`);
+  throw new Error(`${PREFIX9}: ${command} answered ${problem}`);
 }
 function parseJson2(stdout, command) {
   try {
     return JSON.parse(stdout);
   } catch (error) {
-    throw new Error(`${PREFIX7}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
+    throw new Error(`${PREFIX9}: ${command} wrote output that is not JSON: ${messageOf(error)}`, { cause: error });
   }
 }
 function readString2(value, command, where) {
@@ -8551,7 +9103,7 @@ function readWorkflowCount(stdout) {
 }
 function pullNumber(value, member) {
   if (!Number.isSafeInteger(value) || value < 1) {
-    throw new TypeError(`${PREFIX7}: ${member} refused pull request number ${describeValue(value)},` + " expected a positive whole number");
+    throw new TypeError(`${PREFIX9}: ${member} refused pull request number ${describeValue(value)},` + " expected a positive whole number");
   }
   return String(value);
 }
@@ -8559,13 +9111,13 @@ function textArgument(value, member, what, whole) {
   const bad = typeof value !== "string" || value === "" || whole && !(WHOLE_NUMBER.test(value) && Number.isSafeInteger(Number(value)));
   if (bad) {
     const expected2 = whole ? "a positive whole number with no leading zero" : "a non-empty string";
-    throw new TypeError(`${PREFIX7}: ${member} refused ${what} ${describeValue(value)}, expected ${expected2}`);
+    throw new TypeError(`${PREFIX9}: ${member} refused ${what} ${describeValue(value)}, expected ${expected2}`);
   }
   return value;
 }
 function bodyText(value, member) {
   if (typeof value !== "string") {
-    throw new TypeError(`${PREFIX7}: ${member} refused a body ${describeValue(value)}, expected a string`);
+    throw new TypeError(`${PREFIX9}: ${member} refused a body ${describeValue(value)}, expected a string`);
   }
   return value;
 }
@@ -8641,11 +9193,11 @@ function createGhPullRequests(options) {
     merge: async (number, method) => {
       const target = pullNumber(number, "merge");
       if (!isMergeMethod(method)) {
-        throw new TypeError(`${PREFIX7}: merge refused method ${describeValue(method)},` + ` expected one of: ${MERGE_METHODS.join(", ")}`);
+        throw new TypeError(`${PREFIX9}: merge refused method ${describeValue(method)},` + ` expected one of: ${MERGE_METHODS.join(", ")}`);
       }
       const command = `gh pr merge ${target} --${method}`;
       const result = await gh(["pr", "merge", target, `--${method}`]);
-      return { merged: result.ok, detail: detailOf5(result, command) };
+      return { merged: result.ok, detail: detailOf6(result, command) };
     },
     editBody: async (number, body) => {
       const target = pullNumber(number, "editBody");
@@ -9144,7 +9696,7 @@ function etaLine(eta) {
 }
 
 // src/next/sources.ts
-var PREFIX8 = "rafa next";
+var PREFIX10 = "rafa next";
 var DEFAULT_BASE_BRANCH = "main";
 var DEFAULT_NEXT_SOURCE_SEAMS = Object.freeze({});
 function memoiseIssues2(issues) {
@@ -9168,11 +9720,15 @@ function ghNextBoard(options) {
         branches,
         pullRequests: createGhOpenPullRequests({ gh })
       });
-      const pick = await pickNextRoadmapLine(parseRoadmapBody(read.body), readings);
+      const { descent, pick } = await pickDescendedLine(parseRoadmapBody(read.body), {
+        issues,
+        readings,
+        listing: createGhBoardListing({ gh })
+      });
       return {
         roadmap,
         line: pick.line,
-        passed: pick.skipped.length,
+        passed: descent.passed.length + pick.skipped.length,
         problems: branches.problems
       };
     },
@@ -9182,7 +9738,7 @@ function ghNextBoard(options) {
 }
 function nextProject(context) {
   if (context.project === null)
-    throw new Error(`${PREFIX8} runs inside a project, and was handed none`);
+    throw new Error(`${PREFIX10} runs inside a project, and was handed none`);
   return context.project;
 }
 function nextConfig(project, warn) {
@@ -9192,7 +9748,7 @@ function nextConfig(project, warn) {
     if (!(error instanceof ConfigError))
       throw error;
     throw new CommandExit(1, [
-      `\u274C ${PREFIX8}: the config cannot be used:`,
+      `\u274C ${PREFIX10}: the config cannot be used:`,
       ...error.problems.map((problem) => `   ${problem}`)
     ].join(`
 `));
@@ -9368,7 +9924,7 @@ function branchLabel(world) {
 }
 
 // src/next/state.ts
-var PREFIX9 = "rafa next";
+var PREFIX11 = "rafa next";
 var MAX_NAMED_FILES = 5;
 var NEXT_PRECONDITIONS = Object.freeze([
   "tree-modified",
@@ -9646,7 +10202,7 @@ async function readNextState(sources) {
     if (found !== null)
       return answer(found, world.problems());
   }
-  throw new Error(`${PREFIX9}: no row of the table answered, and the last row answers for every reading`);
+  throw new Error(`${PREFIX11}: no row of the table answered, and the last row answers for every reading`);
 }
 
 // src/next/hint.ts
@@ -9727,17 +10283,17 @@ async function nextStepHint(context, seams = DEFAULT_HINT_SEAMS) {
 }
 
 // src/next/actions.ts
-var PREFIX10 = "rafa next";
+var PREFIX12 = "rafa next";
 function needed(state, value, what) {
   if (value === null) {
-    throw new Error(`${PREFIX10}: state "${state.id}" proposes "${state.action}" and names no ${what}`);
+    throw new Error(`${PREFIX12}: state "${state.id}" proposes "${state.action}" and names no ${what}`);
   }
   return String(value);
 }
 function pullRequestOf(state) {
   return needed(state, state.pullRequest, "pull request");
 }
-function issueOf2(state) {
+function issueOf3(state) {
   return needed(state, state.issue, "issue");
 }
 function planFlagOf(state) {
@@ -9751,8 +10307,8 @@ var ACTION_COMMANDS = Object.freeze({
   "merge-unchecked": { subject: "pr", action: "merge", argv: (state) => [pullRequestOf(state), "--skip-checks"] },
   start: { subject: "loop", action: "start", argv: (state) => [planFlagOf(state), "--create-branch"] },
   plan: { subject: "plan", action: "create", argv: () => ["--next"] },
-  unblock: { subject: "issue", action: "unblock", argv: (state) => [issueOf2(state)] },
-  ready: { subject: "issue", action: "ready", argv: (state) => [issueOf2(state)] }
+  unblock: { subject: "issue", action: "unblock", argv: (state) => [issueOf3(state)] },
+  ready: { subject: "issue", action: "ready", argv: (state) => [issueOf3(state)] }
 });
 var NEXT_COMMAND_ACTIONS = Object.freeze(Object.keys(ACTION_COMMANDS));
 function runsCommand(action) {
@@ -9780,12 +10336,12 @@ function actionContext(caller, command, argv) {
 async function runAction(caller, state) {
   const invocation = actionInvocation(state);
   if (invocation === null) {
-    throw new Error(`${PREFIX10}: the action "${state.action}" of state "${state.id}" runs no registered command`);
+    throw new Error(`${PREFIX12}: the action "${state.action}" of state "${state.id}" runs no registered command`);
   }
   const spec = ACTION_COMMANDS[invocation.action];
   const command = caller.registry.find(spec.subject, spec.action);
   if (command === undefined) {
-    throw new CommandExit(1, `\u274C ${PREFIX10}: the "${invocation.action}" step runs "rafa ${invocation.command}", which is registered by nothing`);
+    throw new CommandExit(1, `\u274C ${PREFIX12}: the "${invocation.action}" step runs "rafa ${invocation.command}", which is registered by nothing`);
   }
   await command.run(actionContext(caller, command, invocation.argv));
 }
@@ -9833,7 +10389,7 @@ function endingWith(command, seams = DEFAULT_ENDING_SEAMS) {
 }
 
 // src/adapters/tracker/resolve.ts
-var PREFIX11 = "tracker chain";
+var PREFIX13 = "tracker chain";
 var FAILURE_SEPARATOR = "; ";
 function warnThroughActiveOutput(message) {
   activeOutput().warn(message);
@@ -9874,9 +10430,9 @@ async function resolveTracker(options) {
     }
     attempts = [...attempts, Object.freeze({ kind, ok: false, reason: outcome.reason })];
     failures = [...failures, `${kind}: ${outcome.reason}`];
-    log(`${PREFIX11}: ${kind} unavailable: ${outcome.reason}`);
+    log(`${PREFIX13}: ${kind} unavailable: ${outcome.reason}`);
   }
-  throw new Error(`${PREFIX11}: no tracker available; tried ${failures.join(FAILURE_SEPARATOR)}`);
+  throw new Error(`${PREFIX13}: no tracker available; tried ${failures.join(FAILURE_SEPARATOR)}`);
 }
 
 // src/commands/issue/issue-tracker.ts
@@ -9993,6 +10549,22 @@ function unaskedMessage2(issue3) {
   const number = String(issue3);
   return `#${number} is ready to mark; there is no terminal to ask on, so ${SPEC_READY_LABEL} was not added.` + ` Run rafa issue ready ${number} where an answer can be typed`;
 }
+function requireOneEpic(found) {
+  const listed = {
+    number: found.number,
+    title: found.title,
+    body: found.body,
+    state: found.state,
+    stateReason: null,
+    labels: found.labels,
+    type: typeOfLabels(found.labels),
+    module: moduleOfLabels(found.labels)
+  };
+  const several = readEpicProblems([listed]).find((problem) => problem.kind === "several-epic-labels");
+  if (several === undefined)
+    return;
+  throw new CommandExit(READINESS_REFUSAL_EXIT, `issue #${String(found.number)} cannot be marked ${SPEC_READY_LABEL}: ${epicProblemMessage(several)}`);
+}
 function readyReport(issue3, status, reading2, lines) {
   return Object.freeze({
     issue: issue3,
@@ -10011,6 +10583,7 @@ async function runIssueReady(options) {
   const found = await readIssue(issue3);
   const reading2 = await requireTrustedBoardAuthor({ kind: "issue", number: issue3 }, trust, found.author);
   requireCompleteSpec(issueSource(issue3), found.body);
+  requireOneEpic(found);
   const lines = { trust: trustPassLine(issue3, trust.repo, reading2), checked: completeLine(issue3) };
   if (hasSpecReadyLabel(found.labels)) {
     return readyReport(issue3, "already", reading2, {
@@ -10104,7 +10677,7 @@ function createIssueReadyCommand(seams = DEFAULT_READY_SEAMS) {
     subject: "issue",
     action: "ready",
     summary: `mark an issue ${SPEC_READY_LABEL} once its author and its body check out`,
-    description: "Reads the issue on the GitHub board, refuses one opened by an account without write access to" + " the repository, refuses a body that does not fill the spec template, and then asks whether to mark it" + ` ${SPEC_READY_LABEL}. On a yes it swaps the labels in one write, adding ${SPEC_READY_LABEL} and` + ` removing ${SPEC_NEEDS_WORK_LABEL}. It always asks and declares no flag that skips the question;` + " without a terminal it prints both readings and adds no label. A run that marks the issue, or finds" + " it marked already, ends by naming the one step that follows, which `--no-hint` turns off. With" + " `--output=json` the report is the data of the terminal result event.",
+    description: "Reads the issue on the GitHub board, refuses one opened by an account without write access to" + " the repository, refuses a body that does not fill the spec template, refuses an issue carrying two" + " `epic:` labels, and then asks whether to mark it" + ` ${SPEC_READY_LABEL}. On a yes it swaps the labels in one write, adding ${SPEC_READY_LABEL} and` + ` removing ${SPEC_NEEDS_WORK_LABEL}. It always asks and declares no flag that skips the question;` + " without a terminal it prints both readings and adds no label. A run that marks the issue, or finds" + " it marked already, ends by naming the one step that follows, which `--no-hint` turns off. With" + " `--output=json` the report is the data of the terminal result event.",
     args: [
       {
         name: "n",
@@ -10788,12 +11361,12 @@ var SENTENCE_ABBREVIATIONS = ["e.g", "i.e", "vs", "cf", "etc"];
 function isFilled2(value) {
   return typeof value === "string" && value.trim() !== "";
 }
-function bodyLines(body) {
+function bodyLines2(body) {
   return body.split(`
 `).map((line) => line.replace(/\r$/, ""));
 }
 function bodySections(body) {
-  const lines = bodyLines(body);
+  const lines = bodyLines2(body);
   const headings = [];
   let fenced = false;
   lines.forEach((line, index) => {
@@ -10835,7 +11408,7 @@ function numberedRuns(body) {
       runs.push({ steps, line });
     steps = 0;
   };
-  bodyLines(body).forEach((text, index) => {
+  bodyLines2(body).forEach((text, index) => {
     if (FENCE_LINE4.test(text)) {
       fenced = !fenced;
       return;
@@ -10923,7 +11496,7 @@ function firstSection(sections2, heading) {
 function withoutFences(text) {
   const kept = [];
   let fenced = false;
-  for (const line of bodyLines(text)) {
+  for (const line of bodyLines2(text)) {
     if (FENCE_LINE4.test(line)) {
       fenced = !fenced;
       continue;
@@ -10982,7 +11555,7 @@ function extractedDate(body) {
 }
 function errorString(body) {
   let fenced = false;
-  for (const line of bodyLines(body)) {
+  for (const line of bodyLines2(body)) {
     if (FENCE_LINE4.test(line)) {
       fenced = !fenced;
       continue;
@@ -12417,7 +12990,7 @@ async function storeTaskReport(options) {
 // src/start/pause.ts
 var PAUSE_POLL_MS = 1000;
 var OWN_PID = () => true;
-function storedState(repoRoot, sessionId) {
+function storedState2(repoRoot, sessionId) {
   try {
     return readSession(repoRoot, sessionId, { isAlive: OWN_PID }).state;
   } catch (error) {
@@ -12438,7 +13011,7 @@ async function holdWhilePaused(options) {
   const { repoRoot, sessionId, isInterrupted } = options;
   const sleep = options.seams?.sleep ?? ((ms) => Bun.sleep(ms));
   const pollMs = options.seams?.pollMs ?? PAUSE_POLL_MS;
-  const first = storedState(repoRoot, sessionId);
+  const first = storedState2(repoRoot, sessionId);
   if (first === null)
     return "unreadable";
   if (first !== "paused")
@@ -12452,7 +13025,7 @@ async function holdWhilePaused(options) {
     await sleep(pollMs);
     if (isInterrupted())
       return "interrupted";
-    const state = storedState(repoRoot, sessionId);
+    const state = storedState2(repoRoot, sessionId);
     if (state === null)
       return "unreadable";
     if (state !== "paused") {
@@ -14981,7 +15554,7 @@ function parsedJson(text) {
     return;
   }
 }
-function issueOf3(payload) {
+function issueOf4(payload) {
   const title = field4(payload, "title");
   const body = field4(payload, "body");
   const state = field4(payload, "state");
@@ -15000,7 +15573,7 @@ function ghIssueReader(gh) {
         return { kind: "missing" };
       return { kind: "failed", detail: result.stderr.trim() || result.stdout.trim() || "gh exited non-zero and wrote nothing" };
     }
-    return issueOf3(parsedJson(result.stdout)) ?? { kind: "failed", detail: `gh issue view ${String(number)} answered no title, body and state` };
+    return issueOf4(parsedJson(result.stdout)) ?? { kind: "failed", detail: `gh issue view ${String(number)} answered no title, body and state` };
   };
 }
 function exportedNames(payload) {
@@ -15320,8 +15893,8 @@ function issueTitle(redactedWhat) {
   const kept = points.slice(0, TITLE_MAX_LENGTH - TITLE_CUT.length).join("");
   return `${kept.trimEnd()}${TITLE_CUT}`;
 }
-function section(heading, value, absent, redact) {
-  const shown = value === null ? absent : fenced(redact(value));
+function section(heading, value, absent2, redact) {
+  const shown = value === null ? absent2 : fenced(redact(value));
   return `## ${heading}
 
 ${shown}`;
@@ -16297,6 +16870,73 @@ import { homedir as homedir7 } from "os";
 import path6 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
+// src/board/epic-context.ts
+var EPIC_TYPE_LABEL = "type:epic";
+var EPIC_CONTEXT_LIMIT = 20;
+var PREFIX14 = "epic context";
+function epicContextArgs(slug) {
+  return Object.freeze([
+    "issue",
+    "list",
+    "--state",
+    "all",
+    "--label",
+    EPIC_TYPE_LABEL,
+    "--label",
+    `${EPIC_LABEL_PREFIX}${slug}`,
+    "--limit",
+    String(EPIC_CONTEXT_LIMIT),
+    "--json",
+    BOARD_LIST_FIELDS
+  ]);
+}
+function numbersOf(numbers) {
+  return numbers.map((number) => `#${String(number)}`).join(", ");
+}
+async function findEpic(slug, options, output) {
+  const id = `issue #${String(options.issue)}`;
+  const label = `${EPIC_LABEL_PREFIX}${slug}`;
+  const args = epicContextArgs(slug);
+  const command = `gh ${args.join(" ")}`;
+  const result = await options.gh(args);
+  if (!result.ok) {
+    const written = result.stderr.trim() || result.stdout.trim() || "nothing";
+    output.warn(`${PREFIX14}: ${command} failed (${written}); ${id} is planned without its epic`);
+    return null;
+  }
+  let epics;
+  try {
+    epics = parseBoardListing(result.stdout, command);
+  } catch (error) {
+    output.warn(`${PREFIX14}: ${messageOf(error)}; ${id} is planned without its epic`);
+    return null;
+  }
+  const [epic, ...others] = epics;
+  if (epic === undefined) {
+    output.warn(`${PREFIX14}: ${id} carries "${label}" but no "${EPIC_TYPE_LABEL}" issue does; it is planned without an epic`);
+    return null;
+  }
+  if (others.length > 0) {
+    const found = numbersOf(epics.map((each) => each.number));
+    output.warn(`${PREFIX14}: ${id} carries "${label}" and ${String(epics.length)} epics carry it (${found}); it is planned without an epic`);
+    return null;
+  }
+  return Object.freeze({ number: epic.number, title: epic.title, slug, criteria: readEpicBody(epic.body).criteria });
+}
+async function readEpicContext(options) {
+  const slugs = epicSlugsOf(options.labels);
+  const [slug, ...others] = slugs;
+  if (slug === undefined)
+    return null;
+  const output = options.output ?? activeOutput();
+  if (others.length > 0) {
+    const labels = slugs.map((each) => `"${EPIC_LABEL_PREFIX}${each}"`).join(", ");
+    output.warn(`${PREFIX14}: issue #${String(options.issue)} carries ${String(slugs.length)} epic labels (${labels}); it is planned without an epic`);
+    return null;
+  }
+  return findEpic(slug, options, output);
+}
+
 // src/commands/plan/plan-record.ts
 import fs2 from "fs";
 import path3 from "path";
@@ -16525,7 +17165,7 @@ async function enforceRefsGate(options) {
 // src/commands/plan/refs-check.ts
 async function coreRoster() {
   const [{ CORE_REGISTRY }, { describeRegistry }] = await Promise.all([
-    import("./index-kv51t295.js"),
+    import("./index-gzr2gtmh.js"),
     import("./describe-0tefrkk7.js")
   ]);
   return describeRegistry(CORE_REGISTRY, version);
@@ -16821,6 +17461,43 @@ function formatSkillIndexSection(index) {
 function readPlanSkillIndex(repoRoot, home, settings, entry) {
   return renderSkillIndex(resolveSessionTiers({ root: repoRoot, home, settings, entry }));
 }
+var EPIC_CONTEXT_HEADING = "## Epic (the epic this spec belongs to)";
+function formatEpicContextSection(epic) {
+  if (epic === null)
+    return "";
+  const named = `This spec belongs to epic #${String(epic.number)}, "${epic.title}" (\`epic:${epic.slug}\`).`;
+  if (epic.criteria === null) {
+    return [
+      "",
+      "",
+      EPIC_CONTEXT_HEADING,
+      "",
+      named,
+      "Its body holds no acceptance criteria section, so there is none to carry into the plan."
+    ].join(`
+`);
+  }
+  return [
+    "",
+    "",
+    EPIC_CONTEXT_HEADING,
+    "",
+    named,
+    "Carry the epic's acceptance criteria below, verbatim, into the plan's `rafa:context` block,",
+    "under a line naming the epic, so every task is shown them; plan the spec so that it serves",
+    "them, and name in the plan any criterion the spec leaves to another issue of the epic.",
+    "",
+    "### Acceptance criteria",
+    "",
+    epic.criteria
+  ].join(`
+`);
+}
+async function readPlanEpicContext(spec, gh) {
+  if (spec.read === null)
+    return null;
+  return readEpicContext({ issue: spec.read.number, labels: spec.read.labels, gh });
+}
 var PLAN_PROMPT_SLOTS = [
   "PLAN_FILE",
   "PREREQUISITES_FILE",
@@ -16828,10 +17505,11 @@ var PLAN_PROMPT_SLOTS = [
   "PLAN_FORMAT",
   "ROUTING",
   "SKILL_INDEX",
+  "EPIC_CONTEXT",
   "SPEC_CONTENT"
 ];
 var SLOT_PATTERN = new RegExp(`\\{(${PLAN_PROMPT_SLOTS.join("|")})\\}`, "g");
-function buildPlanPrompt(template, planFormat, specContent, stub, planDir, progressContent, routing = DEFAULT_ROUTING, skillIndex = "") {
+function buildPlanPrompt(template, planFormat, specContent, stub, planDir, progressContent, routing = DEFAULT_ROUTING, skillIndex = "", epic = null) {
   const values = {
     PLAN_FILE: planFilePath(planDir, `PLAN-${stub}.md`),
     PREREQUISITES_FILE: planFilePath(planDir, `PREREQUISITES-${stub}.md`),
@@ -16839,6 +17517,7 @@ function buildPlanPrompt(template, planFormat, specContent, stub, planDir, progr
     PLAN_FORMAT: planFormatBody(planFormat),
     ROUTING: formatRoutingSection(routing),
     SKILL_INDEX: formatSkillIndexSection(skillIndex),
+    EPIC_CONTEXT: formatEpicContextSection(epic),
     SPEC_CONTENT: specContent
   };
   return template.replace(SLOT_PATTERN, (_slot, name2) => values[name2]);
@@ -16898,6 +17577,7 @@ async function plan(args, repoRoot, registry = CORE_ADAPTER_REGISTRY) {
   if (progressContent?.trim()) {
     activeOutput().info("\uD83D\uDCCE Including findings from progress.txt (disable with --no-progress).");
   }
+  const epic = await readPlanEpicContext(resolved.spec, createGhRunner({ cwd: repoRoot }));
   const template = fs4.readFileSync(path6.join(__dirname3, "plan-prompt.md"), "utf8");
   const planFormat = readPlanFormat(__dirname3);
   const skillIndex = readPlanSkillIndex(repoRoot, home, config, fileURLToPath2(import.meta.url));
@@ -16905,7 +17585,7 @@ async function plan(args, repoRoot, registry = CORE_ADAPTER_REGISTRY) {
     repoRoot,
     planDir,
     settingSources,
-    planPrompt: (specContent, planStub2) => buildPlanPrompt(template, planFormat, specContent, planStub2, planDir, progressContent, routing, skillIndex)
+    planPrompt: (specContent, planStub2) => buildPlanPrompt(template, planFormat, specContent, planStub2, planDir, progressContent, routing, skillIndex, epic)
   });
   const gate = {
     source: resolved.spec.source,
@@ -16934,4 +17614,4 @@ async function plan(args, repoRoot, registry = CORE_ADAPTER_REGISTRY) {
   }
 }
 
-export { readConfigFile, loadConfig, planStubsFromFileNames, resolvePlanStub, SERVE_CLI_VERSION, SCOPE_DIR, INIT_COMMAND, DISK_FILE_SYSTEM, ScopeError, scopeAt, initHint, selfAndAncestors, resolveScope, SessionRecordError, runsDir, errorCode, readSessions, readSession, PROVENANCE_FIELD, SKILL_FILE2 as SKILL_FILE, provenanceBlock, serveVerdict, SKILL_USE_CLI_VERSION, sessionLogDir, collectSessionRow, collect, AGENT_DEFINITION_DIR, VENDOR_COMMAND, readAgentDirectory, resolveAgentRoster, missingPlanAgents, isStackList, stackPaths, stacksFromEccSkillName, DESCRIPTION_LIMIT, LISTING_LIMIT, SKILL_SIGNALS, countCharacters, toolOf, pathDirectories, checkReferences, checkFile, checkDirectory, bundledAgentsDirectory, sourceItem, byName, skillItem, readTrees, verdictOf, failingRows, formatRows, waitForChecks, recordPlanCi, report, name, version, MANIFEST_VERSION, FEATURE_TYPES, OUTPUT_CHANNELS, RUNNING_MANIFEST_SEAMS, validateManifest, plansDirAt, requireProject, resolvePlansDir, resolveProjectConfig, countTasks, formatCounts, checkbox, planFileName, stubOfPlanFile, isFile, issueLine, plural, expectNoArgument, expectOneArgument, expectAtMostOneArgument, readSwitch, validate_default, SPEC_READY_LABEL, TEMPLATE_HEADINGS, findReadinessGaps, hasSpecReadyLabel, createGhPermissions, readAuthorTrust, trustRefusalClause, requireTrustedAuthor, SPEC_NEEDS_WORK_LABEL, SPEC_BLOCKED_LABEL, hasSpecBlockedLabel, readBlockedBy, blockedFaultMessage, UNREADABLE, RefsBlockError, fingerprintText, readRefsText, readCopyRefs, restampCopyRefs, createGitRunner, gitSaid, RefVerifyError, ghIssueReader, tsSymbolsOutliner, createRefVerifier, createGhIssueBoard, ID_PREFIX, BRANCH_PREFIX, SPEC_EXTENSION, boardId, notesFileName, PREVIOUS_COPY_WARN_ABOVE, previousDir, countPreviousCopies, SPEC_LABEL, createGhSpecIssueReader, ROADMAP_TITLE, ROADMAP_SETTING, ROADMAP_REFUSAL_EXIT, parseRoadmapBody, createGhRoadmapSearch, severalRoadmapsMessage, resolveRoadmapIssue, createGhOpenPullRequests, closedIssuesIn, branchClaims, scanClaimBranches, blockedLineSentence, memoiseVerifier, LEARNED_DIRECTORY, ORIGIN_FIELD, DEMOTION_VERDICTS, WHEN_TO_USE_HEADING, bodySections, classifySkill, firstSentence, convertToInstinct, readPlanChanges, rankCandidates, readRankCandidate, shellQuote, ghMissingMessage, ghUnauthenticatedMessage, ghHostOf, ghPreflightItems, resolvePrProvider, requireGhProvider, isFirstDispatch, SESSION_ID_FLAG2 as SESSION_ID_FLAG, resolveLoopSeams, sessionIdFlag, refusal2 as refusal, isLive, planLabel, sessionLine, projectRoot, readRecords, pickSession, writeSession, readSessionChecklist, checkboxAt, estimateEta, readSessionFinishes, etaLine, parseWorkingTree, parseWorktrees, readMergeRefusal, cleanUpSteps, commandLine, remainingFrom, createGhPullRequests, ghPullRequestsIn, DEFAULT_BASE_BRANCH, ghNextBoard, openNextSources, createLinePrompter, REMOTE, parseBaseStanding, hasDiverged, list_default, readBranch, readPlans, readOpenPull, readBranchPlan, readNextState, commandWords, nextQuestion, NEXT_COMMAND_ACTIONS, actionInvocation, runAction, HINT_FLAG_SPEC, actionOutput, endWithNextStep, endingWith, DEFAULT_ISSUE_SEAMS, lineRefusal2 as lineRefusal, expectTwoArguments, readTextFlag, readNonBlankFlag, readRequiredFlag, readChoice, readChoiceFlag, issueProject, issueSubjectConfig, resolveIssueTracker, issueRef, issueName, urlLines, onTracker, lazyPrompter, ready_default, versionLine, DEFAULT_PLAN_FILE, resolvePlanPath, assessPlanRisk, renderRiskText, announceRiskTotal, resolveCreateSpec, resolveReleaseEnabled, TRIAGE_MODULE, DEFAULT_CI_TIMEOUT_MIN, CI_POLL_INTERVAL_MS, DEFAULT_CI_ATTEMPTS, RUNTIME_SUBDIR, RUNTIME_ENTRY, VERSION_SHAPE2 as VERSION_SHAPE, refuseMisplacedRuntime, groupChangeNotes, renderNoteLines, highestChangeLevel, parseSemanticVersion, readManifestVersion, MECHANICAL_CONFLICT_SENTENCE, start, usage, coreRoster, createPlanRefsVerifier, plan };
+export { readConfigFile, loadConfig, planStubsFromFileNames, resolvePlanStub, SERVE_CLI_VERSION, SCOPE_DIR, INIT_COMMAND, DISK_FILE_SYSTEM, ScopeError, scopeAt, initHint, selfAndAncestors, resolveScope, SessionRecordError, runsDir, errorCode, readSessions, readSession, PROVENANCE_FIELD, SKILL_FILE2 as SKILL_FILE, provenanceBlock, serveVerdict, SKILL_USE_CLI_VERSION, sessionLogDir, collectSessionRow, collect, AGENT_DEFINITION_DIR, VENDOR_COMMAND, readAgentDirectory, resolveAgentRoster, missingPlanAgents, isStackList, stackPaths, stacksFromEccSkillName, DESCRIPTION_LIMIT, LISTING_LIMIT, SKILL_SIGNALS, countCharacters, toolOf, pathDirectories, checkReferences, checkFile, checkDirectory, bundledAgentsDirectory, sourceItem, byName, skillItem, readTrees, verdictOf, failingRows, formatRows, waitForChecks, recordPlanCi, report, name, version, MANIFEST_VERSION, FEATURE_TYPES, OUTPUT_CHANNELS, RUNNING_MANIFEST_SEAMS, validateManifest, ID_PREFIX, BRANCH_PREFIX, SPEC_EXTENSION, boardId, notesFileName, ROADMAP_TITLE, ROADMAP_SETTING, ROADMAP_REFUSAL_EXIT, parseRoadmapBody, createGhRoadmapSearch, severalRoadmapsMessage, resolveRoadmapIssue, createGhOpenPullRequests, closedIssuesIn, branchClaims, scanClaimBranches, SPEC_BLOCKED_LABEL, hasSpecBlockedLabel, readBlockedBy, blockedFaultMessage, EPIC_LABEL_PREFIX, epicSlugsOf, isNotPlanned, readEpics, BOARD_LISTING_LIMIT, createGhBoardListing, plansDirAt, requireProject, resolvePlansDir, resolveProjectConfig, countTasks, formatCounts, checkbox, planFileName, stubOfPlanFile, isFile, issueLine, plural, expectNoArgument, expectOneArgument, expectAtMostOneArgument, readSwitch, validate_default, SPEC_READY_LABEL, TEMPLATE_HEADINGS, findReadinessGaps, hasSpecReadyLabel, createGhPermissions, readAuthorTrust, trustRefusalClause, requireTrustedAuthor, SPEC_NEEDS_WORK_LABEL, UNREADABLE, RefsBlockError, fingerprintText, readRefsText, readCopyRefs, restampCopyRefs, createGitRunner, gitSaid, RefVerifyError, ghIssueReader, tsSymbolsOutliner, createRefVerifier, createGhIssueBoard, PREVIOUS_COPY_WARN_ABOVE, previousDir, countPreviousCopies, SPEC_LABEL, createGhSpecIssueReader, blockedLineSentence, HORIZON_LABEL_PREFIX, readEpicProblems, epicProblemMessage, isNowEpic, epicLines, memoiseVerifier, LEARNED_DIRECTORY, ORIGIN_FIELD, DEMOTION_VERDICTS, WHEN_TO_USE_HEADING, bodySections, classifySkill, firstSentence, convertToInstinct, readPlanChanges, rankCandidates, readRankCandidate, shellQuote, ghMissingMessage, ghUnauthenticatedMessage, ghHostOf, ghPreflightItems, resolvePrProvider, requireGhProvider, isFirstDispatch, SESSION_ID_FLAG2 as SESSION_ID_FLAG, resolveLoopSeams, sessionIdFlag, refusal2 as refusal, isLive, planLabel, sessionLine, projectRoot, readRecords, pickSession, writeSession, readSessionChecklist, checkboxAt, estimateEta, readSessionFinishes, etaLine, parseWorkingTree, parseWorktrees, readMergeRefusal, cleanUpSteps, commandLine, remainingFrom, createGhPullRequests, ghPullRequestsIn, DEFAULT_BASE_BRANCH, ghNextBoard, openNextSources, createLinePrompter, REMOTE, parseBaseStanding, hasDiverged, list_default, readBranch, readPlans, readOpenPull, readBranchPlan, readNextState, commandWords, nextQuestion, NEXT_COMMAND_ACTIONS, actionInvocation, runAction, HINT_FLAG_SPEC, actionOutput, endWithNextStep, endingWith, DEFAULT_ISSUE_SEAMS, lineRefusal2 as lineRefusal, expectTwoArguments, readTextFlag, readNonBlankFlag, readRequiredFlag, readChoice, readChoiceFlag, issueProject, issueSubjectConfig, resolveIssueTracker, issueRef, issueName, urlLines, onTracker, lazyPrompter, ready_default, versionLine, DEFAULT_PLAN_FILE, resolvePlanPath, assessPlanRisk, renderRiskText, announceRiskTotal, resolveCreateSpec, resolveReleaseEnabled, TRIAGE_MODULE, DEFAULT_CI_TIMEOUT_MIN, CI_POLL_INTERVAL_MS, DEFAULT_CI_ATTEMPTS, RUNTIME_SUBDIR, RUNTIME_ENTRY, VERSION_SHAPE2 as VERSION_SHAPE, refuseMisplacedRuntime, groupChangeNotes, renderNoteLines, highestChangeLevel, parseSemanticVersion, readManifestVersion, MECHANICAL_CONFLICT_SENTENCE, start, usage, coreRoster, createPlanRefsVerifier, plan };