From 0e6c678835fe754ac4ea0935c9e5beb153e42809 Mon Sep 17 00:00:00 2001
From: Bernardo Magri <bernardo@bernardomagri.eu>
Date: Sat, 4 Jul 2026 18:07:32 +0100
Subject: [PATCH] =?UTF-8?q?docs(agent):=20Latitude=20QA=202026-07-04=20?=
 =?UTF-8?q?=E2=80=94=20media=20keys=20PASS,=20swaync=20contrast=20bug=20fi?=
 =?UTF-8?q?led?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- HARDWARE-QUEUE: media keys + touchpad gestures (dccceb4) checked off
  — verified working on the Latitude 5410 by Bernardo.
- BACKLOG item 25 (NOW): swaync text unreadable on summer-day. Traced:
  swaync.nix pairs @subtext on @base, but summer-day (and flexoki-light)
  use subtext as text-ON-surface (== base), and summer-day also has
  surface == text — self-colored body text and buttons.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 agent/BACKLOG.md        | 20 +++++++++++++++++++-
 agent/HARDWARE-QUEUE.md |  5 +++--
 2 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/agent/BACKLOG.md b/agent/BACKLOG.md
index 2a0017f..01219e0 100644
--- a/agent/BACKLOG.md
+++ b/agent/BACKLOG.md
@@ -22,9 +22,27 @@ next, in what order*.
 
 ## NOW
 
-*Items 21–24: real-hardware QA findings from the Latitude 5410
+*Items 21–25: real-hardware QA findings from the Latitude 5410
 (Bernardo, 2026-07-04) — bugs found on metal outrank the queue.*
 
+### 25. swaync text unreadable on summer-day (light-theme contrast)
+Reported: on summer-day, notification/control-centre text is invisible
+(contrast). Root cause (traced 2026-07-04): swaync.nix renders `.body`
+as `@subtext` on `alpha(@base, 0.95)` — but in summer-day (and
+flexoki-light) `subtext` *equals/≈ base* because those palettes use
+`surface` as a dark contrast surface and `subtext` as text-*on*-surface,
+not "dimmer text" (catppuccin-latte-style). summer-day also has
+`surface == text` (#5c6a72), so `.widget-title > button`
+(@surface bg, @text fg) is self-colored too. Fix direction: swaync.nix
+should pair roles that contrast by construction — `muted` (dim-text
+role in every palette) for body text on @base, and button fg that
+contrasts @surface (`subtext` is arguably the *right* role there) —
+or normalize the palette semantics across the light themes; audit the
+other `@subtext`/`@surface` consumers (waybar css, rofi) for the same
+mispairing before choosing. **Verify:** V1 + a contrast assert over all
+themes (text≠bg for each swaync pairing); V2 themed-VM screenshot with
+a `notify-send`; V3 re-check on the Latitude.
+
 ### 22. Network menu shows nameless/weird entries
 Reported: `networkmanager_dmenu` lists entries with no names (likely
 hidden-SSID APs rendered as blank rows, possibly other adapters/
diff --git a/agent/HARDWARE-QUEUE.md b/agent/HARDWARE-QUEUE.md
index 8cd0071..b488fb2 100644
--- a/agent/HARDWARE-QUEUE.md
+++ b/agent/HARDWARE-QUEUE.md
@@ -78,8 +78,9 @@ QA machine), the **T14s** (webcam case).
       summer-day/night whole-swaps): the bar restarts cleanly each time;
       if anything kills it, it's back within ~a second. `pgrep -f
       nomarchy-waybar` shows the supervisor.
-- [ ] **Media keys + gestures** (from dccceb4) — volume/brightness keys
-      drive the OSD; touchpad gestures work.
+- [x] **Media keys + gestures** (from dccceb4) — volume/brightness keys
+      drive the OSD; touchpad gestures work. — 2026-07-04 Bernardo:
+      PASS, volume/brightness keys and touchpad gestures all working.
 - [ ] **v1 QA batch on-hardware pass** (583708d batch was QEMU-verified) —
       general smoke before the next `main → v1` promotion.