From 07ffe1d961e55fc4758b32269a27855a1075ea14 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Tue, 30 Jun 2026 16:51:21 -0400 Subject: docs: bring network module spec current + add diagnostic verbose-capture The spec had drifted behind the code and the redesign. Marked Phases 1-3 shipped, recorded the native captive-login engine and the live-testing portal UX fixes, and folded in the V2 redesign: no terminals, the passwordless sudo-helper, verify-every-action, the Connections/Diagnostics/Performance nav, and the full failure-mode catalog moving to the task. Added the automatic diagnostic verbose-capture feature. On a failing diagnose it elevates the underlying stack (NetworkManager, resolved, wpa_supplicant) to debug, captures the journal and dmesg window, restores with a guaranteed crash-guarded path, and writes a redacted bundle. A manual Debug on/off toggle covers intermittent failures. The redesign task gains a child for it. --- todo.org | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'todo.org') diff --git a/todo.org b/todo.org index 3882a98..e54bc23 100644 --- a/todo.org +++ b/todo.org @@ -191,6 +191,17 @@ run DoT at all. *** TODO Merged Diagnostics panel + nav restructure (Connections | Diagnostics | Performance) *** TODO Make diagnose IPv6-aware and multi-homing-aware *** TODO Close every detect/correct gap in the catalog, with post-action verification +*** TODO Automatic diagnostic verbose-capture (failing diagnose + Advanced toggle) +On =overall: fail=, elevate the underlying stack (NM =WIFI,DHCP,DNS,CORE= / systemd-resolved / +wpa_supplicant) to debug at runtime, run the escalation, capture the journal + dmesg window + +=curl -v=, then restore every level. Also a manual "Debug on/off" toggle in Advanced for +reproducing intermittent failures. HARD: restore is guaranteed (try/finally) AND crash-guarded +(next run detects a left-elevated stack and restores it, like the DoT-restore watcher); the +captured journal is REDACTED before the bundle is written/shown (raw wpa_supplicant/NM debug +carries the PSK/EAP secret in cleartext) with a secret-leak test; log-level toggles run via the +V2 sudo-helper. Bonus: wpa_supplicant debug catches wrong-password/EAP failures the current NM +state-120 snapshot misses, so it also closes the auth live-detection gap. Spec: Observability → +"Automatic diagnostic verbose-capture". Origin: Craig 2026-06-30. ** TODO [#B] Waybar network module — custom/net :feature:waybar:network: :PROPERTIES: -- cgit v1.2.3