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.

Explain denied Proxmox update checks in node details

rcourtmancbec132640cd
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index 1511069f29..6f9002e4f6 100644
--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md
+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
@@ -1392,6 +1392,9 @@ removal/failure retention and containing publication remain separate evidence.
1a. `frontend-modern/src/components/Infrastructure/resourceDetailDrawerMetricsHistoryModel.ts`
1b. `frontend-modern/src/components/Workloads/nodeDrawerModel.ts`
1c. `frontend-modern/src/features/docker/dockerHostDrawerModel.ts`
+ 1d. `frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx`
+ 1e. `frontend-modern/src/utils/proxmoxUpdateEvidence.ts`
+ 1f. `frontend-modern/src/content/help/updates.ts`
2. `frontend-modern/src/components/Settings/Settings.tsx`
3. `frontend-modern/src/components/Settings/SettingsDialogs.tsx`
4. `frontend-modern/src/components/Settings/SettingsPageShell.tsx`
@@ -8767,9 +8770,23 @@ The Proxmox node drawer presents checked zero, current positive, stale,
unavailable, and not-checked package evidence as a labelled detail row with
bounded copy and checked time. The compact table badge remains reserved for a
current positive observation. Provider errors are never rendered. Component
-and browser evidence covers both 1440px and 390px layouts in
-`NodeDrawerOverview.updateEvidence.test.tsx`, `ProxmoxNodesTable.test.tsx`, and
-`frontend-modern/browser-verification.json`.
+evidence is covered by `NodeDrawerOverview.updateEvidence.test.tsx`,
+`proxmoxUpdateEvidence.test.ts`, and `ProxmoxNodesTable.test.tsx`.
+
+Denied update-list access exposes visible guidance beside that status through
+the shared HelpIcon and help-content registry. It explains that inventory and
+metrics use separate permission checks, preserves the choice to monitor with
+read-only access, and describes Sys.Modify as broader access that also permits
+refreshing package indexes. A denied response does not establish the exact
+missing privilege or an empty update list. Status text wraps through the shared
+detail-row contract at phone widths, including retained counts and checked time.
+The operator-context section and its help control retain their identity while
+readings and relative timestamps update. The shared help dialog remains inside
+the viewport with scrollable content, keyboard dismissal and focus return.
+Current-source browser receipts under `frontend-modern/browser-verification/`
+cover desktop, intermediate, phone and short landscape layouts. These checks
+establish presentation and interaction, not installed Proxmox permissions or
+released acceptance.
### Docker drawers expose reduced helper coverage without actions
diff --git a/docs/release-control/v6/internal/subsystems/registry.json b/docs/release-control/v6/internal/subsystems/registry.json
index 4aa61ae657..ce650f7ce8 100644
--- a/docs/release-control/v6/internal/subsystems/registry.json
+++ b/docs/release-control/v6/internal/subsystems/registry.json
@@ -5278,6 +5278,8 @@
"frontend-modern/src/components/Toast/Toast.tsx",
"frontend-modern/src/components/Workloads/GuestDrawerHistory.tsx",
"frontend-modern/src/components/Workloads/nodeDrawerModel.ts",
+ "frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx",
+ "frontend-modern/src/content/help/updates.ts",
"frontend-modern/src/features/docker/dockerHostDrawerModel.ts",
"frontend-modern/src/features/platformPage/platformEstateOverviewModel.ts",
"frontend-modern/src/features/platformPage/PlatformOutdatedAgentNotice.tsx",
@@ -5306,6 +5308,7 @@
"frontend-modern/src/utils/environmentLockPresentation.ts",
"frontend-modern/src/utils/platformSupportManifest.generated.ts",
"frontend-modern/src/utils/platformSupportManifest.ts",
+ "frontend-modern/src/utils/proxmoxUpdateEvidence.ts",
"frontend-modern/src/utils/reportableResourceTypes.ts",
"frontend-modern/src/utils/reportingPresentation.ts",
"frontend-modern/src/utils/reportingResourceTypes.ts",
@@ -5917,7 +5920,11 @@
"match_prefixes": [
"frontend-modern/src/components/shared/"
],
- "match_files": [],
+ "match_files": [
+ "frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx",
+ "frontend-modern/src/content/help/updates.ts",
+ "frontend-modern/src/utils/proxmoxUpdateEvidence.ts"
+ ],
"allow_same_subsystem_tests": false,
"test_prefixes": [],
"exact_files": [
@@ -5940,7 +5947,10 @@
"frontend-modern/src/components/shared/FilterToolbar.test.tsx",
"frontend-modern/src/components/shared/InlineNotice.test.tsx",
"frontend-modern/src/components/shared/SharedPrimitives.guardrails.test.ts",
- "frontend-modern/src/components/shared/TypeColumn.guardrails.test.ts"
+ "frontend-modern/src/components/shared/TypeColumn.guardrails.test.ts",
+ "frontend-modern/src/components/Workloads/__tests__/NodeDrawerOverview.updateEvidence.test.tsx",
+ "frontend-modern/src/features/proxmox/__tests__/ProxmoxNodesTable.test.tsx",
+ "frontend-modern/src/utils/__tests__/proxmoxUpdateEvidence.test.ts"
]
},
{
diff --git a/frontend-modern/browser-verification/e43416515dd06630.json b/frontend-modern/browser-verification/e43416515dd06630.json
new file mode 100644
index 0000000000..589a7166c1
--- /dev/null
+++ b/frontend-modern/browser-verification/e43416515dd06630.json
@@ -0,0 +1,77 @@
+{
+ "version": 1,
+ "base_sha": "634ce84dced83459580a461eeafc565dc7ff1259",
+ "verified_at": "2026-10-12T16:32:02Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx",
+ "frontend-modern/src/components/shared/HelpIcon.tsx",
+ "frontend-modern/src/components/shared/helpIconModel.ts",
+ "frontend-modern/src/components/shared/useHelpIconState.ts",
+ "frontend-modern/src/content/help/updates.ts",
+ "frontend-modern/src/utils/proxmoxUpdateEvidence.ts"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx": "26c84752b849f2cbb9f56e963eab7a65800a14f1031d7389200e899b6477856a",
+ "frontend-modern/src/components/shared/HelpIcon.tsx": "154ff34a5b770a4c5abe954af42ca43b4fd343b593d0ecf36c2aaf21ec1e372f",
+ "frontend-modern/src/components/shared/helpIconModel.ts": "a28b0aa96d48d05ceba5d062d823ec444f15c0e6de17665d1da9bbbf3b0a54ca",
+ "frontend-modern/src/components/shared/useHelpIconState.ts": "c1a05f886cd5f7ec9a1b5f7c4ac98825b3b8f10321be9cc0027053f4c832b8c8",
+ "frontend-modern/src/content/help/updates.ts": "bfe8fc379c4074f0932b3dd9906ef643767bb94544295b0b2c7fc68f86be6f16",
+ "frontend-modern/src/utils/proxmoxUpdateEvidence.ts": "52af16617dbe18ed2608d285975b9565ba22e0e48017723a580a126cc5c90f9a"
+ },
+ "routes": [
+ "/node-update-proof.html (production NodeDrawer and shared inline detail row fixture for Proxmox node Overview)"
+ ],
+ "viewports": [
+ {
+ "width": 1440,
+ "height": 900
+ },
+ {
+ "width": 900,
+ "height": 900
+ },
+ {
+ "width": 390,
+ "height": 844
+ },
+ {
+ "width": 320,
+ "height": 640
+ },
+ {
+ "width": 844,
+ "height": 390
+ }
+ ],
+ "states": [
+ "Permission denied with no successful check",
+ "Permission denied with retained positive and zero counts and checked time",
+ "Current checked zero and positive counts",
+ "Source unavailable, failed check, offline not checked and absent evidence",
+ "Help closed/open with full description and documentation link",
+ "Scrollable help at short landscape height",
+ "Help retained through metric replacement and relative-time advance",
+ "Checked recovery withdraws denied guidance",
+ "History/Overview return, keyboard collapse/remount and reload closed"
+ ],
+ "interactions": [
+ "Pointer hover/focus and Enter open the labelled help control",
+ "Touch opens and closes the help at 390x844",
+ "Close and Escape restore trigger focus",
+ "Outside click closes help without collapsing expanded details",
+ "Documentation link remains reachable by scrolling the help body",
+ "Open dialog stays contained through viewport resize and page scrolling",
+ "Node metric replacement and one-minute clock advance retain the same open dialog",
+ "Recovery removes guidance and open help",
+ "History/Overview selection, keyboard collapse while help is open, remount and reload"
+ ],
+ "command": "Playwright Chromium controlled through the persistent JavaScript runtime against the isolated pulse-dev Vite build at port 8087",
+ "notes": [
+ "Production NodeDrawer, shared InlineDetailTableRow and shared Table rendered with synthetic node data and synthetic read-only API responses. No installed collection or customer permission claim.",
+ "Inspected actual pixels and text-range bounds for complete status, retained counts and checked time. No horizontal overflow at 320/390/900/1440 widths.",
+ "Inspected help placement, stacking, full copy, Close focus, scrolling and Learn more at 1440x900, 900x900, 390x844, 320x640 and 844x390.",
+ "Worker source snapshot based on 634ce84dced83459580a461eeafc565dc7ff1259 with exact staged runtime bytes. Package-lock matched installed dependency graph.",
+ "Interaction matrix, screenshots and raw browser results retained locally under /Volumes/Development/.caches/support-triage-20261012/."
+ ]
+}
diff --git a/frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx b/frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx
index 2d4e200477..c7072ae28e 100644
--- a/frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx
+++ b/frontend-modern/src/components/Workloads/NodeDrawerOverview.tsx
@@ -1,4 +1,6 @@
+import { Show } from 'solid-js';
import { useRelativeTimeNow } from '@/utils/relativeTimeClock';
+import { HelpIcon } from '@/components/shared/HelpIcon';
import { TechnicalDetailsSection } from '@/components/shared/TechnicalDetailsDisclosure';
import { DrawerAttentionSection } from '@/components/shared/DrawerAttentionSection';
import {
@@ -6,6 +8,7 @@ import {
compactDetailSections,
makeDetailRow,
type DetailRow,
+ type DetailSection,
type DetailValueTone,
} from '@/components/shared/DetailSectionTable';
import type { Alert, Disk, HostGPUSensor, Node, Temperature } from '@/types/api';
@@ -338,39 +341,61 @@ export function NodeDrawerOverview(props: NodeDrawerOverviewProps) {
},
]);
- const overviewSections = () => {
- const primaryTemperature = getCpuTemperature(props.node.temperature);
- const updates = updateEvidence();
- const temperatureClass =
- typeof primaryTemperature === 'number'
- ? getTemperatureTextClass(primaryTemperature, props.temperatureThresholds)
- : '';
- return compactDetailSections([
- {
- label: 'Operator context',
- rows: compactDetailRows([
- makeDetailRow('Platform', versionLabel() ? `PVE ${versionLabel()}` : null),
- makeDetailRow(
- 'Pulse coverage',
- linkedAgentId() ? `Agent ${stripAgentPrefix(linkedAgentId())}` : 'PVE API only',
- ),
- updates
- ? makeDetailRow('Updates', updates.value, {
- tone: updates.tone,
- title: updates.title,
- })
- : null,
- typeof primaryTemperature === 'number' &&
- (temperatureClass.includes('yellow') || temperatureClass.includes('red'))
- ? makeDetailRow('Temperature', formatTemperature(primaryTemperature), {
- tone: temperatureClass.includes('red') ? 'danger' : 'warning',
- })
- : null,
- ]),
- },
- ]);
+ const updateAccessGuidance = (
+ <Show when={updateEvidence()?.helpContentId}>
+ <div class="space-y-1 text-left text-[11px] font-normal text-muted">
+ <p class="whitespace-normal wrap-anywhere">
+ Update checks use separate Proxmox access. Other monitoring can still work.
+ </p>
+ <HelpIcon
+ contentId="updates.proxmox.access"
+ triggerLabel="Why update checks are unavailable"
+ size="xs"
+ class="-ml-2"
+ />
+ </div>
+ </Show>
+ );
+
+ // Keep the interactive guidance owned by the drawer, rather than rebuilding
+ // its section and help state whenever node readings or relative ages change.
+ const operatorContextSection: DetailSection = {
+ label: 'Operator context',
+ get rows() {
+ const primaryTemperature = getCpuTemperature(props.node.temperature);
+ const updates = updateEvidence();
+ const temperatureClass =
+ typeof primaryTemperature === 'number'
+ ? getTemperatureTextClass(primaryTemperature, props.temperatureThresholds)
+ : '';
+ return compactDetailRows([
+ makeDetailRow('Platform', versionLabel() ? `PVE ${versionLabel()}` : null),
+ makeDetailRow(
+ 'Pulse coverage',
+ linkedAgentId() ? `Agent ${stripAgentPrefix(linkedAgentId())}` : 'PVE API only',
+ ),
+ updates
+ ? makeDetailRow('Updates', updates.value, {
+ tone: updates.tone,
+ title: updates.title,
+ wrap: true,
+ })
+ : null,
+ typeof primaryTemperature === 'number' &&
+ (temperatureClass.includes('yellow') || temperatureClass.includes('red'))
+ ? makeDetailRow('Temperature', formatTemperature(primaryTemperature), {
+ tone: temperatureClass.includes('red') ? 'danger' : 'warning',
+ })
+ : null,
+ ]);
+ },
+ get footerContent() {
+ return updateEvidence()?.helpContentId ? updateAccessGuidance : undefined;
+ },
};
+ const overviewSections = () => [operatorContextSection];
+
return (
<div class="space-y-3">
<DrawerAttentionSection
diff --git a/frontend-modern/src/components/Workloads/__tests__/NodeDrawerOverview.updateEvidence.test.tsx b/frontend-modern/src/components/Workloads/__tests__/NodeDrawerOverview.updateEvidence.test.tsx
index bd997514f5..bea667f748 100644
--- a/frontend-modern/src/components/Workloads/__tests__/NodeDrawerOverview.updateEvidence.test.tsx
+++ b/frontend-modern/src/components/Workloads/__tests__/NodeDrawerOverview.updateEvidence.test.tsx
@@ -1,4 +1,5 @@
-import { cleanup, render, screen } from '@solidjs/testing-library';
+import { cleanup, fireEvent, render, screen } from '@solidjs/testing-library';
+import { createSignal } from 'solid-js';
import { afterEach, describe, expect, it, vi } from 'vitest';
import { NodeDrawerOverview } from '@/components/Workloads/NodeDrawerOverview';
@@ -79,6 +80,34 @@ describe('NodeDrawerOverview update evidence', () => {
/>
));
- expect(screen.getByText('Unavailable · Update check access denied')).toBeInTheDocument();
+ const status = screen.getByText('Unavailable · Update check access denied');
+ expect(status).toHaveClass('whitespace-normal');
+ expect(status).not.toHaveClass('truncate');
+ expect(screen.getByText(/Other monitoring can still work/)).toBeInTheDocument();
+ fireEvent.click(screen.getByRole('button', { name: 'Why update checks are unavailable' }));
+ const help = screen.getByRole('dialog', { name: 'Proxmox update-check access' });
+ expect(help).toHaveTextContent('Sys.Modify');
+ expect(help).toHaveTextContent('broader than read-only monitoring');
+ expect(help).toHaveTextContent('does not identify the exact missing privilege');
+ });
+
+ it('keeps guidance open while node readings and evidence age update', () => {
+ const start = Date.parse('2026-10-10T12:00:00Z');
+ vi.useFakeTimers({ toFake: ['Date', 'setInterval', 'clearInterval'], now: start });
+ const [node, setNode] = createSignal(
+ makeNode({
+ pendingUpdates: 7,
+ pendingUpdatesStatus: 'stale',
+ pendingUpdatesReason: 'permission_denied',
+ pendingUpdatesCheckedAt: new Date(start - 60_000).toISOString(),
+ }),
+ );
+ render(() => <NodeDrawerOverview node={node()} />);
+ fireEvent.click(screen.getByRole('button', { name: 'Why update checks are unavailable' }));
+ const help = screen.getByRole('dialog', { name: 'Proxmox update-check access' });
+ setNode({ ...node(), cpu: 0.2 });
+ vi.advanceTimersByTime(60_000);
+ expect(screen.getByRole('dialog', { name: 'Proxmox update-check access' })).toBe(help);
+ expect(screen.getByText(/7 pending.*stale.*checked 2 mins ago/)).toBeInTheDocument();
});
});
diff --git a/frontend-modern/src/components/shared/HelpIcon.tsx b/frontend-modern/src/components/shared/HelpIcon.tsx
index 97588da1c2..03ac7fd2a7 100644
--- a/frontend-modern/src/components/shared/HelpIcon.tsx
+++ b/frontend-modern/src/components/shared/HelpIcon.tsx
@@ -24,14 +24,19 @@ export const HelpIcon: Component<HelpIconProps> = (props) => {
<button
ref={state.setButtonRef}
type="button"
- class={`inline-flex min-h-11 min-w-11 items-center justify-center rounded-full p-1 text-slate-400 transition-colors hover:text-blue-500 focus:outline-hidden focus-visible:ring-2 focus-visible:ring-blue-500 sm:min-h-8 sm:min-w-8 dark:hover:text-blue-400 ${props.class ?? ''}`}
+ class={`inline-flex min-h-11 min-w-11 max-w-full items-center justify-center gap-1.5 transition-colors focus:outline-hidden focus-visible:ring-2 focus-visible:ring-blue-500 sm:min-h-8 sm:min-w-8 ${props.triggerLabel ? 'rounded-sm px-2 py-1 text-xs font-medium text-blue-600 hover:text-blue-700 dark:text-blue-400 dark:hover:text-blue-300' : 'rounded-full p-1 text-slate-400 hover:text-blue-500 dark:hover:text-blue-400'} ${props.class ?? ''}`}
onClick={state.toggleOpen}
- aria-label={`Help: ${helpContent.title}`}
+ aria-label={props.triggerLabel ?? `Help: ${helpContent.title}`}
aria-expanded={state.isOpen()}
aria-haspopup="dialog"
aria-controls={state.isOpen() ? popoverId : undefined}
>
- <CircleHelp class={helpIconSizeClasses[state.size()]} strokeWidth={2} />
+ <CircleHelp class={`${helpIconSizeClasses[state.size()]} shrink-0`} strokeWidth={2} />
+ <Show when={props.triggerLabel}>
+ <span class="min-w-0 text-left whitespace-normal wrap-anywhere">
+ {props.triggerLabel}
+ </span>
+ </Show>
</button>
<Show when={state.isOpen()}>
@@ -41,15 +46,15 @@ export const HelpIcon: Component<HelpIconProps> = (props) => {
id={popoverId}
role="dialog"
aria-labelledby={titleId}
- class="fixed z-9999 bg-surface rounded-md shadow-xs border border-border overflow-hidden animate-in fade-in-0 zoom-in-95 duration-150 min-w-[200px]"
+ class="fixed z-9999 flex max-h-[calc(100dvh-16px)] flex-col bg-surface rounded-md shadow-xs border border-border overflow-hidden animate-in fade-in-0 zoom-in-95 duration-150 min-w-[200px]"
style={{
top: `${state.popoverPosition().top}px`,
left: `${state.popoverPosition().left}px`,
- 'max-width': `${state.maxWidth()}px`,
+ 'max-width': `min(${state.maxWidth()}px, calc(100vw - 16px))`,
}}
>
{/* Header */}
- <div class="px-3 py-2 bg-surface-alt border-b border-border flex items-center justify-between gap-2">
+ <div class="shrink-0 px-3 py-2 bg-surface-alt border-b border-border flex items-center justify-between gap-2">
<span id={titleId} class="text-sm font-medium text-base-content">
{helpContent.title}
</span>
@@ -65,7 +70,7 @@ export const HelpIcon: Component<HelpIconProps> = (props) => {
</div>
{/* Content */}
- <div class="px-3 py-2.5 text-xs text-muted space-y-2">
+ <div class="min-h-0 overflow-y-auto px-3 py-2.5 text-xs text-muted space-y-2">
<p class="whitespace-pre-line leading-relaxed">{helpContent.description}</p>
<Show when={helpContent.examples && helpContent.examples.length > 0}>
diff --git a/frontend-modern/src/components/shared/__tests__/HelpIcon.test.tsx b/frontend-modern/src/components/shared/__tests__/HelpIcon.test.tsx
index a490ccbe31..f32f40bca4 100644
--- a/frontend-modern/src/components/shared/__tests__/HelpIcon.test.tsx
+++ b/frontend-modern/src/components/shared/__tests__/HelpIcon.test.tsx
@@ -111,4 +111,41 @@ describe('HelpIcon', () => {
expect(first.id).not.toBe(second.id);
expect(first.getAttribute('aria-labelledby')).not.toBe(second.getAttribute('aria-labelledby'));
});
+
+ it('contains the full dialog box through animation, resize and scrolling', async () => {
+ let flushFrame: FrameRequestCallback | undefined;
+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {
+ flushFrame = callback;
+ return 1;
+ });
+ vi.stubGlobal('cancelAnimationFrame', vi.fn());
+ vi.stubGlobal('innerWidth', 240);
+ vi.stubGlobal('innerHeight', 220);
+ render(() => <HelpIcon inline={{ title: 'Responsive help', description: 'Description' }} />);
+
+ const trigger = screen.getByRole('button', { name: 'Help: Responsive help' });
+ vi.spyOn(trigger, 'getBoundingClientRect').mockReturnValue(new DOMRect(200, 150, 20, 20));
+ fireEvent.click(trigger);
+ const dialog = await screen.findByRole('dialog', { name: 'Responsive help' });
+ Object.defineProperties(dialog, {
+ offsetWidth: { value: 200 },
+ offsetHeight: { value: 150 },
+ });
+ vi.spyOn(dialog, 'getBoundingClientRect').mockReturnValue(new DOMRect(0, 0, 180, 135));
+ flushFrame?.(0);
+ expect(dialog.style.left).toBe('32px');
+ expect(dialog.style.top).toBe('62px');
+
+ vi.stubGlobal('innerWidth', 500);
+ vi.stubGlobal('innerHeight', 600);
+ fireEvent(window, new Event('resize'));
+ expect(dialog.style.left).toBe('110px');
+ expect(dialog.style.top).toBe('178px');
+
+ vi.spyOn(trigger, 'getBoundingClientRect').mockReturnValue(new DOMRect(100, 350, 20, 20));
+ fireEvent(window, new Event('scroll'));
+ expect(dialog.style.left).toBe('10px');
+ expect(dialog.style.top).toBe('192px');
+ expect(screen.getByRole('button', { name: 'Close help' })).toHaveFocus();
+ });
});
diff --git a/frontend-modern/src/components/shared/helpIconModel.ts b/frontend-modern/src/components/shared/helpIconModel.ts
index 27761dddf0..9018d813e7 100644
--- a/frontend-modern/src/components/shared/helpIconModel.ts
+++ b/frontend-modern/src/components/shared/helpIconModel.ts
@@ -14,6 +14,7 @@ export interface HelpIconProps {
class?: string;
position?: 'top' | 'bottom';
maxWidth?: number;
+ triggerLabel?: string;
}
export interface HelpPopoverPosition {
diff --git a/frontend-modern/src/components/shared/useHelpIconState.ts b/frontend-modern/src/components/shared/useHelpIconState.ts
index 7cc1920490..fd99a767ca 100644
--- a/frontend-modern/src/components/shared/useHelpIconState.ts
+++ b/frontend-modern/src/components/shared/useHelpIconState.ts
@@ -28,7 +28,7 @@ export function useHelpIconState(props: HelpIconProps) {
createEffect(() => {
if (!isOpen() || !buttonRef()) return;
- requestAnimationFrame(() => {
+ const updatePosition = () => {
const button = buttonRef();
const popover = popoverRef();
if (!button || !popover) return;
@@ -36,14 +36,34 @@ export function useHelpIconState(props: HelpIconProps) {
setPopoverPosition(
calculateHelpPopoverPosition({
buttonRect: button.getBoundingClientRect(),
- popoverRect: popover.getBoundingClientRect(),
+ // Opening animations transform the visual box. Place the full layout
+ // box so the dialog remains contained when the animation finishes.
+ popoverRect: new DOMRect(0, 0, popover.offsetWidth, popover.offsetHeight),
preferredPosition: preferredPosition(),
viewportWidth: window.innerWidth,
viewportHeight: window.innerHeight,
}),
);
+ };
+
+ const frame = requestAnimationFrame(() => {
+ updatePosition();
closeButtonRef()?.focus({ preventScroll: true });
});
+
+ window.addEventListener('resize', updatePosition);
+ window.addEventListener('scroll', updatePosition, true);
+ const observer =
+ typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(updatePosition);
+ const popover = popoverRef();
+ if (popover) observer?.observe(popover);
+
+ onCleanup(() => {
+ cancelAnimationFrame(frame);
+ window.removeEventListener('resize', updatePosition);
+ window.removeEventListener('scroll', updatePosition, true);
+ observer?.disconnect();
+ });
});
createEffect(() => {
diff --git a/frontend-modern/src/content/help/updates.ts b/frontend-modern/src/content/help/updates.ts
index 6ed80d3a34..93cc3f01b0 100644
--- a/frontend-modern/src/content/help/updates.ts
+++ b/frontend-modern/src/content/help/updates.ts
@@ -4,6 +4,17 @@ import type { HelpContent } from './types';
* Help content for update-related features
*/
export const updatesHelpContent: HelpContent[] = [
+ {
+ id: 'updates.proxmox.access',
+ title: 'Proxmox update-check access',
+ description:
+ "Pulse was denied access to this node's package-update list. Inventory and metrics use separate Proxmox permission checks, so they can still work.\n\n" +
+ "Proxmox's update-list endpoint requires Sys.Modify on the node in current versions. This also permits refreshing package indexes, so it is broader than read-only monitoring.\n\n" +
+ 'You can keep read-only access and check updates in Proxmox. To show update counts in Pulse, review the requirements for your installed Proxmox version and the effective permissions of the exact user or token this connection uses.\n\n' +
+ 'A denied request does not identify the exact missing privilege or confirm that no updates are available.',
+ docUrl:
+ 'https://github.com/rcourtman/Pulse/blob/main/docs/TROUBLESHOOTING.md#proxmox-pending-update-access',
+ },
{
id: 'updates.docker.notifications',
title: 'Container Update Detection',
diff --git a/frontend-modern/src/utils/__tests__/proxmoxUpdateEvidence.test.ts b/frontend-modern/src/utils/__tests__/proxmoxUpdateEvidence.test.ts
index f2dabdf3bb..a33e24e9ae 100644
--- a/frontend-modern/src/utils/__tests__/proxmoxUpdateEvidence.test.ts
+++ b/frontend-modern/src/utils/__tests__/proxmoxUpdateEvidence.test.ts
@@ -53,9 +53,35 @@ describe('Proxmox update evidence presentation', () => {
).toMatchObject({
value: 'Unavailable · Update check access denied',
current: false,
+ helpContentId: 'updates.proxmox.access',
});
});
+ it('offers access guidance for a denied refresh without replacing retained evidence', () => {
+ expect(
+ getProxmoxUpdateEvidencePresentation(
+ {
+ pendingUpdates: 7,
+ pendingUpdatesStatus: 'stale',
+ pendingUpdatesReason: 'permission_denied',
+ pendingUpdatesCheckedAt: '2026-08-29T12:00:00Z',
+ },
+ relative,
+ ),
+ ).toMatchObject({
+ value: '7 pending · stale · checked 5 mins ago',
+ current: false,
+ helpContentId: 'updates.proxmox.access',
+ });
+ for (const state of [
+ { pendingUpdatesStatus: 'checked', pendingUpdatesReason: 'permission_denied' },
+ { pendingUpdatesStatus: 'unavailable', pendingUpdatesReason: 'source_unavailable' },
+ { pendingUpdatesStatus: 'not_checked', pendingUpdatesReason: 'node_offline' },
+ ] as const) {
+ expect(getProxmoxUpdateEvidencePresentation(state)?.helpContentId).toBeUndefined();
+ }
+ });
+
it('only treats checked or legacy-positive evidence as current', () => {
expect(hasCurrentProxmoxUpdateEvidence({ pendingUpdates: 3 })).toBe(true);
expect(
diff --git a/frontend-modern/src/utils/proxmoxUpdateEvidence.ts b/frontend-modern/src/utils/proxmoxUpdateEvidence.ts
index 4b90f7a1d8..30b9222183 100644
--- a/frontend-modern/src/utils/proxmoxUpdateEvidence.ts
+++ b/frontend-modern/src/utils/proxmoxUpdateEvidence.ts
@@ -1,4 +1,5 @@
import type { Node } from '@/types/api';
+import type { HelpContentId } from '@/content/help';
import { formatRelativeTime } from '@/utils/format';
export interface ProxmoxUpdateEvidencePresentation {
@@ -6,6 +7,7 @@ export interface ProxmoxUpdateEvidencePresentation {
title: string;
tone: 'success' | 'warning' | 'default';
current: boolean;
+ helpContentId?: HelpContentId;
}
type UpdateEvidenceNode = Pick<
@@ -40,6 +42,10 @@ export const getProxmoxUpdateEvidencePresentation = (
? formatCheckedAt(node.pendingUpdatesCheckedAt)
: '';
const reason = reasonLabel(node.pendingUpdatesReason);
+ const accessHelp =
+ node.pendingUpdatesReason === 'permission_denied'
+ ? { helpContentId: 'updates.proxmox.access' }
+ : {};
const status =
node.pendingUpdatesStatus ||
(node.pendingUpdatesCheckedAt || (typeof node.pendingUpdates === 'number' && count > 0)
@@ -72,6 +78,7 @@ export const getProxmoxUpdateEvidencePresentation = (
.join(' · '),
tone: 'warning',
current: false,
+ ...accessHelp,
};
}
case 'unavailable':
@@ -80,6 +87,7 @@ export const getProxmoxUpdateEvidencePresentation = (
title: reason || 'Update evidence is unavailable',
tone: 'warning',
current: false,
+ ...accessHelp,
};
case 'not_checked':
return {