@clipboard-health/groundcrew 4.24.1 → 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/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/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.1",
+  "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",