agentplane 0.1.6 → 0.1.8

package/dist/commands/shared/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/path.ts"],"names":[],"mappings":"AAGA,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvE"}

package/dist/commands/shared/path.js

@@ -0,0 +1,14 @@
+import { realpath } from "node:fs/promises";
+import path from "node:path";
+export async function resolvePathFallback(filePath) {
+    try {
+        return await realpath(filePath);
+    }
+    catch {
+        return path.resolve(filePath);
+    }
+}
+export function isPathWithin(parent, candidate) {
+    const rel = path.relative(parent, candidate);
+    return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+}

package/dist/commands/shared/pr-meta.d.ts

@@ -0,0 +1,21 @@
+export type PrMeta = {
+    schema_version: 1;
+    task_id: string;
+    branch?: string;
+    created_at: string;
+    updated_at: string;
+    last_verified_sha: string | null;
+    last_verified_at: string | null;
+    verify?: {
+        status?: "pass" | "fail" | "skipped";
+        command?: string;
+    };
+};
+export declare function parsePrMeta(raw: string, taskId: string): PrMeta;
+export declare function extractLastVerifiedSha(logText: string): string | null;
+export declare function appendVerifyLog(logPath: string, header: string, content: string): Promise<void>;
+export declare function runShellCommand(command: string, cwd: string): Promise<{
+    code: number;
+    output: string;
+}>;
+//# sourceMappingURL=pr-meta.d.ts.map

package/dist/commands/shared/pr-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,MAAM,GAAG;IACnB,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,CAAC;AAEF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAoBD"}

package/dist/commands/shared/pr-meta.js

@@ -0,0 +1,72 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { execFileAsync } from "./git.js";
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isIsoDate(value) {
+    return typeof value === "string" && !Number.isNaN(Date.parse(value));
+}
+export function parsePrMeta(raw, taskId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`JSON Parse error: ${message}`);
+    }
+    if (!isRecord(parsed))
+        throw new Error("pr/meta.json must be an object");
+    if (parsed.schema_version !== 1)
+        throw new Error("pr/meta.json schema_version must be 1");
+    if (parsed.task_id !== taskId)
+        throw new Error("pr/meta.json task_id mismatch");
+    if (!isIsoDate(parsed.created_at))
+        throw new Error("pr/meta.json created_at must be ISO");
+    if (!isIsoDate(parsed.updated_at))
+        throw new Error("pr/meta.json updated_at must be ISO");
+    return parsed;
+}
+export function extractLastVerifiedSha(logText) {
+    const regex = /verified_sha=([0-9a-f]{7,40})/gi;
+    let match = null;
+    let last = null;
+    while ((match = regex.exec(logText))) {
+        last = match[1] ?? null;
+    }
+    return last;
+}
+export async function appendVerifyLog(logPath, header, content) {
+    await mkdir(path.dirname(logPath), { recursive: true });
+    const lines = [header.trimEnd()];
+    if (content)
+        lines.push(content.trimEnd());
+    lines.push("");
+    await writeFile(logPath, `${lines.join("\n")}\n`, { flag: "a" });
+}
+export async function runShellCommand(command, cwd) {
+    try {
+        const { stdout, stderr } = await execFileAsync("sh", ["-lc", command], {
+            cwd,
+            env: process.env,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        let output = "";
+        if (stdout)
+            output += stdout;
+        if (stderr)
+            output += (output && !output.endsWith("\n") ? "\n" : "") + stderr;
+        return { code: 0, output };
+    }
+    catch (err) {
+        const error = err;
+        let output = "";
+        if (error.stdout)
+            output += String(error.stdout);
+        if (error.stderr)
+            output += (output && !output.endsWith("\n") ? "\n" : "") + String(error.stderr);
+        const code = typeof error.code === "number" ? error.code : 1;
+        return { code, output };
+    }
+}

package/dist/commands/shared/task-backend.d.ts

@@ -0,0 +1,15 @@
+import { loadTaskBackend, type TaskData } from "../../backends/task-backend.js";
+export declare function resolveDocUpdatedBy(task: TaskData, author?: string): string;
+export declare function taskDataToFrontmatter(task: TaskData): Record<string, unknown>;
+export declare function loadBackendTask(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    taskId: string;
+}): Promise<{
+    backend: Awaited<ReturnType<typeof loadTaskBackend>>["backend"];
+    backendId: string;
+    resolved: Awaited<ReturnType<typeof loadTaskBackend>>["resolved"];
+    config: Awaited<ReturnType<typeof loadTaskBackend>>["config"];
+    task: TaskData;
+}>;
+//# sourceMappingURL=task-backend.d.ts.map

package/dist/commands/shared/task-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAShF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyB7E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAgBD"}

package/dist/commands/shared/task-backend.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { CliError } from "../../shared/errors.js";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+function normalizeDocUpdatedBy(value) {
+    const trimmed = value?.trim() ?? "";
+    if (!trimmed)
+        return "";
+    if (trimmed.toLowerCase() === "agentplane")
+        return "";
+    return trimmed;
+}
+export function resolveDocUpdatedBy(task, author) {
+    const fromAuthor = normalizeDocUpdatedBy(author);
+    if (fromAuthor)
+        return fromAuthor;
+    const fromTask = normalizeDocUpdatedBy(typeof task.doc_updated_by === "string" ? task.doc_updated_by : undefined);
+    if (fromTask)
+        return fromTask;
+    return normalizeDocUpdatedBy(typeof task.owner === "string" ? task.owner : undefined);
+}
+export function taskDataToFrontmatter(task) {
+    const planApproval = task.plan_approval ??
+        { state: "pending", updated_at: null, updated_by: null, note: null };
+    const verification = task.verification ??
+        { state: "pending", updated_at: null, updated_by: null, note: null };
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        priority: task.priority,
+        owner: task.owner,
+        depends_on: task.depends_on ?? [],
+        tags: task.tags ?? [],
+        verify: task.verify ?? [],
+        plan_approval: planApproval,
+        verification,
+        commit: task.commit ?? null,
+        comments: task.comments ?? [],
+        doc_version: task.doc_version,
+        doc_updated_at: task.doc_updated_at,
+        doc_updated_by: task.doc_updated_by,
+        description: task.description ?? "",
+    };
+}
+export async function loadBackendTask(opts) {
+    const { backend, backendId, resolved, config } = await loadTaskBackend({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const task = await backend.getTask(opts.taskId);
+    if (!task) {
+        const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
+        const readmePath = path.join(tasksDir, opts.taskId, "README.md");
+        throw new CliError({
+            exitCode: 4,
+            code: "E_IO",
+            message: `ENOENT: no such file or directory, open '${readmePath}'`,
+        });
+    }
+    return { backend, backendId, resolved, config, task };
+}

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

@@ -0,0 +1,8 @@
+export declare 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 declare const TASK_ADD_USAGE_EXAMPLE = "agentplane task add 202602030608-F1Q8AB --title \"...\" --description \"...\" --priority med --owner CODER --tag cli";
+export declare function cmdTaskAdd(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/task/add.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc,wKAC4I,CAAC;AACxK,eAAO,MAAM,sBAAsB,yHACiF,CAAC;AAgGrH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlB"}

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"}