@clipboard-health/groundcrew 3.1.3 → 3.1.4

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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"}

package/dist/lib/boardSource.js

@@ -3,7 +3,7 @@
  * snapshot. Owns the GraphQL queries and shape parsing so callers consume a
  * typed `BoardState` instead of raw nodes.
  */
-import { AGENT_ANY_MODEL, isShippedDefaultDisabled } from "./config.js";
+import { AGENT_ANY_MODEL, findProjectBySlugId, isShippedDefaultDisabled, unionTerminalStatuses, } from "./config.js";
 import { log } from "./util.js";
 const AGENT_LABEL_PREFIX = "agent-";
 const ISSUES_PAGE_SIZE = 250;
@@ -17,61 +17,115 @@ export class RepositoryResolutionError extends Error {
         this.name = "RepositoryResolutionError";
     }
 }
+export class UnknownProjectError extends Error {
+    ticket;
+    projectSlugId;
+    configuredSlugIds;
+    constructor(arguments_) {
+        const { ticket, projectSlugId, configuredSlugIds } = arguments_;
+        const ticketProjectClause = projectSlugId === undefined
+            ? "has no associated Linear project"
+            : `belongs to Linear project slugId "${projectSlugId}"`;
+        super(`Ticket ${ticket} ${ticketProjectClause}, which is not in linear.projects (configured: ${configuredSlugIds.join(", ")}). Add the project to your crew config or pick a ticket from a configured project.`);
+        this.name = "UnknownProjectError";
+        this.ticket = ticket;
+        this.projectSlugId = projectSlugId;
+        this.configuredSlugIds = configuredSlugIds;
+    }
+}
 export function createBoardSource(deps) {
     const { config, client } = deps;
     return {
         async verify() {
-            await verifyProject(client, config);
+            await verifyProjects(client, config);
         },
         async fetch() {
             return await fetchBoard(client, config);
         },
     };
 }
-export function isTerminalStatus(status, config) {
-    return config.linear.statuses.terminal.includes(status);
+export function projectFor(issue, config) {
+    const resolved = findProjectBySlugId(config, issue.projectSlugId);
+    /* v8 ignore next 5 @preserve -- fetchBoard's slugId filter and issueStatusBelongsToOwnProject keep production issues from reaching here with an unknown slugId */
+    if (resolved === undefined) {
+        throw new Error(`Issue ${issue.id} carries projectSlugId "${issue.projectSlugId}" which is not in linear.projects`);
+    }
+    return resolved;
+}
+export function isTerminalStatusForIssue(issue, config) {
+    return projectFor(issue, config).statuses.terminal.includes(issue.status);
+}
+/**
+ * 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 function isTerminalStatusForBlocker(blocker, config) {
+    if (blocker.status === undefined) {
+        return false;
+    }
+    if (blocker.projectSlugId !== undefined) {
+        const project = findProjectBySlugId(config, blocker.projectSlugId);
+        if (project !== undefined) {
+            return project.statuses.terminal.includes(blocker.status);
+        }
+    }
+    return unionTerminalStatuses(config).has(blocker.status);
 }
-async function verifyProject(client, config) {
-    const response = await client.client.rawRequest(`query VerifyProject($slugId: String!) {
-      projects(filter: { slugId: { eq: $slugId } }, first: 1) {
+async function verifyProjects(client, config) {
+    const slugIds = config.linear.projects.map((project) => project.slugId);
+    const response = await client.client.rawRequest(`query VerifyProjects($slugIds: [String!]!) {
+      projects(filter: { slugId: { in: $slugIds } }, first: ${slugIds.length}) {
         nodes { id name slugId }
       }
-    }`, { slugId: config.linear.slugId });
+    }`, { slugIds });
     // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by our GraphQL query above
     const { projects } = response.data;
-    const [project] = projects.nodes;
-    if (!project) {
-        throw new Error(`No Linear project found with slugId "${config.linear.slugId}" (linear.projectSlug = "${config.linear.projectSlug}"). Confirm the slug matches the trailing segment of your project's URL and that your Linear API key can access this workspace.`);
+    const resolved = new Map(projects.nodes.map((project) => [project.slugId.toLowerCase(), project]));
+    for (const project of config.linear.projects) {
+        const found = resolved.get(project.slugId);
+        if (found === undefined) {
+            log(`WARNING: no Linear project found with slugId "${project.slugId}" (linear.projects entry "${project.projectSlug}"). Check for typos, archived projects, or missing API-key access. Continuing without this project.`);
+            continue;
+        }
+        log(`Resolved Linear project: ${found.name} (slugId ${found.slugId})`);
+    }
+    if (resolved.size === 0) {
+        throw new Error(`No Linear projects resolved from linear.projects (${config.linear.projects.map((project) => `"${project.projectSlug}"`).join(", ")}). Confirm slugs match the trailing segment of each project's URL and that your Linear API key can access this workspace.`);
     }
-    log(`Resolved Linear project: ${project.name} (slugId ${project.slugId})`);
 }
 async function fetchBoard(client, config) {
     const nodes = [];
     let after = null;
     // Two server-side filters narrow the response to tickets the orchestrator
     // can actually act on:
-    //   1. State: only Todo (to dispatch), In-Progress (to count active
-    //      capacity), Done + extra terminal states (to drive cleanup). Backlog,
-    //      Triage, and custom columns are dropped server-side.
+    //   1. State: union of every configured project's
+    //      {todo, inProgress, done, terminal} state names. Backlog, Triage,
+    //      and custom columns are dropped server-side. Each issue is
+    //      post-filtered against ITS OWN project's statuses below so a
+    //      state name from project A doesn't leak into project B.
     //   2. Labels: at least one `agent-*` label — i.e. someone opted the ticket
     //      in to groundcrew. Without this, every human-owned ticket on a shared
     //      project would round-trip back just to be filtered out client-side.
     // The client-side `isGroundcrewIssue` guard in dispatcher.ts is now
     // belt-and-suspenders against query drift, not the load-bearing filter.
+    const slugIds = config.linear.projects.map((project) => project.slugId);
     const stateNames = [
-        ...new Set([
-            config.linear.statuses.todo,
-            config.linear.statuses.inProgress,
-            config.linear.statuses.done,
-            ...config.linear.statuses.terminal,
-        ]),
+        ...new Set(config.linear.projects.flatMap((project) => [
+            project.statuses.todo,
+            project.statuses.inProgress,
+            project.statuses.done,
+            ...project.statuses.terminal,
+        ])),
     ];
     for (;;) {
         // oxlint-disable-next-line no-await-in-loop -- pagination cursor depends on the previous response
-        const response = await client.client.rawRequest(`query BoardIssues($slugId: String!, $stateNames: [String!]!, $agentLabelPrefix: String!, $after: String) {
+        const response = await client.client.rawRequest(`query BoardIssues($slugIds: [String!]!, $stateNames: [String!]!, $agentLabelPrefix: String!, $after: String) {
         issues(
           filter: {
-            project: { slugId: { eq: $slugId } }
+            project: { slugId: { in: $slugIds } }
             state: { name: { in: $stateNames } }
             labels: { some: { name: { startsWith: $agentLabelPrefix } } }
           }
@@ -88,6 +142,7 @@ async function fetchBoard(client, config) {
             state { id name }
             team { id key }
             assignee { name }
+            project { slugId }
             children { nodes { id } }
             labels {
               nodes {
@@ -101,6 +156,7 @@ async function fetchBoard(client, config) {
                   identifier
                   title
                   state { name }
+                  project { slugId }
                 }
               }
               pageInfo { hasNextPage }
@@ -109,7 +165,7 @@ async function fetchBoard(client, config) {
           pageInfo { hasNextPage endCursor }
         }
       }`, {
-            slugId: config.linear.slugId,
+            slugIds,
             stateNames,
             agentLabelPrefix: AGENT_LABEL_PREFIX,
             after,
@@ -128,44 +184,86 @@ async function fetchBoard(client, config) {
     // would abort the whole `crew run` before the Todo filter ever runs.
     const issues = nodes
         .filter((node) => node.children.nodes.length === 0)
-        .map((node) => {
-        const modelResolution = resolveModelFor({ labels: node.labels.nodes, config });
-        warnIfDisabledFallback(node.identifier, modelResolution, config);
-        const repository = modelResolution.kind === "no-label"
-            ? undefined
-            : parseRepository({
-                description: node.description ?? undefined,
-                config,
-                repositoryRegex,
-                ticket: node.identifier,
-            });
-        let model;
-        if (modelResolution.kind === "matched") {
-            ({ model } = modelResolution);
-        }
-        else if (modelResolution.kind === "disabled-fallback") {
-            model = modelResolution.fallbackModel;
-        }
-        else if (modelResolution.kind === "agent-any") {
-            model = AGENT_ANY_MODEL;
-        }
-        return {
-            id: node.identifier.toLowerCase(),
-            uuid: node.id,
-            title: node.title,
-            status: node.state?.name ?? "Unknown",
-            statusId: node.state?.id ?? "",
-            assignee: node.assignee?.name ?? "Unassigned",
-            updatedAt: node.updatedAt,
-            repository,
-            model,
-            teamId: node.team?.id ?? "",
-            blockers: blockersFromRelations(node.inverseRelations?.nodes ?? []),
-            hasMoreBlockers: node.inverseRelations?.pageInfo.hasNextPage ?? false,
-        };
-    });
+        .filter((node) => issueStatusBelongsToOwnProject(node, config))
+        .map((node) => issueFromNode(node, config, repositoryRegex));
     return { timestamp: new Date().toISOString(), issues };
 }
+function modelForResolution(resolution) {
+    if (resolution.kind === "matched") {
+        return resolution.model;
+    }
+    if (resolution.kind === "disabled-fallback") {
+        return resolution.fallbackModel;
+    }
+    if (resolution.kind === "agent-any") {
+        return AGENT_ANY_MODEL;
+    }
+    return undefined;
+}
+function issueFromNode(node, config, repositoryRegex) {
+    const modelResolution = resolveModelFor({ labels: node.labels.nodes, config });
+    warnIfDisabledFallback(node.identifier, modelResolution, config);
+    const repository = modelResolution.kind === "no-label"
+        ? undefined
+        : parseRepository({
+            description: node.description ?? undefined,
+            config,
+            repositoryRegex,
+            ticket: node.identifier,
+        });
+    // `issueStatusBelongsToOwnProject` drops nodes whose `state` or `project`
+    // is missing, so by the time we land here both are defined. The nullish
+    // coalescing on those fields is belt-and-suspenders for type narrowing.
+    return {
+        id: node.identifier.toLowerCase(),
+        uuid: node.id,
+        title: node.title,
+        /* v8 ignore next @preserve -- post-filter guarantees `state` is defined */
+        status: node.state?.name ?? "Unknown",
+        /* v8 ignore next @preserve -- post-filter guarantees `state` is defined */
+        statusId: node.state?.id ?? "",
+        assignee: node.assignee?.name ?? "Unassigned",
+        updatedAt: node.updatedAt,
+        repository,
+        model: modelForResolution(modelResolution),
+        teamId: node.team?.id ?? "",
+        /* v8 ignore next @preserve -- post-filter guarantees `project` is defined */
+        projectSlugId: node.project?.slugId?.toLowerCase() ?? "",
+        blockers: blockersFromRelations(node.inverseRelations?.nodes ?? []),
+        hasMoreBlockers: node.inverseRelations?.pageInfo.hasNextPage ?? false,
+    };
+}
+/**
+ * Drops issues whose status name isn't recognized by their own project's
+ * configured statuses. The union `stateNames` filter sent to Linear can
+ * pull in an issue from project A whose status name appears in project
+ * B's status list but not A's; this guard removes that cross-project
+ * leakage so each issue is judged only against its own project's rules.
+ */
+function issueStatusBelongsToOwnProject(node, config) {
+    const slugId = node.project?.slugId?.toLowerCase();
+    if (slugId === undefined) {
+        return false;
+    }
+    const project = findProjectBySlugId(config, slugId);
+    if (project === undefined) {
+        return false;
+    }
+    const status = node.state?.name;
+    /* v8 ignore next 3 @preserve -- GraphQL state filter only returns issues whose state name is in the configured union; an undefined status implies a degenerate Linear response */
+    if (status === undefined) {
+        return false;
+    }
+    return projectStateNames(project).has(status);
+}
+function projectStateNames(project) {
+    return new Set([
+        project.statuses.todo,
+        project.statuses.inProgress,
+        project.statuses.done,
+        ...project.statuses.terminal,
+    ]);
+}
 function escapeRegex(value) {
     return value.replaceAll(/[$()*+.?[\\\]^{|}]/g, String.raw `\$&`);
 }
@@ -200,6 +298,7 @@ export async function fetchBlockersForTicket(arguments_) {
                 identifier
                 title
                 state { name }
+                project { slugId }
               }
             }
             pageInfo { hasNextPage endCursor }
@@ -227,6 +326,7 @@ export async function fetchRawLinearIssue(arguments_) {
         title
         description
         team { id }
+        project { slugId }
         state { name }
         labels(first: ${ISSUE_LABEL_PAGE_SIZE}) {
           nodes { name }
@@ -238,6 +338,7 @@ export async function fetchRawLinearIssue(arguments_) {
               identifier
               title
               state { name }
+              project { slugId }
             }
           }
           pageInfo { hasNextPage }
@@ -254,6 +355,7 @@ export async function fetchRawLinearIssue(arguments_) {
         title: issue.title,
         description: issue.description ?? "",
         teamId: issue.team?.id ?? "",
+        projectSlugId: issue.project?.slugId?.toLowerCase(),
         labels: issue.labels.nodes,
         stateName: issue.state?.name ?? "",
         blockers: blockersFromRelations(issue.inverseRelations?.nodes ?? []),
@@ -262,33 +364,58 @@ export async function fetchRawLinearIssue(arguments_) {
 }
 export async function fetchInProgressIssueCount(arguments_) {
     const { client, config } = arguments_;
+    const slugIds = config.linear.projects.map((project) => project.slugId);
+    // The union state filter is permissive: it can pull in an issue whose state
+    // name happens to match a different project's `inProgress`. Post-filter
+    // against each issue's OWN project to count only true in-progress tickets.
+    const stateNames = [
+        ...new Set(config.linear.projects.map((project) => project.statuses.inProgress)),
+    ];
     let after = null;
     let count = 0;
     for (;;) {
         // oxlint-disable-next-line no-await-in-loop -- pagination cursor depends on the previous response
-        const response = await client.client.rawRequest(`query InProgressIssues($slugId: String!, $stateName: String!, $agentLabelPrefix: String!, $after: String) {
+        const response = await client.client.rawRequest(`query InProgressIssues($slugIds: [String!]!, $stateNames: [String!]!, $agentLabelPrefix: String!, $after: String) {
         issues(
           filter: {
-            project: { slugId: { eq: $slugId } }
-            state: { name: { eq: $stateName } }
+            project: { slugId: { in: $slugIds } }
+            state: { name: { in: $stateNames } }
             labels: { some: { name: { startsWith: $agentLabelPrefix } } }
           }
           first: ${ISSUES_PAGE_SIZE}
           after: $after
           includeArchived: false
         ) {
-          nodes { id }
+          nodes {
+            id
+            project { slugId }
+            state { name }
+          }
           pageInfo { hasNextPage endCursor }
         }
       }`, {
-            slugId: config.linear.slugId,
-            stateName: config.linear.statuses.inProgress,
+            slugIds,
+            stateNames,
             agentLabelPrefix: AGENT_LABEL_PREFIX,
             after,
         });
         // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by our GraphQL query above
         const { issues: page } = response.data;
-        count += page.nodes.length;
+        for (const node of page.nodes) {
+            const slugId = node.project?.slugId?.toLowerCase();
+            /* v8 ignore next 3 @preserve -- GraphQL slugId filter scopes results to configured projects */
+            if (slugId === undefined) {
+                continue;
+            }
+            const project = findProjectBySlugId(config, slugId);
+            /* v8 ignore next 3 @preserve -- GraphQL slugId filter scopes results to configured projects */
+            if (project === undefined) {
+                continue;
+            }
+            if (node.state?.name === project.statuses.inProgress) {
+                count += 1;
+            }
+        }
         if (!page.pageInfo.hasNextPage) {
             return count;
         }
@@ -327,19 +454,31 @@ export 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 async function fetchResolvedIssue(arguments_) {
     const { client, config, ticket } = arguments_;
+    const upper = ticket.toUpperCase();
     const raw = await fetchRawLinearIssue({ client, ticket });
+    const project = raw.projectSlugId === undefined ? undefined : findProjectBySlugId(config, raw.projectSlugId);
+    if (project === undefined) {
+        throw new UnknownProjectError({
+            ticket: upper,
+            projectSlugId: raw.projectSlugId,
+            configuredSlugIds: config.linear.projects.map((entry) => entry.slugId),
+        });
+    }
     const repositoryResolution = resolveRepositoryFor({
         description: raw.description,
         config,
-        ticket: ticket.toUpperCase(),
+        ticket: upper,
     });
     if (repositoryResolution.kind === "missing") {
         throw new RepositoryResolutionError({
-            ticket: ticket.toUpperCase(),
+            ticket: upper,
             repositories: config.workspace.knownRepositories,
         });
     }
@@ -362,6 +501,7 @@ export async function fetchResolvedIssue(arguments_) {
         repository: repositoryResolution.repository,
         model,
         teamId: raw.teamId,
+        projectSlugId: project.slugId,
     };
 }
 function parseRepository(arguments_) {
@@ -436,5 +576,6 @@ function blockersFromRelations(relations) {
         id: relation.issue?.identifier?.toLowerCase() ?? "unknown",
         title: relation.issue?.title ?? "",
         status: relation.issue?.state?.name,
+        projectSlugId: relation.issue?.project?.slugId?.toLowerCase(),
     }));
 }

package/dist/lib/config.d.ts

@@ -94,29 +94,43 @@ interface DisabledUserModelDefinition {
     disabled: true;
 }
 type UserModelDefinition = EnabledUserModelDefinition | DisabledUserModelDefinition;
+/**
+ * One Linear project the orchestrator should watch. Each project has its
+ * own status name overrides so multi-team setups with divergent workflow
+ * state names (e.g. "Todo" vs "To Do", "Shipped" vs "Done") can coexist
+ * under one `crew` process.
+ */
+export interface ProjectConfig {
+    /**
+     * Project URL slug as it appears in Linear's URL bar — e.g.
+     * `ai-strategy-5152195762f3` from
+     * `https://linear.app/<workspace>/project/ai-strategy-5152195762f3`.
+     * The trailing 12-character hex `slugId` is what's used for the
+     * GraphQL filter; the leading name segment is kept intact in the
+     * config so `config.ts` is self-documenting at a glance, and so it
+     * survives Linear project renames.
+     */
+    projectSlug: string;
+    statuses?: {
+        todo?: string;
+        inProgress?: string;
+        done?: string;
+        terminal?: string[];
+    };
+}
 /**
  * Loose user-facing shape — what a `config.ts` file declares.
- * Fields with defaults are optional; only `linear.projectSlug` and the
+ * Fields with defaults are optional; only `linear.projects` and the
  * `workspace.*` fields are required.
  */
 export interface Config {
     linear: {
         /**
-         * Project URL slug as it appears in Linear's URL bar — e.g.
-         * `ai-strategy-5152195762f3` from
-         * `https://linear.app/<workspace>/project/ai-strategy-5152195762f3`.
-         * The trailing 12-character hex `slugId` is what's used for the
-         * GraphQL filter; the leading name segment is kept intact in the
-         * config so `config.ts` is self-documenting at a glance, and so it
-         * survives Linear project renames.
+         * One or more Linear projects to watch. A single `crew` process
+         * dispatches across all configured projects under a shared
+         * `orchestrator.maximumInProgress` budget.
          */
-        projectSlug: string;
-        statuses?: {
-            todo?: string;
-            inProgress?: string;
-            done?: string;
-            terminal?: string[];
-        };
+        projects: ProjectConfig[];
     };
     git?: {
         remote?: string;
@@ -168,21 +182,24 @@ export interface Config {
         file?: string;
     };
 }
+export interface ResolvedProjectConfig {
+    /** Original full slug from `ProjectConfig.projectSlug` — for log lines. */
+    projectSlug: string;
+    /** 12-char hex tail of `projectSlug` — the value Linear filters on. */
+    slugId: string;
+    statuses: {
+        todo: string;
+        inProgress: string;
+        done: string;
+        terminal: string[];
+    };
+}
 /**
  * Strict shape after defaults are applied — what scripts work with.
  */
 export interface ResolvedConfig {
     linear: {
-        /** Original full slug from `Config.linear.projectSlug` — for log lines. */
-        projectSlug: string;
-        /** 12-char hex tail of `projectSlug` — the value Linear filters on. */
-        slugId: string;
-        statuses: {
-            todo: string;
-            inProgress: string;
-            done: string;
-            terminal: string[];
-        };
+        projects: ResolvedProjectConfig[];
     };
     git: {
         remote: string;
@@ -228,5 +245,22 @@ export interface ResolvedConfig {
  * Consumers needing to distinguish disabled-by-user from unknown-label use this.
  */
 export declare function isShippedDefaultDisabled(config: Pick<ResolvedConfig, "models">, name: string): boolean;
+/**
+ * Returns the resolved project the issue belongs to, or `undefined` when
+ * its slugId isn't in `linear.projects[]`. Callers in the dispatcher
+ * path expect a project to always exist (the board fetch only surfaces
+ * issues from configured projects); callers in the manual-ticket path
+ * (`setupWorkspace`, `ticketDoctor`) use this to detect off-config
+ * tickets and surface a clear error.
+ */
+export declare function findProjectBySlugId(config: Pick<ResolvedConfig, "linear">, slugId: string): ResolvedProjectConfig | undefined;
+/**
+ * Union of every terminal status name configured across all watched
+ * projects. Used for blocker terminal checks when the blocker belongs
+ * to a project we don't watch — matches today's single-project "is the
+ * status terminal under any configured project?" behavior so off-config
+ * blockers don't regress.
+ */
+export declare function unionTerminalStatuses(config: Pick<ResolvedConfig, "linear">): ReadonlySet<string>;
 export declare function loadConfig(): Promise<Readonly<ResolvedConfig>>;
 //# sourceMappingURL=config.d.ts.map