Fixes

docs/ARCHITECTURE_RESILIENCE_REVIEW.md

@@ -266,8 +266,8 @@ Status: addressed by Phase 6.
 Relevant current `RenderCadenceCompositor` code:
 
 - `src/app/RuntimeLayerControllerControls.cpp`
-- `src/runtime/RuntimeStatePersistence.cpp`
-- `src/runtime/RuntimeStatePersistence.h`
+- `src/runtime/state/RuntimeStatePersistence.cpp`
+- `src/runtime/state/RuntimeStatePersistence.h`
 
 Runtime-state persistence now flows from accepted durable layer-stack mutations into a debounced background writer. The layer controller owns the current snapshot source, while `RuntimeStatePersistenceWriter` owns serialization, temp-file replacement, coalescing, result reporting, and shutdown flushing.
 

docs/CURRENT_SYSTEM_ARCHITECTURE.md

@@ -21,10 +21,16 @@ The app is a native C++ OpenGL compositor with:
 Primary source areas:
 
 - `src/app`: startup/shutdown orchestration, config loading, runtime layer controller
-- `src/render`: render thread, readback, runtime GL scene, shared-context shader prepare worker
+- `src/render`: cadence clock, input texture upload, simple renderer, readback, and runtime GL support
+- `src/render/thread`: render thread lifecycle, cadence loop, metrics, and runtime shader commit mailbox
+- `src/render/runtime`: render-thread-owned runtime shader scene, renderer, text texture upload cache, and shared-context shader prepare worker
 - `src/frames`: system-memory frame exchange
 - `src/video`: DeckLink input/output edges and scheduling
-- `src/runtime`: shader catalog support, layer model, Slang build bridge, font atlas build, runtime-state persistence
+- `src/runtime/catalog`: supported shader catalog and package filtering
+- `src/runtime/layers`: app-side runtime layer model, restore, reload, and render snapshot construction
+- `src/runtime/shader`: background Slang build bridge and prepared shader artifact types
+- `src/runtime/state`: runtime JSON helpers, parameter normalization, and debounced runtime-state persistence
+- `src/runtime/text`: MSDF/MTSDF font atlas build and CPU-side prepared text texture composition
 - `src/control`: HTTP routing, command parsing, OpenAPI state JSON
 - `src/preview`: optional non-consuming preview window
 - `src/telemetry` and `src/logging`: runtime observation and logging

docs/NEW_RENDER_CADENCE_APP_PLAN.md

@@ -123,16 +123,18 @@ apps/RenderCadenceCompositor/
     Win32Console.h
 
   render/
-    RenderThread.cpp
-    RenderThread.h
+    thread/
+      RenderThread.cpp
+      RenderThread.h
     RenderCadenceClock.cpp
     RenderCadenceClock.h
     SimpleMotionRenderer.cpp
     SimpleMotionRenderer.h
-    Bgra8ReadbackPipeline.cpp
-    Bgra8ReadbackPipeline.h
-    PboReadbackRing.cpp
-    PboReadbackRing.h
+    readback/
+      Bgra8ReadbackPipeline.cpp
+      Bgra8ReadbackPipeline.h
+      PboReadbackRing.cpp
+      PboReadbackRing.h
 
   frames/
     SystemFrameExchange.cpp