From 73f9e840812d1922a11a2fa85cb7dccec1312dcd Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Tue, 7 Jul 2026 18:24:12 -0500 Subject: docs: add maintenance console design + interactive prototypes The design doc replaces the install-health framing in system-monitor-design-ideas.org with a maintenance console: dense metric subpanels behind a persistent selector, a doctor that streams into a results wall, determinate remedies only (guard-armed updates, curation lifecycles for noise, listeners, containers, and orphans), rotary band selectors on the tall subpanels, and a CLI-first build with a four-layer test strategy. Every decision is dated in the doc. Prototypes A-E5 keep the exploration path: five divergent layouts converging into E5, a fully interactive simulation whose GOOD/BAD snapshots become the build's test fixtures. todo.org gains the spec-create task, the panel keybinding-family task, and scope notes on the net/bt doctor retrofit. --- ...6-07-07-maint-console-E2-grouped-dashboard.html | 443 +++++++++++++++++++++ 1 file changed, 443 insertions(+) create mode 100644 docs/prototypes/2026-07-07-maint-console-E2-grouped-dashboard.html (limited to 'docs/prototypes/2026-07-07-maint-console-E2-grouped-dashboard.html') diff --git a/docs/prototypes/2026-07-07-maint-console-E2-grouped-dashboard.html b/docs/prototypes/2026-07-07-maint-console-E2-grouped-dashboard.html new file mode 100644 index 0000000..b818006 --- /dev/null +++ b/docs/prototypes/2026-07-07-maint-console-E2-grouped-dashboard.html @@ -0,0 +1,443 @@ + +MAINT · ratio — Approach E2 · Grouped Instrument Dashboard + + +
+ + +
+
+
MAINT · ratio
+
Approach E2 — Grouped instrument dashboard (categories collapse when clean)
+
+
● healthy
+
+ + +
+ Doctor + + + + + Auto unattended · Confirm preview+click · Human you act · Workflow escalate · None diagnostic + +
+ + +
+
Updates
+
47pending
+
3CVE · arch-audit
+
5AUR stale
+
+
+ ● Security advisories present. Updates run through the workflow — never an unattended clean. +
+ +
+ + + + +
+
+ ▾● + Storage & Filesystem + 3 need attention · 6 ok +
+
+
+
+
Disk usage
+
69%
+
root · btrfs
+
+
+
+
+
08090100
+
+
+
+ +
Cache ●
+
8.8 GB
+
Auto · thr ~10 GB
+
+
+
010 GB
+
+
+
+ +
btrfs scrub
+
+ + + + 34 + days + +
+
● past 30d
+
+
+ +
fstrim.timer ●
+
OFF
+
Confirm · SSD discard off
+
+
+
+
●SMARTPASSED
+
●SMART wear0%
+
●device errors0 / 0
+
●btrfs unalloc118 GiB
+
●pacman integrityclean
+
●deep-trimkeep 3
+
+
+
+ + +
+
+ ▾● + Packages & Security + 2 need attention · 2 ok · updates above +
+
+
+
+ +
Orphans
+
●13
+
Confirm · unowned pkgs
+
+
+ +
.pacnew files
+
●2
+
Confirm · config merges
+
+
+
+
●keyring age12d
+
●reboot requiredno
+
+
+
+ + +
+
+ ▾● + systemd & Boot + 2 need attention · 2 ok +
+
+
+
+ +
Failed units
+
●1
+
Workflow · systemd
+
+
+ +
Maintenance timers
+
●4/5
+
Confirm · one not firing
+
+
+
+
●is-system-runningrunning
+
●kernel taint0
+
+
+
+ + +
+
+ ▾● + Logs & Coredumps + 1 needs attention · 4 ok +
+
+
+
+ +
Coredumps 7d
+
●18
+
Auto · clearable
+
+
+
+
●journald size1.2 GB
+
●app-log cleanupok
+
●journal errors12 real
+
●kernel/hw eventsclean
+
+
+
+ + +
+
+ ▾● + Memory · Thermal · Power + 1 needs attention · 4 ok +
+
+
+
+
Temperatures ●
+
+
+ + + + + + + + +
61°C
CPU
+
+
+ + + + + + + + +
54°C
NVMe
+
+
+
+
+
Memory free ●
+
104 GB
+
of 125 GB · Workflow
+
+
0free 104 / 125
+
+
+
Unclean boot ●
+
75%
+
Workflow · investigate
+
+
+
0100
+
+
+
+
●swap / zram16 GiB
+
●thermal throttleno
+
○batteryn/a · desktop
+
+
+
+ + +
+
+ ▾● + Services & Backups + 1 needs attention · 3 ok +
+
+
+
+ +
Docker reclaim
+
●3 GB
+
Confirm · reclaimable
+
+
+
+
●rsyncshot backup3h ago
+
●docker stopped2
+
●cronok
+
○libvirt VMsoff
+
+
+
+ + + +
+
+ ▸● + Snapshots + all clear · 2 ✓ +
+
+ +
+
+ ▸● + Network & Posture + all clear · 6 ✓ +
+
+ +
+ Collapsed panels are all-green — one header line each (chevron ▸ to expand). On a fully-healthy day every + panel collapses to this and the console is ~4 header rows plus the updates strip. The board's height tracks + how much needs you, not how many metrics exist. Verdict lamp (top-right) reads the worst diagnostic + state only — the fstrim fail and the 3 CVEs are actionable/updates, so the box still reads "healthy." +
+ + +
+
+ MAINT · ratio · CLEANING ◐ + 4 Auto actions +
+
+
◐cache trimrunning…
+
●journal vacuumdone · reclaimed 0.9 GB
+
●coredump cleardone · 12 cleared
+
○app-log cleanupqueued
+
+
+
+ +
-- cgit v1.2.3