agentplane 0.1.9 → 0.2.1

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

@@ -0,0 +1,13 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdTaskDerive(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    spikeId: string;
+    title: string;
+    description: string;
+    owner: string;
+    priority: "low" | "normal" | "med" | "high";
+    tags: string[];
+}): Promise<number>;
+//# sourceMappingURL=derive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAUpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgElB"}

package/dist/commands/task/derive.js

@@ -0,0 +1,71 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { unknownEntityMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { extractDocSection, nowIso, toStringArray } from "./shared.js";
+function normalizeOneLine(text, maxChars) {
+    const normalized = text.trim().replaceAll(/\s+/g, " ");
+    if (normalized.length <= maxChars)
+        return normalized;
+    return `${normalized.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
+}
+export async function cmdTaskDerive(opts) {
+    try {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        if (!ctx.taskBackend.generateTaskId) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: "task backend does not support generateTaskId()",
+            });
+        }
+        const spike = await ctx.taskBackend.getTask(opts.spikeId);
+        if (!spike) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("task id", opts.spikeId),
+            });
+        }
+        const spikeTags = toStringArray(spike.tags).map((t) => t.trim().toLowerCase());
+        if (!spikeTags.includes("spike")) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: `${opts.spikeId}: expected tag spike (use --tag spike on the source task)`,
+            });
+        }
+        const spikeDoc = typeof spike.doc === "string" ? spike.doc : "";
+        const notes = extractDocSection(spikeDoc, "Notes") ?? "";
+        const excerpt = notes.trim() ? normalizeOneLine(notes, 180) : "";
+        const suffixLength = ctx.config.tasks.id_suffix_length_default;
+        const taskId = await ctx.taskBackend.generateTaskId({ length: suffixLength, attempts: 1000 });
+        let description = opts.description.trim();
+        description = `${description} (derived from spike ${opts.spikeId})`;
+        if (excerpt)
+            description = `${description} [spike_notes: ${excerpt}]`;
+        const at = nowIso();
+        await ctx.taskBackend.writeTask({
+            id: taskId,
+            title: opts.title,
+            description,
+            status: "TODO",
+            priority: opts.priority,
+            owner: opts.owner,
+            tags: opts.tags,
+            depends_on: [opts.spikeId],
+            verify: [],
+            comments: [],
+            doc_version: 2,
+            doc_updated_at: at,
+            doc_updated_by: opts.owner,
+            id_source: "generated",
+        });
+        process.stdout.write(`${taskId}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task derive", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/task/doc-set.command.d.ts

@@ -0,0 +1,12 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskDocSetParsed = {
+    taskId: string;
+    section: string;
+    text?: string;
+    file?: string;
+    updatedBy?: string;
+};
+export declare const taskDocSetSpec: CommandSpec<TaskDocSetParsed>;
+export declare function makeRunTaskDocSetHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskDocSetParsed) => Promise<number>;
+//# sourceMappingURL=doc-set.command.d.ts.map

package/dist/commands/task/doc-set.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-set.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-set.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAiExD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAYrE"}

package/dist/commands/task/doc-set.command.js

@@ -0,0 +1,82 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskDocSet } from "./doc.js";
+export const taskDocSetSpec = {
+    id: ["task", "doc", "set"],
+    group: "Task",
+    summary: "Update a task README section.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "section",
+            valueHint: "<name>",
+            required: true,
+            description: "Target section heading (must be one of config.tasks.doc.sections).",
+        },
+        {
+            kind: "string",
+            name: "text",
+            valueHint: "<text>",
+            description: "Section content (mutually exclusive with --file).",
+        },
+        {
+            kind: "string",
+            name: "file",
+            valueHint: "<path>",
+            description: "Read section content from a file (mutually exclusive with --text).",
+        },
+        {
+            kind: "string",
+            name: "updated-by",
+            valueHint: "<id>",
+            description: "Optional. Override doc_updated_by metadata (must be non-empty).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task doc set 202602030608-F1Q8AB --section Summary --text "New summary."',
+            why: "Update one section using inline text.",
+        },
+        {
+            cmd: "agentplane task doc set 202602030608-F1Q8AB --section Plan --file ./plan.md",
+            why: "Update one section using a file.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const hasText = typeof raw.opts.text === "string";
+        const hasFile = typeof raw.opts.file === "string";
+        if (hasText === hasFile) {
+            throw usageError({
+                spec: taskDocSetSpec,
+                message: "Exactly one of --text or --file is required.",
+            });
+        }
+        const updatedBy = raw.opts["updated-by"];
+        if (typeof updatedBy === "string" && updatedBy.trim() === "") {
+            throw usageError({ spec: taskDocSetSpec, message: "--updated-by must be non-empty." });
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            section: String(raw.opts.section),
+            text: typeof raw.opts.text === "string" ? raw.opts.text : undefined,
+            file: typeof raw.opts.file === "string" ? raw.opts.file : undefined,
+            updatedBy: typeof raw.opts["updated-by"] === "string" ? raw.opts["updated-by"] : undefined,
+        };
+    },
+};
+export function makeRunTaskDocSetHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskDocSet({
+            ctx: await getCtx("task doc set"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            section: p.section,
+            text: p.text,
+            file: p.file,
+            updatedBy: p.updatedBy,
+        });
+    };
+}

package/dist/commands/task/doc-show.command.d.ts

@@ -0,0 +1,10 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskDocShowParsed = {
+    taskId: string;
+    section?: string;
+    quiet: boolean;
+};
+export declare const taskDocShowSpec: CommandSpec<TaskDocShowParsed>;
+export declare function makeRunTaskDocShowHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskDocShowParsed) => Promise<number>;
+//# sourceMappingURL=doc-show.command.d.ts.map

package/dist/commands/task/doc-show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAUtE"}

package/dist/commands/task/doc-show.command.js

@@ -0,0 +1,54 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskDocShow } from "./doc.js";
+export const taskDocShowSpec = {
+    id: ["task", "doc", "show"],
+    group: "Task",
+    summary: "Print task README content (entire doc or one section).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "section",
+            valueHint: "<name>",
+            description: "Optional. Print a single section.",
+        },
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress informational output when doc/section content is missing.",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane task doc show 202602030608-F1Q8AB", why: "Print the full doc." },
+        {
+            cmd: "agentplane task doc show 202602030608-F1Q8AB --section Summary",
+            why: "Print a single section.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const section = raw.opts.section;
+        if (typeof section === "string" && section.trim() === "") {
+            throw usageError({ spec: taskDocShowSpec, message: "Invalid value for --section: empty." });
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            section: typeof raw.opts.section === "string" ? raw.opts.section : undefined,
+            quiet: raw.opts.quiet === true,
+        };
+    },
+};
+export function makeRunTaskDocShowHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskDocShow({
+            ctx: await getCtx("task doc show"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            section: p.section,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/task/doc.command.d.ts

@@ -0,0 +1,7 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+export type TaskDocParsed = {
+    subcommand?: string;
+};
+export declare const taskDocSpec: CommandSpec<TaskDocParsed>;
+export declare function runTaskDoc(_ctx: CommandCtx, p: TaskDocParsed): Promise<number>;
+//# sourceMappingURL=doc.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAclD,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E"}

package/dist/commands/task/doc.command.js

@@ -0,0 +1,22 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const taskDocSpec = {
+    id: ["task", "doc"],
+    group: "Task",
+    summary: "Task doc commands (show/set).",
+    synopsis: [
+        "agentplane task doc show <task-id> [--section <name>] [--quiet]",
+        "agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>) [--updated-by <id>]",
+    ],
+    args: [{ name: "subcommand", required: false, valueHint: "<show|set>" }],
+    parse: (raw) => {
+        return {
+            subcommand: typeof raw.args.subcommand === "string" ? raw.args.subcommand : undefined,
+        };
+    },
+};
+export function runTaskDoc(_ctx, p) {
+    if (!p.subcommand) {
+        throw usageError({ spec: taskDocSpec, message: "Missing subcommand." });
+    }
+    throw usageError({ spec: taskDocSpec, message: `Unknown subcommand: ${p.subcommand}` });
+}

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

@@ -1,17 +1,20 @@
-export declare const TASK_DOC_SET_USAGE = "Usage: agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)";
-export declare const TASK_DOC_SET_USAGE_EXAMPLE = "agentplane task doc set 202602030608-F1Q8AB --section Summary --text \"...\"";
-export declare const TASK_DOC_SHOW_USAGE = "Usage: agentplane task doc show <task-id> [--section <name>] [--quiet]";
-export declare const TASK_DOC_SHOW_USAGE_EXAMPLE = "agentplane task doc show 202602030608-F1Q8AB --section Summary";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskDocSet(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;
-    args: string[];
+    section: string;
+    text?: string;
+    file?: string;
+    updatedBy?: string;
 }): Promise<number>;
 export declare function cmdTaskDocShow(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;
-    args: string[];
+    section?: string;
+    quiet: boolean;
 }): Promise<number>;
 //# sourceMappingURL=doc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,kBAAkB,8FAC8D,CAAC;AAC9F,eAAO,MAAM,0BAA0B,iFACuC,CAAC;AAC/E,eAAO,MAAM,mBAAmB,2EAC0C,CAAC;AAC3E,eAAO,MAAM,2BAA2B,mEAC0B,CAAC;AAgFnE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoGlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB"}

package/dist/commands/task/doc.js

@@ -1,96 +1,15 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { ensureDocSections, normalizeDocSectionName, parseDocSections, setMarkdownSection, } from "@agentplaneorg/core";
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
-import { infoMessage, missingValueMessage, unknownEntityMessage, usageMessage, backendNotSupportedMessage, } from "../../cli/output.js";
+import { infoMessage, unknownEntityMessage, backendNotSupportedMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-export const TASK_DOC_SET_USAGE = "Usage: agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)";
-export const TASK_DOC_SET_USAGE_EXAMPLE = 'agentplane task doc set 202602030608-F1Q8AB --section Summary --text "..."';
-export const TASK_DOC_SHOW_USAGE = "Usage: agentplane task doc show <task-id> [--section <name>] [--quiet]";
-export const TASK_DOC_SHOW_USAGE_EXAMPLE = "agentplane task doc show 202602030608-F1Q8AB --section Summary";
-function parseTaskDocShowFlags(args) {
-    const out = { quiet: false };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (!arg)
-            continue;
-        if (arg === "--quiet") {
-            out.quiet = true;
-            continue;
-        }
-        if (arg === "--section") {
-            const next = args[i + 1];
-            if (!next) {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
-            }
-            out.section = next;
-            i++;
-            continue;
-        }
-        throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-    }
-    return out;
-}
-function parseTaskDocSetFlags(args) {
-    const out = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (!arg)
-            continue;
-        if (!arg.startsWith("--")) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unexpected argument: ${arg}` });
-        }
-        const next = args[i + 1];
-        if (!next) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
-        }
-        switch (arg) {
-            case "--section": {
-                out.section = next;
-                break;
-            }
-            case "--text": {
-                out.text = next;
-                break;
-            }
-            case "--file": {
-                out.file = next;
-                break;
-            }
-            case "--updated-by": {
-                out.updatedBy = next;
-                break;
-            }
-            default: {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-            }
-        }
-        i++;
-    }
-    return out;
-}
+import { loadCommandContext } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 export async function cmdTaskDocSet(opts) {
-    const flags = parseTaskDocSetFlags(opts.args);
-    if (!flags.section) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
-        });
-    }
-    const hasText = flags.text !== undefined;
-    const hasFile = flags.file !== undefined;
-    if (hasText === hasFile) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
-        });
-    }
     let updatedBy;
-    if (flags.updatedBy !== undefined) {
-        const trimmed = flags.updatedBy.trim();
+    if (opts.updatedBy !== undefined) {
+        const trimmed = opts.updatedBy.trim();
         if (trimmed.length === 0) {
             throw new CliError({
                 exitCode: 2,
@@ -100,20 +19,30 @@ export async function cmdTaskDocSet(opts) {
         }
         updatedBy = trimmed;
     }
-    let text = flags.text ?? "";
+    const hasText = opts.text !== undefined;
+    const hasFile = opts.file !== undefined;
+    if (hasText === hasFile) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Exactly one of --text or --file must be provided",
+        });
+    }
+    let text = opts.text ?? "";
     if (hasFile) {
         try {
-            text = await readFile(path.resolve(opts.cwd, flags.file ?? ""), "utf8");
+            text = await readFile(path.resolve(opts.cwd, opts.file ?? ""), "utf8");
         }
         catch (err) {
-            throw mapCoreError(err, { command: "task doc set", filePath: flags.file ?? "" });
+            throw mapCoreError(err, { command: "task doc set", filePath: opts.file ?? "" });
         }
     }
     try {
-        const { backend, resolved, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
+        const resolved = ctx.resolvedProject;
+        const config = ctx.config;
         if (!backend.getTaskDoc || !backend.setTaskDoc) {
             throw new CliError({
                 exitCode: 2,
@@ -121,16 +50,18 @@ export async function cmdTaskDocSet(opts) {
                 message: backendNotSupportedMessage("task docs"),
             });
         }
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
         const allowed = config.tasks.doc.sections;
-        if (!allowed.includes(flags.section)) {
+        if (!allowed.includes(opts.section)) {
             throw new CliError({
                 exitCode: 2,
                 code: "E_USAGE",
-                message: unknownEntityMessage("doc section", flags.section),
+                message: unknownEntityMessage("doc section", opts.section),
             });
         }
         const normalizedAllowed = new Set(allowed.map((section) => normalizeDocSectionName(section)));
-        const targetKey = normalizeDocSectionName(flags.section);
+        const targetKey = normalizeDocSectionName(opts.section);
         const headingKeys = new Set();
         for (const line of text.replaceAll("\r\n", "\n").split("\n")) {
             const match = /^##\s+(.*)$/.exec(line.trim());
@@ -140,11 +71,20 @@ export async function cmdTaskDocSet(opts) {
             if (key && normalizedAllowed.has(key))
                 headingKeys.add(key);
         }
-        const existing = await backend.getTaskDoc(opts.taskId);
-        const baseDoc = ensureDocSections(existing ?? "", config.tasks.doc.required_sections);
+        const storeTask = useStore ? await store.get(opts.taskId) : null;
+        const baseDocRaw = useStore
+            ? String(storeTask.doc ?? "")
+            : ((await backend.getTaskDoc(opts.taskId)) ?? "");
+        const baseDoc = ensureDocSections(baseDocRaw, config.tasks.doc.required_sections);
         if (headingKeys.size > 0 && (headingKeys.size > 1 || !headingKeys.has(targetKey))) {
             const fullDoc = ensureDocSections(text, config.tasks.doc.required_sections);
-            await backend.setTaskDoc(opts.taskId, fullDoc, updatedBy);
+            await (useStore
+                ? store.update(opts.taskId, (current) => ({
+                    ...current,
+                    doc: fullDoc,
+                    ...(updatedBy ? { doc_updated_by: updatedBy } : {}),
+                }))
+                : backend.setTaskDoc(opts.taskId, fullDoc, updatedBy));
         }
         else {
             let nextText = text;
@@ -153,16 +93,22 @@ export async function cmdTaskDocSet(opts) {
                 let firstContent = 0;
                 while (firstContent < lines.length && lines[firstContent]?.trim() === "")
                     firstContent++;
-                if ((lines[firstContent]?.trim() ?? "") === `## ${flags.section}`) {
+                if ((lines[firstContent]?.trim() ?? "") === `## ${opts.section}`) {
                     lines.splice(firstContent, 1);
                     if (lines[firstContent]?.trim() === "")
                         lines.splice(firstContent, 1);
                     nextText = lines.join("\n");
                 }
             }
-            const nextDoc = setMarkdownSection(baseDoc, flags.section, nextText);
+            const nextDoc = setMarkdownSection(baseDoc, opts.section, nextText);
             const normalized = ensureDocSections(nextDoc, config.tasks.doc.required_sections);
-            await backend.setTaskDoc(opts.taskId, normalized, updatedBy);
+            await (useStore
+                ? store.update(opts.taskId, (current) => ({
+                    ...current,
+                    doc: normalized,
+                    ...(updatedBy ? { doc_updated_by: updatedBy } : {}),
+                }))
+                : backend.setTaskDoc(opts.taskId, normalized, updatedBy));
         }
         const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
         process.stdout.write(`${path.join(tasksDir, opts.taskId, "README.md")}\n`);
@@ -175,12 +121,10 @@ export async function cmdTaskDocSet(opts) {
     }
 }
 export async function cmdTaskDocShow(opts) {
-    const flags = parseTaskDocShowFlags(opts.args);
     try {
-        const { backend } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
         if (!backend.getTaskDoc) {
             throw new CliError({
                 exitCode: 2,
@@ -188,9 +132,13 @@ export async function cmdTaskDocShow(opts) {
                 message: backendNotSupportedMessage("task docs"),
             });
         }
-        const doc = (await backend.getTaskDoc(opts.taskId)) ?? "";
-        if (flags.section) {
-            const sectionKey = normalizeDocSectionName(flags.section);
+        const useStore = backendIsLocalFileBackend(ctx);
+        const storeTask = useStore ? await getTaskStore(ctx).get(opts.taskId) : null;
+        const doc = useStore
+            ? String(storeTask.doc ?? "")
+            : ((await backend.getTaskDoc(opts.taskId)) ?? "");
+        if (opts.section) {
+            const sectionKey = normalizeDocSectionName(opts.section);
             const { sections } = parseDocSections(doc);
             const entry = sections.get(sectionKey);
             const content = entry?.lines ?? [];
@@ -198,8 +146,8 @@ export async function cmdTaskDocShow(opts) {
                 process.stdout.write(`${content.join("\n").trimEnd()}\n`);
                 return 0;
             }
-            if (!flags.quiet) {
-                process.stdout.write(`${infoMessage(`section has no content: ${flags.section}`)}\n`);
+            if (!opts.quiet) {
+                process.stdout.write(`${infoMessage(`section has no content: ${opts.section}`)}\n`);
             }
             return 0;
         }
@@ -207,7 +155,7 @@ export async function cmdTaskDocShow(opts) {
             process.stdout.write(`${doc.trimEnd()}\n`);
             return 0;
         }
-        if (!flags.quiet) {
+        if (!opts.quiet) {
             process.stdout.write(`${infoMessage("task doc metadata missing")}\n`);
         }
         return 0;

package/dist/commands/task/export.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskExportParsed = Record<string, never>;
+export declare const taskExportSpec: CommandSpec<TaskExportParsed>;
+export declare function makeRunTaskExportHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx) => Promise<number>;
+//# sourceMappingURL=export.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,KAAG,OAAO,CAAC,MAAM,CAAC,CAOhD"}

package/dist/commands/task/export.command.js

@@ -0,0 +1,17 @@
+import { cmdTaskExport } from "./export.js";
+export const taskExportSpec = {
+    id: ["task", "export"],
+    group: "Task",
+    summary: "Export tasks to the configured tasks export path (typically .agentplane/tasks.json).",
+    examples: [{ cmd: "agentplane task export", why: "Write tasks export JSON and print the path." }],
+    parse: () => ({}),
+};
+export function makeRunTaskExportHandler(getCtx) {
+    return async (ctx) => {
+        return await cmdTaskExport({
+            ctx: await getCtx("task export"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+        });
+    };
+}

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

@@ -1,4 +1,6 @@
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskExport(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
 }): Promise<number>;

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

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAOA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjG"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}