@slaw-ai/server 2026.611.0

package/dist/services/recovery/successful-run-handoff.js

@@ -0,0 +1,304 @@
+import { and, eq, inArray } from "drizzle-orm";
+import { agentWakeupRequests } from "@slaw-ai/db";
+import { withRecoveryModelProfileHint } from "./model-profile-hint.js";
+export const FINISH_SUCCESSFUL_RUN_HANDOFF_REASON = "finish_successful_run_handoff";
+export const SUCCESSFUL_RUN_MISSING_STATE_REASON = "successful_run_missing_state";
+export const DEFAULT_MAX_SUCCESSFUL_RUN_HANDOFF_ATTEMPTS = 1;
+export const SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY = "Slaw needs a disposition before this issue can continue.";
+export const SUCCESSFUL_RUN_HANDOFF_EXHAUSTED_NOTICE_BODY = "Slaw could not resolve this issue's missing disposition automatically. The issue is blocked on a recovery owner.";
+export const LEGACY_SUCCESSFUL_RUN_HANDOFF_NOTICE_PREFIXES = [
+    "## This issue still needs a next step",
+    "## Successful run missing issue disposition",
+];
+export const SUCCESSFUL_RUN_HANDOFF_OPTIONS = [
+    "mark_done_or_cancelled",
+    "send_for_review_or_ask_for_input",
+    "mark_blocked",
+    "delegate_or_continue_from_checkpoint",
+];
+const PRODUCTIVE_SUCCESS_LIVENESS_STATES = new Set([
+    "advanced",
+    "completed",
+    "blocked",
+    "needs_followup",
+]);
+const IDEMPOTENT_HANDOFF_WAKE_STATUSES = [
+    "queued",
+    "deferred_issue_execution",
+    "claimed",
+    "completed",
+];
+const IDEMPOTENT_HANDOFF_WAKE_STATUS_SET = new Set(IDEMPOTENT_HANDOFF_WAKE_STATUSES);
+export function isIdempotentFinishSuccessfulRunHandoffWakeStatus(status) {
+    return IDEMPOTENT_HANDOFF_WAKE_STATUS_SET.has(status);
+}
+export function noticeMetadataReferencesRecoveryAction(metadata, recoveryActionId) {
+    return (metadata?.sections ?? []).some((section) => section.rows.some((row) => row.type === "key_value" &&
+        row.label === "Recovery action" &&
+        row.value === recoveryActionId));
+}
+function metadataText(value, fallback = "unknown") {
+    const text = typeof value === "string" ? value.trim() : value == null ? "" : String(value).trim();
+    const resolved = text.length > 0 ? text : fallback;
+    return resolved.length > 2000 ? `${resolved.slice(0, 1997)}...` : resolved;
+}
+function keyValueRow(label, value) {
+    return { type: "key_value", label, value: metadataText(value) };
+}
+function issueLinkRow(label, issue) {
+    if (!issue)
+        return keyValueRow(label, "unknown");
+    return {
+        type: "issue_link",
+        label,
+        issueId: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+    };
+}
+function runLinkRow(label, run) {
+    if (!run)
+        return keyValueRow(label, "unknown");
+    return { type: "run_link", label, runId: run.id, title: run.status };
+}
+function agentLinkRow(label, agent) {
+    if (!agent)
+        return keyValueRow(label, "unknown");
+    return { type: "agent_link", label, agentId: agent.id, name: agent.name };
+}
+function systemNoticePresentation(input) {
+    return {
+        kind: "system_notice",
+        tone: input.tone,
+        title: input.title,
+        detailsDefaultOpen: false,
+    };
+}
+export function isSuccessfulRunHandoffRequiredNoticeBody(body) {
+    const trimmed = body.trim();
+    return trimmed === SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY ||
+        LEGACY_SUCCESSFUL_RUN_HANDOFF_NOTICE_PREFIXES.some((prefix) => trimmed.startsWith(prefix));
+}
+export function buildSuccessfulRunHandoffRequiredNotice(input) {
+    return {
+        body: SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY,
+        presentation: systemNoticePresentation({
+            tone: "warning",
+            title: "Missing issue disposition",
+        }),
+        metadata: {
+            version: 1,
+            sourceRunId: input.run.id,
+            sections: [
+                {
+                    title: "Required action",
+                    rows: [
+                        issueLinkRow("Source issue", input.issue),
+                        agentLinkRow("Assignee", input.agent),
+                        keyValueRow("Missing disposition", "clear_next_step"),
+                        keyValueRow("Valid dispositions", "done, cancelled, in_review with an owner, blocked with blockers, delegated follow-up, or explicit continuation"),
+                    ],
+                },
+                {
+                    title: "Run evidence",
+                    rows: [
+                        runLinkRow("Successful run", input.run),
+                        keyValueRow("Run status", input.run.status),
+                        keyValueRow("Normalized cause", SUCCESSFUL_RUN_MISSING_STATE_REASON),
+                        keyValueRow("Detected progress", input.detectedProgressSummary),
+                        keyValueRow("Automatic retry", "one corrective handoff wake queued"),
+                    ],
+                },
+            ],
+        },
+    };
+}
+export function buildSuccessfulRunHandoffExhaustedNotice(input) {
+    return {
+        body: SUCCESSFUL_RUN_HANDOFF_EXHAUSTED_NOTICE_BODY,
+        presentation: systemNoticePresentation({
+            tone: "danger",
+            title: "Missing disposition recovery blocked",
+        }),
+        metadata: {
+            version: 1,
+            sourceRunId: input.sourceRun?.id ?? null,
+            sections: [
+                {
+                    title: "Recovery owner",
+                    rows: [
+                        issueLinkRow("Source issue", input.issue),
+                        input.recoveryActionId
+                            ? keyValueRow("Recovery action", input.recoveryActionId)
+                            : issueLinkRow("Recovery issue", input.recoveryIssue),
+                        agentLinkRow("Recovery owner", input.recoveryOwner),
+                        agentLinkRow("Source assignee", input.sourceAssignee),
+                        keyValueRow("Suggested action", "choose and record a valid issue disposition without copying transcript content"),
+                    ],
+                },
+                {
+                    title: "Run evidence",
+                    rows: [
+                        runLinkRow("Source run", input.sourceRun),
+                        runLinkRow("Corrective handoff run", input.correctiveRun),
+                        keyValueRow("Latest issue status", input.latestIssueStatus),
+                        keyValueRow("Latest handoff run status", input.latestHandoffRunStatus),
+                        keyValueRow("Normalized cause", SUCCESSFUL_RUN_MISSING_STATE_REASON),
+                        keyValueRow("Missing disposition", input.missingDisposition),
+                    ],
+                },
+            ],
+        },
+    };
+}
+export function buildFinishSuccessfulRunHandoffIdempotencyKey(input) {
+    return [
+        FINISH_SUCCESSFUL_RUN_HANDOFF_REASON,
+        input.issueId,
+        input.sourceRunId,
+        String(input.attempt ?? 1),
+    ].join(":");
+}
+export async function findExistingFinishSuccessfulRunHandoffWake(db, input) {
+    return db
+        .select({ id: agentWakeupRequests.id, status: agentWakeupRequests.status })
+        .from(agentWakeupRequests)
+        .where(and(eq(agentWakeupRequests.squadId, input.squadId), eq(agentWakeupRequests.idempotencyKey, input.idempotencyKey), inArray(agentWakeupRequests.status, IDEMPOTENT_HANDOFF_WAKE_STATUSES)))
+        .limit(1)
+        .then((rows) => rows[0] ?? null);
+}
+function readRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function readString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function isCorrectiveHandoffRun(run) {
+    const context = readRecord(run.contextSnapshot);
+    return context.handoffRequired === true ||
+        readString(context.wakeReason) === FINISH_SUCCESSFUL_RUN_HANDOFF_REASON;
+}
+function isIssueMonitorMaintenanceRun(run) {
+    const context = readRecord(run.contextSnapshot);
+    const wakeReason = readString(context.wakeReason);
+    const source = readString(context.source);
+    return Boolean(wakeReason?.startsWith("issue_monitor") || source?.startsWith("issue.monitor"));
+}
+function isProductiveSuccessfulRun(input) {
+    if (input.livenessState && PRODUCTIVE_SUCCESS_LIVENESS_STATES.has(input.livenessState))
+        return true;
+    return Boolean(input.detectedProgressSummary);
+}
+export function buildSuccessfulRunHandoffInstruction(input) {
+    const issueLabel = input.issueIdentifier ?? "this issue";
+    return [
+        `Your previous run on ${issueLabel} succeeded, but the issue is still in \`in_progress\` and Slaw cannot identify a valid issue disposition.`,
+        "",
+        "Resolve the missing disposition before creating or revising any new artifacts. Choose **exactly one** outcome and perform the matching Slaw action:",
+        "",
+        "**Is the issue finished?**",
+        "1. Mark it `done` (scope complete) or `cancelled` (intentionally stopped).",
+        "",
+        "**Does someone else need to look at it?**",
+        "2. Move it to `in_review` with a real reviewer path — `executionState.currentParticipant`, a human owner via `assigneeUserId`, a pending issue-thread interaction, or a linked pending approval.",
+        "",
+        "**Can it not continue right now?**",
+        "3. Mark it `blocked` with first-class blockers (`blockedByIssueIds`) or a clearly named unblock owner/action.",
+        "",
+        "**Is there more work to do?**",
+        `4. Either delegate follow-up work (create/link a follow-up issue and block this one on it, or close this issue if its scope is independently complete) or record an explicit continuation path with \`resumeIntent: true\`, \`resumeFromRunId: ${input.sourceRunId}\`, and a concrete next action. Do not perform the remaining source work in this recovery run; the follow-up/resume wake must use the normal model lane.`,
+        "",
+        "Comments, document revisions, work-product writes, and continuation summaries are supporting evidence only — they do not satisfy this handoff unless the issue state/path also records one valid disposition. If this wake is status-only recovery, document or plan updates are not allowed.",
+    ].join("\n");
+}
+export function decideSuccessfulRunHandoff(input) {
+    const { run, issue, agent } = input;
+    if (run.status !== "succeeded")
+        return { kind: "skip", reason: "source run did not succeed" };
+    if (isCorrectiveHandoffRun(run))
+        return { kind: "skip", reason: "source run is already a corrective handoff run" };
+    if (isIssueMonitorMaintenanceRun(run))
+        return { kind: "skip", reason: "issue monitor run owns its own recovery path" };
+    if (run.issueCommentStatus === "retry_queued" || run.issueCommentStatus === "retry_exhausted") {
+        return { kind: "skip", reason: "missing issue comment retry owns the next action" };
+    }
+    if (!issue)
+        return { kind: "skip", reason: "issue not found" };
+    if (!agent)
+        return { kind: "skip", reason: "agent not found" };
+    if (issue.squadId !== run.squadId || agent.squadId !== run.squadId) {
+        return { kind: "skip", reason: "squad scope mismatch" };
+    }
+    if (issue.assigneeAgentId !== run.agentId) {
+        return { kind: "skip", reason: "issue is no longer assigned to the source run agent" };
+    }
+    if (issue.assigneeUserId)
+        return { kind: "skip", reason: "issue is human-owned" };
+    if (issue.status !== "in_progress")
+        return { kind: "skip", reason: `issue status ${issue.status} is a valid disposition` };
+    if (issue.executionState)
+        return { kind: "skip", reason: "issue has execution policy state" };
+    if (agent.status === "paused" || agent.status === "terminated" || agent.status === "pending_approval") {
+        return { kind: "skip", reason: `agent status ${agent.status} is not invokable` };
+    }
+    if (!isProductiveSuccessfulRun(input)) {
+        return { kind: "skip", reason: "successful run did not produce handoff-relevant progress" };
+    }
+    if (input.hasActiveExecutionPath)
+        return { kind: "skip", reason: "issue already has an active execution path" };
+    if (input.hasQueuedWake)
+        return { kind: "skip", reason: "issue already has a queued or deferred wake" };
+    if (input.hasPendingInteractionOrApproval) {
+        return { kind: "skip", reason: "pending interaction or approval owns the next action" };
+    }
+    if (input.hasExplicitBlockerPath)
+        return { kind: "skip", reason: "explicit blocker path owns the next action" };
+    if (input.hasOpenRecoveryIssue)
+        return { kind: "skip", reason: "open recovery issue owns the ambiguity" };
+    if (input.hasPauseHold)
+        return { kind: "skip", reason: "issue is under an active pause hold" };
+    if (input.budgetBlocked)
+        return { kind: "skip", reason: "budget hard stop blocks corrective wake" };
+    if (input.idempotentWakeExists) {
+        return { kind: "skip", reason: "corrective handoff wake already exists for this source run" };
+    }
+    const instruction = buildSuccessfulRunHandoffInstruction({
+        issueIdentifier: issue.identifier,
+        sourceRunId: run.id,
+    });
+    const payload = withRecoveryModelProfileHint({
+        issueId: issue.id,
+        taskId: issue.id,
+        sourceIssueId: issue.id,
+        sourceRunId: run.id,
+        handoffRequired: true,
+        handoffReason: SUCCESSFUL_RUN_MISSING_STATE_REASON,
+        missingDisposition: "clear_next_step",
+        validDispositionOptions: [...SUCCESSFUL_RUN_HANDOFF_OPTIONS],
+        detectedProgressSummary: input.detectedProgressSummary,
+        handoffAttempt: 1,
+        maxHandoffAttempts: DEFAULT_MAX_SUCCESSFUL_RUN_HANDOFF_ATTEMPTS,
+        resumeIntent: true,
+        followUpRequested: true,
+        resumeFromRunId: run.id,
+        ...(input.taskKey ? { taskKey: input.taskKey } : {}),
+        instruction,
+    }, "status_only");
+    return {
+        kind: "enqueue",
+        idempotencyKey: buildFinishSuccessfulRunHandoffIdempotencyKey({
+            issueId: issue.id,
+            sourceRunId: run.id,
+        }),
+        payload,
+        instruction,
+        contextSnapshot: withRecoveryModelProfileHint({
+            ...payload,
+            wakeReason: FINISH_SUCCESSFUL_RUN_HANDOFF_REASON,
+            livenessState: input.livenessState,
+        }, "status_only"),
+    };
+}
+//# sourceMappingURL=successful-run-handoff.js.map

package/dist/services/recovery/successful-run-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"successful-run-handoff.js","sourceRoot":"","sources":["../../../src/services/recovery/successful-run-handoff.ts"],"names":[],"mappings":"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"}

package/dist/services/recovery/successful-run-handoff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=successful-run-handoff.test.d.ts.map

package/dist/services/recovery/successful-run-handoff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"successful-run-handoff.test.d.ts","sourceRoot":"","sources":["../../../src/services/recovery/successful-run-handoff.test.ts"],"names":[],"mappings":""}

package/dist/services/recovery/successful-run-handoff.test.js

@@ -0,0 +1,276 @@
+import { describe, expect, it } from "vitest";
+import { FINISH_SUCCESSFUL_RUN_HANDOFF_REASON, SUCCESSFUL_RUN_HANDOFF_EXHAUSTED_NOTICE_BODY, SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY, SUCCESSFUL_RUN_MISSING_STATE_REASON, buildFinishSuccessfulRunHandoffIdempotencyKey, buildSuccessfulRunHandoffExhaustedNotice, buildSuccessfulRunHandoffRequiredNotice, decideSuccessfulRunHandoff, isIdempotentFinishSuccessfulRunHandoffWakeStatus, isSuccessfulRunHandoffRequiredNoticeBody, noticeMetadataReferencesRecoveryAction, } from "./successful-run-handoff.js";
+const run = {
+    id: "run-1",
+    squadId: "squad-1",
+    agentId: "agent-1",
+    status: "succeeded",
+    contextSnapshot: { issueId: "issue-1" },
+};
+const issue = {
+    id: "issue-1",
+    squadId: "squad-1",
+    identifier: "PAP-1",
+    title: "Finish backend handoff",
+    status: "in_progress",
+    assigneeAgentId: "agent-1",
+    assigneeUserId: null,
+    executionState: null,
+};
+const agent = {
+    id: "agent-1",
+    squadId: "squad-1",
+    status: "idle",
+};
+function decide(overrides = {}) {
+    return decideSuccessfulRunHandoff({
+        run,
+        issue,
+        agent,
+        livenessState: "advanced",
+        detectedProgressSummary: "Run produced concrete action evidence: 1 issue comment(s)",
+        taskKey: "issue-1",
+        hasActiveExecutionPath: false,
+        hasQueuedWake: false,
+        hasPendingInteractionOrApproval: false,
+        hasExplicitBlockerPath: false,
+        hasOpenRecoveryIssue: false,
+        hasPauseHold: false,
+        budgetBlocked: false,
+        idempotentWakeExists: false,
+        ...overrides,
+    });
+}
+describe("successful run handoff decision", () => {
+    it("queues one corrective handoff wake for a successful progress run without a visible next action", () => {
+        const decision = decide();
+        expect(decision.kind).toBe("enqueue");
+        if (decision.kind !== "enqueue")
+            return;
+        expect(decision.idempotencyKey).toBe("finish_successful_run_handoff:issue-1:run-1:1");
+        expect(decision.payload).toMatchObject({
+            issueId: "issue-1",
+            sourceRunId: "run-1",
+            handoffRequired: true,
+            handoffReason: SUCCESSFUL_RUN_MISSING_STATE_REASON,
+            missingDisposition: "clear_next_step",
+            handoffAttempt: 1,
+            maxHandoffAttempts: 1,
+            resumeIntent: true,
+            resumeFromRunId: "run-1",
+            modelProfile: "cheap",
+            allowDeliverableWork: false,
+            allowDocumentUpdates: false,
+            resumeRequiresNormalModel: true,
+        });
+        expect(decision.contextSnapshot).toMatchObject({
+            wakeReason: FINISH_SUCCESSFUL_RUN_HANDOFF_REASON,
+            handoffRequired: true,
+            modelProfile: "cheap",
+            allowDeliverableWork: false,
+            allowDocumentUpdates: false,
+            resumeRequiresNormalModel: true,
+        });
+        expect(decision.instruction).toContain("Resolve the missing disposition before creating or revising any new artifacts");
+        expect(decision.instruction).toContain("Choose **exactly one** outcome");
+        expect(decision.instruction).toContain("record an explicit continuation path");
+    });
+    it("does not queue when the issue already has a valid disposition", () => {
+        expect(decide({ issue: { ...issue, status: "done" } })).toEqual({
+            kind: "skip",
+            reason: "issue status done is a valid disposition",
+        });
+    });
+    it("does not queue when a successful run records an accepted next-action path", () => {
+        expect(decide({ issue: { ...issue, status: "in_review" } })).toEqual({
+            kind: "skip",
+            reason: "issue status in_review is a valid disposition",
+        });
+        expect(decide({ issue: { ...issue, status: "blocked" } })).toEqual({
+            kind: "skip",
+            reason: "issue status blocked is a valid disposition",
+        });
+        expect(decide({ hasPendingInteractionOrApproval: true })).toEqual({
+            kind: "skip",
+            reason: "pending interaction or approval owns the next action",
+        });
+        expect(decide({ hasActiveExecutionPath: true })).toEqual({
+            kind: "skip",
+            reason: "issue already has an active execution path",
+        });
+    });
+    it("does not queue when another wake or dependency path already owns the next action", () => {
+        expect(decide({ hasQueuedWake: true })).toEqual({
+            kind: "skip",
+            reason: "issue already has a queued or deferred wake",
+        });
+        expect(decide({ hasExplicitBlockerPath: true })).toEqual({
+            kind: "skip",
+            reason: "explicit blocker path owns the next action",
+        });
+    });
+    it("does not queue when a successful run has no progress signal", () => {
+        expect(decide({ livenessState: null, detectedProgressSummary: null })).toEqual({
+            kind: "skip",
+            reason: "successful run did not produce handoff-relevant progress",
+        });
+    });
+    it("does not treat adapter or runtime failures as missing-disposition handoffs", () => {
+        expect(decide({ run: { ...run, status: "failed", errorCode: "adapter_failed" } })).toEqual({
+            kind: "skip",
+            reason: "source run did not succeed",
+        });
+    });
+    it("does not queue on missing-comment retry bookkeeping runs", () => {
+        expect(decide({ run: { ...run, issueCommentStatus: "retry_exhausted" } })).toEqual({
+            kind: "skip",
+            reason: "missing issue comment retry owns the next action",
+        });
+    });
+    it("does not loop from a corrective handoff run", () => {
+        expect(decide({
+            run: {
+                ...run,
+                id: "run-2",
+                contextSnapshot: {
+                    issueId: "issue-1",
+                    wakeReason: FINISH_SUCCESSFUL_RUN_HANDOFF_REASON,
+                    handoffRequired: true,
+                },
+            },
+        })).toEqual({
+            kind: "skip",
+            reason: "source run is already a corrective handoff run",
+        });
+    });
+    it("does not queue for issue monitor maintenance runs", () => {
+        expect(decide({
+            run: {
+                ...run,
+                contextSnapshot: {
+                    issueId: "issue-1",
+                    source: "issue.monitor",
+                    wakeReason: "issue_monitor_due",
+                },
+            },
+        })).toEqual({
+            kind: "skip",
+            reason: "issue monitor run owns its own recovery path",
+        });
+    });
+    it("uses a stable one-attempt idempotency key", () => {
+        expect(buildFinishSuccessfulRunHandoffIdempotencyKey({
+            issueId: "issue-1",
+            sourceRunId: "run-1",
+        })).toBe("finish_successful_run_handoff:issue-1:run-1:1");
+    });
+    it("allows failed or cancelled corrective wakes to be retried", () => {
+        expect(isIdempotentFinishSuccessfulRunHandoffWakeStatus("queued")).toBe(true);
+        expect(isIdempotentFinishSuccessfulRunHandoffWakeStatus("claimed")).toBe(true);
+        expect(isIdempotentFinishSuccessfulRunHandoffWakeStatus("completed")).toBe(true);
+        expect(isIdempotentFinishSuccessfulRunHandoffWakeStatus("failed")).toBe(false);
+        expect(isIdempotentFinishSuccessfulRunHandoffWakeStatus("cancelled")).toBe(false);
+    });
+    it("builds the required system notice with hidden structured metadata", () => {
+        const notice = buildSuccessfulRunHandoffRequiredNotice({
+            issue: {
+                id: "11111111-1111-4111-8111-111111111111",
+                identifier: "PAP-1",
+                title: "Finish backend handoff",
+                status: "in_progress",
+            },
+            run: {
+                id: "22222222-2222-4222-8222-222222222222",
+                status: "succeeded",
+            },
+            agent: {
+                id: "33333333-3333-4333-8333-333333333333",
+                name: "CodexCoder",
+            },
+            detectedProgressSummary: "Run produced concrete action evidence: 1 issue comment(s)",
+        });
+        expect(notice.body).toBe(SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY);
+        expect(notice.presentation).toEqual({
+            kind: "system_notice",
+            tone: "warning",
+            title: "Missing issue disposition",
+            detailsDefaultOpen: false,
+        });
+        expect(notice.metadata.sourceRunId).toBe("22222222-2222-4222-8222-222222222222");
+        expect(notice.metadata.sections).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                title: "Required action",
+                rows: expect.arrayContaining([
+                    expect.objectContaining({ type: "issue_link", identifier: "PAP-1" }),
+                    expect.objectContaining({ type: "agent_link", name: "CodexCoder" }),
+                    expect.objectContaining({ type: "key_value", label: "Missing disposition", value: "clear_next_step" }),
+                ]),
+            }),
+            expect.objectContaining({
+                title: "Run evidence",
+                rows: expect.arrayContaining([
+                    expect.objectContaining({ type: "run_link", runId: "22222222-2222-4222-8222-222222222222" }),
+                    expect.objectContaining({ type: "key_value", label: "Normalized cause", value: SUCCESSFUL_RUN_MISSING_STATE_REASON }),
+                    expect.objectContaining({ type: "key_value", label: "Detected progress" }),
+                ]),
+            }),
+        ]));
+    });
+    it("builds the exhausted system notice with recovery metadata", () => {
+        const notice = buildSuccessfulRunHandoffExhaustedNotice({
+            issue: {
+                id: "11111111-1111-4111-8111-111111111111",
+                identifier: "PAP-1",
+                title: "Finish backend handoff",
+                status: "in_progress",
+            },
+            sourceRun: { id: "22222222-2222-4222-8222-222222222222", status: "succeeded" },
+            correctiveRun: { id: "44444444-4444-4444-8444-444444444444", status: "failed" },
+            sourceAssignee: { id: "33333333-3333-4333-8333-333333333333", name: "CodexCoder" },
+            recoveryIssue: {
+                id: "55555555-5555-4555-8555-555555555555",
+                identifier: "PAP-2",
+                title: "Recover missing next step PAP-1",
+                status: "todo",
+            },
+            recoveryActionId: "77777777-7777-4777-8777-777777777777",
+            recoveryOwner: { id: "66666666-6666-4666-8666-666666666666", name: "CTO" },
+            latestIssueStatus: "in_progress",
+            latestHandoffRunStatus: "failed",
+            missingDisposition: "clear_next_step",
+        });
+        expect(notice.body).toBe(SUCCESSFUL_RUN_HANDOFF_EXHAUSTED_NOTICE_BODY);
+        expect(notice.presentation).toMatchObject({
+            kind: "system_notice",
+            tone: "danger",
+            detailsDefaultOpen: false,
+        });
+        expect(notice.metadata.sourceRunId).toBe("22222222-2222-4222-8222-222222222222");
+        expect(notice.metadata.sections).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                title: "Recovery owner",
+                rows: expect.arrayContaining([
+                    expect.objectContaining({ type: "key_value", label: "Recovery action", value: "77777777-7777-4777-8777-777777777777" }),
+                    expect.objectContaining({ type: "agent_link", label: "Recovery owner", name: "CTO" }),
+                ]),
+            }),
+            expect.objectContaining({
+                title: "Run evidence",
+                rows: expect.arrayContaining([
+                    expect.objectContaining({ type: "run_link", label: "Source run" }),
+                    expect.objectContaining({ type: "run_link", label: "Corrective handoff run" }),
+                    expect.objectContaining({ type: "key_value", label: "Missing disposition", value: "clear_next_step" }),
+                ]),
+            }),
+        ]));
+        expect(noticeMetadataReferencesRecoveryAction(notice.metadata, "77777777-7777-4777-8777-777777777777")).toBe(true);
+        expect(noticeMetadataReferencesRecoveryAction(notice.metadata, "88888888-8888-4888-8888-888888888888")).toBe(false);
+    });
+    it("recognizes new notices and legacy markdown headings for fallback deduplication", () => {
+        expect(isSuccessfulRunHandoffRequiredNoticeBody(SUCCESSFUL_RUN_HANDOFF_REQUIRED_NOTICE_BODY)).toBe(true);
+        expect(isSuccessfulRunHandoffRequiredNoticeBody("## Successful run missing issue disposition\n\nold body")).toBe(true);
+        expect(isSuccessfulRunHandoffRequiredNoticeBody("## This issue still needs a next step\n\nold body")).toBe(true);
+        expect(isSuccessfulRunHandoffRequiredNoticeBody("Unrelated comment")).toBe(false);
+    });
+});
+//# sourceMappingURL=successful-run-handoff.test.js.map

package/dist/services/recovery/successful-run-handoff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"successful-run-handoff.test.js","sourceRoot":"","sources":["../../../src/services/recovery/successful-run-handoff.test.ts"],"names":[],"mappings":"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"}