@clipboard-health/groundcrew 4.14.0 → 4.16.0

package/crew.config.example.ts

@@ -4,10 +4,11 @@ import type { Config } from "@clipboard-health/groundcrew";
 export default {
   // Groundcrew's built-in Linear adapter is implicit and needs no config:
   // it picks up every Linear issue assigned to your API key's viewer that
-  // carries an `agent-*` label. There is no project / view / status
-  // block — Linear's workflow `state.type` (`unstarted` → todo,
-  // `started` → in progress, `completed`/`canceled`/`duplicate` →
-  // terminal) is the single source of truth, so renamed columns Just Work.
+  // carries an `agent-*` label. There is no project / view block. The default
+  // Linear status names `In Progress` and `In Review` disambiguate Linear's
+  // `started` workflow states; other statuses fall back to workflow
+  // `state.type` (`unstarted` → todo, `started` → in progress,
+  // `completed`/`canceled`/`duplicate` → terminal).
   //
   // Opt a ticket in: assign it to yourself and add an `agent-<model>`
   // label (e.g. `agent-claude`, `agent-any`).
@@ -53,6 +54,15 @@ export default {
   // // See the shell adapter's ShellIssue schema for the JSON contract
   // // `fetch` / `resolveOne` must emit.
   // sources: [
+  //   // Optional: explicitly declare Linear only when you need custom status
+  //   // names. Omitted fields keep their defaults.
+  //   {
+  //     kind: "linear",
+  //     statuses: {
+  //       inProgress: ["Doing"],
+  //       inReview: ["Code Review"],
+  //     },
+  //   },
   //   {
   //     kind: "shell",
   //     name: "jira",

package/dist/commands/orchestrator.d.ts

@@ -1,8 +1,8 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
  * git-worktree pairs for ready tickets. Each tick fetches the board, runs
- * the cleaner, and runs the dispatcher; logging from those modules is the
- * orchestrator's user-facing output.
+ * the cleaner, the reviewer, and the dispatcher; logging from those modules is
+ * the orchestrator's user-facing output.
  */
 export interface OrchestratorOptions {
     watch: boolean;

package/dist/commands/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyDH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2DH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD7E"}

package/dist/commands/orchestrator.js

@@ -1,18 +1,20 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
  * git-worktree pairs for ready tickets. Each tick fetches the board, runs
- * the cleaner, and runs the dispatcher; logging from those modules is the
- * orchestrator's user-facing output.
+ * the cleaner, the reviewer, and the dispatcher; logging from those modules is
+ * the orchestrator's user-facing output.
  */
 import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
+import { findPullRequestsForBranch } from "../lib/pullRequests.js";
 import { RepositoryResolutionError } from "../lib/ticketSource.js";
 import { getUsageByModel } from "../lib/usage.js";
 import { errorMessage, log, sleep } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { createCleaner } from "./cleaner.js";
 import { createDispatcher } from "./dispatcher.js";
+import { createReviewer } from "./reviewer.js";
 const RATE_LIMIT_DELAY_MS = 60_000;
 const RETRY_BASE_DELAY_MS = 1000;
 const RETRY_MAX_ATTEMPTS = 3;
@@ -72,6 +74,10 @@ export async function orchestrate(options) {
     const board = createBoard(allSources);
     await board.verify();
     const cleaner = createCleaner({ config });
+    const reviewer = createReviewer({
+        board,
+        findPullRequests: findPullRequestsForBranch,
+    });
     const dispatcher = createDispatcher({ config, board });
     // Folded into the dispatcher's idle log lines in watch mode so each idle
     // tick prints one combined line instead of "<reason>" + "Next poll in Xs".
@@ -88,6 +94,7 @@ export async function orchestrate(options) {
             ...(signal === undefined ? {} : { signal }),
         };
         await cleaner.runOnce(tickArguments);
+        await reviewer.runOnce(tickArguments);
         await dispatcher.runOnce({
             ...tickArguments,
             // Lazy: dispatcher only invokes this after its own early-returns, so

package/dist/commands/reviewer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-iteration scanner that advances in-progress tickets to in-review once
+ * their worktree has an open (or merged) pull request. Sits between the cleaner
+ * and the dispatcher in each `orchestrate()` tick. A successfully-applied
+ * transition frees a dispatch slot (the slot math counts only in-progress)
+ * while leaving the worktree intact for review, since the cleaner only tears
+ * down `done` tickets.
+ *
+ * The write-back lands in the ticket source, not the in-memory `BoardState`, so
+ * the dispatcher in the SAME tick still sees the ticket as in-progress; the slot
+ * frees on the NEXT tick's `board.fetch()`. That one-tick latency is deliberate
+ * — it keeps the reviewer from mutating shared `BoardState` mid-tick. One per
+ * `orchestrate()`; stateless across iterations. Mirrors `Cleaner`.
+ *
+ * "Worktree has an open PR" is a v1 proxy for "the implementation is finished
+ * and up for review". The detection + the open/merged condition live here in
+ * the core reviewer (a push model) rather than inside any adapter, so a future
+ * per-adapter `shouldAdvanceToReview` predicate is a clean additive change.
+ */
+import type { Board } from "../lib/board.ts";
+import type { PullRequestSummary } from "../lib/pullRequests.ts";
+import { type BoardState } from "../lib/ticketSource.ts";
+import type { WorktreeEntry } from "../lib/worktrees.ts";
+/**
+ * Injected PR lookup. Matches `findPullRequestsForBranch`'s shape: best-effort,
+ * never rejects — a failed lookup (gh missing, unauthenticated, non-GitHub
+ * remote, network error) resolves to an empty list, indistinguishable from
+ * "no PR yet". Both outcomes mean "skip this issue, retry next tick".
+ */
+export type FindPullRequests = (arguments_: {
+    cwd: string;
+    branchName: string;
+    signal?: AbortSignal;
+}) => Promise<readonly PullRequestSummary[]>;
+interface ReviewerDeps {
+    board: Board;
+    findPullRequests: FindPullRequests;
+}
+/** Per-tick inputs, mirroring the other orchestrator steps' shape. */
+interface ReviewArguments {
+    state: BoardState;
+    worktreeEntries: readonly WorktreeEntry[];
+    dryRun: boolean;
+    signal?: AbortSignal;
+}
+export interface Reviewer {
+    runOnce(arguments_: ReviewArguments): Promise<void>;
+}
+export declare function createReviewer(deps: ReviewerDeps): Reviewer;
+export {};
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/commands/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/commands/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,KAAK,UAAU,EAAsC,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,sEAAsE;AACtE,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAsBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAqG3D"}

package/dist/commands/reviewer.js

@@ -0,0 +1,121 @@
+/**
+ * Per-iteration scanner that advances in-progress tickets to in-review once
+ * their worktree has an open (or merged) pull request. Sits between the cleaner
+ * and the dispatcher in each `orchestrate()` tick. A successfully-applied
+ * transition frees a dispatch slot (the slot math counts only in-progress)
+ * while leaving the worktree intact for review, since the cleaner only tears
+ * down `done` tickets.
+ *
+ * The write-back lands in the ticket source, not the in-memory `BoardState`, so
+ * the dispatcher in the SAME tick still sees the ticket as in-progress; the slot
+ * frees on the NEXT tick's `board.fetch()`. That one-tick latency is deliberate
+ * — it keeps the reviewer from mutating shared `BoardState` mid-tick. One per
+ * `orchestrate()`; stateless across iterations. Mirrors `Cleaner`.
+ *
+ * "Worktree has an open PR" is a v1 proxy for "the implementation is finished
+ * and up for review". The detection + the open/merged condition live here in
+ * the core reviewer (a push model) rather than inside any adapter, so a future
+ * per-adapter `shouldAdvanceToReview` predicate is a clean additive change.
+ */
+import { naturalIdFromCanonical } from "../lib/ticketSource.js";
+import { debug, errorMessage, log, logEvent } from "../lib/util.js";
+// A PR whose lifecycle means the work is up for (or past) review. `merged`
+// catches a PR that merged between ticks, so we still free the slot.
+function isReviewablePullRequest(pr) {
+    return pr.state === "open" || pr.state === "merged";
+}
+function matchingWorktreeEntries(arguments_) {
+    const { issue, worktreeEntries, ticket } = arguments_;
+    if (issue.repository === undefined) {
+        return [];
+    }
+    return worktreeEntries.filter((entry) => entry.ticket === ticket && entry.repository === issue.repository);
+}
+export function createReviewer(deps) {
+    const { board, findPullRequests } = deps;
+    async function runOnce(arguments_) {
+        const { state, worktreeEntries, dryRun, signal } = arguments_;
+        const inProgress = state.issues.filter((issue) => issue.status === "in-progress");
+        if (inProgress.length === 0) {
+            return;
+        }
+        for (const issue of inProgress) {
+            // oxlint-disable-next-line no-await-in-loop -- at most maximumInProgress (1-5) issues per tick; sequential keeps gh load low.
+            await advanceIfReviewable({
+                issue,
+                worktreeEntries,
+                dryRun,
+                ...(signal === undefined ? {} : { signal }),
+            });
+        }
+    }
+    // Idempotent after an applied transition: once advanced, the issue leaves
+    // `in-progress`, so it never reaches this scan again. Unsupported writebacks
+    // are skipped without claiming success and may retry on later ticks.
+    async function advanceIfReviewable(arguments_) {
+        const { issue, worktreeEntries, dryRun, signal } = arguments_;
+        const ticket = naturalIdFromCanonical(issue.id);
+        const entries = matchingWorktreeEntries({ issue, worktreeEntries, ticket });
+        for (const entry of entries) {
+            // The injected lookup is contracted never to reject (failures resolve to
+            // []), but we still guard it so one bad lookup can never abort the tick
+            // and starve the other in-progress issues. A failure means "can't tell
+            // yet" → skip this worktree and retry next tick.
+            let pullRequests;
+            try {
+                // oxlint-disable-next-line no-await-in-loop -- a ticket almost always has one worktree; sequential lookups are fine.
+                pullRequests = await findPullRequests({
+                    cwd: entry.dir,
+                    branchName: entry.branchName,
+                    ...(signal === undefined ? {} : { signal }),
+                });
+            }
+            catch (error) {
+                debug(`PR lookup failed for ${ticket} (${entry.branchName}): ${errorMessage(error)}`);
+                continue;
+            }
+            const reviewable = pullRequests.find(isReviewablePullRequest);
+            if (reviewable === undefined) {
+                continue;
+            }
+            if (dryRun) {
+                log(`[dry-run] Would advance ${ticket} to in-review (PR ${reviewable.url})`);
+                logEvent("review", { outcome: "skipped", reason: "dry_run", ticket, pr: reviewable.url });
+                return;
+            }
+            // oxlint-disable-next-line no-await-in-loop -- single write-back then return; never iterates past the first reviewable worktree.
+            await advance({ issue, ticket, pullRequest: reviewable });
+            return;
+        }
+    }
+    // A writeback failure (shell/Linear error) is logged and swallowed: the
+    // ticket stays in-progress and is retried next tick, exactly like a failed
+    // lookup. We never let one ticket's writeback abort the others' reviews.
+    async function advance(arguments_) {
+        const { issue, ticket, pullRequest } = arguments_;
+        try {
+            const result = await board.markInReview(issue);
+            if (result.outcome === "unsupported") {
+                log(`Skipped advancing ${ticket} to in-review: ${result.reason}`);
+                logEvent("review", {
+                    outcome: "skipped",
+                    reason: "unsupported",
+                    ticket,
+                });
+                return;
+            }
+            log(`Advanced ${ticket} to in-review (PR ${pullRequest.url})`);
+            logEvent("review", {
+                outcome: "advanced",
+                ticket,
+                pr: pullRequest.url,
+                state: pullRequest.state,
+            });
+        }
+        catch (error) {
+            log(`Failed to advance ${ticket} to in-review: ${errorMessage(error)}`);
+            logEvent("review", { outcome: "failed", reason: "writeback_failed", ticket });
+        }
+    }
+    return { runOnce };
+}

package/dist/lib/adapters/linear/factory.d.ts

@@ -5,9 +5,9 @@
  * ./client.ts) and converts Linear-specific shapes into the canonical
  * Issue/Blocker types consumers (via Board) speak.
  *
- * State classification is driven by Linear's workflow `state.type` — never
- * by status name — so workspaces with renamed columns Just Work without
- * per-team config.
+ * Status names disambiguate Linear's multiple `started` states ("In Progress"
+ * vs "In Review"). Unmatched statuses fall back to workflow `state.type` so
+ * renamed or custom columns still preserve the broad lifecycle behavior.
  *
  * Description is populated on both `fetch()` Issues and `resolveOne()` Issues.
  */
@@ -15,6 +15,7 @@ import type { AdapterContext } from "../../adapterDefinition.ts";
 import { type Issue as CanonicalIssue, type TicketSource } from "../../ticketSource.ts";
 import type { LinearAdapterConfig } from "./schema.ts";
 import { type Issue as LinearIssue } from "./fetch.ts";
+import { type LinearStatusNames } from "./statusNames.ts";
 /**
  * Adapter-private payload threaded through `Issue.sourceRef`. Consumers
  * MUST NOT inspect; only the Linear adapter reads it.
@@ -28,6 +29,6 @@ export interface LinearSourceRef {
     /** Human-readable native status name, e.g. "In Progress", "Shipped". Diagnostic display only. */
     nativeStatus: string;
 }
-export declare function toCanonicalIssue(linearIssue: LinearIssue, sourceName: string): CanonicalIssue;
+export declare function toCanonicalIssue(linearIssue: LinearIssue, sourceName: string, statusNames?: LinearStatusNames): CanonicalIssue;
 export declare function createLinearTicketSource(config: LinearAdapterConfig, context: AdapterContext): TicketSource;
 //# sourceMappingURL=factory.d.ts.map

package/dist/lib/adapters/linear/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAE5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAKL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AAkFD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB7F;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,YAAY,CAgFd"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AAmDD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,iBAA+C,GAC3D,cAAc,CA2BhB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,YAAY,CAiGd"}

package/dist/lib/adapters/linear/factory.js

@@ -5,73 +5,37 @@
  * ./client.ts) and converts Linear-specific shapes into the canonical
  * Issue/Blocker types consumers (via Board) speak.
  *
- * State classification is driven by Linear's workflow `state.type` — never
- * by status name — so workspaces with renamed columns Just Work without
- * per-team config.
+ * Status names disambiguate Linear's multiple `started` states ("In Progress"
+ * vs "In Review"). Unmatched statuses fall back to workflow `state.type` so
+ * renamed or custom columns still preserve the broad lifecycle behavior.
  *
  * Description is populated on both `fetch()` Issues and `resolveOne()` Issues.
  */
 import { toCanonicalId, } from "../../ticketSource.js";
 import { getLinearClient, lazyLinearClient } from "./client.js";
-import { createBoardSource, fetchResolvedIssue, isTerminalStateType, } from "./fetch.js";
+import { createBoardSource, fetchResolvedIssue, } from "./fetch.js";
+import { canonicalStatusFromLinearState, DEFAULT_LINEAR_STATUS_NAMES, resolveLinearStatusNames, } from "./statusNames.js";
 import { createLinearIssueStatusUpdater } from "./writeback.js";
-function canonicalStatusFromStateType(stateType) {
-    /* v8 ignore next 3 @preserve -- LinearIssue.stateType is non-optional; this guard is defensive for the resolveOne path */
-    if (stateType === undefined) {
-        return "other";
-    }
-    switch (stateType) {
-        case "unstarted": {
-            return "todo";
-        }
-        case "started": {
-            return "in-progress";
-        }
-        case "completed":
-        case "canceled":
-        case "duplicate": {
-            return "done";
-        }
-        default: {
-            return "other";
-        }
-    }
-}
-function canonicalBlockerStatus(blocker) {
-    if (blocker.stateType === undefined) {
-        return {
-            status: "other",
-            statusReason: "missing",
-            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
-        };
-    }
-    if (isTerminalStateType(blocker.stateType)) {
-        return {
-            status: "done",
-            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
-        };
-    }
-    if (blocker.stateType === "started") {
+function canonicalBlockerStatus(blocker, statusNames) {
+    const status = canonicalStatusFromLinearState({
+        nativeStatus: blocker.status,
+        stateType: blocker.stateType,
+        statusNames,
+    });
+    if (status !== "other") {
         return {
-            status: "in-progress",
+            status,
             ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
         };
     }
-    if (blocker.stateType === "unstarted") {
-        return {
-            status: "todo",
-            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
-        };
-    }
-    // backlog / triage / anything else falls through as "other"
     return {
-        status: "other",
-        statusReason: "unmapped",
+        status,
+        statusReason: blocker.stateType === undefined ? "missing" : "unmapped",
         ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
     };
 }
-function toCanonicalBlocker(blocker, sourceName) {
-    const { status, statusReason, nativeStatus } = canonicalBlockerStatus(blocker);
+function toCanonicalBlocker(blocker, sourceName, statusNames) {
+    const { status, statusReason, nativeStatus } = canonicalBlockerStatus(blocker, statusNames);
     return {
         id: toCanonicalId(sourceName, blocker.id),
         title: blocker.title,
@@ -87,7 +51,7 @@ function toCanonicalParentSkip(skip, sourceName) {
         childCount: skip.childCount,
     };
 }
-export function toCanonicalIssue(linearIssue, sourceName) {
+export function toCanonicalIssue(linearIssue, sourceName, statusNames = DEFAULT_LINEAR_STATUS_NAMES) {
     const sourceRef = {
         uuid: linearIssue.uuid,
         statusId: linearIssue.statusId,
@@ -100,12 +64,16 @@ export function toCanonicalIssue(linearIssue, sourceName) {
         source: sourceName,
         title: linearIssue.title,
         description: linearIssue.description,
-        status: canonicalStatusFromStateType(linearIssue.stateType),
+        status: canonicalStatusFromLinearState({
+            nativeStatus: linearIssue.status,
+            stateType: linearIssue.stateType,
+            statusNames,
+        }),
         repository: linearIssue.repository,
         model: linearIssue.model,
         assignee: linearIssue.assignee,
         updatedAt: linearIssue.updatedAt,
-        blockers: linearIssue.blockers.map((b) => toCanonicalBlocker(b, sourceName)),
+        blockers: linearIssue.blockers.map((b) => toCanonicalBlocker(b, sourceName, statusNames)),
         hasMoreBlockers: linearIssue.hasMoreBlockers,
         url: linearIssue.url,
         sourceRef,
@@ -113,6 +81,7 @@ export function toCanonicalIssue(linearIssue, sourceName) {
 }
 export function createLinearTicketSource(config, context) {
     const sourceName = config.name ?? "linear";
+    const statusNames = resolveLinearStatusNames(config.statuses);
     const { globalConfig } = context;
     // Lazy: deferring `getLinearClient()` (and the sub-modules that depend on
     // it) until first method use means `createLinearTicketSource` can be
@@ -131,6 +100,7 @@ export function createLinearTicketSource(config, context) {
     function getIssueStatusUpdater() {
         cachedIssueStatusUpdater ??= createLinearIssueStatusUpdater({
             client: getClient(),
+            statusNames,
         });
         return cachedIssueStatusUpdater;
     }
@@ -143,7 +113,7 @@ export function createLinearTicketSource(config, context) {
         async fetch() {
             const state = await getBoardSource().fetch();
             lastParentSkips = state.parentSkips.map((skip) => toCanonicalParentSkip(skip, sourceName));
-            return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, sourceName));
+            return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, sourceName, statusNames));
         },
         async fetchParentSkips() {
             return lastParentSkips;
@@ -166,7 +136,11 @@ export function createLinearTicketSource(config, context) {
                 source: sourceName,
                 title: resolved.title,
                 description: resolved.description,
-                status: canonicalStatusFromStateType(resolved.stateType),
+                status: canonicalStatusFromLinearState({
+                    nativeStatus: resolved.status,
+                    stateType: resolved.stateType,
+                    statusNames,
+                }),
                 repository: resolved.repository,
                 model: resolved.model,
                 assignee: "Unassigned",
@@ -186,5 +160,14 @@ export function createLinearTicketSource(config, context) {
                 teamId: ref.teamId,
             });
         },
+        async markInReview(issue) {
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- by the Linear adapter's contract, every Issue it produces carries a LinearSourceRef in sourceRef
+            const ref = issue.sourceRef;
+            return await getIssueStatusUpdater().markInReview({
+                id: issue.id,
+                uuid: ref.uuid,
+                teamId: ref.teamId,
+            });
+        },
     };
 }

package/dist/lib/adapters/linear/fetch.d.ts

@@ -1,12 +1,11 @@
 /**
  * Linear adapter — GraphQL fetch helpers for board/issue data.
  *
- * There is no project / view / status configuration: the only server-side
- * filter is "assigned to the API key's viewer AND carries an `agent-*`
- * label." State classification is driven by Linear's workflow `state.type`
- * (`unstarted` | `started` | `completed` | `canceled` | `duplicate`) —
- * never by status name — so workspaces with renamed columns (Todo -> To Do,
- * Done -> Shipped, etc.) Just Work without per-team config.
+ * There is no project or view configuration: the only server-side filter is
+ * "assigned to the API key's viewer AND carries an `agent-*` label." This
+ * module returns Linear's native status name plus workflow `state.type`; the
+ * ticket-source factory applies status-name disambiguation and state-type
+ * fallback when building canonical issues.
  */
 import type { LinearClient } from "@linear/sdk";
 import type { ResolvedConfig } from "../../config.ts";
@@ -18,8 +17,8 @@ export interface Blocker {
     status: string | undefined;
     /**
      * Linear workflow `state.type` for the blocker (`unstarted` | `started` |
-     * `completed` | `canceled` | `duplicate` | `backlog` | `triage`). All
-     * canonical classification — todo / in-progress / terminal — keys off this.
+     * `completed` | `canceled` | `duplicate` | `backlog` | `triage`). Canonical
+     * classification uses this as a fallback after configured status names.
      */
     stateType: string | undefined;
 }
@@ -30,7 +29,7 @@ export interface Issue {
     description: string;
     status: string;
     statusId: string;
-    /** Linear workflow `state.type` — the source of truth for canonical classification. */
+    /** Linear workflow `state.type` — canonical classification fallback after status-name matching. */
     stateType: string;
     assignee: string;
     updatedAt: string;

package/dist/lib/adapters/linear/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/fetch.ts"],"names":[],"mappings":"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"}

package/dist/lib/adapters/linear/fetch.js

@@ -1,12 +1,11 @@
 /**
  * Linear adapter — GraphQL fetch helpers for board/issue data.
  *
- * There is no project / view / status configuration: the only server-side
- * filter is "assigned to the API key's viewer AND carries an `agent-*`
- * label." State classification is driven by Linear's workflow `state.type`
- * (`unstarted` | `started` | `completed` | `canceled` | `duplicate`) —
- * never by status name — so workspaces with renamed columns (Todo -> To Do,
- * Done -> Shipped, etc.) Just Work without per-team config.
+ * There is no project or view configuration: the only server-side filter is
+ * "assigned to the API key's viewer AND carries an `agent-*` label." This
+ * module returns Linear's native status name plus workflow `state.type`; the
+ * ticket-source factory applies status-name disambiguation and state-type
+ * fallback when building canonical issues.
  */
 import { RepositoryResolutionError } from "../../ticketSource.js";
 import { log, styleWarning } from "../../util.js";

package/dist/lib/adapters/linear/schema.d.ts

@@ -1,12 +1,17 @@
 /**
  * Zod schema for the Linear adapter's per-source config block. The built-in
  * Linear adapter is implicit and derives scope from the API key's viewer plus
- * `agent-*` labels, so the source config only needs an optional display name.
+ * `agent-*` labels. Source config is only needed to override display name or
+ * Linear status names that disambiguate multiple `started` workflow states.
  */
 import { z } from "zod";
 export declare const linearAdapterConfigSchema: z.ZodObject<{
     kind: z.ZodLiteral<"linear">;
     name: z.ZodOptional<z.ZodString>;
+    statuses: z.ZodOptional<z.ZodObject<{
+        inProgress: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inReview: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type LinearAdapterConfig = z.infer<typeof linearAdapterConfigSchema>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/lib/adapters/linear/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;iBAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB;;;;;;;iBAYpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/lib/adapters/linear/schema.js

@@ -1,13 +1,21 @@
 /**
  * Zod schema for the Linear adapter's per-source config block. The built-in
  * Linear adapter is implicit and derives scope from the API key's viewer plus
- * `agent-*` labels, so the source config only needs an optional display name.
+ * `agent-*` labels. Source config is only needed to override display name or
+ * Linear status names that disambiguate multiple `started` workflow states.
  */
 import { z } from "zod";
+const statusNamesSchema = z.array(z.string().trim().min(1)).min(1);
 export const linearAdapterConfigSchema = z.object({
     kind: z.literal("linear"),
     name: z
         .string()
         .regex(/^[a-z][a-z0-9-]*$/, "name must be kebab-case (lowercase letters, digits, hyphens)")
         .optional(),
+    statuses: z
+        .object({
+        inProgress: statusNamesSchema.optional(),
+        inReview: statusNamesSchema.optional(),
+    })
+        .optional(),
 });

package/dist/lib/adapters/linear/statusNames.d.ts

@@ -0,0 +1,25 @@
+import type { CanonicalStatus } from "../../ticketSource.ts";
+import type { LinearAdapterConfig } from "./schema.ts";
+export interface LinearStatusNames {
+    inProgress: readonly string[];
+    inReview: readonly string[];
+}
+export interface LinearWorkflowState {
+    id: string;
+    name: string;
+    type: string;
+    position: number;
+}
+export declare const DEFAULT_LINEAR_STATUS_NAMES: {
+    readonly inProgress: readonly ["In Progress"];
+    readonly inReview: readonly ["In Review"];
+};
+export declare function resolveLinearStatusNames(config: LinearAdapterConfig["statuses"] | undefined): LinearStatusNames;
+export declare function canonicalStatusFromLinearState(arguments_: {
+    nativeStatus: string | undefined;
+    stateType: string | undefined;
+    statusNames: LinearStatusNames;
+}): CanonicalStatus;
+export declare function findLinearWorkflowStateByName(states: readonly LinearWorkflowState[], names: readonly string[]): LinearWorkflowState | undefined;
+export declare function formatLinearStatusNames(names: readonly string[]): string;
+//# sourceMappingURL=statusNames.d.ts.map

package/dist/lib/adapters/linear/statusNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusNames.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/statusNames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,2BAA2B;;;CAGF,CAAC;AAEvC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,SAAS,GAClD,iBAAiB,CAKnB;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE;IACzD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,iBAAiB,CAAC;CAChC,GAAG,eAAe,CAWlB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,mBAAmB,EAAE,EACtC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExE"}