agentplane 0.3.10 → 0.3.11

package/dist/commands/shared/post-commit-pr-artifacts.js

@@ -0,0 +1,22 @@
+import { warnMessage } from "../../cli/output.js";
+import { normalizeGhTransportError } from "../shared/gh-transport.js";
+import { ensurePrArtifactsSynced } from "../pr/internal/sync.js";
+export async function refreshBranchPrArtifactsAfterTaskCommit(opts) {
+    if (opts.ctx.config.workflow_mode !== "branch_pr")
+        return;
+    try {
+        await ensurePrArtifactsSynced({
+            ctx: opts.ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+    }
+    catch (err) {
+        if (opts.quiet)
+            return;
+        const detail = normalizeGhTransportError(err).trim();
+        const suffix = detail ? ` (${detail})` : "";
+        process.stderr.write(`${warnMessage(`task commit succeeded but PR artifacts refresh failed for ${opts.taskId}; run \`agentplane pr update ${opts.taskId}\`${suffix}`)}\n`);
+    }
+}

package/dist/commands/shared/pr-meta.d.ts

@@ -1,5 +1,14 @@
 import { type TaskPrMeta } from "@agentplaneorg/core";
 export type PrMeta = TaskPrMeta;
+export type ObservedGithubPrState = {
+    prNumber: number;
+    prUrl: string | null;
+    status: "OPEN" | "CLOSED" | "MERGED";
+    mergedAt?: string | null;
+    mergeCommit?: string | null;
+    base?: string | null;
+    headSha?: string | null;
+};
 export type PrArtifactTextState = {
     diffstatText: string | null;
     verifyLogText: string | null;
@@ -23,6 +32,16 @@ export declare function buildUpdatedPrMeta(opts: {
     base?: string | null;
     headSha?: string | null;
 }): PrMeta;
+export declare function resolvePrArtifactHeadSha(opts: {
+    previousHeadSha?: string | null;
+    currentHeadSha?: string | null;
+    preservePrevious: boolean;
+}): string | undefined;
+export declare function buildObservedGithubPrMeta(opts: {
+    meta: PrMeta;
+    observed: ObservedGithubPrState;
+    at: string;
+}): PrMeta;
 export declare function buildVerifiedPrMeta(opts: {
     meta: PrMeta;
     at: string;
@@ -46,6 +65,7 @@ export type ShellInvocation = {
 };
 export declare function resolveShellInvocation(command: string): ShellInvocation;
 export declare function parsePrMeta(raw: string, taskId: string): PrMeta;
+export declare function parsePrMetaForwardCompatible(raw: string, taskId: string): PrMeta;
 export declare function extractLastVerifiedSha(logText: string): string | null;
 export declare function appendVerifyLog(logPath: string, header: string, content: string): Promise<void>;
 export declare function runShellCommand(command: string, cwd: string): Promise<{

package/dist/commands/shared/pr-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI1E,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC;AAChC,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,MAAM,CAoBT;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,MAAM,CAgBT;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,GAAG,MAAM,CAST;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,GAAG,MAAM,CAsBT;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAQvE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD"}
+{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/pr-meta.js

@@ -18,8 +18,14 @@ export function buildOpenedPrMeta(opts) {
         schema_version: 1,
         task_id: opts.taskId,
         branch: opts.branch,
+        pr_number: opts.previousMeta?.pr_number,
+        pr_url: opts.previousMeta?.pr_url,
         created_at: opts.previousMeta?.created_at ?? opts.at,
         updated_at: changed ? opts.at : (opts.previousMeta?.updated_at ?? opts.at),
+        status: opts.previousMeta?.status,
+        merge_strategy: opts.previousMeta?.merge_strategy,
+        merged_at: opts.previousMeta?.merged_at,
+        merge_commit: opts.previousMeta?.merge_commit,
         last_verified_sha: opts.previousMeta?.last_verified_sha ?? null,
         last_verified_at: opts.previousMeta?.last_verified_at ?? null,
         verify: opts.previousMeta?.verify ?? { status: "skipped" },
@@ -43,6 +49,46 @@ export function buildUpdatedPrMeta(opts) {
         last_verified_at: opts.meta.last_verified_at ?? null,
     };
 }
+export function resolvePrArtifactHeadSha(opts) {
+    const previousHeadSha = asNonEmptyString(opts.previousHeadSha);
+    const currentHeadSha = asNonEmptyString(opts.currentHeadSha);
+    if (opts.preservePrevious && previousHeadSha)
+        return previousHeadSha;
+    return currentHeadSha ?? previousHeadSha;
+}
+export function buildObservedGithubPrMeta(opts) {
+    const nextStatus = opts.observed.status;
+    const nextHeadSha = opts.meta.head_sha ?? opts.observed.headSha ?? undefined;
+    const nextMeta = {
+        ...opts.meta,
+        pr_number: opts.observed.prNumber,
+        pr_url: opts.observed.prUrl ?? opts.meta.pr_url,
+        status: nextStatus,
+        base: opts.observed.base ?? opts.meta.base,
+        head_sha: nextHeadSha,
+        updated_at: opts.meta.updated_at,
+    };
+    if (nextStatus === "MERGED") {
+        nextMeta.merged_at = opts.observed.mergedAt ?? opts.meta.merged_at;
+        nextMeta.merge_commit = opts.observed.mergeCommit ?? opts.meta.merge_commit;
+    }
+    else {
+        delete nextMeta.merged_at;
+        delete nextMeta.merge_commit;
+        delete nextMeta.merge_strategy;
+    }
+    const changed = nextMeta.pr_number !== opts.meta.pr_number ||
+        (nextMeta.pr_url ?? null) !== (opts.meta.pr_url ?? null) ||
+        nextMeta.status !== opts.meta.status ||
+        (nextMeta.base ?? null) !== (opts.meta.base ?? null) ||
+        (nextMeta.head_sha ?? null) !== (opts.meta.head_sha ?? null) ||
+        (nextMeta.merged_at ?? null) !== (opts.meta.merged_at ?? null) ||
+        (nextMeta.merge_commit ?? null) !== (opts.meta.merge_commit ?? null);
+    if (changed) {
+        nextMeta.updated_at = opts.at;
+    }
+    return nextMeta;
+}
 export function buildVerifiedPrMeta(opts) {
     const verifiedSha = opts.meta.head_sha ?? null;
     return {
@@ -96,6 +142,85 @@ export function parsePrMeta(raw, taskId) {
         throw new Error("pr/meta.json task_id mismatch");
     return meta;
 }
+function asNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function asOptionalInteger(value) {
+    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : undefined;
+}
+function asVerifyStatus(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const status = asNonEmptyString(value.status);
+    if (status !== "pass" && status !== "fail" && status !== "skipped")
+        return undefined;
+    const command = asNonEmptyString(value.command);
+    return command ? { status, command } : { status };
+}
+function asMergeStrategy(value) {
+    const strategy = asNonEmptyString(value);
+    return strategy === "squash" || strategy === "merge" || strategy === "rebase"
+        ? strategy
+        : undefined;
+}
+function buildForwardCompatiblePrMeta(parsed, taskId) {
+    if (parsed.schema_version !== 1)
+        return null;
+    if (asNonEmptyString(parsed.task_id) !== taskId)
+        return null;
+    const branch = asNonEmptyString(parsed.branch);
+    const createdAt = asNonEmptyString(parsed.created_at);
+    const updatedAt = asNonEmptyString(parsed.updated_at);
+    if (!branch || !createdAt || !updatedAt)
+        return null;
+    const statusCandidate = asNonEmptyString(parsed.status);
+    const status = statusCandidate === "OPEN" || statusCandidate === "CLOSED" || statusCandidate === "MERGED"
+        ? statusCandidate
+        : undefined;
+    return {
+        schema_version: 1,
+        task_id: taskId,
+        branch,
+        pr_number: asOptionalInteger(parsed.pr_number),
+        pr_url: asNonEmptyString(parsed.pr_url),
+        created_at: createdAt,
+        updated_at: updatedAt,
+        status,
+        merge_strategy: asMergeStrategy(parsed.merge_strategy),
+        merged_at: asNonEmptyString(parsed.merged_at),
+        merge_commit: asNonEmptyString(parsed.merge_commit),
+        last_verified_sha: asNonEmptyString(parsed.last_verified_sha),
+        last_verified_at: asNonEmptyString(parsed.last_verified_at),
+        verify: asVerifyStatus(parsed.verify) ?? { status: "skipped" },
+        base: asNonEmptyString(parsed.base),
+        head_sha: asNonEmptyString(parsed.head_sha),
+    };
+}
+export function parsePrMetaForwardCompatible(raw, taskId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`JSON Parse error: ${message}`);
+    }
+    try {
+        const meta = validateTaskPrMeta(parsed);
+        if (meta.task_id !== taskId)
+            throw new Error("pr/meta.json task_id mismatch");
+        return meta;
+    }
+    catch (err) {
+        const compat = buildForwardCompatiblePrMeta(parsed, taskId);
+        if (compat)
+            return compat;
+        throw err;
+    }
+}
 export function extractLastVerifiedSha(logText) {
     const regex = /verified_sha=([0-9a-f]{7,40})/gi;
     let match = null;

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

@@ -29,11 +29,18 @@ export declare function loadCommandContext(opts: {
 export declare function loadTaskFromContext(opts: {
     ctx: CommandContext;
     taskId: string;
+    preferBranchSnapshot?: boolean;
+    branchSnapshotBranch?: string | null;
 }): Promise<TaskData>;
+export declare function resolveTaskBranchFromContext(opts: {
+    ctx: CommandContext;
+    taskId: string;
+}): Promise<string | null>;
 export declare function loadTaskFromBranchSnapshot(opts: {
     ctx: CommandContext;
     taskId: string;
     readmePath: string;
+    branch?: string | null;
 }): Promise<TaskData | null>;
 export declare function loadBackendTask(opts: {
     ctx?: CommandContext;

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

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}

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

@@ -79,29 +79,56 @@ export async function loadCommandContext(opts) {
     };
 }
 export async function loadTaskFromContext(opts) {
-    const task = await opts.ctx.taskBackend.getTask(opts.taskId);
-    if (task)
-        return task;
     const tasksDir = path.join(opts.ctx.resolvedProject.gitRoot, opts.ctx.config.paths.workflow_dir);
     const readmePath = path.join(tasksDir, opts.taskId, "README.md");
-    const branchFallback = await loadTaskFromBranchSnapshot({
+    const branchFallback = () => loadTaskFromBranchSnapshot({
         ctx: opts.ctx,
         taskId: opts.taskId,
         readmePath,
+        branch: opts.branchSnapshotBranch ?? null,
     });
-    if (branchFallback)
-        return branchFallback;
+    if (opts.preferBranchSnapshot) {
+        const preferredBranchTask = await branchFallback();
+        if (preferredBranchTask)
+            return preferredBranchTask;
+    }
+    const task = await opts.ctx.taskBackend.getTask(opts.taskId);
+    if (task)
+        return task;
+    const fallbackTask = await branchFallback();
+    if (fallbackTask)
+        return fallbackTask;
     throw new CliError({
         exitCode: 4,
         code: "E_IO",
         message: `ENOENT: no such file or directory, open '${readmePath}'`,
     });
 }
+export async function resolveTaskBranchFromContext(opts) {
+    if (opts.ctx.backendId !== "local") {
+        return null;
+    }
+    const prefix = opts.ctx.config.branch.task_prefix;
+    const branches = await gitListTaskBranches(opts.ctx.resolvedProject.gitRoot, prefix);
+    const matches = branches.filter((branch) => parseTaskIdFromBranch(prefix, branch) === opts.taskId);
+    if (matches.length === 1)
+        return matches[0] ?? null;
+    if (matches.length > 1) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `Multiple task branches match ${opts.taskId}: ${matches.join(", ")}`,
+        });
+    }
+    return null;
+}
 export async function loadTaskFromBranchSnapshot(opts) {
     if (opts.ctx.backendId !== "local") {
         return null;
     }
-    const branch = await resolveSingleTaskBranch(opts.ctx, opts.taskId);
+    const branch = typeof opts.branch === "string" && opts.branch.trim().length > 0
+        ? opts.branch.trim()
+        : await resolveTaskBranchFromContext({ ctx: opts.ctx, taskId: opts.taskId });
     if (!branch)
         return null;
     const relReadmePath = toGitPath(path.relative(opts.ctx.resolvedProject.gitRoot, opts.readmePath));
@@ -126,21 +153,6 @@ export async function loadTaskFromBranchSnapshot(opts) {
         readmePath: opts.readmePath,
     });
 }
-async function resolveSingleTaskBranch(ctx, taskId) {
-    const prefix = ctx.config.branch.task_prefix;
-    const branches = await gitListTaskBranches(ctx.resolvedProject.gitRoot, prefix);
-    const matches = branches.filter((branch) => parseTaskIdFromBranch(prefix, branch) === taskId);
-    if (matches.length === 1)
-        return matches[0] ?? null;
-    if (matches.length > 1) {
-        throw new CliError({
-            exitCode: 3,
-            code: "E_VALIDATION",
-            message: `Multiple task branches match ${taskId}: ${matches.join(", ")}`,
-        });
-    }
-    return null;
-}
 export async function loadBackendTask(opts) {
     const ctx = opts.ctx ??
         (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));

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":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGrF,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,CAoDlB"}
+{"version":3,"file":"close-duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-duplicate.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAgDnC,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,CAqDlB"}

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

@@ -1,8 +1,40 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { renderTaskReadme } from "@agentplaneorg/core";
 import { mapBackendError } from "../../cli/error-map.js";
+import { fileExists } from "../../cli/fs-utils.js";
 import { CliError } from "../../shared/errors.js";
+import { writeTextIfChanged } from "../../shared/write-if-changed.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
-import { loadTaskFromContext } from "../shared/task-backend.js";
+import { loadTaskFromContext, taskDataToFrontmatter, } from "../shared/task-backend.js";
+import { listWorktrees, parseTaskIdFromBranch } from "../shared/git-worktree.js";
 import { recordVerifiedNoopClosure } from "./close-shared.js";
+async function ensureLocalTaskReadmeHydrated(opts) {
+    const workflowDir = opts.ctx.config.paths.workflow_dir;
+    const targetReadmePath = path.join(opts.ctx.resolvedProject.gitRoot, workflowDir, opts.taskId, "README.md");
+    if (await fileExists(targetReadmePath))
+        return;
+    const worktrees = await listWorktrees(opts.ctx.resolvedProject.gitRoot).catch(() => []);
+    const matchingTaskWorktrees = worktrees.filter((entry) => typeof entry.branch === "string" &&
+        parseTaskIdFromBranch(opts.ctx.config.branch.task_prefix, entry.branch) === opts.taskId);
+    if (matchingTaskWorktrees.length === 1) {
+        const sourceReadmePath = path.join(matchingTaskWorktrees[0].path, workflowDir, opts.taskId, "README.md");
+        if (await fileExists(sourceReadmePath)) {
+            const text = await readFile(sourceReadmePath, "utf8");
+            await mkdir(path.dirname(targetReadmePath), { recursive: true });
+            await writeTextIfChanged(targetReadmePath, text);
+            return;
+        }
+    }
+    const task = await loadTaskFromContext({
+        ctx: opts.ctx,
+        taskId: opts.taskId,
+        preferBranchSnapshot: true,
+    });
+    const rendered = renderTaskReadme(taskDataToFrontmatter(task), task.doc ?? "");
+    await mkdir(path.dirname(targetReadmePath), { recursive: true });
+    await writeTextIfChanged(targetReadmePath, rendered);
+}
 export async function cmdTaskCloseDuplicate(opts) {
     try {
         const sourceId = opts.taskId.trim();
@@ -30,6 +62,7 @@ export async function cmdTaskCloseDuplicate(opts) {
             });
         }
         const canonical = await loadTaskFromContext({ ctx: opts.ctx, taskId: duplicateOf });
+        await ensureLocalTaskReadmeHydrated({ ctx: opts.ctx, taskId: sourceId });
         const reason = opts.note?.trim();
         const canonicalTitle = canonical.title?.trim() ? ` (${canonical.title.trim()})` : "";
         const baseBody = `Verified: ${sourceId} is a bookkeeping duplicate of ${duplicateOf}${canonicalTitle}; ` +

package/dist/commands/task/derive.js

@@ -61,7 +61,7 @@ export async function cmdTaskDerive(opts) {
                 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`);
+            process.stderr.write(`${warnMessage("task requires Verify Steps by primary tag; seeded a concrete ## Verify Steps section in README (refine it only if the task needs stricter acceptance coverage)")}\n`);
         }
         const hasSpike = opts.tags.some((tag) => tag.trim().toLowerCase() === spikeTag);
         if (hasSpike && requiresVerifySteps) {

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":"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"}
+{"version":3,"file":"doc-template.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc-template.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAyDrC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsCrF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,MAAM,CAyBT"}

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

@@ -31,13 +31,11 @@ function buildDefaultPlan(opts) {
         "3. Finalize task findings and finish with traceable commit metadata.",
     ].join("\n");
 }
-function buildDefaultVerifyStepsTemplate() {
+function buildDefaultVerifyStepsTemplate(opts) {
     return [
-        "<!-- TODO: REPLACE WITH TASK-SPECIFIC ACCEPTANCE STEPS -->",
-        "",
-        "1. <Action>. Expected: <observable result>.",
-        "2. <Action>. Expected: <observable result>.",
-        "3. <Action>. Expected: <observable result>.",
+        `1. Review the requested outcome for "${opts.title}". Expected: the visible result matches ## Summary and stays inside approved scope.`,
+        "2. Run the most relevant validation step for this task. Expected: it succeeds without unexpected regressions in touched behavior.",
+        "3. Compare the final result against ## Scope and record any residual follow-up in ## Findings. Expected: open edges are explicit rather than implicit.",
     ].join("\n");
 }
 function buildDefaultVerificationTemplate() {
@@ -69,7 +67,7 @@ export function defaultTaskDocV3(opts) {
     body = setMarkdownSection(body, "Summary", buildDefaultSummary({ title: opts.title, description: opts.description }));
     body = setMarkdownSection(body, "Scope", buildDefaultScope({ title: opts.title, description: opts.description }));
     body = setMarkdownSection(body, "Plan", buildDefaultPlan({ title: opts.title }));
-    body = setMarkdownSection(body, "Verify Steps", buildDefaultVerifyStepsTemplate());
+    body = setMarkdownSection(body, "Verify Steps", buildDefaultVerifyStepsTemplate({ title: opts.title }));
     body = setMarkdownSection(body, "Verification", buildDefaultVerificationTemplate());
     body = setMarkdownSection(body, "Rollback Plan", buildDefaultRollbackPlan());
     body = setMarkdownSection(body, "Findings", "");
@@ -85,10 +83,8 @@ export function buildDefaultVerifyStepsSection(opts) {
     ];
     if (commandSteps.length === 0) {
         return [
-            "<!-- TODO: REPLACE WITH TASK-SPECIFIC ACCEPTANCE STEPS -->",
-            "",
-            "1. Review the changed artifact or behavior. Expected: the requested outcome is visible and matches the approved scope.",
-            "2. Run the most relevant validation step for this task. Expected: it succeeds without unexpected regressions in touched scope.",
+            `1. Review the changed artifact or behavior for the \`${opts.primary}\` task. Expected: the requested outcome is visible and matches the approved scope.`,
+            `2. Run the most relevant validation step for the \`${opts.primary}\` task. Expected: it succeeds without unexpected regressions in touched scope.`,
             "3. Compare the final result against the task summary and scope. Expected: any remaining follow-up is explicit in ## Findings.",
         ].join("\n");
     }

package/dist/commands/task/findings-add.command.d.ts

@@ -0,0 +1,20 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskFindingsAddParsed = {
+    taskId: string;
+    observation: string;
+    impact: string;
+    resolution: string;
+    promote: boolean;
+    external: boolean;
+    fixability: "external" | "repo-fixable" | null;
+    incidentScope?: string;
+    incidentTags: string[];
+    incidentMatch: string[];
+    incidentAdvice?: string;
+    incidentRule?: string;
+    updatedBy?: string;
+};
+export declare const taskFindingsAddSpec: CommandSpec<TaskFindingsAddParsed>;
+export declare function makeRunTaskFindingsAddHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskFindingsAddParsed) => Promise<number>;
+//# sourceMappingURL=findings-add.command.d.ts.map

package/dist/commands/task/findings-add.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-add.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/findings-add.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAqJlE,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC9E,KAAK,UAAU,EAAE,GAAG,qBAAqB,KAAG,OAAO,CAAC,MAAM,CAAC,CAoB1E"}

package/dist/commands/task/findings-add.command.js

@@ -0,0 +1,165 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskFindingsAdd } from "./findings.js";
+export const taskFindingsAddSpec = {
+    id: ["task", "findings", "add"],
+    group: "Task",
+    summary: "Append a structured Findings/Notes block; incident promotion is default unless --local-only.",
+    synopsis: [
+        "agentplane task findings add <task-id> --observation <text> --impact <text> --resolution <text> [--local-only] [--repo-fixable] [--incident-scope <text>] [--incident-tag <tag>] [--incident-match <term>] [--incident-advice <text>] [--incident-rule <text>] [--updated-by <id>]",
+    ],
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "observation",
+            valueHint: "<text>",
+            description: "Required. Observation field.",
+        },
+        { kind: "string", name: "impact", valueHint: "<text>", description: "Required. Impact field." },
+        {
+            kind: "string",
+            name: "resolution",
+            valueHint: "<text>",
+            description: "Required. Resolution field.",
+        },
+        {
+            kind: "boolean",
+            name: "promote",
+            description: "Compatibility flag. Promotion is the default unless `--local-only` is set.",
+        },
+        {
+            kind: "boolean",
+            name: "external",
+            description: "Compatibility flag. External incident metadata is the default unless `--local-only` is set.",
+        },
+        {
+            kind: "boolean",
+            name: "repo-fixable",
+            description: "Mark the structured finding as repo-fixable so it can promote into incidents.md.",
+        },
+        {
+            kind: "boolean",
+            name: "local-only",
+            default: false,
+            description: "Keep the entry task-local only; omit `Promotion: incident-candidate` and any explicit fixability marker.",
+        },
+        {
+            kind: "string",
+            name: "incident-scope",
+            valueHint: "<text>",
+            description: "Optional. IncidentScope override.",
+        },
+        {
+            kind: "string",
+            name: "incident-tag",
+            valueHint: "<tag>",
+            repeatable: true,
+            description: "Repeatable. IncidentTags entry.",
+        },
+        {
+            kind: "string",
+            name: "incident-match",
+            valueHint: "<term>",
+            repeatable: true,
+            description: "Repeatable. IncidentMatch entry.",
+        },
+        {
+            kind: "string",
+            name: "incident-advice",
+            valueHint: "<text>",
+            description: "Optional. IncidentAdvice field.",
+        },
+        {
+            kind: "string",
+            name: "incident-rule",
+            valueHint: "<text>",
+            description: "Optional. IncidentRule field.",
+        },
+        {
+            kind: "string",
+            name: "updated-by",
+            valueHint: "<id>",
+            description: "Optional. Override doc_updated_by metadata (must be non-empty).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task findings add 202602030608-F1Q8AB --observation "GitHub API EOF retries were manual." --impact "Operators repeated the reconcile loop." --resolution "Switch the retry path to REST polling." --incident-scope "GitHub PR reconciliation" --incident-tag workflow --incident-tag github',
+            why: "Append a promotable external incident candidate without hand-editing the README or remembering hidden flags.",
+        },
+        {
+            cmd: 'agentplane task findings add 202602030608-F1Q8AB --observation "One manual follow-up remains." --impact "Task notes should stay local." --resolution "Track it in Findings only." --local-only',
+            why: "Keep an observation task-local when it should not feed incidents collection.",
+        },
+    ],
+    validateRaw: (raw) => {
+        for (const key of ["observation", "impact", "resolution"]) {
+            const value = raw.opts[key];
+            if (typeof value !== "string" || value.trim() === "") {
+                throw usageError({
+                    spec: taskFindingsAddSpec,
+                    message: `Missing required option: --${key}.`,
+                });
+            }
+        }
+        const updatedBy = raw.opts["updated-by"];
+        if (typeof updatedBy === "string" && updatedBy.trim() === "") {
+            throw usageError({ spec: taskFindingsAddSpec, message: "--updated-by must be non-empty." });
+        }
+        if (raw.opts["local-only"] === true &&
+            (raw.opts.promote === true || raw.opts.external === true || raw.opts["repo-fixable"] === true)) {
+            throw usageError({
+                spec: taskFindingsAddSpec,
+                message: "--local-only cannot be combined with --promote, --external, or --repo-fixable.",
+            });
+        }
+        if (raw.opts.external === true && raw.opts["repo-fixable"] === true) {
+            throw usageError({
+                spec: taskFindingsAddSpec,
+                message: "--external and --repo-fixable are mutually exclusive.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const localOnly = raw.opts["local-only"] === true;
+        const repoFixable = raw.opts["repo-fixable"] === true;
+        const fixability = localOnly ? null : repoFixable ? "repo-fixable" : "external";
+        return {
+            taskId: String(raw.args["task-id"]),
+            observation: String(raw.opts.observation),
+            impact: String(raw.opts.impact),
+            resolution: String(raw.opts.resolution),
+            promote: !localOnly,
+            external: !localOnly,
+            fixability,
+            incidentScope: typeof raw.opts["incident-scope"] === "string" ? raw.opts["incident-scope"] : undefined,
+            incidentTags: raw.opts["incident-tag"] ?? [],
+            incidentMatch: raw.opts["incident-match"] ?? [],
+            incidentAdvice: typeof raw.opts["incident-advice"] === "string" ? raw.opts["incident-advice"] : undefined,
+            incidentRule: typeof raw.opts["incident-rule"] === "string" ? raw.opts["incident-rule"] : undefined,
+            updatedBy: typeof raw.opts["updated-by"] === "string" ? raw.opts["updated-by"] : undefined,
+        };
+    },
+};
+export function makeRunTaskFindingsAddHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskFindingsAdd({
+            ctx: await getCtx("task findings add"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            observation: p.observation,
+            impact: p.impact,
+            resolution: p.resolution,
+            promote: p.promote,
+            external: p.external,
+            fixability: p.fixability === "repo-fixable" ? "repo-fixable" : null,
+            incidentScope: p.incidentScope,
+            incidentTags: p.incidentTags,
+            incidentMatch: p.incidentMatch,
+            incidentAdvice: p.incidentAdvice,
+            incidentRule: p.incidentRule,
+            updatedBy: p.updatedBy,
+        });
+    };
+}

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

@@ -0,0 +1,7 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+export type TaskFindingsParsed = {
+    subcommand?: string;
+};
+export declare const taskFindingsSpec: CommandSpec<TaskFindingsParsed>;
+export declare function runTaskFindings(_ctx: CommandCtx, p: TaskFindingsParsed): Promise<number>;
+//# sourceMappingURL=findings.command.d.ts.map