agentplane 0.3.14 → 0.3.16

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

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

@@ -1,7 +1,7 @@
 import { readFile, readdir } from "node:fs/promises";
 import path from "node:path";
 import { exitCodeForError } from "../../cli/exit-codes.js";
-import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
 import { execFileAsync, gitEnv } from "../shared/git.js";
 export async function fileExists(p) {
@@ -102,6 +102,12 @@ export async function readRecipesDependencyVersion(pkgJsonPath) {
 export async function readAgentplaneDependencyVersion(pkgJsonPath) {
     return await readDependencyVersion(pkgJsonPath, "agentplane");
 }
+export async function readOptionalAgentplaneDependencyVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const value = raw.dependencies?.agentplane;
+    const version = typeof value === "string" ? value.trim() : "";
+    return version || null;
+}
 export async function validateReleaseNotes(notesPath, minBullets) {
     const content = await readFile(notesPath, "utf8");
     if (!/release\s+notes/i.test(content)) {
@@ -127,7 +133,12 @@ export async function validateReleaseNotes(notesPath, minBullets) {
         });
     }
 }
-export async function ensureCleanTrackedTree(gitRoot) {
+function releasePushDescription(commandLabel) {
+    return commandLabel === "release candidate"
+        ? "preparing or pushing the release candidate branch"
+        : "pushing the release tag";
+}
+export async function ensureCleanTrackedTree(gitRoot, commandLabel = "release apply") {
     const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
         cwd: gitRoot,
         env: gitEnv(),
@@ -142,20 +153,20 @@ export async function ensureCleanTrackedTree(gitRoot) {
     throw new CliError({
         exitCode: exitCodeForError("E_GIT"),
         code: "E_GIT",
-        message: "Release apply requires a clean tracked working tree.\n" +
+        message: `${commandLabel} requires a clean tracked working tree.\n` +
             `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
-        context: withDiagnosticContext({ command: "release apply" }, {
-            state: "release apply cannot start from a dirty tracked tree",
+        context: withDiagnosticContext({ command: commandLabel }, {
+            state: `${commandLabel} cannot start from a dirty tracked tree`,
             likelyCause: "the release flow needs to create one deterministic version-bump commit and tag, but tracked edits already exist in the workspace",
             nextAction: {
                 command: "git status --short --untracked-files=no",
-                reason: "inspect or clear tracked changes before rerunning `agentplane release apply`",
+                reason: `inspect or clear tracked changes before rerunning \`agentplane ${commandLabel}\``,
                 reasonCode: "release_dirty_tree",
             },
         }),
     });
 }
-export async function ensureTagDoesNotExist(gitRoot, tag) {
+export async function ensureTagDoesNotExist(gitRoot, tag, commandLabel = "release apply") {
     try {
         await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
             cwd: gitRoot,
@@ -165,7 +176,7 @@ export async function ensureTagDoesNotExist(gitRoot, tag) {
             exitCode: exitCodeForError("E_GIT"),
             code: "E_GIT",
             message: `Tag already exists: ${tag}`,
-            context: withDiagnosticContext({ command: "release apply" }, {
+            context: withDiagnosticContext({ command: commandLabel }, {
                 state: "the target release tag already exists locally",
                 likelyCause: "the release version was already applied earlier, or a previous release attempt created the tag before failing later in the flow",
                 nextAction: {
@@ -182,7 +193,7 @@ export async function ensureTagDoesNotExist(gitRoot, tag) {
             throw err;
     }
 }
-export async function ensureRemoteExists(gitRoot, remote) {
+export async function ensureRemoteExists(gitRoot, remote, commandLabel = "release apply") {
     try {
         await execFileAsync("git", ["remote", "get-url", remote], {
             cwd: gitRoot,
@@ -197,19 +208,19 @@ export async function ensureRemoteExists(gitRoot, remote) {
             exitCode: exitCodeForError("E_GIT"),
             code: "E_GIT",
             message: `Git remote is not configured: ${remote}` + (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
+            context: withDiagnosticContext({ command: commandLabel }, {
                 state: "the configured release remote does not exist locally",
                 likelyCause: "release apply was asked to push, but the selected git remote is missing or misconfigured in this checkout",
                 nextAction: {
                     command: "git remote -v",
-                    reason: "inspect configured remotes before rerunning release apply with --push",
+                    reason: `inspect configured remotes before rerunning ${commandLabel} with --push`,
                     reasonCode: "release_remote_missing",
                 },
             }),
         });
     }
 }
-export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
+export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag, commandLabel = "release apply") {
     let stdout = "";
     try {
         const out = await execFileAsync("git", ["ls-remote", "--tags", remote, `refs/tags/${tag}`], {
@@ -227,8 +238,8 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
             code: "E_GIT",
             message: `Failed to inspect remote tag state for ${remote}/${tag}.` +
                 (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
-                state: "release apply could not verify the remote tag state",
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: `${commandLabel} could not verify the remote tag state`,
                 likelyCause: "the remote is configured, but git could not query it for the target release tag before the release started",
                 nextAction: {
                     command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
@@ -244,7 +255,7 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
         exitCode: exitCodeForError("E_GIT"),
         code: "E_GIT",
         message: `Remote tag already exists: ${remote}/${tag}`,
-        context: withDiagnosticContext({ command: "release apply" }, {
+        context: withDiagnosticContext({ command: commandLabel }, {
             state: "the target release tag already exists on the remote",
             likelyCause: "a previous release or partial push already published this tag upstream, so pushing the same version again would drift the local release state",
             nextAction: {
@@ -255,7 +266,7 @@ export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
         }),
     });
 }
-export async function ensureNpmVersionsAvailable(gitRoot, version) {
+export async function ensureNpmVersionsAvailable(gitRoot, version, commandLabel = "release apply") {
     const scriptPath = path.join(gitRoot, "scripts", "check-npm-version-availability.mjs");
     try {
         await execFileAsync("node", [scriptPath, "--version", version], {
@@ -272,7 +283,7 @@ export async function ensureNpmVersionsAvailable(gitRoot, version) {
             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: "release apply" }, {
+            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: {
@@ -284,40 +295,49 @@ export async function ensureNpmVersionsAvailable(gitRoot, version) {
         });
     }
 }
-export async function runReleasePrepublishGate(gitRoot) {
-    try {
-        await execFileAsync("bun", ["run", "release:prepublish"], {
-            cwd: gitRoot,
-            env: {
-                ...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,
-        });
-    }
-    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 gate failed. `agentplane release apply --push` requires a successful local `bun run release:prepublish` run before pushing the release tag." +
-                (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: "release apply" }, {
-                state: "release prepublish validation failed before pushing the release",
-                likelyCause: "one of the local publish gates rejected the current repository state, so the release cannot be pushed safely yet",
-                nextAction: {
-                    command: "bun run release:prepublish",
-                    reason: "rerun the exact local publish gate and fix the reported failure before retrying release apply",
-                    reasonCode: "release_prepublish_failed",
-                },
-            }),
-        });
+async function runReleasePrepublishPhase(gitRoot, phase) {
+    await execFileAsync("bun", ["run", `release:prepublish:${phase}`], {
+        cwd: gitRoot,
+        env: {
+            ...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`,
+                    },
+                }),
+            });
+        }
     }
 }
 export async function loadReleasePlan(opts) {

package/dist/commands/runtime.command.d.ts

@@ -1,7 +1,7 @@
 import type { CommandHandler, CommandSpec } from "../cli/spec/spec.js";
 import { type GroupCommandParsed } from "../cli/group-command.js";
-import { type RepoCliVersionExpectation } from "../shared/repo-cli-version.js";
-import { type RuntimeSourceInfo } from "../shared/runtime-source.js";
+import { type RepoCliVersionExpectation } from "../runtime/shared/repo-cli-version.js";
+import { type RuntimeSourceInfo } from "../runtime/shared/runtime-source.js";
 export type FrameworkDevWorkflow = {
     available: boolean;
     bootstrapCommand: string;

package/dist/commands/runtime.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.command.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AASvC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAkCzF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,EAAE,yBAAyB,GAC5C,MAAM,CA+CR;AAyBD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAQzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkBlE,CAAC"}
+{"version":3,"file":"runtime.command.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,uCAAuC,CAAC;AAS/C,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAC;AAI7C,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAkCzF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,EAAE,yBAAyB,GAC5C,MAAM,CA+CR;AAyBD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAQzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkBlE,CAAC"}