agentplane 0.3.11 → 0.3.13

package/dist/commands/recipes/impl/project-installed-recipes.js

@@ -1,102 +1,58 @@
-import { mkdir, readdir, readFile } from "node:fs/promises";
+import { stat } from "node:fs/promises";
 import path from "node:path";
-import { fileExists, getPathKind } from "../../../cli/fs-utils.js";
 import { invalidFieldMessage, missingFileMessage } from "../../../cli/output.js";
-import { isRecord } from "../../../shared/guards.js";
-import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
-import { resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, } from "./paths.js";
-import { readRecipeManifest } from "./manifest.js";
 import { normalizeRecipeTags } from "./normalize.js";
-function validateRecipeInstallMetadata(raw) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("recipe install metadata", "object"));
-    const id = typeof raw.id === "string" ? raw.id.trim() : "";
-    const version = typeof raw.version === "string" ? raw.version.trim() : "";
-    const source = typeof raw.source === "string" ? raw.source.trim() : "";
-    const installedAt = typeof raw.installed_at === "string" ? raw.installed_at.trim() : "";
-    const installMode = raw.install_mode === undefined || raw.install_mode === "project-local"
-        ? raw.install_mode
-        : null;
-    if (raw.schema_version !== 1) {
-        throw new Error(invalidFieldMessage("recipe install metadata.schema_version", "1"));
-    }
-    if (!id || !version || !source || !installedAt) {
-        throw new Error(invalidFieldMessage("recipe install metadata", "id, version, source, installed_at"));
-    }
-    if (installMode === null) {
-        throw new Error(invalidFieldMessage("recipe install metadata.install_mode", '"project-local"'));
-    }
-    const tags = normalizeRecipeTags(raw.tags ?? []);
-    return {
-        schema_version: 1,
-        id,
-        version,
-        source,
-        installed_at: installedAt,
-        tags,
-        install_mode: installMode,
-    };
-}
+import { readProjectRecipesRegistry } from "./project-registry.js";
+import { readRecipeManifest } from "./manifest.js";
+import { resolveProjectRecipesDir } from "./paths.js";
 function sortInstalledRecipes(entries) {
-    return [...entries].toSorted((a, b) => a.id.localeCompare(b.id));
+    return [...entries].toSorted((left, right) => left.id.localeCompare(right.id));
 }
-export async function readRecipeInstallMetadata(filePath) {
+async function pathExistsAsKind(filePath, kind) {
     try {
-        const raw = JSON.parse(await readFile(filePath, "utf8"));
-        return validateRecipeInstallMetadata(raw);
+        const stats = await stat(filePath);
+        return kind === "dir" ? stats.isDirectory() : stats.isFile();
     }
-    catch (err) {
-        const code = err?.code;
-        if (code === "ENOENT")
-            return null;
-        throw err;
+    catch {
+        return false;
     }
 }
-export async function writeRecipeInstallMetadata(filePath, metadata) {
-    await mkdir(path.dirname(filePath), { recursive: true });
-    await writeJsonStableIfChanged(filePath, metadata);
-}
 export async function readProjectInstalledRecipes(opts) {
-    const recipesDir = resolveProjectRecipesDir(opts);
-    if ((await getPathKind(recipesDir)) !== "dir") {
+    const registry = await readProjectRecipesRegistry(opts);
+    if (registry.recipes.length === 0) {
         return { schema_version: 1, updated_at: "", recipes: [] };
     }
     const entries = [];
-    const dirs = await readdir(recipesDir, { withFileTypes: true });
-    for (const dirent of dirs) {
-        if (!dirent.isDirectory())
-            continue;
-        const recipeDir = resolveProjectInstalledRecipeDir(opts, dirent.name);
+    for (const registryEntry of registry.recipes) {
+        const recipeDir = path.join(resolveProjectRecipesDir(opts), registryEntry.path);
+        if (!(await pathExistsAsKind(recipeDir, "dir"))) {
+            throw new Error(missingFileMessage("vendored recipe directory", recipeDir));
+        }
         const manifestPath = path.join(recipeDir, "manifest.json");
-        if (!(await fileExists(manifestPath))) {
+        if (!(await pathExistsAsKind(manifestPath, "file"))) {
             throw new Error(missingFileMessage("installed recipe manifest", manifestPath));
         }
         const manifest = await readRecipeManifest(manifestPath);
-        if (manifest.id !== dirent.name) {
-            throw new Error(invalidFieldMessage(`installed recipe directory ${dirent.name}`, `manifest.id=${dirent.name}`));
-        }
-        const metadata = await readRecipeInstallMetadata(resolveProjectRecipeInstallMetaPath(opts, dirent.name));
-        if (metadata && (metadata.id !== manifest.id || metadata.version !== manifest.version)) {
-            throw new Error(invalidFieldMessage(`recipe install metadata ${dirent.name}`, "id/version matching manifest"));
+        if (manifest.id !== registryEntry.id || manifest.version !== registryEntry.version) {
+            throw new Error(invalidFieldMessage(`installed recipe directory ${registryEntry.id}`, `manifest.id=${registryEntry.id} and manifest.version=${registryEntry.version}`));
         }
         entries.push({
             id: manifest.id,
             version: manifest.version,
-            source: metadata?.source ?? "project-local",
-            installed_at: metadata?.installed_at ?? "",
-            tags: normalizeRecipeTags(metadata?.tags ?? manifest.tags ?? []),
+            source: registryEntry.source_ref,
+            source_ref: registryEntry.source_ref,
+            source_sha256: registryEntry.source_sha256,
+            vendored_sha256: registryEntry.vendored_sha256,
+            materialization: registryEntry.materialization,
+            installed_at: registryEntry.installed_at,
+            project_path: registryEntry.path,
+            tags: normalizeRecipeTags(registryEntry.tags ?? manifest.tags ?? []),
             manifest,
         });
     }
-    const sorted = sortInstalledRecipes(entries);
-    const updatedAt = sorted
-        .map((entry) => entry.installed_at)
-        .filter(Boolean)
-        .toSorted()
-        .at(-1);
     return {
         schema_version: 1,
-        updated_at: updatedAt ?? "",
-        recipes: sorted,
+        updated_at: registry.updated_at,
+        recipes: sortInstalledRecipes(entries),
     };
 }

package/dist/commands/recipes/impl/project-recipe-state.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectInstalledRecipeEntry, ProjectRecipeState } from "./types.js";
+export declare function hashRecipeTree(rootDir: string): Promise<string>;
+export type ProjectRecipeInspection = {
+    entry: ProjectInstalledRecipeEntry;
+    recipe_dir: string;
+    source_dir: string;
+    cache_present: boolean;
+    current_source_sha256?: string;
+    current_vendored_sha256: string;
+    state: ProjectRecipeState;
+};
+export declare function inspectProjectRecipe(opts: {
+    project: {
+        agentplaneDir: string;
+    };
+    recipeId: string;
+}): Promise<ProjectRecipeInspection>;
+//# sourceMappingURL=project-recipe-state.d.ts.map

package/dist/commands/recipes/impl/project-recipe-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-recipe-state.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project-recipe-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA+BlF,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,2BAA2B,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AA2BF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwCnC"}

package/dist/commands/recipes/impl/project-recipe-state.js

@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import { lstat, readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { readProjectInstalledRecipes } from "./project-installed-recipes.js";
+import { resolveInstalledRecipeDir, resolveProjectVendoredRecipeDir } from "./paths.js";
+async function hashTreeEntry(rootDir, relativeDir, hash) {
+    const directoryPath = relativeDir ? path.join(rootDir, relativeDir) : rootDir;
+    const directoryEntries = await readdir(directoryPath, { withFileTypes: true });
+    const entries = directoryEntries.toSorted((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+        const relativePath = relativeDir ? path.posix.join(relativeDir, entry.name) : entry.name;
+        const absolutePath = path.join(rootDir, relativePath);
+        if (entry.isDirectory()) {
+            hash.update(`dir:${relativePath}\n`);
+            await hashTreeEntry(rootDir, relativePath, hash);
+            continue;
+        }
+        if (entry.isSymbolicLink()) {
+            hash.update(`symlink:${relativePath}\n`);
+            continue;
+        }
+        const data = await readFile(absolutePath);
+        hash.update(`file:${relativePath}\n`);
+        hash.update(data);
+        hash.update("\n");
+    }
+}
+export async function hashRecipeTree(rootDir) {
+    const hash = createHash("sha256");
+    await hashTreeEntry(rootDir, "", hash);
+    return hash.digest("hex");
+}
+function classifyRecipeState(opts) {
+    if (opts.entry.materialization === "link" && !opts.vendoredPathIsSymlink) {
+        return "modified";
+    }
+    const vendoredModified = opts.currentVendoredSha256 !== opts.entry.vendored_sha256;
+    const cacheDiverged = opts.cachePresent && opts.currentSourceSha256 !== undefined
+        ? opts.currentSourceSha256 !== opts.entry.source_sha256
+        : false;
+    if (opts.entry.materialization === "link") {
+        if (cacheDiverged)
+            return "diverged_from_cache";
+        if (vendoredModified)
+            return "modified";
+        return "clean";
+    }
+    if (vendoredModified)
+        return "modified";
+    if (cacheDiverged)
+        return "diverged_from_cache";
+    return "clean";
+}
+export async function inspectProjectRecipe(opts) {
+    const installed = await readProjectInstalledRecipes(opts.project);
+    const entry = installed.recipes.find((recipe) => recipe.id === opts.recipeId);
+    if (!entry) {
+        throw new Error(`Recipe not installed: ${opts.recipeId}`);
+    }
+    const recipeDir = resolveProjectVendoredRecipeDir(opts.project, entry.id);
+    const sourceDir = resolveInstalledRecipeDir({ id: entry.id, version: entry.version });
+    const vendoredPathStat = await lstat(recipeDir);
+    const vendoredPathIsSymlink = vendoredPathStat.isSymbolicLink();
+    const currentVendoredSha256 = await hashRecipeTree(recipeDir);
+    let cachePresent = false;
+    let currentSourceSha256;
+    try {
+        const sourceStat = await lstat(sourceDir);
+        if (sourceStat.isDirectory() || sourceStat.isSymbolicLink()) {
+            cachePresent = true;
+            currentSourceSha256 = await hashRecipeTree(sourceDir);
+        }
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code !== "ENOENT")
+            throw error;
+    }
+    return {
+        entry,
+        recipe_dir: recipeDir,
+        source_dir: sourceDir,
+        cache_present: cachePresent,
+        current_source_sha256: currentSourceSha256,
+        current_vendored_sha256: currentVendoredSha256,
+        state: classifyRecipeState({
+            entry,
+            cachePresent,
+            currentSourceSha256,
+            currentVendoredSha256,
+            vendoredPathIsSymlink,
+        }),
+    };
+}

package/dist/commands/recipes/impl/project-registry.d.ts

@@ -0,0 +1,20 @@
+import type { ProjectRecipeRegistryEntry, ProjectRecipesRegistryFile } from "./types.js";
+export declare function readProjectRecipesRegistry(opts: {
+    agentplaneDir: string;
+}): Promise<ProjectRecipesRegistryFile>;
+export declare function writeProjectRecipesRegistry(opts: {
+    agentplaneDir: string;
+}, file: ProjectRecipesRegistryFile): Promise<void>;
+export declare function upsertProjectRecipeRegistryEntry(opts: {
+    project: {
+        agentplaneDir: string;
+    };
+    entry: ProjectRecipeRegistryEntry;
+}): Promise<ProjectRecipesRegistryFile>;
+export declare function removeProjectRecipeRegistryEntry(opts: {
+    project: {
+        agentplaneDir: string;
+    };
+    recipeId: string;
+}): Promise<ProjectRecipesRegistryFile>;
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/commands/recipes/impl/project-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAsDpB,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAwBtC;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EAC/B,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,KAAK,EAAE,0BAA0B,CAAC;CACnC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAOtC;AAED,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAStC"}

package/dist/commands/recipes/impl/project-registry.js

@@ -0,0 +1,104 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { invalidFieldMessage } from "../../../cli/output.js";
+import { isRecord } from "../../../shared/guards.js";
+import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
+import { normalizeRecipeId, normalizeRecipeTags } from "./normalize.js";
+import { resolveProjectRecipesRegistryPath } from "./paths.js";
+function validateMaterialization(raw) {
+    if (raw === "copy" || raw === "link")
+        return raw;
+    throw new Error(invalidFieldMessage("recipes registry materialization", '"copy" | "link"'));
+}
+function validateRegistryEntry(raw) {
+    if (!isRecord(raw))
+        throw new Error(invalidFieldMessage("recipes registry entry", "object"));
+    const id = normalizeRecipeId(typeof raw.id === "string" ? raw.id.trim() : "");
+    const version = typeof raw.version === "string" ? raw.version.trim() : "";
+    const entryPath = typeof raw.path === "string" ? raw.path.trim() : "";
+    const sourceRef = typeof raw.source_ref === "string" ? raw.source_ref.trim() : "";
+    const sourceSha256 = typeof raw.source_sha256 === "string" ? raw.source_sha256.trim() : "";
+    const vendoredSha256 = typeof raw.vendored_sha256 === "string" ? raw.vendored_sha256.trim() : "";
+    const installedAt = typeof raw.installed_at === "string" ? raw.installed_at.trim() : "";
+    if (!id ||
+        !version ||
+        !entryPath ||
+        !sourceRef ||
+        !sourceSha256 ||
+        !vendoredSha256 ||
+        !installedAt) {
+        throw new Error(invalidFieldMessage("recipes registry entry", "id, version, path, source_ref, source_sha256, vendored_sha256, installed_at"));
+    }
+    return {
+        id,
+        version,
+        path: entryPath,
+        active: raw.active === true,
+        materialization: validateMaterialization(raw.materialization),
+        source_ref: sourceRef,
+        source_sha256: sourceSha256,
+        vendored_sha256: vendoredSha256,
+        installed_at: installedAt,
+        tags: normalizeRecipeTags(raw.tags ?? []),
+    };
+}
+function sortRegistry(file) {
+    return {
+        schema_version: 1,
+        updated_at: file.updated_at,
+        recipes: [...file.recipes].toSorted((left, right) => left.id.localeCompare(right.id)),
+    };
+}
+export async function readProjectRecipesRegistry(opts) {
+    try {
+        const raw = JSON.parse(await readFile(resolveProjectRecipesRegistryPath(opts), "utf8"));
+        if (!isRecord(raw))
+            throw new Error(invalidFieldMessage("recipes registry", "object"));
+        if (raw.schema_version !== 1) {
+            throw new Error(invalidFieldMessage("recipes registry.schema_version", "1"));
+        }
+        if (!Array.isArray(raw.recipes)) {
+            throw new Error(invalidFieldMessage("recipes registry.recipes", "array"));
+        }
+        return sortRegistry({
+            schema_version: 1,
+            updated_at: typeof raw.updated_at === "string" ? raw.updated_at : "",
+            recipes: raw.recipes.map((entry) => validateRegistryEntry(entry)),
+        });
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT") {
+            return { schema_version: 1, updated_at: "", recipes: [] };
+        }
+        throw err;
+    }
+}
+export async function writeProjectRecipesRegistry(opts, file) {
+    const sorted = sortRegistry({
+        schema_version: 1,
+        updated_at: new Date().toISOString(),
+        recipes: file.recipes,
+    });
+    const filePath = resolveProjectRecipesRegistryPath(opts);
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeJsonStableIfChanged(filePath, sorted);
+}
+export async function upsertProjectRecipeRegistryEntry(opts) {
+    const registry = await readProjectRecipesRegistry(opts.project);
+    const recipes = registry.recipes.filter((entry) => entry.id !== opts.entry.id);
+    recipes.push(opts.entry);
+    const next = { schema_version: 1, updated_at: registry.updated_at, recipes };
+    await writeProjectRecipesRegistry(opts.project, next);
+    return readProjectRecipesRegistry(opts.project);
+}
+export async function removeProjectRecipeRegistryEntry(opts) {
+    const registry = await readProjectRecipesRegistry(opts.project);
+    const next = {
+        schema_version: 1,
+        updated_at: registry.updated_at,
+        recipes: registry.recipes.filter((entry) => entry.id !== opts.recipeId),
+    };
+    await writeProjectRecipesRegistry(opts.project, next);
+    return readProjectRecipesRegistry(opts.project);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAEhC,KAAK,qBAAqB,EAE1B,KAAK,wBAAwB,EAE7B,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACrC,MAAM,YAAY,CAAC;AA+BpB,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CASjC;AAYD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,2BAA2B,CAkG9B;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,wBAAwB,GACjC,wBAAwB,CAO1B;AAmDD,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAsBpC;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,mCAAmC,CAAC;CAC5C,GAAG,OAAO,CAAC,+BAA+B,CAAC,CA6D3C"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAEhC,KAAK,qBAAqB,EAE1B,KAAK,wBAAwB,EAE7B,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACrC,MAAM,YAAY,CAAC;AA+BpB,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CASjC;AAYD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,2BAA2B,CAkG9B;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,wBAAwB,GACjC,wBAAwB,CAO1B;AAqDD,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAsBpC;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,mCAAmC,CAAC;CAC5C,GAAG,OAAO,CAAC,+BAA+B,CAAC,CA6D3C"}

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

@@ -3,7 +3,7 @@ import { fileExists } from "../../../cli/fs-utils.js";
 import { getVersion } from "../../../meta/version.js";
 import { dedupeStrings } from "../../../shared/strings.js";
 import { compareVersions } from "../../../shared/version-compare.js";
-import { resolveProjectInstalledRecipeDir } from "./paths.js";
+import { resolveProjectRecipesDir, resolveProjectInstalledRecipeDir } from "./paths.js";
 import { readProjectInstalledRecipes } from "./project-installed-recipes.js";
 import { readScenarioDefinition } from "./scenario.js";
 const SUPPORTED_MANIFEST_API_VERSION = "1";
@@ -109,8 +109,10 @@ export function normalizeResolvedRecipeRunProfile(scenario) {
     };
 }
 function toResolvedRecipeScenarios(opts) {
-    const recipeDir = resolveProjectInstalledRecipeDir(opts.project, opts.entry.id);
-    return opts.entry.manifest.scenarios
+    const recipeDir = opts.entry.project_path
+        ? path.join(resolveProjectRecipesDir(opts.project), opts.entry.project_path)
+        : resolveProjectInstalledRecipeDir(opts.project, opts.entry.id);
+    return (opts.entry.manifest.scenarios ?? [])
         .map((scenario) => ({
         recipe_id: opts.entry.id,
         recipe_version: opts.entry.version,

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

@@ -1,243 +1,4 @@
-export type RecipeCompatibility = {
-    min_agentplane_version?: string;
-    manifest_api_version?: string;
-    scenario_api_version?: string;
-    runtime_api_version?: string;
-    platforms?: string[];
-    repo_types?: string[];
-};
-export type RecipeRunProfile = {
-    mode: string;
-    sandbox?: string;
-    writes_artifacts_to?: string[];
-};
-export type RecipeTaskTemplateDoc = {
-    summary?: string;
-    scope?: string;
-    plan?: string;
-    verify_steps?: string;
-    rollback_plan?: string;
-    findings?: string;
-};
-export type RecipeTaskTemplate = {
-    title: string;
-    description: string;
-    owner: string;
-    priority?: "low" | "normal" | "med" | "high";
-    tags?: string[];
-    verify?: string[];
-    doc?: RecipeTaskTemplateDoc;
-};
-export type RecipeSkillDefinition = {
-    id: string;
-    summary: string;
-    kind: string;
-    file: string;
-};
-export type RecipeToolDefinition = {
-    id: string;
-    summary: string;
-    runtime: "node" | "bash";
-    entrypoint: string;
-    permissions?: string[];
-    timeout_ms?: number;
-    cwd_policy?: string;
-};
-export type RecipeAgentDefinition = {
-    id: string;
-    display_name: string;
-    role: string;
-    summary: string;
-    skills?: string[];
-    tools?: string[];
-    file: string;
-};
-export type RecipeScenarioDescriptor = {
-    id: string;
-    name: string;
-    summary: string;
-    description?: string;
-    use_when: string[];
-    avoid_when?: string[];
-    required_inputs: string[];
-    outputs: string[];
-    permissions: string[];
-    artifacts: string[];
-    agents_involved: string[];
-    skills_used: string[];
-    tools_used: string[];
-    run_profile: RecipeRunProfile;
-    file: string;
-};
-export type RecipeResolverContext = {
-    agentplane_version: string;
-    manifest_api_version: "1";
-    scenario_api_version: "1";
-    runtime_api_version: "1";
-    platform: string;
-    repo_types: string[];
-};
-export type RecipeResolverCompatibilityFailure = {
-    field: "min_agentplane_version" | "manifest_api_version" | "scenario_api_version" | "runtime_api_version" | "platforms" | "repo_types";
-    expected: string | string[];
-    actual: string | string[] | null;
-    reason: string;
-};
-export type RecipeResolverCompatibility = {
-    ok: boolean;
-    reasons: string[];
-    failures: RecipeResolverCompatibilityFailure[];
-};
-export type ResolvedRecipeRunProfile = {
-    mode: string;
-    sandbox?: string;
-    writes_artifacts_to: string[];
-};
-export type ResolvedRecipeScenario = {
-    recipe_id: string;
-    recipe_version: string;
-    recipe_name: string;
-    recipe_summary: string;
-    recipe_tags: string[];
-    recipe_dir: string;
-    scenario_id: string;
-    scenario_name: string;
-    scenario_summary: string;
-    scenario_description?: string;
-    use_when: string[];
-    avoid_when: string[];
-    required_inputs: string[];
-    outputs: string[];
-    permissions: string[];
-    artifacts: string[];
-    agents_involved: string[];
-    skills_used: string[];
-    tools_used: string[];
-    scenario_file: string;
-    compatibility: RecipeResolverCompatibility;
-    run_profile: ResolvedRecipeRunProfile;
-    task_template?: RecipeTaskTemplate;
-};
-export type ResolveRecipeScenarioSelectionFlags = {
-    recipeId?: string;
-    scenarioId?: string;
-    tags?: string[];
-    mode?: string;
-    available_inputs?: string[];
-    includeIncompatible?: boolean;
-};
-export type ResolvedRecipeScenarioSelection = ResolvedRecipeScenario & {
-    selection_reasons: string[];
-};
-export type RecipeManifest = {
-    schema_version: "1";
-    id: string;
-    version: string;
-    name: string;
-    summary: string;
-    description: string;
-    tags?: string[];
-    compatibility?: RecipeCompatibility;
-    skills?: RecipeSkillDefinition[];
-    agents?: RecipeAgentDefinition[];
-    tools?: RecipeToolDefinition[];
-    scenarios: RecipeScenarioDescriptor[];
-};
-export type RecipeConflictMode = "fail" | "rename" | "overwrite";
-export type RecipeInstallMetadata = {
-    schema_version: 1;
-    id: string;
-    version: string;
-    source: string;
-    installed_at: string;
-    tags?: string[];
-    install_mode?: "project-local";
-};
-export type InstalledRecipeEntry = {
-    id: string;
-    version: string;
-    source: string;
-    installed_at: string;
-    tags: string[];
-    manifest: RecipeManifest;
-};
-export type InstalledRecipesFile = {
-    schema_version: 1;
-    updated_at: string;
-    recipes: InstalledRecipeEntry[];
-};
-export type ScenarioDefinition = {
-    schema_version: "1";
-    id: string;
-    summary?: string;
-    description?: string;
-    goal: string;
-    task_template: RecipeTaskTemplate;
-    inputs: unknown;
-    outputs: unknown;
-    evidence?: {
-        required: boolean;
-        files: string[];
-    };
-    steps: unknown[];
-};
-export type RecipeScenarioDetail = {
-    id: string;
-    name?: string;
-    summary?: string;
-    description?: string;
-    use_when?: string[];
-    avoid_when?: string[];
-    required_inputs?: string[];
-    permissions?: string[];
-    artifacts?: string[];
-    agents_involved?: string[];
-    skills_used?: string[];
-    tools_used?: string[];
-    run_profile?: RecipeRunProfile;
-    goal?: string;
-    task_template?: RecipeTaskTemplate;
-    inputs?: unknown;
-    outputs?: unknown;
-    evidence?: ScenarioDefinition["evidence"];
-    file?: string;
-    steps?: unknown[];
-    source: "definition" | "index" | "manifest";
-};
-export type RecipesIndex = {
-    schema_version: 1;
-    recipes: {
-        id: string;
-        summary: string;
-        description?: string;
-        versions: {
-            version: string;
-            url: string;
-            sha256: string;
-            min_agentplane_version?: string;
-            tags?: string[];
-        }[];
-    }[];
-};
-export type RecipesIndexSignature = {
-    schema_version: 1;
-    key_id: string;
-    signature: string;
-    algorithm?: string;
-};
-export type RecipeInstallSource = {
-    type: "name";
-    value: string;
-} | {
-    type: "path";
-    value: string;
-} | {
-    type: "url";
-    value: string;
-} | {
-    type: "auto";
-    value: string;
-};
+export type { CompiledRecipeAssetEntry, CompiledRecipeAssetRegistry, CompiledOverlayBundle, CompiledOverlayPromptFragment, CompiledOverlayTraceEntry, CompiledOverlayValidator, InstalledRecipeEntry, InstalledRecipesFile, OverlayPromptFragment, OverlayStrength, OverlaySurface, OverlayValidator, OverlayWhen, ProjectOverlayManifestV2, ProjectInstalledRecipeEntry, ProjectInstalledRecipesFile, ProjectRecipeMaterialization, ProjectRecipeRegistryEntry, ProjectRecipesRegistryFile, ProjectRecipeState, ProjectRecipesLockEntry, ProjectRecipesLockFile, RecipeAgentDefinition, RecipeCompatibility, RecipeConflictMode, RecipeInstallSource, RecipeKind, RecipeManifest, RecipeResolverCompatibility, RecipeResolverCompatibilityFailure, RecipeResolverContext, RecipeRunProfile, RecipeScenarioDescriptor, RecipeScenarioDetail, RecipeSkillDefinition, RecipeTaskTemplate, RecipeTaskTemplateDoc, RecipeToolDefinition, RecipesIndex, RecipesIndexSignature, ResolveRecipeScenarioSelectionFlags, ResolvedRecipeRunProfile, ResolvedRecipeScenario, ResolvedRecipeScenarioSelection, ScenarioDefinition, } from "@agentplaneorg/recipes";
 export type RecipeCachePruneFlags = {
     dryRun: boolean;
     all: boolean;