agentplane 0.3.24 → 0.3.27

package/dist/commands/runtime.command.js

@@ -1,138 +0,0 @@
-import { loadConfig } from "@agentplaneorg/core/config";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { createCliEmitter } from "../cli/output.js";
-import { loadDirectSubcommandNames, throwGroupCommandUsage, } from "../cli/group-command.js";
-import { evaluateRepoCliVersionExpectation, } from "../runtime/shared/repo-cli-version.js";
-import { FRAMEWORK_DEV_BOOTSTRAP_COMMAND, FRAMEWORK_DEV_FORCE_GLOBAL_EXAMPLE, FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND, FRAMEWORK_DEV_MANUAL_REPAIR_COMMANDS, FRAMEWORK_DEV_REINSTALL_SCRIPT, FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND, } from "../../bin/framework-dev-contract.js";
-import { describeRuntimeMode, resolveRuntimeSourceInfo, } from "../runtime/shared/runtime-source.js";
-import { runtimeSpec } from "./runtime.spec.js";
-const output = createCliEmitter();
-export { runtimeExplainSpec, runtimeSpec } from "./runtime.spec.js";
-function renderPath(value) {
-    return value ?? "unresolved";
-}
-export function buildFrameworkDevWorkflow(report) {
-    const available = report.framework.inFrameworkCheckout;
-    if (!available) {
-        return {
-            available,
-            bootstrapCommand: FRAMEWORK_DEV_BOOTSTRAP_COMMAND,
-            manualRepairCommands: [...FRAMEWORK_DEV_MANUAL_REPAIR_COMMANDS],
-            repoLocalVerifyCommand: FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND,
-            reinstallScript: FRAMEWORK_DEV_REINSTALL_SCRIPT,
-            globalVerifyCommand: FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND,
-            forceGlobalExample: FRAMEWORK_DEV_FORCE_GLOBAL_EXAMPLE,
-            recommendation: null,
-        };
-    }
-    const recommendation = report.mode === "repo-local" || report.mode === "repo-local-handoff"
-        ? "Run the framework bootstrap after fresh clones or dependency drift; use the reinstall helper only when the global PATH command itself should resolve this checkout."
-        : report.mode === "global-in-framework"
-            ? "Bootstrap the framework checkout first so the installed wrapper can hand off cleanly to the repo-local runtime."
-            : report.mode === "global-forced-in-framework"
-                ? "Unset AGENTPLANE_USE_GLOBAL_IN_FRAMEWORK=1 unless you intentionally need the global installed CLI inside the framework checkout."
-                : "Use the framework bootstrap command first, then verify the repo-local runtime and global wrapper explicitly.";
-    return {
-        available,
-        bootstrapCommand: FRAMEWORK_DEV_BOOTSTRAP_COMMAND,
-        manualRepairCommands: [...FRAMEWORK_DEV_MANUAL_REPAIR_COMMANDS],
-        repoLocalVerifyCommand: FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND,
-        reinstallScript: FRAMEWORK_DEV_REINSTALL_SCRIPT,
-        globalVerifyCommand: FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND,
-        forceGlobalExample: FRAMEWORK_DEV_FORCE_GLOBAL_EXAMPLE,
-        recommendation,
-    };
-}
-function buildRuntimeExplainPayload(report) {
-    return {
-        ...report,
-        frameworkDev: buildFrameworkDevWorkflow(report),
-        repoCliExpectation: {
-            expectedVersion: null,
-            activeVersion: report.agentplane.version,
-            state: "unconfigured",
-            summary: null,
-            recovery: null,
-        },
-    };
-}
-export function renderRuntimeExplainText(report, repoCliExpectation) {
-    const frameworkDev = buildFrameworkDevWorkflow(report);
-    const lines = [
-        `Mode: ${report.mode} (${describeRuntimeMode(report.mode)})`,
-        `Active binary: ${renderPath(report.activeBinaryPath)}`,
-        `Current cwd: ${report.cwd}`,
-        `Framework checkout: ${report.framework.inFrameworkCheckout ? "yes" : "no"}`,
-        `Framework repo root: ${renderPath(report.frameworkSources.repoRoot)}`,
-        `Framework agentplane root: ${renderPath(report.frameworkSources.agentplaneRoot)}`,
-        `Framework core root: ${renderPath(report.frameworkSources.coreRoot)}`,
-        `Resolved agentplane: ${report.agentplane.version ?? "unknown"} @ ${renderPath(report.agentplane.packageRoot)}`,
-        `Resolved @agentplaneorg/core: ${report.core.version ?? "unknown"} @ ${renderPath(report.core.packageRoot)}`,
-    ];
-    if (repoCliExpectation.expectedVersion) {
-        lines.push(`Repository expected agentplane CLI: ${repoCliExpectation.expectedVersion}`);
-        if (repoCliExpectation.summary) {
-            lines.push(`Repository CLI status: ${repoCliExpectation.summary}`);
-        }
-        if (repoCliExpectation.recovery) {
-            lines.push(`Recovery: ${repoCliExpectation.recovery}`);
-        }
-    }
-    if (report.handoffFromBinaryPath) {
-        lines.push(`Handoff from: ${report.handoffFromBinaryPath}`);
-    }
-    if (frameworkDev.available) {
-        lines.push("", "Framework dev workflow:", "1. Canonical bootstrap:", `   - ${frameworkDev.bootstrapCommand}`, "2. Manual fallback:", ...frameworkDev.manualRepairCommands.map((command) => `   - ${command}`), "3. Verify the repo-local runtime directly:", `   - ${frameworkDev.repoLocalVerifyCommand}`, "4. If the global PATH install should resolve this checkout:", `   - ${frameworkDev.reinstallScript}`, "5. Re-verify the global wrapper:", `   - ${frameworkDev.globalVerifyCommand}`, "6. Optional: force the global installed CLI inside this checkout:", `   - ${frameworkDev.forceGlobalExample}`);
-        if (frameworkDev.recommendation) {
-            lines.push(`Recommendation: ${frameworkDev.recommendation}`);
-        }
-    }
-    return lines.join("\n");
-}
-async function resolveRepoCliExpectation(opts) {
-    try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
-        return evaluateRepoCliVersionExpectation(loaded.config, opts.report);
-    }
-    catch {
-        return {
-            expectedVersion: null,
-            activeVersion: opts.report.agentplane.version,
-            state: "unconfigured",
-            summary: null,
-            recovery: null,
-        };
-    }
-}
-export const runRuntime = async (_ctx, p) => {
-    throwGroupCommandUsage({
-        spec: runtimeSpec,
-        cmd: p.cmd,
-        subcommands: await loadDirectSubcommandNames(["runtime"]),
-        command: "runtime",
-        contextCommand: "runtime",
-    });
-};
-export const runRuntimeExplain = (ctx, p) => {
-    const report = resolveRuntimeSourceInfo({
-        cwd: ctx.cwd,
-        entryModuleUrl: import.meta.url,
-    });
-    return resolveRepoCliExpectation({
-        cwd: ctx.cwd,
-        rootOverride: ctx.rootOverride ?? null,
-        report,
-    }).then((repoCliExpectation) => {
-        const payload = { ...buildRuntimeExplainPayload(report), repoCliExpectation };
-        if (p.json) {
-            output.json(payload);
-            return 0;
-        }
-        output.line(renderRuntimeExplainText(report, repoCliExpectation));
-        return 0;
-    });
-};

package/dist/commands/runtime.spec.d.ts

@@ -1,8 +0,0 @@
-import { type GroupCommandParsed } from "../cli/group-command.js";
-import type { CommandSpec } from "../cli/spec/spec.js";
-export type RuntimeExplainParsed = {
-    json: boolean;
-};
-export declare const runtimeSpec: CommandSpec<GroupCommandParsed>;
-export declare const runtimeExplainSpec: CommandSpec<RuntimeExplainParsed>;
-//# sourceMappingURL=runtime.spec.d.ts.map

package/dist/commands/runtime.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.spec.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAQvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAoBhE,CAAC"}

package/dist/commands/runtime.spec.js

@@ -1,31 +0,0 @@
-import { parseGroupCommand } from "../cli/group-command.js";
-export const runtimeSpec = {
-    id: ["runtime"],
-    group: "Diagnostics",
-    summary: "Inspect which agentplane runtime/binary/package sources are active.",
-    synopsis: ["agentplane runtime <explain> [options]"],
-    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
-    examples: [{ cmd: "agentplane runtime explain", why: "Show active runtime details." }],
-    parse: (raw) => parseGroupCommand(raw),
-};
-export const runtimeExplainSpec = {
-    id: ["runtime", "explain"],
-    group: "Diagnostics",
-    summary: "Explain the active binary, runtime mode, and resolved package roots.",
-    options: [
-        {
-            kind: "boolean",
-            name: "json",
-            default: false,
-            description: "Emit machine-readable runtime details.",
-        },
-    ],
-    examples: [
-        { cmd: "agentplane runtime explain", why: "Show the active runtime as readable text." },
-        {
-            cmd: "agentplane runtime explain --json",
-            why: "Show runtime details for scripts and diagnostics tooling.",
-        },
-    ],
-    parse: (raw) => ({ json: raw.opts.json === true }),
-};

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

@@ -1,37 +0,0 @@
-import { resolveProject } from "@agentplaneorg/core/project";
-type RecipeToolRuntime = "node" | "bash";
-type RecipeToolInvocation = {
-    command: string;
-    args: string[];
-};
-export declare function resolveRecipeToolInvocation(runtime: RecipeToolRuntime, entrypoint: string, args: string[]): RecipeToolInvocation;
-export declare function cmdScenarioListParsed(opts: {
-    cwd: string;
-    rootOverride?: string;
-}): Promise<number>;
-export declare function cmdScenarioInfoParsed(opts: {
-    cwd: string;
-    rootOverride?: string;
-    recipeId: string;
-    scenarioId: string;
-}): Promise<number>;
-export declare function executeRecipeTool(opts: {
-    runtime: RecipeToolRuntime;
-    entrypoint: string;
-    args: string[];
-    cwd: string;
-    env: Record<string, string>;
-}): Promise<{
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}>;
-export declare function cmdScenarioRunParsed(opts: {
-    cwd: string;
-    rootOverride?: string;
-    recipeId: string;
-    scenarioId: string;
-    resolved?: Awaited<ReturnType<typeof resolveProject>>;
-}): Promise<number>;
-export {};
-//# sourceMappingURL=commands.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAkB7D,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AA0MF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,CAGtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA6ChE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB"}

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

@@ -1,323 +0,0 @@
-import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { runProcess } from "@agentplaneorg/core/process";
-import { mapCoreError } from "../../../cli/error-map.js";
-import { exitCodeForError } from "../../../cli/exit-codes.js";
-import { fileExists } from "../../../cli/fs-utils.js";
-import { createCliEmitter, emptyStateMessage } from "../../../cli/output.js";
-import { CliError } from "../../../shared/errors.js";
-import { listResolvedRecipeScenarios, readProjectInstalledRecipes, readScenarioDefinition, resolveRecipeScenarioSelection, } from "../../recipes.js";
-const output = createCliEmitter();
-const SCENARIO_SELECTION_ERROR_RULES = [
-    {
-        startsWith: ["No recipe scenario matches"],
-        exitCode: exitCodeForError("E_IO"),
-        code: "E_IO",
-        message: (_message) => "",
-    },
-    {
-        startsWith: ["Scenario definition not found"],
-        exitCode: exitCodeForError("E_IO"),
-        code: "E_IO",
-    },
-    {
-        startsWith: [
-            "Scenario selection is ambiguous",
-            "Missing required field: scenario.",
-            "Invalid field scenario.",
-            "Scenario definition id mismatch:",
-        ],
-        exitCode: exitCodeForError("E_VALIDATION"),
-        code: "E_VALIDATION",
-    },
-];
-const RECIPE_TOOL_INVOCATIONS = {
-    node: (entrypoint) => ({ command: "node", args: [entrypoint] }),
-    bash: (entrypoint) => ({ command: "bash", args: [entrypoint] }),
-};
-function buildScenarioNotFoundError(recipeId, scenarioId) {
-    return new CliError({
-        exitCode: exitCodeForError("E_IO"),
-        code: "E_IO",
-        message: `Scenario not found: ${recipeId}:${scenarioId}`,
-    });
-}
-function mapScenarioSelectionError(recipeId, scenarioId, error) {
-    const message = error instanceof Error ? error.message : String(error);
-    for (const rule of SCENARIO_SELECTION_ERROR_RULES) {
-        if (!rule.startsWith.some((prefix) => message.startsWith(prefix)))
-            continue;
-        if (message.startsWith("No recipe scenario matches")) {
-            return buildScenarioNotFoundError(recipeId, scenarioId);
-        }
-        return new CliError({
-            exitCode: rule.exitCode,
-            code: rule.code,
-            message: rule.message ? rule.message(message) : message,
-        });
-    }
-    return null;
-}
-async function resolveScenarioForCli(opts) {
-    const installed = await readProjectInstalledRecipes(opts.project);
-    const entry = installed.recipes.find((recipe) => recipe.id === opts.recipeId);
-    if (!entry) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_IO"),
-            code: "E_IO",
-            message: `Recipe not installed: ${opts.recipeId}`,
-        });
-    }
-    try {
-        const selection = await resolveRecipeScenarioSelection({
-            project: opts.project,
-            flags: {
-                recipeId: opts.recipeId,
-                scenarioId: opts.scenarioId,
-                includeIncompatible: true,
-            },
-        });
-        return { entry, selection };
-    }
-    catch (error) {
-        const mapped = mapScenarioSelectionError(opts.recipeId, opts.scenarioId, error);
-        if (mapped)
-            throw mapped;
-        throw error;
-    }
-}
-async function readValidatedScenarioDefinition(opts) {
-    if (!(await fileExists(opts.selection.scenario_file))) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_IO"),
-            code: "E_IO",
-            message: `Scenario definition not found: ${opts.selection.scenario_file}`,
-        });
-    }
-    try {
-        const scenario = await readScenarioDefinition(opts.selection.scenario_file);
-        if (scenario.id !== opts.selection.scenario_id) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_VALIDATION"),
-                code: "E_VALIDATION",
-                message: `Scenario definition id mismatch: manifest expects ${opts.selection.scenario_id}, ` +
-                    `file defines ${scenario.id}`,
-            });
-        }
-        return scenario;
-    }
-    catch (error) {
-        if (error instanceof CliError)
-            throw error;
-        throw new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
-            message: error instanceof Error ? error.message : String(error),
-        });
-    }
-}
-async function validateScenarioRecipeFiles(opts) {
-    const checks = [];
-    const agents = opts.entry.manifest.agents ?? [];
-    const skills = opts.entry.manifest.skills ?? [];
-    const tools = opts.entry.manifest.tools ?? [];
-    const selectedAgents = agents.filter((agent) => opts.selection.agents_involved.includes(agent.id));
-    const selectedSkills = skills.filter((skill) => opts.selection.skills_used.includes(skill.id));
-    const selectedTools = tools.filter((tool) => opts.selection.tools_used.includes(tool.id));
-    for (const agent of selectedAgents) {
-        const agentFile = path.join(opts.selection.recipe_dir, agent.file);
-        if (!(await fileExists(agentFile))) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_IO"),
-                code: "E_IO",
-                message: `Recipe agent file not found: ${agent.file}`,
-            });
-        }
-    }
-    checks.push(`agent files ok: ${selectedAgents.length}`);
-    for (const skill of selectedSkills) {
-        const skillFile = path.join(opts.selection.recipe_dir, skill.file);
-        if (!(await fileExists(skillFile))) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_IO"),
-                code: "E_IO",
-                message: `Recipe skill file not found: ${skill.file}`,
-            });
-        }
-    }
-    checks.push(`skill files ok: ${selectedSkills.length}`);
-    for (const tool of selectedTools) {
-        const toolEntrypoint = path.join(opts.selection.recipe_dir, tool.entrypoint);
-        if (!(await fileExists(toolEntrypoint))) {
-            throw new CliError({
-                exitCode: exitCodeForError("E_IO"),
-                code: "E_IO",
-                message: `Tool entrypoint not found: ${tool.entrypoint}`,
-            });
-        }
-    }
-    checks.push(`tool entrypoints ok: ${selectedTools.length}`);
-    return checks;
-}
-function assertScenarioCompatibility(selection) {
-    if (selection.compatibility.ok)
-        return;
-    const reasons = selection.compatibility.failures
-        .map((failure) => `- ${failure.reason}`)
-        .join("\n");
-    throw new CliError({
-        exitCode: exitCodeForError("E_VALIDATION"),
-        code: "E_VALIDATION",
-        message: `Scenario is not compatible with the current runtime:\n${reasons}`,
-    });
-}
-export function resolveRecipeToolInvocation(runtime, entrypoint, args) {
-    const invocation = RECIPE_TOOL_INVOCATIONS[runtime](entrypoint);
-    return { command: invocation.command, args: [...invocation.args, ...args] };
-}
-export async function cmdScenarioListParsed(opts) {
-    try {
-        const project = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const entries = await listResolvedRecipeScenarios({
-            project,
-            includeIncompatible: true,
-        });
-        if (entries.length === 0) {
-            output.line(emptyStateMessage("scenarios", "Install a recipe to add scenarios."));
-            return 0;
-        }
-        for (const entry of entries) {
-            const compatibilityLabel = entry.compatibility.ok ? "compatible" : "incompatible";
-            output.line(`${entry.recipe_id}:${entry.scenario_id} - ${entry.scenario_summary} ` +
-                `[mode=${entry.run_profile.mode}] [${compatibilityLabel}]`);
-        }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "recipes scenario list", root: opts.rootOverride ?? null });
-    }
-}
-export async function cmdScenarioInfoParsed(opts) {
-    try {
-        const project = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const { selection } = await resolveScenarioForCli({
-            project,
-            recipeId: opts.recipeId,
-            scenarioId: opts.scenarioId,
-        });
-        output.line(`Scenario: ${selection.recipe_id}:${selection.scenario_id}`);
-        output.line(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})`);
-        output.line(`Summary: ${selection.scenario_summary}`);
-        if (selection.scenario_description) {
-            output.line(`Description: ${selection.scenario_description}`);
-        }
-        output.jsonSection("Use when", selection.use_when);
-        if (selection.avoid_when.length > 0) {
-            output.jsonSection("Avoid when", selection.avoid_when);
-        }
-        output.jsonSection("Run profile", selection.run_profile);
-        output.jsonSection("Task template", selection.task_template);
-        output.line(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}`);
-        if (selection.compatibility.ok) {
-            output.line("Compatibility: satisfied");
-        }
-        else {
-            output.jsonSection("Compatibility failures", selection.compatibility.failures);
-        }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "recipes scenario info", root: opts.rootOverride ?? null });
-    }
-}
-export async function executeRecipeTool(opts) {
-    const { command, args } = resolveRecipeToolInvocation(opts.runtime, opts.entrypoint, opts.args);
-    try {
-        const { stdout, stderr } = await runProcess({
-            command,
-            args,
-            cwd: opts.cwd,
-            env: opts.env,
-        });
-        return { exitCode: 0, stdout: String(stdout), stderr: String(stderr) };
-    }
-    catch (err) {
-        const rawCode = err && typeof err === "object" && "code" in err
-            ? err.code
-            : undefined;
-        const code = typeof rawCode === "number" ? rawCode : undefined;
-        const isCommandNotFound = rawCode === "ENOENT" || code === 127;
-        let execErr = null;
-        if (err && typeof err === "object") {
-            execErr = err;
-        }
-        const exitCode = typeof execErr?.code === "number" ? execErr.code : 1;
-        let stderrText = String(execErr?.stderr ?? "");
-        const isMissingNodeEntrypoint = command === "node" &&
-            /Cannot find module/i.test(stderrText) &&
-            (stderrText.includes(opts.entrypoint) || stderrText.includes(`${opts.entrypoint}.js`));
-        if (isMissingNodeEntrypoint && !isCommandNotFound) {
-            const runtimeLabel = opts.entrypoint.replace(/\.(js|mjs|cjs)$/, "");
-            stderrText = `Runtime command not found: ${runtimeLabel}`;
-            return {
-                exitCode: 1,
-                stdout: "",
-                stderr: stderrText,
-            };
-        }
-        if (isCommandNotFound && !stderrText) {
-            stderrText = `Runtime command not found: ${command}`;
-        }
-        return {
-            exitCode,
-            stdout: String(execErr?.stdout ?? ""),
-            stderr: stderrText,
-        };
-    }
-}
-export async function cmdScenarioRunParsed(opts) {
-    const project = opts.resolved ??
-        (await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        }));
-    try {
-        const { entry, selection } = await resolveScenarioForCli({
-            project,
-            recipeId: opts.recipeId,
-            scenarioId: opts.scenarioId,
-        });
-        assertScenarioCompatibility(selection);
-        const scenarioDefinition = await readValidatedScenarioDefinition({ selection });
-        const validationChecks = await validateScenarioRecipeFiles({ entry, selection });
-        output.line(`Prepared run plan: ${selection.recipe_id}:${selection.scenario_id}`);
-        output.line(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})`);
-        output.line(`Goal: ${scenarioDefinition.goal}`);
-        output.line(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}`);
-        output.jsonSection("Run profile", selection.run_profile);
-        output.jsonSection("Selection reasons", selection.selection_reasons);
-        output.jsonSection("Validation", [
-            `scenario definition ok: ${path.relative(project.gitRoot, selection.scenario_file)}`,
-            ...validationChecks,
-        ]);
-        output.line("Status: preview only; no task created and no runner executed.");
-        output.line(`Next: use \`agentplane recipes scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
-            "to materialize and run this scenario.");
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "recipes scenario run", root: opts.rootOverride ?? null });
-    }
-}

package/dist/commands/scenario/info.command.d.ts

@@ -1,8 +0,0 @@
-import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-export type ScenarioInfoParsed = {
-    recipeId: string;
-    scenarioId: string;
-};
-export declare const scenarioInfoSpec: CommandSpec<ScenarioInfoParsed>;
-export declare const runScenarioInfo: CommandHandler<ScenarioInfoParsed>;
-//# sourceMappingURL=info.command.d.ts.map

package/dist/commands/scenario/info.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"info.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/info.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1E,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAuB5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAM3D,CAAC"}

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

@@ -1,32 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { cmdScenarioInfoParsed } from "../scenario.js";
-export const scenarioInfoSpec = {
-    id: ["recipes", "scenario", "info"],
-    group: "Recipes",
-    summary: "Show manifest-backed scenario details and normalized run profile.",
-    args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
-    examples: [
-        {
-            cmd: "agentplane recipes scenario info viewer:demo",
-            why: "Inspect resolver-backed scenario metadata before execution.",
-        },
-    ],
-    parse: (raw) => {
-        const id = String(raw.args.id ?? "");
-        const [recipeId, scenarioId] = id.split(":", 2);
-        if (!recipeId || !scenarioId) {
-            throw usageError({
-                spec: scenarioInfoSpec,
-                command: "recipes scenario info",
-                message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
-            });
-        }
-        return { recipeId, scenarioId };
-    },
-};
-export const runScenarioInfo = (ctx, p) => cmdScenarioInfoParsed({
-    cwd: ctx.cwd,
-    rootOverride: ctx.rootOverride,
-    recipeId: p.recipeId,
-    scenarioId: p.scenarioId,
-});

package/dist/commands/scenario/list.command.d.ts

@@ -1,5 +0,0 @@
-import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-export type ScenarioListParsed = Record<string, never>;
-export declare const scenarioListSpec: CommandSpec<ScenarioListParsed>;
-export declare const runScenarioList: CommandHandler<ScenarioListParsed>;
-//# sourceMappingURL=list.command.d.ts.map

package/dist/commands/scenario/list.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/list.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEvD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAM5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CACU,CAAC"}

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

@@ -1,9 +0,0 @@
-import { cmdScenarioListParsed } from "../scenario.js";
-export const scenarioListSpec = {
-    id: ["recipes", "scenario", "list"],
-    group: "Recipes",
-    summary: "List resolver-backed scenario descriptors from installed recipes.",
-    parse: () => ({}),
-    examples: [{ cmd: "agentplane recipes scenario list", why: "List available recipe scenarios." }],
-};
-export const runScenarioList = (ctx) => cmdScenarioListParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

package/dist/commands/scenario/run.command.d.ts

@@ -1,8 +0,0 @@
-import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-export type ScenarioRunParsed = {
-    recipeId: string;
-    scenarioId: string;
-};
-export declare const scenarioRunSpec: CommandSpec<ScenarioRunParsed>;
-export declare const runScenarioRun: CommandHandler<ScenarioRunParsed>;
-//# sourceMappingURL=run.command.d.ts.map

package/dist/commands/scenario/run.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/run.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1E,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuB1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAMzD,CAAC"}

package/dist/commands/scenario/run.command.js

@@ -1,32 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { cmdScenarioRunParsed } from "../scenario.js";
-export const scenarioRunSpec = {
-    id: ["recipes", "scenario", "run"],
-    group: "Recipes",
-    summary: "Preview a validated scenario plan without creating a task or running a runner.",
-    args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
-    examples: [
-        {
-            cmd: "agentplane recipes scenario run viewer:demo",
-            why: "Validate a scenario and inspect the preview plan before `recipes scenario execute`.",
-        },
-    ],
-    parse: (raw) => {
-        const id = String(raw.args.id ?? "");
-        const [recipeId, scenarioId] = id.split(":", 2);
-        if (!recipeId || !scenarioId) {
-            throw usageError({
-                spec: scenarioRunSpec,
-                command: "recipes scenario run",
-                message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
-            });
-        }
-        return { recipeId, scenarioId };
-    },
-};
-export const runScenarioRun = (ctx, p) => cmdScenarioRunParsed({
-    cwd: ctx.cwd,
-    rootOverride: ctx.rootOverride,
-    recipeId: p.recipeId,
-    scenarioId: p.scenarioId,
-});

package/dist/commands/scenario.d.ts

@@ -1,2 +0,0 @@
-export { cmdScenarioInfoParsed, cmdScenarioListParsed, cmdScenarioRunParsed, } from "./scenario/impl/commands.js";
-//# sourceMappingURL=scenario.d.ts.map