patchrelay 0.30.0 → 0.31.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.30.0",
-  "commit": "88eca79d5f8d",
-  "builtAt": "2026-04-01T02:27:09.365Z"
+  "version": "0.31.0",
+  "commit": "5de73a74995a",
+  "builtAt": "2026-04-01T09:38:32.968Z"
 }

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

@@ -7,6 +7,7 @@ CREATE TABLE IF NOT EXISTS issues (
   title TEXT,
   url TEXT,
   current_linear_state TEXT,
+  current_linear_state_type TEXT,
   factory_state TEXT NOT NULL DEFAULT 'delegated',
   pending_run_type TEXT,
   pending_run_context_json TEXT,
@@ -152,6 +153,7 @@ CREATE TABLE IF NOT EXISTS issue_dependencies (
   blocker_issue_key TEXT,
   blocker_title TEXT,
   blocker_current_linear_state TEXT,
+  blocker_current_linear_state_type TEXT,
   updated_at TEXT NOT NULL,
   PRIMARY KEY (project_id, linear_issue_id, blocker_linear_issue_id)
 );
@@ -188,17 +190,24 @@ export function runPatchRelayMigrations(connection) {
     addColumnIfMissing(connection, "issues", "description", "TEXT");
     addColumnIfMissing(connection, "issues", "priority", "INTEGER");
     addColumnIfMissing(connection, "issues", "estimate", "REAL");
+    addColumnIfMissing(connection, "issues", "current_linear_state_type", "TEXT");
+    addColumnIfMissing(connection, "issue_dependencies", "blocker_current_linear_state_type", "TEXT");
     // Zombie/stale recovery backoff
     addColumnIfMissing(connection, "issues", "zombie_recovery_attempts", "INTEGER NOT NULL DEFAULT 0");
     addColumnIfMissing(connection, "issues", "last_zombie_recovery_at", "TEXT");
     // 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_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";
@@ -104,6 +105,10 @@ export class PatchRelayDatabase {
                 sets.push("current_linear_state = COALESCE(@currentLinearState, current_linear_state)");
                 values.currentLinearState = params.currentLinearState;
             }
+            if (params.currentLinearStateType !== undefined) {
+                sets.push("current_linear_state_type = COALESCE(@currentLinearStateType, current_linear_state_type)");
+                values.currentLinearStateType = params.currentLinearStateType;
+            }
             if (params.factoryState !== undefined) {
                 sets.push("factory_state = @factoryState");
                 values.factoryState = params.factoryState;
@@ -160,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;
@@ -168,6 +181,10 @@ 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;
@@ -180,6 +197,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;
@@ -207,20 +232,22 @@ export class PatchRelayDatabase {
         INSERT INTO issues (
           project_id, linear_issue_id, issue_key, title, description, url,
           priority, estimate,
-          current_linear_state, factory_state, pending_run_type, pending_run_context_json,
+          current_linear_state, current_linear_state_type, factory_state, pending_run_type, pending_run_context_json,
           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_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,
           @priority, @estimate,
-          @currentLinearState, @factoryState, @pendingRunType, @pendingRunContextJson,
+          @currentLinearState, @currentLinearStateType, @factoryState, @pendingRunType, @pendingRunContextJson,
           @branchName, @worktreePath, @threadId, @activeRunId,
           @agentSessionId,
           @prNumber, @prUrl, @prState, @prReviewState, @prCheckStatus,
-          @lastGitHubFailureSource, @lastGitHubFailureCheckName, @lastGitHubFailureCheckUrl, @lastGitHubFailureAt, @lastQueueSignalAt, @lastQueueIncidentJson,
+          @lastGitHubFailureSource, @lastGitHubFailureHeadSha, @lastGitHubFailureSignature, @lastGitHubFailureCheckName, @lastGitHubFailureCheckUrl, @lastGitHubFailureContextJson, @lastGitHubFailureAt, @lastQueueSignalAt, @lastQueueIncidentJson,
+          @lastAttemptedFailureHeadSha, @lastAttemptedFailureSignature,
           @now
         )
       `).run({
@@ -233,6 +260,7 @@ export class PatchRelayDatabase {
                 priority: params.priority ?? null,
                 estimate: params.estimate ?? null,
                 currentLinearState: params.currentLinearState ?? null,
+                currentLinearStateType: params.currentLinearStateType ?? null,
                 factoryState: params.factoryState ?? "delegated",
                 pendingRunType: params.pendingRunType ?? null,
                 pendingRunContextJson: params.pendingRunContextJson ?? null,
@@ -247,11 +275,16 @@ 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,
                 lastQueueSignalAt: params.lastQueueSignalAt ?? null,
                 lastQueueIncidentJson: params.lastQueueIncidentJson ?? null,
+                lastAttemptedFailureHeadSha: params.lastAttemptedFailureHeadSha ?? null,
+                lastAttemptedFailureSignature: params.lastAttemptedFailureSignature ?? null,
                 now,
             });
         }
@@ -295,11 +328,12 @@ export class PatchRelayDatabase {
         blocker_issue_key,
         blocker_title,
         blocker_current_linear_state,
+        blocker_current_linear_state_type,
         updated_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?)
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
     `);
         for (const blocker of params.blockers) {
-            insert.run(params.projectId, params.linearIssueId, blocker.blockerLinearIssueId, blocker.blockerIssueKey ?? null, blocker.blockerTitle ?? null, blocker.blockerCurrentLinearState ?? null, now);
+            insert.run(params.projectId, params.linearIssueId, blocker.blockerLinearIssueId, blocker.blockerIssueKey ?? null, blocker.blockerTitle ?? null, blocker.blockerCurrentLinearState ?? null, blocker.blockerCurrentLinearStateType ?? null, now);
         }
     }
     listIssueDependencies(projectId, linearIssueId) {
@@ -311,6 +345,7 @@ export class PatchRelayDatabase {
         COALESCE(blockers.issue_key, d.blocker_issue_key) AS blocker_issue_key,
         COALESCE(blockers.title, d.blocker_title) AS blocker_title,
         COALESCE(blockers.current_linear_state, d.blocker_current_linear_state) AS blocker_current_linear_state,
+        COALESCE(blockers.current_linear_state_type, d.blocker_current_linear_state_type) AS blocker_current_linear_state_type,
         d.updated_at
       FROM issue_dependencies d
       LEFT JOIN issues blockers
@@ -328,6 +363,9 @@ export class PatchRelayDatabase {
             ...(row.blocker_current_linear_state !== null && row.blocker_current_linear_state !== undefined
                 ? { blockerCurrentLinearState: String(row.blocker_current_linear_state) }
                 : {}),
+            ...(row.blocker_current_linear_state_type !== null && row.blocker_current_linear_state_type !== undefined
+                ? { blockerCurrentLinearStateType: String(row.blocker_current_linear_state_type) }
+                : {}),
             updatedAt: String(row.updated_at),
         }));
     }
@@ -351,7 +389,10 @@ export class PatchRelayDatabase {
         ON blockers.project_id = d.project_id
        AND blockers.linear_issue_id = d.blocker_linear_issue_id
       WHERE d.project_id = ? AND d.linear_issue_id = ?
-        AND LOWER(TRIM(COALESCE(blockers.current_linear_state, d.blocker_current_linear_state, ''))) != 'done'
+        AND (
+          COALESCE(blockers.current_linear_state_type, d.blocker_current_linear_state_type, '') != 'completed'
+          AND LOWER(TRIM(COALESCE(blockers.current_linear_state, d.blocker_current_linear_state, ''))) != 'done'
+        )
     `).get(projectId, linearIssueId);
         return Number(row?.count ?? 0);
     }
@@ -370,7 +411,10 @@ export class PatchRelayDatabase {
              AND blockers.linear_issue_id = d.blocker_linear_issue_id
             WHERE d.project_id = i.project_id
               AND d.linear_issue_id = i.linear_issue_id
-              AND LOWER(TRIM(COALESCE(blockers.current_linear_state, d.blocker_current_linear_state, ''))) != 'done'
+              AND (
+                COALESCE(blockers.current_linear_state_type, d.blocker_current_linear_state_type, '') != 'completed'
+                AND LOWER(TRIM(COALESCE(blockers.current_linear_state, d.blocker_current_linear_state, ''))) != 'done'
+              )
           )
       `)
             .all();
@@ -491,6 +535,8 @@ export class PatchRelayDatabase {
     // ─── View builders ──────────────────────────────────────────────
     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,
@@ -500,11 +546,15 @@ export class PatchRelayDatabase {
             ...(issue.url ? { issueUrl: issue.url } : {}),
             ...(issue.currentLinearState ? { currentLinearState: issue.currentLinearState } : {}),
             factoryState: issue.factoryState,
-            blockedByCount: blockedBy.filter((entry) => !isDoneState(entry.blockerCurrentLinearState)).length,
-            blockedByKeys: blockedBy
-                .filter((entry) => !isDoneState(entry.blockerCurrentLinearState))
+            blockedByCount: unresolvedBlockedBy.length,
+            blockedByKeys: unresolvedBlockedBy
                 .map((entry) => entry.blockerIssueKey ?? entry.blockerLinearIssueId),
-            readyForExecution: issue.pendingRunType !== undefined && issue.activeRunId === undefined,
+            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,
@@ -544,6 +594,9 @@ function mapIssueRow(row) {
         ...(row.priority !== null && row.priority !== undefined ? { priority: Number(row.priority) } : {}),
         ...(row.estimate !== null && row.estimate !== undefined ? { estimate: Number(row.estimate) } : {}),
         ...(row.current_linear_state !== null ? { currentLinearState: String(row.current_linear_state) } : {}),
+        ...(row.current_linear_state_type !== null && row.current_linear_state_type !== undefined
+            ? { currentLinearStateType: String(row.current_linear_state_type) }
+            : {}),
         factoryState: String(row.factory_state ?? "delegated"),
         ...(row.pending_run_type !== null && row.pending_run_type !== undefined ? { pendingRunType: String(row.pending_run_type) } : {}),
         ...(row.pending_run_context_json !== null && row.pending_run_context_json !== undefined ? { pendingRunContextJson: String(row.pending_run_context_json) } : {}),
@@ -561,12 +614,21 @@ 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) }
             : {}),
@@ -576,6 +638,12 @@ function mapIssueRow(row) {
         ...(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),
@@ -602,6 +670,6 @@ function mapRunRow(row) {
         ...(row.ended_at !== null ? { endedAt: String(row.ended_at) } : {}),
     };
 }
-function isDoneState(stateName) {
-    return stateName?.trim().toLowerCase() === "done";
+function isResolvedLinearState(stateType, stateName) {
+    return stateType === "completed" || stateName?.trim().toLowerCase() === "done";
 }

package/dist/github-failure-context.js

@@ -0,0 +1,205 @@
+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 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 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 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 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();
+}