agentplane 0.3.13 → 0.3.15

package/dist/commands/pr/open.js

@@ -4,7 +4,7 @@ import { exitCodeForError } from "../../cli/exit-codes.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { execFileAsync, gitEnv } from "../shared/git.js";
-import { gitBranchUpstream } from "../shared/git-ops.js";
+import { gitBranchUpstream, gitCurrentBranch } from "../shared/git-ops.js";
 import { loadCommandContext } from "../shared/task-backend.js";
 import { maybeAutoCommitTaskPrArtifacts } from "./internal/auto-commit.js";
 import { syncPrArtifacts } from "./internal/sync.js";
@@ -21,8 +21,25 @@ function prOpenOutcomeDetails(meta, openOutcome) {
 async function pushTaskBranchUpstreamIfConfigured(opts) {
     const upstream = await gitBranchUpstream(opts.gitRoot, opts.branch);
     const trimmed = upstream?.trim() ?? "";
-    if (!trimmed)
-        return false;
+    if (!trimmed) {
+        const currentBranch = await gitCurrentBranch(opts.gitRoot).catch(() => "");
+        if (currentBranch.trim() !== opts.branch.trim())
+            return false;
+        try {
+            await execFileAsync("git", ["remote", "get-url", "origin"], {
+                cwd: opts.gitRoot,
+                env: gitEnv(),
+            });
+        }
+        catch {
+            return false;
+        }
+        await execFileAsync("git", ["push", "--no-verify", "-u", "origin", `HEAD:${opts.branch}`], {
+            cwd: opts.gitRoot,
+            env: gitEnv(),
+        });
+        return true;
+    }
     const slashIndex = trimmed.indexOf("/");
     if (slashIndex <= 0 || slashIndex === trimmed.length - 1)
         return false;
@@ -59,14 +76,14 @@ export async function cmdPrOpen(opts) {
             branch: opts.branch,
             remoteMode: "sync-only",
         });
-        const didAutoCommit = initialSync.meta.branch
-            ? await maybeAutoCommitTaskPrArtifacts({
+        if (initialSync.meta.branch) {
+            await maybeAutoCommitTaskPrArtifacts({
                 ctx: commandCtx,
                 taskId: opts.taskId,
                 branch: initialSync.meta.branch,
-            })
-            : false;
-        if (didAutoCommit && !opts.syncOnly && initialSync.meta.branch) {
+            });
+        }
+        if (!opts.syncOnly && initialSync.meta.branch) {
             await pushTaskBranchUpstreamIfConfigured({
                 gitRoot: commandCtx.resolvedProject.gitRoot,
                 branch: initialSync.meta.branch,

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

@@ -1 +1 @@
-{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/pr.command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/pr.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/pr/pr.command.js

@@ -34,7 +34,7 @@ export const prSpec = {
 export const prOpenSpec = {
     id: ["pr", "open"],
     group: "PR",
-    summary: "Create PR artifacts for a task.",
+    summary: "Create PR artifacts for a task and, unless --sync-only is set, publish/link the remote GitHub PR.",
     args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
     options: [
         {
@@ -57,7 +57,12 @@ export const prOpenSpec = {
             description: "Only write local PR artifacts; do not create a remote GitHub PR.",
         },
     ],
-    examples: [{ cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER", why: "Open." }],
+    examples: [
+        {
+            cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER",
+            why: "Sync local artifacts, publish the task branch to origin if needed, and create/link the GitHub PR.",
+        },
+    ],
     validateRaw: (raw) => {
         const author = typeof raw.opts.author === "string" ? raw.opts.author.trim() : "";
         if (!author) {

package/dist/commands/recipes/impl/apply.d.ts

@@ -1,4 +1,4 @@
-import type { RecipeConflictMode, RecipeManifest } from "./types.js";
+import { type RecipeConflictMode, type RecipeManifest } from "@agentplaneorg/recipes";
 export declare function moveRecipeDir(opts: {
     from: string;
     to: string;

package/dist/commands/recipes/impl/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/apply.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF;AAyBD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/apply.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAWhC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF;AAyBD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}

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

@@ -1,5 +1,6 @@
 import { cp, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { normalizeAgentId, readScenarioDefinition, } from "@agentplaneorg/recipes";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { fileExists, getPathKind } from "../../../cli/fs-utils.js";
 import { invalidFieldMessage, missingFileMessage } from "../../../cli/output.js";
@@ -7,8 +8,6 @@ import { CliError } from "../../../shared/errors.js";
 import { isRecord } from "../../../shared/guards.js";
 import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
 import { RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME } from "./constants.js";
-import { readScenarioDefinition } from "./scenario.js";
-import { normalizeAgentId } from "./normalize.js";
 export async function moveRecipeDir(opts) {
     await mkdir(path.dirname(opts.to), { recursive: true });
     try {

package/dist/commands/recipes/impl/commands/active.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"active.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/active.ts"],"names":[],"mappings":"AASA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ClB"}
+{"version":3,"file":"active.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/active.ts"],"names":[],"mappings":"AAWA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB"}

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

@@ -1,9 +1,10 @@
 import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
-import { emptyStateMessage } from "../../../../cli/output.js";
+import { createCliEmitter, emptyStateMessage } from "../../../../cli/output.js";
 import { CliError } from "../../../../shared/errors.js";
 import { readActiveRecipeIds } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+const output = createCliEmitter();
 export async function cmdRecipeActiveParsed(opts) {
     try {
         const project = await resolveProject({
@@ -18,11 +19,11 @@ export async function cmdRecipeActiveParsed(opts) {
             .map((id) => installed.recipes.find((entry) => entry.id === id))
             .filter(Boolean);
         if (active.length === 0) {
-            process.stdout.write(`${emptyStateMessage("active overlays")}\n`);
+            output.line(emptyStateMessage("active overlays"));
             return 0;
         }
         if (opts.full) {
-            process.stdout.write(`${JSON.stringify({
+            output.json({
                 schema_version: 1,
                 active: active.map((entry) => ({
                     id: entry.id,
@@ -30,11 +31,11 @@ export async function cmdRecipeActiveParsed(opts) {
                     kind: entry.manifest.kind,
                     summary: entry.manifest.summary,
                 })),
-            }, null, 2)}\n`);
+            });
             return 0;
         }
         for (const entry of active) {
-            process.stdout.write(`${entry.id}@${entry.version} [${entry.manifest.kind}]\n`);
+            output.line(`${entry.id}@${entry.version} [${entry.manifest.kind}]`);
         }
         return 0;
     }

package/dist/commands/recipes/impl/commands/add.d.ts

@@ -3,5 +3,6 @@ export declare function cmdRecipeAddParsed(opts: {
     rootOverride?: string;
     recipeRef: string;
     mode?: "copy" | "link";
+    activate?: boolean;
 }): Promise<number>;
 //# sourceMappingURL=add.d.ts.map

package/dist/commands/recipes/impl/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/add.ts"],"names":[],"mappings":"AAqCA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFlB"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/add.ts"],"names":[],"mappings":"AAuCA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFlB"}

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

@@ -1,13 +1,15 @@
 import { cp, mkdir, rm, symlink } from "node:fs/promises";
+import { normalizeRecipeTags } from "@agentplaneorg/recipes";
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
-import { refreshProjectOverlayArtifacts } from "../overlay-project.js";
+import { runVendoredRecipeMutation } from "../mutation-transaction.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
 import { readInstalledRecipesFile } from "../installed-recipes.js";
-import { normalizeRecipeTags } from "../normalize.js";
 import { hashRecipeTree } from "../project-recipe-state.js";
-import { readProjectRecipesRegistry, upsertProjectRecipeRegistryEntry, } from "../project-registry.js";
+import { readProjectRecipesRegistry, replaceProjectRecipeRegistryEntry, } from "../project-registry.js";
+import { pickLatestRecipeVersion } from "../version.js";
 import { resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectRecipesPackagesDir, resolveProjectVendoredRecipeDir, } from "../paths.js";
 function parseRecipeRef(raw) {
     const value = raw.trim();
@@ -32,12 +34,10 @@ export async function cmdRecipeAddParsed(opts) {
         const loaded = await loadConfig(project.agentplaneDir);
         const requested = parseRecipeRef(opts.recipeRef);
         const cache = await readInstalledRecipesFile(resolveInstalledRecipesPath());
-        const cachedEntries = cache.recipes
-            .filter((entry) => entry.id === requested.id)
-            .toSorted((left, right) => left.version.localeCompare(right.version));
+        const cachedEntries = cache.recipes.filter((entry) => entry.id === requested.id);
         const cached = requested.version
             ? cachedEntries.find((entry) => entry.version === requested.version)
-            : cachedEntries.at(-1);
+            : pickLatestRecipeVersion(cachedEntries);
         if (!cached) {
             throw new CliError({
                 exitCode: exitCodeForError("E_IO"),
@@ -61,31 +61,36 @@ export async function cmdRecipeAddParsed(opts) {
                     : `Recipe already vendored: ${cached.id}@${existing.version}. Remove it first or use a dedicated update flow instead of overwriting it with recipes add.`,
             });
         }
-        await mkdir(resolveProjectRecipesPackagesDir(project), { recursive: true });
-        await rm(targetDir, { recursive: true, force: true });
-        await (materialization === "link"
-            ? symlink(sourceDir, targetDir, "dir")
-            : cp(sourceDir, targetDir, { recursive: true }));
         const installedAt = new Date().toISOString();
         const tags = normalizeRecipeTags(cached.tags ?? cached.manifest.tags ?? []);
         const sourceSha256 = await hashRecipeTree(sourceDir);
-        const vendoredSha256 = await hashRecipeTree(targetDir);
-        await upsertProjectRecipeRegistryEntry({
-            project,
-            entry: {
-                id: cached.id,
-                version: cached.version,
-                path: `packages/${cached.id}`,
-                active: false,
-                materialization,
-                source_ref: `${cached.id}@${cached.version}`,
-                source_sha256: sourceSha256,
-                vendored_sha256: vendoredSha256,
-                installed_at: installedAt,
-                tags,
+        await mkdir(resolveProjectRecipesPackagesDir(project), { recursive: true });
+        await runVendoredRecipeMutation({
+            targetDir,
+            mode: "create",
+            materialize: async (nextTargetDir) => {
+                await rm(nextTargetDir, { recursive: true, force: true });
+                await (materialization === "link"
+                    ? symlink(sourceDir, nextTargetDir, "dir")
+                    : cp(sourceDir, nextTargetDir, { recursive: true }));
+            },
+            commit: async () => {
+                const vendoredSha256 = await hashRecipeTree(targetDir);
+                const nextRegistry = replaceProjectRecipeRegistryEntry(registry, {
+                    id: cached.id,
+                    version: cached.version,
+                    path: `packages/${cached.id}`,
+                    active: opts.activate === true,
+                    materialization,
+                    source_ref: `${cached.id}@${cached.version}`,
+                    source_sha256: sourceSha256,
+                    vendored_sha256: vendoredSha256,
+                    installed_at: installedAt,
+                    tags,
+                });
+                await publishProjectRecipesState({ project, registry: nextRegistry });
             },
         });
-        await refreshProjectOverlayArtifacts(project);
         process.stdout.write(`Vendored recipe ${cached.id}@${cached.version} into project (${materialization})\n`);
         if (materialization === "link") {
             process.stdout.write("Warning: link mode is not portable; use `agentplane recipes detach` before sharing the repo.\n");

package/dist/commands/recipes/impl/commands/detach.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/detach.ts"],"names":[],"mappings":"AAgBA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ElB"}
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/detach.ts"],"names":[],"mappings":"AAoBA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA2FlB"}

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

@@ -1,14 +1,15 @@
-import { cp, rm } from "node:fs/promises";
+import { cp } from "node:fs/promises";
+import { normalizeRecipeTags } from "@agentplaneorg/recipes";
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
 import { ensureActionApproved } from "../../../shared/approval-requirements.js";
 import { readInstalledRecipesFile } from "../installed-recipes.js";
-import { normalizeRecipeTags } from "../normalize.js";
-import { readActiveRecipeIds, refreshProjectOverlayArtifacts } from "../overlay-project.js";
+import { runVendoredRecipeMutation } from "../mutation-transaction.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
 import { hashRecipeTree, inspectProjectRecipe } from "../project-recipe-state.js";
-import { upsertProjectRecipeRegistryEntry } from "../project-registry.js";
+import { readProjectRecipesRegistry, replaceProjectRecipeRegistryEntry, } from "../project-registry.js";
 import { resolveInstalledRecipesPath, resolveProjectVendoredRecipeDir } from "../paths.js";
 export async function cmdRecipeDetachParsed(opts) {
     try {
@@ -32,6 +33,14 @@ export async function cmdRecipeDetachParsed(opts) {
                 message: `Cached source is missing for ${inspection.entry.id}@${inspection.entry.version}. Re-install it before detaching.`,
             });
         }
+        const currentSourceSha256 = inspection.current_source_sha256;
+        if (!currentSourceSha256) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message: `Cached source hash is missing for ${inspection.entry.id}@${inspection.entry.version}`,
+            });
+        }
         if (inspection.state === "modified") {
             throw new CliError({
                 exitCode: exitCodeForError("E_USAGE"),
@@ -40,7 +49,7 @@ export async function cmdRecipeDetachParsed(opts) {
             });
         }
         const cache = await readInstalledRecipesFile(resolveInstalledRecipesPath());
-        const activeIds = await readActiveRecipeIds(project);
+        const registry = await readProjectRecipesRegistry(project);
         const cached = cache.recipes.find((entry) => entry.id === inspection.entry.id && entry.version === inspection.entry.version);
         if (!cached) {
             throw new CliError({
@@ -56,24 +65,29 @@ export async function cmdRecipeDetachParsed(opts) {
             reason: `recipes detach ${inspection.entry.id}@${inspection.entry.version}`,
         });
         const targetDir = resolveProjectVendoredRecipeDir(project, inspection.entry.id);
-        await rm(targetDir, { recursive: true, force: true });
-        await cp(inspection.source_dir, targetDir, { recursive: true });
-        await upsertProjectRecipeRegistryEntry({
-            project,
-            entry: {
-                id: inspection.entry.id,
-                version: inspection.entry.version,
-                path: inspection.entry.project_path,
-                active: activeIds.includes(inspection.entry.id),
-                materialization: "copy",
-                source_ref: inspection.entry.source_ref,
-                source_sha256: inspection.current_source_sha256,
-                vendored_sha256: await hashRecipeTree(targetDir),
-                installed_at: inspection.entry.installed_at,
-                tags: normalizeRecipeTags(cached.tags ?? cached.manifest.tags ?? []),
+        await runVendoredRecipeMutation({
+            targetDir,
+            mode: "replace",
+            materialize: async (nextTargetDir) => {
+                await cp(inspection.source_dir, nextTargetDir, { recursive: true });
+            },
+            commit: async () => {
+                const vendoredSha256 = await hashRecipeTree(targetDir);
+                const nextRegistry = replaceProjectRecipeRegistryEntry(registry, {
+                    id: inspection.entry.id,
+                    version: inspection.entry.version,
+                    path: inspection.entry.project_path,
+                    active: registry.recipes.find((entry) => entry.id === inspection.entry.id)?.active === true,
+                    materialization: "copy",
+                    source_ref: inspection.entry.source_ref,
+                    source_sha256: currentSourceSha256,
+                    vendored_sha256: vendoredSha256,
+                    installed_at: inspection.entry.installed_at,
+                    tags: normalizeRecipeTags(cached.tags ?? cached.manifest.tags ?? []),
+                });
+                await publishProjectRecipesState({ project, registry: nextRegistry });
             },
         });
-        await refreshProjectOverlayArtifacts(project);
         process.stdout.write(`Detached recipe ${inspection.entry.id}@${inspection.entry.version} into a project-local copy.\n`);
         return 0;
     }

package/dist/commands/recipes/impl/commands/disable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/disable.ts"],"names":[],"mappings":"AAOA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB"}
+{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/disable.ts"],"names":[],"mappings":"AAQA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB"}

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

@@ -1,15 +1,17 @@
 import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { CliError } from "../../../../shared/errors.js";
-import { refreshProjectOverlayArtifacts, setRecipeActive } from "../overlay-project.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
+import { readProjectRecipesRegistry, setProjectRecipeActiveInFile } from "../project-registry.js";
 export async function cmdRecipeDisableParsed(opts) {
     try {
         const project = await resolveProject({
             cwd: opts.cwd,
             rootOverride: opts.rootOverride ?? null,
         });
-        await setRecipeActive({ project, recipeId: opts.id, active: false });
-        const { bundle } = await refreshProjectOverlayArtifacts(project);
+        const registry = await readProjectRecipesRegistry(project);
+        const nextRegistry = setProjectRecipeActiveInFile(registry, opts.id, false);
+        const { bundle } = await publishProjectRecipesState({ project, registry: nextRegistry });
         process.stdout.write(`Disabled overlay ${opts.id} (${bundle.active.length} active)\n`);
         return 0;
     }

package/dist/commands/recipes/impl/commands/enable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/enable.ts"],"names":[],"mappings":"AASA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB"}
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/enable.ts"],"names":[],"mappings":"AAUA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BlB"}

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

@@ -2,8 +2,9 @@ import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
-import { refreshProjectOverlayArtifacts, setRecipeActive } from "../overlay-project.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { readProjectRecipesRegistry, setProjectRecipeActiveInFile } from "../project-registry.js";
 export async function cmdRecipeEnableParsed(opts) {
     try {
         const project = await resolveProject({
@@ -26,8 +27,9 @@ export async function cmdRecipeEnableParsed(opts) {
                 message: `Recipe ${opts.id} is not a project overlay`,
             });
         }
-        await setRecipeActive({ project, recipeId: opts.id, active: true });
-        const { bundle } = await refreshProjectOverlayArtifacts(project);
+        const registry = await readProjectRecipesRegistry(project);
+        const nextRegistry = setProjectRecipeActiveInFile(registry, opts.id, true);
+        const { bundle } = await publishProjectRecipesState({ project, registry: nextRegistry });
         process.stdout.write(`Enabled overlay ${opts.id} (${bundle.active.length} active)\n`);
         return 0;
     }

package/dist/commands/recipes/impl/commands/explain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/explain.ts"],"names":[],"mappings":"AAeA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA4KlB"}
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/explain.ts"],"names":[],"mappings":"AAkBA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA0LlB"}