patchrelay 0.7.9 → 0.8.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "service": "patchrelay",
-  "version": "0.7.9",
-  "commit": "9f2abbe93f17",
-  "builtAt": "2026-03-17T10:42:10.173Z"
+  "version": "0.8.0",
+  "commit": "c4fcada0fce7",
+  "builtAt": "2026-03-18T10:29:36.175Z"
 }

package/dist/cli/commands/feed.js

@@ -15,23 +15,30 @@ function parseLimit(value) {
     }
     return parsed;
 }
+function readOptionalStringFlag(parsed, name) {
+    const value = parsed.flags.get(name);
+    if (value === true) {
+        throw new Error(`--${name} requires a value.`);
+    }
+    return typeof value === "string" ? value.trim() || undefined : undefined;
+}
 export async function handleFeedCommand(params) {
     const limit = parseLimit(params.parsed.flags.get("limit"));
     const follow = params.parsed.flags.get("follow") === true;
-    const issueFlag = params.parsed.flags.get("issue");
-    const projectFlag = params.parsed.flags.get("project");
-    if (issueFlag === true) {
-        throw new Error("--issue requires a value.");
-    }
-    if (projectFlag === true) {
-        throw new Error("--project requires a value.");
-    }
-    const issueKey = typeof issueFlag === "string" ? issueFlag.trim() || undefined : undefined;
-    const projectId = typeof projectFlag === "string" ? projectFlag.trim() || undefined : undefined;
+    const issueKey = readOptionalStringFlag(params.parsed, "issue");
+    const projectId = readOptionalStringFlag(params.parsed, "project");
+    const kind = readOptionalStringFlag(params.parsed, "kind");
+    const stage = readOptionalStringFlag(params.parsed, "stage");
+    const status = readOptionalStringFlag(params.parsed, "status");
+    const workflowId = readOptionalStringFlag(params.parsed, "workflow");
     const query = {
         limit,
         ...(issueKey ? { issueKey } : {}),
         ...(projectId ? { projectId } : {}),
+        ...(kind ? { kind } : {}),
+        ...(stage ? { stage } : {}),
+        ...(status ? { status } : {}),
+        ...(workflowId ? { workflowId } : {}),
     };
     if (!follow) {
         const result = await params.data.listOperatorFeed(query);

package/dist/cli/formatters/text.js

@@ -134,26 +134,39 @@ function formatFeedStatus(event, color) {
     if (event.level === "error" || raw === "failed" || raw === "delivery_failed") {
         return colorize(color, "31", padded);
     }
-    if (event.level === "warn" || raw === "ignored" || raw === "fallback" || raw === "handoff") {
+    if (event.level === "warn" || raw === "ignored" || raw === "fallback" || raw === "handoff" || raw === "transition_suppressed") {
         return colorize(color, "33", padded);
     }
-    if (raw === "running" || raw === "started" || raw === "delegated") {
+    if (raw === "running" || raw === "started" || raw === "delegated" || raw === "transition_chosen" || raw === "completed") {
         return colorize(color, "32", padded);
     }
-    if (raw === "queued") {
+    if (raw === "queued" || raw === "selected") {
         return colorize(color, "36", padded);
     }
     return colorize(color, "2", padded);
 }
+function formatFeedMeta(event, color) {
+    const parts = [
+        event.workflowId ? `workflow:${event.workflowId}` : undefined,
+        event.stage ? `stage:${event.stage}` : undefined,
+        event.nextStage ? `next:${event.nextStage}` : undefined,
+    ].filter(Boolean);
+    if (parts.length === 0) {
+        return undefined;
+    }
+    return colorize(color, "2", `[${parts.join(" ")}]`);
+}
 export function formatOperatorFeedEvent(event, options) {
     const color = options?.color === true;
     const timestamp = new Date(event.at).toLocaleTimeString("en-GB", { hour12: false });
     const issue = event.issueKey ?? event.projectId ?? "-";
+    const meta = formatFeedMeta(event, color);
     const line = [
         colorize(color, "2", timestamp),
         colorize(color, "1", issue.padEnd(10)),
         formatFeedStatus(event, color),
         event.summary,
+        ...(meta ? [meta] : []),
     ].join("  ");
     if (!event.detail) {
         return `${line}\n`;

package/dist/cli/help.js

@@ -37,7 +37,7 @@ export function rootHelpText() {
         "  connect [--project <projectId>] [--no-open] [--timeout <seconds>] [--json]",
         "                                                          Advanced: start or reuse a Linear installation directly",
         "  installations [--json]                                 Show connected Linear installations",
-        "  feed [--follow] [--limit <count>] [--issue <issueKey>] [--project <projectId>] [--json]",
+        "  feed [--follow] [--limit <count>] [--issue <issueKey>] [--project <projectId>] [--kind <kind>] [--stage <stage>] [--status <status>] [--workflow <id>] [--json]",
         "                                                          Show a live operator feed from the daemon",
         "  serve                                                  Run the local PatchRelay service",
         "  inspect <issueKey>                                     Show the latest known issue state",

package/dist/cli/index.js

@@ -88,7 +88,7 @@ function validateFlags(command, commandArgs, parsed) {
             assertKnownFlags(parsed, command, ["json"]);
             return;
         case "feed":
-            assertKnownFlags(parsed, command, ["follow", "limit", "issue", "project", "json"]);
+            assertKnownFlags(parsed, command, ["follow", "limit", "issue", "project", "kind", "stage", "status", "workflow", "json"]);
             return;
         case "install-service":
             assertKnownFlags(parsed, command, ["force", "write-only", "json"]);

package/dist/cli/operator-client.js

@@ -23,6 +23,10 @@ export class CliOperatorApiClient {
             ...(options?.limit && options.limit > 0 ? { limit: String(options.limit) } : {}),
             ...(options?.issueKey ? { issue: options.issueKey } : {}),
             ...(options?.projectId ? { project: options.projectId } : {}),
+            ...(options?.kind ? { kind: options.kind } : {}),
+            ...(options?.stage ? { stage: options.stage } : {}),
+            ...(options?.status ? { status: options.status } : {}),
+            ...(options?.workflowId ? { workflow: options.workflowId } : {}),
         });
     }
     async followOperatorFeed(onEvent, options) {
@@ -37,6 +41,18 @@ export class CliOperatorApiClient {
         if (options?.projectId) {
             url.searchParams.set("project", options.projectId);
         }
+        if (options?.kind) {
+            url.searchParams.set("kind", options.kind);
+        }
+        if (options?.stage) {
+            url.searchParams.set("stage", options.stage);
+        }
+        if (options?.status) {
+            url.searchParams.set("status", options.status);
+        }
+        if (options?.workflowId) {
+            url.searchParams.set("workflow", options.workflowId);
+        }
         const response = await fetch(url, {
             method: "GET",
             headers: {

package/dist/config.js

@@ -5,6 +5,8 @@ import { z } from "zod";
 import { getDefaultConfigPath, getDefaultDatabasePath, getDefaultLogPath, getDefaultRuntimeEnvPath, getDefaultServiceEnvPath, getPatchRelayDataDir, } from "./runtime-paths.js";
 import { ensureAbsolutePath } from "./utils.js";
 const LINEAR_OAUTH_CALLBACK_PATH = "/oauth/linear/callback";
+const REPO_SETTINGS_DIRNAME = ".patchrelay";
+const REPO_SETTINGS_FILENAME = "project.json";
 const workflowSchema = z.object({
     id: z.string().min(1),
     when_state: z.string().min(1),
@@ -12,25 +14,51 @@ const workflowSchema = z.object({
     workflow_file: z.string().min(1),
     fallback_state: z.string().min(1).nullable().optional(),
 });
+const workflowDefinitionSchema = z.object({
+    id: z.string().min(1),
+    stages: z.array(workflowSchema).min(1),
+});
+const workflowSelectionSchema = z.object({
+    default_workflow: z.string().min(1).optional(),
+    by_label: z
+        .array(z.object({
+        label: z.string().min(1),
+        workflow: z.string().min(1),
+    }))
+        .default([]),
+});
+const workflowLabelsSchema = z
+    .object({
+    working: z.string().min(1).optional(),
+    awaiting_handoff: z.string().min(1).optional(),
+})
+    .optional();
+const trustedActorsSchema = z
+    .object({
+    ids: z.array(z.string().min(1)).default([]),
+    names: z.array(z.string().min(1)).default([]),
+    emails: z.array(z.string().email()).default([]),
+    email_domains: z.array(z.string().min(1)).default([]),
+})
+    .optional();
+const repoSettingsSchema = z.object({
+    workflows: z.array(workflowSchema).min(1).optional(),
+    workflow_definitions: z.array(workflowDefinitionSchema).min(1).optional(),
+    workflow_selection: workflowSelectionSchema.optional(),
+    workflow_labels: workflowLabelsSchema,
+    trusted_actors: trustedActorsSchema,
+    trigger_events: z.array(z.string().min(1)).min(1).optional(),
+    branch_prefix: z.string().min(1).optional(),
+});
 const projectSchema = z.object({
     id: z.string().min(1),
     repo_path: z.string().min(1),
     worktree_root: z.string().min(1).optional(),
     workflows: z.array(workflowSchema).min(1).optional(),
-    workflow_labels: z
-        .object({
-        working: z.string().min(1).optional(),
-        awaiting_handoff: z.string().min(1).optional(),
-    })
-        .optional(),
-    trusted_actors: z
-        .object({
-        ids: z.array(z.string().min(1)).default([]),
-        names: z.array(z.string().min(1)).default([]),
-        emails: z.array(z.string().email()).default([]),
-        email_domains: z.array(z.string().min(1)).default([]),
-    })
-        .optional(),
+    workflow_definitions: z.array(workflowDefinitionSchema).min(1).optional(),
+    workflow_selection: workflowSelectionSchema.optional(),
+    workflow_labels: workflowLabelsSchema,
+    trusted_actors: trustedActorsSchema,
     issue_key_prefixes: z.array(z.string().min(1)).default([]),
     linear_team_ids: z.array(z.string().min(1)).default([]),
     allow_labels: z.array(z.string().min(1)).default([]),
@@ -134,6 +162,12 @@ const builtinWorkflows = [
         fallback_state: "Human Needed",
     },
 ];
+const builtinWorkflowDefinitions = [
+    {
+        id: "default",
+        stages: builtinWorkflows,
+    },
+];
 function withSectionDefaults(input) {
     const source = input && typeof input === "object" ? input : {};
     const { linear: _linear, runner: _runner, ...rest } = source;
@@ -159,6 +193,9 @@ function withSectionDefaults(input) {
         },
     };
 }
+function resolveRepoSettingsPath(repoPath) {
+    return path.join(repoPath, REPO_SETTINGS_DIRNAME, REPO_SETTINGS_FILENAME);
+}
 function expandEnv(value, env) {
     if (typeof value === "string") {
         return value.replace(/\$\{([A-Z0-9_]+)(?::-(.*?))?\}/g, (_match, name, fallback) => {
@@ -230,6 +267,72 @@ function readEnvFilesForProfile(configPath, profile) {
 function resolveWorkflowFilePath(repoPath, workflowFile) {
     return path.isAbsolute(workflowFile) ? ensureAbsolutePath(workflowFile) : path.resolve(repoPath, workflowFile);
 }
+function parseJsonFile(filePath, label) {
+    const raw = readFileSync(filePath, "utf8");
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid JSON ${label}: ${filePath}: ${message}`, {
+            cause: error,
+        });
+    }
+}
+function readRepoSettings(repoPath, env) {
+    const configPath = resolveRepoSettingsPath(repoPath);
+    if (!existsSync(configPath)) {
+        return undefined;
+    }
+    const parsed = repoSettingsSchema.parse(expandEnv(parseJsonFile(configPath, "repo settings file"), env));
+    return {
+        ...parsed,
+        configPath,
+    };
+}
+function mergeWorkflowStages(repoPath, workflows) {
+    return workflows.map((workflow) => ({
+        id: workflow.id,
+        whenState: workflow.when_state,
+        activeState: workflow.active_state,
+        workflowFile: resolveWorkflowFilePath(repoPath, workflow.workflow_file),
+        ...(workflow.fallback_state ? { fallbackState: workflow.fallback_state } : {}),
+    }));
+}
+function mergeWorkflowDefinitions(repoPath, definitions) {
+    return definitions.map((definition) => ({
+        id: definition.id,
+        stages: mergeWorkflowStages(repoPath, definition.stages),
+    }));
+}
+function resolveProjectWorkflowConfig(repoPath, project, repoSettings) {
+    const selectedDefinitions = repoSettings?.workflow_definitions ??
+        project.workflow_definitions ??
+        (repoSettings?.workflows
+            ? [{ id: "default", stages: repoSettings.workflows }]
+            : project.workflows
+                ? [{ id: "default", stages: project.workflows }]
+                : builtinWorkflowDefinitions.map((definition) => ({ id: definition.id, stages: [...definition.stages] })));
+    const workflowDefinitions = mergeWorkflowDefinitions(repoPath, selectedDefinitions);
+    const selectionSource = repoSettings?.workflow_selection ?? project.workflow_selection;
+    const defaultWorkflowId = selectionSource?.default_workflow ?? workflowDefinitions[0]?.id;
+    const workflows = workflowDefinitions.find((definition) => definition.id === defaultWorkflowId)?.stages ?? workflowDefinitions[0]?.stages ?? [];
+    return {
+        workflows,
+        ...(workflowDefinitions.length > 0 ? { workflowDefinitions } : {}),
+        ...(defaultWorkflowId || (selectionSource?.by_label?.length ?? 0) > 0
+            ? {
+                workflowSelection: {
+                    ...(defaultWorkflowId ? { defaultWorkflowId } : {}),
+                    byLabel: (selectionSource?.by_label ?? []).map((entry) => ({
+                        label: entry.label,
+                        workflowId: entry.workflow,
+                    })),
+                },
+            }
+            : {}),
+    };
+}
 function defaultWorktreeRoot(projectId) {
     return path.join(getPatchRelayDataDir(), "worktrees", projectId);
 }
@@ -260,15 +363,6 @@ function deriveLinearOAuthRedirectUri(server) {
     const host = normalizeLocalRedirectHost(server.bind);
     return new URL(LINEAR_OAUTH_CALLBACK_PATH, `http://${formatUrlHost(host)}:${server.port}`).toString();
 }
-function mergeWorkflows(repoPath, workflows) {
-    return workflows.map((workflow) => ({
-        id: workflow.id,
-        whenState: workflow.when_state,
-        activeState: workflow.active_state,
-        workflowFile: resolveWorkflowFilePath(repoPath, workflow.workflow_file),
-        ...(workflow.fallback_state ? { fallbackState: workflow.fallback_state } : {}),
-    }));
-}
 export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefaultConfigPath(), options) {
     const requestedPath = ensureAbsolutePath(configPath);
     if (!existsSync(requestedPath)) {
@@ -280,17 +374,7 @@ export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefa
         ...adjacentEnv,
         ...process.env,
     };
-    const raw = readFileSync(requestedPath, "utf8");
-    let parsedFile;
-    try {
-        parsedFile = JSON.parse(raw);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Invalid JSON config file: ${requestedPath}: ${message}`, {
-            cause: error,
-        });
-    }
+    const parsedFile = parseJsonFile(requestedPath, "config file");
     const parsed = configSchema.parse(withSectionDefaults(expandEnv(parsedFile, env)));
     const requirements = getLoadProfileRequirements(profile);
     const webhookSecret = env[parsed.linear.webhook_secret_env];
@@ -373,35 +457,43 @@ export function loadConfig(configPath = process.env.PATCHRELAY_CONFIG ?? getDefa
         },
         projects: parsed.projects.map((project) => {
             const repoPath = ensureAbsolutePath(project.repo_path);
+            const repoSettings = readRepoSettings(repoPath, env);
+            const workflowConfig = resolveProjectWorkflowConfig(repoPath, project, repoSettings);
+            const workflowLabels = repoSettings?.workflow_labels ?? project.workflow_labels;
+            const trustedActors = repoSettings?.trusted_actors ?? project.trusted_actors;
             return {
                 id: project.id,
                 repoPath,
                 worktreeRoot: ensureAbsolutePath(project.worktree_root ?? defaultWorktreeRoot(project.id)),
-                workflows: mergeWorkflows(repoPath, project.workflows ?? builtinWorkflows),
-                ...(project.workflow_labels
+                workflows: workflowConfig.workflows,
+                ...(workflowConfig.workflowDefinitions ? { workflowDefinitions: workflowConfig.workflowDefinitions } : {}),
+                ...(workflowConfig.workflowSelection ? { workflowSelection: workflowConfig.workflowSelection } : {}),
+                ...(workflowLabels
                     ? {
                         workflowLabels: {
-                            ...(project.workflow_labels.working ? { working: project.workflow_labels.working } : {}),
-                            ...(project.workflow_labels.awaiting_handoff ? { awaitingHandoff: project.workflow_labels.awaiting_handoff } : {}),
+                            ...(workflowLabels.working ? { working: workflowLabels.working } : {}),
+                            ...(workflowLabels.awaiting_handoff ? { awaitingHandoff: workflowLabels.awaiting_handoff } : {}),
                         },
                     }
                     : {}),
-                ...(project.trusted_actors
+                ...(trustedActors
                     ? {
                         trustedActors: {
-                            ids: project.trusted_actors.ids,
-                            names: project.trusted_actors.names,
-                            emails: project.trusted_actors.emails,
-                            emailDomains: project.trusted_actors.email_domains,
+                            ids: trustedActors.ids,
+                            names: trustedActors.names,
+                            emails: trustedActors.emails,
+                            emailDomains: trustedActors.email_domains,
                         },
                     }
                     : {}),
                 issueKeyPrefixes: project.issue_key_prefixes,
                 linearTeamIds: project.linear_team_ids,
                 allowLabels: project.allow_labels,
-                triggerEvents: project.trigger_events ??
+                triggerEvents: repoSettings?.trigger_events ??
+                    project.trigger_events ??
                     defaultTriggerEvents(parsed.linear.oauth.actor),
-                branchPrefix: project.branch_prefix ?? defaultBranchPrefix(project.id),
+                branchPrefix: repoSettings?.branch_prefix ?? project.branch_prefix ?? defaultBranchPrefix(project.id),
+                ...(repoSettings?.configPath ? { repoSettingsPath: repoSettings.configPath } : {}),
             };
         }),
     };
@@ -467,19 +559,40 @@ function validateConfigSemantics(config, options) {
             }
             linearTeamIds.set(teamId, project.id);
         }
-        const workflowIds = new Set();
-        const workflowStates = new Set();
-        for (const workflow of project.workflows) {
-            const normalizedWorkflowId = workflow.id.trim().toLowerCase();
-            if (workflowIds.has(normalizedWorkflowId)) {
-                throw new Error(`Workflow id "${workflow.id}" is configured more than once in project ${project.id}`);
+        const workflowDefinitions = project.workflowDefinitions ?? [{ id: "default", stages: project.workflows }];
+        const definitionIds = new Set();
+        for (const definition of workflowDefinitions) {
+            const normalizedDefinitionId = definition.id.trim().toLowerCase();
+            if (definitionIds.has(normalizedDefinitionId)) {
+                throw new Error(`Workflow definition "${definition.id}" is configured more than once in project ${project.id}`);
+            }
+            definitionIds.add(normalizedDefinitionId);
+            const workflowIds = new Set();
+            const workflowStates = new Set();
+            for (const workflow of definition.stages) {
+                const normalizedWorkflowId = workflow.id.trim().toLowerCase();
+                if (workflowIds.has(normalizedWorkflowId)) {
+                    throw new Error(`Workflow id "${workflow.id}" is configured more than once in project ${project.id}`);
+                }
+                workflowIds.add(normalizedWorkflowId);
+                const normalizedState = workflow.whenState.trim().toLowerCase();
+                if (workflowStates.has(normalizedState)) {
+                    throw new Error(`Linear state "${workflow.whenState}" is configured for more than one workflow in project ${project.id}`);
+                }
+                workflowStates.add(normalizedState);
             }
-            workflowIds.add(normalizedWorkflowId);
-            const normalizedState = workflow.whenState.trim().toLowerCase();
-            if (workflowStates.has(normalizedState)) {
-                throw new Error(`Linear state "${workflow.whenState}" is configured for more than one workflow in project ${project.id}`);
+        }
+        if (project.workflowSelection?.defaultWorkflowId) {
+            const normalizedDefaultWorkflowId = project.workflowSelection.defaultWorkflowId.trim().toLowerCase();
+            if (!workflowDefinitions.some((definition) => definition.id.trim().toLowerCase() === normalizedDefaultWorkflowId)) {
+                throw new Error(`Default workflow "${project.workflowSelection.defaultWorkflowId}" does not exist in project ${project.id}`);
+            }
+        }
+        for (const rule of project.workflowSelection?.byLabel ?? []) {
+            const normalizedWorkflowId = rule.workflowId.trim().toLowerCase();
+            if (!workflowDefinitions.some((definition) => definition.id.trim().toLowerCase() === normalizedWorkflowId)) {
+                throw new Error(`Workflow selection for label "${rule.label}" points to unknown workflow "${rule.workflowId}" in project ${project.id}`);
             }
-            workflowStates.add(normalizedState);
         }
     }
     if (config.operatorApi.enabled &&

package/dist/db/authoritative-ledger-store.js

@@ -54,13 +54,14 @@ export class AuthoritativeLedgerStore {
         this.connection
             .prepare(`
         INSERT INTO issue_control (
-          project_id, linear_issue_id, desired_stage, desired_receipt_id, active_workspace_ownership_id,
+          project_id, linear_issue_id, selected_workflow_id, desired_stage, desired_receipt_id, active_workspace_ownership_id,
           active_run_lease_id, service_owned_comment_id, active_agent_session_id, lifecycle_status, updated_at
         ) VALUES (
-          @projectId, @linearIssueId, @desiredStage, @desiredReceiptId, @activeWorkspaceOwnershipId,
+          @projectId, @linearIssueId, @selectedWorkflowId, @desiredStage, @desiredReceiptId, @activeWorkspaceOwnershipId,
           @activeRunLeaseId, @serviceOwnedCommentId, @activeAgentSessionId, @lifecycleStatus, @updatedAt
         )
         ON CONFLICT(project_id, linear_issue_id) DO UPDATE SET
+          selected_workflow_id = CASE WHEN @setSelectedWorkflowId = 1 THEN @selectedWorkflowId ELSE issue_control.selected_workflow_id END,
           desired_stage = CASE WHEN @setDesiredStage = 1 THEN @desiredStage ELSE issue_control.desired_stage END,
           desired_receipt_id = CASE WHEN @setDesiredReceiptId = 1 THEN @desiredReceiptId ELSE issue_control.desired_receipt_id END,
           active_workspace_ownership_id = CASE WHEN @setActiveWorkspaceOwnershipId = 1 THEN @activeWorkspaceOwnershipId ELSE issue_control.active_workspace_ownership_id END,
@@ -73,6 +74,7 @@ export class AuthoritativeLedgerStore {
             .run({
             projectId: params.projectId,
             linearIssueId: params.linearIssueId,
+            selectedWorkflowId: params.selectedWorkflowId ?? null,
             desiredStage: params.desiredStage ?? null,
             desiredReceiptId: params.desiredReceiptId ?? null,
             activeWorkspaceOwnershipId: params.activeWorkspaceOwnershipId ?? null,
@@ -81,6 +83,7 @@ export class AuthoritativeLedgerStore {
             activeAgentSessionId: params.activeAgentSessionId ?? null,
             lifecycleStatus: params.lifecycleStatus,
             updatedAt: now,
+            setSelectedWorkflowId: Number("selectedWorkflowId" in params),
             setDesiredStage: Number("desiredStage" in params),
             setDesiredReceiptId: Number("desiredReceiptId" in params),
             setActiveWorkspaceOwnershipId: Number("activeWorkspaceOwnershipId" in params),
@@ -452,6 +455,7 @@ function mapIssueControl(row) {
         id: Number(row.id),
         projectId: String(row.project_id),
         linearIssueId: String(row.linear_issue_id),
+        ...(row.selected_workflow_id === null ? {} : { selectedWorkflowId: String(row.selected_workflow_id) }),
         ...(row.desired_stage === null ? {} : { desiredStage: row.desired_stage }),
         ...(row.desired_receipt_id === null ? {} : { desiredReceiptId: Number(row.desired_receipt_id) }),
         ...(row.active_run_lease_id === null ? {} : { activeRunLeaseId: Number(row.active_run_lease_id) }),

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

@@ -31,6 +31,7 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId: params.projectId,
             linearIssueId: params.linearIssueId,
+            ...(params.selectedWorkflowId !== undefined ? { selectedWorkflowId: params.selectedWorkflowId } : {}),
             ...(params.desiredStage !== undefined ? { desiredStage: params.desiredStage } : {}),
             ...(desiredReceiptId !== undefined ? { desiredReceiptId } : {}),
             ...(params.activeWorkspaceId !== undefined ? { activeWorkspaceOwnershipId: params.activeWorkspaceId } : {}),
@@ -69,6 +70,11 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId: params.projectId,
             linearIssueId: params.linearIssueId,
+            ...(params.selectedWorkflowId !== undefined
+                ? { selectedWorkflowId: params.selectedWorkflowId }
+                : existing?.selectedWorkflowId
+                    ? { selectedWorkflowId: existing.selectedWorkflowId }
+                    : {}),
             ...(params.desiredStage !== undefined ? { desiredStage: params.desiredStage } : {}),
             ...(desiredReceiptId !== undefined ? { desiredReceiptId } : {}),
             lifecycleStatus,
@@ -123,6 +129,7 @@ export class IssueWorkflowCoordinator {
             this.authoritativeLedger.upsertIssueControl({
                 projectId: params.projectId,
                 linearIssueId: params.linearIssueId,
+                ...(issue.selectedWorkflowId ? { selectedWorkflowId: issue.selectedWorkflowId } : {}),
                 desiredStage: null,
                 desiredReceiptId: null,
                 activeWorkspaceOwnershipId: workspaceOwnership.id,
@@ -216,6 +223,7 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId,
             linearIssueId,
+            ...(existing?.selectedWorkflowId ? { selectedWorkflowId: existing.selectedWorkflowId } : {}),
             ...(desiredStage !== undefined ? { desiredStage } : { desiredStage: null }),
             ...(desiredReceiptId !== undefined
                 ? { desiredReceiptId }
@@ -236,6 +244,7 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId,
             linearIssueId,
+            ...(existing?.selectedWorkflowId ? { selectedWorkflowId: existing.selectedWorkflowId } : {}),
             lifecycleStatus,
             ...(existing?.desiredStage ? { desiredStage: existing.desiredStage } : {}),
             ...(existingIssueControl?.desiredReceiptId !== undefined ? { desiredReceiptId: existingIssueControl.desiredReceiptId } : {}),
@@ -251,6 +260,7 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId,
             linearIssueId,
+            ...(existing?.selectedWorkflowId ? { selectedWorkflowId: existing.selectedWorkflowId } : {}),
             lifecycleStatus: existing?.lifecycleStatus ?? "idle",
             ...(existing?.desiredStage ? { desiredStage: existing.desiredStage } : {}),
             ...(existingIssueControl?.desiredReceiptId !== undefined ? { desiredReceiptId: existingIssueControl.desiredReceiptId } : {}),
@@ -266,6 +276,7 @@ export class IssueWorkflowCoordinator {
         this.authoritativeLedger.upsertIssueControl({
             projectId,
             linearIssueId,
+            ...(existing?.selectedWorkflowId ? { selectedWorkflowId: existing.selectedWorkflowId } : {}),
             lifecycleStatus: existing?.lifecycleStatus ?? "idle",
             ...(existing?.desiredStage ? { desiredStage: existing.desiredStage } : {}),
             ...(existingIssueControl?.desiredReceiptId !== undefined ? { desiredReceiptId: existingIssueControl.desiredReceiptId } : {}),

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

@@ -107,6 +107,7 @@ export class IssueWorkflowStore {
             id: issueControl?.id ?? projection?.id ?? 0,
             projectId,
             linearIssueId,
+            ...(issueControl?.selectedWorkflowId ? { selectedWorkflowId: issueControl.selectedWorkflowId } : {}),
             ...(projection?.issueKey ? { issueKey: projection.issueKey } : {}),
             ...(projection?.title ? { title: projection.title } : {}),
             ...(projection?.issueUrl ? { issueUrl: projection.issueUrl } : {}),

package/dist/db/migrations.js

@@ -32,6 +32,7 @@ CREATE TABLE IF NOT EXISTS issue_control (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id TEXT NOT NULL,
   linear_issue_id TEXT NOT NULL,
+  selected_workflow_id TEXT,
   desired_stage TEXT,
   desired_receipt_id INTEGER,
   active_run_lease_id INTEGER,
@@ -194,7 +195,9 @@ CREATE TABLE IF NOT EXISTS operator_feed_events (
   issue_key TEXT,
   project_id TEXT,
   stage TEXT,
-  status TEXT
+  status TEXT,
+  workflow_id TEXT,
+  next_stage TEXT
 );
 
 CREATE INDEX IF NOT EXISTS idx_event_receipts_project_issue ON event_receipts(project_id, linear_issue_id);
@@ -214,4 +217,22 @@ WHERE dedupe_key IS NOT NULL;
 `;
 export function runPatchRelayMigrations(connection) {
     connection.exec(baseMigration);
+    try {
+        connection.exec("ALTER TABLE issue_control ADD COLUMN selected_workflow_id TEXT");
+    }
+    catch {
+        // Column already exists on upgraded installs.
+    }
+    try {
+        connection.exec("ALTER TABLE operator_feed_events ADD COLUMN workflow_id TEXT");
+    }
+    catch {
+        // Column already exists on upgraded installs.
+    }
+    try {
+        connection.exec("ALTER TABLE operator_feed_events ADD COLUMN next_stage TEXT");
+    }
+    catch {
+        // Column already exists on upgraded installs.
+    }
 }

package/dist/db/operator-feed-store.js

@@ -9,9 +9,9 @@ export class OperatorFeedStore {
     save(event) {
         const at = event.at ?? isoNow();
         const result = this.connection.prepare(`
-      INSERT INTO operator_feed_events (at, level, kind, summary, detail, issue_key, project_id, stage, status)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(at, event.level, event.kind, event.summary, event.detail ?? null, event.issueKey ?? null, event.projectId ?? null, event.stage ?? null, event.status ?? null);
+      INSERT INTO operator_feed_events (at, level, kind, summary, detail, issue_key, project_id, stage, status, workflow_id, next_stage)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(at, event.level, event.kind, event.summary, event.detail ?? null, event.issueKey ?? null, event.projectId ?? null, event.stage ?? null, event.status ?? null, event.workflowId ?? null, event.nextStage ?? null);
         this.prune();
         const stored = this.connection.prepare("SELECT * FROM operator_feed_events WHERE id = ?").get(Number(result.lastInsertRowid));
         return mapOperatorFeedEvent(stored);
@@ -31,6 +31,22 @@ export class OperatorFeedStore {
             clauses.push("project_id = ?");
             params.push(options.projectId);
         }
+        if (options?.kind) {
+            clauses.push("kind = ?");
+            params.push(options.kind);
+        }
+        if (options?.stage) {
+            clauses.push("stage = ?");
+            params.push(options.stage);
+        }
+        if (options?.status) {
+            clauses.push("status = ?");
+            params.push(options.status);
+        }
+        if (options?.workflowId) {
+            clauses.push("workflow_id = ?");
+            params.push(options.workflowId);
+        }
         const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
         const limit = options?.limit ?? 50;
         const rows = this.connection.prepare(`
@@ -68,5 +84,7 @@ function mapOperatorFeedEvent(row) {
         ...(row.project_id === null ? {} : { projectId: String(row.project_id) }),
         ...(row.stage === null ? {} : { stage: row.stage }),
         ...(row.status === null ? {} : { status: String(row.status) }),
+        ...(row.workflow_id === null ? {} : { workflowId: String(row.workflow_id) }),
+        ...(row.next_stage === null ? {} : { nextStage: row.next_stage }),
     };
 }