agentplane 0.1.9 → 0.2.1

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

@@ -1,36 +1,15 @@
+import { createHash } from "node:crypto";
 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 { backendNotSupportedMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { loadBackendTask } from "../shared/task-backend.js";
-import { appendTaskEvent, nowIso } from "./shared.js";
+import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
+import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { appendTaskEvent, extractDocSection, 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) {
@@ -73,68 +52,25 @@ function renderVerificationEntry(opts) {
         "",
         `Note: ${opts.note}`,
     ];
+    const verifyStepsRef = (opts.verifyStepsRef ?? "").trim();
+    if (verifyStepsRef) {
+        lines.push("", `VerifyStepsRef: ${verifyStepsRef}`);
+    }
     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;
+function sha256Hex(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
 }
 async function recordVerificationResult(opts) {
-    const { backend, config, resolved, task } = await loadBackendTask({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride,
-        taskId: opts.taskId,
-    });
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const backend = ctx.taskBackend;
+    const config = ctx.config;
+    const resolved = ctx.resolvedProject;
     if (!backend.getTaskDoc || !backend.writeTask) {
         throw new CliError({
             exitCode: 2,
@@ -142,9 +78,25 @@ async function recordVerificationResult(opts) {
             message: backendNotSupportedMessage("task docs"),
         });
     }
-    const existingDoc = (typeof task.doc === "string" ? task.doc : "") || (await backend.getTaskDoc(task.id));
+    const useStore = backendIsLocalFileBackend(ctx);
+    const store = useStore ? getTaskStore(ctx) : null;
+    const task = useStore
+        ? await store.get(opts.taskId)
+        : await loadTaskFromContext({ ctx, taskId: opts.taskId });
+    const existingDoc = useStore
+        ? String(task.doc ?? "")
+        : (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 verifySteps = extractDocSection(baseDoc, "Verify Steps");
+    const verifyStepsHash = verifySteps
+        ? sha256Hex(verifySteps.replaceAll("\r\n", "\n").trim())
+        : null;
+    const verifyStepsRef = [
+        `doc_version=${String(task.doc_version ?? "missing")}`,
+        `doc_updated_at=${String(task.doc_updated_at ?? "missing")}`,
+        `excerpt_hash=sha256:${verifyStepsHash ?? "missing"}`,
+    ].join(", ");
     const at = nowIso();
     const entry = renderVerificationEntry({
         at,
@@ -152,10 +104,11 @@ async function recordVerificationResult(opts) {
         by: opts.by,
         note: opts.note,
         details: opts.details ?? null,
+        verifyStepsRef,
     });
     const nextVerification = appendBetweenMarkers(verificationSection, entry);
     const nextDoc = ensureDocSections(setMarkdownSection(baseDoc, "Verification", nextVerification), config.tasks.doc.required_sections);
-    await backend.writeTask({
+    const nextTask = {
         ...task,
         status: opts.state === "needs_rework" ? "DOING" : task.status,
         commit: opts.state === "needs_rework" ? null : (task.commit ?? null),
@@ -174,105 +127,142 @@ async function recordVerificationResult(opts) {
             updated_by: opts.by,
             note: opts.note,
         },
-    });
+    };
+    await (useStore ? store.update(opts.taskId, () => nextTask) : backend.writeTask(nextTask));
     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")) {
+export async function cmdTaskVerifyOk(opts) {
+    const by = String(opts.by ?? "").trim();
+    const note = String(opts.note ?? "").trim();
+    if (!by || !note) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+            message: "Missing required inputs: --by and --note.",
         });
     }
-    const flags = parseVerifyRecordFlags(restArgs);
-    const by = (flags.by ?? "").trim();
-    const note = (flags.note ?? "").trim();
-    if (flags.details && flags.file) {
+    if (typeof opts.details === "string" && typeof opts.file === "string") {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+            message: "Options --details and --file are mutually exclusive.",
+        });
+    }
+    let details = typeof opts.details === "string" ? opts.details : null;
+    if (typeof opts.file === "string") {
+        try {
+            details = await readFile(path.resolve(opts.cwd, opts.file), "utf8");
+        }
+        catch (err) {
+            throw mapCoreError(err, { command: "task verify ok", filePath: opts.file });
+        }
+    }
+    try {
+        await recordVerificationResult({
+            ctx: opts.ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            taskId: opts.taskId,
+            state: "ok",
+            by,
+            note,
+            details,
+            quiet: opts.quiet,
         });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "task verify ok", root: opts.rootOverride ?? null });
     }
+}
+export async function cmdTaskVerifyRework(opts) {
+    const by = String(opts.by ?? "").trim();
+    const note = String(opts.note ?? "").trim();
     if (!by || !note) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE),
+            message: "Missing required inputs: --by and --note.",
         });
     }
-    let details = flags.details ?? null;
-    if (flags.file) {
+    if (typeof opts.details === "string" && typeof opts.file === "string") {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Options --details and --file are mutually exclusive.",
+        });
+    }
+    let details = typeof opts.details === "string" ? opts.details : null;
+    if (typeof opts.file === "string") {
         try {
-            details = await readFile(path.resolve(opts.cwd, flags.file), "utf8");
+            details = await readFile(path.resolve(opts.cwd, opts.file), "utf8");
         }
         catch (err) {
-            throw mapCoreError(err, { command: "task verify", filePath: flags.file });
+            throw mapCoreError(err, { command: "task verify rework", filePath: opts.file });
         }
     }
     try {
         await recordVerificationResult({
+            ctx: opts.ctx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
-            taskId,
-            state: subcommand === "ok" ? "ok" : "needs_rework",
+            taskId: opts.taskId,
+            state: "needs_rework",
             by,
             note,
             details,
-            quiet: flags.quiet,
+            quiet: opts.quiet,
         });
         return 0;
     }
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapBackendError(err, { command: "task verify", root: opts.rootOverride ?? null });
+        throw mapBackendError(err, { command: "task verify rework", 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) {
+export async function cmdVerifyParsed(opts) {
+    const by = String(opts.by ?? "").trim();
+    const note = String(opts.note ?? "").trim();
+    if (!by || !note) {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(VERIFY_USAGE, VERIFY_USAGE_EXAMPLE),
+            message: "Missing required inputs: --by and --note.",
         });
     }
-    if ((ok && rework) || (!ok && !rework) || !by || !note) {
+    if (typeof opts.details === "string" && typeof opts.file === "string") {
         throw new CliError({
             exitCode: 2,
             code: "E_USAGE",
-            message: usageMessage(VERIFY_USAGE, VERIFY_USAGE_EXAMPLE),
+            message: "Options --details and --file are mutually exclusive.",
         });
     }
-    let details = flags.details ?? null;
-    if (flags.file) {
+    let details = typeof opts.details === "string" ? opts.details : null;
+    if (typeof opts.file === "string") {
         try {
-            details = await readFile(path.resolve(opts.cwd, flags.file), "utf8");
+            details = await readFile(path.resolve(opts.cwd, opts.file), "utf8");
         }
         catch (err) {
-            throw mapCoreError(err, { command: "verify", filePath: flags.file });
+            throw mapCoreError(err, { command: "verify", filePath: opts.file });
         }
     }
     try {
         await recordVerificationResult({
+            ctx: opts.ctx,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
             taskId: opts.taskId,
-            state: ok ? "ok" : "needs_rework",
+            state: opts.state,
             by,
             note,
             details,
-            quiet: flags.quiet,
+            quiet: opts.quiet,
         });
         return 0;
     }

package/dist/commands/task/verify-rework.command.d.ts

@@ -0,0 +1,13 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskVerifyReworkParsed = {
+    taskId: string;
+    by: string;
+    note: string;
+    details?: string;
+    file?: string;
+    quiet: boolean;
+};
+export declare const taskVerifyReworkSpec: CommandSpec<TaskVerifyReworkParsed>;
+export declare function makeRunTaskVerifyReworkHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskVerifyReworkParsed) => Promise<number>;
+//# sourceMappingURL=verify-rework.command.d.ts.map

package/dist/commands/task/verify-rework.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-rework.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-rework.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,sBAAsB,CAkEpE,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC/E,KAAK,UAAU,EAAE,GAAG,sBAAsB,KAAG,OAAO,CAAC,MAAM,CAAC,CAa3E"}

package/dist/commands/task/verify-rework.command.js

@@ -0,0 +1,83 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { cmdTaskVerifyRework } from "./verify-record.js";
+export const taskVerifyReworkSpec = {
+    id: ["task", "verify", "rework"],
+    group: "Task",
+    summary: "Record verification as needs rework (resets commit, sets status to DOING, updates Verification).",
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        { kind: "string", name: "by", valueHint: "<id>", required: true, description: "Verifier id." },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            required: true,
+            description: "Short verification note.",
+        },
+        {
+            kind: "string",
+            name: "details",
+            valueHint: "<text>",
+            description: "Optional details text (mutually exclusive with --file).",
+        },
+        {
+            kind: "string",
+            name: "file",
+            valueHint: "<path>",
+            description: "Optional details file path (mutually exclusive with --details).",
+        },
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress normal output (still prints errors).",
+        },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane task verify rework 202602030608-F1Q8AB --by REVIEWER --note "Needs changes"',
+            why: "Record a needs-rework verification.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const details = raw.opts.details;
+        const file = raw.opts.file;
+        if (typeof details === "string" && typeof file === "string") {
+            throw usageError({
+                spec: taskVerifyReworkSpec,
+                message: "Provide at most one of --details or --file.",
+            });
+        }
+        const by = raw.opts.by;
+        if (typeof by === "string" && by.trim().length === 0) {
+            throw usageError({ spec: taskVerifyReworkSpec, message: "Invalid value for --by: empty." });
+        }
+        const note = raw.opts.note;
+        if (typeof note === "string" && note.trim().length === 0) {
+            throw usageError({ spec: taskVerifyReworkSpec, message: "Invalid value for --note: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        by: String(raw.opts.by),
+        note: String(raw.opts.note),
+        details: typeof raw.opts.details === "string" ? raw.opts.details : undefined,
+        file: typeof raw.opts.file === "string" ? raw.opts.file : undefined,
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunTaskVerifyReworkHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskVerifyRework({
+            ctx: await getCtx("task verify rework"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            by: p.by,
+            note: p.note,
+            details: p.details,
+            file: p.file,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/task/verify-show.command.d.ts

@@ -0,0 +1,9 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandContext } from "../shared/task-backend.js";
+export type TaskVerifyShowParsed = {
+    taskId: string;
+    quiet: boolean;
+};
+export declare const taskVerifyShowSpec: CommandSpec<TaskVerifyShowParsed>;
+export declare function makeRunTaskVerifyShowHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskVerifyShowParsed) => Promise<number>;
+//# sourceMappingURL=verify-show.command.d.ts.map

package/dist/commands/task/verify-show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CAyBhE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC7E,KAAK,UAAU,EAAE,GAAG,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAAC,CAUzE"}

package/dist/commands/task/verify-show.command.js

@@ -0,0 +1,38 @@
+import { cmdTaskDocShow } from "./doc.js";
+export const taskVerifyShowSpec = {
+    id: ["task", "verify-show"],
+    group: "Task",
+    summary: 'Print the task Verify Steps section (alias for task doc show --section "Verify Steps").',
+    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
+    options: [
+        {
+            kind: "boolean",
+            name: "quiet",
+            default: false,
+            description: "Suppress errors when the section is missing.",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane task verify-show 202602030608-F1Q8AB", why: "Print Verify Steps." },
+        {
+            cmd: "agentplane task verify-show 202602030608-F1Q8AB --quiet",
+            why: "Print Verify Steps without erroring when missing.",
+        },
+    ],
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        quiet: raw.opts.quiet === true,
+    }),
+};
+export function makeRunTaskVerifyShowHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdTaskDocShow({
+            ctx: await getCtx("task verify-show"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            section: "Verify Steps",
+            quiet: p.quiet,
+        });
+    };
+}

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

@@ -0,0 +1,7 @@
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
+export type TaskVerifyParsed = {
+    subcommand?: string;
+};
+export declare const taskVerifySpec: CommandSpec<TaskVerifyParsed>;
+export declare function runTaskVerify(_ctx: CommandCtx, p: TaskVerifyParsed): Promise<number>;
+//# sourceMappingURL=verify.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAYxD,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpF"}

package/dist/commands/task/verify.command.js

@@ -0,0 +1,20 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const taskVerifySpec = {
+    id: ["task", "verify"],
+    group: "Task",
+    summary: "Record verification results (ok/rework).",
+    synopsis: [
+        "agentplane task verify ok <task-id> --by <id> --note <text> [--details <text> | --file <path>] [--quiet]",
+        "agentplane task verify rework <task-id> --by <id> --note <text> [--details <text> | --file <path>] [--quiet]",
+    ],
+    args: [{ name: "subcommand", required: false, valueHint: "<ok|rework>" }],
+    parse: (raw) => ({
+        subcommand: typeof raw.args.subcommand === "string" ? raw.args.subcommand : undefined,
+    }),
+};
+export function runTaskVerify(_ctx, p) {
+    if (!p.subcommand) {
+        throw usageError({ spec: taskVerifySpec, message: "Missing subcommand." });
+    }
+    throw usageError({ spec: taskVerifySpec, message: `Unknown subcommand: ${p.subcommand}` });
+}

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

@@ -0,0 +1,6 @@
+import type { CommandHandler, CommandSpec } from "../cli/spec/spec.js";
+import { type UpgradeFlags } from "./upgrade.js";
+export type UpgradeParsed = UpgradeFlags;
+export declare const upgradeSpec: CommandSpec<UpgradeParsed>;
+export declare const runUpgrade: CommandHandler<UpgradeParsed>;
+//# sourceMappingURL=upgrade.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.command.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAqGlD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACsB,CAAC"}

package/dist/commands/upgrade.command.js

@@ -0,0 +1,104 @@
+import { usageError } from "../cli/spec/errors.js";
+import { cmdUpgradeParsed } from "./upgrade.js";
+export const upgradeSpec = {
+    id: ["upgrade"],
+    group: "Setup",
+    summary: "Upgrade the local agentplane framework bundle in the repo.",
+    description: "Downloads (or reads) an upgrade bundle, verifies checksum, and applies allowed files into the repo. Network access is gated by config approvals; use --yes when allowed.",
+    options: [
+        {
+            kind: "string",
+            name: "tag",
+            valueHint: "<tag>",
+            description: "GitHub release tag (defaults to latest).",
+        },
+        {
+            kind: "string",
+            name: "source",
+            valueHint: "<repo-url>",
+            description: "Override GitHub repo source URL (defaults to config.framework.source).",
+        },
+        {
+            kind: "string",
+            name: "bundle",
+            valueHint: "<path|url>",
+            description: "Use a local path or URL for the upgrade bundle archive.",
+        },
+        {
+            kind: "string",
+            name: "checksum",
+            valueHint: "<path|url>",
+            description: "Use a local path or URL for the bundle checksum file (required with --bundle).",
+        },
+        {
+            kind: "string",
+            name: "asset",
+            valueHint: "<name>",
+            description: "Override the GitHub release asset name for the bundle.",
+        },
+        {
+            kind: "string",
+            name: "checksum-asset",
+            valueHint: "<name>",
+            description: "Override the GitHub release asset name for the checksum file.",
+        },
+        {
+            kind: "boolean",
+            name: "dry-run",
+            default: false,
+            description: "Report changes without modifying files.",
+        },
+        {
+            kind: "boolean",
+            name: "no-backup",
+            default: false,
+            description: "Disable backups (default is to create backups).",
+        },
+        {
+            kind: "boolean",
+            name: "yes",
+            default: false,
+            description: "Auto-approve network access prompts (subject to config approvals).",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane upgrade",
+            why: "Upgrade to the latest release using config.framework.source.",
+        },
+        {
+            cmd: "agentplane upgrade --tag v0.1.9 --dry-run",
+            why: "Preview changes for a specific release tag.",
+        },
+        {
+            cmd: "agentplane upgrade --bundle ./agentplane-upgrade.tar.gz --checksum ./agentplane-upgrade.tar.gz.sha256",
+            why: "Upgrade from local bundle files (no network).",
+        },
+    ],
+    parse: (raw) => {
+        const noBackup = raw.opts["no-backup"] === true;
+        return {
+            source: raw.opts.source,
+            tag: raw.opts.tag,
+            bundle: raw.opts.bundle,
+            checksum: raw.opts.checksum,
+            asset: raw.opts.asset,
+            checksumAsset: raw.opts["checksum-asset"],
+            dryRun: raw.opts["dry-run"] === true,
+            backup: !noBackup,
+            yes: raw.opts.yes === true,
+        };
+    },
+    validate: (p) => {
+        const hasBundle = Boolean(p.bundle);
+        const hasChecksum = Boolean(p.checksum);
+        if (hasBundle !== hasChecksum) {
+            throw usageError({
+                spec: upgradeSpec,
+                command: "upgrade",
+                message: "Options --bundle and --checksum must be provided together (or omitted together).",
+            });
+        }
+    },
+};
+export const runUpgrade = (ctx, flags) => cmdUpgradeParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });