@clipboard-health/groundcrew 4.1.0 → 4.2.1

package/README.md

@@ -63,7 +63,9 @@ npm install -g @clipboard-health/groundcrew
 crew init && $EDITOR crew.config.ts
 
 # 4. Clone the repos referenced in your config
-crew setup repos
+PROJECT_DIR="$HOME/dev/c"
+mkdir -p "$PROJECT_DIR/OWNER"
+git clone git@github.com:OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
 
 # 5. Export your Linear API key
 export GROUNDCREW_LINEAR_API_KEY="lin_api_..."
@@ -86,14 +88,35 @@ crew status [<TICKET>]                                   # inspect current state
 crew run                                                 # one-shot orchestration
 crew run --watch                                         # poll forever
 crew start <TICKET>                                      # provision + launch one ticket now
-crew setup repos [<repo>...] [--dry-run]                 # clone known repos via gh
 crew stop <TICKET> [--reason <text>]                     # stop workspace, keep worktree
 crew resume <TICKET>                                     # reopen a paused ticket
 crew cleanup <TICKET>                                    # tear down every worktree for a ticket
+crew upgrade [<version>]                                 # reinstall crew globally through npm
 ```
 
 Deprecated aliases still work but print a warning and will be removed in the next major version: `crew interrupt` → `crew stop`, `crew run --ticket <TICKET>` → `crew start <TICKET>`, `crew doctor --ticket <TICKET>` → `crew status <TICKET>`.
 
+## Manual Repository Bootstrap
+
+Groundcrew no longer clones repositories for you. For each `workspace.knownRepositories` entry,
+clone the repository into `workspace.projectDir` using the same relative path that appears in the
+config. For an `OWNER/REPO` entry:
+
+```bash
+PROJECT_DIR="$HOME/dev/c"
+mkdir -p "$PROJECT_DIR/OWNER"
+git clone git@github.com:OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
+```
+
+HTTPS works the same way if you do not use SSH:
+
+```bash
+git clone https://github.com/OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
+```
+
+Bare-name entries do not include an owner, so choose the correct remote URL yourself and clone it to
+`$PROJECT_DIR/<name>`. `crew setup repos` now exits non-zero and points back to this section.
+
 ## Configuration
 
 Two keys are required; everything else has a default.
@@ -508,13 +531,6 @@ The handoff is `<your cmd> "<prompt>"`. `claude`, `codex`, and `cursor-agent` al
 
 </details>
 
-<details>
-<summary><code>crew setup repos</code> only auto-clones <code>owner/repo</code> entries</summary>
-
-Bare-name entries in `workspace.knownRepositories` (e.g. `"api"` rather than `"clipboardhealth/api"`) are skipped with a hint to clone manually — the command refuses to guess the owner. After a partial setup, the exit code is non-zero so CI gates notice; rerun is idempotent once you clone the bare ones into `<projectDir>/<name>` yourself.
-
-</details>
-
 ## Development
 
 Clone the repo and the `crew` / `crew:op` scripts execute straight from TypeScript source — no build step needed.

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuQA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmPA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCvD"}

package/dist/cli.js

@@ -5,20 +5,21 @@ import { initConfigCli } from "./commands/init.js";
 import { interruptWorkspaceCli } from "./commands/interruptWorkspace.js";
 import { orchestrate } from "./commands/orchestrator.js";
 import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
-import { setupReposCli } from "./commands/setupRepos.js";
 import { setupWorkspaceCli } from "./commands/setupWorkspace.js";
 import { statusCli } from "./commands/status.js";
 import { createDefaultUpgradeCliOptions, upgradeCli } from "./commands/upgrade.js";
-import { computeUpgradeNudge, defaultUpgradeCheckCachePath, fetchLatestVersion, } from "./lib/upgrade.js";
-import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTicketArgument, writeError, writeOutput, } from "./lib/util.js";
-const NUDGE_TTL_MS = 6 * 60 * 60 * 1000;
-const NUDGE_FETCH_TIMEOUT_MS = 1000;
+import { errorMessage, parseDryRunPositionals, readTicketArgument, writeError, writeOutput, } from "./lib/util.js";
 const REMOVED_SANDBOX_COMMAND_MESSAGE = [
     "`crew sandbox` is no longer supported.",
     "Groundcrew now launches agents inside existing sbx sandboxes but does not list, create, regenerate, authenticate, or remove them.",
     "Use the manual `sbx` workflow in README.md#docker-sandboxes-sdx-setup, then keep `models.definitions.<model>.sandbox.agent` in crew.config.ts so launches can address the existing sandbox.",
 ].join("\n");
 const requireFromCli = createRequire(import.meta.url);
+const SETUP_REPOS_REMOVED_MESSAGE = [
+    "crew setup repos was removed.",
+    "Clone repositories manually with git clone into workspace.projectDir.",
+    "See README.md#manual-repository-bootstrap for the replacement workflow.",
+].join(" ");
 /**
  * Prints a deprecation warning to stderr naming the canonical command and that
  * the old form is removed in the next major, then lets the caller proceed.
@@ -27,13 +28,12 @@ function warnDeprecated(forms) {
     writeError(`crew ${forms.oldForm} is deprecated and will be removed in the next major version; use crew ${forms.newForm} instead.`);
 }
 function setupUsage() {
-    return "Usage: crew setup repos [--dry-run] [<repo>...]";
+    return `Usage: crew setup repos\n\n${SETUP_REPOS_REMOVED_MESSAGE}`;
 }
 async function setupCli(argv) {
-    const [verb, ...rest] = argv;
+    const [verb] = argv;
     if (verb === "repos") {
-        await setupReposCli(rest);
-        return;
+        throw new Error(SETUP_REPOS_REMOVED_MESSAGE);
     }
     throw new Error(setupUsage());
 }
@@ -80,27 +80,10 @@ async function startCli(argv) {
 async function upgradeCliInvoke(argv) {
     const metadata = packageMetadata();
     await upgradeCli(argv, async () => await createDefaultUpgradeCliOptions({
-        currentVersion: metadata.version,
         packageName: metadata.name,
         cliMetaUrl: import.meta.url,
     }));
 }
-async function maybeRunUpgradeNudge(metadata) {
-    const message = await computeUpgradeNudge({
-        currentVersion: metadata.version,
-        packageName: metadata.name,
-        cachePath: defaultUpgradeCheckCachePath(),
-        ttlMs: NUDGE_TTL_MS,
-        fetchTimeoutMs: NUDGE_FETCH_TIMEOUT_MS,
-        registry: readEnvironmentVariable("npm_config_registry"),
-        noUpgradeCheck: readEnvironmentVariable("GROUNDCREW_NO_UPGRADE_CHECK") === "1",
-        now: Date.now,
-        fetcher: fetchLatestVersion,
-    });
-    if (message !== undefined) {
-        writeError(message);
-    }
-}
 function doctorTicketAlias(argv) {
     if (argv[0] !== "--ticket") {
         return undefined;
@@ -175,28 +158,27 @@ const SUBCOMMANDS = {
         invoke: resumeWorkspaceCli,
     },
     setup: {
-        summary: "Project-level setup commands (currently: repos)",
-        usage: "repos [--dry-run] [<repo>...]",
+        summary: "Removed repository bootstrap command",
+        usage: "repos",
+        hidden: true,
         invoke: setupCli,
     },
     upgrade: {
         summary: "Install the latest version of crew (or pin to a specific version)",
-        usage: "[<version>] [--check]",
+        usage: "[<version>]",
         invoke: upgradeCliInvoke,
     },
 };
 function printHelp() {
-    const width = Math.max(...Object.keys(SUBCOMMANDS).map((key) => key.length));
+    const visibleCommands = Object.entries(SUBCOMMANDS).filter(([, command]) => command.hidden !== true && command.deprecated !== true);
+    const width = Math.max(...visibleCommands.map(([key]) => key.length));
     writeOutput("Usage: crew <command> [...args]\n");
     writeOutput("Options:");
     writeOutput("  -h, --help     Show help");
     writeOutput("  -v, --version  Print version");
     writeOutput("");
     writeOutput("Commands:");
-    for (const [name, command] of Object.entries(SUBCOMMANDS)) {
-        if (command.deprecated === true) {
-            continue;
-        }
+    for (const [name, command] of visibleCommands) {
         writeOutput(`  ${name.padEnd(width)}  ${command.summary}`);
         writeOutput(`  ${" ".repeat(width)}  → crew ${name} ${command.usage}`);
     }
@@ -235,14 +217,6 @@ export async function run(argv) {
         process.exitCode = 1;
         return;
     }
-    if (subcommand !== "upgrade") {
-        try {
-            await maybeRunUpgradeNudge(packageMetadata());
-        }
-        catch {
-            // Passive nudge is never load-bearing; never block the user's command.
-        }
-    }
     try {
         await command.invoke(rest);
     }

package/dist/commands/cleaner.d.ts

@@ -3,8 +3,8 @@
  * tickets that have reached a terminal status. One per `orchestrate()`
  * invocation; stateless across iterations. Mirrors `Dispatcher`.
  */
-import { type BoardState } from "../lib/boardSource.ts";
 import type { ResolvedConfig } from "../lib/config.ts";
+import { type BoardState } from "../lib/ticketSource.ts";
 import { type WorktreeEntry } from "../lib/worktrees.ts";
 interface CleanerDeps {
     config: ResolvedConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"cleaner.d.ts","sourceRoot":"","sources":["../../src/commands/cleaner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,UAAU,EAA4B,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,qBAAqB,CAAC;AAGpE,UAAU,WAAW;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAkDxD"}
+{"version":3,"file":"cleaner.d.ts","sourceRoot":"","sources":["../../src/commands/cleaner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,qBAAqB,CAAC;AAGpE,UAAU,WAAW;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAoDxD"}

package/dist/commands/cleaner.js

@@ -3,8 +3,8 @@
  * tickets that have reached a terminal status. One per `orchestrate()`
  * invocation; stateless across iterations. Mirrors `Dispatcher`.
  */
-import { isTerminalStatusForIssue } from "../lib/boardSource.js";
 import { recordCleanedUpRuns } from "../lib/runStateCleanup.js";
+import { naturalIdFromCanonical } from "../lib/ticketSource.js";
 import { log, logEvent } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { logTeardown, recordTeardownEvents } from "./teardownReporter.js";
@@ -12,7 +12,9 @@ export function createCleaner(deps) {
     const { config } = deps;
     async function runOnce(arguments_) {
         const { state, worktreeEntries, dryRun, signal } = arguments_;
-        const terminalTickets = new Set(state.issues.filter((issue) => isTerminalStatusForIssue(issue)).map((issue) => issue.id));
+        const terminalTickets = new Set(state.issues
+            .filter((issue) => issue.status === "done")
+            .map((issue) => naturalIdFromCanonical(issue.id)));
         if (terminalTickets.size === 0) {
             return;
         }

package/dist/commands/dispatcher.d.ts

@@ -1,19 +1,19 @@
 /**
  * Per-iteration decider that picks Todo tickets to start and acts on the
- * picks. One per `orchestrate()` invocation; reuses its team-state cache
- * across iterations within an invocation.
+ * picks. Stateless across iterations. The Board adapter owns its own writeback
+ * caches (e.g., Linear's team-state cache lives in `src/lib/adapters/linear/writeback.ts`).
  *
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
- * for telemetry, Linear writes, and side-effecting setupWorkspace calls.
+ * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
-import type { LinearClient } from "@linear/sdk";
-import { type BoardState } from "../lib/boardSource.ts";
+import type { Board } from "../lib/board.ts";
 import type { ResolvedConfig } from "../lib/config.ts";
+import { type BoardState } from "../lib/ticketSource.ts";
 import type { UsageByModel } from "../lib/usage.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";
 interface DispatcherDeps {
     config: ResolvedConfig;
-    client: LinearClient;
+    board: Board;
 }
 export interface Dispatcher {
     runOnce(arguments_: {

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,EAKhB,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;AAaD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAyLjE"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/commands/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,wBAAwB,CAAC;AAChC,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,KAAK,EAAE,KAAK,CAAC;CACd;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;AAaD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CA8MjE"}

package/dist/commands/dispatcher.js

@@ -1,13 +1,13 @@
 /**
  * Per-iteration decider that picks Todo tickets to start and acts on the
- * picks. One per `orchestrate()` invocation; reuses its team-state cache
- * across iterations within an invocation.
+ * picks. Stateless across iterations. The Board adapter owns its own writeback
+ * caches (e.g., Linear's team-state cache lives in `src/lib/adapters/linear/writeback.ts`).
  *
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
- * for telemetry, Linear writes, and side-effecting setupWorkspace calls.
+ * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
-import { isGroundcrewIssue, isIssueInProgress, isIssueTodo, } from "../lib/boardSource.js";
-import { createLinearIssueStatusUpdater } from "../lib/linearIssueStatus.js";
+import { dispatchableRepository } from "../lib/repositoryValidation.js";
+import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/ticketSource.js";
 import { errorMessage, log, logEvent } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { classifyBlockers, classifyEligibility, classifyUsageExhaustion, } from "./eligibility.js";
@@ -17,14 +17,13 @@ function logSkip(verdict) {
     logEvent("dispatch", {
         outcome: "skipped",
         reason: verdict.eventReason,
-        ticket: verdict.issue.id,
+        ticket: naturalIdFromCanonical(verdict.issue.id),
         blockers: verdict.blockers,
         model: verdict.model,
     });
 }
 export function createDispatcher(deps) {
-    const { config, client } = deps;
-    const issueStatusUpdater = createLinearIssueStatusUpdater({ client });
+    const { config, board } = deps;
     function buildExhaustedSet(usage) {
         const exhausted = new Set();
         for (const exhaustion of classifyUsageExhaustion(config, usage)) {
@@ -35,17 +34,18 @@ export function createDispatcher(deps) {
     }
     async function startEligibleIssue(start, dryRun, signal) {
         const { issue, recovery } = start;
+        const ticketId = naturalIdFromCanonical(issue.id);
         if (start.resolvedFromAny) {
-            log(`Resolved agent-any for ${issue.id} → ${issue.model}`);
+            log(`Resolved agent-any for ${ticketId} → ${issue.model}`);
         }
         if (dryRun) {
             log(
             /* v8 ignore next @preserve -- classifyTodo forces recovery=false in dry-run, so the resume branch can't fire here */
-            `[dry-run] Would ${recovery ? "resume" : "start"} ${issue.id} in ${issue.repository} (${issue.model})`);
+            `[dry-run] Would ${recovery ? "resume" : "start"} ${ticketId} in ${issue.repository} (${issue.model})`);
             logEvent("dispatch", {
                 outcome: "skipped",
                 reason: "dry_run",
-                ticket: issue.id,
+                ticket: ticketId,
                 model: issue.model,
                 repository: issue.repository,
             });
@@ -53,31 +53,32 @@ export function createDispatcher(deps) {
         }
         try {
             if (recovery) {
-                log(`Worktree and workspace already exist for ${issue.id}; resuming with markInProgress`);
+                log(`Worktree and workspace already exist for ${ticketId}; resuming with markInProgress`);
             }
             else {
                 const setupOptions = {
                     repository: issue.repository,
-                    ticket: issue.id,
+                    ticket: ticketId,
                     model: issue.model,
+                    details: { title: issue.title, description: issue.description },
                 };
                 await (signal === undefined
                     ? setupWorkspace(config, setupOptions)
                     : setupWorkspace(config, setupOptions, { signal }));
             }
-            await issueStatusUpdater.markInProgress(issue);
+            await board.markInProgress(issue);
             logEvent("dispatch", {
                 outcome: recovery ? "resumed" : "started",
-                ticket: issue.id,
+                ticket: ticketId,
                 model: issue.model,
                 repository: issue.repository,
             });
         }
         catch (error) {
-            log(`Failed to start ${issue.id}: ${errorMessage(error)}`);
+            log(`Failed to start ${ticketId}: ${errorMessage(error)}`);
             logEvent("dispatch", {
                 outcome: "failed",
-                ticket: issue.id,
+                ticket: ticketId,
                 model: issue.model,
                 repository: issue.repository,
                 error: errorMessage(error),
@@ -86,24 +87,24 @@ 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
+        // Surface parent tickets that fetch 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`);
+            const ticket = naturalIdFromCanonical(skip.id);
+            log(`Skipping ${ticket}: 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,
+                ticket,
                 children: skip.childCount,
             });
         }
-        const activeCount = state.issues.filter((issue) => isIssueInProgress(issue)).length;
+        const activeCount = state.issues.filter((issue) => issue.status === "in-progress").length;
         const slots = config.orchestrator.maximumInProgress - activeCount;
         // Narrow Todo to tickets that opted in via an `agent-*` label.
         // Unlabeled tickets are not groundcrew's concern even when in Todo.
-        const todo = state.issues.filter((issue) => isIssueTodo(issue) && isGroundcrewIssue(issue));
+        const todo = state.issues.filter((issue) => issue.status === "todo" && isGroundcrewIssue(issue));
         if (slots <= 0) {
             log(`At capacity (${activeCount}/${config.orchestrator.maximumInProgress}), no new work to start${idleSuffix}`);
             return;
@@ -122,6 +123,20 @@ export function createDispatcher(deps) {
             log(`No eligible Todo tickets after blocker filtering${idleSuffix}`);
             return;
         }
+        // Validate repositories BEFORE the expensive probes so a tick whose only
+        // candidates have unknown repos short-circuits without paying for the
+        // usage() HTTP call or the workspaces.probe shell-out. Doing this filter
+        // here also keeps an unknown-repo ticket at the head of the queue from
+        // consuming a slot in classifyEligibility and starving later valid
+        // tickets. Each unknown repo still emits a WARN via dispatchableRepository.
+        const dispatchableUnblocked = unblocked.filter((issue) => {
+            const repository = dispatchableRepository(issue, config.workspace.knownRepositories, log);
+            return repository !== undefined;
+        });
+        if (dispatchableUnblocked.length === 0) {
+            log(`No eligible Todo tickets after repository validation${idleSuffix}`);
+            return;
+        }
         // usage() is an HTTP call; workspaces.probe shells tmux/cmux. Kick off
         // usage first so the workspace probe can overlap with the in-flight request.
         const usagePromise = usage(signal);
@@ -144,7 +159,7 @@ export function createDispatcher(deps) {
         const exhausted = buildExhaustedSet(fetchedUsage);
         const verdicts = classifyEligibility({
             config,
-            unblocked,
+            unblocked: dispatchableUnblocked,
             worktreeEntries,
             workspaceProbe,
             usage: fetchedUsage,
@@ -161,12 +176,13 @@ export function createDispatcher(deps) {
             log(`No eligible Todo tickets after eligibility filtering${idleSuffix}`);
             return;
         }
-        log(`${slots} slot(s) available, starting ${starts.length} ticket(s): ${starts.map(({ issue }) => `${issue.id}(${issue.model})`).join(", ")}`);
+        const dispatchable = starts;
+        log(`${slots} slot(s) available, starting ${dispatchable.length} ticket(s): ${dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}(${issue.model})`).join(", ")}`);
         logEvent("dispatch", {
             outcome: "starting",
-            tickets: starts.map(({ issue }) => `${issue.id}:${issue.model}`),
+            tickets: dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}:${issue.model}`),
         });
-        for (const start of starts) {
+        for (const start of dispatchable) {
             // oxlint-disable-next-line no-await-in-loop -- one workspace at a time avoids racing on git
             await startEligibleIssue(start, dryRun, signal);
         }

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoJH,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CA8E/C"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgJH,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CA8E/C"}

package/dist/commands/doctor.js

@@ -3,12 +3,13 @@
  * Returns true if every required check passes; false otherwise.
  */
 import { existsSync, statSync } from "node:fs";
+import { createBoard } from "../lib/board.js";
+import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfig, } from "../lib/config.js";
-import { createBoardSource } from "../lib/boardSource.js";
 import { detectHostCapabilities, which } from "../lib/host.js";
 import { resolveLocalRunner } from "../lib/localRunner.js";
 import { gatedModels } from "../lib/usage.js";
-import { errorMessage, getLinearClient, resolveLinearApiKey, writeOutput } from "../lib/util.js";
+import { errorMessage, writeOutput } from "../lib/util.js";
 import { resolveWorkspaceKind } from "../lib/workspaces.js";
 // Tokenization stops after this many non-flag tokens. Two is enough to
 // catch wrapper + wrapped CLI commands like `safehouse claude --foo`.
@@ -26,32 +27,27 @@ async function checkCmd(cmd, required, hint) {
     }
     return result;
 }
-async function checkLinearReachability(config) {
-    const resolved = resolveLinearApiKey();
-    if (resolved === undefined) {
-        return {
-            name: "linear reachability",
-            ok: false,
-            required: true,
-            hint: "export $GROUNDCREW_LINEAR_API_KEY or $LINEAR_API_KEY",
-        };
-    }
+/**
+ * Source-agnostic reachability check: build every configured ticket source
+ * and run the Board's `verify()` fan-out. Replaces the old Linear-only
+ * "api key + reachability" probe so a misconfigured shell (or future Jira)
+ * source surfaces here too. A missing Linear API key still fails verify with
+ * its own user-facing message, so the prior behavior is preserved.
+ */
+async function checkSourceProbe(config) {
     try {
-        await createBoardSource({ config, client: getLinearClient() }).verify();
+        const sources = await buildSources(sourcesFromConfig(config), { globalConfig: config });
+        const board = createBoard(sources);
+        await board.verify();
         return {
-            name: "linear reachability",
+            name: "source probe",
             ok: true,
             required: true,
-            hint: `set via $${resolved.source}`,
+            hint: `${sources.length} source(s) verified`,
         };
     }
     catch (error) {
-        return {
-            name: "linear reachability",
-            ok: false,
-            required: true,
-            hint: errorMessage(error),
-        };
+        return { name: "source probe", ok: false, required: true, hint: errorMessage(error) };
     }
 }
 function checkDir(path, label) {
@@ -161,7 +157,7 @@ export async function doctor() {
     const workspaceOutcome = resolveWorkspaceOutcome(config, host);
     reportWorkspaceKind(config, workspaceOutcome);
     const checks = [
-        await checkLinearReachability(config),
+        await checkSourceProbe(config),
         await checkCmd("git", true, "https://git-scm.com/"),
         ...(await workspaceChecks(workspaceOutcome)),
         checkDir(config.workspace.projectDir, "workspace.projectDir"),

package/dist/commands/eligibility.d.ts

@@ -6,8 +6,8 @@
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
-import { type GroundcrewIssue } from "../lib/boardSource.ts";
 import { type ResolvedConfig } from "../lib/config.ts";
+import { type GroundcrewIssue } from "../lib/ticketSource.ts";
 import type { UsageByModel } from "../lib/usage.ts";
 import type { WorkspaceProbe } from "../lib/workspaces.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/commands/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,KAAK,UAAU,GACX,SAAS,GACT,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,EAAE,UAAU,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAgCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,GAAG,SAAS,CAepB;AAaD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,GAClB,oBAAoB,EAAE,CAmCxB;AA4CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,EAAE,CAgE5E"}
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/commands/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,KAAK,UAAU,GACX,SAAS,GACT,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,EAAE,UAAU,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAgCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,GAAG,SAAS,CAepB;AAaD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,GAClB,oBAAoB,EAAE,CAmCxB;AA6CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,EAAE,CAgE5E"}

package/dist/commands/eligibility.js

@@ -6,14 +6,14 @@
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
-import { isTerminalStatusForBlocker, } from "../lib/boardSource.js";
 import { AGENT_ANY_MODEL } from "../lib/config.js";
+import { naturalIdFromCanonical } from "../lib/ticketSource.js";
 const PERCENT_FRACTION_DIVISOR = 100;
 const DAYS_PER_WEEK = 7;
 const MINUTES_PER_DAY = 24 * 60;
 const MINUTES_PER_WEEK = DAYS_PER_WEEK * MINUTES_PER_DAY;
 function blockerSummary(blocker) {
-    return `${blocker.id}:${blocker.status ?? "missing"}`;
+    return `${blocker.id}:${blocker.status}`;
 }
 function blockerVerdictFor(issue) {
     if (issue.hasMoreBlockers) {
@@ -26,7 +26,7 @@ function blockerVerdictFor(issue) {
             blockers,
         };
     }
-    const unresolved = issue.blockers.filter((blocker) => !isTerminalStatusForBlocker(blocker));
+    const unresolved = issue.blockers.filter((blocker) => blocker.status !== "done");
     if (unresolved.length === 0) {
         return undefined;
     }
@@ -110,7 +110,8 @@ function classifyRecovery(arguments_) {
     if (dryRun) {
         return { kind: "go", recovery: false };
     }
-    const exists = worktreeEntries.some((entry) => entry.repository === issue.repository && entry.ticket === issue.id);
+    const naturalId = naturalIdFromCanonical(issue.id);
+    const exists = worktreeEntries.some((entry) => entry.repository === issue.repository && entry.ticket === naturalId);
     if (!exists) {
         return { kind: "go", recovery: false };
     }
@@ -122,11 +123,11 @@ function classifyRecovery(arguments_) {
             eventReason: "workspace_list_unavailable",
         };
     }
-    if (!workspaceProbe.names.has(issue.id)) {
+    if (!workspaceProbe.names.has(naturalId)) {
         return {
             kind: "skip",
             issue,
-            message: `Skipping ${issue.id}: worktree exists but no live workspace. Run \`crew cleanup ${issue.id}\` to allow re-provisioning.`,
+            message: `Skipping ${issue.id}: worktree exists but no live workspace. Run \`crew cleanup ${naturalId}\` to allow re-provisioning.`,
             eventReason: "workspace_missing",
         };
     }

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;AAqDH,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"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyDH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E"}