@clipboard-health/groundcrew 4.19.0 → 4.20.1

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

@@ -1 +1 @@
-{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Ff;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}
+{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAuID,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Ff;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -1,5 +1,6 @@
 import { fetchResolvedIssue } from "../lib/adapters/linear/fetch.js";
 import { getLinearClient } from "../lib/adapters/linear/client.js";
+import { isLinearEnabled } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
 import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { buildLaunchCommand } from "../lib/launchCommand.js";
@@ -41,8 +42,11 @@ async function contextFromLinear(config, task, worktree) {
         resumeCount: 0,
     };
 }
-async function contextFromState(task, state, worktree) {
-    const details = await fetchTaskDetails(task);
+async function contextFromState(config, task, state, worktree) {
+    // Skip the Linear lookup when Linear is disabled — otherwise the
+    // missing-API-key error logs noisily even though resume only needs it to
+    // enrich the prompt title/description (which falls back to the task id).
+    const details = isLinearEnabled(config) ? await fetchTaskDetails(task) : undefined;
     return {
         task,
         repository: state.repository,
@@ -64,7 +68,13 @@ async function buildResumeContext(config, task) {
         throw new Error(`No worktree found for ${task}; cannot resume.`);
     }
     if (state !== undefined) {
-        return await contextFromState(task, state, worktree);
+        return await contextFromState(config, task, state, worktree);
+    }
+    // The cold-resume path resolves repository + model from Linear alone, so it
+    // can't proceed when Linear is disabled. Fail with a clear reason instead of
+    // the cryptic missing-API-key error getLinearClient() would otherwise raise.
+    if (!isLinearEnabled(config)) {
+        throw new Error(`Cannot resume ${task}: no run state recorded and Linear is disabled.`);
     }
     return await contextFromLinear(config, task, worktree);
 }

package/dist/lib/adapters/todo-txt/index.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterDefinition } from "../../adapterDefinition.ts";
+import { todoTxtAdapterConfigSchema } from "./schema.ts";
+declare const definition: AdapterDefinition<typeof todoTxtAdapterConfigSchema>;
+export default definition;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,0BAA0B,CAIpE,CAAC;eAEa,UAAU"}

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

@@ -0,0 +1,8 @@
+import { createTodoTxtTaskSource } from "./source.js";
+import { todoTxtAdapterConfigSchema } from "./schema.js";
+const definition = {
+    kind: "todo-txt",
+    configSchema: todoTxtAdapterConfigSchema,
+    create: createTodoTxtTaskSource,
+};
+export default definition;

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

@@ -0,0 +1,22 @@
+import { type Issue } from "../../taskSource.ts";
+import { type ParsedTodoLine } from "./parser.ts";
+export interface TodoTxtSourceRef {
+    sourceName: string;
+    todoPath: string;
+    id: string;
+    lineFingerprint: string;
+    promptPath: string;
+}
+export interface NormalizeOptions {
+    parsed: ParsedTodoLine;
+    allParsed: (ParsedTodoLine | null)[];
+    sourceName: string;
+    todoPath: string;
+    tasksDir: string;
+    defaultRepository: string | undefined;
+    description: string;
+    updatedAt: string;
+}
+export declare function normalizeToIssue(options: NormalizeOptions): Issue | undefined;
+export declare function isActiveForFetch(parsed: ParsedTodoLine): boolean;
+//# sourceMappingURL=normalizer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,104 @@
+import path from "node:path";
+import { toCanonicalId } from "../../taskSource.js";
+import { getMetadataAll, getMetadataFirst, hashLine } from "./parser.js";
+function derivedCanonicalStatus(parsed) {
+    if (parsed.completed) {
+        return "done";
+    }
+    const statusValue = getMetadataFirst(parsed, "status");
+    if (statusValue === "todo") {
+        return parsed.isStatusFinalToken ? "todo" : "other";
+    }
+    if (statusValue === "in-progress") {
+        return "in-progress";
+    }
+    if (statusValue === "in-review") {
+        return "in-review";
+    }
+    if (statusValue === "done") {
+        return "done";
+    }
+    return "other";
+}
+function priorityToNumber(priority) {
+    if (priority === undefined) {
+        return undefined;
+    }
+    /* v8 ignore next @preserve -- codePointAt(0) on non-empty string never returns undefined */
+    const code = priority.codePointAt(0) ?? 0;
+    /* v8 ignore next @preserve -- same: "A" is a non-empty string literal */
+    const baseCode = "A".codePointAt(0) ?? 65;
+    return code - baseCode + 1;
+}
+function resolveBlocker(depId, allParsed, sourceName) {
+    const found = allParsed.find((p) => p !== null && getMetadataFirst(p, "id")?.toLowerCase() === depId.toLowerCase());
+    const id = toCanonicalId(sourceName, depId);
+    if (found === undefined) {
+        return {
+            id,
+            title: depId,
+            status: "other",
+            statusReason: "missing",
+        };
+    }
+    const status = derivedCanonicalStatus(found);
+    const nativeStatus = found.completed ? "x" : (getMetadataFirst(found, "status") ?? "(no status)");
+    return {
+        id,
+        title: found.title || depId,
+        status,
+        ...(status === "other" && { statusReason: "unmapped" }),
+        nativeStatus,
+    };
+}
+export function normalizeToIssue(options) {
+    const { parsed, allParsed, sourceName, todoPath, tasksDir, defaultRepository, description, updatedAt, } = options;
+    const id = getMetadataFirst(parsed, "id");
+    /* v8 ignore next @preserve -- callers always pre-filter for id: before invoking */
+    if (id === undefined) {
+        return undefined;
+    }
+    const agent = getMetadataFirst(parsed, "agent");
+    const status = derivedCanonicalStatus(parsed);
+    const repository = getMetadataFirst(parsed, "repo") ?? defaultRepository;
+    const depIds = getMetadataAll(parsed, "dep");
+    const blockers = depIds.map((depId) => resolveBlocker(depId, allParsed, sourceName));
+    const promptOverride = getMetadataFirst(parsed, "prompt");
+    const promptPath = promptOverride ?? path.join(tasksDir, `${id}.md`);
+    const sourceRef = {
+        sourceName,
+        todoPath,
+        id,
+        lineFingerprint: hashLine(parsed.raw),
+        promptPath,
+    };
+    const priority = priorityToNumber(parsed.priority);
+    return {
+        id: toCanonicalId(sourceName, id),
+        source: sourceName,
+        title: parsed.title,
+        description,
+        status,
+        repository,
+        model: agent,
+        assignee: "",
+        updatedAt,
+        blockers,
+        hasMoreBlockers: false,
+        ...(priority !== undefined && { priority }),
+        sourceRef,
+    };
+}
+export function isActiveForFetch(parsed) {
+    if (parsed.completed) {
+        return false;
+    }
+    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/parser.d.ts

@@ -0,0 +1,20 @@
+type TodoMetadata = Record<string, string[] | undefined>;
+export interface ParsedTodoLine {
+    readonly raw: string;
+    readonly completed: boolean;
+    readonly completionDate?: string;
+    readonly priority?: string;
+    readonly creationDate?: string;
+    readonly title: string;
+    readonly projects: readonly string[];
+    readonly contexts: readonly string[];
+    readonly metadata: TodoMetadata;
+    /** True when the final meaningful whitespace-delimited token is a `status:X` field. */
+    readonly isStatusFinalToken: boolean;
+}
+export declare function hashLine(raw: string): string;
+export declare function parseAllLines(fileContent: string): (ParsedTodoLine | null)[];
+export declare function getMetadataFirst(parsed: ParsedTodoLine, key: string): string | undefined;
+export declare function getMetadataAll(parsed: ParsedTodoLine, key: string): string[];
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/parser.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uFAAuF;IACvF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAQD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AA6ED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAQ5E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5E"}

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

@@ -0,0 +1,93 @@
+import { createHash } from "node:crypto";
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const KEY_VALUE_RE = /^(?<key>[a-zA-Z][a-zA-Z0-9-]*):(?<value>\S+)$/;
+const PRIORITY_RE = /^\((?<priority>[A-Z])\) /;
+const PROJECT_RE = /^\+\S+$/;
+const CONTEXT_RE = /^@\S+$/;
+export function hashLine(raw) {
+    return createHash("sha256").update(raw).digest("hex");
+}
+function extractDatePrefix(rest) {
+    const spaceIdx = rest.indexOf(" ");
+    const candidate = spaceIdx === -1 ? rest : rest.slice(0, spaceIdx);
+    if (DATE_RE.test(candidate)) {
+        return { date: candidate, rest: spaceIdx === -1 ? "" : rest.slice(spaceIdx + 1).trimStart() };
+    }
+    return { date: undefined, rest };
+}
+function parseTodoLine(raw) {
+    let rest = raw.trim();
+    let completed = false;
+    let completionDate;
+    let priority;
+    let creationDate;
+    if (rest.startsWith("x ")) {
+        completed = true;
+        rest = rest.slice(2).trimStart();
+        ({ date: completionDate, rest } = extractDatePrefix(rest));
+    }
+    const priorityMatch = PRIORITY_RE.exec(rest);
+    if (priorityMatch !== null) {
+        priority = priorityMatch.groups?.["priority"];
+        rest = rest.slice(priorityMatch[0].length);
+    }
+    ({ date: creationDate, rest } = extractDatePrefix(rest));
+    const tokens = rest.split(/\s+/).filter((t) => t.length > 0);
+    const projects = [];
+    const contexts = [];
+    const metadata = {};
+    const titleParts = [];
+    for (const token of tokens) {
+        if (PROJECT_RE.test(token)) {
+            projects.push(token.slice(1));
+        }
+        else if (CONTEXT_RE.test(token)) {
+            contexts.push(token.slice(1));
+        }
+        else {
+            const kvMatch = KEY_VALUE_RE.exec(token);
+            if (kvMatch === null) {
+                titleParts.push(token);
+            }
+            else {
+                /* v8 ignore next @preserve -- named capture groups are always defined when regex matches */
+                const { key, value } = kvMatch.groups ?? {};
+                /* v8 ignore else @preserve -- named groups always defined when regex matches */
+                if (key !== undefined && value !== undefined) {
+                    const existing = metadata[key] ?? [];
+                    metadata[key] = [...existing, value];
+                }
+            }
+        }
+    }
+    const lastToken = tokens.at(-1) ?? "";
+    const lastKv = KEY_VALUE_RE.exec(lastToken);
+    const isStatusFinalToken = lastKv !== null && lastKv.groups?.["key"] === "status";
+    return {
+        raw,
+        completed,
+        ...(completionDate !== undefined && { completionDate }),
+        ...(priority !== undefined && { priority }),
+        ...(creationDate !== undefined && { creationDate }),
+        title: titleParts.join(" "),
+        projects,
+        contexts,
+        metadata,
+        isStatusFinalToken,
+    };
+}
+export function parseAllLines(fileContent) {
+    return fileContent.split("\n").map((line) => {
+        const trimmed = line.trim();
+        if (trimmed.length === 0 || trimmed.startsWith("#")) {
+            return null;
+        }
+        return parseTodoLine(line);
+    });
+}
+export function getMetadataFirst(parsed, key) {
+    return parsed.metadata[key]?.[0];
+}
+export function getMetadataAll(parsed, key) {
+    return parsed.metadata[key] ?? [];
+}

package/dist/lib/adapters/todo-txt/schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const todoTxtAdapterConfigSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"todo-txt">;
+    name: z.ZodDefault<z.ZodString>;
+    todoPath: z.ZodDefault<z.ZodString>;
+    tasksDir: z.ZodDefault<z.ZodString>;
+    defaultRepository: z.ZodOptional<z.ZodString>;
+    idPrefix: z.ZodDefault<z.ZodString>;
+    timezone: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type TodoTxtAdapterConfig = z.infer<typeof todoTxtAdapterConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,0BAA0B;;;;;;;;iBAWrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export const todoTxtAdapterConfigSchema = z.object({
+    kind: z.literal("todo-txt"),
+    name: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]*$/, "name must be kebab-case (lowercase letters, digits, hyphens)")
+        .default("todo"),
+    todoPath: z.string().default("todo.txt"),
+    tasksDir: z.string().default(".tasks"),
+    defaultRepository: z.string().optional(),
+    idPrefix: z.string().default("GC"),
+    timezone: z.string().default("UTC"),
+});

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

@@ -0,0 +1,5 @@
+import type { AdapterContext } from "../../adapterDefinition.ts";
+import { type TaskSource } from "../../taskSource.ts";
+import type { TodoTxtAdapterConfig } from "./schema.ts";
+export declare function createTodoTxtTaskSource(config: TodoTxtAdapterConfig, _context: AdapterContext): TaskSource;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2ExD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,cAAc,GACvB,UAAU,CAiGZ"}

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

@@ -0,0 +1,142 @@
+import { readFileSync, statSync } from "node:fs";
+import { toCanonicalId, } from "../../taskSource.js";
+import { isActiveForFetch, normalizeToIssue } from "./normalizer.js";
+import { getMetadataFirst, parseAllLines } from "./parser.js";
+import { copyPromptFile, updateTaskStatus, validateTodoFile } from "./writeback.js";
+function readDescription(promptPath) {
+    try {
+        return readFileSync(promptPath, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function fileUpdatedAt(filePath) {
+    try {
+        return new Date(statSync(filePath).mtimeMs).toISOString();
+    }
+    catch {
+        /* v8 ignore next @preserve -- statSync failing means file missing; covered by empty-file tests */
+        return new Date().toISOString();
+    }
+}
+function readAndParseTodo(todoPath) {
+    let content;
+    try {
+        content = readFileSync(todoPath, "utf8");
+    }
+    catch {
+        content = "";
+    }
+    return {
+        rawLines: content.split("\n"),
+        parsedAll: parseAllLines(content),
+    };
+}
+function buildIssue(options) {
+    const { parsedIndex, parsedAll, sourceName, todoPath, tasksDir, defaultRepository, updatedAt } = options;
+    const parsed = parsedAll[parsedIndex];
+    /* v8 ignore next @preserve -- callers always validate parsedIndex before calling buildIssue */
+    if (parsed === null || parsed === undefined) {
+        return undefined;
+    }
+    const id = getMetadataFirst(parsed, "id");
+    /* v8 ignore next @preserve -- callers pre-filter by isActiveForFetch which requires id: */
+    if (id === undefined) {
+        return undefined;
+    }
+    const promptOverride = getMetadataFirst(parsed, "prompt");
+    const promptPath = promptOverride ?? `${tasksDir}/${id}.md`;
+    const description = readDescription(promptPath);
+    return normalizeToIssue({
+        parsed,
+        allParsed: parsedAll,
+        sourceName,
+        todoPath,
+        tasksDir,
+        defaultRepository,
+        description,
+        updatedAt,
+    });
+}
+export function createTodoTxtTaskSource(config, _context) {
+    const sourceName = config.name;
+    function buildIssueList() {
+        const updatedAt = fileUpdatedAt(config.todoPath);
+        const { parsedAll } = readAndParseTodo(config.todoPath);
+        const issues = [];
+        for (let i = 0; i < parsedAll.length; i++) {
+            const parsed = parsedAll[i];
+            if (parsed === null || parsed === undefined) {
+                continue;
+            }
+            if (!isActiveForFetch(parsed)) {
+                continue;
+            }
+            const issue = buildIssue({
+                parsedIndex: i,
+                parsedAll,
+                sourceName,
+                todoPath: config.todoPath,
+                tasksDir: config.tasksDir,
+                defaultRepository: config.defaultRepository,
+                updatedAt,
+            });
+            /* v8 ignore else @preserve -- isActiveForFetch guarantees id: present, so buildIssue always returns an Issue */
+            if (issue !== undefined) {
+                issues.push(issue);
+            }
+        }
+        return issues;
+    }
+    return {
+        name: sourceName,
+        async verify() {
+            const errors = validateTodoFile(config.todoPath, config.tasksDir);
+            if (errors.length > 0) {
+                throw new Error(`todo-txt source "${sourceName}" verification failed:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+            }
+        },
+        async fetch() {
+            return buildIssueList();
+        },
+        async resolveOne(naturalId) {
+            const canonicalId = toCanonicalId(sourceName, naturalId);
+            const updatedAt = fileUpdatedAt(config.todoPath);
+            const { parsedAll } = readAndParseTodo(config.todoPath);
+            const index = parsedAll.findIndex((p) => p !== null && toCanonicalId(sourceName, getMetadataFirst(p, "id") ?? "") === canonicalId);
+            if (index === -1) {
+                return undefined;
+            }
+            return buildIssue({
+                parsedIndex: index,
+                parsedAll,
+                sourceName,
+                todoPath: config.todoPath,
+                tasksDir: config.tasksDir,
+                defaultRepository: config.defaultRepository,
+                updatedAt,
+            });
+        },
+        async markInProgress(issue) {
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
+            const ref = issue.sourceRef;
+            await updateTaskStatus({ todoPath: config.todoPath, ref }, "in-progress");
+        },
+        async markInReview(issue) {
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
+            const ref = issue.sourceRef;
+            await updateTaskStatus({ todoPath: config.todoPath, ref }, "in-review");
+            return { outcome: "applied" };
+        },
+        async markDone(issue) {
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
+            const ref = issue.sourceRef;
+            const recurResult = await updateTaskStatus({ todoPath: config.todoPath, ref }, "done");
+            if (recurResult !== undefined) {
+                copyPromptFile(recurResult.oldPromptPath, recurResult.newPromptPath);
+            }
+            return { outcome: "applied" };
+        },
+    };
+}

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

@@ -0,0 +1,18 @@
+import type { TodoTxtSourceRef } from "./normalizer.ts";
+export interface RecurResult {
+    newId: string;
+    newTodoLine: string;
+    oldPromptPath: string;
+    newPromptPath: string;
+}
+export interface UpdateOptions {
+    todoPath: string;
+    ref: TodoTxtSourceRef;
+    now?: Date;
+}
+type StatusMutation = "in-progress" | "in-review" | "done";
+export declare function updateTaskStatus(options: UpdateOptions, newStatus: StatusMutation): Promise<RecurResult | undefined>;
+export declare function copyPromptFile(oldPath: string, newPath: string): void;
+export declare function validateTodoFile(todoPath: string, tasksDir: string): string[];
+export {};
+//# sourceMappingURL=writeback.d.ts.map

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

@@ -0,0 +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;AAYD,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"}

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

@@ -0,0 +1,352 @@
+import { closeSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+import { hashLine, parseAllLines } from "./parser.js";
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isoDate(date) {
+    return date.toISOString().slice(0, 10);
+}
+function compactDate(date) {
+    return isoDate(date).replaceAll("-", "");
+}
+function addDays(dateStr, days) {
+    const ms = Date.parse(`${dateStr}T00:00:00Z`);
+    return isoDate(new Date(ms + days * 24 * 60 * 60 * 1000));
+}
+function addMonths(dateStr, months) {
+    const parts = dateStr.split("-").map(Number);
+    /* v8 ignore next @preserve -- well-formed YYYY-MM-DD always produces 3 numeric parts */
+    const year = parts[0] ?? 2000;
+    /* v8 ignore next @preserve -- same: parts[1] is always defined */
+    const month = parts[1] ?? 1;
+    /* v8 ignore next @preserve -- same: parts[2] is always defined */
+    const day = parts[2] ?? 1;
+    const d = new Date(Date.UTC(year, month - 1 + months, day));
+    return isoDate(d);
+}
+const REC_RE = /^(?<strict>\+?)(?<amount>\d+)(?<unit>[dwmy])$/;
+function parseRecurrence(rec) {
+    const m = REC_RE.exec(rec);
+    if (m === null) {
+        return undefined;
+    }
+    const [, strictStr, amountStr, unit] = m;
+    /* v8 ignore next @preserve -- regex [dwmy] guarantees unit is always one of d/w/m/y */
+    if (unit !== "d" && unit !== "w" && unit !== "m" && unit !== "y") {
+        return undefined;
+    }
+    return {
+        strict: strictStr === "+",
+        /* v8 ignore next @preserve -- regex (\d+) guarantees amountStr is always defined */
+        amount: Number.parseInt(amountStr ?? "1", 10),
+        unit,
+    };
+}
+function advanceDate(dateStr, rec) {
+    const { amount, unit } = rec;
+    if (unit === "d") {
+        return addDays(dateStr, amount);
+    }
+    if (unit === "w") {
+        return addDays(dateStr, amount * 7);
+    }
+    if (unit === "m") {
+        return addMonths(dateStr, amount);
+    }
+    return addMonths(dateStr, amount * 12);
+}
+function advanceId(id, newDate) {
+    const dateCompact = compactDate(newDate);
+    // Replace the first 8-digit run (compact date) in the id
+    const replaced = id.replace(/\d{8}/, dateCompact);
+    return replaced === id ? `${id}-${dateCompact}` : replaced;
+}
+function buildUniqueId(baseNewId, existingIds) {
+    if (existingIds.has(baseNewId.toLowerCase())) {
+        for (let suffix = 2; suffix <= 999; suffix++) {
+            const candidate = `${baseNewId}-${String(suffix).padStart(3, "0")}`;
+            /* v8 ignore else @preserve -- double collision (suffix also taken) is untestable without 1000 tasks */
+            if (!existingIds.has(candidate.toLowerCase())) {
+                return candidate;
+            }
+        }
+        /* v8 ignore next @preserve -- 999 collisions is unreachable in practice */
+        return `${baseNewId}-${Date.now()}`;
+    }
+    return baseNewId;
+}
+function replaceStatusToken(line, newStatus) {
+    return line.replaceAll(/\bstatus:\S+/g, `status:${newStatus}`);
+}
+function buildDoneLine(originalLine, completionDate) {
+    // Remove priority marker if present, replace status, prepend x <date>
+    const withoutPriority = originalLine.replace(/^\([A-Z]\) /, "");
+    const withDoneStatus = replaceStatusToken(withoutPriority, "done");
+    return `x ${completionDate} ${withDoneStatus}`;
+}
+function buildRecurringLine(originalLine, originalId, newId, oldDue, newDue, oldT, newT) {
+    let line = originalLine;
+    line = line.replace(`id:${originalId}`, `id:${newId}`);
+    /* v8 ignore else @preserve -- oldDue absent means no due: replacement needed */
+    if (oldDue !== undefined && newDue !== undefined) {
+        line = line.replace(`due:${oldDue}`, `due:${newDue}`);
+    }
+    /* v8 ignore else @preserve -- oldT absent means no t: replacement needed */
+    if (oldT !== undefined && newT !== undefined) {
+        line = line.replace(`t:${oldT}`, `t:${newT}`);
+    }
+    return replaceStatusToken(line, "todo");
+}
+async function acquireLock(lockPath, maxAttempts = 40, delayMs = 50) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const fd = openSync(lockPath, "wx");
+            closeSync(fd);
+            return;
+        }
+        catch (error) {
+            /* v8 ignore next @preserve -- openSync always throws Error with a code */
+            if (!(error instanceof Error) || !("code" in error) || error.code !== "EEXIST") {
+                throw error;
+            }
+            /* v8 ignore next 5 @preserve -- retry sleep requires concurrent lock ownership, untestable in unit tests */
+            if (attempt + 1 < maxAttempts) {
+                // oxlint-disable-next-line no-await-in-loop -- polling lock acquisition
+                await new Promise((resolve) => {
+                    setTimeout(resolve, delayMs);
+                });
+            }
+        }
+    }
+    /* v8 ignore next @preserve -- exhausting 40 lock attempts is unreachable in normal test conditions */
+    throw new Error(`todo-txt: could not acquire lock at ${lockPath} after ${maxAttempts * delayMs}ms`);
+}
+function releaseLock(lockPath) {
+    try {
+        unlinkSync(lockPath);
+    }
+    catch {
+        // best-effort
+    }
+}
+function atomicWrite(filePath, content) {
+    const tmpPath = `${filePath}.tmp`;
+    writeFileSync(tmpPath, content, "utf8");
+    renameSync(tmpPath, filePath);
+}
+async function withLock(lockPath, fn) {
+    await acquireLock(lockPath);
+    try {
+        // return await is required here so the finally block runs while the lock is held
+        return await Promise.resolve(fn());
+    }
+    finally {
+        releaseLock(lockPath);
+    }
+}
+function assertValidTransition(newStatus, currentStatus, id) {
+    const s = currentStatus ?? "(none)";
+    if (newStatus === "in-progress" && currentStatus !== "todo") {
+        throw new Error(`todo-txt: cannot mark in-progress: task "${id}" has status "${s}", expected "todo"`);
+    }
+    if (newStatus === "in-review" && currentStatus !== "in-progress") {
+        throw new Error(`todo-txt: cannot mark in-review: task "${id}" has status "${s}", expected "in-progress"`);
+    }
+    if (newStatus === "done" &&
+        currentStatus !== "in-review" &&
+        currentStatus !== "in-progress" &&
+        currentStatus !== "todo") {
+        throw new Error(`todo-txt: cannot mark done: task "${id}" has status "${s}"`);
+    }
+}
+function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, now) {
+    const recStr = parsed.metadata["rec"]?.[0];
+    if (recStr === undefined) {
+        return undefined;
+    }
+    const rec = parseRecurrence(recStr);
+    /* v8 ignore next @preserve -- malformed rec: is caught by validate(); reaching here with undefined rec is improbable */
+    if (rec === undefined) {
+        return undefined;
+    }
+    const existingIds = new Set(parsedAll
+        .filter((p) => p !== null)
+        .map((p) => p.metadata["id"]?.[0]?.toLowerCase())
+        .filter((id) => id !== undefined));
+    const oldDue = parsed.metadata["due"]?.[0];
+    const oldT = parsed.metadata["t"]?.[0];
+    // due: advances from old due (strict) or completion date (normal)
+    /* v8 ignore next @preserve -- oldDue undefined with rec: is unusual; callers typically pair rec: with due: */
+    const dueBase = rec.strict ? (oldDue ?? completionDateStr) : completionDateStr;
+    /* v8 ignore next @preserve -- oldDue undefined means skip due advancement */
+    const newDue = oldDue === undefined ? undefined : advanceDate(dueBase, rec);
+    // t: always advances from its own current value by the same period
+    const newT = oldT === undefined ? undefined : advanceDate(oldT, rec);
+    // Compute new date for id advancement
+    /* v8 ignore next @preserve -- newDue undefined when no due: field; rare edge case */
+    const newDateForId = newDue === undefined ? now : new Date(`${newDue}T00:00:00Z`);
+    const baseNewId = advanceId(ref.id, newDateForId);
+    const newId = buildUniqueId(baseNewId, existingIds);
+    const newTodoLine = buildRecurringLine(originalLine, ref.id, newId, oldDue, newDue, oldT, newT);
+    const oldPromptPath = ref.promptPath;
+    const newPromptPath = oldPromptPath.replace(ref.id, newId);
+    return { newId, newTodoLine, oldPromptPath, newPromptPath };
+}
+export async function updateTaskStatus(options, newStatus) {
+    const { todoPath, ref } = options;
+    const now = options.now ?? new Date();
+    const lockPath = `${todoPath}.lock`;
+    return await withLock(lockPath, () => {
+        const content = readFileSync(todoPath, "utf8");
+        const rawLines = content.split("\n");
+        const parsedAll = parseAllLines(content);
+        // Find the target line — prefer fingerprint match, fall back to id: match
+        let targetIndex = rawLines.findIndex((line) => hashLine(line) === ref.lineFingerprint);
+        if (targetIndex >= 0) {
+            // Verify the fingerprint matched a real task line, not a blank/comment collision
+            const matched = parsedAll[targetIndex];
+            /* v8 ignore next @preserve -- SHA-256 collision with a blank/comment line is unreachable */
+            if (matched === null || matched === undefined) {
+                targetIndex = -1;
+            }
+        }
+        if (targetIndex < 0) {
+            // Fingerprint mismatch or structural check failed — find by id: (O(n) scan)
+            targetIndex = parsedAll.findIndex((parsed) => {
+                if (parsed === null || parsed === undefined) {
+                    return false;
+                }
+                return parsed.metadata["id"]?.[0]?.toLowerCase() === ref.id.toLowerCase();
+            });
+        }
+        if (targetIndex < 0) {
+            throw new Error(`todo-txt: task id "${ref.id}" not found in ${todoPath}`);
+        }
+        const originalLine = rawLines[targetIndex];
+        /* v8 ignore next @preserve -- rawLines and parsedAll are co-indexed; targetIndex < length */
+        if (originalLine === undefined) {
+            throw new Error(`todo-txt: line index ${targetIndex} out of range in ${todoPath}`);
+        }
+        const parsed = parsedAll[targetIndex];
+        /* v8 ignore next 3 @preserve -- targetIndex found via fingerprint/id match, so parsed is never null/undefined */
+        if (parsed === null || parsed === undefined) {
+            throw new Error(`todo-txt: could not parse line ${targetIndex} in ${todoPath}`);
+        }
+        assertValidTransition(newStatus, parsed.metadata["status"]?.[0], ref.id);
+        let recurResult;
+        let updatedLine;
+        if (newStatus === "done") {
+            const completionDateStr = isoDate(now);
+            updatedLine = buildDoneLine(originalLine, completionDateStr);
+            recurResult = buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, now);
+        }
+        else {
+            updatedLine = replaceStatusToken(originalLine, newStatus);
+        }
+        const newLines = [...rawLines];
+        newLines[targetIndex] = updatedLine;
+        if (recurResult !== undefined) {
+            // Insert new recurring line after the done line
+            newLines.splice(targetIndex + 1, 0, recurResult.newTodoLine);
+        }
+        atomicWrite(todoPath, newLines.join("\n"));
+        return recurResult;
+    });
+}
+export function copyPromptFile(oldPath, newPath) {
+    try {
+        const content = readFileSync(oldPath, "utf8");
+        mkdirSync(path.dirname(newPath), { recursive: true });
+        writeFileSync(newPath, content, "utf8");
+    }
+    catch {
+        // prompt file is optional — copy is best-effort
+    }
+}
+function validatePromptFile(tasksDir, id, promptOverride, prefix, errors) {
+    const promptPath = promptOverride ?? path.join(tasksDir, `${id}.md`);
+    try {
+        const desc = readFileSync(promptPath, "utf8");
+        if (desc.trim().length === 0) {
+            errors.push(`${prefix}: empty prompt file "${promptPath}" for ready task "${id}"`);
+        }
+    }
+    catch {
+        errors.push(`${prefix}: missing prompt file "${promptPath}" for ready task "${id}"`);
+    }
+}
+function validateDepsAndDates(parsed, parsedAll, id, prefix, errors) {
+    const depIds = parsed.metadata["dep"] ?? [];
+    for (const depId of depIds) {
+        const depFound = parsedAll.find((p) => p !== null && p.metadata["id"]?.[0]?.toLowerCase() === depId.toLowerCase());
+        if (depFound === undefined) {
+            errors.push(`${prefix}: unresolved dep "${depId}" for task "${id}"`);
+        }
+    }
+    for (const dateField of ["due", "t"]) {
+        const dateVal = parsed.metadata[dateField]?.[0];
+        if (dateVal !== undefined && !DATE_RE.test(dateVal)) {
+            errors.push(`${prefix}: malformed ${dateField}: date "${dateVal}" for task "${id}" (expected YYYY-MM-DD)`);
+        }
+    }
+    const recVal = parsed.metadata["rec"]?.[0];
+    if (recVal !== undefined && parseRecurrence(recVal) === undefined) {
+        errors.push(`${prefix}: malformed rec: "${recVal}" for task "${id}" (expected e.g. 1d, 1w, +1m)`);
+    }
+}
+function validateActiveTaskLine(parsed, parsedAll, tasksDir, id, prefix, errors) {
+    const agent = parsed.metadata["agent"]?.[0];
+    /* v8 ignore next @preserve -- parser KEY_VALUE_RE requires \S+, so empty agent values can't be parsed */
+    if (agent !== undefined && agent.trim().length === 0) {
+        errors.push(`${prefix}: empty agent: value for task "${id}"`);
+    }
+    const statusValue = parsed.metadata["status"]?.[0];
+    const validStatuses = ["todo", "in-progress", "in-review", "done", "other"];
+    if (statusValue !== undefined && !validStatuses.includes(statusValue)) {
+        errors.push(`${prefix}: invalid status "${statusValue}" for task "${id}"`);
+    }
+    if (statusValue === "todo" && !parsed.isStatusFinalToken) {
+        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);
+    }
+    validateDepsAndDates(parsed, parsedAll, id, prefix, errors);
+}
+export function validateTodoFile(todoPath, tasksDir) {
+    const errors = [];
+    let content;
+    try {
+        content = readFileSync(todoPath, "utf8");
+    }
+    catch {
+        return [`missing todo file: ${todoPath}`];
+    }
+    const parsedAll = parseAllLines(content);
+    const idsSeen = new Map();
+    for (let i = 0; i < parsedAll.length; i++) {
+        const parsed = parsedAll[i];
+        if (parsed === null || parsed === undefined) {
+            continue;
+        }
+        const lineNum = i + 1;
+        const prefix = `line ${lineNum}`;
+        const id = parsed.metadata["id"]?.[0];
+        if (id !== undefined) {
+            const lower = id.toLowerCase();
+            if (idsSeen.has(lower)) {
+                errors.push(`${prefix}: duplicate id "${id}" (first seen on line ${idsSeen.get(lower)})`);
+            }
+            else {
+                idsSeen.set(lower, lineNum);
+            }
+        }
+        if (id === undefined || parsed.metadata["agent"] === undefined) {
+            continue;
+        }
+        if (parsed.completed) {
+            continue;
+        }
+        validateActiveTaskLine(parsed, parsedAll, tasksDir, id, prefix, errors);
+    }
+    return errors;
+}

package/dist/lib/buildSources.d.ts

@@ -37,4 +37,12 @@ export declare function buildSourcesWith(registry: Record<string, AdapterDefinit
  * other source with `enabled: false` is likewise dropped from the result.
  */
 export declare function sourcesFromConfig(config: ResolvedConfig): readonly unknown[];
+/**
+ * True when the resolved config keeps Linear active — i.e. the user has not
+ * opted out with `{ kind: "linear", enabled: false }`. Callers use this to skip
+ * Linear API calls (and the missing-API-key error they raise) when Linear is
+ * off. Derived from `sourcesFromConfig` so it honors both the explicit opt-out
+ * sentinel and the implicit-source synthesis.
+ */
+export declare function isLinearEnabled(config: ResolvedConfig): boolean;
 //# sourceMappingURL=buildSources.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildSources.d.ts","sourceRoot":"","sources":["../../src/lib/buildSources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,SAAS;;iBAAiC,CAAC;AAExD;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3C,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAcd;AA6DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,OAAO,EAAE,CAa5E"}
+{"version":3,"file":"buildSources.d.ts","sourceRoot":"","sources":["../../src/lib/buildSources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,SAAS;;iBAAiC,CAAC;AAExD;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3C,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAcd;AA6DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,OAAO,EAAE,CAa5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE/D"}

package/dist/lib/buildSources.js

@@ -114,3 +114,13 @@ export function sourcesFromConfig(config) {
     }
     return [{ kind: "linear" }, ...kept];
 }
+/**
+ * True when the resolved config keeps Linear active — i.e. the user has not
+ * opted out with `{ kind: "linear", enabled: false }`. Callers use this to skip
+ * Linear API calls (and the missing-API-key error they raise) when Linear is
+ * off. Derived from `sourcesFromConfig` so it honors both the explicit opt-out
+ * sentinel and the implicit-source synthesis.
+ */
+export function isLinearEnabled(config) {
+    return sourcesFromConfig(config).some(isLinearKindSource);
+}

package/dist/lib/config.d.ts

@@ -1,5 +1,6 @@
 import type { LinearAdapterConfig } from "./adapters/linear/schema.ts";
 import type { ShellAdapterConfig } from "./adapters/shell/schema.ts";
+import type { TodoTxtAdapterConfig } from "./adapters/todo-txt/schema.ts";
 export { BUILD_SECRET_NAMES } from "./buildSecrets.ts";
 /**
  * Discriminated union of all built-in adapter config shapes. Used at
@@ -7,7 +8,7 @@ export { BUILD_SECRET_NAMES } from "./buildSecrets.ts";
  * `ResolvedConfig.sources[]`. The runtime Zod validation lives in each
  * adapter's `schema.ts` and runs at `buildSources` time, not here.
  */
-export type SourceConfig = LinearAdapterConfig | ShellAdapterConfig;
+export type SourceConfig = LinearAdapterConfig | ShellAdapterConfig | TodoTxtAdapterConfig;
 export interface HookCommands {
     prepareWorktree?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAM1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAIzD,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtD,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAMrD,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD,CAAC;IACF;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,KAAK,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAC/D,KAAK,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,GAAG;IAC1E,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AACF,KAAK,mBAAmB,GAAG,0BAA0B,CAAC;AAEtD;;;;;;;;;GASG;AACH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM;IACrB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACnD,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE;QACR;;;;;WAKG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,4DAA4D;QAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gFAAgF;QAChF,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,8EAA8E;QAC9E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;KACrB,CAAC;IACF,YAAY,EAAE;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;QACjC,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC9C,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF;;;OAGG;IACH,aAAa,EAAE,oBAAoB,CAAC;IACpC;;;;OAIG;IACH,KAAK,EAAE;QACL,MAAM,EAAE,kBAAkB,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;CAChC;AAsND;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,OAAO,CAE1F;AA6FD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AA+fD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CA2B5E;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAGpE"}

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

@@ -1 +1 @@
-{"version":3,"file":"sourceCapabilities.d.ts","sourceRoot":"","sources":["../../src/lib/sourceCapabilities.ts"],"names":[],"mappings":"AAKA,UAAU,kBAAkB;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAsCD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAe3D"}
+{"version":3,"file":"sourceCapabilities.d.ts","sourceRoot":"","sources":["../../src/lib/sourceCapabilities.ts"],"names":[],"mappings":"AAKA,UAAU,kBAAkB;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAgDD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiB3D"}

package/dist/lib/sourceCapabilities.js

@@ -33,6 +33,15 @@ function shellCapabilities(raw) {
         markDone: commands.markDone !== undefined,
     };
 }
+const TODO_TXT_CAPABILITIES = {
+    verify: true,
+    listTasks: true,
+    getTask: true,
+    createTask: false,
+    markInProgress: true,
+    markInReview: true,
+    markDone: true,
+};
 export function summarizeSource(raw) {
     const { kind } = kindShape.parse(raw);
     const { name } = nameShape.parse(raw);
@@ -44,6 +53,9 @@ export function summarizeSource(raw) {
     else if (kind === "shell") {
         capabilities = shellCapabilities(raw);
     }
+    else if (kind === "todo-txt") {
+        capabilities = TODO_TXT_CAPABILITIES;
+    }
     else {
         capabilities = UNKNOWN_KIND_CAPABILITIES;
     }

package/package.json

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