MoonLight Scope — Original Release 3–10 Plan¶

This folder preserves the original Release 3–10 roadmap as planned after Release 2. The actual Release 3 ("Pixel Pipeline, MoonLight Effects, and Continuous Integration") replanned the sequence to address structural prerequisites first, then rebuild the pixel pipeline on MoonLight principles.

The original plan built the pixel pipeline incrementally over 8 releases. Several items from the original Release 3 were addressed in the actual Release 3; the rest remains the active forward roadmap.

Coverage Status¶

Doc	Original theme	Status
Release 3 (original)	Pixel Pipeline Foundations	Partially done — see below
Release 4 (original)	2D Effects and Layered Composition	Pending
Release 5 (original)	Modifiers and 3D	Pending
Release 6 (original)	Parallel Drivers and Scale	Pending
Release 7 (original)	Network Protocols and Multi-Device	Pending
Release 8 (original)	Audio-Reactive and Live Scripts	Pending
Release 9 (original)	DMX and Professional Lighting	Pending
Release 10 (original)	Operator UX and System Quality	Pending

What Has Been Done (from original Release 3 plan)¶

Original sprint	What was delivered	Where documented
R3 Sprint 1 — Test scripts + ESP32-S3-N16R8 + preview validation	Python deploy system (`deploy/`); both boards building, flashing, and passing live tests; `test_preview_e2e.cpp`	Release 3 Sprint 8
R3 Sprint 4/5 — PhysicalLayer / VirtualLayer pixel pipeline	`EffectsLayer` / `DriverLayer` with `Coord3D` coordinate system; 3D-ready `w×h×d` buffer; domain-agnostic `ProducerModule`/`ConsumerModule` base	Release 3 Sprints 3b, 5
R3 Sprint 6 — LayoutPanel (serpentine)	`GridLayout` physical coordinate mapping + serpentine wiring; `EffectsLayer` start/end persistence	Release 3 Sprint 6
R3 Sprint 8 — Effect framework + first effects	`SineEffect`, `RipplesEffect`, `LinesEffect` ported from MoonLight; `BrightnessModifier`	Release 3 Sprint 1
R3 Sprint 10 — Module simplification	`StatefulModule` audit; mandatory vs optional overrides; `setProps`/`setInput`/`loadState`/`saveState` rationalised	Release 3 Sprints 5, 7

Still Pending (from original Release 3 plan)¶

Sprint	What remains
R3 Sprint 2 — IO Module	Pin-assignment system; `IoModule` with pin-claim API
R3 Sprint 3 — Board Presets	JSON preset files per board; `POST /api/board`; auto-detection hint
R3 Sprint 7 — FastLED driver	`FastLedDriverModule`; real LEDs lighting up on ESP32-S3-N16R8
R3 Sprint 9 — LightsControl	Global on/off, brightness, RGB scale, BPM broadcast
R3 Sprint 10 — 500 FPS tuning + demo	Hot-path profiling; 500 FPS target on S3-N16R8; end-to-end LED demo