agentplane 0.3.9 → 0.3.11

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

@@ -8,27 +8,97 @@ function nowOrExisting(value, fallback) {
     return trimmed || fallback;
 }
 export function buildOpenedPrMeta(opts) {
+    const nextBase = opts.base ?? opts.previousMeta?.base;
+    const nextHeadSha = opts.headSha ?? opts.previousMeta?.head_sha;
+    const changed = opts.previousMeta === null ||
+        (opts.previousMeta.branch ?? null) !== opts.branch ||
+        (opts.previousMeta.base ?? null) !== (nextBase ?? null) ||
+        (opts.previousMeta.head_sha ?? null) !== (nextHeadSha ?? null);
     return {
         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: 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" },
-        base: opts.previousMeta?.base,
+        base: nextBase,
+        head_sha: nextHeadSha,
     };
 }
 export function buildUpdatedPrMeta(opts) {
+    const nextBase = opts.base ?? opts.meta.base;
+    const nextHeadSha = opts.headSha ?? opts.meta.head_sha;
+    const changed = (opts.meta.branch ?? null) !== opts.branch ||
+        (opts.meta.base ?? null) !== (nextBase ?? null) ||
+        (opts.meta.head_sha ?? null) !== (nextHeadSha ?? null);
     return {
         ...opts.meta,
         branch: opts.branch,
-        updated_at: opts.at,
+        base: nextBase,
+        head_sha: nextHeadSha,
+        updated_at: changed ? opts.at : opts.meta.updated_at,
         last_verified_sha: opts.meta.last_verified_sha ?? null,
         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 {
+        ...opts.meta,
+        updated_at: opts.meta.updated_at,
+        last_verified_sha: verifiedSha,
+        last_verified_at: opts.at,
+        verify: opts.meta.verify ? { ...opts.meta.verify, status: opts.state } : { status: opts.state },
+    };
+}
 export function buildIntegratedPrMeta(opts) {
     const nextMeta = {
         ...opts.meta,
@@ -72,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

@@ -1,4 +1,5 @@
 import { type AgentplaneConfig, type ResolvedProject } from "@agentplaneorg/core";
+import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
 import { loadTaskBackend, type TaskBackend, type TaskData, type TaskSummary } from "../../backends/task-backend.js";
 import { GitContext } from "./git-context.js";
 export type CommandMemo = {
@@ -6,6 +7,7 @@ export type CommandMemo = {
     changedPaths?: Promise<string[]>;
     headCommit?: Promise<string>;
     agentIds?: Promise<string[]>;
+    harness?: Promise<ResolvedHarnessContract>;
 };
 export type CommandContext = {
     resolvedProject: Awaited<ReturnType<typeof loadTaskBackend>>["resolved"];
@@ -27,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/shared/task-local-freshness.d.ts

@@ -0,0 +1,13 @@
+export declare function isTaskLocalAdvancePath(opts: {
+    workflowDir: string;
+    taskId: string;
+    relPath: string;
+}): boolean;
+export declare function isTaskLocalOnlyAdvance(opts: {
+    gitRoot: string;
+    workflowDir: string;
+    taskId: string;
+    fromRef: string | null;
+    toRef: string;
+}): Promise<boolean>;
+//# sourceMappingURL=task-local-freshness.d.ts.map

package/dist/commands/shared/task-local-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-local-freshness.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-local-freshness.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAEV;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAenB"}

package/dist/commands/shared/task-local-freshness.js

@@ -0,0 +1,20 @@
+import path from "node:path";
+import { gitDiffNames, toGitPath } from "./git-diff.js";
+function taskRootPrefix(workflowDir, taskId) {
+    return `${toGitPath(path.join(workflowDir, taskId))}/`;
+}
+export function isTaskLocalAdvancePath(opts) {
+    return opts.relPath.startsWith(taskRootPrefix(opts.workflowDir, opts.taskId));
+}
+export async function isTaskLocalOnlyAdvance(opts) {
+    if (!opts.fromRef || opts.fromRef === opts.toRef) {
+        return false;
+    }
+    const changedPaths = await gitDiffNames(opts.gitRoot, opts.fromRef, opts.toRef);
+    return (changedPaths.length > 0 &&
+        changedPaths.every((relPath) => isTaskLocalAdvancePath({
+            workflowDir: opts.workflowDir,
+            taskId: opts.taskId,
+            relPath,
+        })));
+}

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

@@ -1,4 +1,5 @@
 import type { TaskData, TaskWriteOptions } from "../../backends/task-backend.js";
+import type { PolicyActionId } from "../../policy/taxonomy.js";
 import { type CommandContext } from "./task-backend.js";
 import { getTaskStore, type TaskStoreIntentResult } from "./task-store.js";
 export type TaskMutationPlan = {
@@ -19,6 +20,7 @@ export declare function withTaskMutationStorage<TResult>(opts: {
 export declare function applyTaskMutation(opts: {
     ctx: CommandContext;
     taskId: string;
+    policyAction?: PolicyActionId;
     build: (current: TaskData) => Promise<TaskMutationPlan | null | undefined> | TaskMutationPlan | null | undefined;
     writeOptions?: TaskWriteOptions;
 }): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAGL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CAuDjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}
+{"version":3,"file":"task-mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAGL,YAAY,EACZ,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxF,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CA8DjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE;IAC/D,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,CACL,OAAO,EAAE,QAAQ,EAAE,KAChB,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAQzD"}

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

@@ -1,3 +1,4 @@
+import { PolicyEngine } from "../../policy/engine.js";
 import { loadTaskFromContext, writeTasksOrFallback } from "./task-backend.js";
 import { applyTaskStoreIntentsToTask, backendIsLocalFileBackend, getTaskStore, } from "./task-store.js";
 export async function withTaskMutationStorage(opts) {
@@ -7,6 +8,12 @@ export async function withTaskMutationStorage(opts) {
     return await opts.remote(opts.ctx.taskBackend);
 }
 export async function applyTaskMutation(opts) {
+    void new PolicyEngine().evaluate({
+        action: opts.policyAction ?? "task_mutation",
+        config: opts.ctx.config,
+        taskId: opts.taskId,
+        git: { stagedPaths: [] },
+    });
     if (backendIsLocalFileBackend(opts.ctx)) {
         const store = getTaskStore(opts.ctx);
         const result = await store.update(opts.taskId, async (current) => {

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

@@ -1 +1 @@
-{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAWpF,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,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;IACb,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ElB"}
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAWpF,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,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;IACb,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlB"}

package/dist/commands/task/block.js

@@ -29,6 +29,7 @@ export async function cmdBlock(opts) {
             ctx,
             taskId: opts.taskId,
             quiet: opts.quiet,
+            policyAction: "task_block",
             build: () => ({
                 at,
                 toStatus: "BLOCKED",

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/close-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,cAAc,CAAC;IACpB,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,CAyChB"}
+{"version":3,"file":"close-shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,cAAc,CAAC;IACpB,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,CA0ChB"}

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

@@ -8,6 +8,7 @@ export async function recordVerifiedNoopClosure(opts) {
     await applyTaskMutation({
         ctx: opts.ctx,
         taskId: opts.taskId,
+        policyAction: "task_finish",
         build: async (task) => {
             if (!opts.force && String(task.status || "TODO").toUpperCase() === "DONE") {
                 throw new CliError({

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