agentplane 0.1.9 → 0.2.1

package/dist/commands/commit.spec.js

@@ -0,0 +1,119 @@
+import { usageError } from "../cli/spec/errors.js";
+export const commitSpec = {
+    id: ["commit"],
+    group: "Guard",
+    summary: "Create a git commit after validating policy and allowlist against staged changes.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "message",
+            short: "m",
+            valueHint: "<message>",
+            description: "Commit subject (must follow policy). Required unless --close is used.",
+        },
+        {
+            kind: "boolean",
+            name: "close",
+            default: false,
+            description: "Generate a deterministic close commit message from task snapshot + verification + recorded implementation commit; stages only the task README.",
+        },
+        {
+            kind: "string",
+            name: "allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowed path prefix (git-path).",
+        },
+        {
+            kind: "boolean",
+            name: "auto-allow",
+            default: false,
+            description: "Infer --allow prefixes from staged paths (only when no explicit --allow is provided).",
+        },
+        {
+            kind: "boolean",
+            name: "allow-tasks",
+            default: false,
+            description: "Allow task workflow artifacts (tasks/ and .agentplane/tasks/).",
+        },
+        {
+            kind: "boolean",
+            name: "allow-base",
+            default: false,
+            description: "Allow base branch edits.",
+        },
+        {
+            kind: "boolean",
+            name: "allow-policy",
+            default: false,
+            description: "Allow policy edits (e.g. AGENTS.md).",
+        },
+        { kind: "boolean", name: "allow-config", default: false, description: "Allow config edits." },
+        { kind: "boolean", name: "allow-hooks", default: false, description: "Allow hooks edits." },
+        { kind: "boolean", name: "allow-ci", default: false, description: "Allow CI workflow edits." },
+        {
+            kind: "boolean",
+            name: "require-clean",
+            default: false,
+            description: "Fail if tracked files have unstaged changes (untracked is ignored).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --allow packages/agentplane',
+            why: "Create a commit after validating allowlist and subject policy.",
+        },
+        {
+            cmd: 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --auto-allow',
+            why: "Infer allowlist prefixes from staged paths.",
+        },
+        {
+            cmd: "agentplane commit 202602030608-F1Q8AB --close",
+            why: "Create a close commit for the task README using a deterministic message builder.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const close = raw.opts.close === true;
+        const msg = typeof raw.opts.message === "string" ? raw.opts.message.trim() : "";
+        if (!close && !msg) {
+            throw usageError({
+                spec: commitSpec,
+                message: "Missing required --message (or use --close).",
+            });
+        }
+        if (raw.opts.message !== undefined && !msg) {
+            throw usageError({ spec: commitSpec, message: "Invalid value for --message: empty." });
+        }
+        if (close && raw.opts.message !== undefined) {
+            throw usageError({
+                spec: commitSpec,
+                message: "Use either --message or --close (not both).",
+            });
+        }
+        const allow = raw.opts.allow;
+        if (Array.isArray(allow) && allow.some((s) => typeof s === "string" && s.trim() === "")) {
+            throw usageError({ spec: commitSpec, message: "Invalid value for --allow: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        message: typeof raw.opts.message === "string" ? String(raw.opts.message) : undefined,
+        close: raw.opts.close === true,
+        allow: Array.isArray(raw.opts.allow)
+            ? raw.opts.allow
+            : typeof raw.opts.allow === "string"
+                ? [raw.opts.allow]
+                : [],
+        autoAllow: raw.opts["auto-allow"] === true,
+        allowTasks: raw.opts["allow-tasks"] === true,
+        allowBase: raw.opts["allow-base"] === true,
+        allowPolicy: raw.opts["allow-policy"] === true,
+        allowConfig: raw.opts["allow-config"] === true,
+        allowHooks: raw.opts["allow-hooks"] === true,
+        allowCI: raw.opts["allow-ci"] === true,
+        requireClean: raw.opts["require-clean"] === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};

package/dist/commands/docs/cli.command.d.ts

@@ -0,0 +1,9 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import { type HelpJson } from "../../cli/spec/help-render.js";
+export type DocsCliParsed = {
+    out: string;
+};
+export declare const docsCliSpec: CommandSpec<DocsCliParsed>;
+export declare function makeRunDocsCliHandler(getHelpJson: () => readonly HelpJson[]): (ctx: CommandCtx, p: DocsCliParsed) => Promise<number>;
+export declare function makeHelpJsonFromSpecs(specs: readonly CommandSpec<unknown>[]): HelpJson[];
+//# sourceMappingURL=cli.command.d.ts.map

package/dist/commands/docs/cli.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.command.d.ts","sourceRoot":"","sources":["../../../src/commands/docs/cli.command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGrF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAqBlD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,SAAS,QAAQ,EAAE,IAC5D,KAAK,UAAU,EAAE,GAAG,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC,CAmBlE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,CAExF"}

package/dist/commands/docs/cli.command.js

@@ -0,0 +1,51 @@
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import { usageError } from "../../cli/spec/errors.js";
+import { renderCliDocsMdx } from "../../cli/spec/docs-render.js";
+import { renderCommandHelpJson } from "../../cli/spec/help-render.js";
+import { writeTextIfChanged } from "../../shared/write-if-changed.js";
+export const docsCliSpec = {
+    id: ["docs", "cli"],
+    group: "Docs",
+    summary: "Generate an MDX CLI reference from the current cli2 registry/spec.",
+    options: [
+        {
+            kind: "string",
+            name: "out",
+            valueHint: "<path>",
+            required: true,
+            description: "Output path. If relative, it is resolved against the current working directory.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane docs cli --out docs/user/cli-reference.generated.mdx",
+            why: "Generate docs.",
+        },
+    ],
+    parse: (raw) => ({ out: raw.opts.out }),
+};
+export function makeRunDocsCliHandler(getHelpJson) {
+    return async (ctx, p) => {
+        let list;
+        try {
+            list = getHelpJson();
+        }
+        catch (err) {
+            throw usageError({
+                spec: docsCliSpec,
+                command: "docs cli",
+                message: `Failed to read cli2 registry/spec for docs generation: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        const mdx = renderCliDocsMdx(list);
+        const outPath = path.resolve(ctx.cwd, p.out);
+        await mkdir(path.dirname(outPath), { recursive: true });
+        await writeTextIfChanged(outPath, mdx);
+        process.stdout.write(`${outPath}\n`);
+        return 0;
+    };
+}
+export function makeHelpJsonFromSpecs(specs) {
+    return specs.map((s) => renderCommandHelpJson(s));
+}

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

@@ -0,0 +1,28 @@
+import type { CommandCtx, CommandSpec } from "../cli/spec/spec.js";
+import type { CommandContext } from "./shared/task-backend.js";
+export type FinishParsed = {
+    taskIds: string[];
+    author: string;
+    body: string;
+    result?: string;
+    risk?: "low" | "med" | "high";
+    breaking: boolean;
+    commit?: string;
+    force: boolean;
+    commitFromComment: boolean;
+    commitEmoji?: string;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    statusCommit: boolean;
+    statusCommitEmoji?: string;
+    statusCommitAllow: string[];
+    statusCommitAutoAllow: boolean;
+    statusCommitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    quiet: boolean;
+};
+export declare const finishSpec: CommandSpec<FinishParsed>;
+export declare function makeRunFinishHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: FinishParsed) => Promise<number>;
+//# sourceMappingURL=finish.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finish.command.d.ts","sourceRoot":"","sources":["../../src/commands/finish.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAQF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAsMhD,CAAC;AAEF,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,CAmCjE"}

package/dist/commands/finish.command.js

@@ -0,0 +1,237 @@
+import { usageError } from "../cli/spec/errors.js";
+import { cmdFinish } from "./task/finish.js";
+function toStringList(v) {
+    if (typeof v === "string")
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === "string");
+    return [];
+}
+export const finishSpec = {
+    id: ["finish"],
+    group: "Lifecycle",
+    summary: "Mark task(s) as DONE and record a structured Verified comment.",
+    args: [
+        {
+            name: "task-id",
+            required: true,
+            variadic: true,
+            valueHint: "<task-id>",
+            description: "One or more existing task ids.",
+        },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Comment author id (e.g. INTEGRATOR).",
+        },
+        {
+            kind: "string",
+            name: "body",
+            valueHint: "<text>",
+            required: true,
+            description: "Structured comment body (must match the configured Verified: prefix).",
+        },
+        {
+            kind: "string",
+            name: "result",
+            valueHint: "<one-line>",
+            description: "One-line result summary stored in task metadata (required for non-spike tasks when finishing a single task).",
+        },
+        {
+            kind: "string",
+            name: "risk",
+            valueHint: "<low|med|high>",
+            choices: ["low", "med", "high"],
+            description: "Optional. Risk level stored in task metadata.",
+        },
+        {
+            kind: "boolean",
+            name: "breaking",
+            default: false,
+            description: "Optional. Mark the change as breaking in task metadata.",
+        },
+        {
+            kind: "string",
+            name: "commit",
+            valueHint: "<hash>",
+            description: "Commit hash to record on the task (optional).",
+        },
+        { kind: "boolean", name: "force", default: false, description: "Force finish despite gates." },
+        {
+            kind: "boolean",
+            name: "commit-from-comment",
+            default: false,
+            description: "Create a commit using the comment body (requires exactly one task id).",
+        },
+        {
+            kind: "string",
+            name: "commit-emoji",
+            valueHint: "<emoji>",
+            description: "Override the commit emoji (used with --commit-from-comment).",
+        },
+        {
+            kind: "string",
+            name: "commit-allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowlist path prefixes to stage for the commit (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-auto-allow",
+            default: false,
+            description: "Auto-allow inferred allowlist paths if none are provided (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "commit-allow-tasks",
+            default: true,
+            hidden: true,
+            description: "Deprecated. Tasks are always allowed for status commits.",
+            deprecated: "no-op",
+        },
+        {
+            kind: "boolean",
+            name: "commit-require-clean",
+            default: false,
+            description: "Require a clean working tree for the commit (used with --commit-from-comment).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit",
+            default: false,
+            description: "Create a separate status commit (requires exactly one task id).",
+        },
+        {
+            kind: "string",
+            name: "status-commit-emoji",
+            valueHint: "<emoji>",
+            description: "Override the status commit emoji (used with --status-commit).",
+        },
+        {
+            kind: "string",
+            name: "status-commit-allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowlist path prefixes to stage for the status commit (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit-auto-allow",
+            default: false,
+            description: "Auto-allow inferred allowlist paths if none are provided (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "status-commit-require-clean",
+            default: false,
+            description: "Require a clean working tree for the status commit (used with --status-commit).",
+        },
+        {
+            kind: "boolean",
+            name: "confirm-status-commit",
+            default: false,
+            description: "Confirm status commit creation when status_commit_policy=confirm (used with --commit-from-comment or --status-commit).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body "Verified: all checks passed" --commit abcdef123456',
+            why: "Finish a task and record commit metadata.",
+        },
+        {
+            cmd: 'agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body "Verified: all checks passed" --commit-from-comment --commit-allow packages/agentplane/src',
+            why: "Finish and create a commit from the comment (single-task only).",
+        },
+    ],
+    validateRaw: (raw) => {
+        const ids = raw.args["task-id"];
+        const taskIds = Array.isArray(ids) ? ids : [];
+        const commitFromComment = raw.opts["commit-from-comment"] === true;
+        const statusCommit = raw.opts["status-commit"] === true;
+        if ((commitFromComment || statusCommit) && taskIds.length !== 1) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--commit-from-comment/--status-commit requires exactly one task id",
+            });
+        }
+        const hasMeta = typeof raw.opts.result === "string" ||
+            typeof raw.opts.risk === "string" ||
+            raw.opts.breaking === true;
+        if (hasMeta && taskIds.length !== 1) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--result/--risk/--breaking requires exactly one task id",
+            });
+        }
+    },
+    parse: (raw) => ({
+        taskIds: Array.isArray(raw.args["task-id"])
+            ? raw.args["task-id"].filter((x) => typeof x === "string")
+            : [],
+        author: raw.opts.author,
+        body: raw.opts.body,
+        result: raw.opts.result,
+        risk: raw.opts.risk,
+        breaking: raw.opts.breaking === true,
+        commit: raw.opts.commit,
+        force: raw.opts.force === true,
+        commitFromComment: raw.opts["commit-from-comment"] === true,
+        commitEmoji: raw.opts["commit-emoji"],
+        commitAllow: toStringList(raw.opts["commit-allow"]),
+        commitAutoAllow: raw.opts["commit-auto-allow"] === true,
+        commitAllowTasks: raw.opts["commit-allow-tasks"] !== false,
+        commitRequireClean: raw.opts["commit-require-clean"] === true,
+        statusCommit: raw.opts["status-commit"] === true,
+        statusCommitEmoji: raw.opts["status-commit-emoji"],
+        statusCommitAllow: toStringList(raw.opts["status-commit-allow"]),
+        statusCommitAutoAllow: raw.opts["status-commit-auto-allow"] === true,
+        statusCommitRequireClean: raw.opts["status-commit-require-clean"] === true,
+        confirmStatusCommit: raw.opts["confirm-status-commit"] === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunFinishHandler(getCtx) {
+    return async (ctx, p) => {
+        if (p.taskIds.length === 0) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "Missing required argument: task-id",
+            });
+        }
+        return await cmdFinish({
+            ctx: await getCtx("finish"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskIds: p.taskIds,
+            author: p.author,
+            body: p.body,
+            result: p.result,
+            risk: p.risk,
+            breaking: p.breaking,
+            commit: p.commit,
+            force: p.force,
+            commitFromComment: p.commitFromComment,
+            commitEmoji: p.commitEmoji,
+            commitAllow: p.commitAllow,
+            commitAutoAllow: p.commitAutoAllow,
+            commitAllowTasks: p.commitAllowTasks,
+            commitRequireClean: p.commitRequireClean,
+            statusCommit: p.statusCommit,
+            statusCommitEmoji: p.statusCommitEmoji,
+            statusCommitAllow: p.statusCommitAllow,
+            statusCommitAutoAllow: p.statusCommitAutoAllow,
+            statusCommitRequireClean: p.statusCommitRequireClean,
+            confirmStatusCommit: p.confirmStatusCommit,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/guard/clean.command.d.ts

@@ -0,0 +1,7 @@
+import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+export type GuardCleanParsed = {
+    quiet: boolean;
+};
+export declare const guardCleanSpec: CommandSpec<GuardCleanParsed>;
+export declare const runGuardClean: CommandHandler<GuardCleanParsed>;
+//# sourceMappingURL=clean.command.d.ts.map

package/dist/commands/guard/clean.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.command.d.ts","sourceRoot":"","sources":["../../../src/commands/guard/clean.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CASxD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAE1D,CAAC"}

package/dist/commands/guard/clean.command.js

@@ -0,0 +1,14 @@
+import { cmdGuardClean } from "./index.js";
+export const guardCleanSpec = {
+    id: ["guard", "clean"],
+    group: "Guard",
+    summary: "Ensure the git index has no staged files.",
+    options: [
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [{ cmd: "agentplane guard clean", why: "Fail if staged files exist." }],
+    parse: (raw) => ({ quiet: raw.opts.quiet === true }),
+};
+export const runGuardClean = async (ctx, p) => {
+    return await cmdGuardClean({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, quiet: p.quiet });
+};

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

@@ -0,0 +1,19 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type GuardCommitParsed = {
+    taskId: string;
+    message: string;
+    allow: string[];
+    autoAllow: boolean;
+    allowTasks: boolean;
+    allowBase: boolean;
+    allowPolicy: boolean;
+    allowConfig: boolean;
+    allowHooks: boolean;
+    allowCI: boolean;
+    requireClean: boolean;
+    quiet: boolean;
+};
+export declare const guardCommitSpec: CommandSpec<GuardCommitParsed>;
+export declare function makeRunGuardCommitHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: GuardCommitParsed) => Promise<number>;
+//# sourceMappingURL=commit.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.command.d.ts","sourceRoot":"","sources":["../../../src/commands/guard/commit.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,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,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA+F1D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAkCtE"}

package/dist/commands/guard/commit.command.js

@@ -0,0 +1,132 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { CliError } from "../../shared/errors.js";
+import { cmdGuardCommit, suggestAllowPrefixes } from "./index.js";
+export const guardCommitSpec = {
+    id: ["guard", "commit"],
+    group: "Guard",
+    summary: "Validate commit policy and allowlist for staged changes (no commit is created).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "message",
+            short: "m",
+            valueHint: "<message>",
+            required: true,
+            description: "Commit subject (must follow policy).",
+        },
+        {
+            kind: "string",
+            name: "allow",
+            valueHint: "<path-prefix>",
+            repeatable: true,
+            description: "Repeatable. Allowed path prefix (git-path).",
+        },
+        {
+            kind: "boolean",
+            name: "auto-allow",
+            default: false,
+            description: "Infer --allow prefixes from staged paths (only when no explicit --allow is provided).",
+        },
+        {
+            kind: "boolean",
+            name: "allow-tasks",
+            default: false,
+            description: "Allow task workflow artifacts (tasks/ and .agentplane/tasks/).",
+        },
+        {
+            kind: "boolean",
+            name: "allow-base",
+            default: false,
+            description: "Allow base branch edits.",
+        },
+        {
+            kind: "boolean",
+            name: "allow-policy",
+            default: false,
+            description: "Allow policy edits (e.g. AGENTS.md).",
+        },
+        { kind: "boolean", name: "allow-config", default: false, description: "Allow config edits." },
+        { kind: "boolean", name: "allow-hooks", default: false, description: "Allow hooks edits." },
+        { kind: "boolean", name: "allow-ci", default: false, description: "Allow CI workflow edits." },
+        {
+            kind: "boolean",
+            name: "require-clean",
+            default: false,
+            description: "Fail if tracked files have unstaged changes (untracked is ignored).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane guard commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --allow packages/agentplane',
+            why: "Validate staged changes are covered by allowlist and policy.",
+        },
+        {
+            cmd: 'agentplane guard commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --auto-allow',
+            why: "Infer allowlist prefixes from staged paths.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const msg = typeof raw.opts.message === "string" ? raw.opts.message.trim() : "";
+        if (raw.opts.message !== undefined && !msg) {
+            throw usageError({ spec: guardCommitSpec, message: "Invalid value for --message: empty." });
+        }
+        const allow = raw.opts.allow;
+        if (Array.isArray(allow) && allow.some((s) => typeof s === "string" && s.trim() === "")) {
+            throw usageError({ spec: guardCommitSpec, message: "Invalid value for --allow: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        message: String(raw.opts.message),
+        allow: Array.isArray(raw.opts.allow)
+            ? raw.opts.allow
+            : typeof raw.opts.allow === "string"
+                ? [raw.opts.allow]
+                : [],
+        autoAllow: raw.opts["auto-allow"] === true,
+        allowTasks: raw.opts["allow-tasks"] === true,
+        allowBase: raw.opts["allow-base"] === true,
+        allowPolicy: raw.opts["allow-policy"] === true,
+        allowConfig: raw.opts["allow-config"] === true,
+        allowHooks: raw.opts["allow-hooks"] === true,
+        allowCI: raw.opts["allow-ci"] === true,
+        requireClean: raw.opts["require-clean"] === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunGuardCommitHandler(getCtx) {
+    return async (ctx, p) => {
+        const cmdCtx = await getCtx("guard commit");
+        let allow = p.allow;
+        if (p.autoAllow && allow.length === 0) {
+            const staged = await cmdCtx.git.statusStagedPaths();
+            const prefixes = suggestAllowPrefixes(staged);
+            if (prefixes.length === 0) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: "No staged files (git index empty)",
+                });
+            }
+            allow = prefixes;
+        }
+        return await cmdGuardCommit({
+            ctx: cmdCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            message: p.message,
+            allow,
+            allowBase: p.allowBase,
+            allowTasks: p.allowTasks,
+            allowPolicy: p.allowPolicy,
+            allowConfig: p.allowConfig,
+            allowHooks: p.allowHooks,
+            allowCI: p.allowCI,
+            requireClean: p.requireClean,
+            quiet: p.quiet,
+        });
+    };
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.command.d.ts","sourceRoot":"","sources":["../../../src/commands/guard/guard.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAenD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,gBAAgB,CAGrD,CAAC"}