From 267d1007087f6f36507fad08c13537e1f42212bc Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Sat, 7 Nov 2026 00:00:54 +0000 Subject: [PATCH] Record background task GUI design and verification --- app/notes/background-tasks-gui.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 app/notes/background-tasks-gui.md diff --git a/app/notes/background-tasks-gui.md b/app/notes/background-tasks-gui.md new file mode 100644 index 00000000..1bc4c037 --- /dev/null +++ b/app/notes/background-tasks-gui.md @@ -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.