@nextclaw/ui 0.14.4 → 0.15.1

package/src/features/side-dock/managers/__tests__/side-dock.manager.test.ts

@@ -1,9 +1,24 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+  getSideDockBuiltInItems,
+  SIDE_DOCK_GITHUB_PROJECT_ITEM_ID,
+  SIDE_DOCK_GITHUB_PROJECT_URL,
+} from '@/features/side-dock/configs/side-dock-built-in-items.config';
 import { SideDockManager } from '@/features/side-dock/managers/side-dock.manager';
 import { useSideDockStore } from '@/features/side-dock/stores/side-dock.store';
 import type { SideDockItem } from '@/features/side-dock/types/side-dock.types';
 import type { DocBrowserManager } from '@/shared/components/doc-browser/managers/doc-browser.manager';
 
+const mocks = vi.hoisted(() => ({
+  openExternalUrl: vi.fn(),
+}));
+
+vi.mock('@/shared/lib/host-capabilities', () => ({
+  hostCapabilityManager: {
+    openExternalUrl: mocks.openExternalUrl,
+  },
+}));
+
 const customItem: SideDockItem = {
   builtIn: false,
   icon: { type: 'builtin', name: 'docs' },
@@ -16,14 +31,17 @@ const customItem: SideDockItem = {
 describe('SideDockManager', () => {
   beforeEach(() => {
     window.localStorage.clear();
+    mocks.openExternalUrl.mockReset();
+    mocks.openExternalUrl.mockResolvedValue({ opened: true });
+    useSideDockStore.getState().setVisible(true);
     useSideDockStore.getState().setPinnedItems([]);
   });
 
-  it('opens right panel resource items through DocBrowserManager', () => {
+  it('opens right panel resource items through DocBrowserManager', async () => {
     const open = vi.fn();
     const manager = new SideDockManager({ open } as unknown as DocBrowserManager);
 
-    manager.openItem(customItem);
+    await manager.openItem(customItem);
 
     expect(open).toHaveBeenCalledWith('nextclaw://docs/custom', {
       dockIcon: { type: 'builtin', name: 'docs' },
@@ -31,6 +49,18 @@ describe('SideDockManager', () => {
     });
   });
 
+  it('opens the GitHub project shortcut through host capabilities', async () => {
+    const open = vi.fn();
+    const manager = new SideDockManager({ open } as unknown as DocBrowserManager);
+    const githubItem = getSideDockBuiltInItems().find((item) => item.id === SIDE_DOCK_GITHUB_PROJECT_ITEM_ID);
+
+    expect(githubItem).toBeTruthy();
+    await manager.openItem(githubItem as SideDockItem);
+
+    expect(open).not.toHaveBeenCalled();
+    expect(mocks.openExternalUrl).toHaveBeenCalledWith(SIDE_DOCK_GITHUB_PROJECT_URL);
+  });
+
   it('pins removable items and keeps built-in items immutable', () => {
     const manager = new SideDockManager({ open: vi.fn() } as unknown as DocBrowserManager);
 

package/src/features/side-dock/managers/side-dock.manager.ts

@@ -10,6 +10,7 @@ import {
   createPinnedSideDockItem,
   mergeSideDockItems,
 } from '@/features/side-dock/utils/side-dock-item.utils';
+import { hostCapabilityManager } from '@/shared/lib/host-capabilities';
 import type { DocBrowserManager } from '@/shared/components/doc-browser/managers/doc-browser.manager';
 import type {
   DocBrowserDockIcon,
@@ -20,6 +21,7 @@ const SIDE_DOCK_PINNED_ITEM_ID_PREFIX = 'pinned';
 const SIDE_DOCK_ICON_NAMES = new Set<SideDockIconName>([
   'apps',
   'docs',
+  'github',
   'new-tab',
   'panel-app',
   'service-apps',
@@ -78,12 +80,16 @@ export class SideDockManager {
     useSideDockStore.getState().pinnedItems,
   );
 
-  openItem = (item: Pick<SideDockItem, 'icon' | 'label' | 'target'>): void => {
+  openItem = async (item: Pick<SideDockItem, 'icon' | 'label' | 'target'>): Promise<void> => {
     if (item.target.type === 'right-panel-resource') {
       this.docBrowserManager.open(item.target.uri, {
         dockIcon: item.icon,
         title: item.label,
       });
+      return;
+    }
+    if (item.target.type === 'external-url') {
+      await hostCapabilityManager.openExternalUrl(item.target.url);
     }
   };
 
@@ -130,18 +136,19 @@ export class SideDockManager {
   };
 
   pinItem = (item: SideDockItem, createdAt: string = new Date().toISOString()): void => {
-    if (!item.removable) {
+    if (!item.removable || item.target.type !== 'right-panel-resource') {
       return;
     }
     const uri = normalizeSideDockResourceUri(item.target.uri);
+    const resourceItem = {
+      ...item,
+      target: { type: 'right-panel-resource' as const, uri },
+    };
     this.setPinnedItems((items) => {
       if (items.some((pinnedItem) => pinnedItem.id === item.id || normalizeSideDockResourceUri(pinnedItem.target.uri) === uri)) {
         return items;
       }
-      return [...items, createPinnedSideDockItem({
-        ...item,
-        target: { ...item.target, uri },
-      }, createdAt)];
+      return [...items, createPinnedSideDockItem(resourceItem, createdAt)];
     });
   };
 
@@ -176,6 +183,9 @@ export class SideDockManager {
 
   private findItemByUri = (uri: string): SideDockItem | undefined => {
     const normalized = normalizeSideDockResourceUri(uri);
-    return this.getItems().find((item) => normalizeSideDockResourceUri(item.target.uri) === normalized);
+    return this.getItems().find((item) => (
+      item.target.type === 'right-panel-resource'
+      && normalizeSideDockResourceUri(item.target.uri) === normalized
+    ));
   };
 }

package/src/features/side-dock/stores/side-dock.store.ts

@@ -7,7 +7,9 @@ const SIDE_DOCK_STORAGE_KEY = 'nextclaw.side-dock.state';
 const SIDE_DOCK_STORAGE_VERSION = 1;
 
 type SideDockStore = {
+  isVisible: boolean;
   pinnedItems: SideDockPinnedItem[];
+  setVisible: (isVisible: boolean) => void;
   setPinnedItems: (items: SideDockPinnedItem[]) => void;
 };
 
@@ -18,7 +20,9 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 export const useSideDockStore = create<SideDockStore>()(
   persist(
     (set) => ({
+      isVisible: true,
       pinnedItems: [],
+      setVisible: (isVisible) => set({ isVisible }),
       setPinnedItems: (items) => set({ pinnedItems: normalizeSideDockPinnedItems(items) }),
     }),
     {
@@ -26,14 +30,19 @@ export const useSideDockStore = create<SideDockStore>()(
       version: SIDE_DOCK_STORAGE_VERSION,
       storage: createJSONStorage(() => window.localStorage),
       partialize: (state) => ({
+        isVisible: state.isVisible,
         pinnedItems: state.pinnedItems,
       }),
       merge: (persistedState, currentState) => {
         const pinnedItems = isRecord(persistedState)
           ? normalizeSideDockPinnedItems(persistedState.pinnedItems)
           : [];
+        const isVisible = isRecord(persistedState) && typeof persistedState.isVisible === 'boolean'
+          ? persistedState.isVisible
+          : true;
         return {
           ...currentState,
+          isVisible,
           pinnedItems,
         };
       },

package/src/features/side-dock/types/side-dock.types.ts

@@ -1,11 +1,18 @@
 export type SideDockItemId = string;
 
-export type SideDockItemTarget = {
+export type SideDockResourceItemTarget = {
   type: 'right-panel-resource';
   uri: string;
 };
 
-export type SideDockIconName = 'apps' | 'docs' | 'new-tab' | 'panel-app' | 'service-apps';
+export type SideDockExternalUrlTarget = {
+  type: 'external-url';
+  url: string;
+};
+
+export type SideDockItemTarget = SideDockResourceItemTarget | SideDockExternalUrlTarget;
+
+export type SideDockIconName = 'apps' | 'docs' | 'github' | 'new-tab' | 'panel-app' | 'service-apps';
 
 export type SideDockItemIcon =
   | { type: 'builtin'; name: SideDockIconName }
@@ -26,7 +33,7 @@ export type SideDockPinnedItem = {
   icon: SideDockItemIcon;
   id: SideDockItemId;
   label: string;
-  target: SideDockItemTarget;
+  target: SideDockResourceItemTarget;
 };
 
 export type SideDockResourceDockState = {

package/src/features/side-dock/utils/side-dock-item.utils.ts

@@ -3,11 +3,13 @@ import type {
   SideDockItem,
   SideDockItemIcon,
   SideDockPinnedItem,
+  SideDockResourceItemTarget,
 } from '@/features/side-dock/types/side-dock.types';
 
 const SIDE_DOCK_BUILTIN_ICON_NAMES: SideDockIconName[] = [
   'apps',
   'docs',
+  'github',
   'new-tab',
   'panel-app',
   'service-apps',
@@ -99,7 +101,10 @@ export function normalizeSideDockPinnedItems(value: unknown): SideDockPinnedItem
   return Array.from(itemsById.values());
 }
 
-export function createPinnedSideDockItem(item: SideDockItem, createdAt: string): SideDockPinnedItem {
+export function createPinnedSideDockItem(
+  item: SideDockItem & { target: SideDockResourceItemTarget },
+  createdAt: string,
+): SideDockPinnedItem {
   return {
     createdAt,
     icon: item.icon,
@@ -109,6 +114,10 @@ export function createPinnedSideDockItem(item: SideDockItem, createdAt: string):
   };
 }
 
+function getSideDockResourceUri(item: SideDockItem | SideDockPinnedItem): string | null {
+  return item.target.type === 'right-panel-resource' ? item.target.uri : null;
+}
+
 export function createSideDockItemFromPinnedItem(item: SideDockPinnedItem): SideDockItem {
   return {
     builtIn: false,
@@ -125,7 +134,11 @@ export function mergeSideDockItems(
   pinnedItems: SideDockPinnedItem[],
 ): SideDockItem[] {
   const seenIds = new Set(builtInItems.map((item) => item.id));
-  const seenUris = new Set(builtInItems.map((item) => item.target.uri));
+  const seenUris = new Set(
+    builtInItems
+      .map(getSideDockResourceUri)
+      .filter((uri): uri is string => uri !== null),
+  );
   const customItems = pinnedItems
     .filter((item) => !seenIds.has(item.id) && !seenUris.has(item.target.uri))
     .map(createSideDockItemFromPinnedItem);

package/src/features/system-status/components/__tests__/desktop-update-config.test.tsx

@@ -1,6 +1,7 @@
 import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { useRuntimeUpdateStore } from '@/features/system-status';
 import { DesktopUpdateConfig } from '@/features/system-status/components/desktop-update-config';
 import { setLanguage } from '@/shared/lib/i18n';
@@ -26,6 +27,22 @@ vi.mock('@/features/system-status', async () => {
   };
 });
 
+function renderDesktopUpdateConfig() {
+  const queryClient = new QueryClient({
+    defaultOptions: {
+      queries: {
+        gcTime: 0,
+        retry: false
+      }
+    }
+  });
+  return render(
+    <QueryClientProvider client={queryClient}>
+      <DesktopUpdateConfig />
+    </QueryClientProvider>
+  );
+}
+
 describe('DesktopUpdateConfig', () => {
   beforeEach(() => {
     setLanguage('zh');
@@ -60,7 +77,7 @@ describe('DesktopUpdateConfig', () => {
         availableVersion: '0.18.2-beta.1',
         downloadedVersion: null,
         minimumHostVersion: null,
-        releaseNotesUrl: 'https://example.com/release-notes',
+        releaseNotesUrl: null,
         lastCheckedAt: '2026-04-13T12:00:00.000Z',
         progress: null,
         canAutoDownload: false,
@@ -77,8 +94,12 @@ describe('DesktopUpdateConfig', () => {
     });
   });
 
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
   it('renders current channel information and beta guidance', () => {
-    render(<DesktopUpdateConfig />);
+    renderDesktopUpdateConfig();
 
     expect(mocks.start).not.toHaveBeenCalled();
     expect(mocks.stop).not.toHaveBeenCalled();
@@ -93,7 +114,7 @@ describe('DesktopUpdateConfig', () => {
   it('sends the newly selected release channel to the desktop update manager', async () => {
     const user = userEvent.setup();
 
-    render(<DesktopUpdateConfig />);
+    renderDesktopUpdateConfig();
 
     await user.click(screen.getByRole('combobox'));
     await user.click(screen.getByRole('option', { name: 'Stable' }));
@@ -118,9 +139,80 @@ describe('DesktopUpdateConfig', () => {
         : null
     }));
 
-    render(<DesktopUpdateConfig />);
+    renderDesktopUpdateConfig();
 
     expect(screen.getByText('正在下载 50%')).toBeTruthy();
     expect(screen.getByText('50 B / 100 B')).toBeTruthy();
   });
+
+  it('loads structured release notes from the docs JSON endpoint', async () => {
+    const fetchMock = vi.fn(async () => new Response(JSON.stringify({
+      schemaVersion: 1,
+      product: 'NextClaw',
+      version: '0.22.0',
+      sections: [
+        {
+          kind: 'feature',
+          title: {
+            'zh-CN': '功能',
+            'en-US': 'Features'
+          },
+          items: [
+            {
+              title: {
+                'zh-CN': '更新前查看内容',
+                'en-US': 'Review before updating'
+              },
+              body: {
+                'zh-CN': '更新提示可以直接展示本版本的结构化说明。',
+                'en-US': 'The update prompt can show structured notes for this version.'
+              }
+            }
+          ]
+        },
+        {
+          kind: 'fix',
+          title: {
+            'zh-CN': '修复',
+            'en-US': 'Fixes'
+          },
+          items: [
+            {
+              title: {
+                'zh-CN': '附件发送修复',
+                'en-US': 'Attachment delivery fix'
+              }
+            }
+          ]
+        }
+      ]
+    }), {
+      headers: { 'content-type': 'application/json' },
+      status: 200
+    }));
+    vi.stubGlobal('fetch', fetchMock);
+    useRuntimeUpdateStore.setState((state) => ({
+      ...state,
+      snapshot: state.snapshot
+        ? {
+            ...state.snapshot,
+            status: 'update-available',
+            availableVersion: '0.22.0',
+            releaseNotesUrl: 'https://docs.nextclaw.io/zh/notes/2026-07-05-nextclaw-v0-22-0'
+          }
+        : null
+    }));
+
+    renderDesktopUpdateConfig();
+
+    expect(await screen.findByText('更新前查看内容')).toBeTruthy();
+    expect(screen.getByText('修复')).toBeTruthy();
+    expect(fetchMock).toHaveBeenCalledWith(
+      'https://docs.nextclaw.io/release-notes/nextclaw-v0.22.0.json',
+      expect.objectContaining({
+        cache: 'no-store',
+        headers: { accept: 'application/json' }
+      })
+    );
+  });
 });

package/src/features/system-status/components/desktop-update-config.tsx

@@ -1,4 +1,5 @@
 import type { UpdateSnapshot } from '@nextclaw/shared';
+import { useQuery } from '@tanstack/react-query';
 import { runtimeUpdateManager, useRuntimeUpdateStore } from '@/features/system-status';
 import { Button } from '@/shared/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/components/ui/card';
@@ -6,9 +7,16 @@ import { Label } from '@/shared/components/ui/label';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/shared/components/ui/select';
 import { Switch } from '@/shared/components/ui/switch';
 import { PageHeader, PageLayout } from '@/app/components/layout/page-layout';
-import { formatDateTime, t } from '@/shared/lib/i18n';
+import { formatDateTime, getLanguage, t } from '@/shared/lib/i18n';
 import { cn } from '@/shared/lib/utils';
 import { hostCapabilityManager } from '@/shared/lib/host-capabilities';
+import {
+  fetchReleaseNotesData,
+  readReleaseNotesText,
+  resolveReleaseNotesDataUrl,
+  type ReleaseNotesLocale,
+  type ReleaseNotesSection
+} from '@/features/system-status/utils/update-release-notes.utils';
 import { Download, ExternalLink, RefreshCw, RotateCw } from 'lucide-react';
 
 const STATUS_LABEL_KEYS: Record<string, string> = {
@@ -21,6 +29,13 @@ const STATUS_LABEL_KEYS: Record<string, string> = {
   failed: 'desktopUpdatesStatusFailed',
 };
 
+const RELEASE_NOTES_KIND_LABEL_KEYS: Record<string, string> = {
+  feature: 'desktopUpdatesReleaseNotesFeature',
+  enhancement: 'desktopUpdatesReleaseNotesEnhancement',
+  fix: 'desktopUpdatesReleaseNotesFix',
+  compatibility: 'desktopUpdatesReleaseNotesCompatibility'
+};
+
 function StatusBadge({ status }: { status: string }) {
   return <span className={cn('inline-flex rounded-full px-3 py-1 text-xs font-medium ring-1', getStatusTone(status))}>{getStatusLabel(status)}</span>;
 }
@@ -117,6 +132,80 @@ function getStatusTone(status: string): string {
   return 'bg-gray-100 text-gray-700 ring-gray-200';
 }
 
+function getReleaseNotesLocale(): ReleaseNotesLocale {
+  return getLanguage() === 'zh' ? 'zh-CN' : 'en-US';
+}
+
+function getReleaseNotesSectionTitle(section: ReleaseNotesSection, locale: ReleaseNotesLocale): string {
+  const title = readReleaseNotesText(section.title, locale);
+  return title ?? t(RELEASE_NOTES_KIND_LABEL_KEYS[section.kind] ?? 'desktopUpdatesReleaseNotesEnhancement');
+}
+
+function ReleaseNotesPreview({ snapshot }: { snapshot: UpdateSnapshot }) {
+  const dataUrl = resolveReleaseNotesDataUrl(snapshot);
+  const locale = getReleaseNotesLocale();
+  const releaseNotesQuery = useQuery({
+    queryKey: ['runtime-release-notes', dataUrl],
+    queryFn: async () => await fetchReleaseNotesData(dataUrl ?? ''),
+    enabled: Boolean(dataUrl),
+    retry: false,
+    staleTime: 5 * 60 * 1000
+  });
+  const payload = releaseNotesQuery.data;
+  const title = readReleaseNotesText(payload?.title, locale) ?? t('desktopUpdatesReleaseNotesPreviewTitle');
+  const summary = readReleaseNotesText(payload?.summary, locale) ?? t('desktopUpdatesReleaseNotesPreviewDescription');
+
+  if (!snapshot.releaseNotesUrl) {
+    return null;
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <div className="flex flex-wrap items-start justify-between gap-3">
+          <div className="space-y-1">
+            <CardTitle>{title}</CardTitle>
+            <CardDescription>{summary}</CardDescription>
+          </div>
+          <Button variant="ghost" onClick={() => void hostCapabilityManager.openExternalUrl(snapshot.releaseNotesUrl ?? '')}>
+            <ExternalLink className="mr-2 h-4 w-4" />
+            {t('desktopUpdatesReleaseNotes')}
+          </Button>
+        </div>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        {releaseNotesQuery.isLoading ? (
+          <p className="text-sm text-gray-500">{t('desktopUpdatesReleaseNotesPreviewLoading')}</p>
+        ) : null}
+        {!dataUrl || releaseNotesQuery.isError ? (
+          <p className="text-sm text-gray-500">{t('desktopUpdatesReleaseNotesPreviewUnavailable')}</p>
+        ) : null}
+        {payload ? (
+          <div className="grid gap-4 md:grid-cols-2">
+            {payload.sections.map((section) => (
+              <div key={section.kind} className="rounded-xl border border-gray-200 bg-gray-50/60 p-4">
+                <p className="text-sm font-semibold text-gray-900">{getReleaseNotesSectionTitle(section, locale)}</p>
+                <ul className="mt-3 space-y-3">
+                  {section.items.map((item, index) => {
+                    const itemTitle = readReleaseNotesText(item.title, locale);
+                    const itemBody = readReleaseNotesText(item.body, locale);
+                    return (
+                      <li key={`${itemTitle ?? section.kind}-${index}`} className="space-y-1">
+                        {itemTitle ? <p className="text-sm font-medium text-gray-800">{itemTitle}</p> : null}
+                        {itemBody ? <p className="text-sm leading-5 text-gray-600">{itemBody}</p> : null}
+                      </li>
+                    );
+                  })}
+                </ul>
+              </div>
+            ))}
+          </div>
+        ) : null}
+      </CardContent>
+    </Card>
+  );
+}
+
 function RuntimeUpdateUnavailableState() {
   return (
     <PageLayout className="space-y-6">
@@ -192,6 +281,7 @@ export function DesktopUpdateConfig() {
           {snapshot.errorMessage && snapshot.status !== 'blocked' ? <div className="rounded-2xl border border-red-200 bg-red-50/70 p-4 text-sm text-red-700">{snapshot.errorMessage}</div> : null}
         </CardContent>
       </Card>
+      <ReleaseNotesPreview snapshot={snapshot} />
       <Card>
         <CardHeader>
           <CardTitle>{t('desktopUpdatesPreferencesTitle')}</CardTitle>
@@ -250,7 +340,6 @@ export function DesktopUpdateConfig() {
             <RotateCw className={cn('mr-2 h-4 w-4', isApplying && 'animate-spin')} />
             {t('runtimeUpdatesApplyNow')}
           </Button>
-          {snapshot.releaseNotesUrl ? <Button variant="ghost" onClick={() => void hostCapabilityManager.openExternalUrl(snapshot.releaseNotesUrl ?? '')}><ExternalLink className="mr-2 h-4 w-4" />{t('desktopUpdatesReleaseNotes')}</Button> : null}
         </CardContent>
       </Card>
     </PageLayout>

package/src/features/system-status/utils/update-release-notes.utils.ts

@@ -0,0 +1,94 @@
+import type { UpdateSnapshot } from '@nextclaw/shared';
+
+export type ReleaseNotesLocale = 'zh-CN' | 'en-US';
+
+export type ReleaseNotesText = Partial<Record<ReleaseNotesLocale, string>>;
+
+export type ReleaseNotesItem = {
+  title: ReleaseNotesText;
+  body?: ReleaseNotesText;
+};
+
+export type ReleaseNotesSection = {
+  kind: string;
+  title?: ReleaseNotesText;
+  items: ReleaseNotesItem[];
+};
+
+export type ReleaseNotesPayload = {
+  title?: ReleaseNotesText;
+  summary?: ReleaseNotesText;
+  sections: ReleaseNotesSection[];
+};
+
+export function readReleaseNotesText(
+  value: ReleaseNotesText | undefined,
+  locale: ReleaseNotesLocale
+): string | null {
+  const fallbackLocale = locale === 'zh-CN' ? 'en-US' : 'zh-CN';
+  const text = value?.[locale]?.trim() || value?.[fallbackLocale]?.trim();
+  return text || null;
+}
+
+export function resolveReleaseNotesDataUrl(snapshot: UpdateSnapshot): string | null {
+  const releaseNotesUrl = snapshot.releaseNotesUrl?.trim();
+  const version = (snapshot.availableVersion ?? snapshot.downloadedVersion)?.trim();
+  if (!releaseNotesUrl || !version || !/^[0-9A-Za-z.-]+$/.test(version)) {
+    return null;
+  }
+
+  try {
+    return new URL(`/release-notes/nextclaw-v${version}.json`, releaseNotesUrl).toString();
+  } catch {
+    return null;
+  }
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function isReleaseNotesText(value: unknown): value is ReleaseNotesText {
+  if (!isRecord(value)) {
+    return false;
+  }
+  return typeof value['zh-CN'] === 'string' || typeof value['en-US'] === 'string';
+}
+
+function isReleaseNotesItem(value: unknown): value is ReleaseNotesItem {
+  if (!isRecord(value) || !isReleaseNotesText(value.title)) {
+    return false;
+  }
+  return value.body === undefined || isReleaseNotesText(value.body);
+}
+
+function isReleaseNotesSection(value: unknown): value is ReleaseNotesSection {
+  return isRecord(value)
+    && typeof value.kind === 'string'
+    && Array.isArray(value.items)
+    && value.items.every(isReleaseNotesItem)
+    && (value.title === undefined || isReleaseNotesText(value.title));
+}
+
+function isReleaseNotesPayload(value: unknown): value is ReleaseNotesPayload {
+  return isRecord(value)
+    && Array.isArray(value.sections)
+    && value.sections.every(isReleaseNotesSection)
+    && (value.title === undefined || isReleaseNotesText(value.title))
+    && (value.summary === undefined || isReleaseNotesText(value.summary));
+}
+
+export async function fetchReleaseNotesData(url: string): Promise<ReleaseNotesPayload> {
+  const response = await fetch(url, {
+    cache: 'no-store',
+    headers: { accept: 'application/json' }
+  });
+  if (!response.ok) {
+    throw new Error(`Release notes request failed with HTTP ${response.status}.`);
+  }
+  const payload: unknown = await response.json();
+  if (!isReleaseNotesPayload(payload)) {
+    throw new Error('Release notes payload has an unsupported shape.');
+  }
+  return payload;
+}