agentplane 0.3.4 → 0.3.6

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

@@ -0,0 +1,102 @@
+import { mkdir, readdir, readFile } 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 { readRecipeManifest } from "./manifest.js";
+import { normalizeRecipeTags } from "./normalize.js";
+import { resolveProjectInstalledRecipeDir, resolveProjectRecipeInstallMetaPath, resolveProjectRecipesDir, } from "./paths.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,
+    };
+}
+function sortInstalledRecipes(entries) {
+    return [...entries].toSorted((a, b) => a.id.localeCompare(b.id));
+}
+export async function readRecipeInstallMetadata(filePath) {
+    try {
+        const raw = JSON.parse(await readFile(filePath, "utf8"));
+        return validateRecipeInstallMetadata(raw);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+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") {
+        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);
+        const manifestPath = path.join(recipeDir, "manifest.json");
+        if (!(await fileExists(manifestPath))) {
+            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"));
+        }
+        entries.push({
+            id: manifest.id,
+            version: manifest.version,
+            source: metadata?.source ?? "project-local",
+            installed_at: metadata?.installed_at ?? "",
+            tags: normalizeRecipeTags(metadata?.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,
+    };
+}

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

@@ -0,0 +1,20 @@
+import type { ResolvedProject } from "@agentplaneorg/core";
+import type { RecipeCompatibility, RecipeResolverCompatibility, RecipeResolverContext, RecipeScenarioDescriptor, ResolveRecipeScenarioSelectionFlags, ResolvedRecipeRunProfile, ResolvedRecipeScenario, ResolvedRecipeScenarioSelection } from "./types.js";
+export declare function buildRecipeResolverContext(opts: {
+    project: ResolvedProject;
+}): Promise<RecipeResolverContext>;
+export declare function resolveRecipeCompatibility(opts: {
+    compatibility?: RecipeCompatibility;
+    context: RecipeResolverContext;
+}): RecipeResolverCompatibility;
+export declare function normalizeResolvedRecipeRunProfile(scenario: RecipeScenarioDescriptor): ResolvedRecipeRunProfile;
+export declare function listResolvedRecipeScenarios(opts: {
+    project: ResolvedProject;
+    recipeId?: string;
+    includeIncompatible?: boolean;
+}): Promise<ResolvedRecipeScenario[]>;
+export declare function resolveRecipeScenarioSelection(opts: {
+    project: ResolvedProject;
+    flags: ResolveRecipeScenarioSelectionFlags;
+}): Promise<ResolvedRecipeScenarioSelection>;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +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;AAS3D,OAAO,KAAK,EAEV,mBAAmB,EACnB,2BAA2B,EAE3B,qBAAqB,EAErB,wBAAwB,EACxB,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,YAAY,CAAC;AAsBpB,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,CAmB1B;AA6BD,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,CA2D3C"}

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

@@ -0,0 +1,220 @@
+import path from "node:path";
+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 { readProjectInstalledRecipes } from "./project-installed-recipes.js";
+const SUPPORTED_MANIFEST_API_VERSION = "1";
+const SUPPORTED_SCENARIO_API_VERSION = "1";
+const SUPPORTED_RUNTIME_API_VERSION = "1";
+async function detectProjectRepoTypes(project) {
+    const repoTypes = ["generic"];
+    const checks = [
+        ["package.json", "node"],
+        ["pyproject.toml", "python"],
+        ["go.mod", "go"],
+        ["Cargo.toml", "rust"],
+    ];
+    for (const [relativePath, repoType] of checks) {
+        if (await fileExists(path.join(project.gitRoot, relativePath))) {
+            repoTypes.push(repoType);
+        }
+    }
+    return dedupeStrings(repoTypes).toSorted();
+}
+export async function buildRecipeResolverContext(opts) {
+    return {
+        agentplane_version: getVersion(),
+        manifest_api_version: SUPPORTED_MANIFEST_API_VERSION,
+        scenario_api_version: SUPPORTED_SCENARIO_API_VERSION,
+        runtime_api_version: SUPPORTED_RUNTIME_API_VERSION,
+        platform: process.platform,
+        repo_types: await detectProjectRepoTypes(opts.project),
+    };
+}
+function pushCompatibilityFailure(failures, field, expected, actual, reason) {
+    failures.push({ field, expected, actual, reason });
+}
+export function resolveRecipeCompatibility(opts) {
+    const reasons = [];
+    const failures = [];
+    const compatibility = opts.compatibility;
+    const context = opts.context;
+    if (!compatibility) {
+        reasons.push("recipe compatibility is unconstrained");
+        return { ok: true, reasons, failures };
+    }
+    if (compatibility.min_agentplane_version) {
+        if (compareVersions(context.agentplane_version, compatibility.min_agentplane_version) < 0) {
+            pushCompatibilityFailure(failures, "min_agentplane_version", compatibility.min_agentplane_version, context.agentplane_version, `agentplane ${context.agentplane_version} is older than required ${compatibility.min_agentplane_version}`);
+        }
+        else {
+            reasons.push(`agentplane ${context.agentplane_version} satisfies min ${compatibility.min_agentplane_version}`);
+        }
+    }
+    const versionChecks = [
+        {
+            field: "manifest_api_version",
+            expected: compatibility.manifest_api_version,
+            actual: context.manifest_api_version,
+        },
+        {
+            field: "scenario_api_version",
+            expected: compatibility.scenario_api_version,
+            actual: context.scenario_api_version,
+        },
+        {
+            field: "runtime_api_version",
+            expected: compatibility.runtime_api_version,
+            actual: context.runtime_api_version,
+        },
+    ];
+    for (const check of versionChecks) {
+        if (check.expected === undefined)
+            continue;
+        if (check.expected === check.actual) {
+            reasons.push(`${check.field}=${check.actual}`);
+        }
+        else {
+            pushCompatibilityFailure(failures, check.field, check.expected, check.actual, `${check.field} requires ${check.expected}, active runtime exposes ${check.actual}`);
+        }
+    }
+    if (compatibility.platforms && compatibility.platforms.length > 0) {
+        if (compatibility.platforms.includes(context.platform)) {
+            reasons.push(`platform ${context.platform} is supported`);
+        }
+        else {
+            pushCompatibilityFailure(failures, "platforms", compatibility.platforms, context.platform, `platform ${context.platform} is not supported by recipe`);
+        }
+    }
+    if (compatibility.repo_types && compatibility.repo_types.length > 0) {
+        const matched = compatibility.repo_types.filter((repoType) => context.repo_types.includes(repoType));
+        if (matched.length > 0) {
+            reasons.push(`repo types matched: ${matched.join(", ")}`);
+        }
+        else {
+            pushCompatibilityFailure(failures, "repo_types", compatibility.repo_types, context.repo_types, `project repo types ${context.repo_types.join(", ")} do not match recipe requirements`);
+        }
+    }
+    return { ok: failures.length === 0, reasons, failures };
+}
+export function normalizeResolvedRecipeRunProfile(scenario) {
+    const declaredProfile = scenario.run_profile;
+    const permissions = dedupeStrings([...scenario.permissions]).toSorted();
+    const network = declaredProfile.network ?? permissions.includes("network");
+    return {
+        mode: declaredProfile.mode,
+        sandbox: declaredProfile.sandbox,
+        network,
+        requires_human_approval: declaredProfile.requires_human_approval ?? false,
+        writes_artifacts_to: dedupeStrings(declaredProfile.writes_artifacts_to ?? []).toSorted(),
+        expected_exit_contract: declaredProfile.expected_exit_contract,
+        permissions,
+        agents_involved: dedupeStrings([...scenario.agents_involved]).toSorted(),
+        skills_used: dedupeStrings([...scenario.skills_used]).toSorted(),
+        tools_used: dedupeStrings([...scenario.tools_used]).toSorted(),
+        required_inputs: dedupeStrings([...scenario.required_inputs]).toSorted(),
+        outputs: dedupeStrings([...scenario.outputs]).toSorted(),
+        artifacts: dedupeStrings([...scenario.artifacts]).toSorted(),
+    };
+}
+function toResolvedRecipeScenarios(opts) {
+    const recipeDir = resolveProjectInstalledRecipeDir(opts.project, opts.entry.id);
+    return opts.entry.manifest.scenarios
+        .map((scenario) => ({
+        recipe_id: opts.entry.id,
+        recipe_version: opts.entry.version,
+        recipe_name: opts.entry.manifest.name,
+        recipe_summary: opts.entry.manifest.summary,
+        recipe_tags: [...opts.entry.tags].toSorted(),
+        recipe_dir: recipeDir,
+        scenario_id: scenario.id,
+        scenario_name: scenario.name,
+        scenario_summary: scenario.summary,
+        scenario_description: scenario.description,
+        use_when: [...scenario.use_when],
+        avoid_when: [...(scenario.avoid_when ?? [])],
+        scenario_file: path.join(recipeDir, scenario.file),
+        compatibility: opts.compatibility,
+        run_profile: normalizeResolvedRecipeRunProfile(scenario),
+    }))
+        .toSorted((left, right) => left.scenario_id.localeCompare(right.scenario_id));
+}
+export async function listResolvedRecipeScenarios(opts) {
+    const [context, installed] = await Promise.all([
+        buildRecipeResolverContext({ project: opts.project }),
+        readProjectInstalledRecipes(opts.project),
+    ]);
+    const results = [];
+    for (const entry of installed.recipes) {
+        if (opts.recipeId && entry.id !== opts.recipeId)
+            continue;
+        const compatibility = resolveRecipeCompatibility({
+            compatibility: entry.manifest.compatibility,
+            context,
+        });
+        if (!opts.includeIncompatible && !compatibility.ok)
+            continue;
+        results.push(...toResolvedRecipeScenarios({ project: opts.project, entry, compatibility }));
+    }
+    return results.toSorted((left, right) => {
+        const byRecipe = left.recipe_id.localeCompare(right.recipe_id);
+        if (byRecipe !== 0)
+            return byRecipe;
+        return left.scenario_id.localeCompare(right.scenario_id);
+    });
+}
+export async function resolveRecipeScenarioSelection(opts) {
+    const requiredTags = dedupeStrings(opts.flags.tags ?? []).toSorted();
+    const availableInputs = dedupeStrings(opts.flags.available_inputs ?? []).toSorted();
+    const candidates = await listResolvedRecipeScenarios({
+        project: opts.project,
+        recipeId: opts.flags.recipeId,
+        includeIncompatible: opts.flags.includeIncompatible,
+    });
+    const matches = [];
+    for (const candidate of candidates) {
+        if (opts.flags.scenarioId && candidate.scenario_id !== opts.flags.scenarioId)
+            continue;
+        if (opts.flags.mode && candidate.run_profile.mode !== opts.flags.mode)
+            continue;
+        if (requiredTags.some((tag) => !candidate.recipe_tags.includes(tag))) {
+            continue;
+        }
+        if (availableInputs.length > 0 &&
+            candidate.run_profile.required_inputs.some((input) => !availableInputs.includes(input))) {
+            continue;
+        }
+        const selectionReasons = [];
+        if (candidate.compatibility.ok)
+            selectionReasons.push("recipe compatibility satisfied");
+        if (opts.flags.recipeId)
+            selectionReasons.push(`matches requested recipe: ${opts.flags.recipeId}`);
+        if (opts.flags.scenarioId) {
+            selectionReasons.push(`matches requested scenario: ${opts.flags.scenarioId}`);
+        }
+        if (requiredTags.length > 0) {
+            selectionReasons.push(`matches required tags: ${requiredTags.join(", ")}`);
+        }
+        if (opts.flags.mode)
+            selectionReasons.push(`matches requested mode: ${opts.flags.mode}`);
+        if (availableInputs.length > 0 && candidate.run_profile.required_inputs.length > 0) {
+            selectionReasons.push(`required inputs satisfied: ${candidate.run_profile.required_inputs.join(", ")}`);
+        }
+        matches.push({
+            ...candidate,
+            selection_reasons: selectionReasons,
+        });
+    }
+    if (matches.length === 0) {
+        const requestedRecipe = opts.flags.recipeId ? ` recipe=${opts.flags.recipeId}` : "";
+        const requestedScenario = opts.flags.scenarioId ? ` scenario=${opts.flags.scenarioId}` : "";
+        throw new Error(`No recipe scenario matches the requested selection.${requestedRecipe}${requestedScenario}`);
+    }
+    if (matches.length > 1) {
+        const labels = matches.map((match) => `${match.recipe_id}:${match.scenario_id}`).join(", ");
+        throw new Error(`Scenario selection is ambiguous: ${labels}`);
+    }
+    return matches[0];
+}

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

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/scenario.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwD3F,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG1F;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,cAAc,EAAE,CAAC,CAAC;IAClB,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C,CAAC,CAeD;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA+CjC;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAyB/D"}
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/scenario.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwD3F,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG1F;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,cAAc,EAAE,CAAC,CAAC;IAClB,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C,CAAC,CAeD;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA6EjC;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAyB/D"}

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

@@ -81,7 +81,46 @@ export async function readScenarioIndex(filePath) {
     return { schema_version: 1, scenarios };
 }
 export async function collectRecipeScenarioDetails(recipeDir, manifest) {
+    const manifestScenarios = manifest.scenarios ?? [];
     const scenariosDir = path.join(recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+    if (manifestScenarios.length > 0) {
+        const details = manifestScenarios.map((scenario) => ({
+            id: scenario.id,
+            name: scenario.name,
+            summary: scenario.summary,
+            description: scenario.description,
+            use_when: scenario.use_when,
+            avoid_when: scenario.avoid_when,
+            required_inputs: scenario.required_inputs,
+            outputs: scenario.outputs,
+            permissions: scenario.permissions,
+            artifacts: scenario.artifacts,
+            agents_involved: scenario.agents_involved,
+            skills_used: scenario.skills_used,
+            tools_used: scenario.tools_used,
+            run_profile: scenario.run_profile,
+            file: scenario.file,
+            source: "manifest",
+        }));
+        if ((await getPathKind(scenariosDir)) === "dir") {
+            const files = await readdir(scenariosDir);
+            const jsonFiles = files.filter((file) => file.toLowerCase().endsWith(".json")).toSorted();
+            for (const file of jsonFiles) {
+                const scenario = await readScenarioDefinition(path.join(scenariosDir, file));
+                const detail = details.find((entry) => entry.id === scenario.id);
+                if (!detail)
+                    continue;
+                detail.description ??= scenario.description;
+                detail.goal = scenario.goal;
+                detail.inputs = scenario.inputs;
+                detail.steps = scenario.steps;
+                detail.outputs = detail.outputs ?? scenario.outputs;
+                detail.evidence = scenario.evidence;
+                detail.source = "definition";
+            }
+        }
+        return details.toSorted((a, b) => a.id.localeCompare(b.id));
+    }
     if ((await getPathKind(scenariosDir)) === "dir") {
         const files = await readdir(scenariosDir);
         const jsonFiles = files.filter((file) => file.toLowerCase().endsWith(".json")).toSorted();
@@ -95,6 +134,7 @@ export async function collectRecipeScenarioDetails(recipeDir, manifest) {
                 goal: scenario.goal,
                 inputs: scenario.inputs,
                 outputs: scenario.outputs,
+                evidence: scenario.evidence,
                 steps: scenario.steps,
                 source: "definition",
             });
@@ -112,17 +152,6 @@ export async function collectRecipeScenarioDetails(recipeDir, manifest) {
         }))
             .toSorted((a, b) => a.id.localeCompare(b.id));
     }
-    const manifestScenarios = manifest.scenarios ?? [];
-    if (manifestScenarios.length > 0) {
-        return manifestScenarios
-            .map((scenario) => ({
-            id: scenario?.id ?? "",
-            summary: scenario?.summary,
-            source: "manifest",
-        }))
-            .filter((scenario) => scenario.id)
-            .toSorted((a, b) => a.id.localeCompare(b.id));
-    }
     return [];
 }
 export function normalizeScenarioToolStep(raw, sourcePath) {

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

@@ -1,3 +1,122 @@
+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;
+    network?: boolean;
+    requires_human_approval?: boolean;
+    writes_artifacts_to?: string[];
+    expected_exit_contract?: string;
+};
+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;
+    network: boolean;
+    requires_human_approval: boolean;
+    writes_artifacts_to: string[];
+    expected_exit_contract?: string;
+    permissions: string[];
+    agents_involved: string[];
+    skills_used: string[];
+    tools_used: string[];
+    required_inputs: string[];
+    outputs: string[];
+    artifacts: 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[];
+    scenario_file: string;
+    compatibility: RecipeResolverCompatibility;
+    run_profile: ResolvedRecipeRunProfile;
+};
+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;
@@ -6,24 +125,22 @@ export type RecipeManifest = {
     summary: string;
     description: string;
     tags?: string[];
-    agents?: {
-        id?: string;
-        summary?: string;
-        file?: string;
-    }[];
-    tools?: {
-        id?: string;
-        summary?: string;
-        runtime?: "node" | "bash";
-        entrypoint?: string;
-        permissions?: string[];
-    }[];
-    scenarios?: {
-        id?: string;
-        summary?: 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;
@@ -53,11 +170,23 @@ export type ScenarioDefinition = {
 };
 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;
     inputs?: unknown;
     outputs?: unknown;
+    evidence?: ScenarioDefinition["evidence"];
+    file?: string;
     steps?: unknown[];
     source: "definition" | "index" | "manifest";
 };

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,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,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,EAAE,CAAC;IACJ,SAAS,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjE,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,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,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,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":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"install.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA4IhE,CAAC"}
+{"version":3,"file":"install.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/install.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA6IhE,CAAC"}

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

@@ -60,7 +60,7 @@ export const recipesInstallSpec = {
             valueHint: "<fail|rename|overwrite>",
             choices: ["fail", "rename", "overwrite"],
             default: "fail",
-            description: "How to handle conflicts when applying recipe agents.",
+            description: "Deprecated compatibility no-op; recipe installs stay self-contained.",
         },
     ],
     validateRaw: (raw) => {
@@ -130,11 +130,12 @@ export const recipesInstallSpec = {
         },
         {
             cmd: "agentplane recipes install viewer --on-conflict overwrite",
-            why: "Apply recipe agents, overwriting conflicts.",
+            why: "Compatibility-only flag; ignored by self-contained recipe installs.",
         },
     ],
     notes: [
         "Auto mode resolution matches v0.1.9: URL if http(s); else PATH if file exists; else NAME (remote index).",
         "Network operations may require approval; use --yes to auto-approve when allowed by config.",
+        "--on-conflict is accepted for backward compatibility but does not change install behavior.",
     ],
 };