agentplane 0.1.9 → 0.2.0

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

@@ -0,0 +1,19 @@
+import { resolveProject } from "@agentplaneorg/core";
+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 cmdScenarioRunParsed(opts: {
+    cwd: string;
+    rootOverride?: string;
+    recipeId: string;
+    scenarioId: string;
+    resolved?: Awaited<ReturnType<typeof resolveProject>>;
+}): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA+BtE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB;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,CAoElB;AAkCD,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,CAqNlB"}

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

@@ -0,0 +1,336 @@
+import { execFile } from "node:child_process";
+import { mkdir, readdir } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { atomicWriteFile, resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../../cli/error-map.js";
+import { fileExists, getPathKind } from "../../../cli/fs-utils.js";
+import { emptyStateMessage } from "../../../cli/output.js";
+import { CliError } from "../../../shared/errors.js";
+import { RECIPES_DIR_NAME, RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME, normalizeScenarioToolStep, readInstalledRecipesFile, readRecipeManifest, readScenarioDefinition, readScenarioIndex, resolveInstalledRecipeDir, resolveInstalledRecipesPath, resolveProjectRecipesCacheDir, } from "../../recipes.js";
+import { collectScenarioEnvKeys, getGitDiffSummary, redactArgs, writeScenarioReport, } from "./report.js";
+const execFileAsync = promisify(execFile);
+export async function cmdScenarioListParsed(opts) {
+    try {
+        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const entries = [];
+        for (const recipe of installed.recipes) {
+            const recipeDir = resolveInstalledRecipeDir(recipe);
+            const scenariosDir = path.join(recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+            if ((await getPathKind(scenariosDir)) === "dir") {
+                const files = await readdir(scenariosDir);
+                const jsonFiles = files.filter((entry) => entry.toLowerCase().endsWith(".json")).toSorted();
+                for (const file of jsonFiles) {
+                    const scenario = await readScenarioDefinition(path.join(scenariosDir, file));
+                    entries.push({ recipeId: recipe.id, scenarioId: scenario.id, summary: scenario.summary });
+                }
+                continue;
+            }
+            const scenariosIndexPath = path.join(recipeDir, RECIPES_SCENARIOS_INDEX_NAME);
+            if (await fileExists(scenariosIndexPath)) {
+                const index = await readScenarioIndex(scenariosIndexPath);
+                for (const scenario of index.scenarios) {
+                    entries.push({
+                        recipeId: recipe.id,
+                        scenarioId: scenario.id,
+                        summary: scenario.summary,
+                    });
+                }
+            }
+        }
+        if (entries.length === 0) {
+            process.stdout.write(`${emptyStateMessage("scenarios", "Install a recipe to add scenarios.")}\n`);
+            return 0;
+        }
+        const sorted = entries.toSorted((a, b) => {
+            const byRecipe = a.recipeId.localeCompare(b.recipeId);
+            if (byRecipe !== 0)
+                return byRecipe;
+            return a.scenarioId.localeCompare(b.scenarioId);
+        });
+        for (const entry of sorted) {
+            process.stdout.write(`${entry.recipeId}:${entry.scenarioId} - ${entry.summary ?? "No summary"}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "scenario list", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdScenarioInfoParsed(opts) {
+    const { recipeId, scenarioId } = opts;
+    try {
+        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const entry = installed.recipes.find((recipe) => recipe.id === recipeId);
+        if (!entry) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_IO",
+                message: `Recipe not installed: ${recipeId}`,
+            });
+        }
+        const recipeDir = resolveInstalledRecipeDir(entry);
+        const scenariosDir = path.join(recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+        let scenario = null;
+        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 candidate = await readScenarioDefinition(path.join(scenariosDir, file));
+                if (candidate.id === scenarioId) {
+                    scenario = candidate;
+                    break;
+                }
+            }
+        }
+        let summary;
+        if (!scenario) {
+            const scenariosIndexPath = path.join(recipeDir, RECIPES_SCENARIOS_INDEX_NAME);
+            if (await fileExists(scenariosIndexPath)) {
+                const index = await readScenarioIndex(scenariosIndexPath);
+                const entrySummary = index.scenarios.find((item) => item.id === scenarioId);
+                summary = entrySummary?.summary;
+            }
+        }
+        if (!scenario && !summary) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_IO",
+                message: `Scenario not found: ${recipeId}:${scenarioId}`,
+            });
+        }
+        process.stdout.write(`Scenario: ${recipeId}:${scenarioId}\n`);
+        if (summary)
+            process.stdout.write(`Summary: ${summary}\n`);
+        if (!scenario) {
+            process.stdout.write("Details: Scenario definition not found in recipe.\n");
+            return 0;
+        }
+        if (scenario.summary)
+            process.stdout.write(`Summary: ${scenario.summary}\n`);
+        if (scenario.description)
+            process.stdout.write(`Description: ${scenario.description}\n`);
+        process.stdout.write(`Goal: ${scenario.goal}\n`);
+        process.stdout.write(`Inputs: ${JSON.stringify(scenario.inputs, null, 2)}\n`);
+        process.stdout.write(`Outputs: ${JSON.stringify(scenario.outputs, null, 2)}\n`);
+        process.stdout.write("Steps:\n");
+        let stepIndex = 1;
+        for (const step of scenario.steps) {
+            process.stdout.write(`  ${stepIndex}. ${JSON.stringify(step)}\n`);
+            stepIndex += 1;
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "scenario info", root: opts.rootOverride ?? null });
+    }
+}
+async function executeRecipeTool(opts) {
+    try {
+        const command = opts.runtime === "node" ? "node" : "bash";
+        const { stdout, stderr } = await execFileAsync(command, [opts.entrypoint, ...opts.args], {
+            cwd: opts.cwd,
+            env: opts.env,
+        });
+        return { exitCode: 0, stdout: String(stdout), stderr: String(stderr) };
+    }
+    catch (err) {
+        let execErr = null;
+        if (err && typeof err === "object") {
+            execErr = err;
+        }
+        const exitCode = typeof execErr?.code === "number" ? execErr.code : 1;
+        return {
+            exitCode,
+            stdout: String(execErr?.stdout ?? ""),
+            stderr: String(execErr?.stderr ?? ""),
+        };
+    }
+}
+function sanitizeRunId(value) {
+    return value.replaceAll(/[^a-zA-Z0-9._-]/g, "_");
+}
+export async function cmdScenarioRunParsed(opts) {
+    const resolved = opts.resolved ??
+        (await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        }));
+    const { recipeId, scenarioId } = opts;
+    try {
+        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const entry = installed.recipes.find((recipe) => recipe.id === recipeId);
+        if (!entry) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_IO",
+                message: `Recipe not installed: ${recipeId}`,
+            });
+        }
+        const recipeDir = resolveInstalledRecipeDir(entry);
+        const manifestPath = path.join(recipeDir, "manifest.json");
+        const manifest = await readRecipeManifest(manifestPath);
+        const scenariosDir = path.join(recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+        if ((await getPathKind(scenariosDir)) !== "dir") {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_IO",
+                message: `Scenario definitions not found for recipe: ${recipeId}`,
+            });
+        }
+        let scenario = null;
+        const files = await readdir(scenariosDir);
+        const jsonFiles = files.filter((file) => file.toLowerCase().endsWith(".json")).toSorted();
+        for (const file of jsonFiles) {
+            const candidate = await readScenarioDefinition(path.join(scenariosDir, file));
+            if (candidate.id === scenarioId) {
+                scenario = candidate;
+                break;
+            }
+        }
+        if (!scenario) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_IO",
+                message: `Scenario not found: ${recipeId}:${scenarioId}`,
+            });
+        }
+        const runsRoot = path.join(resolved.agentplaneDir, RECIPES_DIR_NAME, recipeId, "runs");
+        await mkdir(runsRoot, { recursive: true });
+        const recipesCacheDir = resolveProjectRecipesCacheDir(resolved);
+        await mkdir(recipesCacheDir, { recursive: true });
+        const runStartedAt = new Date().toISOString();
+        const runId = `${new Date()
+            .toISOString()
+            .replaceAll(":", "-")
+            .replaceAll(".", "-")}-${sanitizeRunId(scenarioId)}`;
+        const runDir = path.join(runsRoot, runId);
+        await mkdir(runDir, { recursive: true });
+        const stepsMeta = [];
+        const stepsReport = [];
+        for (let index = 0; index < scenario.steps.length; index++) {
+            const step = normalizeScenarioToolStep(scenario.steps[index], `${recipeId}:${scenarioId}`);
+            const toolEntry = manifest.tools?.find((tool) => tool?.id === step.tool);
+            if (!toolEntry) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_IO",
+                    message: `Tool not found in recipe manifest: ${step.tool}`,
+                });
+            }
+            const runtime = toolEntry.runtime === "node" || toolEntry.runtime === "bash" ? toolEntry.runtime : "";
+            const entrypoint = typeof toolEntry.entrypoint === "string" ? toolEntry.entrypoint : "";
+            if (!runtime || !entrypoint) {
+                throw new CliError({
+                    exitCode: 3,
+                    code: "E_VALIDATION",
+                    message: `Tool entry is missing runtime/entrypoint: ${step.tool}`,
+                });
+            }
+            if (Array.isArray(toolEntry.permissions) && toolEntry.permissions.length > 0) {
+                process.stdout.write(`Warning: tool ${toolEntry.id} declares permissions: ${toolEntry.permissions.join(", ")}\n`);
+            }
+            const entrypointPath = path.join(recipeDir, entrypoint);
+            if (!(await fileExists(entrypointPath))) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_IO",
+                    message: `Tool entrypoint not found: ${entrypoint}`,
+                });
+            }
+            const stepDir = path.join(runDir, `step-${index + 1}-${sanitizeRunId(step.tool)}`);
+            await mkdir(stepDir, { recursive: true });
+            const stepEnvKeys = collectScenarioEnvKeys(step.env);
+            const env = {
+                ...process.env,
+                ...step.env,
+                AGENTPLANE_RUN_DIR: runDir,
+                AGENTPLANE_STEP_DIR: stepDir,
+                AGENTPLANE_RECIPES_CACHE_DIR: recipesCacheDir,
+                AGENTPLANE_RECIPE_ID: recipeId,
+                AGENTPLANE_SCENARIO_ID: scenarioId,
+                AGENTPLANE_TOOL_ID: step.tool,
+            };
+            const startedAt = Date.now();
+            const result = await executeRecipeTool({
+                runtime,
+                entrypoint: entrypointPath,
+                args: step.args,
+                cwd: recipeDir,
+                env,
+            });
+            const durationMs = Date.now() - startedAt;
+            await atomicWriteFile(path.join(stepDir, "stdout.log"), result.stdout, "utf8");
+            await atomicWriteFile(path.join(stepDir, "stderr.log"), result.stderr, "utf8");
+            stepsMeta.push({
+                tool: step.tool,
+                runtime,
+                entrypoint,
+                exitCode: result.exitCode,
+                duration_ms: durationMs,
+            });
+            stepsReport.push({
+                step: index + 1,
+                tool: step.tool,
+                runtime,
+                entrypoint,
+                args: redactArgs(step.args),
+                env_keys: stepEnvKeys,
+                exit_code: result.exitCode,
+                duration_ms: durationMs,
+            });
+            if (result.exitCode !== 0) {
+                const gitSummary = await getGitDiffSummary(resolved.gitRoot);
+                await writeScenarioReport({
+                    runDir,
+                    recipeId,
+                    scenarioId,
+                    runId,
+                    startedAt: runStartedAt,
+                    status: "failed",
+                    steps: stepsReport,
+                    gitSummary,
+                });
+                await atomicWriteFile(path.join(runDir, "meta.json"), `${JSON.stringify({
+                    recipe: recipeId,
+                    scenario: scenarioId,
+                    run_id: runId,
+                    steps: stepsMeta,
+                }, null, 2)}\n`, "utf8");
+                throw new CliError({
+                    exitCode: result.exitCode,
+                    code: "E_INTERNAL",
+                    message: `Scenario step failed: ${step.tool}`,
+                });
+            }
+        }
+        const gitSummary = await getGitDiffSummary(resolved.gitRoot);
+        await writeScenarioReport({
+            runDir,
+            recipeId,
+            scenarioId,
+            runId,
+            startedAt: runStartedAt,
+            status: "success",
+            steps: stepsReport,
+            gitSummary,
+        });
+        await atomicWriteFile(path.join(runDir, "meta.json"), `${JSON.stringify({
+            recipe: recipeId,
+            scenario: scenarioId,
+            run_id: runId,
+            steps: stepsMeta,
+        }, null, 2)}\n`, "utf8");
+        process.stdout.write(`Run artifacts: ${path.relative(resolved.gitRoot, runDir)}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "scenario run", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,30 @@
+type ScenarioRunGitSummary = {
+    diff_stat?: string;
+    staged_stat?: string;
+    status?: string[];
+};
+export type ScenarioRunReportStep = {
+    step: number;
+    tool: string;
+    runtime: string;
+    entrypoint: string;
+    args: string[];
+    env_keys: string[];
+    exit_code: number;
+    duration_ms: number;
+};
+export declare function redactArgs(args: string[]): string[];
+export declare function getGitDiffSummary(cwd: string): Promise<ScenarioRunGitSummary | undefined>;
+export declare function collectScenarioEnvKeys(stepEnv: Record<string, string> | undefined): string[];
+export declare function writeScenarioReport(opts: {
+    runDir: string;
+    recipeId: string;
+    scenarioId: string;
+    runId: string;
+    startedAt: string;
+    status: "success" | "failed";
+    steps: ScenarioRunReportStep[];
+    gitSummary?: ScenarioRunGitSummary;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/report.ts"],"names":[],"mappings":"AAYA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA2BF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmBnD;AASD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwB/F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAU5F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB"}

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

@@ -0,0 +1,99 @@
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { atomicWriteFile } from "@agentplaneorg/core";
+import { dedupeStrings } from "../../../shared/strings.js";
+const execFileAsync = promisify(execFile);
+const SCENARIO_REPORT_NAME = "report.json";
+const SENSITIVE_ARG_FLAGS = new Set([
+    "--token",
+    "--secret",
+    "--password",
+    "--api-key",
+    "--apikey",
+    "--access-key",
+    "--client-secret",
+    "--auth",
+    "--authorization",
+    "--bearer",
+]);
+export function redactArgs(args) {
+    const out = [...args];
+    for (let i = 0; i < out.length; i++) {
+        const arg = out[i];
+        if (!arg)
+            continue;
+        const eqIndex = arg.indexOf("=");
+        const flag = eqIndex === -1 ? arg : arg.slice(0, eqIndex);
+        if (!SENSITIVE_ARG_FLAGS.has(flag))
+            continue;
+        if (eqIndex !== -1) {
+            out[i] = `${flag}=<redacted>`;
+            continue;
+        }
+        out[i] = flag;
+        if (i + 1 < out.length && !out[i + 1]?.startsWith("-")) {
+            out[i + 1] = "<redacted>";
+            i += 1;
+        }
+    }
+    return out;
+}
+function isNotGitRepoError(err) {
+    if (err instanceof Error) {
+        return err.message.startsWith("Not a git repository");
+    }
+    return false;
+}
+export async function getGitDiffSummary(cwd) {
+    try {
+        const [diff, staged, status] = await Promise.all([
+            execFileAsync("git", ["diff", "--stat"], { cwd }),
+            execFileAsync("git", ["diff", "--stat", "--staged"], { cwd }),
+            execFileAsync("git", ["status", "--porcelain"], { cwd }),
+        ]);
+        const diffStat = String(diff.stdout).trim();
+        const stagedStat = String(staged.stdout).trim();
+        const statusLines = String(status.stdout).trim();
+        return {
+            diff_stat: diffStat || undefined,
+            staged_stat: stagedStat || undefined,
+            status: statusLines
+                ? statusLines
+                    .split("\n")
+                    .map((line) => line.trim())
+                    .filter(Boolean)
+                : [],
+        };
+    }
+    catch (err) {
+        if (isNotGitRepoError(err))
+            return undefined;
+        return undefined;
+    }
+}
+export function collectScenarioEnvKeys(stepEnv) {
+    return dedupeStrings([
+        ...Object.keys(stepEnv ?? {}),
+        "AGENTPLANE_RUN_DIR",
+        "AGENTPLANE_STEP_DIR",
+        "AGENTPLANE_RECIPES_CACHE_DIR",
+        "AGENTPLANE_RECIPE_ID",
+        "AGENTPLANE_SCENARIO_ID",
+        "AGENTPLANE_TOOL_ID",
+    ]);
+}
+export async function writeScenarioReport(opts) {
+    const report = {
+        schema_version: 1,
+        recipe: opts.recipeId,
+        scenario: opts.scenarioId,
+        run_id: opts.runId,
+        started_at: opts.startedAt,
+        ended_at: new Date().toISOString(),
+        status: opts.status,
+        steps: opts.steps,
+        git: opts.gitSummary,
+    };
+    await atomicWriteFile(path.join(opts.runDir, SCENARIO_REPORT_NAME), `${JSON.stringify(report, null, 2)}\n`, "utf8");
+}

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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1 @@
+{"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,CAkB5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAM3D,CAAC"}

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

@@ -0,0 +1,27 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdScenarioInfoParsed } from "../scenario.js";
+export const scenarioInfoSpec = {
+    id: ["scenario", "info"],
+    group: "Scenario",
+    summary: "Show scenario details (goal/inputs/outputs/steps).",
+    args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
+    examples: [{ cmd: "agentplane scenario info viewer:demo", why: "Show scenario details." }],
+    parse: (raw) => {
+        const id = String(raw.args.id ?? "");
+        const [recipeId, scenarioId] = id.split(":", 2);
+        if (!recipeId || !scenarioId) {
+            throw usageError({
+                spec: scenarioInfoSpec,
+                command: "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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1 @@
+{"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,CAkB1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAMzD,CAAC"}

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

@@ -0,0 +1,27 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdScenarioRunParsed } from "../scenario.js";
+export const scenarioRunSpec = {
+    id: ["scenario", "run"],
+    group: "Scenario",
+    summary: "Run a scenario toolchain from an installed recipe.",
+    args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
+    examples: [{ cmd: "agentplane scenario run viewer:demo", why: "Run a scenario." }],
+    parse: (raw) => {
+        const id = String(raw.args.id ?? "");
+        const [recipeId, scenarioId] = id.split(":", 2);
+        if (!recipeId || !scenarioId) {
+            throw usageError({
+                spec: scenarioRunSpec,
+                command: "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/scenario.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+type ScenarioParsed = Record<string, never>;
+export declare const scenarioSpec: CommandSpec<ScenarioParsed>;
+export declare const runScenario: CommandHandler<ScenarioParsed>;
+export {};
+//# sourceMappingURL=scenario.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/scenario.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAI5C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAyBpD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,cAAc,CAOtD,CAAC"}

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

@@ -0,0 +1,37 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+const SCENARIO_SUBCOMMANDS = ["list", "info", "run"];
+export const scenarioSpec = {
+    id: ["scenario"],
+    group: "Scenario",
+    summary: "Recipe scenario commands.",
+    synopsis: ["agentplane scenario <subcommand> [options]"],
+    args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
+    parse: () => ({}),
+    validateRaw: (raw) => {
+        const rest = Array.isArray(raw.args.subcommand) ? raw.args.subcommand : [];
+        const sub = rest[0];
+        if (!sub) {
+            throw usageError({
+                spec: scenarioSpec,
+                command: "scenario",
+                message: "Missing scenario subcommand.",
+            });
+        }
+        const suggestion = suggestOne(String(sub), [...SCENARIO_SUBCOMMANDS]);
+        const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+        throw usageError({
+            spec: scenarioSpec,
+            command: "scenario",
+            message: `Unknown scenario subcommand: ${String(sub)}.${suffix}`,
+        });
+    },
+};
+export const runScenario = (_ctx) => {
+    // Should be unreachable because validateRaw always throws.
+    throw usageError({
+        spec: scenarioSpec,
+        command: "scenario",
+        message: "Missing scenario subcommand.",
+    });
+};

package/dist/commands/scenario.d.ts

@@ -1,7 +1,2 @@
-export declare function cmdScenario(opts: {
-    cwd: string;
-    rootOverride?: string;
-    command?: string;
-    args: string[];
-}): Promise<number>;
+export { cmdScenarioInfoParsed, cmdScenarioListParsed, cmdScenarioRunParsed, } from "./scenario/impl/commands.js";
 //# sourceMappingURL=scenario.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/commands/scenario.ts"],"names":[],"mappings":"AAojBA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlB"}
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/commands/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}