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 each Manage control does in plain words

rcourtman669fcc100323
diff --git a/docs/release-control/v6/internal/subsystems/unified-resources.md b/docs/release-control/v6/internal/subsystems/unified-resources.md
index 22ac317998..39941558c0 100644
--- a/docs/release-control/v6/internal/subsystems/unified-resources.md
+++ b/docs/release-control/v6/internal/subsystems/unified-resources.md
@@ -3521,6 +3521,18 @@ below its explanatory copy so the button cannot squeeze policy text into a
narrow side column; desktop retains the compact side-by-side layout.
The UI must never infer eligibility from capability names, severity, or the
human approval floor.
+Each control's help says what it does to Alerts, Patrol and automatic fixes in
+plain words, never in implementation terms (no "persisted resource policy",
+"action broker", "dispatch" or "canonical inventory hierarchy"). The
+maintenance-window help says it silences alerts and dismisses new Patrol
+findings, because an active window suppresses alert activation and
+auto-dismisses new findings while keeping them in history. The descendant-scope
+help claims only alerts for descendants, because Patrol reads the exact
+resource's own state. The `Never auto-remediate` label stays as named, because
+help pages and the Assistant's refusal message refer to it; its help and lock
+confirmation say it blocks every automated fix, including approved ones, and
+that blocked runs are logged as failed actions (an Assistant planning refusal
+creates no action record).
The `/api/resources/{id}/operator-state` API surface (GET / PUT /
DELETE) in `internal/api/resources_operator_state.go` is the
diff --git a/frontend-modern/browser-verification/2d240a8d65949bdf.json b/frontend-modern/browser-verification/2d240a8d65949bdf.json
new file mode 100644
index 0000000000..9036fe4923
--- /dev/null
+++ b/frontend-modern/browser-verification/2d240a8d65949bdf.json
@@ -0,0 +1,35 @@
+{
+ "version": 1,
+ "base_sha": "68662e8eec6e64226efb76d1b6e412af0fea1177",
+ "verified_at": "2026-10-13T09:55:04Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx": "56d07878fd33d3bc7e0f09f9dea2ba1b43f1a5c8c7b1958433e2529f8f1167f5"
+ },
+ "routes": [
+ "/proxmox"
+ ],
+ "viewports": [
+ {
+ "width": 1280,
+ "height": 800
+ },
+ {
+ "width": 390,
+ "height": 844
+ }
+ ],
+ "states": [
+ "sidecar Vite dev server serving these final bytes against the shared dev backend with the real homelab estate; frigate (LXC) guest drawer, Manage tab",
+ "Operator overrides reads: subtitle 'How Pulse alerts on, prioritizes and acts on this resource.'; maintenance 'Silence alerts and dismiss new Patrol findings during planned work, such as upgrades or reboots.'; scheduler Applies-to help 'With descendants, alerts on everything under this resource are silenced too, including resources added later.'; Monitoring and Lifecycle consequences unchanged; Never auto-remediate 'Block every automated fix on this resource, including approved ones. Blocked runs are logged as failed actions.'; 119 words with the scheduler closed (about 172 before)",
+ "390px phone: no element extends past the viewport, page scrollWidth equals the viewport"
+ ],
+ "interactions": [
+ "expanded frigate and opened the Manage tab",
+ "clicked Schedule window to read the Applies-to help, then Cancel; no Save overrides button appeared",
+ "turned on the Never auto-remediate toggle in an earlier pass on the same confirmation copy: it read 'Pulse will block every automated fix on this resource, including ones already approved in Patrol or the Assistant, until this is turned off.'; Cancel left the toggle off and nothing to save"
+ ]
+}
diff --git a/frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx b/frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx
index aa3e1a8887..2f24c6612a 100644
--- a/frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx
+++ b/frontend-modern/src/components/Infrastructure/ResourceOperatorStateSection.tsx
@@ -571,8 +571,7 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
<div>
<h3 class="text-sm font-semibold text-base-content">Operator overrides</h3>
<p class="text-xs text-muted">
- Control Alerts, Patrol, lifecycle, priority, and automated remediation from one
- persisted resource policy.
+ How Pulse alerts on, prioritizes and acts on this resource.
</p>
</div>
<Show when={persisted()?.setBy || persisted()?.setAt}>
@@ -685,8 +684,8 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
<div class="min-w-0 flex-1">
<span class="text-sm font-medium text-base-content">Maintenance window</span>
<p class="text-[11px] text-muted mt-0.5 leading-tight">
- Suspend findings on this resource for a defined window. Useful for scheduled upgrades,
- planned downtime, or reboots where Pulse should stay quiet until the window closes.
+ Silence alerts and dismiss new Patrol findings during planned work, such as upgrades
+ or reboots.
</p>
</div>
<Show
@@ -845,7 +844,7 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
onChange={(event) =>
setScheduleScope(event.currentTarget.value as 'resource' | 'resource_and_descendants')
}
- help="Descendant scope follows Pulse's canonical inventory hierarchy and covers resources added beneath this one later."
+ help="With descendants, alerts on everything under this resource are silenced too, including resources added later."
helpClass="text-[11px] leading-tight"
>
<option value="resource">This resource only</option>
@@ -931,7 +930,7 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
{capabilityDisplayName(capability.name)}
</span>
<span class="block text-muted">
- {capability.description || 'Backend-governed resource action'}
+ {capability.description || 'Resource action'}
</span>
<span class="mt-0.5 block text-muted">
{capability.autoAuthorization === 'low_risk'
@@ -1051,9 +1050,8 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
Never auto-remediate
</span>
<p class="text-[11px] text-muted mt-0.5 leading-tight">
- Refuse all automated remediation against this resource, even with a valid approval. The
- action broker logs every refused dispatch as a Failed audit record. Use for resources
- where Pulse must not act under any circumstance.
+ Block every automated fix on this resource, including approved ones. Blocked runs are
+ logged as failed actions.
</p>
</div>
<Toggle
@@ -1068,8 +1066,8 @@ export const ResourceOperatorStateSection: Component<ResourceOperatorStateSectio
<div class="rounded-sm border border-red-300 bg-red-50 px-3 py-2.5 text-xs text-red-900 dark:border-red-800 dark:bg-red-950/25 dark:text-red-100">
<p class="font-semibold">Lock this resource against all automated remediation?</p>
<p class="mt-1 leading-relaxed">
- Pulse will refuse every dispatch targeting this resource, including approved actions
- from Patrol or the Assistant. Operators must clear the lock to allow remediation again.
+ Pulse will block every automated fix on this resource, including ones already approved
+ in Patrol or the Assistant, until this is turned off.
</p>
<div class="mt-2 flex items-center gap-2">
<button
diff --git a/frontend-modern/src/components/Infrastructure/__tests__/ResourceOperatorStateSection.test.ts b/frontend-modern/src/components/Infrastructure/__tests__/ResourceOperatorStateSection.test.ts
index 32b96adf4e..8fd9088c2f 100644
--- a/frontend-modern/src/components/Infrastructure/__tests__/ResourceOperatorStateSection.test.ts
+++ b/frontend-modern/src/components/Infrastructure/__tests__/ResourceOperatorStateSection.test.ts
@@ -44,6 +44,33 @@ describe('ResourceOperatorStateSection', () => {
expect(sectionSource).toContain('setNote');
});
+ it('explains each control by its effect, not by implementation terms', () => {
+ // Users read the help to learn what a control will do; implementation
+ // vocabulary hid that answer. Code comments may keep the internal terms.
+ const visibleSource = sectionSource
+ .replace(/\/\*[\s\S]*?\*\//g, '')
+ .replace(/^\s*\/\/.*$/gm, '');
+ for (const jargon of [
+ 'persisted resource policy',
+ 'action broker',
+ 'dispatch',
+ 'canonical inventory hierarchy',
+ 'Backend-governed',
+ ]) {
+ expect(visibleSource).not.toContain(jargon);
+ }
+ // An active maintenance window silences alerts and dismisses new findings
+ // (kept in history), so the help names both.
+ expect(visibleSource).toContain(
+ 'Silence alerts and dismiss new Patrol findings during planned work',
+ );
+ // The lock's consequence stays beside it, including approved fixes.
+ expect(visibleSource).toContain('Block every automated fix on this resource, including');
+ expect(visibleSource).toContain('Expected offline hides availability noise only.');
+ // Descendant scope reaches alerts only; Patrol reads the exact resource.
+ expect(visibleSource).toContain('With descendants, alerts on everything under this resource');
+ });
+
it('presents resource action policy as an optional limit on global Patrol autonomy', () => {
expect(sectionSource).toContain('Automatic action limits');
expect(sectionSource).toContain('follows your Patrol mode by default');