agentplane 0.3.22 → 0.3.24

package/dist/commands/release/apply.preflight.plan.d.ts

@@ -0,0 +1,16 @@
+import type { PlanChange, ReleaseVersionPlan } from "./apply.types.js";
+export declare function fileExists(p: string): Promise<boolean>;
+export declare function readJsonFile<T>(p: string): Promise<T>;
+export declare function parseVersionPlan(raw: unknown): ReleaseVersionPlan;
+export declare function findLatestPlanDir(gitRoot: string): Promise<string>;
+export declare function loadReleasePlan(opts: {
+    gitRoot: string;
+    planOverride?: string;
+}): Promise<{
+    planDir: string;
+    versionJsonPath: string;
+    plan: ReleaseVersionPlan;
+    changes: PlanChange[];
+    minBullets: number;
+}>;
+//# sourceMappingURL=apply.preflight.plan.d.ts.map

package/dist/commands/release/apply.preflight.plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.plan.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3D;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAuBjE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAwBD"}

package/dist/commands/release/apply.preflight.plan.js

@@ -0,0 +1,92 @@
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+export async function fileExists(p) {
+    try {
+        await readFile(p, "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readJsonFile(p) {
+    return JSON.parse(await readFile(p, "utf8"));
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid ${label} (expected non-empty string).`,
+        });
+    }
+    return value.trim();
+}
+export function parseVersionPlan(raw) {
+    if (!raw || typeof raw !== "object") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Invalid version.json (expected object).",
+        });
+    }
+    const obj = raw;
+    const bumpRaw = assertNonEmptyString(obj.bump, "bump");
+    if (bumpRaw !== "patch" && bumpRaw !== "minor" && bumpRaw !== "major") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid bump in version.json: ${bumpRaw}`,
+        });
+    }
+    const prevTagVal = obj.prevTag;
+    const prevTag = prevTagVal === null ? null : typeof prevTagVal === "string" ? prevTagVal : null;
+    const prevVersion = assertNonEmptyString(obj.prevVersion, "prevVersion");
+    const nextTag = assertNonEmptyString(obj.nextTag, "nextTag");
+    const nextVersion = assertNonEmptyString(obj.nextVersion, "nextVersion");
+    return { prevTag, prevVersion, nextTag, nextVersion, bump: bumpRaw };
+}
+export async function findLatestPlanDir(gitRoot) {
+    const base = path.join(gitRoot, ".agentplane", ".release", "plan");
+    const runNames = await readdir(base);
+    const runs = runNames
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .toSorted();
+    const latest = runs.at(-1);
+    if (!latest) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: "No release plan runs found under .agentplane/.release/plan/. Run `agentplane release plan` first.",
+        });
+    }
+    return path.join(base, latest);
+}
+export async function loadReleasePlan(opts) {
+    const planDir = opts.planOverride
+        ? path.resolve(opts.gitRoot, opts.planOverride)
+        : await findLatestPlanDir(opts.gitRoot);
+    const versionJsonPath = path.join(planDir, "version.json");
+    if (!(await fileExists(versionJsonPath))) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Missing version.json in plan dir: ${path.relative(opts.gitRoot, versionJsonPath)}`,
+        });
+    }
+    const plan = parseVersionPlan(await readJsonFile(versionJsonPath));
+    const changesJsonPath = path.join(planDir, "changes.json");
+    const changes = (await fileExists(changesJsonPath))
+        ? await readJsonFile(changesJsonPath)
+        : [];
+    return {
+        planDir,
+        versionJsonPath,
+        plan,
+        changes,
+        minBullets: Math.max(1, Array.isArray(changes) ? changes.length : 0),
+    };
+}

package/dist/commands/release/apply.preflight.publish.d.ts

@@ -0,0 +1,4 @@
+import { type ReleaseCommandLabel } from "./apply.preflight.git.js";
+export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function runReleasePrepublishGate(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+//# sourceMappingURL=apply.preflight.publish.d.ts.map

package/dist/commands/release/apply.preflight.publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.publish.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.publish.ts"],"names":[],"mappings":"AAWA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAuCf;AAgBD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/commands/release/apply.preflight.publish.js

@@ -0,0 +1,81 @@
+import path from "node:path";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
+import { CliError } from "../../shared/errors.js";
+import { resolvePreferredNodeExecutable, withPreferredRuntimePath, } from "../../shared/runtime-env.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { releasePushDescription } from "./apply.preflight.git.js";
+export async function ensureNpmVersionsAvailable(gitRoot, version, commandLabel = "release apply") {
+    const scriptPath = path.join(gitRoot, "scripts", "check-npm-version-availability.mjs");
+    try {
+        await execFileAsync(resolvePreferredNodeExecutable(process.env), [scriptPath, "--version", version], {
+            cwd: gitRoot,
+            env: withPreferredRuntimePath(process.env),
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const details = String(err?.stderr ?? "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Pre-publish npm check failed for version ${version}. ` +
+                "Ensure this version is not already published for @agentplaneorg/core and agentplane." +
+                (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: "the target npm version is not publishable",
+                likelyCause: "that version is already burned in npm history for one of the published packages, even if it is no longer the current dist-tag",
+                nextAction: {
+                    command: `node scripts/check-npm-version-availability.mjs --version ${version}`,
+                    reason: "inspect which package already consumed the target version before choosing a new release number",
+                    reasonCode: "release_npm_version_burned",
+                },
+            }),
+        });
+    }
+}
+async function runReleasePrepublishPhase(gitRoot, phase) {
+    await execFileAsync("bun", ["run", `release:prepublish:${phase}`], {
+        cwd: gitRoot,
+        env: withPreferredRuntimePath({
+            ...process.env,
+            GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "agentplane-release",
+            GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "agentplane-release@example.com",
+            GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? "agentplane-release",
+            GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? "agentplane-release@example.com",
+        }),
+        maxBuffer: 200 * 1024 * 1024,
+    });
+}
+export async function runReleasePrepublishGate(gitRoot, commandLabel = "release apply") {
+    for (const phase of ["fast", "heavy"]) {
+        try {
+            await runReleasePrepublishPhase(gitRoot, phase);
+        }
+        catch (err) {
+            const details = String(err?.stderr ??
+                err?.stdout ??
+                err?.message ??
+                "").trim();
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: `Release prepublish ${phase} phase failed. \`agentplane ${commandLabel} --push\` requires a successful local \`bun run release:prepublish:${phase}\` run before ${releasePushDescription(commandLabel)}.` +
+                    (details ? `\n\n${details}` : ""),
+                context: withDiagnosticContext({ command: commandLabel }, {
+                    state: `release prepublish ${phase} validation failed before ${releasePushDescription(commandLabel)}`,
+                    likelyCause: phase === "fast"
+                        ? "a lightweight publish-readiness check rejected the current release payload before the expensive validation route started"
+                        : "the expensive release validation route rejected the current repository state after the fast publish-readiness checks passed",
+                    nextAction: {
+                        command: `bun run release:prepublish:${phase}`,
+                        reason: phase === "fast"
+                            ? `rerun the fast prepublish phase to fix the exact payload or packaging problem before retrying ${commandLabel}`
+                            : `rerun the heavy prepublish phase to inspect and fix the expensive validation failure before retrying ${commandLabel}`,
+                        reasonCode: `release_prepublish_${phase}_failed`,
+                    },
+                }),
+            });
+        }
+    }
+}

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":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAqB7D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAanC,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AA+TF,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DlC;AAED,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,CAoBlB"}
+{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAO7D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAqEF,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DlC;AAED,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,CAoBlB"}

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

@@ -1,239 +1,16 @@
 import { readdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { loadConfig } from "@agentplaneorg/core/config";
+import { gitEnv } from "@agentplaneorg/core/git";
+import { execFileAsync } from "@agentplaneorg/core/process";
 import { resolveProject } from "@agentplaneorg/core/project";
-import { atomicWriteFile } from "@agentplaneorg/core/fs";
-import { ensureDocSections, extractTaskDoc, mergeTaskDoc, normalizeTaskDoc, parseTaskReadme, renderTaskDocFromSections, renderTaskReadme, setMarkdownSection, taskDocToSectionMap, } from "@agentplaneorg/core/tasks";
 import { mapCoreError } from "../../cli/error-map.js";
 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 { execFileAsync } from "@agentplaneorg/core/process";
-import { gitEnv } from "@agentplaneorg/core/git";
 import { exportTaskProjectionSnapshot, loadCommandContext, } from "../shared/task-backend.js";
-import { extractDocSection, extractTaskObservationSection, decodeEscapedTaskTextNewlines, normalizeTaskDocVersion, normalizeVerificationSectionLayout, } from "./shared/docs.js";
-import { defaultTaskDocV3 } from "./doc-template.js";
-const V3_CANONICAL_ORDER = [
-    "Summary",
-    "Scope",
-    "Plan",
-    "Verify Steps",
-    "Verification",
-    "Rollback Plan",
-    "Findings",
-];
-const HUMAN_TEXT_SECTIONS = new Set(["summary", "context", "scope", "plan", "findings", "notes"]);
-function isRecord(value) {
-    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function normalizeRevision(value) {
-    return Number.isInteger(value) && typeof value === "number" && value > 0 ? value : null;
-}
-function normalizeCanonicalSections(value) {
-    if (!isRecord(value))
-        return null;
-    const out = {};
-    for (const [title, text] of Object.entries(value)) {
-        const normalizedTitle = title.trim();
-        if (!normalizedTitle || typeof text !== "string")
-            continue;
-        out[normalizedTitle] = text.replaceAll("\r\n", "\n").trimEnd();
-    }
-    return Object.keys(out).length > 0 ? out : null;
-}
-function normalizeSectionKey(section) {
-    return section.trim().replaceAll(/\s+/g, " ").toLowerCase();
-}
-function parseMarkdownSections(doc) {
-    const lines = doc.replaceAll("\r\n", "\n").split("\n");
-    const sections = [];
-    let current = null;
-    for (const line of lines) {
-        const match = /^##\s+(.*)$/.exec(line.trim());
-        if (match) {
-            if (current) {
-                current.text = current.text.trimEnd();
-                sections.push(current);
-            }
-            current = { title: (match[1] ?? "").trim(), text: "" };
-            continue;
-        }
-        if (current) {
-            current.text = current.text.length > 0 ? `${current.text}\n${line}` : line;
-        }
-    }
-    if (current) {
-        current.text = current.text.trimEnd();
-        sections.push(current);
-    }
-    return sections;
-}
-function renderMarkdownSections(sections) {
-    return sections
-        .map((section) => {
-        const text = section.text.trimEnd();
-        return text ? `## ${section.title}\n\n${text}` : `## ${section.title}\n`;
-    })
-        .join("\n\n")
-        .trimEnd();
-}
-function normalizeLiteralNewlinesInHumanSection(title, text) {
-    if (!HUMAN_TEXT_SECTIONS.has(normalizeSectionKey(title)))
-        return text.trimEnd();
-    return decodeEscapedTaskTextNewlines(text).trimEnd();
-}
-function firstSectionText(sections, title) {
-    const target = normalizeSectionKey(title);
-    return sections.find((section) => normalizeSectionKey(section.title) === target)?.text ?? null;
-}
-function mergeObservationText(doc, version) {
-    const preferred = extractTaskObservationSection(doc, version)?.trim() ?? "";
-    const notes = extractDocSection(doc, "Notes")?.trim() ?? "";
-    const findings = extractDocSection(doc, "Findings")?.trim() ?? "";
-    const out = [];
-    for (const candidate of [preferred, findings, notes]) {
-        if (!candidate)
-            continue;
-        if (out.includes(candidate))
-            continue;
-        out.push(candidate);
-    }
-    return out.join("\n\n").trim();
-}
-function migrateDocToV3(opts) {
-    const currentSections = parseMarkdownSections(opts.doc);
-    const defaultSections = parseMarkdownSections(defaultTaskDocV3({ title: opts.title, description: opts.description }));
-    const emitted = new Set();
-    const nextSections = [];
-    const observationText = mergeObservationText(opts.doc, 2);
-    for (const title of V3_CANONICAL_ORDER) {
-        const key = normalizeSectionKey(title);
-        const currentText = firstSectionText(currentSections, title);
-        const defaultText = firstSectionText(defaultSections, title) ?? "";
-        let nextText = currentText ?? defaultText;
-        if (title === "Verification") {
-            nextText = normalizeVerificationSectionLayout(currentText ?? defaultText, 3);
-        }
-        if (title === "Findings") {
-            nextText = observationText || defaultText;
-        }
-        if (nextText === null)
-            continue;
-        nextText = normalizeLiteralNewlinesInHumanSection(title, nextText);
-        nextSections.push({ title, text: nextText.trimEnd() });
-        emitted.add(key);
-        if (title === "Findings")
-            emitted.add("notes");
-    }
-    for (const section of currentSections) {
-        const key = normalizeSectionKey(section.title);
-        if (emitted.has(key))
-            continue;
-        nextSections.push({ title: section.title, text: section.text.trimEnd() });
-        emitted.add(key);
-    }
-    return renderMarkdownSections(nextSections);
-}
-function ensurePlanApprovalFrontmatter(frontmatter) {
-    const raw = frontmatter.plan_approval;
-    if (isRecord(raw) && typeof raw.state === "string")
-        return;
-    frontmatter.plan_approval = {
-        state: "pending",
-        updated_at: null,
-        updated_by: null,
-        note: null,
-    };
-}
-function ensureVerificationFrontmatter(frontmatter) {
-    const raw = frontmatter.verification;
-    if (isRecord(raw) && typeof raw.state === "string")
-        return;
-    frontmatter.verification = {
-        state: "pending",
-        updated_at: null,
-        updated_by: null,
-        note: null,
-    };
-}
-const DATE_ONLY_ON_RE = /\bon (\d{4}-\d{2}-\d{2})(?!T)\b/g;
-function isIsoTimestamp(value) {
-    if (!value.includes("T") || !value.endsWith("Z"))
-        return false;
-    const ms = Date.parse(value);
-    return Number.isFinite(ms);
-}
-function normalizeNoteTimestamp(opts) {
-    if (!isIsoTimestamp(opts.updatedAt))
-        return opts.note;
-    const updatedDate = opts.updatedAt.slice(0, 10);
-    return opts.note.replaceAll(DATE_ONLY_ON_RE, (match, date) => {
-        if (date !== updatedDate)
-            return match;
-        return `on ${opts.updatedAt}`;
-    });
-}
-function normalizeFrontmatterNoteTimestamps(frontmatter) {
-    const plan = frontmatter.plan_approval;
-    if (isRecord(plan) && typeof plan.note === "string" && typeof plan.updated_at === "string") {
-        plan.note = normalizeNoteTimestamp({ note: plan.note, updatedAt: plan.updated_at });
-    }
-    const verification = frontmatter.verification;
-    if (isRecord(verification) &&
-        typeof verification.note === "string" &&
-        typeof verification.updated_at === "string") {
-        verification.note = normalizeNoteTimestamp({
-            note: verification.note,
-            updatedAt: verification.updated_at,
-        });
-    }
-}
-async function migrateTaskReadmeDoc(opts) {
-    const originalRaw = await readFile(opts.readmePath, "utf8");
-    const original = originalRaw.endsWith("\n") ? originalRaw : `${originalRaw}\n`;
-    const parsed = parseTaskReadme(original);
-    const frontmatter = { ...parsed.frontmatter };
-    ensurePlanApprovalFrontmatter(frontmatter);
-    ensureVerificationFrontmatter(frontmatter);
-    normalizeFrontmatterNoteTimestamps(frontmatter);
-    const canonicalSections = normalizeCanonicalSections(frontmatter.sections);
-    const required = opts.config.tasks.doc.required_sections;
-    const extracted = extractTaskDoc(parsed.body);
-    const baseDoc = canonicalSections === null
-        ? extracted || parsed.body
-        : renderTaskDocFromSections(canonicalSections);
-    let nextDoc = normalizeTaskDoc(ensureDocSections(baseDoc, required));
-    const docVersion = normalizeTaskDocVersion(frontmatter.doc_version);
-    if (docVersion === 2) {
-        frontmatter.doc_version = 3;
-        nextDoc = migrateDocToV3({
-            title: typeof frontmatter.title === "string" ? frontmatter.title : "",
-            description: typeof frontmatter.description === "string" ? frontmatter.description : "",
-            doc: nextDoc,
-        });
-    }
-    else {
-        const verificationSection = extractDocSection(nextDoc, "Verification");
-        const normalizedVerification = normalizeVerificationSectionLayout(verificationSection, docVersion);
-        nextDoc = setMarkdownSection(nextDoc, "Verification", normalizedVerification);
-        for (const sectionTitle of ["Summary", "Context", "Scope", "Plan", "Findings", "Notes"]) {
-            const sectionText = extractDocSection(nextDoc, sectionTitle);
-            if (sectionText == null)
-                continue;
-            nextDoc = setMarkdownSection(nextDoc, sectionTitle, normalizeLiteralNewlinesInHumanSection(sectionTitle, sectionText));
-        }
-    }
-    const nextBody = extracted ? mergeTaskDoc(parsed.body, nextDoc) : nextDoc;
-    frontmatter.sections = taskDocToSectionMap(nextDoc);
-    frontmatter.revision = normalizeRevision(frontmatter.revision) ?? 1;
-    const rendered = renderTaskReadme(frontmatter, nextBody);
-    const next = rendered.endsWith("\n") ? rendered : `${rendered}\n`;
-    if (next === original)
-        return { changed: false };
-    await atomicWriteFile(opts.readmePath, next, "utf8");
-    return { changed: true };
-}
+import { migrateTaskReadmeDoc } from "./migrate-doc.readme.js";
 async function resolveReadmePaths(opts) {
     if (!opts.params.all) {
         return opts.params.taskIds.map((taskId) => path.join(opts.tasksDir, taskId, "README.md"));
@@ -251,6 +28,28 @@ async function resolveReadmePaths(opts) {
     }
     return out;
 }
+async function canStageGitPath(gitRoot, relPath) {
+    try {
+        await execFileAsync("git", ["ls-files", "--error-unmatch", "--", relPath], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        return true;
+    }
+    catch {
+        // Continue below: untracked paths may still be stageable when they are not ignored.
+    }
+    try {
+        await execFileAsync("git", ["check-ignore", "--quiet", "--", relPath], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
 async function exportProjectionSnapshotIfChanged(opts) {
     if (!(opts.ctx.taskBackend.exportProjectionSnapshot || opts.ctx.taskBackend.exportTasksJson)) {
         return [];
@@ -276,28 +75,6 @@ async function exportProjectionSnapshotIfChanged(opts) {
         return [];
     return (await canStageGitPath(opts.resolvedGitRoot, relOutputPath)) ? [relOutputPath] : [];
 }
-async function canStageGitPath(gitRoot, relPath) {
-    try {
-        await execFileAsync("git", ["ls-files", "--error-unmatch", "--", relPath], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        return true;
-    }
-    catch {
-        // Continue below: untracked paths may still be stageable when they are not ignored.
-    }
-    try {
-        await execFileAsync("git", ["check-ignore", "--quiet", "--", relPath], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        return false;
-    }
-    catch {
-        return true;
-    }
-}
 export async function migrateTaskDocsInWorkspace(opts) {
     const resolved = opts.resolvedProject ??
         (await resolveProject({

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

@@ -0,0 +1,8 @@
+import type { AgentplaneConfig } from "@agentplaneorg/core/config";
+export declare function migrateTaskReadmeDoc(opts: {
+    readmePath: string;
+    config: AgentplaneConfig;
+}): Promise<{
+    changed: boolean;
+}>;
+//# sourceMappingURL=migrate-doc.readme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-doc.readme.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.readme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AA4NnE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuDhC"}