@clipboard-health/groundcrew 4.34.3 → 4.35.1

package/README.md

@@ -94,6 +94,7 @@ crew source list|verify [<source>]                       # inspect configured ta
 crew task list [--source <name>]                         # list tasks across sources
 crew task get <TASK> [--source <name>] [--prompt]        # inspect one task or its prompt
 crew task create "Title" --source <name> [--agent <name>] # create a source task
+crew task done <TASK> [--allow-dirty]                    # mark a no-PR task done
 crew task validate [<source>]                            # validate task content
 crew status [<TASK>]                                   # inspect current state or one task
 crew run [--watch]                                       # one-shot or --watch forever

package/dist/cli.js

@@ -136,8 +136,8 @@ const SUBCOMMANDS = {
         invoke: sourceCli,
     },
     task: {
-        summary: "List, get, and create tasks across configured sources",
-        usage: "<list|get|create> [...]",
+        summary: "List, get, create, and complete tasks across configured sources",
+        usage: "<list|get|create|done|validate> [...]",
         invoke: taskCli,
     },
     status: {

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,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;AAiCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAmOjE;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;AAiCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAoOjE;AA2BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}

package/dist/commands/dispatcher.js

@@ -70,6 +70,7 @@ export function createDispatcher(deps) {
                 const setupOptions = {
                     repository: issue.repository,
                     task: taskId,
+                    completionTaskId: issue.id,
                     agent: issue.agent,
                     details: {
                         title: issue.title,

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyLH,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAmF/C"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuQH,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAmF/C"}

package/dist/commands/doctor.js

@@ -3,12 +3,12 @@
  * Returns true if every required check passes; false otherwise.
  */
 import { existsSync, statSync } from "node:fs";
-import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfigWithSource, worktreeBaseDir, } from "../lib/config.js";
 import { detectHostCapabilities, which } from "../lib/host.js";
 import { isEnvironmentAssignment } from "../lib/launchCommand.js";
 import { resolveLocalRunner } from "../lib/localRunner.js";
+import { naturalIdFromCanonical } from "../lib/taskSource.js";
 import { gatedAgents } from "../lib/usage.js";
 import { errorMessage, writeOutput } from "../lib/util.js";
 import { resolveWorkspaceKind } from "../lib/workspaces.js";
@@ -34,27 +34,97 @@ async function checkCmd(cmd, required, hint) {
     }
     return result;
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
 /**
- * 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
- * its own user-facing message, so the prior behavior is preserved.
+ * True when a raw source config entry declares `kind: "shell"`. Gates the
+ * shell-only read probe.
  */
-async function checkSourceProbe(config) {
+function isShellSource(raw) {
+    if (!isRecord(raw)) {
+        return false;
+    }
+    const { kind } = raw;
+    return kind === "shell";
+}
+function hasExplicitGetTaskCommand(raw) {
+    const { commands } = raw;
+    if (!isRecord(commands)) {
+        return false;
+    }
+    const { getTask, resolveOne } = commands;
+    return typeof getTask === "string" || typeof resolveOne === "string";
+}
+function shellReadProbeFor(raw) {
+    if (!isShellSource(raw)) {
+        return "none";
+    }
+    return hasExplicitGetTaskCommand(raw) ? "listTasksAndGetTask" : "listTasks";
+}
+/**
+ * Probe each configured task source independently and emit one `Check` per
+ * source (named `source: <name>`), so a single broken source is attributable
+ * instead of hidden behind an aggregate "N source(s) verified" line.
+ *
+ * Every source runs its `verify()`. Shell sources are additionally deep-probed
+ * via `listTasks()`: their `verify` command can discard stdout (e.g.
+ * `... fetch >/dev/null`), so a malformed task payload sails through verify and
+ * only blows up later in `crew run`. Running listTasks here surfaces a
+ * wrong-shape payload (a `TaskSourceOutputError` with a readable message) at
+ * doctor time. Non-shell sources (Linear) are left to `verify()` alone — their
+ * fetch is an expensive network call that verify already exercises.
+ */
+async function checkSourceProbes(config) {
+    const rawSources = sourcesFromConfig(config);
+    let sources;
     try {
-        const sources = await buildSources(sourcesFromConfig(config), { globalConfig: config });
-        const board = createBoard(sources);
-        await board.verify();
-        return {
-            name: "source probe",
-            ok: true,
-            required: true,
-            hint: `${sources.length} source(s) verified`,
-        };
+        sources = await buildSources(rawSources, { globalConfig: config });
+    }
+    catch (error) {
+        // Building sources failed before any individual probe (bad config / unknown
+        // kind). Surface it as a single failed check rather than per-source.
+        return [{ name: "sources", ok: false, required: true, hint: errorMessage(error) }];
+    }
+    if (sources.length === 0) {
+        return [{ name: "sources", ok: false, required: true, hint: "no task sources configured" }];
+    }
+    const checks = [];
+    for (const [index, source] of sources.entries()) {
+        const shellReadProbe = shellReadProbeFor(rawSources[index]);
+        // oxlint-disable-next-line no-await-in-loop -- sequential keeps each verdict attributable to one source
+        checks.push(await probeSource(source, shellReadProbe));
+    }
+    return checks;
+}
+async function probeSource(source, shellReadProbe) {
+    const name = `source: ${source.name}`;
+    try {
+        await source.verify();
+        if (shellReadProbe === "none") {
+            return { name, ok: true, required: true, hint: "verified" };
+        }
+        const tasks = await source.listTasks();
+        const parts = [`fetched ${tasks.length} task(s)`];
+        // Read-path symmetry: an id listTasks emitted must resolve via getTask.
+        // Skipped when getTask is only the adapter's listTasks fallback, since that
+        // would just re-run listTasks and can race changing source output.
+        const [first] = tasks;
+        if (first !== undefined && shellReadProbe === "listTasksAndGetTask") {
+            const naturalId = naturalIdFromCanonical(first.id);
+            const resolved = await source.getTask(naturalId);
+            if (resolved === null) {
+                throw new Error(`getTask("${naturalId}") returned nothing, but listTasks emitted it`);
+            }
+            if (resolved.id !== first.id) {
+                throw new Error(`getTask("${naturalId}") resolved "${resolved.id}", but listTasks emitted "${first.id}"`);
+            }
+            parts.push("getTask round-trips");
+        }
+        return { name, ok: true, required: true, hint: `verified; ${parts.join("; ")}` };
     }
     catch (error) {
-        return { name: "source probe", ok: false, required: true, hint: errorMessage(error) };
+        return { name, ok: false, required: true, hint: errorMessage(error) };
     }
 }
 function checkDir(path, label) {
@@ -190,7 +260,7 @@ export async function doctor() {
     const workspaceOutcome = resolveWorkspaceOutcome(config, host);
     reportWorkspaceKind(config, workspaceOutcome);
     const checks = [
-        await checkSourceProbe(config),
+        ...(await checkSourceProbes(config)),
         await checkCmd("git", true, "https://git-scm.com/"),
         ...(await workspaceChecks(workspaceOutcome)),
         checkDir(config.workspace.projectDir, "workspace.projectDir"),

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

@@ -1 +1 @@
-{"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,CAgE7E"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoEH,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,CAgE7E"}

package/dist/commands/orchestrator.js

@@ -8,7 +8,7 @@ import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfigWithSource } from "../lib/config.js";
 import { findPullRequestsForBranch } from "../lib/pullRequests.js";
-import { RepositoryResolutionError } from "../lib/taskSource.js";
+import { RepositoryResolutionError, TaskSourceOutputError, } from "../lib/taskSource.js";
 import { getUsageByAgent } from "../lib/usage.js";
 import { errorMessage, log, sleep, writeOutput } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
@@ -30,6 +30,11 @@ async function withRetry(function_, signal, maxRetries = RETRY_MAX_ATTEMPTS, bas
             if (error instanceof RepositoryResolutionError) {
                 throw error;
             }
+            // A source returned unparseable output — deterministic, so retrying just
+            // delays a guaranteed failure behind confusing "Retrying in Ns" lines.
+            if (error instanceof TaskSourceOutputError) {
+                throw error;
+            }
             if (attempt === maxRetries) {
                 throw error;
             }

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

@@ -1 +1 @@
-{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcnE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAuID,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Ef;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":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AA0ID,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Ef;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -3,9 +3,10 @@ import { getLinearClient } from "../lib/adapters/linear/client.js";
 import { isLinearEnabled } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
 import { composeAgentLaunch, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
+import { workerEnvironmentForTask } from "../lib/launchCommand.js";
 import { readRunState, recordRunState } from "../lib/runState.js";
 import { removeStagedPrompt, stageBuildSecrets, stagePromptText, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
-import { naturalIdFromCanonical } from "../lib/taskSource.js";
+import { naturalIdFromCanonical, toCanonicalId } from "../lib/taskSource.js";
 import { errorMessage, log } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { resolveLaunchDir, worktrees } from "../lib/worktrees.js";
@@ -38,6 +39,7 @@ async function contextFromLinear(config, task, worktree) {
         worktree,
         title: resolved.title,
         description: resolved.description,
+        completionTaskId: toCanonicalId("linear", task),
         resumeCount: 0,
     };
 }
@@ -53,6 +55,7 @@ async function contextFromState(config, task, state, worktree) {
         worktree,
         title: details?.title ?? task.toUpperCase(),
         description: details?.description ?? "",
+        completionTaskId: state.completionTaskId ?? task,
         ...(state.reason === undefined ? {} : { reason: state.reason }),
         resumeCount: state.resumeCount,
     };
@@ -147,6 +150,7 @@ export async function resumeWorkspace(config, options) {
             workingDir: launchDir,
             secretsFile,
             sandboxName,
+            workerEnvironment: workerEnvironmentForTask(context.completionTaskId),
         }));
         const launchCmd = stageWorkspaceLaunchCommand(stagedPrompt.directory, launchCommand);
         await openAgentWorkspace({
@@ -178,6 +182,7 @@ export async function resumeWorkspace(config, options) {
             workspaceName: task,
             state: "resumed",
             resumeCount: context.resumeCount + 1,
+            completionTaskId: context.completionTaskId,
             ...(context.reason === undefined ? {} : { reason: context.reason }),
         },
     });

package/dist/commands/setupWorkspace.d.ts

@@ -7,6 +7,8 @@ export interface TaskDetails {
 }
 export interface SetupWorkspaceOptions {
     task: string;
+    /** Canonical source id for worker self-completion; falls back to `task`. */
+    completionTaskId?: string;
     repository: string;
     agent: string;
     details: TaskDetails;

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

@@ -1 +1 @@
-{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsBnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA0Hf;AA8ID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAuBnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA8Hf;AAgJD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/commands/setupWorkspace.js

@@ -3,6 +3,7 @@ import { loadConfig } from "../lib/config.js";
 import { composeAgentLaunch, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
+import { workerEnvironmentForTask } from "../lib/launchCommand.js";
 import { resolvePrepareWorktreeCommand } from "../lib/repositoryHooks.js";
 import { recordRunState } from "../lib/runState.js";
 import { stageBuildSecrets, stagePromptFromTemplate, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
@@ -80,6 +81,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             defaultHooks: config.defaults.hooks,
         });
         const secretsFile = prepareWorktreeCommand === undefined ? undefined : stageBuildSecrets(promptDir);
+        const completionTaskId = options.completionTaskId ?? task;
         const { launchCommand, srtSettingsDir: stagedSrtSettingsDir } = composeAgentLaunch({
             runner,
             task,
@@ -90,6 +92,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             secretsFile,
             prepareWorktreeCommand,
             sandboxName,
+            workerEnvironment: workerEnvironmentForTask(completionTaskId),
         });
         srtSettingsDir = stagedSrtSettingsDir;
         const launchCmd = stageWorkspaceLaunchCommand(promptDir, launchCommand);
@@ -113,6 +116,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             workspaceName: task,
             state: "running",
             title: taskDetails.title,
+            completionTaskId,
             ...(taskDetails.url === undefined ? {} : { url: taskDetails.url }),
         });
         log(`${okMark()} "${task}" launched (${agent})  worktree ${worktreeName}`);
@@ -135,6 +139,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             state: "failed-to-launch",
             detail: errorMessage(error),
             title: options.details.title,
+            completionTaskId: options.completionTaskId ?? task,
             ...(options.details.url === undefined ? {} : { url: options.details.url }),
         });
         throw error;
@@ -197,6 +202,7 @@ function recordRunStateBestEffort(arguments_) {
                 workspaceName: arguments_.workspaceName,
                 state: arguments_.state,
                 title: arguments_.title,
+                completionTaskId: arguments_.completionTaskId,
                 ...(arguments_.detail === undefined ? {} : { detail: arguments_.detail }),
                 ...(arguments_.url === undefined ? {} : { url: arguments_.url }),
             },
@@ -275,6 +281,7 @@ export async function setupWorkspaceCli(task, options = {}) {
     const naturalId = naturalIdFromCanonical(resolved.id);
     await setupWorkspace(config, {
         task: naturalId,
+        completionTaskId: resolved.id,
         repository: resolved.repository,
         agent: resolved.agent,
         details: {

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

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAmrBA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3D"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAoyBA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB3D"}

package/dist/commands/task.js

@@ -1,13 +1,17 @@
+import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { AGENT_ANY, loadConfig } from "../lib/config.js";
+import { findPullRequestsForBranch } from "../lib/pullRequests.js";
 import { naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { parseSourceFilterArgs, writeOutput } from "../lib/util.js";
+import { worktrees } from "../lib/worktrees.js";
 const TASK_USAGE = `Usage: crew task <subcommand>
 
 Subcommands:
   list [options]                  List tasks across configured sources
   get <task-id> [options]         Get one task
   create "Short title" [options]  Create one task
+  done <task-id> [options]        Mark one task done
   validate [source] [options]     Validate task content`;
 const LIST_USAGE = `Usage: crew task list [options]
 
@@ -27,6 +31,7 @@ Options:
   --json           Print normalized task JSON.
   --prompt         Print only the task description/prompt.`;
 const CREATE_USAGE = `Usage: crew task create "Short title" --source <source> [--agent <agent>] [options]`;
+const DONE_USAGE = `Usage: crew task done <task-id> [--allow-dirty]`;
 const CANONICAL_STATUSES = [
     "todo",
     "in-progress",
@@ -251,10 +256,34 @@ function parseCreateOptions(argv) {
     };
     return { title, sourceName: state.sourceName, input, json: state.json };
 }
+function parseDoneOptions(argv) {
+    const positionals = [];
+    let allowDirty = false;
+    for (const argument of argv) {
+        if (argument === "--allow-dirty") {
+            allowDirty = true;
+            continue;
+        }
+        if (argument.startsWith("-")) {
+            throw new Error(`crew task done: unknown option: ${argument}\n${DONE_USAGE}`);
+        }
+        positionals.push(argument);
+    }
+    const [taskId, ...extras] = positionals;
+    if (taskId === undefined || taskId.length === 0 || extras.length > 0) {
+        throw new Error(DONE_USAGE);
+    }
+    return { taskId, allowDirty };
+}
 async function loadTaskSources() {
     const config = await loadConfig();
     return await buildSources(sourcesFromConfig(config), { globalConfig: config });
 }
+async function loadTaskBoard() {
+    const config = await loadConfig();
+    const sources = await buildSources(sourcesFromConfig(config), { globalConfig: config });
+    return { config, board: createBoard(sources) };
+}
 function findSource(sources, sourceName) {
     const source = sources.find((candidate) => candidate.name === sourceName);
     if (source === undefined) {
@@ -472,6 +501,60 @@ async function taskCreateCli(argv) {
     }
     writeOutput(created.id);
 }
+function matchingWorktreeEntries(arguments_) {
+    const task = naturalIdFromCanonical(arguments_.issue.id);
+    return worktrees
+        .findByTask(arguments_.config, task)
+        .filter((entry) => arguments_.issue.repository === undefined ||
+        entry.repository === arguments_.issue.repository);
+}
+function describeDirtiness(dirtiness) {
+    if (dirtiness.kind === "dirty") {
+        return `${dirtiness.modified} modified, ${dirtiness.untracked} untracked`;
+    }
+    return "unknown git status";
+}
+async function worktreeHasPullRequest(entry) {
+    const pullRequests = await findPullRequestsForBranch({
+        cwd: entry.dir,
+        branchName: entry.branchName,
+    });
+    return pullRequests.length > 0;
+}
+async function assertCanMarkDone(arguments_) {
+    if (arguments_.allowDirty) {
+        return;
+    }
+    for (const entry of matchingWorktreeEntries({
+        config: arguments_.config,
+        issue: arguments_.issue,
+    })) {
+        // oxlint-disable-next-line no-await-in-loop -- one git status per matching worktree keeps diagnostics deterministic.
+        const dirtiness = await worktrees.probeWorkingTree({ worktreeDir: entry.dir });
+        if (dirtiness.kind === "clean") {
+            continue;
+        }
+        // oxlint-disable-next-line no-await-in-loop -- only dirty/unknown worktrees need the PR lookup.
+        if (dirtiness.kind === "dirty" && (await worktreeHasPullRequest(entry))) {
+            continue;
+        }
+        throw new Error(`crew task done: refusing to mark ${arguments_.issue.id} done because ${entry.dir} has ${describeDirtiness(dirtiness)} and no matching PR. Commit or stash the work, open a PR, or rerun with --allow-dirty.`);
+    }
+}
+async function taskDoneCli(argv) {
+    const options = parseDoneOptions(argv);
+    const { config, board } = await loadTaskBoard();
+    const issue = await board.resolveOne(options.taskId);
+    if (issue === undefined) {
+        throw new Error(`Task ${options.taskId} not found across configured sources.`);
+    }
+    await assertCanMarkDone({ config, issue, allowDirty: options.allowDirty });
+    const result = await board.markDone(issue);
+    if (result.outcome === "unsupported") {
+        throw new Error(`crew task done: ${result.reason}`);
+    }
+    writeOutput(`Marked ${issue.id} done.`);
+}
 const VALIDATE_USAGE = `Usage: crew task validate [source]
 
 Options:
@@ -536,6 +619,10 @@ export async function taskCli(argv) {
         await taskCreateCli(rest);
         return;
     }
+    if (verb === "done") {
+        await taskDoneCli(rest);
+        return;
+    }
     if (verb === "validate") {
         await taskValidateCli(rest);
         return;

package/dist/lib/adapters/shell/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AAyErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AA8BD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CA6LZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AAyErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AA8BD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CAsMZ"}

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

@@ -22,6 +22,7 @@
 import { toCanonicalId, } from "../../taskSource.js";
 import { errorMessage, writeError } from "../../util.js";
 import { invokeShellCommand } from "./invoke.js";
+import { parseShellJson } from "./parseOutput.js";
 import { shellFetchOutputSchema, shellIssueSchema, shellValidateOutputSchema, } from "./schema.js";
 const DEFAULT_TIMEOUTS = {
     verify: 10_000,
@@ -134,7 +135,10 @@ export function createShellTaskSource(config, _context) {
             env: config.env,
             sourceName,
         });
-        const parsed = shellFetchOutputSchema.parse(JSON.parse(stdout));
+        const parsed = parseShellJson(shellFetchOutputSchema, stdout, {
+            sourceName,
+            command: "listTasks",
+        });
         return parsed.map((si) => toCanonicalIssue(si, sourceName));
     }
     async function getTask(naturalId) {
@@ -158,7 +162,10 @@ export function createShellTaskSource(config, _context) {
         if (result.exitCode === 3 || result.stdout.trim().length === 0) {
             return null;
         }
-        const parsed = shellIssueSchema.parse(JSON.parse(result.stdout));
+        const parsed = parseShellJson(shellIssueSchema, result.stdout, {
+            sourceName,
+            command: "getTask",
+        });
         return toCanonicalIssue(parsed, sourceName);
     }
     // Shared by markInProgress / markInReview: both pipe the canonical issue's
@@ -259,7 +266,10 @@ export function createShellTaskSource(config, _context) {
             if (trimmed.length === 0) {
                 throw new Error(`shell source "${sourceName}" createTask command produced no output (expected one ShellIssue JSON)`);
             }
-            const parsed = shellIssueSchema.parse(JSON.parse(trimmed));
+            const parsed = parseShellJson(shellIssueSchema, trimmed, {
+                sourceName,
+                command: "createTask",
+            });
             return toCanonicalIssue(parsed, sourceName);
         };
     }

package/dist/lib/adapters/shell/parseOutput.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Friendly stdout parsing for the shell adapter. A shell source emits JSON on
+ * stdout; both `JSON.parse` and the Zod schema can reject it. A raw `ZodError`
+ * stringifies to a JSON array of issues — cryptic, unattributed, and (for a
+ * fetch array) repeated once per task. This module collapses that into a
+ * single user-facing `TaskSourceOutputError` that names the source, the
+ * command, and the offending field(s), with a targeted hint for the common
+ * "missing `agent`" mistake.
+ */
+import type { z } from "zod";
+export interface ShellParseContext {
+    /** The source's configured `name`, surfaced so the user knows which source broke. */
+    sourceName: string;
+    /** The contract method that produced the output, e.g. `"listTasks"` or `"getTask"`. */
+    command: string;
+}
+/**
+ * Parse `stdout` as JSON and validate it against `schema`. On any failure,
+ * throws a `TaskSourceOutputError` with a readable, source-attributed message
+ * instead of a raw `SyntaxError` / `ZodError`.
+ */
+export declare function parseShellJson<T>(schema: z.ZodType<T>, stdout: string, context: ShellParseContext): T;
+//# sourceMappingURL=parseOutput.d.ts.map

package/dist/lib/adapters/shell/parseOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOutput.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/parseOutput.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,CAAC,CAcH"}

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

@@ -0,0 +1,67 @@
+/**
+ * Friendly stdout parsing for the shell adapter. A shell source emits JSON on
+ * stdout; both `JSON.parse` and the Zod schema can reject it. A raw `ZodError`
+ * stringifies to a JSON array of issues — cryptic, unattributed, and (for a
+ * fetch array) repeated once per task. This module collapses that into a
+ * single user-facing `TaskSourceOutputError` that names the source, the
+ * command, and the offending field(s), with a targeted hint for the common
+ * "missing `agent`" mistake.
+ */
+import { TaskSourceOutputError } from "../../taskSource.js";
+import { errorMessage } from "../../util.js";
+/**
+ * Parse `stdout` as JSON and validate it against `schema`. On any failure,
+ * throws a `TaskSourceOutputError` with a readable, source-attributed message
+ * instead of a raw `SyntaxError` / `ZodError`.
+ */
+export function parseShellJson(schema, stdout, context) {
+    let json;
+    try {
+        json = JSON.parse(stdout);
+    }
+    catch (error) {
+        throw new TaskSourceOutputError(`source "${context.sourceName}": the ${context.command} command did not return valid JSON (${errorMessage(error)}).`);
+    }
+    const result = schema.safeParse(json);
+    if (result.success) {
+        return result.data;
+    }
+    throw new TaskSourceOutputError(formatSchemaError(result.error, context));
+}
+/** The last string segment of an issue path — the field name, ignoring array indices. */
+function fieldName(path) {
+    for (let index = path.length - 1; index >= 0; index -= 1) {
+        const segment = path[index];
+        if (typeof segment === "string") {
+            return segment;
+        }
+    }
+    return undefined;
+}
+/** One human-readable phrase describing what's wrong with a single issue. */
+function describeIssue(issue) {
+    const field = fieldName(issue.path);
+    const label = field === undefined ? "field" : `"${field}"`;
+    // Zod v4 reports a missing required key as an `invalid_type` whose message
+    // ends in "received undefined"; there is no separate `received` property to
+    // branch on, so we match the message.
+    if (issue.code === "invalid_type" && issue.message.includes("received undefined")) {
+        return `are missing the required ${label} field`;
+    }
+    return `have an invalid ${label} field: ${issue.message}`;
+}
+function formatSchemaError(error, context) {
+    // A fetch array yields one issue per task (48 tasks missing `agent` → 48
+    // identical issues). Collapse identical phrasings into a single counted line,
+    // preserving first-seen order via the Map's insertion order.
+    const counts = new Map();
+    for (const issue of error.issues) {
+        const description = describeIssue(issue);
+        counts.set(description, (counts.get(description) ?? 0) + 1);
+    }
+    const lines = [...counts].map(([description, count]) => `  • ${count} issue(s) ${description}`);
+    return [
+        `source "${context.sourceName}": the ${context.command} command returned task JSON that doesn't match the expected shape:`,
+        ...lines,
+    ].join("\n");
+}

package/dist/lib/agentLaunch.d.ts

@@ -1,4 +1,5 @@
 import { type LocalRunner, type AgentDefinition, type ResolvedConfig } from "./config.ts";
+import { type WorkerEnvironment } from "./launchCommand.ts";
 /**
  * Stage any srt settings and build the workspace launch command — the assembly
  * shared verbatim by `setupWorkspace` (fresh runs) and `resumeWorkspace`
@@ -16,6 +17,7 @@ export declare function composeAgentLaunch(input: {
     secretsFile?: string | undefined;
     prepareWorktreeCommand?: string | undefined;
     sandboxName?: string | undefined;
+    workerEnvironment?: WorkerEnvironment | undefined;
 }): {
     launchCommand: string;
     srtSettingsDir: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AASrB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA0BhE;AAsBD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+C/B;AAwBD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAOhF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACnD,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA2BhE;AAsBD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqD/B;AAwBD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}