Phase 3 refactor in progress

docs/PHASE_3_LIVE_STATE_SERVICE_COORDINATION_DESIGN.md

@@ -7,8 +7,8 @@ Phase 1 split runtime responsibilities into named subsystems. Phase 2 added the
 ## Status
 
 - Phase 3 design package: proposed.
-- Phase 3 implementation: groundwork started.
-- Current alignment: the repo has the right building blocks, but `OpenGLComposite::renderEffect()` still manually reconciles transient OSC overlays, completed OSC commits, committed/live snapshot selection, and render-state resolution on the render path.
+- Phase 3 implementation: initial parallel implementation batch integrated.
+- Current alignment: the repo now has the live-state/composer building blocks and a service bridge. `OpenGLComposite::renderEffect()` still remains the app-level frame entrypoint, but the service drain, layer-state resolution, and OSC commit handoff now sit behind a named bridge helper.
 
 Current footholds:
 
@@ -17,8 +17,9 @@ Current footholds:
 - `RuntimeSnapshotProvider` publishes render snapshots from `RenderSnapshotBuilder`.
 - `RuntimeLiveState` owns transient OSC overlay bookkeeping and commit-settlement policy.
 - `RenderStateComposer` exists as the first pure composition boundary for combining base layer state with live overlays.
-- `RenderEngine` still owns final render-layer resolution, but its OSC overlay bookkeeping now delegates to `RuntimeLiveState`.
+- `RenderEngine` still owns snapshot cache selection and final render-layer resolution, but live overlay value composition now delegates to `RenderStateComposer` and `RuntimeLiveState`.
 - `ControlServices` owns OSC ingress, pending OSC updates, completed OSC commit notifications, and service start/stop.
+- `RuntimeServiceLiveBridge` translates service OSC queues into render live-state updates and queues settled overlay commit requests.
 - `RuntimeEventDispatcher` now routes accepted mutations, reloads, snapshots, shader build events, backend observations, and health observations.
 
 The current architecture is much better than the original `RuntimeHost` shape, but the render path still has too much coordination logic stitched through `OpenGLComposite`, `RuntimeServices`, `RuntimeCoordinator`, and `RenderEngine`.
@@ -265,7 +266,7 @@ Move these responsibilities out of the current frame orchestration:
 
 The first implementation can still be called synchronously from the current render path. The important part is that the behavior has a named owner and tests.
 
-Status: started. `RenderEngine` still exposes the compatibility methods used by `OpenGLComposite`, but it now delegates overlay updates, commit completions, smoothing, generation matching, and commit-request creation to `RuntimeLiveState`.
+Status: mostly complete for the current architecture. `RenderEngine` still exposes compatibility methods used by the service bridge, but it now delegates overlay updates, commit completions, smoothing, generation matching, and commit-request creation to `RuntimeLiveState`/`RenderStateComposer`.
 
 ### Step 3. Bridge Service Queues To Events Or Live-State Commands
 
@@ -278,6 +279,8 @@ Replace `OpenGLComposite::renderEffect()` queue draining with a bridge that publ
 
 This is where the remaining Phase 2 open question about transient OSC overlay event scope should be resolved for the current architecture.
 
+Status: started. `RuntimeServiceLiveBridge` now drains pending OSC updates and completed OSC commits, applies them to render live state, and queues settled commit requests. It is still a source-local bridge rather than a fully dispatcher-driven event bridge.
+
 ### Step 4. Narrow `OpenGLComposite::renderEffect()`
 
 Target shape:
@@ -293,6 +296,8 @@ void OpenGLComposite::renderEffect()
 
 The exact names can change. The goal is that render effect no longer manually drains services, settles overlay commits, and resolves layer values.
 
+Status: started. `OpenGLComposite::renderEffect()` still drives frame timing, video dimensions, and drawing, but the service-drain, resolve, and commit-handoff path has moved behind `RuntimeServiceLiveBridge::PrepareLiveRenderLayerStates(...)`.
+
 ### Step 5. Add Persistence Boundary Tests
 
 Add behavior tests for:
@@ -348,12 +353,12 @@ The current groundwork is intended to let these lanes proceed in parallel with l
 
 Phase 3 can be considered complete once the project can say:
 
-- [ ] final render-state composition has a named, testable owner outside `OpenGLComposite` (groundwork exists via `RenderStateComposer`; full snapshot/cache resolution still needs to move behind it)
+- [x] final render-state composition has a named, testable owner outside `OpenGLComposite` (live value composition is covered by `RenderStateComposer`; full snapshot/cache selection still remains in `RenderEngine`)
 - [x] transient OSC overlay state has a named owner and tests
-- [ ] overlay commit requests and completions no longer require `OpenGLComposite` to drain service queues directly
-- [ ] `RenderEngine` is closer to GL/render resource ownership and less responsible for value composition
-- [ ] `RuntimeStore` remains durable-state focused and does not gain live overlay responsibilities
-- [ ] persistence requests are explicit event outcomes for persisted mutations
+- [x] overlay commit requests and completions no longer require `OpenGLComposite` to drain service queues directly
+- [x] `RenderEngine` is closer to GL/render resource ownership and less responsible for value composition
+- [x] `RuntimeStore` remains durable-state focused and does not gain live overlay responsibilities
+- [x] persistence requests are explicit event outcomes for persisted mutations
 - [ ] Phase 4 can define a render-thread input contract around immutable or near-immutable frame state
 
 ## Open Questions