feat: implement 6-stage render pipeline #317

Merged

freemo merged 2 commits from feature/m2-render-pipeline into master

2026-03-16 19:53:40 +00:00

freemo commented

2026-03-16 14:58:47 +00:00

Owner

Summary

Implements a modular 6-stage render pipeline that processes RenderOps into terminal output
Each stage (Router, Formatter, Layout, Dirty Check, Ncurses, Composite) is a separate class for testability
Includes comprehensive unit and integration tests

Changes

New Files

lib/aethyr/core/render/render_pipeline.rb - Main orchestrator
lib/aethyr/core/render/pipeline_stages/router_stage.rb - Routes ops to target windows
lib/aethyr/core/render/pipeline_stages/formatter_stage.rb - Applies ANSI colors, word wrapping
lib/aethyr/core/render/pipeline_stages/layout_stage.rb - Solves layout constraints
lib/aethyr/core/render/pipeline_stages/dirty_check_stage.rb - Compares frames, marks clean windows
lib/aethyr/core/render/pipeline_stages/ncurses_stage.rb - Writes to ncurses buffers
lib/aethyr/core/render/pipeline_stages/composite_stage.rb - Calls doupdate per frame

Tests

tests/unit/render_pipeline.feature - 30 unit test scenarios
tests/integration/render_pipeline_integration.feature - 10 integration scenarios

Testing

All 40 new test scenarios pass
Rubocop passes with no offenses

Closes #307

## Summary - Implements a modular 6-stage render pipeline that processes RenderOps into terminal output - Each stage (Router, Formatter, Layout, Dirty Check, Ncurses, Composite) is a separate class for testability - Includes comprehensive unit and integration tests ## Changes ### New Files - `lib/aethyr/core/render/render_pipeline.rb` - Main orchestrator - `lib/aethyr/core/render/pipeline_stages/router_stage.rb` - Routes ops to target windows - `lib/aethyr/core/render/pipeline_stages/formatter_stage.rb` - Applies ANSI colors, word wrapping - `lib/aethyr/core/render/pipeline_stages/layout_stage.rb` - Solves layout constraints - `lib/aethyr/core/render/pipeline_stages/dirty_check_stage.rb` - Compares frames, marks clean windows - `lib/aethyr/core/render/pipeline_stages/ncurses_stage.rb` - Writes to ncurses buffers - `lib/aethyr/core/render/pipeline_stages/composite_stage.rb` - Calls doupdate per frame ### Tests - `tests/unit/render_pipeline.feature` - 30 unit test scenarios - `tests/integration/render_pipeline_integration.feature` - 10 integration scenarios ## Testing - All 40 new test scenarios pass - Rubocop passes with no offenses Closes #307

freemo added 2 commits

2026-03-16 14:58:48 +00:00

feat: implement RenderOp data model and core RenderOp types 4edb789734

Implements the RenderOp value object class for the UI render pipeline as
specified in issue #304. RenderOps are immutable value objects that describe
rendering instructions without specifying how they should be rendered.

Key features:
- Immutable value objects (frozen after creation) with type, window, and data
- Seven core RenderOp types: text_append, map_refresh, bar_update,
  prompt_update, window_clear, overlay_show, overlay_hide
- Factory methods for convenient construction: RenderOp.text_append(),
  RenderOp.bar_update(), etc.
- Data validation per type (required fields are enforced)
- Equality comparison support (== and hash for use as hash keys)
- to_h serialization for logging and debugging
- Comprehensive YARD documentation

Testing:
- 36 Cucumber scenarios covering all factory methods, immutability,
  validation, equality, and type constants
- 3 integration scenarios for realistic usage patterns

ISSUES CLOSED: #304

feat: implement 6-stage render pipeline 8660214653

Implement a modular 6-stage render pipeline that processes RenderOps
into terminal output:

1. Router - Routes ops to target windows, groups by window
2. Formatter - Applies ANSI colors, word wrapping to window width
3. Layout - Solves layout constraints for window positions/sizes
4. Dirty Check - Compares against previous frame, marks clean windows
5. Ncurses - Writes dirty windows to ncurses buffers (wnoutrefresh)
6. Composite - Calls doupdate once per frame

Each stage is a separate class for testability. The pipeline handles
empty op batches gracefully (no-op frame) and supports terminal resize.

Includes unit tests covering all 6 stages and integration tests for
the full pipeline flow.