f5de2c62e0
feat(display): add reuse flag to Display protocol
...
- Add reuse parameter to Display.init() for all backends
- PygameDisplay: reuse existing SDL window via class-level flag
- TerminalDisplay: skip re-init when reuse=True
- WebSocketDisplay: skip server start when reuse=True
- SixelDisplay, KittyDisplay, NullDisplay: ignore reuse (not applicable)
- MultiDisplay: pass reuse to child displays
- Update benchmark.py to reuse pygame display for effect benchmarks
- Add test_websocket_e2e.py with e2e marker
- Register e2e marker in pyproject.toml
2026-03-16 00:30:52 -07:00
f9991c24af
feat(display): add Pygame native window display backend
...
- Add PygameDisplay for rendering in native application window
- Add pygame to optional dependencies
- Add run-pygame mise task
2026-03-16 00:00:53 -07:00
20ed014491
feat(display): add Kitty graphics backend and improve font detection
...
- Add KittyDisplay using kitty's native graphics protocol
- Improve cross-platform font detection for SixelDisplay
- Add run-kitty mise task for testing kitty backend
- Add kitty_test.py for testing graphics protocol
2026-03-15 23:56:48 -07:00
9e4d54a82e
feat(tests): improve coverage to 56%, add benchmark regression tests
...
- Add EffectPlugin ABC with @abstractmethod decorators for interface enforcement
- Add runtime interface checking in discover_plugins() with issubclass()
- Add EffectContext factory with sensible defaults
- Standardize Display __init__ (remove redundant init in TerminalDisplay)
- Document effect behavior when ticker_height=0
- Evaluate legacy effects: document coexistence, no deprecation needed
- Research plugin patterns (VST, Python entry points)
- Fix pysixel dependency (removed broken dependency)
Test coverage improvements:
- Add DisplayRegistry tests
- Add MultiDisplay tests
- Add SixelDisplay tests
- Add controller._get_display tests
- Add effects controller command handling tests
- Add benchmark regression tests (@pytest.mark.benchmark)
- Add pytest marker for benchmark tests in pyproject.toml
Documentation updates:
- Update AGENTS.md with 56% coverage stats and effect plugin docs
- Update README.md with Sixel display mode and benchmark commands
- Add new modules to architecture section
2026-03-15 23:26:10 -07:00
dcd31469a5
feat(benchmark): add hook mode with baseline cache for pre-push checks
...
- Fix lint errors and LSP issues in benchmark.py
- Add --hook mode to compare against saved baseline
- Add --baseline flag to save results as baseline
- Add --threshold to configure degradation threshold (default 20%)
- Add benchmark step to pre-push hook in hk.pkl
- Update AGENTS.md with hk documentation links and benchmark runner docs
2026-03-15 22:57:55 -07:00
829c4ab63d
refactor: modularize display backends and add benchmark runner
...
- Create engine/display/ package with registry pattern
- Move displays to engine/display/backends/ (terminal, null, websocket, sixel)
- Add DisplayRegistry with auto-discovery
- Add benchmark.py for performance testing effects × displays matrix
- Add mise tasks: benchmark, benchmark-json, benchmark-report
- Update controller to use new display module
2026-03-15 22:25:28 -07:00
22dd063baa
feat: add SixelDisplay backend for terminal graphics
...
- Implement pure Python Sixel encoder (no C dependency)
- Add SixelDisplay class to display.py with ANSI parsing
- Update controller._get_display() to handle sixel mode
- Add --display sixel CLI flag
- Add mise run-sixel task
- Update docs with display modes
2026-03-15 22:13:44 -07:00
0f7203e4e0
feat: enable C&C, compact mise tasks, update docs
...
- Cherry-pick C&C support (ntfy poller for commands, response handling)
- Compact mise.toml with native dependency chaining
- Update AGENTS.md with C&C documentation
- Update README.md with display modes and C&C usage
2026-03-15 21:55:26 -07:00
ba050ada24
feat(cmdline): C&C with separate topics and rich output
2026-03-15 21:47:53 -07:00
d7b044ceae
feat(display): add configurable multi-backend display system
2026-03-15 21:17:16 -07:00
ac1306373d
feat(websocket): add WebSocket display backend for browser client
2026-03-15 20:54:03 -07:00
2650f7245e
merge: effects_plugins
2026-03-15 19:20:53 -07:00
b1f2b9d2be
feat(daemon): add display abstraction and daemon mode with C&C
2026-03-15 19:20:47 -07:00
c08a7d3cb0
feat(cmdline): add command-line interface for mainline control
2026-03-15 19:20:47 -07:00
d5a3edba97
feat(effects): add plugin architecture with performance monitoring
2026-03-15 19:20:47 -07:00
fb35458718
merge: testability_modularization
2026-03-15 19:20:43 -07:00
15de46722a
refactor: phase 4 - event-driven architecture foundation
...
- Add EventBus class with pub/sub messaging (thread-safe)
- Add emitter Protocol classes (EventEmitter, Startable, Stoppable)
- Add event emission to NtfyPoller (NtfyMessageEvent)
- Add event emission to MicMonitor (MicLevelEvent)
- Update StreamController to publish stream start/end events
- Add comprehensive tests for eventbus and emitters modules
2026-03-15 19:15:08 -07:00
35e5c8d38b
refactor: phase 3 - API efficiency improvements
...
Add typed dataclasses for tuple returns:
- types.py: HeadlineItem, FetchResult, Block dataclasses with legacy tuple converters
- fetch.py: Add type hints and HeadlineTuple type alias
Add pyright for static type checking:
- Add pyright to dependencies
- Verify type coverage with pyright (0 errors in core modules)
This enables:
- Named types instead of raw tuples (better IDE support, self-documenting)
- Type-safe APIs across modules
- Backward compatibility via to_tuple/from_tuple methods
Note: Lazy imports skipped for render.py - startup impact is minimal.
2026-03-15 19:13:32 -07:00
cdc8094de2
refactor: phase 2 - modularization of scroll engine
...
Split monolithic scroll.py into focused modules:
- viewport.py: terminal size (tw/th), ANSI positioning helpers
- frame.py: FrameTimer class, scroll step calculation
- layers.py: message overlay, ticker zone, firehose rendering
- scroll.py: simplified orchestrator, imports from new modules
Add stream controller and event types for future event-driven architecture:
- controller.py: StreamController for source initialization and stream lifecycle
- events.py: EventType enum and event dataclasses (HeadlineEvent, FrameTickEvent, etc.)
Added tests for new modules:
- test_viewport.py: 8 tests for viewport utilities
- test_frame.py: 10 tests for frame timing
- test_layers.py: 13 tests for layer compositing
- test_events.py: 11 tests for event types
- test_controller.py: 6 tests for stream controller
This enables:
- Testable chunks with clear responsibilities
- Reusable viewport utilities across modules
- Better separation of concerns in render pipeline
- Foundation for future event-driven architecture
Also includes Phase 1 documentation updates in code comments.
2026-03-15 19:13:32 -07:00
f170143939
refactor: phase 1 - testability improvements
...
- Add Config dataclass with get_config()/set_config() for injection
- Add Config.from_args() for CLI argument parsing (testable)
- Add platform font path detection (Darwin/Linux)
- Bound translate cache with @lru_cache(maxsize=500)
- Add fixtures for external dependencies (network, feeds, config)
- Add 15 tests for Config class, from_args, and platform detection
This enables testability by:
- Allowing config injection instead of global mutable state
- Supporting custom argv in from_args() for testing
- Providing reusable fixtures for mocking network/filesystem
- Preventing unbounded memory growth in translation cache
Fixes: _arg_value/_arg_int not accepting custom argv
2026-03-15 19:13:32 -07:00
19fb4bc4fe
Merge pull request 'docs/update-readme' ( #23 ) from docs/update-readme into main
...
Reviewed-on: #23
2026-03-16 00:09:10 +00:00
ae10fd78ca
refactor: Restructure README, add uv and mise commands, and detail component extension and development workflows.
2026-03-15 17:08:32 -07:00
4afab642f7
docs: add README update design spec
...
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-15 16:56:58 -07:00
f6f177590b
Merge pull request 'Modernize project with uv, pytest, ruff, and git hooks' ( #21 ) from enhance_portability into main
...
Reviewed-on: #21
2026-03-15 23:21:35 +00:00
9ae4dc2b07
fix: update ntfy tests for SSE API (reconnect_delay)
2026-03-15 15:16:37 -07:00
1ac2dec3b0
fix: use native hk staging in pre-commit hook
...
fix: add explicit check command to pre-push hook
2026-03-15 15:16:37 -07:00
757c854584
fix: apply ruff auto-fixes and add hk git hooks
...
- Fix pre-existing lint errors in engine/ modules using ruff --unsafe-fixes
- Add hk.pkl with pre-commit and pre-push hooks using ruff builtin
- Configure hooks to use 'uv run' prefix for tool execution
- Update mise.toml to include hk and pkl tools
- All 73 tests pass
fix: apply ruff auto-fixes and add hk git hooks
- Fix pre-existing lint errors in engine/ modules using ruff --unsafe-fixes
- Add hk.pkl with pre-commit and pre-push hooks using ruff builtin
- Configure hooks to use 'uv run' prefix for tool execution
- Update mise.toml to include hk and pkl tools
- Use 'hk install --mise' for proper mise integration
- All 73 tests pass
2026-03-15 15:16:37 -07:00
4844a64203
style: apply ruff auto-fixes across codebase
...
- Fix import sorting (isort) across all engine modules
- Fix SIM105 try-except-pass patterns (contextlib.suppress)
- Fix nested with statements in tests
- Fix unused loop variables
Run 'uv run pytest' to verify tests still pass.
2026-03-15 15:16:37 -07:00
9201117096
feat: modernize project with uv, add pytest test suite
...
- Add pyproject.toml with modern Python packaging (PEP 517/518)
- Add uv-based dependency management replacing inline venv bootstrap
- Add requirements.txt and requirements-dev.txt for compatibility
- Add mise.toml with dev tasks (test, lint, run, sync, ci)
- Add .python-version pinned to Python 3.12
- Add comprehensive pytest test suite (73 tests) for:
- engine/config, filter, terminal, sources, mic, ntfy modules
- Configure pytest with coverage reporting (16% total, 100% on tested modules)
- Configure ruff for linting with Python 3.10+ target
- Remove redundant venv bootstrap code from mainline.py
- Update .gitignore for uv/venv artifacts
Run 'uv sync' to install dependencies, 'uv run pytest' to test.
2026-03-15 15:16:37 -07:00
d758541156
Merge pull request 'feat: migrate Ntfy message retrieval from polling to SSE streaming, replacing poll_interval with reconnect_delay for continuous updates.' ( #20 ) from feat/ntfy-sse into main
...
Reviewed-on: #20
2026-03-15 20:50:08 +00:00
b979621dd4
Merge branch 'main' into feat/ntfy-sse
2026-03-15 20:50:02 +00:00
f91cc9844e
Merge pull request 'feat: add new font files to the fonts directory' ( #19 ) from feat/display into main
...
Reviewed-on: #19
2026-03-15 20:47:16 +00:00
bddbd69371
Merge branch 'main' into feat/display
2026-03-15 20:45:54 +00:00
6e39a2dad2
feat: migrate Ntfy message retrieval from polling to SSE streaming, replacing poll_interval with reconnect_delay for continuous updates.
2026-03-15 13:44:26 -07:00
1ba3848bed
feat: add new font files to the fonts directory
2026-03-15 13:30:08 -07:00
a986df344a
Merge pull request 'doc: Document new font selection command-line arguments, environment variables, and a dedicated font management section.' ( #18 ) from docs/update-readme into main
...
Reviewed-on: #18
2026-03-15 11:08:25 +00:00
c84bd5c05a
doc: Document new font selection command-line arguments, environment variables, and a dedicated font management section.
2026-03-15 04:07:24 -07:00
7b0f886e53
Merge pull request 'feat: add new font assets including CSBishopDrawn, CyberformDemo, and KATA.' ( #17 ) from feat/font-picker into main
...
Reviewed-on: #17
2026-03-15 11:01:39 +00:00
9eeb817dca
Merge branch 'main' into feat/font-picker
2026-03-15 11:01:31 +00:00
ac80ab23cc
feat: add new font assets including CSBishopDrawn, CyberformDemo, and KATA.
2026-03-15 04:01:06 -07:00
516123345e
Merge pull request 'feat/font-picker' ( #16 ) from feat/font-picker into main
...
Reviewed-on: #16
2026-03-15 10:53:16 +00:00
11226872a1
feat: Implement interactive font selection by scanning the fonts/ directory for .otf, .ttf, and .ttc files, adding new fonts and updating documentation.
2026-03-15 03:52:10 -07:00
e6826c884c
feat: Implement an interactive font face picker at startup, allowing selection of specific font faces from a font file.
2026-03-15 03:38:14 -07:00
0740e34293
Merge pull request 'style: Replace escaped parentheses with standard parentheses in the Mainline Renderer documentation.' ( #15 ) from feat/scalability into main
...
Reviewed-on: #15
2026-03-15 10:03:42 +00:00
1e99d70387
Merge branch 'main' into feat/scalability
2026-03-15 10:03:34 +00:00
7098b2f5aa
Merge pull request 'feat: Introduce a complementary color gradient for queue messages.' ( #14 ) from feat/display into main
...
Reviewed-on: #14
2026-03-15 10:01:57 +00:00
e7de09be50
style: Replace escaped parentheses with standard parentheses in the Mainline Renderer documentation.
2026-03-15 02:58:38 -07:00
9140bfd32b
feat: Introduce a complementary color gradient for queue messages.
2026-03-15 02:44:38 -07:00
c49c0aab33
Merge pull request 'refactor: Change firehose from a drifting overlay to a fixed bottom strip and message display from a top-pinned section to a centered overlay.' ( #13 ) from drift into main
...
Reviewed-on: #13
2026-03-15 09:27:16 +00:00
66c13b5829
refactor: Change firehose from a drifting overlay to a fixed bottom strip and message display from a top-pinned section to a centered overlay.
2026-03-15 02:26:44 -07:00
