agentplane 0.2.3 → 0.2.5

package/dist/commands/task/shared.js

@@ -4,6 +4,7 @@ import { readdir } from "node:fs/promises";
 import path from "node:path";
 import { invalidValueForFlag, invalidValueMessage, missingValueMessage, warnMessage, } from "../../cli/output.js";
 import { fileExists } from "../../cli/fs-utils.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
 import { CliError } from "../../shared/errors.js";
 import { dedupeStrings } from "../../shared/strings.js";
 import { parseGitLogHashSubject } from "../../shared/git-log.js";
@@ -269,7 +270,7 @@ export function parseTaskListFilters(args, opts) {
             const next = args[i + 1];
             if (!next) {
                 throw new CliError({
-                    exitCode: 2,
+                    exitCode: exitCodeForError("E_USAGE"),
                     code: "E_USAGE",
                     message: missingValueMessage("--status"),
                 });
@@ -282,7 +283,7 @@ export function parseTaskListFilters(args, opts) {
             const next = args[i + 1];
             if (!next) {
                 throw new CliError({
-                    exitCode: 2,
+                    exitCode: exitCodeForError("E_USAGE"),
                     code: "E_USAGE",
                     message: missingValueMessage("--owner"),
                 });
@@ -294,7 +295,11 @@ export function parseTaskListFilters(args, opts) {
         if (arg === "--tag") {
             const next = args[i + 1];
             if (!next) {
-                throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage("--tag") });
+                throw new CliError({
+                    exitCode: exitCodeForError("E_USAGE"),
+                    code: "E_USAGE",
+                    message: missingValueMessage("--tag"),
+                });
             }
             out.tag.push(next);
             i++;
@@ -304,7 +309,7 @@ export function parseTaskListFilters(args, opts) {
             const next = args[i + 1];
             if (!next) {
                 throw new CliError({
-                    exitCode: 2,
+                    exitCode: exitCodeForError("E_USAGE"),
                     code: "E_USAGE",
                     message: missingValueMessage("--limit"),
                 });
@@ -312,7 +317,7 @@ export function parseTaskListFilters(args, opts) {
             const parsed = Number.parseInt(next, 10);
             if (!Number.isFinite(parsed)) {
                 throw new CliError({
-                    exitCode: 2,
+                    exitCode: exitCodeForError("E_USAGE"),
                     code: "E_USAGE",
                     message: invalidValueForFlag("--limit", next, "integer"),
                 });
@@ -322,7 +327,11 @@ export function parseTaskListFilters(args, opts) {
             continue;
         }
         if (arg.startsWith("--")) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: `Unknown flag: ${arg}` });
+            throw new CliError({
+                exitCode: exitCodeForError("E_USAGE"),
+                code: "E_USAGE",
+                message: `Unknown flag: ${arg}`,
+            });
         }
     }
     return out;

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

@@ -1 +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"}
+{"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,CA0JlD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACsB,CAAC"}

package/dist/commands/upgrade.command.js

@@ -4,8 +4,32 @@ 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.",
+    description: "Upgrades the local agentplane framework bundle in the repo using a strict manifest of managed files. By default, upgrade generates an agent-assisted plan from the locally installed agentplane package assets (no network) and does not modify files. Use --auto to apply changes. Use --remote to fetch a GitHub release bundle; network access is gated by config approvals.",
     options: [
+        {
+            kind: "boolean",
+            name: "agent",
+            default: false,
+            description: "Generate an agent-assisted upgrade plan (no files are modified). This is the default mode.",
+        },
+        {
+            kind: "boolean",
+            name: "auto",
+            default: false,
+            description: "Apply the upgrade automatically (writes managed files).",
+        },
+        {
+            kind: "boolean",
+            name: "remote",
+            default: false,
+            description: "Fetch the framework bundle from GitHub releases (requires network approvals).",
+        },
+        {
+            kind: "boolean",
+            name: "allow-tarball",
+            default: false,
+            description: "Allow falling back to a GitHub repo tarball when release assets are missing (no checksum verification).",
+        },
         {
             kind: "string",
             name: "tag",
@@ -61,14 +85,27 @@ export const upgradeSpec = {
             description: "Auto-approve network access prompts (subject to config approvals).",
         },
     ],
+    validateRaw: (raw) => {
+        if (raw.opts.agent === true && raw.opts.auto === true) {
+            throw usageError({
+                spec: upgradeSpec,
+                command: "upgrade",
+                message: "Options --agent and --auto are mutually exclusive.",
+            });
+        }
+    },
     examples: [
         {
             cmd: "agentplane upgrade",
-            why: "Upgrade to the latest release using config.framework.source.",
+            why: "Generate an agent-assisted plan using locally installed assets (no network).",
         },
         {
-            cmd: "agentplane upgrade --tag v0.1.9 --dry-run",
-            why: "Preview changes for a specific release tag.",
+            cmd: "agentplane upgrade --auto",
+            why: "Apply the upgrade automatically (writes managed files).",
+        },
+        {
+            cmd: "agentplane upgrade --remote --tag v0.1.9 --dry-run",
+            why: "Preview changes for a specific GitHub release tag (no writes).",
         },
         {
             cmd: "agentplane upgrade --bundle ./agentplane-upgrade.tar.gz --checksum ./agentplane-upgrade.tar.gz.sha256",
@@ -78,6 +115,9 @@ export const upgradeSpec = {
     parse: (raw) => {
         const noBackup = raw.opts["no-backup"] === true;
         return {
+            mode: raw.opts.auto === true ? "auto" : "agent",
+            remote: raw.opts.remote === true,
+            allowTarball: raw.opts["allow-tarball"] === true,
             source: raw.opts.source,
             tag: raw.opts.tag,
             bundle: raw.opts.bundle,
@@ -99,6 +139,14 @@ export const upgradeSpec = {
                 message: "Options --bundle and --checksum must be provided together (or omitted together).",
             });
         }
+        const hasRemoteHints = Boolean(p.source) || Boolean(p.tag) || Boolean(p.asset) || Boolean(p.checksumAsset);
+        if (!p.remote && hasRemoteHints && !hasBundle) {
+            throw usageError({
+                spec: upgradeSpec,
+                command: "upgrade",
+                message: "Remote upgrade options (--tag/--source/--asset/--checksum-asset) require --remote.",
+            });
+        }
     },
 };
 export const runUpgrade = (ctx, flags) => cmdUpgradeParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });

package/dist/commands/upgrade.d.ts

@@ -5,11 +5,15 @@ export type UpgradeFlags = {
     checksum?: string;
     asset?: string;
     checksumAsset?: string;
+    mode: "agent" | "auto";
+    remote: boolean;
+    allowTarball: boolean;
     dryRun: boolean;
     backup: boolean;
     yes: boolean;
 };
 type GitHubRelease = {
+    tag_name?: string;
     assets?: {
         name?: string;
         browser_download_url?: string;
@@ -36,6 +40,12 @@ export declare function resolveUpgradeDownloadFromRelease(opts: {
     kind: "tarball";
     tarballUrl: string;
 };
+export declare function resolveRepoTarballUrl(opts: {
+    release: GitHubRelease;
+    owner: string;
+    repo: string;
+    explicitTag?: string;
+}): string;
 export declare function cmdUpgradeParsed(opts: {
     cwd: string;
     rootOverride?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAmBF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAWA;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GACG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAqB1C;AAkOD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgSlB"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA2DF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAWA;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GACG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAqB1C;AAUD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAgBT;AAkPD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6dlB"}