agentplane 0.3.2 → 0.3.3

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

@@ -0,0 +1,107 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig, saveConfig, setByDottedKey } from "@agentplaneorg/core";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+export async function replacePackageVersionInFile(pkgJsonPath, nextVersion) {
+    const text = await readFile(pkgJsonPath, "utf8");
+    const replaced = text.replace(/"version"\s*:\s*"[^"]*"/u, `"version": "${nextVersion}"`);
+    if (replaced === text) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update version in ${pkgJsonPath} (missing "version" field).`,
+        });
+    }
+    await writeFile(pkgJsonPath, replaced, "utf8");
+}
+export async function replaceAgentplanePackageMetadata(pkgJsonPath, nextVersion) {
+    const text = await readFile(pkgJsonPath, "utf8");
+    const withVersion = text.replace(/"version"\s*:\s*"[^"]*"/u, `"version": "${nextVersion}"`);
+    if (withVersion === text) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update version in ${pkgJsonPath} (missing "version" field).`,
+        });
+    }
+    const withDependency = withVersion.replace(/("@agentplaneorg\/core"\s*:\s*")[^"]*(")/u, `$1${nextVersion}$2`);
+    if (withDependency === withVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update @agentplaneorg/core dependency in ${pkgJsonPath}. ` +
+                "Ensure packages/agentplane/package.json declares this dependency.",
+        });
+    }
+    await writeFile(pkgJsonPath, withDependency, "utf8");
+}
+export async function maybeUpdateBunLockfile(gitRoot, fileExists) {
+    const bunLockPath = path.join(gitRoot, "bun.lock");
+    const rootPkgPath = path.join(gitRoot, "package.json");
+    if (!(await fileExists(bunLockPath)))
+        return;
+    if (!(await fileExists(rootPkgPath)))
+        return;
+    try {
+        await execFileAsync("bun", ["install", "--ignore-scripts"], {
+            cwd: gitRoot,
+            env: process.env,
+            maxBuffer: 50 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const e = err;
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: "Failed to update bun.lock via `bun install --ignore-scripts`.\n" +
+                "Fix:\n" +
+                "  1) Run `bun install --ignore-scripts` manually\n" +
+                "  2) Re-run `agentplane release apply`\n" +
+                (e?.message ? `\nDetails:\n${e.message}` : ""),
+        });
+    }
+}
+export async function maybeRefreshGeneratedReference(gitRoot, fileExists) {
+    const scriptPath = path.join(gitRoot, "scripts", "generate-website-docs.mjs");
+    if (!(await fileExists(scriptPath)))
+        return false;
+    try {
+        await execFileAsync("node", [scriptPath], {
+            cwd: gitRoot,
+            env: process.env,
+            maxBuffer: 20 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const e = err;
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: "Failed to refresh docs/reference/generated-reference.mdx after bumping release versions.\n" +
+                "Fix:\n" +
+                "  1) Run `node scripts/generate-website-docs.mjs`\n" +
+                "  2) Re-run `agentplane release apply`\n" +
+                (e?.message ? `\nDetails:\n${e.message}` : ""),
+        });
+    }
+    return await fileExists(path.join(gitRoot, "docs", "reference", "generated-reference.mdx"));
+}
+export async function maybePersistExpectedCliVersion(agentplaneDir, nextVersion) {
+    const loaded = await loadConfig(agentplaneDir);
+    if (!loaded.exists)
+        return false;
+    const raw = { ...loaded.raw };
+    setByDottedKey(raw, "framework.cli.expected_version", nextVersion);
+    await saveConfig(agentplaneDir, raw);
+    return true;
+}
+export function cleanHookEnv() {
+    const env = { ...gitEnv() };
+    delete env.AGENTPLANE_TASK_ID;
+    delete env.AGENTPLANE_STATUS_TO;
+    delete env.AGENTPLANE_AGENT_ID;
+    return env;
+}

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

@@ -0,0 +1,25 @@
+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 validateReleaseNotes(notesPath: string, minBullets: number): Promise<void>;
+export declare function ensureCleanTrackedTree(gitRoot: string): Promise<void>;
+export declare function ensureTagDoesNotExist(gitRoot: string, tag: string): Promise<void>;
+export declare function ensureRemoteExists(gitRoot: string, remote: string): Promise<void>;
+export declare function ensureRemoteTagDoesNotExist(gitRoot: string, remote: string, tag: string): Promise<void>;
+export declare function ensureNpmVersionsAvailable(gitRoot: string, version: string): Promise<void>;
+export declare function runReleasePrepublishGate(gitRoot: string): Promise<void>;
+export declare function loadReleasePlan(opts: {
+    gitRoot: string;
+    planOverride?: string;
+}): Promise<{
+    planDir: string;
+    versionJsonPath: string;
+    plan: ReleaseVersionPlan;
+    changes: PlanChange[];
+    minBullets: number;
+}>;
+//# sourceMappingURL=apply.preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.preflight.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.preflight.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3D;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAuBjE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBxE;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBpF;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChG;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAwBD"}

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

@@ -0,0 +1,338 @@
+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, gitEnv } from "../shared/git.js";
+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;
+}
+export async function readCoreDependencyVersion(pkgJsonPath) {
+    const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const value = raw.dependencies?.["@agentplaneorg/core"];
+    const version = typeof value === "string" ? value.trim() : "";
+    if (!version) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Missing dependency @agentplaneorg/core in ${pkgJsonPath}. ` +
+                "Release parity requires packages/agentplane to pin @agentplaneorg/core to the same version.",
+        });
+    }
+    return version;
+}
+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}.`,
+        });
+    }
+}
+export async function ensureCleanTrackedTree(gitRoot) {
+    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: "Release apply requires a clean tracked working tree.\n" +
+            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
+        context: withDiagnosticContext({ command: "release apply" }, {
+            state: "release apply cannot start from a dirty tracked tree",
+            likelyCause: "the release flow needs to create one deterministic version-bump commit and tag, but tracked edits already exist in the workspace",
+            nextAction: {
+                command: "git status --short --untracked-files=no",
+                reason: "inspect or clear tracked changes before rerunning `agentplane release apply --push --yes`",
+                reasonCode: "release_dirty_tree",
+            },
+        }),
+    });
+}
+export async function ensureTagDoesNotExist(gitRoot, tag) {
+    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: "release apply" }, {
+                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) {
+    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: "release apply" }, {
+                state: "the configured release remote does not exist locally",
+                likelyCause: "release apply was asked to push, but the selected git remote is missing or misconfigured in this checkout",
+                nextAction: {
+                    command: "git remote -v",
+                    reason: "inspect configured remotes before rerunning release apply with --push",
+                    reasonCode: "release_remote_missing",
+                },
+            }),
+        });
+    }
+}
+export async function ensureRemoteTagDoesNotExist(gitRoot, remote, tag) {
+    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: "release apply" }, {
+                state: "release apply 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: "release apply" }, {
+            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) {
+    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: "release apply" }, {
+                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",
+                },
+            }),
+        });
+    }
+}
+export async function runReleasePrepublishGate(gitRoot) {
+    try {
+        await execFileAsync("bun", ["run", "release:prepublish"], {
+            cwd: gitRoot,
+            env: {
+                ...process.env,
+                GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "agentplane-release",
+                GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "agentplane-release@example.com",
+                GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME ?? "agentplane-release",
+                GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL ?? "agentplane-release@example.com",
+            },
+            maxBuffer: 200 * 1024 * 1024,
+        });
+    }
+    catch (err) {
+        const details = String(err?.stderr ??
+            err?.stdout ??
+            err?.message ??
+            "").trim();
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release prepublish gate failed. `agentplane release apply --push` requires a successful local `bun run release:prepublish` run before pushing the release tag." +
+                (details ? `\n\n${details}` : ""),
+            context: withDiagnosticContext({ command: "release apply" }, {
+                state: "release prepublish validation failed before pushing the release",
+                likelyCause: "one of the local publish gates rejected the current repository state, so the release cannot be pushed safely yet",
+                nextAction: {
+                    command: "bun run release:prepublish",
+                    reason: "rerun the exact local publish gate and fix the reported failure before retrying release apply",
+                    reasonCode: "release_prepublish_failed",
+                },
+            }),
+        });
+    }
+}
+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),
+    };
+}

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

@@ -0,0 +1,4 @@
+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>;
+//# sourceMappingURL=apply.reporting.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+export async function writeReleaseApplyReport(gitRoot, report) {
+    const runId = new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");
+    const dir = path.join(gitRoot, ".agentplane", ".release", "apply");
+    await mkdir(dir, { recursive: true });
+    const reportPath = path.join(dir, `${runId}.json`);
+    const latestPath = path.join(dir, "latest.json");
+    const text = `${JSON.stringify(report, null, 2)}\n`;
+    await writeFile(reportPath, text, "utf8");
+    await writeFile(latestPath, text, "utf8");
+    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(),
+    });
+}

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

@@ -0,0 +1,46 @@
+export type BumpKind = "patch" | "minor" | "major";
+export type ReleaseApplyFlags = {
+    plan?: string;
+    yes: boolean;
+    push: boolean;
+    remote: string;
+};
+export type ReleaseApplyParsed = ReleaseApplyFlags;
+export type ReleaseVersionPlan = {
+    prevTag: string | null;
+    prevVersion: string;
+    nextTag: string;
+    nextVersion: string;
+    bump: BumpKind;
+};
+export type PlanChange = {
+    hash: string;
+    authorDateIso: string;
+    subject: string;
+};
+export type ReleaseApplyReport = {
+    applied_at: string;
+    plan_dir: string;
+    notes_path: string;
+    prev_version: string;
+    next_version: string;
+    prev_tag: string | null;
+    next_tag: string;
+    bump: BumpKind;
+    checks: {
+        clean_tracked_tree: true;
+        tag_absent: true;
+        notes_validated: true;
+        npm_version_available_checked: boolean;
+    };
+    commit: {
+        hash: string;
+        subject: string;
+    } | null;
+    push: {
+        requested: boolean;
+        remote: string;
+        performed: boolean;
+    };
+};
+//# sourceMappingURL=apply.types.d.ts.map

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

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

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,28 @@
+import type { CommandHandler, CommandSpec } from "../cli/spec/spec.js";
+import { type RepoCliVersionExpectation } from "../shared/repo-cli-version.js";
+import { type RuntimeSourceInfo } from "../shared/runtime-source.js";
+export type FrameworkDevWorkflow = {
+    available: boolean;
+    rebuildCommands: string[];
+    reinstallScript: string;
+    verifyCommand: string;
+    forceGlobalExample: string;
+    recommendation: string | null;
+};
+export type RuntimeExplainPayload = RuntimeSourceInfo & {
+    frameworkDev: FrameworkDevWorkflow;
+    repoCliExpectation: RepoCliVersionExpectation;
+};
+export type RuntimeGroupParsed = {
+    cmd: string[];
+};
+export type RuntimeExplainParsed = {
+    json: boolean;
+};
+export declare const runtimeSpec: CommandSpec<RuntimeGroupParsed>;
+export declare const runtimeExplainSpec: CommandSpec<RuntimeExplainParsed>;
+export declare function buildFrameworkDevWorkflow(report: RuntimeSourceInfo): FrameworkDevWorkflow;
+export declare function renderRuntimeExplainText(report: RuntimeSourceInfo, repoCliExpectation: RepoCliVersionExpectation): string;
+export declare const runRuntime: CommandHandler<RuntimeGroupParsed>;
+export declare const runRuntimeExplain: CommandHandler<RuntimeExplainParsed>;
+//# sourceMappingURL=runtime.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.command.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,CAsCzF;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,kBAAkB,EAAE,yBAAyB,GAC5C,MAAM,CA2CR;AAyBD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAazD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CAkBlE,CAAC"}