Files
pipelines/app/notes/background-tasks-gui.md

3.9 KiB
Raw Permalink Blame History

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.

Landing and publication — 7 November 2026

Source and verification notes fast-forwarded to main at 267d1007; ancestry check confirms 21542fb4 is included. Original unrelated README/macOS/export work remains untouched. Final badge captures (collapsed/expanded Cupertino light560) inspected under /private/tmp/background-gui-badge-final; status is readable and filename is shown once. Both release builds succeeded after the typography correction.

Web and Android update 29900160 published without restarting any service. Local authenticated and public HTTPS downloads each matched the staged bytes:

  • Web JS SHA256: d2efb78ba3195cab9bbfb13f75f83e5df20dfe6c742421291a6b055adcbcd26c
  • APK SHA256: e4373488add78e6bba17d60cb8635bdd6f50562c47e43ed1eed952c1930bf24f
  • Feed SHA256: b4cfdef64fe4ee6e9d3dd7a4b1a13a3920dd82322e672c97b9d41f32862e6a66

APK signer verified and matches existing 9bc6109afc4076573861d24b0e2c4af8115c96a94951238d7aa78915455ec494. Rollbacks retained at ~/.local/share/pipelines/lib/app-web.before-web-update-1794009679608653000 and app-updates.before-client-update-1794009679818766000. No device installation/testing performed. No retention policy or cleanup changed.