Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

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.md
index 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 notice
reservation boundary so the release notice and the GitHub gratitude prompt
cannot 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, never
arbitrary remote images or raw PR attachment URLs. Before/now comparisons
load through the authenticated exact-version release-asset endpoint, which
validates body references, bounded PNG data and GitHub redirect hosts
without loosening the application's same-origin image policy. Comparisons
stack 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, while
a first baseline, malformed or development version, missing release, or
metadata-only release stays silent. Text is sanitized independently of
screenshot 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 140
characters each, with links, code, issue references, and nested structure
reserved 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-note
experience. Update checks preview curated Highlights, while the authenticated
running-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. Historical
Added/Improved/Fixed categories remain readable. PR visual evidence can be
selected autonomously and copied into versioned release assets, with fresh
captures available for missing or stale views. Source/development builds and
diff --git a/frontend-modern/browser-verification/d0a9c84927de0912.json b/frontend-modern/browser-verification/d0a9c84927de0912.json
new file mode 100644
index 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.tsx
index 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>
<ActionIconButton
diff --git a/frontend-modern/src/components/WhatsNewContent.tsx b/frontend-modern/src/components/WhatsNewContent.tsx
index 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 Markdown
innerHTML={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.tsx
index 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.ts
index 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.ts
index 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): WhatsNewCont
return 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');