agentplane 0.1.9 → 0.2.1

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,
+        });
+    };
+}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-reject.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan-reject.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,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA4ChE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC7E,KAAK,UAAU,EAAE,GAAG,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAAC,CAUzE"}

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

@@ -0,0 +1,59 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskPlanReject } from "./plan.js";
+export const taskPlanRejectSpec = {
+    id: ["task", "plan", "reject"],
+    group: "Task",
+    summary: "Reject the current task plan (requires a note).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "by",
+            valueHint: "<id>",
+            required: true,
+            description: "Reviewer id.",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            required: true,
+            description: "Required note explaining what needs to change.",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task plan reject 202602030608-F1Q8AB --by USER --note "Need clarification"',
+            why: "Reject a plan with a note.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const by = raw.opts.by;
+        if (typeof by === "string" && by.trim().length === 0) {
+            throw usageError({ spec: taskPlanRejectSpec, message: "Invalid value for --by: empty." });
+        }
+        const note = raw.opts.note;
+        if (typeof note === "string" && note.trim().length === 0) {
+            throw usageError({ spec: taskPlanRejectSpec, message: "Invalid value for --note: empty." });
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            by: String(raw.opts.by),
+            note: String(raw.opts.note),
+        };
+    },
+};
+export function makeRunTaskPlanRejectHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskPlanReject({
+            ctx: await getCtx("task plan reject"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            by: p.by,
+            note: p.note,
+        });
+    };
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-set.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan-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,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4D1D,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,CAWtE"}

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

@@ -0,0 +1,76 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskPlanSet } from "./plan.js";
+export const taskPlanSetSpec = {
+    id: ["task", "plan", "set"],
+    group: "Task",
+    summary: "Set a task plan (writes the Plan section and resets plan approval to pending).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "text",
+            valueHint: "<text>",
+            description: "Plan text to write into the task README Plan section.",
+        },
+        {
+            kind: "string",
+            name: "file",
+            valueHint: "<path>",
+            description: "Read plan text from a file path (relative to cwd).",
+        },
+        {
+            kind: "string",
+            name: "updated-by",
+            valueHint: "<id>",
+            description: "Optional. Sets doc_updated_by when writing the plan.",
+        },
+    ],
+    examples: [
+        {
+            cmd: String.raw `agentplane task plan set 202602030608-F1Q8AB --text "1) Do X\n2) Verify Y" --updated-by ORCHESTRATOR`,
+            why: "Write plan from text and set doc_updated_by.",
+        },
+        {
+            cmd: "agentplane task plan set 202602030608-F1Q8AB --file plan.md",
+            why: "Write plan from a file.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const hasText = typeof raw.opts.text === "string";
+        const hasFile = typeof raw.opts.file === "string";
+        if (hasText === hasFile) {
+            throw usageError({
+                spec: taskPlanSetSpec,
+                message: "Provide exactly one of --text or --file.",
+            });
+        }
+        const updatedBy = raw.opts["updated-by"];
+        if (typeof updatedBy === "string" && updatedBy.trim().length === 0) {
+            throw usageError({
+                spec: taskPlanSetSpec,
+                message: "Invalid value for --updated-by: empty.",
+            });
+        }
+    },
+    parse: (raw) => {
+        return {
+            taskId: String(raw.args["task-id"]),
+            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 makeRunTaskPlanSetHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskPlanSet({
+            ctx: await getCtx("task plan set"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            text: p.text,
+            file: p.file,
+            updatedBy: p.updatedBy,
+        });
+    };
+}

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

@@ -1,14 +1,27 @@
-export declare const TASK_PLAN_USAGE = "Usage: agentplane task plan <set|approve|reject> <task-id> [flags]";
-export declare const TASK_PLAN_USAGE_EXAMPLE = "agentplane task plan set 202602030608-F1Q8AB --text \"...\"";
-export declare const TASK_PLAN_SET_USAGE = "Usage: agentplane task plan set <task-id> (--text <text> | --file <path>) [--updated-by <id>]";
-export declare const TASK_PLAN_SET_USAGE_EXAMPLE: string;
-export declare const TASK_PLAN_APPROVE_USAGE = "Usage: agentplane task plan approve <task-id> --by <id> [--note <text>]";
-export declare const TASK_PLAN_APPROVE_USAGE_EXAMPLE = "agentplane task plan approve 202602030608-F1Q8AB --by USER --note \"OK\"";
-export declare const TASK_PLAN_REJECT_USAGE = "Usage: agentplane task plan reject <task-id> --by <id> --note <text>";
-export declare const TASK_PLAN_REJECT_USAGE_EXAMPLE = "agentplane task plan reject 202602030608-F1Q8AB --by USER --note \"Need clarification\"";
-export declare function cmdTaskPlan(opts: {
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdTaskPlanSet(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    taskId: string;
+    text?: string;
+    file?: string;
+    updatedBy?: string;
+}): Promise<number>;
+export declare function cmdTaskPlanApprove(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    by: string;
+    note?: string;
+}): Promise<number>;
+export declare function cmdTaskPlanReject(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    by: string;
+    note: string;
 }): Promise<number>;
 //# sourceMappingURL=plan.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe,uEAAuE,CAAC;AACpG,eAAO,MAAM,uBAAuB,gEAA8D,CAAC;AAEnG,eAAO,MAAM,mBAAmB,kGACiE,CAAC;AAClG,eAAO,MAAM,2BAA2B,QAA6G,CAAC;AAEtJ,eAAO,MAAM,uBAAuB,4EACuC,CAAC;AAC5E,eAAO,MAAM,+BAA+B,6EAC8B,CAAC;AAE3E,eAAO,MAAM,sBAAsB,yEACqC,CAAC;AACzE,eAAO,MAAM,8BAA8B,4FAC8C,CAAC;AAoG1F,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,CAwIlB"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AA+CnC,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,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmElB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFlB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB"}