agentplane 0.1.6 → 0.1.8

package/dist/commands/task/migrate-doc.js

@@ -0,0 +1,147 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { atomicWriteFile, ensureDocSections, extractTaskDoc, loadConfig, mergeTaskDoc, normalizeTaskDoc, parseTaskReadme, renderTaskReadme, resolveProject, } from "@agentplaneorg/core";
+import { mapCoreError } from "../../cli/error-map.js";
+import { fileExists, getPathKind } from "../../cli/fs-utils.js";
+import { successMessage, usageMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+export const TASK_MIGRATE_DOC_USAGE = "Usage: agentplane task migrate-doc [<task-id> ...] [--all] [--quiet]";
+export const TASK_MIGRATE_DOC_USAGE_EXAMPLE = "agentplane task migrate-doc --all";
+function parseTaskMigrateDocFlags(args) {
+    const out = { all: false, quiet: false, taskIds: [] };
+    for (const arg of args) {
+        if (!arg)
+            continue;
+        if (arg === "--all") {
+            out.all = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            out.quiet = true;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
+            });
+        }
+        out.taskIds.push(arg);
+    }
+    if (!out.all && out.taskIds.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
+        });
+    }
+    if (out.all && out.taskIds.length > 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE),
+        });
+    }
+    return out;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function ensurePlanApprovalFrontmatter(frontmatter) {
+    const raw = frontmatter.plan_approval;
+    if (isRecord(raw) && typeof raw.state === "string")
+        return;
+    frontmatter.plan_approval = {
+        state: "pending",
+        updated_at: null,
+        updated_by: null,
+        note: null,
+    };
+}
+function ensureVerificationFrontmatter(frontmatter) {
+    const raw = frontmatter.verification;
+    if (isRecord(raw) && typeof raw.state === "string")
+        return;
+    frontmatter.verification = {
+        state: "pending",
+        updated_at: null,
+        updated_by: null,
+        note: null,
+    };
+}
+async function migrateTaskReadmeDoc(opts) {
+    const originalRaw = await readFile(opts.readmePath, "utf8");
+    const original = originalRaw.endsWith("\n") ? originalRaw : `${originalRaw}\n`;
+    const parsed = parseTaskReadme(original);
+    const frontmatter = { ...parsed.frontmatter };
+    ensurePlanApprovalFrontmatter(frontmatter);
+    ensureVerificationFrontmatter(frontmatter);
+    const required = opts.config.tasks.doc.required_sections;
+    const extracted = extractTaskDoc(parsed.body);
+    const baseDoc = extracted || parsed.body;
+    const nextDoc = normalizeTaskDoc(ensureDocSections(baseDoc, required));
+    const nextBody = extracted ? mergeTaskDoc(parsed.body, nextDoc) : nextDoc;
+    const rendered = renderTaskReadme(frontmatter, nextBody);
+    const next = rendered.endsWith("\n") ? rendered : `${rendered}\n`;
+    if (next === original)
+        return { changed: false };
+    await atomicWriteFile(opts.readmePath, next, "utf8");
+    return { changed: true };
+}
+async function resolveReadmePaths(opts) {
+    if (!opts.flags.all) {
+        return opts.flags.taskIds.map((taskId) => path.join(opts.tasksDir, taskId, "README.md"));
+    }
+    if ((await getPathKind(opts.tasksDir)) !== "dir")
+        return [];
+    const entries = await readdir(opts.tasksDir, { withFileTypes: true });
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const readmePath = path.join(opts.tasksDir, entry.name, "README.md");
+        if (await fileExists(readmePath))
+            out.push(readmePath);
+    }
+    return out;
+}
+export async function cmdTaskMigrateDoc(opts) {
+    const flags = parseTaskMigrateDocFlags(opts.args);
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
+        const readmePaths = await resolveReadmePaths({ tasksDir, flags });
+        if (!flags.all) {
+            for (const readmePath of readmePaths) {
+                if (!(await fileExists(readmePath))) {
+                    const taskId = path.basename(path.dirname(readmePath));
+                    throw new CliError({
+                        exitCode: 5,
+                        code: "E_IO",
+                        message: `Task README not found: ${taskId}`,
+                    });
+                }
+            }
+        }
+        let changed = 0;
+        for (const readmePath of readmePaths) {
+            const res = await migrateTaskReadmeDoc({ readmePath, config: loaded.config });
+            if (res.changed)
+                changed += 1;
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("migrated task docs", undefined, `changed=${changed}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "task migrate-doc", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

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

package/dist/commands/task/migrate.js

@@ -0,0 +1,70 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { missingValueMessage, successMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+function parseTaskMigrateFlags(args) {
+    const out = { quiet: false, force: 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 === "--force") {
+            out.force = true;
+            continue;
+        }
+        if (arg === "--source") {
+            const next = args[i + 1];
+            if (!next) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: missingValueMessage("--source"),
+                });
+            }
+            out.source = next;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+        }
+    }
+    return out;
+}
+export async function cmdTaskMigrate(opts) {
+    const flags = parseTaskMigrateFlags(opts.args);
+    if (flags.force) {
+        // Force is accepted for parity; no additional checks in node CLI.
+    }
+    try {
+        const { backend, resolved, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const source = flags.source ?? config.paths.tasks_path;
+        const sourcePath = path.join(resolved.gitRoot, source);
+        const raw = await readFile(sourcePath, "utf8");
+        const parsed = JSON.parse(raw);
+        const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+        if (backend.writeTasks) {
+            await backend.writeTasks(tasks);
+        }
+        else {
+            for (const task of tasks)
+                await backend.writeTask(task);
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("migrated tasks into backend", undefined, `count=${tasks.length}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task migrate", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+export declare const TASK_NEW_USAGE = "Usage: agentplane task new --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
+export declare const TASK_NEW_USAGE_EXAMPLE = "agentplane task new --title \"Refactor CLI\" --description \"Improve CLI output\" --priority med --owner CODER --tag cli";
+export declare function cmdTaskNew(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=new.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/task/new.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,8IACkH,CAAC;AAC9I,eAAO,MAAM,sBAAsB,6HACqF,CAAC;AA6DzH,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,CA0DlB"}

package/dist/commands/task/new.js

@@ -0,0 +1,117 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { missingValueMessage, usageMessage, backendNotSupportedMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { normalizeDependsOnInput, nowIso, requiresVerify } from "./shared.js";
+export const TASK_NEW_USAGE = "Usage: agentplane task new --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
+export const TASK_NEW_USAGE_EXAMPLE = 'agentplane task new --title "Refactor CLI" --description "Improve CLI output" --priority med --owner CODER --tag cli';
+function parseTaskNewFlags(args) {
+    const out = { tags: [], dependsOn: [], verify: [] };
+    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 "--title": {
+                out.title = next;
+                break;
+            }
+            case "--description": {
+                out.description = next;
+                break;
+            }
+            case "--owner": {
+                out.owner = next;
+                break;
+            }
+            case "--priority": {
+                out.priority = 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;
+            }
+            default: {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+            }
+        }
+        i++;
+    }
+    return out;
+}
+export async function cmdTaskNew(opts) {
+    const flags = parseTaskNewFlags(opts.args);
+    const priority = flags.priority ?? "med";
+    if (!flags.title || !flags.description || !flags.owner || flags.tags.length === 0) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE),
+        });
+    }
+    try {
+        const { backend, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const suffixLength = config.tasks.id_suffix_length_default;
+        if (!backend.generateTaskId) {
+            throw new CliError({
+                exitCode: 3,
+                code: "E_VALIDATION",
+                message: backendNotSupportedMessage("generateTaskId()"),
+            });
+        }
+        const taskId = await backend.generateTaskId({ length: suffixLength, attempts: 1000 });
+        const task = {
+            id: taskId,
+            title: flags.title,
+            description: flags.description,
+            status: "TODO",
+            priority,
+            owner: flags.owner,
+            tags: flags.tags,
+            depends_on: flags.dependsOn,
+            verify: flags.verify,
+            comments: [],
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: flags.owner,
+            id_source: "generated",
+        };
+        if (requiresVerify(flags.tags, config.tasks.verify.required_tags) &&
+            flags.verify.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Missing verify commands for tasks with code/backend/frontend tags (use --verify)",
+            });
+        }
+        await backend.writeTask(task);
+        process.stdout.write(`${taskId}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task new", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

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

package/dist/commands/task/next.js

@@ -0,0 +1,45 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { buildDependencyState, dedupeStrings, formatTaskLine, parseTaskListFilters, toStringArray, } from "./shared.js";
+export async function cmdTaskNext(opts) {
+    const filters = parseTaskListFilters(opts.args, { allowLimit: true });
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        const depState = buildDependencyState(tasks);
+        const statuses = filters.status.length > 0
+            ? new Set(filters.status.map((s) => s.trim().toUpperCase()))
+            : new Set(["TODO"]);
+        let filtered = tasks.filter((task) => statuses.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));
+            });
+        }
+        const sorted = filtered.toSorted((a, b) => a.id.localeCompare(b.id));
+        const ready = sorted.filter((task) => {
+            const dep = depState.get(task.id);
+            return !dep || (dep.missing.length === 0 && dep.incomplete.length === 0);
+        });
+        const limited = filters.limit !== undefined && filters.limit >= 0 ? ready.slice(0, filters.limit) : ready;
+        for (const task of limited) {
+            process.stdout.write(`${formatTaskLine(task, depState.get(task.id))}\n`);
+        }
+        if (!filters.quiet) {
+            process.stdout.write(`Ready: ${limited.length} / ${filtered.length}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task next", root: opts.rootOverride ?? null });
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/commands/task/normalize.ts"],"names":[],"mappings":"AAoBA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB"}

package/dist/commands/task/normalize.js

@@ -0,0 +1,46 @@
+import { loadTaskBackend } from "../../backends/task-backend.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { successMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+function parseTaskNormalizeFlags(args) {
+    const out = { quiet: false, force: false };
+    for (const arg of args) {
+        if (!arg)
+            continue;
+        if (arg === "--quiet")
+            out.quiet = true;
+        else if (arg === "--force")
+            out.force = true;
+        else if (arg.startsWith("--")) {
+            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+        }
+    }
+    return out;
+}
+export async function cmdTaskNormalize(opts) {
+    const flags = parseTaskNormalizeFlags(opts.args);
+    if (flags.force) {
+        // Force is accepted for parity; no additional checks in node CLI.
+    }
+    try {
+        const { backend } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const tasks = await backend.listTasks();
+        if (backend.writeTasks) {
+            await backend.writeTasks(tasks);
+        }
+        else {
+            for (const task of tasks)
+                await backend.writeTask(task);
+        }
+        if (!flags.quiet) {
+            process.stdout.write(`${successMessage("normalized tasks", undefined, `count=${tasks.length}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task normalize", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,14 @@
+export declare const TASK_PLAN_USAGE = "Usage: agentplane task plan <set|approve|reject> <task-id> [flags]";
+export declare const TASK_PLAN_USAGE_EXAMPLE = "agentplane task plan set 202602030608-F1Q8AB --text \"...\"";
+export declare const TASK_PLAN_SET_USAGE = "Usage: agentplane task plan set <task-id> (--text <text> | --file <path>) [--updated-by <id>]";
+export declare const TASK_PLAN_SET_USAGE_EXAMPLE: string;
+export declare const TASK_PLAN_APPROVE_USAGE = "Usage: agentplane task plan approve <task-id> --by <id> [--note <text>]";
+export declare const TASK_PLAN_APPROVE_USAGE_EXAMPLE = "agentplane task plan approve 202602030608-F1Q8AB --by USER --note \"OK\"";
+export declare const TASK_PLAN_REJECT_USAGE = "Usage: agentplane task plan reject <task-id> --by <id> --note <text>";
+export declare const TASK_PLAN_REJECT_USAGE_EXAMPLE = "agentplane task plan reject 202602030608-F1Q8AB --by USER --note \"Need clarification\"";
+export declare function cmdTaskPlan(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/task/plan.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe,uEAAuE,CAAC;AACpG,eAAO,MAAM,uBAAuB,gEAA8D,CAAC;AAEnG,eAAO,MAAM,mBAAmB,kGACiE,CAAC;AAClG,eAAO,MAAM,2BAA2B,QAA6G,CAAC;AAEtJ,eAAO,MAAM,uBAAuB,4EACuC,CAAC;AAC5E,eAAO,MAAM,+BAA+B,6EAC8B,CAAC;AAE3E,eAAO,MAAM,sBAAsB,yEACqC,CAAC;AACzE,eAAO,MAAM,8BAA8B,4FAC8C,CAAC;AAoG1F,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIlB"}