Files

T

gramps 87509bcf99 docs: restructure TASKS.md into a catalog — one file per task in TASKS/

TASKS.md is now the index (status table, open items, research pointer).
33 files: 32 task files + 1 research facts file. The full take-saga
narrative and all design decisions are preserved verbatim; the catalog
makes the queue readable without opening every task body. Schema and
AGENTS.md updated to reflect the new layout.

2026-09-05 16:31:46 -07:00

2.6 KiB

Raw Permalink Blame History

TASK 24 — Toast notifications (in-app, non-blocking)

Catalog: TASKS.md — status and requirements live here.

Status: ✅ Done (shipped 2026-08-23, branch `task24-notifications`)

Replace blocking MessageBoxes with in-window toasts; promote actionable log-only failures.

Requirements:

Library: Notification.Wpf 11.0.0 (Platonenkov fork of Federerer/Notifications.Wpf) — MIT, active, targets net8.0-windows. Notice #10 added to THIRD-PARTY-NOTICES.txt.
Placement: bottom-right above the footer (NotificationArea x:Name="ToastArea", last child of MainWindow's root grid → topmost z-order, Grid.RowSpan=4, Margin="0,0,12,96", outside the preview Viewbox), max 4 stacked.
Behavior: Info ~4s / Success ~4s / Warning ~8s auto-dismiss; Error sticky until dismissed.
Styling: dark card tints matching the health-banner language (slate #3a3b52 info, green #1d5c38 success, amber #b8860b warning, dark-red #8f1f1f error); corner radius 8; keep-visible-on-hover.
Threading: all Show calls marshal via a Dispatcher captured at construction (encoder/pump events fire off-thread).

Migrations (MessageBox → toast):

Webcam acquire failure ×2 (AddWebcamToStagedSceneAsync, SwapWebcamIdentityAsync) → Warning
Image read failure (PickImageBytes) → Warning
Sign-in unsuccessful → Warning; sign-in failed → Error

Promotions (log-only → toast, each keeps its AppLog line):

Go-live prep ×3: reusable stream unavailable / broadcast insert failed / prep exception → Error
Frame-pump death while live (OnFramePumpFailed) → Error
Mic missing at startup (StartMicCaptureAsync) → Warning (once)
Premium lapse at startup re-validation → Warning
Saved-session refresh failure (signed out notice) → Info

Deliberately left alone: offline license re-validation skip (log-only — would spam every launch); SocialsDialog slot-delete YesNo confirm (stays modal).

Tests:

Unit: pure severity→request mapping (NotificationServiceTests) — area routing, lifetimes, tints.
Integration (the ONE): real window-hosted ToastArea + real service — Info auto-dismisses, Error sticks (NotificationAreaIntegrationTests, RealApp collection).

Library facts (cost a hunt — see also ai.md):

Area routing matches the area's XAML Name against the request's AreaName; unknown name silently drops.
NeverExpires() = ExpirationTime = TimeSpan.MaxValue (not null); NotificationColor.ToHex() returns #AARRGGBB.
Overlay-window shutdown caveat avoided entirely by using the in-window area mode.

2.6 KiB Raw Permalink Blame History Unescape Escape