@zrhsh/wukong-cli 0.4.28 → 0.4.29

package/dist/cli.js

@@ -801,6 +801,7 @@ init_esm_shims();
 var VersionCache = class {
   lastCheckTime = 0;
   cachedVersion = null;
+  cachedHighlights = [];
   checkInterval;
   /**
    * Constructor
@@ -824,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
@@ -853,6 +864,10 @@ var VersionCache = class {
   get version() {
     return this.cachedVersion;
   }
+  /** Cached highlights */
+  get highlights() {
+    return this.cachedHighlights;
+  }
 };
 
 // src/utils/version/compare.ts
@@ -897,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
     };
   }
   /**
@@ -923,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) {
     }
@@ -933,6 +953,7 @@ var VersionChecker = class {
    */
   clearCache() {
     this.cache.clear();
+    this.provider.clearCache?.();
   }
   /**
    * Get current cache info
@@ -947,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);
@@ -969,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
@@ -994,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 {
     }
@@ -1003,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() {
@@ -1026,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");
   }
 };
 
@@ -2242,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 {
@@ -2266,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) {
@@ -2273,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`));
@@ -2280,6 +2357,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;
   }
 });
 authCommands.command("token").description("Display current token structure and JWT payload claims").action(async () => {
@@ -2477,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"
@@ -2486,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")) {
@@ -2627,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);
 }
@@ -2658,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) {