cleveragents/cleveragents-core

Fork 3

UAT: TUI notification system not implemented — flash messages, desktop notifications, and terminal title management all absent #4781

New issue

Open

opened 2026-04-08 18:57:06 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 18:57:06 +00:00

Owner

Bug Report

Feature Area: TUI Notification System
Severity: Medium (backlog)
Found by: UAT tester instance uat-tui-worker-1
Spec reference: docs/specification.md §Notification System (lines ~30065–30111)

What Was Tested

The src/cleveragents/tui/ directory was inspected for notification system implementation.

Expected Behavior (from spec)

The spec defines a multi-tier notification system:

1. Flash Messages (In-App)

Single-line notifications displayed between the conversation and the prompt, auto-dismissing after ui.flash_duration (default: 5s):

Style	CSS Class	Use Case	Example
Default	`-default`	Informational	`Press ctrl+f to focus terminal`
Success	`-success`	Positive outcomes	`✔ Plan fix-auth-bug completed ($0.08)`
Warning	`-warning`	Caution	`⚠ Plan approaching cost limit ($4.50/$5.00)`
Error	`-error`	Failures	`✗ Plan refactor-models failed: validation error`

2. Desktop Notifications

Delivered via OS notification system (notifypy on Linux/macOS, win10toast on Windows). Controlled by notifications.desktop setting (never/on-blur/always).

Events that trigger desktop notifications:

Actor turn completed
Permission requested
Plan phase transition
Plan error or failure
Session cost threshold exceeded

3. Terminal Title Management

Updates terminal window title via VT escape sequences (\033]0;...\007):

State	Title Format
Idle	`◆ CleverAgents — <session_name>`
Actor working	`⌛ CleverAgents — <session_name>`
Awaiting input	Alternates between `◆` and `👉` at 0.5s interval
Permission requested	Alternates between `◆` and `🔐` at 0.5s interval

Actual Behavior

No notification system exists in the TUI codebase. Searching src/cleveragents/tui/ finds:

No flash message widget
No desktop notification integration
No terminal title management
No notifypy or win10toast usage

The app.py has no flash message display, no notifications.* setting integration, and no VT escape sequence output.

Code Location

Missing: Flash message widget (between conversation and prompt)
Missing: Desktop notification service (notifypy integration)
Missing: Terminal title manager (VT escape sequences)
Missing: notifications.* settings integration

Impact

Users receive no in-app feedback when plans complete, fail, or require attention
No desktop notifications when TUI is in background
Terminal title never updates to reflect TUI state
The notifications.desktop, notifications.blink_title, notifications.enable_sounds settings have no effect

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** TUI Notification System **Severity:** Medium (backlog) **Found by:** UAT tester instance `uat-tui-worker-1` **Spec reference:** docs/specification.md §Notification System (lines ~30065–30111) --- ### What Was Tested The `src/cleveragents/tui/` directory was inspected for notification system implementation. ### Expected Behavior (from spec) The spec defines a **multi-tier notification system**: #### 1. Flash Messages (In-App) Single-line notifications displayed between the conversation and the prompt, auto-dismissing after `ui.flash_duration` (default: 5s): | Style | CSS Class | Use Case | Example | |-------|-----------|----------|---------| | Default | `-default` | Informational | `Press ctrl+f to focus terminal` | | Success | `-success` | Positive outcomes | `✔ Plan fix-auth-bug completed ($0.08)` | | Warning | `-warning` | Caution | `⚠ Plan approaching cost limit ($4.50/$5.00)` | | Error | `-error` | Failures | `✗ Plan refactor-models failed: validation error` | #### 2. Desktop Notifications Delivered via OS notification system (`notifypy` on Linux/macOS, `win10toast` on Windows). Controlled by `notifications.desktop` setting (`never`/`on-blur`/`always`). Events that trigger desktop notifications: - Actor turn completed - Permission requested - Plan phase transition - Plan error or failure - Session cost threshold exceeded #### 3. Terminal Title Management Updates terminal window title via VT escape sequences (`\033]0;...\007`): | State | Title Format | |-------|-------------| | Idle | `◆ CleverAgents — <session_name>` | | Actor working | `⌛ CleverAgents — <session_name>` | | Awaiting input | Alternates between `◆` and `👉` at 0.5s interval | | Permission requested | Alternates between `◆` and `🔐` at 0.5s interval | ### Actual Behavior No notification system exists in the TUI codebase. Searching `src/cleveragents/tui/` finds: - No flash message widget - No desktop notification integration - No terminal title management - No `notifypy` or `win10toast` usage The `app.py` has no flash message display, no `notifications.*` setting integration, and no VT escape sequence output. ### Code Location - **Missing:** Flash message widget (between conversation and prompt) - **Missing:** Desktop notification service (`notifypy` integration) - **Missing:** Terminal title manager (VT escape sequences) - **Missing:** `notifications.*` settings integration ### Impact - Users receive no in-app feedback when plans complete, fail, or require attention - No desktop notifications when TUI is in background - Terminal title never updates to reflect TUI state - The `notifications.desktop`, `notifications.blink_title`, `notifications.enable_sounds` settings have no effect --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 19:07:18 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4743

HAL9000 added the

labels

2026-04-08 23:00:12 +00:00

HAL9000 referenced this issue

2026-04-09 00:55:17 +00:00

UAT: TUI notification system not implemented — no flash messages, desktop notifications, or terminal title management #5050

HAL9000 referenced this issue

2026-04-09 00:58:39 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 5) #5088

HAL9000 referenced this issue

2026-04-09 01:28:34 +00:00

UAT: TUI notification system not implemented — no flash messages, desktop notifications, or sound effects #4395

HAL9000 referenced this issue

2026-04-09 01:30:08 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 9) #5135

HAL9000 commented

2026-04-09 03:04:09 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — spec compliance bug identified by UAT testing
Story Points: 3 (M) — targeted fix to align implementation with spec
MoSCoW: Must Have — spec compliance is required for correct system behavior

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — spec compliance bug identified by UAT testing - **Story Points**: 3 (M) — targeted fix to align implementation with spec - **MoSCoW**: Must Have — spec compliance is required for correct system behavior --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed

labels

2026-04-09 03:04:18 +00:00

HAL9000 added this to the v3.7.0 milestone