@clipboard-health/groundcrew 4.24.0 → 4.24.2

package/README.md

@@ -95,7 +95,7 @@ crew init [--global | --local] [--force] [--dry-run]     # create a crew.config.
 crew doctor                                              # check setup
 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 create "Title" --source <name> [--agent <name>] # create a source task
 crew status [<TASK>]                                   # inspect current state or one task
 crew run [--watch]                                       # one-shot or --watch forever
 crew start <TASK>                                      # provision + launch one task now

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

package/dist/commands/dispatcher.js

@@ -6,9 +6,9 @@
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
  * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
-import { dispatchableRepository } from "../lib/repositoryValidation.js";
+import { dispatchableRepository, formatKnownRepositories } from "../lib/repositoryValidation.js";
 import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/taskSource.js";
-import { errorMessage, failMark, log, logEvent } from "../lib/util.js";
+import { errorMessage, failMark, log, logEvent, styleWarning } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { classifyBlockers, classifyEligibility, classifyUsageExhaustion, } from "./eligibility.js";
 import { setupWorkspace } from "./setupWorkspace.js";
@@ -22,6 +22,17 @@ function logSkip(verdict) {
         model: verdict.model,
     });
 }
+function logMissingRepositorySkip(issue, model, knownRepositories) {
+    const task = naturalIdFromCanonical(issue.id);
+    log(styleWarning(`WARNING: ${issue.id} has agent "${model}" but no repository; skipping dispatch. Add --repo <repo> when creating the task, add repo:<repo> to the task line, or set defaultRepository on source "${issue.source}". Known repositories: ${formatKnownRepositories(knownRepositories)}`));
+    logEvent("dispatch", {
+        outcome: "skipped",
+        reason: "missing_repository",
+        task,
+        source: issue.source,
+        model,
+    });
+}
 export function createDispatcher(deps) {
     const { config, board } = deps;
     function buildExhaustedSet(usage) {
@@ -109,20 +120,31 @@ 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 tasks that opted in via an `agent-*` label.
-        // Unlabeled tasks are not groundcrew's concern even when in Todo.
+        const rawTodo = state.issues.filter((issue) => issue.status === "todo");
+        for (const issue of rawTodo) {
+            const { model, repository } = issue;
+            if (model !== undefined && repository === undefined) {
+                logMissingRepositorySkip(issue, model, config.workspace.knownRepositories);
+            }
+        }
+        // Narrow queued work to tasks that opted in with an agent and resolved a
+        // repository. Unlabeled tasks are not groundcrew's concern.
         // Sort by priority so higher-priority tasks fill slots first.
-        const todo = state.issues
-            .filter((issue) => issue.status === "todo" && isGroundcrewIssue(issue))
+        const todo = rawTodo
+            .filter((issue) => isGroundcrewIssue(issue))
             .toSorted((a, b) => prioritySortKey(a.priority) - prioritySortKey(b.priority));
         if (slots <= 0) {
             log(`At capacity (${activeCount}/${config.orchestrator.maximumInProgress})${formatActiveSlotList(active)}, no new work to start${idleSuffix}`);
             return;
         }
-        if (todo.length === 0) {
+        if (rawTodo.length === 0) {
             log(`No Todo tasks to pick up${idleSuffix}`);
             return;
         }
+        if (todo.length === 0) {
+            log(`No eligible Todo tasks after agent/repository filtering${idleSuffix}`);
+            return;
+        }
         // Run the blocker pre-pass first so an all-blocked board short-circuits
         // before the codexbar HTTP call and the cmux/tmux shell-out fire.
         const { unblocked, skips: blockerSkips } = classifyBlockers(todo);

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

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

package/dist/commands/task.js

@@ -1,5 +1,5 @@
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
-import { loadConfig } from "../lib/config.js";
+import { AGENT_ANY_MODEL, loadConfig } from "../lib/config.js";
 import { naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { writeOutput } from "../lib/util.js";
 const TASK_USAGE = `Usage: crew task <subcommand>
@@ -25,7 +25,7 @@ Options:
   --source <name>  Resolve a source-native ID against a specific source.
   --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 CREATE_USAGE = `Usage: crew task create "Short title" --source <source> [--agent <agent>] [options]`;
 const CANONICAL_STATUSES = [
     "todo",
     "in-progress",
@@ -232,12 +232,9 @@ function parseCreateOptions(argv) {
     if (state.sourceName === undefined) {
         throw new Error("crew task create: --source is required");
     }
-    if (state.agent === undefined) {
-        throw new Error("crew task create: --agent is required");
-    }
     const input = {
         title,
-        agent: state.agent,
+        agent: state.agent ?? AGENT_ANY_MODEL,
         projects: state.projects,
         contexts: state.contexts,
         dependencies: state.dependencies,

package/dist/lib/adapters/todo-txt/normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/normalizer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsC,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAqD7E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAYhE"}
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/normalizer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAqD7E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAShE"}

package/dist/lib/adapters/todo-txt/normalizer.js

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { AGENT_ANY_MODEL } from "../../config.js";
 import { toCanonicalId } from "../../taskSource.js";
 import { getMetadataAll, getMetadataFirst, hashLine } from "./parser.js";
 function derivedCanonicalStatus(parsed) {
@@ -58,7 +59,7 @@ export function normalizeToIssue(options) {
     if (id === undefined) {
         return undefined;
     }
-    const agent = getMetadataFirst(parsed, "agent");
+    const agent = getMetadataFirst(parsed, "agent") ?? AGENT_ANY_MODEL;
     const status = derivedCanonicalStatus(parsed);
     const repository = getMetadataFirst(parsed, "repo") ?? defaultRepository;
     const depIds = getMetadataAll(parsed, "dep");
@@ -96,9 +97,6 @@ export function isActiveForFetch(parsed) {
     if (getMetadataFirst(parsed, "id") === undefined) {
         return false;
     }
-    if (getMetadataFirst(parsed, "agent") === undefined) {
-        return false;
-    }
     const statusValue = getMetadataFirst(parsed, "status");
     return statusValue === "todo" || statusValue === "in-progress" || statusValue === "in-review";
 }

package/dist/lib/adapters/todo-txt/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA+QxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,cAAc,GACvB,UAAU,CA4IZ"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA0RxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,cAAc,GACvB,UAAU,CA4IZ"}

package/dist/lib/adapters/todo-txt/source.js

@@ -8,13 +8,23 @@ import { getMetadataFirst, parseAllLines } from "./parser.js";
 import { copyPromptFile, updateTaskStatus, validateTodoFile, withLock } from "./writeback.js";
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 const RECURRENCE_RE = /^\+?\d+[dwmy]$/;
-function readDescription(promptPath) {
+function readPromptFile(promptPath) {
     try {
         return readFileSync(promptPath, "utf8");
     }
     catch {
-        return "";
+        return undefined;
+    }
+}
+function descriptionFor(parsed, promptPath) {
+    const promptContent = readPromptFile(promptPath);
+    if (promptContent !== undefined && promptContent.trim().length > 0) {
+        return promptContent;
+    }
+    if (parsed.title.trim().length > 0) {
+        return `${parsed.title}\n`;
     }
+    return promptContent ?? "";
 }
 function fileUpdatedAt(filePath) {
     try {
@@ -51,7 +61,7 @@ function buildIssue(options) {
     }
     const promptOverride = getMetadataFirst(parsed, "prompt");
     const promptPath = promptOverride ?? `${tasksDir}/${id}.md`;
-    const description = readDescription(promptPath);
+    const description = descriptionFor(parsed, promptPath);
     return normalizeToIssue({
         parsed,
         allParsed: parsedAll,

package/dist/lib/adapters/todo-txt/writeback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/writeback.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAoKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQxF;AAED,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AA6E3D,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsElC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrE;AAwFD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA0C7E"}
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/writeback.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAoKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQxF;AAED,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AA6E3D,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsElC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrE;AA4FD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA0C7E"}

package/dist/lib/adapters/todo-txt/writeback.js

@@ -262,16 +262,19 @@ export function copyPromptFile(oldPath, newPath) {
         // prompt file is optional — copy is best-effort
     }
 }
-function validatePromptFile(tasksDir, id, promptOverride, prefix, errors) {
+function validatePromptFile(tasksDir, id, promptOverride, title, prefix, errors) {
     const promptPath = promptOverride ?? path.join(tasksDir, `${id}.md`);
+    const shouldRequirePrompt = promptOverride !== undefined || title.trim().length === 0;
     try {
         const desc = readFileSync(promptPath, "utf8");
-        if (desc.trim().length === 0) {
+        if (desc.trim().length === 0 && shouldRequirePrompt) {
             errors.push(`${prefix}: empty prompt file "${promptPath}" for ready task "${id}"`);
         }
     }
     catch {
-        errors.push(`${prefix}: missing prompt file "${promptPath}" for ready task "${id}"`);
+        if (shouldRequirePrompt) {
+            errors.push(`${prefix}: missing prompt file "${promptPath}" for ready task "${id}"`);
+        }
     }
 }
 function validateDepsAndDates(parsed, parsedAll, id, prefix, errors) {
@@ -308,7 +311,7 @@ function validateActiveTaskLine(parsed, parsedAll, tasksDir, id, prefix, errors)
         errors.push(`${prefix}: task "${id}" has status:todo but it is not the final token — task will not be dispatched`);
     }
     if (statusValue === "todo" && parsed.isStatusFinalToken) {
-        validatePromptFile(tasksDir, id, parsed.metadata["prompt"]?.[0], prefix, errors);
+        validatePromptFile(tasksDir, id, parsed.metadata["prompt"]?.[0], parsed.title, prefix, errors);
     }
     validateDepsAndDates(parsed, parsedAll, id, prefix, errors);
 }
@@ -340,7 +343,7 @@ export function validateTodoFile(todoPath, tasksDir) {
                 idsSeen.set(lower, lineNum);
             }
         }
-        if (id === undefined || parsed.metadata["agent"] === undefined) {
+        if (id === undefined) {
             continue;
         }
         if (parsed.completed) {

package/dist/lib/repositoryValidation.d.ts

@@ -9,5 +9,6 @@
  * the tick across N sources.
  */
 import type { Issue } from "./taskSource.ts";
+export declare function formatKnownRepositories(knownRepositories: readonly string[]): string;
 export declare function dispatchableRepository(issue: Issue, knownRepositories: readonly string[], log: (message: string) => void): string | undefined;
 //# sourceMappingURL=repositoryValidation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"repositoryValidation.d.ts","sourceRoot":"","sources":["../../src/lib/repositoryValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,MAAM,GAAG,SAAS,CAWpB"}
+{"version":3,"file":"repositoryValidation.d.ts","sourceRoot":"","sources":["../../src/lib/repositoryValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,MAAM,GAAG,SAAS,CAWpB"}

package/dist/lib/repositoryValidation.js

@@ -8,12 +8,15 @@
  * the MVP-2 plan): one badly-labelled task should not throw and abort
  * the tick across N sources.
  */
+export function formatKnownRepositories(knownRepositories) {
+    return knownRepositories.join(", ") || "(none)";
+}
 export function dispatchableRepository(issue, knownRepositories, log) {
     if (issue.repository === undefined) {
         return undefined;
     }
     if (!knownRepositories.includes(issue.repository)) {
-        log(`issue ${issue.id} references unknown repository ${issue.repository}; configured workspace.knownRepositories: ${knownRepositories.join(", ") || "(none)"}`);
+        log(`issue ${issue.id} references unknown repository ${issue.repository}; configured workspace.knownRepositories: ${formatKnownRepositories(knownRepositories)}`);
         return undefined;
     }
     return issue.repository;

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

@@ -1 +1 @@
-{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../src/lib/runState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;CACH;AAaD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAmFD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA0BnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAc/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzE"}
+{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../src/lib/runState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;CACH;AAQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAmFD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA0BnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAc/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzE"}

package/dist/lib/runState.js

@@ -1,13 +1,9 @@
 import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
-const TASK_RE = /^[a-z][\da-z]*-\d+$/;
+import { normalizePlainTaskId } from "./taskId.js";
 const RUN_STATE_DIRECTORY_NAME = "runs";
 function taskKey(task) {
-    const normalized = task.toLowerCase();
-    if (!TASK_RE.test(normalized)) {
-        throw new Error(`Invalid task "${task}": must be a plain task id`);
-    }
-    return normalized;
+    return normalizePlainTaskId(task);
 }
 export function runStateDirectory(config) {
     return path.resolve(path.dirname(config.logging.file), RUN_STATE_DIRECTORY_NAME);

package/dist/lib/taskId.d.ts

@@ -0,0 +1,4 @@
+export declare function isPlainTaskId(task: string): boolean;
+export declare function assertPlainTaskId(task: string): void;
+export declare function normalizePlainTaskId(task: string): string;
+//# sourceMappingURL=taskId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskId.d.ts","sourceRoot":"","sources":["../../src/lib/taskId.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/lib/taskId.js

@@ -0,0 +1,19 @@
+const PLAIN_TASK_ID_RE = /^[a-z][\da-z]*(?:-[\da-z]+)*-\d+$/;
+function invalidPlainTaskIdError(task) {
+    return new Error(`Invalid task "${task}": must be a plain task id`);
+}
+export function isPlainTaskId(task) {
+    return PLAIN_TASK_ID_RE.test(task);
+}
+export function assertPlainTaskId(task) {
+    if (!isPlainTaskId(task)) {
+        throw invalidPlainTaskIdError(task);
+    }
+}
+export function normalizePlainTaskId(task) {
+    const normalized = task.toLowerCase();
+    if (!isPlainTaskId(normalized)) {
+        throw invalidPlainTaskIdError(task);
+    }
+    return normalized;
+}

package/dist/lib/worktrees.d.ts

@@ -18,7 +18,7 @@ export declare class WorktreeAlreadyExistsError extends Error {
 export declare function isWorktreeAlreadyExistsError(error: unknown): error is WorktreeAlreadyExistsError;
 export interface WorktreeEntry {
     repository: string;
-    /** Linear task id, lowercased — e.g. "team-220". */
+    /** Source task id, lowercased — e.g. "team-220" or "gc-20260608-001". */
     task: string;
     /** Slash-free `<prefix>-<task>`. */
     branchName: string;

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

@@ -1 +1 @@
-{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,KAAK,cAAc,EAAsC,MAAM,aAAa,CAAC;AAGtF,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,iBAAS,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAgQD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEzE;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAuBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}
+{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,KAAK,cAAc,EAAsC,MAAM,aAAa,CAAC;AAItF,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,iBAAS,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AA4QD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEzE;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAuBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}

package/dist/lib/worktrees.js

@@ -14,6 +14,7 @@ import path from "node:path";
 import { runCommandAsync } from "./commandRunner.js";
 import { repositoryBaseDir, worktreeBaseDir } from "./config.js";
 import { resolveDefaultBranch } from "./defaultBranch.js";
+import { assertPlainTaskId, isPlainTaskId } from "./taskId.js";
 import { debug, errorMessage, isVerbose } from "./util.js";
 import { workspaces } from "./workspaces.js";
 const WORKTREE_LIST_PREFIX = "worktree ";
@@ -28,8 +29,6 @@ export class WorktreeAlreadyExistsError extends Error {
 export function isWorktreeAlreadyExistsError(error) {
     return error instanceof WorktreeAlreadyExistsError;
 }
-const TASK_RE = /^[a-z][\da-z]*-\d+$/;
-const TASK_DIR_RE = /^(?<repoBasename>.+)-(?<task>[a-z][\da-z]*-\d+)$/;
 function branchPrefix(config) {
     const fromConfig = config.git.branchPrefix;
     if (fromConfig !== undefined) {
@@ -58,9 +57,7 @@ function basePaths(config, repository, task) {
     // Tasks must match the same shape the worktree discovery regexes use,
     // so create()/list()/findByTask() agree on what's a valid worktree.
     // This also rejects traversal tokens before they reach path.resolve().
-    if (!TASK_RE.test(task)) {
-        throw new Error(`Invalid task "${task}": must be a plain task id`);
-    }
+    assertPlainTaskId(task);
     const repoDir = repoDirFor(config, repository);
     const hostWorktreeName = `${repository}-${task}`;
     const hostWorktreeDir = path.resolve(worktreeBaseDir(config), hostWorktreeName);
@@ -75,6 +72,22 @@ function basePaths(config, repository, task) {
 function signalProperty(signal) {
     return signal === undefined ? {} : { signal };
 }
+function parseWorktreeDirectoryName(directoryName, repositoryEntriesByLongestName) {
+    // Match the longest repository basename first so overlapping names like
+    // "repo-a" and "repo-a-admin" parse to the intended repository.
+    for (const [repositoryBaseName, repository] of repositoryEntriesByLongestName) {
+        const worktreePrefix = `${repositoryBaseName}-`;
+        if (!directoryName.startsWith(worktreePrefix)) {
+            continue;
+        }
+        const task = directoryName.slice(worktreePrefix.length);
+        if (!isPlainTaskId(task)) {
+            continue;
+        }
+        return { repository, task };
+    }
+    return undefined;
+}
 /**
  * Runs a long-running git command (fetch, worktree add/remove/prune) with no
  * timeout. Under --verbose the git porcelain streams live to the terminal;
@@ -147,6 +160,7 @@ function listWorktrees(config) {
         repoByBasename.set(basename, repository);
     }
     for (const [parentDir, repoByBasename] of reposByParent) {
+        const repositoryEntriesByLongestName = [...repoByBasename.entries()].toSorted(([nameA], [nameB]) => nameB.length - nameA.length);
         let children;
         try {
             children = readdirSync(parentDir, { withFileTypes: true });
@@ -158,23 +172,14 @@ function listWorktrees(config) {
             if (!entry.isDirectory()) {
                 continue;
             }
-            const match = TASK_DIR_RE.exec(entry.name);
-            if (!match) {
-                continue;
-            }
-            const [, repoBasename, task] = match;
-            /* v8 ignore next 3 @preserve -- TASK_DIR_RE always captures both groups when it matches */
-            if (repoBasename === undefined || task === undefined) {
-                continue;
-            }
-            const repository = repoByBasename.get(repoBasename);
-            if (repository === undefined) {
+            const parsed = parseWorktreeDirectoryName(entry.name, repositoryEntriesByLongestName);
+            if (parsed === undefined) {
                 continue;
             }
             entries.push({
-                repository,
-                task,
-                branchName: branchNameForTask(config, task),
+                repository: parsed.repository,
+                task: parsed.task,
+                branchName: branchNameForTask(config, parsed.task),
                 dir: path.resolve(parentDir, entry.name),
                 kind: "host",
             });

package/docs/commands.md

@@ -18,7 +18,7 @@ crew task get GC-20260608-001 --source todo
 crew task get todo:GC-20260608-001 --prompt
 ```
 
-`crew task create "Short title" --source <source> --agent <agent>` creates a task in a source that supports creation. Todo.txt creation appends the todo line, defaults to priority `A` unless `--priority` is provided, writes `.tasks/<id>.md`, and leaves `status:todo` as the final meaningful token, so no separate ready command is required.
+`crew task create "Short title" --source <source> [--agent <agent>]` creates a task in a source that supports creation. When `--agent` is omitted, it defaults to `any`. Todo.txt creation appends the todo line, defaults to priority `A` unless `--priority` is provided, writes `.tasks/<id>.md`, and leaves `status:todo` as the final meaningful token, so no separate ready command is required. Hand-written todo-txt lines can omit `.tasks/<id>.md` when the line has a non-empty title; that title becomes the prompt text.
 
 ```bash
 crew task create "Fix cancellation retry race" \

package/docs/task-sources.md

@@ -78,7 +78,7 @@ export default {
 };
 ```
 
-Creating a todo task appends a line with `status:todo` as the final meaningful token and writes the prompt to `.tasks/<id>.md`. New todo tasks default to priority `A`; pass `--priority <letter>` to override it.
+Creating a todo task appends a line with `status:todo` as the final meaningful token and writes the prompt to `.tasks/<id>.md`. New todo tasks default to priority `A`; pass `--priority <letter>` to override it. If `--agent` is omitted, the task uses `agent:any`.
 
 ```bash
 crew task create "Fix cancellation retry race" \
@@ -94,6 +94,12 @@ crew task create "Fix cancellation retry race" \
 (A) Fix cancellation retry race +marketplace @backend id:GC-20260608-001 repo:ClipboardHealth/api agent:codex status:todo
 ```
 
+For hand-written todo lines, a non-empty title is enough prompt text when `.tasks/<id>.md` is absent. Omit `agent:` to default to `agent:any`:
+
+```txt
+Say goodbye repo:ClipboardHealth/groundcrew id:GC-20260608-002 status:todo
+```
+
 ## Linear
 
 The built-in Linear source supports listing, getting, writeback, and task creation through `crew task create`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.24.0",
+  "version": "4.24.2",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -81,7 +81,7 @@
     "@nx/js": "22.7.5",
     "@tsconfig/node24": "24.0.4",
     "@tsconfig/strictest": "2.0.8",
-    "@types/node": "25.9.1",
+    "@types/node": "25.9.2",
     "@typescript/native-preview": "7.0.0-dev.20260604.1",
     "@vitest/coverage-v8": "4.1.8",
     "cspell": "10.0.1",