@clipboard-health/groundcrew 4.0.1 → 4.0.3

package/README.md

@@ -17,24 +17,31 @@
 </p>
 
 ```text
-$ crew doctor --ticket HRD-446
-groundcrew doctor --ticket HRD-446 (Add retry logic to the sync job)
-────────────────────────────────────────────────────────────────────
-
-Resolution
-  [ok] Ticket exists in Linear ("Add retry logic to the sync job")
-  [ok] Status is Todo
-  [ok] Has agent-* label (agent-claude)
-  [ok] Model resolves from agent-* label (model "claude")
-  [ok] Description mentions known repo (owner/repo)
-  [ok] Resolved repo is cloned locally (/dev/workspaces/owner/repo)
-
-Eligibility
-  [ok] No active blockers
-  [ok] Model "claude" usage under sessionLimitPercentage (12% (limit 85%))
-  [ok] In-progress cap not hit (2/4 used)
-
-→ would be dispatched on next tick
+$ crew status HRD-446
+groundcrew status HRD-446
+========================
+ticket: hrd-446
+
+Config snapshot
+---------------
+projectDir: /dev/workspaces
+repositories: owner/repo
+git: remote=origin; defaultBranch=main
+workspaceKind: auto
+
+Worktree state
+--------------
+- owner/repo host
+  branch: rocky-hrd-446
+  git: dirty (2 modified, 1 untracked)
+
+Workspace probe
+---------------
+live: yes
+
+Last Linear status
+------------------
+In Progress (state.type=started) — Add retry logic to the sync job
 ```
 
 ## Why
@@ -75,16 +82,18 @@ In Linear, assign tickets to yourself and add an `agent-*` label (`agent-claude`
 ```bash
 crew init [--global | --local] [--force] [--dry-run]     # create a crew.config.ts
 crew doctor                                              # check setup
-crew doctor --ticket <TICKET>                            # diagnose a specific ticket
-crew run                                                 # one-shot dispatch
+crew status [<TICKET>]                                   # inspect current state or one ticket
+crew run                                                 # one-shot orchestration
 crew run --watch                                         # poll forever
-crew run --ticket <TICKET>                               # dispatch one ticket
+crew start <TICKET>                                      # provision + launch one ticket now
 crew setup repos [<repo>...] [--dry-run]                 # clone known repos via gh
-crew interrupt <TICKET> [--reason <text>]                # stop workspace, keep worktree
+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
 ```
 
+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>`.
+
 ## Configuration
 
 Two keys are required; everything else has a default.
@@ -102,7 +111,7 @@ The branch prefix (`<prefix>-<TICKET>`) is derived from `os.userInfo().username`
 - `agent-claude`, `agent-codex`, `agent-<name>` → that model.
 - `agent-any` → the model with the most available session capacity.
 - Unknown `agent-<name>` → falls back to `models.default` with a warning.
-- No `agent-*` label → ignored by `crew run`. Dispatch on demand with `crew run --ticket <TICKET>` (also falls back to `models.default`).
+- No `agent-*` label → ignored by `crew run`. Dispatch on demand with `crew start <TICKET>` (also falls back to `models.default`).
 - Todo tickets blocked by non-terminal blockers are skipped until their blockers reach a terminal status.
 
 Status classification uses Linear's workflow `state.type` (`unstarted`, `started`, `completed`, `canceled`, `duplicate`), so renamed status columns work without configuration. Parent issues with children are ignored — sub-issues are the work items.
@@ -129,7 +138,7 @@ Resolution order: `GROUNDCREW_CONFIG` → cosmiconfig project-walk from cwd (any
 | `orchestrator.maximumInProgress`        | `4`                 | Cap on in-progress tickets at once for this `crew` instance.                                                                                                                                                                                                                                                                                                            |
 | `orchestrator.pollIntervalMilliseconds` | `120_000`           | Poll interval in `--watch` mode.                                                                                                                                                                                                                                                                                                                                        |
 | `orchestrator.sessionLimitPercentage`   | `85`                | Number in `(0, 100]`. A model whose codexbar session window exceeds this percentage is skipped that tick.                                                                                                                                                                                                                                                               |
-| `models.default`                        | `"claude"`          | Tiebreak for `agent-any` resolution and fallback for explicit but unknown `agent-*` labels. Also used by `crew run --ticket <TICKET>` for unlabeled tickets. `crew run` without `--ticket` ignores unlabeled tickets and does not apply this default. Must exist in `models.definitions`.                                                                               |
+| `models.default`                        | `"claude"`          | Tiebreak for `agent-any` resolution and fallback for explicit but unknown `agent-*` labels. Also used by `crew start <TICKET>` for unlabeled tickets. `crew run` ignores unlabeled tickets and does not apply this default. Must exist in `models.definitions`.                                                                                                         |
 | `models.definitions`                    | `{ claude, codex }` | Agent definitions. Additive merge with shipped defaults.                                                                                                                                                                                                                                                                                                                |
 | `models.definitions.<name>.cmd`         | —                   | Shell command launched for the model. Runs in the worktree through the resolved `local.runner`. `{{worktree}}` is replaced before launch; `{{sandbox}}` expands to the sbx sandbox name under the sdx runner and an empty string otherwise.                                                                                                                             |
 | `models.definitions.<name>.color`       | —                   | Color for the workspace status pill (cmux only; tmux silently drops it).                                                                                                                                                                                                                                                                                                |
@@ -185,91 +194,72 @@ Groundcrew auto-creates sandboxes when missing but never deletes them — they p
 
 </details>
 
-## Diagnosing tickets
+## Inspecting status
 
-`crew doctor --ticket <TICKET>` runs the full per-ticket lifecycle: pre-dispatch eligibility (Todo status, `agent-*` label, model resolution, repo mention, local clone, blockers, session usage, capacity) **and** post-dispatch local recovery (run state, host worktree, workspace pane, branches, PR). Prints a single verdict with a copy-pasteable next step.
+`crew status <TICKET>` prints a read-only snapshot for one ticket: resolved config, matching worktrees, workspace probe result, recorded run state, recent log lines for that ticket, and the latest Linear status. It does not fetch, recover, tear down, resume, or mutate any local/remote state.
 
-Verdict precedence: PR outcomes (`pr-open` > `pr-merged`) → recorded failed launches → `interrupted` (concrete recoverable git work first) → `in-flight` → `recoverable` → `unresolvable` > `ineligible` > `would-dispatch` > `lost`. Exits 0 on `would-dispatch`, `pr-open`, or `pr-merged`; any other verdict exits 1. `--watch` and `--ticket` are mutually exclusive. Use `codexbar usage` to inspect session windows directly.
+`crew status` with no ticket prints the current inventory: known worktrees with workspace/run-state presence plus live workspaces reported by the configured backend.
 
-Flags:
+Use `crew cleanup <TICKET>` to tear down stale worktrees and `crew resume <TICKET>` to reopen preserved work. Status is intentionally informational only.
 
-- `--no-linear` — skip the Linear GraphQL call. Resolution and Eligibility sections are skipped; verdicts that need only local state (`in-flight`, `recoverable`, `pr-open`, `pr-merged`, `lost`) still fire.
-- `--no-fetch` — skip the upfront `git fetch origin <branch>` before checking remote presence.
+## Doctor
 
-| Verdict          | What to do                                                                                    |
-| ---------------- | --------------------------------------------------------------------------------------------- |
-| `pr-open`        | Nothing — the PR is the source of truth.                                                      |
-| `pr-merged`      | Done.                                                                                         |
-| `in-flight`      | The ticket is still being worked on; the verdict line names the workspace pane to attach to.  |
-| `recoverable`    | Run the printed `nextStep` exactly.                                                           |
-| `interrupted`    | Resume the preserved worktree with `crew resume <ticket>` or inspect it by hand.              |
-| `failed-launch`  | Fix the launch failure, then run `crew resume <ticket>` or `crew cleanup <ticket>`.           |
-| `would-dispatch` | Pre-dispatch checks pass; the orchestrator will pick the ticket up on its next tick.          |
-| `ineligible`     | A resolution or eligibility check failed; the reason after the colon names the failing check. |
-| `unresolvable`   | The Linear ticket couldn't be fetched; the reason after the colon names the error.            |
-| `lost`           | No trace exists. Re-dispatch via `crew run --ticket <ticket>`.                                |
+`crew doctor` checks host prerequisites only: config validity, Linear reachability, required binaries on PATH, workspace backend availability, workspace.projectDir, local runner capability, and enabled model commands.
 
 <details>
-<summary>Sample output (post-dispatch)</summary>
-
-The Workspace section appends an attach hint to the pane name when the workspace backend exposes one (e.g. `tmux attach -t <session>:<pane>` or `cmux attach <name>`), so the verdict line is immediately actionable.
+<summary>Sample ticket status output</summary>
 
 ```text
-groundcrew doctor --ticket HRD-442 (Multi-event extractor: year inference can produce date_start > date_end)
-────────────────────────────────────────────────────────────────────────────────────────────────────────────
-
-Resolution
-  [ok] Ticket exists in Linear ("Multi-event extractor: year inference can produce date_start > date_end")
-  [ok] Status is Todo
-  (skipped — post-dispatch — pre-dispatch checks are irrelevant)
-
-Eligibility
-  (skipped — post-dispatch — pre-dispatch checks are irrelevant)
+groundcrew status HRD-442
+=========================
+ticket: hrd-442
 
 Run state
-  [ok] Local run state (running)
-  [ok] Recorded model (claude)
-  [ok] Recorded worktree (/Users/paul/dev/groundcrew-workspaces/herds-social/herds-hrd-442)
-  [ok] Recorded branch (paul-hrd-442)
-  [ok] Resume count (0)
+---------
+running; model=claude; updated=2026-05-26T00:01:00.000Z; resumes=0
 
 Worktree
-  [ok] Host worktree exists (/Users/paul/dev/groundcrew-workspaces/herds-social/herds-hrd-442)
-  [--] Working tree clean (0 modified, 1 untracked)
-  [ok] Branch checked out (paul-hrd-442)
+--------
+- herds-social host
+  branch: paul-hrd-442
+  dir: /Users/paul/dev/groundcrew-workspaces/herds-social/herds-hrd-442
+  git: dirty (0 modified, 1 untracked)
 
 Workspace
-  [ok] Workspace pane open (hrd-442 — attach: `tmux attach -t groundcrew:hrd-442`)
+---------
+live: yes
+
+Last Linear status
+------------------
+In Progress (state.type=started) — Multi-event extractor: year inference can produce date_start > date_end
+```
 
-Local branch
-  [ok] Local branch exists (paul-hrd-442, 2 ahead / 0 behind origin/main)
+</details>
 
-Remote branch
-  [ok] Branch present on origin
+### `crew start <TICKET>`
 
-Pull request
-  [ok] Open PR for this branch (#224 https://github.com/herds-social/herds/pull/224)
+Provisions and launches one ticket immediately, bypassing orchestrator eligibility. Use it to dispatch a specific ticket on demand — including unlabeled tickets that `crew run` ignores. (Replaces the deprecated `crew run --ticket <TICKET>`.)
 
-→ pr-open: https://github.com/herds-social/herds/pull/224 (#224)
+```bash
+crew start HRD-442
+crew start HRD-442 --dry-run
 ```
 
-</details>
-
-### `crew interrupt <TICKET>`
+### `crew stop <TICKET>`
 
-Stops a live workspace pane while preserving the ticket worktree and branch. The manual pause button for cases where you need terminal capacity back, want to stop an agent that's going in the wrong direction, or need to inspect the diff before letting another agent continue.
+Stops a live workspace pane while preserving the ticket worktree and branch. The manual pause button for cases where you need terminal capacity back, want to stop an agent that's going in the wrong direction, or need to inspect the diff before letting another agent continue. (Replaces the deprecated `crew interrupt <TICKET>`.)
 
 ```bash
-crew interrupt HRD-442 --reason "wrong implementation direction"
-crew doctor --ticket HRD-442
+crew stop HRD-442 --reason "wrong implementation direction"
+crew status HRD-442
 crew resume HRD-442
 ```
 
-The command closes the cmux/tmux workspace if present, records local run state, and never tears down the worktree. If the workspace was already gone but the worktree is still present, interrupt records that fact so doctor can point at the preserved branch instead of reporting a mystery ticket.
+The command closes the cmux/tmux workspace if present, records local run state, and never tears down the worktree. If the workspace was already gone but the worktree is still present, stop records that fact so status can show the preserved branch.
 
 ### `crew resume <TICKET>`
 
-Reopens an existing ticket worktree with a continuation prompt. Resume never creates a new worktree; if none exists it fails and leaves re-dispatch to `crew run --ticket <ticket>`.
+Reopens an existing ticket worktree with a continuation prompt. Resume never creates a new worktree; if none exists it fails and leaves re-dispatch to `crew start <ticket>`.
 
 The resume prompt tells the agent to inspect git status and diff before editing, includes the previous interrupt reason when recorded, and reuses the recorded model, repository, branch, runner, sandbox, and workspace backend. When no run-state file exists but a worktree does, resume falls back to Linear resolution for the model and ticket context.
 
@@ -452,7 +442,7 @@ op run --env-file .env.1password -- crew doctor
 
 ## Troubleshooting
 
-First stop for "labeled but not on the board": `crew doctor --ticket <ticket>` lists every check the dispatcher runs and flags the failing one.
+First stop for "what exists locally right now": `crew status <ticket>` shows the ticket's worktrees, workspace presence, run state, logs, and latest Linear status. Use `crew doctor` when you need to verify host setup.
 
 <details>
 <summary>Safehouse-already-wrapped commands are not re-wrapped</summary>

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -8,12 +8,20 @@ import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
 import { sandboxCli } from "./commands/sandbox/index.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, readEnvironmentVariable, readTicketArgument, writeError, writeOutput, } from "./lib/util.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;
 const requireFromCli = createRequire(import.meta.url);
+/**
+ * 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.
+ */
+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>...]";
 }
@@ -53,6 +61,16 @@ async function runCli(argv) {
         await orchestrate({ watch, dryRun });
         return;
     }
+    warnDeprecated({ oldForm: "run --ticket", newForm: "start" });
+    await setupWorkspaceCli(ticket, { dryRun });
+}
+const START_USAGE = "crew start <ticket> [--dry-run]";
+async function startCli(argv) {
+    const { dryRun, positionals } = parseDryRunPositionals(argv, START_USAGE);
+    const [ticket, ...extras] = positionals;
+    if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
+        throw new Error(`Usage: ${START_USAGE}`);
+    }
     await setupWorkspaceCli(ticket, { dryRun });
 }
 async function upgradeCliInvoke(argv) {
@@ -79,31 +97,27 @@ async function maybeRunUpgradeNudge(metadata) {
         writeError(message);
     }
 }
-async function doctorCli(argv) {
-    let ticket;
-    const remainingArgs = [];
-    for (let index = 0; index < argv.length; index += 1) {
-        const argument = argv[index];
-        if (argument === "--ticket") {
-            ticket = readTicketArgument(argv, index, "doctor");
-            index += 1;
-            continue;
-        }
-        if (argument === "--no-linear" || argument === "--no-fetch") {
-            remainingArgs.push(argument);
-            continue;
-        }
-        throw new Error(`crew doctor: unknown argument: ${argument}`);
+function doctorTicketAlias(argv) {
+    if (argv[0] !== "--ticket") {
+        return undefined;
     }
-    if (ticket === undefined) {
-        if (remainingArgs.length > 0) {
-            throw new Error(`crew doctor: ${remainingArgs[0]} requires --ticket (host doctor mode has no flags)`);
-        }
-        const ok = await doctor();
-        process.exitCode = ok ? process.exitCode : 1;
+    const ticket = readTicketArgument(argv, 0, "doctor");
+    if (argv.length > 2) {
+        throw new Error("Usage: crew status [<ticket>]");
+    }
+    return ticket;
+}
+async function doctorCli(argv) {
+    const aliasTicket = doctorTicketAlias(argv);
+    if (aliasTicket !== undefined) {
+        warnDeprecated({ oldForm: "doctor --ticket", newForm: "status" });
+        await statusCli([aliasTicket]);
         return;
     }
-    const ok = await doctor({ ticket, ticketArgv: remainingArgs });
+    if (argv.length > 0) {
+        throw new Error("Usage: crew doctor");
+    }
+    const ok = await doctor();
     process.exitCode = ok ? process.exitCode : 1;
 }
 const SUBCOMMANDS = {
@@ -113,25 +127,44 @@ const SUBCOMMANDS = {
         invoke: initConfigCli,
     },
     run: {
-        summary: "Run the orchestrator (one-shot by default), or provision one ticket with --ticket",
-        usage: "[--watch] [--dry-run] [--ticket <ticket>]",
+        summary: "Run the orchestrator: poll sources and start eligible tickets (one-shot by default)",
+        usage: "[--watch] [--dry-run]",
         invoke: runCli,
     },
+    start: {
+        summary: "Provision and launch one ticket immediately, bypassing eligibility",
+        usage: "<ticket> [--dry-run]",
+        invoke: startCli,
+    },
     doctor: {
-        summary: "Verify prereqs, or diagnose one ticket with --ticket (full lifecycle: dispatch eligibility + local-state recovery)",
-        usage: "[--ticket <ticket> [--no-linear] [--no-fetch]]",
+        summary: "Verify host prerequisites (PATH tools, config validity, Linear reachability)",
+        usage: "",
         invoke: doctorCli,
     },
+    status: {
+        summary: "Print read-only groundcrew state, or one ticket's local/Linear status",
+        usage: "[<ticket>]",
+        invoke: statusCli,
+    },
     cleanup: {
         summary: "Tear down a worktree",
         usage: "[--force] <ticket>",
         invoke: cleanupWorkspaceCli,
     },
-    interrupt: {
+    stop: {
         summary: "Stop a live ticket workspace while preserving its worktree",
         usage: "<ticket> [--reason <text>]",
         invoke: interruptWorkspaceCli,
     },
+    interrupt: {
+        summary: "Deprecated alias for `crew stop`",
+        usage: "<ticket> [--reason <text>]",
+        deprecated: true,
+        invoke: async (argv) => {
+            warnDeprecated({ oldForm: "interrupt", newForm: "stop" });
+            await interruptWorkspaceCli(argv);
+        },
+    },
     resume: {
         summary: "Reopen an existing ticket worktree with a continuation prompt",
         usage: "<ticket>",
@@ -162,6 +195,9 @@ function printHelp() {
     writeOutput("");
     writeOutput("Commands:");
     for (const [name, command] of Object.entries(SUBCOMMANDS)) {
+        if (command.deprecated === true) {
+            continue;
+        }
         writeOutput(`  ${name.padEnd(width)}  ${command.summary}`);
         writeOutput(`  ${" ".repeat(width)}  → crew ${name} ${command.usage}`);
     }

package/dist/commands/doctor.d.ts

@@ -2,10 +2,5 @@
  * doctor — verify groundcrew prerequisites against the resolved config.
  * Returns true if every required check passes; false otherwise.
  */
-export interface DoctorOptions {
-    ticket?: string;
-    /** Extra flags after `--ticket <id>`; currently `--no-linear` and `--no-fetch`. */
-    ticketArgv?: string[];
-}
-export declare function doctor(options?: DoctorOptions): Promise<boolean>;
+export declare function doctor(): Promise<boolean>;
 //# sourceMappingURL=doctor.d.ts.map

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;AA4BH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAgHD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAK1E"}
+{"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"}

package/dist/commands/doctor.js

@@ -4,12 +4,12 @@
  */
 import { existsSync, statSync } from "node:fs";
 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, resolveLinearApiKey, writeOutput } from "../lib/util.js";
+import { errorMessage, getLinearClient, resolveLinearApiKey, writeOutput } from "../lib/util.js";
 import { resolveWorkspaceKind } from "../lib/workspaces.js";
-import { parseTicketDoctorFlags, runTicketDoctor } from "./ticketDoctor.js";
 // Tokenization stops after this many non-flag tokens. Two is enough to
 // catch wrapper + wrapped CLI commands like `safehouse claude --foo`.
 const MAX_TOKENS_PER_CMD = 2;
@@ -26,22 +26,33 @@ async function checkCmd(cmd, required, hint) {
     }
     return result;
 }
-function checkLinearApiKey() {
+async function checkLinearReachability(config) {
     const resolved = resolveLinearApiKey();
-    if (resolved !== undefined) {
+    if (resolved === undefined) {
         return {
-            name: "linear api key",
+            name: "linear reachability",
+            ok: false,
+            required: true,
+            hint: "export $GROUNDCREW_LINEAR_API_KEY or $LINEAR_API_KEY",
+        };
+    }
+    try {
+        await createBoardSource({ config, client: getLinearClient() }).verify();
+        return {
+            name: "linear reachability",
             ok: true,
             required: true,
             hint: `set via $${resolved.source}`,
         };
     }
-    return {
-        name: "linear api key",
-        ok: false,
-        required: true,
-        hint: "export $GROUNDCREW_LINEAR_API_KEY or $LINEAR_API_KEY",
-    };
+    catch (error) {
+        return {
+            name: "linear reachability",
+            ok: false,
+            required: true,
+            hint: errorMessage(error),
+        };
+    }
 }
 function checkDir(path, label) {
     // statSync can throw on permission errors or path races; surface those
@@ -120,31 +131,7 @@ function format(check) {
     const hint = check.hint !== undefined && check.hint.length > 0 ? `  — ${check.hint}` : "";
     return `${tag}${check.name}${hint}`;
 }
-export async function doctor(options = {}) {
-    if (options.ticket !== undefined) {
-        return await doctorTicket(options.ticket, options.ticketArgv ?? []);
-    }
-    return await doctorHost();
-}
-async function doctorTicket(ticket, ticketArgv) {
-    try {
-        const flags = parseTicketDoctorFlags(ticketArgv);
-        return await runTicketDoctor({
-            ticket,
-            doLinear: flags.doLinear,
-            doFetch: flags.doFetch,
-        });
-    }
-    catch (error) {
-        const displayTicket = ticket.toUpperCase();
-        const header = `groundcrew doctor --ticket ${displayTicket}`;
-        writeOutput(header);
-        writeOutput("=".repeat(header.length));
-        writeOutput(`[--] config: ${errorMessage(error)}`);
-        return false;
-    }
-}
-async function doctorHost() {
+export async function doctor() {
     writeOutput("groundcrew doctor");
     writeOutput("=================");
     let config;
@@ -174,7 +161,7 @@ async function doctorHost() {
     const workspaceOutcome = resolveWorkspaceOutcome(config, host);
     reportWorkspaceKind(config, workspaceOutcome);
     const checks = [
-        checkLinearApiKey(),
+        await checkLinearReachability(config),
         await checkCmd("git", true, "https://git-scm.com/"),
         ...(await workspaceChecks(workspaceOutcome)),
         checkDir(config.workspace.projectDir, "workspace.projectDir"),

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

@@ -1 +1 @@
-{"version":3,"file":"interruptWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/interruptWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuGD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}
+{"version":3,"file":"interruptWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/interruptWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqGD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}

package/dist/commands/interruptWorkspace.js

@@ -15,20 +15,20 @@ function parseArguments(argv) {
         if (argument === "--reason") {
             const value = argv[index + 1];
             if (value === undefined || value.length === 0 || value.startsWith("-")) {
-                throw new Error("crew interrupt --reason: reason text is required");
+                throw new Error("crew stop --reason: reason text is required");
             }
             reason = value;
             index += 1;
             continue;
         }
         if (argument.startsWith("-")) {
-            throw new Error(`Unknown option: ${argument}\nUsage: crew interrupt <ticket> [--reason <text>]`);
+            throw new Error(`Unknown option: ${argument}\nUsage: crew stop <ticket> [--reason <text>]`);
         }
         positionals.push(argument);
     }
     const [ticket, ...extras] = positionals;
     if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
-        throw new Error("Usage: crew interrupt <ticket> [--reason <text>]");
+        throw new Error("Usage: crew stop <ticket> [--reason <text>]");
     }
     return { ticket: ticket.toLowerCase(), ...(reason === undefined ? {} : { reason }) };
 }
@@ -100,7 +100,7 @@ export async function interruptWorkspace(config, options) {
         },
     });
     log(`Interrupted ${ticket}; worktree preserved at ${source.worktreeDir}`);
-    log(`Next: crew doctor --ticket ${ticket}`);
+    log(`Next: crew status ${ticket}`);
 }
 export async function interruptWorkspaceCli(argv) {
     const config = await loadConfig();

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

@@ -1 +1 @@
-{"version":3,"file":"setupRepos.d.ts","sourceRoot":"","sources":["../../src/commands/setupRepos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;IACzC,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AA6JD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0D3B;AAwBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE"}
+{"version":3,"file":"setupRepos.d.ts","sourceRoot":"","sources":["../../src/commands/setupRepos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;IACzC,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AA6JD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0D3B;AAcD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE"}

package/dist/commands/setupRepos.js

@@ -10,7 +10,7 @@ import { dirname, isAbsolute, relative, resolve } from "node:path";
 import { runCommandAsync } from "../lib/commandRunner.js";
 import { loadConfig } from "../lib/config.js";
 import { which } from "../lib/host.js";
-import { errorMessage, log, writeOutput } from "../lib/util.js";
+import { errorMessage, log, parseDryRunPositionals, writeOutput } from "../lib/util.js";
 function emptyResult() {
     return {
         existing: [],
@@ -190,18 +190,7 @@ export async function setupRepos(config, options) {
     return result;
 }
 function parseArguments(argv) {
-    let dryRun = false;
-    const positionals = [];
-    for (const argument of argv) {
-        if (argument === "--dry-run") {
-            dryRun = true;
-            continue;
-        }
-        if (argument.startsWith("-")) {
-            throw new Error(`Unknown option: ${argument}\nUsage: crew setup repos [--dry-run] [<repo>...]`);
-        }
-        positionals.push(argument);
-    }
+    const { dryRun, positionals } = parseDryRunPositionals(argv, "crew setup repos [--dry-run] [<repo>...]");
     const options = { dryRun };
     if (positionals.length > 0) {
         options.only = positionals;

package/dist/commands/status.d.ts

@@ -0,0 +1,7 @@
+import { type ResolvedConfig } from "../lib/config.ts";
+export interface StatusOptions {
+    ticket?: string;
+}
+export declare function status(config: ResolvedConfig, options?: StatusOptions): Promise<void>;
+export declare function statusCli(argv: string[]): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWnE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuLD,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}