agentplane 0.1.9 → 0.2.1

package/dist/commands/task/migrate-doc.js

@@ -3,48 +3,8 @@ import path from "node:path";
 import { atomicWriteFile, ensureDocSections, extractTaskDoc, loadConfig, mergeTaskDoc, normalizeTaskDoc, parseTaskReadme, renderTaskReadme, resolveProject, } from "@agentplaneorg/core";
 import { mapCoreError } from "../../cli/error-map.js";
 import { fileExists, getPathKind } from "../../cli/fs-utils.js";
-import { successMessage, usageMessage } from "../../cli/output.js";
+import { successMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-export const TASK_MIGRATE_DOC_USAGE = "Usage: agentplane task migrate-doc [<task-id> ...] [--all] [--quiet]";
-export const TASK_MIGRATE_DOC_USAGE_EXAMPLE = "agentplane task migrate-doc --all";
-function parseTaskMigrateDocFlags(args) {
-    const out = { all: false, quiet: false, taskIds: [] };
-    for (const arg of args) {
-        if (!arg)
-            continue;
-        if (arg === "--all") {
-            out.all = true;
-            continue;
-        }
-        if (arg === "--quiet") {
-            out.quiet = true;
-            continue;
-        }
-        if (arg.startsWith("--")) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
-            });
-        }
-        out.taskIds.push(arg);
-    }
-    if (!out.all && out.taskIds.length === 0) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
-        });
-    }
-    if (out.all && out.taskIds.length > 0) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
-        });
-    }
-    return out;
-}
 function isRecord(value) {
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -70,6 +30,38 @@ function ensureVerificationFrontmatter(frontmatter) {
         note: null,
     };
 }
+const DATE_ONLY_ON_RE = /\bon (\d{4}-\d{2}-\d{2})(?!T)\b/g;
+function isIsoTimestamp(value) {
+    if (!value.includes("T") || !value.endsWith("Z"))
+        return false;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms);
+}
+function normalizeNoteTimestamp(opts) {
+    if (!isIsoTimestamp(opts.updatedAt))
+        return opts.note;
+    const updatedDate = opts.updatedAt.slice(0, 10);
+    return opts.note.replaceAll(DATE_ONLY_ON_RE, (match, date) => {
+        if (date !== updatedDate)
+            return match;
+        return `on ${opts.updatedAt}`;
+    });
+}
+function normalizeFrontmatterNoteTimestamps(frontmatter) {
+    const plan = frontmatter.plan_approval;
+    if (isRecord(plan) && typeof plan.note === "string" && typeof plan.updated_at === "string") {
+        plan.note = normalizeNoteTimestamp({ note: plan.note, updatedAt: plan.updated_at });
+    }
+    const verification = frontmatter.verification;
+    if (isRecord(verification) &&
+        typeof verification.note === "string" &&
+        typeof verification.updated_at === "string") {
+        verification.note = normalizeNoteTimestamp({
+            note: verification.note,
+            updatedAt: verification.updated_at,
+        });
+    }
+}
 async function migrateTaskReadmeDoc(opts) {
     const originalRaw = await readFile(opts.readmePath, "utf8");
     const original = originalRaw.endsWith("\n") ? originalRaw : `${originalRaw}\n`;
@@ -77,6 +69,7 @@ async function migrateTaskReadmeDoc(opts) {
     const frontmatter = { ...parsed.frontmatter };
     ensurePlanApprovalFrontmatter(frontmatter);
     ensureVerificationFrontmatter(frontmatter);
+    normalizeFrontmatterNoteTimestamps(frontmatter);
     const required = opts.config.tasks.doc.required_sections;
     const extracted = extractTaskDoc(parsed.body);
     const baseDoc = extracted || parsed.body;
@@ -90,8 +83,8 @@ async function migrateTaskReadmeDoc(opts) {
     return { changed: true };
 }
 async function resolveReadmePaths(opts) {
-    if (!opts.flags.all) {
-        return opts.flags.taskIds.map((taskId) => path.join(opts.tasksDir, taskId, "README.md"));
+    if (!opts.params.all) {
+        return opts.params.taskIds.map((taskId) => path.join(opts.tasksDir, taskId, "README.md"));
     }
     if ((await getPathKind(opts.tasksDir)) !== "dir")
         return [];
@@ -107,7 +100,7 @@ async function resolveReadmePaths(opts) {
     return out;
 }
 export async function cmdTaskMigrateDoc(opts) {
-    const flags = parseTaskMigrateDocFlags(opts.args);
+    const params = { all: opts.all, quiet: opts.quiet, taskIds: opts.taskIds };
     try {
         const resolved = await resolveProject({
             cwd: opts.cwd,
@@ -115,8 +108,8 @@ export async function cmdTaskMigrateDoc(opts) {
         });
         const loaded = await loadConfig(resolved.agentplaneDir);
         const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
-        const readmePaths = await resolveReadmePaths({ tasksDir, flags });
-        if (!flags.all) {
+        const readmePaths = await resolveReadmePaths({ tasksDir, params });
+        if (!params.all) {
             for (const readmePath of readmePaths) {
                 if (!(await fileExists(readmePath))) {
                     const taskId = path.basename(path.dirname(readmePath));
@@ -134,7 +127,7 @@ export async function cmdTaskMigrateDoc(opts) {
             if (res.changed)
                 changed += 1;
         }
-        if (!flags.quiet) {
+        if (!params.quiet) {
             process.stdout.write(`${successMessage("migrated task docs", undefined, `changed=${changed}`)}\n`);
         }
         return 0;

package/dist/commands/task/migrate.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 TaskMigrateParsed = {
+    source?: string;
+    quiet: boolean;
+    force: boolean;
+};
+export declare const taskMigrateSpec: CommandSpec<TaskMigrateParsed>;
+export declare function makeRunTaskMigrateHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskMigrateParsed) => Promise<number>;
+//# sourceMappingURL=migrate.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate.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,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAoC1D,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/migrate.command.js

@@ -0,0 +1,50 @@
+import { cmdTaskMigrate } from "./migrate.js";
+export const taskMigrateSpec = {
+    id: ["task", "migrate"],
+    group: "Task",
+    summary: "Import tasks from an exported JSON file into the configured backend.",
+    options: [
+        {
+            kind: "string",
+            name: "source",
+            valueHint: "<path>",
+            description: "Path to a tasks export JSON file (defaults to config.paths.tasks_path).",
+        },
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress normal output (still prints errors).",
+        },
+        {
+            kind: "boolean",
+            name: "force",
+            default: false,
+            description: "Accepted for parity; currently has no additional checks in the node CLI.",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane task migrate", why: "Import from the default export path." },
+        {
+            cmd: "agentplane task migrate --source tasks-export.json",
+            why: "Import from a custom file.",
+        },
+    ],
+    parse: (raw) => ({
+        source: typeof raw.opts.source === "string" ? raw.opts.source : undefined,
+        quiet: raw.opts.quiet === true,
+        force: raw.opts.force === true,
+    }),
+};
+export function makeRunTaskMigrateHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskMigrate({
+            ctx: await getCtx("task migrate"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            source: p.source,
+            quiet: p.quiet,
+            force: p.force,
+        });
+    };
+}

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

@@ -1,6 +1,10 @@
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskMigrate(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    source?: string;
+    quiet: boolean;
+    force: boolean;
 }): Promise<number>;
 //# sourceMappingURL=migrate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate.ts"],"names":[],"mappings":"AA2CA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlB"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB"}

package/dist/commands/task/migrate.js

@@ -1,53 +1,19 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
-import { missingValueMessage, successMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-function parseTaskMigrateFlags(args) {
-    const out = { quiet: false, force: 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 === "--force") {
-            out.force = true;
-            continue;
-        }
-        if (arg === "--source") {
-            const next = args[i + 1];
-            if (!next) {
-                throw new CliError({
-                    exitCode: 2,
-                    code: "E_USAGE",
-                    message: missingValueMessage("--source"),
-                });
-            }
-            out.source = next;
-            i++;
-            continue;
-        }
-        if (arg.startsWith("--")) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-        }
-    }
-    return out;
-}
+import { successMessage } from "../../cli/output.js";
+import { loadCommandContext } from "../shared/task-backend.js";
 export async function cmdTaskMigrate(opts) {
-    const flags = parseTaskMigrateFlags(opts.args);
-    if (flags.force) {
+    if (opts.force) {
         // Force is accepted for parity; no additional checks in node CLI.
     }
     try {
-        const { backend, resolved, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const source = flags.source ?? config.paths.tasks_path;
+        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;
+        const source = opts.source ?? config.paths.tasks_path;
         const sourcePath = path.join(resolved.gitRoot, source);
         const raw = await readFile(sourcePath, "utf8");
         const parsed = JSON.parse(raw);
@@ -59,7 +25,7 @@ export async function cmdTaskMigrate(opts) {
             for (const task of tasks)
                 await backend.writeTask(task);
         }
-        if (!flags.quiet) {
+        if (!opts.quiet) {
             process.stdout.write(`${successMessage("migrated tasks into backend", undefined, `count=${tasks.length}`)}\n`);
         }
         return 0;

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

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskNewParsed } from "./new.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export { taskNewSpec } from "./new.spec.js";
+export declare function makeRunTaskNewHandler(getCtx: (commandForErrorContext: string) => Promise<CommandContext>): CommandHandler<TaskNewParsed>;
+//# sourceMappingURL=new.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,cAAc,CAAC,aAAa,CAAC,CAU/B"}

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

@@ -0,0 +1,13 @@
+import { runTaskNewParsed } from "./new.js";
+export { taskNewSpec } from "./new.spec.js";
+export function makeRunTaskNewHandler(getCtx) {
+    return async (ctx, p) => {
+        const commandCtx = await getCtx("task new");
+        return await runTaskNewParsed({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            parsed: p,
+        });
+    };
+}

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

@@ -1,8 +1,17 @@
-export declare const TASK_NEW_USAGE = "Usage: agentplane task new --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
-export declare const TASK_NEW_USAGE_EXAMPLE = "agentplane task new --title \"Refactor CLI\" --description \"Improve CLI output\" --priority med --owner CODER --tag cli";
-export declare function cmdTaskNew(opts: {
+import { type CommandContext } from "../shared/task-backend.js";
+export type TaskNewParsed = {
+    title: string;
+    description: string;
+    owner: string;
+    priority: "low" | "normal" | "med" | "high";
+    tags: string[];
+    dependsOn: string[];
+    verify: string[];
+};
+export declare function runTaskNewParsed(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    parsed: TaskNewParsed;
 }): Promise<number>;
 //# sourceMappingURL=new.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,8IACkH,CAAC;AAC9I,eAAO,MAAM,sBAAsB,6HACqF,CAAC;AA6DzH,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,CA0DlB"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,MAAM,MAAM,aAAa,GAAG;IAC1B,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;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DlB"}

package/dist/commands/task/new.js

@@ -1,113 +1,51 @@
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
-import { missingValueMessage, usageMessage, backendNotSupportedMessage } from "../../cli/output.js";
+import { backendNotSupportedMessage, warnMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { normalizeDependsOnInput, nowIso, requiresVerify } from "./shared.js";
-export const TASK_NEW_USAGE = "Usage: agentplane task new --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
-export const TASK_NEW_USAGE_EXAMPLE = 'agentplane task new --title "Refactor CLI" --description "Improve CLI output" --priority med --owner CODER --tag cli';
-function parseTaskNewFlags(args) {
-    const out = { tags: [], dependsOn: [], verify: [] };
-    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 "--title": {
-                out.title = next;
-                break;
-            }
-            case "--description": {
-                out.description = next;
-                break;
-            }
-            case "--owner": {
-                out.owner = next;
-                break;
-            }
-            case "--priority": {
-                out.priority = 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;
-            }
-            default: {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-            }
-        }
-        i++;
-    }
-    return out;
-}
-export async function cmdTaskNew(opts) {
-    const flags = parseTaskNewFlags(opts.args);
-    const priority = flags.priority ?? "med";
-    if (!flags.title || !flags.description || !flags.owner || flags.tags.length === 0) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE),
-        });
-    }
+import { loadCommandContext } from "../shared/task-backend.js";
+import { nowIso, requiresVerify, warnIfUnknownOwner } from "./shared.js";
+export async function runTaskNewParsed(opts) {
+    const p = opts.parsed;
     try {
-        const { backend, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const suffixLength = config.tasks.id_suffix_length_default;
-        if (!backend.generateTaskId) {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const suffixLength = ctx.config.tasks.id_suffix_length_default;
+        if (!ctx.taskBackend.generateTaskId) {
             throw new CliError({
                 exitCode: 3,
                 code: "E_VALIDATION",
                 message: backendNotSupportedMessage("generateTaskId()"),
             });
         }
-        const taskId = await backend.generateTaskId({ length: suffixLength, attempts: 1000 });
+        const taskId = await ctx.taskBackend.generateTaskId({ length: suffixLength, attempts: 1000 });
         const task = {
             id: taskId,
-            title: flags.title,
-            description: flags.description,
+            title: p.title,
+            description: p.description,
             status: "TODO",
-            priority,
-            owner: flags.owner,
-            tags: flags.tags,
-            depends_on: flags.dependsOn,
-            verify: flags.verify,
+            priority: p.priority,
+            owner: p.owner,
+            tags: p.tags,
+            depends_on: p.dependsOn,
+            verify: p.verify,
             comments: [],
             doc_version: 2,
             doc_updated_at: nowIso(),
-            doc_updated_by: flags.owner,
+            doc_updated_by: p.owner,
             id_source: "generated",
         };
-        if (requiresVerify(flags.tags, config.tasks.verify.required_tags) &&
-            flags.verify.length === 0) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: "Missing verify commands for tasks with code/backend/frontend tags (use --verify)",
-            });
+        const requireStepsTags = ctx.config.tasks.verify.require_steps_for_tags ?? ctx.config.tasks.verify.required_tags;
+        const spikeTag = (ctx.config.tasks.verify.spike_tag ?? "spike").trim().toLowerCase();
+        const requiresVerifySteps = requiresVerify(p.tags, requireStepsTags);
+        await warnIfUnknownOwner(ctx, p.owner);
+        if (requiresVerifySteps) {
+            process.stderr.write(`${warnMessage(`task requires ## Verify Steps in README; run \`agentplane task scaffold ${taskId}\` and fill it before approving the plan`)}\n`);
+        }
+        const hasSpike = p.tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
+        const hasImplementationTags = requiresVerify(p.tags, ctx.config.tasks.verify.required_tags);
+        if (hasSpike && hasImplementationTags) {
+            process.stderr.write(`${warnMessage("spike is combined with code/backend/frontend tags; consider splitting spike vs implementation tasks")}\n`);
         }
-        await backend.writeTask(task);
+        await ctx.taskBackend.writeTask(task);
         process.stdout.write(`${taskId}\n`);
         return 0;
     }

package/dist/commands/task/new.spec.d.ts

@@ -0,0 +1,4 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+import type { TaskNewParsed } from "./new.js";
+export declare const taskNewSpec: CommandSpec<TaskNewParsed>;
+//# sourceMappingURL=new.spec.d.ts.map

package/dist/commands/task/new.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CA8ElD,CAAC"}

package/dist/commands/task/new.spec.js

@@ -0,0 +1,79 @@
+import { normalizeDependsOnInput } from "./shared.js";
+export const taskNewSpec = {
+    id: ["task", "new"],
+    group: "Task",
+    summary: "Create a new task (prints the generated task id).",
+    description: "Creates a TODO task with doc_version=2 and writes it via the configured task backend.",
+    options: [
+        {
+            kind: "string",
+            name: "title",
+            valueHint: "<text>",
+            required: true,
+            description: "Task title.",
+        },
+        {
+            kind: "string",
+            name: "description",
+            valueHint: "<text>",
+            required: true,
+            description: "Task description.",
+        },
+        {
+            kind: "string",
+            name: "owner",
+            valueHint: "<id>",
+            required: true,
+            description: "Owner id (e.g. CODER).",
+        },
+        {
+            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).",
+        },
+        {
+            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.",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task new --title "Refactor CLI" --description "Improve CLI output" --owner CODER --tag cli',
+            why: "Create a new task with one tag.",
+        },
+    ],
+    notes: [
+        "This command may emit warnings for tasks that require Verify Steps in the README (config-dependent).",
+    ],
+    parse: (raw) => ({
+        title: raw.opts.title,
+        description: raw.opts.description,
+        owner: raw.opts.owner,
+        priority: (raw.opts.priority ?? "med"),
+        tags: (raw.opts.tag ?? []),
+        dependsOn: (raw.opts["depends-on"] ?? []),
+        verify: (raw.opts.verify ?? []),
+    }),
+};

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

@@ -0,0 +1,9 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+import type { TaskListFilters } from "./shared.js";
+export type TaskNextParsed = {
+    filters: TaskListFilters;
+};
+export declare const taskNextSpec: CommandSpec<TaskNextParsed>;
+export declare function makeRunTaskNextHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskNextParsed) => Promise<number>;
+//# sourceMappingURL=next.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/next.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAQ1D,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAoEpD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACvE,KAAK,UAAU,EAAE,GAAG,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,CAQnE"}