patchrelay 0.30.1 → 0.32.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.30.1",
-  "commit": "dee1d8b522b1",
-  "builtAt": "2026-04-01T08:31:08.208Z"
+  "version": "0.32.0",
+  "commit": "21ba6968b0ff",
+  "builtAt": "2026-04-01T11:53:53.815Z"
 }

package/dist/cli/watch/IssueDetailView.js

@@ -44,5 +44,5 @@ export function IssueDetailView({ issue, timeline, follow, activeRunStartedAt, a
     const history = useMemo(() => buildStateHistory(rawRuns, rawFeedEvents, issue.factoryState, activeRunId), [rawRuns, rawFeedEvents, issue.factoryState, activeRunId]);
     const graph = useMemo(() => buildPatchRelayStateGraph(history, issue.factoryState), [history, issue.factoryState]);
     const queueObservations = useMemo(() => buildPatchRelayQueueObservations(issue, rawFeedEvents), [issue, rawFeedEvents]);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { bold: true, children: key }), _jsx(Text, { color: "cyan", children: issue.factoryState }), issue.blockedByCount > 0 && _jsxs(Text, { color: "yellow", children: ["blocked by ", issue.blockedByKeys.join(", ")] }), issue.readyForExecution && !issue.activeRunType && issue.blockedByCount === 0 && _jsx(Text, { color: "blueBright", children: "ready" }), issue.activeRunType && _jsx(Text, { color: "yellow", children: issue.activeRunType }), issue.prNumber !== undefined && _jsxs(Text, { dimColor: true, children: ["#", issue.prNumber] }), activeRunStartedAt && _jsx(ElapsedTime, { startedAt: activeRunStartedAt }), meta.length > 0 && _jsx(Text, { dimColor: true, children: meta.join("  ") }), detailTab === "timeline" && _jsx(Text, { dimColor: true, children: timelineMode }), follow && _jsx(Text, { color: "yellow", children: "follow" }), _jsx(FreshnessBadge, { connected: connected, lastServerMessageAt: lastServerMessageAt })] }), issue.title && _jsx(Text, { children: issue.title }), detailTab === "timeline" ? (_jsxs(_Fragment, { children: [plan && plan.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "Plan" }), _jsx(Text, { children: progressBar(plan.filter((s) => s.status === "completed").length, plan.length, 16) }), _jsxs(Text, { dimColor: true, children: [plan.filter((s) => s.status === "completed").length, "/", plan.length] })] }), plan.map((entry, i) => (_jsxs(Box, { gap: 1, children: [_jsxs(Text, { color: planStepColor(entry.status), children: ["[", planStepSymbol(entry.status), "]"] }), _jsx(Text, { children: entry.step })] }, `plan-${i}`)))] })), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Timeline, { entries: timeline, follow: follow, mode: timelineMode }) })] })) : (_jsxs(_Fragment, { children: [_jsx(FactoryStateGraph, { main: graph.main, prLoops: graph.prLoops, queueLoop: graph.queueLoop, exits: graph.exits }), _jsx(QueueObservationView, { observations: queueObservations }), _jsx(Box, { marginTop: 1, children: _jsx(StateHistoryView, { history: history, plan: plan, activeRunId: activeRunId }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(HelpBar, { view: "detail", follow: follow, detailTab: detailTab, timelineMode: timelineMode }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { bold: true, children: key }), _jsx(Text, { color: "cyan", children: issue.factoryState }), issue.blockedByCount > 0 && _jsxs(Text, { color: "yellow", children: ["blocked by ", issue.blockedByKeys.join(", ")] }), issue.readyForExecution && !issue.activeRunType && issue.blockedByCount === 0 && _jsx(Text, { color: "blueBright", children: "ready" }), issue.activeRunType && _jsx(Text, { color: "yellow", children: issue.activeRunType }), issue.prNumber !== undefined && _jsxs(Text, { dimColor: true, children: ["#", issue.prNumber] }), activeRunStartedAt && _jsx(ElapsedTime, { startedAt: activeRunStartedAt }), meta.length > 0 && _jsx(Text, { dimColor: true, children: meta.join("  ") }), detailTab === "timeline" && _jsx(Text, { dimColor: true, children: timelineMode }), follow && _jsx(Text, { color: "yellow", children: "follow" }), _jsx(FreshnessBadge, { connected: connected, lastServerMessageAt: lastServerMessageAt })] }), issue.title && _jsx(Text, { children: issue.title }), issueContext?.latestFailureSummary && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: issueContext.latestFailureSource === "queue_eviction" ? "yellow" : "red", children: ["Latest failure: ", issueContext.latestFailureSummary, issueContext.latestFailureHeadSha ? ` @ ${issueContext.latestFailureHeadSha.slice(0, 8)}` : ""] }) })), detailTab === "timeline" ? (_jsxs(_Fragment, { children: [plan && plan.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: "Plan" }), _jsx(Text, { children: progressBar(plan.filter((s) => s.status === "completed").length, plan.length, 16) }), _jsxs(Text, { dimColor: true, children: [plan.filter((s) => s.status === "completed").length, "/", plan.length] })] }), plan.map((entry, i) => (_jsxs(Box, { gap: 1, children: [_jsxs(Text, { color: planStepColor(entry.status), children: ["[", planStepSymbol(entry.status), "]"] }), _jsx(Text, { children: entry.step })] }, `plan-${i}`)))] })), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Timeline, { entries: timeline, follow: follow, mode: timelineMode }) })] })) : (_jsxs(_Fragment, { children: [_jsx(FactoryStateGraph, { main: graph.main, prLoops: graph.prLoops, queueLoop: graph.queueLoop, exits: graph.exits }), _jsx(QueueObservationView, { observations: queueObservations }), _jsx(Box, { marginTop: 1, children: _jsx(StateHistoryView, { history: history, plan: plan, activeRunId: activeRunId }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(HelpBar, { view: "detail", follow: follow, detailTab: detailTab, timelineMode: timelineMode }) })] }));
 }

package/dist/cli/watch/use-detail-stream.js

@@ -54,6 +54,11 @@ async function rehydrate(baseUrl, issueKey, headers, signal, dispatch) {
                 ciRepairAttempts: typeof i.ciRepairAttempts === "number" ? i.ciRepairAttempts : 0,
                 queueRepairAttempts: typeof i.queueRepairAttempts === "number" ? i.queueRepairAttempts : 0,
                 reviewFixAttempts: typeof i.reviewFixAttempts === "number" ? i.reviewFixAttempts : 0,
+                latestFailureSource: typeof i.latestFailureSource === "string" ? i.latestFailureSource : undefined,
+                latestFailureHeadSha: typeof i.latestFailureHeadSha === "string" ? i.latestFailureHeadSha : undefined,
+                latestFailureCheckName: typeof i.latestFailureCheckName === "string" ? i.latestFailureCheckName : undefined,
+                latestFailureStepName: typeof i.latestFailureStepName === "string" ? i.latestFailureStepName : undefined,
+                latestFailureSummary: typeof i.latestFailureSummary === "string" ? i.latestFailureSummary : undefined,
                 runCount: runs.length,
             };
         }

package/dist/cli/watch/watch-state.js

@@ -171,6 +171,20 @@ function applyFeedEvent(state, event, receivedAt) {
         if (event.status === "check_passed" || event.status === "check_failed") {
             issue.prCheckStatus = event.status === "check_passed" ? "passed" : "failed";
         }
+        if (event.status === "ci_repair_queued") {
+            issue.factoryState = "repairing_ci";
+            issue.statusNote = event.detail ?? event.summary;
+        }
+        if (event.status === "queue_repair_queued") {
+            issue.factoryState = "repairing_queue";
+            issue.statusNote = event.detail ?? event.summary;
+        }
+        if (event.status === "repair_deduped" || event.status === "branch_not_advanced") {
+            issue.statusNote = event.summary;
+        }
+    }
+    if ((event.kind === "turn" || event.kind === "github") && event.status === "branch_not_advanced") {
+        issue.statusNote = event.summary;
     }
     issue.updatedAt = event.at;
     updated[index] = issue;

package/dist/db/migrations.js

@@ -198,11 +198,21 @@ export function runPatchRelayMigrations(connection) {
     // Preserve GitHub failure provenance so reconciliation can distinguish
     // branch CI failures from merge-queue evictions after webhook delivery.
     addColumnIfMissing(connection, "issues", "last_github_failure_source", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_failure_head_sha", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_failure_signature", "TEXT");
     addColumnIfMissing(connection, "issues", "last_github_failure_check_name", "TEXT");
     addColumnIfMissing(connection, "issues", "last_github_failure_check_url", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_failure_context_json", "TEXT");
     addColumnIfMissing(connection, "issues", "last_github_failure_at", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_ci_snapshot_head_sha", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_ci_snapshot_gate_check_name", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_ci_snapshot_gate_check_status", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_ci_snapshot_json", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_github_ci_snapshot_settled_at", "TEXT");
     addColumnIfMissing(connection, "issues", "last_queue_signal_at", "TEXT");
     addColumnIfMissing(connection, "issues", "last_queue_incident_json", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_attempted_failure_head_sha", "TEXT");
+    addColumnIfMissing(connection, "issues", "last_attempted_failure_signature", "TEXT");
 }
 function addColumnIfMissing(connection, table, column, definition) {
     const cols = connection.prepare(`PRAGMA table_info(${table})`).all();

package/dist/db.js

@@ -1,3 +1,4 @@
+import { parseGitHubFailureContext } from "./github-failure-context.js";
 import { LinearInstallationStore } from "./db/linear-installation-store.js";
 import { OperatorFeedStore } from "./db/operator-feed-store.js";
 import { RepositoryLinkStore } from "./db/repository-link-store.js";
@@ -164,6 +165,14 @@ export class PatchRelayDatabase {
                 sets.push("last_github_failure_source = @lastGitHubFailureSource");
                 values.lastGitHubFailureSource = params.lastGitHubFailureSource;
             }
+            if (params.lastGitHubFailureHeadSha !== undefined) {
+                sets.push("last_github_failure_head_sha = @lastGitHubFailureHeadSha");
+                values.lastGitHubFailureHeadSha = params.lastGitHubFailureHeadSha;
+            }
+            if (params.lastGitHubFailureSignature !== undefined) {
+                sets.push("last_github_failure_signature = @lastGitHubFailureSignature");
+                values.lastGitHubFailureSignature = params.lastGitHubFailureSignature;
+            }
             if (params.lastGitHubFailureCheckName !== undefined) {
                 sets.push("last_github_failure_check_name = @lastGitHubFailureCheckName");
                 values.lastGitHubFailureCheckName = params.lastGitHubFailureCheckName;
@@ -172,10 +181,34 @@ export class PatchRelayDatabase {
                 sets.push("last_github_failure_check_url = @lastGitHubFailureCheckUrl");
                 values.lastGitHubFailureCheckUrl = params.lastGitHubFailureCheckUrl;
             }
+            if (params.lastGitHubFailureContextJson !== undefined) {
+                sets.push("last_github_failure_context_json = @lastGitHubFailureContextJson");
+                values.lastGitHubFailureContextJson = params.lastGitHubFailureContextJson;
+            }
             if (params.lastGitHubFailureAt !== undefined) {
                 sets.push("last_github_failure_at = @lastGitHubFailureAt");
                 values.lastGitHubFailureAt = params.lastGitHubFailureAt;
             }
+            if (params.lastGitHubCiSnapshotHeadSha !== undefined) {
+                sets.push("last_github_ci_snapshot_head_sha = @lastGitHubCiSnapshotHeadSha");
+                values.lastGitHubCiSnapshotHeadSha = params.lastGitHubCiSnapshotHeadSha;
+            }
+            if (params.lastGitHubCiSnapshotGateCheckName !== undefined) {
+                sets.push("last_github_ci_snapshot_gate_check_name = @lastGitHubCiSnapshotGateCheckName");
+                values.lastGitHubCiSnapshotGateCheckName = params.lastGitHubCiSnapshotGateCheckName;
+            }
+            if (params.lastGitHubCiSnapshotGateCheckStatus !== undefined) {
+                sets.push("last_github_ci_snapshot_gate_check_status = @lastGitHubCiSnapshotGateCheckStatus");
+                values.lastGitHubCiSnapshotGateCheckStatus = params.lastGitHubCiSnapshotGateCheckStatus;
+            }
+            if (params.lastGitHubCiSnapshotJson !== undefined) {
+                sets.push("last_github_ci_snapshot_json = @lastGitHubCiSnapshotJson");
+                values.lastGitHubCiSnapshotJson = params.lastGitHubCiSnapshotJson;
+            }
+            if (params.lastGitHubCiSnapshotSettledAt !== undefined) {
+                sets.push("last_github_ci_snapshot_settled_at = @lastGitHubCiSnapshotSettledAt");
+                values.lastGitHubCiSnapshotSettledAt = params.lastGitHubCiSnapshotSettledAt;
+            }
             if (params.lastQueueSignalAt !== undefined) {
                 sets.push("last_queue_signal_at = @lastQueueSignalAt");
                 values.lastQueueSignalAt = params.lastQueueSignalAt;
@@ -184,6 +217,14 @@ export class PatchRelayDatabase {
                 sets.push("last_queue_incident_json = @lastQueueIncidentJson");
                 values.lastQueueIncidentJson = params.lastQueueIncidentJson;
             }
+            if (params.lastAttemptedFailureHeadSha !== undefined) {
+                sets.push("last_attempted_failure_head_sha = @lastAttemptedFailureHeadSha");
+                values.lastAttemptedFailureHeadSha = params.lastAttemptedFailureHeadSha;
+            }
+            if (params.lastAttemptedFailureSignature !== undefined) {
+                sets.push("last_attempted_failure_signature = @lastAttemptedFailureSignature");
+                values.lastAttemptedFailureSignature = params.lastAttemptedFailureSignature;
+            }
             if (params.ciRepairAttempts !== undefined) {
                 sets.push("ci_repair_attempts = @ciRepairAttempts");
                 values.ciRepairAttempts = params.ciRepairAttempts;
@@ -215,7 +256,10 @@ export class PatchRelayDatabase {
           branch_name, worktree_path, thread_id, active_run_id,
           agent_session_id,
           pr_number, pr_url, pr_state, pr_review_state, pr_check_status,
-          last_github_failure_source, last_github_failure_check_name, last_github_failure_check_url, last_github_failure_at, last_queue_signal_at, last_queue_incident_json,
+          last_github_failure_source, last_github_failure_head_sha, last_github_failure_signature, last_github_failure_check_name, last_github_failure_check_url, last_github_failure_context_json, last_github_failure_at,
+          last_github_ci_snapshot_head_sha, last_github_ci_snapshot_gate_check_name, last_github_ci_snapshot_gate_check_status, last_github_ci_snapshot_json, last_github_ci_snapshot_settled_at,
+          last_queue_signal_at, last_queue_incident_json,
+          last_attempted_failure_head_sha, last_attempted_failure_signature,
           updated_at
         ) VALUES (
           @projectId, @linearIssueId, @issueKey, @title, @description, @url,
@@ -224,7 +268,10 @@ export class PatchRelayDatabase {
           @branchName, @worktreePath, @threadId, @activeRunId,
           @agentSessionId,
           @prNumber, @prUrl, @prState, @prReviewState, @prCheckStatus,
-          @lastGitHubFailureSource, @lastGitHubFailureCheckName, @lastGitHubFailureCheckUrl, @lastGitHubFailureAt, @lastQueueSignalAt, @lastQueueIncidentJson,
+          @lastGitHubFailureSource, @lastGitHubFailureHeadSha, @lastGitHubFailureSignature, @lastGitHubFailureCheckName, @lastGitHubFailureCheckUrl, @lastGitHubFailureContextJson, @lastGitHubFailureAt,
+          @lastGitHubCiSnapshotHeadSha, @lastGitHubCiSnapshotGateCheckName, @lastGitHubCiSnapshotGateCheckStatus, @lastGitHubCiSnapshotJson, @lastGitHubCiSnapshotSettledAt,
+          @lastQueueSignalAt, @lastQueueIncidentJson,
+          @lastAttemptedFailureHeadSha, @lastAttemptedFailureSignature,
           @now
         )
       `).run({
@@ -252,11 +299,21 @@ export class PatchRelayDatabase {
                 prReviewState: params.prReviewState ?? null,
                 prCheckStatus: params.prCheckStatus ?? null,
                 lastGitHubFailureSource: params.lastGitHubFailureSource ?? null,
+                lastGitHubFailureHeadSha: params.lastGitHubFailureHeadSha ?? null,
+                lastGitHubFailureSignature: params.lastGitHubFailureSignature ?? null,
                 lastGitHubFailureCheckName: params.lastGitHubFailureCheckName ?? null,
                 lastGitHubFailureCheckUrl: params.lastGitHubFailureCheckUrl ?? null,
+                lastGitHubFailureContextJson: params.lastGitHubFailureContextJson ?? null,
                 lastGitHubFailureAt: params.lastGitHubFailureAt ?? null,
+                lastGitHubCiSnapshotHeadSha: params.lastGitHubCiSnapshotHeadSha ?? null,
+                lastGitHubCiSnapshotGateCheckName: params.lastGitHubCiSnapshotGateCheckName ?? null,
+                lastGitHubCiSnapshotGateCheckStatus: params.lastGitHubCiSnapshotGateCheckStatus ?? null,
+                lastGitHubCiSnapshotJson: params.lastGitHubCiSnapshotJson ?? null,
+                lastGitHubCiSnapshotSettledAt: params.lastGitHubCiSnapshotSettledAt ?? null,
                 lastQueueSignalAt: params.lastQueueSignalAt ?? null,
                 lastQueueIncidentJson: params.lastQueueIncidentJson ?? null,
+                lastAttemptedFailureHeadSha: params.lastAttemptedFailureHeadSha ?? null,
+                lastAttemptedFailureSignature: params.lastAttemptedFailureSignature ?? null,
                 now,
             });
         }
@@ -353,6 +410,17 @@ export class PatchRelayDatabase {
             linearIssueId: String(row.linear_issue_id),
         }));
     }
+    getLatestGitHubCiSnapshot(projectId, linearIssueId) {
+        const issue = this.getIssue(projectId, linearIssueId);
+        if (!issue?.lastGitHubCiSnapshotJson)
+            return undefined;
+        try {
+            return JSON.parse(issue.lastGitHubCiSnapshotJson);
+        }
+        catch {
+            return undefined;
+        }
+    }
     countUnresolvedBlockers(projectId, linearIssueId) {
         const row = this.connection.prepare(`
       SELECT COUNT(*) AS count
@@ -508,6 +576,7 @@ export class PatchRelayDatabase {
     issueToTrackedIssue(issue) {
         const blockedBy = this.listIssueDependencies(issue.projectId, issue.linearIssueId);
         const unresolvedBlockedBy = blockedBy.filter((entry) => !isResolvedLinearState(entry.blockerCurrentLinearStateType, entry.blockerCurrentLinearState));
+        const failureContext = parseGitHubFailureContext(issue.lastGitHubFailureContextJson);
         return {
             id: issue.id,
             projectId: issue.projectId,
@@ -521,6 +590,11 @@ export class PatchRelayDatabase {
             blockedByKeys: unresolvedBlockedBy
                 .map((entry) => entry.blockerIssueKey ?? entry.blockerLinearIssueId),
             readyForExecution: issue.pendingRunType !== undefined && issue.activeRunId === undefined && unresolvedBlockedBy.length === 0,
+            ...(issue.lastGitHubFailureSource ? { latestFailureSource: issue.lastGitHubFailureSource } : {}),
+            ...(issue.lastGitHubFailureHeadSha ? { latestFailureHeadSha: issue.lastGitHubFailureHeadSha } : {}),
+            ...(issue.lastGitHubFailureCheckName ? { latestFailureCheckName: issue.lastGitHubFailureCheckName } : {}),
+            ...(failureContext?.stepName ? { latestFailureStepName: failureContext.stepName } : {}),
+            ...(failureContext?.summary ? { latestFailureSummary: failureContext.summary } : {}),
             ...(issue.activeRunId !== undefined ? { activeRunId: issue.activeRunId } : {}),
             ...(issue.agentSessionId ? { activeAgentSessionId: issue.agentSessionId } : {}),
             updatedAt: issue.updatedAt,
@@ -580,21 +654,51 @@ function mapIssueRow(row) {
         ...(row.last_github_failure_source !== null && row.last_github_failure_source !== undefined
             ? { lastGitHubFailureSource: String(row.last_github_failure_source) }
             : {}),
+        ...(row.last_github_failure_head_sha !== null && row.last_github_failure_head_sha !== undefined
+            ? { lastGitHubFailureHeadSha: String(row.last_github_failure_head_sha) }
+            : {}),
+        ...(row.last_github_failure_signature !== null && row.last_github_failure_signature !== undefined
+            ? { lastGitHubFailureSignature: String(row.last_github_failure_signature) }
+            : {}),
         ...(row.last_github_failure_check_name !== null && row.last_github_failure_check_name !== undefined
             ? { lastGitHubFailureCheckName: String(row.last_github_failure_check_name) }
             : {}),
         ...(row.last_github_failure_check_url !== null && row.last_github_failure_check_url !== undefined
             ? { lastGitHubFailureCheckUrl: String(row.last_github_failure_check_url) }
             : {}),
+        ...(row.last_github_failure_context_json !== null && row.last_github_failure_context_json !== undefined
+            ? { lastGitHubFailureContextJson: String(row.last_github_failure_context_json) }
+            : {}),
         ...(row.last_github_failure_at !== null && row.last_github_failure_at !== undefined
             ? { lastGitHubFailureAt: String(row.last_github_failure_at) }
             : {}),
+        ...(row.last_github_ci_snapshot_head_sha !== null && row.last_github_ci_snapshot_head_sha !== undefined
+            ? { lastGitHubCiSnapshotHeadSha: String(row.last_github_ci_snapshot_head_sha) }
+            : {}),
+        ...(row.last_github_ci_snapshot_gate_check_name !== null && row.last_github_ci_snapshot_gate_check_name !== undefined
+            ? { lastGitHubCiSnapshotGateCheckName: String(row.last_github_ci_snapshot_gate_check_name) }
+            : {}),
+        ...(row.last_github_ci_snapshot_gate_check_status !== null && row.last_github_ci_snapshot_gate_check_status !== undefined
+            ? { lastGitHubCiSnapshotGateCheckStatus: String(row.last_github_ci_snapshot_gate_check_status) }
+            : {}),
+        ...(row.last_github_ci_snapshot_json !== null && row.last_github_ci_snapshot_json !== undefined
+            ? { lastGitHubCiSnapshotJson: String(row.last_github_ci_snapshot_json) }
+            : {}),
+        ...(row.last_github_ci_snapshot_settled_at !== null && row.last_github_ci_snapshot_settled_at !== undefined
+            ? { lastGitHubCiSnapshotSettledAt: String(row.last_github_ci_snapshot_settled_at) }
+            : {}),
         ...(row.last_queue_signal_at !== null && row.last_queue_signal_at !== undefined
             ? { lastQueueSignalAt: String(row.last_queue_signal_at) }
             : {}),
         ...(row.last_queue_incident_json !== null && row.last_queue_incident_json !== undefined
             ? { lastQueueIncidentJson: String(row.last_queue_incident_json) }
             : {}),
+        ...(row.last_attempted_failure_head_sha !== null && row.last_attempted_failure_head_sha !== undefined
+            ? { lastAttemptedFailureHeadSha: String(row.last_attempted_failure_head_sha) }
+            : {}),
+        ...(row.last_attempted_failure_signature !== null && row.last_attempted_failure_signature !== undefined
+            ? { lastAttemptedFailureSignature: String(row.last_attempted_failure_signature) }
+            : {}),
         ciRepairAttempts: Number(row.ci_repair_attempts ?? 0),
         queueRepairAttempts: Number(row.queue_repair_attempts ?? 0),
         reviewFixAttempts: Number(row.review_fix_attempts ?? 0),

package/dist/github-failure-context.js

@@ -0,0 +1,298 @@
+import { execCommand, safeJsonParse, sanitizeDiagnosticText } from "./utils.js";
+const FAILED_CONCLUSIONS = new Set([
+    "failure",
+    "timed_out",
+    "cancelled",
+    "startup_failure",
+    "action_required",
+    "stale",
+]);
+export function createGitHubFailureContextResolver() {
+    return {
+        resolve: async ({ source, repoFullName, event }) => {
+            if (!repoFullName)
+                return undefined;
+            if (source === "queue_eviction") {
+                const queueContext = buildFallbackFailureContext(source, repoFullName, event);
+                return {
+                    ...queueContext,
+                    failureSignature: buildFailureSignature({
+                        source,
+                        headSha: queueContext.headSha,
+                        checkName: queueContext.checkName,
+                    }),
+                };
+            }
+            const fallback = buildFallbackFailureContext(source, repoFullName, event);
+            try {
+                const failedCheck = await resolveFailedCheckRun(repoFullName, event);
+                const workflowRunId = parseWorkflowRunId(failedCheck?.detailsUrl ?? failedCheck?.htmlUrl ?? event.checkDetailsUrl ?? event.checkUrl);
+                const workflowJob = workflowRunId
+                    ? await resolveWorkflowJob(repoFullName, workflowRunId, failedCheck?.name ?? event.checkName)
+                    : undefined;
+                const annotations = failedCheck?.id
+                    ? await resolveAnnotations(repoFullName, failedCheck.id)
+                    : undefined;
+                const summary = firstNonEmpty(annotations?.[0], failedCheck?.outputTitle, failedCheck?.outputSummary, event.checkOutputTitle, event.checkOutputSummary, workflowJob?.stepName ? `Failed step: ${workflowJob.stepName}` : undefined);
+                const checkName = firstNonEmpty(failedCheck?.name, event.checkName);
+                const checkUrl = firstNonEmpty(failedCheck?.htmlUrl, event.checkUrl);
+                const checkDetailsUrl = firstNonEmpty(failedCheck?.detailsUrl, event.checkDetailsUrl);
+                const jobName = firstNonEmpty(workflowJob?.name, failedCheck?.name, event.checkName);
+                const stepName = workflowJob?.stepName;
+                return {
+                    source,
+                    repoFullName,
+                    capturedAt: new Date().toISOString(),
+                    ...(event.headSha ? { headSha: event.headSha } : {}),
+                    ...(checkName ? { checkName } : {}),
+                    ...(checkUrl ? { checkUrl } : {}),
+                    ...(checkDetailsUrl ? { checkDetailsUrl } : {}),
+                    ...(workflowRunId !== undefined ? { workflowRunId } : {}),
+                    ...(jobName ? { jobName } : {}),
+                    ...(stepName ? { stepName } : {}),
+                    ...(summary ? { summary } : {}),
+                    ...(annotations && annotations.length > 0 ? { annotations } : {}),
+                    failureSignature: buildFailureSignature({
+                        source,
+                        headSha: event.headSha,
+                        checkName,
+                        jobName,
+                        stepName,
+                    }),
+                };
+            }
+            catch {
+                return {
+                    ...fallback,
+                    failureSignature: buildFailureSignature({
+                        source,
+                        headSha: fallback.headSha,
+                        checkName: fallback.checkName,
+                        stepName: fallback.stepName,
+                    }),
+                };
+            }
+        },
+    };
+}
+export function createGitHubCiSnapshotResolver() {
+    return {
+        resolve: async ({ repoFullName, event, gateCheckNames }) => {
+            if (!repoFullName || !event.headSha)
+                return undefined;
+            try {
+                const checks = await resolveCheckSnapshotChecks(repoFullName, event.headSha);
+                return buildCiSnapshotFromChecks(checks, event, gateCheckNames);
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+export function parseGitHubFailureContext(value) {
+    if (!value)
+        return undefined;
+    return safeJsonParse(value);
+}
+export function summarizeGitHubFailureContext(context) {
+    if (!context)
+        return undefined;
+    if (context.source === "queue_eviction") {
+        return firstNonEmpty(context.summary, context.checkName, "Queue eviction");
+    }
+    const lead = firstNonEmpty(context.jobName, context.checkName);
+    const step = context.stepName ? `${lead ?? "CI"} -> ${context.stepName}` : lead;
+    return firstNonEmpty(step && context.summary ? `${step}: ${context.summary}` : undefined, step, context.summary);
+}
+function buildFallbackFailureContext(source, repoFullName, event) {
+    const summary = firstNonEmpty(event.checkOutputTitle, event.checkOutputSummary, event.checkOutputText ? sanitizeDiagnosticText(event.checkOutputText, 240) : undefined);
+    return {
+        source,
+        repoFullName,
+        capturedAt: new Date().toISOString(),
+        ...(event.headSha ? { headSha: event.headSha } : {}),
+        ...(event.checkName ? { checkName: event.checkName } : {}),
+        ...(event.checkUrl ? { checkUrl: event.checkUrl } : {}),
+        ...(event.checkDetailsUrl ? { checkDetailsUrl: event.checkDetailsUrl } : {}),
+        ...(event.checkName ? { jobName: event.checkName } : {}),
+        ...(summary ? { summary } : {}),
+    };
+}
+async function resolveFailedCheckRun(repoFullName, event) {
+    if (!event.headSha)
+        return undefined;
+    const response = await execCommand("gh", [
+        "api",
+        `repos/${repoFullName}/commits/${event.headSha}/check-runs`,
+        "--method", "GET",
+    ], { timeoutMs: 15_000 });
+    if (response.exitCode !== 0) {
+        throw new Error(response.stderr || "gh api check-runs failed");
+    }
+    const payload = safeJsonParse(response.stdout);
+    const checks = (payload?.check_runs ?? [])
+        .map(mapCheckRunSummary)
+        .filter((entry) => entry.conclusion && FAILED_CONCLUSIONS.has(entry.conclusion.toLowerCase()));
+    return checks.find((entry) => entry.name === event.checkName)
+        ?? checks.find((entry) => entry.name && event.checkName && entry.name.includes(event.checkName))
+        ?? checks[0];
+}
+async function resolveCheckSnapshotChecks(repoFullName, headSha) {
+    const response = await execCommand("gh", [
+        "api",
+        `repos/${repoFullName}/commits/${headSha}/check-runs`,
+        "--method", "GET",
+    ], { timeoutMs: 15_000 });
+    if (response.exitCode !== 0) {
+        throw new Error(response.stderr || "gh api check-runs failed");
+    }
+    const payload = safeJsonParse(response.stdout);
+    return (payload?.check_runs ?? []).map(mapCiSnapshotCheck).filter((entry) => Boolean(entry));
+}
+async function resolveWorkflowJob(repoFullName, workflowRunId, preferredName) {
+    const response = await execCommand("gh", [
+        "api",
+        `repos/${repoFullName}/actions/runs/${workflowRunId}/jobs`,
+        "--method", "GET",
+    ], { timeoutMs: 15_000 });
+    if (response.exitCode !== 0) {
+        throw new Error(response.stderr || "gh api workflow jobs failed");
+    }
+    const payload = safeJsonParse(response.stdout);
+    const jobs = (payload?.jobs ?? []).map(mapWorkflowJobSummary);
+    return jobs.find((entry) => entry.name === preferredName)
+        ?? jobs.find((entry) => entry.name && preferredName && entry.name.includes(preferredName))
+        ?? jobs.find((entry) => entry.conclusion && FAILED_CONCLUSIONS.has(entry.conclusion.toLowerCase()))
+        ?? jobs[0];
+}
+async function resolveAnnotations(repoFullName, checkRunId) {
+    const response = await execCommand("gh", [
+        "api",
+        `repos/${repoFullName}/check-runs/${checkRunId}/annotations`,
+        "--method", "GET",
+        "-F", "per_page=20",
+    ], { timeoutMs: 15_000 });
+    if (response.exitCode !== 0) {
+        throw new Error(response.stderr || "gh api annotations failed");
+    }
+    const payload = safeJsonParse(response.stdout) ?? [];
+    return payload
+        .map((entry) => {
+        const title = typeof entry.title === "string" ? entry.title.trim() : "";
+        const message = typeof entry.message === "string" ? entry.message.trim() : "";
+        const path = typeof entry.path === "string" ? entry.path.trim() : "";
+        const rendered = [title, message, path ? `(${path})` : ""].filter(Boolean).join(": ");
+        return rendered ? sanitizeDiagnosticText(rendered, 240) : undefined;
+    })
+        .filter((entry) => Boolean(entry));
+}
+function mapCheckRunSummary(row) {
+    const output = row.output && typeof row.output === "object" ? row.output : undefined;
+    return {
+        ...(typeof row.id === "number" ? { id: row.id } : {}),
+        ...(typeof row.name === "string" ? { name: row.name } : {}),
+        ...(typeof row.html_url === "string" ? { htmlUrl: row.html_url } : {}),
+        ...(typeof row.details_url === "string" ? { detailsUrl: row.details_url } : {}),
+        ...(typeof row.conclusion === "string" ? { conclusion: row.conclusion } : {}),
+        ...(typeof output?.title === "string" ? { outputTitle: output.title } : {}),
+        ...(typeof output?.summary === "string" ? { outputSummary: sanitizeDiagnosticText(output.summary, 240) } : {}),
+        ...(typeof output?.text === "string" ? { outputText: sanitizeDiagnosticText(output.text, 240) } : {}),
+    };
+}
+function mapCiSnapshotCheck(row) {
+    if (typeof row.name !== "string" || !row.name.trim())
+        return undefined;
+    const output = row.output && typeof row.output === "object" ? row.output : undefined;
+    const status = deriveCheckStatus({
+        apiStatus: typeof row.status === "string" ? row.status : undefined,
+        apiConclusion: typeof row.conclusion === "string" ? row.conclusion : undefined,
+    });
+    return {
+        name: row.name.trim(),
+        status,
+        ...(typeof row.conclusion === "string" && row.conclusion.trim() ? { conclusion: row.conclusion.trim().toLowerCase() } : {}),
+        ...(typeof row.details_url === "string" && row.details_url.trim() ? { detailsUrl: row.details_url.trim() } : {}),
+        ...(firstNonEmpty(typeof output?.title === "string" ? output.title : undefined, typeof output?.summary === "string" ? sanitizeDiagnosticText(output.summary, 240) : undefined) ? { summary: firstNonEmpty(typeof output?.title === "string" ? output.title : undefined, typeof output?.summary === "string" ? sanitizeDiagnosticText(output.summary, 240) : undefined) } : {}),
+    };
+}
+function mapWorkflowJobSummary(row) {
+    const steps = Array.isArray(row.steps) ? row.steps.filter((entry) => Boolean(entry) && typeof entry === "object") : [];
+    const failedStep = steps.find((entry) => {
+        const conclusion = typeof entry.conclusion === "string" ? entry.conclusion.toLowerCase() : "";
+        return FAILED_CONCLUSIONS.has(conclusion);
+    });
+    const informativeStep = failedStep ?? steps.findLast((entry) => typeof entry.name === "string");
+    return {
+        ...(typeof row.name === "string" ? { name: row.name } : {}),
+        ...(typeof row.conclusion === "string" ? { conclusion: row.conclusion } : {}),
+        ...(typeof informativeStep?.name === "string" ? { stepName: informativeStep.name } : {}),
+    };
+}
+function parseWorkflowRunId(url) {
+    if (!url)
+        return undefined;
+    const match = url.match(/\/actions\/runs\/(\d+)/);
+    return match ? Number(match[1]) : undefined;
+}
+function buildCiSnapshotFromChecks(checks, event, gateCheckNames) {
+    const gateCheck = findGateCheck(checks, gateCheckNames, event.checkName);
+    const gateCheckName = gateCheck?.name ?? pickGateCheckName(gateCheckNames, event.checkName) ?? event.checkName;
+    const gateCheckStatus = gateCheck?.status ?? deriveCheckStatus({
+        eventStatus: event.checkStatus,
+        eventConclusion: event.triggerEvent === "check_passed" ? "success" : "failure",
+    });
+    const failedChecks = checks.filter((entry) => entry.status === "failure");
+    return {
+        headSha: event.headSha,
+        ...(gateCheckName ? { gateCheckName } : {}),
+        gateCheckStatus,
+        failedChecks,
+        checks,
+        ...(gateCheckStatus !== "pending" ? { settledAt: new Date().toISOString() } : {}),
+        capturedAt: new Date().toISOString(),
+    };
+}
+function findGateCheck(checks, gateCheckNames, fallbackCheckName) {
+    const exactNames = gateCheckNames.map((entry) => entry.trim().toLowerCase()).filter(Boolean);
+    if (exactNames.length > 0) {
+        const exact = checks.find((entry) => exactNames.includes(entry.name.trim().toLowerCase()));
+        if (exact)
+            return exact;
+    }
+    if (!fallbackCheckName)
+        return undefined;
+    const fallback = fallbackCheckName.trim().toLowerCase();
+    return checks.find((entry) => entry.name.trim().toLowerCase() === fallback);
+}
+function pickGateCheckName(gateCheckNames, fallbackCheckName) {
+    return gateCheckNames.find((entry) => entry.trim().length > 0)?.trim()
+        ?? fallbackCheckName?.trim();
+}
+function deriveCheckStatus(params) {
+    const status = params.apiStatus?.trim().toLowerCase();
+    if (status === "queued" || status === "in_progress" || status === "requested" || status === "waiting" || status === "pending") {
+        return "pending";
+    }
+    const conclusion = params.apiConclusion?.trim().toLowerCase()
+        ?? params.eventConclusion?.trim().toLowerCase()
+        ?? params.eventStatus?.trim().toLowerCase();
+    if (conclusion === "success" || conclusion === "neutral" || conclusion === "skipped") {
+        return "success";
+    }
+    if (conclusion && FAILED_CONCLUSIONS.has(conclusion)) {
+        return "failure";
+    }
+    return status === "completed" ? "failure" : "pending";
+}
+function buildFailureSignature(parts) {
+    return [
+        parts.source,
+        parts.headSha ?? "unknown-sha",
+        parts.jobName ?? parts.checkName ?? "unknown-check",
+        parts.stepName ?? "unknown-step",
+    ].join("::");
+}
+function firstNonEmpty(...values) {
+    return values.find((value) => typeof value === "string" && value.trim().length > 0)?.trim();
+}