@evermore.work/server 2026.509.0-canary.0

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

@@ -0,0 +1,267 @@
+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, } from "./successful-run-handoff.js";
+const run = {
+    id: "run-1",
+    companyId: "company-1",
+    agentId: "agent-1",
+    status: "succeeded",
+    contextSnapshot: { issueId: "issue-1" },
+};
+const issue = {
+    id: "issue-1",
+    companyId: "company-1",
+    identifier: "EVR-1",
+    title: "Finish backend handoff",
+    status: "in_progress",
+    assigneeAgentId: "agent-1",
+    assigneeUserId: null,
+    executionState: null,
+};
+const agent = {
+    id: "agent-1",
+    companyId: "company-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",
+        });
+        expect(decision.contextSnapshot).toMatchObject({
+            wakeReason: FINISH_SUCCESSFUL_RUN_HANDOFF_REASON,
+            handoffRequired: true,
+            modelProfile: "cheap",
+        });
+        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: "EVR-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: "EVR-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: "EVR-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: "EVR-2",
+                title: "Recover missing next step EVR-1",
+                status: "todo",
+            },
+            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: "issue_link", identifier: "EVR-2" }),
+                    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" }),
+                ]),
+            }),
+        ]));
+    });
+    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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"}

package/dist/services/routines.d.ts

@@ -0,0 +1,166 @@
+import type { Db } from "@evermore.work/db";
+import type { CreateRoutine, CreateRoutineTrigger, Routine, RoutineDetail, RoutineListItem, RoutineRevision, RoutineRunSummary, RoutineTrigger, RoutineTriggerSecretMaterial, RoutineVariable, RunRoutine, UpdateRoutine, UpdateRoutineTrigger } from "@evermore.work/shared";
+import { type IssueAssignmentWakeupDeps } from "./issue-assignment-wakeup.js";
+import type { PluginWorkerManager } from "./plugin-worker-manager.js";
+type Actor = {
+    agentId?: string | null;
+    userId?: string | null;
+    runId?: string | null;
+};
+interface RoutineTriggerSecretRestoreMaterial extends RoutineTriggerSecretMaterial {
+    triggerId: string;
+}
+export declare function routineService(db: Db, deps?: {
+    heartbeat?: IssueAssignmentWakeupDeps;
+    pluginWorkerManager?: PluginWorkerManager;
+}): {
+    get: (id: string) => Promise<{
+        id: string;
+        description: string | null;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        companyId: string;
+        title: string;
+        createdByAgentId: string | null;
+        createdByUserId: string | null;
+        updatedByUserId: string | null;
+        updatedByAgentId: string | null;
+        projectId: string | null;
+        lastTriggeredAt: Date | null;
+        goalId: string | null;
+        priority: string;
+        assigneeAgentId: string | null;
+        parentIssueId: string | null;
+        concurrencyPolicy: string;
+        catchUpPolicy: string;
+        variables: RoutineVariable[];
+        latestRevisionId: string | null;
+        latestRevisionNumber: number;
+        lastEnqueuedAt: Date | null;
+    }>;
+    getTrigger: (id: string) => Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        companyId: string;
+        createdByAgentId: string | null;
+        createdByUserId: string | null;
+        updatedByUserId: string | null;
+        kind: string;
+        label: string | null;
+        routineId: string;
+        enabled: boolean;
+        cronExpression: string | null;
+        timezone: string | null;
+        nextRunAt: Date | null;
+        lastFiredAt: Date | null;
+        publicId: string | null;
+        secretId: string | null;
+        signingMode: string | null;
+        replayWindowSec: number | null;
+        lastRotatedAt: Date | null;
+        lastResult: string | null;
+        updatedByAgentId: string | null;
+    }>;
+    list: (companyId: string, filters?: {
+        projectId?: string | null;
+    }) => Promise<RoutineListItem[]>;
+    getDetail: (id: string) => Promise<RoutineDetail | null>;
+    create: (companyId: string, input: CreateRoutine, actor: Actor) => Promise<Routine>;
+    update: (id: string, patch: UpdateRoutine, actor: Actor) => Promise<Routine | null>;
+    createTrigger: (routineId: string, input: CreateRoutineTrigger, actor: Actor) => Promise<{
+        trigger: RoutineTrigger;
+        secretMaterial: RoutineTriggerSecretMaterial | null;
+        revision: RoutineRevision;
+    }>;
+    updateTrigger: (id: string, patch: UpdateRoutineTrigger, actor: Actor) => Promise<{
+        trigger: RoutineTrigger;
+        revision: RoutineRevision;
+    } | null>;
+    deleteTrigger: (id: string, actor?: Actor) => Promise<{
+        deleted: boolean;
+        revision: RoutineRevision | null;
+    }>;
+    rotateTriggerSecret: (id: string, actor: Actor) => Promise<{
+        trigger: RoutineTrigger;
+        secretMaterial: RoutineTriggerSecretMaterial;
+        revision: RoutineRevision;
+    }>;
+    listRevisions: (routineId: string) => Promise<RoutineRevision[]>;
+    restoreRevision: (routineId: string, revisionId: string, actor: Actor) => Promise<{
+        routine: Routine;
+        revision: RoutineRevision;
+        restoredFromRevisionId: string;
+        restoredFromRevisionNumber: number;
+        secretMaterials: RoutineTriggerSecretRestoreMaterial[];
+    }>;
+    runRoutine: (id: string, input: RunRoutine, actor?: Actor) => Promise<{
+        id: string;
+        companyId: string;
+        routineId: string;
+        triggerId: string | null;
+        source: string;
+        status: string;
+        triggeredAt: Date;
+        idempotencyKey: string | null;
+        triggerPayload: Record<string, unknown> | null;
+        dispatchFingerprint: string | null;
+        linkedIssueId: string | null;
+        coalescedIntoRunId: string | null;
+        failureReason: string | null;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    firePublicTrigger: (publicId: string, input: {
+        authorizationHeader?: string | null;
+        signatureHeader?: string | null;
+        hubSignatureHeader?: string | null;
+        timestampHeader?: string | null;
+        idempotencyKey?: string | null;
+        rawBody?: Buffer | null;
+        payload?: Record<string, unknown> | null;
+    }) => Promise<{
+        id: string;
+        companyId: string;
+        routineId: string;
+        triggerId: string | null;
+        source: string;
+        status: string;
+        triggeredAt: Date;
+        idempotencyKey: string | null;
+        triggerPayload: Record<string, unknown> | null;
+        dispatchFingerprint: string | null;
+        linkedIssueId: string | null;
+        coalescedIntoRunId: string | null;
+        failureReason: string | null;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    listRuns: (routineId: string, limit?: number) => Promise<RoutineRunSummary[]>;
+    tickScheduledTriggers: (now?: Date) => Promise<{
+        triggered: number;
+    }>;
+    syncRunStatusForIssue: (issueId: string) => Promise<{
+        id: string;
+        companyId: string;
+        routineId: string;
+        triggerId: string | null;
+        source: string;
+        status: string;
+        triggeredAt: Date;
+        idempotencyKey: string | null;
+        triggerPayload: Record<string, unknown> | null;
+        dispatchFingerprint: string | null;
+        linkedIssueId: string | null;
+        coalescedIntoRunId: string | null;
+        failureReason: string | null;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+};
+export {};
+//# sourceMappingURL=routines.d.ts.map

package/dist/services/routines.d.ts.map

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