agentplane 0.3.15 → 0.3.17

package/dist/commands/release/apply.pipeline/state.js

@@ -0,0 +1,129 @@
+import path from "node:path";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { exitCodeForError } from "../../../cli/exit-codes.js";
+import { CliError } from "../../../shared/errors.js";
+import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { ensureCleanTrackedTree, ensureTagDoesNotExist, fileExists, loadReleasePlan, readCoreDependencyVersion, readOptionalAgentplaneDependencyVersion, readPackageVersion, readRecipesDependencyVersion, validateReleaseNotes, } from "../apply.preflight.js";
+export async function resolveReleasePlanInputs(opts) {
+    const { planDir, plan, minBullets } = await loadReleasePlan({
+        gitRoot: opts.gitRoot,
+        planOverride: opts.planOverride,
+    });
+    if (!/^v\d+\.\d+\.\d+$/u.test(plan.nextTag)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid nextTag in version.json (expected vX.Y.Z): ${plan.nextTag}`,
+        });
+    }
+    const notesPath = path.join(opts.gitRoot, "docs", "releases", `${plan.nextTag}.md`);
+    if (!(await fileExists(notesPath))) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Missing release notes: ${path.relative(opts.gitRoot, notesPath)}\n` +
+                "Write this file using a DOCS agent before applying the release.",
+        });
+    }
+    await validateReleaseNotes(notesPath, minBullets);
+    return { planDir, plan, notesPath };
+}
+export async function ensureReleasePlanMatchesRepoState(opts) {
+    const [coreVersion, agentplaneVersion, recipesVersion, coreDependencyVersion, recipesDependencyVersion,] = await Promise.all([
+        readPackageVersion(opts.corePkgPath),
+        readPackageVersion(opts.agentplanePkgPath),
+        readPackageVersion(opts.recipesPkgPath),
+        readCoreDependencyVersion(opts.agentplanePkgPath),
+        readRecipesDependencyVersion(opts.agentplanePkgPath),
+    ]);
+    if (coreVersion !== agentplaneVersion || coreVersion !== recipesVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Package versions must match before applying a release. ` +
+                `packages/core=${coreVersion} packages/agentplane=${agentplaneVersion} packages/recipes=${recipesVersion}`,
+        });
+    }
+    if (coreDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/core=${coreDependencyVersion} ` +
+                `must match packages/core version ${coreVersion}.`,
+        });
+    }
+    if (recipesDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/recipes=${recipesDependencyVersion} ` +
+                `must match packages/recipes version ${coreVersion}.`,
+        });
+    }
+    if (await fileExists(opts.testkitPkgPath)) {
+        const testkitAgentplaneDependencyVersion = await readOptionalAgentplaneDependencyVersion(opts.testkitPkgPath);
+        if (testkitAgentplaneDependencyVersion &&
+            testkitAgentplaneDependencyVersion !== agentplaneVersion) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: "Release dependency parity check failed before apply. " +
+                    `packages/testkit dependency agentplane=${testkitAgentplaneDependencyVersion} ` +
+                    `must match packages/agentplane version ${agentplaneVersion}.`,
+            });
+        }
+    }
+    await ensureCleanTrackedTree(opts.gitRoot, opts.commandLabel);
+    await ensureTagDoesNotExist(opts.gitRoot, opts.plan.nextTag, opts.commandLabel);
+    if (coreVersion !== opts.plan.prevVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Current version does not match the release-plan baseline. ` +
+                `current=${coreVersion} expected_prev=${opts.plan.prevVersion} expected_next=${opts.plan.nextVersion}\n` +
+                "Re-run `agentplane release plan` to generate a fresh plan for this repo state.",
+            context: withDiagnosticContext({ command: opts.commandLabel }, {
+                state: "the repository version no longer matches the prepared release-plan baseline",
+                likelyCause: "package versions changed after the plan was generated, so continuing would apply the release over a partially drifted local state",
+                nextAction: {
+                    command: "agentplane release plan",
+                    reason: "generate a fresh release plan from the current repository state before applying the release",
+                    reasonCode: "release_plan_drifted",
+                },
+            }),
+        });
+    }
+}
+export async function buildReleaseCommandState(opts) {
+    const resolved = await resolveProject({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const gitRoot = resolved.gitRoot;
+    const { planDir, plan, notesPath } = await resolveReleasePlanInputs({
+        gitRoot,
+        planOverride: opts.planOverride,
+    });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    return {
+        resolved,
+        gitRoot,
+        planDir,
+        plan,
+        notesPath,
+        taskBranchPrefix: loaded.config.branch.task_prefix,
+        route: await opts.routeResolver({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            gitRoot,
+            agentplaneDir: resolved.agentplaneDir,
+        }),
+        corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
+        agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
+        recipesPkgPath: path.join(gitRoot, "packages", "recipes", "package.json"),
+        testkitPkgPath: path.join(gitRoot, "packages", "testkit", "package.json"),
+        npmVersionChecked: false,
+    };
+}

package/dist/commands/release/apply.pipeline.d.ts

@@ -1,4 +1,4 @@
-import { type ResolvedProject } from "@agentplaneorg/core";
+import type { ResolvedProject } from "@agentplaneorg/core";
 import type { CommandSpec } from "../../cli/spec/spec.js";
 import type { ReleaseApplyParsed, ReleaseCommandRouteResolver } from "./apply.types.js";
 export declare function runReleaseCommandPipeline(opts: {

package/dist/commands/release/apply.pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.pipeline.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAsC1D,OAAO,KAAK,EACV,kBAAkB,EAIlB,2BAA2B,EAG5B,MAAM,kBAAkB,CAAC;AAgc1B,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlB;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"apply.pipeline.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAMxF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlB;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/commands/release/apply.pipeline.js

@@ -1,351 +1,8 @@
-import path from "node:path";
-import { extractTaskSuffix, loadConfig, resolveProject, } from "@agentplaneorg/core";
-import { createCliEmitter, emitCommandResult } from "../../cli/output.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { usageError } from "../../cli/spec/errors.js";
-import { withDiagnosticContext } from "../../shared/diagnostics.js";
-import { CliError } from "../../shared/errors.js";
-import { execFileAsync, gitEnv } from "../shared/git.js";
-import { GitContext } from "../shared/git-context.js";
-import { ensureActionApproved } from "../shared/approval-requirements.js";
-import { ensureNetworkApproved } from "../shared/network-approval.js";
 import { runOperatorPipeline } from "../shared/operator-pipeline.js";
-import { parseTaskIdFromBranch } from "../shared/git-worktree.js";
-import { cleanHookEnv, maybePersistExpectedCliVersion, maybeRefreshGeneratedReference, maybeUpdateBunLockfile, replaceAgentplanePackageMetadata, replacePackageDependencyVersion, replacePackageVersionInFile, } from "./apply.mutation.js";
-import { ensureCleanTrackedTree, ensureNpmVersionsAvailable, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, fileExists, loadReleasePlan, readAgentplaneDependencyVersion, readCoreDependencyVersion, readPackageVersion, readRecipesDependencyVersion, runReleasePrepublishGate, validateReleaseNotes, } from "./apply.preflight.js";
-import { pushReleaseCandidateBranch, pushReleaseRefs, writeReleaseApplyReport, } from "./apply.reporting.js";
-const output = createCliEmitter();
-function emitReleaseLine(text) {
-    emitCommandResult(output, { kind: "line", text });
-}
-async function resolveReleasePlanInputs(opts) {
-    const { planDir, plan, minBullets } = await loadReleasePlan({
-        gitRoot: opts.gitRoot,
-        planOverride: opts.planOverride,
-    });
-    if (!/^v\d+\.\d+\.\d+$/u.test(plan.nextTag)) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Invalid nextTag in version.json (expected vX.Y.Z): ${plan.nextTag}`,
-        });
-    }
-    const notesPath = path.join(opts.gitRoot, "docs", "releases", `${plan.nextTag}.md`);
-    if (!(await fileExists(notesPath))) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_IO"),
-            code: "E_IO",
-            message: `Missing release notes: ${path.relative(opts.gitRoot, notesPath)}\n` +
-                "Write this file using a DOCS agent before applying the release.",
-        });
-    }
-    await validateReleaseNotes(notesPath, minBullets);
-    return { planDir, plan, notesPath };
-}
-async function ensureReleasePlanMatchesRepoState(opts) {
-    const [coreVersion, agentplaneVersion, recipesVersion, coreDependencyVersion, recipesDependencyVersion,] = await Promise.all([
-        readPackageVersion(opts.corePkgPath),
-        readPackageVersion(opts.agentplanePkgPath),
-        readPackageVersion(opts.recipesPkgPath),
-        readCoreDependencyVersion(opts.agentplanePkgPath),
-        readRecipesDependencyVersion(opts.agentplanePkgPath),
-    ]);
-    if (coreVersion !== agentplaneVersion || coreVersion !== recipesVersion) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Package versions must match before applying a release. ` +
-                `packages/core=${coreVersion} packages/agentplane=${agentplaneVersion} packages/recipes=${recipesVersion}`,
-        });
-    }
-    if (coreDependencyVersion !== coreVersion) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: "Release dependency parity check failed before apply. " +
-                `packages/agentplane dependency @agentplaneorg/core=${coreDependencyVersion} ` +
-                `must match packages/core version ${coreVersion}.`,
-        });
-    }
-    if (recipesDependencyVersion !== coreVersion) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: "Release dependency parity check failed before apply. " +
-                `packages/agentplane dependency @agentplaneorg/recipes=${recipesDependencyVersion} ` +
-                `must match packages/recipes version ${coreVersion}.`,
-        });
-    }
-    if (await fileExists(opts.testkitPkgPath)) {
-        const testkitAgentplaneDependencyVersion = await readAgentplaneDependencyVersion(opts.testkitPkgPath);
-        if (testkitAgentplaneDependencyVersion !== agentplaneVersion) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_VALIDATION"),
-                code: "E_VALIDATION",
-                message: "Release dependency parity check failed before apply. " +
-                    `packages/testkit dependency agentplane=${testkitAgentplaneDependencyVersion} ` +
-                    `must match packages/agentplane version ${agentplaneVersion}.`,
-            });
-        }
-    }
-    await ensureCleanTrackedTree(opts.gitRoot);
-    await ensureTagDoesNotExist(opts.gitRoot, opts.plan.nextTag);
-    if (coreVersion !== opts.plan.prevVersion) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Current version does not match the release-plan baseline. ` +
-                `current=${coreVersion} expected_prev=${opts.plan.prevVersion} expected_next=${opts.plan.nextVersion}\n` +
-                "Re-run `agentplane release plan` to generate a fresh plan for this repo state.",
-            context: withDiagnosticContext({ command: "release apply" }, {
-                state: "the repository version no longer matches the prepared release-plan baseline",
-                likelyCause: "package versions changed after the plan was generated, so continuing would apply the release over a partially drifted local state",
-                nextAction: {
-                    command: "agentplane release plan",
-                    reason: "generate a fresh release plan from the current repository state before applying the release",
-                    reasonCode: "release_plan_drifted",
-                },
-            }),
-        });
-    }
-}
-async function runPushPreflight(opts) {
-    const loaded = await loadConfig(opts.agentplaneDir);
-    const pushReason = opts.route.kind === "release_candidate"
-        ? `${opts.commandLabel} will push current branch ${opts.route.current_branch} to ${opts.remote} as a release candidate for ${opts.nextTag}; final publication remains gated on merge to ${opts.route.base_branch}`
-        : `${opts.commandLabel} will push HEAD and ${opts.nextTag} to ${opts.remote}`;
-    await ensureNetworkApproved({
-        action: opts.route.kind === "release_candidate" ? "release_candidate" : "release_apply",
-        config: loaded.config,
-        yes: opts.yes,
-        reason: `${opts.commandLabel} validates npm version availability and pushes over network`,
-        interactive: Boolean(process.stdin.isTTY),
-    });
-    await ensureActionApproved({
-        action: "git_push",
-        config: loaded.config,
-        yes: opts.yes,
-        reason: pushReason,
-        interactive: Boolean(process.stdin.isTTY),
-    });
-    await ensureRemoteExists(opts.gitRoot, opts.remote);
-    await ensureRemoteTagDoesNotExist(opts.gitRoot, opts.remote, opts.nextTag);
-    await ensureNpmVersionsAvailable(opts.gitRoot, opts.nextVersion);
-    await runReleasePrepublishGate(opts.gitRoot);
-    return true;
-}
-async function applyReleaseMutation(opts) {
-    let releaseCommit = null;
-    await Promise.all([
-        replacePackageVersionInFile(opts.corePkgPath, opts.nextVersion),
-        replacePackageVersionInFile(opts.recipesPkgPath, opts.nextVersion),
-        replaceAgentplanePackageMetadata(opts.agentplanePkgPath, opts.nextVersion),
-    ]);
-    if (await fileExists(opts.testkitPkgPath)) {
-        await replacePackageDependencyVersion(opts.testkitPkgPath, "agentplane", opts.nextVersion);
-    }
-    const expectedCliVersionPersisted = await maybePersistExpectedCliVersion(opts.agentplaneDir, opts.nextVersion);
-    await maybeUpdateBunLockfile(opts.gitRoot, fileExists);
-    const generatedReferenceExists = await maybeRefreshGeneratedReference(opts.gitRoot, fileExists);
-    const stagePaths = [
-        "packages/core/package.json",
-        "packages/agentplane/package.json",
-        "packages/recipes/package.json",
-        path.relative(opts.gitRoot, opts.notesPath),
-    ];
-    if (await fileExists(opts.testkitPkgPath)) {
-        stagePaths.push("packages/testkit/package.json");
-    }
-    if (expectedCliVersionPersisted) {
-        stagePaths.push(".agentplane/config.json");
-    }
-    if (generatedReferenceExists) {
-        stagePaths.push("docs/reference/generated-reference.mdx");
-    }
-    if (await fileExists(path.join(opts.gitRoot, "bun.lock"))) {
-        stagePaths.push("bun.lock");
-    }
-    await opts.git.stage(stagePaths);
-    const staged = await opts.git.statusStagedPaths();
-    if (staged.length === 0) {
-        emitReleaseLine("No changes to commit.");
-        return { releaseCommit };
-    }
-    const taskId = opts.route.kind === "release_candidate"
-        ? parseTaskIdFromBranch(opts.taskBranchPrefix, opts.route.current_branch)
-        : null;
-    const subject = taskId
-        ? `✨ ${extractTaskSuffix(taskId)} release: publish ${opts.nextTag}`
-        : `✨ release: publish ${opts.nextTag}`;
-    await opts.git.commit({ message: subject, env: cleanHookEnv() });
-    const { stdout: headHash } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-    });
-    releaseCommit = { hash: String(headHash ?? "").trim(), subject };
-    return { releaseCommit };
-}
-async function finalizeReleaseApply(opts) {
-    const tagCreated = opts.route.kind === "direct_release";
-    const pushedRefs = [];
-    if (tagCreated) {
-        await execFileAsync("git", ["tag", opts.plan.nextTag], {
-            cwd: opts.gitRoot,
-            env: gitEnv(),
-        });
-        emitReleaseLine(`Release tag created: ${opts.plan.nextTag}`);
-    }
-    else {
-        emitReleaseLine(`Release candidate prepared on ${opts.route.current_branch}; skipped local tag creation for ${opts.plan.nextTag} because final publication is deferred until merge to ${opts.route.base_branch}.`);
-    }
-    if (opts.push) {
-        if (opts.route.kind === "release_candidate") {
-            await pushReleaseCandidateBranch(opts.gitRoot, opts.remote);
-            pushedRefs.push("HEAD");
-            emitReleaseLine(`Pushed: ${opts.remote} ${opts.route.current_branch} (release candidate branch only; no tag pushed)`);
-        }
-        else {
-            await pushReleaseRefs(opts.gitRoot, opts.remote, opts.plan.nextTag);
-            pushedRefs.push("HEAD", opts.plan.nextTag);
-            emitReleaseLine(`Pushed: ${opts.remote} HEAD + ${opts.plan.nextTag}`);
-        }
-    }
-    else if (opts.route.kind === "release_candidate") {
-        emitReleaseLine(`Next: git push <remote> HEAD  # merge ${opts.route.current_branch} into ${opts.route.base_branch} before publishing ${opts.plan.nextTag}`);
-    }
-    else {
-        emitReleaseLine(`Next: git push <remote> HEAD && git push <remote> ${opts.plan.nextTag}`);
-    }
-    const reportPath = await writeReleaseApplyReport(opts.gitRoot, {
-        applied_at: new Date().toISOString(),
-        plan_dir: path.relative(opts.gitRoot, opts.planDir),
-        notes_path: path.relative(opts.gitRoot, opts.notesPath),
-        prev_version: opts.plan.prevVersion,
-        next_version: opts.plan.nextVersion,
-        prev_tag: opts.plan.prevTag,
-        next_tag: opts.plan.nextTag,
-        bump: opts.plan.bump,
-        checks: {
-            clean_tracked_tree: true,
-            tag_absent: true,
-            notes_validated: true,
-            npm_version_available_checked: opts.npmVersionChecked,
-        },
-        commit: opts.releaseCommit,
-        route: opts.route,
-        tag: {
-            name: opts.plan.nextTag,
-            created: tagCreated,
-            pushed: tagCreated && opts.push,
-        },
-        push: {
-            requested: opts.push,
-            remote: opts.remote,
-            performed: pushedRefs.length > 0,
-            refs: pushedRefs,
-        },
-    });
-    emitReleaseLine(`Release report: ${path.relative(opts.gitRoot, reportPath)}`);
-    return 0;
-}
-async function buildReleaseCommandState(opts) {
-    const resolved = await resolveProject({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    const gitRoot = resolved.gitRoot;
-    const { planDir, plan, notesPath } = await resolveReleasePlanInputs({
-        gitRoot,
-        planOverride: opts.planOverride,
-    });
-    const loaded = await loadConfig(resolved.agentplaneDir);
-    return {
-        resolved,
-        gitRoot,
-        planDir,
-        plan,
-        notesPath,
-        taskBranchPrefix: loaded.config.branch.task_prefix,
-        route: await opts.routeResolver({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            gitRoot,
-            agentplaneDir: resolved.agentplaneDir,
-        }),
-        corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
-        agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
-        recipesPkgPath: path.join(gitRoot, "packages", "recipes", "package.json"),
-        testkitPkgPath: path.join(gitRoot, "packages", "testkit", "package.json"),
-        npmVersionChecked: false,
-    };
-}
-function assertReleaseBumpApproved(opts) {
-    if ((opts.plan.bump === "minor" || opts.plan.bump === "major") && opts.flags.yes !== true) {
-        throw usageError({
-            spec: opts.spec,
-            command: opts.commandLabel,
-            message: `Bump '${opts.plan.bump}' requires explicit approval. Re-run with --yes.`,
-        });
-    }
-}
-async function runReleaseCommandPreflight(opts) {
-    assertReleaseBumpApproved({
-        flags: opts.flags,
-        plan: opts.state.plan,
-        spec: opts.spec,
-        commandLabel: opts.commandLabel,
-    });
-    await ensureReleasePlanMatchesRepoState({
-        gitRoot: opts.state.gitRoot,
-        plan: opts.state.plan,
-        corePkgPath: opts.state.corePkgPath,
-        agentplanePkgPath: opts.state.agentplanePkgPath,
-        recipesPkgPath: opts.state.recipesPkgPath,
-        testkitPkgPath: opts.state.testkitPkgPath,
-    });
-    if (opts.flags.push) {
-        opts.state.npmVersionChecked = await runPushPreflight({
-            agentplaneDir: opts.state.resolved.agentplaneDir,
-            gitRoot: opts.state.gitRoot,
-            remote: opts.flags.remote,
-            nextTag: opts.state.plan.nextTag,
-            nextVersion: opts.state.plan.nextVersion,
-            route: opts.state.route,
-            yes: opts.flags.yes,
-            commandLabel: `${opts.commandLabel} --push`,
-        });
-    }
-}
-async function runReleaseCommandExecute(state) {
-    const git = new GitContext({ gitRoot: state.gitRoot });
-    return await applyReleaseMutation({
-        agentplaneDir: state.resolved.agentplaneDir,
-        gitRoot: state.gitRoot,
-        git,
-        notesPath: state.notesPath,
-        corePkgPath: state.corePkgPath,
-        agentplanePkgPath: state.agentplanePkgPath,
-        recipesPkgPath: state.recipesPkgPath,
-        testkitPkgPath: state.testkitPkgPath,
-        nextTag: state.plan.nextTag,
-        nextVersion: state.plan.nextVersion,
-        route: state.route,
-        taskBranchPrefix: state.taskBranchPrefix,
-    });
-}
-async function runReleaseCommandFinalize(opts) {
-    return await finalizeReleaseApply({
-        gitRoot: opts.state.gitRoot,
-        planDir: opts.state.planDir,
-        notesPath: opts.state.notesPath,
-        plan: opts.state.plan,
-        npmVersionChecked: opts.state.npmVersionChecked,
-        releaseCommit: opts.mutation.releaseCommit,
-        route: opts.state.route,
-        push: opts.flags.push,
-        remote: opts.flags.remote,
-    });
-}
+import { runReleaseCommandFinalize } from "./apply.pipeline/finalize.js";
+import { runReleaseCommandExecute } from "./apply.pipeline/mutation.js";
+import { runReleaseCommandPreflight } from "./apply.pipeline/preflight.js";
+import { buildReleaseCommandState } from "./apply.pipeline/state.js";
 export async function runReleaseCommandPipeline(opts) {
     return await runOperatorPipeline({
         init: async () => await buildReleaseCommandState({

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

@@ -7,13 +7,15 @@ export declare function readPackageVersion(pkgJsonPath: string): Promise<string>
 export declare function readCoreDependencyVersion(pkgJsonPath: string): Promise<string>;
 export declare function readRecipesDependencyVersion(pkgJsonPath: string): Promise<string>;
 export declare function readAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readOptionalAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string | null>;
 export declare function validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
-export declare function ensureCleanTrackedTree(gitRoot: string): Promise<void>;
-export declare function ensureTagDoesNotExist(gitRoot: string, tag: string): Promise<void>;
-export declare function ensureRemoteExists(gitRoot: string, remote: string): Promise<void>;
-export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string): Promise<void>;
-export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string): Promise<void>;
-export declare function runReleasePrepublishGate(gitRoot: string): Promise<void>;
+type ReleaseCommandLabel = "release apply" | "release candidate";
+export declare function ensureCleanTrackedTree(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureTagDoesNotExist(gitRoot: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteExists(gitRoot: string, remote: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function runReleasePrepublishGate(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
 export declare function loadReleasePlan(opts: {
     gitRoot: string;
     planOverride?: string;
@@ -24,4 +26,5 @@ export declare function loadReleasePlan(opts: {
     changes: PlanChange[];
     minBullets: number;
 }>;
+export {};
 //# sourceMappingURL=apply.preflight.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAQA,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,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAoBD,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF;AAED,wBAAsB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChG;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E;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"}
+{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAQA,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,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAoBD,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF;AAED,wBAAsB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,wBAAsB,uCAAuC,CAC3D,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,KAAK,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAQjE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAmCf;AAgBD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAsCf;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"}