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
Preserve upstream API wording and diagnostics authority contracts
pulse-triage[bot]de5f541553ab
diff --git a/docs/API.md b/docs/API.mdindex 2840f1258b..173540ff43 100644--- a/docs/API.md+++ b/docs/API.md@@ -989,7 +989,7 @@ apply. GET and CSV never use AI narration.- `POST /api/admin/reports/generate-multi` (admin, `settings:read`)- Body fields: `resources` (1-50 entries of `{resourceType,resourceId}`), `format`, `metricType` (optional), `start`/`end` (RFC3339, optional; defaults to last 24h), `title` (optional)- If `title` is omitted, the backend applies the canonical default fleet report title.- - Fleet PDF narration follows the same `ai:execute` rule for API tokens; without it, the report uses the deterministic summary. CSV output is never narrated.+ - AI narration of the fleet summary follows the same rule as single reports: API-token callers need `ai:execute`, otherwise the deterministic summary is used. CSV output is never narrated.- `GET /api/admin/reports/inventory/vms/export` (admin, `settings:read`)- Query params: `format` (`csv` only; optional and defaults to `csv`)- Exports the current fleet-wide VM inventory as spreadsheet-friendly CSV using the canonical runtime model.diff --git a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md b/docs/release-control/v6/internal/subsystems/agent-lifecycle.mdindex dc53be658c..55ac477663 100644--- a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md+++ b/docs/release-control/v6/internal/subsystems/agent-lifecycle.md@@ -9533,3 +9533,13 @@ isolation, diagnostic throttles and command ceilings are unchanged.and buffered primary paths, record/instance guidance, secret/body non-disclosureand same-credential recovery. These synthetic HTTP controls do not establish aninstalled host's cause or reporting recovery.+++### Upstream diagnostics visibility composition (11 October 2026)++Agent diagnostics may not expose other organizations' API-token records to a narrow token caller. The diagnostics token list uses the existing caller-management authority; no agent reporting, install, command or credential scope is broadened. Session callers retain their existing diagnostic authority.++The accepted upstream `diagnostics_token_visibility_test.go` controls and API+reference route checks cover caller filtering and the documented authority.+Final-source checks must retain this upstream behavior beside the reviewed+reporting/help repairs; source proof is not installed credential recovery.diff --git a/docs/release-control/v6/internal/subsystems/api-contracts.md b/docs/release-control/v6/internal/subsystems/api-contracts.mdindex fd367b21b3..5e67417ac2 100644--- a/docs/release-control/v6/internal/subsystems/api-contracts.md+++ b/docs/release-control/v6/internal/subsystems/api-contracts.md@@ -12146,3 +12146,13 @@ unchanged. The mounted Settings test holds source/target identities fixed andchecks one initial list call while the expiry is crossed.An expired loaded check reads Stale rather than Online in an amber badge;intentional pause and the dedicated stopped-probe label still take precedence.+++### Upstream diagnostics visibility composition (11 October 2026)++Diagnostics token listings follow the same caller authority as token administration: API-token callers see only records they may manage in their organizations, and sessions retain their existing authority. The diagnostic endpoint does not elevate a narrow monitoring credential into an instance-wide token inventory. Single and fleet PDF narration use the shared ai:execute gate; report permission alone yields deterministic output, and CSV never invokes narration.++The accepted upstream `diagnostics_token_visibility_test.go` controls and API+reference route checks cover caller filtering and the documented authority.+Final-source checks must retain this upstream behavior beside the reviewed+reporting/help repairs; source proof is not installed credential recovery.diff --git a/docs/release-control/v6/internal/subsystems/storage-recovery.md b/docs/release-control/v6/internal/subsystems/storage-recovery.mdindex 0a2cd1ebf4..76b340dd06 100644--- a/docs/release-control/v6/internal/subsystems/storage-recovery.md+++ b/docs/release-control/v6/internal/subsystems/storage-recovery.md@@ -6811,3 +6811,13 @@ reads the structure view (see "Mock-mode metrics-target lookups ride thefixture structure revision" in the monitoring contract). Real mode, its stores,backups, retention, snapshots, migrations and recovery paths are unchanged, andnone is added or moved.+++### Upstream diagnostics visibility composition (11 October 2026)++Diagnostics output filters API-token inventory by the existing caller-management authority without changing token persistence, recovery, rotation or lifecycle. A narrow token receives only manageable records, not another organization's credential inventory; session diagnostic authority is unchanged.++The accepted upstream `diagnostics_token_visibility_test.go` controls and API+reference route checks cover caller filtering and the documented authority.+Final-source checks must retain this upstream behavior beside the reviewed+reporting/help repairs; source proof is not installed credential recovery.diff --git a/frontend-modern/public/docs/API.md b/frontend-modern/public/docs/API.mdindex 2840f1258b..173540ff43 100644--- a/frontend-modern/public/docs/API.md+++ b/frontend-modern/public/docs/API.md@@ -989,7 +989,7 @@ apply. GET and CSV never use AI narration.- `POST /api/admin/reports/generate-multi` (admin, `settings:read`)- Body fields: `resources` (1-50 entries of `{resourceType,resourceId}`), `format`, `metricType` (optional), `start`/`end` (RFC3339, optional; defaults to last 24h), `title` (optional)- If `title` is omitted, the backend applies the canonical default fleet report title.- - Fleet PDF narration follows the same `ai:execute` rule for API tokens; without it, the report uses the deterministic summary. CSV output is never narrated.+ - AI narration of the fleet summary follows the same rule as single reports: API-token callers need `ai:execute`, otherwise the deterministic summary is used. CSV output is never narrated.- `GET /api/admin/reports/inventory/vms/export` (admin, `settings:read`)- Query params: `format` (`csv` only; optional and defaults to `csv`)- Exports the current fleet-wide VM inventory as spreadsheet-friendly CSV using the canonical runtime model.