Epic: Render Pipeline #306

New issue

Open

opened 2026-03-16 01:59:26 +00:00 by freemo · 0 comments

freemo commented

2026-03-16 01:59:26 +00:00

Owner

Background and Context

The Terminal UI Framework (#112) needs a render pipeline that transforms RenderOps into actual terminal output. The pipeline processes ops through multiple stages — routing, formatting, layout, dirty checking, ncurses rendering, and compositing — to produce efficient, flicker-free terminal updates. The pipeline targets 20 FPS with dirty-checking optimization and supports a headless mode for testing.

Expected Behavior

RenderOps drained from the render queue flow through a 6-stage pipeline that ultimately produces ncurses screen updates. The pipeline is designed for efficiency (skip unchanged windows), correctness (proper layout solving), and testability (headless renderer for tests).

Acceptance Criteria

A 6-stage render pipeline processes RenderOps into terminal output.
Render loop targets 20 FPS with dirty checking optimization.
A HeadlessRenderer enables terminal-free UI testing.
All child issues are completed, reviewed, and merged.

Child Issues

All child issues for this epic are tracked as individual issues with dependency links.

Definition of Done

This issue is complete when all child issues are merged to master and the Render Pipeline is operational.

## Background and Context The Terminal UI Framework (#112) needs a render pipeline that transforms RenderOps into actual terminal output. The pipeline processes ops through multiple stages — routing, formatting, layout, dirty checking, ncurses rendering, and compositing — to produce efficient, flicker-free terminal updates. The pipeline targets 20 FPS with dirty-checking optimization and supports a headless mode for testing. ## Expected Behavior RenderOps drained from the render queue flow through a 6-stage pipeline that ultimately produces ncurses screen updates. The pipeline is designed for efficiency (skip unchanged windows), correctness (proper layout solving), and testability (headless renderer for tests). ## Acceptance Criteria - [ ] A 6-stage render pipeline processes RenderOps into terminal output. - [ ] Render loop targets 20 FPS with dirty checking optimization. - [ ] A HeadlessRenderer enables terminal-free UI testing. - [ ] All child issues are completed, reviewed, and merged. ## Child Issues All child issues for this epic are tracked as individual issues with dependency links. ## Definition of Done This issue is complete when all child issues are merged to `master` and the Render Pipeline is operational.