supsrc 2025-05-01
Initial project scaffold with full application architecture
222 files · 48,212+ · 1-

Core application package with CLI and configuration

instantiate architectural
14 files changed
  • __init__.py Package initialization with version exports
  • __init__.py CLI package initialization
  • main.py Click-based main CLI entry point
  • config_cmds.py Configuration management CLI commands
  • watch_cmds.py Watch command for filesystem monitoring mode
  • sui_cmds.py SUI command interface
  • circuit_breaker_cmds.py Circuit breaker management commands
  • utils.py Shared CLI utility functions and logging setup
  • __init__.py Configuration package initialization
  • defaults.py Centralized default configuration values
  • models.py TOML-based configuration models with attrs/cattrs
  • exceptions.py Application-wide exception hierarchy
  • protocols.py Protocol definitions for engine and service interfaces
  • types.py Shared type definitions
  • Created the complete supsrc Python package with click-based CLI providing watch, config, sui, and circuit-breaker command groups instantiate architectural
    4 files
    • main.py
    • watch_cmds.py
    • config_cmds.py
    • sui_cmds.py
  • Built TOML-based configuration system with attrs/cattrs models, default values module, and loader instantiate behavioral
    3 files
    • __init__.py
    • defaults.py
    • models.py

Git engine with authentication and event integration

instantiate architectural
7 files changed
  • __init__.py Engines package initialization
  • __init__.py Git engine package initialization
  • base.py Core git operations using pygit2
  • auth.py SSH key, SSH agent, and HTTPS credential support
  • events.py Git-specific event definitions
  • info.py Repository information queries
  • operations.py High-level git operations (stage, commit, push)
  • Implemented pygit2-based git engine with staging, commit, push, and credential support including SSH key, SSH agent, and HTTPS authentication instantiate architectural
    3 files
    • base.py
    • auth.py
    • operations.py

Event system with buffering and feed table widget

instantiate behavioral
21 files changed
  • __init__.py Events package initialization
  • base.py BaseEvent attrs class definition
  • collector.py Event collector for gathering filesystem events
  • feed.py Event feed for TUI consumption
  • protocol.py Event protocol definition
  • system.py System-level event types
  • processor.py Event processing pipeline with timer debounce
  • monitor.py Event monitoring
  • json_logger.py Event logging to JSON format
  • defaults.py Default values for buffer windows and debounce timers
  • __init__.py Buffer package initialization
  • core.py Event buffer core logic
  • grouping.py Event grouping and deduplication
  • converters.py Buffer event converters
  • streaming.py Streaming buffer support
  • buffer_events.py Buffer-specific event types
  • __init__.py Feed table package initialization
  • widget.py Textual widget for event display
  • formatters.py Rich event formatting with file type detection
  • file_utils.py File utility functions for feed table
  • timer.py Timer management for event processing
  • Created comprehensive event system with base events, collector, feed, processor pipeline, and buffer system supporting grouping, deduplication, and configurable debounce windows instantiate behavioral
    3 files
    • base.py
    • processor.py
    • core.py
  • Added Textual-based feed table widget for displaying events with rich formatting instantiate behavioral
    2 files
    • widget.py
    • formatters.py

Runtime orchestrator with workflow engine and state management

instantiate architectural
13 files changed
  • __init__.py Runtime package initialization
  • orchestrator.py Main orchestrator coordinating all subsystems
  • action_handler.py Handles git stage/commit/push actions
  • monitoring_coordinator.py Coordinates file monitoring across repositories
  • repository_manager.py Per-repository lifecycle management
  • status_manager.py Centralized repository status tracking
  • tui_interface.py TUI communication layer
  • __init__.py Workflow package initialization
  • executor.py Workflow execution engine
  • steps.py Composable workflow step definitions
  • git_operations.py Git operations workflow step
  • llm_utils.py LLM integration utilities for workflows
  • test_runner.py Test execution workflow step
  • Built decomposed runtime with orchestrator delegating to action handler, monitoring coordinator, repository manager, and status manager instantiate architectural
    3 files
    • orchestrator.py
    • action_handler.py
    • repository_manager.py
  • Added workflow engine with composable steps for git operations, LLM integration, and test execution instantiate behavioral
    2 files
    • executor.py
    • steps.py

Filesystem monitoring, TUI, LLM, and supporting modules

instantiate behavioral
35 files changed
  • __init__.py Monitor package initialization
  • handler.py Watchdog event handler with debouncing
  • service.py Monitoring service managing directory watchers
  • events.py Monitor event definitions
  • __init__.py TUI package initialization
  • app.py Main Textual TUI application
  • base_app.py Shared TUI base class
  • messages.py TUI message passing
  • utils.py Common TUI utilities
  • actions.py Keyboard and button handlers
  • events.py TUI event processing
  • repo_actions.py Repository-specific TUI actions
  • ui_helpers.py UI utility functions
  • worker_helpers.py Background worker management
  • timer_manager.py Timer lifecycle management
  • draggable_splitter.py Draggable pane splitter widget
  • log_panel.py Log panel widget
  • __init__.py LLM package initialization
  • prompts.py Prompt templates for commit messages and code review
  • base.py Base provider abstraction
  • gemini.py Google Gemini API integration
  • ollama.py Local Ollama model integration
  • __init__.py State package initialization
  • control.py Control state tracking
  • file.py File-level state management
  • manager.py State lifecycle management
  • monitor.py Monitor state tracking
  • runtime.py Runtime state definitions
  • __init__.py Telemetry package initialization
  • eventset.py Telemetry event set definitions
  • rules.py Inactivity, save count, and manual trigger rules
  • circuit_breaker.py Circuit breaker for fault tolerance
  • console_formatter.py Console output formatting
  • directories.py Data directory management
  • streams.py Stream utilities
  • Implemented watchdog-based monitoring, modular Textual TUI with handlers/helpers/widgets, LLM integration with Gemini and Ollama providers, decomposed state management, and supporting services instantiate behavioral
    4 files
    • service.py
    • app.py
    • gemini.py
    • manager.py

Test suite, CI, and project configuration

qualify behavioral
13 files changed
  • pyproject.toml Full metadata, dependencies, and ruff/mypy configuration
  • mkdocs.yml MkDocs documentation site configuration
  • ci.yml GitHub Actions CI workflow
  • release.yml Release workflow
  • LICENSE Apache 2.0 license
  • README.md Usage docs, configuration examples, and architecture overview
  • VERSION Single-source version file
  • CHANGELOG.md Release changelog
  • CLAUDE.md Claude Code project instructions
  • CONTRIBUTING.md Contribution guidelines
  • uv.lock Dependency lock file
  • supsrc.conf Default configuration file
  • .gitignore Git ignore rules
  • Full test suite with unit tests for CLI, config, git engine, events, state, TUI, orchestrator, workflow; integration tests for monitoring, TUI workflows, timer debounce; and E2E tests qualify behavioral
    6 files
    • test_cli.py
    • test_config.py
    • test_git_engine.py
    • test_orchestrator.py
    • test_monitoring.py
    • test_cli_integration.py
  • Added pyproject.toml with dependencies, GitHub Actions CI/release workflows, MkDocs setup, Apache 2.0 LICENSE, and comprehensive README baseline internal
    5 files
    • pyproject.toml
    • ci.yml
    • mkdocs.yml
    • LICENSE
    • README.md
changelog → 2025-05-02 supsrc →