@zrhsh/wukong-cli 0.4.27 → 0.4.29

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2026 武汉壹品慧生活技术有限公司. All rights reserved.
+
+本软件为武汉壹品慧生活技术有限公司（以下简称"公司"）的专有资产，
+仅限公司内部授权人员在公司业务范围内使用。
+
+未经公司书面许可，任何单位和个人不得：
+
+  1. 复制、传播、分发本软件或其任何部分；
+  2. 修改、改编、翻译本软件；
+  3. 将本软件用于公司业务范围之外的任何用途；
+  4. 对本软件进行反向工程、反编译或反汇编。
+
+本软件按"现状"提供，不附带任何明示或暗示的担保。
+
+This software is proprietary and confidential.
+Unauthorized copying, distribution, modification, or use is strictly prohibited.

package/dist/cli.js

@@ -256,8 +256,7 @@ function loadConfig() {
   }
   try {
     const content = readFileSync2(configPath, "utf-8");
-    const config = JSON.parse(content);
-    return config;
+    return JSON.parse(content);
   } catch (error2) {
     console.warn(`Warning: Failed to load config from ${configPath}: ${error2}`);
     return {};
@@ -298,22 +297,6 @@ function getMergedEnvironmentConfig(env) {
   }
   return defaultEnvConfig;
 }
-function getAllEnvironments() {
-  const config = loadConfig();
-  const result = { ...ENVIRONMENTS };
-  if (config.customEnvironments) {
-    for (const [name, customEnv] of Object.entries(config.customEnvironments)) {
-      result[name] = {
-        name,
-        displayName: customEnv.displayName || name,
-        authBaseUrl: customEnv.authBaseUrl,
-        apiBaseUrl: customEnv.apiBaseUrl,
-        clientId: customEnv.clientId
-      };
-    }
-  }
-  return result;
-}
 function getDefaultEnvironment() {
   const envFromVar = process.env.WUKONG_CLI_ENV;
   if (envFromVar && isValidEnvironment(envFromVar)) {
@@ -568,7 +551,7 @@ var init_ora_ui_callbacks = __esm({
 });
 
 // src/core/auth/keytar-adapter.ts
-import { createRequire } from "module";
+import { createRequire as createRequire2 } from "module";
 function isKeytarAvailable() {
   return keytarModule !== null;
 }
@@ -590,15 +573,15 @@ async function deletePassword(service, account) {
   }
   return await keytarModule.deletePassword(service, account);
 }
-var require2, keytarModule;
+var require3, keytarModule;
 var init_keytar_adapter = __esm({
   "src/core/auth/keytar-adapter.ts"() {
     "use strict";
     init_esm_shims();
-    require2 = createRequire(import.meta.url);
+    require3 = createRequire2(import.meta.url);
     keytarModule = null;
     try {
-      keytarModule = require2("keytar");
+      keytarModule = require3("keytar");
     } catch (error2) {
       keytarModule = null;
     }
@@ -795,9 +778,18 @@ var init_token_cache = __esm({
 
 // src/cli.ts
 init_esm_shims();
-init_debug();
 import { Command as Command6 } from "commander";
 
+// src/version.ts
+init_esm_shims();
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
+var CLI_VERSION = pkg.version;
+
+// src/cli.ts
+init_debug();
+
 // src/utils/version/index.ts
 init_esm_shims();
 
@@ -809,6 +801,7 @@ init_esm_shims();
 var VersionCache = class {
   lastCheckTime = 0;
   cachedVersion = null;
+  cachedHighlights = [];
   checkInterval;
   /**
    * Constructor
@@ -832,17 +825,27 @@ var VersionCache = class {
   }
   /**
    * Set cached version with timestamp
+   *
+   * @param highlights 该版本的更新要点，缺省为空数组
    */
-  set(version) {
+  set(version, highlights = []) {
     this.cachedVersion = version;
+    this.cachedHighlights = highlights;
     this.lastCheckTime = Date.now();
   }
+  /**
+   * Get cached highlights
+   */
+  getHighlights() {
+    return this.cachedHighlights;
+  }
   /**
    * Clear cache
    */
   clear() {
     this.lastCheckTime = 0;
     this.cachedVersion = null;
+    this.cachedHighlights = [];
   }
   /**
    * Get time since last check
@@ -861,6 +864,10 @@ var VersionCache = class {
   get version() {
     return this.cachedVersion;
   }
+  /** Cached highlights */
+  get highlights() {
+    return this.cachedHighlights;
+  }
 };
 
 // src/utils/version/compare.ts
@@ -905,23 +912,28 @@ var VersionChecker = class {
         return {
           hasUpdate: compareVersions(cached, this.currentVersion) > 0,
           currentVersion: this.currentVersion,
-          latestVersion: cached
+          latestVersion: cached,
+          latestHighlights: this.cache.getHighlights()
         };
       }
     }
-    const latestVersion = await this.provider.getLatestVersion();
-    if (!latestVersion) {
+    const release = this.provider.getLatestRelease ? await this.provider.getLatestRelease() : await this.provider.getLatestVersion().then(
+      (version) => version ? { version, highlights: [] } : null
+    );
+    if (!release) {
       return {
         hasUpdate: false,
         currentVersion: this.currentVersion,
-        latestVersion: null
+        latestVersion: null,
+        latestHighlights: []
       };
     }
-    this.cache.set(latestVersion);
+    this.cache.set(release.version, release.highlights);
     return {
-      hasUpdate: compareVersions(latestVersion, this.currentVersion) > 0,
+      hasUpdate: compareVersions(release.version, this.currentVersion) > 0,
       currentVersion: this.currentVersion,
-      latestVersion
+      latestVersion: release.version,
+      latestHighlights: release.highlights
     };
   }
   /**
@@ -931,7 +943,7 @@ var VersionChecker = class {
     try {
       const result = await this.checkForUpdate();
       if (result.hasUpdate && notifier && result.latestVersion) {
-        notifier.notify(result.currentVersion, result.latestVersion);
+        notifier.notify(result.currentVersion, result.latestVersion, result.latestHighlights);
       }
     } catch (error2) {
     }
@@ -941,6 +953,7 @@ var VersionChecker = class {
    */
   clearCache() {
     this.cache.clear();
+    this.provider.clearCache?.();
   }
   /**
    * Get current cache info
@@ -955,17 +968,37 @@ var VersionChecker = class {
 
 // src/utils/version/provider.ts
 init_esm_shims();
-var NpmVersionProvider = class {
+function parseHighlights(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter((item) => item.length > 0).slice(0, 5);
+}
+var NpmVersionProvider = class _NpmVersionProvider {
   constructor(packageName, registryUrl) {
     this.packageName = packageName;
     this.registryUrl = registryUrl;
     this.timeout = 5e3;
   }
   timeout;
+  cachedRelease = null;
+  cachedAt = 0;
+  /** 同一次进程内复用结果，避免 getLatestVersion / getLatestRelease 重复请求 */
+  static REUSE_MS = 6e4;
   /**
    * Get latest version from npm
    */
   async getLatestVersion() {
+    const release = await this.getLatestRelease();
+    return release?.version ?? null;
+  }
+  /**
+   * 获取最新版本及其更新摘要
+   */
+  async getLatestRelease() {
+    if (this.cachedRelease && Date.now() - this.cachedAt < _NpmVersionProvider.REUSE_MS) {
+      return this.cachedRelease;
+    }
     try {
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -977,11 +1010,28 @@ var NpmVersionProvider = class {
         return null;
       }
       const data = await response.json();
-      return data["dist-tags"]?.latest || null;
+      const version = data["dist-tags"]?.latest;
+      if (!version) {
+        return null;
+      }
+      const highlights = parseHighlights(
+        data.versions?.[version]?.wukongCli?.highlights ?? data.wukongCli?.highlights
+      );
+      const release = { version, highlights };
+      this.cachedRelease = release;
+      this.cachedAt = Date.now();
+      return release;
     } catch (error2) {
       return null;
     }
   }
+  /**
+   * 清除进程内复用缓存
+   */
+  clearCache() {
+    this.cachedRelease = null;
+    this.cachedAt = 0;
+  }
 };
 
 // src/utils/version/persistent-cache.ts
@@ -1002,6 +1052,7 @@ var PersistentVersionCache = class extends VersionCache {
       if (typeof data.lastCheckTime === "number" && typeof data.version === "string") {
         this.lastCheckTime = data.lastCheckTime;
         this.cachedVersion = data.version;
+        this.cachedHighlights = Array.isArray(data.highlights) ? data.highlights.filter((item) => typeof item === "string") : [];
       }
     } catch {
     }
@@ -1011,14 +1062,15 @@ var PersistentVersionCache = class extends VersionCache {
       mkdirSync(dirname(this.cacheFilePath), { recursive: true });
       const data = {
         lastCheckTime: this.lastCheckTime,
-        version: this.cachedVersion ?? ""
+        version: this.cachedVersion ?? "",
+        highlights: this.cachedHighlights
       };
       writeFileSync(this.cacheFilePath, JSON.stringify(data), "utf-8");
     } catch {
     }
   }
-  set(version) {
-    super.set(version);
+  set(version, highlights = []) {
+    super.set(version, highlights);
     this.saveToFile();
   }
   clear() {
@@ -1034,10 +1086,24 @@ import { join } from "path";
 // src/utils/version/notifier.ts
 init_esm_shims();
 import chalk2 from "chalk";
+var MAX_HIGHLIGHTS = 3;
+var SEPARATOR = "\u2500".repeat(58);
 var ConsoleNotifier = class {
-  notify(currentVersion, latestVersion) {
-    const message = `New version available: ${currentVersion} \u2192 ${latestVersion}, run 'wukong-cli update' to update.`;
-    console.log(chalk2.yellow(message));
+  notify(currentVersion, latestVersion, highlights = []) {
+    const lines = [
+      SEPARATOR,
+      `New version available: ${currentVersion} \u2192 ${latestVersion}`
+    ];
+    if (highlights.length > 0) {
+      lines.push("\u672C\u6B21\u66F4\u65B0\uFF1A");
+      for (const item of highlights.slice(0, MAX_HIGHLIGHTS)) {
+        lines.push(`  \u2022 ${item}`);
+      }
+    }
+    lines.push("\u5347\u7EA7\uFF1Awukong-cli update");
+    lines.push("  \u6216 npm i -g @zrhsh/wukong-cli@latest");
+    lines.push(SEPARATOR);
+    process.stderr.write(chalk2.yellow(lines.join("\n")) + "\n");
   }
 };
 
@@ -2098,16 +2164,18 @@ function getClient() {
 }
 
 // src/commands/auth.ts
+init_environments();
 init_oceanet();
-init_config_loader();
+function resolveEnvContext() {
+  const env = getCurrentEnvironment();
+  setCurrentEnvironment(env);
+  return { env, envConfig: ENVIRONMENTS[env] };
+}
 var authCommands = new Command("auth").description("Authentication commands");
 authCommands.command("login").description("Login using Device Authorization Flow").action(async () => {
   try {
-    const env = getCurrentEnvironment();
-    const allEnvs = getAllEnvironments();
-    setCurrentEnvironment(env);
+    const { env, envConfig } = resolveEnvContext();
     const config = getOceanetConfig();
-    const envConfig = allEnvs[env];
     console.log("");
     console.log(chalk5.bgBlue.white.bold(" Wukong CLI Login "));
     console.log("");
@@ -2175,10 +2243,7 @@ authCommands.command("login").description("Login using Device Authorization Flow
   }
 });
 authCommands.command("logout").description("Logout and clear saved tokens").action(async () => {
-  const env = getCurrentEnvironment();
-  const allEnvs = getAllEnvironments();
-  setCurrentEnvironment(env);
-  const envConfig = allEnvs[env];
+  const { env, envConfig } = resolveEnvContext();
   try {
     const accessToken = await getAccessToken();
     const ystAccessToken = await getYstAccessToken();
@@ -2195,9 +2260,7 @@ authCommands.command("logout").description("Logout and clear saved tokens").acti
   }
 });
 authCommands.command("refresh").description("Manually refresh access token").action(async () => {
-  const env = getCurrentEnvironment();
-  const allEnvs = getAllEnvironments();
-  const envConfig = allEnvs[env];
+  const { env, envConfig } = resolveEnvContext();
   try {
     const config = getOceanetConfig();
     const accessToken = await getAccessToken();
@@ -2243,10 +2306,7 @@ authCommands.command("refresh").description("Manually refresh access token").act
 });
 authCommands.command("status").description("Show authentication status").action(async () => {
   console.log("");
-  const env = getCurrentEnvironment();
-  const allEnvs = getAllEnvironments();
-  setCurrentEnvironment(env);
-  const envConfig = allEnvs[env];
+  const { env, envConfig } = resolveEnvContext();
   try {
     const config = getOceanetConfig();
     const accessToken = await getAccessToken();
@@ -2256,6 +2316,7 @@ authCommands.command("status").description("Show authentication status").action(
       printEnvironmentInfo(env, envConfig.displayName);
       console.log(chalk5.dim(`Run: wukong-cli auth login`));
       console.log("");
+      process.exitCode = 1;
       return;
     }
     try {
@@ -2280,6 +2341,7 @@ authCommands.command("status").description("Show authentication status").action(
       printEnvironmentInfo(env, envConfig.displayName);
       console.log(chalk5.dim(`Run: wukong-cli auth login`));
       console.log("");
+      process.exitCode = 1;
     }
   } catch (error2) {
     if (error2 instanceof ConfigFileError) {
@@ -2287,6 +2349,7 @@ authCommands.command("status").description("Show authentication status").action(
       console.log("");
       console.log(chalk5.red(error2.toUserMessage()));
       console.log("");
+      process.exitCode = 1;
       return;
     }
     console.log(chalk5.yellow(`\u2717 Not authenticated`));
@@ -2294,14 +2357,12 @@ authCommands.command("status").description("Show authentication status").action(
     printEnvironmentInfo(env, envConfig.displayName);
     console.log(chalk5.dim(`Run: wukong-cli auth login`));
     console.log("");
+    process.exitCode = 1;
   }
 });
 authCommands.command("token").description("Display current token structure and JWT payload claims").action(async () => {
   console.log("");
-  const env = getCurrentEnvironment();
-  const allEnvs = getAllEnvironments();
-  setCurrentEnvironment(env);
-  const envConfig = allEnvs[env];
+  const { env, envConfig } = resolveEnvContext();
   try {
     let decodeJwt2 = function(token) {
       try {
@@ -2494,8 +2555,37 @@ function detectPageQueryEnvelope(body) {
   };
 }
 
+// src/core/http/response-guard.ts
+init_esm_shims();
+var AUTH_ERROR_CODES = [401, 403, 9913, 9914];
+var LOGIN_HINT = "Run: wukong-cli auth login";
+function isAuthErrorCode(code) {
+  return AUTH_ERROR_CODES.includes(code);
+}
+function withLoginHint(message) {
+  if (message.includes(LOGIN_HINT)) {
+    return message;
+  }
+  return `${message}
+Hint: \u767B\u5F55\u6001\u53EF\u80FD\u5DF2\u5931\u6548\uFF0C\u8BF7\u91CD\u65B0\u767B\u5F55\u3002${LOGIN_HINT}`;
+}
+function looksLikeHtml(value) {
+  if (typeof value !== "string") {
+    return false;
+  }
+  const head = value.trimStart().slice(0, 64).toLowerCase();
+  return head.startsWith("<!doctype html") || head.startsWith("<html");
+}
+function describeHtmlResponse() {
+  return [
+    "\u63A5\u53E3\u8FD4\u56DE\u7684\u662F HTML \u9875\u9762\uFF0C\u4E0D\u662F JSON\u3002",
+    "\u5E38\u89C1\u539F\u56E0\uFF1A\u767B\u5F55\u6001\u5931\u6548\u88AB\u91CD\u5B9A\u5411\u5230\u767B\u5F55\u9875\u3001\u63A5\u53E3\u8DEF\u5F84\u9519\u8BEF\u3001base URL \u6307\u5411\u4E86\u524D\u7AEF\u7AD9\u70B9\u3002",
+    `\u8BF7\u5148\u6267\u884C wukong-cli auth status \u786E\u8BA4\u767B\u5F55\u6001\uFF0C\u5FC5\u8981\u65F6 ${LOGIN_HINT}`
+  ].join("\n");
+}
+
 // src/commands/http.ts
-function fail(message, jsonMode, errorCode = null) {
+function fail(message, jsonMode, errorCode = null, exitCode = 1) {
   if (jsonMode) {
     process.stderr.write(
       JSON.stringify({ error: { code: errorCode, message } }, null, 2) + "\n"
@@ -2503,7 +2593,7 @@ function fail(message, jsonMode, errorCode = null) {
   } else {
     console.error(chalk6.red(message));
   }
-  process.exit(1);
+  process.exit(exitCode);
 }
 function fixGitBashPath(url) {
   if (url.includes(":") && !url.startsWith("http")) {
@@ -2644,7 +2734,12 @@ function handleError(error2, jsonMode) {
 ${error2.toUserMessage()}`, jsonMode);
   }
   if (error2 instanceof ApiError) {
-    return fail(`API Error (code: ${error2.code}): ${error2.message}`, jsonMode, error2.code);
+    const message = `API Error (code: ${error2.code}): ${error2.message}`;
+    return fail(
+      isAuthErrorCode(error2.code) ? withLoginHint(message) : message,
+      jsonMode,
+      error2.code
+    );
   }
   return fail(error2 instanceof Error ? error2.message : String(error2), jsonMode);
 }
@@ -2675,6 +2770,10 @@ async function executeRequest(method, url, options) {
     };
     warnOnPageQueryEnvelope(context);
     const result = context.fullUrl.includes("/yst-") ? await sendWithYstToken(context) : await sendWithMainToken(context);
+    if (looksLikeHtml(result.data)) {
+      spinner.fail("Unexpected HTML response");
+      fail(describeHtmlResponse(), jsonMode, null, 2);
+    }
     spinner.succeed(`Response received (${result.duration}ms)`);
     renderResult(result, jsonMode);
   } catch (error2) {
@@ -3182,7 +3281,7 @@ async function runUpdateCommand({
 }
 var updateCommand = new Command5("update").description("Update wukong-cli to the latest npm version").action(async () => {
   const exitCode = await runUpdateCommand({
-    currentVersion: "0.4.27",
+    currentVersion: CLI_VERSION,
     versionProvider: new NpmVersionProvider(
       "@zrhsh/wukong-cli",
       "https://registry.npmjs.org"
@@ -3197,7 +3296,7 @@ var updateCommand = new Command5("update").description("Update wukong-cli to the
 
 // src/cli.ts
 var program = new Command6();
-program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version("0.4.27").option("--debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
+program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version(CLI_VERSION).option("--debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   if (options.debug === true) {
     setDebugMode(true, true);
@@ -3216,7 +3315,7 @@ if (process.argv.length === 2) {
 program.parse();
 setImmediate(() => {
   try {
-    const versionChecker = getVersionChecker("0.4.27");
+    const versionChecker = getVersionChecker(CLI_VERSION);
     const notifier = new ConsoleNotifier();
     versionChecker.checkInBackground(notifier).catch(() => {
     });