agentplane 0.1.9 → 0.2.1

package/dist/commands/task/export.js

@@ -1,24 +1,22 @@
 import path from "node:path";
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
 import { backendNotSupportedMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { loadCommandContext } from "../shared/task-backend.js";
 export async function cmdTaskExport(opts) {
     try {
-        const { backend, resolved, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const outPath = path.join(resolved.gitRoot, config.paths.tasks_path);
-        if (!backend.exportTasksJson) {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const outPath = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.tasks_path);
+        if (!ctx.taskBackend.exportTasksJson) {
             throw new CliError({
                 exitCode: 3,
                 code: "E_VALIDATION",
                 message: backendNotSupportedMessage("exportTasksJson()"),
             });
         }
-        await backend.exportTasksJson(outPath);
-        process.stdout.write(`${path.relative(resolved.gitRoot, outPath)}\n`);
+        await ctx.taskBackend.exportTasksJson(outPath);
+        process.stdout.write(`${path.relative(ctx.resolvedProject.gitRoot, outPath)}\n`);
         return 0;
     }
     catch (err) {

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

@@ -1,15 +1,16 @@
-export declare const FINISH_USAGE = "Usage: agentplane finish <task-id> [<task-id>...] --author <id> --body <text> [flags]";
-export declare const FINISH_USAGE_EXAMPLE = "agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body \"Verified: ...\"";
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdFinish(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
     taskIds: string[];
     author: string;
     body: string;
+    result?: string;
+    risk?: "low" | "med" | "high";
+    breaking: boolean;
     commit?: string;
-    skipVerify: boolean;
     force: boolean;
-    noRequireTaskIdInCommit: boolean;
     commitFromComment: boolean;
     commitEmoji?: string;
     commitAllow: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,YAAY,0FACgE,CAAC;AAC1F,eAAO,MAAM,oBAAoB,uFACmD,CAAC;AAErF,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJlB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAcnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyLlB"}

package/dist/commands/task/finish.js

@@ -3,19 +3,13 @@ import { successMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
-import { loadCommandContext, loadTaskFromContext } from "../shared/task-backend.js";
+import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, ensureVerificationSatisfiedIfRequired, 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 ctx = await loadCommandContext({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         const { prefix, min_chars: minChars } = ctx.config.tasks.comments.verified;
         requireStructuredComment(opts.body, prefix, minChars);
         if (opts.commitFromComment || opts.statusCommit) {
@@ -41,12 +35,27 @@ export async function cmdFinish(opts) {
                 message: "--commit-from-comment/--status-commit requires exactly one task id",
             });
         }
+        const gitRoot = ctx.resolvedProject.gitRoot;
         const commitInfo = opts.commit
-            ? await readCommitInfo(ctx.resolved.gitRoot, opts.commit)
-            : await readHeadCommit(ctx.resolved.gitRoot);
+            ? await readCommitInfo(gitRoot, opts.commit)
+            : await readHeadCommit(gitRoot);
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const metaTaskId = opts.taskIds.length === 1 ? (opts.taskIds[0] ?? "") : "";
+        const wantMeta = typeof opts.result === "string" || typeof opts.risk === "string" || opts.breaking === true;
+        if (wantMeta && opts.taskIds.length !== 1) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--result/--risk/--breaking requires exactly one task id",
+            });
+        }
+        const resultSummary = typeof opts.result === "string" ? opts.result.trim() : "";
+        const riskLevel = opts.risk;
+        const breaking = opts.breaking === true;
         let primaryStatusFrom = null;
         for (const taskId of opts.taskIds) {
-            const task = await loadTaskFromContext({ ctx, taskId });
+            const task = useStore ? await store.get(taskId) : await loadTaskFromContext({ ctx, taskId });
             if (!opts.force) {
                 const currentStatus = String(task.status || "TODO").toUpperCase();
                 if (currentStatus === "DONE") {
@@ -63,6 +72,26 @@ export async function cmdFinish(opts) {
                 primaryStatusFrom = String(task.status || "TODO").toUpperCase();
             }
             ensureVerificationSatisfiedIfRequired(task, ctx.config);
+            if (taskId === metaTaskId) {
+                const tags = Array.isArray(task.tags)
+                    ? task.tags.filter((t) => typeof t === "string")
+                    : [];
+                const isSpike = tags.includes("spike");
+                if (!isSpike && opts.taskIds.length === 1 && !resultSummary) {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: "Missing required --result for non-spike tasks.",
+                    });
+                }
+                if (typeof opts.result === "string" && !resultSummary) {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: "Invalid value for --result: empty.",
+                    });
+                }
+            }
             const existingComments = Array.isArray(task.comments)
                 ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
                 : [];
@@ -81,18 +110,21 @@ export async function cmdFinish(opts) {
                     to: "DONE",
                     note: opts.body,
                 }),
+                result_summary: taskId === metaTaskId && resultSummary ? resultSummary : task.result_summary,
+                risk_level: taskId === metaTaskId && riskLevel ? riskLevel : task.risk_level,
+                breaking: taskId === metaTaskId && breaking ? true : task.breaking,
                 doc_version: 2,
                 doc_updated_at: at,
                 doc_updated_by: opts.author,
             };
-            await ctx.backend.writeTask(nextTask);
-        }
-        if (!opts.skipVerify) {
-            // No-op for parity; verify is handled by `agentplane verify`.
+            await (useStore
+                ? store.update(taskId, () => nextTask)
+                : ctx.taskBackend.writeTask(nextTask));
         }
         // tasks.json is export-only; generated via `agentplane task export`.
         if (opts.commitFromComment) {
             await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
@@ -112,6 +144,7 @@ export async function cmdFinish(opts) {
         }
         if (opts.statusCommit) {
             await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,

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

@@ -1,26 +1,27 @@
-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 type { TaskNewParsed } from "./new.js";
+export { runTaskNewParsed } from "./new.js";
+export { cmdTaskAdd } from "./add.js";
+export { cmdTaskUpdate } from "./update.js";
+export { 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 { cmdTaskScaffold } from "./scaffold.js";
 export { cmdTaskNormalize } from "./normalize.js";
 export { cmdTaskMigrate } from "./migrate.js";
-export { TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE, cmdTaskMigrateDoc, } from "./migrate-doc.js";
+export { cmdTaskMigrateDoc } from "./migrate-doc.js";
 export { cmdTaskComment } from "./comment.js";
 export { cmdTaskSetStatus } from "./set-status.js";
 export { cmdTaskShow } from "./show.js";
+export { cmdTaskDerive } from "./derive.js";
 export { cmdTaskExport } from "./export.js";
 export { cmdTaskLint } from "./lint.js";
-export { TASK_PLAN_USAGE, TASK_PLAN_USAGE_EXAMPLE, TASK_PLAN_SET_USAGE, TASK_PLAN_SET_USAGE_EXAMPLE, TASK_PLAN_APPROVE_USAGE, TASK_PLAN_APPROVE_USAGE_EXAMPLE, TASK_PLAN_REJECT_USAGE, TASK_PLAN_REJECT_USAGE_EXAMPLE, cmdTaskPlan, } from "./plan.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_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE, cmdTaskVerify } from "./verify-record.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 { cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject } from "./plan.js";
+export { cmdStart } from "./start.js";
+export { cmdBlock } from "./block.js";
+export { cmdFinish } from "./finish.js";
+export { cmdTaskVerifyOk, cmdTaskVerifyRework } from "./verify-record.js";
+export { cmdTaskDocSet, cmdTaskDocShow } from "./doc.js";
 export { dedupeStrings } from "./shared.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AAC9C,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,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,EACL,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,EAC9B,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,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;AAC5E,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjG,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/task/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,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,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/task/index.js

@@ -1,25 +1,25 @@
-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 { runTaskNewParsed } from "./new.js";
+export { cmdTaskAdd } from "./add.js";
+export { cmdTaskUpdate } from "./update.js";
+export { 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 { cmdTaskScaffold } from "./scaffold.js";
 export { cmdTaskNormalize } from "./normalize.js";
 export { cmdTaskMigrate } from "./migrate.js";
-export { TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE, cmdTaskMigrateDoc, } from "./migrate-doc.js";
+export { cmdTaskMigrateDoc } from "./migrate-doc.js";
 export { cmdTaskComment } from "./comment.js";
 export { cmdTaskSetStatus } from "./set-status.js";
 export { cmdTaskShow } from "./show.js";
+export { cmdTaskDerive } from "./derive.js";
 export { cmdTaskExport } from "./export.js";
 export { cmdTaskLint } from "./lint.js";
-export { TASK_PLAN_USAGE, TASK_PLAN_USAGE_EXAMPLE, TASK_PLAN_SET_USAGE, TASK_PLAN_SET_USAGE_EXAMPLE, TASK_PLAN_APPROVE_USAGE, TASK_PLAN_APPROVE_USAGE_EXAMPLE, TASK_PLAN_REJECT_USAGE, TASK_PLAN_REJECT_USAGE_EXAMPLE, cmdTaskPlan, } from "./plan.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_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE, cmdTaskVerify } from "./verify-record.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 { cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject } from "./plan.js";
+export { cmdStart } from "./start.js";
+export { cmdBlock } from "./block.js";
+export { cmdFinish } from "./finish.js";
+export { cmdTaskVerifyOk, cmdTaskVerifyRework } from "./verify-record.js";
+export { cmdTaskDocSet, cmdTaskDocShow } from "./doc.js";
 export { dedupeStrings } from "./shared.js";

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

@@ -0,0 +1,5 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+export type TaskLintParsed = Record<string, never>;
+export declare const taskLintSpec: CommandSpec<TaskLintParsed>;
+export declare function runTaskLint(ctx: CommandCtx): Promise<number>;
+//# sourceMappingURL=lint.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/lint.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAMpD,CAAC;AAEF,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE"}

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

@@ -0,0 +1,11 @@
+import { cmdTaskLint } from "./lint.js";
+export const taskLintSpec = {
+    id: ["task", "lint"],
+    group: "Task",
+    summary: "Lint the exported tasks JSON file (schema + invariants).",
+    examples: [{ cmd: "agentplane task lint", why: "Validate the tasks export file." }],
+    parse: () => ({}),
+};
+export async function runTaskLint(ctx) {
+    return await cmdTaskLint({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+}

package/dist/commands/task/list.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 TaskListParsed = {
+    filters: TaskListFilters;
+};
+export declare const taskListSpec: CommandSpec<TaskListParsed>;
+export declare function makeRunTaskListHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskListParsed) => Promise<number>;
+//# sourceMappingURL=list.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.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,CAgDpD,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/list.command.js

@@ -0,0 +1,68 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskList } from "./list.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const taskListSpec = {
+    id: ["task", "list"],
+    group: "Task",
+    summary: "List tasks (optionally filtered by status/owner/tag).",
+    options: [
+        {
+            kind: "string",
+            name: "status",
+            valueHint: "<status>",
+            repeatable: true,
+            description: "Repeatable. Filter by status.",
+        },
+        {
+            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: "boolean", name: "quiet", default: false, description: "Suppress summary output." },
+    ],
+    examples: [
+        { cmd: "agentplane task list", why: "List all tasks." },
+        { cmd: "agentplane task list --status TODO --owner CODER", why: "List filtered tasks." },
+    ],
+    validateRaw: (raw) => {
+        for (const key of ["status", "owner", "tag"]) {
+            const list = toStringList(raw.opts[key]);
+            if (list.some((s) => s.trim() === "")) {
+                throw usageError({ spec: taskListSpec, message: `Invalid value for --${key}: empty.` });
+            }
+        }
+    },
+    parse: (raw) => ({
+        filters: {
+            status: toStringList(raw.opts.status),
+            owner: toStringList(raw.opts.owner),
+            tag: toStringList(raw.opts.tag),
+            quiet: raw.opts.quiet === true,
+        },
+    }),
+};
+export function makeRunTaskListHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskList({
+            ctx: await getCtx("task list"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            filters: p.filters,
+        });
+    };
+}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/task/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEnG,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,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;AAED,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,CAElB"}

package/dist/commands/task/list.js

@@ -1,26 +1,23 @@
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
-import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, toStringArray, } from "./shared.js";
+import { listTasksMemo, loadCommandContext } from "../shared/task-backend.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, 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 ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const tasks = await listTasksMemo(ctx);
         const depState = buildDependencyState(tasks);
         let filtered = tasks;
-        if (filters.status.length > 0) {
-            const wanted = new Set(filters.status.map((s) => s.trim().toUpperCase()));
+        if (opts.filters.status.length > 0) {
+            const wanted = new Set(opts.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()));
+        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,7 +27,7 @@ export async function cmdTaskListWithFilters(opts) {
         for (const task of sorted) {
             process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
         }
-        if (!filters.quiet) {
+        if (!opts.filters.quiet) {
             const counts = {};
             for (const task of sorted) {
                 const status = String(task.status || "TODO").toUpperCase();

package/dist/commands/task/migrate-doc.command.d.ts

@@ -0,0 +1,9 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+export type TaskMigrateDocParsed = {
+    all: boolean;
+    quiet: boolean;
+    taskIds: string[];
+};
+export declare const taskMigrateDocSpec: CommandSpec<TaskMigrateDocParsed>;
+export declare function runTaskMigrateDoc(ctx: CommandCtx, p: TaskMigrateDocParsed): Promise<number>;
+//# sourceMappingURL=migrate-doc.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-doc.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAa,MAAM,wBAAwB,CAAC;AAKjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAUF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA6ChE,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQjG"}

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

@@ -0,0 +1,65 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskMigrateDoc } from "./migrate-doc.js";
+function normalizeTaskIdsArg(raw) {
+    const value = raw.args["task-id"];
+    if (Array.isArray(value))
+        return value.filter((v) => typeof v === "string" && v.trim().length > 0);
+    if (typeof value === "string" && value.trim().length > 0)
+        return [value];
+    return [];
+}
+export const taskMigrateDocSpec = {
+    id: ["task", "migrate-doc"],
+    group: "Task",
+    summary: "Migrate task README docs to the current template/metadata format.",
+    args: [{ name: "task-id", required: false, variadic: true, valueHint: "<task-id>" }],
+    options: [
+        { kind: "boolean", name: "all", default: false, description: "Migrate all task READMEs." },
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress normal output (still prints errors).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane task migrate-doc --all", why: "Migrate all task READMEs." },
+        {
+            cmd: "agentplane task migrate-doc 202602030608-F1Q8AB 202602030609-ABCDEF",
+            why: "Migrate specific task READMEs.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const all = raw.opts.all === true;
+        const taskIds = normalizeTaskIdsArg(raw);
+        const hasIds = taskIds.length > 0;
+        if (all && hasIds) {
+            throw usageError({
+                spec: taskMigrateDocSpec,
+                message: "Invalid arguments: use either --all or <task-id>..., not both.",
+            });
+        }
+        if (!all && !hasIds) {
+            throw usageError({
+                spec: taskMigrateDocSpec,
+                message: "Missing task ids (provide <task-id>... or use --all).",
+            });
+        }
+    },
+    parse: (raw) => {
+        return {
+            all: raw.opts.all === true,
+            quiet: raw.opts.quiet === true,
+            taskIds: normalizeTaskIdsArg(raw),
+        };
+    },
+};
+export async function runTaskMigrateDoc(ctx, p) {
+    return await cmdTaskMigrateDoc({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        all: p.all,
+        quiet: p.quiet,
+        taskIds: p.taskIds,
+    });
+}

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

@@ -1,8 +1,8 @@
-export declare const TASK_MIGRATE_DOC_USAGE = "Usage: agentplane task migrate-doc [<task-id> ...] [--all] [--quiet]";
-export declare const TASK_MIGRATE_DOC_USAGE_EXAMPLE = "agentplane task migrate-doc --all";
 export declare function cmdTaskMigrateDoc(opts: {
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    all: boolean;
+    quiet: boolean;
+    taskIds: string[];
 }): Promise<number>;
 //# sourceMappingURL=migrate-doc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,sBAAsB,yEACqC,CAAC;AACzE,eAAO,MAAM,8BAA8B,sCAAsC,CAAC;AAgHlF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB"}
+{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAkIA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB"}