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
Qualify missing Coverage restore evidence with read quality
pulse-triage[bot]1332c4bc8042
diff --git a/frontend-modern/browser-verification/f563a0f987e5c7a3.json b/frontend-modern/browser-verification/f563a0f987e5c7a3.jsonnew file mode 100644index 0000000000..b2b15a9795--- /dev/null+++ b/frontend-modern/browser-verification/f563a0f987e5c7a3.json@@ -0,0 +1,43 @@+{+ "version": 1,+ "base_sha": "72c5579c55d143ec86b3b29a755ac2bbe95cf679",+ "verified_at": "2026-10-24T00:27:18Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx",+ "frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx"+ ],+ "content_sha256": {+ "frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx": "82182ae2cf2d0971d91b08232d502c5b019f1aff0691ea9820b6a6fec8ce67f8",+ "frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx": "fa55f749d77cdc472e5235e8aedb0a320d31b03de8643c2c3358861a631d9f6d"+ },+ "routes": [+ "/proxmox/backups/coverage"+ ],+ "viewports": [+ {+ "width": 1280,+ "height": 900+ },+ {+ "width": 320,+ "height": 812+ }+ ],+ "states": [+ "Actual production ProxmoxBackupsTable, real PVE/PBS/posture HTTP adapters, recovery model, Coverage table and CSS; read-only synthetic HTTP, not a native provider or full application stack. All 294 compiled production modules and artifacts are hash-bound.",+ "Observed and recovered: both accepted backups retain their dates, Verified evidence, Protected posture and complete/sufficient provider quality.",+ "Unreadable namespace history: the readable root remains visible; missing child backup age is Unknown and the expansion qualifies that history is not confirmed complete, rather than asserting no restore points.",+ "Denied/partial history: existing Needs attention and backup-exists explanation remain, with qualified missing evidence, Unknown age and no hidden raw artifact.",+ "Accepted complete/sufficient empty scope: None and source-scoped no-points copy, not a fabricated protected backup.",+ "Raw PBS HTTP503 and posture HTTP503: Unknown and qualified missing evidence despite empty raw arrays or retained complete quality. The synthetic private error body is not rendered. Expected network console errors are recorded, with no unexpected page/console errors.",+ "Known successful point outside the raw list: preserved server-owned Protected posture but Unknown raw-list age and explicit current-list qualification, not None or invented archive.",+ "All 16 state/viewport captures were opened with the native view_image tool; the 320px copy wraps, age stays readable and no horizontal document overflow appears."+ ],+ "interactions": [+ "Keyboard focus, Enter expansion/collapse/reopen through native workload row buttons at both widths.",+ "All three consuming production API hooks read the synthetic HTTP envelopes. No external request or mutation.",+ "Isolated Retry PBS inventory replaces Unknown/incomplete with accepted-empty None at both widths without a component remount.",+ "Inspected all sixteen actual screenshots with native view_image; browser contexts and local server closed."+ ]+}diff --git a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsxindex b49d40d162..1020b8ddd8 100644--- a/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx+++ b/frontend-modern/src/features/proxmox/ProxmoxBackupsTable.tsx@@ -934,6 +934,11 @@ export const ProxmoxBackupsTable: Component<{expandedKey={expandedCoverageKey()}onToggleExpand={toggleCoverageExpansion}showTaskColumn={coverageHasTask()}+ historyReadIncomplete={+ inventoryIncomplete() ||+ !protectionPostures.resolvedOnce() ||+ Boolean(protectionPostures.response.error)+ }/><Show when={orphanedTotalCount() > 0}>@@ -970,6 +975,11 @@ export const ProxmoxBackupsTable: Component<{expandedKey={expandedCoverageKey()}onToggleExpand={toggleCoverageExpansion}showTaskColumn={coverageHasTask()}+ historyReadIncomplete={+ inventoryIncomplete() ||+ !protectionPostures.resolvedOnce() ||+ Boolean(protectionPostures.response.error)+ }/></div></Show>diff --git a/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx b/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsxindex 8c4e508e8f..016b34615b 100644--- a/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx+++ b/frontend-modern/src/features/proxmox/ProxmoxCoverageTable.tsx@@ -65,20 +65,46 @@ const COVERAGE_NO_BACKUP_TITLE = 'No PBS snapshot or PVE backup file';// Matches the posture engine's own wording for a snapshot-only subject.const COVERAGE_SNAPSHOT_ONLY_TITLE ='No PBS snapshot or PVE backup file. A snapshot is not a separate backup, so it does not count.';+const COVERAGE_HISTORY_UNKNOWN_TITLE =+ 'No completed backup is visible in the current list. Missing entries do not mean no backups exist. Expand this row to inspect the evidence.';-function CoverageAgeFallback(props: { unknown?: boolean; emptyTitle: string; compact?: boolean }) {+// A fulfilled raw-inventory request is not proof that every provider scope was+// readable. Keep absence scoped to the server's history/access evidence, not+// the posture colour (an independently readable backup can still be Protected).+const hasCompleteCoverageHistory = (row: WorkloadCoverageRow): boolean => {+ const posture = row.protectionPosture;+ const providers = posture?.providerStates ?? [];+ return (+ (posture?.coverage === 'complete' || posture?.coverage === 'none') &&+ providers.length > 0 &&+ providers.every(+ (provider) =>+ provider.historyCompleteness === 'complete' && provider.permissions === 'sufficient',+ )+ );+};++function CoverageAgeFallback(props: {+ unknown?: boolean;+ historyUnknown?: boolean;+ emptyTitle: string;+ compact?: boolean;+}) {+ const unknown = () => props.unknown || props.historyUnknown;const title = () =>props.unknown? 'One or more completed restore-point dates are unavailable or in the future. The latest point is unknown. Expand this row to inspect the evidence.'- : props.emptyTitle;+ : props.historyUnknown+ ? COVERAGE_HISTORY_UNKNOWN_TITLE+ : props.emptyTitle;return (<span- class={props.unknown ? 'font-semibold text-amber-600 dark:text-amber-300' : 'text-muted'}- classList={{ 'text-[10px]': props.unknown && props.compact }}+ class={unknown() ? 'font-semibold text-amber-600 dark:text-amber-300' : 'text-muted'}+ classList={{ 'text-[10px]': unknown() && props.compact }}title={title()}- aria-label={props.unknown ? `Unknown age. ${title()}` : undefined}+ aria-label={unknown() ? `Unknown age. ${title()}` : undefined}>- {props.unknown ? 'Unknown' : COVERAGE_EMPTY_LABEL}+ {unknown() ? 'Unknown' : COVERAGE_EMPTY_LABEL}</span>);}@@ -220,6 +246,8 @@ export function ProxmoxCoverageTable(props: {// The task column auto-hides when no workload has task history. Per-source// ages (PBS snapshot, PVE file, guest snapshot) live in the row expansion.showTaskColumn: boolean;+ /** Inventory or posture read is pending/failed; retained quality cannot confirm absence. */+ historyReadIncomplete?: boolean;layoutWidth?: Accessor<number | null | undefined>;}) {const observedWidth = useObservedElementWidth();@@ -359,6 +387,8 @@ export function ProxmoxCoverageTable(props: {{(row) => {const isExpanded = () => props.expandedKey === row.key;const evidence = () => selectCoverageRestoreEvidence(row.artifacts);+ const historyComplete = () =>+ !props.historyReadIncomplete && hasCompleteCoverageHistory(row);const detailRowId = () => `proxmox-coverage-evidence-${row.key}`;return (<>@@ -448,6 +478,10 @@ export function ProxmoxCoverageTable(props: {fallback={<CoverageAgeFallbackunknown={row.ageUnknown?.backup}+ historyUnknown={+ !historyComplete() ||+ Boolean(row.protectionPosture?.lastSuccessfulPointAt)+ }compact={layoutMode() === 'compact'}emptyTitle={row.snapshotCount > 0@@ -554,7 +588,11 @@ export function ProxmoxCoverageTable(props: {role="status"class="text-xs">- No restore points found for this workload.+ {!historyComplete()+ ? 'Restore-point history is not confirmed complete. Missing entries do not mean no backups exist.'+ : row.protectionPosture?.lastSuccessfulPointAt+ ? 'No restore points are visible in the current list. Missing entries do not mean no backups exist.'+ : 'No restore points reported for this workload in the readable history.'}</InlineNotice>}>diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsxindex 0df9c3548b..bfe73865b9 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxBackupsTable.test.tsx@@ -1408,3 +1408,140 @@ describe('backup-identity: connected Coverage and By date', () => {expect(apiFetchMock.mock.calls.filter(([url]) => url === '/api/backups/pbs')).toHaveLength(1);});});++describe('Coverage qualifies missing restore evidence through the consuming API hooks', () => {+ const posture = {+ subjectResourceId: workloadResource.id,+ state: 'unprotected',+ freshness: 'unknown',+ verification: 'unknown',+ coverage: 'none',+ providerStates: [+ {+ provider: 'proxmox-pbs',+ source: 'pbs-backup-enumeration',+ scope: 'pbs-main',+ jobState: 'success',+ historyCompleteness: 'complete',+ permissions: 'sufficient',+ evidenceIds: [],+ },+ ],+ repositoryResourceIds: [],+ evidenceIds: [],+ explanation: 'Pulse sees the full history and no backup in it can count.',+ evaluatedAt: '2026-10-23T12:00:00Z',+ };+ const mount = () => {+ window.history.replaceState({}, '', '/proxmox/backups/coverage');+ return renderInRouter(() => (+ <ProxmoxBackupsTable emptyIcon={<span />} workloads={[workloadResource]} />+ ));+ };+ const rowElement = () =>+ document.querySelector('[data-proxmox-backup-row="coverage"]') as HTMLElement;+ const open = async () => {+ await waitFor(() => expect(rowElement()).not.toBeNull());+ fireEvent.click(within(rowElement()).getByRole('button', { name: /expand details/i }));+ return screen.findByTestId('proxmox-coverage-detail');+ };++ beforeEach(() => {+ apiFetchMock.mockImplementation((url: string) =>+ Promise.resolve(jsonResponse(url.endsWith('/pve') ? emptyPVE : emptyPBS)),+ );+ apiFetchJSONMock.mockResolvedValue({ data: [posture], policy: {} });+ });++ it.each(['partial', 'unavailable'])(+ 'does not mistake HTTP200 inventories beside %s provider history for absence',+ async (historyCompleteness) => {+ apiFetchJSONMock.mockResolvedValue({+ data: [+ {+ ...posture,+ state: 'unknown',+ coverage: 'unknown',+ providerStates: [{ ...posture.providerStates[0], historyCompleteness }],+ },+ ],+ policy: {},+ });+ mount();+ const detail = await open();+ await waitFor(() => expect(detail).toHaveTextContent('not confirmed complete'));+ expect(rowElement()).not.toHaveTextContent('None');+ expect(detail).not.toHaveTextContent('No restore points reported');+ expect(detail).not.toHaveTextContent('Restore evidence');+ },+ );++ it('qualifies a failed raw source, then accepts an isolated successful empty retry', async () => {+ let failed = true;+ apiFetchMock.mockImplementation((url: string) =>+ Promise.resolve(+ url.endsWith('/pbs') && failed+ ? new Response('', { status: 503 })+ : jsonResponse(url.endsWith('/pve') ? emptyPVE : emptyPBS),+ ),+ );+ mount();+ const retry = await screen.findByRole('button', { name: 'Retry PBS inventory' });+ const detail = await open();+ await waitFor(() => expect(detail).toHaveTextContent('not confirmed complete'));+ expect(rowElement()).not.toHaveTextContent('None');+ failed = false;+ fireEvent.click(retry);+ await waitFor(() =>+ expect(detail).toHaveTextContent(+ 'No restore points reported for this workload in the readable history.',+ ),+ );+ expect(within(rowElement()).getByTitle('No PBS snapshot or PVE backup file')).toHaveTextContent(+ 'None',+ );+ expect(sourceCalls('pve')).toHaveLength(1);+ expect(sourceCalls('pbs')).toHaveLength(2);+ });++ it('keeps a failed posture read unknown even when both raw inventories are accepted empty', async () => {+ apiFetchJSONMock.mockRejectedValue(new Error('synthetic posture read failed'));+ mount();+ const detail = await open();+ await screen.findByText(/Protection posture is unavailable/);+ expect(detail).toHaveTextContent('not confirmed complete');+ expect(rowElement()).not.toHaveTextContent('None');+ });++ it('keeps an independently visible backup and its date beside partial provider history', async () => {+ apiFetchMock.mockImplementation((url: string) =>+ Promise.resolve(jsonResponse(url.endsWith('/pve') ? emptyPVE : pbsPayload)),+ );+ apiFetchJSONMock.mockResolvedValue({+ data: [+ {+ ...posture,+ state: 'attention',+ coverage: 'partial',+ lastSuccessfulPointAt: pbsPayload.data.backups[0].backupTime,+ providerStates: [+ {+ ...posture.providerStates[0],+ historyCompleteness: 'partial',+ permissions: 'partial',+ },+ ],+ },+ ],+ policy: {},+ });+ mount();+ const detail = await open();+ await waitFor(() => expect(detail).toHaveTextContent('Restore evidence'));+ expect(rowElement()).not.toHaveTextContent('None');+ expect(within(rowElement()).queryByLabelText(/Unknown age/)).not.toBeInTheDocument();+ expect(detail).toHaveTextContent('History Partial');+ expect(detail).toHaveTextContent('Access Partial');+ expect(detail).not.toHaveTextContent('No restore points');+ });+});diff --git a/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx b/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsxindex 0e6cff664a..482642dd71 100644--- a/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx+++ b/frontend-modern/src/features/proxmox/__tests__/ProxmoxCoverageTable.test.tsx@@ -259,7 +259,9 @@ describe('ProxmoxCoverageTable column visibility', () => {));const notice = screen.getByRole('status');- expect(notice).toHaveTextContent('No restore points found for this workload.');+ expect(notice).toHaveTextContent(+ 'No restore points reported for this workload in the readable history.',+ );expect(notice.className).toContain('border-amber-300');// No registry match, so nothing to link to.expect(screen.queryByRole('link')).not.toBeInTheDocument();@@ -391,3 +393,105 @@ describe('ProxmoxCoverageTable column visibility', () => {expect(span?.closest('table')).toHaveClass('table-fixed');});});++describe('Coverage absence requires readable, complete history', () => {+ const unknownTitle =+ 'No completed backup is visible in the current list. Missing entries do not mean no backups exist. Expand this row to inspect the evidence.';+ const completePosture = row.protectionPosture!;+ const provider = completePosture.providerStates[0];+ const mount = (subject: WorkloadCoverageRow, historyReadIncomplete = false) =>+ renderInRouter(() => (+ <ProxmoxCoverageTable+ rows={[subject]}+ hasAnyRows+ emptyIcon={<span />}+ emptyTitle=""+ emptyDescription=""+ sortKey={() => 'posture'}+ sortDirection={() => 'asc'}+ onSort={() => {}}+ expandedKey="w1"+ onToggleExpand={() => {}}+ showTaskColumn={false}+ historyReadIncomplete={historyReadIncomplete}+ layoutWidth={() => 320}+ />+ ));++ it.each([+ ['partial history', { ...provider, historyCompleteness: 'partial' as const }],+ ['unavailable history', { ...provider, historyCompleteness: 'unavailable' as const }],+ ['unknown history', { ...provider, historyCompleteness: 'unknown' as const }],+ ['partial access', { ...provider, permissions: 'partial' as const }],+ ['denied access', { ...provider, permissions: 'denied' as const }],+ ['unknown access', { ...provider, permissions: 'unknown' as const }],+ ])('does not turn %s into confirmed absence', (_label, incompleteProvider) => {+ mount({+ ...row,+ posture: 'attention',+ protectionPosture: { ...completePosture, providerStates: [incompleteProvider] },+ });++ expect(screen.getByTitle(unknownTitle)).toHaveTextContent(/^Unknown$/);+ expect(screen.getByLabelText(`Unknown age. ${unknownTitle}`)).toBeInTheDocument();+ expect(screen.getByRole('status')).toHaveTextContent(+ 'Restore-point history is not confirmed complete. Missing entries do not mean no backups exist.',+ );+ expect(document.body.textContent).not.toContain('No restore points found');+ expect(document.body.textContent).not.toContain('No restore points reported');+ // This copy qualifies the list; it does not synthesise a hidden archive.+ expect(screen.queryByText('Restore evidence')).not.toBeInTheDocument();+ });++ it.each([+ ['missing posture', undefined],+ ['no provider evidence', { ...completePosture, providerStates: [] }],+ ['unknown scope', { ...completePosture, coverage: 'unknown' as const }],+ ['partial scope', { ...completePosture, coverage: 'partial' as const }],+ [+ 'one readable source beside an unreadable source',+ {+ ...completePosture,+ providerStates: [provider, { ...provider, historyCompleteness: 'unavailable' as const }],+ },+ ],+ ])('keeps %s unknown even when raw requests fulfilled', (_label, protectionPosture) => {+ mount({ ...row, protectionPosture });+ expect(screen.getByTitle(unknownTitle)).toHaveTextContent(/^Unknown$/);+ expect(screen.getByRole('status')).toHaveTextContent('not confirmed complete');+ });++ it('qualifies pending/failed reads even beside retained complete provider quality', () => {+ mount(row, true);+ expect(screen.getByTitle(unknownTitle)).toHaveTextContent(/^Unknown$/);+ expect(screen.getByRole('status')).toHaveTextContent('not confirmed complete');+ });++ it('keeps a known backup outside the raw list unknown, not None', () => {+ mount({+ ...row,+ protectionPosture: {+ ...completePosture,+ lastSuccessfulPointAt: '2026-10-23T00:00:00Z',+ },+ });+ expect(screen.getByTitle(unknownTitle)).toHaveTextContent(/^Unknown$/);+ expect(screen.getByRole('status')).toHaveTextContent(+ 'No restore points are visible in the current list. Missing entries do not mean no backups exist.',+ );+ expect(screen.queryByText('Restore evidence')).not.toBeInTheDocument();+ });++ it('preserves accepted-empty history as a scoped empty observation', () => {+ mount({+ ...row,+ posture: 'unprotected',+ protectionPosture: { ...completePosture, state: 'unprotected', coverage: 'none' },+ });+ expect(screen.getByTitle('No PBS snapshot or PVE backup file')).toHaveTextContent(/^None$/);+ expect(screen.getByRole('status')).toHaveTextContent(+ 'No restore points reported for this workload in the readable history.',+ );+ expect(screen.queryByTitle(unknownTitle)).not.toBeInTheDocument();+ });+});