@open-tomato/rafa 0.39.0 → 0.40.0

package/dist/effort/store/index.js

@@ -14,8 +14,8 @@ import {
   openNdjsonStore,
   openSqliteStore,
   selectEffortStore
-} from "../../index-1r2b1052.js";
-import"../../index-m0wt4nr1.js";
+} from "../../index-8veaj0t9.js";
+import"../../index-334y39tn.js";
 import"../../index-d6d0942q.js";
 import"../../index-sr3kc4mf.js";
 import {

package/dist/{index-m0wt4nr1.js → index-334y39tn.js}

@@ -175,6 +175,65 @@ var fragmentsDirectory = (raw, at) => {
   return { value: undefined, problems: [problem], extras: [] };
 };
 
+// src/config-schema-board-project.ts
+var BOARD_PROJECT_RETRIES_MIN = 1;
+var BOARD_PROJECT_RETRIES_MAX = 10;
+var BOARD_PROJECT_RETRY_WAIT_MIN_SECONDS = 1;
+var BOARD_PROJECT_RETRY_WAIT_MAX_SECONDS = 60;
+var BOARD_PROJECT_PROGRESS_MIN_SECONDS = 1;
+var BOARD_PROJECT_PROGRESS_MAX_SECONDS = 300;
+var BOARD_PROJECT_WRITE_BATCH_MIN = 1;
+var BOARD_PROJECT_WRITE_BATCH_MAX = 100;
+var BOARD_PROJECT_WRITE_PAUSE_MIN_MS = 0;
+var BOARD_PROJECT_WRITE_PAUSE_MAX_MS = 60000;
+function isWholeBetween(raw, min, max) {
+  return typeof raw === "number" && Number.isSafeInteger(raw) && raw >= min && raw <= max;
+}
+function rangeWords(min, max) {
+  return `a whole number from ${String(min)} to ${String(max)}`;
+}
+function wholeBetween(min, max) {
+  return (raw, at) => isWholeBetween(raw, min, max) ? { value: raw, problems: [], extras: [] } : refused(at, raw, rangeWords(min, max));
+}
+function offOrWholeBetween(min, max) {
+  return (raw, at) => raw === false || isWholeBetween(raw, min, max) ? { value: raw, problems: [], extras: [] } : refused(at, raw, `false or ${rangeWords(min, max)}`);
+}
+var boardProjectRetries = offOrWholeBetween(BOARD_PROJECT_RETRIES_MIN, BOARD_PROJECT_RETRIES_MAX);
+var boardProjectRetryWaitSeconds = wholeBetween(BOARD_PROJECT_RETRY_WAIT_MIN_SECONDS, BOARD_PROJECT_RETRY_WAIT_MAX_SECONDS);
+var boardProjectProgressSeconds = offOrWholeBetween(BOARD_PROJECT_PROGRESS_MIN_SECONDS, BOARD_PROJECT_PROGRESS_MAX_SECONDS);
+var boardProjectWriteBatchSize = wholeBetween(BOARD_PROJECT_WRITE_BATCH_MIN, BOARD_PROJECT_WRITE_BATCH_MAX);
+var boardProjectWritePauseMs = wholeBetween(BOARD_PROJECT_WRITE_PAUSE_MIN_MS, BOARD_PROJECT_WRITE_PAUSE_MAX_MS);
+var BOARD_PROJECT_LIMIT_DEFAULTS = Object.freeze({
+  boardProjectRetries: 3,
+  boardProjectRetryWaitSeconds: 2,
+  boardProjectProgressSeconds: 10,
+  boardProjectWriteBatchSize: 20,
+  boardProjectWritePauseMs: 1000
+});
+var BOARD_PROJECT_LIMIT_SETTINGS = {
+  boardProjectRetries: { key: "board.project.retries", read: boardProjectRetries, cli: false },
+  boardProjectRetryWaitSeconds: {
+    key: "board.project.retryWaitSeconds",
+    read: boardProjectRetryWaitSeconds,
+    cli: false
+  },
+  boardProjectProgressSeconds: {
+    key: "board.project.progressSeconds",
+    read: boardProjectProgressSeconds,
+    cli: false
+  },
+  boardProjectWriteBatchSize: {
+    key: "board.project.writeBatchSize",
+    read: boardProjectWriteBatchSize,
+    cli: false
+  },
+  boardProjectWritePauseMs: {
+    key: "board.project.writePauseMs",
+    read: boardProjectWritePauseMs,
+    cli: false
+  }
+};
+
 // src/config-schema-hub.ts
 var HUB_TIMEOUT_MIN_SECONDS = 1;
 var HUB_TIMEOUT_MAX_SECONDS = 30;
@@ -569,6 +628,7 @@ var CONFIG_DEFAULTS = Object.freeze({
   boardRelationships: "labels",
   boardProjectTemplate: BOARD_PROJECT_TEMPLATE_DEFAULT,
   boardProjectNumber: null,
+  ...BOARD_PROJECT_LIMIT_DEFAULTS,
   roadmapIssue: null,
   claimsStaleAfter: "3d",
   claimsAhead: "off",
@@ -659,6 +719,7 @@ var SETTINGS = {
   },
   boardProjectTemplate: { key: "board.project.template", read: projectUrl, cli: false },
   boardProjectNumber: { key: "board.project.number", read: projectNumber, cli: false },
+  ...BOARD_PROJECT_LIMIT_SETTINGS,
   roadmapIssue: { key: "roadmap.issue", read: issueNumber, cli: false },
   claimsStaleAfter: { key: "claims.staleAfter", read: claimsStaleAfter, cli: false },
   claimsAhead: { key: "claims.ahead", read: claimsAhead, cli: false },
@@ -797,6 +858,11 @@ function readLayer(rawOf, atOf) {
     boardRelationships: read("boardRelationships"),
     boardProjectTemplate: read("boardProjectTemplate"),
     boardProjectNumber: read("boardProjectNumber"),
+    boardProjectRetries: read("boardProjectRetries"),
+    boardProjectRetryWaitSeconds: read("boardProjectRetryWaitSeconds"),
+    boardProjectProgressSeconds: read("boardProjectProgressSeconds"),
+    boardProjectWriteBatchSize: read("boardProjectWriteBatchSize"),
+    boardProjectWritePauseMs: read("boardProjectWritePauseMs"),
     roadmapIssue: read("roadmapIssue"),
     claimsStaleAfter: read("claimsStaleAfter"),
     claimsAhead: read("claimsAhead"),

package/dist/{index-1r2b1052.js → index-8veaj0t9.js}

@@ -15,7 +15,7 @@ import {
   parseConfigText,
   readRafaBlocks,
   resolveConfig
-} from "./index-m0wt4nr1.js";
+} from "./index-334y39tn.js";
 import {
   bless,
   merge
@@ -259,7 +259,7 @@ import { Database as Database2 } from "bun:sqlite";
 
 // package.json
 var name = "@open-tomato/rafa";
-var version = "0.39.0";
+var version = "0.40.0";
 
 // src/cli/version.ts
 var RAFA_VERSION = version;

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

@@ -41,7 +41,6 @@ import {
   ORIGIN_FIELD,
   PREVIOUS_COPY_WARN_ABOVE,
   PROJECT_SCOPE_FIX,
-  PROJECT_WRITE_PAUSE_MS,
   PROVENANCE_FIELD,
   REASON_FLAG,
   RELEASE_BASE_BRANCH,
@@ -111,6 +110,8 @@ import {
   closedIssuesIn,
   collect,
   collectSessionRow,
+  commandProgressFeed,
+  commandRetrySeams,
   commandWords,
   compareVersions,
   configuredMoveRelations,
@@ -220,11 +221,14 @@ import {
   noBoardListsLine,
   normaliseReason,
   notFoundWarning,
+  notRefreshedWarning,
   notesFileName,
   onTracker,
   openBoards,
   openNextRelations,
   openNextSources,
+  openPhase,
+  openProjectRunner,
   parseBaseStanding,
   parseClaimMessage,
   parseReportArgs,
@@ -361,6 +365,7 @@ import {
   shellQuote,
   show_default,
   skillItem,
+  skippedFieldWarning,
   sourceItem,
   stackPaths,
   stacksFromEccSkillName,
@@ -395,7 +400,7 @@ import {
   worktreesHolding,
   writeSession,
   writeShippedFile
-} from "./index-nwgwxfkt.js";
+} from "./index-zcbj07aq.js";
 import {
   PROBE_TIMEOUT_MS,
   loadPlanPrerequisites,
@@ -407,7 +412,7 @@ import {
   runPreflight,
   splitBlockerComment,
   trackerPathFor
-} from "./index-g4116t9m.js";
+} from "./index-krpmxpkh.js";
 import {
   ACTION_HEADING,
   CAUSE_HEADING,
@@ -518,7 +523,7 @@ import {
   versionLine,
   writeFrontmatter,
   writePositionFile
-} from "./index-1r2b1052.js";
+} from "./index-8veaj0t9.js";
 import {
   CONFIG_DEFAULTS,
   CONFIG_FILE,
@@ -537,7 +542,7 @@ import {
   readItemBytes,
   readRafaBlocks,
   resolveTiers
-} from "./index-m0wt4nr1.js";
+} from "./index-334y39tn.js";
 import {
   promotable
 } from "./index-d6d0942q.js";
@@ -3309,8 +3314,17 @@ async function addIssues(options, ref, issues) {
   const project = await port.find(ref);
   if (project === null)
     return null;
-  for (const number of issues)
-    await port.addItem(project.id, { repository, number });
+  const phase = openPhase(options.progress, "adds", issues.length);
+  let added = 0;
+  try {
+    for (const number of issues) {
+      await port.addItem(project.id, { repository, number });
+      added += 1;
+      phase.advance(added);
+    }
+  } finally {
+    phase.end({ done: added, refused: issues.length - added });
+  }
   return issues;
 }
 async function addMissing(options, first, synced) {
@@ -3327,6 +3341,7 @@ async function addMissing(options, first, synced) {
       ...synced,
       changes: [...first.changes, ...second.changes],
       added,
+      refused: [...first.refused, ...second.refused],
       writes: addedWrites(first.writes, second.writes),
       warnings: [...first.warnings, ...second.warnings.filter((line) => !first.warnings.includes(line))]
     };
@@ -3347,6 +3362,7 @@ async function syncProject(options) {
     changes: first.changes,
     missing: first.missing,
     added: [],
+    refused: first.refused,
     writes: first.writes,
     warnings: first.warnings
   });
@@ -3364,17 +3380,21 @@ function counted(count, noun) {
 function changeLine(change) {
   return `#${String(change.issue)} ${change.name}: ${change.from ?? EMPTY_VALUE} \u2192 ${change.to ?? EMPTY_VALUE}`;
 }
+function refusedPart(result) {
+  return result.refused.length === 0 ? "" : `; ${counted(result.refused.length, "issue")} not refreshed`;
+}
 function closingLine(result) {
   const project = `project #${String(result.project.number)}`;
   const adds = result.dryRun ? result.missing : result.added;
   const changes = counted(result.changes.length, "change");
   const issues = counted(adds.length, "issue");
+  const inStep = result.changes.length === 0 && adds.length === 0 && result.refused.length === 0;
   if (result.dryRun) {
-    return result.changes.length === 0 && adds.length === 0 ? `Dry run on ${project}: in step, nothing to change.` : `Dry run on ${project}: ${changes} and ${issues} to add; nothing written.`;
+    return inStep ? `Dry run on ${project}: in step, nothing to change.` : `Dry run on ${project}: ${changes} and ${issues} to add${refusedPart(result)}; nothing written.`;
   }
   if (result.rateLimited)
     return `Stopped on ${project}: ${String(result.written)} of ${changes} written; the rate limit refused the rest.`;
-  return result.changes.length === 0 && adds.length === 0 ? `Synced ${project}: in step, nothing to change.` : `Synced ${project}: ${changes} written and ${issues} added.`;
+  return inStep ? `Synced ${project}: in step, nothing to change.` : `Synced ${project}: ${changes} written and ${issues} added${refusedPart(result)}.`;
 }
 function syncLines(result) {
   const adds = result.dryRun ? result.missing.map((issue) => `#${String(issue)} is not on the project: would be added`) : result.added.map((issue) => `#${String(issue)} added to the project`);
@@ -3390,6 +3410,7 @@ function syncResultOf(synced) {
     changes: synced.changes.map(plainChange),
     missing: synced.missing,
     added: synced.added,
+    refused: synced.refused.map(({ number, reason }) => ({ issue: number, reason })),
     written: synced.writes.written,
     rateLimited: synced.writes.rateLimited,
     notUpdated: synced.writes.notUpdated,
@@ -3407,9 +3428,10 @@ async function runBoardSync(context, seams) {
   if (config.boardProjectNumber === null) {
     throw new CommandExit(1, `\u274C board.project.number is not set, so there is no project to sync. Run \`${PROJECT_INIT_FIX}\` to create one.`);
   }
-  const gh = seams.gh ?? createGhRunner({ cwd: project.root });
+  const gh = openProjectRunner(seams.gh ?? createGhRunner({ cwd: project.root }), config, commandRetrySeams(context.output, context.outputMode, seams.sleep));
   const dryRun = context.flags[DRY_RUN_FLAG] === true;
-  const synced = await syncProject(seams.sleep === undefined ? { config, gh, dryRun } : { config, gh, dryRun, sleep: seams.sleep }).catch((error) => {
+  const progress = commandProgressFeed(context.output, context.outputMode, config.boardProjectProgressSeconds, seams.now === undefined ? {} : { now: seams.now });
+  const synced = await syncProject(seams.sleep === undefined ? { config, gh, dryRun, progress } : { config, gh, dryRun, progress, sleep: seams.sleep }).catch((error) => {
     throw new CommandExit(BOARD_SYNC_REFUSAL_EXIT, `\u274C Could not sync the project: ${messageOf(error)}`);
   });
   if (synced.kind !== "synced") {
@@ -3439,7 +3461,7 @@ function createBoardSyncCommand(seams = {}) {
     subject: "board",
     action: "sync",
     summary: "bring the repository's GitHub project in step with its issues",
-    description: "Refreshes every item of this repository on the GitHub project board.project.number names, writing" + " only the Stage, Horizon, Rank, Blocked by and Progress values that differ from what rafa reads of the" + " issues, then adds every open issue missing from the project and fills its fields. It repairs what changed" + " outside rafa: a label edited in the web UI, an issue closed by hand, the Roadmap issue's order edited in" + " its body. Prints one line per change and per issue added, then a closing count. With `--dry-run` it" + " prints the same lines and writes nothing. With `--output=json` the changes are the data of the terminal" + " result event. Refused with exit code 1 when board.project.number is unset, and with exit code 2 when the" + " token lacks the project scope, the number names no project, or the rate limit stopped the writes.",
+    description: "Refreshes every item of this repository on the GitHub project board.project.number names, writing" + " only the Stage, Horizon, Rank, Blocked by and Progress values that differ from what rafa reads of the" + " issues, then adds every open issue missing from the project and fills its fields. It repairs what changed" + " outside rafa: a label edited in the web UI, an issue closed by hand, the Roadmap issue's order edited in" + " its body. Prints one line per change and per issue added, then a closing count. With `--dry-run` it" + " prints the same lines and writes nothing. With `--output=json` the changes are the data of the terminal" + " result event. An issue whose facts could not be read is named in a warning, `#<n> not refreshed:" + " <reason>`, while the others are synced; the exit code stays 0 and the next run reads it again. Adding" + " the issues, reading their facts and writing their fields each print a start line with the total, a" + " progress line at most every board.project.progressSeconds, as `reading facts: 146/283, 6m 40s`, and an" + " end line; with `--output=json` each is a `progress` event. Refused" + " with exit code 1 when board.project.number is unset, and with exit code 2 when the token lacks the" + " project scope, the number names no project, or the rate limit stopped the writes.",
     args: [],
     flags: [
       {
@@ -8274,41 +8296,76 @@ async function missingIssues(options, repository, project) {
   const held = heldIssues(await createGhProjectPort(gh).items(project.id), repository);
   const ranked = board.closed.filter((issue) => rankOf(board.ranks, issue) !== null);
   const unread = board.closed.filter((issue) => rankOf(board.ranks, issue) === null && !held.has(issue));
-  const facts = await readIssueFacts({ gh, fragments: config.releaseFragments }, unread);
+  const { facts } = await readIssueFacts({ gh, fragments: config.releaseFragments }, unread);
   const inReview = unread.filter((issue) => {
     const read = facts.get(issue);
     return read !== undefined && stageOf(read) === "In review";
   });
-  return [...new Set([...board.open, ...ranked, ...inReview])].filter((issue) => !held.has(issue)).sort((a, b) => a - b);
+  const missing = [...new Set([...board.open, ...ranked, ...inReview])].filter((issue) => !held.has(issue)).sort((a, b) => a - b);
+  return { held, missing };
 }
 async function itemsStep(options, repository, project) {
   const sleep = options.sleep ?? ((ms) => Bun.sleep(ms));
-  let missing;
+  let wanted;
   try {
-    missing = await missingIssues(options, repository, project);
+    wanted = await missingIssues(options, repository, project);
   } catch (error) {
-    return partOf("items", ITEMS_PART, "refused", `the issues to add could not be read: ${refusalOf(error)}`);
+    return { part: partOf("items", ITEMS_PART, "refused", `the issues to add could not be read: ${refusalOf(error)}`), holds: null };
   }
+  const { held, missing } = wanted;
   if (missing.length === 0)
-    return partOf("items", ITEMS_PART, "present", "the project holds every issue it shows");
+    return { part: partOf("items", ITEMS_PART, "present", "the project holds every issue it shows"), holds: held.size };
   const port = createGhProjectPort(options.gh);
+  const phase = openPhase(options.progress, "adds", missing.length);
   let added = 0;
   try {
     for (const number of missing) {
       if (added > 0)
-        await sleep(PROJECT_WRITE_PAUSE_MS);
+        await sleep(options.config.boardProjectWritePauseMs);
       await port.addItem(project.id, { repository, number });
       added += 1;
+      phase.advance(added);
     }
   } catch (error) {
+    phase.end({ done: added, refused: missing.length - added });
     const went = `${issueCount(added)} of ${String(missing.length)} added`;
-    return partOf("items", ITEMS_PART, "refused", `${went}, then #${String(missing[added])} was refused: ${refusalOf(error)}; run \`${PROJECT_STEP_FIX}\` to add the rest`);
+    const why = `${went}, then #${String(missing[added])} was refused: ${refusalOf(error)}; run \`${PROJECT_STEP_FIX}\` to add the rest`;
+    return { part: partOf("items", ITEMS_PART, "refused", why), holds: held.size + added };
   }
-  return partOf("items", ITEMS_PART, "created", `added ${issueCount(added)} to the project`);
+  phase.end({ done: added, refused: 0 });
+  return { part: partOf("items", ITEMS_PART, "created", `added ${issueCount(added)} to the project`), holds: held.size + added };
+}
+function withListed(part, listed2) {
+  return listed2.length === 0 ? part : { ...part, listed: listed2 };
 }
-async function fieldsStep(options, project) {
+function refusedClause(refused) {
+  return refused === 0 ? "" : `; ${issueCount(refused)} not refreshed`;
+}
+function refreshedPart(refreshed, holds) {
+  const { writes, changes, skipped, refused } = refreshed;
+  const listed2 = refused.map(notRefreshedWarning);
+  if (writes.rateLimited)
+    return withListed(partOf("fields", FIELDS_PART, "refused", rateLimitWarning(writes.notUpdated)), listed2);
+  if (changes.length === 0 && refused.length > 0 && (holds === null || holds <= refused.length)) {
+    return withListed(partOf("fields", FIELDS_PART, "refused", `no item was filled: ${issueCount(refused.length)} not refreshed`), listed2);
+  }
+  if (changes.length === 0) {
+    const held = skipped.length === 0 ? "every value is as the rules give it" : "every value written is as the rules give it";
+    return withListed(partOf("fields", FIELDS_PART, "present", `${held}${refusedClause(refused.length)}`), listed2);
+  }
+  const issues = new Set(changes.map(({ issue }) => issue)).size;
+  const values = writes.written === 1 ? "1 value" : `${String(writes.written)} values`;
+  return withListed(partOf("fields", FIELDS_PART, "created", `wrote ${values} to ${issueCount(issues)}${refusedClause(refused.length)}`), listed2);
+}
+async function fieldsStep(options, project, holds) {
   const config = { ...options.config, boardProjectNumber: project.number };
-  const refreshOptions = options.sleep === undefined ? { config, gh: options.gh } : { config, gh: options.gh, sleep: options.sleep };
+  const { sleep, progress } = options;
+  const refreshOptions = {
+    config,
+    gh: options.gh,
+    ...sleep === undefined ? {} : { sleep },
+    ...progress === undefined ? {} : { progress }
+  };
   let refreshed;
   try {
     refreshed = await refreshProjectItems(refreshOptions, [], { everyItem: true });
@@ -8320,24 +8377,13 @@ async function fieldsStep(options, project) {
   if (refreshed.kind !== "refreshed") {
     return { part: partOf("fields", FIELDS_PART, "refused", refreshed.warnings.join(" ") || "the refresh sent no call"), problems: [] };
   }
-  const { writes, changes, skipped } = refreshed;
-  const problems = refreshed.warnings.slice(writes.rateLimited ? 1 : 0);
-  if (writes.rateLimited) {
-    return { part: partOf("fields", FIELDS_PART, "refused", rateLimitWarning(writes.notUpdated)), problems };
-  }
-  if (changes.length === 0) {
-    const held = skipped.length === 0 ? "every value is as the rules give it" : "every value written is as the rules give it";
-    return { part: partOf("fields", FIELDS_PART, "present", held), problems };
-  }
-  const issues = new Set(changes.map(({ issue }) => issue)).size;
-  const values = writes.written === 1 ? "1 value" : `${String(writes.written)} values`;
-  return { part: partOf("fields", FIELDS_PART, "created", `wrote ${values} to ${issueCount(issues)}`), problems };
+  return { part: refreshedPart(refreshed, holds), problems: refreshed.skipped.map(skippedFieldWarning) };
 }
 async function onProject(options, repository, project) {
   const items = await itemsStep(options, repository, project);
-  const fields = await fieldsStep(options, project);
+  const fields = await fieldsStep(options, project, items.holds);
   const setting = writeProjectNumber(options.root, project.number);
-  return { parts: [items, fields.part, setting], problems: fields.problems };
+  return { parts: [items.part, fields.part, setting], problems: fields.problems };
 }
 async function setUpProject(options) {
   const { gh, config } = options;
@@ -8369,12 +8415,16 @@ function projectSetupChanged(report2) {
 }
 var PROJECT_HEADING = "GitHub project:";
 var OUTCOME_WIDTH3 = 7;
+var LISTED_INDENT = " ".repeat(2 + OUTCOME_WIDTH3 + 2);
 function projectPartLine(part) {
   const row = `  ${part.outcome.padEnd(OUTCOME_WIDTH3, " ")}  ${part.name}`;
   return part.outcome === "present" ? row : `${row}: ${part.detail}`;
 }
+function projectPartLines(part) {
+  return [projectPartLine(part), ...(part.listed ?? []).map((line) => `${LISTED_INDENT}${line}`)];
+}
 function renderProjectSetup(report2) {
-  return [PROJECT_HEADING, ...report2.parts.map((part) => projectPartLine(part)), ...report2.problems];
+  return [PROJECT_HEADING, ...report2.parts.flatMap((part) => projectPartLines(part)), ...report2.problems];
 }
 var PROJECT_QUESTION = "Also create a GitHub project with roadmap and kanban views? [y/N] ";
 var PROJECT_NO_BOARD_WARNING = "--project creates the GitHub project with the GitHub board," + ` and the board step did not run, so no project was created; run ${PROJECT_STEP_FIX}.`;
@@ -8394,6 +8444,13 @@ function withWrittenRoadmap(root, config) {
   const written = readRoadmapSetting(root).issue;
   return written === null ? config : { ...config, roadmapIssue: written };
 }
+function retrySeamsOf(options) {
+  const { sleep, onRetry } = options;
+  return {
+    ...sleep === undefined ? {} : { sleep },
+    ...onRetry === undefined ? {} : { onRetry }
+  };
+}
 async function runProjectStep(options) {
   const { wanted, board, root, isTerminal, openPrompter } = options;
   if (board.status !== "ran") {
@@ -8403,7 +8460,16 @@ async function runProjectStep(options) {
     return noProject("declined", false);
   const run = async (asked) => {
     const setUp = options.setUp ?? setUpProject;
-    const report2 = await setUp({ root, config: withWrittenRoadmap(root, options.config), gh: options.openGh() });
+    const config = withWrittenRoadmap(root, options.config);
+    const gh = openProjectRunner(options.openGh(), config, retrySeamsOf(options));
+    const { sleep, progress } = options;
+    const report2 = await setUp({
+      root,
+      config,
+      gh,
+      ...sleep === undefined ? {} : { sleep },
+      ...progress === undefined ? {} : { progress }
+    });
     return { status: "ran", asked, report: report2, warnings: [] };
   };
   if (wanted === true)
@@ -8481,9 +8547,10 @@ function fieldsRow(project, template) {
   return rowOf2("fields", FIELDS_ROW, "missing", `${sentences} ${fix}`);
 }
 async function readDoctorProject(input) {
-  const { gh, number, template } = input;
-  if (gh === null || number === null)
+  const { number, template } = input;
+  if (input.gh === null || number === null)
     return null;
+  const gh = openProjectRunner(input.gh, input.config, input.retry);
   const scope = await readScopeRow(gh);
   if (scope.outcome !== "present") {
     const project = notRead("project", `${PROJECT_ROW} ${String(number)}`, scope);
@@ -10614,7 +10681,7 @@ async function runDoctor(context, seams) {
     const modeSet = preflight.resolved.sources.boardRelationships !== "default";
     const board = await readDoctorBoard(gh, project.root, preflight.config.roadmapIssue, preflight.config.boardRelationships, modeSet);
     const { boardProjectNumber: number, boardProjectTemplate: template } = preflight.config;
-    const projectRows = await readDoctorProject({ gh, number, template });
+    const projectRows = await readDoctorProject({ gh, number, template, config: preflight.config, retry: commandRetrySeams(context.output, context.outputMode) });
     const readings = { ...board, project: projectRows, cleanup, refs, release, tiers, effortSchema, effortSync };
     writeText(context, renderDoctor(preflight));
     await announceRisk(context, preflight, seams);
@@ -12002,7 +12069,8 @@ async function refreshProjectAfterEpic(context, seams, target) {
     });
     if (config.boardProjectNumber === null)
       return null;
-    const openGh = () => seams.gh ?? createGhRunner({ cwd: project.root });
+    const retry = commandRetrySeams(context.output, context.outputMode, seams.sleep);
+    const openGh = () => openProjectRunner(seams.gh ?? createGhRunner({ cwd: project.root }), config, retry);
     warnings = await refreshLines(config, openGh, seams.projectRefresh ?? refreshIssueItems, target, named2);
   } catch (error) {
     warnings = [epicProjectProblemLine(named2, messageOf(error))];
@@ -14846,6 +14914,11 @@ var CONFIG_SETTINGS_LINES = Object.freeze([
   "#   project:",
   `#     template: ${CONFIG_DEFAULTS.boardProjectTemplate}   # the project URL rafa init --board --project copies`,
   "#     number:                    # the project rafa mirrors the board to; unset until rafa init --board --project",
+  `#     retries: ${String(CONFIG_DEFAULTS.boardProjectRetries)}                 # 1..10 | false, tries again after a failed project call`,
+  `#     retryWaitSeconds: ${String(CONFIG_DEFAULTS.boardProjectRetryWaitSeconds)}        # 1..60, the first wait before a retry; each later one doubles`,
+  `#     progressSeconds: ${String(CONFIG_DEFAULTS.boardProjectProgressSeconds)}        # 1..300 | false, the most seconds between two progress lines`,
+  `#     writeBatchSize: ${String(CONFIG_DEFAULTS.boardProjectWriteBatchSize)}         # 1..100, field writes per request`,
+  `#     writePauseMs: ${String(CONFIG_DEFAULTS.boardProjectWritePauseMs)}         # 0..60000, the pause between two write requests`,
   "# roadmap:",
   "#   issue:                       # the issue plan create --next reads; unset is the one titled Roadmap",
   "# claims:",
@@ -15248,7 +15321,9 @@ async function runInit(context, seams) {
     config: scopes.config,
     openGh: () => seams.gh(scopes.written.root),
     isTerminal: seams.isTerminal,
-    openPrompter: seams.openPrompter
+    openPrompter: seams.openPrompter,
+    ...commandRetrySeams(context.output, context.outputMode, seams.sleep),
+    progress: commandProgressFeed(context.output, context.outputMode, scopes.config.boardProjectProgressSeconds, seams.now === undefined ? {} : { now: seams.now })
   });
   const result2 = {
     ...scopes.written,
@@ -15285,7 +15360,7 @@ function createInitCommand(seams = DEFAULT_INIT_SEAMS) {
     subject: "init",
     action: "init",
     summary: "set up a rafa project: its root, .rafa/config.yaml, the tree and the .gitignore entry",
-    description: "Sets up a rafa project. On a terminal it lists the root candidates, the git toplevel or" + " the working directory outside a repository and then the outermost monorepo root above it, each" + " refused one with its reason, and reads a candidate number or a path typed freely. `--root=<path>`" + " names the root instead, absolute or relative to the working directory, and `--yes` takes the" + " first candidate; without a terminal one of the two is needed. Under the root it writes" + " `.rafa/config.yaml` with every setting commented out at its default, the tree `specs/`, `plans/`," + " `runs/`, `effort/` and `instincts/` under `.rafa/`, and the rafa block in `.gitignore` from the" + " `tracking` settings; under the home it writes `~/.rafa/config.yaml` and `~/.rafa/instincts/` when" + " they are missing. Only what is missing or stale is written, so a rerun changes no byte and says" + " so. It warns when `~/.rafa/bin` is not on PATH ahead of `~/.bun/bin`, and when a plan under" + " `plan.dir` routes to an agent that resolves only in `~/.claude/agents` and rafa does not ship," + " naming `rafa agent vendor <name>`; it writes nothing under `.claude/` itself. A repository whose pull request provider is `gh` ends with one" + " question about setting up the GitHub board, which `--board` and `--no-board` answer for a" + " script, and then, once the board has run, one question about installing the epic guard" + " workflow `.github/workflows/epic-guard.yml`, which removes a second `epic:` label from an issue" + " and comments why; `--epic-guard` and `--no-epic-guard` answer that one. When `board.relationships`" + " is set, the board is then read for relationships held in the other mode: every write that moves" + " them into the configured one is printed and a terminal is asked once, nothing is written on a no," + " and once every write went through a second question asks whether to remove the old marks. Last, once the" + " board has run, one question asks whether to copy the GitHub project template to the repository's" + " owner, link it, add the issues and fill their fields; `--project` and `--no-project` answer that one." + " On a terminal it also asks once whether every pull request bumps the version and gains" + " a changelog entry, and writes the answer as `release.enabled`; `--release` and `--no-release`" + " answer that one, and `--yes` leaves it unset. With `--output=json` the" + " root and every path checked are the data of the terminal result event.",
+    description: "Sets up a rafa project. On a terminal it lists the root candidates, the git toplevel or" + " the working directory outside a repository and then the outermost monorepo root above it, each" + " refused one with its reason, and reads a candidate number or a path typed freely. `--root=<path>`" + " names the root instead, absolute or relative to the working directory, and `--yes` takes the" + " first candidate; without a terminal one of the two is needed. Under the root it writes" + " `.rafa/config.yaml` with every setting commented out at its default, the tree `specs/`, `plans/`," + " `runs/`, `effort/` and `instincts/` under `.rafa/`, and the rafa block in `.gitignore` from the" + " `tracking` settings; under the home it writes `~/.rafa/config.yaml` and `~/.rafa/instincts/` when" + " they are missing. Only what is missing or stale is written, so a rerun changes no byte and says" + " so. It warns when `~/.rafa/bin` is not on PATH ahead of `~/.bun/bin`, and when a plan under" + " `plan.dir` routes to an agent that resolves only in `~/.claude/agents` and rafa does not ship," + " naming `rafa agent vendor <name>`; it writes nothing under `.claude/` itself. A repository whose pull request provider is `gh` ends with one" + " question about setting up the GitHub board, which `--board` and `--no-board` answer for a" + " script, and then, once the board has run, one question about installing the epic guard" + " workflow `.github/workflows/epic-guard.yml`, which removes a second `epic:` label from an issue" + " and comments why; `--epic-guard` and `--no-epic-guard` answer that one. When `board.relationships`" + " is set, the board is then read for relationships held in the other mode: every write that moves" + " them into the configured one is printed and a terminal is asked once, nothing is written on a no," + " and once every write went through a second question asks whether to remove the old marks. Last, once the" + " board has run, one question asks whether to copy the GitHub project template to the repository's" + " owner, link it, add the issues and fill their fields; `--project` and `--no-project` answer that one." + " Adding the issues, reading their facts and writing their fields each print a start line with the" + " total, a progress line at most every board.project.progressSeconds and an end line, one `progress`" + " event each with `--output=json`." + " On a terminal it also asks once whether every pull request bumps the version and gains" + " a changelog entry, and writes the answer as `release.enabled`; `--release` and `--no-release`" + " answer that one, and `--yes` leaves it unset. With `--output=json` the" + " root and every path checked are the data of the terminal result event.",
     args: [],
     flags: [
       {
@@ -15310,7 +15385,7 @@ function createInitCommand(seams = DEFAULT_INIT_SEAMS) {
       },
       {
         name: "project",
-        description: "Create the GitHub project without asking, once the board has run: copy" + " `board.project.template` to the repository's owner, link the repository, add its issues, fill" + " their fields and save `board.project.number`. `--no-project` leaves it out. Without either, a" + " terminal is asked once and a run with no terminal leaves it out.",
+        description: "Create the GitHub project without asking, once the board has run: copy" + " `board.project.template` to the repository's owner, link the repository, add its issues, fill" + " their fields and save `board.project.number`. `--no-project` leaves it out. Without either, a" + " terminal is asked once and a run with no terminal leaves it out. The adds, the facts reads and the" + " field writes print their progress, as `adding issues: 146/283, 6m 40s`.",
         type: "boolean"
       },
       {
@@ -16400,7 +16475,7 @@ async function addCreatedToProject(context, seams, ref8) {
   });
   const lines = await addAndRefreshIssue({
     config,
-    openGh: () => seams.gh ?? createGhRunner({ cwd: project.root })
+    openGh: () => openProjectRunner(seams.gh ?? createGhRunner({ cwd: project.root }), config, commandRetrySeams(context.output, context.outputMode, seams.sleep))
   }, issue);
   for (const line of lines)
     context.output.warn(line);
@@ -19075,6 +19150,10 @@ function openPrContext(context, seams = DEFAULT_PR_SEAMS) {
     versionGuard: mergeGuardSettings(config),
     projectRefresh: {
       boardProjectNumber: config.boardProjectNumber,
+      boardProjectRetries: config.boardProjectRetries,
+      boardProjectRetryWaitSeconds: config.boardProjectRetryWaitSeconds,
+      boardProjectWriteBatchSize: config.boardProjectWriteBatchSize,
+      boardProjectWritePauseMs: config.boardProjectWritePauseMs,
       boardRelationships: config.boardRelationships,
       roadmapIssue: config.roadmapIssue,
       releaseFragments: config.releaseFragments
@@ -19879,7 +19958,7 @@ async function refreshProjectAfterMerge(options) {
   const closed = [...new Set(closedIssuesIn(options.body))];
   if (config.boardProjectNumber === null || closed.length === 0)
     return null;
-  const gh = options.openGh();
+  const gh = openProjectRunner(options.openGh(), config, options.retry);
   const wanted = new Set(closed);
   const warnings = [];
   let listed2 = [];
@@ -20646,7 +20725,14 @@ async function runMerge2(context, seams) {
   const roadmapTicks = await reportTick(context, pr, seams, detail);
   const steps = cleanUpAfterMerge(git, detail, { info: info2, warn: warn3 });
   const board = await reportAfterCleanUp(context, pr, seams, detail);
-  await refreshProjectAfterMerge({ body: detail.body, config: pr.projectRefresh, openGh: () => openGh(pr, seams), unblocked: board.unblocked, warn: warn3 });
+  await refreshProjectAfterMerge({
+    body: detail.body,
+    config: pr.projectRefresh,
+    openGh: () => openGh(pr, seams),
+    unblocked: board.unblocked,
+    warn: warn3,
+    retry: commandRetrySeams(context.output, context.outputMode)
+  });
   const followUps = reportFollowUps({
     root: pr.project.root,
     home: pr.project.home,
@@ -23822,7 +23908,7 @@ async function refreshProjectAfterSettle(options) {
   const commits = releasedCommits(options.delivered);
   if (config.boardProjectNumber === null || commits === null || commits.length === 0)
     return null;
-  const gh = options.openGh();
+  const gh = openProjectRunner(options.openGh(), config, options.retry);
   let pulls;
   try {
     pulls = await readPulls(gh, commits, branch);
@@ -23998,7 +24084,8 @@ async function runSettle(context, seams = DEFAULT_RELEASE_SETTLE_SEAMS) {
     branch,
     config,
     openGh: () => (seams.gh ?? ((cwd) => createGhRunner({ cwd })))(project.root),
-    refresh: seams.refresh
+    refresh: seams.refresh,
+    retry: commandRetrySeams(context.output, context.outputMode)
   });
   return { ...ran.value, project: refreshed };
 }

package/dist/{index-g4116t9m.js → index-krpmxpkh.js}

@@ -3,7 +3,7 @@ import {
   activeOutput,
   isStampableStub,
   readRafaBlocks
-} from "./index-m0wt4nr1.js";
+} from "./index-334y39tn.js";
 import {
   messageOf,
   parseTaskDeclaration