supsrc 2025-09-16
Decomposed TUI into modular handlers, helpers, and widgets with MkDocs setup
58 files · 2,734+ · 992-

TUI modular architecture decomposition

14 files changed
  • app.py Reduced from ~800 lines to a lean coordinator
  • base_app.py Shared TUI base class
  • utils.py Common TUI utilities
  • __init__.py TUI handlers package
  • actions.py Keyboard and button handlers
  • events.py Event processing handlers
  • repo_actions.py Repository-specific action handlers
  • __init__.py TUI helpers package
  • ui_helpers.py UI utility functions
  • worker_helpers.py Background worker management
  • __init__.py TUI managers package
  • timer_manager.py Centralized timer lifecycle management
  • resizable_panes.py Adjustable panel layout widget
  • app.py.backup Backup of original app.py
  • Decomposed tui/app.py from ~800 lines to a lean coordinator, created handlers/ package with actions, events, and repo_actions modules decouple architectural
    4 files
    • app.py
    • actions.py
    • events.py
    • repo_actions.py
  • Created helpers/ package (ui_helpers, worker_helpers), managers/ package (timer_manager), and widgets/ (resizable_panes) decouple behavioral
    3 files
    • ui_helpers.py
    • worker_helpers.py
    • timer_manager.py
  • Added base_app.py for shared TUI base class and utils.py with common utilities instantiate internal
    2 files
    • base_app.py
    • utils.py

Runtime status manager

1 file changed
  • status_manager.py Centralized repository status tracking and reporting (145 lines)
  • Added runtime/status_manager.py (145 lines) for centralized repository status tracking and reporting instantiate behavioral
    1 file
    • status_manager.py

MkDocs documentation site setup

3 files changed
  • mkdocs.yml MkDocs configuration for documentation site
  • index.md Documentation site index
  • index.md API documentation structure
  • Added mkdocs.yml configuration and created docs/index.md and docs/api/index.md for documentation structure specify behavioral
    3 files
    • mkdocs.yml
    • index.md
    • index.md

Orchestrator, LLM, git engine, and test updates

6 files changed
  • orchestrator.py Expanded with better integration of new runtime components
  • gemini.py Improved error handling and API interactions
  • ollama.py Improved error handling
  • base.py More robust error handling and status reporting
  • test_statistics_fix.py Statistics verification tests
  • supsrc.conf Sample configuration for testing
  • Expanded orchestrator with better integration of status manager, action handler, and event processor decouple behavioral
    1 file
    • orchestrator.py
  • Updated LLM providers with improved error handling, git engine with more robust status reporting harden internal
    2 files
    • gemini.py
    • base.py
  • Added test_statistics_fix.py and updated test files for new modular TUI structure qualify internal
    1 file
    • test_statistics_fix.py