agentplane 0.1.5 → 0.1.7

package/dist/commands/task/add.js

@@ -0,0 +1,164 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { missingValueMessage, usageMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { dedupeStrings, normalizeDependsOnInput, normalizeTaskStatus, nowIso, requiresVerify, } from "./shared.js";
+export const TASK_ADD_USAGE = "Usage: agentplane task add <task-id> [<task-id> ...] --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
+export const TASK_ADD_USAGE_EXAMPLE = 'agentplane task add 202602030608-F1Q8AB --title "..." --description "..." --priority med --owner CODER --tag cli';
+function parseTaskAddFlags(args) {
+    const out = {
+        taskIds: [],
+        title: "",
+        description: "",
+        status: "TODO",
+        priority: "",
+        owner: "",
+        tags: [],
+        dependsOn: [],
+        verify: [],
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (!arg.startsWith("--")) {
+            out.taskIds.push(arg);
+            continue;
+        }
+        const next = args[i + 1];
+        if (arg === "--replace-tags" || arg === "--replace-depends-on" || arg === "--replace-verify") {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: usageMessage(TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE),
+            });
+        }
+        if (!next) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
+        }
+        switch (arg) {
+            case "--title": {
+                out.title = next;
+                break;
+            }
+            case "--description": {
+                out.description = next;
+                break;
+            }
+            case "--status": {
+                out.status = next;
+                break;
+            }
+            case "--priority": {
+                out.priority = next;
+                break;
+            }
+            case "--owner": {
+                out.owner = next;
+                break;
+            }
+            case "--tag": {
+                out.tags.push(next);
+                break;
+            }
+            case "--depends-on": {
+                out.dependsOn.push(...normalizeDependsOnInput(next));
+                break;
+            }
+            case "--verify": {
+                out.verify.push(next);
+                break;
+            }
+            case "--comment-author": {
+                out.commentAuthor = next;
+                break;
+            }
+            case "--comment-body": {
+                out.commentBody = next;
+                break;
+            }
+            default: {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+            }
+        }
+        i++;
+    }
+    return out;
+}
+export async function cmdTaskAdd(opts) {
+    const flags = parseTaskAddFlags(opts.args);
+    if (flags.taskIds.length === 0 ||
+        !flags.title ||
+        !flags.description ||
+        !flags.priority ||
+        !flags.owner ||
+        flags.tags.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE),
+        });
+    }
+    try {
+        const { backend, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const status = normalizeTaskStatus(flags.status);
+        const existing = await backend.listTasks();
+        const existingIds = new Set(existing.map((task) => task.id));
+        for (const taskId of flags.taskIds) {
+            if (existingIds.has(taskId)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Task already exists: ${taskId}`,
+                });
+            }
+        }
+        const tags = dedupeStrings(flags.tags);
+        const dependsOn = dedupeStrings(flags.dependsOn);
+        const verify = dedupeStrings(flags.verify);
+        const docUpdatedBy = (flags.commentAuthor ?? "").trim() || flags.owner;
+        if (requiresVerify(tags, config.tasks.verify.required_tags) && verify.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "verify commands are required for tasks with code/backend/frontend tags",
+            });
+        }
+        const tasks = flags.taskIds.map((taskId) => ({
+            id: taskId,
+            title: flags.title,
+            description: flags.description,
+            status,
+            priority: flags.priority,
+            owner: flags.owner,
+            tags,
+            depends_on: dependsOn,
+            verify,
+            comments: flags.commentAuthor && flags.commentBody
+                ? [{ author: flags.commentAuthor, body: flags.commentBody }]
+                : [],
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: docUpdatedBy,
+            id_source: "explicit",
+        }));
+        if (backend.writeTasks) {
+            await backend.writeTasks(tasks);
+        }
+        else {
+            for (const task of tasks) {
+                await backend.writeTask(task);
+            }
+        }
+        for (const task of tasks) {
+            process.stdout.write(`${task.id}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task add", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,19 @@
+export declare const BLOCK_USAGE = "Usage: agentplane block <task-id> --author <id> --body <text> [flags]";
+export declare const BLOCK_USAGE_EXAMPLE = "agentplane block 202602030608-F1Q8AB --author CODER --body \"Blocked: ...\"";
+export declare function cmdBlock(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author: string;
+    body: string;
+    commitFromComment: boolean;
+    commitEmoji?: string;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    force: boolean;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,WAAW,0EAA0E,CAAC;AACnG,eAAO,MAAM,mBAAmB,gFAC6C,CAAC;AAE9E,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqFlB"}

package/dist/commands/task/block.js

@@ -0,0 +1,86 @@
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { mapBackendError } from "../../cli/error-map.js";
+import { successMessage } from "../../cli/output.js";
+import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
+import { CliError } from "../../shared/errors.js";
+import { commitFromComment } from "../guard/index.js";
+import { loadBackendTask } from "../shared/task-backend.js";
+import { defaultCommitEmojiForStatus, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
+export const BLOCK_USAGE = "Usage: agentplane block <task-id> --author <id> --body <text> [flags]";
+export const BLOCK_USAGE_EXAMPLE = 'agentplane block 202602030608-F1Q8AB --author CODER --body "Blocked: ..."';
+export async function cmdBlock(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        if (opts.commitFromComment) {
+            enforceStatusCommitPolicy({
+                policy: loaded.config.status_commit_policy,
+                action: "block",
+                confirmed: opts.confirmStatusCommit,
+                quiet: opts.quiet,
+            });
+        }
+        const { prefix, min_chars: minChars } = loaded.config.tasks.comments.blocked;
+        requireStructuredComment(opts.body, prefix, minChars);
+        const { backend, task } = await loadBackendTask({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        const currentStatus = String(task.status || "TODO").toUpperCase();
+        if (!opts.force && !isTransitionAllowed(currentStatus, "BLOCKED")) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Refusing status transition ${currentStatus} -> BLOCKED (use --force to override)`,
+            });
+        }
+        const formattedComment = opts.commitFromComment
+            ? formatCommentBodyForCommit(opts.body, loaded.config)
+            : null;
+        const commentBody = formattedComment ?? opts.body;
+        const existingComments = Array.isArray(task.comments)
+            ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+            : [];
+        const commentsValue = [...existingComments, { author: opts.author, body: commentBody }];
+        const nextTask = {
+            ...task,
+            status: "BLOCKED",
+            comments: commentsValue,
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: opts.author,
+        };
+        await backend.writeTask(nextTask);
+        let commitInfo = null;
+        if (opts.commitFromComment) {
+            commitInfo = await commitFromComment({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: opts.taskId,
+                commentBody: opts.body,
+                formattedComment,
+                emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus("BLOCKED"),
+                allow: opts.commitAllow,
+                autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
+                allowTasks: opts.commitAllowTasks,
+                requireClean: opts.commitRequireClean,
+                quiet: opts.quiet,
+                config: loaded.config,
+            });
+        }
+        if (!opts.quiet) {
+            const suffix = commitInfo ? ` (commit=${commitInfo.hash.slice(0, 12)})` : "";
+            process.stdout.write(`${successMessage("blocked", `${opts.taskId}${suffix}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "block", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+export declare function cmdTaskComment(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    author: string;
+    body: string;
+}): Promise<number>;
+//# sourceMappingURL=comment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../src/commands/task/comment.ts"],"names":[],"mappings":"AAOA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlB"}

package/dist/commands/task/comment.js

@@ -0,0 +1,29 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { successMessage } from "../../cli/output.js";
+import { loadBackendTask } from "../shared/task-backend.js";
+import { nowIso } from "./shared.js";
+export async function cmdTaskComment(opts) {
+    try {
+        const { backend, task } = await loadBackendTask({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            taskId: opts.taskId,
+        });
+        const existing = Array.isArray(task.comments)
+            ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+            : [];
+        const next = {
+            ...task,
+            comments: [...existing, { author: opts.author, body: opts.body }],
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: opts.author,
+        };
+        await backend.writeTask(next);
+        process.stdout.write(`${successMessage("commented", opts.taskId)}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task comment", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,17 @@
+export declare const TASK_DOC_SET_USAGE = "Usage: agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)";
+export declare const TASK_DOC_SET_USAGE_EXAMPLE = "agentplane task doc set 202602030608-F1Q8AB --section Summary --text \"...\"";
+export declare const TASK_DOC_SHOW_USAGE = "Usage: agentplane task doc show <task-id> [--section <name>] [--quiet]";
+export declare const TASK_DOC_SHOW_USAGE_EXAMPLE = "agentplane task doc show 202602030608-F1Q8AB --section Summary";
+export declare function cmdTaskDocSet(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    args: string[];
+}): Promise<number>;
+export declare function cmdTaskDocShow(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=doc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/doc.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,kBAAkB,8FAC8D,CAAC;AAC9F,eAAO,MAAM,0BAA0B,iFACuC,CAAC;AAC/E,eAAO,MAAM,mBAAmB,2EAC0C,CAAC;AAC3E,eAAO,MAAM,2BAA2B,mEAC0B,CAAC;AAgFnE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoGlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}

package/dist/commands/task/doc.js

@@ -0,0 +1,220 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDocSections, normalizeDocSectionName, parseDocSections, setMarkdownSection, } from "@agentplaneorg/core";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
+import { infoMessage, missingValueMessage, unknownEntityMessage, usageMessage, backendNotSupportedMessage, } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+export const TASK_DOC_SET_USAGE = "Usage: agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)";
+export const TASK_DOC_SET_USAGE_EXAMPLE = 'agentplane task doc set 202602030608-F1Q8AB --section Summary --text "..."';
+export const TASK_DOC_SHOW_USAGE = "Usage: agentplane task doc show <task-id> [--section <name>] [--quiet]";
+export const TASK_DOC_SHOW_USAGE_EXAMPLE = "agentplane task doc show 202602030608-F1Q8AB --section Summary";
+function parseTaskDocShowFlags(args) {
+    const out = { quiet: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === "--quiet") {
+            out.quiet = true;
+            continue;
+        }
+        if (arg === "--section") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
+            }
+            out.section = next;
+            i++;
+            continue;
+        }
+        throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+    }
+    return out;
+}
+function parseTaskDocSetFlags(args) {
+    const out = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (!arg.startsWith("--")) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unexpected argument: ${arg}` });
+        }
+        const next = args[i + 1];
+        if (!next) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
+        }
+        switch (arg) {
+            case "--section": {
+                out.section = next;
+                break;
+            }
+            case "--text": {
+                out.text = next;
+                break;
+            }
+            case "--file": {
+                out.file = next;
+                break;
+            }
+            case "--updated-by": {
+                out.updatedBy = next;
+                break;
+            }
+            default: {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+            }
+        }
+        i++;
+    }
+    return out;
+}
+export async function cmdTaskDocSet(opts) {
+    const flags = parseTaskDocSetFlags(opts.args);
+    if (!flags.section) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
+        });
+    }
+    const hasText = flags.text !== undefined;
+    const hasFile = flags.file !== undefined;
+    if (hasText === hasFile) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE),
+        });
+    }
+    let updatedBy;
+    if (flags.updatedBy !== undefined) {
+        const trimmed = flags.updatedBy.trim();
+        if (trimmed.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "--updated-by must be non-empty",
+            });
+        }
+        updatedBy = trimmed;
+    }
+    let text = flags.text ?? "";
+    if (hasFile) {
+        try {
+            text = await readFile(path.resolve(opts.cwd, flags.file ?? ""), "utf8");
+        }
+        catch (err) {
+            throw mapCoreError(err, { command: "task doc set", filePath: flags.file ?? "" });
+        }
+    }
+    try {
+        const { backend, resolved, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        if (!backend.getTaskDoc || !backend.setTaskDoc) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("task docs"),
+            });
+        }
+        const allowed = config.tasks.doc.sections;
+        if (!allowed.includes(flags.section)) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("doc section", flags.section),
+            });
+        }
+        const normalizedAllowed = new Set(allowed.map((section) => normalizeDocSectionName(section)));
+        const targetKey = normalizeDocSectionName(flags.section);
+        const headingKeys = new Set();
+        for (const line of text.replaceAll("\r\n", "\n").split("\n")) {
+            const match = /^##\s+(.*)$/.exec(line.trim());
+            if (!match)
+                continue;
+            const key = normalizeDocSectionName(match[1] ?? "");
+            if (key && normalizedAllowed.has(key))
+                headingKeys.add(key);
+        }
+        const existing = await backend.getTaskDoc(opts.taskId);
+        const baseDoc = ensureDocSections(existing ?? "", config.tasks.doc.required_sections);
+        if (headingKeys.size > 0 && (headingKeys.size > 1 || !headingKeys.has(targetKey))) {
+            const fullDoc = ensureDocSections(text, config.tasks.doc.required_sections);
+            await backend.setTaskDoc(opts.taskId, fullDoc, updatedBy);
+        }
+        else {
+            let nextText = text;
+            if (headingKeys.size > 0 && headingKeys.has(targetKey)) {
+                const lines = nextText.replaceAll("\r\n", "\n").split("\n");
+                let firstContent = 0;
+                while (firstContent < lines.length && lines[firstContent]?.trim() === "")
+                    firstContent++;
+                if ((lines[firstContent]?.trim() ?? "") === `## ${flags.section}`) {
+                    lines.splice(firstContent, 1);
+                    if (lines[firstContent]?.trim() === "")
+                        lines.splice(firstContent, 1);
+                    nextText = lines.join("\n");
+                }
+            }
+            const nextDoc = setMarkdownSection(baseDoc, flags.section, nextText);
+            const normalized = ensureDocSections(nextDoc, config.tasks.doc.required_sections);
+            await backend.setTaskDoc(opts.taskId, normalized, updatedBy);
+        }
+        const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
+        process.stdout.write(`${path.join(tasksDir, opts.taskId, "README.md")}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task doc set", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdTaskDocShow(opts) {
+    const flags = parseTaskDocShowFlags(opts.args);
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        if (!backend.getTaskDoc) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("task docs"),
+            });
+        }
+        const doc = (await backend.getTaskDoc(opts.taskId)) ?? "";
+        if (flags.section) {
+            const sectionKey = normalizeDocSectionName(flags.section);
+            const { sections } = parseDocSections(doc);
+            const entry = sections.get(sectionKey);
+            const content = entry?.lines ?? [];
+            if (content.length > 0) {
+                process.stdout.write(`${content.join("\n").trimEnd()}\n`);
+                return 0;
+            }
+            if (!flags.quiet) {
+                process.stdout.write(`${infoMessage(`section has no content: ${flags.section}`)}\n`);
+            }
+            return 0;
+        }
+        if (doc.trim()) {
+            process.stdout.write(`${doc.trimEnd()}\n`);
+            return 0;
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${infoMessage("task doc metadata missing")}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task doc show", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAOA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjG"}

package/dist/commands/task/export.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { backendNotSupportedMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+export async function cmdTaskExport(opts) {
+    try {
+        const { backend, resolved, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const outPath = path.join(resolved.gitRoot, config.paths.tasks_path);
+        if (!backend.exportTasksJson) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: backendNotSupportedMessage("exportTasksJson()"),
+            });
+        }
+        await backend.exportTasksJson(outPath);
+        process.stdout.write(`${path.relative(resolved.gitRoot, outPath)}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task export", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,27 @@
+export declare const FINISH_USAGE = "Usage: agentplane finish <task-id> [<task-id>...] --author <id> --body <text> [flags]";
+export declare const FINISH_USAGE_EXAMPLE = "agentplane finish 202602030608-F1Q8AB --author INTEGRATOR --body \"Verified: ...\"";
+export declare function cmdFinish(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskIds: string[];
+    author: string;
+    body: string;
+    commit?: string;
+    skipVerify: boolean;
+    force: boolean;
+    noRequireTaskIdInCommit: 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;
+}): Promise<number>;
+//# sourceMappingURL=finish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,YAAY,0FACgE,CAAC;AAC1F,eAAO,MAAM,oBAAoB,uFACmD,CAAC;AAErF,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,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,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,uBAAuB,EAAE,OAAO,CAAC;IACjC,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,CAkIlB"}