diff --git a/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx b/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx
index 177d4959b..a7081ce25 100644
--- a/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx
+++ b/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx
@@ -126,7 +126,7 @@ describe('WhatsNewCard', () => {
expect(screen.queryByTestId('telemetry-payload-update-notice')).not.toBeInTheDocument();
});
- it('shows curated highlights after the running release changes', async () => {
+ it('shows the categorized changelog after the running release changes', async () => {
localStorage.setItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN, '6.0.5');
versionInfoMock.mockReturnValue({
version: '6.1.0-rc.1',
@@ -135,7 +135,19 @@ describe('WhatsNewCard', () => {
});
getReleaseNotesMock.mockResolvedValue({
version: 'v6.1.0-rc.1',
- releaseNotes: '## Highlights\n- Reviewed Actions inbox\n\n## Changes\n- Internal work',
+ releaseNotes: [
+ '## Highlights',
+ '- General agent improvements',
+ '',
+ '## Added',
+ '- Actions now has a dedicated inbox for approvals.',
+ '',
+ '## Fixed',
+ '- Acknowledged alerts now stay dismissed after refresh.',
+ '',
+ '## Release Qualification',
+ '- Internal work',
+ ].join('\n'),
releaseDate: '2026-07-13T12:00:00Z',
isPrerelease: true,
});
@@ -146,8 +158,16 @@ describe('WhatsNewCard', () => {
expect(screen.getByTestId('whats-new-modal')).toBeInTheDocument();
});
expect(screen.getByRole('dialog')).toBeInTheDocument();
- expect(screen.getByText("What's new in v6.1.0-rc.1")).toBeInTheDocument();
- expect(screen.getByText('Reviewed Actions inbox')).toBeInTheDocument();
+ expect(screen.getByText('Pulse v6.1.0-rc.1 changelog')).toBeInTheDocument();
+ expect(screen.getByText('Added')).toBeInTheDocument();
+ expect(
+ screen.getByText('Actions now has a dedicated inbox for approvals.'),
+ ).toBeInTheDocument();
+ expect(screen.getByText('Fixed')).toBeInTheDocument();
+ expect(
+ screen.getByText('Acknowledged alerts now stay dismissed after refresh.'),
+ ).toBeInTheDocument();
+ expect(screen.queryByText('General agent improvements')).not.toBeInTheDocument();
expect(screen.queryByText('Internal work')).not.toBeInTheDocument();
expect(screen.getByRole('link', { name: 'Full release notes →' })).toHaveAttribute(
'href',
@@ -164,7 +184,7 @@ describe('WhatsNewCard', () => {
});
getReleaseNotesMock.mockResolvedValue({
version: '6.1.0-rc.1',
- releaseNotes: '## Highlights\n- Reviewed Actions inbox',
+ releaseNotes: '## Added\n- Actions now has a dedicated inbox for approvals.',
releaseDate: '2026-07-13T12:00:00Z',
isPrerelease: true,
});
@@ -180,6 +200,28 @@ describe('WhatsNewCard', () => {
expect(localStorage.getItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN)).toBe('6.1.0-rc.1');
});
+ it('stays quiet when a release has only a highlights summary', async () => {
+ localStorage.setItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN, '6.0.5');
+ versionInfoMock.mockReturnValue({
+ version: '6.1.0-rc.1',
+ isDevelopment: false,
+ isSourceBuild: false,
+ });
+ getReleaseNotesMock.mockResolvedValue({
+ version: '6.1.0-rc.1',
+ releaseNotes: '## Highlights\n- General improvements',
+ releaseDate: '2026-07-13T12:00:00Z',
+ isPrerelease: true,
+ });
+
+ await renderCard();
+
+ await waitFor(() => {
+ expect(localStorage.getItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN)).toBe('6.1.0-rc.1');
+ });
+ expect(screen.queryByTestId('whats-new-modal')).not.toBeInTheDocument();
+ });
+
it('stays quiet for development builds', async () => {
localStorage.setItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN, '6.0.5');
versionInfoMock.mockReturnValue({
diff --git a/frontend-modern/src/components/__tests__/whatsNewModel.test.ts b/frontend-modern/src/components/__tests__/whatsNewModel.test.ts
index 8bf467099..839e1b2c7 100644
--- a/frontend-modern/src/components/__tests__/whatsNewModel.test.ts
+++ b/frontend-modern/src/components/__tests__/whatsNewModel.test.ts
@@ -1,5 +1,5 @@
import { describe, expect, it } from 'vitest';
-import { extractHighlights, isReleaseVersion } from '../whatsNewModel';
+import { extractChangelog, extractHighlights, isReleaseVersion } from '../whatsNewModel';
import whatsNewCardSource from '../WhatsNewCard.tsx?raw';
describe('extractHighlights', () => {
@@ -82,6 +82,93 @@ describe('extractHighlights', () => {
});
});
+describe('extractChangelog', () => {
+ it('builds a categorized changelog and excludes the highlights summary', () => {
+ const body = [
+ '# Pulse v6.2.1 Release Notes',
+ '',
+ '## Highlights',
+ '- Agent improvements and fixes.',
+ '',
+ '## Added',
+ '- Plans & Billing is now available before Pro activation.',
+ '',
+ '## Improved',
+ '- Update results show when the last check ran.',
+ '',
+ '## Fixed',
+ '- Agent downloads now work when the server redirects the request (#1696).',
+ '',
+ '## Upgrade Notes',
+ 'Use the normal update flow.',
+ ].join('\n');
+
+ expect(extractChangelog(body)).toBe(
+ [
+ '### Added',
+ '',
+ '- Plans & Billing is now available before Pro activation.',
+ '',
+ '### Improved',
+ '',
+ '- Update results show when the last check ran.',
+ '',
+ '### Fixed',
+ '',
+ '- Agent downloads now work when the server redirects the request (#1696).',
+ ].join('\n'),
+ );
+ });
+
+ it('normalizes generated section names into stable changelog labels', () => {
+ const body = [
+ '## v6.2.2',
+ '### New Features',
+ '- Add certificate expiry monitoring.',
+ '### Improvements',
+ '- Make storage filters easier to scan.',
+ '### Bug Fixes',
+ '- Keep acknowledged alerts dismissed after refresh.',
+ ].join('\n');
+
+ expect(extractChangelog(body)).toBe(
+ [
+ '### Added',
+ '',
+ '- Add certificate expiry monitoring.',
+ '',
+ '### Improved',
+ '',
+ '- Make storage filters easier to scan.',
+ '',
+ '### Fixed',
+ '',
+ '- Keep acknowledged alerts dismissed after refresh.',
+ ].join('\n'),
+ );
+ });
+
+ it('preserves nested details inside a recognized category', () => {
+ const body = [
+ '## Fixed',
+ '### Proxmox',
+ '- Storage rows no longer disappear after refresh.',
+ '## Installation',
+ '- Not part of the changelog.',
+ ].join('\n');
+
+ expect(extractChangelog(body)).toBe(
+ '### Fixed\n\n### Proxmox\n- Storage rows no longer disappear after refresh.',
+ );
+ });
+
+ it('returns null for summaries and release metadata without change categories', () => {
+ expect(
+ extractChangelog('## Highlights\n- Faster updates.\n\n## Installation\n- Pull the image.'),
+ ).toBeNull();
+ });
+});
+
describe('isReleaseVersion', () => {
it('accepts published release versions', () => {
expect(isReleaseVersion('4.13.0')).toBe(true);
diff --git a/frontend-modern/src/components/whatsNewModel.ts b/frontend-modern/src/components/whatsNewModel.ts
index 4cbc03970..630905f0c 100644
--- a/frontend-modern/src/components/whatsNewModel.ts
+++ b/frontend-modern/src/components/whatsNewModel.ts
@@ -1,9 +1,29 @@
-// Model logic for the post-update "What's New" banner.
-//
-// The banner only ever shows the release's "Highlights" section — a curated,
-// user-facing summary — never the full changelog. Releases without a
-// Highlights section stay silent, so patch releases full of internal fixes
-// don't nag anyone.
+// Model logic for the release preview and post-update changelog.
+
+type Heading = {
+ index: number;
+ level: number;
+ title: string;
+};
+
+const headingMatch = (line: string) => line.trim().match(/^(#{1,6})\s+(.*)$/);
+
+const headingsIn = (lines: string[]): Heading[] =>
+ lines.flatMap((line, index) => {
+ const match = headingMatch(line);
+ return match ? [{ index, level: match[1].length, title: match[2].trim() }] : [];
+ });
+
+const sectionBody = (lines: string[], headings: Heading[], headingIndex: number): string => {
+ const heading = headings[headingIndex];
+ const nextHeading = headings
+ .slice(headingIndex + 1)
+ .find((candidate) => candidate.level <= heading.level);
+ return lines
+ .slice(heading.index + 1, nextHeading?.index ?? lines.length)
+ .join('\n')
+ .trim();
+};
/**
* Extract the contents of the `## Highlights` section from a GitHub release
@@ -12,30 +32,55 @@
*/
export const extractHighlights = (markdown: string): string | null => {
const lines = markdown.replace(/\r\n/g, '\n').split('\n');
- const headingMatch = (line: string) => line.trim().match(/^(#{1,6})\s+(.*)$/);
-
- const startIdx = lines.findIndex((line) => {
- const match = headingMatch(line);
- return !!match && /^highlights\b/i.test(match[2].trim());
- });
- if (startIdx === -1) {
+ const headings = headingsIn(lines);
+ const headingIndex = headings.findIndex((heading) => /^highlights\b/i.test(heading.title));
+ if (headingIndex === -1) {
return null;
}
- const startLevel = headingMatch(lines[startIdx])![1].length;
- const section: string[] = [];
- for (let i = startIdx + 1; i < lines.length; i++) {
- const match = headingMatch(lines[i]);
- if (match && match[1].length <= startLevel) {
- break;
- }
- section.push(lines[i]);
- }
-
- const content = section.join('\n').trim();
+ const content = sectionBody(lines, headings, headingIndex);
return content || null;
};
+const CHANGELOG_SECTION_LABELS: Readonly> = {
+ added: 'Added',
+ 'new features': 'Added',
+ improved: 'Improved',
+ improvements: 'Improved',
+ changed: 'Changed',
+ fixed: 'Fixed',
+ 'bug fixes': 'Fixed',
+ security: 'Security',
+ 'breaking changes': 'Breaking changes',
+ deprecated: 'Deprecated',
+ removed: 'Removed',
+};
+
+/**
+ * Build the post-update changelog from the user-facing change categories in a
+ * published release body. Highlights are intentionally excluded: they remain
+ * a compact pre-update preview, while this view tells users what actually
+ * changed under recognizable changelog headings.
+ */
+export const extractChangelog = (markdown: string): string | null => {
+ const lines = markdown.replace(/\r\n/g, '\n').split('\n');
+ const headings = headingsIn(lines);
+ const sections: string[] = [];
+
+ headings.forEach((heading, headingIndex) => {
+ const normalizedTitle = heading.title.replace(/\s+/g, ' ').toLowerCase();
+ const label = CHANGELOG_SECTION_LABELS[normalizedTitle];
+ if (!label) return;
+
+ const content = sectionBody(lines, headings, headingIndex);
+ if (content) {
+ sections.push(`### ${label}\n\n${content}`);
+ }
+ });
+
+ return sections.length > 0 ? sections.join('\n\n') : null;
+};
+
// Dev builds carry -dirty or a -g suffix; they never correspond to a
// published release, so the banner should stay quiet for them.
export const isReleaseVersion = (version: string): boolean => {
diff --git a/scripts/generate-release-notes.sh b/scripts/generate-release-notes.sh
index 0f44b4db0..833159f9c 100755
--- a/scripts/generate-release-notes.sh
+++ b/scripts/generate-release-notes.sh
@@ -78,24 +78,35 @@ internal fixes or minor patches), OMIT this entire section — that deliberately
keeps the in-app banner silent for maintenance releases. Keep the heading at
level 3 (###).]
-### New Features
-[Genuinely new user-facing capabilities. Be specific about what users can now do.]
+### Added
+[Genuinely new user-facing capabilities. Name the page, workflow, integration,
+or platform where users will find each one, then say what they can now do.]
-### Bug Fixes
-[Fixes for problems users would have encountered. Include issue refs like
-(#1234) only when the fix verifiably addresses that issue.]
+### Improved
+[Meaningful changes to existing behavior. Name the affected experience and the
+observable improvement; do not summarize several unrelated changes together.]
-### Improvements
-[Enhancements to existing features.]
+### Fixed
+[Problems users would have encountered. State the visible symptom that no
+longer happens, not the internal cause. Include issue refs like (#1234) only
+when the fix verifiably addresses that issue.]
Guidelines:
- Plain, factual, understated. No marketing language, no emojis.
- Omit any section that has no items.
-- Do NOT write an Installation section or anything after Improvements — the
+- Every Added, Improved, and Fixed bullet must stand on its own as a concrete
+ changelog entry. A reader should understand where they would notice the
+ change and what is different without knowing Pulse's implementation.
+- Avoid internal release and architecture vocabulary such as canonical,
+ governed, schema, provider transport, preflight, convergence, or runtime
+ boundary unless that exact term is visible to the user in the product.
+- Do not use vague entries such as "improved agent handling" or "various UI
+ fixes". Split unrelated changes and name the behavior that changed.
+- Do NOT write an Installation section or anything after Fixed — the
release pipeline appends those.
-- Highlights is the ONE exception to "boring": it is shown in-app to users who
- just updated, so make it the shortest useful explanation of what changed —
- still factual, with no hype.
+- Highlights is the ONE exception to "boring": it is shown in-app before users
+ update, so make it the shortest useful preview of what changed — still
+ factual, with no hype.
Your reply must be ONLY the release-notes markdown, starting with
"## v${VERSION}" — no preamble, no code fences, no commentary.