agentplane 0.3.12 → 0.3.13

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

@@ -0,0 +1,282 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { createEmptyOverlayBundle, hashOverlayInputs, } from "@agentplaneorg/recipes";
+import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
+import { readProjectInstalledRecipes } from "./project-installed-recipes.js";
+import { readProjectRecipesRegistry, writeProjectRecipesRegistry } from "./project-registry.js";
+import { resolveProjectInstalledRecipeDir, resolveProjectOverlayBundlePath, resolveProjectRecipeAssetsPath, resolveProjectRecipesDir, resolveProjectRecipesLockPath, } from "./paths.js";
+function ensureTrailingNewline(text) {
+    return text.endsWith("\n") ? text : `${text}\n`;
+}
+function stripMarkdownFrontmatter(text) {
+    if (!text.startsWith("---\n"))
+        return text;
+    const end = text.indexOf("\n---\n", 4);
+    if (end === -1)
+        return text;
+    return text.slice(end + 5);
+}
+function normalizePromptContent(text) {
+    return ensureTrailingNewline(stripMarkdownFrontmatter(text).trim());
+}
+function normalizeRecipeAssetContent(text) {
+    return ensureTrailingNewline(text.trimEnd());
+}
+function uniqueById(items) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        if (seen.has(item.id))
+            continue;
+        seen.add(item.id);
+        result.push(item);
+    }
+    return result;
+}
+function recipeAssetId(recipeId, kind, assetId) {
+    return `recipe:${recipeId}/${kind}:${assetId}`;
+}
+function relativeSource(project, absolutePath) {
+    return path.relative(project.agentplaneDir, absolutePath).replaceAll("\\", "/");
+}
+async function compileProjectRecipeAssets(opts) {
+    const entries = [];
+    for (const recipe of opts.installed.recipes) {
+        const recipeDir = recipe.project_path
+            ? path.join(resolveProjectRecipesDir(opts.project), recipe.project_path)
+            : resolveProjectInstalledRecipeDir(opts.project, recipe.id);
+        const manifest = recipe.manifest;
+        for (const agent of manifest.agents ?? []) {
+            const sourcePath = path.join(recipeDir, agent.file);
+            entries.push({
+                id: recipeAssetId(recipe.id, "agent", agent.id),
+                kind: "agent",
+                recipe_id: recipe.id,
+                recipe_version: recipe.version,
+                recipe_name: manifest.name,
+                asset_id: agent.id,
+                source: relativeSource(opts.project, sourcePath),
+                summary: agent.summary,
+                definition: agent,
+                content: normalizeRecipeAssetContent(await readFile(sourcePath, "utf8")),
+            });
+        }
+        for (const skill of manifest.skills ?? []) {
+            const sourcePath = path.join(recipeDir, skill.file);
+            entries.push({
+                id: recipeAssetId(recipe.id, "skill", skill.id),
+                kind: "skill",
+                recipe_id: recipe.id,
+                recipe_version: recipe.version,
+                recipe_name: manifest.name,
+                asset_id: skill.id,
+                source: relativeSource(opts.project, sourcePath),
+                summary: skill.summary,
+                definition: skill,
+                content: normalizeRecipeAssetContent(await readFile(sourcePath, "utf8")),
+            });
+        }
+        for (const tool of manifest.tools ?? []) {
+            entries.push({
+                id: recipeAssetId(recipe.id, "tool", tool.id),
+                kind: "tool",
+                recipe_id: recipe.id,
+                recipe_version: recipe.version,
+                recipe_name: manifest.name,
+                asset_id: tool.id,
+                source: relativeSource(opts.project, path.join(recipeDir, tool.entrypoint)),
+                summary: tool.summary,
+                definition: tool,
+            });
+        }
+        for (const scenario of manifest.scenarios ?? []) {
+            entries.push({
+                id: recipeAssetId(recipe.id, "scenario", scenario.id),
+                kind: "scenario",
+                recipe_id: recipe.id,
+                recipe_version: recipe.version,
+                recipe_name: manifest.name,
+                asset_id: scenario.id,
+                source: relativeSource(opts.project, path.join(recipeDir, scenario.file)),
+                summary: scenario.summary,
+                definition: scenario,
+            });
+        }
+        for (const [templateKey, content] of Object.entries(manifest.templates ?? {})) {
+            entries.push({
+                id: recipeAssetId(recipe.id, "template", templateKey),
+                kind: "template",
+                recipe_id: recipe.id,
+                recipe_version: recipe.version,
+                recipe_name: manifest.name,
+                asset_id: templateKey,
+                source: relativeSource(opts.project, path.join(recipeDir, "manifest.json")),
+                content,
+            });
+        }
+    }
+    return {
+        schema_version: 1,
+        kind: "recipe_asset_registry",
+        entries: uniqueById(entries).toSorted((left, right) => left.id.localeCompare(right.id)),
+    };
+}
+export async function readActiveRecipeIds(project) {
+    const registry = await readProjectRecipesRegistry(project);
+    return registry.recipes
+        .filter((entry) => entry.active)
+        .map((entry) => entry.id)
+        .toSorted();
+}
+export async function setRecipeActive(opts) {
+    const registry = await readProjectRecipesRegistry(opts.project);
+    const current = new Set();
+    const recipes = registry.recipes.map((entry) => {
+        const isTarget = entry.id === opts.recipeId;
+        const active = isTarget ? opts.active : entry.active;
+        if (active)
+            current.add(entry.id);
+        return isTarget ? { ...entry, active } : entry;
+    });
+    await writeProjectRecipesRegistry(opts.project, {
+        schema_version: 1,
+        updated_at: registry.updated_at,
+        recipes,
+    });
+    return [...current].toSorted();
+}
+export async function compileProjectOverlayArtifacts(project) {
+    const [activeIds, installed] = await Promise.all([
+        readActiveRecipeIds(project),
+        readProjectInstalledRecipes(project),
+    ]);
+    const bundle = createEmptyOverlayBundle();
+    const lock = { schema_version: 1, active: [] };
+    for (const recipeId of activeIds) {
+        const entry = installed.recipes.find((candidate) => candidate.id === recipeId);
+        if (!entry) {
+            throw new Error(`Active overlay is not installed: ${recipeId}`);
+        }
+        if (entry.manifest.kind !== "project_overlay") {
+            throw new Error(`Active recipe ${recipeId} is not a project overlay`);
+        }
+        const manifest = entry.manifest;
+        const recipeDir = entry.project_path
+            ? path.join(resolveProjectRecipesDir(project), entry.project_path)
+            : resolveProjectInstalledRecipeDir(project, entry.id);
+        const promptInputs = [];
+        if (manifest.requires) {
+            for (const required of manifest.requires) {
+                if (!activeIds.includes(required)) {
+                    throw new Error(`Overlay ${manifest.id} requires active overlay ${required}`);
+                }
+            }
+        }
+        if (manifest.conflicts) {
+            for (const conflict of manifest.conflicts) {
+                if (activeIds.includes(conflict.recipe_id)) {
+                    throw new Error(`Overlay ${manifest.id} conflicts with ${conflict.recipe_id}: ${conflict.reason}`);
+                }
+            }
+        }
+        for (const fragment of manifest.prompts ?? []) {
+            const absPath = path.join(recipeDir, fragment.file);
+            const content = normalizePromptContent(await readFile(absPath, "utf8"));
+            promptInputs.push({ id: fragment.id, content });
+            bundle.surfaces[fragment.surface].push({
+                ...fragment,
+                recipe_id: manifest.id,
+                recipe_version: manifest.version,
+                recipe_name: manifest.name,
+                summary: manifest.summary,
+                source: path.relative(project.agentplaneDir, absPath).replaceAll("\\", "/"),
+                content,
+            });
+            bundle.trace.push({
+                recipe_id: manifest.id,
+                recipe_version: manifest.version,
+                accepted: true,
+                reason: "compiled prompt fragment",
+                source: fragment.file,
+                surface: fragment.surface,
+                fragment_id: fragment.id,
+            });
+        }
+        for (const validator of manifest.validators ?? []) {
+            bundle.validators.push({
+                ...validator,
+                recipe_id: manifest.id,
+                recipe_version: manifest.version,
+            });
+            bundle.trace.push({
+                recipe_id: manifest.id,
+                recipe_version: manifest.version,
+                accepted: true,
+                reason: "compiled validator",
+                validator_id: validator.id,
+            });
+        }
+        bundle.active.push({
+            id: manifest.id,
+            version: manifest.version,
+            name: manifest.name,
+            summary: manifest.summary,
+        });
+        bundle.agents.push(...(manifest.agents ?? []));
+        bundle.tools.push(...(manifest.tools ?? []));
+        Object.assign(bundle.templates, manifest.templates ?? {});
+        lock.active.push({
+            id: manifest.id,
+            version: manifest.version,
+            kind: manifest.kind,
+            source: entry.source,
+            hash: hashOverlayInputs({ manifest, prompts: promptInputs }),
+        });
+    }
+    bundle.agents = uniqueById(bundle.agents);
+    bundle.tools = uniqueById(bundle.tools);
+    for (const surface of Object.keys(bundle.surfaces)) {
+        bundle.surfaces[surface] = bundle.surfaces[surface].toSorted((left, right) => (left.order ?? 0) - (right.order ?? 0) ||
+            left.recipe_id.localeCompare(right.recipe_id) ||
+            left.id.localeCompare(right.id));
+    }
+    lock.active = lock.active.toSorted((left, right) => left.id.localeCompare(right.id));
+    return {
+        bundle,
+        lock,
+        assets: await compileProjectRecipeAssets({ project, installed }),
+    };
+}
+export async function refreshProjectOverlayArtifacts(project) {
+    const compiled = await compileProjectOverlayArtifacts(project);
+    const bundlePath = resolveProjectOverlayBundlePath(project);
+    const lockPath = resolveProjectRecipesLockPath(project);
+    const assetsPath = resolveProjectRecipeAssetsPath(project);
+    await mkdir(path.dirname(bundlePath), { recursive: true });
+    await writeJsonStableIfChanged(bundlePath, compiled.bundle);
+    await writeJsonStableIfChanged(lockPath, compiled.lock);
+    await writeJsonStableIfChanged(assetsPath, compiled.assets);
+    return compiled;
+}
+export async function readProjectOverlayBundle(project) {
+    try {
+        return JSON.parse(await readFile(resolveProjectOverlayBundlePath(project), "utf8"));
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function readProjectRecipeAssetRegistry(project) {
+    try {
+        return JSON.parse(await readFile(resolveProjectRecipeAssetsPath(project), "utf8"));
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}

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

@@ -10,13 +10,31 @@ export declare function resolveInstalledRecipeDir(entry: {
 export declare function resolveProjectRecipesDir(resolved: {
     agentplaneDir: string;
 }): string;
-export declare function resolveProjectInstalledRecipeDir(resolved: {
+export declare function resolveProjectRecipesPackagesDir(resolved: {
+    agentplaneDir: string;
+}): string;
+export declare function resolveProjectRecipesRegistryPath(resolved: {
+    agentplaneDir: string;
+}): string;
+export declare function resolveProjectVendoredRecipeDir(resolved: {
     agentplaneDir: string;
 }, recipeId: string): string;
-export declare function resolveProjectRecipeInstallMetaPath(resolved: {
+export declare function resolveProjectInstalledRecipeDir(resolved: {
     agentplaneDir: string;
 }, recipeId: string): string;
 export declare function resolveProjectRecipesCacheDir(resolved: {
     agentplaneDir: string;
 }): string;
+export declare function resolveProjectRecipesLockPath(resolved: {
+    agentplaneDir: string;
+}): string;
+export declare function resolveProjectGeneratedDir(resolved: {
+    agentplaneDir: string;
+}): string;
+export declare function resolveProjectOverlayBundlePath(resolved: {
+    agentplaneDir: string;
+}): string;
+export declare function resolveProjectRecipeAssetsPath(resolved: {
+    agentplaneDir: string;
+}): string;
 //# sourceMappingURL=paths.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/paths.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/paths.ts"],"names":[],"mappings":"AAeA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE5F;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7F;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtF;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3F;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1F"}

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

@@ -1,6 +1,6 @@
 import os from "node:os";
 import path from "node:path";
-import { AGENTPLANE_HOME_ENV, GLOBAL_RECIPES_DIR_NAME, INSTALLED_RECIPES_NAME, RECIPE_INSTALL_META_NAME, PROJECT_RECIPES_CACHE_DIR_NAME, RECIPES_DIR_NAME, RECIPES_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, } from "./constants.js";
+import { AGENTPLANE_HOME_ENV, 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_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, } from "./constants.js";
 export function resolveAgentplaneHome() {
     const overridden = process.env[AGENTPLANE_HOME_ENV]?.trim();
     if (overridden)
@@ -25,12 +25,30 @@ export function resolveInstalledRecipeDir(entry) {
 export function resolveProjectRecipesDir(resolved) {
     return path.join(resolved.agentplaneDir, RECIPES_DIR_NAME);
 }
-export function resolveProjectInstalledRecipeDir(resolved, recipeId) {
-    return path.join(resolveProjectRecipesDir(resolved), recipeId);
+export function resolveProjectRecipesPackagesDir(resolved) {
+    return path.join(resolveProjectRecipesDir(resolved), PROJECT_RECIPES_PACKAGES_DIR_NAME);
+}
+export function resolveProjectRecipesRegistryPath(resolved) {
+    return path.join(resolveProjectRecipesDir(resolved), PROJECT_RECIPES_REGISTRY_NAME);
 }
-export function resolveProjectRecipeInstallMetaPath(resolved, recipeId) {
-    return path.join(resolveProjectInstalledRecipeDir(resolved, recipeId), RECIPE_INSTALL_META_NAME);
+export function resolveProjectVendoredRecipeDir(resolved, recipeId) {
+    return path.join(resolveProjectRecipesPackagesDir(resolved), recipeId);
+}
+export function resolveProjectInstalledRecipeDir(resolved, recipeId) {
+    return resolveProjectVendoredRecipeDir(resolved, recipeId);
 }
 export function resolveProjectRecipesCacheDir(resolved) {
     return path.join(resolved.agentplaneDir, PROJECT_RECIPES_CACHE_DIR_NAME);
 }
+export function resolveProjectRecipesLockPath(resolved) {
+    return path.join(resolved.agentplaneDir, "recipes.lock.json");
+}
+export function resolveProjectGeneratedDir(resolved) {
+    return path.join(resolved.agentplaneDir, "generated");
+}
+export function resolveProjectOverlayBundlePath(resolved) {
+    return path.join(resolveProjectGeneratedDir(resolved), "overlay-bundle.json");
+}
+export function resolveProjectRecipeAssetsPath(resolved) {
+    return path.join(resolveProjectGeneratedDir(resolved), "recipe-assets.json");
+}

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

@@ -1,7 +1,5 @@
-import type { InstalledRecipesFile, RecipeInstallMetadata } from "./types.js";
-export declare function readRecipeInstallMetadata(filePath: string): Promise<RecipeInstallMetadata | null>;
-export declare function writeRecipeInstallMetadata(filePath: string, metadata: RecipeInstallMetadata): Promise<void>;
+import type { ProjectInstalledRecipesFile } from "./types.js";
 export declare function readProjectInstalledRecipes(opts: {
     agentplaneDir: string;
-}): Promise<InstalledRecipesFile>;
+}): Promise<ProjectInstalledRecipesFile>;
 //# sourceMappingURL=project-installed-recipes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"project-installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project-installed-recipes.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAwB,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAuCpG,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CASvC;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0DhC"}
+{"version":3,"file":"project-installed-recipes.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project-installed-recipes.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAA+B,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAiB3F,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA8CvC"}

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