agentplane 0.3.10 → 0.3.12

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

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { extractTaskSuffix, loadConfig, resolveBaseBranch, resolveProject, } from "@agentplaneorg/core";
 import { createCliEmitter } from "../../cli/output.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { usageError } from "../../cli/spec/errors.js";
@@ -7,12 +7,14 @@ 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 { gitCurrentBranch } from "../shared/git-ops.js";
+import { parseTaskIdFromBranch } from "../shared/git-worktree.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { ensureNetworkApproved } from "../shared/network-approval.js";
 import { runOperatorPipeline } from "../shared/operator-pipeline.js";
 import { cleanHookEnv, maybePersistExpectedCliVersion, maybeRefreshGeneratedReference, maybeUpdateBunLockfile, replaceAgentplanePackageMetadata, replacePackageVersionInFile, } from "./apply.mutation.js";
 import { ensureCleanTrackedTree, ensureNpmVersionsAvailable, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, fileExists, loadReleasePlan, readCoreDependencyVersion, readPackageVersion, runReleasePrepublishGate, validateReleaseNotes, } from "./apply.preflight.js";
-import { pushReleaseRefs, writeReleaseApplyReport } from "./apply.reporting.js";
+import { pushReleaseCandidateBranch, pushReleaseRefs, writeReleaseApplyReport, } from "./apply.reporting.js";
 const output = createCliEmitter();
 async function resolveReleasePlanInputs(opts) {
     const { planDir, plan, minBullets } = await loadReleasePlan({
@@ -84,18 +86,21 @@ async function ensureReleasePlanMatchesRepoState(opts) {
 }
 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: "release_apply",
+        action: opts.route.kind === "release_candidate" ? "release_candidate" : "release_apply",
         config: loaded.config,
         yes: opts.yes,
-        reason: "release apply --push validates npm version availability and pushes over network",
+        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: `release apply --push will push HEAD and ${opts.nextTag} to ${opts.remote}`,
+        reason: pushReason,
         interactive: Boolean(process.stdin.isTTY),
     });
     await ensureRemoteExists(opts.gitRoot, opts.remote);
@@ -104,6 +109,140 @@ async function runPushPreflight(opts) {
     await runReleasePrepublishGate(opts.gitRoot);
     return true;
 }
+async function resolveDirectReleaseRoute(opts) {
+    const loaded = await loadConfig(opts.agentplaneDir);
+    const workflowMode = loaded.config.workflow_mode;
+    const currentBranch = await gitCurrentBranch(opts.gitRoot);
+    if (workflowMode !== "branch_pr") {
+        return {
+            kind: "direct_release",
+            workflow_mode: workflowMode,
+            current_branch: currentBranch,
+            base_branch: null,
+        };
+    }
+    const baseBranch = await resolveBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        mode: workflowMode,
+    });
+    if (!baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release apply in branch_pr mode requires a resolved base branch.\n" +
+                "Pin it with `agentplane branch base set <branch>` or configure origin/HEAD before rerunning.",
+            context: withDiagnosticContext({ command: "release apply" }, {
+                state: "branch_pr release routing could not resolve the protected base branch",
+                likelyCause: "the release flow needs to know whether this checkout is the protected base branch or a task branch before deciding if it should create or push a release tag",
+                nextAction: {
+                    command: "agentplane branch base set <branch>",
+                    reason: "pin the protected base branch so release commands can choose between the direct route and the release-candidate route",
+                    reasonCode: "release_branch_pr_base_unresolved",
+                },
+            }),
+        });
+    }
+    if (currentBranch !== baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "release apply is not available on branch_pr task branches.\n" +
+                "Use `agentplane release candidate` to prepare and optionally push the release candidate branch.",
+            context: withDiagnosticContext({ command: "release apply" }, {
+                state: "release apply was invoked from a branch_pr candidate branch",
+                likelyCause: "branch_pr repositories must prepare release candidates on dedicated non-base branches and publish only after merge into the protected base branch",
+                nextAction: {
+                    command: "agentplane release candidate",
+                    reason: "prepare the release candidate on the current branch instead of treating it as a direct publish route",
+                    reasonCode: "release_apply_branch_pr_candidate_requires_explicit_route",
+                },
+            }),
+        });
+    }
+    throw new CliError({
+        exitCode: exitCodeForError("E_VALIDATION"),
+        code: "E_VALIDATION",
+        message: "release apply is not available in branch_pr mode.\n" +
+            "Prepare the release candidate on a dedicated branch, merge it into the protected base branch, then let hosted publish run from main.",
+        context: withDiagnosticContext({ command: "release apply" }, {
+            state: "release apply was invoked from a branch_pr base checkout",
+            likelyCause: "branch_pr repositories publish from the merged base branch, so local direct release apply should not act as the publication route",
+            nextAction: {
+                command: "agentplane release candidate",
+                reason: "run the explicit release-candidate route from a dedicated non-base branch/worktree before merging to the protected base branch",
+                reasonCode: "release_apply_branch_pr_base_requires_candidate_route",
+            },
+        }),
+    });
+}
+async function resolveReleaseCandidateRoute(opts) {
+    const loaded = await loadConfig(opts.agentplaneDir);
+    const workflowMode = loaded.config.workflow_mode;
+    const currentBranch = await gitCurrentBranch(opts.gitRoot);
+    if (workflowMode !== "branch_pr") {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "release candidate is only available when workflow_mode=branch_pr.\n" +
+                "Use `agentplane release apply` for direct-mode releases.",
+            context: withDiagnosticContext({ command: "release candidate" }, {
+                state: "release candidate was invoked outside branch_pr mode",
+                likelyCause: "direct-mode repositories have no protected-base candidate route, so release preparation and publication stay on the direct release path",
+                nextAction: {
+                    command: "agentplane release apply",
+                    reason: "use the direct release route when the repository workflow mode is not branch_pr",
+                    reasonCode: "release_candidate_requires_branch_pr_mode",
+                },
+            }),
+        });
+    }
+    const baseBranch = await resolveBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        mode: workflowMode,
+    });
+    if (!baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release candidate routing in branch_pr mode requires a resolved base branch.\n" +
+                "Pin it with `agentplane branch base set <branch>` or configure origin/HEAD before rerunning.",
+            context: withDiagnosticContext({ command: "release candidate" }, {
+                state: "branch_pr release-candidate routing could not resolve the protected base branch",
+                likelyCause: "the candidate route must know which protected branch will eventually receive and publish the release candidate",
+                nextAction: {
+                    command: "agentplane branch base set <branch>",
+                    reason: "pin the protected base branch so release candidate routing can target the correct merge branch",
+                    reasonCode: "release_candidate_base_unresolved",
+                },
+            }),
+        });
+    }
+    if (currentBranch === baseBranch) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "release candidate must run from a dedicated non-base branch/worktree in branch_pr mode.\n" +
+                `Current branch ${currentBranch} is the protected base branch ${baseBranch}.`,
+            context: withDiagnosticContext({ command: "release candidate" }, {
+                state: "release candidate was invoked from the protected base branch",
+                likelyCause: "branch_pr release candidates must be prepared on a dedicated branch so the hosted PR becomes the promotion boundary into the protected base branch",
+                nextAction: {
+                    command: "agentplane work start <task-id> --agent CODER --slug <slug> --worktree",
+                    reason: "create or switch to a dedicated release-candidate branch/worktree before preparing the candidate",
+                    reasonCode: "release_candidate_requires_non_base_branch",
+                },
+            }),
+        });
+    }
+    return {
+        kind: "release_candidate",
+        workflow_mode: workflowMode,
+        current_branch: currentBranch,
+        base_branch: baseBranch,
+    };
+}
 async function applyReleaseMutation(opts) {
     let releaseCommit = null;
     await Promise.all([
@@ -133,7 +272,12 @@ async function applyReleaseMutation(opts) {
         output.line("No changes to commit.");
         return { releaseCommit };
     }
-    const subject = `✨ release: ${opts.nextTag}`;
+    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,
@@ -143,14 +287,32 @@ async function applyReleaseMutation(opts) {
     return { releaseCommit };
 }
 async function finalizeReleaseApply(opts) {
-    await execFileAsync("git", ["tag", opts.plan.nextTag], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-    });
-    output.line(`Release tag created: ${opts.plan.nextTag}`);
+    const tagCreated = opts.route.kind === "direct_release";
+    const pushedRefs = [];
+    if (tagCreated) {
+        await execFileAsync("git", ["tag", opts.plan.nextTag], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        output.line(`Release tag created: ${opts.plan.nextTag}`);
+    }
+    else {
+        output.line(`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) {
-        await pushReleaseRefs(opts.gitRoot, opts.remote, opts.plan.nextTag);
-        output.line(`Pushed: ${opts.remote} HEAD + ${opts.plan.nextTag}`);
+        if (opts.route.kind === "release_candidate") {
+            await pushReleaseCandidateBranch(opts.gitRoot, opts.remote);
+            pushedRefs.push("HEAD");
+            output.line(`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);
+            output.line(`Pushed: ${opts.remote} HEAD + ${opts.plan.nextTag}`);
+        }
+    }
+    else if (opts.route.kind === "release_candidate") {
+        output.line(`Next: git push <remote> HEAD  # merge ${opts.route.current_branch} into ${opts.route.base_branch} before publishing ${opts.plan.nextTag}`);
     }
     else {
         output.line(`Next: git push <remote> HEAD && git push <remote> ${opts.plan.nextTag}`);
@@ -171,7 +333,18 @@ async function finalizeReleaseApply(opts) {
             npm_version_available_checked: opts.npmVersionChecked,
         },
         commit: opts.releaseCommit,
-        push: { requested: opts.push, remote: opts.remote, performed: opts.push },
+        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,
+        },
     });
     output.line(`Release report: ${path.relative(opts.gitRoot, reportPath)}`);
     return 0;
@@ -179,8 +352,8 @@ async function finalizeReleaseApply(opts) {
 export const releaseApplySpec = {
     id: ["release", "apply"],
     group: "Release",
-    summary: "Apply a prepared release: bump versions, validate notes, commit, and tag.",
-    description: "Applies a release plan generated by `agentplane release plan`. This command does not author release notes; it expects a DOCS agent to have written docs/releases/vX.Y.Z.md. By default it applies a patch bump; minor/major bumps require explicit approval.",
+    summary: "Apply a prepared direct-mode release: bump versions, validate notes, commit, and tag.",
+    description: "Applies a release plan generated by `agentplane release plan` on the direct release route. This command does not author release notes; it expects a DOCS agent to have written docs/releases/vX.Y.Z.md. In branch_pr repositories, use `agentplane release candidate` on a dedicated non-base branch instead.",
     options: [
         {
             kind: "string",
@@ -192,8 +365,8 @@ export const releaseApplySpec = {
             kind: "boolean",
             name: "push",
             default: false,
-            description: "Mandatory for real releases: push commit and tag so GitHub publish workflow can publish to npm " +
-                "(requires --yes). Local tests can skip with AGENTPLANE_RELEASE_DRY_RUN=1.",
+            description: "Optional direct-push mode: push the release commit and tag immediately " +
+                "(requires --yes). This is for the direct release route only.",
         },
         {
             kind: "string",
@@ -217,13 +390,6 @@ export const releaseApplySpec = {
         };
     },
     validate: (p) => {
-        if (!p.push && process.env.AGENTPLANE_RELEASE_DRY_RUN !== "1") {
-            throw usageError({
-                spec: releaseApplySpec,
-                command: "release apply",
-                message: "Release publish is mandatory. Run `agentplane release apply --push --yes`.",
-            });
-        }
         if (p.push && p.yes !== true) {
             throw usageError({
                 spec: releaseApplySpec,
@@ -242,7 +408,7 @@ export const releaseApplySpec = {
     examples: [
         {
             cmd: "agentplane release apply",
-            why: "Apply the latest release plan (expects docs/releases/vX.Y.Z.md to exist).",
+            why: "Apply the latest release plan locally (expects docs/releases/vX.Y.Z.md to exist).",
         },
         {
             cmd: "agentplane release apply --plan .agentplane/.release/plan/<runId>",
@@ -254,14 +420,71 @@ export const releaseApplySpec = {
         },
     ],
 };
+const releaseCandidateOptions = [
+    {
+        kind: "string",
+        name: "plan",
+        valueHint: "<path>",
+        description: "Path to a release plan directory (defaults to the latest under .agentplane/.release/plan/).",
+    },
+    {
+        kind: "boolean",
+        name: "push",
+        default: false,
+        description: "Optional candidate-push mode: push only the release candidate branch for hosted review and merge (requires --yes). The release tag is not created or pushed here.",
+    },
+    {
+        kind: "string",
+        name: "remote",
+        valueHint: "<name>",
+        description: "Git remote to push to (default: origin).",
+    },
+    {
+        kind: "boolean",
+        name: "yes",
+        default: false,
+        description: "Approve minor/major bumps and allow pushing. Patch bumps can be applied without this flag.",
+    },
+];
+export const releaseCandidateSpec = {
+    id: ["release", "candidate"],
+    group: "Release",
+    summary: "Prepare a branch_pr release candidate: bump versions, validate notes, commit, and optionally push the candidate branch.",
+    description: "Prepares a release candidate from a generated release plan on a dedicated non-base branch in branch_pr mode. This command creates the candidate commit but intentionally does not create or push the release tag; final publication remains gated on merge to the protected base branch and hosted publish from main.",
+    options: releaseCandidateOptions,
+    parse: releaseApplySpec.parse,
+    validate: (p) => {
+        if (p.push && p.yes !== true) {
+            throw usageError({
+                spec: releaseCandidateSpec,
+                command: "release candidate",
+                message: "Option --push requires explicit approval. Re-run with --yes.",
+            });
+        }
+        if (!p.remote.trim()) {
+            throw usageError({
+                spec: releaseCandidateSpec,
+                command: "release candidate",
+                message: "Option --remote must be non-empty.",
+            });
+        }
+    },
+    examples: [
+        {
+            cmd: "agentplane release candidate",
+            why: "Prepare the latest release plan on the current branch_pr candidate branch.",
+        },
+        {
+            cmd: "agentplane release candidate --plan .agentplane/.release/plan/<runId>",
+            why: "Prepare a specific release plan on the current candidate branch.",
+        },
+        {
+            cmd: "agentplane release candidate --push --yes",
+            why: "Prepare and push only the release candidate branch for hosted review and merge.",
+        },
+    ],
+};
 export const runReleaseApply = async (ctx, flags) => {
-    if (!flags.push && process.env.AGENTPLANE_RELEASE_DRY_RUN !== "1") {
-        throw usageError({
-            spec: releaseApplySpec,
-            command: "release apply",
-            message: "Release publish is mandatory. Run `agentplane release apply --push --yes`.",
-        });
-    }
     return await runOperatorPipeline({
         init: async () => {
             const resolved = await resolveProject({
@@ -273,12 +496,20 @@ export const runReleaseApply = async (ctx, flags) => {
                 gitRoot,
                 planOverride: flags.plan,
             });
+            const loaded = await loadConfig(resolved.agentplaneDir);
             return {
                 resolved,
                 gitRoot,
                 planDir,
                 plan,
                 notesPath,
+                taskBranchPrefix: loaded.config.branch.task_prefix,
+                route: await resolveDirectReleaseRoute({
+                    cwd: ctx.cwd,
+                    rootOverride: ctx.rootOverride ?? null,
+                    gitRoot,
+                    agentplaneDir: resolved.agentplaneDir,
+                }),
                 corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
                 agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
                 npmVersionChecked: false,
@@ -305,7 +536,95 @@ export const runReleaseApply = async (ctx, flags) => {
                     remote: flags.remote,
                     nextTag: state.plan.nextTag,
                     nextVersion: state.plan.nextVersion,
+                    route: state.route,
+                    yes: flags.yes,
+                    commandLabel: "release apply --push",
+                });
+            }
+        },
+        execute: async (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,
+                nextTag: state.plan.nextTag,
+                nextVersion: state.plan.nextVersion,
+                route: state.route,
+                taskBranchPrefix: state.taskBranchPrefix,
+            });
+        },
+        finalize: async (state, mutation) => await finalizeReleaseApply({
+            gitRoot: state.gitRoot,
+            planDir: state.planDir,
+            notesPath: state.notesPath,
+            plan: state.plan,
+            npmVersionChecked: state.npmVersionChecked,
+            releaseCommit: mutation.releaseCommit,
+            route: state.route,
+            push: flags.push,
+            remote: flags.remote,
+        }),
+    });
+};
+export const runReleaseCandidate = async (ctx, flags) => {
+    return await runOperatorPipeline({
+        init: async () => {
+            const resolved = await resolveProject({
+                cwd: ctx.cwd,
+                rootOverride: ctx.rootOverride ?? null,
+            });
+            const gitRoot = resolved.gitRoot;
+            const { planDir, plan, notesPath } = await resolveReleasePlanInputs({
+                gitRoot,
+                planOverride: flags.plan,
+            });
+            const loaded = await loadConfig(resolved.agentplaneDir);
+            return {
+                resolved,
+                gitRoot,
+                planDir,
+                plan,
+                notesPath,
+                taskBranchPrefix: loaded.config.branch.task_prefix,
+                route: await resolveReleaseCandidateRoute({
+                    cwd: ctx.cwd,
+                    rootOverride: ctx.rootOverride ?? null,
+                    gitRoot,
+                    agentplaneDir: resolved.agentplaneDir,
+                }),
+                corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
+                agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
+                npmVersionChecked: false,
+            };
+        },
+        preflight: async (state) => {
+            if ((state.plan.bump === "minor" || state.plan.bump === "major") && flags.yes !== true) {
+                throw usageError({
+                    spec: releaseCandidateSpec,
+                    command: "release candidate",
+                    message: `Bump '${state.plan.bump}' requires explicit approval. Re-run with --yes.`,
+                });
+            }
+            await ensureReleasePlanMatchesRepoState({
+                gitRoot: state.gitRoot,
+                plan: state.plan,
+                corePkgPath: state.corePkgPath,
+                agentplanePkgPath: state.agentplanePkgPath,
+            });
+            if (flags.push) {
+                state.npmVersionChecked = await runPushPreflight({
+                    agentplaneDir: state.resolved.agentplaneDir,
+                    gitRoot: state.gitRoot,
+                    remote: flags.remote,
+                    nextTag: state.plan.nextTag,
+                    nextVersion: state.plan.nextVersion,
+                    route: state.route,
                     yes: flags.yes,
+                    commandLabel: "release candidate --push",
                 });
             }
         },
@@ -320,6 +639,8 @@ export const runReleaseApply = async (ctx, flags) => {
                 agentplanePkgPath: state.agentplanePkgPath,
                 nextTag: state.plan.nextTag,
                 nextVersion: state.plan.nextVersion,
+                route: state.route,
+                taskBranchPrefix: state.taskBranchPrefix,
             });
         },
         finalize: async (state, mutation) => await finalizeReleaseApply({
@@ -329,9 +650,10 @@ export const runReleaseApply = async (ctx, flags) => {
             plan: state.plan,
             npmVersionChecked: state.npmVersionChecked,
             releaseCommit: mutation.releaseCommit,
+            route: state.route,
             push: flags.push,
             remote: flags.remote,
         }),
     });
 };
-export { pushReleaseRefs } from "./apply.reporting.js";
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";

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

@@ -1 +1 @@
-{"version":3,"file":"apply.mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.mutation.ts"],"names":[],"mappings":"AASA,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAAC,UAAU,CAMhD"}
+{"version":3,"file":"apply.mutation.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.mutation.ts"],"names":[],"mappings":"AASA,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAAC,UAAU,CAOhD"}

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

@@ -103,5 +103,6 @@ export function cleanHookEnv() {
     delete env.AGENTPLANE_TASK_ID;
     delete env.AGENTPLANE_STATUS_TO;
     delete env.AGENTPLANE_AGENT_ID;
+    env.AGENTPLANE_ALLOW_CONFIG = "1";
     return env;
 }

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;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBpF;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,CAiC3E;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;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBpF;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"}

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

@@ -140,7 +140,7 @@ export async function ensureCleanTrackedTree(gitRoot) {
             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 --push --yes`",
+                reason: "inspect or clear tracked changes before rerunning `agentplane release apply`",
                 reasonCode: "release_dirty_tree",
             },
         }),

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

@@ -1,4 +1,5 @@
 import type { ReleaseApplyReport } from "./apply.types.js";
 export declare function writeReleaseApplyReport(gitRoot: string, report: ReleaseApplyReport): Promise<string>;
 export declare function pushReleaseRefs(gitRoot: string, remote: string, tag: string): Promise<void>;
+export declare function pushReleaseCandidateBranch(gitRoot: string, remote: string): Promise<void>;
 //# sourceMappingURL=apply.reporting.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.reporting.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.reporting.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjG"}
+{"version":3,"file":"apply.reporting.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.reporting.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAe3D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjG;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F"}

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

@@ -1,6 +1,14 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { execFileAsync, gitEnv } from "../shared/git.js";
+async function pushRefspecsNoVerify(gitRoot, remote, refspecs) {
+    for (const refspec of refspecs) {
+        await execFileAsync("git", ["push", "--no-verify", remote, refspec], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+    }
+}
 export async function writeReleaseApplyReport(gitRoot, report) {
     const runId = new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");
     const dir = path.join(gitRoot, ".agentplane", ".release", "apply");
@@ -13,12 +21,8 @@ export async function writeReleaseApplyReport(gitRoot, report) {
     return reportPath;
 }
 export async function pushReleaseRefs(gitRoot, remote, tag) {
-    await execFileAsync("git", ["push", "--no-verify", remote, "HEAD"], {
-        cwd: gitRoot,
-        env: gitEnv(),
-    });
-    await execFileAsync("git", ["push", "--no-verify", remote, tag], {
-        cwd: gitRoot,
-        env: gitEnv(),
-    });
+    await pushRefspecsNoVerify(gitRoot, remote, ["HEAD", tag]);
+}
+export async function pushReleaseCandidateBranch(gitRoot, remote) {
+    await pushRefspecsNoVerify(gitRoot, remote, ["HEAD"]);
 }

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

@@ -13,6 +13,12 @@ export type ReleaseVersionPlan = {
     nextVersion: string;
     bump: BumpKind;
 };
+export type ReleaseApplyRoute = {
+    kind: "direct_release" | "release_candidate";
+    workflow_mode: "direct" | "branch_pr";
+    current_branch: string;
+    base_branch: string | null;
+};
 export type PlanChange = {
     hash: string;
     authorDateIso: string;
@@ -37,10 +43,17 @@ export type ReleaseApplyReport = {
         hash: string;
         subject: string;
     } | null;
+    route: ReleaseApplyRoute;
+    tag: {
+        name: string;
+        created: boolean;
+        pushed: boolean;
+    };
     push: {
         requested: boolean;
         remote: string;
         performed: boolean;
+        refs: string[];
     };
 };
 //# sourceMappingURL=apply.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.types.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE;QACN,kBAAkB,EAAE,IAAI,CAAC;QACzB,UAAU,EAAE,IAAI,CAAC;QACjB,eAAe,EAAE,IAAI,CAAC;QACtB,6BAA6B,EAAE,OAAO,CAAC;KACxC,CAAC;IACF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAClE,CAAC"}
+{"version":3,"file":"apply.types.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IAC7C,aAAa,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE;QACN,kBAAkB,EAAE,IAAI,CAAC;QACzB,UAAU,EAAE,IAAI,CAAC;QACjB,eAAe,EAAE,IAAI,CAAC;QACtB,6BAA6B,EAAE,OAAO,CAAC;KACxC,CAAC;IACF,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClF,CAAC"}

package/dist/commands/release/plan.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/plan.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1E,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AA4IjD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4E1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAqE5D,CAAC"}
+{"version":3,"file":"plan.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/plan.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1E,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAkLjD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA4E1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAiF5D,CAAC"}