agentplane 0.1.9 → 0.2.0

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

@@ -0,0 +1,157 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskAdd } from "./add.js";
+import { normalizeDependsOnInput } from "./shared.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const taskAddSpec = {
+    id: ["task", "add"],
+    group: "Task",
+    summary: "Create one or more tasks with explicit ids (prints the created task ids).",
+    args: [{ name: "task-id", required: true, variadic: true, valueHint: "<task-id>" }],
+    options: [
+        { kind: "string", name: "title", valueHint: "<text>", required: true, description: "Title." },
+        {
+            kind: "string",
+            name: "description",
+            valueHint: "<text>",
+            required: true,
+            description: "Description.",
+        },
+        {
+            kind: "string",
+            name: "status",
+            valueHint: "<TODO|DOING|DONE|BLOCKED>",
+            choices: ["TODO", "DOING", "DONE", "BLOCKED"],
+            default: "TODO",
+            description: "Initial status (default: TODO).",
+        },
+        {
+            kind: "string",
+            name: "priority",
+            valueHint: "<low|normal|med|high>",
+            choices: ["low", "normal", "med", "high"],
+            required: true,
+            description: "Task priority.",
+        },
+        {
+            kind: "string",
+            name: "owner",
+            valueHint: "<id>",
+            required: true,
+            description: "Owner id (e.g. CODER).",
+        },
+        {
+            kind: "string",
+            name: "tag",
+            valueHint: "<tag>",
+            repeatable: true,
+            minCount: 1,
+            description: "Repeatable. Adds a tag (must provide at least one).",
+        },
+        {
+            kind: "string",
+            name: "depends-on",
+            valueHint: "<task-id>",
+            repeatable: true,
+            coerce: (raw) => normalizeDependsOnInput(raw),
+            description: "Repeatable. Adds a dependency. Special-case: '[]' is treated as empty.",
+        },
+        {
+            kind: "string",
+            name: "verify",
+            valueHint: "<command>",
+            repeatable: true,
+            description: "Repeatable. Verification commands/checks to run for this task.",
+        },
+        {
+            kind: "string",
+            name: "comment-author",
+            valueHint: "<id>",
+            description: "Optional. Adds a comment author (requires --comment-body).",
+        },
+        {
+            kind: "string",
+            name: "comment-body",
+            valueHint: "<text>",
+            description: "Optional. Adds a comment body (requires --comment-author).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task add 202602030608-F1Q8AB --title "Refactor CLI" --description "Spec-driven CLI" --priority med --owner CODER --tag cli',
+            why: "Create a task with an explicit id.",
+        },
+        {
+            cmd: 'agentplane task add 202602030608-F1Q8AB 202602030608-ZZZZZZ --title "Refactor CLI" --description "Spec-driven CLI" --priority med --owner CODER --tag cli',
+            why: "Create multiple tasks with shared metadata.",
+        },
+    ],
+    validateRaw: (raw) => {
+        for (const k of ["title", "description", "owner"]) {
+            const v = raw.opts[k];
+            if (typeof v === "string" && v.trim() === "") {
+                throw usageError({ spec: taskAddSpec, message: `Invalid value for --${k}: empty.` });
+            }
+        }
+        const tags = toStringList(raw.opts.tag);
+        if (tags.some((t) => t.trim() === "")) {
+            throw usageError({ spec: taskAddSpec, message: "Invalid value for --tag: empty." });
+        }
+        const commentAuthor = raw.opts["comment-author"];
+        const commentBody = raw.opts["comment-body"];
+        const hasAuthor = typeof commentAuthor === "string" && commentAuthor.trim() !== "";
+        const hasBody = typeof commentBody === "string" && commentBody.trim() !== "";
+        if (hasAuthor !== hasBody) {
+            throw usageError({
+                spec: taskAddSpec,
+                message: "Both --comment-author and --comment-body must be provided together.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const taskIds = Array.isArray(raw.args["task-id"]) ? raw.args["task-id"].map(String) : [];
+        const tags = toStringList(raw.opts.tag);
+        const dependsOn = toStringList(raw.opts["depends-on"]);
+        const verify = toStringList(raw.opts.verify);
+        const commentAuthor = typeof raw.opts["comment-author"] === "string" ? raw.opts["comment-author"] : null;
+        const commentBody = typeof raw.opts["comment-body"] === "string" ? raw.opts["comment-body"] : null;
+        return {
+            taskIds,
+            title: String(raw.opts.title),
+            description: String(raw.opts.description),
+            status: (raw.opts.status ?? "TODO"),
+            priority: raw.opts.priority,
+            owner: String(raw.opts.owner),
+            tags,
+            dependsOn,
+            verify,
+            commentAuthor,
+            commentBody,
+        };
+    },
+};
+export function makeRunTaskAddHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskAdd({
+            ctx: await getCtx("task add"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskIds: p.taskIds,
+            title: p.title,
+            description: p.description,
+            status: p.status,
+            priority: p.priority,
+            owner: p.owner,
+            tags: p.tags,
+            dependsOn: p.dependsOn,
+            verify: p.verify,
+            commentAuthor: p.commentAuthor,
+            commentBody: p.commentBody,
+        });
+    };
+}

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

@@ -1,8 +1,18 @@
-export declare const TASK_ADD_USAGE = "Usage: agentplane task add <task-id> [<task-id> ...] --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
-export declare const TASK_ADD_USAGE_EXAMPLE = "agentplane task add 202602030608-F1Q8AB --title \"...\" --description \"...\" --priority med --owner CODER --tag cli";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskAdd(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    taskIds: string[];
+    title: string;
+    description: string;
+    status: string;
+    priority: string;
+    owner: string;
+    tags: string[];
+    dependsOn: string[];
+    verify: string[];
+    commentAuthor: string | null;
+    commentBody: string | null;
 }): Promise<number>;
 //# sourceMappingURL=add.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/task/add.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc,wKAC4I,CAAC;AACxK,eAAO,MAAM,sBAAsB,yHACiF,CAAC;AAgGrH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlB"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/task/add.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB"}

package/dist/commands/task/add.js

@@ -1,113 +1,15 @@
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
-import { missingValueMessage, usageMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { dedupeStrings, normalizeDependsOnInput, normalizeTaskStatus, nowIso, requiresVerify, } from "./shared.js";
-export const TASK_ADD_USAGE = "Usage: agentplane task add <task-id> [<task-id> ...] --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
-export const TASK_ADD_USAGE_EXAMPLE = 'agentplane task add 202602030608-F1Q8AB --title "..." --description "..." --priority med --owner CODER --tag cli';
-function parseTaskAddFlags(args) {
-    const out = {
-        taskIds: [],
-        title: "",
-        description: "",
-        status: "TODO",
-        priority: "",
-        owner: "",
-        tags: [],
-        dependsOn: [],
-        verify: [],
-    };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (!arg)
-            continue;
-        if (!arg.startsWith("--")) {
-            out.taskIds.push(arg);
-            continue;
-        }
-        const next = args[i + 1];
-        if (arg === "--replace-tags" || arg === "--replace-depends-on" || arg === "--replace-verify") {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: usageMessage(TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE),
-            });
-        }
-        if (!next) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
-        }
-        switch (arg) {
-            case "--title": {
-                out.title = next;
-                break;
-            }
-            case "--description": {
-                out.description = next;
-                break;
-            }
-            case "--status": {
-                out.status = next;
-                break;
-            }
-            case "--priority": {
-                out.priority = next;
-                break;
-            }
-            case "--owner": {
-                out.owner = next;
-                break;
-            }
-            case "--tag": {
-                out.tags.push(next);
-                break;
-            }
-            case "--depends-on": {
-                out.dependsOn.push(...normalizeDependsOnInput(next));
-                break;
-            }
-            case "--verify": {
-                out.verify.push(next);
-                break;
-            }
-            case "--comment-author": {
-                out.commentAuthor = next;
-                break;
-            }
-            case "--comment-body": {
-                out.commentBody = 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 { dedupeStrings, normalizeTaskStatus, nowIso } from "./shared.js";
 export async function cmdTaskAdd(opts) {
-    const flags = parseTaskAddFlags(opts.args);
-    if (flags.taskIds.length === 0 ||
-        !flags.title ||
-        !flags.description ||
-        !flags.priority ||
-        !flags.owner ||
-        flags.tags.length === 0) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE),
-        });
-    }
     try {
-        const { backend, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const status = normalizeTaskStatus(flags.status);
-        const existing = await backend.listTasks();
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const status = normalizeTaskStatus(opts.status);
+        const existing = await ctx.taskBackend.listTasks();
         const existingIds = new Set(existing.map((task) => task.id));
-        for (const taskId of flags.taskIds) {
+        for (const taskId of opts.taskIds) {
             if (existingIds.has(taskId)) {
                 throw new CliError({
                     exitCode: 2,
@@ -116,41 +18,34 @@ export async function cmdTaskAdd(opts) {
                 });
             }
         }
-        const tags = dedupeStrings(flags.tags);
-        const dependsOn = dedupeStrings(flags.dependsOn);
-        const verify = dedupeStrings(flags.verify);
-        const docUpdatedBy = (flags.commentAuthor ?? "").trim() || flags.owner;
-        if (requiresVerify(tags, config.tasks.verify.required_tags) && verify.length === 0) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: "verify commands are required for tasks with code/backend/frontend tags",
-            });
-        }
-        const tasks = flags.taskIds.map((taskId) => ({
+        const tags = dedupeStrings(opts.tags);
+        const dependsOn = dedupeStrings(opts.dependsOn);
+        const verify = dedupeStrings(opts.verify);
+        const docUpdatedBy = (opts.commentAuthor ?? "").trim() || opts.owner;
+        const tasks = opts.taskIds.map((taskId) => ({
             id: taskId,
-            title: flags.title,
-            description: flags.description,
+            title: opts.title,
+            description: opts.description,
             status,
-            priority: flags.priority,
-            owner: flags.owner,
+            priority: opts.priority,
+            owner: opts.owner,
             tags,
             depends_on: dependsOn,
             verify,
-            comments: flags.commentAuthor && flags.commentBody
-                ? [{ author: flags.commentAuthor, body: flags.commentBody }]
+            comments: opts.commentAuthor && opts.commentBody
+                ? [{ author: opts.commentAuthor, body: opts.commentBody }]
                 : [],
             doc_version: 2,
             doc_updated_at: nowIso(),
             doc_updated_by: docUpdatedBy,
             id_source: "explicit",
         }));
-        if (backend.writeTasks) {
-            await backend.writeTasks(tasks);
+        if (ctx.taskBackend.writeTasks) {
+            await ctx.taskBackend.writeTasks(tasks);
         }
         else {
             for (const task of tasks) {
-                await backend.writeTask(task);
+                await ctx.taskBackend.writeTask(task);
             }
         }
         for (const task of tasks) {

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

@@ -1,6 +1,6 @@
-export declare const BLOCK_USAGE = "Usage: agentplane block <task-id> --author <id> --body <text> [flags]";
-export declare const BLOCK_USAGE_EXAMPLE = "agentplane block 202602030608-F1Q8AB --author CODER --body \"Blocked: ...\"";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdBlock(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,WAAW,0EAA0E,CAAC;AACnG,eAAO,MAAM,mBAAmB,gFAC6C,CAAC;AAE9E,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FlB"}
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAYnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGlB"}

package/dist/commands/task/block.js

@@ -3,16 +3,13 @@ import { successMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
-import { loadCommandContext, loadTaskFromContext } from "../shared/task-backend.js";
+import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
-export const BLOCK_USAGE = "Usage: agentplane block <task-id> --author <id> --body <text> [flags]";
-export const BLOCK_USAGE_EXAMPLE = 'agentplane block 202602030608-F1Q8AB --author CODER --body "Blocked: ..."';
 export async function cmdBlock(opts) {
     try {
-        const ctx = await loadCommandContext({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         if (opts.commitFromComment) {
             enforceStatusCommitPolicy({
                 policy: ctx.config.status_commit_policy,
@@ -23,7 +20,11 @@ export async function cmdBlock(opts) {
         }
         const { prefix, min_chars: minChars } = ctx.config.tasks.comments.blocked;
         requireStructuredComment(opts.body, prefix, minChars);
-        const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const task = useStore
+            ? await store.get(opts.taskId)
+            : await loadTaskFromContext({ ctx, taskId: opts.taskId });
         const currentStatus = String(task.status || "TODO").toUpperCase();
         if (!opts.force && !isTransitionAllowed(currentStatus, "BLOCKED")) {
             throw new CliError({
@@ -57,10 +58,13 @@ export async function cmdBlock(opts) {
             doc_updated_at: at,
             doc_updated_by: opts.author,
         };
-        await ctx.backend.writeTask(nextTask);
+        await (useStore
+            ? store.update(opts.taskId, () => nextTask)
+            : ctx.taskBackend.writeTask(nextTask));
         let commitInfo = null;
         if (opts.commitFromComment) {
             commitInfo = await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,

package/dist/commands/task/comment.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 TaskCommentParsed = {
+    taskId: string;
+    author: string;
+    body: string;
+};
+export declare const taskCommentSpec: CommandSpec<TaskCommentParsed>;
+export declare function makeRunTaskCommentHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskCommentParsed) => Promise<number>;
+//# sourceMappingURL=comment.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.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,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA0C1D,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/comment.command.js

@@ -0,0 +1,57 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskComment } from "./comment.js";
+export const taskCommentSpec = {
+    id: ["task", "comment"],
+    group: "Task",
+    summary: "Append a comment to a task.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Comment author id (e.g. CODER).",
+        },
+        {
+            kind: "string",
+            name: "body",
+            valueHint: "<text>",
+            required: true,
+            description: "Comment body text.",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task comment 202602030608-F1Q8AB --author CODER --body "Investigated root cause."',
+            why: "Add a comment and bump doc metadata.",
+        },
+    ],
+    validateRaw: (raw) => {
+        for (const k of ["author", "body"]) {
+            const v = raw.opts[k];
+            if (typeof v === "string" && v.trim() === "") {
+                throw usageError({ spec: taskCommentSpec, message: `Invalid value for --${k}: empty.` });
+            }
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            author: String(raw.opts.author),
+            body: String(raw.opts.body),
+        };
+    },
+};
+export function makeRunTaskCommentHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskComment({
+            ctx: await getCtx("task comment"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            author: p.author,
+            body: p.body,
+        });
+    };
+}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.ts"],"names":[],"mappings":"AAOA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB"}
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAInC,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,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAoClB"}

package/dist/commands/task/comment.js

@@ -1,14 +1,17 @@
 import { mapBackendError } from "../../cli/error-map.js";
 import { successMessage } from "../../cli/output.js";
-import { loadBackendTask } from "../shared/task-backend.js";
+import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { appendTaskEvent, nowIso } from "./shared.js";
 export async function cmdTaskComment(opts) {
     try {
-        const { backend, task } = await loadBackendTask({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            taskId: opts.taskId,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const task = useStore
+            ? await store.get(opts.taskId)
+            : await loadTaskFromContext({ ctx, taskId: opts.taskId });
         const existing = Array.isArray(task.comments)
             ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
             : [];
@@ -26,7 +29,7 @@ export async function cmdTaskComment(opts) {
             doc_updated_at: at,
             doc_updated_by: opts.author,
         };
-        await backend.writeTask(next);
+        await (useStore ? store.update(opts.taskId, () => next) : ctx.taskBackend.writeTask(next));
         process.stdout.write(`${successMessage("commented", opts.taskId)}\n`);
         return 0;
     }

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

@@ -0,0 +1,13 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskDeriveParsed = {
+    spikeId: string;
+    title: string;
+    description: string;
+    owner: string;
+    priority: "low" | "normal" | "med" | "high";
+    tags: string[];
+};
+export declare const taskDeriveSpec: CommandSpec<TaskDeriveParsed>;
+export declare function makeRunTaskDeriveHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskDeriveParsed) => Promise<number>;
+//# sourceMappingURL=derive.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derive.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.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,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,CAAC;AAQF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAqExD,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,CAarE"}

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

@@ -0,0 +1,94 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskDerive } from "./derive.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const taskDeriveSpec = {
+    id: ["task", "derive"],
+    group: "Task",
+    summary: "Derive an implementation task from a spike task (adds depends_on on the spike).",
+    args: [
+        {
+            name: "spike-id",
+            required: true,
+            valueHint: "<task-id>",
+            description: "Spike task id (must have tag spike).",
+        },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "title",
+            valueHint: "<text>",
+            required: true,
+            description: "Task title.",
+        },
+        {
+            kind: "string",
+            name: "description",
+            valueHint: "<text>",
+            required: true,
+            description: "Task description (will be annotated with spike provenance).",
+        },
+        { kind: "string", name: "owner", valueHint: "<id>", required: true, description: "Owner id." },
+        {
+            kind: "string",
+            name: "priority",
+            valueHint: "<low|normal|med|high>",
+            choices: ["low", "normal", "med", "high"],
+            default: "med",
+            description: "Task priority (default: med).",
+        },
+        {
+            kind: "string",
+            name: "tag",
+            valueHint: "<tag>",
+            repeatable: true,
+            minCount: 1,
+            description: "Repeatable. Adds a tag (must provide at least one).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task derive 202602070101-ABCD --title "Implement X" --description "Do the thing" --owner CODER --tag code',
+            why: "Create an implementation task derived from a spike.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const tags = toStringList(raw.opts.tag);
+        if (tags.some((t) => t.trim() === "")) {
+            throw usageError({
+                spec: taskDeriveSpec,
+                command: "task derive",
+                message: "Invalid value for --tag: empty.",
+            });
+        }
+    },
+    parse: (raw) => ({
+        spikeId: typeof raw.args["spike-id"] === "string" ? raw.args["spike-id"] : "",
+        title: raw.opts.title,
+        description: raw.opts.description,
+        owner: raw.opts.owner,
+        priority: raw.opts.priority ?? "med",
+        tags: toStringList(raw.opts.tag),
+    }),
+};
+export function makeRunTaskDeriveHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskDerive({
+            ctx: await getCtx("task derive"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            spikeId: p.spikeId,
+            title: p.title,
+            description: p.description,
+            owner: p.owner,
+            priority: p.priority,
+            tags: p.tags,
+        });
+    };
+}