agentplane 0.1.6 → 0.1.8

package/dist/commands/task/start.js

@@ -0,0 +1,110 @@
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+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 } from "../shared/task-backend.js";
+import { buildDependencyState, ensurePlanApprovedIfRequired, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
+export const START_USAGE = "Usage: agentplane start <task-id> --author <id> --body <text> [flags]";
+export const START_USAGE_EXAMPLE = 'agentplane start 202602030608-F1Q8AB --author CODER --body "Start: ..."';
+export async function cmdStart(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: "start",
+                confirmed: opts.confirmStatusCommit,
+                quiet: opts.quiet,
+            });
+        }
+        const { prefix, min_chars: minChars } = loaded.config.tasks.comments.start;
+        requireStructuredComment(opts.body, prefix, minChars);
+        const { backend, task } = await loadBackendTask({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+        });
+        ensurePlanApprovedIfRequired(task, loaded.config);
+        const currentStatus = String(task.status || "TODO").toUpperCase();
+        if (!opts.force && !isTransitionAllowed(currentStatus, "DOING")) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Refusing status transition ${currentStatus} -> DOING (use --force to override)`,
+            });
+        }
+        if (!opts.force) {
+            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 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: "DOING",
+            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 ?? "🚧",
+                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("started", `${opts.taskId}${suffix}`)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "start", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,8 @@
+export declare const TASK_UPDATE_USAGE = "Usage: agentplane task update <task-id> [flags]";
+export declare const TASK_UPDATE_USAGE_EXAMPLE = "agentplane task update 202602030608-F1Q8AB --title \"...\" --owner CODER";
+export declare function cmdTaskUpdate(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/task/update.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,iBAAiB,oDAAoD,CAAC;AACnF,eAAO,MAAM,yBAAyB,6EACoC,CAAC;AAuG3E,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB"}

package/dist/commands/task/update.js

@@ -0,0 +1,144 @@
+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 { dedupeStrings, normalizeDependsOnInput, requiresVerify, toStringArray } from "./shared.js";
+export const TASK_UPDATE_USAGE = "Usage: agentplane task update <task-id> [flags]";
+export const TASK_UPDATE_USAGE_EXAMPLE = 'agentplane task update 202602030608-F1Q8AB --title "..." --owner CODER';
+function parseTaskUpdateFlags(args) {
+    const [taskId, ...rest] = args;
+    if (!taskId) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE),
+        });
+    }
+    const out = {
+        taskId,
+        tags: [],
+        replaceTags: false,
+        dependsOn: [],
+        replaceDependsOn: false,
+        verify: [],
+        replaceVerify: false,
+    };
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (!arg)
+            continue;
+        if (arg === "--replace-tags") {
+            out.replaceTags = true;
+            continue;
+        }
+        if (arg === "--replace-depends-on") {
+            out.replaceDependsOn = true;
+            continue;
+        }
+        if (arg === "--replace-verify") {
+            out.replaceVerify = true;
+            continue;
+        }
+        if (!arg.startsWith("--")) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: usageMessage(TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE),
+            });
+        }
+        const next = rest[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 "--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;
+            }
+            default: {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Unknown flag: ${arg}`,
+                });
+            }
+        }
+        i++;
+    }
+    return out;
+}
+export async function cmdTaskUpdate(opts) {
+    const flags = parseTaskUpdateFlags(opts.args);
+    try {
+        const { backend, config } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const task = await backend.getTask(flags.taskId);
+        if (!task) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: unknownEntityMessage("task id", flags.taskId),
+            });
+        }
+        const next = { ...task };
+        if (flags.title !== undefined)
+            next.title = flags.title;
+        if (flags.description !== undefined)
+            next.description = flags.description;
+        if (flags.priority !== undefined)
+            next.priority = flags.priority;
+        if (flags.owner !== undefined)
+            next.owner = flags.owner;
+        const existingTags = flags.replaceTags ? [] : dedupeStrings(toStringArray(next.tags));
+        const mergedTags = dedupeStrings([...existingTags, ...flags.tags]);
+        next.tags = mergedTags;
+        const existingDepends = flags.replaceDependsOn
+            ? []
+            : dedupeStrings(toStringArray(next.depends_on));
+        const mergedDepends = dedupeStrings([...existingDepends, ...flags.dependsOn]);
+        next.depends_on = mergedDepends;
+        const existingVerify = flags.replaceVerify ? [] : dedupeStrings(toStringArray(next.verify));
+        const mergedVerify = dedupeStrings([...existingVerify, ...flags.verify]);
+        next.verify = mergedVerify;
+        if (requiresVerify(mergedTags, config.tasks.verify.required_tags) &&
+            mergedVerify.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "verify commands are required for tasks with code/backend/frontend tags",
+            });
+        }
+        await backend.writeTask(next);
+        process.stdout.write(`${successMessage("updated", flags.taskId)}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapBackendError(err, { command: "task update", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/task/verify-record.d.ts

@@ -0,0 +1,16 @@
+export declare const TASK_VERIFY_USAGE = "Usage: agentplane task verify <ok|rework> <task-id> --by <id> --note <text> [--details <text> | --file <path>]";
+export declare const TASK_VERIFY_USAGE_EXAMPLE = "agentplane task verify ok 202602030608-F1Q8AB --by REVIEWER --note \"Looks good\"";
+export declare const VERIFY_USAGE = "Usage: agentplane verify <task-id> (--ok | --rework) --by <id> --note <text> [--details <text> | --file <path>] [--quiet]";
+export declare const VERIFY_USAGE_EXAMPLE = "agentplane verify 202602030608-F1Q8AB --ok --by REVIEWER --note \"Looks good\"";
+export declare function cmdTaskVerify(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+export declare function cmdVerify(opts: {
+    cwd: string;
+    rootOverride?: string;
+    taskId: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=verify-record.d.ts.map

package/dist/commands/task/verify-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-record.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-record.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,iBAAiB,mHACoF,CAAC;AACnH,eAAO,MAAM,yBAAyB,sFAC6C,CAAC;AAEpF,eAAO,MAAM,YAAY,8HACoG,CAAC;AAC9H,eAAO,MAAM,oBAAoB,mFAC+C,CAAC;AA0MjF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,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,CA8ClB"}

package/dist/commands/task/verify-record.js

@@ -0,0 +1,277 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDocSections, setMarkdownSection } from "@agentplaneorg/core";
+import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
+import { backendNotSupportedMessage, missingValueMessage, usageMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { loadBackendTask } from "../shared/task-backend.js";
+import { nowIso } from "./shared.js";
+const RESULTS_BEGIN = "<!-- BEGIN VERIFICATION RESULTS -->";
+const RESULTS_END = "<!-- END VERIFICATION RESULTS -->";
+export const TASK_VERIFY_USAGE = "Usage: agentplane task verify <ok|rework> <task-id> --by <id> --note <text> [--details <text> | --file <path>]";
+export const TASK_VERIFY_USAGE_EXAMPLE = 'agentplane task verify ok 202602030608-F1Q8AB --by REVIEWER --note "Looks good"';
+export const VERIFY_USAGE = "Usage: agentplane verify <task-id> (--ok | --rework) --by <id> --note <text> [--details <text> | --file <path>] [--quiet]";
+export const VERIFY_USAGE_EXAMPLE = 'agentplane verify 202602030608-F1Q8AB --ok --by REVIEWER --note "Looks good"';
+function extractDocSection(doc, sectionName) {
+    const lines = doc.replaceAll("\r\n", "\n").split("\n");
+    let capturing = false;
+    const out = [];
+    for (const line of lines) {
+        const match = /^##\s+(.*)$/.exec(line.trim());
+        if (match) {
+            if (capturing)
+                break;
+            capturing = (match[1] ?? "").trim() === sectionName;
+            continue;
+        }
+        if (capturing)
+            out.push(line);
+    }
+    if (!capturing)
+        return null;
+    return out.join("\n").trimEnd();
+}
+function ensureVerificationResultsMarkers(sectionText) {
+    const normalized = sectionText.replaceAll("\r\n", "\n").trimEnd();
+    if (!normalized) {
+        return ["### Plan", "", "", "### Results", "", "", RESULTS_BEGIN, RESULTS_END].join("\n");
+    }
+    const hasBegin = normalized.includes(RESULTS_BEGIN);
+    const hasEnd = normalized.includes(RESULTS_END);
+    if (hasBegin && hasEnd)
+        return normalized;
+    const out = [normalized];
+    if (!normalized.endsWith("\n"))
+        out.push("");
+    out.push("", RESULTS_BEGIN, RESULTS_END);
+    return out.join("\n").trimEnd();
+}
+function appendBetweenMarkers(sectionText, entryText) {
+    const ensured = ensureVerificationResultsMarkers(sectionText);
+    const beginIdx = ensured.indexOf(RESULTS_BEGIN);
+    const endIdx = ensured.indexOf(RESULTS_END);
+    if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+        throw new Error("Verification results markers are malformed");
+    }
+    const beforeEnd = ensured.slice(0, endIdx).trimEnd();
+    const afterEnd = ensured.slice(endIdx).trimStart();
+    const entry = entryText.trimEnd();
+    const parts = [
+        beforeEnd,
+        ...(beforeEnd.endsWith(RESULTS_BEGIN) ? [] : [""]),
+        entry,
+        "",
+        afterEnd,
+    ];
+    return parts.join("\n").trimEnd();
+}
+function renderVerificationEntry(opts) {
+    const lines = [
+        `#### ${opts.at} — VERIFY — ${opts.state}`,
+        "",
+        `By: ${opts.by}`,
+        "",
+        `Note: ${opts.note}`,
+    ];
+    const details = (opts.details ?? "").trim();
+    if (details) {
+        lines.push("", "Details:", "", details);
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+function parseVerifyRecordFlags(args) {
+    const out = { quiet: false, ok: false, rework: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === "--ok") {
+            out.ok = true;
+            continue;
+        }
+        if (arg === "--rework") {
+            out.rework = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            out.quiet = true;
+            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 "--by": {
+                out.by = next;
+                break;
+            }
+            case "--note": {
+                out.note = next;
+                break;
+            }
+            case "--details": {
+                out.details = next;
+                break;
+            }
+            case "--file": {
+                out.file = next;
+                break;
+            }
+            default: {
+                throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+            }
+        }
+        i++;
+    }
+    return out;
+}
+async function recordVerificationResult(opts) {
+    const { backend, config, resolved, task } = await loadBackendTask({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride,
+        taskId: opts.taskId,
+    });
+    if (!backend.getTaskDoc || !backend.writeTask) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: backendNotSupportedMessage("task docs"),
+        });
+    }
+    const existingDoc = (typeof task.doc === "string" ? task.doc : "") || (await backend.getTaskDoc(task.id));
+    const baseDoc = ensureDocSections(existingDoc ?? "", config.tasks.doc.required_sections);
+    const verificationSection = extractDocSection(baseDoc, "Verification") ?? "";
+    const at = nowIso();
+    const entry = renderVerificationEntry({
+        at,
+        state: opts.state,
+        by: opts.by,
+        note: opts.note,
+        details: opts.details ?? null,
+    });
+    const nextVerification = appendBetweenMarkers(verificationSection, entry);
+    const nextDoc = ensureDocSections(setMarkdownSection(baseDoc, "Verification", nextVerification), config.tasks.doc.required_sections);
+    await backend.writeTask({
+        ...task,
+        status: opts.state === "needs_rework" ? "DOING" : task.status,
+        commit: opts.state === "needs_rework" ? null : (task.commit ?? null),
+        doc: nextDoc,
+        doc_updated_by: opts.by,
+        verification: {
+            state: opts.state,
+            updated_at: at,
+            updated_by: opts.by,
+            note: opts.note,
+        },
+    });
+    if (!opts.quiet) {
+        const readmePath = path.join(resolved.gitRoot, config.paths.workflow_dir, task.id, "README.md");
+        process.stdout.write(`${readmePath}\n`);
+    }
+}
+export async function cmdTaskVerify(opts) {
+    const [subcommand, taskId, ...restArgs] = opts.args;
+    if (!subcommand || !taskId || (subcommand !== "ok" && subcommand !== "rework")) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+        });
+    }
+    const flags = parseVerifyRecordFlags(restArgs);
+    const by = (flags.by ?? "").trim();
+    const note = (flags.note ?? "").trim();
+    if (flags.details && flags.file) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+        });
+    }
+    if (!by || !note) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+        });
+    }
+    let details = flags.details ?? null;
+    if (flags.file) {
+        try {
+            details = await readFile(path.resolve(opts.cwd, flags.file), "utf8");
+        }
+        catch (err) {
+            throw mapCoreError(err, { command: "task verify", filePath: flags.file });
+        }
+    }
+    try {
+        await recordVerificationResult({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId,
+            state: subcommand === "ok" ? "ok" : "needs_rework",
+            by,
+            note,
+            details,
+            quiet: flags.quiet,
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task verify", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdVerify(opts) {
+    const flags = parseVerifyRecordFlags(opts.args);
+    const by = (flags.by ?? "").trim();
+    const note = (flags.note ?? "").trim();
+    const ok = flags.ok;
+    const rework = flags.rework;
+    if (flags.details && flags.file) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(VERIFY_USAGE, VERIFY_USAGE_EXAMPLE),
+        });
+    }
+    if ((ok && rework) || (!ok && !rework) || !by || !note) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(VERIFY_USAGE, VERIFY_USAGE_EXAMPLE),
+        });
+    }
+    let details = flags.details ?? null;
+    if (flags.file) {
+        try {
+            details = await readFile(path.resolve(opts.cwd, flags.file), "utf8");
+        }
+        catch (err) {
+            throw mapCoreError(err, { command: "verify", filePath: flags.file });
+        }
+    }
+    try {
+        await recordVerificationResult({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            state: ok ? "ok" : "needs_rework",
+            by,
+            note,
+            details,
+            quiet: flags.quiet,
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "verify", root: opts.rootOverride ?? null });
+    }
+}

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

@@ -0,0 +1,2 @@
+export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify-record.js";
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/commands/task/verify.js

@@ -0,0 +1 @@
+export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify-record.js";

package/dist/commands/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAwJA,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,CA2KlB"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA8JA,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,CAsLlB"}

package/dist/commands/upgrade.js

@@ -9,12 +9,13 @@ import { extractArchive } from "../cli/archive.js";
 import { invalidFieldMessage, invalidValueMessage, missingValueMessage, requiredFieldMessage, usageMessage, } from "../cli/output.js";
 import { exitCodeForError } from "../cli/exit-codes.js";
 import { CliError } from "../shared/errors.js";
+import { ensureNetworkApproved } from "./shared/network-approval.js";
 const DEFAULT_UPGRADE_ASSET = "agentplane-upgrade.tar.gz";
 const DEFAULT_UPGRADE_CHECKSUM_ASSET = "agentplane-upgrade.tar.gz.sha256";
-const UPGRADE_USAGE = "Usage: agentplane upgrade [--tag <tag>] [--dry-run] [--no-backup] [--source <repo-url>] [--bundle <path|url>] [--checksum <path|url>]";
+const UPGRADE_USAGE = "Usage: agentplane upgrade [--tag <tag>] [--dry-run] [--no-backup] [--source <repo-url>] [--bundle <path|url>] [--checksum <path|url>] [--yes]";
 const UPGRADE_USAGE_EXAMPLE = "agentplane upgrade --tag v0.1.4 --dry-run";
 function parseUpgradeFlags(args) {
-    const out = { dryRun: false, backup: true };
+    const out = { dryRun: false, backup: true, yes: false };
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (!arg)
@@ -34,6 +35,10 @@ function parseUpgradeFlags(args) {
             out.backup = false;
             continue;
         }
+        if (arg === "--yes") {
+            out.yes = true;
+            continue;
+        }
         const next = args[i + 1];
         if (!next) {
             throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
@@ -136,6 +141,13 @@ export async function cmdUpgrade(opts) {
     });
     const loaded = await loadConfig(resolved.agentplaneDir);
     const source = flags.source ?? loaded.config.framework.source;
+    let networkApproved = false;
+    const ensureApproved = async (reason) => {
+        if (networkApproved)
+            return;
+        await ensureNetworkApproved({ config: loaded.config, yes: flags.yes, reason });
+        networkApproved = true;
+    };
     let tempRoot = null;
     let extractRoot = null;
     try {
@@ -146,6 +158,7 @@ export async function cmdUpgrade(opts) {
             const isUrl = flags.bundle.startsWith("http://") || flags.bundle.startsWith("https://");
             bundlePath = isUrl ? path.join(tempRoot, "bundle.tar.gz") : path.resolve(flags.bundle);
             if (isUrl) {
+                await ensureApproved("upgrade downloads the bundle/checksum from the network");
                 await downloadToFile(flags.bundle, bundlePath);
             }
             const checksumValue = flags.checksum ?? "";
@@ -154,6 +167,7 @@ export async function cmdUpgrade(opts) {
                 ? path.join(tempRoot, "bundle.tar.gz.sha256")
                 : path.resolve(checksumValue);
             if (checksumIsUrl) {
+                await ensureApproved("upgrade downloads the bundle/checksum from the network");
                 await downloadToFile(checksumValue, checksumPath);
             }
         }
@@ -162,6 +176,7 @@ export async function cmdUpgrade(opts) {
             const releaseUrl = flags.tag
                 ? `https://api.github.com/repos/${owner}/${repo}/releases/tags/${flags.tag}`
                 : `https://api.github.com/repos/${owner}/${repo}/releases/latest`;
+            await ensureApproved("upgrade fetches release metadata and downloads assets from the network");
             const release = (await fetchJson(releaseUrl));
             const assets = Array.isArray(release.assets) ? release.assets : [];
             const assetName = flags.asset ?? DEFAULT_UPGRADE_ASSET;