agentplane 0.3.5 → 0.3.7

package/dist/commands/task/close-duplicate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-duplicate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AASrF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFlB"}
+{"version":3,"file":"close-duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-duplicate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIrF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlB"}

package/dist/commands/task/close-duplicate.js

@@ -3,7 +3,7 @@ import { CliError } from "../../shared/errors.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { loadTaskFromContext } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
-import { appendTaskEvent, normalizeTaskDocVersion, nowIso, requireStructuredComment, } from "./shared.js";
+import { recordVerifiedNoopClosure } from "./close-shared.js";
 export async function cmdTaskCloseDuplicate(opts) {
     try {
         const sourceId = opts.taskId.trim();
@@ -36,47 +36,22 @@ export async function cmdTaskCloseDuplicate(opts) {
         const task = useStore
             ? await store.get(sourceId)
             : await loadTaskFromContext({ ctx: opts.ctx, taskId: sourceId });
-        if (!opts.force && String(task.status || "TODO").toUpperCase() === "DONE") {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Task is already DONE: ${sourceId} (use --force to override)`,
-            });
-        }
         const reason = opts.note?.trim();
         const canonicalTitle = canonical.title?.trim() ? ` (${canonical.title.trim()})` : "";
         const baseBody = `Verified: ${sourceId} is a bookkeeping duplicate of ${duplicateOf}${canonicalTitle}; ` +
             "no code/config changes are expected in this task and closure is recorded as no-op.";
         const body = reason ? `${baseBody}\n\nReason: ${reason}` : baseBody;
-        const verifiedCfg = opts.ctx.config.tasks.comments.verified;
-        requireStructuredComment(body, verifiedCfg.prefix, verifiedCfg.min_chars);
-        const at = nowIso();
-        const next = {
-            ...task,
-            status: "DONE",
-            comments: [
-                ...(Array.isArray(task.comments) ? task.comments : []),
-                { author: opts.author, body },
-            ],
-            events: appendTaskEvent(task, {
-                type: "status",
-                at,
-                author: opts.author,
-                from: String(task.status || "TODO").toUpperCase(),
-                to: "DONE",
-                note: body,
-            }),
-            result_summary: `Closed as duplicate of ${duplicateOf}.`,
-            risk_level: "low",
-            breaking: false,
-            doc_version: normalizeTaskDocVersion(task.doc_version),
-            doc_updated_at: at,
-            doc_updated_by: opts.author,
-        };
-        await (useStore ? store.update(sourceId, () => next) : opts.ctx.taskBackend.writeTask(next));
-        if (!opts.quiet) {
-            process.stdout.write(`task.done: ${sourceId} (duplicate of ${duplicateOf})\n`);
-        }
+        await recordVerifiedNoopClosure({
+            ctx: opts.ctx,
+            task,
+            taskId: sourceId,
+            author: opts.author,
+            body,
+            resultSummary: `Closed as duplicate of ${duplicateOf}.`,
+            quiet: opts.quiet,
+            successMessage: `task.done: ${sourceId} (duplicate of ${duplicateOf})`,
+            force: opts.force,
+        });
         return 0;
     }
     catch (err) {

package/dist/commands/task/close-noop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-noop.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-noop.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsElB"}
+{"version":3,"file":"close-noop.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-noop.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB"}

package/dist/commands/task/close-noop.js

@@ -3,7 +3,7 @@ import { CliError } from "../../shared/errors.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { loadCommandContext } from "../shared/task-backend.js";
-import { appendTaskEvent, normalizeTaskDocVersion, nowIso, requireStructuredComment, } from "./shared.js";
+import { recordVerifiedNoopClosure } from "./close-shared.js";
 export async function cmdTaskCloseNoop(opts) {
     try {
         const ctx = opts.ctx ??
@@ -38,35 +38,17 @@ export async function cmdTaskCloseNoop(opts) {
         const normalizedNote = opts.note?.trim();
         const baseBody = "Verified: no implementation changes were required; closure is recorded as no-op bookkeeping.";
         const body = normalizedNote ? `${baseBody}\n\nNote: ${normalizedNote}` : baseBody;
-        const verifiedCfg = ctx.config.tasks.comments.verified;
-        requireStructuredComment(body, verifiedCfg.prefix, verifiedCfg.min_chars);
-        const at = nowIso();
-        const next = {
-            ...task,
-            status: "DONE",
-            comments: [
-                ...(Array.isArray(task.comments) ? task.comments : []),
-                { author: opts.author, body },
-            ],
-            events: appendTaskEvent(task, {
-                type: "status",
-                at,
-                author: opts.author,
-                from: String(task.status || "TODO").toUpperCase(),
-                to: "DONE",
-                note: body,
-            }),
-            result_summary: "No-op closure recorded.",
-            risk_level: "low",
-            breaking: false,
-            doc_version: normalizeTaskDocVersion(task.doc_version),
-            doc_updated_at: at,
-            doc_updated_by: opts.author,
-        };
-        await (useStore ? store.update(opts.taskId, () => next) : ctx.taskBackend.writeTask(next));
-        if (!opts.quiet) {
-            process.stdout.write(`task.done: ${opts.taskId} (no-op)\n`);
-        }
+        await recordVerifiedNoopClosure({
+            ctx,
+            task,
+            taskId: opts.taskId,
+            author: opts.author,
+            body,
+            resultSummary: "No-op closure recorded.",
+            quiet: opts.quiet,
+            successMessage: `task.done: ${opts.taskId} (no-op)`,
+            force: opts.force,
+        });
         return 0;
     }
     catch (err) {

package/dist/commands/task/close-shared.d.ts

@@ -0,0 +1,14 @@
+import { type TaskData } from "../../backends/task-backend.js";
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function recordVerifiedNoopClosure(opts: {
+    ctx: CommandContext;
+    task: TaskData;
+    taskId: string;
+    author: string;
+    body: string;
+    resultSummary: string;
+    quiet: boolean;
+    successMessage: string;
+    force: boolean;
+}): Promise<void>;
+//# sourceMappingURL=close-shared.d.ts.map

package/dist/commands/task/close-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAgBhE,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhB"}

package/dist/commands/task/close-shared.js

@@ -0,0 +1,73 @@
+import { CliError } from "../../shared/errors.js";
+import { appendTaskCommentIntent, appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, setTaskFieldsIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
+import { appendTaskEvent, normalizeTaskDocVersion, nowIso, requireStructuredComment, } from "./shared.js";
+export async function recordVerifiedNoopClosure(opts) {
+    if (!opts.force && String(opts.task.status || "TODO").toUpperCase() === "DONE") {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Task is already DONE: ${opts.taskId} (use --force to override)`,
+        });
+    }
+    const verifiedCfg = opts.ctx.config.tasks.comments.verified;
+    requireStructuredComment(opts.body, verifiedCfg.prefix, verifiedCfg.min_chars);
+    const at = nowIso();
+    const useStore = backendIsLocalFileBackend(opts.ctx);
+    const store = useStore ? getTaskStore(opts.ctx) : null;
+    await (useStore
+        ? store.mutate(opts.taskId, (current) => {
+            if (!opts.force && String(current.status || "TODO").toUpperCase() === "DONE") {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Task is already DONE: ${opts.taskId} (use --force to override)`,
+                });
+            }
+            return [
+                setTaskFieldsIntent({
+                    status: "DONE",
+                    result_summary: opts.resultSummary,
+                    risk_level: "low",
+                    breaking: false,
+                }),
+                appendTaskCommentIntent({ author: opts.author, body: opts.body }),
+                appendTaskEventIntent({
+                    type: "status",
+                    at,
+                    author: opts.author,
+                    from: String(current.status || "TODO").toUpperCase(),
+                    to: "DONE",
+                    note: opts.body,
+                }),
+                touchTaskDocMetaIntent({
+                    updatedBy: opts.author,
+                    version: normalizeTaskDocVersion(current.doc_version),
+                }),
+            ];
+        })
+        : opts.ctx.taskBackend.writeTask({
+            ...opts.task,
+            status: "DONE",
+            comments: [
+                ...(Array.isArray(opts.task.comments) ? opts.task.comments : []),
+                { author: opts.author, body: opts.body },
+            ],
+            events: appendTaskEvent(opts.task, {
+                type: "status",
+                at,
+                author: opts.author,
+                from: String(opts.task.status || "TODO").toUpperCase(),
+                to: "DONE",
+                note: opts.body,
+            }),
+            result_summary: opts.resultSummary,
+            risk_level: "low",
+            breaking: false,
+            doc_version: normalizeTaskDocVersion(opts.task.doc_version),
+            doc_updated_at: at,
+            doc_updated_by: opts.author,
+        }));
+    if (!opts.quiet) {
+        process.stdout.write(`${opts.successMessage}\n`);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAInC,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAoClB"}
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAUnC,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB"}

package/dist/commands/task/comment.js

@@ -1,7 +1,7 @@
 import { mapBackendError } from "../../cli/error-map.js";
 import { successMessage } from "../../cli/output.js";
 import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
-import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { appendTaskCommentIntent, appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, touchTaskDocMetaIntent, } from "../shared/task-store.js";
 import { appendTaskEvent, normalizeTaskDocVersion, nowIso } from "./shared.js";
 export async function cmdTaskComment(opts) {
     try {
@@ -9,27 +9,40 @@ export async function cmdTaskComment(opts) {
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         const useStore = backendIsLocalFileBackend(ctx);
         const store = useStore ? getTaskStore(ctx) : null;
-        const task = useStore
-            ? await store.get(opts.taskId)
-            : await loadTaskFromContext({ ctx, taskId: opts.taskId });
-        const existing = Array.isArray(task.comments)
-            ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
-            : [];
+        const task = useStore ? null : await loadTaskFromContext({ ctx, taskId: opts.taskId });
         const at = nowIso();
-        const next = {
-            ...task,
-            comments: [...existing, { author: opts.author, body: opts.body }],
-            events: appendTaskEvent(task, {
-                type: "comment",
-                at,
-                author: opts.author,
-                body: opts.body,
-            }),
-            doc_version: normalizeTaskDocVersion(task.doc_version),
-            doc_updated_at: at,
-            doc_updated_by: opts.author,
-        };
-        await (useStore ? store.update(opts.taskId, () => next) : ctx.taskBackend.writeTask(next));
+        await (useStore
+            ? store.mutate(opts.taskId, (current) => [
+                appendTaskCommentIntent({ author: opts.author, body: opts.body }),
+                appendTaskEventIntent({
+                    type: "comment",
+                    at,
+                    author: opts.author,
+                    body: opts.body,
+                }),
+                touchTaskDocMetaIntent({
+                    updatedBy: opts.author,
+                    version: normalizeTaskDocVersion(current.doc_version),
+                }),
+            ])
+            : ctx.taskBackend.writeTask({
+                ...task,
+                comments: [
+                    ...(Array.isArray(task.comments)
+                        ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+                        : []),
+                    { author: opts.author, body: opts.body },
+                ],
+                events: appendTaskEvent(task, {
+                    type: "comment",
+                    at,
+                    author: opts.author,
+                    body: opts.body,
+                }),
+                doc_version: normalizeTaskDocVersion(task.doc_version),
+                doc_updated_at: at,
+                doc_updated_by: opts.author,
+            }));
         process.stdout.write(`${successMessage("commented", opts.taskId)}\n`);
         return 0;
     }

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

@@ -7,6 +7,7 @@ export type TaskDeriveParsed = {
     owner: string;
     priority: "low" | "normal" | "med" | "high";
     tags: string[];
+    verify: string[];
 };
 export declare const taskDeriveSpec: CommandSpec<TaskDeriveParsed>;
 export declare function makeRunTaskDeriveHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskDeriveParsed) => Promise<number>;

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

@@ -1 +1 @@
-{"version":3,"file":"derive.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAqExD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAarE"}
+{"version":3,"file":"derive.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAiFxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAcrE"}

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

@@ -45,13 +45,24 @@ export const taskDeriveSpec = {
             minCount: 1,
             description: "Repeatable. Adds a tag (must provide at least one).",
         },
+        {
+            kind: "string",
+            name: "verify",
+            valueHint: "<command>",
+            repeatable: true,
+            description: "Repeatable. Verification commands/checks to run for this task.",
+        },
     ],
     examples: [
         {
-            cmd: 'agentplane task derive 202602070101-ABCD --title "Implement X" --description "Do the thing" --owner CODER --tag code',
-            why: "Create an implementation task derived from a spike.",
+            cmd: 'agentplane task derive 202602070101-ABCD --title "Implement X" --description "Do the thing" --owner CODER --tag code --verify "bun test"',
+            why: "Create an implementation task derived from a spike with seeded verify steps.",
         },
     ],
+    notes: [
+        "Derived tasks default to doc_version=3 and seed the README v3 section contract automatically.",
+        "For verify-required primary tags, this command seeds a default ## Verify Steps acceptance contract in README.",
+    ],
     validateRaw: (raw) => {
         const tags = toStringList(raw.opts.tag);
         if (tags.some((t) => t.trim() === "")) {
@@ -69,6 +80,7 @@ export const taskDeriveSpec = {
         owner: raw.opts.owner,
         priority: raw.opts.priority ?? "med",
         tags: toStringList(raw.opts.tag),
+        verify: (raw.opts.verify ?? []),
     }),
 };
 export function makeRunTaskDeriveHandler(getCtx) {
@@ -83,6 +95,7 @@ export function makeRunTaskDeriveHandler(getCtx) {
             owner: p.owner,
             priority: p.priority,
             tags: p.tags,
+            verify: p.verify,
         });
     };
 }

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

@@ -9,5 +9,6 @@ export declare function cmdTaskDerive(opts: {
     owner: string;
     priority: "low" | "normal" | "med" | "high";
     tags: string[];
+    verify: string[];
 }): Promise<number>;
 //# sourceMappingURL=derive.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.ts"],"names":[],"mappings":"AAGA,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;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiElB"}
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../src/commands/task/derive.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAuBpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlB"}

package/dist/commands/task/derive.js

@@ -1,8 +1,10 @@
+import { setMarkdownSection, taskDocToSectionMap } from "@agentplaneorg/core";
 import { mapBackendError } from "../../cli/error-map.js";
-import { unknownEntityMessage } from "../../cli/output.js";
+import { unknownEntityMessage, warnMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { loadCommandContext } from "../shared/task-backend.js";
-import { extractTaskObservationSection, normalizeTaskDocVersion, nowIso, toStringArray, } from "./shared.js";
+import { buildDefaultVerifyStepsSection, defaultTaskDocV3, TASK_DOC_VERSION_V3, } from "./doc-template.js";
+import { extractTaskObservationSection, normalizeTaskDocVersion, nowIso, requiresVerifyStepsByPrimary, resolvePrimaryTag, toStringArray, warnIfUnknownOwner, } from "./shared.js";
 function normalizeOneLine(text, maxChars) {
     const normalized = text.trim().replaceAll(/\s+/g, " ");
     if (normalized.length <= maxChars)
@@ -45,6 +47,25 @@ export async function cmdTaskDerive(opts) {
         description = `${description} (derived from spike ${opts.spikeId})`;
         if (excerpt)
             description = `${description} [spike_notes: ${excerpt}]`;
+        let doc = defaultTaskDocV3({ title: opts.title, description });
+        const spikeTag = (ctx.config.tasks.verify.spike_tag ?? "spike").trim().toLowerCase();
+        const primary = resolvePrimaryTag(opts.tags, ctx);
+        if (primary.usedFallback) {
+            process.stderr.write(`${warnMessage(`primary tag not found in task tags; using fallback primary=${primary.primary}`)}\n`);
+        }
+        const requiresVerifySteps = requiresVerifyStepsByPrimary(opts.tags, ctx.config);
+        await warnIfUnknownOwner(ctx, opts.owner);
+        if (requiresVerifySteps) {
+            doc = setMarkdownSection(doc, "Verify Steps", buildDefaultVerifyStepsSection({
+                primary: primary.primary,
+                verifyCommands: opts.verify,
+            }));
+            process.stderr.write(`${warnMessage("task requires Verify Steps by primary tag; seeded a default ## Verify Steps section in README (review and refine before approval/start)")}\n`);
+        }
+        const hasSpike = opts.tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
+        if (hasSpike && requiresVerifySteps) {
+            process.stderr.write(`${warnMessage("spike is combined with a primary tag that requires verify steps; consider splitting spike vs implementation tasks")}\n`);
+        }
         const at = nowIso();
         await ctx.taskBackend.writeTask({
             id: taskId,
@@ -55,9 +76,11 @@ export async function cmdTaskDerive(opts) {
             owner: opts.owner,
             tags: opts.tags,
             depends_on: [opts.spikeId],
-            verify: [],
+            verify: opts.verify,
             comments: [],
-            doc_version: 2,
+            doc,
+            sections: taskDocToSectionMap(doc),
+            doc_version: TASK_DOC_VERSION_V3,
             doc_updated_at: at,
             doc_updated_by: opts.owner,
             id_source: "generated",

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

@@ -2,10 +2,11 @@ import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
 import type { CommandContext } from "../shared/task-backend.js";
 export type TaskDocSetParsed = {
     taskId: string;
-    section: string;
+    section?: string;
     text?: string;
     file?: string;
     updatedBy?: string;
+    fullDoc: boolean;
 };
 export declare const taskDocSetSpec: CommandSpec<TaskDocSetParsed>;
 export declare function makeRunTaskDocSetHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskDocSetParsed) => Promise<number>;

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

@@ -1 +1 @@
-{"version":3,"file":"doc-set.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-set.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAiExD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAYrE"}
+{"version":3,"file":"doc-set.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-set.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAiGxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACzE,KAAK,UAAU,EAAE,GAAG,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAarE"}

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

@@ -4,20 +4,29 @@ export const taskDocSetSpec = {
     id: ["task", "doc", "set"],
     group: "Task",
     summary: "Update a task README section.",
+    synopsis: [
+        "agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>) [--updated-by <id>]",
+        "agentplane task doc set <task-id> --full-doc (--text <text> | --file <path>) [--updated-by <id>]",
+    ],
     args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
     options: [
         {
             kind: "string",
             name: "section",
             valueHint: "<name>",
-            required: true,
-            description: "Target section heading (must be one of config.tasks.doc.sections).",
+            description: "Target section heading (must be one of config.tasks.doc.sections). Required unless --full-doc is set.",
+        },
+        {
+            kind: "boolean",
+            name: "full-doc",
+            default: false,
+            description: "Treat the provided text/file as the full task README payload.",
         },
         {
             kind: "string",
             name: "text",
             valueHint: "<text>",
-            description: "Section content (mutually exclusive with --file).",
+            description: String.raw `Section content (mutually exclusive with --file). Literal escaped newlines (\n) are normalized for inline text.`,
         },
         {
             kind: "string",
@@ -41,8 +50,29 @@ export const taskDocSetSpec = {
             cmd: "agentplane task doc set 202602030608-F1Q8AB --section Plan --file ./plan.md",
             why: "Update one section using a file.",
         },
+        {
+            cmd: "agentplane task doc set 202602030608-F1Q8AB --full-doc --file ./task-readme.md",
+            why: "Replace the full task README payload explicitly.",
+        },
     ],
     validateRaw: (raw) => {
+        const fullDoc = raw.opts["full-doc"] === true;
+        const section = typeof raw.opts.section === "string" ? raw.opts.section.trim() : "";
+        if (fullDoc && section) {
+            throw usageError({
+                spec: taskDocSetSpec,
+                message: "Use either --section or --full-doc (not both).",
+            });
+        }
+        if (!fullDoc && !section) {
+            throw usageError({
+                spec: taskDocSetSpec,
+                message: "Missing required option: --section (or pass --full-doc).",
+            });
+        }
+        if (typeof raw.opts.section === "string" && section === "") {
+            throw usageError({ spec: taskDocSetSpec, message: "Invalid value for --section: empty." });
+        }
         const hasText = typeof raw.opts.text === "string";
         const hasFile = typeof raw.opts.file === "string";
         if (hasText === hasFile) {
@@ -59,10 +89,11 @@ export const taskDocSetSpec = {
     parse: (raw) => {
         return {
             taskId: String(raw.args["task-id"]),
-            section: String(raw.opts.section),
+            section: typeof raw.opts.section === "string" ? raw.opts.section : undefined,
             text: typeof raw.opts.text === "string" ? raw.opts.text : undefined,
             file: typeof raw.opts.file === "string" ? raw.opts.file : undefined,
             updatedBy: typeof raw.opts["updated-by"] === "string" ? raw.opts["updated-by"] : undefined,
+            fullDoc: raw.opts["full-doc"] === true,
         };
     },
 };
@@ -77,6 +108,7 @@ export function makeRunTaskDocSetHandler(getCtx) {
             text: p.text,
             file: p.file,
             updatedBy: p.updatedBy,
+            fullDoc: p.fullDoc,
         });
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"doc-template.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-template.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAkErC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkCrF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,MAAM,CA2BT"}
+{"version":3,"file":"doc-template.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-template.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AA2DrC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkCrF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,MAAM,CA2BT"}

package/dist/commands/task/doc-template.js

@@ -1,13 +1,8 @@
 import { setMarkdownSection } from "@agentplaneorg/core";
+import { decodeEscapedTaskTextNewlines } from "./shared/docs.js";
 export const TASK_DOC_VERSION_V3 = 3;
 function normalizeTaskHumanText(text) {
-    let next = text.replaceAll("\r\n", "\n");
-    const escapedDoubleNewline = next.includes(String.raw `\n\n`) || next.includes(String.raw `\r\n\r\n`);
-    const escapedNewlineMatches = next.match(/\\n/g) ?? [];
-    if (escapedDoubleNewline || escapedNewlineMatches.length >= 2) {
-        next = next.replaceAll(String.raw `\r\n`, "\n").replaceAll(String.raw `\n`, "\n");
-    }
-    return next.trim();
+    return decodeEscapedTaskTextNewlines(text).trim();
 }
 function normalizeTaskHumanInlineText(text) {
     return normalizeTaskHumanText(text)

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

@@ -6,7 +6,7 @@ export const taskDocSpec = {
     synopsis: [
         "agentplane task doc show <task-id> [--section <name>] [--quiet]",
         "agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>) [--updated-by <id>]",
-        "agentplane task doc set <task-id> --section Summary --file ./task-readme.md  # if payload contains multiple known ## headings, apply as full-doc update",
+        "agentplane task doc set <task-id> --full-doc (--text <text> | --file <path>) [--updated-by <id>]",
     ],
     args: [{ name: "subcommand", required: false, valueHint: "<show|set>" }],
     parse: (raw) => {

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

@@ -4,10 +4,11 @@ export declare function cmdTaskDocSet(opts: {
     cwd: string;
     rootOverride?: string;
     taskId: string;
-    section: string;
+    section?: string;
     text?: string;
     file?: string;
     updatedBy?: string;
+    fullDoc: boolean;
 }): Promise<number>;
 export declare function cmdTaskDocShow(opts: {
     ctx?: CommandContext;

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

@@ -1 +1 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmBpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2IlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB"}
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA6CpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgLlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDlB"}