agentplane 0.3.13 → 0.3.14

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

@@ -1,6 +1,8 @@
 import path from "node:path";
+import { collectRecipeScenarioDetails } from "@agentplaneorg/recipes";
 import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
+import { createCliEmitter } from "../../../../cli/output.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
 import { formatJsonBlock } from "../format.js";
@@ -8,7 +10,7 @@ import { readActiveRecipeIds } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
 import { inspectProjectRecipe } from "../project-recipe-state.js";
 import { resolveProjectRecipesDir, resolveProjectInstalledRecipeDir } from "../paths.js";
-import { collectRecipeScenarioDetails } from "../scenario.js";
+const output = createCliEmitter();
 export async function cmdRecipeExplainParsed(opts) {
     try {
         const resolved = await resolveProject({
@@ -33,145 +35,153 @@ export async function cmdRecipeExplainParsed(opts) {
             ? path.join(resolveProjectRecipesDir(resolved), entry.project_path)
             : resolveProjectInstalledRecipeDir(resolved, entry.id);
         const scenarioDetails = await collectRecipeScenarioDetails(recipeDir, manifest);
-        process.stdout.write(`Recipe: ${manifest.id}@${manifest.version}\n`);
-        process.stdout.write(`Kind: ${manifest.kind}\n`);
-        process.stdout.write(`Schema: ${manifest.schema_version}\n`);
-        process.stdout.write(`Active: ${activeIds.includes(entry.id) ? "yes" : "no"}\n`);
-        process.stdout.write(`Materialization: ${entry.materialization}\n`);
-        process.stdout.write(`State: ${inspection.state}\n`);
-        process.stdout.write(`Source ref: ${entry.source_ref}\n`);
-        process.stdout.write(`Cache source: ${inspection.cache_present ? "present" : "missing"}\n`);
-        process.stdout.write(`Source sha256: ${entry.source_sha256}\n`);
-        process.stdout.write(`Vendored sha256: ${inspection.current_vendored_sha256}\n`);
-        process.stdout.write(`Name: ${manifest.name}\n`);
-        process.stdout.write(`Summary: ${manifest.summary}\n`);
-        process.stdout.write(`Description: ${manifest.description}\n`);
+        output.lines([
+            `Recipe: ${manifest.id}@${manifest.version}`,
+            `Kind: ${manifest.kind}`,
+            `Schema: ${manifest.schema_version}`,
+            `Active: ${activeIds.includes(entry.id) ? "yes" : "no"}`,
+            `Materialization: ${entry.materialization}`,
+            `State: ${inspection.state}`,
+            `Source ref: ${entry.source_ref}`,
+            `Cache source: ${inspection.cache_present ? "present" : "missing"}`,
+            `Source sha256: ${entry.source_sha256}`,
+            `Vendored sha256: ${inspection.current_vendored_sha256}`,
+            `Name: ${manifest.name}`,
+            `Summary: ${manifest.summary}`,
+            `Description: ${manifest.description}`,
+        ]);
         if (manifest.tags && manifest.tags.length > 0) {
-            process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
+            output.line(`Tags: ${manifest.tags.join(", ")}`);
         }
         if (manifest.compatibility) {
             const payload = formatJsonBlock(manifest.compatibility, "  ");
             if (payload)
-                process.stdout.write(`Compatibility:\n${payload}\n`);
+                output.jsonSection("Compatibility", manifest.compatibility);
         }
         const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
         const tools = manifest.tools ?? [];
         if (skills.length > 0) {
-            process.stdout.write("Skills:\n");
+            output.line("Skills:");
             for (const skill of skills) {
-                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+                output.line(`  - ${skill.id} - ${skill.summary}`);
             }
         }
         if (agents.length > 0) {
-            process.stdout.write("Agents:\n");
+            output.line("Agents:");
             for (const agent of agents) {
-                process.stdout.write(`  - ${agent.display_name} (${agent.id}) - ${agent.summary} [role=${agent.role}]\n`);
+                output.line(`  - ${agent.display_name} (${agent.id}) - ${agent.summary} [role=${agent.role}]`);
             }
         }
         if (tools.length > 0) {
-            process.stdout.write("Tools:\n");
+            output.line("Tools:");
             for (const tool of tools) {
-                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
+                output.line(`  - ${tool.id} - ${tool.summary}`);
             }
         }
         const prompts = manifest.prompts ?? [];
         const validators = manifest.validators ?? [];
         if (prompts.length > 0) {
-            process.stdout.write("Overlay prompts:\n");
+            output.line("Overlay prompts:");
             for (const prompt of prompts) {
-                process.stdout.write(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}, file=${prompt.file}]\n`);
+                output.line(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}, file=${prompt.file}]`);
             }
         }
         if (validators.length > 0) {
-            process.stdout.write("Overlay validators:\n");
+            output.line("Overlay validators:");
             for (const validator of validators) {
-                process.stdout.write(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]\n`);
+                output.line(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]`);
             }
         }
         if (manifest.templates && Object.keys(manifest.templates).length > 0) {
             const payload = formatJsonBlock(manifest.templates, "  ");
             if (payload)
-                process.stdout.write(`Templates:\n${payload}\n`);
+                output.jsonSection("Templates", manifest.templates);
         }
         if (scenarioDetails.length > 0) {
-            process.stdout.write("Scenarios:\n");
+            output.line("Scenarios:");
             for (const scenario of scenarioDetails) {
                 const title = scenario.name ? `${scenario.name} (${scenario.id})` : scenario.id;
                 const summary = scenario.summary ? ` - ${scenario.summary}` : "";
-                process.stdout.write(`  - ${title}${summary}\n`);
+                output.line(`  - ${title}${summary}`);
                 if (scenario.description) {
-                    process.stdout.write(`    Description: ${scenario.description}\n`);
+                    output.line(`    Description: ${scenario.description}`);
                 }
                 if (scenario.goal) {
-                    process.stdout.write(`    Goal: ${scenario.goal}\n`);
+                    output.line(`    Goal: ${scenario.goal}`);
                 }
                 if (scenario.use_when && scenario.use_when.length > 0) {
                     const payload = formatJsonBlock(scenario.use_when, "      ");
                     if (payload)
-                        process.stdout.write(`    Use when:\n${payload}\n`);
+                        output.jsonSection("    Use when", scenario.use_when, { indent: "      " });
                 }
                 if (scenario.avoid_when && scenario.avoid_when.length > 0) {
                     const payload = formatJsonBlock(scenario.avoid_when, "      ");
                     if (payload)
-                        process.stdout.write(`    Avoid when:\n${payload}\n`);
+                        output.jsonSection("    Avoid when", scenario.avoid_when, { indent: "      " });
                 }
                 if (scenario.required_inputs && scenario.required_inputs.length > 0) {
                     const payload = formatJsonBlock(scenario.required_inputs, "      ");
-                    if (payload)
-                        process.stdout.write(`    Required inputs:\n${payload}\n`);
+                    if (payload) {
+                        output.jsonSection("    Required inputs", scenario.required_inputs, {
+                            indent: "      ",
+                        });
+                    }
                 }
                 if (scenario.inputs !== undefined) {
                     const payload = formatJsonBlock(scenario.inputs, "      ");
                     if (payload)
-                        process.stdout.write(`    Inputs:\n${payload}\n`);
+                        output.jsonSection("    Inputs", scenario.inputs, { indent: "      " });
                 }
                 if (scenario.outputs !== undefined) {
                     const payload = formatJsonBlock(scenario.outputs, "      ");
                     if (payload)
-                        process.stdout.write(`    Outputs:\n${payload}\n`);
+                        output.jsonSection("    Outputs", scenario.outputs, { indent: "      " });
                 }
                 if (scenario.permissions && scenario.permissions.length > 0) {
                     const payload = formatJsonBlock(scenario.permissions, "      ");
                     if (payload)
-                        process.stdout.write(`    Permissions:\n${payload}\n`);
+                        output.jsonSection("    Permissions", scenario.permissions, { indent: "      " });
                 }
                 if (scenario.artifacts && scenario.artifacts.length > 0) {
                     const payload = formatJsonBlock(scenario.artifacts, "      ");
                     if (payload)
-                        process.stdout.write(`    Artifacts:\n${payload}\n`);
+                        output.jsonSection("    Artifacts", scenario.artifacts, { indent: "      " });
                 }
                 if (scenario.agents_involved && scenario.agents_involved.length > 0) {
                     const payload = formatJsonBlock(scenario.agents_involved, "      ");
-                    if (payload)
-                        process.stdout.write(`    Agents involved:\n${payload}\n`);
+                    if (payload) {
+                        output.jsonSection("    Agents involved", scenario.agents_involved, {
+                            indent: "      ",
+                        });
+                    }
                 }
                 if (scenario.skills_used && scenario.skills_used.length > 0) {
                     const payload = formatJsonBlock(scenario.skills_used, "      ");
                     if (payload)
-                        process.stdout.write(`    Skills used:\n${payload}\n`);
+                        output.jsonSection("    Skills used", scenario.skills_used, { indent: "      " });
                 }
                 if (scenario.tools_used && scenario.tools_used.length > 0) {
                     const payload = formatJsonBlock(scenario.tools_used, "      ");
                     if (payload)
-                        process.stdout.write(`    Tools used:\n${payload}\n`);
+                        output.jsonSection("    Tools used", scenario.tools_used, { indent: "      " });
                 }
                 if (scenario.run_profile) {
                     const payload = formatJsonBlock(scenario.run_profile, "      ");
                     if (payload)
-                        process.stdout.write(`    Run profile:\n${payload}\n`);
+                        output.jsonSection("    Run profile", scenario.run_profile, { indent: "      " });
                 }
                 if (scenario.steps && scenario.steps.length > 0) {
-                    process.stdout.write("    Steps:\n");
+                    output.line("    Steps:");
                     let stepIndex = 1;
                     for (const step of scenario.steps) {
-                        process.stdout.write(`      ${stepIndex}. ${JSON.stringify(step)}\n`);
+                        output.line(`      ${stepIndex}. ${JSON.stringify(step)}`);
                         stepIndex += 1;
                     }
                     continue;
                 }
                 if (scenario.source !== "definition") {
-                    process.stdout.write("    Details: Scenario definition not found in recipe.\n");
+                    output.line("    Details: Scenario definition not found in recipe.");
                 }
             }
         }

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

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/info.ts"],"names":[],"mappings":"AAQA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFlB"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/info.ts"],"names":[],"mappings":"AAWA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFlB"}

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

@@ -1,9 +1,11 @@
 import { mapCoreError } from "../../../../cli/error-map.js";
+import { createCliEmitter } from "../../../../cli/output.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
 import { formatJsonBlock } from "../format.js";
 import { readInstalledRecipesFile } from "../installed-recipes.js";
 import { resolveInstalledRecipesPath } from "../paths.js";
+const output = createCliEmitter();
 export async function cmdRecipeInfoParsed(opts) {
     try {
         const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
@@ -16,20 +18,22 @@ export async function cmdRecipeInfoParsed(opts) {
             });
         }
         const manifest = entry.manifest;
-        process.stdout.write(`Recipe: ${manifest.id}@${manifest.version}\n`);
-        process.stdout.write(`Kind: ${manifest.kind}\n`);
-        process.stdout.write(`Schema: ${manifest.schema_version}\n`);
-        process.stdout.write("Cached: yes\n");
-        process.stdout.write(`Name: ${manifest.name}\n`);
-        process.stdout.write(`Summary: ${manifest.summary}\n`);
-        process.stdout.write(`Description: ${manifest.description}\n`);
+        output.lines([
+            `Recipe: ${manifest.id}@${manifest.version}`,
+            `Kind: ${manifest.kind}`,
+            `Schema: ${manifest.schema_version}`,
+            "Cached: yes",
+            `Name: ${manifest.name}`,
+            `Summary: ${manifest.summary}`,
+            `Description: ${manifest.description}`,
+        ]);
         if (manifest.tags && manifest.tags.length > 0) {
-            process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
+            output.line(`Tags: ${manifest.tags.join(", ")}`);
         }
         if (manifest.compatibility) {
             const payload = formatJsonBlock(manifest.compatibility, "  ");
             if (payload)
-                process.stdout.write(`Compatibility:\n${payload}\n`);
+                output.jsonSection("Compatibility", manifest.compatibility);
         }
         const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
@@ -38,40 +42,40 @@ export async function cmdRecipeInfoParsed(opts) {
         const prompts = manifest.prompts ?? [];
         const validators = manifest.validators ?? [];
         if (skills.length > 0) {
-            process.stdout.write("Skills:\n");
+            output.line("Skills:");
             for (const skill of skills) {
-                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+                output.line(`  - ${skill.id} - ${skill.summary}`);
             }
         }
         if (agents.length > 0) {
-            process.stdout.write("Agents:\n");
+            output.line("Agents:");
             for (const agent of agents) {
                 const label = `${agent.display_name} (${agent.id})`;
-                process.stdout.write(`  - ${label} - ${agent.summary}\n`);
+                output.line(`  - ${label} - ${agent.summary}`);
             }
         }
         if (tools.length > 0) {
-            process.stdout.write("Tools:\n");
+            output.line("Tools:");
             for (const tool of tools) {
-                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
+                output.line(`  - ${tool.id} - ${tool.summary}`);
             }
         }
         if (prompts.length > 0) {
-            process.stdout.write("Prompts:\n");
+            output.line("Prompts:");
             for (const prompt of prompts) {
-                process.stdout.write(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}]\n`);
+                output.line(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}]`);
             }
         }
         if (validators.length > 0) {
-            process.stdout.write("Validators:\n");
+            output.line("Validators:");
             for (const validator of validators) {
-                process.stdout.write(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]\n`);
+                output.line(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]`);
             }
         }
         if (scenarios.length > 0) {
-            process.stdout.write("Scenarios:\n");
+            output.line("Scenarios:");
             for (const scenario of scenarios) {
-                process.stdout.write(`  - ${scenario.name} (${scenario.id}) - ${scenario.summary} [mode=${scenario.run_profile.mode}]\n`);
+                output.line(`  - ${scenario.name} (${scenario.id}) - ${scenario.summary} [mode=${scenario.run_profile.mode}]`);
             }
         }
         return 0;

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

@@ -1,4 +1,4 @@
-import type { RecipeConflictMode, RecipeInstallSource } from "../types.js";
+import { type RecipeConflictMode, type RecipeInstallSource } from "@agentplaneorg/recipes";
 export declare function cmdRecipeInstall(opts: {
     cwd: string;
     rootOverride?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/install.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAM3E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAgOlB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/install.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AA8BhC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAuNlB"}

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

@@ -1,6 +1,7 @@
 import { cp, mkdir, mkdtemp, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { normalizeRecipeTags, readRecipeManifest, } from "@agentplaneorg/recipes";
 import { defaultConfig, loadConfig, resolveProject } from "@agentplaneorg/core";
 import { extractArchive } from "../../../../cli/archive.js";
 import { sha256File } from "../../../../cli/checksum.js";
@@ -8,7 +9,6 @@ import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { fileExists, getPathKind } from "../../../../cli/fs-utils.js";
 import { downloadToFile } from "../../../../cli/http.js";
-import { getBundledRecipeEntry, resolveBundledRecipeSourcePath, } from "../../../../recipes/bundled-recipes.js";
 import { CliError } from "../../../../shared/errors.js";
 import { ensureNetworkApproved } from "../../../shared/network-approval.js";
 import { resolvePathFallback } from "../../../shared/path.js";
@@ -17,9 +17,8 @@ import { resolveRecipeRoot } from "../archive.js";
 import { DEFAULT_RECIPES_INDEX_URL } from "../constants.js";
 import { loadRecipesRemoteIndex, willFetchRemoteRecipesIndex } from "../index.js";
 import { readInstalledRecipesFile, writeInstalledRecipesFile } from "../installed-recipes.js";
-import { readRecipeManifest } from "../manifest.js";
-import { normalizeRecipeTags } from "../normalize.js";
 import { resolveGlobalRecipesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveRecipesIndexCachePath, } from "../paths.js";
+import { pickLatestRecipeVersion } from "../version.js";
 function isHttpUrl(value) {
     return value.startsWith("http://") || value.startsWith("https://");
 }
@@ -74,9 +73,7 @@ export async function cmdRecipeInstall(opts) {
                         message: `Recipe not found in remote index: ${recipeId}`,
                     });
                 }
-                const latest = [...entry.versions]
-                    .toSorted((a, b) => a.version.localeCompare(b.version))
-                    .at(-1);
+                const latest = pickLatestRecipeVersion(entry.versions);
                 if (!latest) {
                     throw new CliError({
                         exitCode: 3,
@@ -107,13 +104,6 @@ export async function cmdRecipeInstall(opts) {
             };
             const resolveSourcePath = async (source) => {
                 if (source.type === "name") {
-                    const bundledPath = resolveBundledRecipeSourcePath(source.value);
-                    if (bundledPath && (await fileExists(path.join(bundledPath, "manifest.json")))) {
-                        const bundledEntry = getBundledRecipeEntry(source.value);
-                        const bundledVersion = bundledEntry?.versions.at(-1)?.version ?? "unknown";
-                        sourceLabel = `bundled:${source.value}@${bundledVersion}`;
-                        return { kind: "directory", path: bundledPath };
-                    }
                     return await resolveFromIndex(source.value);
                 }
                 if (source.type === "url") {

package/dist/commands/recipes/impl/commands/list-remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-remote.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/list-remote.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}
+{"version":3,"file":"list-remote.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/list-remote.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB"}

package/dist/commands/recipes/impl/commands/list-remote.js

@@ -7,6 +7,7 @@ import { DEFAULT_RECIPES_INDEX_URL } from "../constants.js";
 import { loadRecipesRemoteIndex, willFetchRemoteRecipesIndex } from "../index.js";
 import { maybeResolveProject } from "../project.js";
 import { resolveRecipesIndexCachePath } from "../paths.js";
+import { pickLatestRecipeVersion } from "../version.js";
 export async function cmdRecipeListRemoteParsed(opts) {
     const flags = opts.flags;
     try {
@@ -37,9 +38,7 @@ export async function cmdRecipeListRemoteParsed(opts) {
             refresh: flags.refresh,
         });
         for (const recipe of index.recipes) {
-            const latest = [...recipe.versions]
-                .toSorted((a, b) => a.version.localeCompare(b.version))
-                .at(-1);
+            const latest = pickLatestRecipeVersion(recipe.versions);
             if (!latest)
                 continue;
             process.stdout.write(`${recipe.id}@${latest.version} - ${recipe.summary}\n`);

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/list.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDlB"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/list.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB"}

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

@@ -1,8 +1,9 @@
 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 { readInstalledRecipesFile } from "../installed-recipes.js";
 import { resolveInstalledRecipesPath } from "../paths.js";
+const output = createCliEmitter();
 export async function cmdRecipeListParsed(opts) {
     const flags = opts.flags;
     try {
@@ -14,22 +15,22 @@ export async function cmdRecipeListParsed(opts) {
         }
         if (recipes.length === 0) {
             if (flags.tag) {
-                process.stdout.write(`${emptyStateMessage(`cached recipes for tag ${flags.tag}`)}\n`);
+                output.line(emptyStateMessage(`cached recipes for tag ${flags.tag}`));
                 return 0;
             }
-            process.stdout.write(`${emptyStateMessage("cached recipes", "Use `agentplane recipes list-remote` or `agentplane recipes install <id>`.")}\n`);
+            output.line(emptyStateMessage("cached recipes", "Use `agentplane recipes list-remote` or `agentplane recipes install <id>`."));
             return 0;
         }
         if (flags.full) {
-            process.stdout.write(`${JSON.stringify({
+            output.json({
                 schema_version: 1,
                 updated_at: installed.updated_at,
                 recipes,
-            }, null, 2)}\n`);
+            });
             return 0;
         }
         for (const entry of recipes) {
-            process.stdout.write(`${entry.id}@${entry.version} [${entry.manifest.kind}] - ${entry.manifest.summary || "No summary"}\n`);
+            output.line(`${entry.id}@${entry.version} [${entry.manifest.kind}] - ${entry.manifest.summary || "No summary"}`);
         }
         return 0;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/remove.ts"],"names":[],"mappings":"AAeA,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,CAkClB"}
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/remove.ts"],"names":[],"mappings":"AAiBA,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,CAuClB"}

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

@@ -1,13 +1,13 @@
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
-import { rm } from "node:fs/promises";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { successMessage } from "../../../../cli/output.js";
 import { CliError } from "../../../../shared/errors.js";
 import { ensureActionApproved } from "../../../shared/approval-requirements.js";
-import { refreshProjectOverlayArtifacts, setRecipeActive } from "../overlay-project.js";
+import { runVendoredRecipeMutation } from "../mutation-transaction.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
-import { removeProjectRecipeRegistryEntry } from "../project-registry.js";
+import { readProjectRecipesRegistry, removeProjectRecipeRegistryEntryFromFile, } from "../project-registry.js";
 import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeRemoveParsed(opts) {
     try {
@@ -17,6 +17,7 @@ export async function cmdRecipeRemoveParsed(opts) {
         });
         const loaded = await loadConfig(resolved.agentplaneDir);
         const installed = await readProjectInstalledRecipes(resolved);
+        const registry = await readProjectRecipesRegistry(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -32,10 +33,14 @@ export async function cmdRecipeRemoveParsed(opts) {
             yes: false,
             reason: `recipes remove ${entry.id}@${entry.version}`,
         });
-        await rm(recipeDir, { recursive: true, force: true });
-        await setRecipeActive({ project: resolved, recipeId: entry.id, active: false });
-        await removeProjectRecipeRegistryEntry({ project: resolved, recipeId: entry.id });
-        await refreshProjectOverlayArtifacts(resolved);
+        await runVendoredRecipeMutation({
+            targetDir: recipeDir,
+            mode: "remove",
+            commit: async () => {
+                const nextRegistry = removeProjectRecipeRegistryEntryFromFile(registry, entry.id);
+                await publishProjectRecipesState({ project: resolved, registry: nextRegistry });
+            },
+        });
         process.stdout.write(`${successMessage("removed recipe", `${entry.id}@${entry.version}`)}\n`);
         return 0;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/update.ts"],"names":[],"mappings":"AAwBA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFlB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/update.ts"],"names":[],"mappings":"AA4BA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGlB"}

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

@@ -1,14 +1,15 @@
-import { cp, rm, symlink } from "node:fs/promises";
+import { cp, 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 { 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";
 function buildModifiedRecipeError(id) {
     return new CliError({
@@ -35,6 +36,14 @@ export async function cmdRecipeUpdateParsed(opts) {
         if (inspection.state === "modified" && !opts.force) {
             throw buildModifiedRecipeError(inspection.entry.id);
         }
+        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}`,
+            });
+        }
         const cache = await readInstalledRecipesFile(resolveInstalledRecipesPath());
         const cached = cache.recipes.find((entry) => entry.id === inspection.entry.id && entry.version === inspection.entry.version);
         if (!cached) {
@@ -44,7 +53,7 @@ export async function cmdRecipeUpdateParsed(opts) {
                 message: `Recipe not found in global cache: ${inspection.entry.id}@${inspection.entry.version}`,
             });
         }
-        const activeIds = await readActiveRecipeIds(project);
+        const registry = await readProjectRecipesRegistry(project);
         if (inspection.entry.materialization === "copy" &&
             inspection.state === "clean" &&
             inspection.current_source_sha256 === inspection.entry.source_sha256) {
@@ -58,27 +67,32 @@ export async function cmdRecipeUpdateParsed(opts) {
             reason: `recipes update ${inspection.entry.id}@${inspection.entry.version}`,
         });
         const targetDir = resolveProjectVendoredRecipeDir(project, inspection.entry.id);
-        await rm(targetDir, { recursive: true, force: true });
-        await (inspection.entry.materialization === "link"
-            ? symlink(inspection.source_dir, targetDir, "dir")
-            : cp(inspection.source_dir, targetDir, { recursive: true }));
-        const vendoredSha256 = await hashRecipeTree(targetDir);
-        await upsertProjectRecipeRegistryEntry({
-            project,
-            entry: {
-                id: inspection.entry.id,
-                version: inspection.entry.version,
-                path: inspection.entry.project_path,
-                active: activeIds.includes(inspection.entry.id),
-                materialization: inspection.entry.materialization,
-                source_ref: inspection.entry.source_ref,
-                source_sha256: inspection.current_source_sha256,
-                vendored_sha256: vendoredSha256,
-                installed_at: inspection.entry.installed_at,
-                tags: normalizeRecipeTags(cached.tags ?? cached.manifest.tags ?? []),
+        await runVendoredRecipeMutation({
+            targetDir,
+            mode: "replace",
+            materialize: async (nextTargetDir) => {
+                await (inspection.entry.materialization === "link"
+                    ? symlink(inspection.source_dir, nextTargetDir, "dir")
+                    : cp(inspection.source_dir, nextTargetDir, { recursive: true }));
+            },
+            commit: async () => {
+                const vendoredSha256 = await hashRecipeTree(targetDir);
+                const existingEntry = registry.recipes.find((entry) => entry.id === inspection.entry.id);
+                const nextRegistry = replaceProjectRecipeRegistryEntry(registry, {
+                    id: inspection.entry.id,
+                    version: inspection.entry.version,
+                    path: inspection.entry.project_path,
+                    active: existingEntry?.active === true,
+                    materialization: inspection.entry.materialization,
+                    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);
         const verb = inspection.entry.materialization === "link"
             ? "Refreshed linked recipe"
             : "Updated vendored recipe";

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

@@ -1,4 +1,4 @@
-import type { RecipesIndex } from "./types.js";
+import type { RecipesIndex } from "@agentplaneorg/recipes";
 export declare function loadRecipesRemoteIndex(opts: {
     cwd: string;
     source?: string;