patchrelay 0.54.3 → 0.55.0

package/README.md

@@ -8,9 +8,9 @@ This repository ships **three independent services**. Install one, two, or all t
 
 | Service | Package | Role |
 |-|-|-|
-| [`patchrelay`](./) | `npm install -g patchrelay` | Linear-driven harness that runs Codex sessions inside your real repos. Fully autonomous on webhooks: implementation, review fix, CI repair, queue repair. |
-| [`review-quill`](./packages/review-quill) | `npm install -g review-quill` | GitHub PR review bot. Reviews every merge-ready head from a real local checkout and posts a normal `APPROVE` / `REQUEST_CHANGES` review. |
-| [`merge-steward`](./packages/merge-steward) | `npm install -g merge-steward` | Serial merge queue. Speculatively integrates approved PRs on top of the latest `main`, runs CI on the integrated SHA, and fast-forwards `main` only when that tested result is green. |
+| [`patchrelay`](./) | `pnpm add -g patchrelay` | Linear-driven harness that runs Codex sessions inside your real repos. Fully autonomous on webhooks: implementation, review fix, CI repair, queue repair. |
+| [`review-quill`](./packages/review-quill) | `pnpm add -g review-quill` | GitHub PR review bot. Reviews every merge-ready head from a real local checkout and posts a normal `APPROVE` / `REQUEST_CHANGES` review. |
+| [`merge-steward`](./packages/merge-steward) | `pnpm add -g merge-steward` | Serial merge queue. Speculatively integrates approved PRs on top of the latest `main`, runs CI on the integrated SHA, and fast-forwards `main` only when that tested result is green. |
 
 Common setups:
 
@@ -22,7 +22,7 @@ Common setups:
 
 - **PRs ship tested against the latest `main`.** The queue re-validates on the integrated SHA at admission time, and retries if `main` moves during validation. No more "green yesterday, broken today."
 - **Many PR failures have mechanical fixes an agent can handle.** Requested changes like a rename, a missing null check, a new test, refreshing against `main`, resolving a conflict surfaced by speculation, or rerunning a flaky job. Both services publish structured failure reasons (inline review comments, failing check names, queue incidents) an agent can act on directly.
-- **No prerequisites beyond GitHub.** A GitHub App, a webhook, and `npm install -g` per service.
+- **No prerequisites beyond GitHub.** A GitHub App, a webhook, and `pnpm add -g` per service.
 
 ## Use with your own agent
 
@@ -45,7 +45,7 @@ Prerequisites:
 - a public HTTPS entrypoint (Caddy, nginx, tunnel) so Linear and GitHub can reach your webhooks
 
 ```bash
-npm install -g patchrelay
+pnpm add -g patchrelay
 patchrelay init https://patchrelay.example.com
 ```
 
@@ -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
@@ -119,7 +121,7 @@ See the [merge-steward package README](./packages/merge-steward/README.md) for t
 - [Prompting](./docs/prompting.md) — how workflow files and the built-in scaffold compose
 - [Secrets](./docs/secrets.md) — systemd credentials, resolution order
 - [review-quill reference](./docs/review-quill.md) · [merge-steward reference](./docs/merge-steward.md)
-- [Product brief](./docs/product-specs/patchrelay.md) · [Dashboard guidance](./docs/dashboard-guidance.md) · [Design docs](./docs/design-docs/index.md)
+- [Dashboard guidance](./docs/dashboard-guidance.md) · [Design docs](./docs/design-docs/index.md)
 - [Contributing](./CONTRIBUTING.md) · [Security policy](./SECURITY.md)
 
 ## Status

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.54.3",
-  "commit": "83c6b1f9e9e3",
-  "builtAt": "2026-04-30T08:20:16.706Z"
+  "version": "0.55.0",
+  "commit": "bd44ea445936",
+  "builtAt": "2026-05-01T12:06:57.419Z"
 }

package/dist/cli/watch/IssueListView.js

@@ -4,25 +4,16 @@ import { Box, Text, useStdout } from "ink";
 import { IssueRow } from "./IssueRow.js";
 import { StatusBar } from "./StatusBar.js";
 import { HelpBar } from "./HelpBar.js";
-const CHROME_ROWS = 3;
+import { computeIssueListLayout, computeVisibleIssueParts, computeVisibleWindowForTotal } from "./list-layout.js";
 export function computeVisibleWindow(issues, selectedIndex, maxRows) {
-    if (issues.length === 0)
-        return { start: 0, end: 0 };
-    const clamped = Math.max(0, Math.min(selectedIndex, issues.length - 1));
-    const half = Math.floor(maxRows / 2);
-    let start = Math.max(0, clamped - half);
-    let end = Math.min(issues.length, start + maxRows);
-    if (end - start < maxRows) {
-        start = Math.max(0, end - maxRows);
-    }
-    return { start, end };
+    return computeVisibleWindowForTotal(issues.length, selectedIndex, maxRows);
 }
 export function IssueListView({ issues, selectedIndex, connected, lastServerMessageAt, filter, frozen, compact = false, }) {
     const { stdout } = useStdout();
     const cols = stdout?.columns ?? 80;
-    const rows = stdout?.rows ?? 24;
+    const rows = Math.max(1, stdout?.rows ?? 24);
     const titleWidth = Math.max(0, cols - 42);
-    const maxVisibleRows = Math.max(1, rows - CHROME_ROWS);
+    const layout = computeIssueListLayout(rows);
     const [, tick] = useReducer((c) => c + 1, 0);
     useEffect(() => {
         if (frozen)
@@ -30,9 +21,9 @@ export function IssueListView({ issues, selectedIndex, connected, lastServerMess
         const id = setInterval(tick, 5000);
         return () => clearInterval(id);
     }, [frozen]);
-    const { start: startIndex, end: endIndex } = computeVisibleWindow(issues, selectedIndex, maxVisibleRows);
+    const { start: startIndex, end: endIndex, showAbove, showBelow, } = computeVisibleIssueParts(issues.length, selectedIndex, layout.bodyRows);
     const visible = issues.slice(startIndex, endIndex);
     const hiddenAbove = startIndex;
     const hiddenBelow = Math.max(0, issues.length - endIndex);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatusBar, { filter: filter, connected: connected, lastServerMessageAt: lastServerMessageAt, frozen: frozen ?? false }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: issues.length === 0 ? (_jsx(Text, { dimColor: true, children: " " })) : (_jsxs(_Fragment, { children: [hiddenAbove > 0 ? _jsx(Text, { dimColor: true, children: `  ↑${hiddenAbove}` }) : null, visible.map((issue, i) => (_jsx(IssueRow, { issue: issue, selected: startIndex + i === selectedIndex, titleWidth: titleWidth, compact: compact }, issue.issueKey ?? `${issue.projectId}-${startIndex + i}`))), hiddenBelow > 0 ? _jsx(Text, { dimColor: true, children: `  ↓${hiddenBelow}` }) : null] })) }), _jsx(Box, { marginTop: 1, children: _jsx(HelpBar, { view: "list" }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatusBar, { filter: filter, connected: connected, lastServerMessageAt: lastServerMessageAt, frozen: frozen ?? false }), _jsx(Box, { marginTop: layout.showBodyGap ? 1 : 0, flexDirection: "column", children: issues.length === 0 ? (_jsx(Text, { dimColor: true, children: " " })) : (_jsxs(_Fragment, { children: [showAbove ? _jsx(Text, { dimColor: true, children: `  ↑${hiddenAbove}` }) : null, visible.map((issue, i) => (_jsx(IssueRow, { issue: issue, selected: startIndex + i === selectedIndex, titleWidth: titleWidth, compact: compact }, issue.issueKey ?? `${issue.projectId}-${startIndex + i}`))), showBelow ? _jsx(Text, { dimColor: true, children: `  ↓${hiddenBelow}` }) : null] })) }), layout.showHelp ? (_jsx(Box, { marginTop: 1, children: _jsx(HelpBar, { view: "list" }) })) : null] }));
 }

package/dist/cli/watch/list-layout.js

@@ -0,0 +1,44 @@
+export function computeIssueListLayout(totalRows) {
+    const rows = Math.max(1, totalRows);
+    const showBodyGap = rows >= 5;
+    const showHelp = rows >= 8;
+    const chromeRows = 1 + (showBodyGap ? 1 : 0) + (showHelp ? 2 : 0);
+    return {
+        bodyRows: Math.max(1, rows - chromeRows),
+        showBodyGap,
+        showHelp,
+    };
+}
+export function computeVisibleWindowForTotal(total, selectedIndex, maxRows) {
+    if (total === 0)
+        return { start: 0, end: 0 };
+    const clamped = Math.max(0, Math.min(selectedIndex, total - 1));
+    const half = Math.floor(maxRows / 2);
+    let start = Math.max(0, clamped - half);
+    let end = Math.min(total, start + maxRows);
+    if (end - start < maxRows) {
+        start = Math.max(0, end - maxRows);
+    }
+    return { start, end };
+}
+export function computeVisibleIssueParts(total, selectedIndex, rowBudget) {
+    if (total === 0 || rowBudget <= 0) {
+        return { start: 0, end: 0, showAbove: false, showBelow: false };
+    }
+    let { start, end } = computeVisibleWindowForTotal(total, selectedIndex, Math.max(1, rowBudget));
+    let hiddenAbove = start > 0;
+    let hiddenBelow = end < total;
+    if (rowBudget >= 3 && (hiddenAbove || hiddenBelow)) {
+        const indicatorRows = (hiddenAbove ? 1 : 0) + (hiddenBelow ? 1 : 0);
+        ({ start, end } = computeVisibleWindowForTotal(total, selectedIndex, Math.max(1, rowBudget - indicatorRows)));
+        hiddenAbove = start > 0;
+        hiddenBelow = end < total;
+    }
+    const usedRows = end - start;
+    let remaining = Math.max(0, rowBudget - usedRows);
+    const showAbove = hiddenAbove && remaining > 0;
+    if (showAbove)
+        remaining -= 1;
+    const showBelow = hiddenBelow && remaining > 0;
+    return { start, end, showAbove, showBelow };
+}

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.3",
+  "version": "0.55.0",
   "license": "MIT",
   "type": "module",
   "repository": {