@clipboard-health/groundcrew 3.1.5 → 3.1.7

package/README.md

@@ -173,6 +173,53 @@ Three keys are required; everything else has a default.
 
 Agent selection uses Linear labels: `agent-claude`, `agent-codex`, `agent-<name>`. `crew run` without `--ticket` only fetches tickets carrying an `agent-*` label — the GraphQL query filters server-side, so unlabeled tickets are never returned by Linear and do not appear on the board. Use `crew run --ticket <TICKET>` to provision an unlabeled ticket on demand (falls back to `models.default`). `agent-any` routes to the model with the most available session capacity. Todo tickets blocked by non-terminal blockers are skipped until their blockers reach a terminal status.
 
+### Pluggable ticket sources
+
+`sources` declares extra ticket-system adapters. The current release verifies configured extra sources during `crew run` startup; the dispatch loop still reads Linear through `linear.projects` until the consumer refactor lands. This lets you validate shell/Jira/local-plan integrations without changing existing Linear behavior.
+
+The built-in `shell` adapter runs command templates and reads JSON from stdout:
+
+```ts
+export default {
+  // ...
+  sources: [
+    {
+      kind: "shell",
+      name: "jira",
+      commands: {
+        verify: "jira me",
+        fetch: "~/.config/groundcrew/jira-fetch.sh",
+        resolveOne: "~/.config/groundcrew/jira-resolve.sh ${id}",
+        markInProgress: "jira issue move ${id} 'In Progress'",
+      },
+      timeouts: { fetch: 60_000 },
+    },
+  ],
+};
+```
+
+`commands.fetch` must print a JSON array of issues. `commands.resolveOne`, when set, must print one issue, print nothing for "not found", or exit `3` for "not found". `commands.markInProgress`, when set, receives the issue's `sourceRef` as JSON on stdin. `${id}`, `${canonicalId}`, and `${name}` placeholders are shell-quoted before substitution.
+
+```json
+[
+  {
+    "id": "JIRA-123",
+    "title": "Add retry logic",
+    "description": "Ticket body",
+    "status": "todo",
+    "repository": "your-org/your-repo",
+    "model": "claude",
+    "assignee": "Alice",
+    "updatedAt": "2026-05-22T15:00:00Z",
+    "blockers": [{ "id": "JIRA-122", "title": "Schema migration", "status": "done" }],
+    "hasMoreBlockers": false,
+    "sourceRef": { "nativeId": "10042" }
+  }
+]
+```
+
+Allowed `status` values are `todo`, `in-progress`, `in-review`, `done`, and `other`. Use `null` for `repository` or `model` when a ticket should not be groundcrew-eligible. `hasMoreBlockers` is optional and defaults to `false`; `sourceRef` is opaque data that groundcrew passes back to your writeback command.
+
 ### Prompt customization
 
 Groundcrew ships one model-agnostic unattended prompt by default. It tells the agent to make reasonable assumptions, follow repository instructions, run documented verification, review its diff, open a PR when GitHub/`gh` is available, and include a workspace continuation hint when known.
@@ -203,6 +250,7 @@ This keeps package defaults portable while letting your private config reference
 | `linear.projects[].statuses.inProgress` | `"In Progress"`     | Status set after a workspace is provisioned; counts toward the shared `maximumInProgress`.                                                                                                                                                                                                                                                                              |
 | `linear.projects[].statuses.done`       | `"Done"`            | Status that triggers worktree cleanup for this project.                                                                                                                                                                                                                                                                                                                 |
 | `linear.projects[].statuses.terminal`   | `["Done"]`          | Additional status names treated as terminal for cleanup and blocker checks. The project's `done` status is always included.                                                                                                                                                                                                                                             |
+| `sources`                               | `[]`                | Additional pluggable ticket sources. Extra sources are verified at startup; Linear remains the dispatch read path until the consumer refactor. Built-in kinds: `shell`, `linear`.                                                                                                                                                                                       |
 | `git.remote`                            | `"origin"`          | Remote used for `fetch` and as the worktree base ref.                                                                                                                                                                                                                                                                                                                   |
 | `git.defaultBranch`                     | `"main"`            | Branch fetched from `git.remote` and used as the worktree base.                                                                                                                                                                                                                                                                                                         |
 | `workspace.projectDir`                  | **required**        | Parent dir for cloned repos and sibling ticket worktrees.                                                                                                                                                                                                                                                                                                               |

package/crew.config.example.ts

@@ -40,6 +40,26 @@ export default {
   // Everything below is optional — defaults shown for reference. Uncomment
   // and edit to override.
   //
+  // // Additional pluggable ticket sources beyond the implicit built-in
+  // // Linear adapter (configured via `linear.projects` above). The most
+  // // common use is `kind: "shell"`, which wires any external system via
+  // // command templates that emit/consume JSON. See the shell adapter's
+  // // ShellIssue schema for the JSON contract `fetch` / `resolveOne` must
+  // // emit.
+  // sources: [
+  //   {
+  //     kind: "shell",
+  //     name: "jira",
+  //     commands: {
+  //       verify: "jira me",
+  //       fetch: "~/.config/groundcrew/jira-fetch.sh",
+  //       resolveOne: "~/.config/groundcrew/jira-resolve.sh ${id}",
+  //       markInProgress: "jira issue move ${id} 'In Progress'",
+  //     },
+  //     timeouts: { fetch: 60_000 },
+  //   },
+  // ],
+  //
   // git: { remote: "origin", defaultBranch: "main" },
   //
   // orchestrator: {

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

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/commands/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,UAAU,cAAc;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,+FAA+F;QAC/F,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAwLjE"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/commands/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,UAAU,cAAc;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,+FAA+F;QAC/F,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAuMjE"}

package/dist/commands/dispatcher.js

@@ -87,6 +87,18 @@ export function createDispatcher(deps) {
     async function runOnce(arguments_) {
         const { state, worktreeEntries, usage, dryRun, signal, idleSuffix = "" } = arguments_;
         issueStatusUpdater.resetMissingInProgressCache();
+        // Surface parent tickets that fetchBoard silently dropped. Without this
+        // an operator sees "No Todo tickets to pick up" with no signal that an
+        // expected Todo+labelled ticket was skipped because it has sub-issues.
+        for (const skip of state.parentSkips) {
+            log(`Skipping ${skip.id}: parent ticket with ${skip.childCount} sub-issue(s) — groundcrew works sub-issues, not parents`);
+            logEvent("dispatch", {
+                outcome: "skipped",
+                reason: "parent_with_children",
+                ticket: skip.id,
+                children: skip.childCount,
+            });
+        }
         const activeCount = state.issues.filter((issue) => issue.status === projectFor(issue, config).statuses.inProgress).length;
         const slots = config.orchestrator.maximumInProgress - activeCount;
         // Narrow Todo to tickets that opted in via an `agent-*` label.

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;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,CAoC7E"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6DH,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,CA4C7E"}

package/dist/commands/orchestrator.js

@@ -5,6 +5,8 @@
  * orchestrator's user-facing output.
  */
 import { createBoardSource, RepositoryResolutionError, } from "../lib/boardSource.js";
+import { createBoard } from "../lib/board.js";
+import { buildSources } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
 import { getUsageByModel } from "../lib/usage.js";
 import { errorMessage, getLinearClient, log, sleep } from "../lib/util.js";
@@ -65,6 +67,13 @@ export async function orchestrate(options) {
     const client = getLinearClient();
     const boardSource = createBoardSource({ config, client });
     await boardSource.verify();
+    // Verify any pluggable sources declared in config.sources (shell adapters,
+    // future built-in adapters) at startup. The Linear path still runs through
+    // boardSource.fetch in the main loop; shell-source dispatch is a follow-up.
+    // An empty config.sources resolves to an empty Board and verify() is a no-op.
+    const extraSources = await buildSources(config.sources, { globalConfig: config });
+    const board = createBoard(extraSources);
+    await board.verify();
     const cleaner = createCleaner({ config });
     const dispatcher = createDispatcher({ config, client });
     // Folded into the dispatcher's idle log lines in watch mode so each idle

package/dist/commands/ticketDoctor.d.ts

@@ -145,14 +145,26 @@ export interface TicketDoctorDependencies {
     probeWorkingTree: (input: {
         worktreeDir: string;
     }) => Promise<WorktreeDirtiness>;
+    /**
+     * Resolves the default branch for `repoDir` (e.g. "master" vs "main") from
+     * the local clone's `refs/remotes/<remote>/HEAD`, falling back to
+     * `config.git.defaultBranch`. Injected so probeLocalBranchSection can pass a
+     * per-repo branch into `probeLocalBranch` without each probe needing to
+     * shell out to git itself.
+     */
+    resolveDefaultBranch: (input: {
+        repoDir: string;
+    }) => Promise<string>;
     probeLocalBranch: (input: {
         repoDir: string;
         branch: string;
+        remote: string;
         defaultBranch: string;
     }) => Promise<LocalBranchProbe>;
     probeRemoteBranch: (input: {
         repoDir: string;
         branch: string;
+        remote: string;
         doFetch: boolean;
     }) => Promise<RemoteBranchProbe>;
     probePullRequest: (input: {

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

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

package/dist/commands/ticketDoctor.js

@@ -18,6 +18,7 @@ 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 { resolveDefaultBranch } from "../lib/defaultBranch.js";
 import { AGENT_ANY_MODEL, findProjectBySlugId, loadConfig, } from "../lib/config.js";
 import { which } from "../lib/host.js";
 import { readRunState } from "../lib/runState.js";
@@ -258,6 +259,17 @@ function buildRepoChecks(raw, config, ticket) {
     const resolvedRepository = repositoryResolution.kind === "ok" ? repositoryResolution.repository : "";
     return { resolvedRepository, checks };
 }
+function buildChildrenCheck(raw) {
+    if (raw.hasChildren) {
+        return {
+            name: "Has no sub-issues",
+            status: "fail",
+            detail: "parent ticket with sub-issues — groundcrew works sub-issues, not parents; label a sub-issue or detach the children",
+            failureSummary: "parent ticket with sub-issues — groundcrew works sub-issues, not parents",
+        };
+    }
+    return { name: "Has no sub-issues", status: "ok" };
+}
 async function runEligibilityChecks(arguments_) {
     const { ticket, raw, config, resolvedRepository, resolvedModel, dependencies, eligibility } = arguments_;
     const blockers = await dependencies.fetchBlockersFor({ ticket, uuid: raw.uuid });
@@ -531,10 +543,12 @@ async function probeLocalBranchSection(deps, entry) {
         };
     }
     const repoDir = repoDirFromEntry(entry, deps);
+    const defaultBranch = await deps.resolveDefaultBranch({ repoDir });
     const probe = await deps.probeLocalBranch({
         repoDir,
         branch: entry.branchName,
-        defaultBranch: deps.config.git.defaultBranch,
+        remote: deps.config.git.remote,
+        defaultBranch,
     });
     if (probe.kind === "present") {
         const defaultBranchName = probe.defaultBranch ?? deps.config.git.defaultBranch;
@@ -543,7 +557,7 @@ async function probeLocalBranchSection(deps, entry) {
                 {
                     name: "Local branch exists",
                     status: "ok",
-                    detail: `${entry.branchName}, ${probe.ahead} ahead / ${probe.behind} behind origin/${defaultBranchName}`,
+                    detail: `${entry.branchName}, ${probe.ahead} ahead / ${probe.behind} behind ${deps.config.git.remote}/${defaultBranchName}`,
                 },
             ],
             skipReason: "",
@@ -572,24 +586,26 @@ async function probeRemoteBranchSection(deps, entry) {
         return { checks: [], skipReason: "repo dir unresolved", probe: { kind: "absent" } };
     }
     const repoDir = repoDirFromEntry(entry, deps);
+    const checkName = `Branch present on ${deps.config.git.remote}`;
     const probe = await deps.probeRemoteBranch({
         repoDir,
         branch: entry.branchName,
+        remote: deps.config.git.remote,
         doFetch: deps.doFetch,
     });
     if (probe.kind === "present") {
-        return { checks: [{ name: "Branch present on origin", status: "ok" }], skipReason: "", probe };
+        return { checks: [{ name: checkName, status: "ok" }], skipReason: "", probe };
     }
     if (probe.kind === "absent") {
         return {
-            checks: [{ name: "Branch present on origin", status: "fail", detail: "not pushed" }],
+            checks: [{ name: checkName, status: "fail", detail: "not pushed" }],
             skipReason: "",
             probe,
         };
     }
     // probe.kind === "unknown"
     return {
-        checks: [{ name: "Branch present on origin", status: "skipped", detail: probe.reason }],
+        checks: [{ name: checkName, status: "skipped", detail: probe.reason }],
         skipReason: "",
         probe,
     };
@@ -642,6 +658,12 @@ async function runPreDispatch(input) {
     const eligibility = [];
     const { resolvedModel, checks: modelChecks } = buildModelChecks(raw, config);
     resolutionExtra.push(...modelChecks);
+    // Children check comes before repo checks: a parent ticket is a
+    // structural property of the issue itself (filtered out by `fetchBoard`,
+    // so the dispatcher will never act on it). Reporting that first beats
+    // surfacing "your repo isn't cloned" for a ticket groundcrew won't pick
+    // up either way.
+    resolutionExtra.push(buildChildrenCheck(raw));
     const { resolvedRepository, checks: repoChecks } = buildRepoChecks(raw, config, ticket);
     resolutionExtra.push(...repoChecks);
     if (input.statusCheckFailed) {
@@ -969,6 +991,11 @@ export async function runTicketDoctor(parsed) {
         probeWorkspaces: async () => await workspaces.probe(config),
         workspaceAccessHint: async (name) => await workspaces.accessHint(config, name),
         probeWorkingTree: async ({ worktreeDir }) => await worktrees.probeWorkingTree({ worktreeDir }),
+        resolveDefaultBranch: async ({ repoDir }) => await resolveDefaultBranch({
+            repoDir,
+            remote: config.git.remote,
+            fallback: config.git.defaultBranch,
+        }),
         probeLocalBranch: probeLocalBranchImpl,
         probeRemoteBranch: probeRemoteBranchImpl,
         probePullRequest: probePullRequestImpl,
@@ -1028,7 +1055,7 @@ async function probeLocalBranchImpl(input) {
             "rev-list",
             "--left-right",
             "--count",
-            `${input.branch}...origin/${input.defaultBranch}`,
+            `${input.branch}...${input.remote}/${input.defaultBranch}`,
         ]);
         const [aheadString, behindString] = output.trim().split(/\s+/);
         const ahead = Number.parseInt(aheadString ?? "0", 10);
@@ -1050,7 +1077,7 @@ async function probeRemoteBranchImpl(input) {
                 input.repoDir,
                 "fetch",
                 "--quiet",
-                "origin",
+                input.remote,
                 input.branch,
             ]);
         }
@@ -1064,7 +1091,7 @@ async function probeRemoteBranchImpl(input) {
             input.repoDir,
             "ls-remote",
             "--exit-code",
-            "origin",
+            input.remote,
             `refs/heads/${input.branch}`,
         ]);
         return { kind: "present" };

package/dist/index.d.ts

@@ -5,11 +5,16 @@ export { interruptWorkspace, type InterruptWorkspaceOptions, } from "./commands/
 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, ProjectConfig, ResolvedConfig, ResolvedProjectConfig, } from "./lib/config.ts";
+export type { Config, ModelDefinition, ProjectConfig, ResolvedConfig, ResolvedProjectConfig, SourceConfig, } 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 Board, createBoard } from "./lib/board.ts";
+export { buildSources, buildSourcesWith } from "./lib/buildSources.ts";
+export type { AdapterContext, AdapterDefinition } from "./lib/adapterDefinition.ts";
+export { adapterRegistry, type AdapterLoader, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.ts";
+export { AmbiguousTicketError, type Blocker as CanonicalBlocker, type BoardState as CanonicalBoardState, type CanonicalStatus, type GroundcrewIssue as CanonicalGroundcrewIssue, type Issue as CanonicalIssue, isGroundcrewIssue as isCanonicalGroundcrewIssue, type TicketSource, } from "./lib/ticketSource.ts";
 export type { TicketCheck } from "./commands/ticketCheck.ts";
 export { ticketDoctor, type TicketDoctorDependencies, type TicketDoctorResult, type TicketDoctorVerdict, } from "./commands/ticketDoctor.ts";
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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,EACrB,YAAY,GACb,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,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAE/B,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

@@ -9,4 +9,8 @@ export { findProjectBySlugId, loadConfig, unionTerminalStatuses } from "./lib/co
 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 { createBoard } from "./lib/board.js";
+export { buildSources, buildSourcesWith } from "./lib/buildSources.js";
+export { adapterRegistry, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.js";
+export { AmbiguousTicketError, isGroundcrewIssue as isCanonicalGroundcrewIssue, } from "./lib/ticketSource.js";
 export { ticketDoctor, } from "./commands/ticketDoctor.js";

package/dist/lib/adapterDefinition.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared `AdapterDefinition` shape that every built-in adapter
+ * (`src/lib/adapters/<kind>/index.ts`) default-exports. The runtime registry
+ * (`./adapters/registry.ts`) discovers adapters by enumerating that
+ * directory and reading each module's default export.
+ */
+import type { z } from "zod";
+import type { ResolvedConfig } from "./config.ts";
+import type { TicketSource } from "./ticketSource.ts";
+/**
+ * Cross-cutting context every adapter receives at construction time. Holds
+ * the global resolved config so adapters can read shared concerns (the
+ * `workspace.knownRepositories` list, `models.*` definitions, etc.) without
+ * each one duplicating them in its per-source config block.
+ */
+export interface AdapterContext {
+    readonly globalConfig: ResolvedConfig;
+}
+export interface AdapterDefinition<TSchema extends z.ZodType = z.ZodType> {
+    /** Discriminator value used in `SourceConfig.kind`. Must equal the directory name. */
+    readonly kind: string;
+    /** Zod schema for this adapter's config block. The `kind` field must be `z.literal(kind)`. */
+    readonly configSchema: TSchema;
+    /** Builds a TicketSource from a validated config and the shared adapter context. */
+    readonly create: (config: z.infer<TSchema>, context: AdapterContext) => TicketSource;
+}
+//# sourceMappingURL=adapterDefinition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapterDefinition.d.ts","sourceRoot":"","sources":["../../src/lib/adapterDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACtE,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,YAAY,CAAC;CACtF"}

package/dist/lib/adapterDefinition.js

@@ -0,0 +1,7 @@
+/**
+ * Shared `AdapterDefinition` shape that every built-in adapter
+ * (`src/lib/adapters/<kind>/index.ts`) default-exports. The runtime registry
+ * (`./adapters/registry.ts`) discovers adapters by enumerating that
+ * directory and reading each module's default export.
+ */
+export {};

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

@@ -0,0 +1,27 @@
+/**
+ * Linear `TicketSource` factory. Wraps the existing boardSource.ts machinery
+ * (createBoardSource, fetchResolvedIssue, createLinearIssueStatusUpdater) and
+ * converts the legacy Linear-specific `Issue`/`Blocker` shapes into the
+ * canonical `Issue`/`Blocker` shapes consumers (via `Board`) speak.
+ *
+ * Per-project canonical-status mapping lives here: each `Issue` is mapped
+ * against its own project's `statuses` block (the multi-project semantics
+ * shipped in PR #75). Off-config blockers fall back to the union of all
+ * configured projects' status sets — preserving today's
+ * `isTerminalStatusForBlocker` behavior.
+ *
+ * Description is not populated on `fetch()` Issues (boardSource's snapshot
+ * doesn't include it); `resolveOne()` Issues carry the full description
+ * because `fetchResolvedIssue` fetches it explicitly. Phase 6 can lift
+ * description onto the board snapshot when it refactors setupWorkspace.
+ */
+import type { AdapterContext } from "../../adapterDefinition.ts";
+import { type Blocker as LinearBlocker, type Issue as LinearIssue } from "../../boardSource.ts";
+import { type ResolvedProjectConfig } from "../../config.ts";
+import type { CanonicalStatus, Issue as CanonicalIssue, TicketSource } from "../../ticketSource.ts";
+import type { LinearAdapterConfig } from "./schema.ts";
+export declare function canonicalStatusForProject(nativeStatus: string, project: ResolvedProjectConfig): CanonicalStatus;
+export declare function canonicalBlockerStatus(blocker: LinearBlocker, globalConfig: AdapterContext["globalConfig"]): CanonicalStatus;
+export declare function toCanonicalIssue(linearIssue: LinearIssue, globalConfig: AdapterContext["globalConfig"], sourceName: string): CanonicalIssue;
+export declare function createLinearTicketSource(config: LinearAdapterConfig, context: AdapterContext): TicketSource;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,KAAK,OAAO,IAAI,aAAa,EAG7B,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,KAAK,EAEV,eAAe,EACf,KAAK,IAAI,cAAc,EACvB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUvD,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CAcjB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,GAC3C,eAAe,CAoBjB;AAcD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,EAC5C,UAAU,EAAE,MAAM,GACjB,cAAc,CA8BhB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,YAAY,CAwEd"}

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

@@ -0,0 +1,161 @@
+/**
+ * Linear `TicketSource` factory. Wraps the existing boardSource.ts machinery
+ * (createBoardSource, fetchResolvedIssue, createLinearIssueStatusUpdater) and
+ * converts the legacy Linear-specific `Issue`/`Blocker` shapes into the
+ * canonical `Issue`/`Blocker` shapes consumers (via `Board`) speak.
+ *
+ * Per-project canonical-status mapping lives here: each `Issue` is mapped
+ * against its own project's `statuses` block (the multi-project semantics
+ * shipped in PR #75). Off-config blockers fall back to the union of all
+ * configured projects' status sets — preserving today's
+ * `isTerminalStatusForBlocker` behavior.
+ *
+ * Description is not populated on `fetch()` Issues (boardSource's snapshot
+ * doesn't include it); `resolveOne()` Issues carry the full description
+ * because `fetchResolvedIssue` fetches it explicitly. Phase 6 can lift
+ * description onto the board snapshot when it refactors setupWorkspace.
+ */
+import { createBoardSource, fetchResolvedIssue, isTerminalStatusForBlocker, } from "../../boardSource.js";
+import { findProjectBySlugId } from "../../config.js";
+import { createLinearIssueStatusUpdater } from "../../linearIssueStatus.js";
+import { getLinearClient } from "../../util.js";
+export function canonicalStatusForProject(nativeStatus, project) {
+    if (project.statuses.todo === nativeStatus) {
+        return "todo";
+    }
+    if (project.statuses.inProgress === nativeStatus) {
+        return "in-progress";
+    }
+    if (project.statuses.done === nativeStatus) {
+        return "done";
+    }
+    if (project.statuses.terminal.includes(nativeStatus)) {
+        return "done";
+    }
+    return "other";
+}
+export function canonicalBlockerStatus(blocker, globalConfig) {
+    if (blocker.status === undefined) {
+        return "other";
+    }
+    // Terminal first — handles off-config blockers via the union fallback that
+    // isTerminalStatusForBlocker already implements.
+    if (isTerminalStatusForBlocker(blocker, globalConfig)) {
+        return "done";
+    }
+    // Non-terminal: if the blocker's project is configured, use its statuses to
+    // distinguish todo vs in-progress. For off-config blockers we collapse to
+    // "other" — eligibility only cares whether the blocker is terminal, so the
+    // distinction is informational at most.
+    if (blocker.projectSlugId !== undefined) {
+        const project = findProjectBySlugId(globalConfig, blocker.projectSlugId);
+        if (project !== undefined) {
+            return canonicalStatusForProject(blocker.status, project);
+        }
+    }
+    return "other";
+}
+function toCanonicalBlocker(blocker, globalConfig, sourceName) {
+    return {
+        id: `${sourceName}:${blocker.id}`,
+        title: blocker.title,
+        status: canonicalBlockerStatus(blocker, globalConfig),
+    };
+}
+export function toCanonicalIssue(linearIssue, globalConfig, sourceName) {
+    const project = findProjectBySlugId(globalConfig, linearIssue.projectSlugId);
+    /* v8 ignore next 5 @preserve -- fetchBoard's slugId filter and issueStatusBelongsToOwnProject guarantee project is configured by the time we get here */
+    if (project === undefined) {
+        throw new Error(`Linear adapter: issue ${linearIssue.id} carries unknown projectSlugId "${linearIssue.projectSlugId}"`);
+    }
+    const sourceRef = {
+        uuid: linearIssue.uuid,
+        statusId: linearIssue.statusId,
+        teamId: linearIssue.teamId,
+        projectSlugId: linearIssue.projectSlugId,
+        nativeStatus: linearIssue.status,
+    };
+    return {
+        id: `${sourceName}:${linearIssue.id}`,
+        source: sourceName,
+        title: linearIssue.title,
+        // Board snapshot doesn't carry description; resolveOne() populates it.
+        description: "",
+        status: canonicalStatusForProject(linearIssue.status, project),
+        repository: linearIssue.repository,
+        model: linearIssue.model,
+        assignee: linearIssue.assignee,
+        updatedAt: linearIssue.updatedAt,
+        blockers: linearIssue.blockers.map((b) => toCanonicalBlocker(b, globalConfig, sourceName)),
+        hasMoreBlockers: linearIssue.hasMoreBlockers,
+        sourceRef,
+    };
+}
+export function createLinearTicketSource(config, context) {
+    const sourceName = config.name ?? "linear";
+    const { globalConfig } = context;
+    const client = getLinearClient();
+    const boardSource = createBoardSource({ config: globalConfig, client });
+    const issueStatusUpdater = createLinearIssueStatusUpdater({ config: globalConfig, client });
+    return {
+        name: sourceName,
+        async verify() {
+            await boardSource.verify();
+        },
+        async fetch() {
+            const state = await boardSource.fetch();
+            return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, globalConfig, sourceName));
+        },
+        async resolveOne(naturalId) {
+            // fetchResolvedIssue throws on unknown project / missing repo; we let
+            // those propagate. Returning `undefined` is reserved for "ticket genuinely
+            // doesn't exist," which fetchResolvedIssue surfaces as an Error too —
+            // for now we let any error bubble up rather than swallow.
+            const resolved = await fetchResolvedIssue({
+                client,
+                config: globalConfig,
+                ticket: naturalId,
+            });
+            const project = findProjectBySlugId(globalConfig, resolved.projectSlugId);
+            /* v8 ignore next 5 @preserve -- fetchResolvedIssue already throws UnknownProjectError before reaching this guard */
+            if (project === undefined) {
+                throw new Error(`Linear adapter: resolved issue ${naturalId} carries unknown projectSlugId "${resolved.projectSlugId}"`);
+            }
+            // fetchResolvedIssue doesn't return the native status name (it's
+            // already been resolved through workflow state lookup). We surface
+            // "other" until the consumer needs the canonical status, which is fine
+            // because `crew setup` doesn't branch on it.
+            const sourceRef = {
+                uuid: resolved.uuid,
+                statusId: "",
+                teamId: resolved.teamId,
+                projectSlugId: resolved.projectSlugId,
+                nativeStatus: "",
+            };
+            return {
+                id: `${sourceName}:${naturalId.toLowerCase()}`,
+                source: sourceName,
+                title: resolved.title,
+                description: resolved.description,
+                status: "other",
+                repository: resolved.repository,
+                model: resolved.model,
+                assignee: "Unassigned",
+                updatedAt: new Date().toISOString(),
+                blockers: [],
+                hasMoreBlockers: false,
+                sourceRef,
+            };
+        },
+        async markInProgress(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;
+            await issueStatusUpdater.markInProgress({
+                id: issue.id,
+                uuid: ref.uuid,
+                teamId: ref.teamId,
+                projectSlugId: ref.projectSlugId,
+            });
+        },
+    };
+}

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

@@ -0,0 +1,5 @@
+import type { AdapterDefinition } from "../../adapterDefinition.ts";
+import { linearAdapterConfigSchema } from "./schema.ts";
+declare const definition: AdapterDefinition<typeof linearAdapterConfigSchema>;
+export default definition;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,yBAAyB,CAInE,CAAC;eAEa,UAAU"}

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

@@ -0,0 +1,8 @@
+import { createLinearTicketSource } from "./factory.js";
+import { linearAdapterConfigSchema } from "./schema.js";
+const definition = {
+    kind: "linear",
+    configSchema: linearAdapterConfigSchema,
+    create: createLinearTicketSource,
+};
+export default definition;