agentplane 0.1.9 → 0.2.1

package/dist/commands/branch/remove.js

@@ -0,0 +1,65 @@
+import path from "node:path";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../cli/error-map.js";
+import { successMessage, unknownEntityMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { gitBranchExists } from "../shared/git-ops.js";
+import { isPathWithin, resolvePathFallback } from "../shared/path.js";
+export async function cmdBranchRemove(opts) {
+    const branch = (opts.branch ?? "").trim();
+    const worktree = (opts.worktree ?? "").trim();
+    if (!branch && !worktree) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Missing required option: --branch or --worktree.",
+        });
+    }
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        if (worktree) {
+            const worktreePath = path.isAbsolute(worktree)
+                ? await resolvePathFallback(worktree)
+                : await resolvePathFallback(path.join(resolved.gitRoot, worktree));
+            const worktreesRoot = path.resolve(resolved.gitRoot, loaded.config.paths.worktrees_dir);
+            if (!isPathWithin(worktreesRoot, worktreePath)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Refusing to remove worktree outside ${worktreesRoot}: ${worktreePath}`,
+                });
+            }
+            await execFileAsync("git", ["worktree", "remove", ...(opts.force ? ["--force"] : []), worktreePath], { cwd: resolved.gitRoot, env: gitEnv() });
+            if (!opts.quiet) {
+                process.stdout.write(`${successMessage("removed worktree", worktreePath)}\n`);
+            }
+        }
+        if (branch) {
+            if (!(await gitBranchExists(resolved.gitRoot, branch))) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: unknownEntityMessage("branch", branch),
+                });
+            }
+            await execFileAsync("git", ["branch", opts.force ? "-D" : "-d", branch], {
+                cwd: resolved.gitRoot,
+                env: gitEnv(),
+            });
+            if (!opts.quiet) {
+                process.stdout.write(`${successMessage("removed branch", branch)}\n`);
+            }
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "branch remove", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/branch/status.command.d.ts

@@ -0,0 +1,8 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type BranchStatusParsed = {
+    branch: string | null;
+    base: string | null;
+};
+export declare const branchStatusSpec: CommandSpec<BranchStatusParsed>;
+export declare const runBranchStatus: CommandHandler<BranchStatusParsed>;
+//# sourceMappingURL=status.command.d.ts.map

package/dist/commands/branch/status.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.command.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/status.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1E,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CA0B5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAO9D,CAAC"}

package/dist/commands/branch/status.command.js

@@ -0,0 +1,36 @@
+import { cmdBranchStatus } from "./index.js";
+export const branchStatusSpec = {
+    id: ["branch", "status"],
+    group: "Branch",
+    summary: "Show ahead/behind status for a branch relative to a base branch.",
+    options: [
+        {
+            kind: "string",
+            name: "branch",
+            valueHint: "<name>",
+            description: "Branch name (default: current branch).",
+        },
+        {
+            kind: "string",
+            name: "base",
+            valueHint: "<name>",
+            description: "Base branch name (default: auto-resolved base).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane branch status", why: "Check current branch against effective base." },
+        { cmd: "agentplane branch status --base main", why: "Check against an explicit base." },
+    ],
+    parse: (raw) => ({
+        branch: typeof raw.opts.branch === "string" ? raw.opts.branch : null,
+        base: typeof raw.opts.base === "string" ? raw.opts.base : null,
+    }),
+};
+export const runBranchStatus = async (ctx, p) => {
+    return await cmdBranchStatus({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        branch: p.branch ?? undefined,
+        base: p.base ?? undefined,
+    });
+};

package/dist/commands/branch/status.d.ts

@@ -0,0 +1,7 @@
+export declare function cmdBranchStatus(opts: {
+    cwd: string;
+    rootOverride?: string;
+    branch?: string;
+    base?: string;
+}): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/branch/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/status.ts"],"names":[],"mappings":"AASA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDlB"}

package/dist/commands/branch/status.js

@@ -0,0 +1,60 @@
+import { loadConfig, resolveBaseBranch, resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../cli/error-map.js";
+import { unknownEntityMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { gitAheadBehind } from "../shared/git-diff.js";
+import { gitBranchExists, gitCurrentBranch } from "../shared/git-ops.js";
+import { findWorktreeForBranch, parseTaskIdFromBranch } from "../shared/git-worktree.js";
+export async function cmdBranchStatus(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        const branch = (opts.branch ?? (await gitCurrentBranch(resolved.gitRoot))).trim();
+        const base = await resolveBaseBranch({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            cliBaseOpt: opts.base ?? null,
+            mode: loaded.config.workflow_mode,
+        });
+        if (!branch) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: "Invalid value for --branch." });
+        }
+        if (!base) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Base branch could not be resolved (use `agentplane branch base set` or --base).",
+            });
+        }
+        if (!(await gitBranchExists(resolved.gitRoot, branch))) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("branch", branch),
+            });
+        }
+        if (!(await gitBranchExists(resolved.gitRoot, base))) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("base branch", base),
+            });
+        }
+        const taskId = parseTaskIdFromBranch(loaded.config.branch.task_prefix, branch);
+        const worktree = await findWorktreeForBranch(resolved.gitRoot, branch);
+        const { ahead, behind } = await gitAheadBehind(resolved.gitRoot, base, branch);
+        process.stdout.write(`branch=${branch} base=${base} ahead=${ahead} behind=${behind} task_id=${taskId ?? "-"}\n`);
+        if (worktree) {
+            process.stdout.write(`worktree=${worktree}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "branch status", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/branch/work-start.command.d.ts

@@ -0,0 +1,11 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type WorkStartParsed = {
+    taskId: string;
+    agent: string;
+    slug: string;
+    worktree: boolean;
+};
+export declare const workStartSpec: CommandSpec<WorkStartParsed>;
+export declare function makeRunWorkStartHandler(getCtx: (commandForErrorContext: string) => Promise<CommandContext>): CommandHandler<WorkStartParsed>;
+//# sourceMappingURL=work-start.command.d.ts.map

package/dist/commands/branch/work-start.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.command.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgDtD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,cAAc,CAAC,eAAe,CAAC,CA4BjC"}

package/dist/commands/branch/work-start.command.js

@@ -0,0 +1,80 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdWorkStart } from "./index.js";
+export const workStartSpec = {
+    id: ["work", "start"],
+    group: "Work",
+    summary: "Create or switch to the task branch (optionally via git worktree).",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>", description: "Existing task id." },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "agent",
+            valueHint: "<ID>",
+            required: true,
+            pattern: /^[A-Z0-9_]+$/,
+            patternHint: "A–Z, 0–9, underscore",
+            description: "Agent id (uppercase letters, numbers, underscore).",
+        },
+        {
+            kind: "string",
+            name: "slug",
+            valueHint: "<slug>",
+            required: true,
+            pattern: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+            patternHint: "lowercase kebab-case",
+            description: "Branch slug (lowercase kebab-case).",
+        },
+        {
+            kind: "boolean",
+            name: "worktree",
+            default: false,
+            description: "Use git worktree for the task branch. Required when workflow_mode=branch_pr.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane work start 202602030608-F1Q8AB --agent CODER --slug cli",
+            why: "Start work by checking out / creating the branch in-place (direct mode).",
+        },
+    ],
+    notes: [
+        "When workflow_mode=branch_pr, --worktree is required and the command must be run on the base branch.",
+    ],
+    parse: (raw) => ({
+        taskId: raw.args["task-id"],
+        agent: raw.opts.agent,
+        slug: raw.opts.slug,
+        worktree: Boolean(raw.opts.worktree ?? false),
+    }),
+};
+export function makeRunWorkStartHandler(getCtx) {
+    return async (ctx, p) => {
+        const commandCtx = await getCtx("work start");
+        const mode = commandCtx.config.workflow_mode;
+        if (mode === "branch_pr" && !p.worktree) {
+            throw usageError({
+                spec: workStartSpec,
+                message: "--worktree is required when workflow_mode=branch_pr",
+                command: "work start",
+            });
+        }
+        if (mode !== "branch_pr" && p.worktree) {
+            throw usageError({
+                spec: workStartSpec,
+                message: `--worktree is only supported when workflow_mode=branch_pr (current: ${mode})`,
+                command: "work start",
+            });
+        }
+        return await cmdWorkStart({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            agent: p.agent,
+            slug: p.slug,
+            worktree: p.worktree,
+        });
+    };
+}

package/dist/commands/branch/work-start.d.ts

@@ -0,0 +1,11 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdWorkStart(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    agent: string;
+    slug: string;
+    worktree: boolean;
+}): Promise<number>;
+//# sourceMappingURL=work-start.d.ts.map

package/dist/commands/branch/work-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoHlB"}

package/dist/commands/branch/work-start.js

@@ -0,0 +1,120 @@
+import { mkdir } 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 } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+import { gitBranchExists, gitCurrentBranch } from "../shared/git-ops.js";
+import { isPathWithin } from "../shared/path.js";
+import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
+import { ensurePlanApprovedIfRequired } from "../task/shared.js";
+import { validateWorkAgent, validateWorkSlug } from "./internal/work-validate.js";
+export async function cmdWorkStart(opts) {
+    try {
+        validateWorkAgent(opts.agent);
+        validateWorkSlug(opts.slug);
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const resolved = ctx.resolvedProject;
+        const config = ctx.config;
+        const mode = config.workflow_mode;
+        if (mode !== "branch_pr" && opts.worktree) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `--worktree is only supported in workflow_mode=branch_pr (current: ${mode}).`,
+            });
+        }
+        if (mode === "branch_pr" && !opts.worktree) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--worktree is required when workflow_mode=branch_pr.",
+            });
+        }
+        const { task } = await loadBackendTask({
+            ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        ensurePlanApprovedIfRequired(task, config);
+        const currentBranch = await gitCurrentBranch(resolved.gitRoot);
+        let baseRef = currentBranch;
+        if (mode === "branch_pr") {
+            const baseBranch = await resolveBaseBranch({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride ?? null,
+                cliBaseOpt: null,
+                mode,
+            });
+            if (!baseBranch) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: "Base branch could not be resolved (use `agentplane branch base set`).",
+                });
+            }
+            if (currentBranch !== baseBranch) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: `work start must be run on base branch ${baseBranch} (current: ${currentBranch})`,
+                });
+            }
+            baseRef = baseBranch;
+        }
+        const prefix = config.branch.task_prefix;
+        const branchName = `${prefix}/${opts.taskId}/${opts.slug.trim()}`;
+        const branchExists = await gitBranchExists(resolved.gitRoot, branchName);
+        let worktreePath = "";
+        if (opts.worktree) {
+            const worktreesDir = path.resolve(resolved.gitRoot, config.paths.worktrees_dir);
+            if (!isPathWithin(resolved.gitRoot, worktreesDir)) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: `worktrees_dir must be inside the repo: ${worktreesDir}`,
+                });
+            }
+            worktreePath = path.join(worktreesDir, `${opts.taskId}-${opts.slug.trim()}`);
+            if (await fileExists(worktreePath)) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: `Worktree path already exists: ${worktreePath}`,
+                });
+            }
+            await mkdir(worktreesDir, { recursive: true });
+            const worktreeArgs = branchExists
+                ? ["worktree", "add", worktreePath, branchName]
+                : ["worktree", "add", "-b", branchName, worktreePath, baseRef];
+            await execFileAsync("git", worktreeArgs, { cwd: resolved.gitRoot, env: gitEnv() });
+        }
+        else {
+            if (branchExists) {
+                if (currentBranch !== branchName) {
+                    await execFileAsync("git", ["checkout", "-q", branchName], {
+                        cwd: resolved.gitRoot,
+                        env: gitEnv(),
+                    });
+                }
+            }
+            else {
+                await execFileAsync("git", ["checkout", "-q", "-b", branchName, baseRef], {
+                    cwd: resolved.gitRoot,
+                    env: gitEnv(),
+                });
+            }
+        }
+        process.stdout.write(`${successMessage("work start", branchName, opts.worktree ? `worktree=${path.relative(resolved.gitRoot, worktreePath)}` : "")}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "work start", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/cleanup/merged.command.d.ts

@@ -0,0 +1,17 @@
+import type { CommandCtx, CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+type CleanupGroupParsed = {
+    cmd: string[];
+};
+export declare const cleanupSpec: CommandSpec<CleanupGroupParsed>;
+export type CleanupMergedParsed = {
+    base: string | null;
+    yes: boolean;
+    archive: boolean;
+    quiet: boolean;
+};
+export declare const cleanupMergedSpec: CommandSpec<CleanupMergedParsed>;
+export declare const runCleanup: CommandHandler<CleanupGroupParsed>;
+export declare function makeRunCleanupMergedHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: CleanupMergedParsed) => Promise<number>;
+export {};
+//# sourceMappingURL=merged.command.d.ts.map

package/dist/commands/cleanup/merged.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged.command.d.ts","sourceRoot":"","sources":["../../../src/commands/cleanup/merged.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,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE5C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAUvD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CAkC9D,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,kBAAkB,CAczD,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC5E,KAAK,UAAU,EAAE,GAAG,mBAAmB,KAAG,OAAO,CAAC,MAAM,CAAC,CAWxE"}

package/dist/commands/cleanup/merged.command.js

@@ -0,0 +1,75 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { suggestOne } from "../../cli/spec/suggest.js";
+import { cmdCleanupMerged } from "../branch/index.js";
+export const cleanupSpec = {
+    id: ["cleanup"],
+    group: "Branch",
+    summary: "Clean up local branches/worktrees.",
+    synopsis: ["agentplane cleanup <merged> [options]"],
+    args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
+    examples: [
+        { cmd: "agentplane cleanup merged --yes", why: "Delete merged task branches/worktrees." },
+    ],
+    parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
+};
+export const cleanupMergedSpec = {
+    id: ["cleanup", "merged"],
+    group: "Branch",
+    summary: "Delete merged task branches/worktrees (branch_pr workflow).",
+    options: [
+        { kind: "string", name: "base", valueHint: "<name>", description: "Base branch override." },
+        { kind: "boolean", name: "yes", default: false, description: "Confirm deletions." },
+        {
+            kind: "boolean",
+            name: "archive",
+            default: false,
+            description: "Archive PR artifacts before deletion.",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [
+        { cmd: "agentplane cleanup merged", why: "List candidates without deleting." },
+        {
+            cmd: "agentplane cleanup merged --yes --archive",
+            why: "Delete candidates and archive PR artifacts.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const base = typeof raw.opts.base === "string" ? raw.opts.base.trim() : "";
+        if (raw.opts.base !== undefined && !base) {
+            throw usageError({ spec: cleanupMergedSpec, message: "Invalid value for --base: empty." });
+        }
+    },
+    parse: (raw) => ({
+        base: typeof raw.opts.base === "string" ? raw.opts.base : null,
+        yes: raw.opts.yes === true,
+        archive: raw.opts.archive === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export const runCleanup = (_ctx, p) => {
+    const input = p.cmd.join(" ");
+    const candidates = ["merged"];
+    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]}.`;
+    return Promise.reject(usageError({
+        spec: cleanupSpec,
+        command: "cleanup",
+        message: `${msg}${suffix}`,
+        context: { command: "cleanup" },
+    }));
+};
+export function makeRunCleanupMergedHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdCleanupMerged({
+            ctx: await getCtx("cleanup merged"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            base: p.base ?? undefined,
+            yes: p.yes,
+            archive: p.archive,
+            quiet: p.quiet,
+        });
+    };
+}

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

@@ -0,0 +1,6 @@
+import type { CommandCtx } from "../cli/spec/spec.js";
+import type { CommandContext } from "./shared/task-backend.js";
+import type { CommitParsed } from "./commit.spec.js";
+export { commitSpec } from "./commit.spec.js";
+export declare function makeRunCommitHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: CommitParsed) => Promise<number>;
+//# sourceMappingURL=commit.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.command.d.ts","sourceRoot":"","sources":["../../src/commands/commit.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,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,CAoBjE"}

package/dist/commands/commit.command.js

@@ -0,0 +1,24 @@
+import { cmdCommit } from "./guard/index.js";
+export { commitSpec } from "./commit.spec.js";
+export function makeRunCommitHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdCommit({
+            ctx: await getCtx("commit"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            message: p.message ?? "",
+            close: p.close,
+            allow: p.allow,
+            autoAllow: p.autoAllow,
+            allowTasks: p.allowTasks,
+            allowBase: p.allowBase,
+            allowPolicy: p.allowPolicy,
+            allowConfig: p.allowConfig,
+            allowHooks: p.allowHooks,
+            allowCI: p.allowCI,
+            requireClean: p.requireClean,
+            quiet: p.quiet,
+        });
+    };
+}

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

@@ -0,0 +1,18 @@
+import type { CommandSpec } from "../cli/spec/spec.js";
+export type CommitParsed = {
+    taskId: string;
+    message?: string;
+    close: boolean;
+    allow: string[];
+    autoAllow: boolean;
+    allowTasks: boolean;
+    allowBase: boolean;
+    allowPolicy: boolean;
+    allowConfig: boolean;
+    allowHooks: boolean;
+    allowCI: boolean;
+    requireClean: boolean;
+    quiet: boolean;
+};
+export declare const commitSpec: CommandSpec<CommitParsed>;
+//# sourceMappingURL=commit.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.spec.d.ts","sourceRoot":"","sources":["../../src/commands/commit.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAuHhD,CAAC"}