@clipboard-health/groundcrew 4.38.0 → 4.39.0

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

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

package/dist/commands/task.js

@@ -2,6 +2,7 @@ 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 { resolveTaskIdMatches } from "../lib/taskResolution.js";
 import { naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { parseSourceFilterArgs, writeOutput } from "../lib/util.js";
 import { worktrees } from "../lib/worktrees.js";
@@ -387,8 +388,28 @@ function canonicalParts(taskId) {
     }
     return { sourceName, naturalId };
 }
-async function taskFromSource(source, naturalId) {
-    return await source.getTask(naturalId);
+function taskFromResolution({ taskId, resolution, sourceName }) {
+    if (resolution.matches.length === 0) {
+        if (resolution.rejections.length > 0) {
+            throw resolution.rejections[0];
+        }
+        if (sourceName !== undefined) {
+            throw new Error(`Task ${taskId} not found in source "${sourceName}".`);
+        }
+        throw new Error(`Task ${taskId} not found across configured sources.`);
+    }
+    if (resolution.matches.length > 1) {
+        if (resolution.matchKind === "exact" && sourceName === undefined) {
+            throw new Error(`Task id "${taskId}" matched multiple sources: ${resolution.matches.map((task) => task.id).join(", ")}. Re-run with a canonical id or --source <name>.`);
+        }
+        throw new Error(`Task id "${taskId}" matched multiple tasks: ${resolution.matches.map((task) => task.id).join(", ")}. Re-run with a longer prefix or canonical id.`);
+    }
+    const [match] = resolution.matches;
+    /* v8 ignore next 3 @preserve -- matches.length was checked above; guard exists for noUncheckedIndexedAccess */
+    if (match === undefined) {
+        throw new Error(`Task ${taskId} not found across configured sources.`);
+    }
+    return match;
 }
 async function resolveTask(sources, taskId, sourceName) {
     const canonical = canonicalParts(taskId);
@@ -397,47 +418,24 @@ async function resolveTask(sources, taskId, sourceName) {
             throw new Error(`crew task get: canonical id "${taskId}" already names source "${canonical.sourceName}"`);
         }
         const source = findSource(sources, canonical.sourceName);
-        const task = await taskFromSource(source, canonical.naturalId);
-        if (task === null) {
-            throw new Error(`Task ${taskId} not found in source "${source.name}".`);
-        }
-        return task;
+        return taskFromResolution({
+            taskId,
+            sourceName: source.name,
+            resolution: await resolveTaskIdMatches({ sources: [source], naturalId: canonical.naturalId }),
+        });
     }
     if (sourceName !== undefined) {
         const source = findSource(sources, sourceName);
-        const task = await taskFromSource(source, taskId);
-        if (task === null) {
-            throw new Error(`Task ${taskId} not found in source "${source.name}".`);
-        }
-        return task;
-    }
-    const results = await Promise.allSettled(sources.map(async (source) => await taskFromSource(source, taskId)));
-    const matches = [];
-    const rejections = [];
-    for (const result of results) {
-        if (result.status === "fulfilled") {
-            if (result.value !== null) {
-                matches.push(result.value);
-            }
-            continue;
-        }
-        rejections.push(result.reason);
-    }
-    if (matches.length === 0) {
-        if (rejections.length > 0) {
-            throw rejections[0];
-        }
-        throw new Error(`Task ${taskId} not found across configured sources.`);
-    }
-    if (matches.length > 1) {
-        throw new Error(`Task id "${taskId}" matched multiple sources: ${matches.map((task) => task.id).join(", ")}. Re-run with a canonical id or --source <name>.`);
-    }
-    const [match] = matches;
-    /* v8 ignore next 3 @preserve -- matches.length was checked above; guard exists for noUncheckedIndexedAccess */
-    if (match === undefined) {
-        throw new Error(`Task ${taskId} not found across configured sources.`);
-    }
-    return match;
+        return taskFromResolution({
+            taskId,
+            sourceName: source.name,
+            resolution: await resolveTaskIdMatches({ sources: [source], naturalId: taskId }),
+        });
+    }
+    return taskFromResolution({
+        taskId,
+        resolution: await resolveTaskIdMatches({ sources, naturalId: taskId }),
+    });
 }
 function writeTaskDetails(task) {
     writeOutput(task.id);

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AA2DD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,iBAA+C,GAC3D,cAAc,CA4BhB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,UAAU,CAqIZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AA8DD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,iBAA+C,GAC3D,cAAc,CA4BhB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,UAAU,CAkIZ"}

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

@@ -23,17 +23,16 @@ function canonicalBlockerStatus(blocker, statusNames) {
         stateType: blocker.stateType,
         statusNames,
     });
-    if (status !== "other") {
-        return {
+    return status === "other"
+        ? {
+            status,
+            statusReason: blocker.stateType === undefined ? "missing" : "unmapped",
+            ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
+        }
+        : {
             status,
             ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
         };
-    }
-    return {
-        status,
-        statusReason: blocker.stateType === undefined ? "missing" : "unmapped",
-        ...(blocker.status !== undefined && { nativeStatus: blocker.status }),
-    };
 }
 function toCanonicalBlocker(blocker, sourceName, statusNames) {
     const { status, statusReason, nativeStatus } = canonicalBlockerStatus(blocker, statusNames);
@@ -57,6 +56,9 @@ function isLinearNotFoundError(error, naturalId) {
         error.message.startsWith(`Task ${naturalId.toUpperCase()} `) &&
         error.message.includes("not found"));
 }
+function throwLinearLookupError(error) {
+    throw error;
+}
 export function toCanonicalIssue(linearIssue, sourceName, statusNames = DEFAULT_LINEAR_STATUS_NAMES) {
     const sourceRef = {
         uuid: linearIssue.uuid,
@@ -127,10 +129,7 @@ export function createLinearTaskSource(config, context) {
             });
         }
         catch (error) {
-            if (isLinearNotFoundError(error, naturalId)) {
-                return null;
-            }
-            throw error;
+            return isLinearNotFoundError(error, naturalId) ? null : throwLinearLookupError(error);
         }
         const sourceRef = {
             uuid: resolved.uuid,

package/dist/lib/board.d.ts

@@ -9,8 +9,9 @@ export interface Board {
     verify: () => Promise<void>;
     fetch: () => Promise<BoardState>;
     /**
-     * Accepts either canonical (`linear:eng-220`) or natural (`eng-220`) ids.
-     * Natural ids fan out across sources; ambiguous matches throw.
+     * Accepts either canonical (`linear:eng-220`) or natural (`eng-220`) ids,
+     * plus unique prefixes of current listed tasks. Natural ids fan out across
+     * sources; ambiguous matches throw.
      */
     resolveOne: (canonicalOrNaturalId: string) => Promise<Issue | undefined>;
     /** Routes to the adapter whose `name` matches `issue.source`. Unknown source throws. */

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

@@ -1 +1 @@
-{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/lib/board.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,EAAE,CAAC,oBAAoB,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACzE,wFAAwF;IACxF,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AAqBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,KAAK,CAmHjE"}
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/lib/board.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC;;;;OAIG;IACH,UAAU,EAAE,CAAC,oBAAoB,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACzE,wFAAwF;IACxF,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AA0CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,KAAK,CA8FjE"}

package/dist/lib/board.js

@@ -5,6 +5,7 @@
  * back into consumers.
  */
 import { AmbiguousTaskError, } from "./taskSource.js";
+import { resolveTaskIdMatches } from "./taskResolution.js";
 async function callVerify(source) {
     await source.verify();
 }
@@ -17,8 +18,21 @@ async function callFetchParentSkips(source) {
     }
     return [];
 }
-async function callResolveOne(source, naturalId) {
-    return (await source.getTask(naturalId)) ?? undefined;
+function uniqueResolvedIssue({ idArgument, resolution, }) {
+    if (resolution.matches.length === 0) {
+        if (resolution.rejections.length > 0) {
+            throw resolution.rejections[0];
+        }
+        return undefined;
+    }
+    if (resolution.matches.length === 1) {
+        // oxlint-disable-next-line typescript/no-non-null-assertion -- length checked above
+        return resolution.matches[0];
+    }
+    throw new AmbiguousTaskError({
+        naturalId: idArgument,
+        matches: resolution.matches.map((match) => match.id),
+    });
 }
 export function createBoard(sources) {
     const byName = new Map();
@@ -69,7 +83,10 @@ export function createBoard(sources) {
                 if (!source) {
                     throw new Error(`unknown source "${sourceName}" in canonical id "${idArgument}"`);
                 }
-                return await callResolveOne(source, naturalId);
+                return uniqueResolvedIssue({
+                    idArgument,
+                    resolution: await resolveTaskIdMatches({ sources: [source], naturalId }),
+                });
             }
             // Per-source resolveOne errors must not poison sibling resolutions.
             // A source that rejects on a natural-id lookup is treated as "I don't
@@ -78,31 +95,9 @@ export function createBoard(sources) {
             // the rejection — so the user sees a real Linear/network error when
             // there's no fallback, but a stray "not found" from one source doesn't
             // mask a successful match from another.
-            const results = await Promise.allSettled(sources.map(async (s) => await callResolveOne(s, idArgument)));
-            const matches = [];
-            const rejections = [];
-            for (const result of results) {
-                if (result.status === "rejected") {
-                    rejections.push(result.reason);
-                    continue;
-                }
-                if (result.value !== undefined) {
-                    matches.push(result.value);
-                }
-            }
-            if (matches.length === 0) {
-                if (rejections.length > 0) {
-                    throw rejections[0];
-                }
-                return undefined;
-            }
-            if (matches.length === 1) {
-                // oxlint-disable-next-line typescript/no-non-null-assertion -- length checked above
-                return matches[0];
-            }
-            throw new AmbiguousTaskError({
-                naturalId: idArgument,
-                matches: matches.map((m) => m.id),
+            return uniqueResolvedIssue({
+                idArgument,
+                resolution: await resolveTaskIdMatches({ sources, naturalId: idArgument }),
             });
         },
         async markInProgress(issue) {

package/dist/lib/taskResolution.d.ts

@@ -0,0 +1,14 @@
+import { type Task, type TaskSource } from "./taskSource.ts";
+type TaskMatchKind = "exact" | "prefix" | "none";
+export interface TaskResolutionMatches {
+    matches: Task[];
+    rejections: unknown[];
+    matchKind: TaskMatchKind;
+}
+interface CollectExactTaskMatchesArguments {
+    sources: readonly TaskSource[];
+    naturalId: string;
+}
+export declare function resolveTaskIdMatches(arguments_: CollectExactTaskMatchesArguments): Promise<TaskResolutionMatches>;
+export {};
+//# sourceMappingURL=taskResolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskResolution.d.ts","sourceRoot":"","sources":["../../src/lib/taskResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErF,KAAK,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,UAAU,gCAAgC;IACxC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,gCAAgC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAehC"}

package/dist/lib/taskResolution.js

@@ -0,0 +1,53 @@
+import { naturalIdFromCanonical } from "./taskSource.js";
+export async function resolveTaskIdMatches(arguments_) {
+    const exact = await collectExactTaskMatches(arguments_);
+    if (exact.matches.length > 0) {
+        return { ...exact, matchKind: "exact" };
+    }
+    const prefix = await collectPrefixTaskMatches({
+        sources: arguments_.sources,
+        naturalIdPrefix: arguments_.naturalId,
+    });
+    const rejections = [...exact.rejections, ...prefix.rejections];
+    if (prefix.matches.length > 0) {
+        return { matches: prefix.matches, rejections, matchKind: "prefix" };
+    }
+    return { matches: [], rejections, matchKind: "none" };
+}
+async function collectExactTaskMatches({ sources, naturalId, }) {
+    const results = await Promise.allSettled(sources.map(async (source) => await source.getTask(naturalId)));
+    const matches = [];
+    const rejections = [];
+    for (const result of results) {
+        if (result.status === "fulfilled") {
+            if (result.value !== null) {
+                matches.push(result.value);
+            }
+            continue;
+        }
+        rejections.push(result.reason);
+    }
+    return { matches, rejections };
+}
+async function collectPrefixTaskMatches({ sources, naturalIdPrefix, }) {
+    const results = await Promise.allSettled(sources.map(async (source) => {
+        const tasks = await source.listTasks();
+        return tasks.filter((task) => taskMatchesNaturalIdPrefix({ task, naturalIdPrefix }));
+    }));
+    const matches = [];
+    const rejections = [];
+    for (const result of results) {
+        if (result.status === "fulfilled") {
+            matches.push(...result.value);
+            continue;
+        }
+        rejections.push(result.reason);
+    }
+    return { matches, rejections };
+}
+function taskMatchesNaturalIdPrefix({ task, naturalIdPrefix, }) {
+    if (naturalIdPrefix.length === 0) {
+        return false;
+    }
+    return naturalIdFromCanonical(task.id).toLowerCase().startsWith(naturalIdPrefix.toLowerCase());
+}

package/dist/lib/taskSource.js

@@ -36,7 +36,7 @@ export class TaskSourceOutputError extends Error {
 export class AmbiguousTaskError extends Error {
     constructor(arguments_) {
         const { naturalId, matches } = arguments_;
-        super(`Task id "${naturalId}" is ambiguous; matched in multiple sources: ${matches.join(", ")}. Re-invoke with one of those canonical ids.`);
+        super(`Task id "${naturalId}" is ambiguous; matched multiple tasks: ${matches.join(", ")}. Re-invoke with a longer prefix or one of those canonical ids.`);
         this.name = "AmbiguousTaskError";
     }
 }

package/docs/commands.md

@@ -10,7 +10,7 @@ crew task list --source todo --status todo --unblocked
 crew task list --agent claude-fable --repo ClipboardHealth/api --json
 ```
 
-`crew task get <task-id>` prints one normalized task. Canonical IDs such as `todo:GC-20260608-001` route directly to the named source. Natural IDs can be resolved with `--source <name>` or, when unique, by searching all configured sources. If more than one source matches, the command fails and asks for a canonical ID or `--source`.
+`crew task get <task-id>` prints one normalized task. Canonical IDs such as `todo:GC-20260608-001` route directly to the named source. Natural IDs can be resolved with `--source <name>` or, when unique, by searching all configured sources. Exact IDs are tried first; if none match, Groundcrew accepts a unique prefix of a current listed task ID. If more than one task matches, the command fails and prints the matching canonical IDs.
 
 ```bash
 crew task get todo:GC-20260608-001
@@ -44,8 +44,9 @@ crew task create "Fix cancellation retry race" \
 `crew task done <task-id>` marks one task done through its source adapter. Use
 it for completed work that intentionally does not produce a PR. The command
 resolves canonical IDs such as `todo:flaky-triage-1` directly, or natural IDs
-when they match exactly one configured source. Sources without a done writeback
-return an unsupported error.
+when they match exactly one configured source. Exact IDs are tried first; if
+none match, Groundcrew accepts a unique prefix of a current listed task ID.
+Sources without a done writeback return an unsupported error.
 
 Groundcrew checks matching local worktrees before marking a task done. Clean
 worktrees, and tasks with no local worktree, are allowed. A dirty worktree with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.38.0",
+  "version": "4.39.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",