@clipboard-health/groundcrew 4.0.1 → 4.0.2

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,7 +82,7 @@ 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 status [<TICKET>]                                   # inspect current state or one ticket
 crew run                                                 # one-shot dispatch
 crew run --watch                                         # poll forever
 crew run --ticket <TICKET>                               # dispatch one ticket
@@ -185,72 +192,44 @@ 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`)
-
-Local branch
-  [ok] Local branch exists (paul-hrd-442, 2 ahead / 0 behind origin/main)
-
-Remote branch
-  [ok] Branch present on origin
-
-Pull request
-  [ok] Open PR for this branch (#224 https://github.com/herds-social/herds/pull/224)
+---------
+live: yes
 
-→ pr-open: https://github.com/herds-social/herds/pull/224 (#224)
+Last Linear status
+------------------
+In Progress (state.type=started) — Multi-event extractor: year inference can produce date_start > date_end
 ```
 
 </details>
@@ -261,11 +240,11 @@ Stops a live workspace pane while preserving the ticket worktree and branch. The
 
 ```bash
 crew interrupt HRD-442 --reason "wrong implementation direction"
-crew doctor --ticket HRD-442
+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, interrupt records that fact so status can show the preserved branch.
 
 ### `crew resume <TICKET>`
 
@@ -452,7 +431,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":"AA6MA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvD"}

package/dist/cli.js

@@ -8,6 +8,7 @@ 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";
@@ -80,30 +81,10 @@ async function maybeRunUpgradeNudge(metadata) {
     }
 }
 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}`);
+    if (argv.length > 0) {
+        throw new Error("Usage: crew doctor");
     }
-    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;
-        return;
-    }
-    const ok = await doctor({ ticket, ticketArgv: remainingArgs });
+    const ok = await doctor();
     process.exitCode = ok ? process.exitCode : 1;
 }
 const SUBCOMMANDS = {
@@ -118,10 +99,15 @@ const SUBCOMMANDS = {
         invoke: runCli,
     },
     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>",

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.js

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

package/dist/commands/status.js

@@ -0,0 +1,178 @@
+import { readFileSync } from "node:fs";
+import { fetchRawLinearIssue } from "../lib/boardSource.js";
+import { loadConfig } from "../lib/config.js";
+import { readRunState } from "../lib/runState.js";
+import { errorMessage, getLinearClient, withLogOutputSuppressed, writeOutput, } from "../lib/util.js";
+import { workspaces } from "../lib/workspaces.js";
+import { worktrees } from "../lib/worktrees.js";
+const RECENT_LOG_LINE_COUNT = 10;
+function escapeRegExp(value) {
+    return value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
+}
+function ticketLinePattern(ticket) {
+    return new RegExp(`(^|[^a-z0-9])${escapeRegExp(ticket)}([^a-z0-9]|$)`, "i");
+}
+function parseArguments(argv) {
+    const [ticket, ...extras] = argv;
+    if (extras.length > 0 || ticket?.length === 0 || ticket?.startsWith("-") === true) {
+        throw new Error("Usage: crew status [<ticket>]");
+    }
+    return ticket === undefined ? {} : { ticket: ticket.toLowerCase() };
+}
+function writeSection(title) {
+    writeOutput();
+    writeOutput(title);
+    writeOutput("-".repeat(title.length));
+}
+function writeConfigSnapshot(config) {
+    writeSection("Config snapshot");
+    writeOutput(`projectDir: ${config.workspace.projectDir}`);
+    writeOutput(`repositories: ${config.workspace.knownRepositories.join(", ")}`);
+    writeOutput(`git: remote=${config.git.remote}; defaultBranch=${config.git.defaultBranch}`);
+    writeOutput(`workspaceKind: ${config.workspaceKind}`);
+    writeOutput(`local.runner: ${config.local.runner}`);
+    writeOutput(`models: default=${config.models.default}; enabled=${Object.keys(config.models.definitions).join(", ")}`);
+    writeOutput(`logFile: ${config.logging.file}`);
+}
+function formatDirtiness(dirtiness) {
+    if (dirtiness.kind === "dirty") {
+        return `dirty (${dirtiness.modified} modified, ${dirtiness.untracked} untracked)`;
+    }
+    return dirtiness.kind;
+}
+async function writeTicketWorktrees(config, ticket) {
+    writeSection("Worktree state");
+    const entries = worktrees.findByTicket(config, ticket);
+    if (entries.length === 0) {
+        writeOutput("(none)");
+        return;
+    }
+    for (const entry of entries) {
+        // oxlint-disable-next-line no-await-in-loop -- status output is easier to read in worktree order.
+        const dirtiness = await worktrees.probeWorkingTree({ worktreeDir: entry.dir });
+        writeOutput(`- ${entry.repository} ${entry.kind}`);
+        writeOutput(`  ticket: ${entry.ticket}`);
+        writeOutput(`  branch: ${entry.branchName}`);
+        writeOutput(`  dir: ${entry.dir}`);
+        writeOutput(`  git: ${formatDirtiness(dirtiness)}`);
+    }
+}
+function workspaceProbeUnavailableLine(probe) {
+    return probe.error === undefined
+        ? "Workspace probe unavailable"
+        : `Workspace probe unavailable: ${errorMessage(probe.error)}`;
+}
+function writeTicketWorkspace(probe, ticket) {
+    writeSection("Workspace probe");
+    if (probe.kind === "unavailable") {
+        writeOutput(workspaceProbeUnavailableLine(probe));
+        return;
+    }
+    writeOutput(`live: ${probe.names.has(ticket) ? "yes" : "no"}`);
+}
+function formatRunState(state) {
+    if (state === undefined) {
+        return "(none)";
+    }
+    const summary = `${state.state}; model=${state.model}; updated=${state.updatedAt}; resumes=${state.resumeCount}`;
+    const detail = state.reason ?? state.detail;
+    return detail === undefined ? summary : `${summary}; ${detail}`;
+}
+function recentTicketLogLines(config, ticket) {
+    let raw;
+    try {
+        raw = readFileSync(config.logging.file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const pattern = ticketLinePattern(ticket);
+    return raw
+        .split("\n")
+        .filter((line) => pattern.test(line))
+        .slice(-RECENT_LOG_LINE_COUNT);
+}
+async function linearStatus(ticket) {
+    try {
+        const issue = await fetchRawLinearIssue({ client: getLinearClient(), ticket });
+        return `${issue.stateName} (state.type=${issue.stateType ?? "unknown"}) — ${issue.title}`;
+    }
+    catch (error) {
+        return `unavailable: ${errorMessage(error)}`;
+    }
+}
+async function writeTicketStatus(config, rawTicket) {
+    const ticket = rawTicket.toLowerCase();
+    const displayTicket = ticket.toUpperCase();
+    writeOutput(`groundcrew status ${displayTicket}`);
+    writeOutput("=".repeat(`groundcrew status ${displayTicket}`.length));
+    writeOutput(`ticket: ${ticket}`);
+    writeConfigSnapshot(config);
+    await writeTicketWorktrees(config, ticket);
+    const workspaceProbe = await withLogOutputSuppressed(async () => await workspaces.probe(config));
+    writeTicketWorkspace(workspaceProbe, ticket);
+    writeSection("Run state");
+    writeOutput(formatRunState(readRunState(config, ticket)));
+    writeSection("Recent logs");
+    const logLines = recentTicketLogLines(config, ticket);
+    writeOutput(logLines.length === 0 ? "(none)" : logLines.join("\n"));
+    writeSection("Last Linear status");
+    writeOutput(await linearStatus(ticket));
+}
+function workspacePresence(probe, ticket) {
+    if (probe.kind === "unavailable") {
+        return "unknown";
+    }
+    return probe.names.has(ticket) ? "yes" : "no";
+}
+function writeInventoryWorktrees(config, probe) {
+    writeSection("Worktrees");
+    const entries = worktrees
+        .list(config)
+        .toSorted((left, right) => left.ticket.localeCompare(right.ticket));
+    if (entries.length === 0) {
+        writeOutput("(none)");
+        return;
+    }
+    const runStates = new Map();
+    for (const entry of entries) {
+        if (!runStates.has(entry.ticket)) {
+            runStates.set(entry.ticket, readRunState(config, entry.ticket));
+        }
+        const runState = runStates.get(entry.ticket);
+        writeOutput(`${entry.ticket}  ${entry.repository}  ${entry.kind}  workspace=${workspacePresence(probe, entry.ticket)}  run=${runState?.state ?? "none"}`);
+        writeOutput(`  ${entry.branchName}  ${entry.dir}`);
+    }
+}
+function writeInventoryWorkspaces(probe) {
+    writeSection("Live workspaces");
+    if (probe.kind === "unavailable") {
+        writeOutput(workspaceProbeUnavailableLine(probe));
+        return;
+    }
+    const names = [...probe.names].toSorted();
+    writeOutput(names.length === 0 ? "(none)" : names.join("\n"));
+}
+async function writeInventoryStatus(config) {
+    writeOutput("groundcrew status");
+    writeOutput("=================");
+    const probe = await withLogOutputSuppressed(async () => await workspaces.probe(config));
+    writeInventoryWorktrees(config, probe);
+    writeInventoryWorkspaces(probe);
+}
+export async function status(config, options = {}) {
+    const ticket = options.ticket?.trim();
+    if (ticket === undefined) {
+        await writeInventoryStatus(config);
+        return;
+    }
+    if (ticket.length === 0 || ticket.startsWith("-")) {
+        throw new Error("ticket must be a non-empty value");
+    }
+    await writeTicketStatus(config, ticket);
+}
+export async function statusCli(argv) {
+    const options = parseArguments(argv);
+    const config = await loadConfig();
+    await status(config, options);
+}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ 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 { status, type StatusOptions } from "./commands/status.ts";
 export type { Config, ModelDefinition, ResolvedConfig, SourceConfig } from "./lib/config.ts";
 export { loadConfig } from "./lib/config.ts";
 export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, type RunLifecycleState, type RunState, } from "./lib/runState.ts";
@@ -15,6 +16,4 @@ 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,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,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,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,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"}
+{"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,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,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,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,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"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { interruptWorkspace, } from "./commands/interruptWorkspace.js";
 export { orchestrate } from "./commands/orchestrator.js";
 export { resumeWorkspace } from "./commands/resumeWorkspace.js";
 export { setupWorkspace } from "./commands/setupWorkspace.js";
+export { status } from "./commands/status.js";
 export { loadConfig } from "./lib/config.js";
 export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, } from "./lib/runState.js";
 export { fetchBlockersForTicket, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, resolveModelFor, resolveRepositoryFor, } from "./lib/boardSource.js";
@@ -13,4 +14,4 @@ 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";
+// RepositoryResolutionError is exported via boardSource.ts above (single canonical location).

package/dist/lib/util.d.ts

@@ -3,6 +3,7 @@ export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function writeOutput(message?: string): void;
 export declare function writeError(message: string): void;
 export declare function setLogFile(path: string | undefined): void;
+export declare function withLogOutputSuppressed<T>(operation: () => Promise<T>): Promise<T>;
 export declare function log(message: string): void;
 type LogEventFieldValue = boolean | number | string | readonly string[] | undefined;
 export declare function logEvent(event: string, fields: Record<string, LogEventFieldValue>): void;
@@ -18,8 +19,8 @@ export declare function getLinearClient(): LinearClient;
 /**
  * Returns a zero-arg getter that lazily constructs (and caches) a Linear
  * client on first call. Used by CLI entry points that may not need the
- * client at all (e.g. `--no-linear`), so we avoid blowing up on a missing
- * API key when no Linear call is actually made. The factory is taken as a
+ * client at all, so we avoid blowing up on a missing API key when no Linear
+ * call is actually made. The factory is taken as a
  * parameter (rather than calling `getLinearClient` directly) so callers can
  * pass their own module-level import of `getLinearClient` — that binding
  * respects `vi.mock` intercepts, whereas an intra-module reference would

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzD;AAkBD,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,KAAK,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;AAUpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAWxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAQtE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAQD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzD;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxF;AAkBD,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQzC;AAED,KAAK,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;AAUpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAcxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAQtE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}