agentplane 0.1.6 → 0.1.8

package/dist/commands/task/set-status.d.ts

@@ -0,0 +1,19 @@
+export declare function cmdTaskSetStatus(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    status: string;
+    author?: string;
+    body?: string;
+    commit?: string;
+    force: boolean;
+    commitFromComment: boolean;
+    commitEmoji?: string;
+    commitAllow: string[];
+    commitAutoAllow: boolean;
+    commitAllowTasks: boolean;
+    commitRequireClean: boolean;
+    confirmStatusCommit: boolean;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=set-status.d.ts.map

package/dist/commands/task/set-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-status.d.ts","sourceRoot":"","sources":["../../../src/commands/task/set-status.ts"],"names":[],"mappings":"AAmBA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8HlB"}

package/dist/commands/task/set-status.js

@@ -0,0 +1,123 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { successMessage, warnMessage } 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, resolveDocUpdatedBy } from "../shared/task-backend.js";
+import { buildDependencyState, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, isTransitionAllowed, normalizeTaskStatus, nowIso, readCommitInfo, } from "./shared.js";
+export async function cmdTaskSetStatus(opts) {
+    const nextStatus = normalizeTaskStatus(opts.status);
+    if (nextStatus === "DONE" && !opts.force) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Use `agentplane finish` to mark DONE (use --force to override)",
+        });
+    }
+    if ((opts.author && !opts.body) || (opts.body && !opts.author)) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "--author and --body must be provided together",
+        });
+    }
+    try {
+        const { backend, task, config, resolved } = await loadBackendTask({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            taskId: opts.taskId,
+        });
+        if (opts.commitFromComment) {
+            enforceStatusCommitPolicy({
+                policy: config.status_commit_policy,
+                action: "task set-status",
+                confirmed: opts.confirmStatusCommit,
+                quiet: opts.quiet,
+            });
+        }
+        const currentStatus = String(task.status || "TODO").toUpperCase();
+        if (!opts.force && !isTransitionAllowed(currentStatus, nextStatus)) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Refusing status transition ${currentStatus} -> ${nextStatus} (use --force to override)`,
+            });
+        }
+        if (!opts.force && (nextStatus === "DOING" || nextStatus === "DONE")) {
+            const allTasks = await backend.listTasks();
+            const depState = buildDependencyState(allTasks);
+            const dep = depState.get(task.id);
+            if (dep && (dep.missing.length > 0 || dep.incomplete.length > 0)) {
+                if (!opts.quiet) {
+                    if (dep.missing.length > 0) {
+                        process.stderr.write(`${warnMessage(`missing deps: ${dep.missing.join(", ")}`)}\n`);
+                    }
+                    if (dep.incomplete.length > 0) {
+                        process.stderr.write(`${warnMessage(`incomplete deps: ${dep.incomplete.join(", ")}`)}\n`);
+                    }
+                }
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Task is not ready: ${task.id} (use --force to override)`,
+                });
+            }
+        }
+        const existingComments = Array.isArray(task.comments)
+            ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
+            : [];
+        let comments = existingComments;
+        if (opts.author && opts.body) {
+            const commentBody = opts.commitFromComment
+                ? formatCommentBodyForCommit(opts.body, config)
+                : opts.body;
+            comments = [...existingComments, { author: opts.author, body: commentBody }];
+        }
+        const next = {
+            ...task,
+            status: nextStatus,
+            comments,
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: resolveDocUpdatedBy(task, opts.author),
+        };
+        if (opts.commit) {
+            const commitInfo = await readCommitInfo(resolved.gitRoot, opts.commit);
+            next.commit = { hash: commitInfo.hash, message: commitInfo.message };
+        }
+        await backend.writeTask(next);
+        // tasks.json is export-only; generated via `agentplane task export`.
+        if (opts.commitFromComment) {
+            if (!opts.body) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: "--body is required when using --commit-from-comment",
+                });
+            }
+            await commitFromComment({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                taskId: opts.taskId,
+                commentBody: opts.body,
+                formattedComment: formatCommentBodyForCommit(opts.body, config),
+                emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus(nextStatus),
+                allow: opts.commitAllow,
+                autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
+                allowTasks: opts.commitAllowTasks,
+                requireClean: opts.commitRequireClean,
+                quiet: opts.quiet,
+                config,
+            });
+        }
+        if (!opts.quiet) {
+            process.stdout.write(`${successMessage("status", opts.taskId, `next=${nextStatus}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task set-status", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,48 @@
+import { execFile } from "node:child_process";
+import { type AgentplaneConfig } from "@agentplaneorg/core";
+import { type TaskData } from "../../backends/task-backend.js";
+export declare const execFileAsync: typeof execFile.__promisify__;
+export declare function nowIso(): string;
+export declare function normalizeDependsOnInput(value: string): string[];
+export declare function normalizeTaskStatus(value: string): string;
+export declare function dedupeStrings(items: string[]): string[];
+export declare function toStringArray(value: unknown): string[];
+export declare function requiresVerify(tags: string[], requiredTags: string[]): boolean;
+export declare function ensurePlanApprovedIfRequired(task: TaskData, config: AgentplaneConfig): void;
+export declare function ensureVerificationSatisfiedIfRequired(task: TaskData, config: AgentplaneConfig): void;
+export type DependencyState = {
+    dependsOn: string[];
+    missing: string[];
+    incomplete: string[];
+};
+export declare function buildDependencyState(tasks: TaskData[]): Map<string, DependencyState>;
+export declare function formatTaskLine(task: TaskData, depState?: DependencyState): string;
+export declare function isTransitionAllowed(current: string, next: string): boolean;
+export declare function requireStructuredComment(body: string, prefix: string, minChars: number): void;
+export declare function readHeadCommit(cwd: string): Promise<{
+    hash: string;
+    message: string;
+}>;
+export declare function enforceStatusCommitPolicy(opts: {
+    policy: AgentplaneConfig["status_commit_policy"];
+    action: string;
+    confirmed: boolean;
+    quiet: boolean;
+}): void;
+export declare function readCommitInfo(cwd: string, rev: string): Promise<{
+    hash: string;
+    message: string;
+}>;
+export declare function defaultCommitEmojiForStatus(status: string): string;
+export type TaskListFilters = {
+    status: string[];
+    owner: string[];
+    tag: string[];
+    limit?: number;
+    quiet: boolean;
+};
+export declare function parseTaskListFilters(args: string[], opts?: {
+    allowLimit?: boolean;
+}): TaskListFilters;
+export declare function taskTextBlob(task: TaskData): string;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG/D,eAAO,MAAM,aAAa,+BAAsB,CAAC;AAEjD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/D;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAczD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAKtD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAI9E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc3F;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAiBN;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAqBpF;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,MAAM,CAgBjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAqBP;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,eAAe,CAsEjB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAiBnD"}

package/dist/commands/task/shared.js

@@ -0,0 +1,312 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { invalidValueForFlag, invalidValueMessage, missingValueMessage, warnMessage, } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+export const execFileAsync = promisify(execFile);
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function normalizeDependsOnInput(value) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed === "[]")
+        return [];
+    return [trimmed];
+}
+const ALLOWED_TASK_STATUSES = new Set(["TODO", "DOING", "DONE", "BLOCKED"]);
+export function normalizeTaskStatus(value) {
+    const normalized = value.trim().toUpperCase();
+    if (!ALLOWED_TASK_STATUSES.has(normalized)) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: invalidValueMessage("status", value, `one of ${[...ALLOWED_TASK_STATUSES].join(", ")}`),
+        });
+    }
+    return normalized;
+}
+export function dedupeStrings(items) {
+    const seen = new Set();
+    const out = [];
+    for (const item of items) {
+        const trimmed = item.trim();
+        if (!trimmed)
+            continue;
+        if (seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+export function toStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim());
+}
+export function requiresVerify(tags, requiredTags) {
+    const required = new Set(requiredTags.map((tag) => tag.trim().toLowerCase()).filter(Boolean));
+    if (required.size === 0)
+        return false;
+    return tags.some((tag) => required.has(tag.trim().toLowerCase()));
+}
+export function ensurePlanApprovedIfRequired(task, config) {
+    if (config.agents?.approvals?.require_plan !== true)
+        return;
+    const state = task.plan_approval?.state ?? "missing";
+    if (state === "approved")
+        return;
+    throw new CliError({
+        exitCode: 3,
+        code: "E_VALIDATION",
+        message: `${task.id}: plan approval is required before work can proceed ` +
+            `(plan_approval.state=${JSON.stringify(state)}; use \`agentplane task plan approve ${task.id} --by <USER>\` ` +
+            "or set agents.approvals.require_plan=false).",
+    });
+}
+export function ensureVerificationSatisfiedIfRequired(task, config) {
+    if (config.agents?.approvals?.require_verify !== true)
+        return;
+    const state = task.verification?.state ?? "missing";
+    if (state === "ok")
+        return;
+    const hint = `use \`agentplane verify ${task.id} --ok|--rework --by <ID> --note <TEXT>\` ` +
+        `or \`agentplane task verify ok|rework ${task.id} --by <ID> --note <TEXT>\``;
+    throw new CliError({
+        exitCode: 3,
+        code: "E_VALIDATION",
+        message: `${task.id}: verification result is required before integration/closure can proceed ` +
+            `(verification.state=${JSON.stringify(state)}; ${hint} or set agents.approvals.require_verify=false).`,
+    });
+}
+export function buildDependencyState(tasks) {
+    const byId = new Map(tasks.map((task) => [task.id, task]));
+    const state = new Map();
+    for (const task of tasks) {
+        const dependsOn = dedupeStrings(toStringArray(task.depends_on));
+        const missing = [];
+        const incomplete = [];
+        for (const depId of dependsOn) {
+            const dep = byId.get(depId);
+            if (!dep) {
+                missing.push(depId);
+                continue;
+            }
+            const status = String(dep.status || "TODO").toUpperCase();
+            if (status !== "DONE") {
+                incomplete.push(depId);
+            }
+        }
+        state.set(task.id, { dependsOn, missing, incomplete });
+    }
+    return state;
+}
+function formatDepsSummary(dep) {
+    if (!dep)
+        return null;
+    if (dep.dependsOn.length === 0)
+        return "deps=none";
+    if (dep.missing.length === 0 && dep.incomplete.length === 0)
+        return "deps=ready";
+    const parts = [];
+    if (dep.missing.length > 0) {
+        parts.push(`missing:${dep.missing.join(",")}`);
+    }
+    if (dep.incomplete.length > 0) {
+        parts.push(`wait:${dep.incomplete.join(",")}`);
+    }
+    return `deps=${parts.join(",")}`;
+}
+export function formatTaskLine(task, depState) {
+    const status = String(task.status || "TODO").toUpperCase();
+    const title = task.title?.trim() || "(untitled task)";
+    const extras = [];
+    if (task.owner?.trim())
+        extras.push(`owner=${task.owner.trim()}`);
+    if (task.priority !== undefined && String(task.priority).trim()) {
+        extras.push(`prio=${String(task.priority).trim()}`);
+    }
+    const depsSummary = formatDepsSummary(depState);
+    if (depsSummary)
+        extras.push(depsSummary);
+    const tags = dedupeStrings(toStringArray(task.tags));
+    if (tags.length > 0)
+        extras.push(`tags=${tags.join(",")}`);
+    const verify = dedupeStrings(toStringArray(task.verify));
+    if (verify.length > 0)
+        extras.push(`verify=${verify.length}`);
+    const suffix = extras.length > 0 ? ` (${extras.join(", ")})` : "";
+    return `${task.id} [${status}] ${title}${suffix}`;
+}
+export function isTransitionAllowed(current, next) {
+    if (current === next)
+        return true;
+    if (current === "TODO")
+        return next === "DOING" || next === "BLOCKED";
+    if (current === "DOING")
+        return next === "DONE" || next === "BLOCKED";
+    if (current === "BLOCKED")
+        return next === "TODO" || next === "DOING";
+    if (current === "DONE")
+        return false;
+    return false;
+}
+export function requireStructuredComment(body, prefix, minChars) {
+    const normalized = body.trim();
+    if (!normalized.toLowerCase().startsWith(prefix.toLowerCase())) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Comment body must start with ${prefix}`,
+        });
+    }
+    if (normalized.length < minChars) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Comment body must be at least ${minChars} characters`,
+        });
+    }
+}
+export async function readHeadCommit(cwd) {
+    const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H:%s"], { cwd });
+    const trimmed = stdout.trim();
+    const [hash, message] = trimmed.split(":", 2);
+    if (!hash || !message) {
+        throw new Error("Unable to read git HEAD commit");
+    }
+    return { hash, message };
+}
+export function enforceStatusCommitPolicy(opts) {
+    if (opts.policy === "off")
+        return;
+    if (opts.policy === "warn") {
+        if (!opts.quiet && !opts.confirmed) {
+            process.stderr.write(`${warnMessage(`${opts.action}: status/comment-driven commit requested; policy=warn (pass --confirm-status-commit to acknowledge)`)}\n`);
+        }
+        return;
+    }
+    if (opts.policy === "confirm" && !opts.confirmed) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `${opts.action}: status/comment-driven commit blocked by status_commit_policy='confirm' ` +
+                "(pass --confirm-status-commit to proceed)",
+        });
+    }
+}
+export async function readCommitInfo(cwd, rev) {
+    const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H:%s", rev], { cwd });
+    const trimmed = stdout.trim();
+    const [hash, message] = trimmed.split(":", 2);
+    if (!hash || !message) {
+        throw new Error("Unable to read git commit");
+    }
+    return { hash, message };
+}
+export function defaultCommitEmojiForStatus(status) {
+    const normalized = status.trim().toUpperCase();
+    if (normalized === "DOING")
+        return "🚧";
+    if (normalized === "DONE")
+        return "✅";
+    if (normalized === "BLOCKED")
+        return "⛔";
+    return "🧩";
+}
+export function parseTaskListFilters(args, opts) {
+    const out = { status: [], owner: [], tag: [], 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 === "--status") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: missingValueMessage("--status"),
+                });
+            }
+            out.status.push(next);
+            i++;
+            continue;
+        }
+        if (arg === "--owner") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: missingValueMessage("--owner"),
+                });
+            }
+            out.owner.push(next);
+            i++;
+            continue;
+        }
+        if (arg === "--tag") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage("--tag") });
+            }
+            out.tag.push(next);
+            i++;
+            continue;
+        }
+        if (opts?.allowLimit && arg === "--limit") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: missingValueMessage("--limit"),
+                });
+            }
+            const parsed = Number.parseInt(next, 10);
+            if (!Number.isFinite(parsed)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueForFlag("--limit", next, "integer"),
+                });
+            }
+            out.limit = parsed;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+        }
+    }
+    return out;
+}
+export function taskTextBlob(task) {
+    const parts = [];
+    for (const key of ["id", "title", "description", "status", "priority", "owner"]) {
+        const value = task[key];
+        if (typeof value === "string" && value.trim())
+            parts.push(value.trim());
+    }
+    const tags = toStringArray(task.tags);
+    parts.push(...tags.filter(Boolean));
+    const comments = Array.isArray(task.comments) ? task.comments : [];
+    for (const comment of comments) {
+        if (comment && typeof comment.author === "string")
+            parts.push(comment.author);
+        if (comment && typeof comment.body === "string")
+            parts.push(comment.body);
+    }
+    const commit = task.commit ?? null;
+    if (commit && typeof commit.hash === "string")
+        parts.push(commit.hash);
+    if (commit && typeof commit.message === "string")
+        parts.push(commit.message);
+    return parts.join("\n");
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.ts"],"names":[],"mappings":"AAOA,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}

package/dist/commands/task/show.js

@@ -0,0 +1,35 @@
+import { validateTaskDocMetadata } from "@agentplaneorg/core";
+import { mapBackendError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+import { loadBackendTask, taskDataToFrontmatter } from "../shared/task-backend.js";
+export async function cmdTaskShow(opts) {
+    try {
+        const { task, backendId } = await loadBackendTask({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        const frontmatter = taskDataToFrontmatter(task);
+        if (backendId === "local") {
+            const metadataErrors = validateTaskDocMetadata(frontmatter);
+            if (metadataErrors.length > 0) {
+                throw new CliError({
+                    exitCode: 3,
+                    code: "E_VALIDATION",
+                    message: `Invalid task README metadata: ${metadataErrors.join("; ")}`,
+                });
+            }
+        }
+        process.stdout.write(`${JSON.stringify(frontmatter, null, 2)}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task show",
+            root: opts.rootOverride ?? null,
+            taskId: opts.taskId,
+        });
+    }
+}

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

@@ -0,0 +1,19 @@
+export declare const START_USAGE = "Usage: agentplane start <task-id> --author <id> --body <text> [flags]";
+export declare const START_USAGE_EXAMPLE = "agentplane start 202602030608-F1Q8AB --author CODER --body \"Start: ...\"";
+export declare function cmdStart(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=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,0EAA0E,CAAC;AACnG,eAAO,MAAM,mBAAmB,8EAC2C,CAAC;AAE5E,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,CAkHlB"}