agentplane 0.3.11 → 0.3.12

package/dist/commands/pr/open.js

@@ -3,6 +3,8 @@ import { mapBackendError } from "../../cli/error-map.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { maybeAutoCommitTaskPrArtifacts } from "./internal/auto-commit.js";
 import { syncPrArtifacts } from "./internal/sync.js";
 function prOpenOutcomeDetails(meta, openOutcome) {
     if (openOutcome)
@@ -35,6 +37,15 @@ export async function cmdPrOpen(opts) {
             branch: opts.branch,
             remoteMode: opts.syncOnly ? "sync-only" : "auto",
         });
+        const commandCtx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        if (meta.branch) {
+            await maybeAutoCommitTaskPrArtifacts({
+                ctx: commandCtx,
+                taskId: opts.taskId,
+                branch: meta.branch,
+            });
+        }
         output.success("pr open", path.relative(resolved.gitRoot, prDir), prOpenOutcomeDetails(meta, openOutcome ?? null));
         return 0;
     }

package/dist/commands/pr/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/update.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmEnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/update.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqEnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsClB"}

package/dist/commands/pr/update.js

@@ -5,6 +5,7 @@ import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { gitRevParse } from "../shared/git-ops.js";
 import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
+import { maybeAutoCommitTaskPrArtifacts } from "./internal/auto-commit.js";
 import { assessPrArtifactFreshness } from "./internal/freshness.js";
 import { syncPrArtifacts } from "./internal/sync.js";
 async function readTextIfExists(filePath) {
@@ -38,6 +39,7 @@ async function warnOnStaleVerifyAfterUpdate(opts) {
     const freshness = await assessPrArtifactFreshness({
         gitRoot: opts.resolved.gitRoot,
         workflowDir: path.join(opts.resolved.gitRoot, config.paths.workflow_dir),
+        tasksPath: config.paths.tasks_path,
         taskId: opts.taskId,
         branchHeadSha,
         metaHeadSha: opts.meta.head_sha ?? null,
@@ -54,16 +56,25 @@ async function warnOnStaleVerifyAfterUpdate(opts) {
 export async function cmdPrUpdate(opts) {
     try {
         const output = createCliEmitter();
+        const commandCtx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         const { meta, prDir, resolved } = await syncPrArtifacts({
-            ctx: opts.ctx,
+            ctx: commandCtx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
             taskId: opts.taskId,
             mode: "update",
         });
+        if (meta.branch) {
+            await maybeAutoCommitTaskPrArtifacts({
+                ctx: commandCtx,
+                taskId: opts.taskId,
+                branch: meta.branch,
+            });
+        }
         await warnOnStaleVerifyAfterUpdate({
             output,
-            ctx: opts.ctx,
+            ctx: commandCtx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
             taskId: opts.taskId,

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

@@ -1,6 +1,8 @@
 import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
 import type { ReleaseApplyParsed } from "./apply.types.js";
 export declare const releaseApplySpec: CommandSpec<ReleaseApplyParsed>;
+export declare const releaseCandidateSpec: CommandSpec<ReleaseApplyParsed>;
 export declare const runReleaseApply: CommandHandler<ReleaseApplyParsed>;
-export { pushReleaseRefs } from "./apply.reporting.js";
+export declare const runReleaseCandidate: CommandHandler<ReleaseApplyParsed>;
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";
 //# sourceMappingURL=apply.command.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA8B1E,OAAO,KAAK,EAAE,kBAAkB,EAA0C,MAAM,kBAAkB,CAAC;AAkOnG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CA0E5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CA2E9D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAoC1E,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,kBAAkB,CAAC;AA8c1B,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CA0E5D,CAAC;AAgCF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,kBAAkB,CAuChE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAwF9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,kBAAkB,CAwFlE,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

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",
@@ -193,7 +366,7 @@ export const releaseApplySpec = {
             name: "push",
             default: false,
             description: "Optional direct-push mode: push the release commit and tag immediately " +
-                "(requires --yes). Leave this off when publishing happens later from a protected branch workflow.",
+                "(requires --yes). This is for the direct release route only.",
         },
         {
             kind: "string",
@@ -247,6 +420,70 @@ 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) => {
     return await runOperatorPipeline({
         init: async () => {
@@ -259,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,
@@ -291,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",
                 });
             }
         },
@@ -306,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({
@@ -315,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.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"]);
 }