omp-conductor 0.16.2 → 0.17.0

package/src/setup-wizard.ts

@@ -107,6 +107,7 @@ import {
   type ReportScopeChoice,
   type ResolvedGrants,
 } from "./types.ts";
+import { withProgress } from "./ui/progress.ts";
 import type { WizardUi } from "./wizard-ui.ts";
 
 /**
@@ -132,8 +133,8 @@ const REPO_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
  * takes it, because the harness has no pre-filled input dialog — so "Enter
  * accepts what you see" is the contract the whole wizard is built on.
  */
-async function ask(ui: WizardUi, title: string, fallback: string): Promise<string> {
-  const raw = await ui.input(title, fallback.length > 0 ? fallback : undefined);
+async function ask(ui: WizardUi, key: string, title: string, fallback: string): Promise<string> {
+  const raw = await ui.input(title, fallback.length > 0 ? fallback : undefined, { key });
   if (raw === undefined) throw new Cancelled();
   const trimmed = raw.trim();
   return trimmed.length > 0 ? trimmed : fallback;
@@ -147,8 +148,8 @@ async function ask(ui: WizardUi, title: string, fallback: string): Promise<strin
  * recorded a silent no and walked on to the next question, which is not what
  * abandoning a run means. `undefined` is the surface saying the operator left.
  */
-async function askYesNo(ui: WizardUi, title: string, message: string): Promise<boolean> {
-  const answer = await ui.confirm(title, message);
+async function askYesNo(ui: WizardUi, key: string, title: string, message: string): Promise<boolean> {
+  const answer = await ui.confirm(title, message, { key });
   if (answer === undefined) throw new Cancelled();
   return answer;
 }
@@ -160,12 +161,13 @@ async function askYesNo(ui: WizardUi, title: string, message: string): Promise<b
  */
 async function askValid(
   ui: WizardUi,
+  key: string,
   title: string,
   fallback: string,
   check: (value: string) => string | undefined,
 ): Promise<string> {
   for (let attempt = 0; attempt < 3; attempt++) {
-    const value = await ask(ui, title, fallback);
+    const value = await ask(ui, key, title, fallback);
     const problem = check(value);
     if (problem === undefined) return value;
     ui.notify(problem, "warning");
@@ -176,8 +178,8 @@ async function askValid(
 
 /** A cap. Unparseable input keeps the current value rather than writing a NaN
  *  the validator would later reject — the operator sees why, immediately. */
-async function askNumber(ui: WizardUi, title: string, fallback: number): Promise<number> {
-  const raw = await ask(ui, title, String(fallback));
+async function askNumber(ui: WizardUi, key: string, title: string, fallback: number): Promise<number> {
+  const raw = await ask(ui, key, title, String(fallback));
   const value = Number(raw);
   if (!Number.isFinite(value) || value < 0) {
     ui.notify(`"${raw}" is not a non-negative number — keeping ${fallback}.`, "warning");
@@ -193,11 +195,12 @@ async function askNumber(ui: WizardUi, title: string, fallback: number): Promise
  */
 async function askSpendCap(
   ui: WizardUi,
+  key: string,
   title: string,
   fallback: number | null,
 ): Promise<number | null> {
   const seed = fallback === null ? "" : String(fallback);
-  const raw = (await ask(ui, title, seed)).trim().toLowerCase();
+  const raw = (await ask(ui, key, title, seed)).trim().toLowerCase();
   if (raw === "" || raw === "none" || raw === "off" || raw === "null") return null;
   const value = Number(raw);
   if (!Number.isFinite(value) || value < 0) {
@@ -232,6 +235,7 @@ async function askGates(
   // found, so it is on screen either way.
   const raw = await ask(
     ui,
+    `pre-push-gates.${repoName}`,
     `Pre-push gates for ${repoName} — exactly what CI runs, comma separated`,
     formatGates(seed.length > 0 ? seed : probed),
   );
@@ -263,6 +267,7 @@ async function askReportScope(ui: WizardUi, current: ReportScopeChoice): Promise
   const options = REPORT_SCOPE_CHOICES.map((c) => ({ label: c.label, description: c.description }));
   const at = REPORT_SCOPE_CHOICES.findIndex((c) => c.scope === current);
   const picked = await ui.select("What should the orchestrator report unprompted?", options, {
+    key: "report-scope",
     initialIndex: at === -1 ? 0 : at,
   });
   if (picked === undefined) throw new Cancelled();
@@ -292,6 +297,7 @@ async function askReportScope(ui: WizardUi, current: ReportScopeChoice): Promise
  */
 async function askLiteral<T extends string>(
   ui: WizardUi,
+  key: string,
   title: string,
   values: readonly T[],
   described: { readonly [K in T]: string },
@@ -301,7 +307,7 @@ async function askLiteral<T extends string>(
   const picked = await ui.select(
     title,
     values.map((v) => ({ label: v, description: described[v] })),
-    { initialIndex: at === -1 ? 0 : at },
+    { key, initialIndex: at === -1 ? 0 : at },
   );
   if (picked === undefined) throw new Cancelled();
 
@@ -336,8 +342,13 @@ function parseNameList(answer: string): string[] {
 
 /** Check names, artefacts, environments: open-ended lists this package cannot
  *  enumerate, so the only validation is the shape. */
-async function askNameList(ui: WizardUi, title: string, seed: readonly string[]): Promise<string[]> {
-  return parseNameList(await ask(ui, title, formatNameList(seed)));
+async function askNameList(
+  ui: WizardUi,
+  key: string,
+  title: string,
+  seed: readonly string[],
+): Promise<string[]> {
+  return parseNameList(await ask(ui, key, title, formatNameList(seed)));
 }
 
 /**
@@ -362,6 +373,7 @@ async function askReleaseRequirements(
   );
   const answered = await askValid(
     ui,
+    "release-requirements",
     `Release — what must have landed first (any of ${accepted}, comma separated, or "${EMPTY_LIST}")`,
     formatNameList(prior),
     (value) => {
@@ -398,11 +410,13 @@ async function askPolicyPreconditions(
   const merge = {
     requiredChecks: await askNameList(
       ui,
+      "merge-required-checks",
       `Merge — required checks (comma separated, "${EMPTY_LIST}" = every check the PR reports)`,
       prior.merge.requiredChecks,
     ),
     baseFreshness: await askLiteral(
       ui,
+      "merge-base-freshness",
       "Merge — must the PR be level with its base?",
       BASE_FRESHNESS,
       BASE_FRESHNESS_CHOICES,
@@ -410,6 +424,7 @@ async function askPolicyPreconditions(
     ),
     drafts: await askLiteral(
       ui,
+      "merge-drafts",
       "Merge — draft pull requests",
       DRAFT_POLICIES,
       DRAFT_POLICY_CHOICES,
@@ -417,6 +432,7 @@ async function askPolicyPreconditions(
     ),
     whenBehindBase: await askLiteral(
       ui,
+      "merge-behind-base",
       "Merge — a green PR that fell behind its base",
       BEHIND_BASE_ACTIONS,
       BEHIND_BASE_CHOICES,
@@ -430,16 +446,19 @@ async function askPolicyPreconditions(
           requires: await askReleaseRequirements(ui, prior.release.requires),
           requiredChecks: await askNameList(
             ui,
+            "release-required-checks",
             `Release — required checks (comma separated, "${EMPTY_LIST}" = every check the branch reports)`,
             prior.release.requiredChecks,
           ),
           artefacts: await askNameList(
             ui,
+            "release-artefacts",
             `Release — artefacts this project ships (comma separated, or "${EMPTY_LIST}")`,
             prior.release.artefacts,
           ),
           environments: await askNameList(
             ui,
+            "release-environments",
             `Release — environments a deploy may target (comma separated, or "${EMPTY_LIST}")`,
             prior.release.environments,
           ),
@@ -487,6 +506,7 @@ async function askAuthority(
 ): Promise<ProjectConfig["authority"]> {
   const merge = await askYesNo(
     ui,
+    "merge-authority",
     "Merge authority",
     "Delegate PR merging to the orchestrator session? It would land green PRs one at a time, each " +
       "re-checked against the base branch first. Default: humans merge" +
@@ -496,6 +516,7 @@ async function askAuthority(
   const unlockCount = unlock.gates.length + unlock.policy.length;
   const release = await askYesNo(
     ui,
+    "release-authority",
     "Release authority",
     "Delegate release cutting to the orchestrator session? It would tag, pin and publish by the " +
       "procedure you write into its brief — and its brief forbids cutting one before you have. " +
@@ -506,6 +527,7 @@ async function askAuthority(
   );
   const promotion = await askYesNo(
     ui,
+    "promotion-authority",
     "Promotion authority",
     "Delegate promotion to the orchestrator session? Promotion is adding the queue label to an " +
       "issue — the sign-off that lets a worker claim it, and the act that starts spend. " +
@@ -576,13 +598,14 @@ async function askJudgment(
     const picked = await ui.select(
       "Roadmap candidates found in GitHub",
       [...roadmapChoices.map((label) => ({ label })), { label: other }],
-      { initialIndex: 0 },
+      { key: "roadmap-candidate", initialIndex: 0 },
     );
     if (picked === undefined) throw new Cancelled();
     roadmapSeed = picked === other ? "" : picked;
   }
   const roadmap = await ask(
     ui,
+    "roadmap",
     "Where does the roadmap live, and what is the current priority?",
     roadmapSeed,
   );
@@ -622,26 +645,40 @@ async function askJudgment(
   // so an operator has something to calibrate against.
   judgment.boundary = await ask(
     ui,
+    "release-boundary",
     "Where does the orchestrator's leg END? One sentence " +
       '(a real answer: "at the merged version pin — deploying it is operator territory")',
     prior.boundary ?? "",
   );
 
   // All five, because the brief needs each and a missing one is a hole.
-  judgment.releaseWhat = await ask(ui, "Release — WHAT may be released, and from which branch?", prior.releaseWhat ?? "");
+  judgment.releaseWhat = await ask(
+    ui,
+    "release-what",
+    "Release — WHAT may be released, and from which branch?",
+    prior.releaseWhat ?? "",
+  );
   judgment.releaseWhen = await ask(
     ui,
+    "release-when",
     "Release — WHEN: batched how, after which named checks are green?",
     prior.releaseWhen ?? "",
   );
   judgment.releaseProof = await ask(
     ui,
+    "release-proof",
     "Release — WHAT PROOF must be held first (results actually read, not an impression)?",
     prior.releaseProof ?? "",
   );
-  judgment.releaseAsk = await ask(ui, "Release — what must still be ASKED, every time?", prior.releaseAsk ?? "");
+  judgment.releaseAsk = await ask(
+    ui,
+    "release-ask",
+    "Release — what must still be ASKED, every time?",
+    prior.releaseAsk ?? "",
+  );
   judgment.releaseForbidden = await ask(
     ui,
+    "release-forbidden",
     "Release — what stays permanently FORBIDDEN?",
     prior.releaseForbidden ?? "force-push, secrets, production data",
   );
@@ -652,17 +689,19 @@ async function askJudgment(
   // `RELEASE_REQUIREMENTS`, which are mechanical preconditions, not a unit.
   judgment.worthCutting = await ask(
     ui,
+    "release-worth-cutting",
     "What is a release worth cutting? (a sprint, an epic's children all closed, N merged issues, urgency)",
     prior.worthCutting ?? "",
   );
 
-  judgment.rollbackOwner = await ask(ui, "Who owns the rollback?", prior.rollbackOwner ?? "");
+  judgment.rollbackOwner = await ask(ui, "rollback-owner", "Who owns the rollback?", prior.rollbackOwner ?? "");
   if (namesAPerson(judgment.rollbackOwner)) {
     // Honour the consequence rather than recording a contradiction: if a person
     // rolls it back, that person owns the release, and the boundary belongs
     // before the irreversible step whatever the authority answer sounded like.
     judgment.rollbackMovesBoundary = await askYesNo(
       ui,
+      "rollback-moves-boundary",
       "Rollback owner is a person",
       `You named "${judgment.rollbackOwner}" as the rollback owner. That person already owns the release, ` +
         "so the honest configuration puts the orchestrator's boundary *before* the irreversible step — " +
@@ -671,6 +710,7 @@ async function askJudgment(
     if (judgment.rollbackMovesBoundary) {
       judgment.boundary = await ask(
         ui,
+        "release-boundary",
         "Restate the boundary, ending before the irreversible step",
         judgment.boundary ?? "",
       );
@@ -713,6 +753,7 @@ async function askReleaseGrants(
   for (const shape of RELEASE_SHAPES) {
     const open = await askYesNo(
     ui,
+      `release-tool-gate.${shape}`,
       `Release tool gate — ${shape}`,
       `Allow the orchestrator session to ${RELEASE_SHAPE_QUESTIONS[shape]}? Grant this only when the ` +
         "operator brief carries the procedure it must follow. A worker session is refused this " +
@@ -733,6 +774,7 @@ async function askReleaseGrants(
 async function askOrchestratorMode(ui: WizardUi, prior: OrchestratorMode): Promise<OrchestratorMode> {
   const external = await askYesNo(
     ui,
+    "orchestrator-mode",
     "Orchestrator session",
     "Do you already run your own orchestrator session for this project — a visible TUI session, say? " +
       "Then the daemon starts none of its own, and posts tier-1 escalations as issue comments for yours " +
@@ -762,6 +804,7 @@ async function askGraphRoot(
 ): Promise<string | undefined> {
   const wanted = await askYesNo(
     ui,
+    "code-graph-enabled",
     "Code-graph discovery",
     "Set up code-graph discovery for workers? Workers spend most of their turn budget finding code; " +
       'a graph answers "who calls this" in one call. Conductor keeps one disposable clone per repo, ' +
@@ -772,6 +815,7 @@ async function askGraphRoot(
 
   return await askValid(
     ui,
+    "code-graph-root",
     `Root for those clones — one per repo (${repoNames.join(", ")}) is created under it`,
     prior ?? defaultGraphRoot(trackerRepo),
     (v) =>
@@ -791,6 +835,7 @@ async function askOrchestratorBrief(ui: WizardUi, a: SetupAnswers): Promise<bool
   const path = orchestratorBriefPath(a);
   const wanted = await askYesNo(
     ui,
+    "write-operator-brief",
     `Write ${ORCHESTRATOR_BRIEF_NAME} + ${POLICY_BRIEF_NAME} under ${dirname(path)}?`,
     `Writes composed ${ORCHESTRATOR_BRIEF_NAME} (package floor, refreshed each tick) and ${POLICY_BRIEF_NAME} ` +
       `(Releases, Project context, Reporting, Amendments — yours to edit via the Learning loop). ` +
@@ -801,6 +846,7 @@ async function askOrchestratorBrief(ui: WizardUi, a: SetupAnswers): Promise<bool
 
   return await askYesNo(
     ui,
+    "overwrite-operator-brief",
     `Overwrite existing ${ORCHESTRATOR_BRIEF_NAME} / ${POLICY_BRIEF_NAME}?`,
     `${path} already exists. Overwriting replaces the composed brief and POLICY.md scaffold — any policy you wrote is lost.`,
   );
@@ -990,6 +1036,7 @@ async function proseFromRepos(ui: WizardUi, a: SetupAnswers): Promise<ProbedPros
 const askTrackerAndRepos: AreaAsker = async (ui, a, probes) => {
   const trackerRepo = await askValid(
     ui,
+    "tracker-repo",
     "Tracker repo (owner/repo) — where ready issues live",
     a.trackerRepo,
     (v) => (REPO_RE.test(v) ? undefined : `"${v}" is not owner/repo — e.g. acme/planning.`),
@@ -997,6 +1044,7 @@ const askTrackerAndRepos: AreaAsker = async (ui, a, probes) => {
 
   const queueLabel = await ask(
     ui,
+    "queue-label",
     "Queue label — the human sign-off that makes an issue claimable",
     a.queueLabel,
   );
@@ -1007,18 +1055,20 @@ const askTrackerAndRepos: AreaAsker = async (ui, a, probes) => {
   const stateLabels: SetupAnswers["stateLabels"] = { ...a.stateLabels };
   const customiseStates = await askYesNo(
     ui,
+    "customise-state-labels",
     "State labels",
     `The conductor writes back "${stateLabels.inProgress}", "${stateLabels.blocked}" and ` +
       `"${stateLabels.failed}" so the tracker alone shows live state. Rename them?`,
   );
   if (customiseStates) {
-    stateLabels.inProgress = await ask(ui, "Label for a run in progress", stateLabels.inProgress);
-    stateLabels.blocked = await ask(ui, "Label for a run parked on a human", stateLabels.blocked);
-    stateLabels.failed = await ask(ui, "Label for a run that gave up", stateLabels.failed);
+    stateLabels.inProgress = await ask(ui, "state-label-in-progress", "Label for a run in progress", stateLabels.inProgress);
+    stateLabels.blocked = await ask(ui, "state-label-blocked", "Label for a run parked on a human", stateLabels.blocked);
+    stateLabels.failed = await ask(ui, "state-label-failed", "Label for a run that gave up", stateLabels.failed);
   }
 
   const routingLabelPrefix = await ask(
     ui,
+    "routing-label-prefix",
     "Routing label prefix — an issue picks its checkout with <prefix><repo>",
     a.routingLabelPrefix,
   );
@@ -1028,18 +1078,21 @@ const askTrackerAndRepos: AreaAsker = async (ui, a, probes) => {
     const seed = a.targetRepos[i];
     const name = await askValid(
       ui,
+      `routing-key.${i + 1}`,
       `Routing key for repo ${i + 1} — the "${routingLabelPrefix}<key>" label an issue carries`,
       seed?.name ?? "",
       (v) => (v.length > 0 ? undefined : "A routing key is required, or no issue can reach this repo."),
     );
     const cloneUrl = await askValid(
       ui,
+      `clone-url.${name}`,
       `Clone URL for ${routingLabelPrefix}${name}`,
       seed?.cloneUrl ?? "",
       (v) => (v.length > 0 ? undefined : "A clone URL is required — the daemon mirrors it before every run."),
     );
     const defaultBranch = await ask(
       ui,
+      `default-branch.${name}`,
       `Default branch for ${name} — worktrees are cut from it and PRs target it`,
       seed?.defaultBranch ?? SETUP_DEFAULTS.defaultBranch,
     );
@@ -1051,6 +1104,7 @@ const askTrackerAndRepos: AreaAsker = async (ui, a, probes) => {
 
     const more = await askYesNo(
     ui,
+      `another-repo.${i + 1}`,
       "Another repo?",
       `${targetRepos.map((r) => r.name).join(", ")} configured. Add another checkout this project routes to?`,
     );
@@ -1121,6 +1175,7 @@ const askCaps: AreaAsker = async (ui, a) => {
       : "";
   const tuneCaps = await askYesNo(
     ui,
+    "tune-caps",
     "Caps",
     `Defaults: ${workersDefault} workers, ` +
       `${spendLabel}, ${DEFAULT_CAPS.workerMaxTurns} base / ` +
@@ -1143,16 +1198,19 @@ const askCaps: AreaAsker = async (ui, a) => {
   // not silently go unasked.
   caps.maxConcurrentWorkers = await askNumber(
     ui,
+    "max-concurrent-workers",
     "Max concurrent workers",
     workersDefault,
   );
   caps.dailySpendUsd = await askSpendCap(
     ui,
+    "daily-spend-usd",
     "Spend ceiling per rolling day (USD) — blank = no spend cap",
     caps.dailySpendUsd !== undefined ? caps.dailySpendUsd : DEFAULT_CAPS.dailySpendUsd,
   );
   const workerMaxTurns = await askNumber(
     ui,
+    "worker-max-turns",
     "Turn ceiling per worker",
     caps.workerMaxTurns ?? DEFAULT_CAPS.workerMaxTurns,
   );
@@ -1164,6 +1222,7 @@ const askCaps: AreaAsker = async (ui, a) => {
   );
   const workerMaxTurnsCeiling = await askNumber(
     ui,
+    "worker-max-turns-ceiling",
     "Maximum turn ceiling for one issue",
     turnCeilingFallback,
   );
@@ -1179,16 +1238,19 @@ const askCaps: AreaAsker = async (ui, a) => {
   }
   caps.workerWallClockMs = await askNumber(
     ui,
+    "worker-wall-clock-ms",
     "Wall-clock ceiling per worker (ms)",
     caps.workerWallClockMs ?? DEFAULT_CAPS.workerWallClockMs,
   );
   caps.maxAttemptsPerIssue = await askNumber(
     ui,
+    "max-attempts-per-issue",
     "Failed implementation attempts per issue before escalation",
     caps.maxAttemptsPerIssue ?? DEFAULT_CAPS.maxAttemptsPerIssue,
   );
   caps.maxContinuationsPerIssue = await askNumber(
     ui,
+    "max-continuations-per-issue",
     "Operational continuations per issue before escalation",
     caps.maxContinuationsPerIssue ?? DEFAULT_CAPS.maxContinuationsPerIssue,
   );
@@ -1198,7 +1260,12 @@ const askCaps: AreaAsker = async (ui, a) => {
 /** Outside the caps block: a model is not a ceiling, and an operator who left
  *  the caps alone may still want workers on a cheaper model. */
 const askWorkerModel: AreaAsker = async (ui, a) => {
-  const answered = await ask(ui, "Worker model pattern (blank = harness default)", a.workerModel ?? "");
+  const answered = await ask(
+    ui,
+    "worker-model",
+    "Worker model pattern (blank = harness default)",
+    a.workerModel ?? "",
+  );
   const next: SetupAnswers = { ...a };
   if (answered.trim().length === 0) delete next.workerModel;
   else next.workerModel = answered.trim();
@@ -1216,6 +1283,7 @@ const askOmpSettings: AreaAsker = async (ui, a) => {
   const seed = a.ompSettings === undefined ? "" : JSON.stringify(a.ompSettings);
   const answered = await askValid(
     ui,
+    "omp-settings",
     "Omp settings overlay for workers (YAML, blank = none — omp's schema, not conductor's)",
     seed,
     (value) => {
@@ -1280,12 +1348,18 @@ const askEscalation: AreaAsker = async (ui, a) => {
     if (telegramChatId === undefined && telegram.pairedOwnerId !== undefined) {
       const usePaired = await askYesNo(
         ui,
+        "tier2-use-paired-chat",
         "Tier-2 escalations",
         `omp-telegram is paired with chat ${telegram.pairedOwnerId}. Page it when a run is stuck?`,
       );
       if (usePaired) telegramChatId = telegram.pairedOwnerId;
     } else {
-      const answered = await ask(ui, "Telegram chat id for tier-2 escalations (blank for none)", telegramChatId ?? "");
+      const answered = await ask(
+        ui,
+        "tier2-chat-id",
+        "Telegram chat id for tier-2 escalations (blank for none)",
+        telegramChatId ?? "",
+      );
       telegramChatId = answered.length > 0 ? answered : undefined;
     }
   } else {
@@ -1303,6 +1377,7 @@ const askEscalation: AreaAsker = async (ui, a) => {
 
   const fallbackToIssueComment = await askYesNo(
     ui,
+    "escalation-fallback",
     "Escalation fallback",
     "Also comment on the issue when a run escalates? Recommended: a chat message you miss is a run nobody sees.",
   );
@@ -1346,6 +1421,7 @@ async function askTelegramTopicId(
     ];
     const priorIdx = prior === undefined ? -1 : claimed.findIndex((t) => t.threadId === prior);
     const picked = await ui.select("Telegram forum topic for tier-2 pages", options, {
+      key: "tier2-topic",
       initialIndex: priorIdx >= 0 ? priorIdx : claimed.length + 1,
     });
     if (picked === undefined) throw new Cancelled();
@@ -1358,6 +1434,7 @@ async function askTelegramTopicId(
 
   const answered = await ask(
     ui,
+    "tier2-topic-id",
     "Telegram forum topic id (blank for flat chat)",
     prior !== undefined ? String(prior) : "",
   );
@@ -1388,7 +1465,7 @@ const askReporting: AreaAsker = async (ui, a) => {
         description: "hold non-bypass interruptions outside selected local working hours",
       },
     ],
-    { initialIndex: a.availability === undefined ? 0 : 1 },
+    { key: "operator-availability", initialIndex: a.availability === undefined ? 0 : 1 },
   );
   if (mode === undefined) throw new Cancelled();
 
@@ -1420,6 +1497,7 @@ const askReporting: AreaAsker = async (ui, a) => {
           : a.dailyDigestAt ?? (a.digestCadence === "daily" ? "model-timed" : fallback);
     const schedule = await askValid(
       ui,
+      "digest-schedule",
       'Daily rollup time in that timezone / digest cadence ("per-tick", "model-timed", "off", or 24h HH:MM)',
       shown,
       (value) =>
@@ -1444,6 +1522,7 @@ const askReporting: AreaAsker = async (ui, a) => {
     a.reportingTimezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
   const reportingTimezone = await askValid(
     ui,
+    "reporting-timezone",
     "Operator timezone (IANA, for example Europe/London)",
     defaultZone,
     (value) => {
@@ -1457,6 +1536,7 @@ const askReporting: AreaAsker = async (ui, a) => {
   );
   const daysText = await askValid(
     ui,
+    "working-weekdays",
     "Working weekdays (comma-separated: mon,tue,wed,thu,fri,sat,sun)",
     a.availability?.days.join(",") ?? "mon,tue,wed,thu,fri",
     (value) => {
@@ -1470,12 +1550,14 @@ const askReporting: AreaAsker = async (ui, a) => {
   const days = daysText.split(",").map((day) => day.trim().toLowerCase() as Weekday);
   const start = await askValid(
     ui,
+    "availability-start",
     "Availability starts (24h HH:MM)",
     a.availability?.start ?? "09:00",
     (value) => (/^([01]\d|2[0-3]):[0-5]\d$/.test(value) ? undefined : "Use 24h HH:MM."),
   );
   const end = await askValid(
     ui,
+    "availability-end",
     "Availability ends (24h HH:MM)",
     a.availability?.end ?? "17:00",
     (value) =>
@@ -1487,6 +1569,7 @@ const askReporting: AreaAsker = async (ui, a) => {
   );
   const bypassText = await askValid(
     ui,
+    "quiet-hours-bypass",
     `Quiet-hours bypass categories (comma-separated; "none" = none; choices: ${INTERRUPT_CATEGORIES.join(",")})`,
     a.availability === undefined ? "fleet-stopped" : a.availability.bypass.join(",") || "none",
     (value) => {
@@ -1634,7 +1717,7 @@ async function chooseAmendArea(ui: WizardUi, prior: ProjectConfig, defaults: Cap
         description: "full interview for a new project; existing projects stay as they are",
       },
     ],
-    { initialIndex: 0 },
+    { key: `existing-project-action.${prior.name}`, initialIndex: 0 },
   );
   if (mode === undefined) throw new Cancelled();
   if (mode === ADD_PROJECT) return { kind: "add-project" };
@@ -1650,7 +1733,7 @@ async function chooseAmendArea(ui: WizardUi, prior: ProjectConfig, defaults: Cap
   const picked = await ui.select(
     "Which area? Each row shows what it says now",
     choices.map((c) => ({ label: c.label, description: c.description })),
-    { initialIndex: 0 },
+    { key: `amend-area.${prior.name}`, initialIndex: 0 },
   );
   if (picked === undefined) throw new Cancelled();
 
@@ -1693,6 +1776,7 @@ async function collectAnswers(
 
   const projectName = await askValid(
     ui,
+    "project-name",
     "Project name",
     projectArg ?? seed.projectName,
     (v) => (v.length > 0 ? undefined : "A name is required — it is how `omp-conductor status --project <name>` finds this project."),
@@ -1821,7 +1905,7 @@ export async function collectSetup(
             description: "overwrites this project's config entry on apply; other projects untouched",
           },
         ],
-        { initialIndex: 0 },
+        { key: `duplicate-project-action.${answers.projectName}`, initialIndex: 0 },
       );
       if (mode === undefined) throw new Cancelled();
       if (mode.startsWith("Amend")) {
@@ -1866,7 +1950,7 @@ export async function collectSetup(
             description: "overwrites this project's config entry on apply; other projects untouched",
           },
         ],
-        { initialIndex: 0 },
+        { key: `duplicate-project-action.${answers.projectName}`, initialIndex: 0 },
       );
       if (mode === undefined) throw new Cancelled();
       if (mode.startsWith("Amend")) {
@@ -1884,6 +1968,7 @@ export async function collectSetup(
       "Walks every question again and overwrites this project's config entry on apply. " +
         "Other projects are left alone. Cancel and pick \"Change one area\" to amend without a full replace, " +
         "or \"Add another project\" to create a neighbour.",
+      { key: `replace-project.${prior.name}` },
     );
     if (replace !== true) throw new Cancelled();
     return { answers: await collectAnswers(ui, prior, projectArg, probes) };
@@ -1990,6 +2075,7 @@ async function offerCodeGraph(
     "Clones each index-only checkout as you, installs and enables the reindex timer as root, then seeds one " +
       "indexing run so the first fetch happens while you watch. Minutes per repo. " +
       "`omp-conductor setup graph` does the same later; `--no-seed` skips the seeding run.",
+    { key: `offer-code-graph.${project.name}` },
   );
   if (wantsGraph === true) await graphInstall(project, ui);
   else
@@ -2202,7 +2288,7 @@ export async function setup(
       amend === undefined ? "Apply this setup?" : `Apply this change to ${AMEND_AREAS[amend.area].name}?`,
       REVIEW_CHOICES,
       // Bare Enter lands on Review — the one row with no effect.
-      { initialIndex: 2 },
+      { key: "setup-review", initialIndex: 2 },
     );
     if (choice === undefined) {
       ui.notify("Setup cancelled — nothing was changed, and the answers were discarded.", "info");
@@ -2229,7 +2315,7 @@ export async function setup(
     const pickedArea = await ui.select(
       "Edit which area?",
       INTERVIEW_AREAS.map((area) => ({ label: area.label })),
-      { initialIndex: 0 },
+      { key: "setup-edit-area", initialIndex: 0 },
     );
     if (pickedArea === undefined) {
       ui.notify("Editing cancelled — the answers stand as they were.", "info");
@@ -2270,12 +2356,16 @@ export async function setup(
   // last re-derivation: the loop above can only break here on a final "Apply",
   // so this one-writer sequence runs exactly once per setup run.
   prepareConductor(plan.project.name);
-  const created = await apply.createLabels(answers.trackerRepo, plan.labels);
+  const created = await withProgress("Creating tracker labels", "Tracker labels ready", () =>
+    apply.createLabels(answers.trackerRepo, plan.labels),
+  );
   saveConfig(plan.nextConfig);
   const briefPath = answers.writeOrchestratorBrief ? writeOrchestratorBrief(answers, prose) : undefined;
   const runtimeFiles = writeHostRuntime(plan.runtime);
   for (const warning of runtimeFiles.warnings) ui.notify(warning, "warning");
-  const smoke = await apply.smoke(plan.project.name);
+  const smoke = await withProgress("Running setup smoke", "Setup smoke passed", () =>
+    apply.smoke(plan.project.name),
+  );
   let smokeLine =
     `paused daemon --once; temporary /healthz on :${smoke.daemon.port}; ` +
     `stored status for ${smoke.status.project}`;
@@ -2392,6 +2482,7 @@ export async function setup(
       `${plan.runtime.installedAction === "create" ? "Installs" : "Updates"} ${plan.runtime.installedPath} from ` +
         `${plan.runtime.service.path}, then enables and restarts it. Needs root, one step at a time, and shows every ` +
         "command before it runs. Skipping is fine — `omp-conductor setup host` does exactly this later.",
+      { key: `install-daemon.${plan.project.name}` },
     );
     if (install === true)
       await apply.hostInstall(