agentplane 0.3.4 → 0.3.6

package/dist/commands/guard/impl/commands.js

@@ -1,15 +1,30 @@
 import { mapCoreError } from "../../../cli/error-map.js";
-import { successMessage } from "../../../cli/output.js";
+import { infoMessage, successMessage } from "../../../cli/output.js";
+import { stripAnsi } from "../../../cli/shared/ansi.js";
 import { withDiagnosticContext } from "../../../shared/diagnostics.js";
 import { CliError } from "../../../shared/errors.js";
 import { loadCommandContext } from "../../shared/task-backend.js";
 import { loadTaskFromContext } from "../../shared/task-backend.js";
 import { execFileAsync, gitEnv } from "../../shared/git.js";
 import { ensureReconciledBeforeMutation } from "../../shared/reconcile-check.js";
-import { suggestAllowPrefixes } from "./allow.js";
+import { stageAllowlist, suggestAllowPrefixes } from "./allow.js";
 import { buildCloseCommitMessage, taskReadmePathForTask } from "./close-message.js";
 import { buildGitCommitEnv } from "./env.js";
 import { guardCommitCheck } from "./policy.js";
+const COMMIT_FAILURE_SIGNAL_PATTERNS = [
+    /Code style issues found/i,
+    /Run Prettier with --write/i,
+    /\bESLint\b/i,
+    /\b[0-9]+\s+problems?\b/i,
+    /\berror\b/i,
+    /\bfailed\b/i,
+    /✖/,
+];
+const FORMATTER_SIGNAL_PATTERNS = [
+    /Code style issues found/i,
+    /Run Prettier with --write/i,
+];
+const ESLINT_SIGNAL_PATTERNS = [/\bESLint\b/i, /\b[0-9]+\s+problems?\b/i];
 function readText(value) {
     if (typeof value === "string")
         return value;
@@ -21,16 +36,103 @@ function summarizeOutput(raw) {
     const lines = raw
         .replaceAll("\r\n", "\n")
         .split("\n")
-        .map((line) => line.trimEnd())
+        .map((line) => stripAnsi(line).trimEnd())
         .filter((line) => line.trim().length > 0)
         .map((line) => (line.length > 180 ? `${line.slice(0, 180)} [truncated]` : line));
     if (lines.length <= 12)
         return lines;
-    const head = lines.slice(0, 6);
-    const tail = lines.slice(-6);
-    return [...head, `[${lines.length - 12} lines omitted]`, ...tail];
+    const selected = new Set();
+    for (let index = 0; index < Math.min(6, lines.length); index += 1) {
+        selected.add(index);
+    }
+    for (let index = Math.max(lines.length - 6, 0); index < lines.length; index += 1) {
+        selected.add(index);
+    }
+    for (const [index, line] of lines.entries()) {
+        if (selected.has(index))
+            continue;
+        if (COMMIT_FAILURE_SIGNAL_PATTERNS.some((pattern) => pattern.test(line))) {
+            selected.add(index);
+        }
+    }
+    const ordered = [...selected].toSorted((a, b) => a - b);
+    const summary = [];
+    let previous = -1;
+    for (const index of ordered) {
+        if (previous >= 0 && index - previous > 1) {
+            summary.push(`[${index - previous - 1} lines omitted]`);
+        }
+        summary.push(lines[index] ?? "");
+        previous = index;
+    }
+    return summary;
+}
+function detectCommitFailureSignal(output) {
+    if (FORMATTER_SIGNAL_PATTERNS.some((pattern) => pattern.test(output))) {
+        return "formatter";
+    }
+    if (ESLINT_SIGNAL_PATTERNS.some((pattern) => pattern.test(output))) {
+        return "eslint";
+    }
+    return null;
+}
+function commitFailureDiagnostic(phase, output) {
+    const signal = detectCommitFailureSignal(output);
+    if (signal === "formatter") {
+        return {
+            state: phase === "close_commit"
+                ? "git rejected the generated close commit"
+                : "git rejected the requested task-scoped commit",
+            likelyCause: phase === "close_commit"
+                ? "a formatting check in the pre-commit path rejected the deterministic close commit after the task README was staged"
+                : "a formatting check in the pre-commit path rejected the staged task-scoped commit",
+            nextAction: {
+                command: "bun run format",
+                reason: "apply formatter fixes before retrying the commit flow",
+                reasonCode: "git_pre_commit_format",
+            },
+        };
+    }
+    if (signal === "eslint") {
+        return {
+            state: phase === "close_commit"
+                ? "git rejected the generated close commit"
+                : "git rejected the requested task-scoped commit",
+            likelyCause: phase === "close_commit"
+                ? "a lint check in the pre-commit path rejected the deterministic close commit after the task README was staged"
+                : "a lint check in the pre-commit path rejected the staged task-scoped commit",
+            nextAction: {
+                command: "bun run lint:core",
+                reason: "rerun lint and fix the reported error before retrying the commit flow",
+                reasonCode: "git_pre_commit_lint",
+            },
+        };
+    }
+    if (phase === "close_commit") {
+        return {
+            state: "git rejected the generated close commit",
+            likelyCause: "a hook or commit policy blocked the deterministic task close commit after the task README was staged",
+            nextAction: {
+                command: "git status --short --untracked-files=no",
+                reason: "inspect the staged close-commit payload before fixing the hook or policy failure",
+                reasonCode: "git_close_commit_blocked",
+            },
+        };
+    }
+    return {
+        state: "git rejected the requested task-scoped commit",
+        likelyCause: "a hook or commit policy blocked the staged changes after guard validation passed",
+        nextAction: {
+            command: "git status --short --untracked-files=no",
+            reason: "inspect the staged task-scoped payload before fixing the hook or policy failure",
+            reasonCode: "git_task_commit_blocked",
+        },
+    };
 }
-function asCommitFailure(err) {
+function hasExplicitCommitScope(opts) {
+    return opts.allow.some((prefix) => prefix.trim().length > 0) || opts.allowTasks;
+}
+function asCommitFailure(err, phase) {
     if (err instanceof Error) {
         const e = err;
         const cmd = typeof e.cmd === "string" ? e.cmd : "";
@@ -51,15 +153,7 @@ function asCommitFailure(err) {
                 exitCode: 5,
                 code: "E_GIT",
                 message: lines.join("\n"),
-                context: withDiagnosticContext({ command: "commit" }, {
-                    state: "git rejected the generated close commit",
-                    likelyCause: "a hook or commit policy blocked the deterministic task close commit after the task README was staged",
-                    nextAction: {
-                        command: "git status --short --untracked-files=no",
-                        reason: "inspect the staged close-commit payload before fixing the hook or policy failure",
-                        reasonCode: "git_close_commit_blocked",
-                    },
-                }),
+                context: withDiagnosticContext({ command: "commit" }, commitFailureDiagnostic(phase, output)),
             });
         }
         return null;
@@ -235,6 +329,31 @@ export async function cmdCommit(opts) {
             });
         }
         await ensureReconciledBeforeMutation({ ctx, command: "commit" });
+        let autoStaged = [];
+        const staged = await ctx.git.statusStagedPaths();
+        if (staged.length === 0) {
+            if (!hasExplicitCommitScope(opts)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: "No staged files and no commit allowlist. Pass --allow <path-prefix>, use --allow-tasks for active task artifacts, or stage files manually.",
+                });
+            }
+            autoStaged = await stageAllowlist({
+                ctx,
+                allow: opts.allow,
+                allowTasks: opts.allowTasks,
+                tasksPath: ctx.config.paths.tasks_path,
+                workflowDir: ctx.config.paths.workflow_dir,
+                taskId: opts.taskId,
+                allowTaskOnly: true,
+                emptyAllowMessage: "No staged files and no commit allowlist. Pass --allow <path-prefix>, use --allow-tasks for active task artifacts, or stage files manually.",
+                noMatchMessage: "No changed files matched the commit allowlist (adjust --allow / --allow-tasks or stage files manually).",
+            });
+            if (!opts.quiet) {
+                process.stdout.write(`${infoMessage(`commit auto-staged ${autoStaged.length} path(s) from allowlist`)}\n`);
+            }
+        }
         await guardCommitCheck({
             ctx,
             cwd: opts.cwd,
@@ -263,14 +382,14 @@ export async function cmdCommit(opts) {
         await ctx.git.commit({ message: opts.message, env });
         if (!opts.quiet) {
             const { hash, subject } = await ctx.git.headHashSubject();
-            process.stdout.write(`${successMessage("committed", `${hash?.slice(0, 12) ?? ""} ${subject ?? ""}`.trim())}\n`);
+            process.stdout.write(`${successMessage("committed", `${hash?.slice(0, 12) ?? ""} ${subject ?? ""}`.trim(), autoStaged.length > 0 ? `staged=${autoStaged.join(", ")}` : undefined)}\n`);
         }
         return 0;
     }
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        const commitFailure = asCommitFailure(err);
+        const commitFailure = asCommitFailure(err, opts.close ? "close_commit" : "task_commit");
         if (commitFailure)
             throw commitFailure;
         throw mapCoreError(err, { command: "commit", root: opts.rootOverride ?? null });

package/dist/commands/guard/impl/comment-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyF/D"}
+{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2F/D"}

package/dist/commands/guard/impl/comment-commit.js

@@ -68,6 +68,8 @@ export async function commitFromComment(opts) {
         allow: allowPrefixes,
         allowTasks: opts.allowTasks,
         tasksPath: opts.config.paths.tasks_path,
+        workflowDir: opts.config.paths.workflow_dir,
+        taskId: opts.taskId,
     });
     const message = deriveCommitMessageFromComment({
         taskId: opts.taskId,

package/dist/commands/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AA8G5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8HlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AA8G5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlB"}

package/dist/commands/hooks/index.js

@@ -5,13 +5,11 @@ import { evaluatePolicy } from "../../policy/evaluate.js";
 import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
 import { fileExists } from "../../cli/fs-utils.js";
 import { infoMessage, successMessage } from "../../cli/output.js";
-import { resolveCommitEmojiForAgent } from "../../shared/agent-emoji.js";
 import { CliError } from "../../shared/errors.js";
 import { GitContext } from "../shared/git-context.js";
 import { throwIfPolicyDenied } from "../shared/policy-deny.js";
 import { gitCurrentBranch, gitRevParse } from "../shared/git-ops.js";
 import { isPathWithin } from "../shared/path.js";
-import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
 const HOOK_MARKER = "agentplane-hook";
 const SHIM_MARKER = "agentplane-hook-shim";
 export const HOOK_NAMES = ["commit-msg", "pre-commit", "pre-push"];
@@ -201,40 +199,15 @@ export async function cmdHooksRun(opts) {
             const loaded = await loadConfig(resolved.agentplaneDir);
             const taskId = (process.env.AGENTPLANE_TASK_ID ?? "").trim();
             const statusTo = (process.env.AGENTPLANE_STATUS_TO ?? "").trim().toUpperCase();
-            const agentsDirAbs = path.join(resolved.gitRoot, loaded.config.paths.agents_dir);
-            let agentId = (process.env.AGENTPLANE_AGENT_ID ?? "").trim();
-            if (!agentId && loaded.config.workflow_mode === "direct" && taskId) {
-                const lock = await readDirectWorkLock(resolved.agentplaneDir);
-                const lockAgent = lock?.agent?.trim() ?? "";
-                if (lock?.task_id === taskId && lockAgent)
-                    agentId = lockAgent;
-            }
             const emoji = subject.split(/\s+/).find(Boolean) ?? "";
-            if (taskId) {
-                if (statusTo === "DONE") {
-                    if (emoji !== "✅") {
-                        throw new CliError({
-                            exitCode: 5,
-                            code: "E_GIT",
-                            message: "Finish commits must use a checkmark emoji.\n" +
-                                "Expected:\n" +
-                                "  ✅ <TASK_SUFFIX> <scope>: <summary>",
-                        });
-                    }
-                }
-                else if (agentId) {
-                    const expectedEmoji = await resolveCommitEmojiForAgent({ agentsDirAbs, agentId });
-                    if (emoji !== expectedEmoji) {
-                        throw new CliError({
-                            exitCode: 5,
-                            code: "E_GIT",
-                            message: "Commit emoji does not match the executor agent policy.\n" +
-                                `executor_agent=${agentId}\n` +
-                                "Expected:\n" +
-                                `  ${expectedEmoji} <TASK_SUFFIX> <scope>: <summary>`,
-                        });
-                    }
-                }
+            if (taskId && statusTo === "DONE" && emoji !== "✅") {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: "Finish commits must use a checkmark emoji.\n" +
+                        "Expected:\n" +
+                        "  ✅ <TASK_SUFFIX> <scope>: <summary>",
+                });
             }
             const res = evaluatePolicy({
                 action: "hook_commit_msg",

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

@@ -3,6 +3,10 @@ export declare function moveRecipeDir(opts: {
     from: string;
     to: string;
 }): Promise<void>;
+export declare function validateRecipeAssets(opts: {
+    manifest: RecipeManifest;
+    recipeDir: string;
+}): Promise<void>;
 export declare function applyRecipeAgents(opts: {
     manifest: RecipeManifest;
     recipeDir: string;

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

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/apply.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/apply.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF;AAkBD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}

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

@@ -24,6 +24,40 @@ export async function moveRecipeDir(opts) {
         throw err;
     }
 }
+async function readRecipeJsonObject(recipeDir, relativePath, label) {
+    const sourcePath = path.join(recipeDir, relativePath);
+    if (!(await fileExists(sourcePath))) {
+        throw new Error(missingFileMessage(label, relativePath));
+    }
+    const raw = JSON.parse(await readFile(sourcePath, "utf8"));
+    if (!isRecord(raw)) {
+        throw new Error(invalidFieldMessage(label, "JSON object", relativePath));
+    }
+}
+export async function validateRecipeAssets(opts) {
+    for (const skill of opts.manifest.skills ?? []) {
+        await readRecipeJsonObject(opts.recipeDir, skill.file, "recipe skill file");
+    }
+    for (const agent of opts.manifest.agents ?? []) {
+        await readRecipeJsonObject(opts.recipeDir, agent.file, "recipe agent file");
+    }
+    for (const tool of opts.manifest.tools ?? []) {
+        const entrypointPath = path.join(opts.recipeDir, tool.entrypoint);
+        if (!(await fileExists(entrypointPath))) {
+            throw new Error(missingFileMessage("recipe tool entrypoint", tool.entrypoint));
+        }
+    }
+    for (const scenario of opts.manifest.scenarios ?? []) {
+        const sourcePath = path.join(opts.recipeDir, scenario.file);
+        if (!(await fileExists(sourcePath))) {
+            throw new Error(missingFileMessage("recipe scenario file", scenario.file));
+        }
+        const definition = await readScenarioDefinition(sourcePath);
+        if (definition.id !== scenario.id) {
+            throw new Error(invalidFieldMessage("recipe scenario file", `scenario.id=${scenario.id}`, scenario.file));
+        }
+    }
+}
 export async function applyRecipeAgents(opts) {
     const agents = opts.manifest.agents ?? [];
     if (agents.length === 0)

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

@@ -1 +1 @@
-{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/explain.ts"],"names":[],"mappings":"AASA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFlB"}
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/explain.ts"],"names":[],"mappings":"AAWA,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAqIlB"}

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

@@ -1,13 +1,18 @@
+import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
 import { collectRecipeScenarioDetails } from "../scenario.js";
 import { formatJsonBlock } from "../format.js";
-import { readInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipeDir, resolveInstalledRecipesPath } from "../paths.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
+import { resolveProjectInstalledRecipeDir } from "../paths.js";
 export async function cmdRecipeExplainParsed(opts) {
     try {
-        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -17,7 +22,7 @@ export async function cmdRecipeExplainParsed(opts) {
             });
         }
         const manifest = entry.manifest;
-        const recipeDir = resolveInstalledRecipeDir(entry);
+        const recipeDir = resolveProjectInstalledRecipeDir(resolved, entry.id);
         const scenarioDetails = await collectRecipeScenarioDetails(recipeDir, manifest);
         process.stdout.write(`Recipe: ${manifest.id}@${manifest.version}\n`);
         process.stdout.write(`Name: ${manifest.name}\n`);
@@ -26,35 +31,59 @@ export async function cmdRecipeExplainParsed(opts) {
         if (manifest.tags && manifest.tags.length > 0) {
             process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
         }
+        if (manifest.compatibility) {
+            const payload = formatJsonBlock(manifest.compatibility, "  ");
+            if (payload)
+                process.stdout.write(`Compatibility:\n${payload}\n`);
+        }
+        const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
         const tools = manifest.tools ?? [];
+        if (skills.length > 0) {
+            process.stdout.write("Skills:\n");
+            for (const skill of skills) {
+                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+            }
+        }
         if (agents.length > 0) {
             process.stdout.write("Agents:\n");
             for (const agent of agents) {
-                const label = agent?.id ?? "unknown";
-                const summary = agent?.summary ? ` - ${agent.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${agent.display_name} (${agent.id}) - ${agent.summary} [role=${agent.role}]\n`);
             }
         }
         if (tools.length > 0) {
             process.stdout.write("Tools:\n");
             for (const tool of tools) {
-                const label = tool?.id ?? "unknown";
-                const summary = tool?.summary ? ` - ${tool.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
         if (scenarioDetails.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarioDetails) {
+                const title = scenario.name ? `${scenario.name} (${scenario.id})` : scenario.id;
                 const summary = scenario.summary ? ` - ${scenario.summary}` : "";
-                process.stdout.write(`  - ${scenario.id}${summary}\n`);
+                process.stdout.write(`  - ${title}${summary}\n`);
                 if (scenario.description) {
                     process.stdout.write(`    Description: ${scenario.description}\n`);
                 }
                 if (scenario.goal) {
                     process.stdout.write(`    Goal: ${scenario.goal}\n`);
                 }
+                if (scenario.use_when && scenario.use_when.length > 0) {
+                    const payload = formatJsonBlock(scenario.use_when, "      ");
+                    if (payload)
+                        process.stdout.write(`    Use when:\n${payload}\n`);
+                }
+                if (scenario.avoid_when && scenario.avoid_when.length > 0) {
+                    const payload = formatJsonBlock(scenario.avoid_when, "      ");
+                    if (payload)
+                        process.stdout.write(`    Avoid when:\n${payload}\n`);
+                }
+                if (scenario.required_inputs && scenario.required_inputs.length > 0) {
+                    const payload = formatJsonBlock(scenario.required_inputs, "      ");
+                    if (payload)
+                        process.stdout.write(`    Required inputs:\n${payload}\n`);
+                }
                 if (scenario.inputs !== undefined) {
                     const payload = formatJsonBlock(scenario.inputs, "      ");
                     if (payload)
@@ -65,6 +94,36 @@ export async function cmdRecipeExplainParsed(opts) {
                     if (payload)
                         process.stdout.write(`    Outputs:\n${payload}\n`);
                 }
+                if (scenario.permissions && scenario.permissions.length > 0) {
+                    const payload = formatJsonBlock(scenario.permissions, "      ");
+                    if (payload)
+                        process.stdout.write(`    Permissions:\n${payload}\n`);
+                }
+                if (scenario.artifacts && scenario.artifacts.length > 0) {
+                    const payload = formatJsonBlock(scenario.artifacts, "      ");
+                    if (payload)
+                        process.stdout.write(`    Artifacts:\n${payload}\n`);
+                }
+                if (scenario.agents_involved && scenario.agents_involved.length > 0) {
+                    const payload = formatJsonBlock(scenario.agents_involved, "      ");
+                    if (payload)
+                        process.stdout.write(`    Agents involved:\n${payload}\n`);
+                }
+                if (scenario.skills_used && scenario.skills_used.length > 0) {
+                    const payload = formatJsonBlock(scenario.skills_used, "      ");
+                    if (payload)
+                        process.stdout.write(`    Skills used:\n${payload}\n`);
+                }
+                if (scenario.tools_used && scenario.tools_used.length > 0) {
+                    const payload = formatJsonBlock(scenario.tools_used, "      ");
+                    if (payload)
+                        process.stdout.write(`    Tools used:\n${payload}\n`);
+                }
+                if (scenario.run_profile) {
+                    const payload = formatJsonBlock(scenario.run_profile, "      ");
+                    if (payload)
+                        process.stdout.write(`    Run profile:\n${payload}\n`);
+                }
                 if (scenario.steps && scenario.steps.length > 0) {
                     process.stdout.write("    Steps:\n");
                     let stepIndex = 1;

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

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/info.ts"],"names":[],"mappings":"AAOA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDlB"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/info.ts"],"names":[],"mappings":"AASA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,MAAM,CAAC,CAkElB"}

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

@@ -1,11 +1,16 @@
+import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../../cli/error-map.js";
 import { exitCodeForError } from "../../../../cli/exit-codes.js";
 import { CliError } from "../../../../shared/errors.js";
-import { readInstalledRecipesFile } from "../installed-recipes.js";
-import { resolveInstalledRecipesPath } from "../paths.js";
+import { formatJsonBlock } from "../format.js";
+import { readProjectInstalledRecipes } from "../project-installed-recipes.js";
 export async function cmdRecipeInfoParsed(opts) {
     try {
-        const installed = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const installed = await readProjectInstalledRecipes(resolved);
         const entry = installed.recipes.find((recipe) => recipe.id === opts.id);
         if (!entry) {
             throw new CliError({
@@ -22,31 +27,38 @@ export async function cmdRecipeInfoParsed(opts) {
         if (manifest.tags && manifest.tags.length > 0) {
             process.stdout.write(`Tags: ${manifest.tags.join(", ")}\n`);
         }
+        if (manifest.compatibility) {
+            const payload = formatJsonBlock(manifest.compatibility, "  ");
+            if (payload)
+                process.stdout.write(`Compatibility:\n${payload}\n`);
+        }
+        const skills = manifest.skills ?? [];
         const agents = manifest.agents ?? [];
         const tools = manifest.tools ?? [];
         const scenarios = manifest.scenarios ?? [];
+        if (skills.length > 0) {
+            process.stdout.write("Skills:\n");
+            for (const skill of skills) {
+                process.stdout.write(`  - ${skill.id} - ${skill.summary}\n`);
+            }
+        }
         if (agents.length > 0) {
             process.stdout.write("Agents:\n");
             for (const agent of agents) {
-                const label = agent?.id ?? "unknown";
-                const summary = agent?.summary ? ` - ${agent.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                const label = `${agent.display_name} (${agent.id})`;
+                process.stdout.write(`  - ${label} - ${agent.summary}\n`);
             }
         }
         if (tools.length > 0) {
             process.stdout.write("Tools:\n");
             for (const tool of tools) {
-                const label = tool?.id ?? "unknown";
-                const summary = tool?.summary ? ` - ${tool.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${tool.id} - ${tool.summary}\n`);
             }
         }
         if (scenarios.length > 0) {
             process.stdout.write("Scenarios:\n");
             for (const scenario of scenarios) {
-                const label = scenario?.id ?? "unknown";
-                const summary = scenario?.summary ? ` - ${scenario.summary}` : "";
-                process.stdout.write(`  - ${label}${summary}\n`);
+                process.stdout.write(`  - ${scenario.name} (${scenario.id}) - ${scenario.summary} [mode=${scenario.run_profile.mode}]\n`);
             }
         }
         return 0;

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/install.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAM3E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA6NlB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/install.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAM3E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA4NlB"}