UAT: TUI sound effects not implemented — data/sounds/ directory and audio playback on events absent #4791

Open
opened 2026-04-08 18:58:56 +00:00 by HAL9000 · 1 comment
Owner

Bug Report

Feature Area: TUI Sound Effects
Severity: Low (backlog)
Found by: UAT tester instance uat-tui-worker-1
Spec reference: docs/specification.md §Sound Effects (lines ~30113–30122)


What Was Tested

The src/cleveragents/tui/ directory was inspected for sound effects implementation.

Expected Behavior (from spec)

The spec defines optional sound effects for significant events:

Optional sound effects play on significant events (controlled by notifications.enable_sounds setting, default: true):

  • turn_complete.wav — Actor finished a response
  • permission_required.wav — Permission requested
  • plan_complete.wav — Plan reached terminal state
  • error.wav — Error or failure occurred

Sound files are bundled in src/cleveragents/tui/data/sounds/. The notification system gracefully degrades if audio playback is unavailable (e.g., headless server).

Actual Behavior

The src/cleveragents/tui/ directory has no data/ subdirectory and no sound files:

src/cleveragents/tui/
├── __init__.py
├── app.py
├── cleveragents.tcss
├── commands.py
├── first_run.py
├── input/
├── permissions/
├── persona/
├── screens/
├── search/
├── shell_safety/
├── slash_catalog.py
└── widgets/

There is no data/sounds/ directory, no .wav files, and no audio playback code anywhere in the TUI module.

Code Location

  • Missing: src/cleveragents/tui/data/sounds/turn_complete.wav
  • Missing: src/cleveragents/tui/data/sounds/permission_required.wav
  • Missing: src/cleveragents/tui/data/sounds/plan_complete.wav
  • Missing: src/cleveragents/tui/data/sounds/error.wav
  • Missing: Audio playback service (e.g., using playsound, pygame.mixer, or subprocess with aplay/afplay)
  • Missing: notifications.enable_sounds setting integration

Impact

  • No audio feedback for significant events
  • The notifications.enable_sounds setting has no effect
  • Users on headless servers would not be affected (graceful degradation is also not implemented)

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

## Bug Report **Feature Area:** TUI Sound Effects **Severity:** Low (backlog) **Found by:** UAT tester instance `uat-tui-worker-1` **Spec reference:** docs/specification.md §Sound Effects (lines ~30113–30122) --- ### What Was Tested The `src/cleveragents/tui/` directory was inspected for sound effects implementation. ### Expected Behavior (from spec) The spec defines optional sound effects for significant events: > Optional sound effects play on significant events (controlled by `notifications.enable_sounds` setting, default: `true`): > > - `turn_complete.wav` — Actor finished a response > - `permission_required.wav` — Permission requested > - `plan_complete.wav` — Plan reached terminal state > - `error.wav` — Error or failure occurred > > Sound files are bundled in `src/cleveragents/tui/data/sounds/`. The notification system gracefully degrades if audio playback is unavailable (e.g., headless server). ### Actual Behavior The `src/cleveragents/tui/` directory has no `data/` subdirectory and no sound files: ``` src/cleveragents/tui/ ├── __init__.py ├── app.py ├── cleveragents.tcss ├── commands.py ├── first_run.py ├── input/ ├── permissions/ ├── persona/ ├── screens/ ├── search/ ├── shell_safety/ ├── slash_catalog.py └── widgets/ ``` There is no `data/sounds/` directory, no `.wav` files, and no audio playback code anywhere in the TUI module. ### Code Location - **Missing:** `src/cleveragents/tui/data/sounds/turn_complete.wav` - **Missing:** `src/cleveragents/tui/data/sounds/permission_required.wav` - **Missing:** `src/cleveragents/tui/data/sounds/plan_complete.wav` - **Missing:** `src/cleveragents/tui/data/sounds/error.wav` - **Missing:** Audio playback service (e.g., using `playsound`, `pygame.mixer`, or `subprocess` with `aplay`/`afplay`) - **Missing:** `notifications.enable_sounds` setting integration ### Impact - No audio feedback for significant events - The `notifications.enable_sounds` setting has no effect - Users on headless servers would not be affected (graceful degradation is also not implemented) --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester
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 this to the v3.7.0 milestone 2026-04-09 03:03:56 +00:00
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#4791
No description provided.