fix(gui): auto-retry npm update check on latest_unavailable with Retry button (#77)

- Server: npm view retries up to 3 attempts with backoff (src/update/index.ts)
- GUI: auto-retries 2x when latest_unavailable comes back, then shows Retry button
- Retry button next to the warning, no dashboard refresh needed
- Dead code removed (old UPDATE_CHECK_ATTEMPTS/sleepMs constants)
- i18n: dash.updateRetry added for en/ko/zh

Author: Wibias

gui/src/i18n/en.ts

@@ -79,6 +79,7 @@ export const en = {
   "dash.updateCommand": "Command",
   "dash.updateSource": "This is a source checkout. Update it from the terminal with the shown command.",
   "dash.updateUnavailable": "Could not read the latest version from npm. Try again later.",
+  "dash.updateRetry": "Retry",
   "dash.updateRestart": "Restart after update",
   "dash.updateRestartHint": "Recommended. The current GUI keeps running the old code until the proxy restarts.",
   "dash.runUpdate": "Update",

gui/src/i18n/ko.ts

@@ -79,6 +79,7 @@ export const ko: Record<TKey, string> = {
   "dash.updateCommand": "명령",
   "dash.updateSource": "현재는 소스 체크아웃입니다. 표시된 명령을 터미널에서 실행해 업데이트하세요.",
   "dash.updateUnavailable": "npm에서 최신 버전을 읽지 못했습니다. 잠시 후 다시 시도하세요.",
+  "dash.updateRetry": "Retry",
   "dash.updateRestart": "업데이트 후 재시작",
   "dash.updateRestartHint": "권장. 프록시를 재시작하기 전까지 현재 GUI는 이전 코드로 계속 실행됩니다.",
   "dash.runUpdate": "업데이트",

gui/src/i18n/zh.ts

@@ -79,6 +79,7 @@ export const zh: Record<TKey, string> = {
   "dash.updateCommand": "命令",
   "dash.updateSource": "当前是源码检出。请在终端运行显示的命令进行更新。",
   "dash.updateUnavailable": "无法从 npm 读取最新版本。请稍后重试。",
+  "dash.updateRetry": "Retry",
   "dash.updateRestart": "更新后重启",
   "dash.updateRestartHint": "推荐开启。代理重启前，当前 GUI 仍运行旧代码。",
   "dash.runUpdate": "更新",

gui/src/pages/Dashboard.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { formatUptime } from "../formatUptime";
 import { IconAlert, IconExternal, IconInfo, IconRefresh, IconX } from "../icons";
 import { useI18n, Trans } from "../i18n";
@@ -98,6 +98,7 @@ export default function Dashboard({ apiBase }: { apiBase: string }) {
   const [updateChannel, setUpdateChannel] = useState<UpdateChannel>("latest");
   const [updateRestart, setUpdateRestart] = useState(true);
   const [updateLoading, setUpdateLoading] = useState(false);
+  const updateRetryRef = useRef(0);
   const [updateCheck, setUpdateCheck] = useState<UpdateCheckData | null>(null);
   const [updateError, setUpdateError] = useState<string | null>(null);
   const [updateJob, setUpdateJob] = useState<UpdateJob | null>(null);
@@ -317,14 +318,25 @@ export default function Dashboard({ apiBase }: { apiBase: string }) {
       const data = await res.json() as UpdateCheckData | { error?: string };
       if (!res.ok) throw new Error("error" in data && data.error ? data.error : "update check failed");
       setUpdateCheck(data as UpdateCheckData);
+      updateRetryRef.current = 0;
     } catch (err) {
       setUpdateError(err instanceof Error ? err.message : String(err));
     } finally {
       setUpdateLoading(false);
+
+      setUpdateCheck(prev => {
+        if (!prev || prev.reason !== "latest_unavailable") return prev;
+        const max = 2;
+        if (updateRetryRef.current >= max) return prev;
+        updateRetryRef.current += 1;
+        setTimeout(() => { void fetchUpdateCheck(channel); }, 800 * updateRetryRef.current);
+        return prev;
+      });
     }
   };
 
   const openUpdateDialog = () => {
+    updateRetryRef.current = 0;
     const channel = defaultUpdateChannel(health?.version);
     setUpdateChannel(channel);
     setUpdateRestart(true);
@@ -333,6 +345,7 @@ export default function Dashboard({ apiBase }: { apiBase: string }) {
   };
 
   const changeUpdateChannel = (channel: UpdateChannel) => {
+    updateRetryRef.current = 0;
     setUpdateChannel(channel);
     fetchUpdateCheck(channel);
   };
@@ -692,7 +705,18 @@ export default function Dashboard({ apiBase }: { apiBase: string }) {
                   <div className="notice-warn" role="status"><IconAlert /> {t("dash.updateSource")}</div>
                 )}
                 {updateCheck.reason === "latest_unavailable" && (
-                  <div className="notice-warn" role="status"><IconAlert /> {t("dash.updateUnavailable")}</div>
+                  <div className="notice-warn" role="status">
+                    <IconAlert /> {t("dash.updateUnavailable")}
+                    <button
+                      type="button"
+                      className="btn btn-ghost btn-sm"
+                      disabled={updateLoading}
+                      onClick={() => { void fetchUpdateCheck(updateChannel); }}
+                      style={{ marginLeft: 12 }}
+                    >
+                      <IconRefresh /> {t("dash.updateRetry")}
+                    </button>
+                  </div>
                 )}
                 {updateCheck.canUpdate && (
                   <div className="spread update-restart">

src/update/index.ts

@@ -58,11 +58,27 @@ function npmSpawnTarget(bin: string): { bin: string; shell: boolean } {
   return { bin: "npm.cmd", shell: true };
 }
 
+const LATEST_VERSION_ATTEMPTS = 3;
+const LATEST_VERSION_RETRY_MS = 500;
+
+function sleepMs(ms: number): void {
+  const until = Date.now() + ms;
+  while (Date.now() < until) { /* sync backoff between npm view retries */ }
+}
+
 /** Latest published version from the registry (best-effort; null if npm isn't available). */
-export function latestVersion(tag: string): string | null {
+export function latestVersion(tag: string, options?: { attempts?: number }): string | null {
+  const attempts = Math.max(1, options?.attempts ?? LATEST_VERSION_ATTEMPTS);
   const npm = npmSpawnTarget("npm");
-  const r = spawnSync(npm.bin, ["view", `${PKG}@${tag}`, "version"], { encoding: "utf8", timeout: 12000, windowsHide: true, shell: npm.shell });
-  return r.status === 0 ? r.stdout.trim() : null;
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    const r = spawnSync(npm.bin, ["view", `${PKG}@${tag}`, "version"], { encoding: "utf8", timeout: 12000, windowsHide: true, shell: npm.shell });
+    if (r.status === 0) {
+      const version = r.stdout.trim();
+      if (version) return version;
+    }
+    if (attempt < attempts - 1) sleepMs(LATEST_VERSION_RETRY_MS * (attempt + 1));
+  }
+  return null;
 }
 
 /** The global-install command opencodex would run to update on this channel. */