aboutsummaryrefslogtreecommitdiff
path: root/docs/prototypes/2026-07-07-maint-console-A-two-column.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-07 18:24:12 -0500
committerCraig Jennings <c@cjennings.net>2026-07-07 18:24:12 -0500
commit7955be70ea7751c68d6a9b2ca3683ee697a38726 (patch)
treeb241c157d36238f9769660c0701ca24a2696abf2 /docs/prototypes/2026-07-07-maint-console-A-two-column.html
parent96881fccae125c8803ac5c26b8ddb7ee77be363a (diff)
downloadarchsetup-7955be70ea7751c68d6a9b2ca3683ee697a38726.tar.gz
archsetup-7955be70ea7751c68d6a9b2ca3683ee697a38726.zip
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.
Diffstat (limited to 'docs/prototypes/2026-07-07-maint-console-A-two-column.html')
-rw-r--r--docs/prototypes/2026-07-07-maint-console-A-two-column.html335
1 files changed, 335 insertions, 0 deletions
diff --git a/docs/prototypes/2026-07-07-maint-console-A-two-column.html b/docs/prototypes/2026-07-07-maint-console-A-two-column.html
new file mode 100644
index 0000000..23d0e60
--- /dev/null
+++ b/docs/prototypes/2026-07-07-maint-console-A-two-column.html
@@ -0,0 +1,335 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Maintenance console — Approach A · two-column board</title>
+<style>
+:root{
+ --ground:#0a0c0d; --panel:#100f0f; --well:#0a0c0d;
+ --gold:#dab53d; --gold-hi:#ffd75f; --silver:#bfc4d0; --cream:#f3e7c5;
+ --dim:#7c838a; --slate:#424f5e; --slate-hi:#54677d; --wash:#2c2f32;
+ --ok:#74932f; --warn:#dab53d; --fail:#cb6b4d;
+ --mono:"BerkeleyMono Nerd Font","Berkeley Mono",monospace;
+}
+*{box-sizing:border-box;margin:0;padding:0}
+html{background:var(--ground)}
+body{font-family:var(--mono);color:var(--silver);line-height:1.4;
+ padding:2.2rem 1.4rem 4rem;
+ background:radial-gradient(1100px 560px at 72% -12%,#141210 0%,transparent 60%),var(--ground);
+ display:flex;flex-direction:column;align-items:center;gap:1.5rem}
+
+/* ---- capsule ---- */
+.capsule{width:1000px;max-width:100%;background:var(--panel);border:1px solid var(--gold);
+ border-radius:16px;padding:18px 20px;box-shadow:0 20px 55px rgba(0,0,0,.6)}
+
+/* ---- header strip ---- */
+.hdr{display:flex;align-items:center;gap:14px;padding-bottom:12px;border-bottom:1px solid var(--wash)}
+.hdr .mark{color:var(--gold);font-weight:700;font-size:1.15rem;letter-spacing:.12em}
+.hdr .mark .host{color:var(--cream)}
+.hdr .verdict{margin-left:auto;display:flex;align-items:center;gap:8px;font-size:.92rem}
+.hdr .verdict .word{color:var(--ok);font-weight:700;letter-spacing:.08em;text-transform:uppercase}
+.subhdr{color:var(--dim);font-size:.72rem;letter-spacing:.24em;text-transform:uppercase;margin-top:8px}
+
+/* ---- lamps ---- */
+.lamp{font-size:.72rem;line-height:1;flex:0 0 auto;position:relative;top:-.5px}
+.lamp.ok{color:var(--ok)}
+.lamp.warn{color:var(--warn)}
+.lamp.fail{color:var(--fail)}
+.lamp.off{color:var(--dim)}
+.lamp.run{color:var(--warn)}
+.lamp.big{font-size:.85rem}
+
+/* ---- board ---- */
+.board{display:grid;grid-template-columns:1fr 1fr;gap:20px;margin-top:16px}
+.col{min-width:0}
+.col-h{display:flex;align-items:baseline;gap:10px;margin-bottom:10px}
+.col-h .tag{color:var(--gold);font-weight:700;font-size:.86rem;letter-spacing:.22em}
+.col-h .sub{color:var(--dim);font-size:.68rem;letter-spacing:.04em}
+
+/* doctor buttons */
+.doctor{display:flex;gap:10px;margin-bottom:14px}
+.btn{font:inherit;cursor:pointer;border-radius:10px;border:1px solid transparent;
+ background:var(--slate);color:var(--cream);padding:.5rem .9rem;font-size:.82rem;letter-spacing:.02em;
+ transition:background .12s,border-color .12s}
+.btn:hover{background:var(--slate-hi)}
+.btn.big{flex:1;text-align:center;padding:.62rem .8rem;font-size:.86rem}
+.btn.big .k{display:block;color:var(--cream);font-weight:700}
+.btn.big .d{display:block;color:var(--silver);font-size:.66rem;letter-spacing:.02em;margin-top:2px;opacity:.85}
+.btn.ghost{background:transparent;border-color:var(--wash);color:var(--silver)}
+.btn.ghost:hover{border-color:var(--slate-hi);background:rgba(66,79,94,.18)}
+.btn.lever{padding:.28rem .66rem;font-size:.74rem;border:1px solid var(--slate);background:rgba(66,79,94,.32);color:var(--cream)}
+.btn.lever:hover{background:var(--slate);border-color:var(--slate-hi)}
+.btn.done{background:var(--slate);color:var(--cream);padding:.5rem 1.4rem}
+
+/* inset group */
+.group{background:var(--well);border:1px solid var(--wash);border-radius:10px;padding:8px 10px 6px;margin-bottom:11px}
+.group-h{color:var(--gold);font-weight:700;font-size:.7rem;letter-spacing:.2em;text-transform:uppercase;
+ display:flex;align-items:center;gap:8px;padding:1px 2px 7px}
+.group-h::after{content:"";height:1px;background:var(--wash);flex:1}
+
+/* metric row */
+.row{display:grid;grid-template-columns:auto 1fr auto auto;align-items:center;gap:9px;
+ padding:4px 4px;border-radius:6px;font-size:.82rem}
+.row:hover{background:rgba(44,47,50,.4)}
+.row .name{color:var(--silver);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.row .cls{color:var(--dim);font-size:.6rem;letter-spacing:.14em;border:1px solid var(--wash);
+ border-radius:4px;padding:0 4px;flex:0 0 auto;text-transform:uppercase}
+.row .val{color:var(--dim);text-align:right;white-space:nowrap;font-size:.78rem}
+.row .val.warn{color:var(--warn)}
+.row .val.fail{color:var(--fail)}
+.row .lev-slot{justify-self:end;min-width:0}
+.wf-link{font:inherit;background:transparent;border:0;cursor:pointer;color:var(--warn);
+ font-size:.72rem;letter-spacing:.02em;white-space:nowrap;padding:.1rem 0}
+.wf-link:hover{color:var(--gold-hi);text-decoration:underline}
+.wf-link.fail{color:var(--fail)}
+.dash{color:var(--wash);font-size:.8rem;padding-right:6px}
+
+/* ---- updates quarantine strip ---- */
+.updates{margin-top:6px;padding-top:15px;border-top:1px solid var(--gold);
+ display:flex;align-items:center;gap:16px;flex-wrap:wrap}
+.updates .u-tag{color:var(--gold);font-weight:700;font-size:.8rem;letter-spacing:.22em}
+.updates .u-body{color:var(--silver);font-size:.82rem;flex:1;min-width:260px}
+.updates .u-body .n{color:var(--cream);font-weight:700}
+.updates .u-body .cve{color:var(--fail);font-weight:700}
+.updates .u-body .pk{color:var(--dim)}
+.updates .btn{white-space:nowrap}
+
+/* ---- running / output-wall capsule ---- */
+.run-cap .hdr .mark .state{color:var(--warn)}
+.wall{margin-top:14px;background:var(--well);border:1px solid var(--wash);border-radius:10px;padding:12px 14px;
+ display:flex;flex-direction:column;gap:9px}
+.wall .act{display:grid;grid-template-columns:auto 1fr auto;align-items:center;gap:10px;font-size:.84rem}
+.wall .act .step{color:var(--silver)}
+.wall .act .dots{color:var(--wash);letter-spacing:.1em;overflow:hidden}
+.wall .act .res{color:var(--dim);font-size:.76rem;white-space:nowrap;text-align:right}
+.wall .act.running .step{color:var(--cream)}
+.wall .act.running .res{color:var(--warn)}
+.wall .act.done .res{color:var(--ok)}
+.wall .act.queued .step{color:var(--dim)}
+.run-foot{display:flex;align-items:center;justify-content:space-between;margin-top:14px}
+.run-foot .prog{color:var(--dim);font-size:.76rem;letter-spacing:.04em}
+.run-foot .prog b{color:var(--cream);font-weight:700}
+
+/* ---- legend ---- */
+.legend{width:1000px;max-width:100%;display:flex;gap:18px;flex-wrap:wrap;
+ font-size:.7rem;color:var(--dim);padding:0 4px}
+.legend .item b{color:var(--silver);font-weight:700}
+.legend .item{white-space:nowrap}
+.legend .swatch{color:var(--gold)}
+
+@media(max-width:1040px){
+ .capsule,.legend{width:100%}
+ .board{grid-template-columns:1fr}
+}
+</style>
+</head>
+<body>
+
+<!-- =================== RESTING BOARD =================== -->
+<section class="capsule">
+ <div class="hdr">
+ <div class="mark">MAINT · <span class="host">ratio</span></div>
+ <div class="verdict">
+ <span class="lamp ok big">&#9679;</span>
+ <span class="word">healthy</span>
+ </div>
+ </div>
+ <div class="subhdr">Approach A — Two-column board</div>
+
+ <div class="board">
+
+ <!-- ============ LEFT / FIX ============ -->
+ <div class="col">
+ <div class="col-h"><span class="tag">FIX</span><span class="sub">actionable — auto &amp; confirm</span></div>
+
+ <div class="doctor">
+ <button class="btn big">
+ <span class="k">Clean up</span><span class="d">runs the Auto set unattended</span>
+ </button>
+ <button class="btn big ghost">
+ <span class="k">Review &amp; fix</span><span class="d">preview the Confirm set</span>
+ </button>
+ </div>
+
+ <!-- Storage -->
+ <div class="group">
+ <div class="group-h">Storage</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">cache size</span><span class="cls">Auto</span><span class="lev-slot"><button class="btn lever">Clean</button></span></div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">btrfs scrub age</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Scrub</button></span></div>
+ <div class="row"><span class="lamp fail">&#9679;</span><span class="name">fstrim.timer</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Enable</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">deep trim (keep-1)</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Deep trim</button></span></div>
+ </div>
+
+ <!-- Snapshots -->
+ <div class="group">
+ <div class="group-h">Snapshots</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">snapper count/retention</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Prune</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">snapshot auto-timer</span><span class="cls">Conf</span><span class="val">active</span></div>
+ </div>
+
+ <!-- Packages -->
+ <div class="group">
+ <div class="group-h">Packages</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">orphaned packages</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Review</button></span></div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">.pacnew files</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Review</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">keyring freshness</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Refresh</button></span></div>
+ </div>
+
+ <!-- Logs -->
+ <div class="group">
+ <div class="group-h">Logs &amp; coredumps</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">coredumps</span><span class="cls">Auto</span><span class="lev-slot"><button class="btn lever">Clear</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">journald disk usage</span><span class="cls">Auto</span><span class="lev-slot"><button class="btn lever">Vacuum</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">app-log cleanup</span><span class="cls">Auto</span><span class="lev-slot"><button class="btn lever">Run</button></span></div>
+ </div>
+
+ <!-- systemd -->
+ <div class="group">
+ <div class="group-h">systemd</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">maintenance timers firing</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Enable</button></span></div>
+ </div>
+
+ <!-- Network confirm -->
+ <div class="group">
+ <div class="group-h">Network</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">firewall active</span><span class="cls">Conf</span><span class="val">active</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">tailscale peers</span><span class="cls">Conf</span><span class="val">4/4</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">fail2ban</span><span class="cls">Conf</span><span class="val">active</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">NTP sync</span><span class="cls">Conf</span><span class="val">synced</span></div>
+ </div>
+
+ <!-- Services confirm -->
+ <div class="group">
+ <div class="group-h">Services</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">docker reclaimable</span><span class="cls">Conf</span><span class="lev-slot"><button class="btn lever">Prune</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">cron</span><span class="cls">Conf</span><span class="val">ok</span></div>
+ </div>
+ </div>
+
+ <!-- ============ RIGHT / WATCH ============ -->
+ <div class="col">
+ <div class="col-h"><span class="tag">WATCH</span><span class="sub">read-only — none, human &amp; forensic</span></div>
+
+ <!-- Hardware -->
+ <div class="group">
+ <div class="group-h">Hardware</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">SMART health</span><span class="cls">None</span><span class="val">PASSED</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">SMART wear</span><span class="cls">None</span><span class="val">0%</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">btrfs device errors</span><span class="cls">None</span><span class="val">0/0</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">CPU/GPU temps</span><span class="cls">None</span><span class="val">61&deg;/54&deg;</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">thermal throttling</span><span class="cls">None</span><span class="val">no</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">kernel/hardware events</span><span class="cls">None</span><span class="val">clean</span></div>
+ </div>
+
+ <!-- System -->
+ <div class="group">
+ <div class="group-h">System &amp; disk</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">is-system-running</span><span class="cls">None</span><span class="val">running</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">disk usage</span><span class="cls">None</span><span class="val">69%</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">btrfs unallocated</span><span class="cls">None</span><span class="val">118 GiB</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">kernel taint flag</span><span class="cls">None</span><span class="val">0</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">pacman file integrity</span><span class="cls">Wflow</span><span class="val">clean</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">reboot required</span><span class="cls">Human</span><span class="val">no</span></div>
+ </div>
+
+ <!-- Forensic / systemd -->
+ <div class="group">
+ <div class="group-h">Forensic (workflow)</div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">failed units</span><span class="cls">Wflow</span><span class="val warn">1</span><span class="lev-slot"><button class="wf-link">&rarr; workflow</button></span></div>
+ <div class="row"><span class="lamp warn">&#9679;</span><span class="name">unclean-shutdown rate</span><span class="cls">Wflow</span><span class="val warn">75%</span><span class="lev-slot"><button class="wf-link">&rarr; workflow</button></span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">journal error count</span><span class="cls">Wflow</span><span class="val">12 real</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">memory free / OOM</span><span class="cls">Wflow</span><span class="val">104 GB free</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">rsyncshot backup</span><span class="cls">Wflow</span><span class="val">3h ago</span></div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">DNS / NetworkManager</span><span class="cls">Wflow</span><span class="val">ok</span></div>
+ </div>
+
+ <!-- Power / memory -->
+ <div class="group">
+ <div class="group-h">Memory &amp; power</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">swap / zram</span><span class="cls">None</span><span class="val">16 GiB</span></div>
+ <div class="row"><span class="lamp off">&#9675;</span><span class="name">battery health</span><span class="cls">None</span><span class="val">n/a</span></div>
+ </div>
+
+ <!-- Network posture -->
+ <div class="group">
+ <div class="group-h">Network posture</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">unexpected listeners</span><span class="cls">None</span><span class="val">3</span></div>
+ </div>
+
+ <!-- Services / virt -->
+ <div class="group">
+ <div class="group-h">Services &amp; virt</div>
+ <div class="row"><span class="lamp ok">&#9679;</span><span class="name">docker stopped containers</span><span class="cls">None</span><span class="val">2</span></div>
+ <div class="row"><span class="lamp off">&#9675;</span><span class="name">libvirt VMs</span><span class="cls">None</span><span class="val">off</span></div>
+ </div>
+ </div>
+
+ </div><!-- /board -->
+
+ <!-- quarantined updates strip -->
+ <div class="updates">
+ <span class="u-tag">UPDATES</span>
+ <span class="u-body"><span class="n">47 pending</span> &middot; <span class="pk">mesa, linux-lts, systemd</span> &middot; <span class="cve">3 CVEs</span></span>
+ <button class="btn">Run workflow</button>
+ </div>
+</section>
+
+<!-- =================== RUNNING / OUTPUT WALL =================== -->
+<section class="capsule run-cap">
+ <div class="hdr">
+ <div class="mark">MAINT · <span class="host">ratio</span> · <span class="state">CLEANING</span></div>
+ <div class="verdict">
+ <span class="lamp run big">&#9680;</span>
+ <span class="word" style="color:var(--warn)">working</span>
+ </div>
+ </div>
+ <div class="subhdr">Doctor has the surface — Auto set streaming</div>
+
+ <div class="wall">
+ <div class="act running">
+ <span class="lamp run">&#9680;</span>
+ <span class="step">cache trim</span>
+ <span class="res">running</span>
+ </div>
+ <div class="act done">
+ <span class="lamp ok">&#9679;</span>
+ <span class="step">journal vacuum</span>
+ <span class="res">done &middot; reclaimed 0.9 GB</span>
+ </div>
+ <div class="act done">
+ <span class="lamp ok">&#9679;</span>
+ <span class="step">coredump clear</span>
+ <span class="res">done &middot; 12 cleared</span>
+ </div>
+ <div class="act queued">
+ <span class="lamp off">&#9675;</span>
+ <span class="step">app-log cleanup</span>
+ <span class="res">queued</span>
+ </div>
+ </div>
+
+ <div class="run-foot">
+ <span class="prog"><b>2</b> of 4 done &middot; 1 running &middot; 1 queued</span>
+ <button class="btn done">Done</button>
+ </div>
+</section>
+
+<!-- =================== AUTOMATION-CLASS LEGEND =================== -->
+<div class="legend">
+ <span class="item"><span class="swatch">&#9679;</span> <b>Auto</b> — doctor "Clean up", fires unattended</span>
+ <span class="item"><span class="swatch">&#9679;</span> <b>Confirm</b> — doctor "Review &amp; fix", preview then one click</span>
+ <span class="item"><span class="swatch">&#9679;</span> <b>Human</b> — panel nudges, you act</span>
+ <span class="item"><span class="swatch">&#9679;</span> <b>Workflow</b> — escalate to the agent health-check</span>
+ <span class="item"><span class="swatch">&#9679;</span> <b>None</b> — diagnostic only, no fix</span>
+</div>
+<div class="legend" style="margin-top:-8px">
+ <span class="item"><span class="lamp ok">&#9679;</span> ok/pass</span>
+ <span class="item"><span class="lamp warn">&#9679;</span> warn</span>
+ <span class="item"><span class="lamp fail">&#9679;</span> fail</span>
+ <span class="item"><span class="lamp run">&#9680;</span> running</span>
+ <span class="item"><span class="lamp off">&#9675;</span> off / n/a</span>
+</div>
+
+</body>
+</html>