@clipboard-health/groundcrew 4.18.2 → 4.20.0

package/dist/commands/dispatcher.js

@@ -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`).
  *
@@ -7,7 +7,7 @@
  * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
 import { dispatchableRepository } from "../lib/repositoryValidation.js";
-import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/ticketSource.js";
+import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { errorMessage, failMark, log, logEvent } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { classifyBlockers, classifyEligibility, classifyUsageExhaustion, } from "./eligibility.js";
@@ -17,7 +17,7 @@ function logSkip(verdict) {
     logEvent("dispatch", {
         outcome: "skipped",
         reason: verdict.eventReason,
-        ticket: naturalIdFromCanonical(verdict.issue.id),
+        task: naturalIdFromCanonical(verdict.issue.id),
         blockers: verdict.blockers,
         model: verdict.model,
     });
@@ -34,18 +34,18 @@ export function createDispatcher(deps) {
     }
     async function startEligibleIssue(start, dryRun, signal) {
         const { issue, recovery } = start;
-        const ticketId = naturalIdFromCanonical(issue.id);
+        const taskId = naturalIdFromCanonical(issue.id);
         if (start.resolvedFromAny) {
-            log(`Resolved agent-any for ${ticketId} → ${issue.model}`);
+            log(`Resolved agent-any for ${taskId} → ${issue.model}`);
         }
         if (dryRun) {
             log(
             /* v8 ignore next @preserve -- classifyTodo forces recovery=false in dry-run, so the resume branch can't fire here */
-            `[dry-run] Would ${recovery ? "resume" : "start"} ${ticketId} in ${issue.repository} (${issue.model})`);
+            `[dry-run] Would ${recovery ? "resume" : "start"} ${taskId} in ${issue.repository} (${issue.model})`);
             logEvent("dispatch", {
                 outcome: "skipped",
                 reason: "dry_run",
-                ticket: ticketId,
+                task: taskId,
                 model: issue.model,
                 repository: issue.repository,
             });
@@ -53,12 +53,12 @@ export function createDispatcher(deps) {
         }
         try {
             if (recovery) {
-                log(`Worktree and workspace already exist for ${ticketId}; resuming with markInProgress`);
+                log(`Worktree and workspace already exist for ${taskId}; resuming with markInProgress`);
             }
             else {
                 const setupOptions = {
                     repository: issue.repository,
-                    ticket: ticketId,
+                    task: taskId,
                     model: issue.model,
                     details: {
                         title: issue.title,
@@ -73,16 +73,16 @@ export function createDispatcher(deps) {
             await board.markInProgress(issue);
             logEvent("dispatch", {
                 outcome: recovery ? "resumed" : "started",
-                ticket: ticketId,
+                task: taskId,
                 model: issue.model,
                 repository: issue.repository,
             });
         }
         catch (error) {
-            log(`${failMark()} Failed to start ${ticketId}: ${errorMessage(error)}`);
+            log(`${failMark()} Failed to start ${taskId}: ${errorMessage(error)}`);
             logEvent("dispatch", {
                 outcome: "failed",
-                ticket: ticketId,
+                task: taskId,
                 model: issue.model,
                 repository: issue.repository,
                 error: errorMessage(error),
@@ -91,16 +91,16 @@ export function createDispatcher(deps) {
     }
     async function runOnce(arguments_) {
         const { state, worktreeEntries, usage, dryRun, signal, idleSuffix = "" } = arguments_;
-        // Surface parent tickets that fetch silently dropped. Without this
-        // an operator sees "No Todo tickets to pick up" with no signal that an
-        // expected Todo+labelled ticket was skipped because it has sub-issues.
+        // Surface parent tasks that fetch silently dropped. Without this
+        // an operator sees "No Todo tasks to pick up" with no signal that an
+        // expected Todo+labelled task was skipped because it has sub-issues.
         for (const skip of state.parentSkips) {
-            const ticket = naturalIdFromCanonical(skip.id);
-            log(`Skipping ${ticket}: parent ticket with ${skip.childCount} sub-issue(s) — groundcrew works sub-issues, not parents`);
+            const task = naturalIdFromCanonical(skip.id);
+            log(`Skipping ${task}: parent task with ${skip.childCount} sub-issue(s) — groundcrew works sub-issues, not parents`);
             logEvent("dispatch", {
                 outcome: "skipped",
                 reason: "parent_with_children",
-                ticket,
+                task,
                 children: skip.childCount,
             });
         }
@@ -109,9 +109,9 @@ export function createDispatcher(deps) {
             .toSorted((a, b) => a.id.localeCompare(b.id));
         const activeCount = active.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.
-        // Sort by priority so higher-priority tickets fill slots first.
+        // Narrow Todo to tasks that opted in via an `agent-*` label.
+        // Unlabeled tasks are not groundcrew's concern even when in Todo.
+        // Sort by priority so higher-priority tasks fill slots first.
         const todo = state.issues
             .filter((issue) => issue.status === "todo" && isGroundcrewIssue(issue))
             .toSorted((a, b) => prioritySortKey(a.priority) - prioritySortKey(b.priority));
@@ -120,7 +120,7 @@ export function createDispatcher(deps) {
             return;
         }
         if (todo.length === 0) {
-            log(`No Todo tickets to pick up${idleSuffix}`);
+            log(`No Todo tasks to pick up${idleSuffix}`);
             return;
         }
         // Run the blocker pre-pass first so an all-blocked board short-circuits
@@ -130,21 +130,21 @@ export function createDispatcher(deps) {
             logSkip(skip);
         }
         if (unblocked.length === 0) {
-            log(`No eligible Todo tickets after blocker filtering${idleSuffix}`);
+            log(`No eligible Todo tasks after blocker filtering${idleSuffix}`);
             return;
         }
         // Validate repositories BEFORE the expensive probes so a tick whose only
         // candidates have unknown repos short-circuits without paying for the
         // usage() HTTP call or the workspaces.probe shell-out. Doing this filter
-        // here also keeps an unknown-repo ticket at the head of the queue from
+        // here also keeps an unknown-repo task at the head of the queue from
         // consuming a slot in classifyEligibility and starving later valid
-        // tickets. Each unknown repo still emits a WARN via dispatchableRepository.
+        // tasks. Each unknown repo still emits a WARN via dispatchableRepository.
         const dispatchableUnblocked = unblocked.filter((issue) => {
             const repository = dispatchableRepository(issue, config.workspace.knownRepositories, log);
             return repository !== undefined;
         });
         if (dispatchableUnblocked.length === 0) {
-            log(`No eligible Todo tickets after repository validation${idleSuffix}`);
+            log(`No eligible Todo tasks after repository validation${idleSuffix}`);
             return;
         }
         // usage() is an HTTP call; workspaces.probe shells tmux/cmux. Kick off
@@ -186,14 +186,14 @@ export function createDispatcher(deps) {
             logSkip(skip);
         }
         if (starts.length === 0) {
-            log(`No eligible Todo tickets after eligibility filtering${idleSuffix}`);
+            log(`No eligible Todo tasks after eligibility filtering${idleSuffix}`);
             return;
         }
         const dispatchable = starts;
-        log(`Slots ${activeCount}/${config.orchestrator.maximumInProgress} used${formatActiveSlotList(active)}, starting ${dispatchable.length} ticket(s): ${dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}(${issue.model})`).join(", ")}`);
+        log(`Slots ${activeCount}/${config.orchestrator.maximumInProgress} used${formatActiveSlotList(active)}, starting ${dispatchable.length} task(s): ${dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}(${issue.model})`).join(", ")}`);
         logEvent("dispatch", {
             outcome: "starting",
-            tickets: dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}:${issue.model}`),
+            tasks: dispatchable.map(({ issue }) => `${naturalIdFromCanonical(issue.id)}:${issue.model}`),
         });
         for (const start of dispatchable) {
             // oxlint-disable-next-line no-await-in-loop -- one workspace at a time avoids racing on git
@@ -205,15 +205,15 @@ export function createDispatcher(deps) {
 function hasRecoverableCandidate(issues, worktreeEntries) {
     return issues.some((issue) => {
         const naturalId = naturalIdFromCanonical(issue.id);
-        return worktreeEntries.some((entry) => entry.repository === issue.repository && entry.ticket === naturalId);
+        return worktreeEntries.some((entry) => entry.repository === issue.repository && entry.task === naturalId);
     });
 }
 function formatUsageExhaustion(exhaustion) {
     if (exhaustion.kind === "session") {
         const mins = exhaustion.resetMinutes ?? "?";
-        return `${exhaustion.model} session at ${exhaustion.usedPercentage.toFixed(0)}% (> ${exhaustion.limitPercentage}%), resets in ${mins}m — skipping its tickets`;
+        return `${exhaustion.model} session at ${exhaustion.usedPercentage.toFixed(0)}% (> ${exhaustion.limitPercentage}%), resets in ${mins}m — skipping its tasks`;
     }
-    return `${exhaustion.model} weekly at ${exhaustion.usedPercentage.toFixed(1)}% (> ${exhaustion.allowedPercentage.toFixed(1)}% paced budget), resets in ${exhaustion.resetMinutes}m — skipping its tickets`;
+    return `${exhaustion.model} weekly at ${exhaustion.usedPercentage.toFixed(1)}% (> ${exhaustion.allowedPercentage.toFixed(1)}% paced budget), resets in ${exhaustion.resetMinutes}m — skipping its tasks`;
 }
 /** Undefined priority sorts last. */
 function prioritySortKey(priority) {

package/dist/commands/doctor.js

@@ -34,7 +34,7 @@ async function checkCmd(cmd, required, hint) {
     return result;
 }
 /**
- * Source-agnostic reachability check: build every configured ticket source
+ * Source-agnostic reachability check: build every configured task source
  * and run the Board's `verify()` fan-out. Replaces the old Linear-only
  * "api key + reachability" probe so a misconfigured shell (or future Jira)
  * source surfaces here too. A missing Linear API key still fails verify with

package/dist/commands/eligibility.d.ts

@@ -1,13 +1,13 @@
 /**
  * Pure eligibility classifier — takes the per-iteration board snapshot plus
  * derived state (worktrees, live workspaces, usage, slot count) and returns
- * a verdict per Todo ticket. No logging, no Linear calls, no shell-outs.
+ * a verdict per Todo task. No logging, no Linear calls, no shell-outs.
  *
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
 import { type ResolvedConfig } from "../lib/config.ts";
-import { type GroundcrewIssue } from "../lib/ticketSource.ts";
+import { type GroundcrewIssue } from "../lib/taskSource.ts";
 import type { UsageByModel } from "../lib/usage.ts";
 import type { WorkspaceProbe } from "../lib/workspaces.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";

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,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpG,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;AAgCD;;;;;;;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;AA6CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;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,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClG,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;AAgCD;;;;;;;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;AA6CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,EAAE,CAgE5E"}

package/dist/commands/eligibility.js

@@ -1,13 +1,13 @@
 /**
  * Pure eligibility classifier — takes the per-iteration board snapshot plus
  * derived state (worktrees, live workspaces, usage, slot count) and returns
- * a verdict per Todo ticket. No logging, no Linear calls, no shell-outs.
+ * a verdict per Todo task. No logging, no Linear calls, no shell-outs.
  *
  * The Dispatcher consumes the verdict list to drive logging and side
  * effects.
  */
 import { AGENT_ANY_MODEL } from "../lib/config.js";
-import { naturalIdFromCanonical } from "../lib/ticketSource.js";
+import { naturalIdFromCanonical } from "../lib/taskSource.js";
 const PERCENT_FRACTION_DIVISOR = 100;
 const DAYS_PER_WEEK = 7;
 const MINUTES_PER_DAY = 24 * 60;
@@ -104,14 +104,14 @@ export function classifyUsageExhaustion(config, usage) {
     return exhausted;
 }
 // Stale worktrees with no matching live workspace are filtered out here so
-// they don't permanently block later tickets in the Todo queue.
+// they don't permanently block later tasks in the Todo queue.
 function classifyRecovery(arguments_) {
     const { issue, worktreeEntries, workspaceProbe, dryRun } = arguments_;
     if (dryRun) {
         return { kind: "go", recovery: false };
     }
     const naturalId = naturalIdFromCanonical(issue.id);
-    const exists = worktreeEntries.some((entry) => entry.repository === issue.repository && entry.ticket === naturalId);
+    const exists = worktreeEntries.some((entry) => entry.repository === issue.repository && entry.task === naturalId);
     if (!exists) {
         return { kind: "go", recovery: false };
     }

package/dist/commands/init.js

@@ -209,7 +209,7 @@ function writeInitGuidance(destination, options) {
     writeCloneGuidance(options);
     writeOutput("  - If using Linear, export your API key:");
     writeOutput('      export GROUNDCREW_LINEAR_API_KEY="lin_api_..."');
-    writeOutput("  - In Linear, assign tickets to yourself and add an agent-* label to opt them in");
+    writeOutput("  - In Linear, assign tasks to yourself and add an agent-* label to opt them in");
     writeOutput("  - Validate and start:");
     writeOutput("      crew doctor");
     writeOutput("      crew run --watch");

package/dist/commands/interruptWorkspace.d.ts

@@ -1,6 +1,6 @@
 import { type ResolvedConfig } from "../lib/config.ts";
 export interface InterruptWorkspaceOptions {
-    ticket: string;
+    task: string;
     reason?: string;
 }
 export declare function interruptWorkspace(config: ResolvedConfig, options: InterruptWorkspaceOptions): Promise<void>;

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

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

package/dist/commands/interruptWorkspace.js

@@ -22,19 +22,19 @@ function parseArguments(argv) {
             continue;
         }
         if (argument.startsWith("-")) {
-            throw new Error(`Unknown option: ${argument}\nUsage: crew stop <ticket> [--reason <text>]`);
+            throw new Error(`Unknown option: ${argument}\nUsage: crew stop <task> [--reason <text>]`);
         }
         positionals.push(argument);
     }
-    const [ticket, ...extras] = positionals;
-    if (ticket === undefined || ticket.length === 0 || extras.length > 0) {
-        throw new Error("Usage: crew stop <ticket> [--reason <text>]");
+    const [task, ...extras] = positionals;
+    if (task === undefined || task.length === 0 || extras.length > 0) {
+        throw new Error("Usage: crew stop <task> [--reason <text>]");
     }
-    return { ticket: ticket.toLowerCase(), ...(reason === undefined ? {} : { reason }) };
+    return { task: task.toLowerCase(), ...(reason === undefined ? {} : { reason }) };
 }
 function sourceFromState(state) {
     return {
-        ticket: state.ticket,
+        task: state.task,
         repository: state.repository,
         model: state.model,
         worktreeDir: state.worktreeDir,
@@ -43,14 +43,14 @@ function sourceFromState(state) {
         resumeCount: state.resumeCount,
     };
 }
-function sourceFromWorktree(config, ticket, entry) {
+function sourceFromWorktree(config, task, entry) {
     return {
-        ticket,
+        task,
         repository: entry.repository,
         model: config.models.default,
         worktreeDir: entry.dir,
         branchName: entry.branchName,
-        workspaceName: ticket,
+        workspaceName: task,
         resumeCount: 0,
     };
 }
@@ -59,9 +59,9 @@ function resolveInterruptSource(arguments_) {
         return sourceFromState(arguments_.state);
     }
     if (arguments_.entry !== undefined) {
-        return sourceFromWorktree(arguments_.config, arguments_.ticket, arguments_.entry);
+        return sourceFromWorktree(arguments_.config, arguments_.task, arguments_.entry);
     }
-    throw new Error(`No run state or worktree found for ${arguments_.ticket}; nothing to interrupt.`);
+    throw new Error(`No run state or worktree found for ${arguments_.task}; nothing to interrupt.`);
 }
 function interruptDetail(result) {
     if (result.kind === "missing") {
@@ -77,17 +77,17 @@ function failOnUnavailable(result) {
     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 task = options.task.toLowerCase();
+    const state = readRunState(config, task);
+    const [entry] = worktrees.findByTask(config, task);
+    const source = resolveInterruptSource({ config, task, state, entry });
     const result = await workspaces.interrupt(config, source.workspaceName);
     failOnUnavailable(result);
     const detail = interruptDetail(result);
     recordRunState({
         config,
         state: {
-            ticket,
+            task,
             repository: source.repository,
             model: source.model,
             worktreeDir: source.worktreeDir,
@@ -99,8 +99,8 @@ export async function interruptWorkspace(config, options) {
             ...(detail === undefined ? {} : { detail }),
         },
     });
-    log(`Interrupted ${ticket}; worktree preserved at ${source.worktreeDir}`);
-    log(`Next: crew status ${ticket}`);
+    log(`Interrupted ${task}; worktree preserved at ${source.worktreeDir}`);
+    log(`Next: crew status ${task}`);
 }
 export async function interruptWorkspaceCli(argv) {
     const config = await loadConfig();

package/dist/commands/orchestrator.d.ts

@@ -1,6 +1,6 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
- * git-worktree pairs for ready tickets. Each tick fetches the board, runs
+ * git-worktree pairs for ready tasks. Each tick fetches the board, runs
  * the cleaner, the reviewer, and the dispatcher; logging from those modules is
  * the orchestrator's user-facing output.
  */

package/dist/commands/orchestrator.js

@@ -1,6 +1,6 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
- * git-worktree pairs for ready tickets. Each tick fetches the board, runs
+ * git-worktree pairs for ready tasks. Each tick fetches the board, runs
  * the cleaner, the reviewer, and the dispatcher; logging from those modules is
  * the orchestrator's user-facing output.
  */
@@ -8,7 +8,7 @@ import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
 import { findPullRequestsForBranch } from "../lib/pullRequests.js";
-import { RepositoryResolutionError } from "../lib/ticketSource.js";
+import { RepositoryResolutionError } from "../lib/taskSource.js";
 import { getUsageByModel } from "../lib/usage.js";
 import { errorMessage, log, sleep } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";

package/dist/commands/resumeWorkspace.d.ts

@@ -1,6 +1,6 @@
 import { type ResolvedConfig } from "../lib/config.ts";
 export interface ResumeWorkspaceOptions {
-    ticket: string;
+    task: string;
 }
 export declare function resumeWorkspace(config: ResolvedConfig, options: ResumeWorkspaceOptions): Promise<void>;
 export declare function resumeWorkspaceCli(argv: string[]): Promise<void>;

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;AAenE,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,CA0Ff;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;AAenE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Ff;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -10,29 +10,29 @@ import { errorMessage, log } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { worktrees } from "../lib/worktrees.js";
 function parseArguments(argv) {
-    const [ticket, ...extras] = argv;
-    if (ticket === undefined || ticket.length === 0 || extras.length > 0 || ticket.startsWith("-")) {
-        throw new Error("Usage: crew resume <ticket>");
+    const [task, ...extras] = argv;
+    if (task === undefined || task.length === 0 || extras.length > 0 || task.startsWith("-")) {
+        throw new Error("Usage: crew resume <task>");
     }
-    return { ticket: ticket.toLowerCase() };
+    return { task: task.toLowerCase() };
 }
-async function fetchTicketDetails(ticket) {
+async function fetchTaskDetails(task) {
     try {
-        const issue = await getLinearClient().issue(ticket.toUpperCase());
+        const issue = await getLinearClient().issue(task.toUpperCase());
         return {
             title: issue.title,
             description: issue.description ?? "",
         };
     }
     catch (error) {
-        log(`Resume Linear detail lookup failed for ${ticket}: ${errorMessage(error)}`);
+        log(`Resume Linear detail lookup failed for ${task}: ${errorMessage(error)}`);
         return undefined;
     }
 }
-async function contextFromLinear(config, ticket, worktree) {
-    const resolved = await fetchResolvedIssue({ client: getLinearClient(), config, ticket });
+async function contextFromLinear(config, task, worktree) {
+    const resolved = await fetchResolvedIssue({ client: getLinearClient(), config, task });
     return {
-        ticket,
+        task,
         repository: resolved.repository,
         model: resolved.model,
         worktree,
@@ -41,38 +41,38 @@ async function contextFromLinear(config, ticket, worktree) {
         resumeCount: 0,
     };
 }
-async function contextFromState(ticket, state, worktree) {
-    const details = await fetchTicketDetails(ticket);
+async function contextFromState(task, state, worktree) {
+    const details = await fetchTaskDetails(task);
     return {
-        ticket,
+        task,
         repository: state.repository,
         model: state.model,
         worktree,
-        title: details?.title ?? ticket.toUpperCase(),
+        title: details?.title ?? task.toUpperCase(),
         description: details?.description ?? "",
         ...(state.reason === undefined ? {} : { reason: state.reason }),
         resumeCount: state.resumeCount,
     };
 }
-async function buildResumeContext(config, ticket) {
-    const state = readRunState(config, ticket);
-    const entries = worktrees.findByTicket(config, ticket);
+async function buildResumeContext(config, task) {
+    const state = readRunState(config, task);
+    const entries = worktrees.findByTask(config, task);
     const worktree = state === undefined
         ? entries[0]
         : (entries.find((entry) => entry.repository === state.repository) ?? entries[0]);
     if (worktree === undefined) {
-        throw new Error(`No worktree found for ${ticket}; cannot resume.`);
+        throw new Error(`No worktree found for ${task}; cannot resume.`);
     }
     if (state !== undefined) {
-        return await contextFromState(ticket, state, worktree);
+        return await contextFromState(task, state, worktree);
     }
-    return await contextFromLinear(config, ticket, worktree);
+    return await contextFromLinear(config, task, worktree);
 }
 function renderResumePrompt(context) {
     return [
-        `You are resuming Groundcrew ticket ${context.ticket} (${context.title}) in an existing worktree.`,
+        `You are resuming Groundcrew task ${context.task} (${context.title}) in an existing worktree.`,
         "",
-        "Ticket description:",
+        "Task description:",
         "",
         context.description,
         "",
@@ -89,20 +89,20 @@ function renderResumePrompt(context) {
         "Run the repository's documented verification before stopping, then leave the branch ready or open a PR when possible.",
     ].join("\n");
 }
-async function failIfWorkspaceAlreadyLive(config, ticket) {
+async function failIfWorkspaceAlreadyLive(config, task) {
     const probe = await workspaces.probe(config);
     if (probe.kind === "unavailable") {
         const detail = probe.error === undefined ? "" : `: ${errorMessage(probe.error)}`;
-        throw new Error(`Could not verify whether workspace for ${ticket} is already live${detail}. Retry or inspect the workspace backend manually before resuming.`);
+        throw new Error(`Could not verify whether workspace for ${task} is already live${detail}. Retry or inspect the workspace backend manually before resuming.`);
     }
-    if (probe.names.has(ticket)) {
-        throw new Error(`Workspace for ${ticket} is already live; attach to it instead of resuming.`);
+    if (probe.names.has(task)) {
+        throw new Error(`Workspace for ${task} is already live; attach to it instead of resuming.`);
     }
 }
 export async function resumeWorkspace(config, options) {
-    const ticket = options.ticket.toLowerCase();
-    await failIfWorkspaceAlreadyLive(config, ticket);
-    const context = await buildResumeContext(config, ticket);
+    const task = options.task.toLowerCase();
+    await failIfWorkspaceAlreadyLive(config, task);
+    const context = await buildResumeContext(config, task);
     const definition = config.models.definitions[context.model];
     if (definition === undefined) {
         throw new Error(`Unknown model: ${context.model}`);
@@ -116,7 +116,7 @@ export async function resumeWorkspace(config, options) {
     await ensureReady();
     const stagedPrompt = stagePromptText({
         prefix: "groundcrew-resume",
-        ticket,
+        task,
         text: renderResumePrompt(context),
     });
     const secretsFile = stageBuildSecrets(stagedPrompt.directory);
@@ -131,7 +131,7 @@ export async function resumeWorkspace(config, options) {
         const staged = buildAndStageSrtLaunch({
             config,
             repository: context.repository,
-            ticket,
+            task,
             worktreeDir: context.worktree.dir,
             definition,
         });
@@ -156,7 +156,7 @@ export async function resumeWorkspace(config, options) {
     try {
         await openAgentWorkspace({
             config,
-            name: ticket,
+            name: task,
             cwd: context.worktree.dir,
             command: launchCmd,
             model: context.model,
@@ -175,18 +175,18 @@ export async function resumeWorkspace(config, options) {
     recordRunState({
         config,
         state: {
-            ticket,
+            task,
             repository: context.repository,
             model: context.model,
             worktreeDir: context.worktree.dir,
             branchName: context.worktree.branchName,
-            workspaceName: ticket,
+            workspaceName: task,
             state: "resumed",
             resumeCount: context.resumeCount + 1,
             ...(context.reason === undefined ? {} : { reason: context.reason }),
         },
     });
-    log(`Resumed ${ticket} in ${context.worktree.dir} (${context.model})`);
+    log(`Resumed ${task} in ${context.worktree.dir} (${context.model})`);
 }
 export async function resumeWorkspaceCli(argv) {
     const config = await loadConfig();

package/dist/commands/reviewer.d.ts

@@ -1,13 +1,13 @@
 /**
- * Per-iteration scanner that advances a ticket based on its worktree's pull
+ * Per-iteration scanner that advances a task based on its worktree's pull
  * request state. Sits between the cleaner and the dispatcher in each
  * `orchestrate()` tick.
  *
- * - An **open** PR on an **in-progress** ticket → `markInReview`: frees a
+ * - An **open** PR on an **in-progress** task → `markInReview`: frees a
  *   dispatch slot (slot math counts only in-progress) while leaving the
  *   worktree intact for review, since the cleaner only tears down `done`.
- * - A **merged** PR (on an in-progress or in-review ticket) → `markDone`:
- *   the work has landed, so the ticket is terminal and the cleaner tears the
+ * - A **merged** PR (on an in-progress or in-review task) → `markDone`:
+ *   the work has landed, so the task is terminal and the cleaner tears the
  *   worktree down on a later tick. `merged` never routes to `in-review`.
  *
  * Sources that don't implement `markDone` (e.g. Linear) return `unsupported`;
@@ -15,14 +15,14 @@
  * fallback. (Linear's own GitHub integration moves merged issues to Done,
  * which groundcrew observes via `fetch()`.)
  *
- * The write-back lands in the ticket source, not the in-memory `BoardState`,
+ * The write-back lands in the task source, not the in-memory `BoardState`,
  * so the dispatcher in the SAME tick still sees prior state; the slot frees on
  * the NEXT tick's `board.fetch()`. That one-tick latency is deliberate. One
  * per `orchestrate()`; stateless across iterations. Mirrors `Cleaner`.
  */
 import type { Board } from "../lib/board.ts";
 import type { PullRequestSummary } from "../lib/pullRequests.ts";
-import { type BoardState } from "../lib/ticketSource.ts";
+import { type BoardState } from "../lib/taskSource.ts";
 import type { WorktreeEntry } from "../lib/worktrees.ts";
 /**
  * Injected PR lookup. Matches `findPullRequestsForBranch`'s shape: best-effort,
@@ -47,7 +47,7 @@ interface ReviewArguments {
     signal?: AbortSignal;
 }
 export interface Reviewer {
-    runOnce(arguments_: ReviewArguments): Promise<void>;
+    runOnce: (arguments_: ReviewArguments) => Promise<void>;
 }
 export declare function createReviewer(deps: ReviewerDeps): Reviewer;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/commands/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,sEAAsE;AACtE,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AA+CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAwH3D"}
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/commands/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,sEAAsE;AACtE,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AA+CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAwH3D"}