Record background task GUI design and verification

This commit is contained in:
2026-11-07 00:00:54 +00:00
parent 21542fb4f0
commit 267d100708
+23
View File
@@ -0,0 +1,23 @@
# Background task inspector GUI
Replaces the flat alert/list with an adaptive native task inspector. Material uses a width-bounded dialog and Cupertino a grouped sheet. Each task has a kind icon, title, Running badge, prominent elapsed time, and labelled Started/tool-call/token facts. Counts retain exact values with grouping; dates remain day-first and 24-hour. Missing start time and reported runtime remain distinct.
Duplicate title/command/progress text is suppressed. Distinct progress has its own inset surface. Details explicitly reveal identity, additional command/last-tool/update facts and a separately bounded selectable output surface. Loading/error/empty/unavailable/refresh behavior and existing generation/session scoping remain intact. The existing one-second local timer updates elapsed time without extra network requests.
## Evidence
The isolated full-app fixture adds `tasks=example` matching the supplied one-task screenshot (same repeated screenshot path, 37 tool calls, 120,905 tokens, start 4m40s earlier). `tasks=rich` still exercises three tasks including missing start/runtime. This fixture never contacts the backend or changes real chats.
Initial browser review inspected seven actual PNGs from the app: Material dark 880×720 example collapsed/expanded; Cupertino light 560×1000 three-task list; Material light 560×1000 list/expanded; Cupertino dark 1100×800 example collapsed/expanded. Captures are under `/private/tmp/background-gui-{material,cupertino,material-light-phone,cupertino-dark-wide}`. Final checks/publication are recorded below after completion.
No backend changes or service restart. No physical device testing or installation.
## Checks and source
- Fixture commit `d739166c`; primary GUI commit `cd175e09`.
- 33 focused background GUI/controller/modal/metadata tests passed via memory watchdog. Responsive cases retain 320px/2× coverage; long-output coverage scrolls the actual selectable output and checks its inner offset.
- Integrated chat suite: 900 passed (68s, peak 1,827 MB). Application: 143 passed (47s, peak 2,358 MB). Shell: 123 passed (12s, peak 1,707 MB).
- Bounded analysis clean; source diff has no whitespace errors.
- Final browser interactions also opened Details and used Done to return to the same chat in both native styles; six PNGs inspected under `/private/tmp/background-gui-material-final` and `/private/tmp/background-gui-cupertino-final`. A final typography-only correction replaces Cupertino tab-label typography with readable native body-derived 13px status text and uses Material onSecondaryContainer foreground. Release rebuild and final badge capture follow that correction.
Badge correction `21542fb4`: 24 focused checks passed (including responsive cases), bounded analysis clean.