agentplane 0.3.12 → 0.3.13

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;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,GAAG,CAAC;IAC1B,oBAAoB,EAAE,GAAG,CAAC;IAC1B,mBAAmB,EAAE,GAAG,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,KAAK,EACD,wBAAwB,GACxB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,WAAW,GACX,YAAY,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,kCAAkC,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,2BAA2B,CAAC;IAC3C,WAAW,EAAE,wBAAwB,CAAC;IACtC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,sBAAsB,GAAG;IACrE,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC/B,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,GAAG,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,OAAO,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC;YAChB,GAAG,EAAE,MAAM,CAAC;YACZ,MAAM,EAAE,MAAM,CAAC;YACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;YAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;SACjB,EAAE,CAAC;KACL,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,2BAA2B,EAC3B,kCAAkC,EAClC,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC"}

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

@@ -2,9 +2,9 @@ import { cmdRecipeInfoParsed } from "../recipes.js";
 export const recipesInfoSpec = {
     id: ["recipes", "info"],
     group: "Recipes",
-    summary: "Show installed recipe metadata.",
+    summary: "Show cached recipe metadata.",
     args: [{ name: "id", required: true, valueHint: "<id>" }],
-    examples: [{ cmd: "agentplane recipes info viewer", why: "Show recipe metadata." }],
+    examples: [{ cmd: "agentplane recipes info viewer", why: "Show cached recipe metadata." }],
     parse: (raw) => ({ id: String(raw.args.id ?? "") }),
 };
 export const runRecipesInfo = (ctx, p) => cmdRecipeInfoParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, id: p.id });

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

@@ -2,7 +2,7 @@ import { usageError } from "../../cli/spec/errors.js";
 export const recipesInstallSpec = {
     id: ["recipes", "install"],
     group: "Recipes",
-    summary: "Install a recipe from remote index, local archive, or URL.",
+    summary: "Install a recipe into the global cache from remote index, local archive, or URL.",
     synopsis: [
         "agentplane recipes install <id|path|url> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
         "agentplane recipes install --name <id> [--index <path|url>] [--refresh] [--yes] [--on-conflict <fail|rename|overwrite>]",
@@ -22,19 +22,19 @@ export const recipesInstallSpec = {
             kind: "string",
             name: "name",
             valueHint: "<id>",
-            description: "Install from remote index by recipe id.",
+            description: "Cache from remote index by recipe id.",
         },
         {
             kind: "string",
             name: "path",
             valueHint: "<path>",
-            description: "Install from local recipe archive path.",
+            description: "Cache from local recipe archive path.",
         },
         {
             kind: "string",
             name: "url",
             valueHint: "<url>",
-            description: "Install from recipe archive URL.",
+            description: "Cache from recipe archive URL.",
         },
         {
             kind: "string",

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

@@ -3,19 +3,19 @@ import { cmdRecipeListParsed } from "../recipes.js";
 export const recipesListSpec = {
     id: ["recipes", "list"],
     group: "Recipes",
-    summary: "List installed recipes.",
+    summary: "List cached recipes.",
     options: [
         { kind: "boolean", name: "full", default: false, description: "Print full JSON payload." },
         {
             kind: "string",
             name: "tag",
             valueHint: "<tag>",
-            description: "Filter installed recipes by tag.",
+            description: "Filter cached recipes by tag.",
         },
     ],
     examples: [
-        { cmd: "agentplane recipes list", why: "List installed recipes." },
-        { cmd: "agentplane recipes list --tag cli", why: "List installed recipes with a tag." },
+        { cmd: "agentplane recipes list", why: "List cached recipes." },
+        { cmd: "agentplane recipes list --tag cli", why: "List cached recipes with a tag." },
         { cmd: "agentplane recipes list --full", why: "Print full JSON payload." },
     ],
     parse: (raw) => ({

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

@@ -2,9 +2,9 @@ import { cmdRecipeRemoveParsed } from "../recipes.js";
 export const recipesRemoveSpec = {
     id: ["recipes", "remove"],
     group: "Recipes",
-    summary: "Remove an installed recipe.",
+    summary: "Remove a vendored recipe from the current project.",
     args: [{ name: "id", required: true, valueHint: "<id>" }],
-    examples: [{ cmd: "agentplane recipes remove viewer", why: "Remove a recipe by id." }],
+    examples: [{ cmd: "agentplane recipes remove viewer", why: "Remove a vendored recipe by id." }],
     parse: (raw) => ({ id: String(raw.args.id ?? "") }),
 };
 export const runRecipesRemove = (ctx, p) => cmdRecipeRemoveParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, id: p.id });

package/dist/commands/recipes/update.command.d.ts

@@ -0,0 +1,8 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type RecipesUpdateParsed = {
+    id: string;
+    force: boolean;
+};
+export declare const recipesUpdateSpec: CommandSpec<RecipesUpdateParsed>;
+export declare const runRecipesUpdate: CommandHandler<RecipesUpdateParsed>;
+//# sourceMappingURL=update.command.d.ts.map

package/dist/commands/recipes/update.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/update.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CA2B9D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,mBAAmB,CAM7D,CAAC"}

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

@@ -0,0 +1,35 @@
+import { cmdRecipeUpdateParsed } from "../recipes.js";
+export const recipesUpdateSpec = {
+    id: ["recipes", "update"],
+    group: "Recipes",
+    summary: "Refresh a vendored recipe from the cached source.",
+    args: [{ name: "id", required: true, valueHint: "<id>" }],
+    options: [
+        {
+            kind: "boolean",
+            name: "force",
+            default: false,
+            description: "Overwrite local project edits in the vendored recipe.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane recipes update tdd",
+            why: "Sync a clean vendored recipe to the current cached source.",
+        },
+        {
+            cmd: "agentplane recipes update tdd --force",
+            why: "Overwrite local vendored edits with the cached source.",
+        },
+    ],
+    parse: (raw) => ({
+        id: String(raw.args.id ?? "").trim(),
+        force: raw.opts.force === true,
+    }),
+};
+export const runRecipesUpdate = (ctx, parsed) => cmdRecipeUpdateParsed({
+    cwd: ctx.cwd,
+    rootOverride: ctx.rootOverride,
+    id: parsed.id,
+    force: parsed.force,
+});

package/dist/commands/recipes.d.ts

@@ -1,10 +1,13 @@
 export { RECIPES_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, RECIPE_RUNS_DIR_NAME, } from "./recipes/impl/constants.js";
-export type { RecipeCachePruneFlags, RecipeConflictMode, RecipeInstallSource, RecipeListFlags, RecipeListRemoteFlags, RecipeResolverCompatibility, RecipeResolverCompatibilityFailure, RecipeResolverContext, ResolveRecipeScenarioSelectionFlags, ResolvedRecipeRunProfile, ResolvedRecipeScenario, ResolvedRecipeScenarioSelection, ScenarioDefinition, } from "./recipes/impl/types.js";
+export type { CompiledRecipeAssetEntry, CompiledRecipeAssetRegistry, CompiledOverlayBundle, RecipeCachePruneFlags, RecipeConflictMode, RecipeInstallSource, RecipeKind, RecipeListFlags, RecipeListRemoteFlags, RecipeResolverCompatibility, RecipeResolverCompatibilityFailure, RecipeResolverContext, ProjectOverlayManifestV2, ResolveRecipeScenarioSelectionFlags, ResolvedRecipeRunProfile, ResolvedRecipeScenario, ResolvedRecipeScenarioSelection, ScenarioDefinition, } from "./recipes/impl/types.js";
 export { readRecipeManifest } from "./recipes/impl/manifest.js";
 export { readInstalledRecipesFile } from "./recipes/impl/installed-recipes.js";
-export { readProjectInstalledRecipes, readRecipeInstallMetadata, writeRecipeInstallMetadata, } from "./recipes/impl/project-installed-recipes.js";
-export { resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, resolveProjectRecipesCacheDir, } from "./recipes/impl/paths.js";
+export { readProjectInstalledRecipes } from "./recipes/impl/project-installed-recipes.js";
+export { readProjectRecipesRegistry, removeProjectRecipeRegistryEntry, upsertProjectRecipeRegistryEntry, writeProjectRecipesRegistry, } from "./recipes/impl/project-registry.js";
+export { hashRecipeTree, inspectProjectRecipe } from "./recipes/impl/project-recipe-state.js";
+export { compileProjectOverlayArtifacts, readActiveRecipeIds, readProjectOverlayBundle, readProjectRecipeAssetRegistry, refreshProjectOverlayArtifacts, setRecipeActive, } from "./recipes/impl/overlay-project.js";
+export { resolveProjectRecipesPackagesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectInstalledRecipeDir, resolveProjectOverlayBundlePath, resolveProjectRecipeAssetsPath, resolveProjectRecipesLockPath, resolveProjectRecipesDir, resolveProjectRecipesCacheDir, resolveProjectRecipesRegistryPath, resolveProjectVendoredRecipeDir, } from "./recipes/impl/paths.js";
 export { collectRecipeScenarioDetails, normalizeScenarioToolStep, readScenarioDefinition, readScenarioIndex, } from "./recipes/impl/scenario.js";
 export { buildRecipeResolverContext, listResolvedRecipeScenarios, normalizeResolvedRecipeRunProfile, resolveRecipeCompatibility, resolveRecipeScenarioSelection, } from "./recipes/impl/resolver.js";
-export { cmdRecipeCachePruneParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeRemoveParsed, } from "./recipes/impl/commands.js";
+export { cmdRecipeAddParsed, cmdRecipeActiveParsed, cmdRecipeCachePruneParsed, cmdRecipeDisableParsed, cmdRecipeEnableParsed, cmdRecipeExplainActiveParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeDetachParsed, cmdRecipeRemoveParsed, cmdRecipeUpdateParsed, } from "./recipes/impl/commands.js";
 //# sourceMappingURL=recipes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/commands/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,kCAAkC,EAClC,qBAAqB,EACrB,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,gCAAgC,EAChC,mCAAmC,EACnC,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,EACjC,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/commands/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,kCAAkC,EAClC,qBAAqB,EACrB,wBAAwB,EACxB,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9F,OAAO,EACL,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,GAChB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC3B,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,EACjC,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/commands/recipes.js

@@ -1,8 +1,11 @@
 export { RECIPES_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, RECIPE_RUNS_DIR_NAME, } from "./recipes/impl/constants.js";
 export { readRecipeManifest } from "./recipes/impl/manifest.js";
 export { readInstalledRecipesFile } from "./recipes/impl/installed-recipes.js";
-export { readProjectInstalledRecipes, readRecipeInstallMetadata, writeRecipeInstallMetadata, } from "./recipes/impl/project-installed-recipes.js";
-export { resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, resolveProjectRecipesCacheDir, } from "./recipes/impl/paths.js";
+export { readProjectInstalledRecipes } from "./recipes/impl/project-installed-recipes.js";
+export { readProjectRecipesRegistry, removeProjectRecipeRegistryEntry, upsertProjectRecipeRegistryEntry, writeProjectRecipesRegistry, } from "./recipes/impl/project-registry.js";
+export { hashRecipeTree, inspectProjectRecipe } from "./recipes/impl/project-recipe-state.js";
+export { compileProjectOverlayArtifacts, readActiveRecipeIds, readProjectOverlayBundle, readProjectRecipeAssetRegistry, refreshProjectOverlayArtifacts, setRecipeActive, } from "./recipes/impl/overlay-project.js";
+export { resolveProjectRecipesPackagesDir, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectInstalledRecipeDir, resolveProjectOverlayBundlePath, resolveProjectRecipeAssetsPath, resolveProjectRecipesLockPath, resolveProjectRecipesDir, resolveProjectRecipesCacheDir, resolveProjectRecipesRegistryPath, resolveProjectVendoredRecipeDir, } from "./recipes/impl/paths.js";
 export { collectRecipeScenarioDetails, normalizeScenarioToolStep, readScenarioDefinition, readScenarioIndex, } from "./recipes/impl/scenario.js";
 export { buildRecipeResolverContext, listResolvedRecipeScenarios, normalizeResolvedRecipeRunProfile, resolveRecipeCompatibility, resolveRecipeScenarioSelection, } from "./recipes/impl/resolver.js";
-export { cmdRecipeCachePruneParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeRemoveParsed, } from "./recipes/impl/commands.js";
+export { cmdRecipeAddParsed, cmdRecipeActiveParsed, cmdRecipeCachePruneParsed, cmdRecipeDisableParsed, cmdRecipeEnableParsed, cmdRecipeExplainActiveParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeDetachParsed, cmdRecipeRemoveParsed, cmdRecipeUpdateParsed, } from "./recipes/impl/commands.js";

package/dist/commands/recipes.test-helpers.d.ts

@@ -8,12 +8,12 @@ export declare function signIndexPayload(indexText: string): {
 };
 export declare function writeSignedIndex(indexPath: string, payload: unknown): Promise<void>;
 export declare function resolveProjectRecipeDir(projectDir: string, recipeId: string): string;
+export declare function resolveProjectRecipesRegistryPath(projectDir: string): string;
 export declare function writeInstalledRecipes(projectDir: string, recipes: unknown[]): Promise<void>;
 export declare function writeInstalledRecipesRegistry(recipes: unknown[]): Promise<void>;
 export declare function skillEntry(overrides?: Partial<Record<string, unknown>>): {
     id: string;
     summary: string;
-    kind: string;
     file: string;
 };
 export declare function toolEntry(overrides?: Partial<Record<string, unknown>>): {
@@ -67,7 +67,6 @@ export declare function baseRecipeManifest(overrides?: Partial<Record<string, un
     skills: {
         id: string;
         summary: string;
-        kind: string;
         file: string;
     }[];
     agents: {
@@ -128,7 +127,6 @@ export declare function baseRecipeEntry(overrides?: Partial<Record<string, unkno
         skills: {
             id: string;
             summary: string;
-            kind: string;
             file: string;
         }[];
         agents: {
@@ -169,6 +167,8 @@ export declare function installRecipe(opts: {
     projectDir: string;
     archivePath?: string;
     tags?: string[];
+    vendor?: boolean;
+    mode?: "copy" | "link";
 }): Promise<void>;
 export declare function installRecipeFixture(opts: {
     projectDir: string;

package/dist/commands/recipes.test-helpers.d.ts.map

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