agentplane 0.3.12 → 0.3.14

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

@@ -35,7 +35,30 @@ export async function replaceAgentplanePackageMetadata(pkgJsonPath, nextVersion)
                 "Ensure packages/agentplane/package.json declares this dependency.",
         });
     }
-    await writeFile(pkgJsonPath, withDependency, "utf8");
+    const withRecipesDependency = withDependency.replace(/("@agentplaneorg\/recipes"\s*:\s*")[^"]*(")/u, `$1${nextVersion}$2`);
+    if (withRecipesDependency === withDependency) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update @agentplaneorg/recipes dependency in ${pkgJsonPath}. ` +
+                "Ensure packages/agentplane/package.json declares this dependency.",
+        });
+    }
+    await writeFile(pkgJsonPath, withRecipesDependency, "utf8");
+}
+export async function replacePackageDependencyVersion(pkgJsonPath, dependencyName, nextVersion) {
+    const text = await readFile(pkgJsonPath, "utf8");
+    const pattern = new RegExp(`("${dependencyName.replace("/", "\\/")}"\\s*:\\s*")[^"]*(")`, "u");
+    const replaced = text.replace(pattern, `$1${nextVersion}$2`);
+    if (replaced === text) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Failed to update ${dependencyName} dependency in ${pkgJsonPath}. ` +
+                "Ensure the package.json declares this dependency.",
+        });
+    }
+    await writeFile(pkgJsonPath, replaced, "utf8");
 }
 export async function maybeUpdateBunLockfile(gitRoot, fileExists) {
     const bunLockPath = path.join(gitRoot, "bun.lock");

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

@@ -0,0 +1,22 @@
+import { type ResolvedProject } from "@agentplaneorg/core";
+import type { CommandSpec } from "../../cli/spec/spec.js";
+import type { ReleaseApplyParsed, ReleaseCommandRouteResolver } from "./apply.types.js";
+export declare function runReleaseCommandPipeline(opts: {
+    ctx: {
+        cwd: string;
+        rootOverride?: string | null;
+    };
+    flags: ReleaseApplyParsed;
+    spec: CommandSpec<ReleaseApplyParsed>;
+    commandLabel: string;
+    routeResolver: ReleaseCommandRouteResolver;
+}): Promise<number>;
+export type ReleaseApplyRouteResolverArgs = {
+    cwd: string;
+    rootOverride?: string | null;
+    gitRoot: string;
+    agentplaneDir: string;
+};
+export type ReleaseApplyResolvedProject = ResolvedProject;
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";
+//# sourceMappingURL=apply.pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.pipeline.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAsC1D,OAAO,KAAK,EACV,kBAAkB,EAIlB,2BAA2B,EAG5B,MAAM,kBAAkB,CAAC;AAgc1B,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlB;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,371 @@
+import path from "node:path";
+import { extractTaskSuffix, loadConfig, resolveProject, } from "@agentplaneorg/core";
+import { createCliEmitter, emitCommandResult } from "../../cli/output.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { usageError } from "../../cli/spec/errors.js";
+import { withDiagnosticContext } from "../../shared/diagnostics.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { GitContext } from "../shared/git-context.js";
+import { ensureActionApproved } from "../shared/approval-requirements.js";
+import { ensureNetworkApproved } from "../shared/network-approval.js";
+import { runOperatorPipeline } from "../shared/operator-pipeline.js";
+import { parseTaskIdFromBranch } from "../shared/git-worktree.js";
+import { cleanHookEnv, maybePersistExpectedCliVersion, maybeRefreshGeneratedReference, maybeUpdateBunLockfile, replaceAgentplanePackageMetadata, replacePackageDependencyVersion, replacePackageVersionInFile, } from "./apply.mutation.js";
+import { ensureCleanTrackedTree, ensureNpmVersionsAvailable, ensureRemoteExists, ensureRemoteTagDoesNotExist, ensureTagDoesNotExist, fileExists, loadReleasePlan, readAgentplaneDependencyVersion, readCoreDependencyVersion, readPackageVersion, readRecipesDependencyVersion, runReleasePrepublishGate, validateReleaseNotes, } from "./apply.preflight.js";
+import { pushReleaseCandidateBranch, pushReleaseRefs, writeReleaseApplyReport, } from "./apply.reporting.js";
+const output = createCliEmitter();
+function emitReleaseLine(text) {
+    emitCommandResult(output, { kind: "line", text });
+}
+async function resolveReleasePlanInputs(opts) {
+    const { planDir, plan, minBullets } = await loadReleasePlan({
+        gitRoot: opts.gitRoot,
+        planOverride: opts.planOverride,
+    });
+    if (!/^v\d+\.\d+\.\d+$/u.test(plan.nextTag)) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Invalid nextTag in version.json (expected vX.Y.Z): ${plan.nextTag}`,
+        });
+    }
+    const notesPath = path.join(opts.gitRoot, "docs", "releases", `${plan.nextTag}.md`);
+    if (!(await fileExists(notesPath))) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Missing release notes: ${path.relative(opts.gitRoot, notesPath)}\n` +
+                "Write this file using a DOCS agent before applying the release.",
+        });
+    }
+    await validateReleaseNotes(notesPath, minBullets);
+    return { planDir, plan, notesPath };
+}
+async function ensureReleasePlanMatchesRepoState(opts) {
+    const [coreVersion, agentplaneVersion, recipesVersion, coreDependencyVersion, recipesDependencyVersion,] = await Promise.all([
+        readPackageVersion(opts.corePkgPath),
+        readPackageVersion(opts.agentplanePkgPath),
+        readPackageVersion(opts.recipesPkgPath),
+        readCoreDependencyVersion(opts.agentplanePkgPath),
+        readRecipesDependencyVersion(opts.agentplanePkgPath),
+    ]);
+    if (coreVersion !== agentplaneVersion || coreVersion !== recipesVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Package versions must match before applying a release. ` +
+                `packages/core=${coreVersion} packages/agentplane=${agentplaneVersion} packages/recipes=${recipesVersion}`,
+        });
+    }
+    if (coreDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/core=${coreDependencyVersion} ` +
+                `must match packages/core version ${coreVersion}.`,
+        });
+    }
+    if (recipesDependencyVersion !== coreVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: "Release dependency parity check failed before apply. " +
+                `packages/agentplane dependency @agentplaneorg/recipes=${recipesDependencyVersion} ` +
+                `must match packages/recipes version ${coreVersion}.`,
+        });
+    }
+    if (await fileExists(opts.testkitPkgPath)) {
+        const testkitAgentplaneDependencyVersion = await readAgentplaneDependencyVersion(opts.testkitPkgPath);
+        if (testkitAgentplaneDependencyVersion !== agentplaneVersion) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message: "Release dependency parity check failed before apply. " +
+                    `packages/testkit dependency agentplane=${testkitAgentplaneDependencyVersion} ` +
+                    `must match packages/agentplane version ${agentplaneVersion}.`,
+            });
+        }
+    }
+    await ensureCleanTrackedTree(opts.gitRoot);
+    await ensureTagDoesNotExist(opts.gitRoot, opts.plan.nextTag);
+    if (coreVersion !== opts.plan.prevVersion) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_VALIDATION"),
+            code: "E_VALIDATION",
+            message: `Current version does not match the release-plan baseline. ` +
+                `current=${coreVersion} expected_prev=${opts.plan.prevVersion} expected_next=${opts.plan.nextVersion}\n` +
+                "Re-run `agentplane release plan` to generate a fresh plan for this repo state.",
+            context: withDiagnosticContext({ command: "release apply" }, {
+                state: "the repository version no longer matches the prepared release-plan baseline",
+                likelyCause: "package versions changed after the plan was generated, so continuing would apply the release over a partially drifted local state",
+                nextAction: {
+                    command: "agentplane release plan",
+                    reason: "generate a fresh release plan from the current repository state before applying the release",
+                    reasonCode: "release_plan_drifted",
+                },
+            }),
+        });
+    }
+}
+async function runPushPreflight(opts) {
+    const loaded = await loadConfig(opts.agentplaneDir);
+    const pushReason = opts.route.kind === "release_candidate"
+        ? `${opts.commandLabel} will push current branch ${opts.route.current_branch} to ${opts.remote} as a release candidate for ${opts.nextTag}; final publication remains gated on merge to ${opts.route.base_branch}`
+        : `${opts.commandLabel} will push HEAD and ${opts.nextTag} to ${opts.remote}`;
+    await ensureNetworkApproved({
+        action: opts.route.kind === "release_candidate" ? "release_candidate" : "release_apply",
+        config: loaded.config,
+        yes: opts.yes,
+        reason: `${opts.commandLabel} validates npm version availability and pushes over network`,
+        interactive: Boolean(process.stdin.isTTY),
+    });
+    await ensureActionApproved({
+        action: "git_push",
+        config: loaded.config,
+        yes: opts.yes,
+        reason: pushReason,
+        interactive: Boolean(process.stdin.isTTY),
+    });
+    await ensureRemoteExists(opts.gitRoot, opts.remote);
+    await ensureRemoteTagDoesNotExist(opts.gitRoot, opts.remote, opts.nextTag);
+    await ensureNpmVersionsAvailable(opts.gitRoot, opts.nextVersion);
+    await runReleasePrepublishGate(opts.gitRoot);
+    return true;
+}
+async function applyReleaseMutation(opts) {
+    let releaseCommit = null;
+    await Promise.all([
+        replacePackageVersionInFile(opts.corePkgPath, opts.nextVersion),
+        replacePackageVersionInFile(opts.recipesPkgPath, opts.nextVersion),
+        replaceAgentplanePackageMetadata(opts.agentplanePkgPath, opts.nextVersion),
+    ]);
+    if (await fileExists(opts.testkitPkgPath)) {
+        await replacePackageDependencyVersion(opts.testkitPkgPath, "agentplane", opts.nextVersion);
+    }
+    const expectedCliVersionPersisted = await maybePersistExpectedCliVersion(opts.agentplaneDir, opts.nextVersion);
+    await maybeUpdateBunLockfile(opts.gitRoot, fileExists);
+    const generatedReferenceExists = await maybeRefreshGeneratedReference(opts.gitRoot, fileExists);
+    const stagePaths = [
+        "packages/core/package.json",
+        "packages/agentplane/package.json",
+        "packages/recipes/package.json",
+        path.relative(opts.gitRoot, opts.notesPath),
+    ];
+    if (await fileExists(opts.testkitPkgPath)) {
+        stagePaths.push("packages/testkit/package.json");
+    }
+    if (expectedCliVersionPersisted) {
+        stagePaths.push(".agentplane/config.json");
+    }
+    if (generatedReferenceExists) {
+        stagePaths.push("docs/reference/generated-reference.mdx");
+    }
+    if (await fileExists(path.join(opts.gitRoot, "bun.lock"))) {
+        stagePaths.push("bun.lock");
+    }
+    await opts.git.stage(stagePaths);
+    const staged = await opts.git.statusStagedPaths();
+    if (staged.length === 0) {
+        emitReleaseLine("No changes to commit.");
+        return { releaseCommit };
+    }
+    const taskId = opts.route.kind === "release_candidate"
+        ? parseTaskIdFromBranch(opts.taskBranchPrefix, opts.route.current_branch)
+        : null;
+    const subject = taskId
+        ? `✨ ${extractTaskSuffix(taskId)} release: publish ${opts.nextTag}`
+        : `✨ release: publish ${opts.nextTag}`;
+    await opts.git.commit({ message: subject, env: cleanHookEnv() });
+    const { stdout: headHash } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+        cwd: opts.gitRoot,
+        env: gitEnv(),
+    });
+    releaseCommit = { hash: String(headHash ?? "").trim(), subject };
+    return { releaseCommit };
+}
+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;
+}
+async function buildReleaseCommandState(opts) {
+    const resolved = await resolveProject({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const gitRoot = resolved.gitRoot;
+    const { planDir, plan, notesPath } = await resolveReleasePlanInputs({
+        gitRoot,
+        planOverride: opts.planOverride,
+    });
+    const loaded = await loadConfig(resolved.agentplaneDir);
+    return {
+        resolved,
+        gitRoot,
+        planDir,
+        plan,
+        notesPath,
+        taskBranchPrefix: loaded.config.branch.task_prefix,
+        route: await opts.routeResolver({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            gitRoot,
+            agentplaneDir: resolved.agentplaneDir,
+        }),
+        corePkgPath: path.join(gitRoot, "packages", "core", "package.json"),
+        agentplanePkgPath: path.join(gitRoot, "packages", "agentplane", "package.json"),
+        recipesPkgPath: path.join(gitRoot, "packages", "recipes", "package.json"),
+        testkitPkgPath: path.join(gitRoot, "packages", "testkit", "package.json"),
+        npmVersionChecked: false,
+    };
+}
+function assertReleaseBumpApproved(opts) {
+    if ((opts.plan.bump === "minor" || opts.plan.bump === "major") && opts.flags.yes !== true) {
+        throw usageError({
+            spec: opts.spec,
+            command: opts.commandLabel,
+            message: `Bump '${opts.plan.bump}' requires explicit approval. Re-run with --yes.`,
+        });
+    }
+}
+async function runReleaseCommandPreflight(opts) {
+    assertReleaseBumpApproved({
+        flags: opts.flags,
+        plan: opts.state.plan,
+        spec: opts.spec,
+        commandLabel: opts.commandLabel,
+    });
+    await ensureReleasePlanMatchesRepoState({
+        gitRoot: opts.state.gitRoot,
+        plan: opts.state.plan,
+        corePkgPath: opts.state.corePkgPath,
+        agentplanePkgPath: opts.state.agentplanePkgPath,
+        recipesPkgPath: opts.state.recipesPkgPath,
+        testkitPkgPath: opts.state.testkitPkgPath,
+    });
+    if (opts.flags.push) {
+        opts.state.npmVersionChecked = await runPushPreflight({
+            agentplaneDir: opts.state.resolved.agentplaneDir,
+            gitRoot: opts.state.gitRoot,
+            remote: opts.flags.remote,
+            nextTag: opts.state.plan.nextTag,
+            nextVersion: opts.state.plan.nextVersion,
+            route: opts.state.route,
+            yes: opts.flags.yes,
+            commandLabel: `${opts.commandLabel} --push`,
+        });
+    }
+}
+async function runReleaseCommandExecute(state) {
+    const git = new GitContext({ gitRoot: state.gitRoot });
+    return await applyReleaseMutation({
+        agentplaneDir: state.resolved.agentplaneDir,
+        gitRoot: state.gitRoot,
+        git,
+        notesPath: state.notesPath,
+        corePkgPath: state.corePkgPath,
+        agentplanePkgPath: state.agentplanePkgPath,
+        recipesPkgPath: state.recipesPkgPath,
+        testkitPkgPath: state.testkitPkgPath,
+        nextTag: state.plan.nextTag,
+        nextVersion: state.plan.nextVersion,
+        route: state.route,
+        taskBranchPrefix: state.taskBranchPrefix,
+    });
+}
+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,
+    });
+}
+export async function runReleaseCommandPipeline(opts) {
+    return await runOperatorPipeline({
+        init: async () => await buildReleaseCommandState({
+            cwd: opts.ctx.cwd,
+            rootOverride: opts.ctx.rootOverride ?? null,
+            planOverride: opts.flags.plan,
+            routeResolver: opts.routeResolver,
+        }),
+        preflight: async (state) => await runReleaseCommandPreflight({
+            state,
+            flags: opts.flags,
+            spec: opts.spec,
+            commandLabel: opts.commandLabel,
+        }),
+        execute: async (state) => await runReleaseCommandExecute(state),
+        finalize: async (state, mutation) => await runReleaseCommandFinalize({
+            state,
+            mutation,
+            flags: opts.flags,
+        }),
+    });
+}
+export { pushReleaseCandidateBranch, pushReleaseRefs } from "./apply.reporting.js";

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

@@ -5,6 +5,8 @@ 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 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>;

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

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

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

@@ -79,20 +79,29 @@ export async function readPackageVersion(pkgJsonPath) {
     }
     return version;
 }
-export async function readCoreDependencyVersion(pkgJsonPath) {
+async function readDependencyVersion(pkgJsonPath, dependencyName) {
     const raw = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-    const value = raw.dependencies?.["@agentplaneorg/core"];
+    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 @agentplaneorg/core in ${pkgJsonPath}. ` +
-                "Release parity requires packages/agentplane to pin @agentplaneorg/core to the same version.",
+            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 validateReleaseNotes(notesPath, minBullets) {
     const content = await readFile(notesPath, "utf8");
     if (!/release\s+notes/i.test(content)) {

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

@@ -1,3 +1,4 @@
+import type { ResolvedProject } from "@agentplaneorg/core";
 export type BumpKind = "patch" | "minor" | "major";
 export type ReleaseApplyFlags = {
     plan?: string;
@@ -56,4 +57,30 @@ export type ReleaseApplyReport = {
         refs: string[];
     };
 };
+export type ReleaseCommandState = {
+    resolved: ResolvedProject;
+    gitRoot: string;
+    planDir: string;
+    plan: ReleaseVersionPlan;
+    notesPath: string;
+    taskBranchPrefix: string;
+    route: ReleaseApplyRoute;
+    corePkgPath: string;
+    agentplanePkgPath: string;
+    recipesPkgPath: string;
+    testkitPkgPath: string;
+    npmVersionChecked: boolean;
+};
+export type ReleaseCommandMutation = {
+    releaseCommit: {
+        hash: string;
+        subject: string;
+    } | null;
+};
+export type ReleaseCommandRouteResolver = (opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    gitRoot: string;
+    agentplaneDir: string;
+}) => Promise<ReleaseApplyRoute>;
 //# sourceMappingURL=apply.types.d.ts.map

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

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

package/dist/commands/release.test-helpers.d.ts

@@ -3,7 +3,9 @@ export declare function writeReleaseNotes(root: string, version: string, body?:
 export declare function seedReleaseWorkspace(root: string, opts?: {
     coreVersion?: string;
     cliVersion?: string;
+    recipesVersion?: string;
     dependencyVersion?: string;
+    recipesDependencyVersion?: string;
     extraDependencies?: Record<string, string>;
     extraWorkspacePackages?: {
         relDir: string;
@@ -19,7 +21,9 @@ export declare function initReleaseWorkspace(opts?: {
     prefix?: string;
     coreVersion?: string;
     cliVersion?: string;
+    recipesVersion?: string;
     dependencyVersion?: string;
+    recipesDependencyVersion?: string;
     extraDependencies?: Record<string, string>;
     extraWorkspacePackages?: {
         relDir: string;

package/dist/commands/release.test-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release.test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/release.test-helpers.ts"],"names":[],"mappings":"AAIA,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAIjB"}
+{"version":3,"file":"release.test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/release.test-helpers.ts"],"names":[],"mappings":"AAIA,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAc,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sBAAsB,CAAC,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/commands/release.test-helpers.js

@@ -14,9 +14,12 @@ export async function writeReleaseNotes(root, version, body = "# Notes\n") {
 export async function seedReleaseWorkspace(root, opts = {}) {
     const coreVersion = opts.coreVersion ?? "1.2.3";
     const cliVersion = opts.cliVersion ?? coreVersion;
+    const recipesVersion = opts.recipesVersion ?? cliVersion;
     const dependencyVersion = opts.dependencyVersion ?? coreVersion;
+    const recipesDependencyVersion = opts.recipesDependencyVersion ?? recipesVersion;
     const dependencies = {
         "@agentplaneorg/core": dependencyVersion,
+        "@agentplaneorg/recipes": recipesDependencyVersion,
     };
     if (opts.extraDependencies) {
         Object.assign(dependencies, opts.extraDependencies);
@@ -30,6 +33,10 @@ export async function seedReleaseWorkspace(root, opts = {}) {
         version: cliVersion,
         dependencies,
     });
+    await writePackageJson(root, "packages/recipes", {
+        name: "@agentplaneorg/recipes",
+        version: recipesVersion,
+    });
     for (const pkg of opts.extraWorkspacePackages ?? []) {
         await writePackageJson(root, pkg.relDir, {
             name: pkg.name,

package/dist/commands/scenario/execute.command.js

@@ -10,14 +10,14 @@ import { cmdTaskStartReady } from "../task/start-ready.js";
 import { CliError } from "../../shared/errors.js";
 const output = createCliEmitter();
 export const scenarioExecuteSpec = {
-    id: ["scenario", "execute"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "execute"],
+    group: "Recipes",
     summary: "Materialize a recipe-backed task and execute it through the shared runner flow.",
     description: "Resolves a recipe scenario, materializes a task from its explicit task_template, and executes the shared runner with recipe context bundled alongside the created task.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario execute viewer:demo",
+            cmd: "agentplane recipes scenario execute viewer:demo",
             why: "Create a task from the scenario template and execute it through the configured runner.",
         },
     ],
@@ -27,7 +27,7 @@ export const scenarioExecuteSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioExecuteSpec,
-                command: "scenario execute",
+                command: "recipes scenario execute",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/impl/commands.js

@@ -187,7 +187,7 @@ export async function cmdScenarioListParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario list", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario list", root: opts.rootOverride ?? null });
     }
 }
 export async function cmdScenarioInfoParsed(opts) {
@@ -225,7 +225,7 @@ export async function cmdScenarioInfoParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario info", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario info", root: opts.rootOverride ?? null });
     }
 }
 export async function executeRecipeTool(opts) {
@@ -297,13 +297,13 @@ export async function cmdScenarioRunParsed(opts) {
             ...validationChecks,
         ]);
         output.line("Status: preview only; no task created and no runner executed.");
-        output.line(`Next: use \`agentplane scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
+        output.line(`Next: use \`agentplane recipes scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
             "to materialize and run this scenario.");
         return 0;
     }
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario run", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario run", root: opts.rootOverride ?? null });
     }
 }