Prepare renderer snapshots before legacy exports

docs/modernization/build-inventory.md

@@ -275,6 +275,11 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   in `rendererUpload` JSON. It is covered by
   `pano_cli_plan_canvas_document_snapshot_smoke` plus the payload-bearing
   snapshot smoke.
+- Live equirectangular, layer, animation-frame, and cube-face export adapters
+  now prepare and log the same payload-bearing canvas document snapshot plus
+  renderer-neutral active-frame upload report before delegating to retained
+  `Canvas` export execution. Depth and video export remain on the older retained
+  path.
 - `pano_cli save-document-project` writes that pure document export to a PPI
   file and is covered by `pano_cli_save_document_project_roundtrip_smoke`,
   which inspects and loads the generated file.
@@ -1110,7 +1115,10 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   layers, animation-frame, depth, and cube-face export calls. It preserves
   platform-specific export messages, directory creation, picker-selected stem
   exports, Web prepared-file handoff, and legacy `Canvas` export execution while
-  retained renderer/document/platform ownership is tracked by `DEBT-0043`. It
+  retained renderer/document/platform ownership is tracked by `DEBT-0043`.
+  Equirectangular, layer, animation-frame, and cube-face execution now prepare
+  the document snapshot plus renderer-upload readiness report before those
+  retained calls; depth export remains on the older retained path. It
   also bridges timelapse and animation MP4 export picker-selected paths while
   preserving desktop worker-thread timelapse behavior, mobile/Web save
   callbacks, `App::rec_export`, animation `Canvas::export_anim_mp4`, and

docs/modernization/capability-map.md

@@ -24,9 +24,9 @@ and validation command.
 | Capability | Current Area | Target Owner | Required Tests |
 | --- | --- | --- | --- |
 | PNG/JPEG import | `Image`, `Canvas` import paths | `pp_assets`, `pp_document` | Fixture import, malformed file |
-| PNG/JPEG export | `Canvas`, `Image`, export dialogs | `pp_assets`, `pp_paint_renderer`, `pp_app_core` | Golden output tolerance, export start/target planning tests |
-| Equirectangular import/export | `Canvas`, shaders, RTT, export dialogs | `pp_paint_renderer`, `pp_app_core` | Tiny cube/equirect golden, app-core file target tests |
-| Cube face export | `Canvas` | `pp_paint_renderer` | Pure six-face document frame composite, renderer texture-upload bridge, payload-complete canvas-snapshot renderer-upload automation, OpenGL command-plan coverage, six-face golden set |
+| PNG/JPEG export | `Canvas`, `Image`, export dialogs | `pp_assets`, `pp_paint_renderer`, `pp_app_core` | Golden output tolerance, export start/target planning tests, live export-adapter document snapshot readiness |
+| Equirectangular import/export | `Canvas`, shaders, RTT, export dialogs | `pp_paint_renderer`, `pp_app_core` | Tiny cube/equirect golden, app-core file target tests, live export-adapter renderer-upload readiness |
+| Cube face export | `Canvas` | `pp_paint_renderer` | Pure six-face document frame composite, renderer texture-upload bridge, payload-complete canvas-snapshot renderer-upload automation, live export-adapter renderer-upload readiness, OpenGL command-plan coverage, six-face golden set |
 | Depth export | `Canvas`, grid tools | `pp_paint_renderer` | Float/readback validation |
 
 ## Brush And Painting

docs/modernization/roadmap.md

@@ -680,6 +680,10 @@ document-frame compositor and renderer-neutral recording upload path, reporting
 texture, transition, byte, payload, and command counts. Live save writer
 replacement, export adoption, and renderer-owned readback remain under
 `DEBT-0010`/`DEBT-0013`/`DEBT-0036`.
+Live equirectangular, layer, animation-frame, and cube-face export adapters now
+prepare the same payload-bearing document snapshot and renderer-neutral upload
+report before delegating to retained `Canvas` export execution, so export
+workflows consume the boundary without changing file output yet.
 `pano_cli plan-image-import` exposes app-core planning for File > Import image
 route decisions, including wide equirectangular images, legacy vertical cube
 strips, regular transform-placement images, and invalid image dimensions; live
@@ -2226,6 +2230,10 @@ Results:
   frame through `pp_paint_renderer::upload_document_frame_faces` and the
   `RecordingRenderDevice`, emitting `rendererUpload` JSON with texture,
   transition, command, byte, and active-frame payload counts.
+- Live equirectangular, layer, animation-frame, and cube-face export bridges now
+  capture the payload-bearing canvas document snapshot and run the
+  renderer-neutral upload report before retained `Canvas` export execution;
+  failures are logged and retained export still continues to preserve behavior.
 - `pp_app_core_document_import_tests` passed, covering wide equirectangular,
   legacy vertical cube strip, regular transform-placement, and invalid-dimension
   import route decisions, equirectangular service dispatch, transform import
@@ -2509,6 +2517,10 @@ Results:
   snapshot through the pure document-frame compositor and renderer-neutral
   texture upload stream, so agents can validate document/canvas payloads moving
   into renderer commands before live canvas export/save writer replacement.
+- Live image/collection/cube export adapters now prepare and log the same
+  document/canvas plus renderer-upload readiness before retained `Canvas`
+  export calls. Depth and video export remain on their prior retained paths;
+  actual image/cube writer replacement remains tracked under export debt.
 - Snapshot creation now rejects invalid embedded RGBA8 face payloads before
   document export or history can persist malformed state.
 - Package-smoke wrappers validate the Windows CMake app executable/runtime