agentplane 0.1.8 → 0.2.0

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"}

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

@@ -0,0 +1,89 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskNext } from "./next.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const taskNextSpec = {
+    id: ["task", "next"],
+    group: "Task",
+    summary: "List ready tasks (default status=TODO) with optional filters.",
+    options: [
+        {
+            kind: "string",
+            name: "status",
+            valueHint: "<status>",
+            repeatable: true,
+            description: "Repeatable. Filter by status (default: TODO).",
+        },
+        {
+            kind: "string",
+            name: "owner",
+            valueHint: "<owner>",
+            repeatable: true,
+            description: "Repeatable. Filter by owner id.",
+        },
+        {
+            kind: "string",
+            name: "tag",
+            valueHint: "<tag>",
+            repeatable: true,
+            description: "Repeatable. Filter by tag.",
+        },
+        { kind: "string", name: "limit", valueHint: "<n>", description: "Max rows to print." },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress summary output." },
+    ],
+    examples: [
+        { cmd: "agentplane task next", why: "List ready TODO tasks." },
+        { cmd: "agentplane task next --limit 3", why: "Limit output." },
+    ],
+    validateRaw: (raw) => {
+        for (const key of ["status", "owner", "tag"]) {
+            const list = toStringList(raw.opts[key]);
+            if (list.some((s) => s.trim() === "")) {
+                throw usageError({ spec: taskNextSpec, message: `Invalid value for --${key}: empty.` });
+            }
+        }
+        if (raw.opts.limit !== undefined) {
+            const limitRaw = raw.opts.limit;
+            if (typeof limitRaw !== "string") {
+                throw usageError({
+                    spec: taskNextSpec,
+                    message: `Invalid value for --limit: ${JSON.stringify(limitRaw)} (expected integer)`,
+                });
+            }
+            const parsed = Number.parseInt(limitRaw, 10);
+            if (Number.isFinite(parsed)) {
+                // ok
+            }
+            else {
+                throw usageError({
+                    spec: taskNextSpec,
+                    message: `Invalid value for --limit: ${limitRaw} (expected integer)`,
+                });
+            }
+        }
+    },
+    parse: (raw) => ({
+        filters: {
+            status: toStringList(raw.opts.status),
+            owner: toStringList(raw.opts.owner),
+            tag: toStringList(raw.opts.tag),
+            limit: typeof raw.opts.limit === "string" ? Number.parseInt(raw.opts.limit, 10) : undefined,
+            quiet: raw.opts.quiet === true,
+        },
+    }),
+};
+export function makeRunTaskNextHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskNext({
+            ctx: await getCtx("task next"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            filters: p.filters,
+        });
+    };
+}

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

@@ -1,6 +1,9 @@
+import { type CommandContext } from "../shared/task-backend.js";
+import { type TaskListFilters } from "./shared.js";
 export declare function cmdTaskNext(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    filters: TaskListFilters;
 }): Promise<number>;
 //# sourceMappingURL=next.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/commands/task/next.ts"],"names":[],"mappings":"AAWA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB"}
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/commands/task/next.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB"}

package/dist/commands/task/next.js

@@ -1,25 +1,22 @@
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
-import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, toStringArray, } from "./shared.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, toStringArray, } from "./shared.js";
 export async function cmdTaskNext(opts) {
-    const filters = parseTaskListFilters(opts.args, { allowLimit: true });
     try {
-        const { backend } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const tasks = await backend.listTasks();
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const tasks = await ctx.taskBackend.listTasks();
         const depState = buildDependencyState(tasks);
-        const statuses = filters.status.length > 0
-            ? new Set(filters.status.map((s) => s.trim().toUpperCase()))
+        const statuses = opts.filters.status.length > 0
+            ? new Set(opts.filters.status.map((s) => s.trim().toUpperCase()))
             : new Set(["TODO"]);
         let filtered = tasks.filter((task) => statuses.has(String(task.status || "TODO").toUpperCase()));
-        if (filters.owner.length > 0) {
-            const wanted = new Set(filters.owner.map((o) => o.trim().toUpperCase()));
+        if (opts.filters.owner.length > 0) {
+            const wanted = new Set(opts.filters.owner.map((o) => o.trim().toUpperCase()));
             filtered = filtered.filter((task) => wanted.has(String(task.owner || "").toUpperCase()));
         }
-        if (filters.tag.length > 0) {
-            const wanted = new Set(filters.tag.map((t) => t.trim()).filter(Boolean));
+        if (opts.filters.tag.length > 0) {
+            const wanted = new Set(opts.filters.tag.map((t) => t.trim()).filter(Boolean));
             filtered = filtered.filter((task) => {
                 const tags = dedupeStrings(toStringArray(task.tags));
                 return tags.some((tag) => wanted.has(tag));
@@ -30,11 +27,13 @@ export async function cmdTaskNext(opts) {
             const dep = depState.get(task.id);
             return !dep || (dep.missing.length === 0 && dep.incomplete.length === 0);
         });
-        const limited = filters.limit !== undefined && filters.limit >= 0 ? ready.slice(0, filters.limit) : ready;
+        const limited = opts.filters.limit !== undefined && opts.filters.limit >= 0
+            ? ready.slice(0, opts.filters.limit)
+            : ready;
         for (const task of limited) {
             process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
         }
-        if (!filters.quiet) {
+        if (!opts.filters.quiet) {
             process.stdout.write(`Ready: ${limited.length} / ${filtered.length}\n`);
         }
         return 0;

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

@@ -0,0 +1,9 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskNormalizeParsed = {
+    quiet: boolean;
+    force: boolean;
+};
+export declare const taskNormalizeSpec: CommandSpec<TaskNormalizeParsed>;
+export declare function makeRunTaskNormalizeHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskNormalizeParsed) => Promise<number>;
+//# sourceMappingURL=normalize.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/normalize.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,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CA0B9D,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC5E,KAAK,UAAU,EAAE,GAAG,mBAAmB,KAAG,OAAO,CAAC,MAAM,CAAC,CASxE"}

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

@@ -0,0 +1,39 @@
+import { cmdTaskNormalize } from "./normalize.js";
+export const taskNormalizeSpec = {
+    id: ["task", "normalize"],
+    group: "Task",
+    summary: "Normalize tasks in the configured backend (stable ordering and formatting).",
+    options: [
+        {
+            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 normalize", why: "Normalize tasks and print a short summary." },
+        { cmd: "agentplane task normalize --quiet", why: "Normalize tasks without printing output." },
+    ],
+    parse: (raw) => ({
+        quiet: raw.opts.quiet === true,
+        force: raw.opts.force === true,
+    }),
+};
+export function makeRunTaskNormalizeHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskNormalize({
+            ctx: await getCtx("task normalize"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            quiet: p.quiet,
+            force: p.force,
+        });
+    };
+}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/commands/task/normalize.ts"],"names":[],"mappings":"AAoBA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/commands/task/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB"}

package/dist/commands/task/normalize.js

@@ -1,41 +1,28 @@
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
 import { successMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-function parseTaskNormalizeFlags(args) {
-    const out = { quiet: false, force: false };
-    for (const arg of args) {
-        if (!arg)
-            continue;
-        if (arg === "--quiet")
-            out.quiet = true;
-        else if (arg === "--force")
-            out.force = true;
-        else if (arg.startsWith("--")) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-        }
-    }
-    return out;
-}
+import { loadCommandContext } from "../shared/task-backend.js";
 export async function cmdTaskNormalize(opts) {
-    const flags = parseTaskNormalizeFlags(opts.args);
-    if (flags.force) {
+    if (opts.force) {
         // Force is accepted for parity; no additional checks in node CLI.
     }
     try {
-        const { backend } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const tasks = await backend.listTasks();
-        if (backend.writeTasks) {
-            await backend.writeTasks(tasks);
-        }
-        else {
-            for (const task of tasks)
-                await backend.writeTask(task);
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        if (ctx.taskBackend.normalizeTasks) {
+            const result = await ctx.taskBackend.normalizeTasks();
+            if (!opts.quiet) {
+                process.stdout.write(`${successMessage("normalized tasks", undefined, `scanned=${result.scanned} changed=${result.changed}`)}\n`);
+            }
+            return 0;
         }
-        if (!flags.quiet) {
+        const tasks = await ctx.taskBackend.listTasks();
+        await (ctx.taskBackend.writeTasks
+            ? ctx.taskBackend.writeTasks(tasks)
+            : (async () => {
+                for (const task of tasks)
+                    await ctx.taskBackend.writeTask(task);
+            })());
+        if (!opts.quiet) {
             process.stdout.write(`${successMessage("normalized tasks", undefined, `count=${tasks.length}`)}\n`);
         }
         return 0;

package/dist/commands/task/plan-approve.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 TaskPlanApproveParsed = {
+    taskId: string;
+    by: string;
+    note?: string;
+};
+export declare const taskPlanApproveSpec: CommandSpec<TaskPlanApproveParsed>;
+export declare function makeRunTaskPlanApproveHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskPlanApproveParsed) => Promise<number>;
+//# sourceMappingURL=plan-approve.command.d.ts.map

package/dist/commands/task/plan-approve.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-approve.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan-approve.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,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAuClE,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC9E,KAAK,UAAU,EAAE,GAAG,qBAAqB,KAAG,OAAO,CAAC,MAAM,CAAC,CAU1E"}

package/dist/commands/task/plan-approve.command.js

@@ -0,0 +1,54 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskPlanApprove } from "./plan.js";
+export const taskPlanApproveSpec = {
+    id: ["task", "plan", "approve"],
+    group: "Task",
+    summary: "Approve the current task plan (enforces Verify Steps gating when configured).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "by",
+            valueHint: "<id>",
+            required: true,
+            description: "Approver id.",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            description: "Optional note (stored in plan_approval.note).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task plan approve 202602030608-F1Q8AB --by USER --note "OK"',
+            why: "Approve a plan with a note.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const by = raw.opts.by;
+        if (typeof by === "string" && by.trim().length === 0) {
+            throw usageError({ spec: taskPlanApproveSpec, message: "Invalid value for --by: empty." });
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            by: String(raw.opts.by),
+            note: typeof raw.opts.note === "string" ? raw.opts.note : undefined,
+        };
+    },
+};
+export function makeRunTaskPlanApproveHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskPlanApprove({
+            ctx: await getCtx("task plan approve"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            by: p.by,
+            note: p.note,
+        });
+    };
+}