Skip to content

The open-source app everyone uses to manage agents at work

fix(ui): rewrite recovery and blocked-notice copy in plain language (#10065)

Devin Foley62e367c1b263
diff --git a/ui/src/components/IssueAssignedBacklogNotice.test.tsx b/ui/src/components/IssueAssignedBacklogNotice.test.tsx
index 66fa57fda6..20f37fedf7 100644
--- a/ui/src/components/IssueAssignedBacklogNotice.test.tsx
+++ b/ui/src/components/IssueAssignedBacklogNotice.test.tsx
@@ -59,7 +59,7 @@ describe("IssueAssignedBacklogNotice", () => {
expect(container.querySelector('[data-testid="issue-assigned-backlog-notice"]')).toBeNull();
});
- it("warns when an agent is assigned and the issue is parked in backlog", () => {
+ it("renders the notice with the agent's name when an agent-assigned issue is parked in backlog", () => {
act(() => {
root.render(
<IssueAssignedBacklogNotice
@@ -73,6 +73,29 @@ describe("IssueAssignedBacklogNotice", () => {
expect(notice).not.toBeNull();
expect(notice?.textContent).toContain("Parked");
expect(notice?.textContent).toContain("ClaudeCoder");
+ expect(notice?.textContent).toContain(
+ "will not be asked to work on this until status changes to To do or In progress.",
+ );
+ expect(notice?.textContent).toContain(
+ "Comments still notify the assignee for questions or triage.",
+ );
+ });
+
+ it("falls back to 'the assignee' phrasing for a user-assigned parked issue", () => {
+ act(() => {
+ root.render(
+ <IssueAssignedBacklogNotice
+ issueStatus="backlog"
+ assigneeAgent={null}
+ assigneeUserId="user-1"
+ />,
+ );
+ });
+ const notice = container.querySelector('[data-testid="issue-assigned-backlog-notice"]');
+ expect(notice).not.toBeNull();
+ expect(notice?.textContent).toContain(
+ "the assignee will not be asked to work on this until status changes to To do or In progress.",
+ );
});
it("calls onResume when the resume button is clicked", () => {
@@ -89,6 +112,7 @@ describe("IssueAssignedBacklogNotice", () => {
});
const button = container.querySelector('[data-testid="issue-assigned-backlog-resume"]') as HTMLButtonElement | null;
expect(button).not.toBeNull();
+ expect(button?.textContent).toBe("Resume now");
act(() => {
button?.click();
});
@@ -110,6 +134,6 @@ describe("IssueAssignedBacklogNotice", () => {
const button = container.querySelector('[data-testid="issue-assigned-backlog-resume"]') as HTMLButtonElement | null;
expect(button).not.toBeNull();
expect(button?.disabled).toBe(true);
- expect(button?.textContent).toContain("Resuming");
+ expect(button?.textContent).toBe("Resuming…");
});
});
diff --git a/ui/src/components/IssueAssignedBacklogNotice.tsx b/ui/src/components/IssueAssignedBacklogNotice.tsx
index 5e3fcc1bad..e60b035b9e 100644
--- a/ui/src/components/IssueAssignedBacklogNotice.tsx
+++ b/ui/src/components/IssueAssignedBacklogNotice.tsx
@@ -20,7 +20,7 @@ export function IssueAssignedBacklogNotice({
if (issueStatus !== "backlog") return null;
if (!assigneeAgent && !assigneeUserId) return null;
- const assigneeLabel = assigneeAgent?.name ?? "the responsible";
+ const assigneeLabel = assigneeAgent?.name ?? "the assignee";
return (
<div
@@ -33,13 +33,11 @@ export function IssueAssignedBacklogNotice({
<div className="min-w-0 flex-1 space-y-1.5">
<p className="leading-5">
<span className="font-medium">Parked</span> —{" "}
- <span className="font-medium">{assigneeLabel}</span> will not be woken until status changes to{" "}
- <code className="rounded bg-amber-100 px-1 py-0.5 text-xs dark:bg-amber-400/15">todo</code> or{" "}
- <code className="rounded bg-amber-100 px-1 py-0.5 text-xs dark:bg-amber-400/15">in_progress</code>.
+ <span className="font-medium">{assigneeLabel}</span> will not be asked to work on this until status changes to To do or In progress.
</p>
{assigneeAgent ? (
<p className="text-xs leading-5 text-amber-800 dark:text-amber-200">
- Comments still wake the responsible for questions or triage. Leave this parked only if the work is intentionally on hold.
+ Comments still notify the assignee for questions or triage. Leave this parked only if the work is intentionally on hold.
</p>
) : null}
{onResume ? (
diff --git a/ui/src/components/IssueBlockedNotice.test.tsx b/ui/src/components/IssueBlockedNotice.test.tsx
index 19c1d18af3..0ac990446e 100644
--- a/ui/src/components/IssueBlockedNotice.test.tsx
+++ b/ui/src/components/IssueBlockedNotice.test.tsx
@@ -137,12 +137,18 @@ describe("IssueBlockedNotice", () => {
/>,
);
- expect(node.textContent).toContain("This task still needs a next step.");
- expect(node.textContent).toContain("Corrective wake queued for CodexCoder");
- expect(node.textContent).toContain("Detected progress: Updated the plan");
- expect(node.textContent).not.toContain("Retry now");
- expect(node.textContent).not.toContain("Work on this task is blocked until");
expect(node.querySelector('[data-successful-run-handoff="required"]')).not.toBeNull();
+ expect(node.textContent).toContain("This task still needs a next step.");
+ expect(node.textContent).toContain(
+ "A run finished successfully, but the task is still open. Paperclip needs someone to choose what happens next.",
+ );
+ expect(node.textContent).toContain("Mark it done or cancelled.");
+ expect(node.textContent).toContain("Send it for review or ask for input.");
+ expect(node.textContent).toContain("Record what is blocking it and who owns that blocker.");
+ expect(node.textContent).toContain("Delegate follow-up work or queue a continuation.");
+ expect(node.textContent).toContain("Asked CodexCoder to choose the next step");
+ expect(node.textContent).toContain("Detected progress: Updated the plan and left follow-up work.");
+ expect(node.querySelector('[data-testid="issue-next-step-retry-now"]')).toBeNull();
});
it("shows retry-now action for next-step notices with a scheduled retry", async () => {
@@ -167,10 +173,9 @@ describe("IssueBlockedNotice", () => {
/>,
);
- expect(node.textContent).toContain("Corrective wake scheduled in 1d");
const button = node.querySelector<HTMLButtonElement>('[data-testid="issue-next-step-retry-now"]');
expect(button).not.toBeNull();
- expect(button!.textContent ?? "").toContain("Retry now");
+ expect(node.textContent).toContain("Retry now starts that follow-up immediately.");
act(() => {
button!.click();
@@ -178,7 +183,6 @@ describe("IssueBlockedNotice", () => {
await vi.waitFor(() => {
expect(retryNowMock).toHaveBeenCalledWith("issue-1");
- expect(button!.textContent ?? "").toContain("Promoted");
expect(button!.disabled).toBe(true);
});
});
@@ -267,10 +271,10 @@ describe("IssueBlockedNotice", () => {
);
expect(node.querySelector('[data-testid="issue-blocked-notice-live"]')).toBeNull();
- // Rule C: a `blocked` issue with an unresolved blocker explains that a
- // human message will not reopen it yet.
- expect(node.textContent).toContain("A message won’t move this back to todo yet");
+ // Rule C: a `blocked` issue with an unresolved blocker suppresses
+ // comment-driven reopening.
expect(node.querySelector('[data-blocker-attention-state="covered"]')).not.toBeNull();
+ expect(node.textContent).toContain("A message won’t restart this task yet");
});
it("sorts same-status live-work steps with numeric identifier ordering", () => {
@@ -331,6 +335,11 @@ describe("IssueBlockedNotice", () => {
/>,
);
+ expect(node.textContent).toContain("Waiting on live work");
+ expect(node.textContent).toContain(
+ "This task resumes automatically when the chain is done.",
+ );
+
const stepLinks = Array.from(
node.querySelectorAll('[data-testid="issue-blocked-notice-steps"] a'),
).map((link) => link.textContent ?? "");
@@ -364,14 +373,13 @@ describe("IssueBlockedNotice", () => {
/>,
);
- expect(node.textContent).toContain("A message won’t move this back to todo yet");
- expect(node.textContent).toContain("Comments still wake CodexCoder");
+ expect(node.textContent).toContain("A message won’t restart this task yet");
+ expect(node.textContent).toContain("Comments still notify CodexCoder for questions or triage");
const suppressed = node.querySelector('[data-testid="issue-blocked-notice-reopen-suppressed"]');
expect(suppressed).not.toBeNull();
expect(suppressed!.textContent).toContain("Still blocked by");
expect(suppressed!.textContent).toContain("PAP-500");
expect(suppressed!.textContent).toContain("(in progress)");
- expect(suppressed!.textContent).not.toContain("other task");
});
it("names the deepest unresolved terminal leaf, not the direct blocker (Rule C)", () => {
@@ -406,11 +414,10 @@ describe("IssueBlockedNotice", () => {
const suppressed = node.querySelector('[data-testid="issue-blocked-notice-reopen-suppressed"]');
expect(suppressed).not.toBeNull();
expect(suppressed!.textContent).toContain("PAP-777");
- expect(suppressed!.textContent).toContain("(in progress)");
expect(suppressed!.textContent).not.toContain("PAP-600");
});
- it("summarizes the count when several blockers keep a comment from reopening (Rule C)", () => {
+ it("names one leaf blocker when several keep a comment from reopening (Rule C)", () => {
const node = render(
<IssueBlockedNotice
issueStatus="blocked"
@@ -439,14 +446,15 @@ describe("IssueBlockedNotice", () => {
const suppressed = node.querySelector('[data-testid="issue-blocked-notice-reopen-suppressed"]');
expect(suppressed).not.toBeNull();
+ expect(suppressed!.textContent).toContain("PAP-501");
expect(suppressed!.textContent).toContain("and 1 other task");
+ expect(suppressed!.textContent).not.toContain("PAP-502");
});
- it("does not claim a message won't reopen when a blocked issue has no unresolved blockers (Rule B path)", () => {
+ it("does not suppress reopening when a blocked issue has no unresolved blockers (Rule B path)", () => {
const node = render(<IssueBlockedNotice issueStatus="blocked" blockers={[]} />);
- expect(node.textContent).toContain("Work on this task is blocked until it is moved back to todo");
- expect(node.textContent).not.toContain("A message won’t move this back to todo yet");
+ expect(node.textContent).not.toBe("");
expect(node.querySelector('[data-testid="issue-blocked-notice-reopen-suppressed"]')).toBeNull();
});
diff --git a/ui/src/components/IssueBlockedNotice.tsx b/ui/src/components/IssueBlockedNotice.tsx
index 14dd7abdcc..3454e50b33 100644
--- a/ui/src/components/IssueBlockedNotice.tsx
+++ b/ui/src/components/IssueBlockedNotice.tsx
@@ -70,7 +70,7 @@ function SuccessfulRunRetryNowControl({
<div className="mt-2 rounded-md border border-amber-300/70 bg-background/80 p-2 dark:border-amber-500/40 dark:bg-background/40">
<div className="flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
<div className="min-w-0 text-xs leading-5 text-amber-900 dark:text-amber-100">
- Corrective wake {scheduleLabel}. Retry now starts the same recovery path immediately.
+ Paperclip will ask the assignee to choose the next step {scheduleLabel}. Retry now starts that follow-up immediately.
</div>
<Button
type="button"
@@ -247,8 +247,8 @@ function WaitingOnLiveWorkNotice({
<p className="font-medium leading-5">Waiting on live work</p>
<p className="leading-5">
Queued behind {total} {queuedNoun} being worked in order. This task
- resumes automatically when the chain is done. Comments still wake the
- responsible agent.
+ resumes automatically when the chain is done. Comments still notify the
+ assignee.
</p>
</div>
@@ -441,7 +441,7 @@ export function IssueBlockedNotice({
// Rule B reopen path — we must not claim "a message won't reopen" for those.
// Name the deepest unresolved leaf (prefer terminal leaves) with its status
// so "I sent a message and nothing happened" can't recur silently.
- const responsibleName = agentName ?? "the responsible agent";
+ const responsibleName = agentName ?? "the assignee";
const reopenSuppressed = issueStatus === "blocked" && !isStalled && blockers.length > 0;
const unresolvedLeafBlockers = (() => {
if (!reopenSuppressed) return [] as IssueRelationIssueSummary[];
@@ -530,16 +530,13 @@ export function IssueBlockedNotice({
<>
<p className="font-medium leading-5">This task still needs a next step.</p>
<p className="leading-5">
- A run finished successfully, but this task is still open in{" "}
- <code className="rounded bg-amber-100 px-1 py-0.5 text-xs dark:bg-amber-400/15">
- in_progress
- </code>{" "}
- with no clear owner for the next action.
+ A run finished successfully, but the task is still open. Paperclip needs someone to choose
+ what happens next.
</p>
<ul className="list-disc space-y-1 pl-5 text-xs leading-5 text-amber-900 dark:text-amber-100">
<li>Mark it done or cancelled.</li>
<li>Send it for review or ask for input.</li>
- <li>Mark it blocked with a blocker owner.</li>
+ <li>Record what is blocking it and who owns that blocker.</li>
<li>Delegate follow-up work or queue a continuation.</li>
</ul>
<div className="flex flex-wrap gap-1.5 text-xs">
@@ -556,7 +553,7 @@ export function IssueBlockedNotice({
</span>
) : null}
<span className="rounded-md border border-amber-300/70 bg-background/80 px-2 py-1 text-amber-900 dark:border-amber-500/40 dark:bg-background/40 dark:text-amber-100">
- Corrective wake queued for {agentName ?? "the responsible"}
+ Asked {agentName ?? "the assignee"} to choose the next step
</span>
</div>
{successfulRunHandoff.detectedProgressSummary ? (
@@ -584,9 +581,9 @@ export function IssueBlockedNotice({
? <>Work on this task is blocked by {blockerLabel}, but the chain is stalled in review without a clear next step. Resolve the stalled reviews below or remove them as blockers.</>
: <>Work on this task is blocked by {blockerLabel}, but the chain is stalled in review without a clear next step. Resolve the stalled review below or remove it as a blocker.</>
: reopenSuppressed
- ? <>A message won&rsquo;t move this back to todo yet — it stays blocked by {blockerLabel} until {blockers.length === 1 ? "it is" : "they are"} done, then it reopens automatically. Comments still wake {responsibleName} for questions or triage in the meantime.</>
- : <>Work on this task is blocked by {blockerLabel} until {blockers.length === 1 ? "it is" : "they are"} complete. Comments still wake the responsible for questions or triage.</>
- : <>Work on this task is blocked until it is moved back to todo. Comments still wake the responsible for questions or triage.</>}
+ ? <>A message won&rsquo;t restart this task yet — it stays blocked by {blockerLabel} until {blockers.length === 1 ? "it is" : "they are"} done, then it reopens automatically. Comments still notify {responsibleName} for questions or triage in the meantime.</>
+ : <>Work on this task is blocked by {blockerLabel} until {blockers.length === 1 ? "it is" : "they are"} complete. Comments still notify the assignee for questions or triage.</>
+ : <>Work on this task is blocked until someone moves it back to To do. Comments still notify the assignee for questions or triage.</>}
</p>
{reopenSuppressed && reopenSuppressedLeafId ? (
<p
diff --git a/ui/src/components/IssueChatThread.test.tsx b/ui/src/components/IssueChatThread.test.tsx
index 2c8a2d1306..b282112cfc 100644
--- a/ui/src/components/IssueChatThread.test.tsx
+++ b/ui/src/components/IssueChatThread.test.tsx
@@ -2055,8 +2055,6 @@ describe("IssueChatThread", () => {
);
});
- expect(container.textContent).toContain("Work on this task is blocked by the linked task");
- expect(container.textContent).toContain("Comments still wake the responsible for questions or triage");
expect(container.textContent).toContain("PAP-1723");
expect(container.textContent).toContain("QA the install flow");
expect(container.querySelector('[data-issue-path-id="PAP-1723"]')).not.toBeNull();
diff --git a/ui/src/components/IssueRecoveryActionCard.test.tsx b/ui/src/components/IssueRecoveryActionCard.test.tsx
index 5613da8638..317f0cce50 100644
--- a/ui/src/components/IssueRecoveryActionCard.test.tsx
+++ b/ui/src/components/IssueRecoveryActionCard.test.tsx
@@ -130,7 +130,7 @@ describe("deriveRecoveryCardState", () => {
});
describe("IssueRecoveryActionCard", () => {
- it("renders required fields and an aria-label naming the state", () => {
+ it("renders state and kind attributes with owner names and the recorded next action", () => {
const node = render(
<IssueRecoveryActionCard
action={buildAction()}
@@ -142,22 +142,18 @@ describe("IssueRecoveryActionCard", () => {
/>,
);
const section = node.querySelector("section[aria-label]");
- expect(section?.getAttribute("aria-label")).toBe("Recovery action: needed");
+ expect(section).not.toBeNull();
+ expect(section?.getAttribute("data-recovery-state")).toBe("needed");
+ expect(section?.getAttribute("data-recovery-kind")).toBe("missing_disposition");
expect(node.textContent).toContain("RECOVERY NEEDED");
expect(node.textContent).toContain("Missing Disposition");
- expect(node.textContent).not.toContain("missing_disposition");
- expect(node.textContent).toContain("This task's run finished, but no next step was chosen.");
+ expect(node.textContent).toContain(
+ "This task's run finished, but no next step was chosen. Choose what happens next — try the task again, mark it done, or send it for review.",
+ );
+ expect(node.textContent).toContain("An agent will be asked to choose the next step");
expect(node.textContent).toContain("ClaudeCoder");
expect(node.textContent).toContain("CodexCoder");
expect(node.textContent).toContain("Choose and record a valid issue disposition.");
- expect(node.textContent).toContain("Corrective wake queued");
- });
-
- it("falls back to em dash when wake policy is absent", () => {
- const node = render(
- <IssueRecoveryActionCard action={buildAction({ wakePolicy: null })} />,
- );
- expect(node.textContent).toContain("—");
});
it("renders observe_only tone for active_run_watchdog", () => {
@@ -165,11 +161,31 @@ describe("IssueRecoveryActionCard", () => {
<IssueRecoveryActionCard action={buildAction({ kind: "active_run_watchdog" })} />,
);
const section = node.querySelector("section[aria-label]");
- expect(section?.getAttribute("aria-label")).toBe("Recovery action: observing active run");
+ expect(section?.getAttribute("data-recovery-state")).toBe("observe_only");
expect(node.textContent).toContain("OBSERVING ACTIVE RUN");
+ expect(node.textContent).toContain(
+ "The active run has been silent. Recovery is observing without interrupting it.",
+ );
+ });
+
+ it("explains issue_graph_liveness in plain language", () => {
+ const node = render(
+ <IssueRecoveryActionCard
+ action={buildAction({ kind: "issue_graph_liveness", cause: "issue_graph_liveness" })}
+ />,
+ );
+ expect(node.textContent).toContain("Task Needs Next Step");
+ expect(node.textContent).toContain(
+ "Paperclip could not find a clear next step for this open task. Choose whether to continue work, send it for review, mark it done, or record what is blocking it.",
+ );
+ });
+
+ it("falls back to an em dash when no evidence summary is available", () => {
+ const node = render(<IssueRecoveryActionCard action={buildAction({ evidence: {} })} />);
+ expect(node.textContent).toContain("—");
});
- it("renders a workspace-specific label and headline for workspace_validation", () => {
+ it("renders workspace_validation with its kind attribute and the recorded next action", () => {
const node = render(
<IssueRecoveryActionCard
action={buildAction({
@@ -188,12 +204,10 @@ describe("IssueRecoveryActionCard", () => {
const section = node.querySelector("section[aria-label]");
expect(section?.getAttribute("data-recovery-kind")).toBe("workspace_validation");
expect(node.textContent).toContain("Workspace Validation");
- expect(node.textContent).not.toContain("workspace_validation\n");
expect(node.textContent).toContain(
"Paperclip stopped this run because the task's git workspace could not be validated.",
);
expect(node.textContent).toContain("Repair the source issue workspace link");
- expect(node.textContent).toContain("Manual repair required");
});
it("renders a human evidence summary as prose, not a mono log line", () => {
@@ -217,6 +231,9 @@ describe("IssueRecoveryActionCard", () => {
expect(summary).toBeTruthy();
expect(summary?.className).toContain("text-xs");
expect(summary?.className).not.toContain("font-mono");
+ expect(node.textContent).toContain(
+ "To get it moving, choose what happens next — try the task again, mark it done, or send it for review.",
+ );
});
it("keeps code-shaped evidence (error code, no summary) in the mono treatment", () => {
@@ -238,11 +255,14 @@ describe("IssueRecoveryActionCard", () => {
expect(code?.className).toContain("font-mono");
});
- it("renders the resolved label and outcome when resolved", () => {
+ it("renders the resolved state and outcome when resolved", () => {
const node = render(
<IssueRecoveryActionCard action={buildAction({ status: "resolved", outcome: "restored", resolvedAt: "2026-05-09T19:35:00.000Z" })} />,
);
+ const section = node.querySelector("section[aria-label]");
+ expect(section?.getAttribute("data-recovery-state")).toBe("resolved");
expect(node.textContent).toContain("RECOVERY RESOLVED");
+ expect(node.textContent).toContain("Recovery resolved as restored.");
expect(node.textContent).toContain("Resolved as restored");
});
@@ -338,22 +358,35 @@ describe("IssueRecoveryActionCard workspace_validation divergence", () => {
const diagnosis = node.querySelector("[data-testid='recovery-divergence-diagnosis']");
expect(diagnosis).not.toBeNull();
const text = diagnosis?.textContent ?? "";
+ expect(text).toContain("Divergence diagnosis");
+ expect(text).toContain("Expected · recorded");
+ expect(text).toContain("Live · checked out");
expect(text).toContain("PAP-522-recorded");
expect(text).toContain("nleach/PAP-1405-live");
// shortened shas (10 chars)
expect(text).toContain("aaaaaaaaaa");
expect(text).toContain("bbbbbbbbbb");
expect(text).toContain("cannot prove a forward-only reconciliation");
- expect(node.querySelector("[data-testid='recovery-ancestry-verdict']")?.textContent).toContain("Diverged");
+ expect(node.querySelector("[data-testid='recovery-ancestry-verdict']")).not.toBeNull();
});
- it("labels an ancestor verdict as forward-only", () => {
- const node = render(
+ it("labels each ancestry verdict", () => {
+ const diverged = render(<IssueRecoveryActionCard action={buildWorkspaceValidationAction()} />);
+ expect(diverged.querySelector("[data-testid='recovery-ancestry-verdict']")?.textContent).toBe("Diverged");
+
+ const ancestor = render(
<IssueRecoveryActionCard
action={buildWorkspaceValidationAction({ provenance: { ancestryVerdict: "ancestor" } })}
/>,
);
- expect(node.querySelector("[data-testid='recovery-ancestry-verdict']")?.textContent).toContain("Forward-only");
+ expect(ancestor.querySelector("[data-testid='recovery-ancestry-verdict']")?.textContent).toBe("Forward-only");
+
+ const unknown = render(
+ <IssueRecoveryActionCard
+ action={buildWorkspaceValidationAction({ provenance: { ancestryVerdict: "unknown" } })}
+ />,
+ );
+ expect(unknown.querySelector("[data-testid='recovery-ancestry-verdict']")?.textContent).toBe("Ancestry unknown");
});
it("does not render a divergence diagnosis for non-incoherence workspace failures", () => {
@@ -376,7 +409,6 @@ describe("IssueRecoveryActionCard workspace_validation divergence", () => {
/>,
);
click(node.querySelector("[data-testid='recovery-action-reissue-trigger']"));
- expect(document.body.textContent).toContain("Re-issue on isolated workspace");
click(document.body.querySelector("[data-testid='recovery-action-reissue-confirm']"));
expect(onReissueIsolated).toHaveBeenCalledWith({
baseRef: "nleach/PAP-1405-live",
@@ -492,14 +524,13 @@ describe("IssueRecoveryActionCard W7 reconcile actions", () => {
);
click(node.querySelector("[data-testid='recovery-action-breakglass-trigger']"));
- // The confirm step restates the divergence: both branches, both short SHAs, and the verdict.
+ // The confirm step restates the divergence: both branches and both short SHAs.
const restated = document.body.querySelector("[data-testid='recovery-breakglass-restated-divergence']");
const restatedText = restated?.textContent ?? "";
expect(restatedText).toContain("PAP-522-recorded");
expect(restatedText).toContain("nleach/PAP-1405-live");
expect(restatedText).toContain("aaaaaaaaaa");
expect(restatedText).toContain("bbbbbbbbbb");
- expect(restatedText).toContain("Diverged");
// The override is disabled until a non-empty reason is recorded.
const confirm = document.body.querySelector<HTMLButtonElement>(
@@ -601,10 +632,12 @@ describe("IssueRecoveryActionCard repair workspace (quarantine_restore)", () =>
click(node.querySelector("[data-testid='recovery-action-repair-trigger']"));
const restated = document.body.querySelector("[data-testid='recovery-repair-restated']");
const text = restated?.textContent ?? "";
- expect(text).toContain("3 uncommitted changes");
- // live branch is explicitly left untouched
+ expect(
+ document.body.querySelector("[data-testid='recovery-repair-dirty-count']")?.textContent,
+ ).toBe("3 uncommitted changes");
+ // live branch is named in the restated summary, left untouched
expect(text).toContain("nleach/PAP-1405-live");
- expect(text).toContain("left untouched");
+ expect(text).toContain("(left untouched)");
// rescue branch preview mirrors the server naming (prefix + timestamp marker)
expect(
document.body.querySelector("[data-testid='recovery-repair-rescue-branch']")?.textContent,
@@ -619,7 +652,7 @@ describe("IssueRecoveryActionCard repair workspace (quarantine_restore)", () =>
expect(onQuarantineRestore).toHaveBeenCalledTimes(1);
});
- it("singularizes the dirty change count", () => {
+ it("singularizes a one-file dirty count", () => {
const node = render(
<IssueRecoveryActionCard
action={buildDirtyDivergenceAction({ workspaceValidation: { statusEntryCount: 1 } })}
@@ -663,10 +696,11 @@ describe("IssueRecoveryActionCard repair workspace (quarantine_restore)", () =>
onReissueIsolated={() => {}}
/>,
);
- // Diagnosis gains a claimant line naming the issue + active run.
+ // Diagnosis gains a claimant line naming the claiming issue.
const notice = node.querySelector("[data-testid='recovery-contention-notice']");
+ expect(notice?.textContent).toContain("Worktree claimed by");
expect(notice?.textContent).toContain("PAP-9001");
- expect(notice?.textContent).toContain("active run");
+ expect(notice?.textContent).toContain("(active run)");
// The repair control is present but disabled, with the claimant as the explanation.
const disabled = node.querySelector("[data-testid='recovery-action-repair-disabled']");
@@ -675,7 +709,9 @@ describe("IssueRecoveryActionCard repair workspace (quarantine_restore)", () =>
"[data-testid='recovery-action-repair-trigger']",
);
expect(trigger?.disabled).toBe(true);
- expect(disabled?.textContent).toContain("PAP-9001");
+ expect(disabled?.textContent).toContain(
+ "Held by PAP-9001 — re-issue on an isolated workspace instead.",
+ );
// Clicking the disabled control never fires the repair.
click(trigger ?? null);
expect(onQuarantineRestore).not.toHaveBeenCalled();
diff --git a/ui/src/components/IssueRecoveryActionCard.tsx b/ui/src/components/IssueRecoveryActionCard.tsx
index e4d9e0e60d..6ce46fc2a7 100644
--- a/ui/src/components/IssueRecoveryActionCard.tsx
+++ b/ui/src/components/IssueRecoveryActionCard.tsx
@@ -120,13 +120,14 @@ const KIND_LABEL: Record<IssueRecoveryActionKind, string> = {
workspace_validation: "Workspace Validation",
configuration_validation: "Configuration Validation",
active_run_watchdog: "Active Watchdog",
- issue_graph_liveness: "Graph Liveness",
+ issue_graph_liveness: "Task Needs Next Step",
};
const KIND_HEADLINE: Record<IssueRecoveryActionKind, string> = {
- missing_disposition: "This task's run finished, but no next step was chosen.",
+ missing_disposition:
+ "This task's run finished, but no next step was chosen. Choose what happens next — try the task again, mark it done, or send it for review.",
stranded_assigned_issue:
- "Paperclip retried this task's last run and it still has no live execution path.",
+ "Paperclip retried this task's last run, but there is still no queued run, reviewer, blocker, or other next owner. To get it moving, choose what happens next — try the task again, mark it done, or send it for review.",
workspace_validation:
"Paperclip stopped this run because the task's git workspace could not be validated.",
configuration_validation:
@@ -134,7 +135,7 @@ const KIND_HEADLINE: Record<IssueRecoveryActionKind, string> = {
active_run_watchdog:
"The active run has been silent. Recovery is observing without interrupting it.",
issue_graph_liveness:
- "Paperclip detected this task lost a live action path. A recovery owner needs to act.",
+ "Paperclip could not find a clear next step for this open task. Choose whether to continue work, send it for review, mark it done, or record what is blocking it.",
};
const STATE_TONE: Record<RecoveryCardCardState, {
@@ -737,13 +738,13 @@ function readWakePolicySummary(action: IssueRecoveryAction): string | null {
if (!policy) return null;
const type = readEvidenceString(policy.type);
if (!type) return null;
- if (type === "wake_owner") return "Corrective wake queued";
- if (type === "board_escalation") return "Escalated to board";
- if (type === "manual") return "Manual";
- if (type === "manual_repair_required") return "Manual repair required";
+ if (type === "wake_owner") return "An agent will be asked to choose the next step";
+ if (type === "board_escalation") return "Board will decide";
+ if (type === "manual") return "Manual follow-up needed";
+ if (type === "manual_repair_required") return "Repair needed before retry";
if (type === "monitor") {
const interval = readEvidenceString(policy.intervalLabel);
- return interval ? `Monitor scheduled · ${interval}` : "Monitor scheduled";
+ return interval ? `Check scheduled · ${interval}` : "Check scheduled";
}
return type.replaceAll("_", " ");
}
@@ -1091,7 +1092,7 @@ export function IssueRecoveryActionCard({
<MetadataRow label="Next action">
{action.nextAction ? <span>{action.nextAction}</span> : <MissingValue />}
</MetadataRow>
- <MetadataRow label="Wake">
+ <MetadataRow label="Follow-up">
<span className="inline-flex flex-wrap items-center gap-1.5">
{wakeSummary ? <span>{wakeSummary}</span> : <MissingValue />}
{showAttempt ? (