patchrelay 0.8.1 → 0.8.3

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.8.1",
-  "commit": "362440acad55",
-  "builtAt": "2026-03-18T10:38:01.072Z"
+  "version": "0.8.3",
+  "commit": "ef05604cd432",
+  "builtAt": "2026-03-18T23:26:09.415Z"
 }

package/dist/config.js

@@ -128,10 +128,28 @@ const configSchema = z.object({
 });
 function defaultTriggerEvents(actor) {
     if (actor === "app") {
-        return ["agentSessionCreated", "agentPrompted"];
+        return ["delegateChanged", "statusChanged", "agentSessionCreated", "agentPrompted", "commentCreated", "commentUpdated"];
     }
     return ["statusChanged"];
 }
+function normalizeTriggerEvents(actor, configured) {
+    if (actor !== "app") {
+        return configured ?? defaultTriggerEvents(actor);
+    }
+    const required = defaultTriggerEvents(actor);
+    if (!configured || configured.length === 0) {
+        return required;
+    }
+    const seen = new Set(required);
+    const extras = configured.filter((event) => {
+        if (seen.has(event)) {
+            return false;
+        }
+        seen.add(event);
+        return true;
+    });
+    return [...required, ...extras];
+}
 const builtinWorkflows = [
     {
         id: "development",
@@ -489,9 +507,8 @@ export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefa
                 issueKeyPrefixes: project.issue_key_prefixes,
                 linearTeamIds: project.linear_team_ids,
                 allowLabels: project.allow_labels,
-                triggerEvents: repoSettings?.trigger_events ??
-                    project.trigger_events ??
-                    defaultTriggerEvents(parsed.linear.oauth.actor),
+                triggerEvents: normalizeTriggerEvents(parsed.linear.oauth.actor, repoSettings?.trigger_events ??
+                    project.trigger_events),
                 branchPrefix: repoSettings?.branch_prefix ?? project.branch_prefix ?? defaultBranchPrefix(project.id),
                 ...(repoSettings?.configPath ? { repoSettingsPath: repoSettings.configPath } : {}),
             };

package/dist/db/issue-workflow-coordinator.js

@@ -200,7 +200,7 @@ export class IssueWorkflowCoordinator {
             });
         }
         const workspace = this.authoritativeLedger.getWorkspaceOwnership(stageRun.workspaceId);
-        if (workspace) {
+        if (workspace && workspace.currentRunLeaseId === params.stageRunId) {
             this.authoritativeLedger.upsertWorkspaceOwnership({
                 projectId: stageRun.projectId,
                 linearIssueId: stageRun.linearIssueId,

package/dist/preflight.js

@@ -40,8 +40,14 @@ export async function runPreflight(config) {
             checks.push(pass("linear_oauth", "Linear app actor includes assignable and mentionable scopes"));
         }
         for (const project of config.projects) {
+            if (!project.triggerEvents.includes("delegateChanged")) {
+                checks.push(warn(`project:${project.id}:triggers`, "Automatic pipeline pickup works best when trigger_events includes delegateChanged"));
+            }
+            if (!project.triggerEvents.includes("statusChanged")) {
+                checks.push(warn(`project:${project.id}:triggers`, "Automatic stage-to-stage continuation works best when trigger_events includes statusChanged"));
+            }
             if (!project.triggerEvents.includes("agentSessionCreated")) {
-                checks.push(warn(`project:${project.id}:triggers`, "App-mode delegation works best when trigger_events includes agentSessionCreated"));
+                checks.push(warn(`project:${project.id}:triggers`, "Native Linear agent sessions work best when trigger_events includes agentSessionCreated"));
             }
             if (!project.triggerEvents.includes("agentPrompted")) {
                 checks.push(warn(`project:${project.id}:triggers`, "Native follow-up agent prompts will not reach an active run unless trigger_events includes agentPrompted"));

package/dist/service-stage-finalizer.js

@@ -3,14 +3,11 @@ 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 { resolveActiveLinearState, resolveFallbackLinearState } from "./linear-workflow.js";
+import { 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";
 import { StageTurnInputDispatcher } from "./stage-turn-input-dispatcher.js";
-import { safeJsonParse } from "./utils.js";
-import { normalizeWebhook } from "./webhooks.js";
-const MAX_AUTOMATIC_TRANSITION_ATTEMPTS = 3;
 export class ServiceStageFinalizer {
     config;
     stores;
@@ -155,6 +152,7 @@ export class ServiceStageFinalizer {
         const report = buildStageReport(finalizedStageRun, issue, thread, countEventMethods(this.stores.stageEvents.listThreadEvents(stageRun.id)));
         this.runAtomically(() => {
             this.finishLedgerRun(stageRun.projectId, stageRun.linearIssueId, "completed", {
+                stageRunId: stageRun.id,
                 threadId: params.threadId,
                 ...(params.turnId ? { turnId: params.turnId } : {}),
                 nextLifecycleStatus: params.nextLifecycleStatus ?? (issue.desiredStage ? "queued" : "completed"),
@@ -173,6 +171,7 @@ export class ServiceStageFinalizer {
     failStageRun(stageRun, threadId, message, options) {
         this.runAtomically(() => {
             this.finishLedgerRun(stageRun.projectId, stageRun.linearIssueId, "failed", {
+                stageRunId: stageRun.id,
                 threadId,
                 ...(options?.turnId ? { turnId: options.turnId } : {}),
                 failureReason: message,
@@ -261,7 +260,7 @@ export class ServiceStageFinalizer {
         if (!linearIssue) {
             return;
         }
-        const continuationPrecondition = await this.checkAutomaticContinuationPreconditions(project, stageRun, refreshedIssue, linear, linearIssue);
+        const continuationPrecondition = await this.checkAutomaticContinuationPreconditions(stageRun, refreshedIssue, linear, linearIssue);
         if (!continuationPrecondition.allowed) {
             this.feed?.publish({
                 level: "info",
@@ -317,9 +316,19 @@ export class ServiceStageFinalizer {
             await this.routeStageToHumanNeeded(project, stageRun, linearIssue, `PatchRelay received ${nextTarget} as the next stage again and needs a human to confirm the intended loop.`);
             return;
         }
-        const priorAttempts = this.countPriorTransitionAttempts(stageRun.projectId, stageRun.linearIssueId, stageRun.stage, nextTarget);
-        if (priorAttempts >= MAX_AUTOMATIC_TRANSITION_ATTEMPTS) {
-            await this.routeStageToHumanNeeded(project, stageRun, linearIssue, `PatchRelay hit the automatic continuation limit for ${stageRun.stage} -> ${nextTarget}.`);
+        if (this.isTransitionAlreadyInFlight(stageRun, nextTarget)) {
+            this.feed?.publish({
+                level: "info",
+                kind: "workflow",
+                issueKey: refreshedIssue.issueKey,
+                projectId: stageRun.projectId,
+                stage: stageRun.stage,
+                ...(refreshedIssue.selectedWorkflowId ? { workflowId: refreshedIssue.selectedWorkflowId } : {}),
+                nextStage: nextTarget,
+                status: "transition_in_progress",
+                summary: `${nextTarget} is already queued or running`,
+                detail: `PatchRelay kept ${stageRun.stage} completion from re-queueing ${nextTarget}.`,
+            });
             return;
         }
         this.feed?.publish({
@@ -339,14 +348,7 @@ export class ServiceStageFinalizer {
             lifecycleStatus: "queued",
         });
     }
-    async checkAutomaticContinuationPreconditions(project, stageRun, issue, linear, linearIssue) {
-        const activeState = resolveActiveLinearState(project, stageRun.stage, issue.selectedWorkflowId);
-        if (activeState && normalizeLinearState(linearIssue.stateName) !== normalizeLinearState(activeState)) {
-            return {
-                allowed: false,
-                reason: `Linear moved from ${activeState} to ${linearIssue.stateName ?? "an unknown state"} while the stage was running.`,
-            };
-        }
+    async checkAutomaticContinuationPreconditions(stageRun, issue, linear, linearIssue) {
         const actorProfile = await linear.getActorProfile().catch(() => undefined);
         if (actorProfile?.actorId && linearIssue.delegateId && linearIssue.delegateId !== actorProfile.actorId) {
             return {
@@ -354,48 +356,8 @@ export class ServiceStageFinalizer {
                 reason: "The issue is no longer delegated to PatchRelay.",
             };
         }
-        const stageSession = stageRun.threadId ? this.stores.issueSessions.getIssueSessionByThreadId(stageRun.threadId) : undefined;
-        if (stageSession?.linkedAgentSessionId && issue.activeAgentSessionId !== stageSession.linkedAgentSessionId) {
-            return {
-                allowed: false,
-                reason: "The active Linear agent session changed while the stage was running.",
-            };
-        }
-        const recentInterruptions = this.listInterruptingWebhooksSince(stageRun, actorProfile?.actorId);
-        if (recentInterruptions.length > 0) {
-            return {
-                allowed: false,
-                reason: `A newer human webhook (${recentInterruptions[0]}) arrived while the stage was running.`,
-            };
-        }
         return { allowed: true };
     }
-    listInterruptingWebhooksSince(stageRun, patchRelayActorId) {
-        const events = this.stores.webhookEvents.listWebhookEventsForIssueSince(stageRun.linearIssueId, stageRun.startedAt);
-        const interrupts = [];
-        for (const event of events) {
-            const payload = safeJsonParse(event.payloadJson);
-            if (!payload) {
-                continue;
-            }
-            const normalized = normalizeWebhook({
-                webhookId: event.webhookId,
-                payload: payload,
-            });
-            if (patchRelayActorId && normalized.actor?.id === patchRelayActorId) {
-                continue;
-            }
-            if (normalized.triggerEvent === "commentCreated" ||
-                normalized.triggerEvent === "commentUpdated" ||
-                normalized.triggerEvent === "agentPrompted" ||
-                normalized.triggerEvent === "agentSessionCreated" ||
-                normalized.triggerEvent === "delegateChanged" ||
-                normalized.triggerEvent === "statusChanged") {
-                interrupts.push(normalized.triggerEvent);
-            }
-        }
-        return interrupts;
-    }
     resolveTransitionTarget(project, stageRun, workflowDefinitionId, handoff) {
         if (!handoff) {
             return "human_needed";
@@ -409,19 +371,16 @@ export class ServiceStageFinalizer {
         }
         return resolveDefaultTransitionTarget(project, stageRun.stage, workflowDefinitionId) ?? "human_needed";
     }
-    countPriorTransitionAttempts(projectId, linearIssueId, currentStage, nextTarget) {
-        const stageHistory = this.stores.issueWorkflows
-            .listStageRunsForIssue(projectId, linearIssueId)
-            .filter((stageRun) => stageRun.status === "completed");
-        let count = 0;
-        for (let index = 0; index < stageHistory.length - 1; index += 1) {
-            const current = stageHistory[index];
-            const next = stageHistory[index + 1];
-            if (current?.stage === currentStage && next?.stage === nextTarget) {
-                count += 1;
-            }
+    isTransitionAlreadyInFlight(stageRun, nextTarget) {
+        const refreshedIssue = this.stores.issueWorkflows.getTrackedIssue(stageRun.projectId, stageRun.linearIssueId);
+        if (!refreshedIssue) {
+            return false;
+        }
+        if (refreshedIssue.desiredStage === nextTarget) {
+            return true;
         }
-        return count;
+        const activeStageRun = this.resolveActiveStageRun(refreshedIssue);
+        return activeStageRun !== undefined && activeStageRun.id !== stageRun.id && activeStageRun.stage === nextTarget;
     }
     async routeStageToHumanNeeded(project, stageRun, linearIssue, reason) {
         const linear = await this.linearProvider.forProject(stageRun.projectId);
@@ -457,29 +416,41 @@ export class ServiceStageFinalizer {
     }
     finishLedgerRun(projectId, linearIssueId, status, params) {
         const issueControl = this.stores.issueControl.getIssueControl(projectId, linearIssueId);
-        if (!issueControl?.activeRunLeaseId) {
+        const targetRunLeaseId = params.stageRunId ?? issueControl?.activeRunLeaseId;
+        if (!targetRunLeaseId) {
+            return;
+        }
+        const targetRunLease = this.stores.runLeases.getRunLease(targetRunLeaseId);
+        if (!targetRunLease) {
             return;
         }
         this.stores.runLeases.finishRunLease({
-            runLeaseId: issueControl.activeRunLeaseId,
+            runLeaseId: targetRunLeaseId,
             status,
             ...(params.threadId ? { threadId: params.threadId } : {}),
             ...(params.turnId ? { turnId: params.turnId } : {}),
             ...(params.failureReason ? { failureReason: params.failureReason } : {}),
         });
-        if (issueControl.activeWorkspaceOwnershipId !== undefined) {
-            const workspace = this.stores.workspaceOwnership.getWorkspaceOwnership(issueControl.activeWorkspaceOwnershipId);
+        if (targetRunLease.workspaceOwnershipId !== undefined) {
+            const workspace = this.stores.workspaceOwnership.getWorkspaceOwnership(targetRunLease.workspaceOwnershipId);
             if (workspace) {
                 this.stores.workspaceOwnership.upsertWorkspaceOwnership({
                     projectId,
                     linearIssueId,
                     branchName: workspace.branchName,
                     worktreePath: workspace.worktreePath,
-                    status: status === "completed" ? "active" : "paused",
-                    currentRunLeaseId: null,
+                    status: workspace.currentRunLeaseId === targetRunLeaseId ? (status === "completed" ? "active" : "paused") : workspace.status,
+                    ...(workspace.currentRunLeaseId === targetRunLeaseId
+                        ? { currentRunLeaseId: null }
+                        : workspace.currentRunLeaseId !== undefined
+                            ? { currentRunLeaseId: workspace.currentRunLeaseId }
+                            : {}),
                 });
             }
         }
+        if (!issueControl?.activeRunLeaseId || issueControl.activeRunLeaseId !== targetRunLeaseId) {
+            return;
+        }
         this.stores.issueControl.upsertIssueControl({
             projectId,
             linearIssueId,

package/dist/service-webhook-processor.js

@@ -154,8 +154,7 @@ export class ServiceWebhookProcessor {
                 });
             }
             if (issueState.issue?.selectedWorkflowId &&
-                issueState.issue.selectedWorkflowId !== priorIssue?.selectedWorkflowId &&
-                (hydrated.triggerEvent === "agentSessionCreated" || hydrated.triggerEvent === "agentPrompted")) {
+                issueState.issue.selectedWorkflowId !== priorIssue?.selectedWorkflowId) {
                 this.feed?.publish({
                     level: "info",
                     kind: "workflow",

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

@@ -78,9 +78,6 @@ export class WebhookDesiredStageRecorder {
         if (!normalizedIssue) {
             return undefined;
         }
-        if (normalized.triggerEvent !== "agentSessionCreated" && normalized.triggerEvent !== "agentPrompted") {
-            return undefined;
-        }
         if (!delegatedToPatchRelay || !triggerEventAllowed(project, normalized.triggerEvent)) {
             return undefined;
         }
@@ -102,9 +99,6 @@ export class WebhookDesiredStageRecorder {
         if (activeStageRun) {
             return issue?.selectedWorkflowId;
         }
-        if (normalized.triggerEvent !== "agentSessionCreated" && normalized.triggerEvent !== "agentPrompted") {
-            return issue?.selectedWorkflowId;
-        }
         if (!delegatedToPatchRelay || !triggerEventAllowed(project, normalized.triggerEvent) || !normalized.issue) {
             return issue?.selectedWorkflowId;
         }

package/package.json

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