cleveragents/cleveragents-core

Fork 3

UAT: TUI TuiMaterializer not implemented — no ElementHandle-to-widget mapping, TUI cannot display CLI command output #6444

New issue

Open

opened 2026-04-09 21:03:37 +00:00 by HAL9000 · 1 comment

HAL9000 commented

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

Owner

Bug Report

Spec Reference

Specification lines 29019, 27722–27741 (TuiMaterializer integration, Output Rendering Framework)

Expected Behavior (from spec)

From spec line 29019:

The TUI communicates with the Application layer exclusively through A2A (ADR-026). It subscribes to A2A events for real-time updates and uses the existing Output Rendering Framework (ADR-021) via a TuiMaterializer that maps ElementHandle events to Textual widget operations — enabling all CLI command producers to render in the TUI without modification.

From spec lines 27722–27741:

A TUI MaterializationStrategy (e.g., TuiMaterializer) would subscribe to element events and route them to TUI widgets. The producer code (command logic) is completely unaware of whether it is driving a CLI, TUI, or web frontend — it writes to handles identically in all cases.

The TuiMaterializer should:

Subscribe to ElementHandle events from the Output Rendering Framework
Route events to appropriate TUI widgets (tables → DataTable, code → CodeBlock, etc.)
Enable all CLI command producers to render in the TUI without modification

Actual Behavior (from code analysis)

No TuiMaterializer class exists anywhere in the codebase:

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

No file named materializer.py, tui_materializer.py, or similar exists. The TUI does not integrate with the Output Rendering Framework at all.

The TUI's app.py on_input_submitted() (lines 168–209) processes input and updates a plain _Static widget directly, bypassing the Output Rendering Framework entirely.

Code Location

src/cleveragents/tui/ — no materializer module
src/cleveragents/tui/app.py — lines 168–209 (direct static update, no materializer)

Steps to Reproduce (Code Analysis)

Search src/cleveragents/tui/ for any file containing "materializer" or "TuiMaterializer"
Observe: no such file exists
Read src/cleveragents/tui/app.py lines 168–209
Observe: conversation updated directly without materializer
Compare with spec lines 29019 and 27722–27741

Severity

Critical — without TuiMaterializer, the TUI cannot display output from CLI command producers (plan execution, actor responses, tool calls). This is a fundamental architectural gap.

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

## Bug Report ### Spec Reference Specification lines 29019, 27722–27741 (TuiMaterializer integration, Output Rendering Framework) ### Expected Behavior (from spec) From spec line 29019: > The TUI communicates with the Application layer exclusively through A2A (ADR-026). It subscribes to A2A events for real-time updates and uses the existing Output Rendering Framework (ADR-021) via a **`TuiMaterializer`** that maps `ElementHandle` events to Textual widget operations — enabling all CLI command producers to render in the TUI without modification. From spec lines 27722–27741: > A TUI `MaterializationStrategy` (e.g., `TuiMaterializer`) would subscribe to element events and route them to TUI widgets. The producer code (command logic) is completely unaware of whether it is driving a CLI, TUI, or web frontend — it writes to handles identically in all cases. The `TuiMaterializer` should: 1. Subscribe to `ElementHandle` events from the Output Rendering Framework 2. Route events to appropriate TUI widgets (tables → DataTable, code → CodeBlock, etc.) 3. Enable all CLI command producers to render in the TUI without modification ### Actual Behavior (from code analysis) No `TuiMaterializer` class exists anywhere in the codebase: ``` src/cleveragents/tui/ ├── app.py ├── commands.py ├── first_run.py ├── input/ ├── permissions/ ├── persona/ ├── search/ ├── shell_safety/ ├── slash_catalog.py └── widgets/ ``` No file named `materializer.py`, `tui_materializer.py`, or similar exists. The TUI does not integrate with the Output Rendering Framework at all. The TUI's `app.py` `on_input_submitted()` (lines 168–209) processes input and updates a plain `_Static` widget directly, bypassing the Output Rendering Framework entirely. ### Code Location - `src/cleveragents/tui/` — no materializer module - `src/cleveragents/tui/app.py` — lines 168–209 (direct static update, no materializer) ### Steps to Reproduce (Code Analysis) 1. Search `src/cleveragents/tui/` for any file containing "materializer" or "TuiMaterializer" 2. Observe: no such file exists 3. Read `src/cleveragents/tui/app.py` lines 168–209 4. Observe: conversation updated directly without materializer 5. Compare with spec lines 29019 and 27722–27741 ### Severity Critical — without `TuiMaterializer`, the TUI cannot display output from CLI command producers (plan execution, actor responses, tool calls). This is a fundamental architectural gap. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 21:09:07 +00:00

HAL9000 referenced this issue

2026-04-09 21:37:14 +00:00

[AUTO-UAT-SUP] UAT Testing Pool Status (Cycle 6) #6372

HAL9000 added a new dependency

2026-04-10 04:44:31 +00:00

#5306 EPIC: TUI A2A Integration Layer — TuiMaterializer & Session Binding (v3.7.0)

HAL9000 referenced this issue

2026-04-10 04:45:58 +00:00

EPIC: TUI A2A Integration Layer — TuiMaterializer & Session Binding (v3.7.0) #5306

HAL9000 referenced this issue

2026-04-10 04:48:02 +00:00

AUTO-PROD-BLDR: Product Builder Session — v3.7.0 Production Ready #6870

HAL9000 commented

2026-04-17 08:46:51 +00:00

Author

Owner

✅ Verified — Critical UAT bug. TuiMaterializer is a core v3.7.0 component that maps CLI output to TUI widgets. Without it, TUI cannot display any command output. MoSCoW: Must Have — core TUI architecture component.

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

✅ **Verified** — Critical UAT bug. TuiMaterializer is a core v3.7.0 component that maps CLI output to TUI widgets. Without it, TUI cannot display any command output. **MoSCoW: Must Have** — core TUI architecture component. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 added this to the v3.7.0 milestone

2026-04-17 08:47:06 +00:00

HAL9000 added

and removed

labels

2026-04-18 07:56:03 +00:00