docs: concrete attention system design for colibri-tui #189

Merged

clawdie merged 1 commit from docs/tui-attention-plan into main

2026-06-25 18:44:31 +02:00

clawdie commented

2026-06-25 17:18:37 +02:00

Owner

Summary

Crystallizes the TUI attention system design from our brainstorm into the existing working doc (GLASSPANE-TUI-ENHANCEMENTS.md).

Resolved decisions

needs_attention = Error + Blocked + Stalled — free function on &Pane, single source of truth
Stall threshold stays at 4h — Stalled is a rare/critical escalation signal
Attention bar replaces header when active (same 3-line footprint, red border)
Row highlight inverts on selection — bg(DarkRed) normally, fg(LightRed)+bold on bg(DarkGray) when selected
Filter composes (AND) with session filter, not replaces it

Implementation plan (4 tiers in `main.rs`, ~100-120 lines)

Tier	What	~Lines
1	`needs_attention()` + attention bar	~40
2	`n`/`N` jump keys	~20
3	`a` attention filter	~15
4	per-row highlight (invert on selection)	~20
5	answer-from-dashboard	separate PR

Docs-only change. Ready to implement after merge.

(Sam & Claude)

## Summary Crystallizes the TUI attention system design from our brainstorm into the existing working doc (`GLASSPANE-TUI-ENHANCEMENTS.md`). ### Resolved decisions - **needs_attention = Error + Blocked + Stalled** — free function on `&Pane`, single source of truth - **Stall threshold stays at 4h** — Stalled is a rare/critical escalation signal - **Attention bar replaces header** when active (same 3-line footprint, red border) - **Row highlight inverts on selection** — `bg(DarkRed)` normally, `fg(LightRed)+bold` on `bg(DarkGray)` when selected - **Filter composes (AND)** with session filter, not replaces it ### Implementation plan (4 tiers in `main.rs`, ~100-120 lines) | Tier | What | ~Lines | |------|------|--------| | 1 | `needs_attention()` + attention bar | ~40 | | 2 | `n`/`N` jump keys | ~20 | | 3 | `a` attention filter | ~15 | | 4 | per-row highlight (invert on selection) | ~20 | | 5 | answer-from-dashboard | separate PR | Docs-only change. Ready to implement after merge. *(Sam & Claude)*

clawdie added 1 commit 2026-06-25 17:18:40 +02:00

docs: add concrete attention system design to TUI enhancements

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

CI / port (pull_request) Has been cancelled

Details

CI / agent-jail-pkgs (pull_request) Has been cancelled

Details

0ac07a864c

Resolved decisions from brainstorm (Sam & Claude):
- needs_attention = Error + Blocked + Stalled (free function on &Pane)
- Stall threshold stays at 4h (Stalled is rare/critical, not frequent)
- Attention bar replaces header when active (same 3-line footprint)
- Row highlight inverts on selection (red bg → bright red fg on DarkGray)
- Filter composes with session filter (AND), not replaces

Implementation plan: 4 tiers in main.rs (~100-120 lines added):
  T1: needs_attention() + attention bar (replaces header)
  T2: n/N jump keys
  T3: a key attention filter
  T4: per-row highlight (invert on selection)
  T5: answer-from-dashboard (separate PR)

Also documents pre-existing 'All sessions' unreachable bug.