@nextclaw/ui 0.12.22 → 0.12.23

package/dist/index.html

@@ -78,45 +78,45 @@
     })();
   </script>
   <title>NextClaw</title>
-  <script type="module" crossorigin src="/assets/index-Doxyk7L2.js"></script>
-  <link rel="modulepreload" crossorigin href="/assets/i18n-C5Mibli1.js">
-  <link rel="modulepreload" crossorigin href="/assets/chunk-JZWAC4HX-u4uYphxM.js">
-  <link rel="modulepreload" crossorigin href="/assets/api-lwyw9j7i.js">
-  <link rel="modulepreload" crossorigin href="/assets/es2015-yYU5Ad5w.js">
-  <link rel="modulepreload" crossorigin href="/assets/createLucideIcon-BZkY6emz.js">
-  <link rel="modulepreload" crossorigin href="/assets/select-Cw5Zkb1w.js">
-  <link rel="modulepreload" crossorigin href="/assets/dist-CuqvE--P.js">
-  <link rel="modulepreload" crossorigin href="/assets/x-DpTzXQcX.js">
-  <link rel="modulepreload" crossorigin href="/assets/dialog-CdtCU2xX.js">
-  <link rel="modulepreload" crossorigin href="/assets/popover-jbfQhYQh.js">
-  <link rel="modulepreload" crossorigin href="/assets/tooltip-GYzH-Hfq.js">
-  <link rel="modulepreload" crossorigin href="/assets/refresh-cw-BxojR62w.js">
-  <link rel="modulepreload" crossorigin href="/assets/use-config-BhJHD3-G.js">
-  <link rel="modulepreload" crossorigin href="/assets/theme-provider-B5XReW_-.js">
-  <link rel="modulepreload" crossorigin href="/assets/search-vChioOoe.js">
-  <link rel="modulepreload" crossorigin href="/assets/book-open-DgLqYpNY.js">
-  <link rel="modulepreload" crossorigin href="/assets/external-link-Sw3ah_JD.js">
-  <link rel="modulepreload" crossorigin href="/assets/folder-D7-VTnkz.js">
-  <link rel="modulepreload" crossorigin href="/assets/logos-CqVm0q0W.js">
-  <link rel="modulepreload" crossorigin href="/assets/loader-circle-B5i8oMMY.js">
-  <link rel="modulepreload" crossorigin href="/assets/plus-Di0KAkiO.js">
-  <link rel="modulepreload" crossorigin href="/assets/refresh-ccw-Bii4w8aB.js">
-  <link rel="modulepreload" crossorigin href="/assets/settings-CiRChctQ.js">
-  <link rel="modulepreload" crossorigin href="/assets/sparkles-D1ZKWdm4.js">
-  <link rel="modulepreload" crossorigin href="/assets/trash-2-rY9ZteZX.js">
-  <link rel="modulepreload" crossorigin href="/assets/doc-browser-context-DfLHAWbG.js">
-  <link rel="modulepreload" crossorigin href="/assets/doc-browser-CzCV73NJ.js">
-  <link rel="modulepreload" crossorigin href="/assets/doc-browser-BUlCkZo2.js">
-  <link rel="modulepreload" crossorigin href="/assets/use-viewport-layout-D33zVbr5.js">
-  <link rel="modulepreload" crossorigin href="/assets/logo-badge-BQgKnVtz.js">
-  <link rel="modulepreload" crossorigin href="/assets/skeleton-CFQRIUzt.js">
-  <link rel="modulepreload" crossorigin href="/assets/chat-DwUf7AKR.js">
-  <link rel="modulepreload" crossorigin href="/assets/key-round-CnI1mc9F.js">
-  <link rel="modulepreload" crossorigin href="/assets/message-square-D6Z4NwpG.js">
-  <link rel="modulepreload" crossorigin href="/assets/app-navigation.config-DgiR0c5_.js">
-  <link rel="modulepreload" crossorigin href="/assets/notice-card-BPtCVEKW.js">
-  <link rel="modulepreload" crossorigin href="/assets/status-dot-Dv_hiUVa.js">
-  <link rel="modulepreload" crossorigin href="/assets/app-manager-provider-C0ONQxUg.js">
+  <script type="module" crossorigin src="/assets/index-BrEdR78s.js"></script>
+  <link rel="modulepreload" crossorigin href="/assets/i18n-DnTGDIRw.js">
+  <link rel="modulepreload" crossorigin href="/assets/chunk-JZWAC4HX-Kydj4yEz.js">
+  <link rel="modulepreload" crossorigin href="/assets/api-BGd3rgv_.js">
+  <link rel="modulepreload" crossorigin href="/assets/es2015-V75WQJ2s.js">
+  <link rel="modulepreload" crossorigin href="/assets/createLucideIcon-BLMK3QUd.js">
+  <link rel="modulepreload" crossorigin href="/assets/select-DTdzR8j8.js">
+  <link rel="modulepreload" crossorigin href="/assets/dist-DsYTOyq7.js">
+  <link rel="modulepreload" crossorigin href="/assets/x-CM-XDMpk.js">
+  <link rel="modulepreload" crossorigin href="/assets/dialog-dxsKz7jJ.js">
+  <link rel="modulepreload" crossorigin href="/assets/popover-BMyiifTA.js">
+  <link rel="modulepreload" crossorigin href="/assets/tooltip-BOYp8Ue7.js">
+  <link rel="modulepreload" crossorigin href="/assets/refresh-cw-PcqoYB3K.js">
+  <link rel="modulepreload" crossorigin href="/assets/use-config-DTwhNDQE.js">
+  <link rel="modulepreload" crossorigin href="/assets/theme-provider-COAwWFv8.js">
+  <link rel="modulepreload" crossorigin href="/assets/search-CLd7m0M7.js">
+  <link rel="modulepreload" crossorigin href="/assets/book-open-DDlN5MvX.js">
+  <link rel="modulepreload" crossorigin href="/assets/external-link-DwfSfTLB.js">
+  <link rel="modulepreload" crossorigin href="/assets/folder-CeJKPx5P.js">
+  <link rel="modulepreload" crossorigin href="/assets/logos-C4sYP1Vl.js">
+  <link rel="modulepreload" crossorigin href="/assets/loader-circle-fd-vQKtW.js">
+  <link rel="modulepreload" crossorigin href="/assets/plus-D8eKFY7h.js">
+  <link rel="modulepreload" crossorigin href="/assets/refresh-ccw-ByVwmnN_.js">
+  <link rel="modulepreload" crossorigin href="/assets/settings-drbWqzA4.js">
+  <link rel="modulepreload" crossorigin href="/assets/sparkles-DVfeSVJQ.js">
+  <link rel="modulepreload" crossorigin href="/assets/trash-2-CBsHCfqq.js">
+  <link rel="modulepreload" crossorigin href="/assets/doc-browser-context-BJuMaI3o.js">
+  <link rel="modulepreload" crossorigin href="/assets/doc-browser-p82AdNO-.js">
+  <link rel="modulepreload" crossorigin href="/assets/doc-browser-C8FM5fC0.js">
+  <link rel="modulepreload" crossorigin href="/assets/use-viewport-layout-C0NJAVXs.js">
+  <link rel="modulepreload" crossorigin href="/assets/logo-badge-KAe-7d8c.js">
+  <link rel="modulepreload" crossorigin href="/assets/skeleton-BK1SOSRA.js">
+  <link rel="modulepreload" crossorigin href="/assets/chat-DGM6K3Qs.js">
+  <link rel="modulepreload" crossorigin href="/assets/key-round-CJ5gDAAG.js">
+  <link rel="modulepreload" crossorigin href="/assets/message-square-z_osm9c0.js">
+  <link rel="modulepreload" crossorigin href="/assets/app-navigation.config-BTdUuqXS.js">
+  <link rel="modulepreload" crossorigin href="/assets/notice-card-D1RNsTn_.js">
+  <link rel="modulepreload" crossorigin href="/assets/status-dot-ChvPCib9.js">
+  <link rel="modulepreload" crossorigin href="/assets/app-manager-provider-BuJ_U9eC.js">
   <link rel="stylesheet" crossorigin href="/assets/index-D8MKmXtO.css">
 </head>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ui",
-  "version": "0.12.22",
+  "version": "0.12.23",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -29,13 +29,13 @@
     "zod": "^3.23.8",
     "zustand": "^5.0.2",
     "@nextclaw/agent-chat": "0.1.13",
-    "@nextclaw/agent-chat-ui": "0.3.15",
     "@nextclaw/client-sdk": "0.1.3",
-    "@nextclaw/ncp": "0.5.8",
-    "@nextclaw/ncp-react": "0.4.28",
-    "@nextclaw/server": "0.12.15",
+    "@nextclaw/agent-chat-ui": "0.3.15",
     "@nextclaw/shared": "0.1.2",
-    "@nextclaw/ncp-http-agent-client": "0.3.20"
+    "@nextclaw/ncp-react": "0.4.28",
+    "@nextclaw/ncp-http-agent-client": "0.3.20",
+    "@nextclaw/ncp": "0.5.8",
+    "@nextclaw/server": "0.12.15"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",

package/src/features/account/hooks/use-auth.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import {
-  AUTH_STATUS_BOOTSTRAP_RETRY_DELAY_MS,
   isTransientAuthStatusBootstrapError,
+  resolveAuthStatusBootstrapRetryDelay,
   shouldRetryAuthStatusBootstrap
 } from './use-auth';
 
@@ -23,11 +23,13 @@ describe('auth status bootstrap retry policy', () => {
   });
 
   it('stops retrying after the bootstrap retry budget is exhausted', () => {
-    expect(shouldRetryAuthStatusBootstrap(39, new Error('Failed to fetch'))).toBe(true);
-    expect(shouldRetryAuthStatusBootstrap(40, new Error('Failed to fetch'))).toBe(false);
+    expect(shouldRetryAuthStatusBootstrap(7, new Error('Failed to fetch'))).toBe(true);
+    expect(shouldRetryAuthStatusBootstrap(8, new Error('Failed to fetch'))).toBe(false);
   });
 
-  it('keeps the retry delay short and predictable', () => {
-    expect(AUTH_STATUS_BOOTSTRAP_RETRY_DELAY_MS).toBe(250);
+  it('backs off retry delay without becoming sluggish', () => {
+    expect(resolveAuthStatusBootstrapRetryDelay(1)).toBe(500);
+    expect(resolveAuthStatusBootstrapRetryDelay(2)).toBe(1000);
+    expect(resolveAuthStatusBootstrapRetryDelay(4)).toBe(3000);
   });
 });

package/src/features/account/hooks/use-auth.ts

@@ -11,46 +11,49 @@ import {
 import type { AuthStatusView } from '@/shared/lib/api';
 import { toast } from 'sonner';
 import { t } from '@/shared/lib/i18n';
+import { isTransientRuntimeConnectionErrorMessage } from '@/shared/lib/transport';
 
-const AUTH_STATUS_BOOTSTRAP_MAX_RETRIES = 40;
-const AUTH_STATUS_BOOTSTRAP_TIMEOUT_MS = 400;
-export const AUTH_STATUS_BOOTSTRAP_RETRY_DELAY_MS = 250;
+const AUTH_STATUS_BOOTSTRAP_PROBE_POLICY = {
+  maxRetries: 8,
+  startupTimeoutMs: 2_000,
+  settledTimeoutMs: 5_000,
+  retryBaseDelayMs: 500,
+  retryMaxDelayMs: 3_000,
+} as const;
 
 export function isTransientAuthStatusBootstrapError(error: unknown): boolean {
   if (!(error instanceof Error)) {
     return false;
   }
-  const message = error.message.trim().toLowerCase();
-  if (!message) {
-    return false;
-  }
-  return (
-    message.includes('failed to fetch') ||
-    message.includes('networkerror') ||
-    message.includes('network request failed') ||
-    message.includes('load failed') ||
-    message.includes('request timed out') ||
-    message.includes('timed out waiting for remote request response') ||
-    message.includes('remote transport connection closed')
-  );
+  return isTransientRuntimeConnectionErrorMessage(error.message);
 }
 
 export function shouldRetryAuthStatusBootstrap(failureCount: number, error: unknown): boolean {
-  if (failureCount >= AUTH_STATUS_BOOTSTRAP_MAX_RETRIES) {
+  if (failureCount >= AUTH_STATUS_BOOTSTRAP_PROBE_POLICY.maxRetries) {
     return false;
   }
   return isTransientAuthStatusBootstrapError(error);
 }
 
+export function resolveAuthStatusBootstrapRetryDelay(failureCount: number): number {
+  return Math.min(
+    AUTH_STATUS_BOOTSTRAP_PROBE_POLICY.retryMaxDelayMs,
+    AUTH_STATUS_BOOTSTRAP_PROBE_POLICY.retryBaseDelayMs * 2 ** Math.max(0, failureCount - 1)
+  );
+}
+
 export function useAuthStatus() {
   const [bootstrapSettled, setBootstrapSettled] = useState(false);
   const query = useQuery<AuthStatusView>({
     queryKey: ['auth-status'],
-    queryFn: () => fetchAuthStatus({ timeoutMs: bootstrapSettled ? 5_000 : AUTH_STATUS_BOOTSTRAP_TIMEOUT_MS }),
+    queryFn: () => fetchAuthStatus({
+      timeoutMs: bootstrapSettled
+        ? AUTH_STATUS_BOOTSTRAP_PROBE_POLICY.settledTimeoutMs
+        : AUTH_STATUS_BOOTSTRAP_PROBE_POLICY.startupTimeoutMs,
+    }),
     staleTime: 5_000,
     retry: shouldRetryAuthStatusBootstrap,
-    retryDelay: AUTH_STATUS_BOOTSTRAP_RETRY_DELAY_MS,
-    refetchOnWindowFocus: true
+    retryDelay: resolveAuthStatusBootstrapRetryDelay
   });
 
   useEffect(() => {

package/src/features/system-status/hooks/use-system-status.ts

@@ -10,46 +10,24 @@ import {
 import { systemStatusManager } from '@/features/system-status/managers/system-status.manager';
 import { useSystemStatusStore } from '@/features/system-status/stores/system-status.store';
 
-function createPendingBootstrapStatus(): BootstrapStatusView {
-  return {
-    phase: 'kernel-starting',
-    ncpAgent: {
-      state: 'pending',
-    },
-    pluginHydration: {
-      state: 'pending',
-      loadedPluginCount: 0,
-      totalPluginCount: 0,
-    },
-    channels: {
-      state: 'pending',
-      enabled: [],
-    },
-    remote: {
-      state: 'pending',
-    },
-  };
-}
-
 export function useSystemStatusSources() {
-  const runtimeBootstrapStatus = useQuery({
+  const runtimeBootstrapStatus = useQuery<BootstrapStatusView>({
     queryKey: ['runtime-bootstrap-status'],
-    queryFn: fetchBootstrapStatus,
-    placeholderData: createPendingBootstrapStatus,
+    queryFn: () => fetchBootstrapStatus({
+      timeoutMs: 5_000,
+    }),
     refetchInterval: (query) => {
       return systemStatusManager.getRuntimeBootstrapPollInterval(
-        query.state.data
+        query.state.data,
+        query.state.fetchFailureCount
       );
     },
-    refetchIntervalInBackground: true,
     retry: false,
-    refetchOnWindowFocus: true,
   });
   const runtimeControl = useQuery({
     queryKey: ['runtime-control'],
     queryFn: async () => await systemStatusManager.getRuntimeControl(),
     staleTime: 5_000,
-    refetchOnWindowFocus: true,
   });
 
   useEffect(() => {

package/src/features/system-status/index.ts

@@ -1,5 +1,6 @@
 export { useRuntimeControlPanelView, useRuntimeStatusBadgeView, useSystemStatus, useSystemStatusSources } from './hooks/use-system-status';
-export { isTransientRuntimeConnectionErrorMessage, systemStatusManager } from './managers/system-status.manager';
+export { systemStatusManager } from './managers/system-status.manager';
+export { isTransientRuntimeConnectionErrorMessage } from '@/shared/lib/transport';
 export { runtimeUpdateManager } from './managers/runtime-update.manager';
 export type { SystemStatusState, SystemStatusView } from './types/system-status.types';
 export { useSystemStatusStore } from './stores/system-status.store';

package/src/features/system-status/managers/system-status.manager.bootstrap-polling.test.ts

@@ -16,7 +16,7 @@ describe('getRuntimeBootstrapPollInterval', () => {
 
   it('keeps polling while bootstrap status is missing', () => {
     expect(systemStatusManager.getRuntimeBootstrapPollInterval(undefined)).toBe(
-      500
+      1000
     );
   });
 
@@ -40,7 +40,7 @@ describe('getRuntimeBootstrapPollInterval', () => {
           state: 'pending',
         },
       })
-    ).toBe(500);
+    ).toBe(1000);
   });
 
   it('continues polling even when bootstrap status reports an ncp agent error', () => {
@@ -65,7 +65,7 @@ describe('getRuntimeBootstrapPollInterval', () => {
         },
         lastError: 'startup failed',
       })
-    ).toBe(500);
+    ).toBe(2000);
   });
 
   it('stops polling once the ncp agent is ready', () => {
@@ -121,6 +121,16 @@ describe('getRuntimeBootstrapPollInterval', () => {
           state: 'disabled',
         },
       })
-    ).toBe(500);
+    ).toBe(1000);
   });
+
+  it('backs off polling after transport failures', () => {
+    expect(
+      systemStatusManager.getRuntimeBootstrapPollInterval(undefined, 1)
+    ).toBe(2000);
+    expect(
+      systemStatusManager.getRuntimeBootstrapPollInterval(undefined, 3)
+    ).toBe(5000);
+  });
+
 });

package/src/features/system-status/managers/system-status.manager.test.ts

@@ -1,10 +1,8 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import type { BootstrapStatusView } from '@/shared/lib/api';
 import { appQueryClient } from '@/app-query-client';
-import {
-  isTransientRuntimeConnectionErrorMessage,
-  systemStatusManager,
-} from './system-status.manager';
+import { systemStatusManager } from './system-status.manager';
+import { isTransientRuntimeConnectionErrorMessage } from '@/shared/lib/transport';
 import { useSystemStatusStore } from '@/features/system-status/stores/system-status.store';
 
 const readyBootstrapStatus: BootstrapStatusView = {
@@ -76,9 +74,6 @@ describe('systemStatusManager', () => {
   });
 
   it('enters recovering only after the page has previously reached ready', async () => {
-    const invalidateQueriesSpy = vi
-      .spyOn(appQueryClient, 'invalidateQueries')
-      .mockResolvedValue(undefined as never);
     const refetchQueriesSpy = vi
       .spyOn(appQueryClient, 'refetchQueries')
       .mockResolvedValue(undefined as never);
@@ -93,7 +88,6 @@ describe('systemStatusManager', () => {
     systemStatusManager.reportBootstrapStatus(readyBootstrapStatus);
 
     expect(useSystemStatusStore.getState().state.lifecyclePhase).toBe('ready');
-    expect(invalidateQueriesSpy).toHaveBeenCalled();
     expect(refetchQueriesSpy).toHaveBeenCalledWith({ type: 'active' });
   });
 

package/src/features/system-status/managers/system-status.manager.ts

@@ -21,8 +21,14 @@ import {
   initialSystemStatusState,
   useSystemStatusStore,
 } from '@/features/system-status/stores/system-status.store';
+import { isTransientRuntimeConnectionErrorMessage } from '@/shared/lib/transport';
 
 const RECOVERY_TIMEOUT_MS = 30_000;
+const RUNTIME_BOOTSTRAP_PROBE_POLICY = {
+  activePollIntervalMs: 1_000,
+  errorPollIntervalMs: 2_000,
+  maxErrorPollIntervalMs: 5_000,
+} as const;
 
 function getErrorMessage(error: unknown): string {
   if (error instanceof Error) {
@@ -53,46 +59,34 @@ function resolveActionHelp(action: RuntimeControlAction): string {
   return t('runtimeControlRestartingAppHelp');
 }
 
-export function isTransientRuntimeConnectionErrorMessage(
-  message: string
-): boolean {
-  const normalized = message.trim().toLowerCase();
-  if (!normalized) {
-    return false;
-  }
-  return (
-    normalized.includes('failed to fetch') ||
-    normalized.includes('networkerror') ||
-    normalized.includes('network request failed') ||
-    normalized.includes('load failed') ||
-    normalized.includes('request timed out') ||
-    normalized.includes('timed out waiting for remote request response') ||
-    normalized.includes('remote transport connection closed') ||
-    normalized.includes('websocket error') ||
-    normalized.includes('fetch failed on ') ||
-    normalized.includes('stream request failed for ') ||
-    normalized.includes('ncp fetch failed for ')
-  );
-}
-
 export class SystemStatusManager {
   private recoveryTimeoutId: number | null = null;
 
   getRuntimeBootstrapPollInterval = (
-    status: BootstrapStatusView | null | undefined
+    status: BootstrapStatusView | null | undefined,
+    fetchFailureCount = 0
   ): number | false => {
     const { lifecyclePhase, activeSystemAction } = this.getState();
+    if (fetchFailureCount > 0) {
+      return Math.min(
+        RUNTIME_BOOTSTRAP_PROBE_POLICY.maxErrorPollIntervalMs,
+        RUNTIME_BOOTSTRAP_PROBE_POLICY.errorPollIntervalMs * fetchFailureCount
+      );
+    }
     if (
       lifecyclePhase === 'recovering' ||
       lifecyclePhase === 'stalled' ||
       activeSystemAction?.lifecycle === 'recovering'
     ) {
-      return 500;
+      return RUNTIME_BOOTSTRAP_PROBE_POLICY.activePollIntervalMs;
     }
     if (status?.ncpAgent.state === 'ready') {
       return false;
     }
-    return 500;
+    if (status?.ncpAgent.state === 'error' || status?.phase === 'error') {
+      return RUNTIME_BOOTSTRAP_PROBE_POLICY.errorPollIntervalMs;
+    }
+    return RUNTIME_BOOTSTRAP_PROBE_POLICY.activePollIntervalMs;
   };
 
   getRuntimeControl = async (): Promise<RuntimeControlView> => {
@@ -343,10 +337,7 @@ export class SystemStatusManager {
     });
 
     if (shouldRefreshQueries) {
-      void Promise.all([
-        appQueryClient.invalidateQueries(),
-        appQueryClient.refetchQueries({ type: 'active' }),
-      ]);
+      void appQueryClient.refetchQueries({ type: 'active' });
     }
   };
 
@@ -413,7 +404,6 @@ export class SystemStatusManager {
       const view = await this.getRuntimeControl();
       this.syncRuntimeControlQueryCache(view);
       this.reportRuntimeControlView(view);
-      await appQueryClient.invalidateQueries({ queryKey: ['runtime-control'] });
     } catch (error) {
       this.reportRuntimeControlError(error);
     }

package/src/shared/components/common/brand-header.test.tsx

@@ -3,6 +3,7 @@ import userEvent from '@testing-library/user-event';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { MemoryRouter } from 'react-router-dom';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type * as SystemStatusModule from '@/features/system-status';
 import { useRuntimeUpdateStore } from '@/features/system-status';
 import { BrandHeader } from '@/shared/components/common/brand-header';
 import { setLanguage } from '@/shared/lib/i18n';
@@ -13,9 +14,7 @@ const mocks = vi.hoisted(() => ({
 }));
 
 vi.mock('@/features/system-status', async () => {
-  const actual = await vi.importActual<typeof import('@/features/system-status')>(
-    '@/features/system-status'
-  );
+  const actual = await vi.importActual<typeof SystemStatusModule>('@/features/system-status');
   return {
     ...actual,
     runtimeUpdateManager: {
@@ -144,4 +143,86 @@ describe('BrandHeader', () => {
     expect(mocks.applyDownloadedUpdate).toHaveBeenCalledTimes(1);
     expect(mocks.downloadUpdate).not.toHaveBeenCalled();
   });
+
+  it('shows a warning icon with the blocked update reason instead of a visible failure label', async () => {
+    useRuntimeUpdateStore.setState({
+      supported: true,
+      initialized: true,
+      busyAction: null,
+      snapshot: {
+        status: 'blocked',
+        installationKind: 'npm-runtime-bundle',
+        channel: 'stable',
+        hostVersion: '0.19.4',
+        currentVersion: '0.19.4',
+        availableVersion: null,
+        downloadedVersion: null,
+        minimumHostVersion: null,
+        releaseNotesUrl: null,
+        lastCheckedAt: null,
+        progress: null,
+        canAutoDownload: true,
+        canApplyInApp: false,
+        requiresRestart: false,
+        blockReason: 'signature-verification-unavailable',
+        recoveryCommand: 'Set NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY',
+        errorMessage: 'Runtime bundle updates require a configured update public key.',
+        preferences: {
+          automaticChecks: true,
+          autoDownload: true
+        }
+      }
+    });
+
+    renderBrandHeader();
+
+    expect(screen.queryByText('更新异常')).toBeNull();
+    const issueIcon = screen.getByLabelText('更新被阻塞');
+
+    expect(issueIcon.textContent).toBe('!');
+    expect(issueIcon.getAttribute('title')).toContain('更新被阻塞');
+    expect(issueIcon.getAttribute('title')).toContain('根因：缺少更新签名公钥，无法验证更新包来源');
+    expect(issueIcon.getAttribute('title')).toContain('Runtime bundle updates require a configured update public key.');
+    expect(issueIcon.getAttribute('title')).toContain('Set NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY');
+  });
+
+  it('uses the failed update wording only for failed snapshots', async () => {
+    useRuntimeUpdateStore.setState({
+      supported: true,
+      initialized: true,
+      busyAction: null,
+      snapshot: {
+        status: 'failed',
+        installationKind: 'npm-runtime-bundle',
+        channel: 'stable',
+        hostVersion: '0.19.4',
+        currentVersion: '0.19.3',
+        availableVersion: '0.19.4',
+        downloadedVersion: null,
+        minimumHostVersion: null,
+        releaseNotesUrl: null,
+        lastCheckedAt: null,
+        progress: null,
+        canAutoDownload: true,
+        canApplyInApp: false,
+        requiresRestart: false,
+        blockReason: null,
+        recoveryCommand: null,
+        errorMessage: 'runtime bundle sha256 mismatch',
+        preferences: {
+          automaticChecks: true,
+          autoDownload: true
+        }
+      }
+    });
+
+    renderBrandHeader();
+
+    const issueIcon = screen.getByLabelText('更新失败');
+
+    expect(issueIcon.textContent).toBe('!');
+    expect(issueIcon.getAttribute('title')).toContain('更新失败');
+    expect(issueIcon.getAttribute('title')).toContain('runtime bundle sha256 mismatch');
+    expect(screen.queryByText('更新被阻塞')).toBeNull();
+  });
 });