agentplane 0.3.3 → 0.3.5

package/dist/commands/doctor/workspace.js

@@ -3,6 +3,8 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { renderDiagnosticFinding } from "../../shared/diagnostics.js";
 import { resolvePolicyGatewayForRepo } from "../../shared/policy-gateway.js";
+import { GitContext } from "../shared/git-context.js";
+import { listTaskProjection } from "../shared/task-backend.js";
 async function pathExists(absPath) {
     try {
         await fs.access(absPath);
@@ -44,7 +46,14 @@ async function listMissingManagedPolicyFiles(repoRoot) {
     }
     return missing.toSorted();
 }
-async function checkTaskReadmeMigrationState(repoRoot) {
+function taskDataToSnapshot(task) {
+    return {
+        id: task.id,
+        status: task.status,
+        doc_version: task.doc_version,
+    };
+}
+async function readTaskDocSnapshotsFromTasksJson(repoRoot) {
     const tasksPath = path.join(repoRoot, ".agentplane", "tasks.json");
     let raw = "";
     try {
@@ -60,7 +69,22 @@ async function checkTaskReadmeMigrationState(repoRoot) {
     catch {
         return [];
     }
-    const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+    return Array.isArray(parsed.tasks) ? parsed.tasks : [];
+}
+async function readTaskDocSnapshotsFromProjection(ctx) {
+    if (!ctx)
+        return null;
+    try {
+        const tasks = await listTaskProjection(ctx);
+        if (tasks === null)
+            return null;
+        return tasks.map((task) => taskDataToSnapshot(task));
+    }
+    catch {
+        return null;
+    }
+}
+function buildTaskReadmeMigrationFindings(tasks) {
     if (tasks.length === 0)
         return [];
     const legacy = tasks.filter((task) => task.doc_version !== 3);
@@ -114,7 +138,66 @@ async function checkTaskReadmeMigrationState(repoRoot) {
         }),
     ];
 }
-export async function checkWorkspace(repoRoot) {
+async function checkTaskReadmeMigrationState(repoRoot, ctx) {
+    const projectionTasks = await readTaskDocSnapshotsFromProjection(ctx);
+    const tasks = projectionTasks && projectionTasks.length > 0
+        ? projectionTasks
+        : await readTaskDocSnapshotsFromTasksJson(repoRoot);
+    return buildTaskReadmeMigrationFindings(tasks);
+}
+async function readUntrackedPaths(repoRoot, ctx) {
+    try {
+        const git = ctx?.git ?? new GitContext({ gitRoot: repoRoot });
+        return new Set(await git.statusUntrackedPaths());
+    }
+    catch {
+        return new Set();
+    }
+}
+async function checkDoneTaskReadmeArchiveDrift(repoRoot, ctx) {
+    const projectionTasks = await readTaskDocSnapshotsFromProjection(ctx);
+    const tasks = projectionTasks && projectionTasks.length > 0
+        ? projectionTasks
+        : await readTaskDocSnapshotsFromTasksJson(repoRoot);
+    if (tasks.length === 0)
+        return [];
+    const workflowDir = (ctx?.config.paths.workflow_dir ?? ".agentplane/tasks").replaceAll("\\", "/");
+    const untracked = await readUntrackedPaths(repoRoot, ctx);
+    if (untracked.size === 0)
+        return [];
+    const affected = tasks
+        .filter((task) => {
+        const status = typeof task.status === "string" ? task.status.trim().toUpperCase() : "";
+        const taskId = typeof task.id === "string" ? task.id.trim() : "";
+        if (status !== "DONE" || !taskId)
+            return false;
+        return untracked.has(`${workflowDir}/${taskId}/README.md`);
+    })
+        .map((task) => String(task.id))
+        .toSorted();
+    if (affected.length === 0)
+        return [];
+    const examples = affected.slice(0, 5).join(", ");
+    const stagedCommand = `git add ${affected
+        .map((taskId) => `${workflowDir}/${taskId}/README.md`)
+        .join(" ")}`;
+    return [
+        renderDiagnosticFinding({
+            severity: "WARN",
+            state: "DONE task archive README files exist on disk but are missing from the git index",
+            likelyCause: "task metadata reached DONE state, but the human-readable task README archive never landed in a tracked close commit",
+            nextAction: {
+                command: stagedCommand,
+                reason: "stage the missing archived task README files and commit them before continuing",
+            },
+            details: [
+                `Affected DONE tasks: ${affected.length}`,
+                examples ? `Examples: ${examples}` : "Examples unavailable.",
+            ],
+        }),
+    ];
+}
+export async function checkWorkspace(repoRoot, opts) {
     const problems = [];
     const requiredFiles = [path.join(repoRoot, ".agentplane", "config.json")];
     for (const filePath of requiredFiles) {
@@ -160,6 +243,6 @@ export async function checkWorkspace(repoRoot) {
     if (!hasJson) {
         problems.push("No agent profiles found in .agentplane/agents (*.json expected).");
     }
-    problems.push(...(await checkTaskReadmeMigrationState(repoRoot)));
+    problems.push(...(await checkTaskReadmeMigrationState(repoRoot, opts?.ctx)), ...(await checkDoneTaskReadmeArchiveDrift(repoRoot, opts?.ctx)));
     return problems;
 }

package/dist/commands/doctor.run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAuDlD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CA6DlD,CAAC"}

package/dist/commands/doctor.run.js

@@ -1,5 +1,6 @@
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { warnMessage, successMessage } from "../cli/output.js";
+import { loadCommandContext } from "./shared/task-backend.js";
 import { checkDoneTaskCommitInvariants } from "./doctor/archive.js";
 import { safeFixGitignore, safeFixTaskIndex } from "./doctor/fixes.js";
 import { checkLayering } from "./doctor/layering.js";
@@ -11,9 +12,15 @@ export const runDoctor = async (ctx, p) => {
     const resolved = await resolveProject({ cwd: ctx.cwd, rootOverride: ctx.rootOverride ?? null });
     const repoRoot = resolved.gitRoot;
     const loadedConfig = await loadConfig(resolved.agentplaneDir);
+    const commandCtx = await loadCommandContext({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride ?? null,
+        resolvedProject: resolved,
+        config: loadedConfig.config,
+    });
     const runChecks = async () => {
         let checks = [
-            ...(await checkWorkspace(repoRoot)),
+            ...(await checkWorkspace(repoRoot, { ctx: commandCtx })),
             ...checkRuntimeSourceFacts(ctx.cwd, loadedConfig.config),
             ...(await checkDoneTaskCommitInvariants(repoRoot, { fullArchive: p.archiveFull })),
         ];

package/dist/commands/shared/git-context.d.ts

@@ -7,6 +7,7 @@ export declare class GitContext {
     private statusPorcelainZ;
     statusChangedPaths(): Promise<string[]>;
     statusStagedPaths(): Promise<string[]>;
+    statusUntrackedPaths(): Promise<string[]>;
     statusUnstagedTrackedPaths(): Promise<string[]>;
     headCommit(): Promise<string>;
     stage(paths: string[]): Promise<void>;

package/dist/commands/shared/git-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}

package/dist/commands/shared/git-context.js

@@ -87,6 +87,10 @@ export class GitContext {
         const status = await this.statusPorcelainZ();
         return status.stagedPaths;
     }
+    async statusUntrackedPaths() {
+        const status = await this.statusPorcelainZ();
+        return status.untrackedPaths;
+    }
     async statusUnstagedTrackedPaths() {
         const status = await this.statusPorcelainZ();
         return status.unstagedTrackedPaths;

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

@@ -44,4 +44,9 @@ export declare function loadBackendTask(opts: {
     task: TaskData;
 }>;
 export declare function listTasksMemo(ctx: CommandContext): Promise<TaskData[]>;
+export declare function listTaskProjection(ctx: CommandContext): Promise<TaskData[] | null>;
+export declare function exportTaskProjectionSnapshot(opts: {
+    ctx: CommandContext;
+    outputPath: string;
+}): Promise<void>;
 //# sourceMappingURL=task-backend.d.ts.map

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":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC;IAEhB,IAAI,EAAE,WAAW,CAAC;IAGlB,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AASF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B7E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAepB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAaD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG5E"}
+{"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

@@ -99,3 +99,27 @@ export async function listTasksMemo(ctx) {
     ctx.memo.taskList ??= ctx.taskBackend.listTasks();
     return await ctx.memo.taskList;
 }
+export async function listTaskProjection(ctx) {
+    if (ctx.taskBackend.listProjectionTasks) {
+        return await ctx.taskBackend.listProjectionTasks();
+    }
+    if (ctx.taskBackend.capabilities.reads_from_projection_by_default) {
+        return await listTasksMemo(ctx);
+    }
+    return null;
+}
+export async function exportTaskProjectionSnapshot(opts) {
+    if (opts.ctx.taskBackend.exportProjectionSnapshot) {
+        await opts.ctx.taskBackend.exportProjectionSnapshot(opts.outputPath);
+        return;
+    }
+    if (opts.ctx.taskBackend.exportTasksJson) {
+        await opts.ctx.taskBackend.exportTasksJson(opts.outputPath);
+        return;
+    }
+    throw new CliError({
+        exitCode: 3,
+        code: "E_VALIDATION",
+        message: "Configured backend does not support exporting a task snapshot",
+    });
+}

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

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

package/dist/commands/task/export.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2XlB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4XlB"}

package/dist/commands/task/finish.js

@@ -114,8 +114,9 @@ export async function cmdFinish(opts) {
             : await readHeadCommit(gitRoot);
         const useStore = backendIsLocalFileBackend(ctx);
         const store = useStore ? getTaskStore(ctx) : null;
+        const backendWritesTaskReadmes = ctx.taskBackend.capabilities.writes_task_readmes === true;
         const defaultDirectCloseCommit = ctx.config.workflow_mode === "direct" &&
-            useStore &&
+            backendWritesTaskReadmes &&
             opts.taskIds.length === 1 &&
             !opts.commitFromComment &&
             !statusCommitRequested;
@@ -275,7 +276,7 @@ export async function cmdFinish(opts) {
             await (useStore
                 ? store.update(primaryTaskId, () => updatedAfterCommit)
                 : ctx.taskBackend.writeTask(updatedAfterCommit));
-            if (useStore) {
+            if (backendWritesTaskReadmes) {
                 const workflowReadmeRelPath = path.join(ctx.config.paths.workflow_dir, primaryTaskId, "README.md");
                 await ctx.git.stage([workflowReadmeRelPath]);
                 const env = buildGitCommitEnv({

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

@@ -1 +1 @@
-{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAkSA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB"}
+{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAiSA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlB"}

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

@@ -6,11 +6,11 @@ import { exitCodeForError } from "../../cli/exit-codes.js";
 import { fileExists, getPathKind } from "../../cli/fs-utils.js";
 import { successMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { exportTaskProjectionSnapshot, loadCommandContext } from "../shared/task-backend.js";
 import { extractDocSection, extractTaskObservationSection, normalizeTaskDocVersion, normalizeVerificationSectionLayout, } from "./shared/docs.js";
 import { defaultTaskDocV3 } from "./doc-template.js";
 const V3_CANONICAL_ORDER = [
     "Summary",
-    "Context",
     "Scope",
     "Plan",
     "Verify Steps",
@@ -98,8 +98,6 @@ function migrateDocToV3(opts) {
         const currentText = firstSectionText(currentSections, title);
         const defaultText = firstSectionText(defaultSections, title) ?? "";
         let nextText = currentText ?? defaultText;
-        if (title === "Context" && !(currentText ?? "").trim())
-            continue;
         if (title === "Verification") {
             nextText = normalizeVerificationSectionLayout(currentText ?? defaultText, 3);
         }
@@ -242,6 +240,12 @@ export async function cmdTaskMigrateDoc(opts) {
             rootOverride: opts.rootOverride ?? null,
         });
         const loaded = await loadConfig(resolved.agentplaneDir);
+        const ctx = await loadCommandContext({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            resolvedProject: resolved,
+            config: loaded.config,
+        });
         const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
         const readmePaths = await resolveReadmePaths({ tasksDir, params });
         if (!params.all) {
@@ -262,6 +266,12 @@ export async function cmdTaskMigrateDoc(opts) {
             if (res.changed)
                 changed += 1;
         }
+        // Refresh the local export snapshot so doctor and other snapshot-based checks
+        // immediately observe the migrated README contract without a separate task export.
+        if (ctx.taskBackend.exportProjectionSnapshot || ctx.taskBackend.exportTasksJson) {
+            const outPath = path.join(resolved.gitRoot, loaded.config.paths.tasks_path);
+            await exportTaskProjectionSnapshot({ ctx, outputPath: outPath });
+        }
         if (!params.quiet) {
             process.stdout.write(`${successMessage("migrated task docs", undefined, `changed=${changed}`)}\n`);
         }

package/dist/commands/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA2CA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAuMF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4gBlB;AAED,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAuMF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsiBlB;AAED,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/commands/upgrade.js

@@ -10,6 +10,7 @@ import { extractArchive } from "../cli/archive.js";
 import { exitCodeForError } from "../cli/exit-codes.js";
 import { warnMessage } from "../cli/output.js";
 import { CliError } from "../shared/errors.js";
+import { ensureWorkflowArtifacts } from "../shared/workflow-artifacts.js";
 import { ensureNetworkApproved } from "./shared/network-approval.js";
 import { getVersion } from "../meta/version.js";
 import { applyManagedFiles, cleanupAutoUpgradeArtifacts, createUpgradeCommit, ensureCleanTrackedTreeForUpgrade, persistUpgradeState, } from "./upgrade/apply.js";
@@ -638,8 +639,25 @@ export async function cmdUpgradeParsed(opts) {
             updates: updates.length,
             skipped: skipped.length,
         });
+        const orchestratorProfilePath = path.join(resolved.agentplaneDir, "agents", "ORCHESTRATOR.json");
+        const workflowArtifacts = (await fileExists(orchestratorProfilePath))
+            ? await ensureWorkflowArtifacts({
+                gitRoot: resolved.gitRoot,
+                workflowMode: loaded.config.workflow_mode,
+                approvals: {
+                    requirePlanApproval: loaded.config.agents?.approvals?.require_plan ?? true,
+                    requireVerifyApproval: loaded.config.agents?.approvals?.require_verify ?? true,
+                    requireNetworkApproval: loaded.config.agents?.approvals?.require_network ?? true,
+                },
+            })
+            : { installPaths: [], commitPaths: [], changedPaths: [] };
         const commitPaths = [
-            ...new Set([...additions, ...updates, ...(shouldMutateConfig ? [CONFIG_REL_PATH] : [])]),
+            ...new Set([
+                ...additions,
+                ...updates,
+                ...workflowArtifacts.commitPaths,
+                ...(shouldMutateConfig ? [CONFIG_REL_PATH] : []),
+            ]),
         ];
         const commit = await createUpgradeCommit({
             gitRoot: resolved.gitRoot,
@@ -653,6 +671,9 @@ export async function cmdUpgradeParsed(opts) {
         });
         await cleanupAutoUpgradeArtifacts({ upgradeStateDir, createdBackups });
         process.stdout.write(`Upgrade applied: ${additions.length} add, ${updates.length} update, ${skipped.length} unchanged\n`);
+        if (workflowArtifacts.changedPaths.length > 0) {
+            process.stdout.write(`Workflow artifacts refreshed: ${workflowArtifacts.commitPaths.join(", ")}\n`);
+        }
         if (commit) {
             process.stdout.write(`Upgrade commit: ${commit.hash.slice(0, 12)} ${commit.subject}\n`);
         }

package/dist/commands/workflow-build.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-build.command.d.ts","sourceRoot":"","sources":["../../src/commands/workflow-build.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAWvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CAgC9D,CAAC;AAWF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,mBAAmB,CA2EhE,CAAC"}
+{"version":3,"file":"workflow-build.command.d.ts","sourceRoot":"","sources":["../../src/commands/workflow-build.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CAgC9D,CAAC;AAWF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,mBAAmB,CAoEhE,CAAC"}

package/dist/commands/workflow-build.command.js

@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { successMessage, warnMessage } from "../cli/output.js";
+import { buildWorkflowRuntimeContext } from "../shared/workflow-artifacts.js";
 import { DEFAULT_WORKFLOW_TEMPLATE, buildWorkflowFromTemplates, diagnosticsSummary, publishWorkflowCandidate, resolveWorkflowPaths, validateWorkflowText, } from "../workflow-runtime/index.js";
 export const workflowBuildSpec = {
     id: ["workflow", "build"],
@@ -50,22 +51,15 @@ export const runWorkflowBuild = async (ctx, flags) => {
     const configLoaded = await loadConfig(resolved.agentplaneDir);
     const workflowPaths = resolveWorkflowPaths(resolved.gitRoot);
     const configApprovals = configLoaded.config.agents?.approvals;
-    const runtimeContext = {
-        workflow: {
-            mode: configLoaded.config.workflow_mode,
-            version: 1,
-            approvals: {
-                require_plan: configApprovals?.require_plan ?? true,
-                require_verify: configApprovals?.require_verify ?? true,
-                require_network: configApprovals?.require_network ?? true,
-            },
+    const runtimeContext = buildWorkflowRuntimeContext({
+        gitRoot: resolved.gitRoot,
+        workflowMode: configLoaded.config.workflow_mode,
+        approvals: {
+            requirePlanApproval: configApprovals?.require_plan ?? true,
+            requireVerifyApproval: configApprovals?.require_verify ?? true,
+            requireNetworkApproval: configApprovals?.require_network ?? true,
         },
-        runtime: {
-            repo_name: path.basename(resolved.gitRoot),
-            repo_root: resolved.gitRoot,
-            timestamp: new Date().toISOString(),
-        },
-    };
+    });
     const overrideTemplate = await maybeReadOverride(workflowPaths);
     const built = buildWorkflowFromTemplates({
         baseTemplate: DEFAULT_WORKFLOW_TEMPLATE,

package/dist/ports/task-backend-port.d.ts

@@ -3,6 +3,6 @@ export type TaskBackendPort = {
     listTasks(): Promise<TaskData[]>;
     getTask(id: string): Promise<TaskData | null>;
     writeTask(task: TaskData): Promise<void>;
-    exportTasksJson(path: string): Promise<void>;
+    exportProjectionSnapshot(path: string): Promise<void>;
 };
 //# sourceMappingURL=task-backend-port.d.ts.map

package/dist/ports/task-backend-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend-port.d.ts","sourceRoot":"","sources":["../../src/ports/task-backend-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC"}
+{"version":3,"file":"task-backend-port.d.ts","sourceRoot":"","sources":["../../src/ports/task-backend-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC"}

package/dist/shared/workflow-artifacts.d.ts

@@ -0,0 +1,37 @@
+export type WorkflowArtifactApprovals = {
+    requirePlanApproval: boolean;
+    requireVerifyApproval: boolean;
+    requireNetworkApproval: boolean;
+};
+export declare function buildWorkflowRuntimeContext(opts: {
+    gitRoot: string;
+    workflowMode: "direct" | "branch_pr";
+    approvals: WorkflowArtifactApprovals;
+    timestamp?: string;
+}): {
+    workflow: {
+        mode: "direct" | "branch_pr";
+        version: number;
+        approvals: {
+            require_plan: boolean;
+            require_verify: boolean;
+            require_network: boolean;
+        };
+    };
+    runtime: {
+        repo_name: string;
+        repo_root: string;
+        timestamp: string;
+    };
+};
+export declare function ensureWorkflowArtifacts(opts: {
+    gitRoot: string;
+    workflowMode: "direct" | "branch_pr";
+    approvals: WorkflowArtifactApprovals;
+    projectOverrideTemplate?: string;
+}): Promise<{
+    installPaths: string[];
+    commitPaths: string[];
+    changedPaths: string[];
+}>;
+//# sourceMappingURL=workflow-artifacts.d.ts.map

package/dist/shared/workflow-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-artifacts.d.ts","sourceRoot":"","sources":["../../src/shared/workflow-artifacts.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE,yBAAyB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;EAiBA;AAUD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE,yBAAyB,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwErF"}

package/dist/shared/workflow-artifacts.js

@@ -0,0 +1,97 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { DEFAULT_WORKFLOW_TEMPLATE, buildWorkflowFromTemplates, diagnosticsSummary, publishWorkflowCandidate, resolveWorkflowPaths, } from "../workflow-runtime/index.js";
+import { CliError } from "./errors.js";
+export function buildWorkflowRuntimeContext(opts) {
+    return {
+        workflow: {
+            mode: opts.workflowMode,
+            version: 1,
+            approvals: {
+                require_plan: opts.approvals.requirePlanApproval,
+                require_verify: opts.approvals.requireVerifyApproval,
+                require_network: opts.approvals.requireNetworkApproval,
+            },
+        },
+        runtime: {
+            repo_name: path.basename(opts.gitRoot) || "repo",
+            repo_root: opts.gitRoot,
+            timestamp: opts.timestamp ?? new Date().toISOString(),
+        },
+    };
+}
+async function readIfPresent(absPath) {
+    try {
+        return await readFile(absPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function ensureWorkflowArtifacts(opts) {
+    const workflowPaths = resolveWorkflowPaths(opts.gitRoot);
+    const [beforeWorkflow, beforeLastKnownGood, beforeLegacyWorkflow] = await Promise.all([
+        readIfPresent(workflowPaths.workflowPath),
+        readIfPresent(workflowPaths.lastKnownGoodPath),
+        workflowPaths.legacyWorkflowPath === workflowPaths.workflowPath
+            ? Promise.resolve(null)
+            : readIfPresent(workflowPaths.legacyWorkflowPath),
+    ]);
+    const built = buildWorkflowFromTemplates({
+        baseTemplate: DEFAULT_WORKFLOW_TEMPLATE,
+        projectOverrideTemplate: opts.projectOverrideTemplate,
+        runtimeContext: buildWorkflowRuntimeContext({
+            gitRoot: opts.gitRoot,
+            workflowMode: opts.workflowMode,
+            approvals: opts.approvals,
+        }),
+    });
+    if (built.diagnostics.some((diagnostic) => diagnostic.severity === "ERROR")) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `Failed to generate WORKFLOW.md: ${diagnosticsSummary(built.diagnostics)}`,
+            context: {
+                diagnostics: built.diagnostics.map((diagnostic) => ({
+                    severity: diagnostic.severity,
+                    code: diagnostic.code,
+                    path: diagnostic.path,
+                    message: diagnostic.message,
+                })),
+            },
+        });
+    }
+    const published = await publishWorkflowCandidate(opts.gitRoot, built.text);
+    if (!published.ok) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `Failed to publish WORKFLOW.md: ${diagnosticsSummary(published.diagnostics)}`,
+            context: {
+                diagnostics: published.diagnostics.map((diagnostic) => ({
+                    severity: diagnostic.severity,
+                    code: diagnostic.code,
+                    path: diagnostic.path,
+                    message: diagnostic.message,
+                })),
+            },
+        });
+    }
+    const changedPaths = [];
+    if (beforeWorkflow !== built.text)
+        changedPaths.push(workflowPaths.workflowPath);
+    if (beforeLastKnownGood !== built.text)
+        changedPaths.push(workflowPaths.lastKnownGoodPath);
+    if (workflowPaths.legacyWorkflowPath !== workflowPaths.workflowPath &&
+        beforeLegacyWorkflow !== null) {
+        changedPaths.push(workflowPaths.legacyWorkflowPath);
+    }
+    const commitPaths = [
+        ...new Set(changedPaths.map((absPath) => path.relative(opts.gitRoot, absPath))),
+    ];
+    return {
+        installPaths: [workflowPaths.workflowPath, workflowPaths.lastKnownGoodPath],
+        commitPaths,
+        changedPaths,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -55,7 +55,7 @@
     "prepublishOnly": "node ../../scripts/enforce-github-publish.mjs && npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.3.3",
+    "@agentplaneorg/core": "0.3.5",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {