@clipboard-health/groundcrew 4.18.1 → 4.19.0

package/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  Dispatch your ticket backlog to local, interactive AI coding agents. One git worktree per ticket, sandboxed by default.
+  Dispatch your task backlog to local, interactive AI coding agents. One git worktree per task, sandboxed by default.
 </p>
 
 <p align="center">
@@ -17,18 +17,18 @@
 </p>
 
 <p align="center">
-  <a href="./static/demo.tape"><img alt="Groundcrew dispatching tickets into tmux panes with coding agents running in parallel" src="./static/demo.gif" width="800"></a>
+  <a href="./static/demo.tape"><img alt="Groundcrew dispatching tasks into tmux panes with coding agents running in parallel" src="./static/demo.gif" width="800"></a>
 </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)_.
+Groundcrew watches assigned tasks, creates isolated worktrees, launches agent CLIs in dedicated terminals, and leaves each task's work on its own PR-ready branch. For the backstory, read _[Tasks to pull requests while you sleep](https://www.clipboardworks.com/resources/blog/tasks-to-pull-requests-while-you-sleep)_.
 
 ## Why
 
 - **Local.** Agents run on your machine with your tools, shell, and credentials. That makes them more steerable than remote agents, and easy to nudge when they drift.
-- **Interactive.** Each ticket launches the real `claude` or `codex` CLI in its own terminal pane, not a wrapper that approximates it. Watch any session live and take over when you need to.
-- **One worktree per ticket.** Agents work in parallel without stepping on each other.
+- **Interactive.** Each task launches the real `claude` or `codex` CLI in its own terminal pane, not a wrapper that approximates it. Watch any session live and take over when you need to.
+- **One worktree per task.** Agents work in parallel without stepping on each other.
 - **Sandboxed by default.** Safehouse or Docker Sandboxes isolate each agent on the host; `none` is an explicit escape hatch.
-- **Pluggable ticket sources.** Linear by default; Jira and local files via [ticket sources](./docs/ticket-sources.md).
+- **Pluggable task sources.** Linear by default; Jira and local files via [task sources](./docs/task-sources.md).
 - **Multi-agent routing.** Ships `claude` and `codex` presets; bring your own CLI in config.
 
 ## Prerequisites
@@ -56,7 +56,7 @@ crew init --global --project-dir ~/dev --repo OWNER/REPO --model claude
 # 4. Set the clearance egress proxy allowlist.
 export CLEARANCE_ALLOW_HOSTS_FILES="$(npm root -g)/@clipboard-health/groundcrew/clearance-allow-hosts"
 
-# 5. Using Linear? Export your API key. (Jira and other trackers: see Ticket Pickup.)
+# 5. Using Linear? Export your API key. (Jira and other trackers: see Task Pickup.)
 export GROUNDCREW_LINEAR_API_KEY="lin_api_..."
 
 # 6. Verify setup, then dispatch.
@@ -66,25 +66,25 @@ crew run --watch
 
 `crew init --global` writes config to `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/`. Pass `--repo` more than once for multiple repos. `--model claude` or `--model codex` chooses the single built-in model preset to enable in the generated config.
 
-## Ticket Pickup
+## Task Pickup
 
-**Not on Linear?** Use Jira or local files via [ticket sources](./docs/ticket-sources.md).
+**Not on Linear?** Use Jira or local files via [task sources](./docs/task-sources.md).
 
-Linear works out of the box: assign tickets to yourself and add an `agent-*` label.
+Linear works out of the box: assign tasks 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 session headroom, after skipping models over their session limit or weekly paced budget.
-- Tickets without an `agent-*` label are ignored by `crew run`; dispatch one manually with `crew start <TICKET>`.
+- Tasks without an `agent-*` label are ignored by `crew run`; dispatch one manually with `crew start <TASK>`.
 
-Groundcrew scans `workspace.knownRepositories` to infer which repo a ticket belongs to.
+Groundcrew scans `workspace.knownRepositories` to infer which repo a task belongs to.
 
-A ticket blocked by non-terminal blockers is skipped until those blockers are done.
+A task blocked by non-terminal blockers is skipped until those blockers are done.
 
-### The ticket description is the prompt
+### The task description is the prompt
 
-Groundcrew sends each agent a generic unattended-execution prompt plus the ticket title and description. The prompt says how to work: read the repo instructions, make the smallest sensible change, verify it, and produce the requested output. The ticket description says what to do.
+Groundcrew sends each agent a generic unattended-execution prompt plus the task title and description. The prompt says how to work: read the repo instructions, make the smallest sensible change, verify it, and produce the requested output. The task description says what to do.
 
-Write tickets as complete agent instructions: the goal, the context and constraints, links to logs or screenshots, how to verify, and the output you want. A vague ticket gets a vague PR.
+Write tasks as complete agent instructions: the goal, the context and constraints, links to logs or screenshots, how to verify, and the output you want. A vague task gets a vague PR.
 
 ## Commands
 
@@ -93,12 +93,12 @@ crew init [--global | --local] [--force] [--dry-run]     # create a crew.config.
           [--project-dir <dir>] [--repo <repo>]...
           [--runner <auto|safehouse|sdx|none>] [--model <claude|codex>]
 crew doctor                                              # check setup
-crew status [<TICKET>]                                   # inspect current state or one ticket
+crew status [<TASK>]                                   # inspect current state or one task
 crew run [--watch]                                       # one-shot or --watch forever
-crew start <TICKET>                                      # provision + launch one ticket now
-crew stop <TICKET> [--reason <text>]                     # stop workspace, keep worktree
-crew resume <TICKET>                                     # reopen a paused ticket
-crew cleanup <TICKET>                                    # tear down every worktree for a ticket
+crew start <TASK>                                      # provision + launch one task now
+crew stop <TASK> [--reason <text>]                     # stop workspace, keep worktree
+crew resume <TASK>                                     # reopen a paused task
+crew cleanup <TASK>                                    # tear down every worktree for a task
 crew upgrade [<version>]                                 # reinstall crew globally through npm
 ```
 
@@ -147,7 +147,7 @@ There is no `linear` config block. Groundcrew reads `GROUNDCREW_LINEAR_API_KEY`
 - [Runners](./docs/runners.md): Safehouse, Docker Sandboxes, and the `none` escape hatch.
 - [Credentials](./docs/credentials.md): Linear API keys, 1Password, build secrets, and `preLaunch`.
 - [Prepare worktree hooks](./docs/setup-hooks.md): `.groundcrew/config.json` `hooks.prepareWorktree` for per-repo dependency setup.
-- [Ticket sources](./docs/ticket-sources.md): custom shell/Jira/local-plan adapters.
+- [Task sources](./docs/task-sources.md): custom shell/Jira/local-plan adapters.
 - [Troubleshooting](./docs/troubleshooting.md): common operational pitfalls and fixes.
 
 ## Development

package/crew.config.example.ts

@@ -10,18 +10,18 @@ export default {
   // `state.type` (`unstarted` → todo, `started` → in progress,
   // `completed`/`canceled`/`duplicate` → terminal).
   //
-  // Opt a ticket in: assign it to yourself and add an `agent-<model>`
+  // Opt a task in: assign it to yourself and add an `agent-<model>`
   // label (e.g. `agent-claude`, `agent-any`).
   workspace: {
     // Parent directory under which groundcrew clones repositories and (by
-    // default) creates per-ticket worktrees.
+    // default) creates per-task worktrees.
     projectDir: "~/dev/groundcrew",
     // Optional: collect ALL worktrees here instead of beside each repo. Useful
     // when your repos live in more than one place. Defaults to projectDir.
     // worktreeDir: "~/dev/worktrees",
     // Repositories groundcrew is allowed to set up worktrees in. Add
     // `<owner>/<repo>` or bare `<repo>` strings; the orchestrator scopes
-    // tickets to these and refuses unknown repos by default. Use the object
+    // tasks to these and refuses unknown repos by default. Use the object
     // form to point a repo at a different parent directory:
     //   { name: "other-org/other-repo", projectDirOverride: "~/work" }
     knownRepositories: ["your-org/your-repo"],
@@ -30,7 +30,7 @@ export default {
     default: "claude",
     // `definitions` is the enabled model set. Built-in keys can use `{}` to
     // opt into the shipped command/color/usage preset. Add `codex: {}` if you
-    // want both shipped agents, or add a custom entry and tag tickets with
+    // want both shipped agents, or add a custom entry and tag tasks with
     // `agent-<name>`.
     definitions: {
       claude: {},
@@ -53,7 +53,7 @@ export default {
   // Everything below is optional — defaults shown for reference. Uncomment
   // and edit to override.
   //
-  // // Additional pluggable ticket sources beyond the implicit built-in
+  // // Additional pluggable task sources beyond the implicit built-in
   // // Linear adapter. The most common use is `kind: "shell"`, which wires
   // // any external system via command templates that emit/consume JSON.
   // // See the shell adapter's ShellIssue schema for the JSON contract

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA+QA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCvD"}

package/dist/cli.js

@@ -6,9 +6,10 @@ import { interruptWorkspaceCli } from "./commands/interruptWorkspace.js";
 import { orchestrate } from "./commands/orchestrator.js";
 import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
 import { setupWorkspaceCli } from "./commands/setupWorkspace.js";
+import { sourceCli } from "./commands/source.js";
 import { statusCli } from "./commands/status.js";
 import { createDefaultUpgradeCliOptions, upgradeCli } from "./commands/upgrade.js";
-import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTicketArgument, setVerbose, writeError, writeOutput, } from "./lib/util.js";
+import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTaskArgument, 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.",
@@ -40,7 +41,7 @@ async function setupCli(argv) {
 async function runCli(argv) {
     let watch = false;
     let dryRun = false;
-    let ticket;
+    let task;
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index];
         if (argument === "--watch") {
@@ -51,31 +52,31 @@ async function runCli(argv) {
             dryRun = true;
             continue;
         }
-        if (argument === "--ticket") {
-            ticket = readTicketArgument(argv, index, "run");
+        if (argument === "--task") {
+            task = readTaskArgument(argv, index, "run");
             index += 1;
             continue;
         }
         throw new Error(`crew run: unknown argument: ${argument}`);
     }
-    if (ticket !== undefined && watch) {
-        throw new Error("crew run: --watch and --ticket are mutually exclusive");
+    if (task !== undefined && watch) {
+        throw new Error("crew run: --watch and --task are mutually exclusive");
     }
-    if (ticket === undefined) {
+    if (task === undefined) {
         await orchestrate({ watch, dryRun });
         return;
     }
-    warnDeprecated({ oldForm: "run --ticket", newForm: "start" });
-    await setupWorkspaceCli(ticket, { dryRun });
+    warnDeprecated({ oldForm: "run --task", newForm: "start" });
+    await setupWorkspaceCli(task, { dryRun });
 }
-const START_USAGE = "crew start <ticket> [--dry-run]";
+const START_USAGE = "crew start <task> [--dry-run]";
 async function startCli(argv) {
     const { dryRun, positionals } = parseDryRunPositionals(argv, START_USAGE);
-    const [ticket, ...extras] = positionals;
-    if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
+    const [task, ...extras] = positionals;
+    if (task === undefined || task.length === 0 || extras.length > 0) {
         throw new Error(`Usage: ${START_USAGE}`);
     }
-    await setupWorkspaceCli(ticket, { dryRun });
+    await setupWorkspaceCli(task, { dryRun });
 }
 async function upgradeCliInvoke(argv) {
     const metadata = packageMetadata();
@@ -84,21 +85,21 @@ async function upgradeCliInvoke(argv) {
         cliMetaUrl: import.meta.url,
     }));
 }
-function doctorTicketAlias(argv) {
-    if (argv[0] !== "--ticket") {
+function doctorTaskAlias(argv) {
+    if (argv[0] !== "--task") {
         return undefined;
     }
-    const ticket = readTicketArgument(argv, 0, "doctor");
+    const task = readTaskArgument(argv, 0, "doctor");
     if (argv.length > 2) {
-        throw new Error("Usage: crew status [<ticket>]");
+        throw new Error("Usage: crew status [<task>]");
     }
-    return ticket;
+    return task;
 }
 async function doctorCli(argv) {
-    const aliasTicket = doctorTicketAlias(argv);
-    if (aliasTicket !== undefined) {
-        warnDeprecated({ oldForm: "doctor --ticket", newForm: "status" });
-        await statusCli([aliasTicket]);
+    const aliasTask = doctorTaskAlias(argv);
+    if (aliasTask !== undefined) {
+        warnDeprecated({ oldForm: "doctor --task", newForm: "status" });
+        await statusCli([aliasTask]);
         return;
     }
     if (argv.length > 0) {
@@ -114,13 +115,13 @@ const SUBCOMMANDS = {
         invoke: initConfigCli,
     },
     run: {
-        summary: "Run the orchestrator: poll sources and start eligible tickets (one-shot by default)",
+        summary: "Run the orchestrator: poll sources and start eligible tasks (one-shot by default)",
         usage: "[--watch] [--dry-run]",
         invoke: runCli,
     },
     start: {
-        summary: "Launch one ticket immediately, bypassing eligibility",
-        usage: "<ticket> [--dry-run]",
+        summary: "Launch one task immediately, bypassing eligibility",
+        usage: "<task> [--dry-run]",
         invoke: startCli,
     },
     doctor: {
@@ -128,24 +129,29 @@ const SUBCOMMANDS = {
         usage: "",
         invoke: doctorCli,
     },
+    source: {
+        summary: "Inspect configured task sources",
+        usage: "<list|verify> [...]",
+        invoke: sourceCli,
+    },
     status: {
-        summary: "Print read-only groundcrew state, or one ticket's local/Linear status",
-        usage: "[<ticket>]",
+        summary: "Print read-only groundcrew state, or one task's local/Linear status",
+        usage: "[<task>]",
         invoke: statusCli,
     },
     cleanup: {
         summary: "Tear down a worktree",
-        usage: "[--force] <ticket>",
+        usage: "[--force] <task>",
         invoke: cleanupWorkspaceCli,
     },
     stop: {
-        summary: "Stop a live ticket workspace while preserving its worktree",
-        usage: "<ticket> [--reason <text>]",
+        summary: "Stop a live task workspace while preserving its worktree",
+        usage: "<task> [--reason <text>]",
         invoke: interruptWorkspaceCli,
     },
     interrupt: {
         summary: "Deprecated alias for `crew stop`",
-        usage: "<ticket> [--reason <text>]",
+        usage: "<task> [--reason <text>]",
         deprecated: true,
         invoke: async (argv) => {
             warnDeprecated({ oldForm: "interrupt", newForm: "stop" });
@@ -153,8 +159,8 @@ const SUBCOMMANDS = {
         },
     },
     resume: {
-        summary: "Reopen an existing ticket worktree with a continuation prompt",
-        usage: "<ticket>",
+        summary: "Reopen an existing task worktree with a continuation prompt",
+        usage: "<task>",
         invoke: resumeWorkspaceCli,
     },
     setup: {

package/dist/commands/cleaner.d.ts

@@ -1,21 +1,21 @@
 /**
  * Per-iteration scanner that closes workspaces and removes worktrees for
- * tickets that have reached a terminal status. One per `orchestrate()`
+ * tasks that have reached a terminal status. One per `orchestrate()`
  * invocation; stateless across iterations. Mirrors `Dispatcher`.
  */
 import type { ResolvedConfig } from "../lib/config.ts";
-import { type BoardState } from "../lib/ticketSource.ts";
+import { type BoardState } from "../lib/taskSource.ts";
 import { type WorktreeEntry } from "../lib/worktrees.ts";
 interface CleanerDeps {
     config: ResolvedConfig;
 }
 export interface Cleaner {
-    runOnce(arguments_: {
+    runOnce: (arguments_: {
         state: BoardState;
         worktreeEntries: readonly WorktreeEntry[];
         dryRun: boolean;
         signal?: AbortSignal;
-    }): Promise<void>;
+    }) => Promise<void>;
 }
 export declare function createCleaner(deps: CleanerDeps): Cleaner;
 export {};

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,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,qBAAqB,CAAC;AAGpE,UAAU,WAAW;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAoDxD"}
+{"version":3,"file":"cleaner.d.ts","sourceRoot":"","sources":["../../src/commands/cleaner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,qBAAqB,CAAC;AAGpE,UAAU,WAAW;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,UAAU,EAAE;QACpB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAoDxD"}

package/dist/commands/cleaner.js

@@ -1,10 +1,10 @@
 /**
  * Per-iteration scanner that closes workspaces and removes worktrees for
- * tickets that have reached a terminal status. One per `orchestrate()`
+ * tasks that have reached a terminal status. One per `orchestrate()`
  * invocation; stateless across iterations. Mirrors `Dispatcher`.
  */
 import { recordCleanedUpRuns } from "../lib/runStateCleanup.js";
-import { naturalIdFromCanonical } from "../lib/ticketSource.js";
+import { naturalIdFromCanonical } from "../lib/taskSource.js";
 import { log, logEvent } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
 import { logTeardown, recordTeardownEvents } from "./teardownReporter.js";
@@ -12,24 +12,24 @@ export function createCleaner(deps) {
     const { config } = deps;
     async function runOnce(arguments_) {
         const { state, worktreeEntries, dryRun, signal } = arguments_;
-        const terminalTickets = new Set(state.issues
+        const terminalTasks = new Set(state.issues
             .filter((issue) => issue.status === "done")
             .map((issue) => naturalIdFromCanonical(issue.id)));
-        if (terminalTickets.size === 0) {
+        if (terminalTasks.size === 0) {
             return;
         }
-        const stale = worktreeEntries.filter((entry) => terminalTickets.has(entry.ticket));
+        const stale = worktreeEntries.filter((entry) => terminalTasks.has(entry.task));
         if (stale.length === 0) {
             return;
         }
         if (dryRun) {
             log(`[dry-run] ${stale.length} worktree(s) due for cleanup:`);
             for (const entry of stale) {
-                log(`  - ${entry.repository}-${entry.ticket} (${entry.kind})`);
+                log(`  - ${entry.repository}-${entry.task} (${entry.kind})`);
                 logEvent("cleanup", {
                     outcome: "skipped",
                     reason: "dry_run",
-                    ticket: entry.ticket,
+                    task: entry.task,
                     repository: entry.repository,
                     kind: entry.kind,
                 });

package/dist/commands/cleanupWorkspace.d.ts

@@ -1,6 +1,6 @@
 import { type ResolvedConfig } from "../lib/config.ts";
 export interface CleanupWorkspaceOptions {
-    ticket: string;
+    task: string;
     /** Default false. The automated cleanup path keeps in-flight uncommitted work. */
     force?: boolean;
 }

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;AAQnE,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,CA+Bf;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;AAQnE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,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,CA6Bf;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/commands/cleanupWorkspace.js

@@ -14,35 +14,35 @@ function parseArguments(argv) {
             continue;
         }
         if (argument.startsWith("-")) {
-            throw new Error(`Unknown option: ${argument}\nUsage: crew cleanup [--force] <ticket>\nExample: crew cleanup team-220`);
+            throw new Error(`Unknown option: ${argument}\nUsage: crew cleanup [--force] <task>\nExample: crew cleanup team-220`);
         }
         positionals.push(argument);
     }
-    const [ticket, ...extras] = positionals;
-    if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
-        throw new Error("Usage: crew cleanup [--force] <ticket>\nExample: crew cleanup team-220");
+    const [task, ...extras] = positionals;
+    if (task === undefined || task.length === 0 || extras.length > 0) {
+        throw new Error("Usage: crew cleanup [--force] <task>\nExample: crew cleanup team-220");
     }
-    return { ticket: ticket.toLowerCase(), force };
+    return { task: task.toLowerCase(), force };
 }
 export async function cleanupWorkspace(config, options) {
-    const { ticket, force = false } = options;
-    const entries = worktrees.findByTicket(config, ticket);
+    const { task, force = false } = options;
+    const entries = worktrees.findByTask(config, task);
     if (entries.length === 0) {
-        if (readRunState(config, ticket) === undefined) {
-            log(`No worktree found for ${ticket}; nothing to clean up.`);
+        if (readRunState(config, task) === undefined) {
+            log(`No worktree found for ${task}; nothing to clean up.`);
             return;
         }
         const workspaceProbe = await workspaces.probe(config);
         if (workspaceProbe.kind === "unavailable") {
-            log(`No worktree found for ${ticket}; workspace probe unavailable, leaving run-state intact.`);
+            log(`No worktree found for ${task}; workspace probe unavailable, leaving run-state intact.`);
             return;
         }
-        if (workspaceProbe.names.has(ticket)) {
-            log(`No worktree found for ${ticket}; workspace still present; leaving run-state intact.`);
+        if (workspaceProbe.names.has(task)) {
+            log(`No worktree found for ${task}; workspace still present; leaving run-state intact.`);
             return;
         }
-        removeRunState(config, ticket);
-        log(`No worktree found for ${ticket}; cleared stale run-state.`);
+        removeRunState(config, task);
+        log(`No worktree found for ${task}; cleared stale run-state.`);
         return;
     }
     const result = await worktrees.teardown(config, entries, { force });

package/dist/commands/dispatcher.d.ts

@@ -1,5 +1,5 @@
 /**
- * Per-iteration decider that picks Todo tickets to start and acts on the
+ * Per-iteration decider that picks Todo tasks to start and acts on the
  * picks. Stateless across iterations. The Board adapter owns its own writeback
  * caches (e.g., Linear's team-state cache lives in `src/lib/adapters/linear/writeback.ts`).
  *
@@ -8,7 +8,7 @@
  */
 import type { Board } from "../lib/board.ts";
 import type { ResolvedConfig } from "../lib/config.ts";
-import { type BoardState, type Issue } from "../lib/ticketSource.ts";
+import { type BoardState, type Issue } from "../lib/taskSource.ts";
 import type { UsageByModel } from "../lib/usage.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";
 interface DispatcherDeps {
@@ -16,7 +16,7 @@ interface DispatcherDeps {
     board: Board;
 }
 export interface Dispatcher {
-    runOnce(arguments_: {
+    runOnce: (arguments_: {
         state: BoardState;
         worktreeEntries: readonly WorktreeEntry[];
         /** Lazy so dispatcher can early-return on idle ticks without paying the codexbar shell-out. */
@@ -29,7 +29,7 @@ export interface Dispatcher {
          * printing a second line per tick.
          */
         idleSuffix?: string;
-    }): Promise<void>;
+    }) => Promise<void>;
 }
 export declare function createDispatcher(deps: DispatcherDeps): Dispatcher;
 export declare function formatActiveSlotList(active: readonly Issue[]): string;

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,CA2NjE;AA2BD,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,sBAAsB,CAAC;AAC9B,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,EAAE,CAAC,UAAU,EAAE;QACpB,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,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAaD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAyNjE;AA2BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}