agentplane 0.1.8 → 0.2.0

package/dist/commands/task/doc.js

@@ -1,96 +1,15 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { ensureDocSections, normalizeDocSectionName, parseDocSections, setMarkdownSection, } from "@agentplaneorg/core";
-import { loadTaskBackend } from "../../backends/task-backend.js";
 import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
-import { infoMessage, missingValueMessage, unknownEntityMessage, usageMessage, backendNotSupportedMessage, } from "../../cli/output.js";
+import { infoMessage, unknownEntityMessage, backendNotSupportedMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-export const TASK_DOC_SET_USAGE = "Usage: agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)";
-export const TASK_DOC_SET_USAGE_EXAMPLE = 'agentplane task doc set 202602030608-F1Q8AB --section Summary --text "..."';
-export const TASK_DOC_SHOW_USAGE = "Usage: agentplane task doc show <task-id> [--section <name>] [--quiet]";
-export const TASK_DOC_SHOW_USAGE_EXAMPLE = "agentplane task doc show 202602030608-F1Q8AB --section Summary";
-function parseTaskDocShowFlags(args) {
-    const out = { quiet: 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 === "--section") {
-            const next = args[i + 1];
-            if (!next) {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
-            }
-            out.section = next;
-            i++;
-            continue;
-        }
-        throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-    }
-    return out;
-}
-function parseTaskDocSetFlags(args) {
-    const out = {};
-    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 "--section": {
-                out.section = next;
-                break;
-            }
-            case "--text": {
-                out.text = next;
-                break;
-            }
-            case "--file": {
-                out.file = next;
-                break;
-            }
-            case "--updated-by": {
-                out.updatedBy = next;
-                break;
-            }
-            default: {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
-            }
-        }
-        i++;
-    }
-    return out;
-}
+import { loadCommandContext } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 export async function cmdTaskDocSet(opts) {
-    const flags = parseTaskDocSetFlags(opts.args);
-    if (!flags.section) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
-        });
-    }
-    const hasText = flags.text !== undefined;
-    const hasFile = flags.file !== undefined;
-    if (hasText === hasFile) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
-        });
-    }
     let updatedBy;
-    if (flags.updatedBy !== undefined) {
-        const trimmed = flags.updatedBy.trim();
+    if (opts.updatedBy !== undefined) {
+        const trimmed = opts.updatedBy.trim();
         if (trimmed.length === 0) {
             throw new CliError({
                 exitCode: 2,
@@ -100,20 +19,30 @@ export async function cmdTaskDocSet(opts) {
         }
         updatedBy = trimmed;
     }
-    let text = flags.text ?? "";
+    const hasText = opts.text !== undefined;
+    const hasFile = opts.file !== undefined;
+    if (hasText === hasFile) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Exactly one of --text or --file must be provided",
+        });
+    }
+    let text = opts.text ?? "";
     if (hasFile) {
         try {
-            text = await readFile(path.resolve(opts.cwd, flags.file ?? ""), "utf8");
+            text = await readFile(path.resolve(opts.cwd, opts.file ?? ""), "utf8");
         }
         catch (err) {
-            throw mapCoreError(err, { command: "task doc set", filePath: flags.file ?? "" });
+            throw mapCoreError(err, { command: "task doc set", filePath: opts.file ?? "" });
         }
     }
     try {
-        const { backend, resolved, config } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
+        const resolved = ctx.resolvedProject;
+        const config = ctx.config;
         if (!backend.getTaskDoc || !backend.setTaskDoc) {
             throw new CliError({
                 exitCode: 2,
@@ -121,16 +50,18 @@ export async function cmdTaskDocSet(opts) {
                 message: backendNotSupportedMessage("task docs"),
             });
         }
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
         const allowed = config.tasks.doc.sections;
-        if (!allowed.includes(flags.section)) {
+        if (!allowed.includes(opts.section)) {
             throw new CliError({
                 exitCode: 2,
                 code: "E_USAGE",
-                message: unknownEntityMessage("doc section", flags.section),
+                message: unknownEntityMessage("doc section", opts.section),
             });
         }
         const normalizedAllowed = new Set(allowed.map((section) => normalizeDocSectionName(section)));
-        const targetKey = normalizeDocSectionName(flags.section);
+        const targetKey = normalizeDocSectionName(opts.section);
         const headingKeys = new Set();
         for (const line of text.replaceAll("\r\n", "\n").split("\n")) {
             const match = /^##\s+(.*)$/.exec(line.trim());
@@ -140,11 +71,20 @@ export async function cmdTaskDocSet(opts) {
             if (key && normalizedAllowed.has(key))
                 headingKeys.add(key);
         }
-        const existing = await backend.getTaskDoc(opts.taskId);
-        const baseDoc = ensureDocSections(existing ?? "", config.tasks.doc.required_sections);
+        const storeTask = useStore ? await store.get(opts.taskId) : null;
+        const baseDocRaw = useStore
+            ? String(storeTask.doc ?? "")
+            : ((await backend.getTaskDoc(opts.taskId)) ?? "");
+        const baseDoc = ensureDocSections(baseDocRaw, config.tasks.doc.required_sections);
         if (headingKeys.size > 0 && (headingKeys.size > 1 || !headingKeys.has(targetKey))) {
             const fullDoc = ensureDocSections(text, config.tasks.doc.required_sections);
-            await backend.setTaskDoc(opts.taskId, fullDoc, updatedBy);
+            await (useStore
+                ? store.update(opts.taskId, (current) => ({
+                    ...current,
+                    doc: fullDoc,
+                    ...(updatedBy ? { doc_updated_by: updatedBy } : {}),
+                }))
+                : backend.setTaskDoc(opts.taskId, fullDoc, updatedBy));
         }
         else {
             let nextText = text;
@@ -153,16 +93,22 @@ export async function cmdTaskDocSet(opts) {
                 let firstContent = 0;
                 while (firstContent < lines.length && lines[firstContent]?.trim() === "")
                     firstContent++;
-                if ((lines[firstContent]?.trim() ?? "") === `## ${flags.section}`) {
+                if ((lines[firstContent]?.trim() ?? "") === `## ${opts.section}`) {
                     lines.splice(firstContent, 1);
                     if (lines[firstContent]?.trim() === "")
                         lines.splice(firstContent, 1);
                     nextText = lines.join("\n");
                 }
             }
-            const nextDoc = setMarkdownSection(baseDoc, flags.section, nextText);
+            const nextDoc = setMarkdownSection(baseDoc, opts.section, nextText);
             const normalized = ensureDocSections(nextDoc, config.tasks.doc.required_sections);
-            await backend.setTaskDoc(opts.taskId, normalized, updatedBy);
+            await (useStore
+                ? store.update(opts.taskId, (current) => ({
+                    ...current,
+                    doc: normalized,
+                    ...(updatedBy ? { doc_updated_by: updatedBy } : {}),
+                }))
+                : backend.setTaskDoc(opts.taskId, normalized, updatedBy));
         }
         const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
         process.stdout.write(`${path.join(tasksDir, opts.taskId, "README.md")}\n`);
@@ -175,12 +121,10 @@ export async function cmdTaskDocSet(opts) {
     }
 }
 export async function cmdTaskDocShow(opts) {
-    const flags = parseTaskDocShowFlags(opts.args);
     try {
-        const { backend } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const backend = ctx.taskBackend;
         if (!backend.getTaskDoc) {
             throw new CliError({
                 exitCode: 2,
@@ -188,9 +132,13 @@ export async function cmdTaskDocShow(opts) {
                 message: backendNotSupportedMessage("task docs"),
             });
         }
-        const doc = (await backend.getTaskDoc(opts.taskId)) ?? "";
-        if (flags.section) {
-            const sectionKey = normalizeDocSectionName(flags.section);
+        const useStore = backendIsLocalFileBackend(ctx);
+        const storeTask = useStore ? await getTaskStore(ctx).get(opts.taskId) : null;
+        const doc = useStore
+            ? String(storeTask.doc ?? "")
+            : ((await backend.getTaskDoc(opts.taskId)) ?? "");
+        if (opts.section) {
+            const sectionKey = normalizeDocSectionName(opts.section);
             const { sections } = parseDocSections(doc);
             const entry = sections.get(sectionKey);
             const content = entry?.lines ?? [];
@@ -198,8 +146,8 @@ export async function cmdTaskDocShow(opts) {
                 process.stdout.write(`${content.join("\n").trimEnd()}\n`);
                 return 0;
             }
-            if (!flags.quiet) {
-                process.stdout.write(`${infoMessage(`section has no content: ${flags.section}`)}\n`);
+            if (!opts.quiet) {
+                process.stdout.write(`${infoMessage(`section has no content: ${opts.section}`)}\n`);
             }
             return 0;
         }
@@ -207,7 +155,7 @@ export async function cmdTaskDocShow(opts) {
             process.stdout.write(`${doc.trimEnd()}\n`);
             return 0;
         }
-        if (!flags.quiet) {
+        if (!opts.quiet) {
             process.stdout.write(`${infoMessage("task doc metadata missing")}\n`);
         }
         return 0;

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

@@ -0,0 +1,6 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskExportParsed = Record<string, never>;
+export declare const taskExportSpec: CommandSpec<TaskExportParsed>;
+export declare function makeRunTaskExportHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx) => Promise<number>;
+//# sourceMappingURL=export.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.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,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,KAAG,OAAO,CAAC,MAAM,CAAC,CAOhD"}

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

@@ -0,0 +1,17 @@
+import { cmdTaskExport } from "./export.js";
+export const taskExportSpec = {
+    id: ["task", "export"],
+    group: "Task",
+    summary: "Export tasks to the configured tasks export path (typically .agentplane/tasks.json).",
+    examples: [{ cmd: "agentplane task export", why: "Write tasks export JSON and print the path." }],
+    parse: () => ({}),
+};
+export function makeRunTaskExportHandler(getCtx) {
+    return async (ctx) => {
+        return await cmdTaskExport({
+            ctx: await getCtx("task export"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+        });
+    };
+}

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

@@ -1,4 +1,6 @@
+import { type CommandContext } from "../shared/task-backend.js";
 export declare function cmdTaskExport(opts: {
+    ctx?: CommandContext;
     cwd: string;
     rootOverride?: string;
 }): Promise<number>;

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

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAOA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjG"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

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":"AAqBA,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,CAoIlB"}
+{"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

@@ -1,29 +1,20 @@
-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, 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: ..."';
+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 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;
+        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) {
             enforceStatusCommitPolicy({
-                policy: loaded.config.status_commit_policy,
+                policy: ctx.config.status_commit_policy,
                 action: "finish",
                 confirmed: opts.confirmStatusCommit,
                 quiet: opts.quiet,
@@ -44,19 +35,27 @@ export async function cmdFinish(opts) {
                 message: "--commit-from-comment/--status-commit requires exactly one task id",
             });
         }
-        const { backend } = await loadTaskBackend({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const gitRoot = ctx.resolvedProject.gitRoot;
         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,
+            ? 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 = useStore ? await store.get(taskId) : await loadTaskFromContext({ ctx, taskId });
             if (!opts.force) {
                 const currentStatus = String(task.status || "TODO").toUpperCase();
                 if (currentStatus === "DONE") {
@@ -67,56 +66,100 @@ export async function cmdFinish(opts) {
                     });
                 }
             }
-            ensureVerificationSatisfiedIfRequired(task, loaded.config);
+            if (taskId === primaryTaskId &&
+                (opts.commitFromComment || opts.statusCommit) &&
+                primaryStatusFrom === null) {
+                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")
                 : [];
             const commentsValue = [...existingComments, { author: opts.author, body: opts.body }];
+            const at = nowIso();
             const nextTask = {
                 ...task,
                 status: "DONE",
                 commit: { hash: commitInfo.hash, message: commitInfo.message },
                 comments: commentsValue,
+                events: appendTaskEvent(task, {
+                    type: "status",
+                    at,
+                    author: opts.author,
+                    from: String(task.status || "TODO").toUpperCase(),
+                    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: nowIso(),
+                doc_updated_at: at,
                 doc_updated_by: opts.author,
             };
-            await 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,
+                author: opts.author,
+                statusFrom: primaryStatusFrom ?? undefined,
+                statusTo: "DONE",
                 commentBody: opts.body,
-                formattedComment: formatCommentBodyForCommit(opts.body, loaded.config),
+                formattedComment: formatCommentBodyForCommit(opts.body, ctx.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,
+                config: ctx.config,
             });
         }
         if (opts.statusCommit) {
             await commitFromComment({
+                ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
+                author: opts.author,
+                statusFrom: primaryStatusFrom ?? undefined,
+                statusTo: "DONE",
                 commentBody: opts.body,
-                formattedComment: formatCommentBodyForCommit(opts.body, loaded.config),
+                formattedComment: formatCommentBodyForCommit(opts.body, ctx.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,
+                config: ctx.config,
             });
         }
         if (!opts.quiet) {

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