@clipboard-health/groundcrew 3.1.2 → 3.1.4

package/dist/commands/ticketDoctor.js

@@ -3,11 +3,14 @@
 // `crew doctor --ticket <TICKET>` — single per-ticket diagnostic that covers
 // both the pre-dispatch question ("will this dispatch on the next tick?") and
 // the post-dispatch question ("what's already happened and what's left to
-// do?"). Verdict precedence runs strictly from post-dispatch states down:
+// do?"). Verdict precedence starts with PR outcomes, then handles run-state
+// exceptions before ordinary local recovery:
 //
-//   pr-open > pr-merged > in-flight > recoverable
-//     > unresolvable > ineligible > would-dispatch
-//       > lost
+//   pr-open > pr-merged
+//     > failed-launch
+//     > interrupted (unless concrete recoverable git work exists)
+//     > in-flight > recoverable
+//     > unresolvable > ineligible > would-dispatch > lost
 //
 // When a post-dispatch verdict fires, the Resolution and Eligibility sections
 // are skipped — they describe pre-dispatch state that no longer matters.
@@ -15,8 +18,9 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, resolveModelFor, resolveRepositoryFor, } from "../lib/boardSource.js";
 import { runCommandAsync } from "../lib/commandRunner.js";
-import { AGENT_ANY_MODEL, loadConfig } from "../lib/config.js";
+import { AGENT_ANY_MODEL, findProjectBySlugId, loadConfig, } from "../lib/config.js";
 import { which } from "../lib/host.js";
+import { readRunState } from "../lib/runState.js";
 import { getUsageByModel } from "../lib/usage.js";
 import { getLinearClient, lazyLinearClient, writeOutput } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
@@ -91,9 +95,11 @@ function verdictRecoverable(input) {
  * "ticket has moved past dispatch" cases. Returns `undefined` otherwise,
  * signalling that the caller should fall through to the pre-dispatch path.
  *
- * Precedence: PR > in-flight > recoverable. Inside `recoverable`, dirty
- * worktree beats clean-with-un-pushed-local beats remote-only beats stranded
- * local.
+ * Precedence: PR verdicts always win. Failed launches report before ordinary
+ * local recovery. Interrupted runs report concrete recoverable git work first
+ * when it exists, then fall back to `interrupted`. Ordinary post-dispatch cases
+ * report in-flight before recoverable. Inside `recoverable`, dirty worktree
+ * beats clean-with-un-pushed-local beats remote-only beats stranded local.
  */
 export function decidePostDispatchVerdict(input) {
     if (input.pullRequest.kind === "open") {
@@ -102,13 +108,34 @@ export function decidePostDispatchVerdict(input) {
     if (input.pullRequest.kind === "merged") {
         return { kind: "pr-merged", number: input.pullRequest.number, url: input.pullRequest.url };
     }
-    return verdictInFlight(input) ?? verdictRecoverable(input);
+    const recoverable = verdictRecoverable(input);
+    if (input.runState?.state === "interrupted") {
+        if (recoverable !== undefined) {
+            return recoverable;
+        }
+        const detail = input.runState.reason ?? input.runState.detail ?? "workspace stopped";
+        return {
+            kind: "interrupted",
+            reason: detail,
+            nextStep: `run \`crew resume ${input.runState.ticket}\` or inspect ${input.runState.worktreeDir}`,
+        };
+    }
+    if (input.runState?.state === "failed-to-launch") {
+        const detail = input.runState.detail ?? "workspace launch failed";
+        return {
+            kind: "failed-launch",
+            reason: detail,
+            nextStep: `fix the launch failure, then run \`crew resume ${input.runState.ticket}\` or \`crew cleanup ${input.runState.ticket}\``,
+        };
+    }
+    return verdictInFlight(input) ?? recoverable;
 }
 function emptySkipReasons() {
     return {
         resolution: "",
         eligibility: "",
         worktree: "",
+        runState: "",
         workspace: "",
         localBranch: "",
         remoteBranch: "",
@@ -243,6 +270,8 @@ async function runEligibilityChecks(arguments_) {
         assignee: "",
         updatedAt: "",
         teamId: raw.teamId,
+        /* v8 ignore next @preserve -- probeLinear gates off-config projects upstream so raw.projectSlugId is always defined here */
+        projectSlugId: raw.projectSlugId ?? "",
         repository: resolvedRepository,
         model: resolvedModel,
         blockers: [...blockers],
@@ -345,8 +374,31 @@ async function probeLinear(deps, upperTicket) {
     }
     try {
         const raw = await deps.fetchRawIssue({ ticket: upperTicket });
-        const isTerminal = deps.config.linear.statuses.terminal.includes(raw.stateName);
-        const todoState = deps.config.linear.statuses.todo;
+        const project = raw.projectSlugId === undefined
+            ? undefined
+            : findProjectBySlugId(deps.config, raw.projectSlugId);
+        if (project === undefined) {
+            const configured = deps.config.linear.projects.map((entry) => entry.slugId).join(", ");
+            const detail = raw.projectSlugId === undefined
+                ? `ticket has no associated Linear project; configure linear.projects (${configured})`
+                : `project slugId "${raw.projectSlugId}" is not in linear.projects (configured: ${configured})`;
+            return {
+                linearStatus: { kind: "unresolvable", reason: detail },
+                resolution: [
+                    { name: "Ticket exists in Linear", status: "ok", detail: `"${raw.title}"` },
+                    {
+                        name: "Project is configured",
+                        status: "fail",
+                        detail,
+                        failureSummary: detail,
+                    },
+                ],
+                title: raw.title,
+                raw,
+            };
+        }
+        const isTerminal = project.statuses.terminal.includes(raw.stateName);
+        const todoState = project.statuses.todo;
         const resolution = [
             { name: "Ticket exists in Linear", status: "ok", detail: `"${raw.title}"` },
         ];
@@ -376,6 +428,29 @@ async function probeLinear(deps, upperTicket) {
         };
     }
 }
+function probeRunStateSection(deps, ticket) {
+    const state = deps.readRunState(ticket);
+    if (state === undefined) {
+        return {
+            checks: [{ name: "Local run state", status: "skipped", detail: "none found" }],
+            state: undefined,
+        };
+    }
+    const checks = [
+        { name: "Local run state", status: "ok", detail: state.state },
+        { name: "Recorded model", status: "ok", detail: state.model },
+        { name: "Recorded worktree", status: "ok", detail: state.worktreeDir },
+        { name: "Recorded branch", status: "ok", detail: state.branchName },
+        { name: "Resume count", status: "ok", detail: String(state.resumeCount) },
+    ];
+    if (state.reason !== undefined) {
+        checks.push({ name: "Last reason", status: "ok", detail: state.reason });
+    }
+    if (state.detail !== undefined) {
+        checks.push({ name: "Last detail", status: "ok", detail: state.detail });
+    }
+    return { checks, state };
+}
 async function probeWorktreeSection(deps, ticket) {
     const entry = deps.findWorktree(ticket);
     if (entry === undefined) {
@@ -615,6 +690,7 @@ export async function ticketDoctor(dependencies) {
     const skipReasons = emptySkipReasons();
     const linearResult = await probeLinear(dependencies, upperTicket);
     const resolution = [...linearResult.resolution];
+    const runStateResult = probeRunStateSection(dependencies, lowerTicket);
     const worktreeResult = await probeWorktreeSection(dependencies, lowerTicket);
     const workspaceResult = await probeWorkspaceSection(dependencies, lowerTicket);
     const localResult = await probeLocalBranchSection(dependencies, worktreeResult.entry);
@@ -638,6 +714,7 @@ export async function ticketDoctor(dependencies) {
         branch: worktreeResult.entry?.branchName ?? lowerTicket,
         worktreeDir: worktreeResult.entry?.dir,
         workspaceName: workspaceResult.workspaceName,
+        runState: runStateResult.state,
     });
     if (postVerdict !== undefined) {
         skipReasons.resolution = "post-dispatch — pre-dispatch checks are irrelevant";
@@ -647,6 +724,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -667,6 +745,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -687,6 +766,7 @@ export async function ticketDoctor(dependencies) {
             title: linearResult.title,
             resolution,
             eligibility: [],
+            runStateResult,
             worktreeResult,
             workspaceResult,
             localResult,
@@ -725,6 +805,7 @@ export async function ticketDoctor(dependencies) {
         title: linearResult.title,
         resolution,
         eligibility: preDispatch.eligibility,
+        runStateResult,
         worktreeResult,
         workspaceResult,
         localResult,
@@ -740,6 +821,7 @@ function buildResult(input) {
         ...(input.title === undefined ? {} : { title: input.title }),
         resolution: input.resolution,
         eligibility: input.eligibility,
+        runState: input.runStateResult.checks,
         worktree: input.worktreeResult.checks,
         workspace: input.workspaceResult.checks,
         localBranch: input.localResult.checks,
@@ -778,6 +860,12 @@ function formatVerdict(verdict) {
         case "pr-merged": {
             return `→ pr-merged: ${verdict.url} (#${verdict.number})`;
         }
+        case "interrupted": {
+            return `→ interrupted: ${verdict.reason}; ${verdict.nextStep}`;
+        }
+        case "failed-launch": {
+            return `→ failed-launch: ${verdict.reason}; ${verdict.nextStep}`;
+        }
         case "in-flight": {
             return `→ in-flight: ${verdict.reason}`;
         }
@@ -818,6 +906,11 @@ export function renderTicketDoctorResult(result) {
                 ? {}
                 : { skipReason: result.skipReasons.eligibility }),
         },
+        {
+            name: "Run state",
+            checks: result.runState,
+            ...(result.skipReasons.runState === "" ? {} : { skipReason: result.skipReasons.runState }),
+        },
         {
             name: "Worktree",
             checks: result.worktree,
@@ -879,6 +972,7 @@ export async function runTicketDoctor(parsed) {
         probeLocalBranch: probeLocalBranchImpl,
         probeRemoteBranch: probeRemoteBranchImpl,
         probePullRequest: probePullRequestImpl,
+        readRunState: (ticket) => readRunState(config, ticket),
         doFetch: parsed.doFetch,
     });
     for (const line of renderTicketDoctorResult(result)) {

package/dist/index.d.ts

@@ -1,11 +1,14 @@
 export { run } from "./cli.ts";
 export { cleanupWorkspace, type CleanupWorkspaceOptions } from "./commands/cleanupWorkspace.ts";
 export { doctor } from "./commands/doctor.ts";
+export { interruptWorkspace, type InterruptWorkspaceOptions, } from "./commands/interruptWorkspace.ts";
 export { orchestrate, type OrchestratorOptions } from "./commands/orchestrator.ts";
+export { resumeWorkspace, type ResumeWorkspaceOptions } from "./commands/resumeWorkspace.ts";
 export { setupWorkspace, type SetupWorkspaceOptions } from "./commands/setupWorkspace.ts";
-export type { Config, ModelDefinition, ResolvedConfig } from "./lib/config.ts";
-export { loadConfig } from "./lib/config.ts";
-export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, resolveModelFor, resolveRepositoryFor, type ModelResolution, type RawLinearIssue, type RepositoryResolution, } from "./lib/boardSource.ts";
+export type { Config, ModelDefinition, ProjectConfig, ResolvedConfig, ResolvedProjectConfig, } from "./lib/config.ts";
+export { findProjectBySlugId, loadConfig, unionTerminalStatuses } from "./lib/config.ts";
+export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, type RunLifecycleState, type RunState, } from "./lib/runState.ts";
+export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isTerminalStatusForBlocker, isTerminalStatusForIssue, projectFor, resolveModelFor, resolveRepositoryFor, UnknownProjectError, type ModelResolution, type RawLinearIssue, type RepositoryResolution, } from "./lib/boardSource.ts";
 export { getUsageByModel, type UsageByModel } from "./lib/usage.ts";
 export type { TicketCheck } from "./commands/ticketCheck.ts";
 export { ticketDoctor, type TicketDoctorDependencies, type TicketDoctorResult, type TicketDoctorVerdict, } from "./commands/ticketDoctor.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,YAAY,EACV,MAAM,EACN,eAAe,EACf,aAAa,EACb,cAAc,EACd,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,9 +1,12 @@
 export { run } from "./cli.js";
 export { cleanupWorkspace } from "./commands/cleanupWorkspace.js";
 export { doctor } from "./commands/doctor.js";
+export { interruptWorkspace, } from "./commands/interruptWorkspace.js";
 export { orchestrate } from "./commands/orchestrator.js";
+export { resumeWorkspace } from "./commands/resumeWorkspace.js";
 export { setupWorkspace } from "./commands/setupWorkspace.js";
-export { loadConfig } from "./lib/config.js";
-export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, resolveModelFor, resolveRepositoryFor, } from "./lib/boardSource.js";
+export { findProjectBySlugId, loadConfig, unionTerminalStatuses } from "./lib/config.js";
+export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, } from "./lib/runState.js";
+export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isTerminalStatusForBlocker, isTerminalStatusForIssue, projectFor, resolveModelFor, resolveRepositoryFor, UnknownProjectError, } from "./lib/boardSource.js";
 export { getUsageByModel } from "./lib/usage.js";
 export { ticketDoctor, } from "./commands/ticketDoctor.js";

package/dist/lib/agentLaunch.d.ts

@@ -0,0 +1,29 @@
+import type { LocalRunner, ModelDefinition, ResolvedConfig } from "./config.ts";
+interface PreparedAgentLaunch {
+    runner: LocalRunner;
+    sandboxName: string | undefined;
+}
+export declare function prepareAgentLaunch(input: {
+    config: ResolvedConfig;
+    model: string;
+    definition: ModelDefinition;
+    purpose: "runs" | "resumes";
+    signal?: AbortSignal;
+}): Promise<PreparedAgentLaunch>;
+export declare function ensureAgentSandbox(input: {
+    config: ResolvedConfig;
+    definition: ModelDefinition;
+    sandboxName: string | undefined;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function openAgentWorkspace(input: {
+    config: ResolvedConfig;
+    name: string;
+    cwd: string;
+    command: string;
+    model: string;
+    color: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=agentLaunch.d.ts.map

package/dist/lib/agentLaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOhF,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/lib/agentLaunch.js

@@ -0,0 +1,53 @@
+import { resolve } from "node:path";
+import { ensureClearance } from "@clipboard-health/clearance";
+import { ensureSandbox, sandboxNameFor } from "./dockerSandbox.js";
+import { detectHostCapabilities } from "./host.js";
+import { assertLocalRunnerRequirements, resolveLocalRunner } from "./localRunner.js";
+import { log, sleep } from "./util.js";
+import { workspaces } from "./workspaces.js";
+export async function prepareAgentLaunch(input) {
+    const host = await detectHostCapabilities(input.signal);
+    const runner = resolveLocalRunner(input.config.local.runner, host);
+    assertLocalRunnerRequirements(host, runner);
+    if (runner === "safehouse") {
+        await ensureClearance({
+            logger: log,
+            ...(input.signal === undefined
+                ? {}
+                : {
+                    sleep: async (ms) => {
+                        await sleep(ms, input.signal);
+                        input.signal?.throwIfAborted();
+                    },
+                }),
+        });
+        input.signal?.throwIfAborted();
+    }
+    if (runner === "sdx" && input.definition.sandbox === undefined) {
+        throw new Error(`Local groundcrew ${input.purpose} with the sdx runner require a sandbox config on model '${input.model}'.`);
+    }
+    const sandboxName = runner === "sdx" && input.definition.sandbox !== undefined
+        ? sandboxNameFor({ agent: input.definition.sandbox.agent })
+        : undefined;
+    return { runner, sandboxName };
+}
+export async function ensureAgentSandbox(input) {
+    if (input.sandboxName !== undefined && input.definition.sandbox !== undefined) {
+        await ensureSandbox({
+            sandboxName: input.sandboxName,
+            sandbox: input.definition.sandbox,
+            mountPath: resolve(input.config.workspace.projectDir),
+        }, input.signal);
+    }
+}
+export async function openAgentWorkspace(input) {
+    const spec = {
+        name: input.name,
+        cwd: input.cwd,
+        command: input.command,
+        status: { text: input.model, color: input.color, icon: "sparkle" },
+    };
+    await (input.signal === undefined
+        ? workspaces.open(input.config, spec)
+        : workspaces.open(input.config, spec, input.signal));
+}

package/dist/lib/boardSource.d.ts

@@ -4,11 +4,19 @@
  * typed `BoardState` instead of raw nodes.
  */
 import type { LinearClient } from "@linear/sdk";
-import { type ResolvedConfig } from "./config.ts";
+import { type ResolvedConfig, type ResolvedProjectConfig } from "./config.ts";
 export interface Blocker {
     id: string;
     title: string;
     status: string | undefined;
+    /**
+     * SlugId of the project the blocker lives in. `undefined` when Linear
+     * returned no project for the blocker (rare — issues can technically
+     * exist without a project). Drives `isTerminalStatusForBlocker`'s
+     * pick between the blocker's own project terminals and the global
+     * union fallback.
+     */
+    projectSlugId: string | undefined;
 }
 export interface Issue {
     id: string;
@@ -23,6 +31,8 @@ export interface Issue {
     /** `undefined` when the ticket has no `agent-*` label — i.e. not groundcrew's concern. */
     model: string | undefined;
     teamId: string;
+    /** SlugId of the Linear project the issue belongs to — always one of `linear.projects[*].slugId`. */
+    projectSlugId: string;
     blockers: Blocker[];
     hasMoreBlockers: boolean;
 }
@@ -46,10 +56,22 @@ export declare class RepositoryResolutionError extends Error {
         repositories: readonly string[];
     });
 }
+export declare class UnknownProjectError extends Error {
+    readonly ticket: string;
+    readonly projectSlugId: string | undefined;
+    readonly configuredSlugIds: readonly string[];
+    constructor(arguments_: {
+        ticket: string;
+        projectSlugId: string | undefined;
+        configuredSlugIds: readonly string[];
+    });
+}
 export interface BoardSource {
     /**
-     * Look up the configured project and fail loudly if it isn't there. Run
-     * once at startup so a misconfigured slug surfaces before the first tick.
+     * Look up the configured projects and warn loudly on any that aren't
+     * there. Throws only when zero projects resolve, so a typo in one of
+     * several entries doesn't abort the watch loop. Run once at startup
+     * so misconfigurations surface before the first tick.
      */
     verify(): Promise<void>;
     /** Fetch the current board snapshot. Paginates internally. */
@@ -60,7 +82,16 @@ interface BoardSourceDeps {
     client: LinearClient;
 }
 export declare function createBoardSource(deps: BoardSourceDeps): BoardSource;
-export declare function isTerminalStatus(status: string, config: ResolvedConfig): boolean;
+export declare function projectFor(issue: Issue, config: ResolvedConfig): ResolvedProjectConfig;
+export declare function isTerminalStatusForIssue(issue: Issue, config: ResolvedConfig): boolean;
+/**
+ * Terminal check for a blocker. When the blocker lives in a configured
+ * project, we use that project's terminal list directly. Otherwise we
+ * fall back to the union of terminals across all configured projects —
+ * matches today's single-project "is this name in our terminal list?"
+ * behavior so off-config blockers don't regress.
+ */
+export declare function isTerminalStatusForBlocker(blocker: Blocker, config: ResolvedConfig): boolean;
 interface ResolvedIssue {
     uuid: string;
     title: string;
@@ -68,12 +99,14 @@ interface ResolvedIssue {
     repository: string;
     model: string;
     teamId: string;
+    projectSlugId: string;
 }
 export interface RawLinearIssue {
     uuid: string;
     title: string;
     description: string;
     teamId: string;
+    projectSlugId: string | undefined;
     labels: {
         name: string;
     }[];
@@ -127,7 +160,10 @@ export declare function resolveModelFor(arguments_: {
 /**
  * `agent-any` collapses to `models.default` here — manual setup doesn't run
  * the usage-gated `any` resolver, so the caller gets a concrete model name
- * instead of a sentinel that downstream code can't interpret.
+ * instead of a sentinel that downstream code can't interpret. Throws
+ * `UnknownProjectError` when the ticket lives in a Linear project that
+ * isn't listed in `linear.projects`, so callers can surface the misconfiguration
+ * instead of silently using the wrong status names.
  */
 export declare function fetchResolvedIssue(arguments_: {
     client: LinearClient;

package/dist/lib/boardSource.d.ts.map

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