agentplane 0.3.14 → 0.3.16

package/dist/commands/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,UAAU,iEAAkE,CAAC;AA8K1F,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoLlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,UAAU,iEAAkE,CAAC;AAoI1F,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AA4CD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8LlB"}

package/dist/commands/hooks/index.js

@@ -1,8 +1,7 @@
-import { spawnSync } from "node:child_process";
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { loadConfig, resolveBaseBranch, resolveProject } from "@agentplaneorg/core";
+import { loadConfig, resolveBaseBranch, resolveProject, runProcessSync } from "@agentplaneorg/core";
 import { evaluatePolicy } from "../../policy/evaluate.js";
 import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
 import { fileExists } from "../../cli/fs-utils.js";
@@ -133,6 +132,15 @@ function readCommitSubject(message) {
 function resolveBundledPrePushHookScriptPath() {
     return fileURLToPath(new URL("../../../../../scripts/run-pre-push-hook.mjs", import.meta.url));
 }
+export async function resolvePrePushHookScriptPath(gitRoot, opts = {}) {
+    const repoScriptPath = path.join(gitRoot, "scripts", "run-pre-push-hook.mjs");
+    if (await fileExists(repoScriptPath))
+        return repoScriptPath;
+    const bundledScriptPath = opts.bundledScriptPath ?? resolveBundledPrePushHookScriptPath();
+    if (await fileExists(bundledScriptPath))
+        return bundledScriptPath;
+    return null;
+}
 async function readHookStdinUtf8(timeoutMs = 25) {
     if (process.stdin.isTTY)
         return "";
@@ -333,24 +341,33 @@ export async function cmdHooksRun(opts) {
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride ?? null,
             });
-            const scriptPath = resolveBundledPrePushHookScriptPath();
-            if (!(await fileExists(scriptPath))) {
+            const scriptPath = await resolvePrePushHookScriptPath(resolved.gitRoot);
+            if (!scriptPath) {
                 throw new CliError({
                     exitCode: 2,
                     code: "E_USAGE",
-                    message: `Missing pre-push hook script: ${scriptPath}`,
+                    message: [
+                        "Missing pre-push hook script: scripts/run-pre-push-hook.mjs",
+                        "The pre-push hook needs a repository-local script or an installed CLI bundle that ships the fallback.",
+                        "Fix:",
+                        "  1) Restore scripts/run-pre-push-hook.mjs in this repository, or",
+                        "  2) Run `agentplane hooks uninstall` if this repository should not use the agentplane pre-push gate.",
+                    ].join("\n"),
                 });
             }
-            const result = spawnSync("node", [scriptPath], {
+            const result = runProcessSync({
+                command: "node",
+                args: [scriptPath],
                 cwd: resolved.gitRoot,
                 env: process.env,
                 encoding: "utf8",
                 input: await readHookStdinUtf8(),
-                stdio: ["pipe", "inherit", "inherit"],
+                stdin: "pipe",
+                stdout: "inherit",
+                stderr: "inherit",
+                reject: false,
             });
-            if (result.error)
-                throw result.error;
-            return result.status ?? (result.signal ? 1 : 0);
+            return result.exitCode ?? (result.signal ? 1 : 0);
         }
         if (opts.hook === "post-merge") {
             try {

package/dist/commands/pr/integrate/cmd.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { mapBackendError } from "../../../cli/error-map.js";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { createCliEmitter } from "../../../cli/output.js";
-import { withDiagnosticContext } from "../../../shared/diagnostics.js";
+import { withDiagnosticContext } from "../../shared/diagnostics.js";
 import { CliError } from "../../../shared/errors.js";
 import { cleanupIntegratedBranch } from "./internal/cleanup.js";
 import { renderPostIntegrateBootstrapFailureGuidance, renderPostIntegrateBootstrapGuidance, shouldRecommendPostIntegrateBootstrap, } from "./internal/bootstrap-guidance.js";

package/dist/commands/pr/integrate/internal/prepare.js

@@ -4,7 +4,7 @@ import { resolveBaseBranch } from "@agentplaneorg/core";
 import { fileExists } from "../../../../cli/fs-utils.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { unknownEntityMessage, workflowModeMessage } from "../../../../cli/output.js";
-import { withDiagnosticContext } from "../../../../shared/diagnostics.js";
+import { withDiagnosticContext } from "../../../shared/diagnostics.js";
 import { CliError } from "../../../../shared/errors.js";
 import { ensureGitClean } from "../../../guard/index.js";
 import { gitDiffNames } from "../../../shared/git-diff.js";

package/dist/commands/pr/internal/auto-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/auto-commit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiCnE,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+CnB"}
+{"version":3,"file":"auto-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/auto-commit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA6BnE,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+CnB"}

package/dist/commands/pr/internal/auto-commit.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { extractTaskSuffix } from "@agentplaneorg/core";
+import { buildTaskArtifactRefreshCommitSubject } from "@agentplaneorg/core";
 import { buildGitCommitEnv, resolveCanonicalGitIdentity } from "../../guard/impl/env.js";
 import { toGitPath } from "../../shared/git-diff.js";
 import { execFileAsync, gitEnv } from "../../shared/git.js";
@@ -25,9 +25,6 @@ async function readCachedPaths(gitRoot) {
         .map((line) => line.trim())
         .filter((line) => line.length > 0);
 }
-function taskPrArtifactRefreshMessage(taskId) {
-    return `📝 ${extractTaskSuffix(taskId)} task: refresh PR artifacts`;
-}
 export async function maybeAutoCommitTaskPrArtifacts(opts) {
     if (opts.ctx.config.workflow_mode !== "branch_pr")
         return false;
@@ -53,7 +50,7 @@ export async function maybeAutoCommitTaskPrArtifacts(opts) {
     }
     await opts.ctx.git.stage(taskPacketPaths);
     await opts.ctx.git.commit({
-        message: taskPrArtifactRefreshMessage(opts.taskId),
+        message: buildTaskArtifactRefreshCommitSubject({ taskId: opts.taskId }),
         env: buildGitCommitEnv({
             taskId: opts.taskId,
             allowTasks: true,

package/dist/commands/pr/internal/gh-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gh-api.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/gh-api.ts"],"names":[],"mappings":"AAqBA,wBAAgB,KAAK,IAAI,MAAM,CAAC,UAAU,CAiBzC;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe3E;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAa7E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD"}
+{"version":3,"file":"gh-api.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/gh-api.ts"],"names":[],"mappings":"AAiBA,wBAAgB,KAAK,IAAI,MAAM,CAAC,UAAU,CAiBzC;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB3E;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB7E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/commands/pr/internal/gh-api.js

@@ -1,11 +1,9 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
+import { runProcess } from "@agentplaneorg/core";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { CliError } from "../../../shared/errors.js";
 import { isDotEnvLoadedKey } from "../../../shared/env.js";
 import { gitEnv } from "../../shared/git.js";
 import { normalizeGhTransportError, withGhTransportRetry } from "../../shared/gh-transport.js";
-const execFileAsyncRaw = promisify(execFile);
 function parseGithubRepoFromRemoteUrl(remoteUrl) {
     const trimmed = remoteUrl.trim();
     if (!trimmed)
@@ -41,12 +39,15 @@ export function ghEnv() {
     return env;
 }
 export async function resolveDefaultGithubRepo(cwd) {
-    const { stdout } = await execFileAsyncRaw("git", ["remote", "get-url", "origin"], {
+    const { stdout } = await runProcess({
+        command: "git",
+        args: ["remote", "get-url", "origin"],
         cwd,
         env: gitEnv(),
+        encoding: "utf8",
         maxBuffer: 10 * 1024 * 1024,
     });
-    const repo = parseGithubRepoFromRemoteUrl(stdout);
+    const repo = parseGithubRepoFromRemoteUrl(String(stdout));
     if (!repo) {
         throw new CliError({
             exitCode: exitCodeForError("E_VALIDATION"),
@@ -57,19 +58,25 @@ export async function resolveDefaultGithubRepo(cwd) {
     return repo;
 }
 export async function runGhApiJson(cwd, args) {
-    const { stdout } = await withGhTransportRetry(() => execFileAsyncRaw("gh", ["api", ...args], {
+    const { stdout } = await withGhTransportRetry(() => runProcess({
+        command: "gh",
+        args: ["api", ...args],
         cwd,
         env: ghEnv(),
+        encoding: "utf8",
         maxBuffer: 10 * 1024 * 1024,
     }), {
         label: `running gh api ${args[0] ?? ""}`,
     });
-    return JSON.parse(stdout);
+    return JSON.parse(String(stdout));
 }
 export async function runGhApiNoOutput(cwd, args) {
-    await withGhTransportRetry(() => execFileAsyncRaw("gh", ["api", ...args], {
+    await withGhTransportRetry(() => runProcess({
+        command: "gh",
+        args: ["api", ...args],
         cwd,
         env: ghEnv(),
+        encoding: "utf8",
         maxBuffer: 10 * 1024 * 1024,
     }), {
         label: `running gh api ${args[0] ?? ""}`,

package/dist/commands/pr/internal/sync-branch.d.ts

@@ -3,7 +3,6 @@ export type ResolvedPrSyncBranch = {
     source: "explicit" | "meta" | "current" | "none";
 };
 export declare function isUnknownRevisionError(err: unknown): boolean;
-export declare function taskPrArtifactRefreshMessage(taskId: string): string;
 export declare function resolveBranchHeadSha(opts: {
     gitRoot: string;
     branch: string;

package/dist/commands/pr/internal/sync-branch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-branch.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-branch.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAClD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAO5D;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAwBhE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAET"}
+{"version":3,"file":"sync-branch.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync-branch.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAClD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAO5D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAwBhE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAET"}

package/dist/commands/pr/internal/sync-branch.js

@@ -1,6 +1,6 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { extractTaskSuffix } from "@agentplaneorg/core";
+import { isTaskArtifactRefreshCommitSubject } from "@agentplaneorg/core";
 import { fileExists } from "../../../cli/fs-utils.js";
 import { execFileAsync, gitEnv } from "../../shared/git.js";
 import { gitBranchUpstream, gitCurrentBranch } from "../../shared/git-ops.js";
@@ -13,9 +13,6 @@ export function isUnknownRevisionError(err) {
         /bad revision/i.test(message) ||
         /ambiguous argument/i.test(message));
 }
-export function taskPrArtifactRefreshMessage(taskId) {
-    return `📝 ${extractTaskSuffix(taskId)} task: refresh PR artifacts`;
-}
 export async function resolveBranchHeadSha(opts) {
     try {
         const { stdout } = await execFileAsync("git", ["rev-parse", opts.branch], {
@@ -45,7 +42,7 @@ export async function resolveRenderableBranchHead(opts) {
         const subject = subjectStdout.trim();
         return {
             headSha: branchHeadSha,
-            artifactRefresh: subject === taskPrArtifactRefreshMessage(opts.taskId),
+            artifactRefresh: isTaskArtifactRefreshCommitSubject({ subject, taskId: opts.taskId }),
         };
     }
     catch {

package/dist/commands/pr/internal/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync.ts"],"names":[],"mappings":"AAYA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE7F,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAQtC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGb,MAAM,iBAAiB,CAAC;AAKzB,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+EnE,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GAAG,IAAI,CAAC,CAmDR;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC,CAkHD"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/pr/internal/sync.ts"],"names":[],"mappings":"AAaA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE7F,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAQtC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGb,MAAM,iBAAiB,CAAC;AAKzB,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+EnE,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GAAG,IAAI,CAAC,CAmDR;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC,CA+ID"}

package/dist/commands/pr/internal/sync.js

@@ -6,6 +6,7 @@ import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { fileExists } from "../../../cli/fs-utils.js";
 import { workflowModeMessage } from "../../../cli/output.js";
 import { CliError } from "../../../shared/errors.js";
+import { emitTraceEvent } from "../../../shared/trace-events.js";
 import { INCIDENTS_POLICY_PATH } from "../../incidents/shared.js";
 import { resolvePrArtifactHeadSha, parsePrMeta } from "../../shared/pr-meta.js";
 import { isTaskLocalOnlyAdvance } from "../../shared/task-local-freshness.js";
@@ -126,6 +127,11 @@ export async function syncPrArtifacts(opts) {
     try {
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        emitTraceEvent({
+            component: "pr-sync",
+            event: "sync_started",
+            details: { task_id: opts.taskId, mode: opts.mode, backend: ctx.backendId },
+        });
         const { task } = await loadBackendTask({
             ctx,
             cwd: opts.cwd,
@@ -203,9 +209,24 @@ export async function syncPrArtifacts(opts) {
                     author: opts.author,
                     remoteMode,
                 });
+                emitTraceEvent({
+                    component: "pr-sync",
+                    event: "sync_completed",
+                    details: {
+                        task_id: task.id,
+                        mode: opts.mode,
+                        branch,
+                        action: openOutcome?.action ?? null,
+                    },
+                });
                 return { meta, prDir, resolved, openOutcome };
             }
             const { meta } = await runPrUpdateSync(common);
+            emitTraceEvent({
+                component: "pr-sync",
+                event: "sync_completed",
+                details: { task_id: task.id, mode: opts.mode, branch, action: "updated" },
+            });
             return { meta, prDir, resolved };
         }
         finally {
@@ -216,6 +237,15 @@ export async function syncPrArtifacts(opts) {
         }
     }
     catch (err) {
+        emitTraceEvent({
+            component: "pr-sync",
+            event: "sync_failed",
+            details: {
+                task_id: opts.taskId,
+                mode: opts.mode,
+                error: err instanceof Error ? err.name : "UnknownError",
+            },
+        });
         if (err instanceof CliError)
             throw err;
         throw mapBackendError(err, { command: "pr sync", root: opts.rootOverride ?? null });

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

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/open.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAuDpF,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgElB"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/open.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAoKpF,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgElB"}

package/dist/commands/pr/open.js

@@ -18,6 +18,66 @@ function prOpenOutcomeDetails(meta, openOutcome) {
     }
     return "local PR artifacts synced; remote PR creation staged";
 }
+async function gitResolveBranchHead(gitRoot, branch) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", `refs/heads/${branch}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function gitResolveRemoteBranchHead(gitRoot, remoteTarget, branch) {
+    try {
+        const { stdout } = await execFileAsync("git", ["ls-remote", "--heads", remoteTarget, `refs/heads/${branch}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        const trimmed = stdout.trim();
+        if (!trimmed)
+            return null;
+        const [head] = trimmed.split(/\s+/, 1);
+        return head?.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function gitResolveRemotePushTarget(gitRoot, remote) {
+    try {
+        const { stdout } = await execFileAsync("git", ["remote", "get-url", "--push", remote], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : remote;
+    }
+    catch {
+        return remote;
+    }
+}
+async function gitSetBranchUpstream(opts) {
+    await execFileAsync("git", ["config", `branch.${opts.branch}.remote`, opts.remote], {
+        cwd: opts.gitRoot,
+        env: gitEnv(),
+    });
+    await execFileAsync("git", ["config", `branch.${opts.branch}.merge`, `refs/heads/${opts.remoteBranch}`], {
+        cwd: opts.gitRoot,
+        env: gitEnv(),
+    });
+}
+async function canReuseMatchingRemoteHead(opts) {
+    const remoteTarget = await gitResolveRemotePushTarget(opts.gitRoot, opts.remote);
+    const [localHead, remoteHead] = await Promise.all([
+        gitResolveBranchHead(opts.gitRoot, opts.branch),
+        gitResolveRemoteBranchHead(opts.gitRoot, remoteTarget, opts.remoteBranch),
+    ]);
+    return Boolean(localHead && remoteHead && localHead === remoteHead);
+}
 async function pushTaskBranchUpstreamIfConfigured(opts) {
     const upstream = await gitBranchUpstream(opts.gitRoot, opts.branch);
     const trimmed = upstream?.trim() ?? "";
@@ -34,10 +94,28 @@ async function pushTaskBranchUpstreamIfConfigured(opts) {
         catch {
             return false;
         }
-        await execFileAsync("git", ["push", "--no-verify", "-u", "origin", `HEAD:${opts.branch}`], {
-            cwd: opts.gitRoot,
-            env: gitEnv(),
-        });
+        try {
+            await execFileAsync("git", ["push", "--no-verify", "-u", "origin", `HEAD:${opts.branch}`], {
+                cwd: opts.gitRoot,
+                env: gitEnv(),
+            });
+        }
+        catch (err) {
+            const canReuseRemote = await canReuseMatchingRemoteHead({
+                gitRoot: opts.gitRoot,
+                branch: opts.branch,
+                remote: "origin",
+                remoteBranch: opts.branch,
+            });
+            if (!canReuseRemote)
+                throw err;
+            await gitSetBranchUpstream({
+                gitRoot: opts.gitRoot,
+                branch: opts.branch,
+                remote: "origin",
+                remoteBranch: opts.branch,
+            });
+        }
         return true;
     }
     const slashIndex = trimmed.indexOf("/");
@@ -47,10 +125,22 @@ async function pushTaskBranchUpstreamIfConfigured(opts) {
     const upstreamBranch = trimmed.slice(slashIndex + 1);
     if (!remote || !upstreamBranch)
         return false;
-    await execFileAsync("git", ["push", "--no-verify", remote, `HEAD:${upstreamBranch}`], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-    });
+    try {
+        await execFileAsync("git", ["push", "--no-verify", remote, `HEAD:${upstreamBranch}`], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+    }
+    catch (err) {
+        const canReuseRemote = await canReuseMatchingRemoteHead({
+            gitRoot: opts.gitRoot,
+            branch: opts.branch,
+            remote,
+            remoteBranch: upstreamBranch,
+        });
+        if (!canReuseRemote)
+            throw err;
+    }
     return true;
 }
 export async function cmdPrOpen(opts) {

package/dist/commands/recipes/impl/resolver.js

@@ -3,7 +3,7 @@ import { readScenarioDefinition, } from "@agentplaneorg/recipes";
 import { fileExists } from "../../../cli/fs-utils.js";
 import { getVersion } from "../../../meta/version.js";
 import { dedupeStrings } from "../../../shared/strings.js";
-import { compareVersions } from "../../../shared/version-compare.js";
+import { compareVersions } from "../../../runtime/shared/version-compare.js";
 import { resolveProjectRecipesDir, resolveProjectInstalledRecipeDir } from "./paths.js";
 import { readProjectInstalledRecipes } from "./project-installed-recipes.js";
 const SUPPORTED_MANIFEST_API_VERSION = "1";

package/dist/commands/recipes/impl/version.js

@@ -1,4 +1,4 @@
-import { compareVersions } from "../../../shared/version-compare.js";
+import { compareVersions } from "../../../runtime/shared/version-compare.js";
 export function compareRecipeVersions(left, right) {
     return compareVersions(left, right);
 }

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

@@ -1,7 +1,7 @@
 import { loadConfig, resolveBaseBranch } from "@agentplaneorg/core";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { usageError } from "../../cli/spec/errors.js";
-import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
 import { CliError } from "../../shared/errors.js";
 import { gitCurrentBranch } from "../shared/git-ops.js";
 import { runReleaseCommandPipeline } from "./apply.pipeline.js";

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

@@ -1,6 +1,7 @@
 export declare function replacePackageVersionInFile(pkgJsonPath: string, nextVersion: string): Promise<void>;
 export declare function replaceAgentplanePackageMetadata(pkgJsonPath: string, nextVersion: string): Promise<void>;
 export declare function replacePackageDependencyVersion(pkgJsonPath: string, dependencyName: string, nextVersion: string): Promise<void>;
+export declare function packageDependencyExists(pkgJsonPath: string, dependencyName: string): Promise<boolean>;
 export declare function maybeUpdateBunLockfile(gitRoot: string, fileExists: (p: string) => Promise<boolean>): Promise<void>;
 export declare function maybeRefreshGeneratedReference(gitRoot: string, fileExists: (p: string) => Promise<boolean>): Promise<boolean>;
 export declare function maybePersistExpectedCliVersion(agentplaneDir: string, nextVersion: string): Promise<boolean>;

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,CAqCf;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAcf;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"}
+{"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,CAqCf;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAKlB;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

@@ -48,7 +48,7 @@ export async function replaceAgentplanePackageMetadata(pkgJsonPath, nextVersion)
 }
 export async function replacePackageDependencyVersion(pkgJsonPath, dependencyName, nextVersion) {
     const text = await readFile(pkgJsonPath, "utf8");
-    const pattern = new RegExp(`("${dependencyName.replace("/", "\\/")}"\\s*:\\s*")[^"]*(")`, "u");
+    const pattern = new RegExp(String.raw `("${dependencyName.replace("/", String.raw `\/`)}"\s*:\s*")[^"]*(")`, "u");
     const replaced = text.replace(pattern, `$1${nextVersion}$2`);
     if (replaced === text) {
         throw new CliError({
@@ -60,6 +60,10 @@ export async function replacePackageDependencyVersion(pkgJsonPath, dependencyNam
     }
     await writeFile(pkgJsonPath, replaced, "utf8");
 }
+export async function packageDependencyExists(pkgJsonPath, dependencyName) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    return typeof raw.dependencies?.[dependencyName] === "string";
+}
 export async function maybeUpdateBunLockfile(gitRoot, fileExists) {
     const bunLockPath = path.join(gitRoot, "bun.lock");
     const rootPkgPath = path.join(gitRoot, "package.json");

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

@@ -0,0 +1,21 @@
+import type { ReleaseApplyParsed, ReleaseCommandMutation, ReleaseCommandState, ReleaseVersionPlan } from "../apply.types.js";
+export declare function finalizeReleaseApply(opts: {
+    gitRoot: string;
+    planDir: string;
+    notesPath: string;
+    plan: ReleaseVersionPlan;
+    npmVersionChecked: boolean;
+    releaseCommit: {
+        hash: string;
+        subject: string;
+    } | null;
+    route: ReleaseCommandState["route"];
+    push: boolean;
+    remote: string;
+}): Promise<number>;
+export declare function runReleaseCommandFinalize(opts: {
+    state: ReleaseCommandState;
+    mutation: ReleaseCommandMutation;
+    flags: ReleaseApplyParsed;
+}): Promise<number>;
+//# sourceMappingURL=finalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../src/commands/release/apply.pipeline/finalize.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAG3B,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiElB;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB"}

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

@@ -0,0 +1,80 @@
+import path from "node:path";
+import { execFileAsync, gitEnv } from "../../shared/git.js";
+import { pushReleaseCandidateBranch, pushReleaseRefs, writeReleaseApplyReport, } from "../apply.reporting.js";
+import { emitReleaseLine } from "./shared.js";
+export 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;
+}
+export 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,
+    });
+}

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

@@ -0,0 +1,18 @@
+import { GitContext } from "../../shared/git-context.js";
+import type { ReleaseCommandMutation, ReleaseCommandState } from "../apply.types.js";
+export declare function applyReleaseMutation(opts: {
+    agentplaneDir: string;
+    gitRoot: string;
+    git: GitContext;
+    notesPath: string;
+    corePkgPath: string;
+    agentplanePkgPath: string;
+    recipesPkgPath: string;
+    testkitPkgPath: string;
+    nextTag: string;
+    nextVersion: string;
+    route: ReleaseCommandState["route"];
+    taskBranchPrefix: string;
+}): Promise<ReleaseCommandMutation>;
+export declare function runReleaseCommandExecute(state: ReleaseCommandState): Promise<ReleaseCommandMutation>;
+//# sourceMappingURL=mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../../../src/commands/release/apply.pipeline/mutation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAazD,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA6DlC;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC"}