patchrelay 0.54.4 → 0.55.0

package/README.md

@@ -61,6 +61,8 @@ patchrelay service status
 patchrelay dashboard
 ```
 
+When one Linear team owns issues for multiple repositories, include `--project <Linear project>` on each `repo link`. PatchRelay routes Linear webhooks by project first, so separate projects inside the same `USE` team can map to separate GitHub repos.
+
 Each repo needs two workflow files for repo-specific run behavior:
 
 - `IMPLEMENTATION_WORKFLOW.md` — implementation, CI repair, queue repair runs

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.54.4",
-  "commit": "fa7ff16eaeff",
-  "builtAt": "2026-04-30T14:26:42.396Z"
+  "version": "0.55.0",
+  "commit": "bd44ea445936",
+  "builtAt": "2026-05-01T12:06:57.419Z"
 }

package/dist/config.js

@@ -52,6 +52,7 @@ const projectSchema = z.object({
     trusted_actors: trustedActorsSchema,
     issue_key_prefixes: z.array(z.string().min(1)).default([]),
     linear_team_ids: z.array(z.string().min(1)).default([]),
+    linear_project_ids: z.array(z.string().min(1)).default([]),
     allow_labels: z.array(z.string().min(1)).default([]),
     trigger_events: z.array(z.string().min(1)).min(1).optional(),
     branch_prefix: z.string().min(1).optional(),
@@ -466,6 +467,7 @@ export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefa
             worktreeRoot: ensureAbsolutePath(defaultWorktreeRoot(repository.githubRepo)),
             issueKeyPrefixes: repository.issueKeyPrefixes,
             linearTeamIds: repository.linearTeamIds,
+            linearProjectIds: repository.linearProjectIds,
             allowLabels: [],
             reviewChecks: repository.reviewChecks,
             gateChecks: repository.gateChecks,
@@ -503,6 +505,7 @@ export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefa
                 : {}),
             issueKeyPrefixes: project.issue_key_prefixes,
             linearTeamIds: project.linear_team_ids,
+            linearProjectIds: project.linear_project_ids,
             allowLabels: project.allow_labels,
             reviewChecks: project.review_checks,
             gateChecks: project.gate_checks,
@@ -656,6 +659,7 @@ function validateConfigSemantics(config, options) {
     const githubRepos = new Set();
     const issuePrefixes = new Map();
     const linearTeamIds = new Map();
+    const linearProjectIds = new Map();
     for (const repository of config.repositories) {
         if (githubRepos.has(repository.githubRepo)) {
             throw new Error(`Duplicate repository github_repo: ${repository.githubRepo}`);
@@ -667,19 +671,26 @@ function validateConfigSemantics(config, options) {
             throw new Error(`Duplicate project id: ${project.id}`);
         }
         projectIds.add(project.id);
+        for (const linearProjectId of project.linearProjectIds) {
+            const owner = linearProjectIds.get(linearProjectId);
+            if (owner && owner !== project.id) {
+                throw new Error(`Linear project id "${linearProjectId}" is configured for both ${owner} and ${project.id}`);
+            }
+            linearProjectIds.set(linearProjectId, project.id);
+        }
         for (const prefix of project.issueKeyPrefixes) {
             const owner = issuePrefixes.get(prefix);
-            if (owner && owner !== project.id) {
-                throw new Error(`Issue key prefix "${prefix}" is configured for both ${owner} and ${project.id}`);
+            if (owner && owner.id !== project.id && !hasDisjointProjectRouting(owner, project)) {
+                throw new Error(`Issue key prefix "${prefix}" is configured for both ${owner.id} and ${project.id}`);
             }
-            issuePrefixes.set(prefix, project.id);
+            issuePrefixes.set(prefix, project);
         }
         for (const teamId of project.linearTeamIds) {
             const owner = linearTeamIds.get(teamId);
-            if (owner && owner !== project.id) {
-                throw new Error(`Linear team id "${teamId}" is configured for both ${owner} and ${project.id}`);
+            if (owner && owner.id !== project.id && !hasDisjointProjectRouting(owner, project)) {
+                throw new Error(`Linear team id "${teamId}" is configured for both ${owner.id} and ${project.id}`);
             }
-            linearTeamIds.set(teamId, project.id);
+            linearTeamIds.set(teamId, project);
         }
     }
     if (config.operatorApi.enabled &&
@@ -689,3 +700,10 @@ function validateConfigSemantics(config, options) {
         throw new Error("operator_api.enabled requires operator_api.bearer_token_env when server.bind is not 127.0.0.1");
     }
 }
+function hasDisjointProjectRouting(left, right) {
+    if (left.linearProjectIds.length === 0 || right.linearProjectIds.length === 0) {
+        return false;
+    }
+    const rightProjectIds = new Set(right.linearProjectIds);
+    return left.linearProjectIds.every((linearProjectId) => !rightProjectIds.has(linearProjectId));
+}

package/dist/linear-client.js

@@ -88,6 +88,10 @@ const LINEAR_ISSUE_SELECTION = `
       }
     }
   }
+  project {
+    id
+    name
+  }
 `;
 export class LinearGraphqlClient {
     options;
@@ -388,6 +392,8 @@ export class LinearGraphqlClient {
             ...(issue.state?.type ? { stateType: issue.state.type } : {}),
             ...(issue.team?.id ? { teamId: issue.team.id } : {}),
             ...(issue.team?.key ? { teamKey: issue.team.key } : {}),
+            ...(issue.project?.id ? { projectId: issue.project.id } : {}),
+            ...(issue.project?.name ? { projectName: issue.project.name } : {}),
             ...(issue.delegate?.id ? { delegateId: issue.delegate.id } : {}),
             ...(issue.delegate?.name ? { delegateName: issue.delegate.name } : {}),
             workflowStates: (issue.team?.states?.nodes ?? []).map((state) => ({

package/dist/linear-session-reporting.js

@@ -42,6 +42,16 @@ export function buildAlreadyRunningThought(runType) {
         body: `PatchRelay is already working on the ${lowerRunTypeLabel(runType)} workflow.`,
     };
 }
+export function buildBlockedDelegationActivity(blockedByKeys = []) {
+    const blockers = blockedByKeys.filter((key) => key.trim().length > 0);
+    const blockerText = blockers.length > 0
+        ? ` Waiting on ${blockers.join(", ")}.`
+        : " Waiting for blocker issues to complete.";
+    return {
+        type: "response",
+        body: `PatchRelay accepted this delegation and will not start implementation until the issue is unblocked.${blockerText}`,
+    };
+}
 export function buildPromptDeliveredThought(runType) {
     return {
         type: "thought",

package/dist/project-resolution.js

@@ -11,12 +11,30 @@ function matchesProject(issue, project) {
     return false;
 }
 export function resolveProject(config, issue) {
+    if (issue.projectId) {
+        const projectMatches = config.projects.filter((project) => matchesLinearProject(issue, project));
+        if (projectMatches.length === 1) {
+            return projectMatches[0];
+        }
+        if (projectMatches.length > 1) {
+            return undefined;
+        }
+    }
     const matches = config.projects.filter((project) => matchesProject(issue, project));
     if (matches.length === 1) {
         return matches[0];
     }
     return undefined;
 }
+function matchesLinearProject(issue, project) {
+    if (!issue.projectId || !project.linearProjectIds.includes(issue.projectId)) {
+        return false;
+    }
+    if (project.linearTeamIds.length === 0 || !issue.teamId) {
+        return true;
+    }
+    return project.linearTeamIds.includes(issue.teamId);
+}
 export function triggerEventAllowed(project, triggerEvent) {
     return project.triggerEvents.includes(triggerEvent);
 }

package/dist/webhooks/agent-session-handler.js

@@ -1,6 +1,6 @@
 import { buildAgentSessionPlanForIssue, } from "../agent-session-plan.js";
 import { buildAgentSessionExternalUrls } from "../agent-session-presentation.js";
-import { buildAlreadyRunningThought, buildDelegationThought, buildPromptDeliveredThought, buildStopConfirmationActivity, } from "../linear-session-reporting.js";
+import { buildAlreadyRunningThought, buildBlockedDelegationActivity, buildDelegationThought, buildPromptDeliveredThought, buildStopConfirmationActivity, } from "../linear-session-reporting.js";
 import { triggerEventAllowed } from "../project-resolution.js";
 export class AgentSessionHandler {
     config;
@@ -47,6 +47,12 @@ export class AgentSessionHandler {
                 await this.publishAgentActivity(linear, normalized.agentSession.id, buildAlreadyRunningThought(activeRun.runType));
                 return;
             }
+            if ((trackedIssue?.blockedByCount ?? 0) > 0) {
+                const latestIssue = this.db.issues.getIssue(project.id, normalized.issue.id);
+                await this.syncAgentSession(linear, normalized.agentSession.id, latestIssue ?? trackedIssue, params.peekPendingSessionWakeRunType);
+                await this.publishAgentActivity(linear, normalized.agentSession.id, buildBlockedDelegationActivity(trackedIssue?.blockedByKeys));
+                return;
+            }
             if (!trackedIssue?.blockedByCount) {
                 await this.publishAgentActivity(linear, normalized.agentSession.id, {
                     type: "elicitation",

package/dist/webhooks/decision-helpers.js

@@ -113,6 +113,8 @@ export function mergeIssueMetadata(issue, liveIssue) {
         ...(issue.attachments && issue.attachments.length > 0 ? {} : liveIssue.attachments ? { attachments: liveIssue.attachments } : {}),
         ...(issue.teamId ? {} : liveIssue.teamId ? { teamId: liveIssue.teamId } : {}),
         ...(issue.teamKey ? {} : liveIssue.teamKey ? { teamKey: liveIssue.teamKey } : {}),
+        ...(issue.projectId ? {} : liveIssue.projectId ? { projectId: liveIssue.projectId } : {}),
+        ...(issue.projectName ? {} : liveIssue.projectName ? { projectName: liveIssue.projectName } : {}),
         ...(issue.stateId ? {} : liveIssue.stateId ? { stateId: liveIssue.stateId } : {}),
         ...(issue.stateName ? {} : liveIssue.stateName ? { stateName: liveIssue.stateName } : {}),
         ...(issue.stateType ? {} : liveIssue.stateType ? { stateType: liveIssue.stateType } : {}),

package/dist/webhooks.js

@@ -200,8 +200,11 @@ function extractIssueMetadata(payload) {
     const title = getString(issueRecord, "title");
     const url = getString(issueRecord, "url") ?? payload.url;
     const delegateRecord = asRecord(issueRecord.delegate);
+    const projectRecord = asRecord(issueRecord.project);
     const teamId = getString(issueRecord, "teamId") ?? getString(teamRecord ?? {}, "id");
     const teamKey = getString(teamRecord ?? {}, "key");
+    const projectId = getString(issueRecord, "projectId") ?? getString(projectRecord ?? {}, "id");
+    const projectName = getString(projectRecord ?? {}, "name");
     const stateRecord = asRecord(issueRecord.state);
     const stateId = getString(issueRecord, "stateId") ?? getString(stateRecord ?? {}, "id");
     const stateName = getString(stateRecord ?? {}, "name");
@@ -227,6 +230,8 @@ function extractIssueMetadata(payload) {
         ...(url ? { url } : {}),
         ...(teamId ? { teamId } : {}),
         ...(teamKey ? { teamKey } : {}),
+        ...(projectId ? { projectId } : {}),
+        ...(projectName ? { projectName } : {}),
         ...(stateId ? { stateId } : {}),
         ...(stateName ? { stateName } : {}),
         ...(stateType ? { stateType } : {}),

package/package.json

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