agentplane 0.1.8 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"pr.command.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/pr.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,KAAK,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,aAAa,CAgB7C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAErF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAgChD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAOpD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAOlD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA0ChD,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAC/C,cAAc,CAAC,aAAa,CAAC,CAe/B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAUjE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACvE,KAAK,UAAU,EAAE,GAAG,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACtE,KAAK,UAAU,EAAE,GAAG,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAUjE"}

package/dist/commands/pr/pr.command.js

@@ -0,0 +1,172 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+import { cmdPrCheck, cmdPrNote, cmdPrOpen, cmdPrUpdate } from "./index.js";
+export const prSpec = {
+    id: ["pr"],
+    group: "PR",
+    summary: "Manage local PR artifacts for a task (branch_pr workflow).",
+    synopsis: ["agentplane pr <open|update|check|note> <task-id> [options]"],
+    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
+    examples: [
+        { cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER", why: "Create PR artifacts." },
+        { cmd: "agentplane pr update 202602030608-F1Q8AB", why: "Refresh diffstat and summary." },
+        { cmd: "agentplane pr check 202602030608-F1Q8AB", why: "Validate PR artifacts." },
+        {
+            cmd: 'agentplane pr note 202602030608-F1Q8AB --author REVIEWER --body "Looks good"',
+            why: "Append a handoff note.",
+        },
+    ],
+    parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
+};
+export const prOpenSpec = {
+    id: ["pr", "open"],
+    group: "PR",
+    summary: "Create PR artifacts for a task.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Author id (e.g. CODER).",
+        },
+        {
+            kind: "string",
+            name: "branch",
+            valueHint: "<name>",
+            description: "Branch name (default: current branch).",
+        },
+    ],
+    examples: [{ cmd: "agentplane pr open 202602030608-F1Q8AB --author CODER", why: "Open." }],
+    validateRaw: (raw) => {
+        const author = typeof raw.opts.author === "string" ? raw.opts.author.trim() : "";
+        if (!author) {
+            throw usageError({ spec: prOpenSpec, message: "Invalid value for --author: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        author: String(raw.opts.author),
+        branch: typeof raw.opts.branch === "string" ? raw.opts.branch : null,
+    }),
+};
+export const prUpdateSpec = {
+    id: ["pr", "update"],
+    group: "PR",
+    summary: "Update PR artifacts (diffstat and auto summary).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    examples: [{ cmd: "agentplane pr update 202602030608-F1Q8AB", why: "Update artifacts." }],
+    parse: (raw) => ({ taskId: String(raw.args["task-id"]) }),
+};
+export const prCheckSpec = {
+    id: ["pr", "check"],
+    group: "PR",
+    summary: "Check that PR artifacts are present and valid.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    examples: [{ cmd: "agentplane pr check 202602030608-F1Q8AB", why: "Check artifacts." }],
+    parse: (raw) => ({ taskId: String(raw.args["task-id"]) }),
+};
+export const prNoteSpec = {
+    id: ["pr", "note"],
+    group: "PR",
+    summary: "Append a handoff note into PR review.md.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Author id (e.g. REVIEWER).",
+        },
+        {
+            kind: "string",
+            name: "body",
+            valueHint: "<text>",
+            required: true,
+            description: "Note body text.",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane pr note 202602030608-F1Q8AB --author REVIEWER --body "LGTM"',
+            why: "Add note.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const author = typeof raw.opts.author === "string" ? raw.opts.author.trim() : "";
+        const body = typeof raw.opts.body === "string" ? raw.opts.body.trim() : "";
+        if (!author) {
+            throw usageError({ spec: prNoteSpec, message: "Invalid value for --author: empty." });
+        }
+        if (!body) {
+            throw usageError({ spec: prNoteSpec, message: "Invalid value for --body: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        author: String(raw.opts.author),
+        body: String(raw.opts.body),
+    }),
+};
+export function makeRunPrHandler(getCtx) {
+    return async (_ctx, p) => {
+        await getCtx("pr");
+        const input = p.cmd.join(" ");
+        const candidates = ["open", "update", "check", "note"];
+        const suggestion = suggestOne(input, candidates);
+        const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+        const msg = p.cmd.length === 0 ? "Missing subcommand." : `Unknown subcommand: ${p.cmd[0]}.`;
+        throw usageError({
+            spec: prSpec,
+            command: "pr",
+            message: `${msg}${suffix}`,
+            context: { command: "pr" },
+        });
+    };
+}
+export function makeRunPrOpenHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrOpen({
+            ctx: await getCtx("pr open"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            author: p.author,
+            branch: p.branch ?? undefined,
+        });
+    };
+}
+export function makeRunPrUpdateHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrUpdate({
+            ctx: await getCtx("pr update"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+        });
+    };
+}
+export function makeRunPrCheckHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrCheck({
+            ctx: await getCtx("pr check"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+        });
+    };
+}
+export function makeRunPrNoteHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdPrNote({
+            ctx: await getCtx("pr note"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            author: p.author,
+            body: p.body,
+        });
+    };
+}

package/dist/commands/pr/update.d.ts

@@ -0,0 +1,8 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdPrUpdate(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+}): Promise<number>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/pr/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/pr/update.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AASnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+FlB"}

package/dist/commands/pr/update.js

@@ -0,0 +1,103 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveBaseBranch } from "@agentplaneorg/core";
+import { mapBackendError } from "../../cli/error-map.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { successMessage, workflowModeMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { writeJsonStableIfChanged, writeTextIfChanged } from "../../shared/write-if-changed.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { gitCurrentBranch } from "../shared/git-ops.js";
+import { parsePrMeta } from "../shared/pr-meta.js";
+import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
+import { resolvePrPaths } from "./internal/pr-paths.js";
+import { updateAutoSummaryBlock } from "./internal/review-template.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+export async function cmdPrUpdate(opts) {
+    try {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        await loadBackendTask({
+            ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        const { resolved, config, prDir, metaPath, diffstatPath, reviewPath } = await resolvePrPaths({
+            ...opts,
+            ctx,
+        });
+        if (config.workflow_mode !== "branch_pr") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: workflowModeMessage(config.workflow_mode, "branch_pr"),
+            });
+        }
+        if (!(await fileExists(metaPath)) || !(await fileExists(reviewPath))) {
+            const missing = [];
+            if (!(await fileExists(metaPath)))
+                missing.push(path.relative(resolved.gitRoot, metaPath));
+            if (!(await fileExists(reviewPath)))
+                missing.push(path.relative(resolved.gitRoot, reviewPath));
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: `PR artifacts missing: ${missing.join(", ")} (run \`agentplane pr open\`)`,
+            });
+        }
+        const baseBranch = await resolveBaseBranch({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            cliBaseOpt: null,
+            mode: config.workflow_mode,
+        });
+        if (!baseBranch) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Base branch could not be resolved (use `agentplane branch base set`).",
+            });
+        }
+        const branch = await gitCurrentBranch(resolved.gitRoot);
+        const { stdout: diffStatOut } = await execFileAsync("git", ["diff", "--stat", `${baseBranch}...HEAD`], { cwd: resolved.gitRoot, env: gitEnv() });
+        const diffstat = diffStatOut.trimEnd();
+        await writeTextIfChanged(diffstatPath, diffstat ? `${diffstat}\n` : "");
+        const { stdout: headOut } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+            cwd: resolved.gitRoot,
+            env: gitEnv(),
+        });
+        const headSha = headOut.trim();
+        const summaryLines = [
+            `- Updated: ${nowIso()}`,
+            `- Branch: ${branch}`,
+            `- Head: ${headSha.slice(0, 12)}`,
+            "- Diffstat:",
+            "```",
+            diffstat || "No changes detected.",
+            "```",
+        ];
+        const reviewText = await readFile(reviewPath, "utf8");
+        const nextReview = updateAutoSummaryBlock(reviewText, summaryLines.join("\n"));
+        await writeTextIfChanged(reviewPath, nextReview);
+        const rawMeta = await readFile(metaPath, "utf8");
+        const meta = parsePrMeta(rawMeta, opts.taskId);
+        const nextMeta = {
+            ...meta,
+            branch,
+            updated_at: nowIso(),
+            last_verified_sha: meta.last_verified_sha ?? null,
+            last_verified_at: meta.last_verified_at ?? null,
+        };
+        await writeJsonStableIfChanged(metaPath, nextMeta);
+        process.stdout.write(`${successMessage("pr update", path.relative(resolved.gitRoot, prDir))}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "pr update", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/ready.command.d.ts

@@ -0,0 +1,8 @@
+import type { CommandCtx, CommandSpec } from "../cli/spec/spec.js";
+import type { CommandContext } from "./shared/task-backend.js";
+export type ReadyParsed = {
+    taskId: string;
+};
+export declare const readySpec: CommandSpec<ReadyParsed>;
+export declare function makeRunReadyHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: ReadyParsed) => Promise<number>;
+//# sourceMappingURL=ready.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ready.command.d.ts","sourceRoot":"","sources":["../../src/commands/ready.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,WAAW,CAgB9C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACpE,KAAK,UAAU,EAAE,GAAG,WAAW,KAAG,OAAO,CAAC,MAAM,CAAC,CAQhE"}

package/dist/commands/ready.command.js

@@ -0,0 +1,28 @@
+import { cmdReady } from "./task/ready.js";
+export const readySpec = {
+    id: ["ready"],
+    group: "Task",
+    summary: "Report dependency readiness details for a task.",
+    args: [
+        {
+            name: "task-id",
+            required: true,
+            valueHint: "<task-id>",
+            description: "Existing task id.",
+        },
+    ],
+    examples: [{ cmd: "agentplane ready 202602030608-F1Q8AB", why: "Print readiness details." }],
+    parse: (raw) => ({
+        taskId: typeof raw.args["task-id"] === "string" ? raw.args["task-id"] : "",
+    }),
+};
+export function makeRunReadyHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdReady({
+            ctx: await getCtx("ready"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+        });
+    };
+}

package/dist/commands/recipes/cache-prune.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import { type RecipeCachePruneFlags } from "../recipes.js";
+export type RecipesCachePruneParsed = RecipeCachePruneFlags;
+export declare const recipesCachePruneSpec: CommandSpec<RecipesCachePruneParsed>;
+export declare const runRecipesCachePrune: CommandHandler<RecipesCachePruneParsed>;
+//# sourceMappingURL=cache-prune.command.d.ts.map

package/dist/commands/recipes/cache-prune.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-prune.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/cache-prune.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtF,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,uBAAuB,CA2BtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,uBAAuB,CACW,CAAC"}

package/dist/commands/recipes/cache-prune.command.js

@@ -0,0 +1,30 @@
+import { cmdRecipeCachePruneParsed } from "../recipes.js";
+export const recipesCachePruneSpec = {
+    id: ["recipes", "cache", "prune"],
+    group: "Recipes",
+    summary: "Prune global recipe cache entries.",
+    options: [
+        {
+            kind: "boolean",
+            name: "dry-run",
+            default: false,
+            description: "Report removals without modifying files.",
+        },
+        {
+            kind: "boolean",
+            name: "all",
+            default: false,
+            description: "Remove all cached recipes (also clears installed recipes file).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane recipes cache prune --dry-run", why: "Preview removals." },
+        { cmd: "agentplane recipes cache prune", why: "Prune unused cached recipes." },
+        { cmd: "agentplane recipes cache prune --all", why: "Remove everything." },
+    ],
+    parse: (raw) => ({
+        dryRun: raw.opts["dry-run"] === true,
+        all: raw.opts.all === true,
+    }),
+};
+export const runRecipesCachePrune = (ctx, flags) => cmdRecipeCachePruneParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/cache.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAIhD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAyB5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAS9D,CAAC"}

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

@@ -0,0 +1,37 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+const RECIPES_CACHE_SUBCOMMANDS = ["prune"];
+export const recipesCacheSpec = {
+    id: ["recipes", "cache"],
+    group: "Recipes",
+    summary: "Manage recipes cache.",
+    synopsis: ["agentplane recipes cache <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: recipesCacheSpec,
+                command: "recipes cache",
+                message: "Missing recipes cache subcommand.",
+            });
+        }
+        const suggestion = suggestOne(String(sub), [...RECIPES_CACHE_SUBCOMMANDS]);
+        const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+        throw usageError({
+            spec: recipesCacheSpec,
+            command: "recipes cache",
+            message: `Unknown recipes cache subcommand: ${String(sub)}.${suffix}`,
+        });
+    },
+};
+export const runRecipesCache = (_ctx) => {
+    // Should be unreachable because validateRaw always throws.
+    throw usageError({
+        spec: recipesCacheSpec,
+        command: "recipes cache",
+        message: "Missing recipes cache subcommand.",
+    });
+};

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

@@ -0,0 +1,7 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type RecipesExplainParsed = {
+    id: string;
+};
+export declare const recipesExplainSpec: CommandSpec<RecipesExplainParsed>;
+export declare const runRecipesExplain: CommandHandler<RecipesExplainParsed>;
+//# sourceMappingURL=explain.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.command.d.ts","sourceRoot":"","sources":["../../../src/commands/recipes/explain.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAOhE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,oBAAoB,CACiB,CAAC"}

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

@@ -0,0 +1,10 @@
+import { cmdRecipeExplainParsed } from "../recipes.js";
+export const recipesExplainSpec = {
+    id: ["recipes", "explain"],
+    group: "Recipes",
+    summary: "Show detailed info for an installed recipe.",
+    args: [{ name: "id", required: true, valueHint: "<id>" }],
+    examples: [{ cmd: "agentplane recipes explain viewer", why: "Show detailed recipe info." }],
+    parse: (raw) => ({ id: String(raw.args.id ?? "") }),
+};
+export const runRecipesExplain = (ctx, p) => cmdRecipeExplainParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, id: p.id });

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

@@ -0,0 +1,16 @@
+import type { RecipeConflictMode, RecipeManifest } from "./types.js";
+export declare function moveRecipeDir(opts: {
+    from: string;
+    to: string;
+}): Promise<void>;
+export declare function applyRecipeAgents(opts: {
+    manifest: RecipeManifest;
+    recipeDir: string;
+    agentplaneDir: string;
+    onConflict: RecipeConflictMode;
+}): Promise<void>;
+export declare function applyRecipeScenarios(opts: {
+    manifest: RecipeManifest;
+    recipeDir: string;
+}): Promise<void>;
+//# sourceMappingURL=apply.d.ts.map

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

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

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

@@ -0,0 +1,97 @@
+import { cp, mkdir, readFile, readdir, rename, rm } from "node:fs/promises";
+import path from "node:path";
+import { fileExists, getPathKind } from "../../../cli/fs-utils.js";
+import { invalidFieldMessage, missingFileMessage } from "../../../cli/output.js";
+import { CliError } from "../../../shared/errors.js";
+import { isRecord } from "../../../shared/guards.js";
+import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
+import { RECIPES_SCENARIOS_DIR_NAME, RECIPES_SCENARIOS_INDEX_NAME } from "./constants.js";
+import { normalizeAgentId } from "./normalize.js";
+import { readScenarioDefinition } from "./scenario.js";
+export async function moveRecipeDir(opts) {
+    await mkdir(path.dirname(opts.to), { recursive: true });
+    try {
+        await rename(opts.from, opts.to);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "EXDEV") {
+            await cp(opts.from, opts.to, { recursive: true });
+            await rm(opts.from, { recursive: true, force: true });
+            return;
+        }
+        throw err;
+    }
+}
+export async function applyRecipeAgents(opts) {
+    const agents = opts.manifest.agents ?? [];
+    if (agents.length === 0)
+        return;
+    const agentsDir = path.join(opts.agentplaneDir, "agents");
+    await mkdir(agentsDir, { recursive: true });
+    for (const agent of agents) {
+        const rawId = typeof agent?.id === "string" ? agent.id : "";
+        const rawFile = typeof agent?.file === "string" ? agent.file : "";
+        if (!rawId.trim() || !rawFile.trim()) {
+            throw new Error("manifest.agents entries must include id and file");
+        }
+        const agentId = normalizeAgentId(rawId);
+        const sourcePath = path.join(opts.recipeDir, rawFile);
+        if (!(await fileExists(sourcePath))) {
+            throw new Error(missingFileMessage("recipe agent file", rawFile));
+        }
+        const rawAgent = JSON.parse(await readFile(sourcePath, "utf8"));
+        if (!isRecord(rawAgent)) {
+            throw new Error(invalidFieldMessage("recipe agent file", "JSON object", rawFile));
+        }
+        const baseId = `${opts.manifest.id}__${agentId}`;
+        let targetId = baseId;
+        let targetPath = path.join(agentsDir, `${targetId}.json`);
+        if (await getPathKind(targetPath)) {
+            if (opts.onConflict === "fail") {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_IO",
+                    message: `Agent already exists: ${targetId}`,
+                });
+            }
+            if (opts.onConflict === "rename") {
+                let counter = 1;
+                while (await getPathKind(targetPath)) {
+                    targetId = `${baseId}__${counter}`;
+                    targetPath = path.join(agentsDir, `${targetId}.json`);
+                    counter += 1;
+                }
+            }
+        }
+        rawAgent.id = targetId;
+        await writeJsonStableIfChanged(targetPath, rawAgent);
+    }
+}
+export async function applyRecipeScenarios(opts) {
+    const scenariosDir = path.join(opts.recipeDir, RECIPES_SCENARIOS_DIR_NAME);
+    const scenariosIndexPath = path.join(opts.recipeDir, RECIPES_SCENARIOS_INDEX_NAME);
+    const payload = { schema_version: 1, scenarios: [] };
+    if ((await getPathKind(scenariosDir)) === "dir") {
+        const entries = await readdir(scenariosDir);
+        const jsonEntries = entries.filter((entry) => entry.toLowerCase().endsWith(".json")).toSorted();
+        for (const entry of jsonEntries) {
+            const scenarioPath = path.join(scenariosDir, entry);
+            const scenario = await readScenarioDefinition(scenarioPath);
+            payload.scenarios.push({ id: scenario.id, summary: scenario.summary });
+        }
+    }
+    else {
+        const scenarios = opts.manifest.scenarios ?? [];
+        payload.scenarios = scenarios
+            .filter((scenario) => isRecord(scenario))
+            .map((scenario) => ({
+            id: typeof scenario.id === "string" ? scenario.id : "",
+            summary: typeof scenario.summary === "string" ? scenario.summary : "",
+        }))
+            .filter((scenario) => scenario.id);
+    }
+    if (payload.scenarios.length === 0)
+        return;
+    await writeJsonStableIfChanged(scenariosIndexPath, payload);
+}

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

@@ -0,0 +1,2 @@
+export declare function resolveRecipeRoot(extractedDir: string): Promise<string>;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/archive.ts"],"names":[],"mappings":"AAMA,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7E"}

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

@@ -0,0 +1,19 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../../../cli/fs-utils.js";
+import { missingFileMessage } from "../../../cli/output.js";
+export async function resolveRecipeRoot(extractedDir) {
+    const rootManifest = path.join(extractedDir, "manifest.json");
+    if (await fileExists(rootManifest))
+        return extractedDir;
+    const entries = await readdir(extractedDir, { withFileTypes: true });
+    const dirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    if (dirs.length !== 1) {
+        throw new Error(missingFileMessage("manifest.json", "archive root"));
+    }
+    const candidate = path.join(extractedDir, dirs[0]);
+    if (!(await fileExists(path.join(candidate, "manifest.json")))) {
+        throw new Error(missingFileMessage("manifest.json", "archive root"));
+    }
+    return candidate;
+}

package/dist/commands/recipes/impl/commands/cache-prune.d.ts

@@ -0,0 +1,7 @@
+import type { RecipeCachePruneFlags } from "../types.js";
+export declare function cmdRecipeCachePruneParsed(opts: {
+    cwd: string;
+    rootOverride?: string;
+    flags: RecipeCachePruneFlags;
+}): Promise<number>;
+//# sourceMappingURL=cache-prune.d.ts.map

package/dist/commands/recipes/impl/commands/cache-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-prune.d.ts","sourceRoot":"","sources":["../../../../../src/commands/recipes/impl/commands/cache-prune.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA6BzD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFlB"}