agentplane 0.2.19 → 0.2.22

package/dist/commands/task/close-duplicate.command.js

@@ -0,0 +1,102 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskCloseDuplicate } from "./close-duplicate.js";
+export const taskCloseDuplicateSpec = {
+    id: ["task", "close-duplicate"],
+    group: "Task",
+    summary: "Close a task as a duplicate of another task with no-op bookkeeping metadata.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "of",
+            valueHint: "<task-id>",
+            required: true,
+            description: "Canonical task id that this task duplicates.",
+        },
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Comment author id (e.g. ORCHESTRATOR).",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            description: "Optional short reason appended to the closure comment.",
+        },
+        { kind: "boolean", name: "force", default: false, description: "Force closure despite gates." },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve force-action approval checks when required.",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task close-duplicate 202602120845-VKGC27 --of 202602120845-RWJ8K3 --author ORCHESTRATOR",
+            why: "Close accidental duplicate task in one command.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const taskId = typeof raw.args["task-id"] === "string" ? raw.args["task-id"].trim() : "";
+        const of = typeof raw.opts.of === "string" ? raw.opts.of.trim() : "";
+        const author = typeof raw.opts.author === "string" ? raw.opts.author.trim() : "";
+        const note = raw.opts.note;
+        if (!taskId) {
+            throw usageError({
+                spec: taskCloseDuplicateSpec,
+                message: "Invalid value for task-id: empty.",
+            });
+        }
+        if (!of) {
+            throw usageError({ spec: taskCloseDuplicateSpec, message: "Invalid value for --of: empty." });
+        }
+        if (!author) {
+            throw usageError({
+                spec: taskCloseDuplicateSpec,
+                message: "Invalid value for --author: empty.",
+            });
+        }
+        if (typeof note === "string" && note.trim().length === 0) {
+            throw usageError({
+                spec: taskCloseDuplicateSpec,
+                message: "Invalid value for --note: empty.",
+            });
+        }
+        if (taskId === of) {
+            throw usageError({
+                spec: taskCloseDuplicateSpec,
+                message: "Duplicate target must differ from task-id.",
+            });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        duplicateOf: String(raw.opts.of),
+        author: String(raw.opts.author),
+        note: typeof raw.opts.note === "string" ? raw.opts.note : undefined,
+        force: raw.opts.force === true,
+        yes: raw.opts.yes === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunTaskCloseDuplicateHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskCloseDuplicate({
+            ctx: await getCtx("task close-duplicate"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            duplicateOf: p.duplicateOf,
+            author: p.author,
+            note: p.note,
+            force: p.force,
+            yes: p.yes,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/task/close-duplicate.d.ts

@@ -0,0 +1,14 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdTaskCloseDuplicate(opts: {
+    ctx: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    duplicateOf: string;
+    author: string;
+    note?: string;
+    force: boolean;
+    yes: boolean;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=close-duplicate.d.ts.map

package/dist/commands/task/close-duplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-duplicate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIrF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFlB"}

package/dist/commands/task/close-duplicate.js

@@ -0,0 +1,90 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+import { ensureActionApproved } from "../shared/approval-requirements.js";
+import { loadTaskFromContext } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { appendTaskEvent, nowIso, requireStructuredComment } from "./shared.js";
+export async function cmdTaskCloseDuplicate(opts) {
+    try {
+        const sourceId = opts.taskId.trim();
+        const duplicateOf = opts.duplicateOf.trim();
+        if (!sourceId || !duplicateOf) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Both task id and --of must be non-empty.",
+            });
+        }
+        if (sourceId === duplicateOf) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Duplicate target must differ from task id (${sourceId}).`,
+            });
+        }
+        if (opts.force) {
+            await ensureActionApproved({
+                action: "force_action",
+                config: opts.ctx.config,
+                yes: opts.yes,
+                reason: "task close-duplicate --force",
+            });
+        }
+        const canonical = await loadTaskFromContext({ ctx: opts.ctx, taskId: duplicateOf });
+        const useStore = backendIsLocalFileBackend(opts.ctx);
+        const store = useStore ? getTaskStore(opts.ctx) : null;
+        const task = useStore
+            ? await store.get(sourceId)
+            : await loadTaskFromContext({ ctx: opts.ctx, taskId: sourceId });
+        if (!opts.force && String(task.status || "TODO").toUpperCase() === "DONE") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Task is already DONE: ${sourceId} (use --force to override)`,
+            });
+        }
+        const reason = opts.note?.trim();
+        const canonicalTitle = canonical.title?.trim() ? ` (${canonical.title.trim()})` : "";
+        const baseBody = `Verified: ${sourceId} is a bookkeeping duplicate of ${duplicateOf}${canonicalTitle}; ` +
+            "no code/config changes are expected in this task and closure is recorded as no-op.";
+        const body = reason ? `${baseBody}\n\nReason: ${reason}` : baseBody;
+        const verifiedCfg = opts.ctx.config.tasks.comments.verified;
+        requireStructuredComment(body, verifiedCfg.prefix, verifiedCfg.min_chars);
+        const at = nowIso();
+        const next = {
+            ...task,
+            status: "DONE",
+            comments: [
+                ...(Array.isArray(task.comments) ? task.comments : []),
+                { author: opts.author, body },
+            ],
+            events: appendTaskEvent(task, {
+                type: "status",
+                at,
+                author: opts.author,
+                from: String(task.status || "TODO").toUpperCase(),
+                to: "DONE",
+                note: body,
+            }),
+            result_summary: `Closed as duplicate of ${duplicateOf}.`,
+            risk_level: "low",
+            breaking: false,
+            doc_version: 2,
+            doc_updated_at: at,
+            doc_updated_by: opts.author,
+        };
+        await (useStore ? store.update(sourceId, () => next) : opts.ctx.taskBackend.writeTask(next));
+        if (!opts.quiet) {
+            process.stdout.write(`task.done: ${sourceId} (duplicate of ${duplicateOf})\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task close-duplicate",
+            root: opts.rootOverride ?? null,
+        });
+    }
+}

package/dist/commands/task/close-noop.command.d.ts

@@ -0,0 +1,14 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+type TaskCloseNoopParsed = {
+    taskId: string;
+    author: string;
+    note?: string;
+    force: boolean;
+    yes: boolean;
+    quiet: boolean;
+};
+export declare const taskCloseNoopSpec: CommandSpec<TaskCloseNoopParsed>;
+export declare function makeRunTaskCloseNoopHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskCloseNoopParsed) => Promise<number>;
+export {};
+//# sourceMappingURL=close-noop.command.d.ts.map

package/dist/commands/task/close-noop.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-noop.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-noop.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CA2D9D,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,CAaxE"}

package/dist/commands/task/close-noop.command.js

@@ -0,0 +1,77 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskCloseNoop } from "./close-noop.js";
+export const taskCloseNoopSpec = {
+    id: ["task", "close-noop"],
+    group: "Task",
+    summary: "Close a task as a verified no-op in one command.",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "string",
+            name: "author",
+            valueHint: "<id>",
+            required: true,
+            description: "Comment author id (e.g. ORCHESTRATOR).",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            description: "Optional closure note.",
+        },
+        {
+            kind: "boolean",
+            name: "force",
+            default: false,
+            description: "Override status/verification gates.",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve force-action checks when required.",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task close-noop 202602030608-F1Q8AB --author ORCHESTRATOR --note "Duplicate tracking artifact"',
+            why: "Close bookkeeping-only tasks without manual verify+finish choreography.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const taskId = typeof raw.args["task-id"] === "string" ? raw.args["task-id"].trim() : "";
+        const author = typeof raw.opts.author === "string" ? raw.opts.author.trim() : "";
+        const note = raw.opts.note;
+        if (!taskId)
+            throw usageError({ spec: taskCloseNoopSpec, message: "Invalid value for task-id: empty." });
+        if (!author)
+            throw usageError({ spec: taskCloseNoopSpec, message: "Invalid value for --author: empty." });
+        if (typeof note === "string" && note.trim().length === 0) {
+            throw usageError({ spec: taskCloseNoopSpec, message: "Invalid value for --note: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        author: String(raw.opts.author),
+        note: typeof raw.opts.note === "string" ? raw.opts.note : undefined,
+        force: raw.opts.force === true,
+        yes: raw.opts.yes === true,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunTaskCloseNoopHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskCloseNoop({
+            ctx: await getCtx("task close-noop"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            author: p.author,
+            note: p.note,
+            force: p.force,
+            yes: p.yes,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/task/close-noop.d.ts

@@ -0,0 +1,13 @@
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function cmdTaskCloseNoop(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author: string;
+    note?: string;
+    force: boolean;
+    yes: boolean;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=close-noop.d.ts.map

package/dist/commands/task/close-noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-noop.d.ts","sourceRoot":"","sources":["../../../src/commands/task/close-noop.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsElB"}

package/dist/commands/task/close-noop.js

@@ -0,0 +1,77 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+import { ensureActionApproved } from "../shared/approval-requirements.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { appendTaskEvent, nowIso, requireStructuredComment } from "./shared.js";
+export async function cmdTaskCloseNoop(opts) {
+    try {
+        const ctx = opts.ctx ??
+            (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+        if (opts.force) {
+            await ensureActionApproved({
+                action: "force_action",
+                config: ctx.config,
+                yes: opts.yes,
+                reason: "task close-noop --force",
+            });
+        }
+        const useStore = backendIsLocalFileBackend(ctx);
+        const store = useStore ? getTaskStore(ctx) : null;
+        const task = useStore
+            ? await store.get(opts.taskId)
+            : await ctx.taskBackend.getTask(opts.taskId);
+        if (!task) {
+            throw new CliError({
+                exitCode: 4,
+                code: "E_IO",
+                message: `Task not found: ${opts.taskId}`,
+            });
+        }
+        if (!opts.force && String(task.status || "TODO").toUpperCase() === "DONE") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Task is already DONE: ${opts.taskId} (use --force to override)`,
+            });
+        }
+        const normalizedNote = opts.note?.trim();
+        const baseBody = "Verified: no implementation changes were required; closure is recorded as no-op bookkeeping.";
+        const body = normalizedNote ? `${baseBody}\n\nNote: ${normalizedNote}` : baseBody;
+        const verifiedCfg = ctx.config.tasks.comments.verified;
+        requireStructuredComment(body, verifiedCfg.prefix, verifiedCfg.min_chars);
+        const at = nowIso();
+        const next = {
+            ...task,
+            status: "DONE",
+            comments: [
+                ...(Array.isArray(task.comments) ? task.comments : []),
+                { author: opts.author, body },
+            ],
+            events: appendTaskEvent(task, {
+                type: "status",
+                at,
+                author: opts.author,
+                from: String(task.status || "TODO").toUpperCase(),
+                to: "DONE",
+                note: body,
+            }),
+            result_summary: "No-op closure recorded.",
+            risk_level: "low",
+            breaking: false,
+            doc_version: 2,
+            doc_updated_at: at,
+            doc_updated_by: opts.author,
+        };
+        await (useStore ? store.update(opts.taskId, () => next) : ctx.taskBackend.writeTask(next));
+        if (!opts.quiet) {
+            process.stdout.write(`task.done: ${opts.taskId} (no-op)\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task close-noop", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -24,6 +24,8 @@ export declare function cmdFinish(opts: {
     statusCommitAutoAllow: boolean;
     statusCommitRequireClean: boolean;
     confirmStatusCommit: boolean;
+    closeCommit?: boolean;
+    closeUnstageOthers?: boolean;
     quiet: boolean;
 }): Promise<number>;
 //# sourceMappingURL=finish.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAiCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,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,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,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,GAAG,OAAO,CAAC,MAAM,CAAC,CAiRlB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,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,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,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,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqUlB"}

package/dist/commands/task/finish.js

@@ -4,12 +4,12 @@ import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { readFile, rm } from "node:fs/promises";
 import path from "node:path";
-import { buildGitCommitEnv, commitFromComment } from "../guard/index.js";
+import { buildGitCommitEnv, cmdCommit, commitFromComment } from "../guard/index.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
 import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
 import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
-import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, ensureVerificationSatisfiedIfRequired, nowIso, readCommitInfo, readHeadCommit, requireStructuredComment, } from "./shared.js";
+import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, ensureVerificationSatisfiedIfRequired, nowIso, readCommitInfo, readHeadCommit, requireStructuredComment, resolvePrimaryTag, toStringArray, } from "./shared.js";
 async function clearDirectWorkLockIfMatches(opts) {
     const lockPath = path.join(opts.agentplaneDir, "cache", "direct-work.json");
     try {
@@ -40,23 +40,36 @@ export async function cmdFinish(opts) {
         }
         const { prefix, min_chars: minChars } = ctx.config.tasks.comments.verified;
         requireStructuredComment(opts.body, prefix, minChars);
-        if (opts.commitFromComment || opts.statusCommit) {
-            enforceStatusCommitPolicy({
-                policy: ctx.config.status_commit_policy,
-                action: "finish",
-                confirmed: opts.confirmStatusCommit,
-                quiet: opts.quiet,
+        const autoStatusCommit = (ctx.config.finish_auto_status_commit === true ||
+            ctx.config.commit_automation === "finish_only") &&
+            !opts.commitFromComment &&
+            !opts.statusCommit &&
+            opts.closeCommit !== true &&
+            opts.taskIds.length === 1;
+        const statusCommitRequested = opts.statusCommit || autoStatusCommit;
+        if ((opts.commitFromComment || statusCommitRequested) && opts.taskIds.length !== 1) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--commit-from-comment/--status-commit requires exactly one task id",
             });
         }
-        if ((opts.commitFromComment || opts.statusCommit) && opts.taskIds.length !== 1) {
+        if (opts.closeCommit && opts.taskIds.length !== 1) {
             throw new CliError({
                 exitCode: 2,
                 code: "E_USAGE",
-                message: "--commit-from-comment/--status-commit requires exactly one task id",
+                message: "--close-commit requires exactly one task id",
+            });
+        }
+        if (opts.closeCommit && (opts.commitFromComment || opts.statusCommit)) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--close-commit cannot be combined with --commit-from-comment/--status-commit",
             });
         }
         const primaryTaskId = opts.taskIds[0] ?? "";
-        if ((opts.commitFromComment || opts.statusCommit) && !primaryTaskId) {
+        if ((opts.commitFromComment || statusCommitRequested) && !primaryTaskId) {
             throw new CliError({
                 exitCode: 2,
                 code: "E_USAGE",
@@ -82,6 +95,7 @@ export async function cmdFinish(opts) {
         const riskLevel = opts.risk;
         const breaking = opts.breaking === true;
         let primaryStatusFrom = null;
+        let primaryTag = null;
         for (const taskId of opts.taskIds) {
             const task = useStore ? await store.get(taskId) : await loadTaskFromContext({ ctx, taskId });
             if (!opts.force) {
@@ -95,9 +109,10 @@ export async function cmdFinish(opts) {
                 }
             }
             if (taskId === primaryTaskId &&
-                (opts.commitFromComment || opts.statusCommit) &&
+                (opts.commitFromComment || statusCommitRequested) &&
                 primaryStatusFrom === null) {
                 primaryStatusFrom = String(task.status || "TODO").toUpperCase();
+                primaryTag = resolvePrimaryTag(toStringArray(task.tags), ctx).primary;
             }
             ensureVerificationSatisfiedIfRequired(task, ctx.config);
             if (taskId === metaTaskId) {
@@ -149,9 +164,19 @@ export async function cmdFinish(opts) {
                 ? store.update(taskId, () => nextTask)
                 : ctx.taskBackend.writeTask(nextTask));
         }
+        if (opts.commitFromComment || statusCommitRequested) {
+            enforceStatusCommitPolicy({
+                policy: ctx.config.status_commit_policy,
+                action: "finish",
+                confirmed: opts.confirmStatusCommit || autoStatusCommit,
+                quiet: opts.quiet,
+                statusFrom: primaryStatusFrom ?? "UNKNOWN",
+                statusTo: "DONE",
+            });
+        }
         // tasks.json is export-only; generated via `agentplane task export`.
         let executorAgent = null;
-        if (opts.commitFromComment || opts.statusCommit) {
+        if (opts.commitFromComment || statusCommitRequested) {
             const mode = ctx.config.workflow_mode;
             executorAgent = opts.author;
             if (mode === "direct") {
@@ -174,6 +199,7 @@ export async function cmdFinish(opts) {
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
+                primaryTag: primaryTag ?? "meta",
                 executorAgent: executorAgent ?? undefined,
                 author: opts.author,
                 statusFrom: primaryStatusFrom ?? undefined,
@@ -221,7 +247,7 @@ export async function cmdFinish(opts) {
                 await ctx.git.commitAmendNoEdit({ env });
             }
         }
-        if (opts.statusCommit) {
+        if (statusCommitRequested) {
             if (typeof opts.statusCommitEmoji === "string" && opts.statusCommitEmoji.trim() !== "✅") {
                 throw new CliError({
                     exitCode: 2,
@@ -234,6 +260,7 @@ export async function cmdFinish(opts) {
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
+                primaryTag: primaryTag ?? "meta",
                 executorAgent: executorAgent ?? undefined,
                 author: opts.author,
                 statusFrom: primaryStatusFrom ?? undefined,
@@ -249,6 +276,28 @@ export async function cmdFinish(opts) {
                 config: ctx.config,
             });
         }
+        if (opts.closeCommit && primaryTaskId) {
+            await cmdCommit({
+                ctx,
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: primaryTaskId,
+                message: "",
+                close: true,
+                allow: [],
+                autoAllow: false,
+                allowTasks: true,
+                allowBase: false,
+                allowPolicy: false,
+                allowConfig: false,
+                allowHooks: false,
+                allowCI: false,
+                requireClean: true,
+                quiet: opts.quiet,
+                closeUnstageOthers: opts.closeUnstageOthers === true,
+                closeCheckOnly: false,
+            });
+        }
         if (ctx.config.workflow_mode === "direct") {
             await clearDirectWorkLockIfMatches({
                 agentplaneDir: ctx.resolvedProject.agentplaneDir,

package/dist/commands/task/index.d.ts

@@ -15,6 +15,9 @@ export { cmdTaskComment } from "./comment.js";
 export { cmdTaskSetStatus } from "./set-status.js";
 export { cmdTaskShow } from "./show.js";
 export { cmdTaskDerive } from "./derive.js";
+export { cmdTaskCloseDuplicate } from "./close-duplicate.js";
+export { cmdTaskStartReady } from "./start-ready.js";
+export { cmdTaskCloseNoop } from "./close-noop.js";
 export { cmdTaskExport } from "./export.js";
 export { cmdTaskLint } from "./lint.js";
 export { cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject } from "./plan.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/task/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/task/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/task/index.js

@@ -14,6 +14,9 @@ export { cmdTaskComment } from "./comment.js";
 export { cmdTaskSetStatus } from "./set-status.js";
 export { cmdTaskShow } from "./show.js";
 export { cmdTaskDerive } from "./derive.js";
+export { cmdTaskCloseDuplicate } from "./close-duplicate.js";
+export { cmdTaskStartReady } from "./start-ready.js";
+export { cmdTaskCloseNoop } from "./close-noop.js";
 export { cmdTaskExport } from "./export.js";
 export { cmdTaskLint } from "./lint.js";
 export { cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject } from "./plan.js";

package/dist/commands/task/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGpF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DlB"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQpF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAyBF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsElB"}