Render captured canvas snapshots through renderer boundary

docs/modernization/build-inventory.md

@@ -268,7 +268,11 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   plus the save-readiness report now consumed before retained live saves. For
   payload-complete or metadata-only snapshots, the same app-core boundary now
   exports through the pure `pp_document` PPI writer and reports generated byte
-  counts plus decoded dirty-face counts in `ppiExport` JSON. It is covered by
+  counts plus decoded dirty-face counts in `ppiExport` JSON. Payload-complete
+  snapshots also feed the active frame through the `pp_paint_renderer`
+  document-frame compositor and renderer-neutral recording upload path,
+  reporting texture, transition, command, byte, and active-frame payload counts
+  in `rendererUpload` JSON. It is covered by
   `pano_cli_plan_canvas_document_snapshot_smoke` plus the payload-bearing
   snapshot smoke.
 - `pano_cli save-document-project` writes that pure document export to a PPI

docs/modernization/capability-map.md

@@ -11,7 +11,7 @@ and validation command.
 
 | Capability | Current Area | Target Owner | Required Tests |
 | --- | --- | --- | --- |
-| PPI open/save | `Canvas`, serializer, dialogs | `pp_document`, `pp_assets`, `pano_cli` | Round-trip tiny project, old-version fixture, corrupt/truncated fixture, live-canvas-to-`pp_document` snapshot projection with captured RGBA8 payloads, pending renderer-readback counts, save-readiness reporting before retained live saves, and pure PPI export from payload-complete snapshots |
+| PPI open/save | `Canvas`, serializer, dialogs | `pp_document`, `pp_assets`, `pano_cli` | Round-trip tiny project, old-version fixture, corrupt/truncated fixture, live-canvas-to-`pp_document` snapshot projection with captured RGBA8 payloads, pending renderer-readback counts, save-readiness reporting before retained live saves, pure PPI export from payload-complete snapshots, and renderer-neutral active-frame upload from the same snapshot |
 | Open-document routing | `App::open_document` | `pp_app_core`, `pano_cli`, `pp_panopainter_ui`, `pp_document`, `pp_assets` | Project/ABR/PPBR route tests, malformed path tests, open-action plan tests, CLI route/action smoke, app open smoke |
 | Document session decisions | `App::open_document`, `App::request_close`, save hotkeys, file menu, dialogs | `pp_app_core`, `pano_cli`, `pp_panopainter_ui` | Clean/dirty/prompt-open/save/save-as/save-version/save-before-workflow/name/new-document resolution/overwrite/version-target decision tests, CLI session, new-document, document-file, and document-version smoke, app close/open/save/new/browse smoke |
 | Version metadata | `scripts/pre-build.py`, `version.*` | build system, `pp_foundation` | Generated header smoke test, missing-tag behavior |
@@ -26,7 +26,7 @@ and validation command.
 | 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, OpenGL command-plan coverage, six-face golden set |
+| 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 |
 | Depth export | `Canvas`, grid tools | `pp_paint_renderer` | Float/readback validation |
 
 ## Brush And Painting

docs/modernization/roadmap.md

@@ -674,7 +674,10 @@ prepare and log a payload-completeness report from that snapshot before
 delegating to retained `Canvas::project_save`; the app-core snapshot boundary
 also has a tested pure PPI export helper, and
 `pano_cli plan-canvas-document-snapshot` runs that helper for payload-complete
-snapshots and reports generated byte/dirty-face summaries. Live save writer
+snapshots and reports generated byte/dirty-face summaries. The same automation
+now feeds payload-complete snapshots through the `pp_paint_renderer`
+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`.
 `pano_cli plan-image-import` exposes app-core planning for File > Import image
@@ -2219,6 +2222,10 @@ Results:
   report (`payloadComplete` and `canExportPpi`) used by the live save bridge,
   and payload-complete snapshots now run the pure `pp_document` PPI exporter
   and decoded-project summary before emitting `ppiExport` JSON.
+- The same payload-complete snapshot automation now uploads the active document
+  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.
 - `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
@@ -2497,6 +2504,11 @@ Results:
   document-canvas tests decode the generated bytes, and
   `pano_cli plan-canvas-document-snapshot` reports `ppiExport` readiness,
   byte count, and dirty-face count for agent automation.
+- Payload-complete canvas snapshot automation also crosses the renderer
+  boundary now: `pano_cli plan-canvas-document-snapshot` records the same
+  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.
 - 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