patchrelay 0.8.3 → 0.8.5

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.8.3",
-  "commit": "ef05604cd432",
-  "builtAt": "2026-03-18T23:26:09.415Z"
+  "version": "0.8.5",
+  "commit": "1a8f1cf74d1f",
+  "builtAt": "2026-03-19T10:46:11.106Z"
 }

package/dist/linear-workflow.js

@@ -1,11 +1,53 @@
 import { resolveWorkflowStageConfig } from "./workflow-policy.js";
 const STATUS_MARKER = "<!-- patchrelay:status-comment -->";
+function normalizeLinearState(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed.toLowerCase() : undefined;
+}
 export function resolveActiveLinearState(project, stage, workflowDefinitionId) {
     return resolveWorkflowStageConfig(project, stage, workflowDefinitionId)?.activeState;
 }
 export function resolveFallbackLinearState(project, stage, workflowDefinitionId) {
     return resolveWorkflowStageConfig(project, stage, workflowDefinitionId)?.fallbackState;
 }
+export function resolveDoneLinearState(issue) {
+    const typedMatch = issue.workflowStates.find((state) => normalizeLinearState(state.type) === "completed");
+    if (typedMatch?.name) {
+        return typedMatch.name;
+    }
+    const nameMatch = issue.workflowStates.find((state) => {
+        const normalized = normalizeLinearState(state.name);
+        return normalized === "done" || normalized === "completed" || normalized === "complete";
+    });
+    return nameMatch?.name;
+}
+export function resolveAuthoritativeLinearStopState(issue) {
+    const currentStateName = issue.stateName?.trim();
+    const normalizedCurrentState = normalizeLinearState(currentStateName);
+    if (!currentStateName || !normalizedCurrentState) {
+        return undefined;
+    }
+    const currentWorkflowState = issue.workflowStates.find((state) => normalizeLinearState(state.name) === normalizedCurrentState);
+    if (normalizeLinearState(currentWorkflowState?.type) === "completed") {
+        return {
+            stateName: currentWorkflowState?.name ?? currentStateName,
+            lifecycleStatus: "completed",
+        };
+    }
+    if (normalizedCurrentState === "human needed") {
+        return {
+            stateName: currentStateName,
+            lifecycleStatus: "paused",
+        };
+    }
+    if (normalizedCurrentState === "done" || normalizedCurrentState === "completed" || normalizedCurrentState === "complete") {
+        return {
+            stateName: currentStateName,
+            lifecycleStatus: "completed",
+        };
+    }
+    return undefined;
+}
 export function buildRunningStatusComment(params) {
     return [
         STATUS_MARKER,

package/dist/service-stage-finalizer.js

@@ -3,7 +3,7 @@ import { reconcileIssue } from "./reconciliation-engine.js";
 import { buildReconciliationSnapshot } from "./reconciliation-snapshot-builder.js";
 import { syncFailedStageToLinear } from "./stage-failure.js";
 import { parseStageHandoff } from "./stage-handoff.js";
-import { resolveFallbackLinearState } from "./linear-workflow.js";
+import { resolveAuthoritativeLinearStopState, resolveDoneLinearState, resolveFallbackLinearState } from "./linear-workflow.js";
 import { resolveDefaultTransitionTarget, transitionTargetAllowed } from "./workflow-policy.js";
 import { buildFailedStageReport, buildPendingMaterializationThread, buildStageReport, countEventMethods, extractStageSummary, extractTurnId, resolveStageRunStatus, summarizeCurrentThread, } from "./stage-reporting.js";
 import { StageLifecyclePublisher } from "./stage-lifecycle-publisher.js";
@@ -241,7 +241,7 @@ export class ServiceStageFinalizer {
     }
     async maybeQueueAutomaticTransition(stageRun, report) {
         const refreshedIssue = this.stores.issueWorkflows.getTrackedIssue(stageRun.projectId, stageRun.linearIssueId);
-        if (!refreshedIssue || refreshedIssue.desiredStage) {
+        if (!refreshedIssue) {
             return;
         }
         const project = this.config.projects.find((candidate) => candidate.id === stageRun.projectId);
@@ -260,6 +260,14 @@ export class ServiceStageFinalizer {
         if (!linearIssue) {
             return;
         }
+        const authoritativeStopState = resolveAuthoritativeLinearStopState(linearIssue);
+        if (authoritativeStopState) {
+            this.syncIssueToAuthoritativeLinearStopState(stageRun, refreshedIssue, authoritativeStopState);
+            return;
+        }
+        if (refreshedIssue.desiredStage) {
+            return;
+        }
         const continuationPrecondition = await this.checkAutomaticContinuationPreconditions(stageRun, refreshedIssue, linear, linearIssue);
         if (!continuationPrecondition.allowed) {
             this.feed?.publish({
@@ -348,6 +356,32 @@ export class ServiceStageFinalizer {
             lifecycleStatus: "queued",
         });
     }
+    syncIssueToAuthoritativeLinearStopState(stageRun, issue, stopState) {
+        this.stores.workflowCoordinator.setIssueDesiredStage(stageRun.projectId, stageRun.linearIssueId, undefined, {
+            lifecycleStatus: stopState.lifecycleStatus,
+        });
+        this.stores.workflowCoordinator.upsertTrackedIssue({
+            projectId: stageRun.projectId,
+            linearIssueId: stageRun.linearIssueId,
+            currentLinearState: stopState.stateName,
+            lifecycleStatus: stopState.lifecycleStatus,
+        });
+        this.feed?.publish({
+            level: "info",
+            kind: "workflow",
+            issueKey: issue.issueKey,
+            projectId: stageRun.projectId,
+            stage: stageRun.stage,
+            ...(issue.selectedWorkflowId ? { workflowId: issue.selectedWorkflowId } : {}),
+            status: stopState.lifecycleStatus === "completed" ? "completed" : "transition_suppressed",
+            summary: stopState.lifecycleStatus === "completed"
+                ? `Kept workflow completed after ${stageRun.stage}`
+                : `Ignored stale ${stageRun.stage} completion`,
+            detail: stopState.lifecycleStatus === "completed"
+                ? `Live Linear state is already ${stopState.stateName}, so PatchRelay kept the issue finished.`
+                : `Live Linear state is already ${stopState.stateName}, so PatchRelay kept the issue paused.`,
+        });
+    }
     async checkAutomaticContinuationPreconditions(stageRun, issue, linear, linearIssue) {
         const actorProfile = await linear.getActorProfile().catch(() => undefined);
         if (actorProfile?.actorId && linearIssue.delegateId && linearIssue.delegateId !== actorProfile.actorId) {
@@ -651,14 +685,3 @@ function normalizeLinearState(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed.toLowerCase() : undefined;
 }
-function resolveDoneLinearState(issue) {
-    const typedMatch = issue.workflowStates.find((state) => normalizeLinearState(state.type) === "completed");
-    if (typedMatch?.name) {
-        return typedMatch.name;
-    }
-    const nameMatch = issue.workflowStates.find((state) => {
-        const normalized = normalizeLinearState(state.name);
-        return normalized === "done" || normalized === "completed" || normalized === "complete";
-    });
-    return nameMatch?.name;
-}

package/dist/service-stage-runner.js

@@ -1,3 +1,4 @@
+import { resolveAuthoritativeLinearStopState } from "./linear-workflow.js";
 import { buildStageLaunchPlan, isCodexThreadId } from "./stage-launch.js";
 import { syncFailedStageToLinear } from "./stage-failure.js";
 import { buildFailedStageReport } from "./stage-reporting.js";
@@ -47,6 +48,22 @@ export class ServiceStageRunner {
         if (!issue) {
             return;
         }
+        if (issue.lifecycleStatus === "completed" || issue.lifecycleStatus === "paused") {
+            this.feed?.publish({
+                level: "info",
+                kind: "workflow",
+                issueKey: issue.issueKey,
+                projectId: item.projectId,
+                stage: desiredStage,
+                ...(issue.selectedWorkflowId ? { workflowId: issue.selectedWorkflowId } : {}),
+                status: issue.lifecycleStatus === "completed" ? "completed" : "transition_suppressed",
+                summary: issue.lifecycleStatus === "completed"
+                    ? `Skipped ${desiredStage} because the issue is already complete`
+                    : `Skipped ${desiredStage} because the issue is already paused`,
+                detail: issue.currentLinearState ? `Live Linear state is ${issue.currentLinearState}.` : undefined,
+            });
+            return;
+        }
         const existingWorkspace = this.stores.workspaceOwnership.getWorkspaceOwnershipForIssue(item.projectId, item.issueId);
         const stageHistory = this.stores.issueWorkflows.listStageRunsForIssue(item.projectId, item.issueId);
         const previousStageRun = stageHistory.at(-1);
@@ -201,13 +218,28 @@ export class ServiceStageRunner {
     }
     async ensureLaunchIssueMirror(project, linearIssueId, _desiredStage, _desiredWebhookId) {
         const existing = this.stores.issueWorkflows.getTrackedIssue(project.id, linearIssueId);
-        if (existing?.issueKey && existing.title && existing.issueUrl && existing.currentLinearState) {
-            return existing;
-        }
         const liveIssue = await this.linearProvider
             .forProject(project.id)
             .then((linear) => linear?.getIssue(linearIssueId))
             .catch(() => undefined);
+        const authoritativeStopState = liveIssue ? resolveAuthoritativeLinearStopState(liveIssue) : undefined;
+        if (authoritativeStopState) {
+            this.stores.workflowCoordinator.setIssueDesiredStage(project.id, linearIssueId, undefined, {
+                lifecycleStatus: authoritativeStopState.lifecycleStatus,
+            });
+            return this.stores.workflowCoordinator.upsertTrackedIssue({
+                projectId: project.id,
+                linearIssueId,
+                ...(liveIssue?.identifier ? { issueKey: liveIssue.identifier } : existing?.issueKey ? { issueKey: existing.issueKey } : {}),
+                ...(liveIssue?.title ? { title: liveIssue.title } : existing?.title ? { title: existing.title } : {}),
+                ...(liveIssue?.url ? { issueUrl: liveIssue.url } : existing?.issueUrl ? { issueUrl: existing.issueUrl } : {}),
+                currentLinearState: authoritativeStopState.stateName,
+                lifecycleStatus: authoritativeStopState.lifecycleStatus,
+            });
+        }
+        if (!liveIssue && existing?.issueKey && existing.title && existing.issueUrl && existing.currentLinearState) {
+            return existing;
+        }
         return this.stores.workflowCoordinator.recordDesiredStage({
             projectId: project.id,
             linearIssueId,

package/dist/webhook-desired-stage-recorder.js

@@ -39,7 +39,7 @@ export class WebhookDesiredStageRecorder {
             ...(normalizedIssue.stateName ? { currentLinearState: normalizedIssue.stateName } : {}),
             ...(selectedWorkflowId !== undefined ? { selectedWorkflowId } : {}),
             ...(desiredStage ? { desiredStage } : {}),
-            ...(options?.eventReceiptId !== undefined ? { desiredReceiptId: options.eventReceiptId } : {}),
+            ...(desiredStage && options?.eventReceiptId !== undefined ? { desiredReceiptId: options.eventReceiptId } : {}),
             ...(activeAgentSessionId !== undefined ? { activeAgentSessionId } : {}),
             lastWebhookAt: new Date().toISOString(),
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patchrelay",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "license": "MIT",
   "type": "module",
   "repository": {