@clipboard-health/groundcrew 4.20.2 → 4.22.0

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

@@ -51,6 +51,11 @@ function toCanonicalParentSkip(skip, sourceName) {
         childCount: skip.childCount,
     };
 }
+function isLinearNotFoundError(error, naturalId) {
+    return (error instanceof Error &&
+        error.message.startsWith(`Task ${naturalId.toUpperCase()} `) &&
+        error.message.includes("not found"));
+}
 export function toCanonicalIssue(linearIssue, sourceName, statusNames = DEFAULT_LINEAR_STATUS_NAMES) {
     const sourceRef = {
         uuid: linearIssue.uuid,
@@ -106,51 +111,73 @@ export function createLinearTaskSource(config, context) {
         return cachedIssueStatusUpdater;
     }
     let lastParentSkips = [];
+    async function listTasks() {
+        const state = await getBoardSource().fetch();
+        lastParentSkips = state.parentSkips.map((skip) => toCanonicalParentSkip(skip, sourceName));
+        return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, sourceName, statusNames));
+    }
+    async function getTask(naturalId) {
+        let resolved;
+        try {
+            resolved = await fetchResolvedIssue({
+                client: getClient(),
+                config: globalConfig,
+                task: naturalId,
+            });
+        }
+        catch (error) {
+            if (isLinearNotFoundError(error, naturalId)) {
+                return null;
+            }
+            throw error;
+        }
+        const sourceRef = {
+            uuid: resolved.uuid,
+            statusId: resolved.statusId,
+            teamId: resolved.teamId,
+            stateType: resolved.stateType,
+            nativeStatus: resolved.status,
+        };
+        return {
+            id: toCanonicalId(sourceName, naturalId),
+            source: sourceName,
+            title: resolved.title,
+            description: resolved.description,
+            status: canonicalStatusFromLinearState({
+                nativeStatus: resolved.status,
+                stateType: resolved.stateType,
+                statusNames,
+            }),
+            repository: resolved.repository,
+            model: resolved.model,
+            assignee: resolved.assignee,
+            updatedAt: resolved.updatedAt,
+            blockers: resolved.blockers.map((b) => toCanonicalBlocker(b, sourceName, statusNames)),
+            hasMoreBlockers: resolved.hasMoreBlockers,
+            url: resolved.url,
+            ...(resolved.priority === 0 ? {} : { priority: resolved.priority }),
+            sourceRef,
+        };
+    }
     return {
         name: sourceName,
         async verify() {
             await getBoardSource().verify();
         },
+        async listTasks() {
+            return await listTasks();
+        },
+        async getTask(naturalId) {
+            return await getTask(naturalId);
+        },
         async fetch() {
-            const state = await getBoardSource().fetch();
-            lastParentSkips = state.parentSkips.map((skip) => toCanonicalParentSkip(skip, sourceName));
-            return state.issues.map((linearIssue) => toCanonicalIssue(linearIssue, sourceName, statusNames));
+            return await listTasks();
         },
         async fetchParentSkips() {
             return lastParentSkips;
         },
         async resolveOne(naturalId) {
-            const resolved = await fetchResolvedIssue({
-                client: getClient(),
-                config: globalConfig,
-                task: naturalId,
-            });
-            const sourceRef = {
-                uuid: resolved.uuid,
-                statusId: resolved.statusId,
-                teamId: resolved.teamId,
-                stateType: resolved.stateType,
-                nativeStatus: resolved.status,
-            };
-            return {
-                id: toCanonicalId(sourceName, naturalId),
-                source: sourceName,
-                title: resolved.title,
-                description: resolved.description,
-                status: canonicalStatusFromLinearState({
-                    nativeStatus: resolved.status,
-                    stateType: resolved.stateType,
-                    statusNames,
-                }),
-                repository: resolved.repository,
-                model: resolved.model,
-                assignee: "Unassigned",
-                updatedAt: new Date().toISOString(),
-                blockers: [],
-                hasMoreBlockers: false,
-                url: resolved.url,
-                sourceRef,
-            };
+            return (await getTask(naturalId)) ?? undefined;
         },
         async markInProgress(issue) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- by the Linear adapter's contract, every Issue it produces carries a LinearSourceRef in sourceRef

package/dist/lib/adapters/linear/fetch.d.ts

@@ -116,7 +116,12 @@ interface ResolvedIssue {
     stateType: string;
     status: string;
     statusId: string;
+    assignee: string;
+    updatedAt: string;
+    blockers: Blocker[];
+    hasMoreBlockers: boolean;
     url: string;
+    priority: number;
 }
 export interface RawLinearIssue {
     uuid: string;
@@ -130,6 +135,8 @@ export interface RawLinearIssue {
     stateName: string;
     stateType: string;
     stateId: string;
+    assignee: string;
+    updatedAt: string;
     blockers: Blocker[];
     hasMoreBlockers: boolean;
     /**
@@ -141,6 +148,8 @@ export interface RawLinearIssue {
     hasChildren: boolean;
     /** Linear `Issue.url` — direct web link to the task. */
     url: string;
+    /** Linear priority: 1=Urgent, 2=High, 3=Medium, 4=Low, 0=No priority. */
+    priority: number;
 }
 export declare function fetchBlockersForTask(arguments_: {
     client: LinearClient;

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

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/fetch.ts"],"names":[],"mappings":"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"}

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

@@ -260,9 +260,12 @@ export async function fetchRawLinearIssue(arguments_) {
         id
         title
         description
+        updatedAt
         url
+        priority
         team { id }
         state { id name type }
+        assignee { name }
         children { nodes { id } }
         labels(first: ${ISSUE_LABEL_PAGE_SIZE}) {
           nodes { name }
@@ -298,10 +301,13 @@ export async function fetchRawLinearIssue(arguments_) {
         stateType: issue.state?.type ?? "",
         /* v8 ignore next @preserve -- ResolveIssue query selects state; null only if Linear genuinely returns a stateless task */
         stateId: issue.state?.id ?? "",
+        assignee: issue.assignee?.name ?? "Unassigned",
+        updatedAt: issue.updatedAt,
         blockers: blockersFromRelations(issue.inverseRelations?.nodes ?? []),
         hasMoreBlockers: issue.inverseRelations?.pageInfo.hasNextPage ?? false,
         hasChildren: (issue.children?.nodes.length ?? 0) > 0,
         url: issue.url,
+        priority: issue.priority,
     };
 }
 export async function fetchInProgressIssueCount(arguments_) {
@@ -378,7 +384,12 @@ export async function fetchResolvedIssue(arguments_) {
         stateType: raw.stateType,
         status: raw.stateName,
         statusId: raw.stateId,
+        assignee: raw.assignee,
+        updatedAt: raw.updatedAt,
+        blockers: raw.blockers,
+        hasMoreBlockers: raw.hasMoreBlockers,
         url: raw.url,
+        priority: raw.priority,
     };
 }
 export function warnIfNotEnabledFallback(task, modelResolution, config) {

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAGL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAC;AAkErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CA+GZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAGL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAC;AAkErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CAyHZ"}

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

@@ -101,6 +101,30 @@ export function createShellTaskSource(config, _context) {
         const parsed = shellFetchOutputSchema.parse(JSON.parse(stdout));
         return parsed.map((si) => toCanonicalIssue(si, sourceName));
     }
+    async function getTask(naturalId) {
+        const canonicalId = toCanonicalId(sourceName, naturalId);
+        if (getTaskCommand === undefined) {
+            const all = await runFetch();
+            return all.find((i) => i.id === canonicalId) ?? null;
+        }
+        const result = await invokeShellCommand({
+            command: getTaskCommand,
+            timeoutMs: timeouts.getTask,
+            cwd: config.cwd,
+            env: config.env,
+            substitutions: {
+                id: naturalId,
+                canonicalId,
+                name: sourceName,
+            },
+            sourceName,
+        });
+        if (result.exitCode === 3 || result.stdout.trim().length === 0) {
+            return null;
+        }
+        const parsed = shellIssueSchema.parse(JSON.parse(result.stdout));
+        return toCanonicalIssue(parsed, sourceName);
+    }
     // Shared by markInProgress / markInReview: both pipe the canonical issue's
     // opaque sourceRef to a status-transition script on stdin, with the natural
     // and canonical ids substituted into the command.
@@ -140,30 +164,15 @@ export function createShellTaskSource(config, _context) {
                 sourceName,
             });
         },
+        async listTasks() {
+            return await runFetch();
+        },
+        async getTask(naturalId) {
+            return await getTask(naturalId);
+        },
         fetch: runFetch,
         async resolveOne(naturalId) {
-            const canonicalId = toCanonicalId(sourceName, naturalId);
-            if (getTaskCommand === undefined) {
-                const all = await runFetch();
-                return all.find((i) => i.id === canonicalId);
-            }
-            const result = await invokeShellCommand({
-                command: getTaskCommand,
-                timeoutMs: timeouts.getTask,
-                cwd: config.cwd,
-                env: config.env,
-                substitutions: {
-                    id: naturalId,
-                    canonicalId,
-                    name: sourceName,
-                },
-                sourceName,
-            });
-            if (result.exitCode === 3 || result.stdout.trim().length === 0) {
-                return undefined;
-            }
-            const parsed = shellIssueSchema.parse(JSON.parse(result.stdout));
-            return toCanonicalIssue(parsed, sourceName);
+            return (await getTask(naturalId)) ?? undefined;
         },
         async markInProgress(issue) {
             await invokeWriteback(config.commands.markInProgress, timeouts.markInProgress, issue);

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":"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,CAkGZ"}
+{"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"}

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

@@ -1,8 +1,13 @@
-import { readFileSync, statSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { appendFileSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import path from "node:path";
 import { toCanonicalId, } from "../../taskSource.js";
+import { readEnvironmentVariable } from "../../util.js";
 import { isActiveForFetch, normalizeToIssue } from "./normalizer.js";
 import { getMetadataFirst, parseAllLines } from "./parser.js";
-import { copyPromptFile, updateTaskStatus, validateTodoFile } from "./writeback.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) {
     try {
         return readFileSync(promptPath, "utf8");
@@ -29,7 +34,6 @@ function readAndParseTodo(todoPath) {
         content = "";
     }
     return {
-        rawLines: content.split("\n"),
         parsedAll: parseAllLines(content),
     };
 }
@@ -59,10 +63,183 @@ function buildIssue(options) {
         updatedAt,
     });
 }
+function assertToken(label, value) {
+    if (value.length === 0 || /\s/.test(value)) {
+        throw new Error(`todo-txt: ${label} must be a non-empty single token`);
+    }
+}
+function assertCreateId(id) {
+    assertToken("id", id);
+    if (id === "." || id === ".." || id.includes("/") || id.includes("\\")) {
+        throw new Error("todo-txt: id must be a filename-safe token");
+    }
+}
+function normalizeProject(project) {
+    return project.startsWith("+") ? project.slice(1) : project;
+}
+function normalizeContext(context) {
+    return context.startsWith("@") ? context.slice(1) : context;
+}
+function metadataToken(key, value) {
+    assertToken(`${key}: value`, value);
+    return `${key}:${value}`;
+}
+function datePartFor(timeZone, now) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).formatToParts(now);
+    const year = parts.find((part) => part.type === "year")?.value;
+    const month = parts.find((part) => part.type === "month")?.value;
+    const day = parts.find((part) => part.type === "day")?.value;
+    /* v8 ignore next 3 @preserve -- Intl.DateTimeFormat with year/month/day always returns these parts */
+    if (year === undefined || month === undefined || day === undefined) {
+        throw new Error(`todo-txt: could not format date in timezone "${timeZone}"`);
+    }
+    return `${year}${month}${day}`;
+}
+/* v8 ignore next @preserve -- Covered in source tests; full-suite V8 coverage remaps this helper inconsistently. */
+function nextGeneratedId(config, parsedAll) {
+    const datePart = datePartFor(config.timezone, new Date());
+    const prefix = `${config.idPrefix}-${datePart}-`;
+    let maximumSequence = 0;
+    for (const parsed of parsedAll) {
+        if (parsed === null || parsed === undefined) {
+            continue;
+        }
+        const id = getMetadataFirst(parsed, "id");
+        if (id === undefined || !id.startsWith(prefix)) {
+            continue;
+        }
+        const sequence = Number.parseInt(id.slice(prefix.length), 10);
+        if (Number.isFinite(sequence) && sequence > maximumSequence) {
+            maximumSequence = sequence;
+        }
+    }
+    return `${prefix}${String(maximumSequence + 1).padStart(3, "0")}`;
+}
+function assertNewId(id, parsedAll) {
+    const existing = parsedAll.some((parsed) => parsed !== null && getMetadataFirst(parsed, "id")?.toLowerCase() === id.toLowerCase());
+    if (existing) {
+        throw new Error(`todo-txt: task id "${id}" already exists`);
+    }
+}
+function buildTodoLine(id, input) {
+    const title = input.title.trim();
+    if (title.length === 0) {
+        throw new Error("todo-txt: title is required");
+    }
+    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");
+    }
+    tokens.push(`(${priority})`);
+    tokens.push(title);
+    for (const rawProject of input.projects) {
+        const project = normalizeProject(rawProject);
+        assertToken("project", project);
+        tokens.push(`+${project}`);
+    }
+    for (const rawContext of input.contexts) {
+        const context = normalizeContext(rawContext);
+        assertToken("context", context);
+        tokens.push(`@${context}`);
+    }
+    tokens.push(metadataToken("id", id));
+    if (input.repository !== undefined) {
+        tokens.push(metadataToken("repo", input.repository));
+    }
+    tokens.push(metadataToken("agent", input.agent));
+    for (const dependency of input.dependencies) {
+        tokens.push(metadataToken("dep", dependency));
+    }
+    if (input.due !== undefined) {
+        if (!DATE_RE.test(input.due)) {
+            throw new Error("todo-txt: due date must use YYYY-MM-DD");
+        }
+        tokens.push(metadataToken("due", input.due));
+    }
+    if (input.recurrence !== undefined) {
+        if (!RECURRENCE_RE.test(input.recurrence)) {
+            throw new Error("todo-txt: recurrence must look like 1d, 1w, 1m, 1y, or +1m");
+        }
+        tokens.push(metadataToken("rec", input.recurrence));
+    }
+    tokens.push("status:todo");
+    return tokens.join(" ");
+}
+function promptContentFor(input) {
+    if (input.promptFile !== undefined && input.description !== undefined) {
+        throw new Error("todo-txt: --prompt-file and --description are mutually exclusive");
+    }
+    if (input.promptFile !== undefined) {
+        return readFileSync(input.promptFile, "utf8");
+    }
+    if (input.description !== undefined) {
+        return input.description;
+    }
+    return `${input.title.trim()}\n`;
+}
+function appendTodoLine(todoPath, line) {
+    mkdirSync(path.dirname(todoPath), { recursive: true });
+    let separator = "";
+    try {
+        const current = readFileSync(todoPath, "utf8");
+        separator = current.length === 0 || current.endsWith("\n") ? "" : "\n";
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+            throw error;
+        }
+    }
+    appendFileSync(todoPath, `${separator}${line}\n`, "utf8");
+}
+function writePromptFile(promptPath, content) {
+    mkdirSync(path.dirname(promptPath), { recursive: true });
+    writeFileSync(promptPath, content.endsWith("\n") ? content : `${content}\n`, "utf8");
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", String.raw `'\''`)}'`;
+}
+function configuredEditor() {
+    const visual = readEnvironmentVariable("VISUAL");
+    if (visual !== undefined && visual.trim().length > 0) {
+        return visual;
+    }
+    const editor = readEnvironmentVariable("EDITOR");
+    if (editor !== undefined && editor.trim().length > 0) {
+        return editor;
+    }
+    return undefined;
+}
+function openPromptEditor(promptPath) {
+    const editor = configuredEditor();
+    if (editor === undefined) {
+        throw new Error("todo-txt: --edit requires VISUAL or EDITOR to be set");
+    }
+    const result = spawnSync(`${editor} ${shellQuote(promptPath)}`, {
+        shell: true,
+        stdio: "inherit",
+    });
+    /* v8 ignore next 3 @preserve -- with shell:true editor launch failures report a nonzero status */
+    if (result.error !== undefined) {
+        throw result.error;
+    }
+    if (result.status !== 0) {
+        throw new Error(`todo-txt: editor exited with status ${result.status}`);
+    }
+}
 export function createTodoTxtTaskSource(config, _context) {
     const sourceName = config.name;
+    /* v8 ignore next @preserve -- Covered in source tests; full-suite V8 coverage remaps this line inconsistently. */
     const { todoPath, tasksDir } = config;
-    function buildIssueList() {
+    function listTasks() {
         const updatedAt = fileUpdatedAt(todoPath);
         const { parsedAll } = readAndParseTodo(todoPath);
         const issues = [];
@@ -90,6 +267,25 @@ export function createTodoTxtTaskSource(config, _context) {
         }
         return issues;
     }
+    function getTask(naturalId) {
+        const canonicalId = toCanonicalId(sourceName, naturalId);
+        const updatedAt = fileUpdatedAt(todoPath);
+        const { parsedAll } = readAndParseTodo(todoPath);
+        const index = parsedAll.findIndex((parsed) => parsed !== null &&
+            toCanonicalId(sourceName, getMetadataFirst(parsed, "id") ?? "") === canonicalId);
+        if (index === -1) {
+            return null;
+        }
+        return (buildIssue({
+            parsedIndex: index,
+            parsedAll,
+            sourceName,
+            todoPath,
+            tasksDir,
+            defaultRepository: config.defaultRepository,
+            updatedAt,
+        }) ?? null);
+    }
     return {
         name: sourceName,
         async verify() {
@@ -98,26 +294,39 @@ export function createTodoTxtTaskSource(config, _context) {
                 throw new Error(`todo-txt source "${sourceName}" verification failed:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
             }
         },
+        async listTasks() {
+            return listTasks();
+        },
+        async getTask(naturalId) {
+            return getTask(naturalId);
+        },
+        async createTask(input) {
+            return await withLock(`${todoPath}.lock`, () => {
+                const { parsedAll } = readAndParseTodo(todoPath);
+                const id = input.id ?? nextGeneratedId(config, parsedAll);
+                assertCreateId(id);
+                assertNewId(id, parsedAll);
+                const promptPath = path.join(tasksDir, `${id}.md`);
+                const promptContent = promptContentFor(input);
+                const line = buildTodoLine(id, input);
+                writePromptFile(promptPath, promptContent);
+                appendTodoLine(todoPath, line);
+                if (input.edit) {
+                    openPromptEditor(promptPath);
+                }
+                const task = getTask(id);
+                /* v8 ignore next 3 @preserve -- createTask just appended this id and getTask reads the same file */
+                if (task === null) {
+                    throw new Error(`todo-txt: created task "${id}" could not be read back`);
+                }
+                return task;
+            });
+        },
         async fetch() {
-            return buildIssueList();
+            return listTasks();
         },
         async resolveOne(naturalId) {
-            const canonicalId = toCanonicalId(sourceName, naturalId);
-            const updatedAt = fileUpdatedAt(todoPath);
-            const { parsedAll } = readAndParseTodo(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,
-                tasksDir,
-                defaultRepository: config.defaultRepository,
-                updatedAt,
-            });
+            return getTask(naturalId) ?? undefined;
         },
         async markInProgress(issue) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef

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

@@ -10,6 +10,7 @@ export interface UpdateOptions {
     ref: TodoTxtSourceRef;
     now?: Date;
 }
+export declare function withLock<T>(lockPath: string, fn: () => T | Promise<T>): Promise<T>;
 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;

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;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"}
+{"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"}

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

@@ -133,7 +133,7 @@ function atomicWrite(filePath, content) {
     writeFileSync(tmpPath, content, "utf8");
     renameSync(tmpPath, filePath);
 }
-async function withLock(lockPath, fn) {
+export async function withLock(lockPath, fn) {
     await acquireLock(lockPath);
     try {
         // return await is required here so the finally block runs while the lock is held

package/dist/lib/board.d.ts

@@ -1,5 +1,5 @@
 /**
- * Board composer — fans `verify` / `fetch` / `resolveOne` / `markInProgress` /
+ * Board composer — fans `verify` / `listTasks` / `getTask` / `markInProgress` /
  * `markInReview` across N `TaskSource` adapters. Even a single-source config
  * goes through this; the moment we skip the wrapper we grow Linear assumptions
  * back into consumers.

package/dist/lib/board.js

@@ -1,5 +1,5 @@
 /**
- * Board composer — fans `verify` / `fetch` / `resolveOne` / `markInProgress` /
+ * Board composer — fans `verify` / `listTasks` / `getTask` / `markInProgress` /
  * `markInReview` across N `TaskSource` adapters. Even a single-source config
  * goes through this; the moment we skip the wrapper we grow Linear assumptions
  * back into consumers.
@@ -9,7 +9,7 @@ async function callVerify(source) {
     await source.verify();
 }
 async function callFetch(source) {
-    return await source.fetch();
+    return await source.listTasks();
 }
 async function callFetchParentSkips(source) {
     if (source.fetchParentSkips !== undefined) {
@@ -18,7 +18,7 @@ async function callFetchParentSkips(source) {
     return [];
 }
 async function callResolveOne(source, naturalId) {
-    return await source.resolveOne(naturalId);
+    return (await source.getTask(naturalId)) ?? undefined;
 }
 export function createBoard(sources) {
     const byName = new Map();