Document Panama health and recovery

This commit is contained in:
Gabriel Brown
2026-08-18 11:36:06 -04:00
parent 4ef2f01baa
commit f8e7512e01
3 changed files with 74 additions and 2 deletions
@@ -498,6 +498,19 @@ git commit -m "Add bounded Panama recovery actions"
### Task 7: Full verification, live read-only audit, and documentation
**Integration note:** `origin/main` added Mouse, Privacy, Region, and Online
Accounts destinations while this feature was in review. Merge commit `4ef2f01`
preserves those routes and the newer Settings navigation architecture, keeps
the stable `services` route rendered by `HealthPage`, and leaves
`ServicesPage.qml` retired. Its useful Fedora handoffs for Users, Sharing,
Colour profiles, and Digital wellbeing now live in the boundary-last System
Health card alongside the existing network handoff, with focused static and
isolated runtime coverage.
**Live-audit handoff:** Per the integration brief, this task does not reload the
daily-driver Quickshell, invoke a live repair, or run the read-only live
doctor/IPC comparison. Those checks remain for the controller after code review.
**Files:**
- Modify: `config/dot/hypr/DESKTOP-PARITY.md`
- Modify: `config/dot/quickshell/modules/settings/README.md`
@@ -507,7 +520,7 @@ git commit -m "Add bounded Panama recovery actions"
- Consumes: the complete feature and existing regression suite.
- Produces: current user documentation, a redacted live health snapshot, and final verification evidence.
- [ ] **Step 1: Document boundaries and entry points**
- [x] **Step 1: Document boundaries and entry points**
Document `Panama: Check System Health`, Settings → System Health, the degraded-only bar indicator, `panama-doctor --summary`, the no-`sudo`/no-package-install boundary, and the fact that GNOME/Fedora tools remain responsible for generic system configuration.
@@ -525,7 +538,16 @@ for test in tests/quickshell/*contract.sh; do "$test"; done
for test in tests/hypr/*contract.sh; do "$test"; done
```
Expected: every command exits 0; Quickshell tests report 58 contracts after the three new contracts land.
Expected: every command exits 0. After the Settings parity merge, the current
inventory is 65 Quickshell contracts and 2 Hyprland contracts (the original
pre-merge estimate was 58).
Integration result: syntax and all focused Health/Settings contracts pass. Two
complete serial Quickshell runs each passed 63/65, but failed on different
order-sensitive contracts. Run one failed Displays and Settings Hyprland Write;
run two failed Focus Session and Health Service. Each failed contract passed
immediately when rerun alone. Hyprland contracts passed 2/2. No out-of-scope
test or service code was changed to hide this suite-order interference.
- [ ] **Step 3: Run a redacted live read-only comparison**