agentplane 0.1.6 → 0.1.7

package/dist/commands/task/finish.js

@@ -0,0 +1,131 @@
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+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 { loadBackendTask } from "../shared/task-backend.js";
+import { defaultCommitEmojiForStatus, enforceStatusCommitPolicy, nowIso, readCommitInfo, readHeadCommit, requireStructuredComment, } from "./shared.js";
+export const FINISH_USAGE = "Usage: agentplane finish <task-id> [<task-id>...] --author <id> --body <text> [flags]";
+export const FINISH_USAGE_EXAMPLE = 'agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body "Verified: ..."';
+export async function cmdFinish(opts) {
+    try {
+        if (opts.noRequireTaskIdInCommit) {
+            // Parity flag (commit subject checks are not enforced in node CLI).
+        }
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        const { prefix, min_chars: minChars } = loaded.config.tasks.comments.verified;
+        requireStructuredComment(opts.body, prefix, minChars);
+        if (opts.commitFromComment || opts.statusCommit) {
+            enforceStatusCommitPolicy({
+                policy: loaded.config.status_commit_policy,
+                action: "finish",
+                confirmed: opts.confirmStatusCommit,
+                quiet: opts.quiet,
+            });
+        }
+        if ((opts.commitFromComment || opts.statusCommit) && opts.taskIds.length !== 1) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--commit-from-comment/--status-commit requires exactly one task id",
+            });
+        }
+        const primaryTaskId = opts.taskIds[0] ?? "";
+        if ((opts.commitFromComment || opts.statusCommit) && !primaryTaskId) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--commit-from-comment/--status-commit requires exactly one task id",
+            });
+        }
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const commitInfo = opts.commit
+            ? await readCommitInfo(resolved.gitRoot, opts.commit)
+            : await readHeadCommit(resolved.gitRoot);
+        for (const taskId of opts.taskIds) {
+            const { task } = await loadBackendTask({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId,
+            });
+            if (!opts.force) {
+                const currentStatus = String(task.status || "TODO").toUpperCase();
+                if (currentStatus === "DONE") {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: `Task is already DONE: ${task.id} (use --force to override)`,
+                    });
+                }
+            }
+            const existingComments = Array.isArray(task.comments)
+                ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+                : [];
+            const commentsValue = [...existingComments, { author: opts.author, body: opts.body }];
+            const nextTask = {
+                ...task,
+                status: "DONE",
+                commit: { hash: commitInfo.hash, message: commitInfo.message },
+                comments: commentsValue,
+                doc_version: 2,
+                doc_updated_at: nowIso(),
+                doc_updated_by: opts.author,
+            };
+            await backend.writeTask(nextTask);
+        }
+        if (!opts.skipVerify) {
+            // No-op for parity; verify is handled by `agentplane verify`.
+        }
+        // tasks.json is export-only; generated via `agentplane task export`.
+        if (opts.commitFromComment) {
+            await commitFromComment({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: primaryTaskId,
+                commentBody: opts.body,
+                formattedComment: formatCommentBodyForCommit(opts.body, loaded.config),
+                emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus("DONE"),
+                allow: opts.commitAllow,
+                autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
+                allowTasks: opts.commitAllowTasks,
+                requireClean: opts.commitRequireClean,
+                quiet: opts.quiet,
+                config: loaded.config,
+            });
+        }
+        if (opts.statusCommit) {
+            await commitFromComment({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: primaryTaskId,
+                commentBody: opts.body,
+                formattedComment: formatCommentBodyForCommit(opts.body, loaded.config),
+                emoji: opts.statusCommitEmoji ?? defaultCommitEmojiForStatus("DONE"),
+                allow: opts.statusCommitAllow,
+                autoAllow: opts.statusCommitAutoAllow || opts.statusCommitAllow.length === 0,
+                allowTasks: true,
+                requireClean: opts.statusCommitRequireClean,
+                quiet: opts.quiet,
+                config: loaded.config,
+            });
+        }
+        if (!opts.quiet) {
+            process.stdout.write(`${successMessage("finished")}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "finish", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,23 @@
+export { TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE, cmdTaskNew } from "./new.js";
+export { TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE, cmdTaskAdd } from "./add.js";
+export { TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE, cmdTaskUpdate } from "./update.js";
+export { TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE, cmdTaskScrub } from "./scrub.js";
+export { cmdTaskListWithFilters, cmdTaskList } from "./list.js";
+export { cmdTaskNext } from "./next.js";
+export { cmdReady } from "./ready.js";
+export { cmdTaskSearch } from "./search.js";
+export { TASK_SCAFFOLD_USAGE, TASK_SCAFFOLD_USAGE_EXAMPLE, cmdTaskScaffold } from "./scaffold.js";
+export { cmdTaskNormalize } from "./normalize.js";
+export { cmdTaskMigrate } from "./migrate.js";
+export { cmdTaskComment } from "./comment.js";
+export { cmdTaskSetStatus } from "./set-status.js";
+export { cmdTaskShow } from "./show.js";
+export { cmdTaskExport } from "./export.js";
+export { cmdTaskLint } from "./lint.js";
+export { START_USAGE, START_USAGE_EXAMPLE, cmdStart } from "./start.js";
+export { BLOCK_USAGE, BLOCK_USAGE_EXAMPLE, cmdBlock } from "./block.js";
+export { FINISH_USAGE, FINISH_USAGE_EXAMPLE, cmdFinish } from "./finish.js";
+export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify.js";
+export { TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE, TASK_DOC_SHOW_USAGE, TASK_DOC_SHOW_USAGE_EXAMPLE, cmdTaskDocSet, cmdTaskDocShow, } from "./doc.js";
+export { dedupeStrings } from "./shared.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/task/index.js

@@ -0,0 +1,22 @@
+export { TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE, cmdTaskNew } from "./new.js";
+export { TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE, cmdTaskAdd } from "./add.js";
+export { TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE, cmdTaskUpdate } from "./update.js";
+export { TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE, cmdTaskScrub } from "./scrub.js";
+export { cmdTaskListWithFilters, cmdTaskList } from "./list.js";
+export { cmdTaskNext } from "./next.js";
+export { cmdReady } from "./ready.js";
+export { cmdTaskSearch } from "./search.js";
+export { TASK_SCAFFOLD_USAGE, TASK_SCAFFOLD_USAGE_EXAMPLE, cmdTaskScaffold } from "./scaffold.js";
+export { cmdTaskNormalize } from "./normalize.js";
+export { cmdTaskMigrate } from "./migrate.js";
+export { cmdTaskComment } from "./comment.js";
+export { cmdTaskSetStatus } from "./set-status.js";
+export { cmdTaskShow } from "./show.js";
+export { cmdTaskExport } from "./export.js";
+export { cmdTaskLint } from "./lint.js";
+export { START_USAGE, START_USAGE_EXAMPLE, cmdStart } from "./start.js";
+export { BLOCK_USAGE, BLOCK_USAGE_EXAMPLE, cmdBlock } from "./block.js";
+export { FINISH_USAGE, FINISH_USAGE_EXAMPLE, cmdFinish } from "./finish.js";
+export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify.js";
+export { TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE, TASK_DOC_SHOW_USAGE, TASK_DOC_SHOW_USAGE_EXAMPLE, cmdTaskDocSet, cmdTaskDocShow, } from "./doc.js";
+export { dedupeStrings } from "./shared.js";

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

@@ -0,0 +1,5 @@
+export declare function cmdTaskLint(opts: {
+    cwd: string;
+    rootOverride?: string;
+}): Promise<number>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../src/commands/task/lint.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB/F"}

package/dist/commands/task/lint.js

@@ -0,0 +1,22 @@
+import { lintTasksFile } from "@agentplaneorg/core";
+import { mapCoreError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+export async function cmdTaskLint(opts) {
+    try {
+        const result = await lintTasksFile({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+        if (result.errors.length > 0) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: result.errors.join("\n"),
+            });
+        }
+        process.stdout.write("OK\n");
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "task lint", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,11 @@
+export declare function cmdTaskListWithFilters(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+export declare function cmdTaskList(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.ts"],"names":[],"mappings":"AAWA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ClB;AAED,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,CAElB"}

package/dist/commands/task/list.js

@@ -0,0 +1,54 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, toStringArray, } from "./shared.js";
+export async function cmdTaskListWithFilters(opts) {
+    const filters = parseTaskListFilters(opts.args);
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        const depState = buildDependencyState(tasks);
+        let filtered = tasks;
+        if (filters.status.length > 0) {
+            const wanted = new Set(filters.status.map((s) => s.trim().toUpperCase()));
+            filtered = filtered.filter((task) => wanted.has(String(task.status || "TODO").toUpperCase()));
+        }
+        if (filters.owner.length > 0) {
+            const wanted = new Set(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));
+            filtered = filtered.filter((task) => {
+                const tags = dedupeStrings(toStringArray(task.tags));
+                return tags.some((tag) => wanted.has(tag));
+            });
+        }
+        const sorted = filtered.toSorted((a, b) => a.id.localeCompare(b.id));
+        for (const task of sorted) {
+            process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
+        }
+        if (!filters.quiet) {
+            const counts = {};
+            for (const task of sorted) {
+                const status = String(task.status || "TODO").toUpperCase();
+                counts[status] = (counts[status] ?? 0) + 1;
+            }
+            const total = sorted.length;
+            const summary = Object.keys(counts)
+                .toSorted()
+                .map((key) => `${key}=${counts[key]}`)
+                .join(", ");
+            process.stdout.write(`Total: ${total}${summary ? ` (${summary})` : ""}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task list", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdTaskList(opts) {
+    return await cmdTaskListWithFilters(opts);
+}

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

@@ -0,0 +1,6 @@
+export declare function cmdTaskMigrate(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/task/migrate.js

@@ -0,0 +1,70 @@
+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;
+}
+export async function cmdTaskMigrate(opts) {
+    const flags = parseTaskMigrateFlags(opts.args);
+    if (flags.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 sourcePath = path.join(resolved.gitRoot, source);
+        const raw = await readFile(sourcePath, "utf8");
+        const parsed = JSON.parse(raw);
+        const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+        if (backend.writeTasks) {
+            await backend.writeTasks(tasks);
+        }
+        else {
+            for (const task of tasks)
+                await backend.writeTask(task);
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("migrated tasks into backend", undefined, `count=${tasks.length}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task migrate", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+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: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=new.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/task/new.js

@@ -0,0 +1,117 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { missingValueMessage, usageMessage, backendNotSupportedMessage } 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),
+        });
+    }
+    try {
+        const { backend, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const suffixLength = config.tasks.id_suffix_length_default;
+        if (!backend.generateTaskId) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: backendNotSupportedMessage("generateTaskId()"),
+            });
+        }
+        const taskId = await backend.generateTaskId({ length: suffixLength, attempts: 1000 });
+        const task = {
+            id: taskId,
+            title: flags.title,
+            description: flags.description,
+            status: "TODO",
+            priority,
+            owner: flags.owner,
+            tags: flags.tags,
+            depends_on: flags.dependsOn,
+            verify: flags.verify,
+            comments: [],
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: flags.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)",
+            });
+        }
+        await backend.writeTask(task);
+        process.stdout.write(`${taskId}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task new", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,6 @@
+export declare function cmdTaskNext(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=next.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/task/next.js

@@ -0,0 +1,45 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, 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 depState = buildDependencyState(tasks);
+        const statuses = filters.status.length > 0
+            ? new Set(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()));
+            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));
+            filtered = filtered.filter((task) => {
+                const tags = dedupeStrings(toStringArray(task.tags));
+                return tags.some((tag) => wanted.has(tag));
+            });
+        }
+        const sorted = filtered.toSorted((a, b) => a.id.localeCompare(b.id));
+        const ready = sorted.filter((task) => {
+            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;
+        for (const task of limited) {
+            process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
+        }
+        if (!filters.quiet) {
+            process.stdout.write(`Ready: ${limited.length} / ${filtered.length}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task next", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,6 @@
+export declare function cmdTaskNormalize(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/task/normalize.js

@@ -0,0 +1,46 @@
+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;
+}
+export async function cmdTaskNormalize(opts) {
+    const flags = parseTaskNormalizeFlags(opts.args);
+    if (flags.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);
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("normalized tasks", undefined, `count=${tasks.length}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task normalize", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,6 @@
+export declare function cmdReady(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+}): Promise<number>;
+//# sourceMappingURL=ready.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ready.d.ts","sourceRoot":"","sources":["../../../src/commands/task/ready.ts"],"names":[],"mappings":"AAMA,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlB"}