Skip to content

v0.75.0 Spanner: device Tools panel (existing flows only) - #186

Merged
agit8or1 merged 3 commits into
mainfrom
device-tools-0.75
Nov 20, 2026
Merged

agit8or1 merged 3 commits into
mainfrom
device-tools-0.75

Conversation

@agit8or1

Copy link
Copy Markdown
Owner

v0.75.0 Spanner: the device page's Tools panel

The P0 Device Tools / Quick Actions item from the RMM expansion directive (docs/rmm-expansion-audit.md, PR #182), built from existing flows only: no new agent build, no new action, no signer change, no new API route, no invariant relaxed.

  • Tools beside Connect opens one dialog listing 30 tools in eight groups (Diagnostics, PowerShell / Scripts, Services & Processes, Software, Windows Updates, Networking, Security, Maintenance).
  • Picking a tool opens its existing flow and runs nothing. A diagnostic opens its row on Diagnostics, marked and focused. An action opens Actions with that action picked. Row actions open their tab. The Security log opens Event logs with Security and Information chosen. A script run opens Automation → Scripts. Deep links work: ?tab=diagnostics&check=…, ?tab=actions&action=…, ?tab=events&log=Security.
  • Each tool shows one of these states, with a reason: Available, Needs approval, Needs a newer agent, Unsupported here (Linux, macOS, RustDesk only), Paused (containment), Not reporting, Not permitted (shown with no button), Not set up (no signer), Unavailable (archived, pooled or unbound), Coming later. Two rows are Coming later: Flush DNS / renew DHCP, and antivirus/firewall/BitLocker/Secure Boot. Neither has a backing flow, and unknown is never shown as healthy.
  • The state logic lives in one pure module, apps/web/lib/device-tools.ts. The server is still the authority: every tool goes through its existing route with all of that route's checks.
  • One API change: each GET /containment/banner row now carries businessId, so the panel can tell which pause covers this computer. No route was added, so API-REFERENCE is unchanged.

Tests

  • apps/web/scripts/unit-device-tools.mjs (new, in CI): 1,598 checks. Covers every tool in every state, the decision order, mayRequestActions against AccessPolicyService, and that every action, diagnostics key, tab and page the panel names exists.
  • e2e-ui.mjs toolsPanel:
    • On signed, standard, Linux, macOS and offline fixtures, at both widths and in both themes, every tool is in its expected state.
    • At 375 px nothing scrolls sideways, and Escape returns focus to Tools.
    • On desktop/light and phone/dark all 16 opening tools are clicked; each lands in its flow and nothing runs. The keyboard and a deep link are also covered.
    • A Business User sees Not permitted, with no button.
    • The existing "no gated MSA request" check covers all of it.
  • check-security-invariants.mjs §84 (new) checks that:
    • the module is pure;
    • the panel only reads the action catalog, the diagnostics catalog and the containment banner, and calls no MSA route;
    • every action and check it names is in the catalog;
    • the only link is the existing report;
    • no new route was added.

Deploy

API and web only. No migration, agent, signer or dependency change.

🤖 Generated with Claude Code

@agit8or1
agit8or1 force-pushed the device-tools-0.75 branch 2 times, most recently from bea327c to f923fba Compare November 20, 2026 21:47
agit8or1 and others added 3 commits November 20, 2026 22:33
Tools beside Connect lists 30 tools in eight groups (Diagnostics,
PowerShell / Scripts, Services & Processes, Software, Windows Updates,
Networking, Security, Maintenance). Each tool opens the flow that already
does it and runs nothing itself. Each shows its state and the reason
(available, needs approval, needs a newer agent, unsupported here,
paused, not reporting, not permitted, not set up, unavailable, coming
later), decided by one pure module, apps/web/lib/device-tools.ts.

No new agent, action, signer change or route. GET /containment/banner
rows now carry businessId. New: unit-device-tools.mjs (in CI), toolsPanel
in e2e-ui.mjs and check-security-invariants §84.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The phone/dark standard-computer check sampled document.activeElement once,
right after the panel detached; Radix returns the focus when the close
animation ends, so on a slower CI runner the sample was null. Wait for it,
bounded at 3 s, then check as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…er 0.74.0)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@agit8or1
agit8or1 merged commit e370a18 into main Nov 20, 2026
21 checks passed
@agit8or1
agit8or1 deleted the device-tools-0.75 branch November 20, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant