@clipboard-health/groundcrew 4.6.0 → 4.7.0

package/README.md

@@ -16,48 +16,64 @@
   <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/@clipboard-health/groundcrew?style=flat-square&label=license&color=18181b&labelColor=18181b"></a>
 </p>
 
-Groundcrew watches assigned tickets, creates isolated worktrees, launches agent CLIs in cmux or tmux, and leaves each ticket's work on its own branch. The longer product story is in [Tickets to pull requests while you sleep](https://www.clipboardworks.com/resources/blog/tickets-to-pull-requests-while-you-sleep).
+<p align="center">
+  <img alt="Groundcrew picking up tickets and running coding agents in parallel" src="./static/demo.gif" width="800">
+</p>
+
+Groundcrew watches assigned tickets, creates isolated worktrees, launches agent CLIs in dedicated terminals, and leaves each ticket's work on its own PR-ready branch. For the backstory, read _[Tickets to pull requests while you sleep](https://www.clipboardworks.com/resources/blog/tickets-to-pull-requests-while-you-sleep)_.
 
 ## Why
 
 - **One worktree per ticket.** Agents work in parallel without stepping on each other.
-- **Linear out of the box.** Assign yourself an `agent-*` labeled issue and Groundcrew can pick it up.
-- **Local-first isolation.** Safehouse on macOS, Docker Sandboxes on Linux/WSL, or an explicit `none` escape hatch.
+- **Pluggable ticket sources.** Linear by default; Jira and local files via [ticket sources](./docs/ticket-sources.md).
+- **Local-first isolation.** Safehouse, Docker Sandboxes, or an explicit `none` escape hatch.
 - **Multi-agent routing.** Ships with `claude` and `codex`; bring your own CLI in config.
 
+## Prerequisites
+
+`crew doctor` checks all of these, so you can install as you go.
+
+- **Node >= 24:** [nvm](https://github.com/nvm-sh/nvm): `nvm install 24`.
+- **git:** e.g., `brew install git`, `apt install git`.
+- **A terminal multiplexer:** [tmux](https://github.com/tmux/tmux/wiki/Installing) (cross-platform) or [cmux](https://cmux.com/) (macOS).
+- **An agent CLI:** [Claude Code](https://code.claude.com/docs/en/quickstart) and/or [Codex](https://developers.openai.com/codex/quickstart?setup=cli).
+- **A sandbox runner:** [Docker Sandboxes](https://docs.docker.com/sandboxes/) (cross-platform) or [Safehouse](https://agent-safehouse.dev/) on macOS. Skip only with `--runner none`.
+
 ## Quickstart
 
 ```bash
-# 1. Install Node >= 24, git, cmux or tmux, and the agent CLI you'll use.
-
-# 2. Install groundcrew.
+# 1. Install groundcrew.
 npm install -g @clipboard-health/groundcrew
 
-# 3. Scaffold a global config.
-#    runner=none is the quickest path, but it runs agents unsandboxed on the host.
-crew init --global --project-dir ~/dev --repo OWNER/REPO --runner none --model claude
+# 2. Scaffold a global config. Agents are sandboxed by default
+#    (Safehouse/Docker Sandboxes); add --runner none to run unsandboxed on the host.
+crew init --global --project-dir ~/dev --repo OWNER/REPO --model claude
 
-# 4. Run the clone commands printed by `crew init`.
+# 3. Run the clone commands printed by `crew init`.
 
-# 5. If using Linear, export your API key.
+# 4. Using Linear? Export your API key. (Jira and other trackers: see Ticket Pickup.)
 export GROUNDCREW_LINEAR_API_KEY="lin_api_..."
 
-# 6. Verify setup, then dispatch.
+# 5. Verify setup, then dispatch.
 crew doctor
 crew run --watch
 ```
 
-`crew init --global` writes config to `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/`. Pass `--repo` more than once for multiple repos. Pass `--model claude` or `--model codex` to disable the missing CLI if you only have one installed.
+`crew init --global` writes config to `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/`. Pass `--repo` more than once for multiple repos. If you only have one CLI installed, pass `--model claude` (or `--model codex`) so Groundcrew disables the other model and `doctor` won't flag it as missing.
 
 ## Ticket Pickup
 
-For Linear, assign tickets to yourself and add an `agent-*` label:
+**Not on Linear?** Use Jira or local files via [ticket sources](./docs/ticket-sources.md).
+
+Linear works out of the box: assign tickets to yourself and add an `agent-*` label.
 
 - `agent-claude`, `agent-codex`, or `agent-<name>` routes to that model.
 - `agent-any` routes to the enabled model with the most available capacity.
 - Tickets without an `agent-*` label are ignored by `crew run`; dispatch one manually with `crew start <TICKET>`.
 
-Groundcrew scans `workspace.knownRepositories` to infer which repo a ticket belongs to. A ticket blocked by non-terminal blockers is skipped until those blockers are done.
+Groundcrew scans `workspace.knownRepositories` to infer which repo a ticket belongs to.
+
+A ticket blocked by non-terminal blockers is skipped until those blockers are done.
 
 ## Commands
 
@@ -91,7 +107,7 @@ export default {
     knownRepositories: ["OWNER/REPO"],
   },
   local: {
-    runner: "none",
+    runner: "auto",
   },
   models: {
     default: "claude",

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -8,7 +8,7 @@ import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
 import { setupWorkspaceCli } from "./commands/setupWorkspace.js";
 import { statusCli } from "./commands/status.js";
 import { createDefaultUpgradeCliOptions, upgradeCli } from "./commands/upgrade.js";
-import { errorMessage, parseDryRunPositionals, readTicketArgument, writeError, writeOutput, } from "./lib/util.js";
+import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTicketArgument, setVerbose, 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.",
@@ -176,6 +176,7 @@ function printHelp() {
     writeOutput("Options:");
     writeOutput("  -h, --help     Show help");
     writeOutput("  -v, --version  Print version");
+    writeOutput("      --verbose  Show diagnostic output (or set GROUNDCREW_VERBOSE)");
     writeOutput("");
     writeOutput("Commands:");
     for (const [name, command] of visibleCommands) {
@@ -192,8 +193,27 @@ function packageMetadata() {
 function packageVersion() {
     return packageMetadata().version;
 }
+const VERBOSE_FLAG = "--verbose";
+function environmentVerbose() {
+    const raw = readEnvironmentVariable("GROUNDCREW_VERBOSE");
+    return raw !== undefined && raw !== "" && raw !== "0" && raw.toLowerCase() !== "false";
+}
+/**
+ * Pulls the global `--verbose` flag out of argv before subcommand dispatch so
+ * every command supports it and the strict per-command parsers never see it.
+ * GROUNDCREW_VERBOSE enables it without the flag.
+ */
+function extractVerbose(argv) {
+    const commandArgv = argv.filter((argument) => argument !== VERBOSE_FLAG);
+    const verbose = commandArgv.length !== argv.length || environmentVerbose();
+    return { verbose, commandArgv };
+}
 export async function run(argv) {
-    const [subcommand, ...rest] = argv;
+    const { verbose, commandArgv } = extractVerbose(argv);
+    if (verbose) {
+        setVerbose(true);
+    }
+    const [subcommand, ...rest] = commandArgv;
     if (subcommand === undefined || subcommand === "-h" || subcommand === "--help") {
         printHelp();
         if (subcommand === undefined) {

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,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,KAAK,EAEX,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,CAqNjE;AAUD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}
+{"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,EAGf,KAAK,KAAK,EAEX,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,CAwNjE;AAsBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}

package/dist/commands/dispatcher.js

@@ -8,7 +8,7 @@
  */
 import { dispatchableRepository } from "../lib/repositoryValidation.js";
 import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/ticketSource.js";
-import { errorMessage, log, logEvent } from "../lib/util.js";
+import { errorMessage, failMark, log, logEvent } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { classifyBlockers, classifyEligibility, classifyUsageExhaustion, } from "./eligibility.js";
 import { setupWorkspace } from "./setupWorkspace.js";
@@ -79,7 +79,7 @@ export function createDispatcher(deps) {
             });
         }
         catch (error) {
-            log(`Failed to start ${ticketId}: ${errorMessage(error)}`);
+            log(`${failMark()} Failed to start ${ticketId}: ${errorMessage(error)}`);
             logEvent("dispatch", {
                 outcome: "failed",
                 ticket: ticketId,
@@ -145,18 +145,21 @@ export function createDispatcher(deps) {
             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.
+        // usage first so any necessary workspace probe can overlap with the
+        // in-flight request.
         const usagePromise = usage(signal);
         // Snapshot live workspace names once per iteration so eligibility can
         // distinguish "worktree exists AND its agent is still running" (resume)
         // from "worktree exists but the workspace is gone" (ambiguous — don't
-        // auto-recover). Done before slot-counting so a skipped stale ticket
-        // doesn't consume an eligible slot and starve later Todo tickets.
+        // auto-recover). Skip the shell-out entirely for fresh-start-only ticks:
+        // if none of the candidates has a matching worktree, classifyRecovery()
+        // will never read the probe.
         let workspaceProbe;
         try {
-            workspaceProbe = dryRun
-                ? { kind: "ok", names: new Set() }
-                : await workspaces.probe(config, signal);
+            workspaceProbe =
+                dryRun || !hasRecoverableCandidate(dispatchableUnblocked, worktreeEntries)
+                    ? { kind: "ok", names: new Set() }
+                    : await workspaces.probe(config, signal);
         }
         catch (error) {
             usagePromise.catch(() => "ignored");
@@ -196,6 +199,12 @@ export function createDispatcher(deps) {
     }
     return { runOnce };
 }
+function hasRecoverableCandidate(issues, worktreeEntries) {
+    return issues.some((issue) => {
+        const naturalId = naturalIdFromCanonical(issue.id);
+        return worktreeEntries.some((entry) => entry.repository === issue.repository && entry.ticket === naturalId);
+    });
+}
 function formatUsageExhaustion(exhaustion) {
     if (exhaustion.kind === "session") {
         const mins = exhaustion.resetMinutes ?? "?";

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

@@ -1 +1 @@
-{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}
+{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -106,12 +106,13 @@ export async function resumeWorkspace(config, options) {
     if (definition === undefined) {
         throw new Error(`Unknown model: ${context.model}`);
     }
-    const { runner, sandboxName } = await prepareAgentLaunch({
+    const { runner, sandboxName, ensureReady } = await prepareAgentLaunch({
         config,
         model: context.model,
         definition,
         purpose: "resumes",
     });
+    await ensureReady();
     const stagedPrompt = stagePromptText({
         prefix: "groundcrew-resume",
         ticket,

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

@@ -1 +1 @@
-{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiBnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA6Gf;AAqHD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiBnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA+Gf;AAyID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/commands/setupWorkspace.js

@@ -7,7 +7,7 @@ import { buildLaunchCommand } from "../lib/launchCommand.js";
 import { recordRunState } from "../lib/runState.js";
 import { stageBuildSecrets, stagePromptFromTemplate, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
 import { naturalIdFromCanonical } from "../lib/ticketSource.js";
-import { errorMessage, log } from "../lib/util.js";
+import { debug, errorMessage, log, okMark } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { isWorktreeAlreadyExistsError, worktrees } from "../lib/worktrees.js";
 function stagePrompt(input) {
@@ -31,7 +31,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
     if (!definition) {
         throw new Error(`Unknown model: ${model}`);
     }
-    const { runner, sandboxName } = await prepareAgentLaunch({
+    const { runner, sandboxName, ensureReady } = await prepareAgentLaunch({
         config,
         model,
         definition,
@@ -40,11 +40,10 @@ export async function setupWorkspace(config, options, runOptions = {}) {
     });
     const spec = { repository, ticket };
     let created;
+    const createdPromise = signal === undefined ? worktrees.create(config, spec) : worktrees.create(config, spec, signal);
+    const readinessPromise = startLaunchReadiness(ensureReady);
     try {
-        created =
-            signal === undefined
-                ? await worktrees.create(config, spec)
-                : await worktrees.create(config, spec, signal);
+        created = await createdPromise;
     }
     catch (error) {
         if (isWorktreeAlreadyExistsError(error)) {
@@ -63,6 +62,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
     // the ticket strands forever.
     let promptDir;
     try {
+        await assertLaunchReady(readinessPromise);
         const ticketDetails = options.details;
         const accessHint = await workspaces.accessHint(config, ticket, signal);
         const stagedPrompt = stagePrompt({
@@ -83,7 +83,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             sandboxName,
         });
         const launchCmd = stageWorkspaceLaunchCommand(promptDir, launchCommand);
-        log("Opening workspace...");
+        debug("Opening workspace...");
         await openAgentWorkspace({
             config,
             name: ticket,
@@ -105,9 +105,9 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             title: ticketDetails.title,
             ...(ticketDetails.url === undefined ? {} : { url: ticketDetails.url }),
         });
-        log(`Workspace "${ticket}" launched (${model})`);
-        log(`  Worktree: ${launchDir}`);
-        log(`  Branch:   ${branchName}`);
+        log(`${okMark()} "${ticket}" launched (${model})  worktree ${worktreeName}`);
+        debug(`  Worktree: ${launchDir}`);
+        debug(`  Branch:   ${branchName}`);
         if (accessHint !== undefined) {
             logAccessHint(accessHint);
         }
@@ -130,6 +130,21 @@ export async function setupWorkspace(config, options, runOptions = {}) {
         throw error;
     }
 }
+async function startLaunchReadiness(ensureReady) {
+    try {
+        await ensureReady();
+        return { kind: "ready" };
+    }
+    catch (error) {
+        return { kind: "failed", error };
+    }
+}
+async function assertLaunchReady(readinessPromise) {
+    const readiness = await readinessPromise;
+    if (readiness.kind === "failed") {
+        throw readiness.error;
+    }
+}
 /**
  * Probe the workspace backend and, if a workspace for `ticket` is still
  * live, log the access hint. Used on the pre-launch error path (e.g. the
@@ -151,7 +166,7 @@ async function logAccessHintForExistingWorkspace(arguments_) {
     logAccessHint(accessHint);
 }
 function logAccessHint(accessHint) {
-    log(`  Attach:   ${accessHint.command}`);
+    debug(`  Attach:   ${accessHint.command}`);
 }
 function renderWorkspaceContinuationInstruction(accessHint) {
     if (accessHint === undefined) {

package/dist/commands/teardownReporter.js

@@ -1,14 +1,14 @@
-import { errorMessage, log, logEvent } from "../lib/util.js";
+import { debug, errorMessage, log, logEvent, okMark } from "../lib/util.js";
 export function logTeardown(result) {
     if (result.workspaceProbe.kind === "unavailable" && result.workspaceProbe.error !== undefined) {
         log(`workspace list failed: ${errorMessage(result.workspaceProbe.error)}`);
     }
     for (const ticket of result.closed) {
-        log(`Closed workspace ${ticket}`);
+        debug(`Closed workspace ${ticket}`);
     }
     for (const entry of result.removed) {
-        log(`Cleanup complete for ${entry.ticket} (${entry.kind})`);
-        log(`  Worktree: ${entry.dir} (removed)`);
+        log(`${okMark()} Cleanup complete for ${entry.ticket} (${entry.kind})`);
+        debug(`  Worktree: ${entry.dir} (removed)`);
     }
     for (const failure of result.failures) {
         const message = errorMessage(failure.error);

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

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

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

@@ -9,7 +9,7 @@
  * Done -> Shipped, etc.) Just Work without per-team config.
  */
 import { RepositoryResolutionError } from "../../ticketSource.js";
-import { log } from "../../util.js";
+import { log, styleWarning } from "../../util.js";
 import { AGENT_LABEL_PREFIX, resolveModelFor, resolveRepositoryFor, } from "./parsing.js";
 export const ISSUES_PAGE_SIZE = 250;
 // `state.type` values surfaced by `fetch()`. `backlog` / `triage` are dropped
@@ -33,13 +33,13 @@ export function createBoardSource(deps) {
     };
 }
 async function verifyViewer(client) {
-    const response = await client.client.rawRequest(`query VerifyViewer { viewer { id name email } }`);
+    const response = await client.client.rawRequest(`query VerifyViewer { viewer { id name } }`);
     // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by our GraphQL query above
     const { viewer } = response.data;
     if (viewer === null) {
         throw new Error("Linear API did not return a viewer for this API key. Confirm LINEAR_API_KEY is set and points to a personal API key, not a workspace key.");
     }
-    log(`Resolved Linear viewer: ${viewer.name} (${viewer.email})`);
+    log(`Resolved Linear viewer: ${viewer.name}`);
 }
 export function isIssueInProgress(issue) {
     return issue.stateType === "started";
@@ -158,7 +158,7 @@ function resolveAgentMetadata(arguments_) {
         }
         else {
             model = undefined;
-            log(`WARNING: ${ticket} has an ${AGENT_LABEL_PREFIX}* label but no known repository in its description; skipping dispatch. Add one of workspace.knownRepositories to the description, or remove the ${AGENT_LABEL_PREFIX}* label: ${config.workspace.knownRepositories.join(", ")}`);
+            log(styleWarning(`WARNING: ${ticket} has an ${AGENT_LABEL_PREFIX}* label but no known repository in its description; skipping dispatch. Add one of workspace.knownRepositories to the description, or remove the ${AGENT_LABEL_PREFIX}* label: ${config.workspace.knownRepositories.join(", ")}`));
         }
     }
     return { repository, model };

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

@@ -1,4 +1,4 @@
-import { log } from "../../util.js";
+import { debug } from "../../util.js";
 export function createLinearIssueStatusUpdater(arguments_) {
     const { client } = arguments_;
     // Positive cache only. Keyed by teamId because the in-progress-state
@@ -45,7 +45,7 @@ export function createLinearIssueStatusUpdater(arguments_) {
             throw new Error(`Could not find a workflow state with type "started" for ${issue.id} (team ${issue.teamId.length > 0 ? issue.teamId : "?"}). Confirm the team's Linear workflow has an in-progress column.`);
         }
         await client.updateIssue(issue.uuid, { stateId });
-        log(`Marked ${issue.id} as in progress`);
+        debug(`Marked ${issue.id} as in progress`);
     }
     return { markInProgress };
 }

package/dist/lib/adapters/shell/invoke.js

@@ -12,7 +12,7 @@
  * interpret); any other nonzero exit throws.
  */
 import { spawn } from "node:child_process";
-import { log } from "../../util.js";
+import { debug } from "../../util.js";
 /**
  * Hard cap on captured stdout/stderr per stream. Misbehaving scripts that
  * `yes | head -c <huge>` would otherwise exhaust memory. 10 MB is enough for
@@ -96,7 +96,7 @@ export async function invokeShellCommand(args) {
             clearTimeout(timer);
             const stderrText = stderr.toString("utf8");
             if (stderrText.length > 0) {
-                log(`[shell:${args.sourceName}] ${command}\n${stderrText.trimEnd()}`);
+                debug(`[shell:${args.sourceName}] ${command}\n${stderrText.trimEnd()}`);
             }
             /* v8 ignore next @preserve -- `code` is null only when the process was killed by signal; the timeout path SIGKILLs but settles via the timer rather than 'close' */
             const exitCode = code ?? 1;

package/dist/lib/agentLaunch.d.ts

@@ -2,6 +2,7 @@ import { type LocalRunner, type ModelDefinition, type ResolvedConfig } from "./c
 interface PreparedAgentLaunch {
     runner: LocalRunner;
     sandboxName: string | undefined;
+    ensureReady: () => Promise<void>;
 }
 export declare function prepareAgentLaunch(input: {
     config: ResolvedConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAOrB,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsD/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAOrB,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+C/B;AAqBD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/lib/agentLaunch.js

@@ -3,26 +3,17 @@ import { hasPreLaunchEnv, } from "./config.js";
 import { detectHostCapabilities } from "./host.js";
 import { assertLocalRunnerRequirements, resolveLocalRunner } from "./localRunner.js";
 import { sandboxNameFor } from "./sandboxName.js";
-import { log, sleep } from "./util.js";
+import { debug, sleep } from "./util.js";
 import { workspaces } from "./workspaces.js";
 export async function prepareAgentLaunch(input) {
     const host = await detectHostCapabilities(input.signal);
     const runner = resolveLocalRunner(input.config.local.runner, host);
     assertLocalRunnerRequirements(host, runner);
-    if (runner === "safehouse") {
-        await ensureClearance({
-            logger: log,
-            ...(input.signal === undefined
-                ? {}
-                : {
-                    sleep: async (ms) => {
-                        await sleep(ms, input.signal);
-                        input.signal?.throwIfAborted();
-                    },
-                }),
-        });
-        input.signal?.throwIfAborted();
-    }
+    const ensureReady = runner === "safehouse"
+        ? async () => {
+            await ensureSafehouseClearance(input.signal);
+        }
+        : alreadyReady;
     if (runner === "sdx" && input.definition.sandbox === undefined) {
         throw new Error(`Local groundcrew ${input.purpose} with the sdx runner require a sandbox config on model '${input.model}'.`);
     }
@@ -46,7 +37,24 @@ export async function prepareAgentLaunch(input) {
     const sandboxName = runner === "sdx" && input.definition.sandbox !== undefined
         ? sandboxNameFor({ agent: input.definition.sandbox.agent })
         : undefined;
-    return { runner, sandboxName };
+    return { runner, sandboxName, ensureReady };
+}
+async function alreadyReady() {
+    await Promise.resolve();
+}
+async function ensureSafehouseClearance(signal) {
+    await ensureClearance({
+        logger: debug,
+        ...(signal === undefined
+            ? {}
+            : {
+                sleep: async (ms) => {
+                    await sleep(ms, signal);
+                    signal.throwIfAborted();
+                },
+            }),
+    });
+    signal?.throwIfAborted();
 }
 export async function openAgentWorkspace(input) {
     const spec = {

package/dist/lib/cmuxAdapter.js

@@ -4,7 +4,7 @@
  * per-workspace status pill, which `open` applies best-effort.
  */
 import { isSignalAborted, runWorkspaceCommand, } from "./workspaceAdapter.js";
-import { errorMessage, log } from "./util.js";
+import { debug, errorMessage, log } from "./util.js";
 export const cmuxAdapter = {
     async open(spec, signal) {
         const output = await runWorkspaceCommand("cmux", [
@@ -31,7 +31,7 @@ export const cmuxAdapter = {
                 // so swallow that specific gap silently; surface anything else so a real
                 // regression doesn't hide behind the same swallow.
                 if (!isCmuxSetStatusUnsupported(error)) {
-                    log(`cmux set-status failed for ${spec.name} (continuing): ${errorMessage(error)}`);
+                    debug(`cmux set-status failed for ${spec.name} (continuing): ${errorMessage(error)}`);
                 }
             }
         }
@@ -46,7 +46,7 @@ export const cmuxAdapter = {
             // cmux v2 `workspace.close` rejects titles, so forwarding `name`
             // would always fail. The list failure has already been logged by
             // `listCmuxRaw`; bail rather than guarantee a downstream error.
-            log(`cmux close-workspace skipped for ${name}: list-workspaces failed, no usable id`);
+            debug(`cmux close-workspace skipped for ${name}: list-workspaces failed, no usable id`);
             return { kind: "unavailable" };
         }
         const match = raw.find((ws) => ws.title === name);
@@ -90,7 +90,7 @@ function parseCmuxList(output) {
         }
         const id = pickCmuxId(ws);
         if (id === undefined) {
-            log(`cmux list-workspaces returned workspace "${ws.title}" without a usable id or ref; skipping`);
+            debug(`cmux list-workspaces returned workspace "${ws.title}" without a usable id or ref; skipping`);
             continue;
         }
         items.push({ title: ws.title, id });
@@ -121,7 +121,7 @@ async function listCmuxRaw(signal) {
         if (isSignalAborted(signal)) {
             throw error;
         }
-        log(`cmux list-workspaces failed: ${errorMessage(error)}`);
+        debug(`cmux list-workspaces failed: ${errorMessage(error)}`);
         return undefined;
     }
 }

package/dist/lib/config.js

@@ -4,7 +4,7 @@ import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { cosmiconfig } from "cosmiconfig";
-import { log, readEnvironmentVariable, setLogFile } from "./util.js";
+import { debug, log, readEnvironmentVariable, setLogFile } from "./util.js";
 import { xdgConfigPath, xdgStatePath } from "./xdg.js";
 import { BUILD_SECRET_NAMES } from "./buildSecrets.js";
 export { BUILD_SECRET_NAMES } from "./buildSecrets.js";
@@ -601,7 +601,7 @@ export async function loadConfig() {
     if (isEmpty === true || !isPlainObject(userConfig)) {
         fail(`${filepath} must export a config object (e.g. \`export default { ... } satisfies Config\`)`);
     }
-    log(`Loaded config from ${filepath}`);
+    debug(`Loaded config from ${filepath}`);
     // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- runtime fields are validated by applyDefaults/validate
     const resolved = applyDefaults(userConfig);
     validate(resolved);

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

@@ -1 +1 @@
-{"version":3,"file":"localRunner.d.ts","sourceRoot":"","sources":["../../src/lib/localRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,gBAAgB,GACrB,WAAW,CAQb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA6B/F"}
+{"version":3,"file":"localRunner.d.ts","sourceRoot":"","sources":["../../src/lib/localRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,gBAAgB,GACrB,WAAW,CAQb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA+B/F"}

package/dist/lib/localRunner.js

@@ -1,4 +1,4 @@
-import { log } from "./util.js";
+import { log, styleWarning } from "./util.js";
 /**
  * Resolve `local.runner` from config + host capabilities into a concrete
  * backend. `auto` defaults to safehouse on macOS and sdx on Linux — both
@@ -47,5 +47,5 @@ export function assertLocalRunnerRequirements(host, runner) {
         return;
     }
     // runner === "none"
-    log("WARNING: local.runner='none' — agent process will run on the host without sandboxing. Only use this when you understand the implications.");
+    log(styleWarning("WARNING: local.runner='none' — agent process will run on the host without sandboxing. Only use this when you understand the implications."));
 }

package/dist/lib/runStateCleanup.js

@@ -1,12 +1,12 @@
 import { removeRunState } from "./runState.js";
-import { errorMessage, log } from "./util.js";
+import { debug, errorMessage } from "./util.js";
 export function recordCleanedUpRuns(config, entries) {
     for (const entry of entries) {
         try {
             removeRunState(config, entry.ticket);
         }
         catch (error) {
-            log(`Run state cleanup failed for ${entry.ticket}: ${errorMessage(error)}`);
+            debug(`Run state cleanup failed for ${entry.ticket}: ${errorMessage(error)}`);
         }
     }
 }

package/dist/lib/tmuxAdapter.js

@@ -5,7 +5,7 @@
  * Linux/WSL path where cmux is unavailable.
  */
 import { isSignalAborted, runWorkspaceCommand, } from "./workspaceAdapter.js";
-import { errorMessage, log, readEnvironmentVariable } from "./util.js";
+import { debug, errorMessage, readEnvironmentVariable } from "./util.js";
 const TMUX_SESSION = "groundcrew";
 // `tmux new-session -d -s …` always creates one initial window. Without
 // `-n`, that window is named after the running shell (e.g. "0" / "zsh") and
@@ -49,7 +49,7 @@ export const tmuxAdapter = {
             return [];
         }
         if (probe.status === "failed") {
-            log(`tmux list-windows failed: ${probe.reason}`);
+            debug(`tmux list-windows failed: ${probe.reason}`);
             // oxlint-disable-next-line unicorn/no-useless-undefined -- undefined marks the workspace backend as unavailable.
             return undefined;
         }

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

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/lib/usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,aAAa,CAAC;AA+BnE,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,eAK7B,CAAC;AA2GF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAI5D;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA6BvB"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/lib/usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,aAAa,CAAC;AA+BnE,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,eAK7B,CAAC;AA2GF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAI5D;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA+BvB"}

package/dist/lib/usage.js

@@ -6,7 +6,7 @@
  * `codexbar` itself is the user-facing inspection tool.
  */
 import { runCommandAsync } from "./commandRunner.js";
-import { errorMessage, log } from "./util.js";
+import { debug, errorMessage } from "./util.js";
 /**
  * Synthetic snapshot used when codexbar can't be read for a model. Both
  * window fractions are pinned to Infinity so the dispatcher's
@@ -138,10 +138,12 @@ export async function getUsageByModel(config, signal) {
             }
             // Per-model failure: fail closed. A silent skip would let the
             // dispatcher spawn agents on a model whose quota we can't see —
-            // the exact bug a usage gate is supposed to prevent. Log the
-            // failure so operators can fix the underlying CLI, and return
-            // a fully-exhausted snapshot so the dispatcher gates the model.
-            log(`Usage check failed for ${model} (treating as exhausted): ${errorMessage(error)}`);
+            // the exact bug a usage gate is supposed to prevent. Record the
+            // failure (debug-tier — always in the log file, console under
+            // --verbose) so operators can fix the underlying CLI, and return a
+            // fully-exhausted snapshot so the dispatcher gates the model. The
+            // gate itself surfaces a visible skip line via formatUsageExhaustion.
+            debug(`Usage check failed for ${model} (treating as exhausted): ${errorMessage(error)}`);
             out[model] = EXHAUSTED_USAGE;
         }
     }

package/dist/lib/util.d.ts

@@ -1,9 +1,22 @@
 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 setVerbose(value: boolean): void;
+export declare function isVerbose(): boolean;
+export declare function okMark(): string;
+export declare function failMark(): string;
+export declare function styleWarning(text: string): string;
+export declare function styleDim(text: string): string;
 export declare function setLogFile(path: string | undefined): void;
 export declare function withLogOutputSuppressed<T>(operation: () => Promise<T>): Promise<T>;
+/** Important tier: always on the console (dimmed timestamp) and the log file. */
 export declare function log(message: string): void;
+/**
+ * Diagnostic tier: always tee'd to the log file, but echoed to the console only
+ * under --verbose. Use for mechanics (git porcelain brackets, adapter probe
+ * failures, "loaded config") that an operator rarely needs while watching.
+ */
+export declare function debug(message: string): void;
 type LogEventFieldValue = boolean | number | string | readonly string[] | undefined;
 export declare function logEvent(event: string, fields: Record<string, LogEventFieldValue>): void;
 export declare function readEnvironmentVariable(name: string): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAGA,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;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAcvF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"AAIA,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,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAWD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;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;AAuBD,iFAAiF;AACjF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOzC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS3C;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,CAiBxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAcvF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}

package/dist/lib/util.js

@@ -1,5 +1,6 @@
 import { appendFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
+import { styleText } from "node:util";
 export async function sleep(ms, signal) {
     if (signal?.aborted === true) {
         return;
@@ -30,6 +31,32 @@ export function writeError(message) {
     // oxlint-disable-next-line no-console -- Centralized CLI stderr writer.
     console.error(message);
 }
+// Gates whether the diagnostic tier — debug() and logEvent() — is echoed to the
+// console. Both tiers always tee to the log file regardless of this flag, so the
+// full stream is never lost. The CLI arms this from `--verbose` /
+// GROUNDCREW_VERBOSE before dispatching a command.
+let verboseConsole = false;
+export function setVerbose(value) {
+    verboseConsole = value;
+}
+export function isVerbose() {
+    return verboseConsole;
+}
+function paint(format, text) {
+    return styleText(format, text, { stream: process.stdout });
+}
+export function okMark() {
+    return paint("green", "✓");
+}
+export function failMark() {
+    return paint("red", "✗");
+}
+export function styleWarning(text) {
+    return paint("yellow", text);
+}
+export function styleDim(text) {
+    return paint("dim", text);
+}
 // Module-scoped sink for tee-ing log()/logEvent() to disk. Unset by default
 // so tests don't write to the host filesystem; the CLI arms it after
 // loadConfig() resolves `logging.file`.
@@ -63,14 +90,33 @@ function appendLogLine(line) {
         writeError(`groundcrew: disabling file logging — could not write to ${broken}`);
     }
 }
+function timestamped(message) {
+    const timestamp = new Date().toLocaleTimeString();
+    return { plain: `[${timestamp}] ${message}`, timestamp };
+}
+/** Important tier: always on the console (dimmed timestamp) and the log file. */
 export function log(message) {
     if (suppressedLogDepth > 0) {
         return;
     }
-    const timestamp = new Date().toLocaleTimeString();
-    const line = `[${timestamp}] ${message}`;
-    writeOutput(line);
-    appendLogLine(line);
+    const { plain, timestamp } = timestamped(message);
+    writeOutput(`${styleDim(`[${timestamp}]`)} ${message}`);
+    appendLogLine(plain);
+}
+/**
+ * Diagnostic tier: always tee'd to the log file, but echoed to the console only
+ * under --verbose. Use for mechanics (git porcelain brackets, adapter probe
+ * failures, "loaded config") that an operator rarely needs while watching.
+ */
+export function debug(message) {
+    if (suppressedLogDepth > 0) {
+        return;
+    }
+    const { plain } = timestamped(message);
+    if (verboseConsole) {
+        writeOutput(styleDim(plain));
+    }
+    appendLogLine(plain);
 }
 function formatLogEventFieldValue(value) {
     const raw = Array.isArray(value) ? value.join(",") : String(value);
@@ -91,7 +137,10 @@ export function logEvent(event, fields) {
         parts.push(`${key}=${formatLogEventFieldValue(value)}`);
     }
     const line = parts.join(" ");
-    writeOutput(line);
+    // Structured telemetry is diagnostic: file always, console only under --verbose.
+    if (verboseConsole) {
+        writeOutput(styleDim(line));
+    }
     appendLogLine(line);
 }
 export function readEnvironmentVariable(name) {

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

@@ -1 +1 @@
-{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAKlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AA8PD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAE7E;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAyBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}
+{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAmQD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAE7E;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAyBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}

package/dist/lib/worktrees.js

@@ -12,9 +12,8 @@ import { userInfo } from "node:os";
 import { isAbsolute, relative, resolve } from "node:path";
 import { runCommandAsync } from "./commandRunner.js";
 import { resolveDefaultBranch } from "./defaultBranch.js";
-import { errorMessage, log } from "./util.js";
+import { debug, errorMessage, isVerbose } from "./util.js";
 import { workspaces } from "./workspaces.js";
-const LONG_RUNNING_COMMAND_OPTIONS = { stdio: "inherit", timeoutMs: 0 };
 const WORKTREE_LIST_PREFIX = "worktree ";
 export class WorktreeAlreadyExistsError extends Error {
     dir;
@@ -72,23 +71,33 @@ function basePaths(config, repository, ticket) {
 function signalProperty(signal) {
     return signal === undefined ? {} : { signal };
 }
-function longRunningCommandOptions(signal) {
-    return signal === undefined
-        ? LONG_RUNNING_COMMAND_OPTIONS
-        : { ...LONG_RUNNING_COMMAND_OPTIONS, signal };
+/**
+ * Runs a long-running git command (fetch, worktree add/remove/prune) with no
+ * timeout. Under --verbose the git porcelain streams live to the terminal;
+ * otherwise it is captured and discarded on success — the bracketing debug()
+ * lines record what ran, and a failure still carries git's stderr via the
+ * thrown error (see normalizeCommandError in commandRunner.ts).
+ */
+async function runLongGitCommand(arguments_, signal) {
+    const signalOption = signal === undefined ? {} : { signal };
+    if (isVerbose()) {
+        await runCommandAsync("git", arguments_, { stdio: "inherit", timeoutMs: 0, ...signalOption });
+        return;
+    }
+    await runCommandAsync("git", arguments_, { stdio: "captured", timeoutMs: 0, ...signalOption });
 }
 async function deleteBranchBestEffort(arguments_) {
     try {
         await (arguments_.signal === undefined
             ? runCommandAsync(arguments_.cmd, arguments_.cmdArgs)
             : runCommandAsync(arguments_.cmd, arguments_.cmdArgs, { signal: arguments_.signal }));
-        log(`Deleted branch ${arguments_.branchName}`);
+        debug(`Deleted branch ${arguments_.branchName}`);
     }
     catch (error) {
         if (arguments_.signal?.aborted === true) {
             throw error;
         }
-        log(`Branch ${arguments_.branchName} cleanup skipped: ${errorMessage(error)}`);
+        debug(`Branch ${arguments_.branchName} cleanup skipped: ${errorMessage(error)}`);
     }
 }
 async function createWorktree(config, spec, signal) {
@@ -100,10 +109,10 @@ async function createWorktree(config, spec, signal) {
         ...signalProperty(signal),
     });
     const baseRef = `${config.git.remote}/${defaultBranch}`;
-    log(`Fetching ${baseRef} in ${spec.repository}...`);
-    await runCommandAsync("git", ["-C", base.repoDir, "fetch", config.git.remote, defaultBranch], longRunningCommandOptions(signal));
-    log(`Creating worktree ${spec.repository}-${spec.ticket} (branch ${base.branchName} from ${baseRef})...`);
-    await runCommandAsync("git", ["-C", base.repoDir, "worktree", "add", "-b", base.branchName, base.hostWorktreeDir, baseRef], longRunningCommandOptions(signal));
+    debug(`Fetching ${baseRef} in ${spec.repository}...`);
+    await runLongGitCommand(["-C", base.repoDir, "fetch", config.git.remote, defaultBranch], signal);
+    debug(`Creating worktree ${spec.repository}-${spec.ticket} (branch ${base.branchName} from ${baseRef})...`);
+    await runLongGitCommand(["-C", base.repoDir, "worktree", "add", "-b", base.branchName, base.hostWorktreeDir, baseRef], signal);
     return {
         repository: spec.repository,
         ticket: spec.ticket,
@@ -172,19 +181,20 @@ async function removeWorktree(config, entry, options) {
     const projectDir = resolve(config.workspace.projectDir);
     const repoDir = resolve(projectDir, entry.repository);
     if (existsSync(entry.dir)) {
-        log(`Removing worktree ${entry.dir}${options.force ? " (--force)" : ""}...`);
+        debug(`Removing worktree ${entry.dir}${options.force ? " (--force)" : ""}...`);
         const removeArguments = ["-C", repoDir, "worktree", "remove"];
         if (options.force) {
             removeArguments.push("--force");
         }
         removeArguments.push(entry.dir);
         try {
-            await runCommandAsync("git", removeArguments, longRunningCommandOptions(options.signal));
+            await runLongGitCommand(removeArguments, options.signal);
         }
         catch (error) {
-            // git's `fatal: ...` diagnostic goes to inherited stderr, so the
-            // captured error is just "Exit status: 128". Probe the worktree
-            // ourselves so the failure message names the condition — dirty
+            // Under --verbose git's `fatal: ...` streams to the terminal rather than
+            // the captured error, so the failure may surface as just "Exit status:
+            // 128". Probe the worktree ourselves so the failure message names the
+            // condition either way — dirty
             // (modified/untracked files, fixable with `crew cleanup --force`) or
             // orphan (directory exists on disk but is not registered with the
             // parent repo, fixable with `crew cleanup --force` when the path still
@@ -230,8 +240,8 @@ async function removeWorktree(config, entry, options) {
         }
     }
     else {
-        log(`Worktree directory ${entry.dir} not found, pruning stale refs...`);
-        await runCommandAsync("git", ["-C", repoDir, "worktree", "prune"], longRunningCommandOptions(options.signal));
+        debug(`Worktree directory ${entry.dir} not found, pruning stale refs...`);
+        await runLongGitCommand(["-C", repoDir, "worktree", "prune"], options.signal);
     }
     await deleteBranchBestEffort({
         cmd: "git",
@@ -318,7 +328,7 @@ function removeOrphanWorktreeDirectory(config, entry) {
     if (targetDir !== expectedDir || !isInsideDirectory(projectDir, targetDir)) {
         throw new Error(`Refusing to force-delete ${entry.dir}: expected groundcrew worktree path ${expectedDir}.`);
     }
-    log(`Removing orphaned worktree directory ${entry.dir} (--force)...`);
+    debug(`Removing orphaned worktree directory ${entry.dir} (--force)...`);
     rmSync(targetDir, { recursive: true, force: true });
 }
 function list(config) {

package/docs/commands.md

@@ -12,24 +12,24 @@ Status is informational only. Use `crew cleanup <TICKET>` to tear down stale wor
 <summary>Sample ticket status output</summary>
 
 ```text
-crew status HRD-442
+crew status ENG-123
 ===================
-ticket: hrd-442  in-progress  https://linear.app/example/issue/HRD-442
+ticket: eng-123  in-progress  https://linear.app/example/issue/ENG-123
 title: Multi-event extractor: year inference can produce date_start > date_end
 run: running; model=claude; updated=2026-05-26T00:01:00.000Z; resumes=0
 workspace: live
 
 Worktrees
 ---------
-- herds-social/herds host
-  branch: paul-hrd-442
-  dir: /dev/workspaces/herds-social/herds-hrd-442
+- acme/widgets host
+  branch: dev-eng-123
+  dir: /dev/workspaces/acme/widgets-eng-123
   git: dirty (0 modified, 1 untracked)
-  pr: https://github.com/herds-social/herds/pull/224 (open)
+  pr: https://github.com/acme/widgets/pull/224 (open)
 
 Recent logs
 -----------
-[10:15:30] Workspace "hrd-442" launched
+[10:15:30] Workspace "eng-123" launched
 ```
 
 </details>
@@ -45,8 +45,8 @@ Doctor's command introspection is intentionally shallow. It reports the resolved
 `crew start <TICKET>` launches one ticket immediately, bypassing orchestrator eligibility. Use it to dispatch a specific ticket on demand, including unlabeled tickets that `crew run` ignores.
 
 ```bash
-crew start HRD-442
-crew start HRD-442 --dry-run
+crew start ENG-123
+crew start ENG-123 --dry-run
 ```
 
 ## Stop
@@ -54,9 +54,9 @@ crew start HRD-442 --dry-run
 `crew stop <TICKET>` stops a live workspace pane while preserving the ticket worktree and branch. Use it when you need terminal capacity back, want to stop an agent going in the wrong direction, or need to inspect the diff before letting another agent continue.
 
 ```bash
-crew stop HRD-442 --reason "wrong implementation direction"
-crew status HRD-442
-crew resume HRD-442
+crew stop ENG-123 --reason "wrong implementation direction"
+crew status ENG-123
+crew resume ENG-123
 ```
 
 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",