agentplane 0.3.12 → 0.3.13

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

@@ -0,0 +1,85 @@
+import { cp, rm } from "node:fs/promises";
+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 { hashRecipeTree, inspectProjectRecipe } from "../project-recipe-state.js";
+import { upsertProjectRecipeRegistryEntry } from "../project-registry.js";
+import { resolveInstalledRecipesPath, resolveProjectVendoredRecipeDir } from "../paths.js";
+export async function cmdRecipeDetachParsed(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.entry.materialization !== "link") {
+            throw new CliError({
+                exitCode: exitCodeForError("E_USAGE"),
+                code: "E_USAGE",
+                message: `Recipe ${inspection.entry.id} is already materialized as copy.`,
+            });
+        }
+        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}. Re-install it before detaching.`,
+            });
+        }
+        if (inspection.state === "modified") {
+            throw new CliError({
+                exitCode: exitCodeForError("E_USAGE"),
+                code: "E_USAGE",
+                message: `Recipe ${inspection.entry.id} is no longer a clean project link. Restore it with agentplane recipes update ${inspection.entry.id} --force before detaching.`,
+            });
+        }
+        const cache = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const activeIds = await readActiveRecipeIds(project);
+        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}`,
+            });
+        }
+        await ensureActionApproved({
+            action: "dangerous_fs",
+            config: loaded.config,
+            yes: false,
+            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 refreshProjectOverlayArtifacts(project);
+        process.stdout.write(`Detached recipe ${inspection.entry.id}@${inspection.entry.version} into a project-local copy.\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes detach", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

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

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

@@ -0,0 +1,21 @@
+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";
+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);
+        process.stdout.write(`Disabled overlay ${opts.id} (${bundle.active.length} active)\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes disable", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

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

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

@@ -0,0 +1,39 @@
+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 { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+export async function cmdRecipeEnableParsed(opts) {
+    try {
+        const project = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(project);
+        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}`,
+            });
+        }
+        if (entry.manifest.kind !== "project_overlay") {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: `Recipe ${opts.id} is not a project overlay`,
+            });
+        }
+        await setRecipeActive({ project, recipeId: opts.id, active: true });
+        const { bundle } = await refreshProjectOverlayArtifacts(project);
+        process.stdout.write(`Enabled overlay ${opts.id} (${bundle.active.length} active)\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes enable", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/recipes/impl/commands/explain-active.d.ts

@@ -0,0 +1,5 @@
+export declare function cmdRecipeExplainActiveParsed(opts: {
+    cwd: string;
+    rootOverride?: string;
+}): Promise<number>;
+//# sourceMappingURL=explain-active.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain-active.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/explain-active.ts"],"names":[],"mappings":"AAOA,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalB"}

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

@@ -0,0 +1,20 @@
+import { resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../../../cli/error-map.js";
+import { CliError } from "../../../../shared/errors.js";
+import { readProjectOverlayBundle } from "../overlay-project.js";
+export async function cmdRecipeExplainActiveParsed(opts) {
+    try {
+        const project = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const bundle = await readProjectOverlayBundle(project);
+        process.stdout.write(`${JSON.stringify(bundle ?? null, null, 2)}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes explain-active", root: opts.rootOverride ?? null });
+    }
+}

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":"AAWA,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,CAqIlB"}
+{"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"}

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

@@ -1,10 +1,13 @@
+import path from "node:path";
 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 { formatJsonBlock } from "../format.js";
+import { readActiveRecipeIds } from "../overlay-project.js";
 import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
-import { resolveProjectInstalledRecipeDir } from "../paths.js";
+import { inspectProjectRecipe } from "../project-recipe-state.js";
+import { resolveProjectRecipesDir, resolveProjectInstalledRecipeDir } from "../paths.js";
 import { collectRecipeScenarioDetails } from "../scenario.js";
 export async function cmdRecipeExplainParsed(opts) {
     try {
@@ -12,7 +15,10 @@ export async function cmdRecipeExplainParsed(opts) {
             cwd: opts.cwd,
             rootOverride: opts.rootOverride ?? null,
         });
-        const installed = await readProjectInstalledRecipes(resolved);
+        const [installed, activeIds] = await Promise.all([
+            readProjectInstalledRecipes(resolved),
+            readActiveRecipeIds(resolved),
+        ]);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -21,10 +27,22 @@ export async function cmdRecipeExplainParsed(opts) {
                 message: `Recipe not installed: ${opts.id}`,
             });
         }
+        const inspection = await inspectProjectRecipe({ project: resolved, recipeId: opts.id });
         const manifest = entry.manifest;
-        const recipeDir = resolveProjectInstalledRecipeDir(resolved, entry.id);
+        const recipeDir = entry.project_path
+            ? 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`);
@@ -57,6 +75,25 @@ export async function cmdRecipeExplainParsed(opts) {
                 process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
+        const prompts = manifest.prompts ?? [];
+        const validators = manifest.validators ?? [];
+        if (prompts.length > 0) {
+            process.stdout.write("Overlay prompts:\n");
+            for (const prompt of prompts) {
+                process.stdout.write(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}, file=${prompt.file}]\n`);
+            }
+        }
+        if (validators.length > 0) {
+            process.stdout.write("Overlay validators:\n");
+            for (const validator of validators) {
+                process.stdout.write(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]\n`);
+            }
+        }
+        if (manifest.templates && Object.keys(manifest.templates).length > 0) {
+            const payload = formatJsonBlock(manifest.templates, "  ");
+            if (payload)
+                process.stdout.write(`Templates:\n${payload}\n`);
+        }
         if (scenarioDetails.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarioDetails) {

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":"AASA,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,CAkElB"}
+{"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"}

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

@@ -1,26 +1,25 @@
-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 { formatJsonBlock } from "../format.js";
-import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { readInstalledRecipesFile } from "../installed-recipes.js";
+import { resolveInstalledRecipesPath } from "../paths.js";
 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(`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`);
@@ -36,6 +35,8 @@ export async function cmdRecipeInfoParsed(opts) {
         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");
             for (const skill of skills) {
@@ -55,6 +56,18 @@ export async function cmdRecipeInfoParsed(opts) {
                 process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
+        if (prompts.length > 0) {
+            process.stdout.write("Prompts:\n");
+            for (const prompt of prompts) {
+                process.stdout.write(`  - ${prompt.id} [surface=${prompt.surface}, strength=${prompt.strength ?? "default"}]\n`);
+            }
+        }
+        if (validators.length > 0) {
+            process.stdout.write("Validators:\n");
+            for (const validator of validators) {
+                process.stdout.write(`  - ${validator.id} [kind=${validator.kind}, phase=${validator.phase}]\n`);
+            }
+        }
         if (scenarios.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarios) {

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":"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"}

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

@@ -14,25 +14,30 @@ 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 { readInstalledRecipesFile, writeInstalledRecipesFile } from "../installed-recipes.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 { resolveGlobalRecipesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveRecipesIndexCachePath, } from "../paths.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)
@@ -175,7 +180,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 +192,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.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;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"}

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

@@ -1,16 +1,12 @@
-import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { 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";
 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 +14,22 @@ export async function cmdRecipeListParsed(opts) {
         }
         if (recipes.length === 0) {
             if (flags.tag) {
-                process.stdout.write(`${emptyStateMessage(`installed recipes for tag ${flags.tag}`)}\n`);
+                process.stdout.write(`${emptyStateMessage(`cached recipes for tag ${flags.tag}`)}\n`);
                 return 0;
             }
-            process.stdout.write(`${emptyStateMessage("installed recipes", "Use `agentplane recipes list-remote` or `agentplane recipes install <id>`.")}\n`);
+            process.stdout.write(`${emptyStateMessage("cached recipes", "Use `agentplane recipes list-remote` or `agentplane recipes install <id>`.")}\n`);
             return 0;
         }
         if (flags.full) {
-            process.stdout.write(`${JSON.stringify({ schema_version: 1, updated_at: installed.updated_at, recipes }, null, 2)}\n`);
+            process.stdout.write(`${JSON.stringify({
+                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.summary || "No summary"}\n`);
+            process.stdout.write(`${entry.id}@${entry.version} [${entry.manifest.kind}] - ${entry.manifest.summary || "No summary"}\n`);
         }
         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":"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"}

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

@@ -5,7 +5,9 @@ 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 { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { removeProjectRecipeRegistryEntry } from "../project-registry.js";
 import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeRemoveParsed(opts) {
     try {
@@ -31,6 +33,9 @@ export async function cmdRecipeRemoveParsed(opts) {
             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);
         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":"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"}