agentplane 0.3.12 → 0.3.14

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

@@ -1,64 +1,81 @@
-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";
-import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { readInstalledRecipesFile } from "../installed-recipes.js";
+import { resolveInstalledRecipesPath } from "../paths.js";
+const output = createCliEmitter();
 export async function cmdRecipeInfoParsed(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const installed = await readProjectInstalledRecipes(resolved);
+        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
                 exitCode: exitCodeForError("E_IO"),
                 code: "E_IO",
-                message: `Recipe not installed: ${opts.id}`,
+                message: `Recipe not cached: ${opts.id}`,
             });
         }
         const manifest = entry.manifest;
-        process.stdout.write(`Recipe: ${manifest.id}@${manifest.version}\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 ?? [];
         const tools = manifest.tools ?? [];
         const scenarios = manifest.scenarios ?? [];
+        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) {
+            output.line("Prompts:");
+            for (const prompt of prompts) {
+                output.line(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}]`);
+            }
+        }
+        if (validators.length > 0) {
+            output.line("Validators:");
+            for (const validator of validators) {
+                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,CA4NlB"}
+{"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,31 +9,34 @@ 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";
 import { moveRecipeDir, validateRecipeAssets } from "../apply.js";
 import { resolveRecipeRoot } from "../archive.js";
-import { DEFAULT_RECIPES_INDEX_URL, RECIPE_RUNS_DIR_NAME } from "../constants.js";
+import { DEFAULT_RECIPES_INDEX_URL } from "../constants.js";
 import { loadRecipesRemoteIndex, willFetchRemoteRecipesIndex } from "../index.js";
-import { readRecipeManifest } from "../manifest.js";
-import { normalizeRecipeTags } from "../normalize.js";
-import { writeRecipeInstallMetadata } from "../project-installed-recipes.js";
-import { resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, resolveRecipesIndexCachePath, } from "../paths.js";
+import { readInstalledRecipesFile, writeInstalledRecipesFile } from "../installed-recipes.js";
+import { resolveGlobalRecipesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveRecipesIndexCachePath, } from "../paths.js";
+import { pickLatestRecipeVersion } from "../version.js";
 function isHttpUrl(value) {
     return value.startsWith("http://") || value.startsWith("https://");
 }
 export async function cmdRecipeInstall(opts) {
     void opts.onConflict;
     try {
-        const project = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
         let config = defaultConfig();
-        const loaded = await loadConfig(project.agentplaneDir);
-        config = loaded.config;
+        try {
+            const project = await resolveProject({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride ?? null,
+            });
+            const loaded = await loadConfig(project.agentplaneDir);
+            config = loaded.config;
+        }
+        catch {
+            config = defaultConfig();
+        }
         let networkApproved = false;
         const ensureApproved = async (reason) => {
             if (networkApproved)
@@ -69,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,
@@ -102,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") {
@@ -175,7 +170,10 @@ export async function cmdRecipeInstall(opts) {
             const resolvedTags = manifest.tags && manifest.tags.length > 0 ? manifest.tags : normalizeRecipeTags(indexTags);
             const manifestWithTags = resolvedTags.length > 0 ? { ...manifest, tags: resolvedTags } : manifest;
             await validateRecipeAssets({ manifest: manifestWithTags, recipeDir: recipeRoot });
-            const installDir = resolveProjectInstalledRecipeDir(project, manifestWithTags.id);
+            const installDir = resolveInstalledRecipeDir({
+                id: manifestWithTags.id,
+                version: manifestWithTags.version,
+            });
             const installKind = await getPathKind(installDir);
             if (installKind && installKind !== "dir") {
                 throw new CliError({
@@ -184,40 +182,35 @@ export async function cmdRecipeInstall(opts) {
                     message: `Recipe install path is not a directory: ${installDir}`,
                 });
             }
-            const hadExisting = Boolean(installKind);
-            const existingRunsDir = path.join(installDir, RECIPE_RUNS_DIR_NAME);
-            const preservedRunsDir = path.join(tempRoot, RECIPE_RUNS_DIR_NAME);
             if (installKind) {
-                if ((await getPathKind(existingRunsDir)) === "dir") {
-                    await cp(existingRunsDir, preservedRunsDir, { recursive: true });
-                }
                 await rm(installDir, { recursive: true, force: true });
             }
-            await mkdir(resolveProjectRecipesDir(project), { recursive: true });
+            await mkdir(resolveGlobalRecipesDir(), { recursive: true });
             await moveRecipeDir({ from: recipeRoot, to: installDir });
             try {
-                if ((await getPathKind(preservedRunsDir)) === "dir") {
-                    await cp(preservedRunsDir, path.join(installDir, RECIPE_RUNS_DIR_NAME), {
-                        recursive: true,
-                    });
-                }
-                await writeRecipeInstallMetadata(resolveProjectRecipeInstallMetaPath(project, manifestWithTags.id), {
-                    schema_version: 1,
+                const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+                const entry = {
                     id: manifestWithTags.id,
                     version: manifestWithTags.version,
                     source: sourceLabel,
                     installed_at: new Date().toISOString(),
                     tags: resolvedTags,
-                    install_mode: "project-local",
+                    manifest: manifestWithTags,
+                };
+                await writeInstalledRecipesFile(resolveInstalledRecipesPath(), {
+                    schema_version: 1,
+                    updated_at: installed.updated_at,
+                    recipes: [
+                        ...installed.recipes.filter((installedEntry) => !(installedEntry.id === entry.id && installedEntry.version === entry.version)),
+                        entry,
+                    ],
                 });
             }
             catch (err) {
-                if (!hadExisting) {
-                    await rm(installDir, { recursive: true, force: true });
-                }
+                await rm(installDir, { recursive: true, force: true });
                 throw err;
             }
-            process.stdout.write(`Installed recipe ${manifestWithTags.id}@${manifestWithTags.version}\n`);
+            process.stdout.write(`Installed recipe ${manifestWithTags.id}@${manifestWithTags.version} to global cache\n`);
             return 0;
         }
         finally {

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":"AAOA,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,16 +1,13 @@
-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 { readProjectInstalledRecipes } from "../project-installed-recipes.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 {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const installed = await readProjectInstalledRecipes(resolved);
+        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
         let recipes = installed.recipes;
         if (flags.tag) {
             const needle = flags.tag.toLowerCase();
@@ -18,18 +15,22 @@ export async function cmdRecipeListParsed(opts) {
         }
         if (recipes.length === 0) {
             if (flags.tag) {
-                process.stdout.write(`${emptyStateMessage(`installed recipes for tag ${flags.tag}`)}\n`);
+                output.line(emptyStateMessage(`cached recipes for tag ${flags.tag}`));
                 return 0;
             }
-            process.stdout.write(`${emptyStateMessage("installed 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({ schema_version: 1, updated_at: installed.updated_at, recipes }, null, 2)}\n`);
+            output.json({
+                schema_version: 1,
+                updated_at: installed.updated_at,
+                recipes,
+            });
             return 0;
         }
         for (const entry of recipes) {
-            process.stdout.write(`${entry.id}@${entry.version} - ${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":"AAaA,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"}
+{"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,11 +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 { runVendoredRecipeMutation } from "../mutation-transaction.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { readProjectRecipesRegistry, removeProjectRecipeRegistryEntryFromFile, } from "../project-registry.js";
 import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeRemoveParsed(opts) {
     try {
@@ -15,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({
@@ -30,7 +33,14 @@ export async function cmdRecipeRemoveParsed(opts) {
             yes: false,
             reason: `recipes remove ${entry.id}@${entry.version}`,
         });
-        await rm(recipeDir, { recursive: true, force: true });
+        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

@@ -0,0 +1,7 @@
+export declare function cmdRecipeUpdateParsed(opts: {
+    cwd: string;
+    rootOverride?: string;
+    id: string;
+    force: boolean;
+}): Promise<number>;
+//# sourceMappingURL=update.d.ts.map

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

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

@@ -0,0 +1,107 @@
+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 { runVendoredRecipeMutation } from "../mutation-transaction.js";
+import { publishProjectRecipesState } from "../overlay-project.js";
+import { hashRecipeTree, inspectProjectRecipe } from "../project-recipe-state.js";
+import { readProjectRecipesRegistry, replaceProjectRecipeRegistryEntry, } from "../project-registry.js";
+import { resolveInstalledRecipesPath, resolveProjectVendoredRecipeDir } from "../paths.js";
+function buildModifiedRecipeError(id) {
+    return new CliError({
+        exitCode: exitCodeForError("E_USAGE"),
+        code: "E_USAGE",
+        message: `Recipe ${id} has local project edits. Re-run with --force to overwrite the vendored copy from cache.`,
+    });
+}
+export async function cmdRecipeUpdateParsed(opts) {
+    try {
+        const project = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(project.agentplaneDir);
+        const inspection = await inspectProjectRecipe({ project, recipeId: opts.id });
+        if (!inspection.cache_present || !inspection.current_source_sha256) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message: `Cached source is missing for ${inspection.entry.id}@${inspection.entry.version}. Run agentplane recipes install ${inspection.entry.id}@${inspection.entry.version}`,
+            });
+        }
+        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) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message: `Recipe not found in global cache: ${inspection.entry.id}@${inspection.entry.version}`,
+            });
+        }
+        const registry = await readProjectRecipesRegistry(project);
+        if (inspection.entry.materialization === "copy" &&
+            inspection.state === "clean" &&
+            inspection.current_source_sha256 === inspection.entry.source_sha256) {
+            process.stdout.write(`Recipe ${inspection.entry.id}@${inspection.entry.version} is already up to date.\n`);
+            return 0;
+        }
+        await ensureActionApproved({
+            action: "dangerous_fs",
+            config: loaded.config,
+            yes: false,
+            reason: `recipes update ${inspection.entry.id}@${inspection.entry.version}`,
+        });
+        const targetDir = resolveProjectVendoredRecipeDir(project, inspection.entry.id);
+        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 });
+            },
+        });
+        const verb = inspection.entry.materialization === "link"
+            ? "Refreshed linked recipe"
+            : "Updated vendored recipe";
+        process.stdout.write(`${verb} ${inspection.entry.id}@${inspection.entry.version} from cache.\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes update", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -1,8 +1,15 @@
+export { cmdRecipeAddParsed } from "./commands/add.js";
+export { cmdRecipeDetachParsed } from "./commands/detach.js";
 export { cmdRecipeListParsed } from "./commands/list.js";
 export { cmdRecipeListRemoteParsed } from "./commands/list-remote.js";
 export { cmdRecipeInfoParsed } from "./commands/info.js";
 export { cmdRecipeExplainParsed } from "./commands/explain.js";
+export { cmdRecipeActiveParsed } from "./commands/active.js";
+export { cmdRecipeExplainActiveParsed } from "./commands/explain-active.js";
+export { cmdRecipeEnableParsed } from "./commands/enable.js";
+export { cmdRecipeDisableParsed } from "./commands/disable.js";
 export { cmdRecipeInstall } from "./commands/install.js";
 export { cmdRecipeRemoveParsed } from "./commands/remove.js";
+export { cmdRecipeUpdateParsed } from "./commands/update.js";
 export { cmdRecipeCachePruneParsed } from "./commands/cache-prune.js";
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -1,7 +1,14 @@
+export { cmdRecipeAddParsed } from "./commands/add.js";
+export { cmdRecipeDetachParsed } from "./commands/detach.js";
 export { cmdRecipeListParsed } from "./commands/list.js";
 export { cmdRecipeListRemoteParsed } from "./commands/list-remote.js";
 export { cmdRecipeInfoParsed } from "./commands/info.js";
 export { cmdRecipeExplainParsed } from "./commands/explain.js";
+export { cmdRecipeActiveParsed } from "./commands/active.js";
+export { cmdRecipeExplainActiveParsed } from "./commands/explain-active.js";
+export { cmdRecipeEnableParsed } from "./commands/enable.js";
+export { cmdRecipeDisableParsed } from "./commands/disable.js";
 export { cmdRecipeInstall } from "./commands/install.js";
 export { cmdRecipeRemoveParsed } from "./commands/remove.js";
+export { cmdRecipeUpdateParsed } from "./commands/update.js";
 export { cmdRecipeCachePruneParsed } from "./commands/cache-prune.js";

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

@@ -1,15 +1,2 @@
-export declare const INSTALLED_RECIPES_NAME = "recipes.json";
-export declare const RECIPES_DIR_NAME = "recipes";
-export declare const RECIPES_SCENARIOS_DIR_NAME = "scenarios";
-export declare const RECIPES_SCENARIOS_INDEX_NAME = "scenarios.json";
-export declare const RECIPE_INSTALL_META_NAME = ".install.json";
-export declare const RECIPE_RUNS_DIR_NAME = "runs";
-export declare const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
-export declare const GLOBAL_RECIPES_DIR_NAME = "recipes";
-export declare const PROJECT_RECIPES_CACHE_DIR_NAME = "recipes-cache";
-export declare const RECIPES_REMOTE_INDEX_NAME = "recipes-index.json";
-export declare const RECIPES_REMOTE_INDEX_SIG_NAME = "recipes-index.json.sig";
-export declare const DEFAULT_RECIPES_INDEX_URL = "https://raw.githubusercontent.com/basilisk-labs/agentplane-recipes/main/index.json";
-export declare const RECIPES_INDEX_PUBLIC_KEYS_ENV = "AGENTPLANE_RECIPES_INDEX_PUBLIC_KEYS";
-export declare const RECIPES_INDEX_PUBLIC_KEYS: Record<string, string>;
+export { AGENTPLANE_HOME_ENV, DEFAULT_RECIPES_INDEX_URL, GLOBAL_RECIPES_DIR_NAME, INSTALLED_RECIPES_NAME, PROJECT_RECIPES_PACKAGES_DIR_NAME, PROJECT_RECIPES_REGISTRY_NAME, PROJECT_RECIPES_CACHE_DIR_NAME, RECIPES_DIR_NAME, RECIPES_INDEX_PUBLIC_KEYS, RECIPES_INDEX_PUBLIC_KEYS_ENV, RECIPES_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, RECIPE_RUNS_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, } from "@agentplaneorg/recipes";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,eAAO,MAAM,uBAAuB,YAAY,CAAC;AACjD,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAE9D,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AAEtE,eAAO,MAAM,yBAAyB,uFACgD,CAAC;AAEvF,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5D,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

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

@@ -1,18 +1 @@
-export const INSTALLED_RECIPES_NAME = "recipes.json";
-export const RECIPES_DIR_NAME = "recipes";
-export const RECIPES_SCENARIOS_DIR_NAME = "scenarios";
-export const RECIPES_SCENARIOS_INDEX_NAME = "scenarios.json";
-export const RECIPE_INSTALL_META_NAME = ".install.json";
-export const RECIPE_RUNS_DIR_NAME = "runs";
-export const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
-export const GLOBAL_RECIPES_DIR_NAME = "recipes";
-export const PROJECT_RECIPES_CACHE_DIR_NAME = "recipes-cache";
-export const RECIPES_REMOTE_INDEX_NAME = "recipes-index.json";
-export const RECIPES_REMOTE_INDEX_SIG_NAME = "recipes-index.json.sig";
-export const DEFAULT_RECIPES_INDEX_URL = "https://raw.githubusercontent.com/basilisk-labs/agentplane-recipes/main/index.json";
-export const RECIPES_INDEX_PUBLIC_KEYS_ENV = "AGENTPLANE_RECIPES_INDEX_PUBLIC_KEYS";
-export const RECIPES_INDEX_PUBLIC_KEYS = {
-    "2026-02": `-----BEGIN PUBLIC KEY-----
-MCowBQYDK2VwAyEAeRWdXKVZtz0v+bnQS3zb24jMfa0gflsRUHQkeJkji6E=
------END PUBLIC KEY-----`,
-};
+export { AGENTPLANE_HOME_ENV, DEFAULT_RECIPES_INDEX_URL, GLOBAL_RECIPES_DIR_NAME, INSTALLED_RECIPES_NAME, PROJECT_RECIPES_PACKAGES_DIR_NAME, PROJECT_RECIPES_REGISTRY_NAME, PROJECT_RECIPES_CACHE_DIR_NAME, RECIPES_DIR_NAME, RECIPES_INDEX_PUBLIC_KEYS, RECIPES_INDEX_PUBLIC_KEYS_ENV, RECIPES_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, RECIPE_RUNS_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, } from "@agentplaneorg/recipes";

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;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,YAAY,CAAC;AAyHtE,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAGV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,wBAAwB,CAAC;AAsIlF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAGV"}

package/dist/commands/recipes/impl/installed-recipes.d.ts

@@ -1,4 +1,4 @@
-import type { InstalledRecipesFile } from "./types.js";
+import { type InstalledRecipesFile } from "@agentplaneorg/recipes";
 export declare function readInstalledRecipesFile(filePath: string): Promise<InstalledRecipesFile>;
 export declare function writeInstalledRecipesFile(filePath: string, file: InstalledRecipesFile): Promise<void>;
 //# sourceMappingURL=installed-recipes.d.ts.map

package/dist/commands/recipes/impl/installed-recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/installed-recipes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAoCvD,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/installed-recipes.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAwChC,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf"}