feat/color-pick #30

genewildish · 2026-03-16T10:07:30Z

genewildish commented

2026-03-16 10:07:30 +00:00

Summary

Implements interactive color theme selection for Mainline news ticker.

Three selectable color themes: Verdant Green, Molten Orange, Violet Purple
Interactive picker at startup (↑/↓ or j/k, Enter to select)
Complementary gradients for ntfy messages (magenta, blue, yellow)
Fresh theme selection each run (no persistence)
Non-TTY environments silently default to green

Test Plan

Run python3 mainline.py and select each theme (verify colors)
Run echo "" | python3 mainline.py (verify non-TTY fallback)
Run python3 mainline.py --poetry with orange (verify poetry mode)
Run python3 mainline.py --code with purple (verify code mode)
Run pytest tests/ -v (all 121 tests pass)

Architecture

New engine/themes.py: Theme class + registry (data-only, no circular deps)
Modified engine/config.py: ACTIVE_THEME global + setter
Modified engine/render.py: Theme-aware gradients with fallback
Modified engine/scroll.py: Message gradient integration
Modified engine/app.py: Interactive picker UI + startup integration
Updated README.md: Feature documentation

## Summary Implements interactive color theme selection for Mainline news ticker. - Three selectable color themes: Verdant Green, Molten Orange, Violet Purple - Interactive picker at startup (↑/↓ or j/k, Enter to select) - Complementary gradients for ntfy messages (magenta, blue, yellow) - Fresh theme selection each run (no persistence) - Non-TTY environments silently default to green ## Test Plan - [x] Run `python3 mainline.py` and select each theme (verify colors) - [x] Run `echo "" | python3 mainline.py` (verify non-TTY fallback) - [x] Run `python3 mainline.py --poetry` with orange (verify poetry mode) - [x] Run `python3 mainline.py --code` with purple (verify code mode) - [x] Run `pytest tests/ -v` (all 121 tests pass) ## Architecture - New `engine/themes.py`: Theme class + registry (data-only, no circular deps) - Modified `engine/config.py`: ACTIVE_THEME global + setter - Modified `engine/render.py`: Theme-aware gradients with fallback - Modified `engine/scroll.py`: Message gradient integration - Modified `engine/app.py`: Interactive picker UI + startup integration - Updated `README.md`: Feature documentation

genewildish added 11 commits 2026-03-16 10:07:31 +00:00

docs: add color scheme switcher design spec f085042dee

docs: revise color scheme design spec to address review feedback 667bef2685

- Clarify boot messages use hardcoded green, not theme gradients
- Finalize all gradient ANSI color codes (no TBD)
- Add initialization guarantee for ACTIVE_THEME
- Resolve circular import risk with data-only themes.py
- Update theme ID naming to match menu labels
- Expand test strategy and mock approach

docs: add terminal resize handling clarification 9d9172ef0d

docs: add color scheme feature documentation to README 6daea90b0a

- Update opening description to mention selectable color gradients
- Add new 'Color Schemes' section with picker usage instructions
- Document three available themes (Green, Orange, Purple)
- Clarify that boot UI uses hardcoded green, not theme colors

docs: add color scheme implementation plan d9422b1fec

Comprehensive plan with 6 chunks, each containing bite-sized TDD tasks:
- Chunk 1: Theme class and registry
- Chunk 2: Config integration
- Chunk 3: Render pipeline
- Chunk 4: Message gradient integration
- Chunk 5: Color picker UI
- Chunk 6: Integration and validation

Each step includes exact code, test commands, and expected output.

feat: create Theme class and registry with finalized color gradients abc4483859

feat: add ACTIVE_THEME global and set_active_theme() to config ebe7b04ba5

feat: update lr_gradient to use config.ACTIVE_THEME d67423fe4c

- Remove hardcoded GRAD_COLS and MSG_GRAD_COLS module constants
- Add _default_green_gradient() and _default_magenta_gradient() fallback functions
- Add _color_codes_to_ansi() to convert integer color codes from themes to ANSI escape strings
- Update lr_gradient() signature: cols parameter (was grad_cols)
- lr_gradient() now pulls colors from config.ACTIVE_THEME when available
- Falls back to default green gradient when no theme is active
- Existing calls with explicit cols parameter continue to work
- Add comprehensive tests for new functionality

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

feat: update scroll.py to use theme message gradient 84cb16d463

Add msg_gradient() helper function to render.py that applies message
(ntfy) gradient using the active theme's message_gradient property.
This replaces hardcoded magenta gradient in scroll.py with a theme-aware
approach that uses complementary colors from the active theme.

- Add msg_gradient(rows, offset) helper in render.py with fallback to
  default magenta gradient when no theme is active
- Update scroll.py imports to use msg_gradient instead of
  lr_gradient_opposite
- Replace lr_gradient_opposite() call with msg_gradient() in message
  overlay rendering
- Add 6 comprehensive tests for msg_gradient covering theme usage,
  fallback behavior, and edge cases

All tests pass (121 passed), no regressions detected.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

feat: add pick_color_theme() UI and integration d4d0344a12

refactor: Fix import ordering and code formatting with ruff bc20a35ea9

Organize imports in render.py and scroll.py to meet ruff style requirements.
Add blank lines for code formatting compliance.

genewildish added 1 commit 2026-03-16 10:13:21 +00:00

Merge origin/main into feat/color-pick 31f5d9f171

Resolved conflicts in tests/test_config.py by keeping TestActiveTheme tests.
Main branch has new architecture components (controller, events, layers, effects).
Color scheme feature preserved and compatible.

genewildish merged commit 001158214c into main

2026-03-16 10:13:48 +00:00

genewildish referenced this issue from a commit

2026-03-16 10:13:48 +00:00

Merge pull request 'feat/color-pick' (#30) from feat/color-pick into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: genewildish/Mainline#30