agentplane 0.3.22 → 0.3.24

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

@@ -1,30 +1,5 @@
-import type { PlanChange, ReleaseVersionPlan } from "./apply.types.js";
-export declare function fileExists(p: string): Promise<boolean>;
-export declare function readJsonFile<T>(p: string): Promise<T>;
-export declare function parseVersionPlan(raw: unknown): ReleaseVersionPlan;
-export declare function findLatestPlanDir(gitRoot: string): Promise<string>;
-export declare function readPackageVersion(pkgJsonPath: string): Promise<string>;
-export declare function readCoreDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readRecipesDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string>;
-export declare function readOptionalAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string | null>;
-export declare function validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
-type ReleaseCommandLabel = "release apply" | "release candidate";
-export declare function ensureCleanTrackedTree(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureTagDoesNotExist(gitRoot: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureRemoteExists(gitRoot: string, remote: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function runReleasePrepublishGate(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
-export declare function loadReleasePlan(opts: {
-    gitRoot: string;
-    planOverride?: string;
-}): Promise<{
-    planDir: string;
-    versionJsonPath: string;
-    plan: ReleaseVersionPlan;
-    changes: PlanChange[];
-    minBullets: number;
-}>;
-export {};
+export { fileExists, findLatestPlanDir, loadReleasePlan, parseVersionPlan, readJsonFile, } from "./apply.preflight.plan.js";
+export { readAgentplaneDependencyVersion, readCoreDependencyVersion, readOptionalAgentplaneDependencyVersion, readPackageVersion, readRecipesDependencyVersion, validateReleaseNotes, } from "./apply.preflight.package.js";
+export { ensureCleanTrackedTree, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, releasePushDescription, type ReleaseCommandLabel, } from "./apply.preflight.git.js";
+export { ensureNpmVersionsAvailable, runReleasePrepublishGate } from "./apply.preflight.publish.js";
 //# sourceMappingURL=apply.preflight.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3D;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAuBjE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxE;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAoBD,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF;AAED,wBAAsB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,wBAAsB,uCAAuC,CAC3D,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,KAAK,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAQjE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAmCf;AAgBD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAwBD"}
+{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,uCAAuC,EACvC,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

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

@@ -0,0 +1,7 @@
+export type ReleaseCommandLabel = "release apply" | "release candidate";
+export declare function releasePushDescription(commandLabel: ReleaseCommandLabel): string;
+export declare function ensureCleanTrackedTree(gitRoot: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureTagDoesNotExist(gitRoot: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteExists(gitRoot: string, remote: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string, commandLabel?: ReleaseCommandLabel): Promise<void>;
+//# sourceMappingURL=apply.preflight.git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.git.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.git.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,mBAAmB,GAAG,MAAM,CAIhF;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,mBAAqC,GAClD,OAAO,CAAC,IAAI,CAAC,CAyDf"}

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

@@ -0,0 +1,138 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { withDiagnosticContext } from "../shared/diagnostics.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { gitEnv } from "@agentplaneorg/core/git";
+export function releasePushDescription(commandLabel) {
+    return commandLabel === "release candidate"
+        ? "preparing or pushing the release candidate branch"
+        : "pushing the release tag";
+}
+export async function ensureCleanTrackedTree(gitRoot, commandLabel = "release apply") {
+    const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const dirty = String(stdout ?? "")
+        .split(/\r?\n/u)
+        .map((line) => line.trimEnd())
+        .filter((line) => line.length > 0);
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `${commandLabel} requires a clean tracked working tree.\n` +
+            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
+        context: withDiagnosticContext({ command: commandLabel }, {
+            state: `${commandLabel} cannot start from a dirty tracked tree`,
+            likelyCause: "the release flow needs to create one deterministic version-bump commit and tag, but tracked edits already exist in the workspace",
+            nextAction: {
+                command: "git status --short --untracked-files=no",
+                reason: `inspect or clear tracked changes before rerunning \`agentplane ${commandLabel}\``,
+                reasonCode: "release_dirty_tree",
+            },
+        }),
+    });
+}
+export async function ensureTagDoesNotExist(gitRoot, tag, commandLabel = "release apply") {
+    try {
+        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Tag already exists: ${tag}`,
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: "the target release tag already exists locally",
+                likelyCause: "the release version was already applied earlier, or a previous release attempt created the tag before failing later in the flow",
+                nextAction: {
+                    command: `git show --stat --oneline ${tag}`,
+                    reason: "inspect the existing tag before deciding whether to reuse it or plan a new version",
+                    reasonCode: "release_tag_exists",
+                },
+            }),
+        });
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code !== 1)
+            throw err;
+    }
+}
+export async function ensureRemoteExists(gitRoot, remote, commandLabel = "release apply") {
+    try {
+        await execFileAsync("git", ["remote", "get-url", remote], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+    }
+    catch (err) {
+        const details = String(err?.stderr ??
+            err?.message ??
+            "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Git remote is not configured: ${remote}` + (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: "the configured release remote does not exist locally",
+                likelyCause: "release apply was asked to push, but the selected git remote is missing or misconfigured in this checkout",
+                nextAction: {
+                    command: "git remote -v",
+                    reason: `inspect configured remotes before rerunning ${commandLabel} with --push`,
+                    reasonCode: "release_remote_missing",
+                },
+            }),
+        });
+    }
+}
+export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag, commandLabel = "release apply") {
+    let stdout = "";
+    try {
+        const out = await execFileAsync("git", ["ls-remote", "--tags", remote, `refs/tags/${tag}`], {
+            cwd: gitRoot,
+            env: gitEnv(),
+        });
+        stdout = String(out.stdout ?? "").trim();
+    }
+    catch (err) {
+        const details = String(err?.stderr ??
+            err?.message ??
+            "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_GIT"),
+            code: "E_GIT",
+            message: `Failed to inspect remote tag state for ${remote}/${tag}.` +
+                (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: commandLabel }, {
+                state: `${commandLabel} could not verify the remote tag state`,
+                likelyCause: "the remote is configured, but git could not query it for the target release tag before the release started",
+                nextAction: {
+                    command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
+                    reason: "inspect remote tag visibility before retrying the release push path",
+                    reasonCode: "release_remote_tag_check_failed",
+                },
+            }),
+        });
+    }
+    if (!stdout)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `Remote tag already exists: ${remote}/${tag}`,
+        context: withDiagnosticContext({ command: commandLabel }, {
+            state: "the target release tag already exists on the remote",
+            likelyCause: "a previous release or partial push already published this tag upstream, so pushing the same version again would drift the local release state",
+            nextAction: {
+                command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
+                reason: "inspect the existing remote tag before deciding whether to recover or bump to a new version",
+                reasonCode: "release_remote_tag_exists",
+            },
+        }),
+    });
+}

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

@@ -1,368 +1,4 @@
-import { readFile, readdir } from "node:fs/promises";
-import path from "node:path";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { withDiagnosticContext } from "../shared/diagnostics.js";
-import { CliError } from "../../shared/errors.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { gitEnv } from "@agentplaneorg/core/git";
-export async function fileExists(p) {
-    try {
-        await readFile(p, "utf8");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function readJsonFile(p) {
-    return JSON.parse(await readFile(p, "utf8"));
-}
-function assertNonEmptyString(value, label) {
-    if (typeof value !== "string" || !value.trim()) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Invalid ${label} (expected non-empty string).`,
-        });
-    }
-    return value.trim();
-}
-export function parseVersionPlan(raw) {
-    if (!raw || typeof raw !== "object") {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: "Invalid version.json (expected object).",
-        });
-    }
-    const obj = raw;
-    const bumpRaw = assertNonEmptyString(obj.bump, "bump");
-    if (bumpRaw !== "patch" && bumpRaw !== "minor" && bumpRaw !== "major") {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Invalid bump in version.json: ${bumpRaw}`,
-        });
-    }
-    const prevTagVal = obj.prevTag;
-    const prevTag = prevTagVal === null ? null : typeof prevTagVal === "string" ? prevTagVal : null;
-    const prevVersion = assertNonEmptyString(obj.prevVersion, "prevVersion");
-    const nextTag = assertNonEmptyString(obj.nextTag, "nextTag");
-    const nextVersion = assertNonEmptyString(obj.nextVersion, "nextVersion");
-    return { prevTag, prevVersion, nextTag, nextVersion, bump: bumpRaw };
-}
-export async function findLatestPlanDir(gitRoot) {
-    const base = path.join(gitRoot, ".agentplane", ".release", "plan");
-    const runNames = await readdir(base);
-    const runs = runNames
-        .map((s) => s.trim())
-        .filter(Boolean)
-        .toSorted();
-    const latest = runs.at(-1);
-    if (!latest) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_IO"),
-            code: "E_IO",
-            message: "No release plan runs found under .agentplane/.release/plan/. Run `agentplane release plan` first.",
-        });
-    }
-    return path.join(base, latest);
-}
-export async function readPackageVersion(pkgJsonPath) {
-    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-    const version = typeof raw.version === "string" ? raw.version.trim() : "";
-    if (!version) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Missing package.json version: ${pkgJsonPath}`,
-        });
-    }
-    return version;
-}
-async function readDependencyVersion(pkgJsonPath, dependencyName) {
-    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-    const value = raw.dependencies?.[dependencyName];
-    const version = typeof value === "string" ? value.trim() : "";
-    if (!version) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Missing dependency ${dependencyName} in ${pkgJsonPath}. ` +
-                `Release parity requires packages/agentplane to pin ${dependencyName} to the same version.`,
-        });
-    }
-    return version;
-}
-export async function readCoreDependencyVersion(pkgJsonPath) {
-    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/core");
-}
-export async function readRecipesDependencyVersion(pkgJsonPath) {
-    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/recipes");
-}
-export async function readAgentplaneDependencyVersion(pkgJsonPath) {
-    return await readDependencyVersion(pkgJsonPath, "agentplane");
-}
-export async function readOptionalAgentplaneDependencyVersion(pkgJsonPath) {
-    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-    const value = raw.dependencies?.agentplane;
-    const version = typeof value === "string" ? value.trim() : "";
-    return version || null;
-}
-export async function validateReleaseNotes(notesPath, minBullets) {
-    const content = await readFile(notesPath, "utf8");
-    if (!/release\s+notes/i.test(content)) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Release notes must include a "Release Notes" heading in ${notesPath}.`,
-        });
-    }
-    const bulletCount = content.split(/\r?\n/u).filter((line) => /^\s*[-*]\s+\S+/u.test(line)).length;
-    if (bulletCount < minBullets) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Release notes must include at least ${minBullets} bullet points in ${notesPath}.`,
-        });
-    }
-    if (/[\u0400-\u04FF]/u.test(content)) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Release notes must be written in English (no Cyrillic) in ${notesPath}.`,
-        });
-    }
-}
-function releasePushDescription(commandLabel) {
-    return commandLabel === "release candidate"
-        ? "preparing or pushing the release candidate branch"
-        : "pushing the release tag";
-}
-export async function ensureCleanTrackedTree(gitRoot, commandLabel = "release apply") {
-    const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
-        cwd: gitRoot,
-        env: gitEnv(),
-        maxBuffer: 10 * 1024 * 1024,
-    });
-    const dirty = String(stdout ?? "")
-        .split(/\r?\n/u)
-        .map((line) => line.trimEnd())
-        .filter((line) => line.length > 0);
-    if (dirty.length === 0)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: `${commandLabel} requires a clean tracked working tree.\n` +
-            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
-        context: withDiagnosticContext({ command: commandLabel }, {
-            state: `${commandLabel} cannot start from a dirty tracked tree`,
-            likelyCause: "the release flow needs to create one deterministic version-bump commit and tag, but tracked edits already exist in the workspace",
-            nextAction: {
-                command: "git status --short --untracked-files=no",
-                reason: `inspect or clear tracked changes before rerunning \`agentplane ${commandLabel}\``,
-                reasonCode: "release_dirty_tree",
-            },
-        }),
-    });
-}
-export async function ensureTagDoesNotExist(gitRoot, tag, commandLabel = "release apply") {
-    try {
-        await execFileAsync("git", ["rev-parse", "-q", "--verify", `refs/tags/${tag}`], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `Tag already exists: ${tag}`,
-            context: withDiagnosticContext({ command: commandLabel }, {
-                state: "the target release tag already exists locally",
-                likelyCause: "the release version was already applied earlier, or a previous release attempt created the tag before failing later in the flow",
-                nextAction: {
-                    command: `git show --stat --oneline ${tag}`,
-                    reason: "inspect the existing tag before deciding whether to reuse it or plan a new version",
-                    reasonCode: "release_tag_exists",
-                },
-            }),
-        });
-    }
-    catch (err) {
-        const code = err?.code;
-        if (code !== 1)
-            throw err;
-    }
-}
-export async function ensureRemoteExists(gitRoot, remote, commandLabel = "release apply") {
-    try {
-        await execFileAsync("git", ["remote", "get-url", remote], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-    }
-    catch (err) {
-        const details = String(err?.stderr ??
-            err?.message ??
-            "").trim();
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `Git remote is not configured: ${remote}` + (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: commandLabel }, {
-                state: "the configured release remote does not exist locally",
-                likelyCause: "release apply was asked to push, but the selected git remote is missing or misconfigured in this checkout",
-                nextAction: {
-                    command: "git remote -v",
-                    reason: `inspect configured remotes before rerunning ${commandLabel} with --push`,
-                    reasonCode: "release_remote_missing",
-                },
-            }),
-        });
-    }
-}
-export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag, commandLabel = "release apply") {
-    let stdout = "";
-    try {
-        const out = await execFileAsync("git", ["ls-remote", "--tags", remote, `refs/tags/${tag}`], {
-            cwd: gitRoot,
-            env: gitEnv(),
-        });
-        stdout = String(out.stdout ?? "").trim();
-    }
-    catch (err) {
-        const details = String(err?.stderr ??
-            err?.message ??
-            "").trim();
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: `Failed to inspect remote tag state for ${remote}/${tag}.` +
-                (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: commandLabel }, {
-                state: `${commandLabel} could not verify the remote tag state`,
-                likelyCause: "the remote is configured, but git could not query it for the target release tag before the release started",
-                nextAction: {
-                    command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
-                    reason: "inspect remote tag visibility before retrying the release push path",
-                    reasonCode: "release_remote_tag_check_failed",
-                },
-            }),
-        });
-    }
-    if (!stdout)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: `Remote tag already exists: ${remote}/${tag}`,
-        context: withDiagnosticContext({ command: commandLabel }, {
-            state: "the target release tag already exists on the remote",
-            likelyCause: "a previous release or partial push already published this tag upstream, so pushing the same version again would drift the local release state",
-            nextAction: {
-                command: `git ls-remote --tags ${remote} refs/tags/${tag}`,
-                reason: "inspect the existing remote tag before deciding whether to recover or bump to a new version",
-                reasonCode: "release_remote_tag_exists",
-            },
-        }),
-    });
-}
-export async function ensureNpmVersionsAvailable(gitRoot, version, commandLabel = "release apply") {
-    const scriptPath = path.join(gitRoot, "scripts", "check-npm-version-availability.mjs");
-    try {
-        await execFileAsync("node", [scriptPath, "--version", version], {
-            cwd: gitRoot,
-            env: process.env,
-            maxBuffer: 10 * 1024 * 1024,
-        });
-    }
-    catch (err) {
-        const details = String(err?.stderr ?? "").trim();
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: `Pre-publish npm check failed for version ${version}. ` +
-                "Ensure this version is not already published for @agentplaneorg/core and agentplane." +
-                (details ? `\n\n${details}` : ""),
-            context: withDiagnosticContext({ command: commandLabel }, {
-                state: "the target npm version is not publishable",
-                likelyCause: "that version is already burned in npm history for one of the published packages, even if it is no longer the current dist-tag",
-                nextAction: {
-                    command: `node scripts/check-npm-version-availability.mjs --version ${version}`,
-                    reason: "inspect which package already consumed the target version before choosing a new release number",
-                    reasonCode: "release_npm_version_burned",
-                },
-            }),
-        });
-    }
-}
-async function runReleasePrepublishPhase(gitRoot, phase) {
-    await execFileAsync("bun", ["run", `release:prepublish:${phase}`], {
-        cwd: gitRoot,
-        env: {
-            ...process.env,
-            GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "agentplane-release",
-            GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "agentplane-release@example.com",
-            GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? "agentplane-release",
-            GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? "agentplane-release@example.com",
-        },
-        maxBuffer: 200 * 1024 * 1024,
-    });
-}
-export async function runReleasePrepublishGate(gitRoot, commandLabel = "release apply") {
-    for (const phase of ["fast", "heavy"]) {
-        try {
-            await runReleasePrepublishPhase(gitRoot, phase);
-        }
-        catch (err) {
-            const details = String(err?.stderr ??
-                err?.stdout ??
-                err?.message ??
-                "").trim();
-            throw new CliError({
-                exitCode: exitCodeForError("E_VALIDATION"),
-                code: "E_VALIDATION",
-                message: `Release prepublish ${phase} phase failed. \`agentplane ${commandLabel} --push\` requires a successful local \`bun run release:prepublish:${phase}\` run before ${releasePushDescription(commandLabel)}.` +
-                    (details ? `\n\n${details}` : ""),
-                context: withDiagnosticContext({ command: commandLabel }, {
-                    state: `release prepublish ${phase} validation failed before ${releasePushDescription(commandLabel)}`,
-                    likelyCause: phase === "fast"
-                        ? "a lightweight publish-readiness check rejected the current release payload before the expensive validation route started"
-                        : "the expensive release validation route rejected the current repository state after the fast publish-readiness checks passed",
-                    nextAction: {
-                        command: `bun run release:prepublish:${phase}`,
-                        reason: phase === "fast"
-                            ? `rerun the fast prepublish phase to fix the exact payload or packaging problem before retrying ${commandLabel}`
-                            : `rerun the heavy prepublish phase to inspect and fix the expensive validation failure before retrying ${commandLabel}`,
-                        reasonCode: `release_prepublish_${phase}_failed`,
-                    },
-                }),
-            });
-        }
-    }
-}
-export async function loadReleasePlan(opts) {
-    const planDir = opts.planOverride
-        ? path.resolve(opts.gitRoot, opts.planOverride)
-        : await findLatestPlanDir(opts.gitRoot);
-    const versionJsonPath = path.join(planDir, "version.json");
-    if (!(await fileExists(versionJsonPath))) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_IO"),
-            code: "E_IO",
-            message: `Missing version.json in plan dir: ${path.relative(opts.gitRoot, versionJsonPath)}`,
-        });
-    }
-    const plan = parseVersionPlan(await readJsonFile(versionJsonPath));
-    const changesJsonPath = path.join(planDir, "changes.json");
-    const changes = (await fileExists(changesJsonPath))
-        ? await readJsonFile(changesJsonPath)
-        : [];
-    return {
-        planDir,
-        versionJsonPath,
-        plan,
-        changes,
-        minBullets: Math.max(1, Array.isArray(changes) ? changes.length : 0),
-    };
-}
+export { fileExists, findLatestPlanDir, loadReleasePlan, parseVersionPlan, readJsonFile, } from "./apply.preflight.plan.js";
+export { readAgentplaneDependencyVersion, readCoreDependencyVersion, readOptionalAgentplaneDependencyVersion, readPackageVersion, readRecipesDependencyVersion, validateReleaseNotes, } from "./apply.preflight.package.js";
+export { ensureCleanTrackedTree, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, releasePushDescription, } from "./apply.preflight.git.js";
+export { ensureNpmVersionsAvailable, runReleasePrepublishGate } from "./apply.preflight.publish.js";

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

@@ -0,0 +1,7 @@
+export declare function readPackageVersion(pkgJsonPath: string): Promise<string>;
+export declare function readCoreDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readRecipesDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string>;
+export declare function readOptionalAgentplaneDependencyVersion(pkgJsonPath: string): Promise<string | null>;
+export declare function validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
+//# sourceMappingURL=apply.preflight.package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.package.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.package.ts"],"names":[],"mappings":"AAKA,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAoBD,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF;AAED,wBAAsB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvF;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,wBAAsB,uCAAuC,CAC3D,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F"}

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

@@ -0,0 +1,69 @@
+import { readFile } from "node:fs/promises";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+export async function readPackageVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const version = typeof raw.version === "string" ? raw.version.trim() : "";
+    if (!version) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing package.json version: ${pkgJsonPath}`,
+        });
+    }
+    return version;
+}
+async function readDependencyVersion(pkgJsonPath, dependencyName) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const value = raw.dependencies?.[dependencyName];
+    const version = typeof value === "string" ? value.trim() : "";
+    if (!version) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing dependency ${dependencyName} in ${pkgJsonPath}. ` +
+                `Release parity requires packages/agentplane to pin ${dependencyName} to the same version.`,
+        });
+    }
+    return version;
+}
+export async function readCoreDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/core");
+}
+export async function readRecipesDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "@agentplaneorg/recipes");
+}
+export async function readAgentplaneDependencyVersion(pkgJsonPath) {
+    return await readDependencyVersion(pkgJsonPath, "agentplane");
+}
+export async function readOptionalAgentplaneDependencyVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const value = raw.dependencies?.agentplane;
+    const version = typeof value === "string" ? value.trim() : "";
+    return version || null;
+}
+export async function validateReleaseNotes(notesPath, minBullets) {
+    const content = await readFile(notesPath, "utf8");
+    if (!/release\s+notes/i.test(content)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must include a "Release Notes" heading in ${notesPath}.`,
+        });
+    }
+    const bulletCount = content.split(/\r?\n/u).filter((line) => /^\s*[-*]\s+\S+/u.test(line)).length;
+    if (bulletCount < minBullets) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must include at least ${minBullets} bullet points in ${notesPath}.`,
+        });
+    }
+    if (/[\u0400-\u04FF]/u.test(content)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Release notes must be written in English (no Cyrillic) in ${notesPath}.`,
+        });
+    }
+}