agentplane 0.1.5 → 0.1.7

package/dist/commands/task/ready.js

@@ -0,0 +1,57 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { successMessage, unknownEntityMessage, warnMessage } from "../../cli/output.js";
+import { buildDependencyState } from "./shared.js";
+export async function cmdReady(opts) {
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        const depState = buildDependencyState(tasks);
+        const task = tasks.find((item) => item.id === opts.taskId);
+        const warnings = [];
+        if (task) {
+            const dep = depState.get(task.id);
+            const missing = dep?.missing ?? [];
+            const incomplete = dep?.incomplete ?? [];
+            if (missing.length > 0) {
+                warnings.push(`${task.id}: missing deps: ${missing.join(", ")}`);
+            }
+            if (incomplete.length > 0) {
+                warnings.push(`${task.id}: incomplete deps: ${incomplete.join(", ")}`);
+            }
+        }
+        else {
+            warnings.push(unknownEntityMessage("task id", opts.taskId));
+        }
+        for (const warning of warnings) {
+            process.stdout.write(`${warnMessage(warning)}\n`);
+        }
+        if (task) {
+            const status = String(task.status || "TODO").toUpperCase();
+            const title = task.title?.trim() || "(untitled task)";
+            const owner = task.owner?.trim() || "-";
+            const dep = depState.get(task.id);
+            const dependsOn = dep?.dependsOn ?? [];
+            process.stdout.write(`Task: ${task.id} [${status}] ${title}\n`);
+            process.stdout.write(`Owner: ${owner}\n`);
+            process.stdout.write(`Depends on: ${dependsOn.length > 0 ? dependsOn.join(", ") : "-"}\n`);
+            const missing = dep?.missing ?? [];
+            const incomplete = dep?.incomplete ?? [];
+            if (missing.length > 0) {
+                process.stdout.write(`${warnMessage(`missing deps: ${missing.join(", ")}`)}\n`);
+            }
+            if (incomplete.length > 0) {
+                process.stdout.write(`${warnMessage(`incomplete deps: ${incomplete.join(", ")}`)}\n`);
+            }
+        }
+        const ready = warnings.length === 0;
+        process.stdout.write(`${ready ? successMessage("ready") : warnMessage("not ready")}` + "\n");
+        return ready ? 0 : 2;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "ready", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+export declare const TASK_SCAFFOLD_USAGE = "Usage: agentplane task scaffold <task-id> [--title <text>] [--overwrite] [--force]";
+export declare const TASK_SCAFFOLD_USAGE_EXAMPLE = "agentplane task scaffold 202602030608-F1Q8AB";
+export declare function cmdTaskScaffold(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scaffold.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,mBAAmB,uFACsD,CAAC;AACvF,eAAO,MAAM,2BAA2B,iDAAiD,CAAC;AAyD1F,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ElB"}

package/dist/commands/task/scaffold.js

@@ -0,0 +1,131 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDocSections, renderTaskReadme, taskReadmePath } from "@agentplaneorg/core";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { missingValueMessage, successMessage, unknownEntityMessage, usageMessage, } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { taskDataToFrontmatter } from "../shared/task-backend.js";
+import { nowIso } from "./shared.js";
+export const TASK_SCAFFOLD_USAGE = "Usage: agentplane task scaffold <task-id> [--title <text>] [--overwrite] [--force]";
+export const TASK_SCAFFOLD_USAGE_EXAMPLE = "agentplane task scaffold 202602030608-F1Q8AB";
+function parseTaskScaffoldFlags(args) {
+    const [taskId, ...rest] = args;
+    if (!taskId) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_SCAFFOLD_USAGE, TASK_SCAFFOLD_USAGE_EXAMPLE),
+        });
+    }
+    const out = { taskId, overwrite: false, force: false, quiet: false };
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (!arg)
+            continue;
+        if (arg === "--overwrite") {
+            out.overwrite = true;
+            continue;
+        }
+        if (arg === "--force") {
+            out.force = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            out.quiet = true;
+            continue;
+        }
+        if (arg === "--title") {
+            const next = rest[i + 1];
+            if (!next) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: missingValueMessage("--title"),
+                });
+            }
+            out.title = next;
+            i++;
+            continue;
+        }
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: `Unknown flag: ${arg}`,
+        });
+    }
+    return out;
+}
+export async function cmdTaskScaffold(opts) {
+    const flags = parseTaskScaffoldFlags(opts.args);
+    try {
+        const { backend, resolved, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const task = await backend.getTask(flags.taskId);
+        if (!task && !flags.force) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("task id", flags.taskId),
+            });
+        }
+        const readmePath = taskReadmePath(path.join(resolved.gitRoot, config.paths.workflow_dir), flags.taskId);
+        try {
+            await readFile(readmePath, "utf8");
+            if (!flags.overwrite) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `File already exists: ${readmePath}`,
+                });
+            }
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code !== "ENOENT") {
+                if (err instanceof CliError)
+                    throw err;
+                throw err;
+            }
+        }
+        const baseTask = task ??
+            {
+                id: flags.taskId,
+                title: flags.title ?? "",
+                description: "",
+                status: "TODO",
+                priority: "med",
+                owner: "",
+                depends_on: [],
+                tags: [],
+                verify: [],
+                comments: [],
+                doc_version: 2,
+                doc_updated_at: nowIso(),
+                doc_updated_by: "UNKNOWN",
+            };
+        if (flags.title)
+            baseTask.title = flags.title;
+        if (typeof baseTask.doc_updated_by !== "string" ||
+            baseTask.doc_updated_by.trim().length === 0 ||
+            baseTask.doc_updated_by.trim().toLowerCase() === "agentplane") {
+            baseTask.doc_updated_by = baseTask.owner?.trim() ? baseTask.owner : "UNKNOWN";
+        }
+        const frontmatter = taskDataToFrontmatter(baseTask);
+        const body = ensureDocSections("", config.tasks.doc.required_sections);
+        const text = renderTaskReadme(frontmatter, body);
+        await mkdir(path.dirname(readmePath), { recursive: true });
+        await writeFile(readmePath, text.endsWith("\n") ? text : `${text}\n`, "utf8");
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("wrote", path.relative(resolved.gitRoot, readmePath))}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task scaffold", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+export declare const TASK_SCRUB_USAGE = "Usage: agentplane task scrub --find <text> --replace <text> [flags]";
+export declare const TASK_SCRUB_USAGE_EXAMPLE = "agentplane task scrub --find \"agentctl\" --replace \"agentplane\" --dry-run";
+export declare function cmdTaskScrub(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=scrub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrub.d.ts","sourceRoot":"","sources":["../../../src/commands/task/scrub.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB,wEAC0C,CAAC;AACxE,eAAO,MAAM,wBAAwB,iFACuC,CAAC;AAgE7E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB"}

package/dist/commands/task/scrub.js

@@ -0,0 +1,121 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { infoMessage, missingValueMessage, successMessage, usageMessage, } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+export const TASK_SCRUB_USAGE = "Usage: agentplane task scrub --find <text> --replace <text> [flags]";
+export const TASK_SCRUB_USAGE_EXAMPLE = 'agentplane task scrub --find "agentctl" --replace "agentplane" --dry-run';
+function parseTaskScrubFlags(args) {
+    const out = {
+        find: "",
+        replace: "",
+        dryRun: false,
+        quiet: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === "--dry-run") {
+            out.dryRun = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            out.quiet = true;
+            continue;
+        }
+        if (!arg.startsWith("--")) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: usageMessage(TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE),
+            });
+        }
+        const next = args[i + 1];
+        if (!next) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
+        }
+        if (arg === "--find") {
+            out.find = next;
+        }
+        else if (arg === "--replace") {
+            out.replace = next;
+        }
+        else {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+        }
+        i++;
+    }
+    return out;
+}
+function scrubValue(value, find, replace) {
+    if (typeof value === "string")
+        return value.replaceAll(find, replace);
+    if (Array.isArray(value))
+        return value.map((item) => scrubValue(item, find, replace));
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value);
+        const out = {};
+        for (const [key, val] of entries) {
+            out[key] = scrubValue(val, find, replace);
+        }
+        return out;
+    }
+    return value;
+}
+export async function cmdTaskScrub(opts) {
+    const flags = parseTaskScrubFlags(opts.args);
+    if (!flags.find) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE),
+        });
+    }
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        const updated = [];
+        const changedIds = new Set();
+        for (const task of tasks) {
+            const before = JSON.stringify(task);
+            const scrubbed = scrubValue(task, flags.find, flags.replace);
+            if (scrubbed && typeof scrubbed === "object") {
+                const next = scrubbed;
+                updated.push(next);
+                const after = JSON.stringify(next);
+                if (before !== after)
+                    changedIds.add(next.id);
+            }
+            else {
+                updated.push(task);
+            }
+        }
+        if (flags.dryRun) {
+            if (!flags.quiet) {
+                process.stdout.write(`${infoMessage(`dry-run: would update ${changedIds.size} task(s)`)}` + "\n");
+                for (const id of [...changedIds].toSorted()) {
+                    process.stdout.write(`${id}\n`);
+                }
+            }
+            return 0;
+        }
+        if (backend.writeTasks) {
+            await backend.writeTasks(updated);
+        }
+        else {
+            for (const task of updated) {
+                await backend.writeTask(task);
+            }
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("updated tasks", undefined, `count=${changedIds.size}`)}` + "\n");
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task scrub", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,7 @@
+export declare function cmdTaskSearch(opts: {
+    cwd: string;
+    rootOverride?: string;
+    query: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/task/search.ts"],"names":[],"mappings":"AAcA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqElB"}

package/dist/commands/task/search.js

@@ -0,0 +1,79 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { invalidValueMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, taskTextBlob, toStringArray, } from "./shared.js";
+export async function cmdTaskSearch(opts) {
+    const query = opts.query.trim();
+    if (!query) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Missing query (expected non-empty text)",
+        });
+    }
+    let regex = false;
+    const restArgs = [...opts.args];
+    if (restArgs.includes("--regex")) {
+        regex = true;
+        restArgs.splice(restArgs.indexOf("--regex"), 1);
+    }
+    const filters = parseTaskListFilters(restArgs, { allowLimit: true });
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        const depState = buildDependencyState(tasks);
+        let filtered = tasks;
+        if (filters.status.length > 0) {
+            const wanted = new Set(filters.status.map((s) => s.trim().toUpperCase()));
+            filtered = filtered.filter((task) => wanted.has(String(task.status || "TODO").toUpperCase()));
+        }
+        if (filters.owner.length > 0) {
+            const wanted = new Set(filters.owner.map((o) => o.trim().toUpperCase()));
+            filtered = filtered.filter((task) => wanted.has(String(task.owner || "").toUpperCase()));
+        }
+        if (filters.tag.length > 0) {
+            const wanted = new Set(filters.tag.map((t) => t.trim()).filter(Boolean));
+            filtered = filtered.filter((task) => {
+                const tags = dedupeStrings(toStringArray(task.tags));
+                return tags.some((tag) => wanted.has(tag));
+            });
+        }
+        let matches = [];
+        if (regex) {
+            let pattern;
+            try {
+                pattern = new RegExp(query, "i");
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "Invalid regex";
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueMessage("regex", message, "valid pattern"),
+                });
+            }
+            matches = filtered.filter((task) => pattern.test(taskTextBlob(task)));
+        }
+        else {
+            const needle = query.toLowerCase();
+            matches = filtered.filter((task) => taskTextBlob(task).toLowerCase().includes(needle));
+        }
+        if (filters.limit !== undefined && filters.limit >= 0) {
+            matches = matches.slice(0, filters.limit);
+        }
+        const sorted = matches.toSorted((a, b) => a.id.localeCompare(b.id));
+        for (const task of sorted) {
+            process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task search", root: opts.rootOverride ?? null });
+    }
+}

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,46 @@
+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 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,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"}