@aigne/cli 1.49.2-beta → 1.49.2-beta.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.49.2-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.49.2-beta...cli-v1.49.2-beta.1) (2025-09-29)
+
+
+### Bug Fixes
+
+* **cli:** improve app loading reliability with force upgrade on error ([#566](https://github.com/AIGNE-io/aigne-framework/issues/566)) ([d7c49cf](https://github.com/AIGNE-io/aigne-framework/commit/d7c49cfdfdc72c0d1a98c3033babe1392cb707c1))
+
 ## [1.49.2-beta](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.49.1...cli-v1.49.2-beta) (2025-09-29)
 
 

package/dist/cli.js

@@ -16,7 +16,8 @@ function getAIGNEFilePath() {
     }
 }
 const aigneFilePath = getAIGNEFilePath();
-export default createAIGNECommand({ aigneFilePath })
+const argv = process.argv.slice(aigneFilePath ? 3 : 2);
+export default createAIGNECommand({ argv, aigneFilePath })
     .fail((message, error, yargs) => {
     // We catch all errors below, here just print the help message non-error case like demandCommand
     if (!error) {
@@ -25,7 +26,7 @@ export default createAIGNECommand({ aigneFilePath })
         process.exit(1);
     }
 })
-    .parseAsync(process.argv.slice(aigneFilePath ? 3 : 2))
+    .parseAsync(argv)
     .catch((error) => {
     console.log(""); // Add an empty line for better readability
     console.error(`${chalk.red("Error:")} ${highlightUrl(error.message)}`);

package/dist/commands/aigne.d.ts

@@ -1,4 +1,5 @@
 import yargs from "yargs";
 export declare function createAIGNECommand(options?: {
+    argv?: string[];
     aigneFilePath?: string;
 }): yargs.Argv<{}>;

package/dist/commands/aigne.js

@@ -21,7 +21,7 @@ export function createAIGNECommand(options) {
         .command(createCreateCommand())
         .command(createServeMCPCommand(options))
         .command(createObservabilityCommand())
-        .command(createAppCommands())
+        .command(createAppCommands(options))
         .command(createHubCommand())
         .command(createDeployCommands())
         .demandCommand()

package/dist/commands/app.d.ts

@@ -1,7 +1,9 @@
 import type { CommandModule } from "yargs";
 import { type AgentInChildProcess, type LoadAIGNEInChildProcessResult } from "../utils/workers/run-aigne-in-child-process.js";
 import { type AgentRunCommonOptions } from "../utils/yargs.js";
-export declare function createAppCommands(): CommandModule[];
+export declare function createAppCommands({ argv }?: {
+    argv?: string[];
+}): CommandModule[];
 export declare const agentCommandModule: ({ dir, agent, }: {
     dir: string;
     agent: AgentInChildProcess;

package/dist/commands/app.js

@@ -7,6 +7,7 @@ import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { joinURL } from "ufo";
 import { downloadAndExtract } from "../utils/download.js";
+import { withSpinner } from "../utils/spinner.js";
 import { runAIGNEInChildProcess, } from "../utils/workers/run-aigne-in-child-process.js";
 import { withAgentInputSchema } from "../utils/yargs.js";
 import { serveMCPServerFromDir } from "./serve-mcp.js";
@@ -32,36 +33,36 @@ const builtinApps = [
         aliases: ["websmith", "web"],
     },
 ];
-export function createAppCommands() {
+export function createAppCommands({ argv } = {}) {
     return builtinApps.map((app) => ({
         command: app.name,
         describe: app.describe,
         aliases: app.aliases,
-        builder: async (yargs) => {
+        builder: async (y) => {
             const dir = join(homedir(), ".aigne", "registry.npmjs.org", app.packageName);
-            const { aigne, version } = await loadApplication({
-                dir,
-                packageName: app.packageName,
-                install: true,
-            });
-            if (aigne.cli?.chat) {
-                yargs.command({
-                    ...agentCommandModule({ dir, agent: aigne.cli.chat }),
-                    command: "$0",
+            y.command(upgradeCommandModule({ packageName: app.packageName, dir }));
+            if (!argv || !isUpgradeCommand(argv)) {
+                const { aigne, version } = await loadApplication({
+                    dir,
+                    packageName: app.packageName,
+                    install: true,
                 });
+                if (aigne.cli?.chat) {
+                    y.command({
+                        ...agentCommandModule({ dir, agent: aigne.cli.chat }),
+                        command: "$0",
+                    });
+                }
+                for (const agent of aigne.cli?.agents ?? []) {
+                    y.command(agentCommandModule({ dir, agent }));
+                }
+                y.option("model", {
+                    type: "string",
+                    description: "Model to use for the application, example: openai:gpt-4.1 or google:gemini-2.5-flash",
+                }).command(serveMcpCommandModule({ name: app.name, dir }));
+                y.version(`${app.name} v${version}`).alias("version", "v");
             }
-            for (const agent of aigne.cli?.agents ?? []) {
-                yargs.command(agentCommandModule({ dir, agent }));
-            }
-            yargs
-                .option("model", {
-                type: "string",
-                description: "Model to use for the application, example: openai:gpt-4.1 or google:gemini-2.5-flash",
-            })
-                .command(serveMcpCommandModule({ name: app.name, dir }))
-                .command(upgradeCommandModule({ packageName: app.packageName, dir }));
-            yargs.version(`${app.name} v${version}`).alias("version", "v");
-            return yargs.demandCommand();
+            return y.demandCommand();
         },
         handler: () => { },
     }));
@@ -90,11 +91,15 @@ const serveMcpCommandModule = ({ name, dir, }) => ({
         await serveMCPServerFromDir({ ...options, dir });
     },
 });
+function isUpgradeCommand(argv) {
+    const skipGlobalOptions = ["-v", "--version"];
+    return argv[1] === "upgrade" && !argv.some((arg) => skipGlobalOptions.includes(arg));
+}
 const upgradeCommandModule = ({ packageName, dir, }) => ({
     command: "upgrade",
     describe: `Upgrade ${packageName} to the latest version`,
-    builder: (argv) => {
-        return argv
+    builder: (yargs) => {
+        return yargs
             .option("beta", {
             type: "boolean",
             describe: "Use beta versions if available",
@@ -112,11 +117,13 @@ const upgradeCommandModule = ({ packageName, dir, }) => ({
     },
     handler: async ({ beta, targetVersion, force }) => {
         beta ??= shouldUseBetaApps();
-        let app = await loadApplication({ packageName, dir });
-        const npm = await getNpmTgzInfo(packageName, { beta, version: targetVersion });
-        if (!app || force || npm.version !== app.version) {
+        const npm = await withSpinner("", async () => {
             if (force)
                 await rm(dir, { force: true, recursive: true });
+            return await getNpmTgzInfo(packageName, { beta, version: targetVersion });
+        });
+        let app = await loadApplication({ packageName, dir });
+        if (!app || force || npm.version !== app.version) {
             await installApp({ packageName, dir, beta, version: targetVersion });
             app = await loadApplication({ dir, packageName, install: true });
             console.log(`\n✅ Upgraded ${packageName} to version ${app.version}`);
@@ -149,8 +156,12 @@ export async function loadApplication(options) {
     const { dir, packageName } = options;
     const check = await checkInstallation(dir);
     if (check && !check.expired) {
-        const aigne = await runAIGNEInChildProcess("loadAIGNE", dir).catch((error) => {
-            console.warn(`⚠️ Failed to load ${packageName}, trying to reinstall:`, error.message);
+        const aigne = await runAIGNEInChildProcess("loadAIGNE", dir).catch(async (error) => {
+            logger.error(`⚠️ Failed to load ${packageName}, trying to reinstall:`, error.message);
+            await withSpinner("", async () => {
+                await rm(options.dir, { recursive: true, force: true });
+                await mkdir(options.dir, { recursive: true });
+            });
         });
         if (aigne) {
             return { aigne, version: check.version, isCache: true };

package/dist/utils/spinner.d.ts

@@ -0,0 +1 @@
+export declare function withSpinner<T>(message: string, fn: () => Promise<T>): Promise<T>;

package/dist/utils/spinner.js

@@ -0,0 +1,14 @@
+import { Spinner } from "@aigne/listr2";
+export async function withSpinner(message, fn) {
+    const spinner = new Spinner();
+    spinner.start(() => {
+        process.stdout.write(`\r\x1b[K${spinner.fetch()} ${message}`);
+    });
+    try {
+        return await fn();
+    }
+    finally {
+        spinner.stop();
+        process.stdout.write("\r\x1b[K"); // Clear the spinner line
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.49.2-beta",
+  "version": "1.49.2-beta.1",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -85,10 +85,10 @@
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
     "@aigne/agent-library": "^1.21.47-beta",
+    "@aigne/agentic-memory": "^1.0.47-beta",
     "@aigne/aigne-hub": "^0.10.1-beta",
     "@aigne/core": "^1.61.1-beta",
     "@aigne/default-memory": "^1.2.10-beta",
-    "@aigne/agentic-memory": "^1.0.47-beta",
     "@aigne/observability-api": "^0.11.1-beta",
     "@aigne/openai": "^0.16.1-beta"
   },