bug(tui): ThoughtBlockWidget uses wrong CSS background — $primary 20% instead of spec-required $primary-muted 20% #1448

Closed
opened 2026-04-02 18:17:00 +00:00 by freemo · 2 comments
Owner

Summary

ThoughtBlockWidget in src/cleveragents/tui/widgets/thought_block.py uses $primary 20% as the background colour, but the specification (§29811) explicitly requires $primary-muted 20%.

Spec Reference

docs/specification.md §29811 — Actor Thought Block:

Property Value
Background $primary-muted 20%
Text style Italic

Also §29671:

ActorThought | $primary-muted 20% bg, max 10 lines (expandable), italic | Actor reasoning

Current Implementation

# src/cleveragents/tui/widgets/thought_block.py
DEFAULT_CSS = """
ThoughtBlockWidget {
    background: $primary 20%;        # ← WRONG: should be $primary-muted 20%
    color: $text-muted;
    border: solid $primary 30%;
    padding: 0 1;
    margin: 0 0 1 0;
}

Expected Fix

DEFAULT_CSS = """
ThoughtBlockWidget {
    background: $primary-muted 20%;  # ← CORRECT per spec
    color: $text-muted;
    border: solid $primary 30%;
    padding: 0 1;
    margin: 0 0 1 0;
}

Impact

The thought block will appear with the wrong visual weight — using the full primary colour at 20% opacity instead of the muted variant, making it visually heavier than intended and inconsistent with the spec's design intent of a subtle, non-distracting reasoning trace display.

Definition of Done

  • ThoughtBlockWidget.DEFAULT_CSS updated to use $primary-muted 20%
  • BDD scenario added/updated to verify the CSS class
  • nox -e lint && nox -e typecheck && nox -e unit_tests pass

Metadata

Suggested commit: fix(tui): use $primary-muted background for ThoughtBlockWidget per spec
Suggested branch: bugfix/thought-block-css-primary-muted


Automated by CleverAgents Bot
Supervisor: Spec Evolution | Agent: ca-spec-updater

## Summary `ThoughtBlockWidget` in `src/cleveragents/tui/widgets/thought_block.py` uses `$primary 20%` as the background colour, but the specification (§29811) explicitly requires `$primary-muted 20%`. ## Spec Reference **`docs/specification.md` §29811 — Actor Thought Block:** | Property | Value | |----------|-------| | Background | `$primary-muted 20%` | | Text style | Italic | Also §29671: > `ActorThought` | `$primary-muted` 20% bg, max 10 lines (expandable), italic | Actor reasoning ## Current Implementation ```python # src/cleveragents/tui/widgets/thought_block.py DEFAULT_CSS = """ ThoughtBlockWidget { background: $primary 20%; # ← WRONG: should be $primary-muted 20% color: $text-muted; border: solid $primary 30%; padding: 0 1; margin: 0 0 1 0; } ``` ## Expected Fix ```python DEFAULT_CSS = """ ThoughtBlockWidget { background: $primary-muted 20%; # ← CORRECT per spec color: $text-muted; border: solid $primary 30%; padding: 0 1; margin: 0 0 1 0; } ``` ## Impact The thought block will appear with the wrong visual weight — using the full primary colour at 20% opacity instead of the muted variant, making it visually heavier than intended and inconsistent with the spec's design intent of a subtle, non-distracting reasoning trace display. ## Definition of Done - [ ] `ThoughtBlockWidget.DEFAULT_CSS` updated to use `$primary-muted 20%` - [ ] BDD scenario added/updated to verify the CSS class - [ ] `nox -e lint && nox -e typecheck && nox -e unit_tests` pass ## Metadata **Suggested commit:** `fix(tui): use $primary-muted background for ThoughtBlockWidget per spec` **Suggested branch:** `bugfix/thought-block-css-primary-muted` --- **Automated by CleverAgents Bot** Supervisor: Spec Evolution | Agent: ca-spec-updater
freemo self-assigned this 2026-04-02 18:45:09 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Low (already assigned) — CSS colour value deviation. Purely cosmetic.
  • Milestone: Needs assignment — TUI feature, belongs in v3.7.0.
  • MoSCoW: Could Have — This is a minor CSS colour deviation ($primary vs $primary-muted). The visual difference is subtle (full primary at 20% opacity vs muted primary at 20% opacity). While the spec is explicit, this is cosmetic polish that can be deferred.

Valid but low-impact bug. One-line CSS fix.


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

Issue triaged by project owner: - **State**: Verified - **Priority**: Low (already assigned) — CSS colour value deviation. Purely cosmetic. - **Milestone**: Needs assignment — TUI feature, belongs in v3.7.0. - **MoSCoW**: Could Have — This is a minor CSS colour deviation (`$primary` vs `$primary-muted`). The visual difference is subtle (full primary at 20% opacity vs muted primary at 20% opacity). While the spec is explicit, this is cosmetic polish that can be deferred. Valid but low-impact bug. One-line CSS fix. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
freemo 2026-04-02 19:31:05 +00:00
Author
Owner

Closing — work completed in PR #1479 (merged). The PR fixed ThoughtBlockWidget to use $primary-muted background as required by the spec.


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

Closing — work completed in PR #1479 (merged). The PR fixed `ThoughtBlockWidget` to use `$primary-muted` background as required by the spec. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: ca-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#1448
No description provided.