patchrelay 0.2.0 → 0.4.0

package/dist/db/migrations.js

@@ -91,6 +91,23 @@ CREATE TABLE IF NOT EXISTS run_leases (
   FOREIGN KEY(trigger_receipt_id) REFERENCES event_receipts(id) ON DELETE SET NULL
 );
 
+CREATE TABLE IF NOT EXISTS issue_sessions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL,
+  linear_issue_id TEXT NOT NULL,
+  workspace_ownership_id INTEGER NOT NULL,
+  run_lease_id INTEGER,
+  thread_id TEXT NOT NULL UNIQUE,
+  parent_thread_id TEXT,
+  source TEXT NOT NULL,
+  linked_agent_session_id TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  last_opened_at TEXT,
+  FOREIGN KEY(workspace_ownership_id) REFERENCES workspace_ownership(id) ON DELETE CASCADE,
+  FOREIGN KEY(run_lease_id) REFERENCES run_leases(id) ON DELETE SET NULL
+);
+
 CREATE TABLE IF NOT EXISTS run_reports (
   run_lease_id INTEGER PRIMARY KEY,
   summary_json TEXT,
@@ -170,6 +187,8 @@ CREATE TABLE IF NOT EXISTS oauth_states (
 CREATE INDEX IF NOT EXISTS idx_event_receipts_project_issue ON event_receipts(project_id, linear_issue_id);
 CREATE INDEX IF NOT EXISTS idx_issue_control_ready ON issue_control(desired_stage, active_run_lease_id);
 CREATE INDEX IF NOT EXISTS idx_issue_projection_issue_key ON issue_projection(issue_key);
+CREATE INDEX IF NOT EXISTS idx_issue_sessions_issue ON issue_sessions(project_id, linear_issue_id, id DESC);
+CREATE INDEX IF NOT EXISTS idx_issue_sessions_last_opened ON issue_sessions(project_id, linear_issue_id, last_opened_at DESC, id DESC);
 CREATE INDEX IF NOT EXISTS idx_run_leases_active ON run_leases(status, project_id, linear_issue_id);
 CREATE INDEX IF NOT EXISTS idx_run_leases_thread ON run_leases(thread_id);
 CREATE INDEX IF NOT EXISTS idx_run_thread_events_run ON run_thread_events(run_lease_id, id);

package/dist/db/run-report-store.js

@@ -0,0 +1,33 @@
+import { isoNow } from "./shared.js";
+export class RunReportStore {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    saveRunReport(params) {
+        const now = isoNow();
+        this.connection
+            .prepare(`
+        INSERT INTO run_reports (run_lease_id, summary_json, report_json, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?)
+        ON CONFLICT(run_lease_id) DO UPDATE SET
+          summary_json = excluded.summary_json,
+          report_json = excluded.report_json,
+          updated_at = excluded.updated_at
+        `)
+            .run(params.runLeaseId, params.summaryJson ?? null, params.reportJson ?? null, now, now);
+    }
+    getRunReport(runLeaseId) {
+        const row = this.connection.prepare("SELECT * FROM run_reports WHERE run_lease_id = ?").get(runLeaseId);
+        return row ? mapRunReport(row) : undefined;
+    }
+}
+function mapRunReport(row) {
+    return {
+        runLeaseId: Number(row.run_lease_id),
+        ...(row.summary_json === null ? {} : { summaryJson: String(row.summary_json) }),
+        ...(row.report_json === null ? {} : { reportJson: String(row.report_json) }),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}

package/dist/db.js

@@ -1,7 +1,10 @@
 import { AuthoritativeLedgerStore } from "./db/authoritative-ledger-store.js";
+import { IssueProjectionStore } from "./db/issue-projection-store.js";
+import { IssueWorkflowCoordinator } from "./db/issue-workflow-coordinator.js";
 import { IssueWorkflowStore } from "./db/issue-workflow-store.js";
 import { LinearInstallationStore } from "./db/linear-installation-store.js";
 import { runPatchRelayMigrations } from "./db/migrations.js";
+import { RunReportStore } from "./db/run-report-store.js";
 import { StageEventStore } from "./db/stage-event-store.js";
 import { SqliteConnection } from "./db/shared.js";
 import { WebhookEventStore } from "./db/webhook-event-store.js";
@@ -11,10 +14,14 @@ export class PatchRelayDatabase {
     eventReceipts;
     issueControl;
     workspaceOwnership;
+    issueSessions;
     runLeases;
     obligations;
     webhookEvents;
+    issueProjections;
     issueWorkflows;
+    workflowCoordinator;
+    runReports;
     stageEvents;
     linearInstallations;
     constructor(databasePath, wal) {
@@ -27,10 +34,24 @@ export class PatchRelayDatabase {
         this.eventReceipts = this.authoritativeLedger;
         this.issueControl = this.authoritativeLedger;
         this.workspaceOwnership = this.authoritativeLedger;
+        this.issueSessions = this.authoritativeLedger;
         this.runLeases = this.authoritativeLedger;
         this.obligations = this.authoritativeLedger;
         this.webhookEvents = new WebhookEventStore(this.connection);
-        this.issueWorkflows = new IssueWorkflowStore(this.connection);
+        this.issueProjections = new IssueProjectionStore(this.connection);
+        this.runReports = new RunReportStore(this.connection);
+        this.issueWorkflows = new IssueWorkflowStore({
+            authoritativeLedger: this.authoritativeLedger,
+            issueProjections: this.issueProjections,
+            runReports: this.runReports,
+        });
+        this.workflowCoordinator = new IssueWorkflowCoordinator({
+            connection: this.connection,
+            authoritativeLedger: this.authoritativeLedger,
+            issueProjections: this.issueProjections,
+            issueWorkflows: this.issueWorkflows,
+            runReports: this.runReports,
+        });
         this.stageEvents = new StageEventStore(this.connection);
         this.linearInstallations = new LinearInstallationStore(this.connection);
     }

package/dist/index.js

@@ -42,10 +42,19 @@ async function main() {
     const service = new PatchRelayService(config, db, codex, linearProvider, logger);
     await service.start();
     const app = await buildHttpServer(config, service, logger);
-    await app.listen({
-        host: config.server.bind,
-        port: config.server.port,
-    });
+    try {
+        await app.listen({
+            host: config.server.bind,
+            port: config.server.port,
+        });
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "EADDRINUSE") {
+            throw new Error(`Port ${config.server.port} on ${config.server.bind} is already in use. ` +
+                `Another patchrelay process may be running. Check with: ss -tlnp | grep ${config.server.port}`, { cause: error });
+        }
+        throw error;
+    }
     logger.info({
         bind: config.server.bind,
         port: config.server.port,

package/dist/install.js

@@ -193,11 +193,12 @@ export async function upsertProjectInConfig(options) {
     const original = await readFile(configPath, "utf8");
     const parsed = parseConfigObject(original, configPath);
     const existingProjects = Array.isArray(parsed.projects) ? parsed.projects : [];
-    const existingIndex = existingProjects.findIndex((project) => String(project.id ?? "") === projectId);
+    const existingIndex = existingProjects.findIndex((project) => String(project.id ?? "").toLowerCase() === projectId.toLowerCase());
     const existingProject = existingIndex >= 0 ? existingProjects[existingIndex] : undefined;
+    const resolvedProjectId = existingProject ? String(existingProject.id ?? projectId) : projectId;
     const nextProject = {
         ...(existingProject ?? {}),
-        id: projectId,
+        id: resolvedProjectId,
         repo_path: repoPath,
         workflows: Array.isArray(existingProject?.workflows) && existingProject.workflows.length > 0
             ? existingProject.workflows
@@ -293,7 +294,7 @@ export async function upsertProjectInConfig(options) {
         configPath,
         status,
         project: {
-            id: projectId,
+            id: resolvedProjectId,
             repoPath,
             issueKeyPrefixes,
             linearTeamIds,

package/dist/linear-oauth.js

@@ -20,19 +20,20 @@ export async function exchangeLinearOAuthCode(config, params) {
     const response = await fetch(DEFAULT_LINEAR_TOKEN_URL, {
         method: "POST",
         headers: {
-            "content-type": "application/json",
+            "content-type": "application/x-www-form-urlencoded",
         },
-        body: JSON.stringify({
+        body: new URLSearchParams({
             grant_type: "authorization_code",
             code: params.code,
             client_id: config.linear.oauth.clientId,
             client_secret: config.linear.oauth.clientSecret,
             redirect_uri: params.redirectUri,
-        }),
+        }).toString(),
     });
     const payload = (await response.json().catch(() => undefined));
     if (!response.ok || !payload) {
-        throw new Error(`Linear OAuth code exchange failed with HTTP ${response.status}`);
+        const detail = payload?.error ? `: ${String(payload.error)}` : "";
+        throw new Error(`Linear OAuth code exchange failed with HTTP ${response.status}${detail}`);
     }
     const accessToken = typeof payload.access_token === "string" ? payload.access_token : undefined;
     if (!accessToken) {
@@ -53,14 +54,14 @@ export async function refreshLinearOAuthToken(config, refreshToken) {
     const response = await fetch(DEFAULT_LINEAR_TOKEN_URL, {
         method: "POST",
         headers: {
-            "content-type": "application/json",
+            "content-type": "application/x-www-form-urlencoded",
         },
-        body: JSON.stringify({
+        body: new URLSearchParams({
             grant_type: "refresh_token",
             refresh_token: refreshToken,
             client_id: config.linear.oauth.clientId,
             client_secret: config.linear.oauth.clientSecret,
-        }),
+        }).toString(),
     });
     const payload = (await response.json().catch(() => undefined));
     if (!response.ok || !payload) {

package/dist/service-stage-finalizer.js

@@ -114,7 +114,7 @@ export class ServiceStageFinalizer {
                 ...(params.turnId ? { turnId: params.turnId } : {}),
                 nextLifecycleStatus: params.nextLifecycleStatus ?? (issue.desiredStage ? "queued" : "completed"),
             });
-            this.stores.issueWorkflows.finishStageRun({
+            this.stores.workflowCoordinator.finishStageRun({
                 stageRunId: stageRun.id,
                 status,
                 threadId: params.threadId,
@@ -133,7 +133,7 @@ export class ServiceStageFinalizer {
                 failureReason: message,
                 nextLifecycleStatus: "failed",
             });
-            this.stores.issueWorkflows.finishStageRun({
+            this.stores.workflowCoordinator.finishStageRun({
                 stageRunId: stageRun.id,
                 status: "failed",
                 threadId,

package/dist/service-stage-runner.js

@@ -45,7 +45,7 @@ export class ServiceStageRunner {
             return;
         }
         const plan = buildStageLaunchPlan(project, issue, desiredStage);
-        const claim = this.stores.issueWorkflows.claimStageRun({
+        const claim = this.stores.workflowCoordinator.claimStageRun({
             projectId: item.projectId,
             linearIssueId: item.issueId,
             stage: desiredStage,
@@ -83,7 +83,7 @@ export class ServiceStageRunner {
             }, "Failed to launch Codex stage run");
             throw err;
         }
-        this.stores.issueWorkflows.updateStageRunThread({
+        this.stores.workflowCoordinator.updateStageRunThread({
             stageRunId: claim.stageRun.id,
             threadId: threadLaunch.threadId,
             ...(threadLaunch.parentThreadId ? { parentThreadId: threadLaunch.parentThreadId } : {}),
@@ -121,7 +121,7 @@ export class ServiceStageRunner {
             .forProject(project.id)
             .then((linear) => linear?.getIssue(linearIssueId))
             .catch(() => undefined);
-        return this.stores.issueWorkflows.recordDesiredStage({
+        return this.stores.workflowCoordinator.recordDesiredStage({
             projectId: project.id,
             linearIssueId,
             ...(liveIssue?.identifier ? { issueKey: liveIssue.identifier } : existing?.issueKey ? { issueKey: existing.issueKey } : {}),
@@ -168,7 +168,7 @@ export class ServiceStageRunner {
     async markLaunchFailed(project, issue, stageRun, message, threadId) {
         const failureThreadId = threadId ?? `launch-failed-${stageRun.id}`;
         this.runAtomically(() => {
-            this.stores.issueWorkflows.finishStageRun({
+            this.stores.workflowCoordinator.finishStageRun({
                 stageRunId: stageRun.id,
                 status: "failed",
                 threadId: failureThreadId,

package/dist/service.js

@@ -13,6 +13,7 @@ function createServiceStores(db) {
         workspaceOwnership: db.workspaceOwnership,
         runLeases: db.runLeases,
         obligations: db.obligations,
+        workflowCoordinator: db.workflowCoordinator,
         issueWorkflows: db.issueWorkflows,
         stageEvents: db.stageEvents,
         linearInstallations: db.linearInstallations,

package/dist/stage-failure.js

@@ -39,21 +39,14 @@ export async function syncFailedStageToLinear(params) {
     }
     if (fallbackState) {
         await linear.setIssueState(params.stageRun.linearIssueId, fallbackState).catch(() => undefined);
-        params.stores.issueWorkflows.setIssueLifecycleStatus(params.stageRun.projectId, params.stageRun.linearIssueId, "failed");
-        params.stores.issueWorkflows.upsertTrackedIssue({
+        params.stores.workflowCoordinator.upsertTrackedIssue({
             projectId: params.stageRun.projectId,
             linearIssueId: params.stageRun.linearIssueId,
             currentLinearState: fallbackState,
             statusCommentId: params.issue.statusCommentId ?? null,
+            activeAgentSessionId: params.issue.activeAgentSessionId ?? null,
             lifecycleStatus: "failed",
         });
-        params.stores.issueControl.upsertIssueControl({
-            projectId: params.stageRun.projectId,
-            linearIssueId: params.stageRun.linearIssueId,
-            lifecycleStatus: "failed",
-            ...(params.issue.statusCommentId ? { serviceOwnedCommentId: params.issue.statusCommentId } : {}),
-            ...(params.issue.activeAgentSessionId ? { activeAgentSessionId: params.issue.activeAgentSessionId } : {}),
-        });
     }
     const result = await linear
         .upsertIssueComment({
@@ -69,14 +62,7 @@ export async function syncFailedStageToLinear(params) {
     })
         .catch(() => undefined);
     if (result) {
-        params.stores.issueWorkflows.setIssueStatusComment(params.stageRun.projectId, params.stageRun.linearIssueId, result.id);
-        params.stores.issueControl.upsertIssueControl({
-            projectId: params.stageRun.projectId,
-            linearIssueId: params.stageRun.linearIssueId,
-            serviceOwnedCommentId: result.id,
-            lifecycleStatus: "failed",
-            ...(params.issue.activeAgentSessionId ? { activeAgentSessionId: params.issue.activeAgentSessionId } : {}),
-        });
+        params.stores.workflowCoordinator.setIssueStatusComment(params.stageRun.projectId, params.stageRun.linearIssueId, result.id);
     }
     if (params.issue.activeAgentSessionId) {
         await linear

package/dist/stage-lifecycle-publisher.js

@@ -26,18 +26,12 @@ export class StageLifecyclePublisher {
                 ...(labels.remove.length > 0 ? { removeNames: labels.remove } : {}),
             });
         }
-        this.stores.issueWorkflows.upsertTrackedIssue({
+        this.stores.workflowCoordinator.upsertTrackedIssue({
             projectId: stageRun.projectId,
             linearIssueId: stageRun.linearIssueId,
             currentLinearState: activeState,
             statusCommentId: issue.statusCommentId ?? null,
-            lifecycleStatus: "running",
-        });
-        this.stores.issueControl.upsertIssueControl({
-            projectId: stageRun.projectId,
-            linearIssueId: stageRun.linearIssueId,
-            ...(issue.statusCommentId ? { serviceOwnedCommentId: issue.statusCommentId } : {}),
-            ...(issue.activeAgentSessionId ? { activeAgentSessionId: issue.activeAgentSessionId } : {}),
+            activeAgentSessionId: issue.activeAgentSessionId ?? null,
             lifecycleStatus: "running",
         });
     }
@@ -62,13 +56,7 @@ export class StageLifecyclePublisher {
                     branchName: workspace.branchName,
                 }),
             });
-            this.stores.issueWorkflows.setIssueStatusComment(projectId, issueId, result.id);
-            this.stores.issueControl.upsertIssueControl({
-                projectId,
-                linearIssueId: issueId,
-                serviceOwnedCommentId: result.id,
-                lifecycleStatus: issue.lifecycleStatus,
-            });
+            this.stores.workflowCoordinator.setIssueStatusComment(projectId, issueId, result.id);
         }
         catch (error) {
             this.logger.warn({
@@ -133,12 +121,7 @@ export class StageLifecyclePublisher {
                             ...(labels.remove.length > 0 ? { removeNames: labels.remove } : {}),
                         });
                     }
-                    this.stores.issueWorkflows.setIssueLifecycleStatus(stageRun.projectId, stageRun.linearIssueId, "paused");
-                    this.stores.issueControl.upsertIssueControl({
-                        projectId: stageRun.projectId,
-                        linearIssueId: stageRun.linearIssueId,
-                        lifecycleStatus: "paused",
-                    });
+                    this.stores.workflowCoordinator.setIssueLifecycleStatus(stageRun.projectId, stageRun.linearIssueId, "paused");
                     const finalStageRun = this.stores.issueWorkflows.getStageRun(stageRun.id) ?? stageRun;
                     const result = await linear.upsertIssueComment({
                         issueId: stageRun.linearIssueId,
@@ -149,13 +132,7 @@ export class StageLifecyclePublisher {
                             activeState,
                         }),
                     });
-                    this.stores.issueWorkflows.setIssueStatusComment(stageRun.projectId, stageRun.linearIssueId, result.id);
-                    this.stores.issueControl.upsertIssueControl({
-                        projectId: stageRun.projectId,
-                        linearIssueId: stageRun.linearIssueId,
-                        serviceOwnedCommentId: result.id,
-                        lifecycleStatus: "paused",
-                    });
+                    this.stores.workflowCoordinator.setIssueStatusComment(stageRun.projectId, stageRun.linearIssueId, result.id);
                     await this.publishAgentCompletion(refreshedIssue, {
                         type: "elicitation",
                         body: `PatchRelay finished the ${stageRun.stage} workflow. Move the issue to its next workflow state or leave a follow-up prompt to continue.`,

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

@@ -27,19 +27,18 @@ export class WebhookDesiredStageRecorder {
         const stageAllowed = triggerEventAllowed(project, normalized.triggerEvent);
         const desiredStage = this.resolveDesiredStage(project, normalized, issue, activeStageRun, delegatedToPatchRelay);
         const launchInput = this.resolveLaunchInput(normalized.agentSession);
-        this.persistIssueControlFirst(project.id, normalizedIssue.id, issue, activeStageRun, desiredStage, normalized.agentSession?.id, options?.eventReceiptId);
-        this.stores.issueWorkflows.recordDesiredStage({
+        const refreshedIssue = this.stores.workflowCoordinator.recordDesiredStage({
             projectId: project.id,
             linearIssueId: normalizedIssue.id,
             ...(normalizedIssue.identifier ? { issueKey: normalizedIssue.identifier } : {}),
             ...(normalizedIssue.title ? { title: normalizedIssue.title } : {}),
             ...(normalizedIssue.url ? { issueUrl: normalizedIssue.url } : {}),
             ...(normalizedIssue.stateName ? { currentLinearState: normalizedIssue.stateName } : {}),
+            ...(desiredStage ? { desiredStage } : {}),
+            ...(options?.eventReceiptId !== undefined ? { desiredReceiptId: options.eventReceiptId } : {}),
+            ...(normalized.agentSession?.id ? { activeAgentSessionId: normalized.agentSession.id } : {}),
             lastWebhookAt: new Date().toISOString(),
         });
-        if (normalized.agentSession?.id) {
-            this.stores.issueWorkflows.setIssueActiveAgentSession(project.id, normalizedIssue.id, normalized.agentSession.id);
-        }
         if (launchInput && !activeStageRun && delegatedToPatchRelay && stageAllowed) {
             this.stores.obligations.enqueueObligation({
                 projectId: project.id,
@@ -51,8 +50,6 @@ export class WebhookDesiredStageRecorder {
                 }),
             });
         }
-        const refreshedIssue = this.stores.issueWorkflows.getTrackedIssue(project.id, normalizedIssue.id);
-        this.syncIssueControl(project.id, normalizedIssue.id, refreshedIssue, desiredStage, normalized.agentSession?.id, options?.eventReceiptId);
         return {
             issue: refreshedIssue ?? issue,
             activeStageRun,
@@ -119,32 +116,4 @@ export class WebhookDesiredStageRecorder {
         }
         return undefined;
     }
-    persistIssueControlFirst(projectId, linearIssueId, issue, activeStageRun, desiredStage, activeAgentSessionId, eventReceiptId) {
-        if (!desiredStage) {
-            return;
-        }
-        const lifecycleStatus = issue?.lifecycleStatus ?? "queued";
-        this.stores.issueControl.upsertIssueControl({
-            projectId,
-            linearIssueId,
-            desiredStage,
-            ...(eventReceiptId !== undefined ? { desiredReceiptId: eventReceiptId } : {}),
-            ...(issue?.statusCommentId ? { serviceOwnedCommentId: issue.statusCommentId } : {}),
-            ...(activeAgentSessionId ? { activeAgentSessionId } : {}),
-            lifecycleStatus,
-        });
-    }
-    syncIssueControl(projectId, linearIssueId, issue, desiredStage, activeAgentSessionId, eventReceiptId) {
-        if (!issue) {
-            return;
-        }
-        this.stores.issueControl.upsertIssueControl({
-            projectId,
-            linearIssueId,
-            ...(desiredStage ? { desiredStage } : {}),
-            ...(eventReceiptId !== undefined && desiredStage ? { desiredReceiptId: eventReceiptId } : {}),
-            ...(activeAgentSessionId ? { activeAgentSessionId } : {}),
-            lifecycleStatus: issue.lifecycleStatus,
-        });
-    }
 }

package/infra/patchrelay.path

@@ -6,6 +6,8 @@ Unit=patchrelay-reload.service
 PathChanged=/home/your-user/.config/patchrelay/runtime.env
 PathChanged=/home/your-user/.config/patchrelay/service.env
 PathChanged=/home/your-user/.config/patchrelay/patchrelay.json
+TriggerLimitIntervalSec=5
+TriggerLimitBurst=1
 
 [Install]
 WantedBy=default.target

package/infra/patchrelay.service

@@ -2,6 +2,8 @@
 Description=PatchRelay (systemd user service)
 After=network-online.target
 Wants=network-online.target
+StartLimitIntervalSec=60
+StartLimitBurst=8
 
 [Service]
 Type=simple

package/package.json

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