Document the Panama Control Center

config/dot/hypr/DESKTOP-PARITY.md

@@ -23,7 +23,7 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0.
 | Date menu | Two-column Daybook with Agenda, Ongoing activity, Notifications, month calendar, weather, and media | Live |
 | Ongoing activity | Focus, Caffeine, recording, screen sharing, camera, and microphone state with direct controls | Live |
 | Calendar agenda | Existing GNOME, Google, iCloud, and Nextcloud sources through Evolution Data Server | Live |
-| Quick settings | Wi-Fi, Bluetooth, audio input/output, caffeine, night light, focus | Live |
+| Control Center | Wi-Fi, Bluetooth, audio input/output, Caffeine, Night Light, Focus, Home Assistant favourites, and KDE Connect phone continuity | Live |
 | Focus sessions | Persistent workspace-bound timer, DND/caffeine coordination, Signal Glass controls | Live |
 | Brightness | Appears only when a backlight device exists | Live, not applicable on this monitor |
 | AppIndicator / tray | Native StatusNotifierItem host and themed menus | Live |
@@ -35,6 +35,7 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0.
 | Portals and screen sharing | xdg-desktop-portal-hyprland plus GTK portal | Live |
 | Removable media | udiskie plus udisks notifications | Live |
 | Autostart apps | Nextcloud, Bitwarden, and RustDesk system service/tray | Live |
+| Printer administration | CUPS with the `system-config-printer` graphical interface | Live |
 | System settings | Panama Settings for display policy, appearance, desktop, sound, focus, shortcuts, and services; labelled GNOME hardware/account handoffs | Live |
 
 ## GNOME extension migration
@@ -52,8 +53,8 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0.
 | Blur My Shell / Openbar / User Theme | Replaced by the Prism shell and compositor blur |
 | Bluetooth Quick Connect | Replaced by the full Bluetooth picker |
 | Wi-Fi QR | Deliberately omitted; it is not useful enough to justify another credential-reading surface |
-| GSConnect | No paired phone profile was present; KDE Connect is installed and awaiting pairing |
+| GSConnect | Replaced by capability-aware KDE Connect phone continuity in Control Center; the paired iPhone exposes file, clipboard, and Ring actions when reachable |
-| Home Assistant | Useful integration, but needs a purpose-built panel and secure credential migration |
+| Home Assistant | Replaced by secure favourites in Control Center; explicit private environment values take precedence over the existing GNOME extension and Secret Service setup |
 | Custom Hot Corners Extended | No action was configured, so there is no behavior to port |
 | App Hider | Hidden app list is now applied in Vicinae |
 | Allow Locked Remote Desktop | Mutter-specific patch; RustDesk is independent, but lock-screen access needs a real remote test |
@@ -63,20 +64,11 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0.
 These are not blockers for normal use, but they are the remaining places where
 a polished general-purpose desktop can go beyond the current shell.
 
-1. Home Assistant favourites in a dedicated, secure quick panel. The token must
+1. A real external RustDesk test while hyprlock is active. Local process state
-   stay in the keyring or a private state file, never in this repository.
-2. Phone integration through KDE Connect, including battery/share status in the
-   tray. The package is installed and ready for a new pairing.
-3. A printer administration GUI. CUPS is already active; the
-   `system-config-printer` package supplies the missing UI.
-4. A real external RustDesk test while hyprlock is active. Local process state
    cannot prove what a remote client sees or whether input is accepted.
 
-Supporting packages tracked in `setup/packages/hyprland-packages`:
+KDE Connect, the printer UI, Tesseract, and ZBar are installed and remain
-
+tracked in `setup/packages/hyprland-packages`.
-```sh
-sudo dnf install kde-connect system-config-printer tesseract zbar
-```
 
 ## Global menu decision
 

config/dot/hypr/README.md

@@ -213,6 +213,38 @@ before a timed event until 5 minutes after it starts. It displays relative time
 (`12m` or `Now`); the event title is available on hover but otherwise stays out
 of the bar. All-day events never trigger the capsule.
 
+## Control Center
+
+Click the right-side status cluster or press `SUPER + S` for Panama's Control
+Center. It is attached directly beneath the bar and keeps Wi-Fi, Bluetooth,
+Caffeine, Night Light, Focus, audio input/output, user, settings, and power in
+one place. Home and Phone continue the same surface rather than opening extra
+dashboard windows.
+
+Home shows the first four configured Home Assistant favourites as direct
+controls and expands to the complete configured list. Panama reads the current
+GNOME Home Assistant extension configuration and its Secret Service token as a
+compatibility fallback, so the existing setup works without copying a secret.
+The preferred private configuration lives in the gitignored
+`config/bash/env` file:
+
+```sh
+export PANAMA_HOME_ASSISTANT_URL=https://home.example.test
+export PANAMA_HOME_ASSISTANT_TOKEN=replace-with-a-long-lived-token
+export PANAMA_HOME_ASSISTANT_ENTITIES=light.kitchen,light.living_room
+```
+
+The helper reads that file directly. No shell restart is required after editing
+it; close and reopen Control Center to refresh. If Home Assistant is offline,
+the last known values stay visible with a stale-state label and Retry action.
+
+Phone uses KDE Connect for the capabilities the paired iPhone actually
+advertises: Send File, Send Clipboard, and Ring. The device remains visible
+while iOS suspends KDE Connect, but actions stay disabled until it reconnects.
+No battery percentage is invented when iOS reports none, and BlueBubbles
+remains the messaging experience. Active file sends appear in Daybook's
+Ongoing page; successful sends become a quiet recent exchange.
+
 ## Screen Intelligence
 
 `SUPER + SHIFT + S` opens the capture picker directly in Selection + Read