agentplane 0.1.9 → 0.2.1

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

@@ -0,0 +1,21 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const guardSpec = {
+    id: ["guard"],
+    group: "Guard",
+    summary: "Guard commands (commit checks, git hygiene, and allowlist helpers).",
+    synopsis: ["agentplane guard <command> [args] [options]"],
+    validateRaw: (raw) => {
+        if (raw.extra.length > 0) {
+            throw usageError({
+                spec: guardSpec,
+                message: `Unknown subcommand: ${raw.extra[0]}`,
+            });
+        }
+        throw usageError({ spec: guardSpec, message: "Missing subcommand." });
+    },
+    parse: () => ({}),
+};
+export const runGuard = () => {
+    // Unreachable (validateRaw always throws).
+    return Promise.resolve(2);
+};

package/dist/commands/guard/impl/allow.d.ts

@@ -0,0 +1,18 @@
+import { type CommandContext } from "../../shared/task-backend.js";
+export declare function suggestAllowPrefixes(paths: string[]): string[];
+export declare function gitStatusChangedPaths(opts: {
+    cwd: string;
+    rootOverride?: string;
+}): Promise<string[]>;
+export declare function ensureGitClean(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+}): Promise<void>;
+export declare function stageAllowlist(opts: {
+    ctx: CommandContext;
+    allow: string[];
+    allowTasks: boolean;
+    tasksPath: string;
+}): Promise<string[]>;
+//# sourceMappingURL=allow.d.ts.map

package/dist/commands/guard/impl/allow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allow.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/allow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS9D;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCpB"}

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

@@ -0,0 +1,77 @@
+import { resolveProject } from "@agentplaneorg/core";
+import { gitPathIsUnderPrefix, normalizeGitPathPrefix } from "../../../shared/git-path.js";
+import { CliError } from "../../../shared/errors.js";
+import { GitContext } from "../../shared/git-context.js";
+import { loadCommandContext } from "../../shared/task-backend.js";
+export function suggestAllowPrefixes(paths) {
+    const out = new Set();
+    for (const filePath of paths) {
+        if (!filePath)
+            continue;
+        const idx = filePath.lastIndexOf("/");
+        if (idx <= 0)
+            out.add(filePath);
+        else
+            out.add(filePath.slice(0, idx));
+    }
+    return [...out].toSorted((a, b) => a.localeCompare(b));
+}
+export async function gitStatusChangedPaths(opts) {
+    const resolved = await resolveProject({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const git = new GitContext({ gitRoot: resolved.gitRoot });
+    return await git.statusChangedPaths();
+}
+export async function ensureGitClean(opts) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const staged = await ctx.git.statusStagedPaths();
+    if (staged.length > 0) {
+        throw new CliError({ exitCode: 5, code: "E_GIT", message: "Working tree has staged changes" });
+    }
+    // Policy-defined "clean" ignores untracked files.
+    const unstaged = await ctx.git.statusUnstagedTrackedPaths();
+    if (unstaged.length > 0) {
+        throw new CliError({
+            exitCode: 5,
+            code: "E_GIT",
+            message: "Working tree has unstaged changes",
+        });
+    }
+}
+export async function stageAllowlist(opts) {
+    const changed = await opts.ctx.git.statusChangedPaths();
+    if (changed.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "No changes to stage (working tree clean)",
+        });
+    }
+    const allow = opts.allow.map((prefix) => normalizeGitPathPrefix(prefix));
+    const denied = new Set();
+    if (!opts.allowTasks)
+        denied.add(opts.tasksPath);
+    const staged = [];
+    for (const filePath of changed) {
+        if (denied.has(filePath))
+            continue;
+        if (allow.some((prefix) => gitPathIsUnderPrefix(filePath, prefix))) {
+            staged.push(filePath);
+        }
+    }
+    const unique = [...new Set(staged)].toSorted((a, b) => a.localeCompare(b));
+    if (unique.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "No changes matched allowed prefixes (use --commit-auto-allow or update --commit-allow)",
+        });
+    }
+    // `git add <pathspec>` is not reliable for staging deletes/renames across versions/configs.
+    // `-A -- <pathspec...>` makes the allowlist staging semantics deterministic.
+    await opts.ctx.git.stage(unique);
+    return unique;
+}

package/dist/commands/guard/impl/close-message.d.ts

@@ -0,0 +1,16 @@
+import type { TaskData } from "../../../backends/task-backend.js";
+export type CloseCommitMessage = {
+    subject: string;
+    body: string;
+};
+export declare function buildCloseCommitMessage(opts: {
+    gitRoot: string;
+    task: TaskData;
+    keyFilesLimit?: number;
+}): Promise<CloseCommitMessage>;
+export declare function taskReadmePathForTask(opts: {
+    gitRoot: string;
+    workflowDir: string;
+    taskId: string;
+}): string;
+//# sourceMappingURL=close-message.d.ts.map

package/dist/commands/guard/impl/close-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-message.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/close-message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAqHlE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkD9B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAET"}

package/dist/commands/guard/impl/close-message.js

@@ -0,0 +1,156 @@
+import path from "node:path";
+import { extractTaskSuffix } from "@agentplaneorg/core";
+import { CliError } from "../../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../../shared/git.js";
+function uniqSorted(values) {
+    return [...new Set(values)].toSorted((a, b) => a.localeCompare(b));
+}
+function uniqInOrder(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        if (seen.has(v))
+            continue;
+        seen.add(v);
+        out.push(v);
+    }
+    return out;
+}
+function isTaskArtifactPath(p) {
+    const norm = p.replaceAll("\\", "/");
+    return norm.startsWith(".agentplane/tasks/") || norm.startsWith("tasks/");
+}
+function normalizeResultFallback(title) {
+    const trimmed = title.trim().replaceAll(/\s+/g, " ");
+    return trimmed.length > 90 ? `${trimmed.slice(0, 87)}...` : trimmed;
+}
+function clampList(items, max) {
+    return items.slice(0, Math.max(0, Math.floor(max)));
+}
+async function gitNumstatForCommit(gitRoot, commit) {
+    const { stdout } = await execFileAsync("git", ["show", "--numstat", "--format=", commit], {
+        cwd: gitRoot,
+        env: gitEnv(),
+        encoding: "buffer",
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const text = Buffer.isBuffer(stdout) ? stdout.toString("utf8") : String(stdout);
+    const entries = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const parts = trimmed.split("\t");
+        if (parts.length < 3)
+            continue;
+        const [aRaw, dRaw, fileRaw] = parts;
+        const file = String(fileRaw ?? "").trim();
+        if (!file)
+            continue;
+        const added = aRaw === "-" ? 0 : Number(aRaw);
+        const deleted = dRaw === "-" ? 0 : Number(dRaw);
+        const churn = (Number.isFinite(added) ? added : 0) + (Number.isFinite(deleted) ? deleted : 0);
+        entries.push({
+            file,
+            added: Number.isFinite(added) ? added : 0,
+            deleted: Number.isFinite(deleted) ? deleted : 0,
+            churn,
+        });
+    }
+    return entries;
+}
+function pickKeyFiles(opts) {
+    const sorted = [...opts.entries].toSorted((a, b) => {
+        if (b.churn !== a.churn)
+            return b.churn - a.churn;
+        return a.file.localeCompare(b.file);
+    });
+    const filtered = sorted.map((e) => e.file).filter((f) => !isTaskArtifactPath(f));
+    // Preserve churn ordering while still being deterministic and duplicate-free.
+    return clampList(uniqInOrder(filtered), opts.limit);
+}
+function formatTagsForSubject(tags) {
+    const norm = uniqSorted(tags.map((t) => t.trim()).filter(Boolean));
+    const filtered = norm.filter((t) => t !== "spike");
+    const max = 4;
+    const shown = filtered.slice(0, max);
+    const extra = filtered.length - shown.length;
+    if (shown.length === 0)
+        return "";
+    const base = shown.join(",");
+    return extra > 0 ? `[${base},+${extra}]` : `[${base}]`;
+}
+function formatTagsForBody(tags) {
+    const norm = uniqSorted(tags.map((t) => t.trim()).filter(Boolean));
+    return norm.join(", ");
+}
+function normalizeOneLine(s, maxChars) {
+    const trimmed = s.trim().replaceAll(/\s+/g, " ");
+    if (!trimmed)
+        return "";
+    const max = Math.max(1, Math.floor(maxChars));
+    return trimmed.length > max ? `${trimmed.slice(0, Math.max(1, max - 3))}...` : trimmed;
+}
+function buildVerifySummary(task, isSpike) {
+    if (isSpike)
+        return "not required (spike)";
+    const state = task.verification?.state ?? "pending";
+    const note = typeof task.verification?.note === "string" ? task.verification.note : "";
+    if (state === "ok" && note.trim())
+        return normalizeOneLine(note, 120);
+    const cmds = Array.isArray(task.verify)
+        ? task.verify.filter((c) => typeof c === "string" && c.trim())
+        : [];
+    if (cmds.length > 0)
+        return cmds.join("; ");
+    if (state === "ok")
+        return "ok (see task verification note)";
+    return String(state);
+}
+export async function buildCloseCommitMessage(opts) {
+    const task = opts.task;
+    const tags = Array.isArray(task.tags)
+        ? task.tags.filter((t) => typeof t === "string")
+        : [];
+    const isSpike = tags.includes("spike");
+    if (String(task.status || "").toUpperCase() !== "DONE") {
+        throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Task is not DONE: ${task.id}` });
+    }
+    const implCommit = task.commit?.hash?.trim() ?? "";
+    if (!implCommit) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Task is missing recorded commit metadata: ${task.id} (finish with --commit or set commit on the task).`,
+        });
+    }
+    const suffix = extractTaskSuffix(task.id);
+    const resultSummary = typeof task.result_summary === "string" ? task.result_summary.trim() : "";
+    const result = resultSummary
+        ? normalizeResultFallback(resultSummary)
+        : `${normalizeResultFallback(task.title)} (no result_summary)`;
+    const tagBracket = formatTagsForSubject(tags);
+    const emoji = isSpike ? "🧪" : "✅";
+    // CommitPolicy requires scope to match: [a-z][a-z0-9_-]* (no punctuation like parentheses).
+    // Include the task id as part of the summary for scanability.
+    const subject = `${emoji} ${suffix} close: ${result} (${task.id})${tagBracket ? ` ${tagBracket}` : ""}`;
+    const verifySummary = buildVerifySummary(task, isSpike);
+    const entries = await gitNumstatForCommit(opts.gitRoot, implCommit);
+    const keyFiles = pickKeyFiles({ entries, limit: opts.keyFilesLimit ?? 5 });
+    const keyFilesText = keyFiles.length > 0 ? keyFiles.join(", ") : "(none)";
+    const notes = [];
+    if (task.breaking === true)
+        notes.push("breaking");
+    if (typeof task.risk_level === "string" && task.risk_level.trim())
+        notes.push(`risk=${task.risk_level.trim()}`);
+    const bodyLines = [
+        `Scope: ${formatTagsForBody(tags) || "(none)"}`,
+        `Verify: ${verifySummary}`,
+        `Key files: ${keyFilesText}`,
+        notes.length > 0 ? `Notes: ${notes.join("; ")}` : null,
+    ].filter((l) => typeof l === "string");
+    return { subject, body: bodyLines.join("\n") };
+}
+export function taskReadmePathForTask(opts) {
+    return path.join(opts.gitRoot, opts.workflowDir, opts.taskId, "README.md");
+}

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

@@ -0,0 +1,32 @@
+import { type CommandContext } from "../../shared/task-backend.js";
+import { type GuardCommitOptions } from "./policy.js";
+export declare function cmdGuardClean(opts: {
+    cwd: string;
+    rootOverride?: string;
+    quiet: boolean;
+}): Promise<number>;
+export declare function cmdGuardSuggestAllow(opts: {
+    cwd: string;
+    rootOverride?: string;
+    format: "lines" | "args";
+}): Promise<number>;
+export declare function cmdGuardCommit(opts: GuardCommitOptions): Promise<number>;
+export declare function cmdCommit(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    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;
+}): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,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,GAAG,OAAO,CAAC,MAAM,CAAC,CAgIlB"}

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

@@ -0,0 +1,191 @@
+import { mapCoreError } from "../../../cli/error-map.js";
+import { successMessage } from "../../../cli/output.js";
+import { CliError } from "../../../shared/errors.js";
+import { loadCommandContext } from "../../shared/task-backend.js";
+import { loadTaskFromContext } from "../../shared/task-backend.js";
+import { suggestAllowPrefixes } from "./allow.js";
+import { buildCloseCommitMessage, taskReadmePathForTask } from "./close-message.js";
+import { buildGitCommitEnv } from "./env.js";
+import { guardCommitCheck } from "./policy.js";
+export async function cmdGuardClean(opts) {
+    try {
+        const ctx = await loadCommandContext({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const staged = await ctx.git.statusStagedPaths();
+        if (staged.length > 0) {
+            throw new CliError({
+                exitCode: 5,
+                code: "E_GIT",
+                message: "Staged files exist",
+            });
+        }
+        if (!opts.quiet) {
+            process.stdout.write(`${successMessage("index clean", undefined, "no staged files")}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "guard clean", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdGuardSuggestAllow(opts) {
+    try {
+        const ctx = await loadCommandContext({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const staged = await ctx.git.statusStagedPaths();
+        if (staged.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "No staged files (git index empty)",
+            });
+        }
+        const prefixes = suggestAllowPrefixes(staged);
+        if (opts.format === "args") {
+            const args = prefixes.map((p) => `--allow ${p}`).join(" ");
+            process.stdout.write(`${args}\n`);
+        }
+        else {
+            for (const prefix of prefixes)
+                process.stdout.write(`${prefix}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, { command: "guard suggest-allow", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdGuardCommit(opts) {
+    try {
+        await guardCommitCheck(opts);
+        if (!opts.quiet)
+            process.stdout.write("OK\n");
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "guard commit", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdCommit(opts) {
+    try {
+        if (opts.close) {
+            const ctx = opts.ctx ??
+                (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+            // Make the close commit deterministic: require empty index, then stage only the task README.
+            const staged = await ctx.git.statusStagedPaths();
+            if (staged.length > 0) {
+                throw new CliError({
+                    exitCode: 5,
+                    code: "E_GIT",
+                    message: "Staged files exist (close commit requires an empty index)",
+                });
+            }
+            const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
+            const msg = await buildCloseCommitMessage({ gitRoot: ctx.resolvedProject.gitRoot, task });
+            const readmeAbs = taskReadmePathForTask({
+                gitRoot: ctx.resolvedProject.gitRoot,
+                workflowDir: ctx.config.paths.workflow_dir,
+                taskId: opts.taskId,
+            });
+            const readmeRel = readmeAbs.startsWith(ctx.resolvedProject.gitRoot)
+                ? readmeAbs.slice(ctx.resolvedProject.gitRoot.length + 1)
+                : readmeAbs;
+            await ctx.git.stage([readmeRel]);
+            // Close commits should not require manual --allow flags:
+            // the command stages exactly one task README under workflow_dir.
+            const allow = [ctx.config.paths.workflow_dir];
+            await guardCommitCheck({
+                ctx,
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: opts.taskId,
+                message: msg.subject,
+                allow,
+                allowBase: false,
+                allowTasks: true,
+                allowPolicy: false,
+                allowConfig: false,
+                allowHooks: false,
+                allowCI: false,
+                requireClean: true,
+                quiet: opts.quiet,
+            });
+            const env = buildGitCommitEnv({
+                taskId: opts.taskId,
+                allowTasks: true,
+                allowBase: false,
+                allowPolicy: false,
+                allowConfig: false,
+                allowHooks: false,
+                allowCI: false,
+            });
+            await ctx.git.commit({ message: msg.subject, body: msg.body, env });
+            if (!opts.quiet) {
+                const { hash, subject } = await ctx.git.headHashSubject();
+                process.stdout.write(`${successMessage("committed", `${hash?.slice(0, 12) ?? ""} ${subject ?? ""}`.trim())}\n`);
+            }
+            return 0;
+        }
+        let allow = opts.allow;
+        if (opts.autoAllow && allow.length === 0) {
+            const ctx = opts.ctx ??
+                (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+            const staged = await ctx.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;
+        }
+        await guardCommitCheck({
+            ctx: opts.ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            message: opts.message,
+            allow,
+            allowBase: opts.allowBase,
+            allowTasks: opts.allowTasks,
+            allowPolicy: opts.allowPolicy,
+            allowConfig: opts.allowConfig,
+            allowHooks: opts.allowHooks,
+            allowCI: opts.allowCI,
+            requireClean: opts.requireClean,
+            quiet: opts.quiet,
+        });
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        const env = buildGitCommitEnv({
+            taskId: opts.taskId,
+            allowTasks: opts.allowTasks,
+            allowBase: opts.allowBase,
+            allowPolicy: opts.allowPolicy,
+            allowConfig: opts.allowConfig,
+            allowHooks: opts.allowHooks,
+            allowCI: opts.allowCI,
+        });
+        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`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "commit", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,25 @@
+import { type AgentplaneConfig } from "@agentplaneorg/core";
+import { type CommandContext } from "../../shared/task-backend.js";
+export declare function commitFromComment(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author?: string;
+    statusFrom?: string;
+    statusTo?: string;
+    commentBody: string;
+    formattedComment: string | null;
+    emoji: string;
+    allow: string[];
+    autoAllow: boolean;
+    allowTasks: boolean;
+    requireClean: boolean;
+    quiet: boolean;
+    config: AgentplaneConfig;
+}): Promise<{
+    hash: string;
+    message: string;
+    staged: string[];
+}>;
+//# sourceMappingURL=comment-commit.d.ts.map

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

@@ -0,0 +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;AAS/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAoEvF,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,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,CA4F/D"}