@clipboard-health/groundcrew 3.1.2 → 3.1.4

package/README.md

@@ -71,7 +71,7 @@ Installs the `crew` binary. `@clipboard-health/clearance` is pulled in transitiv
 
    Or drop `crew.config.ts` at the root of any repo you run `crew` from — `crew` discovers it via cosmiconfig project-walk. Any of `crew.config.{ts,mjs,js,json}`, `.crewrc{,.json,.ts}`, `.config/crew.config.{ts,json}`, or `.config/crewrc{,.json}` work.
 
-   Set `linear.projectSlug` (paste the trailing slug of your Linear project URL, e.g. `ai-strategy-5152195762f3`), `workspace.projectDir`, and `workspace.knownRepositories`. Defaults cover everything else.
+   Set `linear.projects[].projectSlug` (paste the trailing slug of your Linear project URL, e.g. `ai-strategy-5152195762f3`), `workspace.projectDir`, and `workspace.knownRepositories`. Defaults cover everything else. To watch multiple projects from one `crew` instance, add more entries to `linear.projects`; they all share the same `orchestrator.maximumInProgress` budget.
 
    Then clone each repo before the first `crew run` — groundcrew creates per-ticket worktrees from these clones, it does not auto-clone:
 
@@ -163,11 +163,11 @@ Watch `${XDG_CACHE_HOME:-$HOME/.cache}/clearance/clearance.log` for `DENY` lines
 
 Three keys are required; everything else has a default.
 
-| Key                           | What                                                                       |
-| ----------------------------- | -------------------------------------------------------------------------- |
-| `linear.projectSlug`          | Trailing slug of the Linear project URL (e.g. `ai-strategy-5152195762f3`). |
-| `workspace.projectDir`        | Parent dir for cloned repos and sibling ticket worktrees.                  |
-| `workspace.knownRepositories` | Repos searched for in ticket descriptions to infer where work belongs.     |
+| Key                             | What                                                                                                      |
+| ------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `linear.projects[].projectSlug` | Trailing slug of each Linear project URL to watch (e.g. `ai-strategy-5152195762f3`). One or more entries. |
+| `workspace.projectDir`          | Parent dir for cloned repos and sibling ticket worktrees.                                                 |
+| `workspace.knownRepositories`   | Repos searched for in ticket descriptions to infer where work belongs.                                    |
 
 `crew` resolves config as: `GROUNDCREW_CONFIG` if set → project-walk from cwd (cosmiconfig: `crew.config.{ts,mjs,js,json}`, `.crewrc{,.json,.ts}`, `.config/crew.config.{ts,json}`, `.config/crewrc{,.json}`) → `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/crew.config.ts` (also accepts legacy `config.ts` for one release). The branch prefix (`<prefix>-<TICKET>`) is derived from `os.userInfo().username` — not configurable.
 
@@ -197,16 +197,17 @@ This keeps package defaults portable while letting your private config reference
 
 | Key                                     | Default             | What it does                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `linear.projectSlug`                    | **required**        | Linear project URL slug (e.g. `ai-strategy-5152195762f3`). The trailing 12-char hex `slugId` is what's matched against Linear's API; the leading name keeps `crew.config.ts` self-documenting and the lookup survives project renames.                                                                                                                                  |
-| `linear.statuses.todo`                  | `"Todo"`            | Status name picked up for new work.                                                                                                                                                                                                                                                                                                                                     |
-| `linear.statuses.inProgress`            | `"In Progress"`     | Status set after a workspace is provisioned; counts toward `maximumInProgress`.                                                                                                                                                                                                                                                                                         |
-| `linear.statuses.done`                  | `"Done"`            | Status that triggers worktree cleanup.                                                                                                                                                                                                                                                                                                                                  |
-| `linear.statuses.terminal`              | `["Done"]`          | Additional status names treated as terminal for cleanup, board remaining counts, and blocker checks. The `done` status is always included.                                                                                                                                                                                                                              |
+| `linear.projects`                       | **required**        | Non-empty array of Linear projects to watch. One `crew` instance dispatches across every entry under a shared `maximumInProgress` budget.                                                                                                                                                                                                                               |
+| `linear.projects[].projectSlug`         | **required**        | Linear project URL slug (e.g. `ai-strategy-5152195762f3`). The trailing 12-char hex `slugId` is what's matched against Linear's API; the leading name keeps `crew.config.ts` self-documenting and the lookup survives project renames.                                                                                                                                  |
+| `linear.projects[].statuses.todo`       | `"Todo"`            | Status name picked up for new work in this project. Per-project so multi-team setups with divergent state names can coexist.                                                                                                                                                                                                                                            |
+| `linear.projects[].statuses.inProgress` | `"In Progress"`     | Status set after a workspace is provisioned; counts toward the shared `maximumInProgress`.                                                                                                                                                                                                                                                                              |
+| `linear.projects[].statuses.done`       | `"Done"`            | Status that triggers worktree cleanup for this project.                                                                                                                                                                                                                                                                                                                 |
+| `linear.projects[].statuses.terminal`   | `["Done"]`          | Additional status names treated as terminal for cleanup and blocker checks. The project's `done` status is always included.                                                                                                                                                                                                                                             |
 | `git.remote`                            | `"origin"`          | Remote used for `fetch` and as the worktree base ref.                                                                                                                                                                                                                                                                                                                   |
 | `git.defaultBranch`                     | `"main"`            | Branch fetched from `git.remote` and used as the worktree base.                                                                                                                                                                                                                                                                                                         |
 | `workspace.projectDir`                  | **required**        | Parent dir for cloned repos and sibling ticket worktrees.                                                                                                                                                                                                                                                                                                               |
 | `workspace.knownRepositories`           | **required**        | Repos searched for in ticket descriptions to infer where work belongs. A ticket labeled for groundcrew (`agent-*`) fails fast when no known repo appears; unlabeled tickets are ignored.                                                                                                                                                                                |
-| `orchestrator.maximumInProgress`        | `4`                 | Cap on tickets in `linear.statuses.inProgress` at once.                                                                                                                                                                                                                                                                                                                 |
+| `orchestrator.maximumInProgress`        | `4`                 | Cap on in-progress tickets at once, shared across every project in `linear.projects`.                                                                                                                                                                                                                                                                                   |
 | `orchestrator.pollIntervalMilliseconds` | `120_000`           | Poll interval in `--watch` mode.                                                                                                                                                                                                                                                                                                                                        |
 | `orchestrator.sessionLimitPercentage`   | `85`                | Number in `(0, 100]`. A model whose codexbar session window exceeds this percentage is skipped that tick.                                                                                                                                                                                                                                                               |
 | `models.default`                        | `"claude"`          | Tiebreak for `agent-any` resolution and fallback for explicit but unknown `agent-*` labels. Also used by `crew run --ticket <TICKET>` for unlabeled tickets. `crew run` without `--ticket` ignores unlabeled tickets and does not apply this default. Must exist in `models.definitions`.                                                                               |
@@ -316,14 +317,16 @@ crew run                                                 # one-shot dispatch
 crew run --watch                                         # poll forever
 crew run --ticket <TICKET>                               # provision one ticket and exit
 crew setup repos [--dry-run] [<repo>...]
+crew interrupt <TICKET> [--reason <text>]                # stop the live workspace, keep the worktree
+crew resume <TICKET>                                     # reopen an existing ticket worktree
 crew cleanup <TICKET>                                    # tear down every worktree carrying this ticket
 ```
 
-`crew doctor --ticket <TICKET>` covers the full per-ticket lifecycle: pre-dispatch eligibility (Todo status, `agent-*` label, model resolution, repository mention, local clone, blockers, model session usage, in-progress capacity) **and** post-dispatch local-state recovery (host worktree, workspace pane, local branch, remote branch, open PR). Verdict precedence runs from post-dispatch outcomes down: `pr-open` > `pr-merged` > `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. To inspect codexbar session windows directly, run `codexbar usage`.
+`crew doctor --ticket <TICKET>` covers the full per-ticket lifecycle: pre-dispatch eligibility (Todo status, `agent-*` label, model resolution, repository mention, local clone, blockers, model session usage, in-progress capacity) **and** post-dispatch local-state recovery (recorded run state, host worktree, workspace pane, local branch, remote branch, open PR). Verdict precedence starts with PR outcomes (`pr-open` > `pr-merged`). Recorded failed launches report before ordinary local recovery, interrupted runs report concrete recoverable git work first when it exists and otherwise report `interrupted`, and ordinary post-dispatch cases report `in-flight` before `recoverable`. If none of those apply, doctor falls through to `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. To inspect codexbar session windows directly, run `codexbar usage`.
 
 ### `crew doctor --ticket <ticket>`
 
-Diagnose where a ticket is in its lifecycle and what to do next. Runs the same resolution and eligibility chain as the dispatcher, plus probes the host worktree, workspace pane, local branch, remote branch, and PR; prints a single verdict with a copy-pasteable recovery step when one applies.
+Diagnose where a ticket is in its lifecycle and what to do next. Runs the same resolution and eligibility chain as the dispatcher, plus probes recorded run state, host worktree, workspace pane, local branch, remote branch, and PR; prints a single verdict with a copy-pasteable recovery step when one applies.
 
 Flags:
 
@@ -344,6 +347,13 @@ Resolution
 Eligibility
   (skipped — post-dispatch — pre-dispatch checks are irrelevant)
 
+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)
+
 Worktree
   [ok] Host worktree exists (/Users/paul/dev/groundcrew-workspaces/herds-social/herds-hrd-442)
   [--] Working tree clean (0 modified, 1 untracked)
@@ -374,11 +384,31 @@ The verdict on the last line maps to a recovery action:
 | `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 interrupt <ticket>`
+
+Stop a live workspace pane while preserving the ticket worktree and branch. This is the manual pause button for cases where you need terminal capacity back, want to stop an agent that is going in the wrong direction, or need to inspect the diff before letting another agent continue.
+
+```bash
+crew interrupt HRD-442 --reason "wrong implementation direction"
+crew doctor --ticket HRD-442
+crew resume HRD-442
+```
+
+The command closes the cmux/tmux workspace when it exists, records local run state under the groundcrew state directory, 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.
+
+### `crew resume <ticket>`
+
+Reopen an existing ticket worktree with a continuation prompt. Resume never creates a new worktree; if none exists, it fails and leaves re-dispatch to `crew run --ticket <ticket>`.
+
+The resume prompt tells the agent to inspect current git status and diff before editing, includes the previous interrupt reason when recorded, and reuses the recorded model, repository, branch, runner, sandbox, and workspace backend. When no run-state file exists but a worktree does, resume falls back to Linear resolution for the model and ticket context.
+
 ## 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.
@@ -414,7 +444,7 @@ When a wrapped agent command fails (e.g. `safehouse-clearance` not found, `npm i
 <details>
 <summary>Status names matter</summary>
 
-If your team uses `Started` instead of `In Progress`, set `linear.statuses.inProgress = "Started"`.
+If your team uses `Started` instead of `In Progress`, set `linear.projects[].statuses.inProgress = "Started"` on that project's entry. Status overrides are per-project so divergent team workflows coexist.
 
 </details>
 
@@ -433,9 +463,9 @@ Groundcrew sets a ticket to `inProgress` when it provisions a workspace and neve
 </details>
 
 <details>
-<summary>Project must be on a single Linear team in practice</summary>
+<summary>Cross-team projects need a consistent `inProgress` name per project</summary>
 
-Cross-team projects work — the orchestrator caches the in-progress state ID per team — but every team in the project must use the same status name for `linear.statuses.inProgress`.
+Cross-team projects work — the orchestrator caches the in-progress state ID per `(team, statusName)` pair — but every team in a given project must use the same status name for that project's `statuses.inProgress`. If you watch two projects that share a Linear team but configure different `inProgress` names, each project's lookup is independent.
 
 </details>
 

package/crew.config.example.ts

@@ -3,16 +3,30 @@ import type { Config } from "./src/lib/config.js";
 
 export default {
   linear: {
-    // Project URL slug to scope polling. Copy the trailing segment of
-    // your Linear project URL —
-    //   https://linear.app/<workspace>/project/<projectSlug>
-    // — verbatim, for example "ai-strategy-5152195762f3". The 12-char hex
-    // tail is the canonical ID groundcrew uses, so the orchestrator stays
-    // resilient across project renames and across same-name projects in
-    // different teams. The leading name segment keeps the file
-    // self-documenting at a glance.
-    projectSlug: "your-project-name-0123456789ab",
-    // statuses: { todo: "Todo", inProgress: "In Progress", done: "Done", terminal: ["Done"] },
+    // One or more Linear projects to watch. A single `crew` process
+    // dispatches across all configured projects under a shared
+    // `orchestrator.maximumInProgress` budget.
+    //
+    // Each entry's `projectSlug` is the trailing segment of your Linear
+    // project URL — copy it verbatim, e.g. "ai-strategy-5152195762f3"
+    // from "https://linear.app/<workspace>/project/ai-strategy-5152195762f3".
+    // The 12-char hex tail is the canonical ID groundcrew uses, so the
+    // orchestrator stays resilient across project renames and across
+    // same-name projects in different teams. The leading name segment
+    // keeps the file self-documenting at a glance.
+    //
+    // `statuses` is per-project so multi-team setups with divergent
+    // workflow state names (e.g. "Todo" vs "To Do", "Shipped" vs
+    // "Done") can coexist. Each field falls back to its default when
+    // omitted: { todo: "Todo", inProgress: "In Progress",
+    // done: "Done", terminal: ["Done"] }.
+    projects: [
+      { projectSlug: "your-project-name-0123456789ab" },
+      // {
+      //   projectSlug: "platform-aaaaaaaaaaaa",
+      //   statuses: { inProgress: "Doing", done: "Released", terminal: ["Released", "Won't Do"] },
+      // },
+    ],
   },
   workspace: {
     // Parent directory under which groundcrew clones repositories and
@@ -29,6 +43,7 @@ export default {
   // git: { remote: "origin", defaultBranch: "main" },
   //
   // orchestrator: {
+  //   // Shared across all watched projects in linear.projects.
   //   maximumInProgress: 4,
   //   pollIntervalMilliseconds: 120_000,
   //   sessionLimitPercentage: 85,

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,7 +1,9 @@
 import { createRequire } from "node:module";
 import { cleanupWorkspaceCli } from "./commands/cleanupWorkspace.js";
 import { doctor } from "./commands/doctor.js";
+import { interruptWorkspaceCli } from "./commands/interruptWorkspace.js";
 import { orchestrate } from "./commands/orchestrator.js";
+import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
 import { setupReposCli } from "./commands/setupRepos.js";
 import { setupWorkspaceCli } from "./commands/setupWorkspace.js";
 import { errorMessage, readTicketArgument, writeError, writeOutput } from "./lib/util.js";
@@ -90,6 +92,16 @@ const SUBCOMMANDS = {
         usage: "[--force] <ticket>",
         invoke: cleanupWorkspaceCli,
     },
+    interrupt: {
+        summary: "Stop a live ticket workspace while preserving its worktree",
+        usage: "<ticket> [--reason <text>]",
+        invoke: interruptWorkspaceCli,
+    },
+    resume: {
+        summary: "Reopen an existing ticket worktree with a continuation prompt",
+        usage: "<ticket>",
+        invoke: resumeWorkspaceCli,
+    },
     setup: {
         summary: "Project-level setup commands (currently: repos)",
         usage: "repos [--dry-run] [<repo>...]",

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

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

package/dist/commands/cleaner.js

@@ -3,7 +3,8 @@
  * tickets that have reached a terminal status. One per `orchestrate()`
  * invocation; stateless across iterations. Mirrors `Dispatcher`.
  */
-import { isTerminalStatus } from "../lib/boardSource.js";
+import { isTerminalStatusForIssue } from "../lib/boardSource.js";
+import { recordCleanedUpRuns } from "../lib/runStateCleanup.js";
 import { log, logEvent } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { logTeardown, recordTeardownEvents } from "./teardownReporter.js";
@@ -11,10 +12,10 @@ export function createCleaner(deps) {
     const { config } = deps;
     async function runOnce(arguments_) {
         const { state, worktreeEntries, dryRun, signal } = arguments_;
-        // Only act on tickets in this project — if the dir name happens to look
-        // like a Linear ticket from another project, leave it alone.
+        // Only act on tickets in configured projects — if the dir name happens to
+        // look like a Linear ticket from another project, leave it alone.
         const terminalTickets = new Set(state.issues
-            .filter((issue) => isTerminalStatus(issue.status, config))
+            .filter((issue) => isTerminalStatusForIssue(issue, config))
             .map((issue) => issue.id));
         if (terminalTickets.size === 0) {
             return;
@@ -41,6 +42,7 @@ export function createCleaner(deps) {
         const result = signal === undefined
             ? await worktrees.teardown(config, stale)
             : await worktrees.teardown(config, stale, { signal });
+        recordCleanedUpRuns(config, result.removed);
         logTeardown(result);
         recordTeardownEvents(result);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"cleanupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/cleanupWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwBD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}
+{"version":3,"file":"cleanupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/cleanupWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwBD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/commands/cleanupWorkspace.js

@@ -1,4 +1,5 @@
 import { loadConfig } from "../lib/config.js";
+import { recordCleanedUpRuns } from "../lib/runStateCleanup.js";
 import { log } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { logTeardown } from "./teardownReporter.js";
@@ -29,6 +30,7 @@ export async function cleanupWorkspace(config, options) {
         return;
     }
     const result = await worktrees.teardown(config, entries, { force });
+    recordCleanedUpRuns(config, result.removed);
     logTeardown(result);
     if (result.failures.length > 0) {
         throw result.failures[0]?.error;

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

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

package/dist/commands/dispatcher.js

@@ -6,7 +6,7 @@
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
  * for telemetry, Linear writes, and side-effecting setupWorkspace calls.
  */
-import { isGroundcrewIssue } from "../lib/boardSource.js";
+import { isGroundcrewIssue, projectFor, } from "../lib/boardSource.js";
 import { createLinearIssueStatusUpdater } from "../lib/linearIssueStatus.js";
 import { errorMessage, log, logEvent } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
@@ -87,17 +87,17 @@ export function createDispatcher(deps) {
     async function runOnce(arguments_) {
         const { state, worktreeEntries, usage, dryRun, signal } = arguments_;
         issueStatusUpdater.resetMissingInProgressCache();
-        const activeCount = state.issues.filter((issue) => issue.status === config.linear.statuses.inProgress).length;
+        const activeCount = state.issues.filter((issue) => issue.status === projectFor(issue, config).statuses.inProgress).length;
         const slots = config.orchestrator.maximumInProgress - activeCount;
         // Narrow Todo to tickets that opted in via an `agent-*` label.
         // Unlabeled tickets are not groundcrew's concern even when in Todo.
-        const todo = state.issues.filter((issue) => issue.status === config.linear.statuses.todo && isGroundcrewIssue(issue));
+        const todo = state.issues.filter((issue) => issue.status === projectFor(issue, config).statuses.todo && isGroundcrewIssue(issue));
         if (slots <= 0) {
             log(`At capacity (${activeCount}/${config.orchestrator.maximumInProgress}), no new work to start`);
             return;
         }
         if (todo.length === 0) {
-            log(`No ${config.linear.statuses.todo} tickets to pick up`);
+            log(`No Todo tickets to pick up`);
             return;
         }
         // Run the blocker pre-pass first so an all-blocked board short-circuits
@@ -107,7 +107,7 @@ export function createDispatcher(deps) {
             logSkip(skip);
         }
         if (unblocked.length === 0) {
-            log(`No eligible ${config.linear.statuses.todo} tickets after blocker filtering`);
+            log(`No eligible Todo tickets after blocker filtering`);
             return;
         }
         // usage() is an HTTP call; workspaces.probe shells tmux/cmux. Kick off
@@ -146,7 +146,7 @@ export function createDispatcher(deps) {
             logSkip(skip);
         }
         if (starts.length === 0) {
-            log(`No eligible ${config.linear.statuses.todo} tickets after eligibility filtering`);
+            log(`No eligible Todo tickets after eligibility filtering`);
             return;
         }
         log(`${slots} slot(s) available, starting ${starts.length} ticket(s): ${starts.map(({ issue }) => `${issue.id}(${issue.model})`).join(", ")}`);

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

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

package/dist/commands/eligibility.js

@@ -6,7 +6,7 @@
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
-import { isTerminalStatus } from "../lib/boardSource.js";
+import { isTerminalStatusForBlocker, } from "../lib/boardSource.js";
 import { AGENT_ANY_MODEL } from "../lib/config.js";
 const PERCENT_FRACTION_DIVISOR = 100;
 const DAYS_PER_WEEK = 7;
@@ -26,7 +26,7 @@ function blockerVerdictFor(issue, config) {
             blockers,
         };
     }
-    const unresolved = issue.blockers.filter((blocker) => blocker.status === undefined || !isTerminalStatus(blocker.status, config));
+    const unresolved = issue.blockers.filter((blocker) => !isTerminalStatusForBlocker(blocker, config));
     if (unresolved.length === 0) {
         return undefined;
     }

package/dist/commands/interruptWorkspace.d.ts

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

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

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

package/dist/commands/interruptWorkspace.js

@@ -0,0 +1,108 @@
+import { loadConfig } from "../lib/config.js";
+import { readRunState, recordRunState } from "../lib/runState.js";
+import { errorMessage, log } from "../lib/util.js";
+import { workspaces } from "../lib/workspaces.js";
+import { worktrees } from "../lib/worktrees.js";
+function parseArguments(argv) {
+    let reason;
+    const positionals = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        /* v8 ignore next @preserve -- loop bounds ensure argv[index] exists; guard satisfies noUncheckedIndexedAccess */
+        if (argument === undefined) {
+            continue;
+        }
+        if (argument === "--reason") {
+            const value = argv[index + 1];
+            if (value === undefined || value.length === 0 || value.startsWith("-")) {
+                throw new Error("crew interrupt --reason: reason text is required");
+            }
+            reason = value;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith("-")) {
+            throw new Error(`Unknown option: ${argument}\nUsage: crew interrupt <ticket> [--reason <text>]`);
+        }
+        positionals.push(argument);
+    }
+    const [ticket, ...extras] = positionals;
+    if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
+        throw new Error("Usage: crew interrupt <ticket> [--reason <text>]");
+    }
+    return { ticket: ticket.toLowerCase(), ...(reason === undefined ? {} : { reason }) };
+}
+function sourceFromState(state) {
+    return {
+        ticket: state.ticket,
+        repository: state.repository,
+        model: state.model,
+        worktreeDir: state.worktreeDir,
+        branchName: state.branchName,
+        workspaceName: state.workspaceName,
+        resumeCount: state.resumeCount,
+    };
+}
+function sourceFromWorktree(config, ticket, entry) {
+    return {
+        ticket,
+        repository: entry.repository,
+        model: config.models.default,
+        worktreeDir: entry.dir,
+        branchName: entry.branchName,
+        workspaceName: ticket,
+        resumeCount: 0,
+    };
+}
+function resolveInterruptSource(arguments_) {
+    if (arguments_.state !== undefined) {
+        return sourceFromState(arguments_.state);
+    }
+    if (arguments_.entry !== undefined) {
+        return sourceFromWorktree(arguments_.config, arguments_.ticket, arguments_.entry);
+    }
+    throw new Error(`No run state or worktree found for ${arguments_.ticket}; nothing to interrupt.`);
+}
+function interruptDetail(result) {
+    if (result.kind === "missing") {
+        return "workspace missing";
+    }
+    return undefined;
+}
+function failOnUnavailable(result) {
+    if (result.kind !== "unavailable") {
+        return;
+    }
+    const detail = result.error === undefined ? "workspace adapter unavailable" : errorMessage(result.error);
+    throw new Error(`Could not interrupt workspace: ${detail}`);
+}
+export async function interruptWorkspace(config, options) {
+    const ticket = options.ticket.toLowerCase();
+    const state = readRunState(config, ticket);
+    const [entry] = worktrees.findByTicket(config, ticket);
+    const source = resolveInterruptSource({ config, ticket, state, entry });
+    const result = await workspaces.interrupt(config, source.workspaceName);
+    failOnUnavailable(result);
+    const detail = interruptDetail(result);
+    recordRunState({
+        config,
+        state: {
+            ticket,
+            repository: source.repository,
+            model: source.model,
+            worktreeDir: source.worktreeDir,
+            branchName: source.branchName,
+            workspaceName: source.workspaceName,
+            state: "interrupted",
+            resumeCount: source.resumeCount,
+            ...(options.reason === undefined ? {} : { reason: options.reason }),
+            ...(detail === undefined ? {} : { detail }),
+        },
+    });
+    log(`Interrupted ${ticket}; worktree preserved at ${source.worktreeDir}`);
+    log(`Next: crew doctor --ticket ${ticket}`);
+}
+export async function interruptWorkspaceCli(argv) {
+    const config = await loadConfig();
+    await interruptWorkspace(config, parseArguments(argv));
+}

package/dist/commands/orchestrator.d.ts

@@ -1,6 +1,8 @@
 /**
- * groundcrew orchestrator — polls a Linear project and spins up
- * workspace + git-worktree pairs for ready tickets.
+ * groundcrew orchestrator — polls Linear projects and spins up workspace +
+ * git-worktree pairs for ready tickets. Each tick fetches the board, runs
+ * the cleaner, and runs the dispatcher; logging from those modules is the
+ * orchestrator's user-facing output.
  */
 export interface OrchestratorOptions {
     watch: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4LH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC7E"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2DH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7E"}