agentplane 0.3.12 → 0.3.13

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

@@ -0,0 +1,93 @@
+import { cp, rm, symlink } from "node:fs/promises";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../../../cli/error-map.js";
+import { exitCodeForError } from "../../../../cli/exit-codes.js";
+import { CliError } from "../../../../shared/errors.js";
+import { ensureActionApproved } from "../../../shared/approval-requirements.js";
+import { readInstalledRecipesFile } from "../installed-recipes.js";
+import { normalizeRecipeTags } from "../normalize.js";
+import { readActiveRecipeIds, refreshProjectOverlayArtifacts } from "../overlay-project.js";
+import { hashRecipeTree, inspectProjectRecipe } from "../project-recipe-state.js";
+import { upsertProjectRecipeRegistryEntry } from "../project-registry.js";
+import { resolveInstalledRecipesPath, resolveProjectVendoredRecipeDir } from "../paths.js";
+function buildModifiedRecipeError(id) {
+    return new CliError({
+        exitCode: exitCodeForError("E_USAGE"),
+        code: "E_USAGE",
+        message: `Recipe ${id} has local project edits. Re-run with --force to overwrite the vendored copy from cache.`,
+    });
+}
+export async function cmdRecipeUpdateParsed(opts) {
+    try {
+        const project = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(project.agentplaneDir);
+        const inspection = await inspectProjectRecipe({ project, recipeId: opts.id });
+        if (!inspection.cache_present || !inspection.current_source_sha256) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message: `Cached source is missing for ${inspection.entry.id}@${inspection.entry.version}. Run agentplane recipes install ${inspection.entry.id}@${inspection.entry.version}`,
+            });
+        }
+        if (inspection.state === "modified" && !opts.force) {
+            throw buildModifiedRecipeError(inspection.entry.id);
+        }
+        const cache = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const cached = cache.recipes.find((entry) => entry.id === inspection.entry.id && entry.version === inspection.entry.version);
+        if (!cached) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message: `Recipe not found in global cache: ${inspection.entry.id}@${inspection.entry.version}`,
+            });
+        }
+        const activeIds = await readActiveRecipeIds(project);
+        if (inspection.entry.materialization === "copy" &&
+            inspection.state === "clean" &&
+            inspection.current_source_sha256 === inspection.entry.source_sha256) {
+            process.stdout.write(`Recipe ${inspection.entry.id}@${inspection.entry.version} is already up to date.\n`);
+            return 0;
+        }
+        await ensureActionApproved({
+            action: "dangerous_fs",
+            config: loaded.config,
+            yes: false,
+            reason: `recipes update ${inspection.entry.id}@${inspection.entry.version}`,
+        });
+        const targetDir = resolveProjectVendoredRecipeDir(project, inspection.entry.id);
+        await rm(targetDir, { recursive: true, force: true });
+        await (inspection.entry.materialization === "link"
+            ? symlink(inspection.source_dir, targetDir, "dir")
+            : cp(inspection.source_dir, targetDir, { recursive: true }));
+        const vendoredSha256 = await hashRecipeTree(targetDir);
+        await upsertProjectRecipeRegistryEntry({
+            project,
+            entry: {
+                id: inspection.entry.id,
+                version: inspection.entry.version,
+                path: inspection.entry.project_path,
+                active: activeIds.includes(inspection.entry.id),
+                materialization: inspection.entry.materialization,
+                source_ref: inspection.entry.source_ref,
+                source_sha256: inspection.current_source_sha256,
+                vendored_sha256: vendoredSha256,
+                installed_at: inspection.entry.installed_at,
+                tags: normalizeRecipeTags(cached.tags ?? cached.manifest.tags ?? []),
+            },
+        });
+        await refreshProjectOverlayArtifacts(project);
+        const verb = inspection.entry.materialization === "link"
+            ? "Refreshed linked recipe"
+            : "Updated vendored recipe";
+        process.stdout.write(`${verb} ${inspection.entry.id}@${inspection.entry.version} from cache.\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "recipes update", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -1,8 +1,15 @@
+export { cmdRecipeAddParsed } from "./commands/add.js";
+export { cmdRecipeDetachParsed } from "./commands/detach.js";
 export { cmdRecipeListParsed } from "./commands/list.js";
 export { cmdRecipeListRemoteParsed } from "./commands/list-remote.js";
 export { cmdRecipeInfoParsed } from "./commands/info.js";
 export { cmdRecipeExplainParsed } from "./commands/explain.js";
+export { cmdRecipeActiveParsed } from "./commands/active.js";
+export { cmdRecipeExplainActiveParsed } from "./commands/explain-active.js";
+export { cmdRecipeEnableParsed } from "./commands/enable.js";
+export { cmdRecipeDisableParsed } from "./commands/disable.js";
 export { cmdRecipeInstall } from "./commands/install.js";
 export { cmdRecipeRemoveParsed } from "./commands/remove.js";
+export { cmdRecipeUpdateParsed } from "./commands/update.js";
 export { cmdRecipeCachePruneParsed } from "./commands/cache-prune.js";
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -1,7 +1,14 @@
+export { cmdRecipeAddParsed } from "./commands/add.js";
+export { cmdRecipeDetachParsed } from "./commands/detach.js";
 export { cmdRecipeListParsed } from "./commands/list.js";
 export { cmdRecipeListRemoteParsed } from "./commands/list-remote.js";
 export { cmdRecipeInfoParsed } from "./commands/info.js";
 export { cmdRecipeExplainParsed } from "./commands/explain.js";
+export { cmdRecipeActiveParsed } from "./commands/active.js";
+export { cmdRecipeExplainActiveParsed } from "./commands/explain-active.js";
+export { cmdRecipeEnableParsed } from "./commands/enable.js";
+export { cmdRecipeDisableParsed } from "./commands/disable.js";
 export { cmdRecipeInstall } from "./commands/install.js";
 export { cmdRecipeRemoveParsed } from "./commands/remove.js";
+export { cmdRecipeUpdateParsed } from "./commands/update.js";
 export { cmdRecipeCachePruneParsed } from "./commands/cache-prune.js";

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

@@ -1,15 +1,2 @@
-export declare const INSTALLED_RECIPES_NAME = "recipes.json";
-export declare const RECIPES_DIR_NAME = "recipes";
-export declare const RECIPES_SCENARIOS_DIR_NAME = "scenarios";
-export declare const RECIPES_SCENARIOS_INDEX_NAME = "scenarios.json";
-export declare const RECIPE_INSTALL_META_NAME = ".install.json";
-export declare const RECIPE_RUNS_DIR_NAME = "runs";
-export declare const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
-export declare const GLOBAL_RECIPES_DIR_NAME = "recipes";
-export declare const PROJECT_RECIPES_CACHE_DIR_NAME = "recipes-cache";
-export declare const RECIPES_REMOTE_INDEX_NAME = "recipes-index.json";
-export declare const RECIPES_REMOTE_INDEX_SIG_NAME = "recipes-index.json.sig";
-export declare const DEFAULT_RECIPES_INDEX_URL = "https://raw.githubusercontent.com/basilisk-labs/agentplane-recipes/main/index.json";
-export declare const RECIPES_INDEX_PUBLIC_KEYS_ENV = "AGENTPLANE_RECIPES_INDEX_PUBLIC_KEYS";
-export declare const RECIPES_INDEX_PUBLIC_KEYS: Record<string, string>;
+export { AGENTPLANE_HOME_ENV, DEFAULT_RECIPES_INDEX_URL, GLOBAL_RECIPES_DIR_NAME, INSTALLED_RECIPES_NAME, PROJECT_RECIPES_PACKAGES_DIR_NAME, PROJECT_RECIPES_REGISTRY_NAME, PROJECT_RECIPES_CACHE_DIR_NAME, RECIPES_DIR_NAME, RECIPES_INDEX_PUBLIC_KEYS, RECIPES_INDEX_PUBLIC_KEYS_ENV, RECIPES_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, RECIPE_RUNS_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, } from "@agentplaneorg/recipes";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,eAAO,MAAM,uBAAuB,YAAY,CAAC;AACjD,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAE9D,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AAEtE,eAAO,MAAM,yBAAyB,uFACgD,CAAC;AAEvF,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI5D,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

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

@@ -1,18 +1 @@
-export const INSTALLED_RECIPES_NAME = "recipes.json";
-export const RECIPES_DIR_NAME = "recipes";
-export const RECIPES_SCENARIOS_DIR_NAME = "scenarios";
-export const RECIPES_SCENARIOS_INDEX_NAME = "scenarios.json";
-export const RECIPE_INSTALL_META_NAME = ".install.json";
-export const RECIPE_RUNS_DIR_NAME = "runs";
-export const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
-export const GLOBAL_RECIPES_DIR_NAME = "recipes";
-export const PROJECT_RECIPES_CACHE_DIR_NAME = "recipes-cache";
-export const RECIPES_REMOTE_INDEX_NAME = "recipes-index.json";
-export const RECIPES_REMOTE_INDEX_SIG_NAME = "recipes-index.json.sig";
-export const DEFAULT_RECIPES_INDEX_URL = "https://raw.githubusercontent.com/basilisk-labs/agentplane-recipes/main/index.json";
-export const RECIPES_INDEX_PUBLIC_KEYS_ENV = "AGENTPLANE_RECIPES_INDEX_PUBLIC_KEYS";
-export const RECIPES_INDEX_PUBLIC_KEYS = {
-    "2026-02": `-----BEGIN PUBLIC KEY-----
-MCowBQYDK2VwAyEAeRWdXKVZtz0v+bnQS3zb24jMfa0gflsRUHQkeJkji6E=
------END PUBLIC KEY-----`,
-};
+export { AGENTPLANE_HOME_ENV, DEFAULT_RECIPES_INDEX_URL, GLOBAL_RECIPES_DIR_NAME, INSTALLED_RECIPES_NAME, PROJECT_RECIPES_PACKAGES_DIR_NAME, PROJECT_RECIPES_REGISTRY_NAME, PROJECT_RECIPES_CACHE_DIR_NAME, RECIPES_DIR_NAME, RECIPES_INDEX_PUBLIC_KEYS, RECIPES_INDEX_PUBLIC_KEYS_ENV, RECIPES_REMOTE_INDEX_NAME, RECIPES_REMOTE_INDEX_SIG_NAME, RECIPE_RUNS_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, } from "@agentplaneorg/recipes";

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

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

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

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

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

@@ -1,229 +1,7 @@
-import { readFile } from "node:fs/promises";
-import { invalidFieldMessage, requiredFieldMessage } from "../../../cli/output.js";
-import { isRecord } from "../../../shared/guards.js";
-import { dedupeStrings } from "../../../shared/strings.js";
-import { normalizeAgentId, normalizeRecipeId, normalizeRecipeRelativePath, normalizeRecipeTags, normalizeScenarioId, normalizeSkillId, normalizeToolId, } from "./normalize.js";
-function normalizeRequiredString(raw, field) {
-    if (typeof raw !== "string")
-        throw new Error(invalidFieldMessage(field, "string"));
-    const value = raw.trim();
-    if (!value)
-        throw new Error(requiredFieldMessage(field));
-    return value;
-}
-function normalizeOptionalString(raw, field) {
-    if (raw === undefined)
-        return undefined;
-    if (typeof raw !== "string")
-        throw new Error(invalidFieldMessage(field, "string"));
-    const value = raw.trim();
-    return value || undefined;
-}
-function normalizeStringList(raw, field, opts) {
-    if (!Array.isArray(raw))
-        throw new Error(invalidFieldMessage(field, "string[]"));
-    const values = raw.map((value) => {
-        if (typeof value !== "string")
-            throw new Error(invalidFieldMessage(field, "string[]"));
-        const trimmed = value.trim();
-        if (!trimmed)
-            throw new Error(invalidFieldMessage(field, "string[]"));
-        return trimmed;
-    });
-    const deduped = dedupeStrings(values);
-    if ((opts?.minLength ?? 0) > 0 && deduped.length < (opts?.minLength ?? 0)) {
-        throw new Error(invalidFieldMessage(field, `string[${opts?.minLength ?? 0}+]`));
-    }
-    return deduped;
-}
-function normalizeOptionalStringList(raw, field) {
-    if (raw === undefined)
-        return undefined;
-    return normalizeStringList(raw, field);
-}
-function normalizeNumber(raw, field) {
-    if (raw === undefined)
-        return undefined;
-    if (typeof raw !== "number" || Number.isNaN(raw)) {
-        throw new Error(invalidFieldMessage(field, "number"));
-    }
-    return raw;
-}
-function normalizeCompatibility(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("manifest.compatibility", "object"));
-    return {
-        min_agentplane_version: normalizeOptionalString(raw.min_agentplane_version, "manifest.compatibility.min_agentplane_version"),
-        manifest_api_version: normalizeOptionalString(raw.manifest_api_version, "manifest.compatibility.manifest_api_version"),
-        scenario_api_version: normalizeOptionalString(raw.scenario_api_version, "manifest.compatibility.scenario_api_version"),
-        runtime_api_version: normalizeOptionalString(raw.runtime_api_version, "manifest.compatibility.runtime_api_version"),
-        platforms: normalizeOptionalStringList(raw.platforms, "manifest.compatibility.platforms"),
-        repo_types: normalizeOptionalStringList(raw.repo_types, "manifest.compatibility.repo_types"),
-    };
-}
-function normalizeRunProfile(raw, field) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage(field, "object"));
-    return {
-        mode: normalizeRequiredString(raw.mode, `${field}.mode`),
-        sandbox: normalizeOptionalString(raw.sandbox, `${field}.sandbox`),
-        writes_artifacts_to: normalizeOptionalStringList(raw.writes_artifacts_to, `${field}.writes_artifacts_to`),
-    };
-}
-function normalizeSkills(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!Array.isArray(raw))
-        throw new Error(invalidFieldMessage("manifest.skills", "array"));
-    return raw.map((entry, index) => {
-        if (!isRecord(entry))
-            throw new Error(invalidFieldMessage(`manifest.skills[${index}]`, "object"));
-        return {
-            id: normalizeSkillId(normalizeRequiredString(entry.id, `manifest.skills[${index}].id`)),
-            summary: normalizeRequiredString(entry.summary, `manifest.skills[${index}].summary`),
-            kind: normalizeRequiredString(entry.kind, `manifest.skills[${index}].kind`),
-            file: normalizeRecipeRelativePath(`manifest.skills[${index}].file`, normalizeRequiredString(entry.file, `manifest.skills[${index}].file`)),
-        };
-    });
-}
-function normalizeTools(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!Array.isArray(raw))
-        throw new Error(invalidFieldMessage("manifest.tools", "array"));
-    return raw.map((entry, index) => {
-        if (!isRecord(entry))
-            throw new Error(invalidFieldMessage(`manifest.tools[${index}]`, "object"));
-        const runtime = normalizeRequiredString(entry.runtime, `manifest.tools[${index}].runtime`);
-        if (runtime !== "node" && runtime !== "bash") {
-            throw new Error(invalidFieldMessage(`manifest.tools[${index}].runtime`, '"node" | "bash"'));
-        }
-        return {
-            id: normalizeToolId(normalizeRequiredString(entry.id, `manifest.tools[${index}].id`)),
-            summary: normalizeRequiredString(entry.summary, `manifest.tools[${index}].summary`),
-            runtime,
-            entrypoint: normalizeRecipeRelativePath(`manifest.tools[${index}].entrypoint`, normalizeRequiredString(entry.entrypoint, `manifest.tools[${index}].entrypoint`)),
-            permissions: normalizeOptionalStringList(entry.permissions, `manifest.tools[${index}].permissions`),
-            timeout_ms: normalizeNumber(entry.timeout_ms, `manifest.tools[${index}].timeout_ms`),
-            cwd_policy: normalizeOptionalString(entry.cwd_policy, `manifest.tools[${index}].cwd_policy`),
-        };
-    });
-}
-function normalizeAgents(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!Array.isArray(raw))
-        throw new Error(invalidFieldMessage("manifest.agents", "array"));
-    return raw.map((entry, index) => {
-        if (!isRecord(entry))
-            throw new Error(invalidFieldMessage(`manifest.agents[${index}]`, "object"));
-        return {
-            id: normalizeAgentId(normalizeRequiredString(entry.id, `manifest.agents[${index}].id`)),
-            display_name: normalizeRequiredString(entry.display_name, `manifest.agents[${index}].display_name`),
-            role: normalizeRequiredString(entry.role, `manifest.agents[${index}].role`),
-            summary: normalizeRequiredString(entry.summary, `manifest.agents[${index}].summary`),
-            skills: normalizeOptionalStringList(entry.skills, `manifest.agents[${index}].skills`),
-            tools: normalizeOptionalStringList(entry.tools, `manifest.agents[${index}].tools`),
-            file: normalizeRecipeRelativePath(`manifest.agents[${index}].file`, normalizeRequiredString(entry.file, `manifest.agents[${index}].file`)),
-        };
-    });
-}
-function normalizeScenarios(raw) {
-    if (!Array.isArray(raw) || raw.length === 0) {
-        throw new Error(invalidFieldMessage("manifest.scenarios", "non-empty array"));
-    }
-    return raw.map((entry, index) => {
-        if (!isRecord(entry)) {
-            throw new Error(invalidFieldMessage(`manifest.scenarios[${index}]`, "object"));
-        }
-        return {
-            id: normalizeScenarioId(normalizeRequiredString(entry.id, `manifest.scenarios[${index}].id`)),
-            name: normalizeRequiredString(entry.name, `manifest.scenarios[${index}].name`),
-            summary: normalizeRequiredString(entry.summary, `manifest.scenarios[${index}].summary`),
-            description: normalizeOptionalString(entry.description, `manifest.scenarios[${index}].description`),
-            use_when: normalizeStringList(entry.use_when, `manifest.scenarios[${index}].use_when`, {
-                minLength: 1,
-            }),
-            avoid_when: normalizeOptionalStringList(entry.avoid_when, `manifest.scenarios[${index}].avoid_when`),
-            required_inputs: normalizeStringList(entry.required_inputs, `manifest.scenarios[${index}].required_inputs`),
-            outputs: normalizeStringList(entry.outputs, `manifest.scenarios[${index}].outputs`),
-            permissions: normalizeStringList(Array.isArray(entry.permissions) ? entry.permissions : [], `manifest.scenarios[${index}].permissions`),
-            artifacts: normalizeStringList(Array.isArray(entry.artifacts) ? entry.artifacts : [], `manifest.scenarios[${index}].artifacts`),
-            agents_involved: normalizeStringList(entry.agents_involved, `manifest.scenarios[${index}].agents_involved`, { minLength: 1 }),
-            skills_used: normalizeStringList(Array.isArray(entry.skills_used) ? entry.skills_used : [], `manifest.scenarios[${index}].skills_used`),
-            tools_used: normalizeStringList(Array.isArray(entry.tools_used) ? entry.tools_used : [], `manifest.scenarios[${index}].tools_used`),
-            run_profile: normalizeRunProfile(entry.run_profile, `manifest.scenarios[${index}].run_profile`),
-            file: normalizeRecipeRelativePath(`manifest.scenarios[${index}].file`, normalizeRequiredString(entry.file, `manifest.scenarios[${index}].file`)),
-        };
-    });
-}
-function assertUniqueIds(field, items) {
-    const seen = new Set();
-    for (const item of items) {
-        if (seen.has(item.id)) {
-            throw new Error(invalidFieldMessage(field, `unique ids (duplicate: ${item.id})`));
-        }
-        seen.add(item.id);
-    }
-}
-function assertKnownReferences(field, refs, known) {
-    if (!refs || refs.length === 0)
-        return;
-    const missing = refs.filter((ref) => !known.has(ref));
-    if (missing.length > 0) {
-        throw new Error(invalidFieldMessage(field, `known ids (missing: ${missing.join(", ")})`));
-    }
+import { readRecipeManifest as readRecipeManifestBase, validateRecipeManifest as validateRecipeManifestBase, } from "@agentplaneorg/recipes";
+export async function readRecipeManifest(manifestPath) {
+    return readRecipeManifestBase(manifestPath);
 }
 export function validateRecipeManifest(raw) {
-    if (!isRecord(raw))
-        throw new Error(invalidFieldMessage("manifest", "object"));
-    if (raw.schema_version !== "1")
-        throw new Error(invalidFieldMessage("manifest.schema_version", '"1"'));
-    const id = normalizeRecipeId(normalizeRequiredString(raw.id, "manifest.id"));
-    const version = normalizeRequiredString(raw.version, "manifest.version");
-    const tags = normalizeRecipeTags(raw.tags);
-    const compatibility = normalizeCompatibility(raw.compatibility);
-    const skills = normalizeSkills(raw.skills);
-    const tools = normalizeTools(raw.tools);
-    const agents = normalizeAgents(raw.agents);
-    const scenarios = normalizeScenarios(raw.scenarios);
-    if (skills)
-        assertUniqueIds("manifest.skills", skills);
-    if (tools)
-        assertUniqueIds("manifest.tools", tools);
-    if (agents)
-        assertUniqueIds("manifest.agents", agents);
-    assertUniqueIds("manifest.scenarios", scenarios);
-    const skillIds = new Set((skills ?? []).map((skill) => skill.id));
-    const toolIds = new Set((tools ?? []).map((tool) => tool.id));
-    const agentIds = new Set((agents ?? []).map((agent) => agent.id));
-    for (const [index, agent] of (agents ?? []).entries()) {
-        assertKnownReferences(`manifest.agents[${index}].skills`, agent.skills, skillIds);
-        assertKnownReferences(`manifest.agents[${index}].tools`, agent.tools, toolIds);
-    }
-    for (const [index, scenario] of scenarios.entries()) {
-        assertKnownReferences(`manifest.scenarios[${index}].agents_involved`, scenario.agents_involved, agentIds);
-        assertKnownReferences(`manifest.scenarios[${index}].skills_used`, scenario.skills_used, skillIds);
-        assertKnownReferences(`manifest.scenarios[${index}].tools_used`, scenario.tools_used, toolIds);
-    }
-    return {
-        schema_version: "1",
-        id,
-        version,
-        name: normalizeRequiredString(raw.name, "manifest.name"),
-        summary: normalizeRequiredString(raw.summary, "manifest.summary"),
-        description: normalizeRequiredString(raw.description, "manifest.description"),
-        tags: tags.length > 0 ? tags : undefined,
-        compatibility,
-        skills,
-        agents,
-        tools,
-        scenarios,
-    };
-}
-export async function readRecipeManifest(manifestPath) {
-    const raw = JSON.parse(await readFile(manifestPath, "utf8"));
-    return validateRecipeManifest(raw);
+    return validateRecipeManifestBase(raw);
 }

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

@@ -0,0 +1,32 @@
+import { type CompiledRecipeAssetRegistry, type CompiledOverlayBundle, type ProjectRecipesLockFile } from "@agentplaneorg/recipes";
+export declare function readActiveRecipeIds(project: {
+    agentplaneDir: string;
+}): Promise<string[]>;
+export declare function setRecipeActive(opts: {
+    project: {
+        agentplaneDir: string;
+    };
+    recipeId: string;
+    active: boolean;
+}): Promise<string[]>;
+export declare function compileProjectOverlayArtifacts(project: {
+    agentplaneDir: string;
+}): Promise<{
+    bundle: CompiledOverlayBundle;
+    lock: ProjectRecipesLockFile;
+    assets: CompiledRecipeAssetRegistry;
+}>;
+export declare function refreshProjectOverlayArtifacts(project: {
+    agentplaneDir: string;
+}): Promise<{
+    bundle: CompiledOverlayBundle;
+    lock: ProjectRecipesLockFile;
+    assets: CompiledRecipeAssetRegistry;
+}>;
+export declare function readProjectOverlayBundle(project: {
+    agentplaneDir: string;
+}): Promise<CompiledOverlayBundle | null>;
+export declare function readProjectRecipeAssetRegistry(project: {
+    agentplaneDir: string;
+}): Promise<CompiledRecipeAssetRegistry | null>;
+//# sourceMappingURL=overlay-project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-project.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/overlay-project.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAiJhC,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM/F;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAepB;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAChG,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAiHD;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAChG,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC,CAUD;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAUxC;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAU9C"}