Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Show post-update What's New as a plain changelog
[email protected]bbdcfa95f46c
diff --git a/docs/release-control/v6/internal/subsystems/deployment-installability.md b/docs/release-control/v6/internal/subsystems/deployment-installability.mdindex 3d26247b6c..d1d7d5cb5c 100644--- a/docs/release-control/v6/internal/subsystems/deployment-installability.md+++ b/docs/release-control/v6/internal/subsystems/deployment-installability.md@@ -2973,24 +2973,27 @@ artifact-selection behaviour.`frontend-modern/src/utils/localStorage.ts` owns that browser-session noticereservation boundary so the release notice and the GitHub gratitude promptcannot create a one-two sequence. The post-update- surface keeps authored Known issues and historical Breaking changes open- before the Highlights, with optional `See the difference` images directly- after the Highlights. Routine Before-you-upgrade instructions have their own- initially collapsed disclosure, separate from the grouped change expansion.- Release authors must put critical risks and required safety actions in Known- issues so those warnings remain visible without expanding upgrade notes.+ dialog reads as a conventional changelog headed by the version and release+ date: authored Known issues and historical Breaking changes first, optional+ `See the difference` images next, then every grouped change section as+ plain headed lists and routine Before-you-upgrade instructions last as+ Upgrade notes, with no disclosure hiding any of them. The curated+ Highlights summary belongs to the pre-update preview and is not repeated+ above the changelog. Release authors must put critical risks and required+ safety actions in Known issues so those warnings lead the dialog.Screenshot URLs must be exact-version public release PNG sidecars, neverarbitrary remote images or raw PR attachment URLs. Before/now comparisonsload through the authenticated exact-version release-asset endpoint, whichvalidates body references, bounded PNG data and GitHub redirect hostswithout loosening the application's same-origin image policy. Comparisonsstack at narrow widths, link to full-size assets and degrade to readable- text if an image cannot load. Highlights-only releases remain useful, while+ text if an image cannot load. A release without grouped change sections+ shows its Highlights list as the changelog, whilea first baseline, malformed or development version, missing release, ormetadata-only release stays silent. Text is sanitized independently ofscreenshot rendering and cannot expand the chat Markdown trust boundary.- For both the pre-update preview and post-update overview, release rendering- keeps it to at most three short plain-text bullets of no more than 140+ For the pre-update preview, release rendering keeps Highlights to at most+ three short plain-text bullets of no more than 140characters each, with links, code, issue references, and nested structurereserved for the categorized or full release notes.The post-update communication boundary does not announce telemetry payload@@ -5048,8 +5051,9 @@ build upload or public mobile-store rollout is part of this server release.The same release boundary provides one canonical in-app release-noteexperience. Update checks preview curated Highlights, while the authenticatedrunning-version endpoint supplies the same published body to the post-update-modal. That modal shows Highlights, optional release screenshot comparisons,-important operator information and expandable grouped changes. Historical+modal. That modal is a plain changelog: important operator information,+optional release screenshot comparisons, every grouped change section and+upgrade notes, without repeating Highlights. HistoricalAdded/Improved/Fixed categories remain readable. PR visual evidence can beselected autonomously and copied into versioned release assets, with freshcaptures available for missing or stale views. Source/development builds anddiff --git a/frontend-modern/browser-verification/d0a9c84927de0912.json b/frontend-modern/browser-verification/d0a9c84927de0912.jsonnew file mode 100644index 0000000000..355804516c--- /dev/null+++ b/frontend-modern/browser-verification/d0a9c84927de0912.json@@ -0,0 +1,37 @@+{+ "version": 1,+ "base_sha": "82df77f2f5526a3b424d19926edf6f99b8faecd4",+ "verified_at": "2026-10-24T12:36:22Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/components/WhatsNewCard.tsx",+ "frontend-modern/src/components/WhatsNewContent.tsx",+ "frontend-modern/src/components/whatsNewModel.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/components/WhatsNewCard.tsx": "5ae186944e83411f377127719b2bbc57554331fe99f53045478420a860fa809d",+ "frontend-modern/src/components/WhatsNewContent.tsx": "f9e8d395090ba97c65bae205b4cef6142bd6cf83cd7ad7b60be13285a7483b53",+ "frontend-modern/src/components/whatsNewModel.ts": "77d1987c91342ea0b0d5348b71f2ad4b1f8cd1aa6af26a76aecd652a4263423a"+ },+ "routes": [+ "/proxmox/overview"+ ],+ "viewports": [+ {+ "width": 1440,+ "height": 900+ },+ {+ "width": 390,+ "height": 844+ }+ ],+ "states": [+ "Production vite build of this tree served by vite preview, proxied to the pulse-dev perf rig on :7699; /api/version rewritten to a published 6.6.0-rc.6 build and /api/updates/release-notes fulfilled with the published v6.6.0-rc.6 body, last-seen version 6.5.0",+ "Post-update notice shown; dialog header reads the version with Released <date>; Known issues callout first, then Improved and every grouped section through Other improvements, then Upgrade notes; no Highlights cards and zero details elements in the dialog",+ "Dark and light at 1440x900 and dark at 390x844; dialog scrolls internally (8662px content in a 540px viewport at desktop) with header and footer fixed"+ ],+ "interactions": [+ "Signed in, reloaded with the new release, clicked See what's new, scrolled the dialog to 15%, 50% and the end at each viewport"+ ]+}diff --git a/frontend-modern/src/components/WhatsNewCard.tsx b/frontend-modern/src/components/WhatsNewCard.tsxindex 1e42179e71..f65a2ca8cf 100644--- a/frontend-modern/src/components/WhatsNewCard.tsx+++ b/frontend-modern/src/components/WhatsNewCard.tsx@@ -9,6 +9,7 @@ import { Dialog } from '@/components/shared/Dialog';import { ExternalTextLink } from '@/components/shared/ExternalTextLink';import { InlineNotice } from '@/components/shared/InlineNotice';import { buildReleaseNotesUrl, normalizeReleaseVersion } from '@/components/updateVersion';+import { formatUpdateReleaseDate } from '@/utils/updatesPresentation';import {extractWhatsNew,isReleaseVersion,@@ -48,6 +49,7 @@ export function WhatsNewCard() {const [noticeVisible, setNoticeVisible] = createSignal(false);const [dialogVisible, setDialogVisible] = createSignal(false);const [version, setVersion] = createSignal('');+ const [releaseDate, setReleaseDate] = createSignal<string | undefined>();const [content, setContent] = createSignal<ReleaseContent | null>(null);let checked = false;@@ -66,6 +68,7 @@ export function WhatsNewCard() {}setContent(releaseContent);setVersion(currentVersion);+ setReleaseDate(formatUpdateReleaseDate(notes.releaseDate));// The compact notice is the only automatic release UI. Record the// version immediately so reloads cannot turn it into a recurring prompt.markVersionSeen(currentVersion);@@ -182,7 +185,9 @@ export function WhatsNewCard() {>What's new in Pulse v{version()}</h2>- <p class="text-xs text-muted">What changed and why it matters</p>+ <Show when={releaseDate()}>+ {(date) => <p class="text-xs text-muted">Released {date()}</p>}+ </Show></div></div><ActionIconButtondiff --git a/frontend-modern/src/components/WhatsNewContent.tsx b/frontend-modern/src/components/WhatsNewContent.tsxindex 827fe97cfd..8eddf83485 100644--- a/frontend-modern/src/components/WhatsNewContent.tsx+++ b/frontend-modern/src/components/WhatsNewContent.tsx@@ -30,7 +30,7 @@ const releaseText = (markdown: string): string =>function ReleaseText(props: { markdown: string }) {return (<div- class="text-sm leading-relaxed text-base-content [&_h3]:mb-2 [&_h3]:mt-5 [&_h3:first-child]:mt-0 [&_h3]:font-semibold [&_h4]:mt-3 [&_h4]:font-medium [&_ul]:list-disc [&_ul]:space-y-2 [&_ul]:pl-5 [&_ol]:list-decimal [&_ol]:pl-5 [&_p+p]:mt-2 [&_a]:text-blue-600 [&_a]:underline dark:[&_a]:text-blue-400 [&_code]:font-mono [&_code]:text-xs"+ class="text-sm leading-relaxed text-base-content [&_h3]:mb-3 [&_h3]:mt-8 [&_h3:first-child]:mt-0 [&_h3]:text-base [&_h3]:font-semibold [&_h4]:mt-3 [&_h4]:font-medium [&_ul]:list-disc [&_ul]:space-y-2 [&_ul]:pl-5 [&_ol]:list-decimal [&_ol]:pl-5 [&_p+p]:mt-2 [&_a]:text-blue-600 [&_a]:underline dark:[&_a]:text-blue-400 [&_code]:font-mono [&_code]:text-xs"// eslint-disable-next-line solid/no-innerhtml -- releaseText sanitizes release MarkdowninnerHTML={releaseText(props.markdown)}/>@@ -72,6 +72,8 @@ function Screenshot(props: { src: string; title: string; label: string }) {);}+// A conventional changelog: warnings first, then every change group as plain+// headed lists, with nothing hidden behind a disclosure.export function WhatsNewContent(props: { content: ReleaseContent }) {return (<div class="space-y-6">@@ -85,20 +87,6 @@ export function WhatsNewContent(props: { content: ReleaseContent }) {</section>)}</Show>- <Show when={props.content.highlights.length > 0}>- <section aria-label="Release highlights">- <h3 class="mb-3 text-xs font-semibold uppercase tracking-wide text-muted">Highlights</h3>- <ul class="space-y-3">- <For each={props.content.highlights}>- {(highlight) => (- <li class="rounded-lg border border-border bg-surface-alt p-4">- <ReleaseText markdown={highlight} />- </li>- )}- </For>- </ul>- </section>- </Show><For each={props.content.visuals}>{(visual) => (<section aria-label={visual.title} class="space-y-3">@@ -119,31 +107,18 @@ export function WhatsNewContent(props: { content: ReleaseContent }) {</section>)}</For>- <Show when={props.content.upgradeNotes}>- {(upgradeNotes) => (- <details class="group rounded-lg border border-border">- <summary class="cursor-pointer rounded-lg px-4 py-3 text-sm font-medium text-base-content focus-visible:outline-solid focus-visible:outline-2 focus-visible:outline-blue-500">- Before you upgrade- </summary>- <div class="border-t border-border p-4">- <ReleaseText markdown={upgradeNotes()} />- </div>- </details>- )}- </Show><Show when={props.content.changes}>{(changes) => (- <details- open={props.content.highlights.length === 0 && props.content.visuals.length === 0}- class="group rounded-lg border border-border"- >- <summary class="cursor-pointer rounded-lg px-4 py-3 text-sm font-medium text-base-content focus-visible:outline-solid focus-visible:outline-2 focus-visible:outline-blue-500">- All changes- </summary>- <div class="border-t border-border p-4">- <ReleaseText markdown={changes()} />- </div>- </details>+ <section aria-label="Changes">+ <ReleaseText markdown={changes()} />+ </section>+ )}+ </Show>+ <Show when={props.content.upgradeNotes}>+ {(upgradeNotes) => (+ <section aria-label="Upgrade notes">+ <ReleaseText markdown={`### Upgrade notes\n\n${upgradeNotes()}`} />+ </section>)}</Show></div>diff --git a/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx b/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsxindex 402034943e..65c89ba238 100644--- a/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx+++ b/frontend-modern/src/components/__tests__/WhatsNewCard.test.tsx@@ -108,6 +108,9 @@ describe('WhatsNewCard', () => {expect(screen.queryByTestId('whats-new-notice')).not.toBeInTheDocument();expect(screen.getByRole('dialog')).toBeInTheDocument();expect(screen.getByText("What's new in Pulse v6.1.0-rc.1")).toBeInTheDocument();+ expect(+ screen.getByText(`Released ${new Date('2026-07-13T12:00:00Z').toLocaleDateString()}`),+ ).toBeInTheDocument();expect(screen.getByText('Added')).toBeInTheDocument();expect(screen.getByText('Actions now has a dedicated inbox for approvals.'),@@ -116,9 +119,11 @@ describe('WhatsNewCard', () => {expect(screen.getByText('Acknowledged alerts now stay dismissed after refresh.'),).toBeInTheDocument();- expect(screen.getByText('General agent improvements')).toBeInTheDocument();- expect(screen.getByText('All changes').parentElement).not.toHaveAttribute('open');- fireEvent.click(screen.getByText('All changes'));+ expect(screen.getByText('Acknowledged alerts now stay dismissed after refresh.')).toBeVisible();+ // The dialog is a changelog: the Highlights summary is not repeated above it.+ expect(screen.queryByText('General agent improvements')).not.toBeInTheDocument();+ expect(screen.queryByText('All changes')).not.toBeInTheDocument();+ expect(document.querySelector('[data-testid="whats-new-modal"] details')).toBeNull();expect(screen.queryByText('Internal work')).not.toBeInTheDocument();expect(screen.getByRole('link', { name: 'Full release notes →' })).toHaveAttribute('href',@@ -180,7 +185,7 @@ describe('WhatsNewCard', () => {expect(screen.queryByTestId('whats-new-notice')).not.toBeInTheDocument();});- it('announces a highlights-only release without adding an empty details section', async () => {+ it('falls back to the Highlights list for a release without change groups', async () => {localStorage.setItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN, '6.0.5');versionInfoMock.mockReturnValue({version: '6.1.0-rc.1',@@ -203,11 +208,10 @@ describe('WhatsNewCard', () => {fireEvent.click(await screen.findByRole('button', { name: "See what's new in Pulse 6.1.0-rc.1" }),);- expect(screen.getByText('General improvements')).toBeInTheDocument();- expect(screen.queryByText('All changes')).not.toBeInTheDocument();+ expect(screen.getByText('General improvements')).toBeVisible();});- it('puts screenshots under highlights, keeps warnings open and collapses routine upgrade notes', async () => {+ it('orders warnings, screenshots, changes and upgrade notes without disclosures', async () => {localStorage.setItem(STORAGE_KEYS.WHATS_NEW_LAST_SEEN, '6.5.0');versionInfoMock.mockReturnValue({version: '6.6.0',@@ -245,19 +249,17 @@ describe('WhatsNewCard', () => {screen.getByText('Migrate the old configuration before enabling collection.'),).toBeVisible();const warnings = screen.getByRole('region', { name: 'Important release information' });- const highlights = screen.getByRole('region', { name: 'Release highlights' });const comparison = screen.getByRole('region', { name: 'Backup coverage at a glance' });- expect(warnings.closest('details')).toBeNull();- expect(- warnings.compareDocumentPosition(highlights) & Node.DOCUMENT_POSITION_FOLLOWING,- ).toBeTruthy();- expect(highlights.nextElementSibling).toBe(comparison);- const upgradeNotes = screen.getByText('Before you upgrade').closest('details');- expect(upgradeNotes).not.toHaveAttribute('open');- expect(screen.getByText('Verify the published checksums.')).not.toBeVisible();- expect(- comparison.compareDocumentPosition(upgradeNotes!) & Node.DOCUMENT_POSITION_FOLLOWING,- ).toBeTruthy();+ const changes = screen.getByRole('region', { name: 'Changes' });+ const upgradeNotes = screen.getByRole('region', { name: 'Upgrade notes' });+ expect(warnings.nextElementSibling).toBe(comparison);+ expect(comparison.nextElementSibling).toBe(changes);+ expect(changes.nextElementSibling).toBe(upgradeNotes);+ expect(screen.queryByRole('region', { name: 'Release highlights' })).toBeNull();+ expect(screen.queryByText('Find backup failures faster.')).not.toBeInTheDocument();+ expect(screen.getByText('Open Backups to inspect recent failures.')).toBeVisible();+ expect(screen.getByText('Verify the published checksums.')).toBeVisible();+ expect(document.querySelector('[data-testid="whats-new-modal"] details')).toBeNull();const after = screen.getByRole('img', { name: 'Backup coverage at a glance, now' });expect(after).toHaveAttribute('src',@@ -291,7 +293,6 @@ describe('WhatsNewCard', () => {});await renderCard();fireEvent.click(await screen.findByRole('button', { name: "See what's new in Pulse 6.1.0" }));- expect(screen.getByText('All changes').parentElement).toHaveAttribute('open');expect(screen.getByText(/Alerts stay dismissed/)).toBeVisible();expect(screen.queryByRole('img')).not.toBeInTheDocument();expect(document.querySelector('script')).not.toBeInTheDocument();diff --git a/frontend-modern/src/components/__tests__/whatsNewModel.test.ts b/frontend-modern/src/components/__tests__/whatsNewModel.test.tsindex f35d55d9b0..6c4c0bce36 100644--- a/frontend-modern/src/components/__tests__/whatsNewModel.test.ts+++ b/frontend-modern/src/components/__tests__/whatsNewModel.test.ts@@ -269,7 +269,7 @@ describe('post-update release content', () => {'Not part of the visual.',].join('\n');- it('consumes current grouped release notes and a short Highlights list', () => {+ it('reads current grouped release notes without repeating the Highlights summary', () => {const content = extractWhatsNew(['## Highlights',@@ -286,7 +286,7 @@ describe('post-update release content', () => {].join('\n'),'6.6.0',);- expect(content?.highlights).toEqual(['Spot backup gaps.', 'Keep important alerts visible.']);+ expect(content?.changes).not.toContain('Spot backup gaps.');expect(content?.changes).toContain('Proxmox, PBS and backups');expect(content?.changes).toContain('Acknowledgements persist');expect(content?.changes).not.toContain('Internal evidence');@@ -294,7 +294,7 @@ describe('post-update release content', () => {expect(content?.important).toBeNull();});- it('separates authored warnings from collapsible upgrade instructions', () => {+ it('separates authored warnings from routine upgrade instructions', () => {const content = extractWhatsNew(['## Known issues',@@ -340,7 +340,10 @@ describe('post-update release content', () => {'6.6.0',)[0],).toMatchObject({ after: `${base}release-note-new-now.png`, before: undefined });- expect(extractWhatsNew('## Highlights\n- Faster updates.', '6.6.0')?.visuals).toEqual([]);+ expect(extractWhatsNew('## Highlights\n- Faster updates.', '6.6.0')).toMatchObject({+ changes: '- Faster updates.',+ visuals: [],+ });expect(extractWhatsNew('## Installation\nInstall Pulse.', '6.6.0')).toBeNull();});diff --git a/frontend-modern/src/components/whatsNewModel.ts b/frontend-modern/src/components/whatsNewModel.tsindex 7b738ea88d..d8029b479f 100644--- a/frontend-modern/src/components/whatsNewModel.ts+++ b/frontend-modern/src/components/whatsNewModel.ts@@ -1,5 +1,5 @@// Model logic for the release preview and post-update changelog.-import { marked, type Tokens } from 'marked';+import { marked } from 'marked';import { normalizeReleaseVersion } from './updateVersion';type Heading = {@@ -90,7 +90,6 @@ export type ReleaseVisual = {};export type WhatsNewContent = {- highlights: string[];changes: string | null;important: string | null;upgradeNotes: string | null;@@ -142,15 +141,12 @@ export const extractReleaseVisuals = (markdown: string, version: string): Releas});};-/** Read the same authored release body used by GitHub and the update preview. */+/**+ * Read the same authored release body used by GitHub and the update preview.+ * The post-update dialog is a changelog: the curated Highlights summary only+ * stands in for the change groups when a release has none.+ */export const extractWhatsNew = (markdown: string, version: string): WhatsNewContent | null => {- const summary = extractHighlights(markdown);- const summaryTokens = summary ? marked.lexer(summary) : [];- const highlights = summaryTokens- .flatMap((token) =>- token.type === 'list' ? token.items.map((item: Tokens.ListItem) => item.text) : [],- )- .slice(0, 3);const lines = markdown.replace(/\r\n/g, '\n').split('\n');const headings = headingsIn(lines);const sectionMarkdown = (titles: ReadonlySet<string>, includeTitles = true) =>@@ -161,21 +157,21 @@ export const extractWhatsNew = (markdown: string, version: string): WhatsNewContreturn body ? [includeTitles ? `### ${heading.title}\n\n${body}` : body] : [];}).join('\n\n') || null;- // Authored warning sections stay open. Routine upgrade instructions have- // their own disclosure, without inferring severity from individual words.+ // Authored warning sections lead the changelog, without inferring severity+ // from individual words.const important = sectionMarkdown(new Set(['known issues', 'breaking changes']));const upgradeNotes = sectionMarkdown(new Set(['before you upgrade', 'upgrade notes']), false);- const changes = extractChangelog(markdown);+ const changes = extractChangelog(markdown) ?? extractHighlights(markdown);const visuals = extractReleaseVisuals(markdown, version);- return highlights.length || changes || important || upgradeNotes || visuals.length- ? { highlights, changes, important, upgradeNotes, visuals }+ return changes || important || upgradeNotes || visuals.length+ ? { changes, important, upgradeNotes, visuals }: null;};/*** Build the post-update changelog from the user-facing change categories in a- * published release body. Highlights, warnings, upgrade notes and visuals- * render separately, while this is its expandable detailed changelog.+ * published release body. Warnings, upgrade notes and visuals render+ * separately around it.*/export const extractChangelog = (markdown: string): string | null => {const lines = markdown.replace(/\r\n/g, '\n').split('\n');