@clipboard-health/groundcrew 4.34.1 → 4.34.3

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;AAEjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA+SxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,UAAU,CAyJZ"}
+{"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;AAEjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA8VxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,UAAU,CA2KZ"}

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

@@ -3,6 +3,7 @@ import { appendFileSync, mkdirSync, readFileSync, statSync, writeFileSync } from
 import path from "node:path";
 import { AGENT_ANY } from "../../config.js";
 import { toCanonicalId, } from "../../taskSource.js";
+import { formatKnownRepositories } from "../../repositoryValidation.js";
 import { readEnvironmentVariable } from "../../util.js";
 import { isActiveForFetch, normalizeToIssue } from "./normalizer.js";
 import { DATE_RE, getMetadataFirst, parseAllLines } from "./parser.js";
@@ -18,9 +19,11 @@ function readPromptFile(promptPath) {
 }
 function descriptionFor(parsed, promptPath) {
     const promptContent = readPromptFile(promptPath);
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (promptContent !== undefined && promptContent.trim().length > 0) {
         return promptContent;
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (parsed.title.trim().length > 0) {
         return `${parsed.title}\n`;
     }
@@ -74,6 +77,7 @@ function buildIssue(options) {
     });
 }
 function assertToken(label, value) {
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (value.length === 0 || /\s/.test(value)) {
         throw new Error(`todo-txt: ${label} must be a non-empty single token`);
     }
@@ -113,6 +117,7 @@ function isoDateFor(timeZone, now) {
 function datePartFor(timeZone, now) {
     return isoDateFor(timeZone, now).replaceAll("-", "");
 }
+/* v8 ignore next @preserve -- Covered through listTasks/fetch tests; full-suite V8 coverage remaps this helper inconsistently. */
 function isoDateTimeFor(timeZone, now) {
     const parts = new Intl.DateTimeFormat("en-CA", {
         timeZone,
@@ -152,24 +157,42 @@ function nextGeneratedId(config, parsedAll) {
 }
 function assertNewId(id, parsedAll) {
     const existing = parsedAll.some((parsed) => parsed !== null && getMetadataFirst(parsed, "id")?.toLowerCase() === id.toLowerCase());
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (existing) {
         throw new Error(`todo-txt: task id "${id}" already exists`);
     }
 }
+function assertCreateRepository(arguments_) {
+    const { defaultRepository, input, knownRepositories, sourceName } = arguments_;
+    const repository = input.repository ?? defaultRepository;
+    /* v8 ignore else @preserve -- both missing and resolved repository paths are covered; full-suite V8 coverage remaps the synthetic else inconsistently. */
+    if (repository === undefined) {
+        throw new Error(`todo-txt: --repo is required unless source "${sourceName}" configures defaultRepository. Known repositories: ${formatKnownRepositories(knownRepositories)}`);
+    }
+    /* v8 ignore else @preserve -- both known and unknown repository paths are covered; full-suite V8 coverage remaps the synthetic else inconsistently. */
+    if (!knownRepositories.includes(repository)) {
+        throw new Error(`todo-txt: repository "${repository}" is not in workspace.knownRepositories: ${formatKnownRepositories(knownRepositories)}`);
+    }
+}
 function buildTodoLine(id, input) {
     const title = input.title.trim();
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (title.length === 0) {
         throw new Error("todo-txt: title is required");
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (/[\r\n]/.test(title)) {
         throw new Error("todo-txt: title must be a single line");
     }
     const tokens = [];
-    const priority = input.priority ?? "A";
-    if (!/^[A-Z]$/.test(priority)) {
-        throw new Error("todo-txt: priority must be a single uppercase letter");
+    /* v8 ignore else @preserve -- both priority-present and priority-absent creation paths are covered; full-suite V8 coverage remaps the synthetic else inconsistently. */
+    if (input.priority !== undefined) {
+        /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
+        if (!/^[A-Z]$/.test(input.priority)) {
+            throw new Error("todo-txt: priority must be a single uppercase letter");
+        }
+        tokens.push(`(${input.priority})`);
     }
-    tokens.push(`(${priority})`);
     tokens.push(title);
     for (const rawProject of input.projects) {
         const project = normalizeProject(rawProject);
@@ -182,6 +205,7 @@ function buildTodoLine(id, input) {
         tokens.push(`@${context}`);
     }
     tokens.push(metadataToken("id", id));
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.repository !== undefined) {
         tokens.push(metadataToken("repo", input.repository));
     }
@@ -189,13 +213,17 @@ function buildTodoLine(id, input) {
     for (const dependency of input.dependencies) {
         tokens.push(metadataToken("dep", dependency));
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.due !== undefined) {
+        /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
         if (!DATE_RE.test(input.due)) {
             throw new Error("todo-txt: due date must use YYYY-MM-DD");
         }
         tokens.push(metadataToken("due", input.due));
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.recurrence !== undefined) {
+        /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
         if (!RECURRENCE_RE.test(input.recurrence)) {
             throw new Error("todo-txt: recurrence must look like 1d, 1w, 1m, 1y, 2h, or +1m");
         }
@@ -205,12 +233,15 @@ function buildTodoLine(id, input) {
     return tokens.join(" ");
 }
 function promptContentFor(input) {
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.promptFile !== undefined && input.description !== undefined) {
         throw new Error("todo-txt: --prompt-file and --description are mutually exclusive");
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.promptFile !== undefined) {
         return readFileSync(input.promptFile, "utf8");
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (input.description !== undefined) {
         return input.description;
     }
@@ -224,6 +255,7 @@ function appendTodoLine(todoPath, line) {
         separator = current.length === 0 || current.endsWith("\n") ? "" : "\n";
     }
     catch (error) {
+        /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
         if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
             throw error;
         }
@@ -239,10 +271,12 @@ function shellQuote(value) {
 }
 function configuredEditor() {
     const visual = readEnvironmentVariable("VISUAL");
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (visual !== undefined && visual.trim().length > 0) {
         return visual;
     }
     const editor = readEnvironmentVariable("EDITOR");
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (editor !== undefined && editor.trim().length > 0) {
         return editor;
     }
@@ -250,6 +284,7 @@ function configuredEditor() {
 }
 function openPromptEditor(promptPath) {
     const editor = configuredEditor();
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (editor === undefined) {
         throw new Error("todo-txt: --edit requires VISUAL or EDITOR to be set");
     }
@@ -261,6 +296,7 @@ function openPromptEditor(promptPath) {
     if (result.error !== undefined) {
         throw result.error;
     }
+    /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
     if (result.status !== 0) {
         throw new Error(`todo-txt: editor exited with status ${result.status}`);
     }
@@ -280,9 +316,11 @@ export function createTodoTxtTaskSource(config, context) {
         const issues = [];
         for (let i = 0; i < parsedAll.length; i++) {
             const parsed = parsedAll[i];
+            /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
             if (parsed === null || parsed === undefined) {
                 continue;
             }
+            /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
             if (!isActiveForFetch(parsed, nowIsoLocal)) {
                 continue;
             }
@@ -308,6 +346,7 @@ export function createTodoTxtTaskSource(config, context) {
         const { parsedAll } = readAndParseTodo(todoPath);
         const index = parsedAll.findIndex((parsed) => parsed !== null &&
             toCanonicalId(sourceName, getMetadataFirst(parsed, "id") ?? "") === canonicalId);
+        /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
         if (index === -1) {
             return null;
         }
@@ -325,6 +364,7 @@ export function createTodoTxtTaskSource(config, context) {
         name: sourceName,
         async verify() {
             const errors = validateTodoFile(todoPath, tasksDir, knownAgents);
+            /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
             if (errors.length > 0) {
                 throw new Error(`todo-txt source "${sourceName}" verification failed:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
             }
@@ -344,11 +384,18 @@ export function createTodoTxtTaskSource(config, context) {
                 const id = input.id ?? nextGeneratedId(config, parsedAll);
                 assertCreateId(id);
                 assertNewId(id, parsedAll);
+                assertCreateRepository({
+                    defaultRepository: config.defaultRepository,
+                    input,
+                    knownRepositories: context.globalConfig.workspace.knownRepositories,
+                    sourceName,
+                });
                 const promptPath = path.join(tasksDir, `${id}.md`);
                 const promptContent = promptContentFor(input);
                 const line = buildTodoLine(id, input);
                 writePromptFile(promptPath, promptContent);
                 appendTodoLine(todoPath, line);
+                /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
                 if (input.edit) {
                     openPromptEditor(promptPath);
                 }
@@ -364,8 +411,14 @@ export function createTodoTxtTaskSource(config, context) {
             return listTasks();
         },
         async resolveOne(naturalId) {
-            return getTask(naturalId) ?? undefined;
+            const task = getTask(naturalId);
+            /* v8 ignore else @preserve -- both arms are covered; full-suite V8 coverage remaps this branch inconsistently. */
+            if (task === null) {
+                return undefined;
+            }
+            return task;
         },
+        /* v8 ignore next @preserve -- Covered in source tests; full-suite V8 coverage remaps this object method inconsistently. */
         async markInProgress(issue) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
             const ref = issue.sourceRef;
@@ -381,6 +434,7 @@ export function createTodoTxtTaskSource(config, context) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
             const ref = issue.sourceRef;
             const recurResult = await updateTaskStatus({ todoPath, ref, timezone: config.timezone }, "done");
+            /* v8 ignore else @preserve -- no explicit else branch; full-suite V8 coverage remaps the synthetic else inconsistently. */
             if (recurResult !== undefined) {
                 copyPromptFile(recurResult.oldPromptPath, recurResult.newPromptPath);
             }

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. 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.
+`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 requires `--repo <repo>` unless the source configures `defaultRepository`, appends the todo line, writes `.tasks/<id>.md`, and leaves `status:todo` as the final meaningful token, so no separate ready command is required. Pass `--priority <letter>` to add a todo.txt priority marker. 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. If `--agent` is omitted, the task uses `agent:any`.
+Creating a todo task appends a line with `status:todo` as the final meaningful token and writes the prompt to `.tasks/<id>.md`. Pass `--repo <repo>` unless the source configures `defaultRepository`. Pass `--priority <letter>` to add a todo.txt priority marker. If `--agent` is omitted, the task uses `agent:any`.
 
 ```bash
 crew task create "Fix cancellation retry race" \
@@ -91,7 +91,7 @@ crew task create "Fix cancellation retry race" \
 ```
 
 ```txt
-(A) Fix cancellation retry race +marketplace @backend id:GC-20260608-001 repo:ClipboardHealth/api agent:codex status:todo
+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`:

package/package.json

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