agentplane 0.3.5 → 0.3.6

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

@@ -3,6 +3,10 @@ export declare function moveRecipeDir(opts: {
     from: string;
     to: string;
 }): Promise<void>;
+export declare function validateRecipeAssets(opts: {
+    manifest: RecipeManifest;
+    recipeDir: string;
+}): Promise<void>;
 export declare function applyRecipeAgents(opts: {
     manifest: RecipeManifest;
     recipeDir: string;

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

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

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

@@ -24,6 +24,40 @@ export async function moveRecipeDir(opts) {
         throw err;
     }
 }
+async function readRecipeJsonObject(recipeDir, relativePath, label) {
+    const sourcePath = path.join(recipeDir, relativePath);
+    if (!(await fileExists(sourcePath))) {
+        throw new Error(missingFileMessage(label, relativePath));
+    }
+    const raw = JSON.parse(await readFile(sourcePath, "utf8"));
+    if (!isRecord(raw)) {
+        throw new Error(invalidFieldMessage(label, "JSON object", relativePath));
+    }
+}
+export async function validateRecipeAssets(opts) {
+    for (const skill of opts.manifest.skills ?? []) {
+        await readRecipeJsonObject(opts.recipeDir, skill.file, "recipe skill file");
+    }
+    for (const agent of opts.manifest.agents ?? []) {
+        await readRecipeJsonObject(opts.recipeDir, agent.file, "recipe agent file");
+    }
+    for (const tool of opts.manifest.tools ?? []) {
+        const entrypointPath = path.join(opts.recipeDir, tool.entrypoint);
+        if (!(await fileExists(entrypointPath))) {
+            throw new Error(missingFileMessage("recipe tool entrypoint", tool.entrypoint));
+        }
+    }
+    for (const scenario of opts.manifest.scenarios ?? []) {
+        const sourcePath = path.join(opts.recipeDir, scenario.file);
+        if (!(await fileExists(sourcePath))) {
+            throw new Error(missingFileMessage("recipe scenario file", scenario.file));
+        }
+        const definition = await readScenarioDefinition(sourcePath);
+        if (definition.id !== scenario.id) {
+            throw new Error(invalidFieldMessage("recipe scenario file", `scenario.id=${scenario.id}`, scenario.file));
+        }
+    }
+}
 export async function applyRecipeAgents(opts) {
     const agents = opts.manifest.agents ?? [];
     if (agents.length === 0)

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

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

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

@@ -1,13 +1,18 @@
+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 { collectRecipeScenarioDetails } from "../scenario.js";
 import { formatJsonBlock } from "../format.js";
-import { readInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipeDir, resolveInstalledRecipesPath } from "../paths.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeExplainParsed(opts) {
     try {
-        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -17,7 +22,7 @@ export async function cmdRecipeExplainParsed(opts) {
             });
         }
         const manifest = entry.manifest;
-        const recipeDir = resolveInstalledRecipeDir(entry);
+        const recipeDir = resolveProjectInstalledRecipeDir(resolved, entry.id);
         const scenarioDetails = await collectRecipeScenarioDetails(recipeDir, manifest);
         process.stdout.write(`Recipe: ${manifest.id}@${manifest.version}\n`);
         process.stdout.write(`Name: ${manifest.name}\n`);
@@ -26,35 +31,59 @@ export async function cmdRecipeExplainParsed(opts) {
         if (manifest.tags && manifest.tags.length > 0) {
             process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
         }
+        if (manifest.compatibility) {
+            const payload = formatJsonBlock(manifest.compatibility, "  ");
+            if (payload)
+                process.stdout.write(`Compatibility:\n${payload}\n`);
+        }
+        const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
         const tools = manifest.tools ?? [];
+        if (skills.length > 0) {
+            process.stdout.write("Skills:\n");
+            for (const skill of skills) {
+                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+            }
+        }
         if (agents.length > 0) {
             process.stdout.write("Agents:\n");
             for (const agent of agents) {
-                const label = agent?.id ?? "unknown";
-                const summary = agent?.summary ? ` - ${agent.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${agent.display_name} (${agent.id}) - ${agent.summary} [role=${agent.role}]\n`);
             }
         }
         if (tools.length > 0) {
             process.stdout.write("Tools:\n");
             for (const tool of tools) {
-                const label = tool?.id ?? "unknown";
-                const summary = tool?.summary ? ` - ${tool.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
         if (scenarioDetails.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarioDetails) {
+                const title = scenario.name ? `${scenario.name} (${scenario.id})` : scenario.id;
                 const summary = scenario.summary ? ` - ${scenario.summary}` : "";
-                process.stdout.write(`  - ${scenario.id}${summary}\n`);
+                process.stdout.write(`  - ${title}${summary}\n`);
                 if (scenario.description) {
                     process.stdout.write(`    Description: ${scenario.description}\n`);
                 }
                 if (scenario.goal) {
                     process.stdout.write(`    Goal: ${scenario.goal}\n`);
                 }
+                if (scenario.use_when && scenario.use_when.length > 0) {
+                    const payload = formatJsonBlock(scenario.use_when, "      ");
+                    if (payload)
+                        process.stdout.write(`    Use when:\n${payload}\n`);
+                }
+                if (scenario.avoid_when && scenario.avoid_when.length > 0) {
+                    const payload = formatJsonBlock(scenario.avoid_when, "      ");
+                    if (payload)
+                        process.stdout.write(`    Avoid when:\n${payload}\n`);
+                }
+                if (scenario.required_inputs && scenario.required_inputs.length > 0) {
+                    const payload = formatJsonBlock(scenario.required_inputs, "      ");
+                    if (payload)
+                        process.stdout.write(`    Required inputs:\n${payload}\n`);
+                }
                 if (scenario.inputs !== undefined) {
                     const payload = formatJsonBlock(scenario.inputs, "      ");
                     if (payload)
@@ -65,6 +94,36 @@ export async function cmdRecipeExplainParsed(opts) {
                     if (payload)
                         process.stdout.write(`    Outputs:\n${payload}\n`);
                 }
+                if (scenario.permissions && scenario.permissions.length > 0) {
+                    const payload = formatJsonBlock(scenario.permissions, "      ");
+                    if (payload)
+                        process.stdout.write(`    Permissions:\n${payload}\n`);
+                }
+                if (scenario.artifacts && scenario.artifacts.length > 0) {
+                    const payload = formatJsonBlock(scenario.artifacts, "      ");
+                    if (payload)
+                        process.stdout.write(`    Artifacts:\n${payload}\n`);
+                }
+                if (scenario.agents_involved && scenario.agents_involved.length > 0) {
+                    const payload = formatJsonBlock(scenario.agents_involved, "      ");
+                    if (payload)
+                        process.stdout.write(`    Agents involved:\n${payload}\n`);
+                }
+                if (scenario.skills_used && scenario.skills_used.length > 0) {
+                    const payload = formatJsonBlock(scenario.skills_used, "      ");
+                    if (payload)
+                        process.stdout.write(`    Skills used:\n${payload}\n`);
+                }
+                if (scenario.tools_used && scenario.tools_used.length > 0) {
+                    const payload = formatJsonBlock(scenario.tools_used, "      ");
+                    if (payload)
+                        process.stdout.write(`    Tools used:\n${payload}\n`);
+                }
+                if (scenario.run_profile) {
+                    const payload = formatJsonBlock(scenario.run_profile, "      ");
+                    if (payload)
+                        process.stdout.write(`    Run profile:\n${payload}\n`);
+                }
                 if (scenario.steps && scenario.steps.length > 0) {
                     process.stdout.write("    Steps:\n");
                     let stepIndex = 1;

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":"AAOA,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,CAsDlB"}
+{"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"}

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

@@ -1,11 +1,16 @@
+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 { readInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipesPath } from "../paths.js";
+import { formatJsonBlock } from "../format.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
 export async function cmdRecipeInfoParsed(opts) {
     try {
-        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -22,31 +27,38 @@ export async function cmdRecipeInfoParsed(opts) {
         if (manifest.tags && manifest.tags.length > 0) {
             process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
         }
+        if (manifest.compatibility) {
+            const payload = formatJsonBlock(manifest.compatibility, "  ");
+            if (payload)
+                process.stdout.write(`Compatibility:\n${payload}\n`);
+        }
+        const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
         const tools = manifest.tools ?? [];
         const scenarios = manifest.scenarios ?? [];
+        if (skills.length > 0) {
+            process.stdout.write("Skills:\n");
+            for (const skill of skills) {
+                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+            }
+        }
         if (agents.length > 0) {
             process.stdout.write("Agents:\n");
             for (const agent of agents) {
-                const label = agent?.id ?? "unknown";
-                const summary = agent?.summary ? ` - ${agent.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                const label = `${agent.display_name} (${agent.id})`;
+                process.stdout.write(`  - ${label} - ${agent.summary}\n`);
             }
         }
         if (tools.length > 0) {
             process.stdout.write("Tools:\n");
             for (const tool of tools) {
-                const label = tool?.id ?? "unknown";
-                const summary = tool?.summary ? ` - ${tool.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
         if (scenarios.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarios) {
-                const label = scenario?.id ?? "unknown";
-                const summary = scenario?.summary ? ` - ${scenario.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${scenario.name} (${scenario.id}) - ${scenario.summary} [mode=${scenario.run_profile.mode}]\n`);
             }
         }
         return 0;

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":"AAkCA,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,CA6NlB"}
+{"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"}

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

@@ -1,7 +1,7 @@
 import { cp, mkdir, mkdtemp, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { defaultConfig, loadConfig } from "@agentplaneorg/core";
+import { defaultConfig, loadConfig, resolveProject } from "@agentplaneorg/core";
 import { extractArchive } from "../../../../cli/archive.js";
 import { sha256File } from "../../../../cli/checksum.js";
 import { mapCoreError } from "../../../../cli/error-map.js";
@@ -12,26 +12,27 @@ import { getBundledRecipeEntry, resolveBundledRecipeSourcePath, } from "../../..
 import { CliError } from "../../../../shared/errors.js";
 import { ensureNetworkApproved } from "../../../shared/network-approval.js";
 import { resolvePathFallback } from "../../../shared/path.js";
-import { applyRecipeAgents, applyRecipeScenarios, moveRecipeDir } from "../apply.js";
+import { moveRecipeDir, validateRecipeAssets } from "../apply.js";
 import { resolveRecipeRoot } from "../archive.js";
-import { DEFAULT_RECIPES_INDEX_URL } from "../constants.js";
+import { DEFAULT_RECIPES_INDEX_URL, RECIPE_RUNS_DIR_NAME } from "../constants.js";
 import { loadRecipesRemoteIndex, willFetchRemoteRecipesIndex } from "../index.js";
-import { readInstalledRecipesFile, writeInstalledRecipesFile } from "../installed-recipes.js";
 import { readRecipeManifest } from "../manifest.js";
 import { normalizeRecipeTags } from "../normalize.js";
-import { resolveGlobalRecipesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveRecipesIndexCachePath, } from "../paths.js";
-import { maybeResolveProject } from "../project.js";
+import { writeRecipeInstallMetadata } from "../project-installed-recipes.js";
+import { resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, 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 maybeResolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride });
+        const project = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
         let config = defaultConfig();
-        if (project) {
-            const loaded = await loadConfig(project.agentplaneDir);
-            config = loaded.config;
-        }
+        const loaded = await loadConfig(project.agentplaneDir);
+        config = loaded.config;
         let networkApproved = false;
         const ensureApproved = async (reason) => {
             if (networkApproved)
@@ -173,7 +174,8 @@ export async function cmdRecipeInstall(opts) {
             const manifest = await readRecipeManifest(path.join(recipeRoot, "manifest.json"));
             const resolvedTags = manifest.tags && manifest.tags.length > 0 ? manifest.tags : normalizeRecipeTags(indexTags);
             const manifestWithTags = resolvedTags.length > 0 ? { ...manifest, tags: resolvedTags } : manifest;
-            const installDir = resolveInstalledRecipeDir(manifestWithTags);
+            await validateRecipeAssets({ manifest: manifestWithTags, recipeDir: recipeRoot });
+            const installDir = resolveProjectInstalledRecipeDir(project, manifestWithTags.id);
             const installKind = await getPathKind(installDir);
             if (installKind && installKind !== "dir") {
                 throw new CliError({
@@ -183,21 +185,31 @@ export async function cmdRecipeInstall(opts) {
                 });
             }
             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(resolveGlobalRecipesDir(), { recursive: true });
+            await mkdir(resolveProjectRecipesDir(project), { recursive: true });
             await moveRecipeDir({ from: recipeRoot, to: installDir });
             try {
-                if (project) {
-                    await applyRecipeAgents({
-                        manifest: manifestWithTags,
-                        recipeDir: installDir,
-                        agentplaneDir: project.agentplaneDir,
-                        onConflict: opts.onConflict,
+                if ((await getPathKind(preservedRunsDir)) === "dir") {
+                    await cp(preservedRunsDir, path.join(installDir, RECIPE_RUNS_DIR_NAME), {
+                        recursive: true,
                     });
                 }
-                await applyRecipeScenarios({ manifest: manifestWithTags, recipeDir: installDir });
+                await writeRecipeInstallMetadata(resolveProjectRecipeInstallMetaPath(project, manifestWithTags.id), {
+                    schema_version: 1,
+                    id: manifestWithTags.id,
+                    version: manifestWithTags.version,
+                    source: sourceLabel,
+                    installed_at: new Date().toISOString(),
+                    tags: resolvedTags,
+                    install_mode: "project-local",
+                });
             }
             catch (err) {
                 if (!hadExisting) {
@@ -205,22 +217,6 @@ export async function cmdRecipeInstall(opts) {
                 }
                 throw err;
             }
-            const recipesPath = resolveInstalledRecipesPath();
-            const installed = await readInstalledRecipesFile(recipesPath);
-            const updated = installed.recipes.filter((entry) => entry.id !== manifestWithTags.id);
-            updated.push({
-                id: manifestWithTags.id,
-                version: manifestWithTags.version,
-                source: sourceLabel,
-                installed_at: new Date().toISOString(),
-                tags: resolvedTags,
-                manifest: manifestWithTags,
-            });
-            await writeInstalledRecipesFile(recipesPath, {
-                schema_version: 1,
-                updated_at: installed.updated_at,
-                recipes: updated,
-            });
             process.stdout.write(`Installed recipe ${manifestWithTags.id}@${manifestWithTags.version}\n`);
             return 0;
         }

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/list.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ClB"}
+{"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"}

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

@@ -1,13 +1,16 @@
+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 { readInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipesPath } from "../paths.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
 export async function cmdRecipeListParsed(opts) {
     const flags = opts.flags;
     try {
-        const filePath = resolveInstalledRecipesPath();
-        const installed = await readInstalledRecipesFile(filePath);
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         let recipes = installed.recipes;
         if (flags.tag) {
             const needle = flags.tag.toLowerCase();

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":"AAUA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/remove.ts"],"names":[],"mappings":"AAYA,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,CAwBlB"}

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

@@ -1,14 +1,18 @@
+import { 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 { readInstalledRecipesFile, writeInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipeDir, resolveInstalledRecipesPath } from "../paths.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeRemoveParsed(opts) {
     try {
-        const recipesPath = resolveInstalledRecipesPath();
-        const installed = await readInstalledRecipesFile(recipesPath);
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -17,14 +21,8 @@ export async function cmdRecipeRemoveParsed(opts) {
                 message: `Recipe not installed: ${opts.id}`,
             });
         }
-        const recipeDir = resolveInstalledRecipeDir(entry);
+        const recipeDir = resolveProjectInstalledRecipeDir(resolved, entry.id);
         await rm(recipeDir, { recursive: true, force: true });
-        const updated = installed.recipes.filter((recipe) => recipe.id !== opts.id);
-        await writeInstalledRecipesFile(recipesPath, {
-            schema_version: 1,
-            updated_at: installed.updated_at,
-            recipes: updated,
-        });
         process.stdout.write(`${successMessage("removed recipe", `${entry.id}@${entry.version}`)}\n`);
         return 0;
     }

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

@@ -2,6 +2,8 @@ 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";

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;AAE7D,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,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"}

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

@@ -2,6 +2,8 @@ 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";

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":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgCnE;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":"AAeA,OAAO,KAAK,EAGV,cAAc,EAKf,MAAM,YAAY,CAAC;AAyPpB,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAsDnE;AAED,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAGtF"}