@coreplane/switchboard 1.260.3 → 1.260.4

package/dist/cli.js

@@ -1874,7 +1874,7 @@ function bashBudgetWithinRun(wantedMs, remainingMs) {
   if (cap < BASH_TIMEOUT_MIN_MS) {
     return {
       kind: "exhausted",
-      note: `run budget exhausted \u2014 ${secs(remainingMs)}s of wall clock left, inside the ${secs(RUN_DEADLINE_RESERVE_MS)}s write-up reserve, so the command was not run; write up what you have now`
+      note: `the run budget is exhausted \u2014 ${secs(remainingMs)}s of wall clock left, inside the ${secs(RUN_DEADLINE_RESERVE_MS)}s write-up reserve, so the command was not run; write up what you have now`
     };
   }
   if (cap >= wantedMs) return { kind: "unchanged" };
@@ -2094,7 +2094,7 @@ function renderFirstInstruction(rebase) {
   const branch2 = rebase.branch ? `\`${rebase.branch}\`` : "the unit's branch";
   const onto = rebase.onto ? `\`${rebase.onto}\`` : "the merged parent";
   const gates = `${FAST_GATES_POINTER} ${GATE_RECEIPTS}`;
-  return `Rebase ${branch2} onto ${onto} before any other work \u2014 the parent unit has merged and the base has moved; the only writes are your own on that branch. Push the branch as soon as the change exists and the fast gates pass \u2014 the project's full verification is CI's gate, run there after the push with any fix as a further commit; an unpushed tree does not survive the run's end. ${gates} ${REBASE_POINTER} At the wind-down note, commit and push what compiles, say what does not, then answer. ${TIMEOUT_ON_LONG_COMMANDS}`;
+  return `Rebase ${branch2} onto ${onto} before any other work \u2014 the parent unit has merged and the base has moved; the only writes are your own on that branch. Push the branch as soon as the change exists and the fast gates pass \u2014 the project's full verification is CI's gate and runs there after the push, with any fix as a further commit; an unpushed tree does not survive the run's end. ${gates} ${REBASE_POINTER} At the wind-down note, commit and push what compiles, say what does not, then answer. ${TIMEOUT_ON_LONG_COMMANDS}`;
 }
 function renderSpecRow(row2, dropText) {
   const head = `#### ${row2.spec} item ${row2.item}`;
@@ -3007,7 +3007,7 @@ function renewalDecision(input) {
   };
 }
 function renderRenewal(decision, grant2, options = {}) {
-  const recourse = options.idle ? "reply in this thread to continue" : "re-issue the request to try again";
+  const recourse = options.idle ? "the next reply in this thread continues the unit" : "the next reply in this thread continues the original task";
   const senders = options.senders?.length ? `, with ${options.senders.length} message${options.senders.length === 1 ? "" : "s"} from ${options.senders.join(", ")}` : "";
   if (decision.renew)
     return `budget renewed, ${decision.segment - 1} of ${grant2.renewals}, continues ${decision.from !== void 0 ? decision.from.slice(0, 7) : "the branch's head"}${senders}`;
@@ -3455,9 +3455,9 @@ function interruptionCauseOfWords(words) {
 }
 function shipInterruptedNote(prUrl3, cause, idle = false) {
   const stands = prUrl3 ? `Its work stands on GitHub: ${prUrl3}.` : "Whatever it pushed stands on its pipeline branch; no PR was opened yet.";
-  const reissue = idle ? "To continue, reply in this thread to continue." : prUrl3 ? `To continue the review loop, re-issue \`agent:ship\` in this thread with only the PR URL (${prUrl3}).` : "To continue, re-issue `agent:ship` in this thread with the task \u2014 round 0 runs again on the same branch.";
+  const continuation = idle ? "The next reply in this thread continues the unit." : prUrl3 ? `The pipeline kept its task, branch and pull request; the next reply in this thread continues the review loop at ${prUrl3}.` : "The pipeline kept its task and branch; the next reply in this thread starts round 0 again on that branch.";
   const opening = cause === "container_replaced" ? "\u26A0\uFE0F The resident container running this pipeline's child was replaced (a deploy's image swap) and the child could not resume, so the pipeline stopped." : cause === "sandbox_fault" ? "\u26A0\uFE0F The sandbox running this pipeline's child failed and the child could not resume, so the pipeline stopped." : cause === "bot_restart" ? "\u26A0\uFE0F The bot restarted while this ship pipeline was running, so the pipeline stopped." : "\u26A0\uFE0F This ship pipeline's child was interrupted and could not resume, so the pipeline stopped.";
-  return `${opening} ${stands} ${reissue}`;
+  return `${opening} ${stands} ${continuation}`;
 }
 function planIdOf(planPath) {
   const base = planPath.split("/").pop() ?? "";
@@ -4735,7 +4735,7 @@ function analyzeRunFriction(events, opts = {}) {
       findings.push({
         category: "infra_failure",
         severity: "high",
-        summary: `no result for tool call (run ended mid-tool): ${event.summary}`,
+        summary: `no result for tool call (the run ended mid-tool): ${event.summary}`,
         tool: event.tool,
         eventIndex: index,
         ...durationMs !== void 0 ? { durationMs } : {},
@@ -11680,13 +11680,13 @@ function fleetBusyRunEndedLine(run2, thread, err2) {
   });
 }
 function fleetBusyExhaustedMessage(waitedMs) {
-  return `sandbox fleet busy \u2014 no free per-thread sandbox after waiting ${Math.round(waitedMs / 1e3)}s (the fleet's max_instances is reached); try again in a few minutes`;
+  return `this is a bug: the sandbox fleet had no free per-thread sandbox after waiting ${Math.round(waitedMs / 1e3)}s (the fleet's max_instances is reached), and no automatic queue remained`;
 }
 function isWaitReason(reason2) {
   return reason2 === FLEET_BUSY_REASON || reason2 === SANDBOX_STARTING_REASON || reason2 === RUNTIME_BUSY_REASON;
 }
 function startWaitExhaustedMessage(waitedMs) {
-  return `sandbox not ready \u2014 the thread's container did not finish starting within ${Math.round(waitedMs / 1e3)}s; try again in a few minutes`;
+  return `this is a bug: the thread's sandbox did not finish starting within ${Math.round(waitedMs / 1e3)}s, and no automatic start wait remained`;
 }
 function runtimeBusyExhaustedMessage(waitedMs) {
   return `sandbox busy \u2014 the thread's container did not accept a connection within ${Math.round(waitedMs / 1e3)}s (the platform refused every connect of the wait; a command saturating its cores is one cause, an idle container has met it too); retry`;
@@ -15748,9 +15748,7 @@ var init_resident = __esm({
        *  the factory binds the thread to it (loudly) instead of asking. Undefined
        *  from a Worker predating that field → the dispatcher asks as before. */
       constructor(resource, defaultRef) {
-        super(
-          `the ${resource} resident needs a branch for this thread: no ref is bound yet. Name the branch to work on (e.g. "on main") and try again.`
-        );
+        super(`Which branch should the ${resource} resident use for this thread (for example, "main")?`);
         this.resource = resource;
         this.defaultRef = defaultRef;
         this.name = "ResidentNeedsRefError";
@@ -16280,7 +16278,7 @@ var init_resident = __esm({
         const callTimeoutMs = opts.callTimeoutMs ?? BASH_TIMEOUT_MS;
         const stillGone = (data) => classifyError(
           new ExecInfraError(
-            `resident ${route2}: worktree still unavailable after a re-attach (${String(data.error ?? "")}) \u2014 the resident may be mid-restore; try again shortly.`,
+            `this is a bug: resident ${route2} still had no worktree after its automatic re-attach (${String(data.error ?? "")}); no further restore wait was scheduled`,
             "refused"
           ),
           { kind: "infra", code: "attach" }
@@ -21529,7 +21527,7 @@ var init_metricsService = __esm({
     init_budgets();
     init_metrics();
     init_clock();
-    METRICS_OFF_MESSAGE = "Run metrics aren't configured \u2014 set metrics.dataset in config (beside the costs block's Cloudflare account and analytics token) to enable this view.";
+    METRICS_OFF_MESSAGE = "Metrics by run aren't configured \u2014 metrics.dataset in config (beside the costs block's Cloudflare account and analytics token) enables this view.";
     NullMetricsService = class {
       report() {
         return Promise.reject(new Error(METRICS_OFF_MESSAGE));
@@ -23045,7 +23043,7 @@ var init_artifacts = __esm({
         if (!read.ok)
           throw new CommandError(
             "unavailable",
-            `the rules were applied to ${bucket} but reading them back failed \u2014 ${read.problem}; run \`artifacts lifecycle\` again to confirm`
+            `this is a bug: the rules were applied to ${bucket}, but their read-back failed (${read.problem}) and no automatic confirmation was completed`
           );
         const match = rulesMatch(read.value, rules);
         if (!match.ok)
@@ -23565,7 +23563,7 @@ var init_config4 = __esm({
         destructive: destructiveBeyondMe,
         risk: configRisk
       },
-      describe: "Drop every runtime override of a channel (gated), of yourself (your GitHub binding stays \u2014 it is an identity admin's write), or of a thread (gated like the channel); `config clear user --user <id>` removes one person's GitHub binding (identity admins). Static config.yaml values show through again.",
+      describe: "Drops every runtime override of a channel (gated), of yourself (your GitHub binding stays \u2014 it is an identity admin's write), or of a thread (gated like the channel); `config clear user --user <id>` removes one person's GitHub binding (identity admins). Static config.yaml values show through again.",
       render: (output) => {
         const scope = output.scope;
         return scope === "user" ? "Cleared the user's GitHub binding." : `Cleared ${who(scope)} overrides.`;
@@ -23809,7 +23807,7 @@ function renderCostsBy(output, surface = "text") {
   const columns = surface === "chat" ? [] : [
     `${String(o.dimension).padEnd(40)} ${count.padStart(6)} ${"LLM".padStart(10)}${cloud ? "cloud".padStart(10) : ""} ${"total".padStart(10)} share`
   ];
-  const where = coverage2.historyOn === false ? "run history is off \u2014 no runs to attribute" : `runs from ${String(coverage2.from)}${coverage2.clamped === true ? ` (earlier days are past the history's ${String(coverage2.retentionDays)}-day window)` : ""}${typeof o.pending === "number" && o.pending > 0 ? ` \xB7 ${o.pending} run(s) still being priced` : ""}`;
+  const where = coverage2.historyOn === false ? "history is off \u2014 no runs to attribute" : `runs from ${String(coverage2.from)}${coverage2.clamped === true ? ` (earlier days are past the history's ${String(coverage2.retentionDays)}-day window)` : ""}${typeof o.pending === "number" && o.pending > 0 ? ` \xB7 ${o.pending} run(s) still being priced` : ""}`;
   const tieOut = typeof rec2.comparedDays === "number" && rec2.comparedDays > 0 ? `LLM attributed ${money(rec2.attributedLlmUsd)} of ${money(rec2.workspaceLlmUsd)} on the workspace over ${rec2.comparedDays} day(s)` + (typeof rec2.unattributedLlmUsd === "number" && rec2.unattributedLlmUsd < 0 ? ` \xB7 ${money(-rec2.unattributedLlmUsd)} more attributed than the workspace figure` : ` \xB7 ${money(rec2.unattributedLlmUsd)} unattributed`) : "no day in range has a workspace LLM figure to compare against";
   const cloudLine = cloud ? ` \xB7 cloud allocated ${money(rec2.cloudAllocatedUsd)}${typeof rec2.cloudUnallocatedUsd === "number" && rec2.cloudUnallocatedUsd > 0 ? ` \xB7 ${money(rec2.cloudUnallocatedUsd)} on days with no runs` : ""}` : "";
   return [
@@ -23852,7 +23850,7 @@ var init_costs2 = __esm({
           if (message4 === COSTS_OFF_MESSAGE) throw new CommandError("unavailable", message4);
           throw new CommandError(
             "busy",
-            `costs snapshot not taken: ${message4} \u2014 the previous snapshot still serves; try again`
+            `costs snapshot not taken: ${message4} \u2014 the previous snapshot still serves, and the scheduled loop will take the next snapshot`
           );
         }
       }
@@ -24288,7 +24286,7 @@ ${formatDeployResults(result.results, result.notAttempted)}`
         if (drift.length > 0)
           throw new CommandError(
             "conflict",
-            `Worker configs are not the render of their templates \u2014 ${drift.map((f) => `${f.path} (${f.status})`).join(", ")}; run \`npm run deploy:gen\` and commit the result`
+            `this is a bug: Worker configs are not the render of their templates \u2014 ${drift.map((f) => `${f.path} (${f.status})`).join(", ")} \u2014 and deploy did not repair or commit the generated files automatically`
           );
         const output = { profile: { origin: loaded.origin, path: loaded.path }, files };
         return output;
@@ -24703,7 +24701,7 @@ function patternSignature(f) {
       return "slow_model_turn:model_turn";
     case "infra_failure": {
       if (summary.startsWith("sandbox dead")) return "infra_failure:sandbox_dead";
-      const mid = /^no result for tool call \(run ended mid-tool\):\s*/.exec(summary);
+      const mid = /^no result for tool call \(the run ended mid-tool\):\s*/.exec(summary);
       if (mid) return `infra_failure:mid-tool ${commandSignature(summary.slice(mid[0].length))}`;
       const during = /^exec infrastructure failed during\s*/.exec(summary);
       return `infra_failure:${commandSignature(during ? summary.slice(during[0].length) : summary)}`;
@@ -25265,7 +25263,7 @@ async function recentRecords(ledger, query) {
 function inProgressHint(diagnosis, finished) {
   if (!finished) return void 0;
   const midTool = diagnosis.findings.some(
-    (f) => f.category === "infra_failure" && f.summary.includes("run ended mid-tool")
+    (f) => f.category === "infra_failure" && f.summary.includes("the run ended mid-tool")
   );
   return midTool ? "(hint: the stream ends on a tool call with no result \u2014 if this capture was taken mid-run, pass --in-progress)" : void 0;
 }
@@ -25286,7 +25284,7 @@ var init_friction = __esm({
     defineCommand9 = commandDefiner();
     positiveInt2 = z12.coerce.number().int().positive();
     repoSlug = z12.string().refine((s) => /^[\w.-]+\/[\w.-]+$/.test(s), "expected an owner/name slug");
-    NO_LEDGER_MESSAGE = "Run history is not configured in this deployment (`runHistory`), so there are no recent runs to analyze.";
+    NO_LEDGER_MESSAGE = "History is not configured in this deployment (`runHistory`), so there are no recent runs to analyze.";
     NO_REPO_MESSAGE = "Set `selfImprovement.repo` (an `owner/name`) in config.yaml to tell `friction propose` where to file issues.";
     asJson2 = (r) => r;
     render = (output) => formatSelfImprovementReport(output);
@@ -25338,7 +25336,7 @@ var init_friction = __esm({
         openWorld: true,
         risk: (input) => dryRunRequested(input) ? PLAN_ONLY_RISK : "files issues on the tracker"
       },
-      describe: "Run the self-improvement step: cluster recent friction, dedupe against open issues, file the top proposals as labeled issues.",
+      describe: "Clusters recent friction, deduplicates against open issues, and files the top proposals as labeled issues.",
       render,
       handler: async ({ options, caller, deps }) => {
         const ledger = await ledgerOf(deps);
@@ -25927,15 +25925,15 @@ function planCallback(ticket, identity2, now) {
 function refusalMessage(r) {
   switch (r.kind) {
     case "not_authorizing":
-      return "This sign-in did not start from a connect link, or the link was opened again since. Open the connect link and try again.";
+      return "This is a bug: this sign-in did not start from a live connect link, and no fresh connect link was opened automatically.";
     case "oauth_failed":
       return `Sign-in with the server did not complete: ${r.reason}.`;
     case "not_found":
-      return "This connect link is not known. Ask for a new one with `mcp connect <name>`.";
+      return "This is a bug: this connect link is not known, and no fresh connect link was opened automatically.";
     case "expired":
-      return "This connect link has expired (links last 10 minutes). Ask for a new one with `mcp connect <name>`.";
+      return "This is a bug: this connect link expired after 10 minutes, and no fresh connect link was opened automatically.";
     case "used":
-      return "This connect link was already used. If the credential needs replacing, ask for a new one with `mcp connect <name>`.";
+      return "This connect link was already used; no credential was changed by this visit.";
     case "cancelled":
       return "This connect link was cancelled.";
     case "wrong_identity":
@@ -25988,7 +25986,7 @@ async function readCapped2(res, max, signal2) {
   let total = 0;
   try {
     for (; ; ) {
-      if (signal2?.aborted) throw new McpError("timeout", "run aborted");
+      if (signal2?.aborted) throw new McpError("timeout", "the run was aborted");
       const { value, done } = await reader.read();
       if (done) break;
       if (value) {
@@ -26484,7 +26482,7 @@ function needsRefresh(cred, now) {
 async function refreshCredential(fetchImpl, cred, now) {
   if (!cred.refreshToken)
     throw new OAuthError(
-      "the access token expired and the server issued no refresh token \u2014 run `mcp connect` to sign in again"
+      "this is a bug: the access token expired, the server issued no refresh token, and no fresh sign-in was opened automatically"
     );
   const tokens = await tokenRequest(fetchImpl, cred.tokenEndpoint, {
     grant_type: "refresh_token",
@@ -27701,7 +27699,7 @@ var init_service = __esm({
         } catch (err2) {
           return { name: r.name, unavailable: `secret store: ${err2 instanceof Error ? err2.message : String(err2)}` };
         }
-        if (!sealed) return { name: r.name, unavailable: "no credential stored \u2014 run `mcp connect`" };
+        if (!sealed) return { name: r.name, unavailable: "no credential is stored, so this server is unavailable" };
         try {
           const stored = parseStoredCredential(await openCredential(this.opts.key, sealed));
           if (stored.kind === "bearer") return { spec: { ...base, auth: { type: "bearer", token: stored.token } } };
@@ -27926,7 +27924,7 @@ var init_mcp = __esm({
       // Org-only by definition: it changes what every run in the org can reach,
       // so it is destructive at its every input (record 0057's audit rule).
       annotations: { destructive: true, risk: () => "adds or moves a server every run in the scope can use" },
-      describe: "Re-issue a person's MCP server in the org tier (admins): the same name, URL and auth, added by you; a bearer/oauth server gets a fresh org connect link for you to complete \u2014 the person's credential is never copied.",
+      describe: "Promote a person's MCP server into the org tier (admins): the same name, URL and auth, added by you; a bearer/oauth server gets a fresh org connect link for you to complete \u2014 the person's credential is never copied.",
       render: renderAdd,
       settle: (output, { deps }) => settleConnect(deps, output),
       handler: async ({ args, options, caller, deps }) => {
@@ -29764,7 +29762,7 @@ async function fencedTarget(args) {
   if (args.refusePending && checks.total === 0)
     throw new CommandError(
       "conflict",
-      `no check reported at the head of ${name} \u2014 nothing was done; retry once CI registers (a repository with no CI stays a person's click on GitHub)`
+      `no check reported at the head of ${name} \u2014 nothing was done; this is a bug when the repository has CI because no automatic wait or event re-fire was scheduled (a repository with no CI stays a person's click on GitHub)`
     );
   if (checks.failed.length > 0)
     throw new CommandError(
@@ -29957,7 +29955,7 @@ var init_metrics2 = __esm({
           const message4 = err2 instanceof Error ? err2.message : String(err2);
           if (message4 === METRICS_OFF_MESSAGE) throw new CommandError("unavailable", message4);
           const kind = err2 instanceof Error ? err2.name : "Error";
-          throw new CommandError("unavailable", `run metrics unavailable: ${kind}: ${message4}`);
+          throw new CommandError("unavailable", `metrics by run unavailable: ${kind}: ${message4}`);
         }
       }
     });
@@ -29992,7 +29990,7 @@ function runLine(row2, now, surface) {
 }
 function prLine(row2, surface) {
   const name = `${row2.pr.repo}#${row2.pr.number}`;
-  const owner = row2.owner.unitKey ?? (row2.owner.runId ? `run ${shortId(row2.owner.runId)}` : "a person");
+  const owner = row2.owner.unitKey ?? (row2.owner.runId ? `the run ${shortId(row2.owner.runId)}` : "a person");
   const health = healthWords(row2.health) || "-";
   if (surface === "chat") return `\u2022 ${name} \u2014 ${health} \xB7 ${owner}`;
   return `${name.padEnd(32)}  ${health.padEnd(24)}  ${owner}`.trimEnd();
@@ -30484,7 +30482,7 @@ function defineOp(op) {
     // agent, or the exec grant a token was minted with (policy.ts).
     resource: () => ({ type: "agent", name: "coding" }),
     effect: "write",
-    describe: `Run the repo's onboarded ${op} command with zero model turns (needs coding-agent access; the ref must be a plausible branch).`,
+    describe: `Executes the repo's onboarded ${op} command with zero model turns (needs coding-agent access; the ref must be a plausible branch).`,
     render: renderOp,
     handler: async ({ args, caller, deps, span }) => {
       if (!await deps.repo.canUseRepo(caller.id, args.slug))
@@ -30530,7 +30528,7 @@ ${line4}` : ""}`);
         case "error":
           throw new CommandError(
             "unavailable",
-            result.transient === true ? `${result.message} \u2014 the resident was unavailable for a moment; re-run the command` : result.message
+            result.transient === true ? `${result.message} \u2014 the resident was unavailable for a moment; Switchboard ended the command as unavailable` : result.message
           );
       }
     }
@@ -30718,7 +30716,7 @@ ${line4}`
             `\u2022 ${n(w.backupObjects)} snapshot backup object(s) in R2${ids}`,
             `\u2022 ${n(w.r2Objects)} object(s) under the resident's R2 prefix`,
             `\u2022 ${n(w.threadBindings)} thread binding(s) and the container (currently \`${String(w.container ?? "?")}\`)`,
-            `Nothing was changed. Run \`repo offboard ${slug}\` to execute.`
+            `Nothing was changed. Without \`--dry-run\`, \`repo offboard ${slug}\` performs this removal.`
           ].join("\n");
         }
         const errors = Array.isArray(o.errors) ? o.errors : [];
@@ -30758,7 +30756,7 @@ ${line4}`
             snap ? `\u2022 discard the snapshot from ${String(snap.createdAt ?? "?")} (${n(discards.backupObjects)} backup object(s); ids ${String(snap.mirrorBackupId ?? "?")}, ${String(snap.checkoutBackupId ?? "?")})` : "\u2022 discard no snapshot (none recorded)",
             `\u2022 reprovision from scratch on \`${String(reprov.defaultRef ?? "?")}\` (budget ${n(reprov.provisioningTimeoutMs)}ms)`,
             `\u2022 keep the registry record and ${n(keeps.threadBindings)} thread binding(s)`,
-            `Nothing was changed. Run \`repo rebuild ${slug}\` to execute.`
+            `Nothing was changed. Without \`--dry-run\`, \`repo rebuild ${slug}\` performs this rebuild.`
           ].join("\n");
         }
         return `\u{1F504} Rebuilding \`${slug}\`: discarded ${n(o.backupObjectsDeleted)} backup object(s); reprovisioning from scratch on \`${String(reprov.defaultRef ?? "?")}\` (state \`onboarding\` \u2014 I'll report here when it is warm or has failed; \`repo list\` shows the live state meanwhile).`;
@@ -31704,7 +31702,7 @@ function newestFinished(a, b) {
 }
 function hostedSealAnswer(units, runnerStopped) {
   const lines = units.map((u) => {
-    const how = u.ending ? u.ending.kind : u.threadKey !== void 0 ? "no ending was recorded \u2014 re-issue `agent:ship` in its thread to continue" : "not started";
+    const how = u.ending ? u.ending.kind : u.threadKey !== void 0 ? "no ending was recorded \u2014 the next reply in its thread continues the unit" : "not started";
     return `${u.unit} \u2014 ${how}${u.pr ? ` \u2014 ${u.pr.url}` : ""}`;
   });
   return [
@@ -32345,10 +32343,10 @@ async function abridgerOf(deps) {
 async function assertVisible(deps, id, caller) {
   const runs = await deps.review.runs();
   const res = await runs.getRun(id);
-  if (!res.ok) throw new CommandError("not_found", "run not found");
+  if (!res.ok) throw new CommandError("not_found", "no run found");
   const actor = caller.actor;
   if (!authorize(actor, "runs:read", runResource(res.value)).allow)
-    throw new CommandError("not_found", "run not found", "policy");
+    throw new CommandError("not_found", "no run found", "policy");
 }
 function refused2(err2) {
   if (err2 instanceof AbridgeRefusal) throw new CommandError(err2.code, err2.message);
@@ -32368,13 +32366,13 @@ var init_review = __esm({
     init_runsService();
     defineCommand19 = commandDefiner();
     runId = z22.string().regex(RUN_ID_PATTERN);
-    ABRIDGE_OFF_MESSAGE = "The abridged reading diff is off in this deployment: it needs the `meat` binary on the bot host, the Anthropic provider's credential, `review.readingDiff.provider` not `off`, and run history to store it.";
+    ABRIDGE_OFF_MESSAGE = "The abridged reading diff is off in this deployment: it needs the `meat` binary on the bot host, the Anthropic provider's credential, `review.readingDiff.provider` not `off`, plus history to store it.";
     reviewAbridge = defineCommand19({
       id: "review.abridge",
       // Hidden unless the abridging can happen here (the binary, the credential,
       // the switch) AND there is a record to append to.
       enabledWhen: (caps) => caps.runHistory && caps.readingDiffAbridge,
-      args: [{ name: "id", schema: runId, describe: "run id of a finished PR review" }],
+      args: [{ name: "id", schema: runId, describe: "id of a finished PR review run" }],
       options: z22.object({
         model: z22.string().min(1).optional().describe("meat's model (default review.readingDiff.meatModel; without either the abridge fails naming the key)"),
         force: flag.optional().describe("recompute even when an abridged diff is already stored, or retry a failed one"),
@@ -32414,7 +32412,7 @@ import { z as z23 } from "zod";
 function unwrap2(res, what = "run") {
   if (res.ok) return res.value;
   if (res.error === "hosted") throw new CommandError("conflict", HOSTED_STOP_REFUSAL);
-  throw new CommandError(res.error, res.error === "not_found" ? `${what} not found` : "run already finished");
+  throw new CommandError(res.error, res.error === "not_found" ? `no ${what} found` : "the run already finished");
 }
 async function getVisibleRun(runs, id, caller, action, deps, commandId, opts = {}) {
   const view = unwrap2(await runs.getRun(id, opts));
@@ -32422,7 +32420,7 @@ async function getVisibleRun(runs, id, caller, action, deps, commandId, opts = {
   const decision = authorize(actor, action, runResource(view));
   if (!decision.allow) {
     (deps.denied ?? logDenied)({ commandId, actorId: actor.id, action, reason: decision.reason });
-    throw new CommandError("not_found", "run not found");
+    throw new CommandError("not_found", "no run found");
   }
   return view;
 }
@@ -32553,7 +32551,7 @@ var init_runs = __esm({
     defineCommand20 = commandDefiner();
     runId2 = z23.string().regex(RUN_ID_PATTERN);
     positiveInt3 = z23.coerce.number().int().positive();
-    idArg = { name: "id", schema: runId2, describe: "run id" };
+    idArg = { name: "id", schema: runId2, describe: "id of the run" };
     HOSTED_STOP_REFUSAL = "this run is a pipeline; its units run in their own threads, so a soft stop ends nothing; `--mode hard` is the escape: it seals the run failed and releases the thread";
     NO_RUNS_NAME_PR = "no runs name this pull request";
     SESSION_SEARCH_DEFAULT_HITS = 10;
@@ -33121,8 +33119,8 @@ function capabilityLine(c) {
     `execution ${c.execution}`,
     `github ${onOff(c.github)}`,
     `memory ${onOff(c.memory)}`,
-    `run history ${onOff(c.runHistory)}`,
-    `run ledger ${onOff(c.runLedger)}`,
+    `history ${onOff(c.runHistory)}`,
+    `ledger ${onOff(c.runLedger)}`,
     `mcp ${onOff(c.mcp)}`,
     `costs ${onOff(c.costs)}`,
     `schedules ${onOff(c.schedules)}`,
@@ -35073,7 +35071,7 @@ function activityLine(e) {
     case "answer":
       return "answer ready";
     case "run_meta":
-      return "run context recorded";
+      return "context for the run recorded";
     // published straight to the registry too — never arrives here
     case "lease":
       return "lease started";
@@ -35363,13 +35361,13 @@ var init_reply = __esm({
       live_agent_allowlist: (p) => `\u{1F6AB} You're not on the allowlist for the \`${p.agent}\` agent, whose run is in flight in this thread. Ask ${p.adminsHint} for access.`,
       elsewhere_agent_allowlist: (p) => `\u{1F6AB} You're not on the allowlist for the \`${p.agent}\` agent, whose run is in flight in this thread. Ask ${p.adminsHint} for access.`,
       repo_not_visible: (p) => `\u{1F4E6} \`${p.slug}\` is not a repository this installation can see \u2014 GitHub answered 404 \u2014 so I did not start ${aRun(p.agent)} for it. The repository is outside the Switchboard GitHub App installation (\`github_repos\` lists the reachable ones), or the name is wrong.`,
-      repo_unverified: (p) => p.via === "github" ? `\u26A0\uFE0F I couldn't verify \`${p.slug}\` against GitHub \u2014 it didn't answer \u2014 so I did not start ${aRun(p.agent)} rather than guess which repository you meant. Try again in a minute.` : `\u26A0\uFE0F I couldn't verify that \`${p.slug}\` is an onboarded repo \u2014 the resident registry didn't answer \u2014 so I did not start a *${p.agent}* run rather than guess which repo you meant. Try again in a minute, or name the repository by URL (https://github.com/${p.slug}) to run in a cold per-thread sandbox.`,
+      repo_unverified: (p) => p.via === "github" ? `\u26A0\uFE0F This is a bug: I couldn't verify \`${p.slug}\` against GitHub because it did not answer, so I did not start ${aRun(p.agent)} and no automatic retry was scheduled.` : `\u26A0\uFE0F This is a bug: I couldn't verify that \`${p.slug}\` is an onboarded repo because the resident registry did not answer, so I did not start a *${p.agent}* run and no automatic fallback was started.`,
       repo_not_onboarded: (p) => `\u{1F4E6} \`${p.slug}\` is not onboarded as a resident, so I did not start a *${p.agent}* run for it. ${p.onboardHint} for a warm, deps-ready environment, or name the repository by URL (https://github.com/${p.slug}) to run in a cold per-thread sandbox.`,
       repo_access: (p) => `\u{1F6AB} You're not on the allowlist for the \`${p.repo}\` repo environment. Ask ${p.adminsHint} for access.`,
       which_branch: (p) => `\u{1F33F} Which branch of \`${p.repo}\` should this thread work on? No branch is bound yet; a branch token such as \`branch:main\` will bind it.`,
       ship_thread_live: () => "\u{1F6AB} A pipeline is already running in this thread \u2014 one pipeline per thread. Follow the one in flight here, or start this one in a thread of its own.",
       pipeline_thread_owned: (p) => `\u{1F6A6} This thread belongs to the live *${p.agent}* pipeline runner \u2014 nothing runs beside it here. ` + (p.units.length > 0 ? `Reply in the unit's own thread instead: ${p.units.map((u) => `${u.unit}${u.threadKey !== void 0 ? ` (\`${u.threadKey}\`)` : ""}`).join(", ")}.` : "Reply in the unit's own thread instead."),
-      ship_budget: (p) => `\u{1F6AB} Ship cannot start under a ${p.maxMinutes}-minute budget: the loop it allows (${p.maxRounds} review rounds) needs ${p.need} minutes \u2014 ${p.provision} to provision, the coding child's ${p.coding}, and the reserve for the rounds after it at their floors. Widen the budget or the boundary that clipped it, or run \`agent:coding\` for a single pass without the review loop.`
+      ship_budget: (p) => `\u{1F6AB} Ship cannot start under a ${p.maxMinutes}-minute budget: the loop it allows (${p.maxRounds} review rounds) needs ${p.need} minutes \u2014 ${p.provision} to provision, the coding child's ${p.coding}, and the reserve for the rounds after it at their floors. Switchboard left the budget and boundary unchanged and did not start either the review loop or a single coding pass.`
     };
     LONG_COMMAND_REPLY_CHARS = 3e3;
   }
@@ -36064,7 +36062,7 @@ function checkPrHeadPreflight(input) {
   return {
     ok: false,
     where,
-    reply: `\u{1F500} Review of ${where} not started: GitHub did not give me a usable head commit for the PR (the lookup failed, or answered without a well-formed SHA), so I cannot pin a review to it. Re-send the request in a moment; if it keeps failing, look at the PR on GitHub and at the bot's GitHub App credentials.`
+    reply: `\u{1F500} Review of ${where} not started: GitHub did not give me a usable head commit for the PR (the lookup failed, or answered without a well-formed SHA), so I cannot pin a review to it. This is a bug: no automatic head lookup retry was scheduled, and nothing was posted to GitHub.`
   };
 }
 async function guardAttachedHead(input) {
@@ -36079,7 +36077,7 @@ async function guardAttachedHead(input) {
     console.log(`[review] ${input.logKey} not started: ${namedSource} unreadable, PR head ${expected} (${where})`);
     return {
       outcome: "refused",
-      reply: `\u{1F500} Review of ${where} not started: ${namedSource} could not be read, so the workspace cannot be verified against PR head ${expected}. This infrastructure failure is not a finding and nothing was posted to GitHub; re-send the request after the workspace backend recovers.`
+      reply: `\u{1F500} Review of ${where} not started: ${namedSource} could not be read, so the workspace cannot be verified against PR head ${expected}. This is a bug: the infrastructure failure was not retried automatically. It is not a finding, and nothing was posted to GitHub.`
     };
   }
   if (sameCommit(expected, attached)) return { outcome: "verified" };
@@ -36093,7 +36091,7 @@ async function guardAttachedHead(input) {
   console.log(`[review] ${input.logKey} not started: ${namedSource} ${attached}, PR head ${expected} (${where})`);
   return {
     outcome: "refused",
-    reply: `\u{1F500} Review of ${where} not started: the ${namedSource} is at ${attached}, but the PR head is ${expected} \u2014 the branch moved while the workspace was being prepared (a push or force-push). This infrastructure mismatch is not a finding and nothing was posted to GitHub; re-send the request to review the new head.`
+    reply: `\u{1F500} Review of ${where} not started: the ${namedSource} is at ${attached}, but the PR head is ${expected} \u2014 the branch moved while the workspace was being prepared (a push or force-push). This is a bug: the workspace was not reprovisioned automatically at the new head. It is not a finding, and nothing was posted to GitHub.`
   };
 }
 function makeSystemComposer(input) {
@@ -36415,56 +36413,34 @@ function boundaryOf(scope) {
       return "the parent run's remaining budget";
   }
 }
-function wayForward(scope, axis, needs, adminsHint) {
+function boundaryOutcome(scope) {
   switch (scope) {
     case "channel":
-      return `run it in a channel that allows \`${needs}\`, or ask ${adminsHint} to raise this channel's boundary`;
+      return "Switchboard left this channel's boundary unchanged";
     case "user":
-      return `raise your own boundary with \`config set me --boundary.${axis} ${needs}\`, or drop your overrides with \`config clear me\``;
+      return "Switchboard left your boundary and overrides unchanged";
     case "defaults":
-      return `ask ${adminsHint} to raise \`defaults.boundary\` in the configuration`;
+      return "Switchboard left the installation's default boundary unchanged";
     case "directive":
-      return "send the message again without the budget directive";
+      return "Switchboard applied this message's budget directive";
     case "parent":
-      return `spawn it from a run with at least ${needs} left`;
+      return "Switchboard left the parent run's remaining budget unchanged";
   }
 }
-function minutesWayForward(scope, needs, adminsHint) {
-  switch (scope) {
-    case "directive":
-      return `send the message again with \`budget:${needs}\` or more`;
-    case "user":
-      return `raise your own boundary with \`config set me --boundary.maxMinutes ${needs}\`, or drop your overrides with \`config clear me\``;
-    case "channel":
-      return `run it in a channel whose boundary allows ${needs} minutes, or ask ${adminsHint} to raise this channel's boundary`;
-    case "defaults":
-      return `ask ${adminsHint} to raise \`defaults.boundary\` in the configuration`;
-    case "parent":
-      return `spawn it from a run with at least ${needs} minutes left`;
-  }
-}
-function profileRefusalReply(agentName, refusal, adminsHint) {
-  const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+function profileRefusalReply(agentName, refusal, _adminsHint) {
   if (refusal.axis === "identity") {
-    const how2 = wayForward(refusal.scope, "maxIdentity", refusal.needs, adminsHint);
-    return `\u{1F6AB} \`${agentName}\` needs a \`${refusal.needs}\` credential; ${boundaryOf(refusal.scope)} caps runs at \`${refusal.cap}\`. ${capitalize(how2)}.`;
+    const outcome = boundaryOutcome(refusal.scope);
+    return `\u{1F6AB} \`${agentName}\` needs a \`${refusal.needs}\` credential; ${boundaryOf(refusal.scope)} caps runs at \`${refusal.cap}\`. ${outcome} and did not start the run.`;
   }
   if (refusal.axis === "minutes") {
-    const how2 = minutesWayForward(refusal.scope, refusal.needs, adminsHint);
-    return `\u{1F6AB} \`${agentName}\` needs at least ${refusal.needs} minutes \u2014 a turn, then its write-up and post-step \u2014 and ${boundaryOf(refusal.scope)} gives it ${refusal.have}. ${capitalize(how2)}.`;
+    const outcome = boundaryOutcome(refusal.scope);
+    return `\u{1F6AB} \`${agentName}\` needs at least ${refusal.needs} minutes \u2014 a turn, then its write-up and post-step \u2014 and ${boundaryOf(refusal.scope)} gives it ${refusal.have}. ${outcome} and did not start the run.`;
   }
   const scopes = refusal.scopes.map(boundaryOf);
   const who2 = scopes.length > 1 ? `${scopes.join(" and ")} allow` : `${scopes[0] ?? "the boundary"} allows`;
   const allowed2 = refusal.allowed.map((m) => `\`${m}\``).join(", ");
-  const how = refusal.scopes.map(
-    (scope) => wayForward(
-      scope,
-      "machines",
-      scope === "user" ? `<classes including ${refusal.needs}>` : refusal.needs,
-      adminsHint
-    )
-  ).join("; ");
-  return `\u{1F6AB} \`${agentName}\` runs on a \`${refusal.needs}\` machine; ${who2} only ${allowed2}. ${capitalize(how)}.`;
+  const outcomes = refusal.scopes.map(boundaryOutcome).join("; ");
+  return `\u{1F6AB} \`${agentName}\` runs on a \`${refusal.needs}\` machine; ${who2} only ${allowed2}. ${outcomes}; it did not start the run.`;
 }
 function escapeRegExp2(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -36958,7 +36934,7 @@ function steerAck(live, now) {
 }
 function refusalReply(live, decision, now) {
   return `\u23F3 A *${live.agent}* run is already in flight in this thread (${elapsed(live, now)} in).${linkSuffix(live)}
-An \`agent:${decision.requestedAgent}\` request cannot start beside it \u2014 one run per thread. Wait for it to finish and re-send, or start a new thread.`;
+An \`agent:${decision.requestedAgent}\` request cannot start beside it \u2014 one run per thread \u2014 so this request was not started.`;
 }
 function followUpPrompt(inputs, opts = {}) {
   const body = inputs.map((i) => attributedText(attributed(i))).map((line4) => inputs.length > 1 ? `- ${line4}` : line4).join("\n");
@@ -37398,13 +37374,13 @@ async function steerRun2(deps, sender, target, text) {
   if (live && live.runId === target.runId) {
     live.inbox.push(followUpOf(msg, text, at, { ledgerSeq, ...sender.from ? { from: sender.from } : {} }));
     console.log(
-      `[steer] ${sender.from ? `run ${sender.from.runId}` : sender.userId} \u2192 ${target.agent} run ${target.runId} in ${target.threadKey} (${live.inbox.size} pending${ledgerSeq !== void 0 ? `, durable seq ${ledgerSeq}` : ""})`
+      `[steer] ${sender.from ? `the run ${sender.from.runId}` : sender.userId} \u2192 the ${target.agent} run ${target.runId} in ${target.threadKey} (${live.inbox.size} pending${ledgerSeq !== void 0 ? `, durable seq ${ledgerSeq}` : ""})`
     );
     return { kind: "steered", where: "here", at, ...ledgerSeq !== void 0 ? { ledgerSeq } : {} };
   }
   if (ledgerSeq !== void 0) {
     console.log(
-      `[steer] ${sender.from ? `run ${sender.from.runId}` : sender.userId} \u2192 ${target.agent} run ${target.runId} live on another generation (durable seq ${ledgerSeq})`
+      `[steer] ${sender.from ? `the run ${sender.from.runId}` : sender.userId} \u2192 the ${target.agent} run ${target.runId} live on another generation (durable seq ${ledgerSeq})`
     );
     return { kind: "steered", where: "elsewhere", at, ledgerSeq };
   }
@@ -37420,7 +37396,7 @@ function createSteerSender(deps) {
   return {
     async send(runId3, words, caller) {
       const run2 = deps.runs.getById(runId3);
-      if (!run2) throw new CommandError("not_found", `run ${runId3} is not known here.`);
+      if (!run2) throw new CommandError("not_found", `the run ${runId3} is not known here.`);
       const owner = authorizeSteerOwner({
         caller: { ids: caller.actor.self ?? [caller.actor.id], grants: effectiveGrants(caller.actor) },
         target: {
@@ -37435,7 +37411,7 @@ function createSteerSender(deps) {
       const ended = run2.finished || run2.threadKey === void 0 || run2.agent === void 0;
       if (ended) {
         const when = run2.finishedAt !== void 0 ? `at ${new Date(run2.finishedAt).toISOString()}` : "before this steer arrived";
-        throw new CommandError("conflict", `run ${runId3} ended ${when}; nothing to steer.`);
+        throw new CommandError("conflict", `the run ${runId3} ended ${when}; nothing to steer.`);
       }
       const out = await steerRun2(
         deps,
@@ -37466,7 +37442,7 @@ function createSteerSender(deps) {
         case "not_live":
           throw new CommandError(
             "conflict",
-            `run ${runId3} ended while the steer was being delivered; nothing to steer.`
+            `the run ${runId3} ended while the steer was being delivered; nothing to steer.`
           );
       }
     }
@@ -39038,11 +39014,11 @@ var init_confirm = __esm({
     init_runOwner();
     init_commandRun();
     init_route();
-    OFFER_EXPIRED_LINE = "this offer expired; its ten minutes passed \u2014 type the line to run it";
-    QUESTION_EXPIRED_LINE = "this question expired; its day passed \u2014 type the line to run it";
+    OFFER_EXPIRED_LINE = "this offer expired after ten minutes; nothing ran, and a later request may receive a fresh confirmation";
+    QUESTION_EXPIRED_LINE = "this question expired after one day; nothing ran, and a later request may receive a fresh question";
     OFFER_FOREIGN_LINE = "only the requester can confirm this";
     OFFER_USED_LINE = "this offer was already used";
-    OFFER_UNREADABLE_LINE = "the confirmation could not be read; type the line to run it";
+    OFFER_UNREADABLE_LINE = "this is a bug: the confirmation could not be read, so nothing ran and no replacement offer was minted";
     OFFER_CANCELLED_LINE = "Cancelled; nothing ran";
     CONFIRMED_REASON = "confirmed after offer";
     REFUSED_REASON = "refused after offer";
@@ -39449,7 +39425,7 @@ function resolveTarget2(deps, ctx) {
     throw new RefusalError(
       refusalOf(
         "model_card_refused",
-        `Model "${resolved.modelRef}" speaks the openai-responses wire, which the "opencode" harness cannot speak yet: run it on pi, or use an openai-chat block.`
+        `Model "${resolved.modelRef}" speaks the openai-responses wire, which the "opencode" harness cannot speak yet; this request needs the pi harness or an openai-chat block.`
       )
     );
   }
@@ -43132,7 +43108,7 @@ async function spawnChild(deps, parent, request2) {
   if (AGENTS[request2.preset]?.identity === "write") {
     return refused7(
       "spawn_identity",
-      `\`${request2.preset}\` runs as a \`write\` identity \u2014 it pushes branches and opens pull requests \u2014 and a spawned child never writes: it reads this conversation and reports; the person who asked starts that work by hand with \`agent:${request2.preset}\``
+      `\`${request2.preset}\` runs as a \`write\` identity \u2014 it pushes branches and opens pull requests \u2014 so this run was not started: spawned children read this conversation and report, but never write`
     );
   }
   const childPreset = LOOP_PRESETS.includes(request2.preset) ? request2.preset : "general";
@@ -46348,28 +46324,32 @@ function windDownAnswer(ending, maxMinutes, facts2) {
       return unlabelledAnswer(ending.text, ending.writeUpFailed, ending.ended, facts2);
   }
 }
-function established(facts2, advice) {
-  const then = advice ? ` \u2014 ${advice}` : "";
+function established(facts2) {
   const w = facts2?.workspace;
   let tree = "";
-  if (w?.kind === "unmeasured") tree = `The workspace could not be measured, so work may sit unpushed there${then}.`;
+  if (w?.kind === "unmeasured") tree = "The workspace could not be measured, so work may sit unpushed there.";
   else if (w?.kind === "clean")
     tree = `The tree was clean${w.branch ? ` and \`${w.branch}\` held no unpushed commits` : " with no unpushed commits"}${w.head ? ` \u2014 its head \`${shortSha2(w.head)}\` is on the remote` : ""}.`;
   else if (w?.kind === "salvaged")
     tree = `What the tree held was pushed to \`${w.branch}\`${w.head ? ` at \`${shortSha2(w.head)}\`` : ""} by the budget salvage, unreviewed \u2014 a follow-up starts from it.`;
   else if (w?.kind === "left")
-    tree = w.fate === "kept" ? `${counted(w)} sit in the workspace, kept for this thread until it idles out \u2014 a follow-up here reuses them.` : w.fate === "discarded" ? `${counted(w)} were left in the tree and discarded at the run's end${then}.` : `${counted(w)} were left in the tree, which is torn down since a command may still be running in it${then}.`;
+    tree = w.fate === "kept" ? `${counted(w)} sit in the workspace, kept for this thread until it idles out \u2014 a follow-up here reuses them.` : w.fate === "discarded" ? `${counted(w)} were left in the tree and discarded at the run's end.` : `${counted(w)} were left in the tree, which is torn down since a command may still be running in it.`;
   const description = facts2?.description === "submitted" ? "The PR description was submitted." : facts2?.description === "not_submitted" ? "No PR description was submitted." : "";
   return [tree, description].filter((s) => s !== "").join(" ");
 }
-function nothingWritten(facts2, advice) {
-  const known = established(facts2, advice);
-  if (known) return ` ${known}`;
-  if (facts2?.workspace?.kind === "none") return advice ? ` ${advice.charAt(0).toUpperCase()}${advice.slice(1)}.` : "";
-  return ` Partial work may exist in the workspace${advice ? ` \u2014 ${advice}` : ""}.`;
+function gapApplies(facts2) {
+  const w = facts2?.workspace;
+  return w === void 0 || w.kind === "unread" || w.kind === "unmeasured" || w.kind === "none" || w.kind === "left" && w.fate !== "kept";
+}
+function nothingWritten(facts2, gap) {
+  const gapSentence = gap && gapApplies(facts2) ? `${gap.charAt(0).toUpperCase()}${gap.slice(1)}.` : "";
+  const known = established(facts2);
+  if (known) return ` ${[gapSentence, known].filter((s) => s !== "").join(" ")}`;
+  if (facts2?.workspace?.kind === "none") return gapSentence ? ` ${gapSentence}` : "";
+  return ` Partial work may exist in the workspace${gap ? ` \u2014 ${gap}` : ""}.`;
 }
 function beforeFindings(facts2) {
-  const known = established(facts2, void 0);
+  const known = established(facts2);
   return known ? `. ${known} Findings so far:` : " \u2014 findings so far:";
 }
 function elapsedMinutes(ms) {
@@ -46393,10 +46373,10 @@ var init_windDown = __esm({
     MODEL_CALL_IN_FLIGHT = "a model call was in flight";
     timeBudgetNote = (doing) => doing ? `the loop's time is up while ${doing} \u2014 writing up findings so far inside the lease` : "the loop's time is up \u2014 writing up findings so far inside the lease";
     toolCutNote = (doing) => `the loop's end cut the command in flight (${doing}) so the write-up keeps its allowance`;
-    commandPastLoopEndRefusal = (askedSecs, leftSecs) => `budget \u2014 this command asked for a ${askedSecs} s timeout and the loop ends in ${leftSecs} s, so it could never finish: re-issue it with a timeout inside the ${leftSecs} s left if it finishes sooner, or push what you have and write up \u2014 the full verification is CI's.`;
+    commandPastLoopEndRefusal = (askedSecs, leftSecs) => `budget \u2014 this command asked for a ${askedSecs} s timeout and the loop ends in ${leftSecs} s, so it could never finish. A timeout inside the ${leftSecs} s left can still finish; otherwise the current work and write-up stand, and CI owns full verification.`;
     turnGuardNote = (pace) => `turn guard fired: ${pace}, a pace that looks like a loop \u2014 writing up findings so far`;
     softStopNote = () => "soft stop \u2014 no further steps, writing up findings so far";
-    hardStopNote = () => "hard stop \u2014 run aborted, no summary written";
+    hardStopNote = () => "hard stop \u2014 the run was aborted, no summary written";
     windDownFailureNote = (error, closes = "run") => `the model call failed during the wind-down (${error}); the ${closes} closes with its findings so far`;
     finaleWaitNote = (reason2, doing, interruptUnanswered, closes = "run") => `the finale bound ended the wait${doing ? ` while ${doing}` : ""}${interruptUnanswered ? ", the loop-end interrupt unanswered" : ""} (${reason2}); the ${closes} closes with its findings so far`;
     finaleTimedOutNote = (closes = "run") => `finale timed out \u2014 closing the ${closes} without a write-up`;
@@ -46420,14 +46400,14 @@ var init_windDown = __esm({
     wrapUpName = (kind) => kind === "time" ? "time-budget" : kind === "turns" ? "turn-guard" : "soft-stop";
     finaleAbortReason = (boundMs) => `aborted at the finale bound (${elapsedMinutes(boundMs)})`;
     noWriteUp = (failed, onTool) => failed ? onTool ? `; the finale bound ended the wait on a tool call (${failed}), so no write-up came` : `; the model call failed during the wind-down (${failed}), so no write-up came` : "";
-    TIME_ADVICE = "narrow the task and try again";
-    TURN_ADVICE = "look for a retry loop in the run's events before trying again";
+    TIME_ADVICE = "this is a bug: the task outlived its run budget and no automatic continuation was scheduled";
+    TURN_ADVICE = "this is a bug: a retry loop spent the turn guard and no automatic recovery was scheduled";
     shortSha2 = (sha) => sha.slice(0, 7);
     counted = (w) => `${w.uncommitted} uncommitted change(s) and ${w.unpushed} unpushed commit(s)`;
     timeBudgetAnswer = (text, maxMinutes, writeUpFailed, facts2, writeUpFailedOnTool) => text ? `\u26A0\uFE0F _Hit the ${maxMinutes}-minute budget before finishing${beforeFindings(facts2)}_
 
 ${text}` : `Stopped at the ${maxMinutes}-minute budget without finishing${noWriteUp(writeUpFailed, writeUpFailedOnTool)}.${nothingWritten(facts2, TIME_ADVICE)}`;
-    turnGuardAnswer = (text, pace, writeUpFailed, facts2, writeUpFailedOnTool) => text ? `\u26A0\uFE0F _Stopped after ${pace} \u2014 that pace looks like a loop${established(facts2, void 0) ? beforeFindings(facts2) : "; findings so far:"}_
+    turnGuardAnswer = (text, pace, writeUpFailed, facts2, writeUpFailedOnTool) => text ? `\u26A0\uFE0F _Stopped after ${pace} \u2014 that pace looks like a loop${established(facts2) ? beforeFindings(facts2) : "; findings so far:"}_
 
 ${text}` : `Stopped after ${pace} \u2014 that pace looks like a loop \u2014 without finishing${noWriteUp(writeUpFailed, writeUpFailedOnTool)}.${nothingWritten(facts2, TURN_ADVICE)}`;
     unlabelledAnswer = (text, writeUpFailed, ended = "failed", facts2) => {
@@ -52908,12 +52888,12 @@ async function handOffToCoordinator(deps, input) {
   if (status3.kind === "unanswered")
     return refused5(
       "plan_runner_state_unknown",
-      `\u26A0\uFE0F The plan runner could not tell whether \`${latest.id}\` still runs: ${status3.reason}. Nothing ran; re-issue the request to try again.`
+      `\u26A0\uFE0F This is a bug: the plan runner could not tell whether \`${latest.id}\` still runs (${status3.reason}), so nothing ran and no automatic state retry was scheduled.`
     );
   if (status3.kind === "status" && RUNNING.has(status3.status))
     return refused5(
       "plan_runner_live",
-      `\u{1F6AB} A runner for ${where} is still running (\`${latest.id}\`, status: ${status3.status}): wait for it to end \u2014 or terminate it in the Workflows dashboard \u2014 before re-issuing.`
+      `\u{1F6AB} A runner for ${where} is still running (\`${latest.id}\`, status: ${status3.status}), so this request started no second runner.`
     );
   if (status3.kind === "status" && !ENDED.has(status3.status))
     return refused5(
@@ -52977,7 +52957,7 @@ async function start(deps, input, instance, units, where, write) {
       );
     return refused5(
       "plan_runner_conflict",
-      `\u{1F6AB} A runner for \`${instance.id}\` was just recorded by another request \u2014 re-issue in a minute if it did not start.`
+      `\u{1F6AB} A runner for \`${instance.id}\` was just recorded by another request, so this request started nothing; the recorded runner owns the pipeline.`
     );
   }
   const rows = await deps.instances.putUnits(units);
@@ -53035,7 +53015,7 @@ async function start(deps, input, instance, units, where, write) {
       log(`[ship] ${input.msg.threadKey}: the plan runner ${instance.id} could not be started \u2014 ${answer.reason}`);
       return refused5(
         "plan_start_failed",
-        `\u26A0\uFE0F The plan runner could not be started: ${answer.reason}. Nothing ran; re-issue the request to try again.`
+        `\u26A0\uFE0F This is a bug: the plan runner could not be started (${answer.reason}), nothing ran, and no automatic start retry was scheduled.`
       );
   }
 }
@@ -53618,7 +53598,7 @@ function settleThread(deps, ctx) {
     console.log(`[dispatch] ${msg.threadKey} ${fromRuns} steer(s) from a parent run never read \u2014 not run fresh`);
   const stopMode = stopCounts ? control?.requested : void 0;
   if (pending2.length > 0 && stopMode) {
-    console.log(`[dispatch] ${msg.threadKey} ${pending2.length} follow-up(s) dropped: run stopped (${stopMode})`);
+    console.log(`[dispatch] ${msg.threadKey} ${pending2.length} follow-up(s) dropped: the run stopped (${stopMode})`);
     return { kind: "dropped", stopMode, pending: pending2 };
   }
   if (pending2.length > 0 && admitted) {
@@ -53669,7 +53649,7 @@ var init_settle = __esm({
     init_requestTrace();
     init_threadAdmission();
     init_admission();
-    FOLLOW_UP_DROPPED_BY_STOP = "\u26D4 The run this was folded into was stopped before it read this follow-up, so it was not run. Re-send it to run it fresh.";
+    FOLLOW_UP_DROPPED_BY_STOP = "\u26D4 This is a bug: the run was stopped before it read this folded follow-up, and the follow-up was not replayed as a fresh request.";
     fromPerson = (p) => p.from === void 0 && p.io !== void 0;
   }
 });
@@ -53692,7 +53672,7 @@ function carriedCoordinatorTag(row2, events) {
 }
 function lostWorkspaceNote(why, restarts) {
   const lost = `resumed after a restart: the run's workspace could not be re-attached (${why})`;
-  return restarts ? `${lost}; the run restarts from its request under the same run id` : `${lost}, and the row's request cannot be read, so the run ends here; re-send it to run it again`;
+  return restarts ? `${lost}; the run restarts from its request under the same run id` : `${lost}; this is a bug: the row's request cannot be read, so the run ends here and no replacement run starts`;
 }
 function carriedRunIdentity(registry, runId3, note) {
   const snap = registry.snapshotById(runId3);
@@ -53737,7 +53717,7 @@ async function abandonLostWorkspace(ctx) {
       shell.close({
         kind: "not_started",
         icon: "\u{1F501}",
-        reason: restored ? "workspace lost across the restart; restarting from the request" : "workspace lost across the restart; re-send to run again",
+        reason: restored ? "workspace lost across the restart; restarting from the request" : "this is a bug: the workspace was lost across the restart, the request could not be read, and no replacement run starts",
         ...closeLines(clock4(), false)
       })
     );
@@ -54415,7 +54395,7 @@ async function dispatch(deps, msg, io, opts = {}) {
         const original = await shipRequestOf(runsService, owner.run.id);
         if (original === void 0) {
           await io.reply(
-            "This ship pipeline ended, but its original task could not be read; what task should this thread re-issue?"
+            "This ship pipeline ended, but its original task could not be read. What was the pipeline's original task?"
           );
           await recordPendingOperator();
           return ended;
@@ -62704,7 +62684,7 @@ function findOrphanedCards(input) {
 }
 function interruptedCardFrame(cardText) {
   const label = cardText.replace(LIVE_GLYPH_PREFIX, "").replace(SHUTDOWN_NOTICE_SUFFIX, "").replace(ACTIVITY_SUFFIX, "").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&").trim();
-  const detail = "The bot restarted (a deploy) while this run was in flight, so the run was lost and this card stopped updating. Re-send your request to run it again.";
+  const detail = "This is a bug: the bot restarted while this run was in flight, but the run could not be resumed from the ledger. The card stopped updating and no replacement run was started.";
   return { title: `\u274C interrupted \xB7 ${label}`, detail };
 }
 async function catchUpMissedMentions(opts) {
@@ -63861,7 +63841,7 @@ var init_slack = __esm({
     PLATFORM3 = "slack";
     SLACK_MSG_LIMIT = 3500;
     SLACK_SECTION_LIMIT = 3e3;
-    CLICK_FAILED_LINE = "this click could not be handled; type the line to run it";
+    CLICK_FAILED_LINE = "this click could not be handled; nothing ran, and the command line remains visible in the offer";
     LOADING_PHRASES = [
       "is patching you through\u2026",
       "is untangling the cords\u2026",
@@ -65440,7 +65420,7 @@ function serveEvents(subscribe, sink, onLive) {
   );
   if (!subscribed) {
     sink.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
-    sink.write("run not found");
+    sink.write("no run found");
     sink.end();
     return;
   }
@@ -65731,7 +65711,7 @@ function createLiveViewHandler(deps) {
   };
   const liveTokens = () => new Map(index.listActive().map((s) => [s.id, s.token]));
   const notFoundPage = (req, res, viewer) => {
-    deps.page(req, res, 404, viewer, "Run not found", {
+    deps.page(req, res, 404, viewer, "No run found", {
       page: "runNotFound",
       retentionDays: deps.retention ? deps.retention.retentionDays : null
     });
@@ -65929,7 +65909,7 @@ function createLiveViewHandler(deps) {
         }
         const result = access.requestStop(mode);
         if (!result.ok) {
-          if (result.reason === "finished") text(res, 409, "run already finished");
+          if (result.reason === "finished") text(res, 409, "the run already finished");
           else if (result.reason === "hosted") text(res, 409, HOSTED_STOP);
           else text(res, 404, NOT_FOUND2);
           return true;
@@ -65963,13 +65943,13 @@ function createLiveViewHandler(deps) {
           return;
         }
         if (found.value.finished) {
-          text(res, 409, "run already finished");
+          text(res, 409, "the run already finished");
           return;
         }
         const stopped = await service.stopRun(route2.id, mode, { kind: "access", id: actor.id });
         if (!stopped.ok) {
           if (stopped.error === "hosted") text(res, 409, HOSTED_STOP);
-          else if (stopped.error === "conflict") text(res, 409, "run already finished");
+          else if (stopped.error === "conflict") text(res, 409, "the run already finished");
           else text(res, 404, NOT_FOUND2);
           return;
         }
@@ -66104,7 +66084,7 @@ var init_liveView = __esm({
     INDEX_PAGE_SIZE = 25;
     RUNS_GET = { type: "command", id: "runs.get" };
     RUNS_STOP = { type: "command", id: "runs.stop" };
-    NOT_FOUND2 = "run not found";
+    NOT_FOUND2 = "no run found";
     HOSTED_STOP = "this run is a pipeline; its units run in their own threads, so a stop here ends nothing; an operator's hard stop seals it failed and releases the thread";
     TEXT = { "content-type": "text/plain; charset=utf-8" };
     JSON_NO_STORE2 = { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" };
@@ -67022,7 +67002,7 @@ function createWebChatHandler(deps) {
     const threadKey = threadKeyFor(sub, route2.id);
     readTurns(threadKey, ctx.actor).then(async (open2) => {
       if (open2.runs.length === 0 && !ownLane(sub, threadKey)) {
-        deps.page(req, res, 404, ctx.actor, "Run not found", { page: "runNotFound", retentionDays });
+        deps.page(req, res, 404, ctx.actor, "No run found", { page: "runNotFound", retentionDays });
         return;
       }
       const seed = await seedFor(ctx, route2.id, threadKey, open2);
@@ -67304,14 +67284,14 @@ function createMetricsViewHandler(service, page2) {
         json2(res, report2);
         return;
       }
-      page2(req, res, 200, ctx.actor, "Run metrics", { page: "metrics", report: report2 });
+      page2(req, res, 200, ctx.actor, "Metrics by run", { page: "metrics", report: report2 });
     }).catch((err2) => {
       const message4 = err2 instanceof Error ? err2.message : String(err2);
       if (message4 === METRICS_OFF_MESSAGE) {
         plain3(res, 503, METRICS_OFF_MESSAGE);
         return;
       }
-      plain3(res, 503, `run metrics unavailable: ${err2 instanceof Error ? err2.name : "Error"}`);
+      plain3(res, 503, `metrics by run unavailable: ${err2 instanceof Error ? err2.name : "Error"}`);
     });
     return true;
   };
@@ -68121,7 +68101,7 @@ async function complete(svc, nonce, identity2, token2, res) {
       res,
       400,
       "Token rejected by the server",
-      `<p class="err">${esc(warning ?? "the server rejected the token")}</p><p>Nothing was stored. Check the token and try again.</p>${server ? entryForm(server, nonce) : ""}`
+      `<p class="err">${esc(warning ?? "the server rejected the token")}</p><p>Nothing was stored. This is a bug: the token was refused and no fresh sign-in was opened automatically.</p>${server ? entryForm(server, nonce) : ""}`
     );
   }
   return connected(res, server, toolCount, warning);
@@ -68269,7 +68249,12 @@ function page(res, status3, title, body, head = "") {
 }
 function failure(res, err2) {
   console.error(`[mcp-connect] ${err2 instanceof Error ? err2.message : String(err2)}`);
-  page(res, 503, "Registry unavailable", "<p>The MCP registry could not be reached. Try again in a moment.</p>");
+  page(
+    res,
+    503,
+    "Registry unavailable",
+    "<p>This is a bug: the MCP registry could not be reached and no automatic retry was scheduled.</p>"
+  );
 }
 function esc(s) {
   return s.replace(
@@ -68398,8 +68383,8 @@ function closureNote(agent, prUrl3, cause) {
   if (agent === "ship")
     return shipInterruptedNote(prUrl3, cause === "resident_replaced" ? "container_replaced" : "bot_restart");
   if (cause !== void 0)
-    return `This run ended \u2014 ${endingCauseWords(cause)} \u2014 and it could not be resumed, so this card stopped updating. Re-send your request to run it again.`;
-  return "The bot restarted while this run was in flight and it could not be resumed, so this card stopped updating. Re-send your request to run it again.";
+    return `This is a bug: this run ended \u2014 ${endingCauseWords(cause)} \u2014 but it could not be resumed from the ledger. This card stopped updating and no replacement run was started.`;
+  return "This is a bug: the bot restarted while this run was in flight, but the run could not be resumed from the ledger. This card stopped updating and no replacement run was started.";
 }
 function prUrlOf(events) {
   let url;
@@ -69544,7 +69529,7 @@ ${turn}`, contract };
       return {
         preset: "coding",
         ref: unit.branch,
-        prompt: `The approved pull request ${prUrl(instance.repo, brief.pr)} conflicts with \`${brief.base}\` at reviewed head \`${brief.headSha}\`. Rebase \`${unit.branch}\` onto the latest \`${brief.base}\`, resolve only the conflicts git left using the thread and repository rules, run the changed-set fast gates, and push with lease. Resubmit the pull request description at the pushed head. Never merge and never approve; the pipeline re-reviews the changed patch.`
+        prompt: `The approved pull request ${prUrl(instance.repo, brief.pr)} conflicts with \`${brief.base}\` at reviewed head \`${brief.headSha}\`. Rebase \`${unit.branch}\` onto the latest \`${brief.base}\`, resolve only the conflicts git left using the thread and repository rules, and make the lease-protected push only after the changed-set fast gates pass. Resubmit the pull request description at the pushed head. Never merge and never approve; the pipeline re-reviews the changed patch.`
       };
     default: {
       const unknown = brief;
@@ -69554,7 +69539,7 @@ ${turn}`, contract };
 }
 async function facts(readers, runId3) {
   const read = await readers.readRunFacts(runId3);
-  if (!read) throw new Error(`run ${runId3} is not in the run history`);
+  if (!read) throw new Error(`the run ${runId3} is not in history`);
   return read;
 }
 var SPECS_DIR2, RULES_FILES2, isGenerated, prUrl;
@@ -70840,7 +70825,7 @@ async function unitWake(body, deps) {
       } else {
         answer = {
           kind: "answered",
-          reply: `${renderRenewal(decision, grantFact.grant, { idle: true })} (grant from ${grantFact.source}); run \`runs stop ${instance.id}:${row2.unit}\` to end this idle unit.`
+          reply: `${renderRenewal(decision, grantFact.grant, { idle: true })} (grant from ${grantFact.source}); the idle unit remains open, and \`runs stop ${instance.id}:${row2.unit}\` is its stop command.`
         };
       }
     }
@@ -71230,7 +71215,7 @@ async function merge(body, deps, subject2) {
   const enqueue = async () => {
     if (deps.enqueuePullRequest === void 0)
       return refused7(
-        `\`${facts2.baseRef ?? "the base"}\` takes changes only through a merge queue and the door cannot enqueue \u2014 enqueue ${where} by hand (\`gh pr merge --auto\`); the approved work stands`
+        `\`${facts2.baseRef ?? "the base"}\` takes changes only through a merge queue and the door cannot enqueue \u2014 this is a bug: automatic merge-queue enqueue is unavailable; the approved work stands`
       );
     let queued;
     try {
@@ -71329,7 +71314,7 @@ async function checksStep(body, deps) {
 function planSummary(units, generated = false) {
   const lines = units.map((u) => {
     const kind = u.ending ? u.ending.kind : u.threadKey ? "unfinished" : "not started";
-    const how = u.ending ? endingWordOf(u.ending.kind) : u.threadKey ? "no ending was recorded \u2014 re-issue `agent:ship` in its thread to continue" : kind;
+    const how = u.ending ? endingWordOf(u.ending.kind) : u.threadKey ? "no ending was recorded \u2014 the next reply in its thread continues the unit" : kind;
     const pr = u.pr ? ` \u2014 ${u.pr.url}` : "";
     return generated ? `${ENDING_ICON[kind] ?? "\u2022"} ${how}${pr}` : `${ENDING_ICON[kind] ?? "\u2022"} ${u.unit} \u2014 ${how}${pr}`;
   });
@@ -72040,14 +72025,17 @@ async function sweepOne(pr, deps, owner) {
     return at("skipped", "deferred \u2014 its pipeline runner owns the rebase");
   const dirty = pr.mergeableState === "dirty";
   if (!dirty && (pr.mergeableState === "unknown" || pr.mergeableState === ""))
-    return at("skipped", "mergeability still computing \u2014 run the sweep again in a minute");
+    return at("skipped", "mergeability still computing \u2014 no rebase was attempted");
   if (!dirty) return at("skipped", "skipped, already current");
   try {
     const rebased = await deps.git.rebase(pr);
     const decision = rebased.kind === "conflict" ? owner === "runner" ? { action: "model-round", file: rebased.file } : decideSweep({ dirty, rebase: rebased, modelRoundSpent: await deps.effects.modelRoundSpent(pr) }) : decideSweep({ dirty, rebase: rebased, patchUnchanged: await deps.git.patchUnchanged(pr, rebased.newHead) });
     switch (decision.action) {
       case "end":
-        return at("conflict", `conflict in ${decision.file}, its fix round is spent \u2014 rebase it by hand`);
+        return at(
+          "conflict",
+          `this is a bug: the conflict in ${decision.file} remained after the sweep's fix round, and no automatic recovery remains`
+        );
       case "model-round": {
         if (owner === "runner")
           return at("conflict", `conflict in ${decision.file}, the pipeline runner's fix round will resolve it`);
@@ -73845,7 +73833,7 @@ function askExitCode(finished) {
 function missingBotConfig(configPath) {
   return new CommandError(
     "unavailable",
-    `bot config not found at ${configPath} \u2014 set SWITCHBOARD_CONFIG to a config file or run from a checkout with config/config.yaml (deploy, env, friction analyze need none)`
+    `bot config not found at ${configPath} \u2014 the command stopped before work began; the config path comes from SWITCHBOARD_CONFIG or defaults to config/config.yaml (deploy, env, friction analyze need no bot config)`
   );
 }
 async function loadBotConfig(configPath, overridesPath, opts = {}) {