@clipboard-health/groundcrew 4.35.0 → 4.35.1

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/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/taskSource.d.ts

@@ -210,6 +210,19 @@ export declare class RepositoryResolutionError extends Error {
         repositories: readonly string[];
     });
 }
+/**
+ * A task source returned output that groundcrew could not parse — non-JSON
+ * stdout, or JSON that doesn't match the source's contract (e.g. a shell
+ * script's `listTasks` payload missing the required `agent` field). Carries a
+ * user-facing message that names the source and what was wrong.
+ *
+ * Marked deterministic: re-running the same command yields the same bad
+ * output, so the orchestrator's `withRetry` must NOT retry it (retrying only
+ * delays a guaranteed failure behind confusing "Retrying in Ns" lines).
+ */
+export declare class TaskSourceOutputError extends Error {
+    constructor(message: string);
+}
 export declare class AmbiguousTaskError extends Error {
     constructor(arguments_: {
         naturalId: string;

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

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

package/dist/lib/taskSource.js

@@ -17,6 +17,22 @@ export class RepositoryResolutionError extends Error {
         this.name = "RepositoryResolutionError";
     }
 }
+/**
+ * A task source returned output that groundcrew could not parse — non-JSON
+ * stdout, or JSON that doesn't match the source's contract (e.g. a shell
+ * script's `listTasks` payload missing the required `agent` field). Carries a
+ * user-facing message that names the source and what was wrong.
+ *
+ * Marked deterministic: re-running the same command yields the same bad
+ * output, so the orchestrator's `withRetry` must NOT retry it (retrying only
+ * delays a guaranteed failure behind confusing "Retrying in Ns" lines).
+ */
+export class TaskSourceOutputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TaskSourceOutputError";
+    }
+}
 export class AmbiguousTaskError extends Error {
     constructor(arguments_) {
         const { naturalId, matches } = arguments_;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.35.0",
+  "version": "4.35.1",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -82,7 +82,7 @@
     "@tsconfig/node24": "24.0.4",
     "@tsconfig/strictest": "2.0.8",
     "@types/node": "25.9.2",
-    "@typescript/native-preview": "7.0.0-dev.20260606.1",
+    "@typescript/native-preview": "7.0.0-dev.20260608.1",
     "@vitest/coverage-v8": "4.1.8",
     "cspell": "10.0.1",
     "dependency-cruiser": "17.4.3",