patchrelay 0.69.4 → 0.69.5

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.69.4",
-  "commit": "56b3535ee459",
-  "builtAt": "2026-05-22T22:23:51.490Z"
+  "version": "0.69.5",
+  "commit": "ab14b628b055",
+  "builtAt": "2026-05-22T23:00:59.300Z"
 }

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

@@ -1,13 +1,11 @@
-import { classifyIssue } from "../issue-class.js";
-import { computeOrchestrationSettleUntil, wakeOrchestrationParentsForChildEvent, } from "../orchestration-parent-wake.js";
+import { wakeOrchestrationParentsForChildEvent } from "../orchestration-parent-wake.js";
 import { triggerEventAllowed } from "../project-resolution.js";
-import { resolveAwaitingInputReason } from "../awaiting-input-reason.js";
-import { decideActiveRunRelease, decideAgentSession, decideRunIntent, decideUnDelegation, isResolvedLinearState, isTerminalDelegationState, resolveReDelegationResume, } from "./decision-helpers.js";
+import { isResolvedLinearState } from "./decision-helpers.js";
 import { isDelegatedToPatchRelay, resolveDelegationTruth } from "./delegation-truth.js";
 import { syncIssueDependencies } from "./issue-dependency-sync.js";
 import { resolveLinkedPrAdoption } from "./linked-pr-adoption.js";
 import { buildOperatorRetryEvent } from "../operator-retry-event.js";
-import { resolveIssueUpdatePlan } from "./issue-update-plan.js";
+import { planIssueWebhookWorkflow } from "./issue-webhook-workflow-planner.js";
 export class DesiredStageRecorder {
     db;
     linearProvider;
@@ -56,108 +54,25 @@ export class DesiredStageRecorder {
             triggerEvent: params.normalized.triggerEvent,
         });
         const unresolvedBlockers = this.db.issues.countUnresolvedBlockers(params.project.id, normalizedIssue.id);
-        const terminal = isTerminalDelegationState(existingIssue, hydratedIssue);
-        const openPrExists = existingIssue?.prNumber !== undefined
-            && existingIssue.prState !== "closed"
-            && existingIssue.prState !== "merged";
-        const blockerPausedImplementation = unresolvedBlockers > 0
-            && activeRun?.runType === "implementation"
-            && !openPrExists;
-        const desiredStage = linkedPrAdoption
-            ? undefined
-            : decideRunIntent({
-                delegated,
-                triggerAllowed,
-                triggerEvent: params.normalized.triggerEvent,
-                unresolvedBlockers,
-                hasActiveRun: Boolean(activeRun),
-                hasPendingWake,
-                terminal,
-                currentState: existingIssue?.factoryState,
-            });
         const childIssueCount = this.db.issues.listCanonicalChildIssues(params.project.id, normalizedIssue.id).length;
-        const classification = classifyIssue({
-            issue: {
-                issueClass: existingIssue?.issueClass,
-                issueClassSource: existingIssue?.issueClassSource,
-                title: hydratedIssue.title ?? existingIssue?.title,
-                description: hydratedIssue.description ?? existingIssue?.description,
-                parentLinearIssueId: hydratedIssue.parentId ?? existingIssue?.parentLinearIssueId,
-            },
-            childIssueCount,
-        });
-        const shouldEnterOrchestrationSettle = Boolean(delegated
-            && desiredStage === "implementation"
-            && classification.issueClass === "orchestration"
-            && childIssueCount === 0
-            && !existingIssue?.threadId
-            && !activeRun
-            && !terminal);
-        const runRelease = decideActiveRunRelease({
-            hasActiveRun: Boolean(activeRun),
-            terminal,
-            triggerEvent: params.normalized.triggerEvent,
-            delegated,
-        });
-        const effectiveRunRelease = blockerPausedImplementation
-            ? { release: true, reason: "Issue became blocked during implementation" }
-            : runRelease;
-        const undelegation = decideUnDelegation({
-            triggerEvent: params.normalized.triggerEvent,
-            delegated,
-            currentState: existingIssue?.factoryState,
-            hasPr: existingIssue?.prNumber !== undefined && existingIssue?.prState !== "merged",
-        });
-        const startupResume = linkedPrAdoption
-            ? {
-                factoryState: linkedPrAdoption.factoryState,
-                pendingRunType: linkedPrAdoption.pendingRunType,
-                pendingRunContext: linkedPrAdoption.pendingRunContext,
-                source: "linked_pr_adoption",
-            }
-            : {
-                ...resolveReDelegationResume({
-                    delegated,
-                    previouslyDelegated: existingIssue?.delegatedToPatchRelay,
-                    currentState: existingIssue?.factoryState,
-                    awaitingInputReason: existingIssue
-                        ? resolveAwaitingInputReason({ issue: existingIssue, latestRun })
-                        : undefined,
-                    unresolvedBlockers,
-                    prNumber: existingIssue?.prNumber,
-                    prState: existingIssue?.prState,
-                    prIsDraft: existingIssue?.prIsDraft,
-                    prReviewState: existingIssue?.prReviewState,
-                    prCheckStatus: existingIssue?.prCheckStatus,
-                    latestFailureSource: existingIssue?.lastGitHubFailureSource,
-                }),
-                source: "re_delegated",
-            };
         const existingWakeRunType = existingIssue
             ? params.peekPendingSessionWakeRunType(params.project.id, normalizedIssue.id)
             : undefined;
-        const clearPending = (unresolvedBlockers > 0 && existingWakeRunType === "implementation" && !activeRun)
-            || undelegation.clearPending;
-        const agentSessionId = decideAgentSession({
-            sessionId: params.normalized.agentSession?.id,
-            triggerEvent: params.normalized.triggerEvent,
-            delegated,
-        });
-        const terminalRunRelease = effectiveRunRelease.release && terminal;
-        const resolvedPlan = resolveIssueUpdatePlan({
-            existingIssue: Boolean(existingIssue),
+        const workflowPlan = planIssueWebhookWorkflow({
+            existingIssue,
+            hydratedIssue,
+            latestRun,
             delegated,
+            linkedPrAdoption,
+            triggerAllowed,
+            triggerEvent: params.normalized.triggerEvent,
+            unresolvedBlockers,
+            hasActiveRun: Boolean(activeRun),
+            activeRunType: activeRun?.runType,
+            hasPendingWake,
+            existingWakeRunType,
             incomingAgentSessionId,
-            startupResume,
-            desiredStage,
-            terminalRunRelease,
-            blockerPausedImplementation,
-            undelegation,
-            clearPending,
-            effectiveRunRelease,
-            shouldEnterOrchestrationSettle,
-            agentSessionId,
-            computeOrchestrationSettleUntil,
+            childIssueCount,
         });
         const commitIssueUpdate = () => {
             const record = this.db.issues.upsertIssue({
@@ -166,8 +81,8 @@ export class DesiredStageRecorder {
                 ...(hydratedIssue.identifier ? { issueKey: hydratedIssue.identifier } : {}),
                 ...(hydratedIssue.parentId !== undefined ? { parentLinearIssueId: hydratedIssue.parentId ?? null } : {}),
                 ...(hydratedIssue.parentIdentifier !== undefined ? { parentIssueKey: hydratedIssue.parentIdentifier ?? null } : {}),
-                issueClass: classification.issueClass,
-                issueClassSource: classification.issueClassSource,
+                issueClass: workflowPlan.classification.issueClass,
+                issueClassSource: workflowPlan.classification.issueClassSource,
                 ...(hydratedIssue.title ? { title: hydratedIssue.title } : {}),
                 ...(hydratedIssue.description ? { description: hydratedIssue.description } : {}),
                 ...(hydratedIssue.url ? { url: hydratedIssue.url } : {}),
@@ -177,10 +92,10 @@ export class DesiredStageRecorder {
                 ...(hydratedIssue.stateType ? { currentLinearStateType: hydratedIssue.stateType } : {}),
                 ...linkedPrAdoption?.issueUpdates,
                 delegatedToPatchRelay: delegated,
-                ...resolvedPlan,
+                ...workflowPlan.resolvedIssueUpdate,
             });
-            if (effectiveRunRelease.release && activeRun && effectiveRunRelease.reason) {
-                this.db.runs.finishRun(activeRun.id, { status: "released", failureReason: effectiveRunRelease.reason });
+            if (workflowPlan.effectiveRunRelease.release && activeRun && workflowPlan.effectiveRunRelease.reason) {
+                this.db.runs.finishRun(activeRun.id, { status: "released", failureReason: workflowPlan.effectiveRunRelease.reason });
             }
             return record;
         };
@@ -196,7 +111,7 @@ export class DesiredStageRecorder {
         const currentParentIssueId = issue.parentLinearIssueId;
         const wasResolved = isResolvedLinearState(existingIssue?.currentLinearStateType, existingIssue?.currentLinearState);
         const isResolved = isResolvedLinearState(issue.currentLinearStateType, issue.currentLinearState);
-        if (undelegation.factoryState) {
+        if (workflowPlan.undelegation.factoryState) {
             if (activeRun?.threadId && activeRun.turnId) {
                 await params.stopActiveRun(activeRun, "STOP: The issue was un-delegated from PatchRelay. Stop working immediately and exit.");
             }
@@ -220,7 +135,7 @@ export class DesiredStageRecorder {
                     : `Issue un-delegated from PatchRelay; ${issue.factoryState} is now paused`,
             });
         }
-        else if (blockerPausedImplementation) {
+        else if (workflowPlan.blockerPausedImplementation) {
             if (activeRun?.threadId && activeRun.turnId) {
                 await params.stopActiveRun(activeRun, "STOP: The issue is now blocked by another task. Stop working immediately and exit without publishing.");
             }
@@ -236,14 +151,14 @@ export class DesiredStageRecorder {
                 summary: `Implementation paused because ${issue.issueKey ?? normalizedIssue.id} is now blocked`,
             });
         }
-        else if (startupResume.pendingRunType) {
+        else if (workflowPlan.startupResume.pendingRunType) {
             this.db.issueSessions.appendIssueSessionEventRespectingActiveLease(params.project.id, normalizedIssue.id, {
                 projectId: params.project.id,
                 linearIssueId: normalizedIssue.id,
-                ...buildOperatorRetryEvent(issue, startupResume.pendingRunType, startupResume.source),
+                ...buildOperatorRetryEvent(issue, workflowPlan.startupResume.pendingRunType, workflowPlan.startupResume.source),
             });
         }
-        else if (shouldEnterOrchestrationSettle) {
+        else if (workflowPlan.shouldEnterOrchestrationSettle) {
             this.feed?.publish({
                 level: "info",
                 kind: "stage",
@@ -254,10 +169,9 @@ export class DesiredStageRecorder {
                 summary: "Waiting briefly for child issues to settle before orchestration starts",
             });
         }
-        else if (!startupResume.factoryState
-            && !startupResume.pendingRunType
-            &&
-                desiredStage === "implementation"
+        else if (!workflowPlan.startupResume.factoryState
+            && !workflowPlan.startupResume.pendingRunType
+            && workflowPlan.desiredStage === "implementation"
             && params.normalized.triggerEvent !== "commentCreated"
             && params.normalized.triggerEvent !== "commentUpdated"
             && params.normalized.triggerEvent !== "agentPrompted") {

package/dist/webhooks/issue-webhook-workflow-planner.js

@@ -0,0 +1,124 @@
+import { resolveAwaitingInputReason } from "../awaiting-input-reason.js";
+import { computeOrchestrationSettleUntil as computeDefaultOrchestrationSettleUntil } from "../orchestration-parent-wake.js";
+import { classifyIssue } from "../issue-class.js";
+import { decideActiveRunRelease, decideAgentSession, decideRunIntent, decideUnDelegation, isTerminalDelegationState, resolveReDelegationResume, } from "./decision-helpers.js";
+import { resolveIssueUpdatePlan } from "./issue-update-plan.js";
+function resolveStartupResume(input) {
+    if (input.linkedPrAdoption) {
+        return {
+            factoryState: input.linkedPrAdoption.factoryState,
+            pendingRunType: input.linkedPrAdoption.pendingRunType,
+            pendingRunContext: input.linkedPrAdoption.pendingRunContext,
+            source: "linked_pr_adoption",
+        };
+    }
+    const awaitingInputReason = input.existingIssue
+        ? resolveAwaitingInputReason({ issue: input.existingIssue, latestRun: input.latestRun })
+        : undefined;
+    return {
+        ...resolveReDelegationResume({
+            delegated: input.delegated,
+            previouslyDelegated: input.existingIssue?.delegatedToPatchRelay,
+            currentState: input.existingIssue?.factoryState,
+            awaitingInputReason,
+            unresolvedBlockers: input.unresolvedBlockers,
+            prNumber: input.existingIssue?.prNumber,
+            prState: input.existingIssue?.prState,
+            prIsDraft: input.existingIssue?.prIsDraft,
+            prReviewState: input.existingIssue?.prReviewState,
+            prCheckStatus: input.existingIssue?.prCheckStatus,
+            latestFailureSource: input.existingIssue?.lastGitHubFailureSource,
+        }),
+        source: "re_delegated",
+    };
+}
+export function planIssueWebhookWorkflow(input) {
+    const terminal = isTerminalDelegationState(input.existingIssue, input.hydratedIssue);
+    const openPrExists = input.existingIssue?.prNumber !== undefined
+        && input.existingIssue.prState !== "closed"
+        && input.existingIssue.prState !== "merged";
+    const blockerPausedImplementation = input.unresolvedBlockers > 0
+        && input.activeRunType === "implementation"
+        && !openPrExists;
+    const desiredStage = input.linkedPrAdoption
+        ? undefined
+        : decideRunIntent({
+            delegated: input.delegated,
+            triggerAllowed: input.triggerAllowed,
+            triggerEvent: input.triggerEvent,
+            unresolvedBlockers: input.unresolvedBlockers,
+            hasActiveRun: input.hasActiveRun,
+            hasPendingWake: input.hasPendingWake,
+            terminal,
+            currentState: input.existingIssue?.factoryState,
+        });
+    const classification = classifyIssue({
+        issue: {
+            issueClass: input.existingIssue?.issueClass,
+            issueClassSource: input.existingIssue?.issueClassSource,
+            title: input.hydratedIssue.title ?? input.existingIssue?.title,
+            description: input.hydratedIssue.description ?? input.existingIssue?.description,
+            parentLinearIssueId: input.hydratedIssue.parentId ?? input.existingIssue?.parentLinearIssueId,
+        },
+        childIssueCount: input.childIssueCount,
+    });
+    const shouldEnterOrchestrationSettle = Boolean(input.delegated
+        && desiredStage === "implementation"
+        && classification.issueClass === "orchestration"
+        && input.childIssueCount === 0
+        && !input.existingIssue?.threadId
+        && !input.hasActiveRun
+        && !terminal);
+    const runRelease = decideActiveRunRelease({
+        hasActiveRun: input.hasActiveRun,
+        terminal,
+        triggerEvent: input.triggerEvent,
+        delegated: input.delegated,
+    });
+    const effectiveRunRelease = blockerPausedImplementation
+        ? { release: true, reason: "Issue became blocked during implementation" }
+        : runRelease;
+    const undelegation = decideUnDelegation({
+        triggerEvent: input.triggerEvent,
+        delegated: input.delegated,
+        currentState: input.existingIssue?.factoryState,
+        hasPr: input.existingIssue?.prNumber !== undefined && input.existingIssue?.prState !== "merged",
+    });
+    const startupResume = resolveStartupResume(input);
+    const clearPending = (input.unresolvedBlockers > 0 && input.existingWakeRunType === "implementation" && !input.hasActiveRun)
+        || undelegation.clearPending;
+    const agentSessionId = decideAgentSession({
+        sessionId: input.incomingAgentSessionId,
+        triggerEvent: input.triggerEvent,
+        delegated: input.delegated,
+    });
+    const terminalRunRelease = effectiveRunRelease.release && terminal;
+    const resolvedIssueUpdate = resolveIssueUpdatePlan({
+        existingIssue: Boolean(input.existingIssue),
+        delegated: input.delegated,
+        incomingAgentSessionId: input.incomingAgentSessionId,
+        startupResume,
+        desiredStage,
+        terminalRunRelease,
+        blockerPausedImplementation,
+        undelegation,
+        clearPending,
+        effectiveRunRelease,
+        shouldEnterOrchestrationSettle,
+        agentSessionId,
+        computeOrchestrationSettleUntil: input.computeOrchestrationSettleUntil ?? computeDefaultOrchestrationSettleUntil,
+    });
+    return {
+        classification,
+        terminal,
+        desiredStage,
+        blockerPausedImplementation,
+        undelegation,
+        startupResume,
+        effectiveRunRelease,
+        clearPending,
+        agentSessionId,
+        shouldEnterOrchestrationSettle,
+        resolvedIssueUpdate,
+    };
+}

package/package.json

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