agentplane 0.3.11 → 0.3.13

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

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

@@ -0,0 +1,93 @@
+import { cp, rm, symlink } 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";
+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 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 activeIds = await readActiveRecipeIds(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 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 refreshProjectOverlayArtifacts(project);
+        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/manifest.d.ts

@@ -1,4 +1,4 @@
-import type { RecipeManifest } from "./types.js";
-export declare function validateRecipeManifest(raw: unknown): RecipeManifest;
+import { type RecipeManifest } from "@agentplaneorg/recipes";
 export declare function readRecipeManifest(manifestPath: string): Promise<RecipeManifest>;
+export declare function validateRecipeManifest(raw: unknown): RecipeManifest;
 //# sourceMappingURL=manifest.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/manifest.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAGV,cAAc,EAKf,MAAM,YAAY,CAAC;AA0OpB,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAsDnE;AAED,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAGtF"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEtF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEnE"}