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

Closed
opened 2026-04-09 00:51:02 +00:00 by HAL9000 · 1 comment
Owner

Bug Report

Feature Area: TUI — Notification System

Severity: High (user feedback system missing)

What Was Tested

The TUI notification system as defined in the specification (§ Notification System).

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-dismiss after ui.flash_duration (default 5s).

Style CSS Class Use Case
Default -default Informational
Success -success ✔ Plan fix-auth-bug completed ($0.08)
Warning -warning ⚠ Plan approaching cost limit ($4.50/$5.00)
Error -error ✗ Plan refactor-models failed: validation error

2. Desktop Notifications
Delivered via notifypy (Linux/macOS) or win10toast (Windows). Configurable: never / on-blur (default) / 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):

  • 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

4. Sound Effects
Optional sounds: turn_complete.wav, permission_required.wav, plan_complete.wav, error.wav bundled in src/cleveragents/tui/data/sounds/.

Actual Behavior (from code analysis)

No notification system exists in the TUI codebase:

  • No flash message widget
  • No desktop notification integration (notifypy not used)
  • No terminal title management code
  • No data/sounds/ directory in src/cleveragents/tui/
  • No notification-related settings in any settings module

Steps to Reproduce

  1. Run agents tui
  2. Complete an actor turn — no flash message appears
  3. Observe terminal title — no ◆ CleverAgents prefix

Code Location

  • src/cleveragents/tui/ — no notification module exists
  • src/cleveragents/tui/data/ — directory does not exist

Impact

Users receive no feedback about:

  • Plan completion or failure
  • Cost warnings
  • Actor turn completion
  • Permission requests (when TUI is in background)

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

## Bug Report **Feature Area:** TUI — Notification System **Severity:** High (user feedback system missing) ### What Was Tested The TUI notification system as defined in the specification (§ Notification System). ### 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-dismiss after `ui.flash_duration` (default 5s). | Style | CSS Class | Use Case | |-------|-----------|----------| | Default | `-default` | Informational | | Success | `-success` | `✔ Plan fix-auth-bug completed ($0.08)` | | Warning | `-warning` | `⚠ Plan approaching cost limit ($4.50/$5.00)` | | Error | `-error` | `✗ Plan refactor-models failed: validation error` | **2. Desktop Notifications** Delivered via `notifypy` (Linux/macOS) or `win10toast` (Windows). Configurable: `never` / `on-blur` (default) / `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`): - 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 **4. Sound Effects** Optional sounds: `turn_complete.wav`, `permission_required.wav`, `plan_complete.wav`, `error.wav` bundled in `src/cleveragents/tui/data/sounds/`. ### Actual Behavior (from code analysis) No notification system exists in the TUI codebase: - No flash message widget - No desktop notification integration (`notifypy` not used) - No terminal title management code - No `data/sounds/` directory in `src/cleveragents/tui/` - No notification-related settings in any settings module ### Steps to Reproduce 1. Run `agents tui` 2. Complete an actor turn — no flash message appears 3. Observe terminal title — no `◆ CleverAgents` prefix ### Code Location - `src/cleveragents/tui/` — no notification module exists - `src/cleveragents/tui/data/` — directory does not exist ### Impact Users receive no feedback about: - Plan completion or failure - Cost warnings - Actor turn completion - Permission requests (when TUI is in background) --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester
Author
Owner

Closing as duplicate of #4781 — both issues report the same problem: TUI notification system not implemented. Issue #4781 has more detail on the missing components.


Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Closing as duplicate of #4781 — both issues report the same problem: TUI notification system not implemented. Issue #4781 has more detail on the missing components. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#5050
No description provided.