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.

Say what an agent update brings and what the CPU count is

rcourtman56e88d5561e7
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index aa974bf928..d6dcd4dd65 100644
--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md
+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
@@ -8366,6 +8366,13 @@ inventory and Storage search below the fold at desktop and phone widths, and
from competing with real warnings for attention, while preserving every
affected name on demand. The component test pins collapsed, expanded and collapsed-again
states; 1440px, 768px and 390px browser checks verify placement and overflow.
+Each platform page names what the update brings in the reader's words through
+`missingLabel`: the latest fixes and machine, node, system or VM details.
+The notice selects hosts by agent version alone, and command execution is a
+separate setting the update preserves, so the notice must not promise Patrol
+actions or command support. Internal phrasing such as "agent-contributed
+detail", "agent-managed platform detail" or "in-guest telemetry" does not
+belong in the notice.
The shared `InlineNotice` action text uses opaque 800-level colors for its four
tones. The current Tailwind configuration overrides several 900-level palette
tokens with 25%-alpha colors for translucent backgrounds, so using those
diff --git a/docs/release-control/v6/internal/subsystems/performance-and-scalability.md b/docs/release-control/v6/internal/subsystems/performance-and-scalability.md
index 50344121e9..7566602199 100644
--- a/docs/release-control/v6/internal/subsystems/performance-and-scalability.md
+++ b/docs/release-control/v6/internal/subsystems/performance-and-scalability.md
@@ -1122,6 +1122,11 @@ change may globally weaken the Task 03 lifecycle-state idempotency invariant.
hover tooltips from synthesized mouse events; a row tap remains the primary
drawer action. Tooltip suppression belongs to the shared hover-capability
boundary rather than per-row viewport branches or listeners.
+ The shared `EnhancedCPUBar` hover panel names the CPU count that the bar
+ shows in parentheses beside the percentage ("22% (18)") as "CPUs": logical
+ CPUs on a host, configured vCPUs on a guest, so "Cores" would be wrong on
+ hyperthreaded hosts. It reads the `cores` prop the row already passes and
+ adds no per-row work.
Ultra-narrow workload presentation belongs in the existing layout and
column model: below 360 pixels it keeps five identity/health columns with a
40-percent identity track. It must not add per-row measurement, viewport
diff --git a/docs/release-control/v6/internal/subsystems/storage-recovery.md b/docs/release-control/v6/internal/subsystems/storage-recovery.md
index ebbc81311a..993581c65c 100644
--- a/docs/release-control/v6/internal/subsystems/storage-recovery.md
+++ b/docs/release-control/v6/internal/subsystems/storage-recovery.md
@@ -923,8 +923,9 @@ coverage, restore capability, recovery-job proof, storage-health verification,
or evidence that a specific resource was protected or recovered.
Proxmox page stale-agent notices are adjacent frontend and agent-lifecycle
plumbing even though `ProxmoxPageSurface` is a storage/recovery canonical file.
-Those notices may link an operator to scoped agent update commands for
-agent-contributed node detail and command support, but they must not be
+Those notices may link an operator to scoped agent update commands for the
+latest fixes and node details (the notice's own wording; command execution is
+a separate setting the update does not change), but they must not be
interpreted as backup visibility, recovery readiness, restore capability, or a
storage/recovery-owned command path. Suppressing those notices when the API has
no deployable agent update target is likewise lifecycle/frontend behavior and
diff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.md
index b91304e4d5..564eb08b9b 100644
--- a/docs/release-control/v6/internal/subsystems/unified-resources.md
+++ b/docs/release-control/v6/internal/subsystems/unified-resources.md
@@ -2370,6 +2370,9 @@ for the column when evidence later appears. The
compact row action trigger chrome stays under the frontend-primitives
`ActionIconButton` boundary rather than becoming a unified-resource-local
button shell.
+The Machines outdated-agent notice names what an update brings in plain
+words, the latest fixes and machine details, and stays maintenance guidance
+rather than a membership or health signal.
Machines list search and online-state narrowing are frontend route state,
not new unified-resource membership fields. `StandalonePageSurface.tsx`
owns the `STANDALONE_QUERY_PARAMS` query/status projection and one composite
diff --git a/frontend-modern/browser-verification/936d9cf319d0e486.json b/frontend-modern/browser-verification/936d9cf319d0e486.json
new file mode 100644
index 0000000000..957411a378
--- /dev/null
+++ b/frontend-modern/browser-verification/936d9cf319d0e486.json
@@ -0,0 +1,46 @@
+{
+ "version": 1,
+ "base_sha": "b19c6aaf709637adedd46de9f61307252ab1131d",
+ "verified_at": "2026-10-06T14:18:34Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx",
+ "frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx",
+ "frontend-modern/src/features/standalone/StandalonePageSurface.tsx",
+ "frontend-modern/src/features/truenas/TrueNASPageSurface.tsx",
+ "frontend-modern/src/features/vmware/VmwarePageSurface.tsx"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx": "7aad8eb3f5eb326aac32fb698e95b7fb76d3c2683a794dd104e0ed63e9080bf6",
+ "frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx": "3daf35d191a8df3d47c37d1813763730c1849a5097e3e707ecc6b3faf10143a6",
+ "frontend-modern/src/features/standalone/StandalonePageSurface.tsx": "620c1ebcc9fea62047bea73c4505a21c7ed3fc3f28791e50f4d07b3b5203d6d2",
+ "frontend-modern/src/features/truenas/TrueNASPageSurface.tsx": "52aa6b488694cbeb3103e83abe98cb739953afdc734d9f26b5b3d595f47fbbd0",
+ "frontend-modern/src/features/vmware/VmwarePageSurface.tsx": "cd6bd1afc48a59908b7b0940e9c8e33a084f3f55c513815218e53072db534ce1"
+ },
+ "routes": [
+ "/standalone/machines",
+ "/proxmox/overview",
+ "/truenas/overview",
+ "/vmware/overview"
+ ],
+ "viewports": [
+ {
+ "width": 1440,
+ "height": 1000
+ },
+ {
+ "width": 390,
+ "height": 844
+ }
+ ],
+ "states": [
+ "Private mock stack on main b19c6aaf70 plus this change; Machines has three older agents and Proxmox five, TrueNAS and vSphere none (their notice copy is covered by the page contract tests)",
+ "Before: the Machines notice read 'Update them to v4.26.0 for the latest agent command support and agent-managed platform detail', Proxmox 'agent-contributed Proxmox node detail and command support'",
+ "After: 'Update them to v4.26.0 for the latest fixes and machine details' on Machines and '...fixes and node details' on Proxmox; the notice no longer promises Patrol actions or command support, which is a separate setting the update keeps",
+ "Before: the CPU cell's '22% (18)' had nothing explaining the 18; its hover panel listed Usage and Load (1m) only. After: the hover panel's first row reads 'CPUs 18'"
+ ],
+ "interactions": [
+ "Hovered a machine's CPU bar and read the panel",
+ "Read the outdated-agent notice on each platform page"
+ ]
+}
diff --git a/frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx b/frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx
index bca20abbd3..ff43f1b353 100644
--- a/frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx
+++ b/frontend-modern/src/components/Workloads/EnhancedCPUBar.tsx
@@ -63,6 +63,15 @@ export function EnhancedCPUBar(props: EnhancedCPUBarProps) {
<div class="text-[9px] text-slate-400 mb-1.5 truncate max-w-[200px]">{props.model}</div>
</Show>
+ {/* The bar's "(18)" beside the percentage is this count: logical
+ CPUs on a host, configured vCPUs on a guest. */}
+ <Show when={props.cores}>
+ <div class="flex justify-between gap-3 py-0.5">
+ <span class="text-slate-400">CPUs</span>
+ <span class="font-medium text-base-content">{props.cores}</span>
+ </div>
+ </Show>
+
<div class="flex justify-between gap-3 py-0.5">
<span class="text-slate-400">Usage</span>
<span class={`font-medium ${presentation().tooltipUsageClass}`}>
diff --git a/frontend-modern/src/components/Workloads/__tests__/EnhancedCPUBar.test.tsx b/frontend-modern/src/components/Workloads/__tests__/EnhancedCPUBar.test.tsx
index 69401f4eae..8af6c7f263 100644
--- a/frontend-modern/src/components/Workloads/__tests__/EnhancedCPUBar.test.tsx
+++ b/frontend-modern/src/components/Workloads/__tests__/EnhancedCPUBar.test.tsx
@@ -252,6 +252,20 @@ describe('EnhancedCPUBar', () => {
expect(screen.getByText('CPU Details')).toBeInTheDocument();
});
+ it('names the CPU count shown beside the percentage', async () => {
+ const { container } = render(() => <EnhancedCPUBar usage={22} cores={18} />);
+ expect(container.textContent).toContain('(18)');
+ await fireEvent.mouseEnter(getBarTrigger(container));
+ const label = screen.getByText('CPUs');
+ expect(label.closest('.flex.justify-between')?.textContent).toContain('18');
+ });
+
+ it('omits the CPU row when the count is unknown', async () => {
+ const { container } = render(() => <EnhancedCPUBar usage={22} />);
+ await fireEvent.mouseEnter(getBarTrigger(container));
+ expect(screen.queryByText('CPUs')).not.toBeInTheDocument();
+ });
+
it('shows usage value in tooltip', async () => {
const { container } = render(() => <EnhancedCPUBar usage={72} />);
await fireEvent.mouseEnter(getBarTrigger(container));
diff --git a/frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx b/frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx
index d40ce5bf2c..c8db9e84d3 100644
--- a/frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx
+++ b/frontend-modern/src/features/proxmox/ProxmoxPageSurface.tsx
@@ -350,7 +350,7 @@ export function ProxmoxPageSurface() {
<PlatformOutdatedAgentNotice
hosts={outdatedAgentHosts()}
targetVersion={serverVersionDisplay()}
- missingLabel="agent-contributed Proxmox node detail and command support"
+ missingLabel="fixes and node details"
copyVariant="latest-detail"
actionHref={outdatedAgentUpdatePath()}
actionLabel="Open agent upgrade commands"
diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxPageSurface.contract.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxPageSurface.contract.test.tsx
index 73a1dee144..ec2c0d1353 100644
--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxPageSurface.contract.test.tsx
+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxPageSurface.contract.test.tsx
@@ -247,9 +247,7 @@ describe('ProxmoxPageSurface contract', () => {
expect(screen.getByTestId('nodes-table')).toHaveAttribute('data-rows', '1');
const notice = screen.getByTestId('platform-outdated-agent-notice');
expect(notice).toHaveTextContent('delly runs an older Pulse agent (v5.1.34).');
- expect(notice).toHaveTextContent(
- 'latest agent-contributed Proxmox node detail and command support',
- );
+ expect(notice).toHaveTextContent('latest fixes and node details');
expect(screen.getByRole('link', { name: 'Open agent upgrade commands' })).toHaveAttribute(
'href',
'/settings/infrastructure/agent-doctor?agents=agent%3Aagent-delly',
diff --git a/frontend-modern/src/features/standalone/StandalonePageSurface.tsx b/frontend-modern/src/features/standalone/StandalonePageSurface.tsx
index 806407c6d2..908d94dad4 100644
--- a/frontend-modern/src/features/standalone/StandalonePageSurface.tsx
+++ b/frontend-modern/src/features/standalone/StandalonePageSurface.tsx
@@ -331,7 +331,7 @@ export function StandalonePageSurface() {
<PlatformOutdatedAgentNotice
hosts={outdatedAgentHosts()}
targetVersion={serverVersionDisplay()}
- missingLabel="agent command support and agent-managed platform detail"
+ missingLabel="fixes and machine details"
copyVariant="latest-detail"
actionHref={outdatedAgentUpdatePath()}
actionLabel="Open agent upgrade commands"
diff --git a/frontend-modern/src/features/standalone/__tests__/StandalonePageSurface.test.tsx b/frontend-modern/src/features/standalone/__tests__/StandalonePageSurface.test.tsx
index c2afa09e5a..01272a988e 100644
--- a/frontend-modern/src/features/standalone/__tests__/StandalonePageSurface.test.tsx
+++ b/frontend-modern/src/features/standalone/__tests__/StandalonePageSurface.test.tsx
@@ -253,9 +253,7 @@ describe('StandalonePageSurface', () => {
const notice = screen.getByTestId('platform-outdated-agent-notice');
expect(notice).toHaveTextContent('tower runs an older Pulse agent (v5.1.34).');
- expect(notice).toHaveTextContent(
- 'latest agent command support and agent-managed platform detail',
- );
+ expect(notice).toHaveTextContent('latest fixes and machine details');
expect(screen.getByRole('link', { name: 'Open agent upgrade commands' })).toHaveAttribute(
'href',
'/settings/infrastructure/agent-doctor?agents=agent%3Aagent-tower',
diff --git a/frontend-modern/src/features/truenas/TrueNASPageSurface.tsx b/frontend-modern/src/features/truenas/TrueNASPageSurface.tsx
index df6df6a535..60fd759874 100644
--- a/frontend-modern/src/features/truenas/TrueNASPageSurface.tsx
+++ b/frontend-modern/src/features/truenas/TrueNASPageSurface.tsx
@@ -189,7 +189,7 @@ export function TrueNASPageSurface() {
<PlatformOutdatedAgentNotice
hosts={outdatedAgentHosts()}
targetVersion={serverVersionDisplay()}
- missingLabel="agent-contributed TrueNAS system detail and command support"
+ missingLabel="fixes and system details"
copyVariant="latest-detail"
actionHref={outdatedAgentUpdatePath()}
actionLabel="Open agent upgrade commands"
diff --git a/frontend-modern/src/features/truenas/__tests__/TrueNASPageSurface.contract.test.tsx b/frontend-modern/src/features/truenas/__tests__/TrueNASPageSurface.contract.test.tsx
index 8220220c63..51f1ba443d 100644
--- a/frontend-modern/src/features/truenas/__tests__/TrueNASPageSurface.contract.test.tsx
+++ b/frontend-modern/src/features/truenas/__tests__/TrueNASPageSurface.contract.test.tsx
@@ -180,9 +180,7 @@ describe('TrueNASPageSurface contract', () => {
expect(screen.getByTestId('systems-table')).toHaveAttribute('data-rows', '1');
const notice = screen.getByTestId('platform-outdated-agent-notice');
expect(notice).toHaveTextContent('truenas-scale runs an older Pulse agent (v5.1.34).');
- expect(notice).toHaveTextContent(
- 'latest agent-contributed TrueNAS system detail and command support',
- );
+ expect(notice).toHaveTextContent('latest fixes and system details');
expect(screen.getByRole('link', { name: 'Open agent upgrade commands' })).toHaveAttribute(
'href',
'/settings/infrastructure/agent-doctor?agents=agent%3Aagent-truenas-scale',
diff --git a/frontend-modern/src/features/vmware/VmwarePageSurface.tsx b/frontend-modern/src/features/vmware/VmwarePageSurface.tsx
index e3aeeda59e..0e8d015897 100644
--- a/frontend-modern/src/features/vmware/VmwarePageSurface.tsx
+++ b/frontend-modern/src/features/vmware/VmwarePageSurface.tsx
@@ -352,7 +352,7 @@ export function VmwarePageSurface() {
<PlatformOutdatedAgentNotice
hosts={outdatedAgentVMs()}
targetVersion={serverVersionDisplay()}
- missingLabel="in-guest telemetry and command support"
+ missingLabel="fixes and VM details"
copyVariant="latest-detail"
actionHref={outdatedAgentUpdatePath()}
actionLabel="Open agent upgrade commands"
diff --git a/frontend-modern/src/features/vmware/__tests__/VmwarePageSurface.contract.test.tsx b/frontend-modern/src/features/vmware/__tests__/VmwarePageSurface.contract.test.tsx
index e23a15b80f..b9a4c5a43a 100644
--- a/frontend-modern/src/features/vmware/__tests__/VmwarePageSurface.contract.test.tsx
+++ b/frontend-modern/src/features/vmware/__tests__/VmwarePageSurface.contract.test.tsx
@@ -179,7 +179,7 @@ describe('VmwarePageSurface contract', () => {
expect(screen.getByTestId('hosts-table')).toHaveAttribute('data-rows', '1');
const notice = screen.getByTestId('platform-outdated-agent-notice');
expect(notice).toHaveTextContent('app-01 runs an older Pulse agent (v5.1.34).');
- expect(notice).toHaveTextContent('latest in-guest telemetry and command support.');
+ expect(notice).toHaveTextContent('latest fixes and VM details.');
expect(screen.getByRole('link', { name: 'Open agent upgrade commands' })).toHaveAttribute(
'href',
'/settings/infrastructure/agent-doctor?agents=agent%3Aagent-app-01',