Plan clipboard text actions in app core

docs/modernization/build-inventory.md

@@ -440,6 +440,10 @@ Known local toolchain state:
 - `pano_cli plan-cursor-visibility` exposes `pp_app_core` cursor visibility
   planning as JSON for hidden and visible states; live canvas cursor requests
   consume the same contract before retained desktop platform cursor bridges.
+- `pano_cli plan-clipboard-read` and `pano_cli plan-clipboard-write` expose
+  `pp_app_core` clipboard text planning as JSON, including empty text writes;
+  live clipboard get/set requests consume the same contracts before retained
+  platform clipboard bridges.
 - `pano_cli plan-cloud-upload` exposes `pp_app_core` cloud upload availability,
   new-document warning, publish prompt, and save-before-upload planning as JSON;
   the live cloud upload command consumes the same start contract before
@@ -474,7 +478,8 @@ Known local toolchain state:
   and non-empty picked-path callback planning, plus empty/non-empty display-file
   planning before platform picker/display callbacks, plus virtual keyboard
   show/hide planning before platform keyboard callbacks, plus cursor visibility
-  planning before platform cursor callbacks.
+  planning before platform cursor callbacks, plus clipboard read/write
+  planning before platform clipboard callbacks.
 - `pp_app_core_document_cloud_tests` covers cloud upload no-canvas,
   new-document warning, clean publish prompt, and dirty save-before-upload
   decisions, plus cloud browse no-canvas/show-browser and selected-download

docs/modernization/capability-map.md

@@ -67,7 +67,7 @@ and validation command.
 | --- | --- | --- | --- |
 | Mouse/keyboard/touch/gestures/cursor | `App`, platform entrypoints | `pp_app_core`, `pp_platform_*`, app | Cursor visibility decision tests, synthetic event playback |
 | Wacom pressure | `WacomTablet` | `pp_platform_windows` | Adapter smoke with fallback |
-| Clipboard/file picker/share/display | `App` platform methods | `pp_app_core`, `pp_platform_*` | Share saved-path, picked-path, and display-file decision tests, platform smoke or mocked service |
+| Clipboard/file picker/share/display | `App` platform methods | `pp_app_core`, `pp_platform_*` | Clipboard read/write, share saved-path, picked-path, and display-file decision tests, platform smoke or mocked service |
 | Virtual keyboard | `App`, platform entrypoints | `pp_app_core`, `pp_platform_*` | Keyboard visibility decision tests, platform smoke |
 | OpenVR desktop | `HMD`, `Vive`, `app_vr` | `pp_platform_vr`, app | Compile gate and mocked pose tests |
 | Quest/OVR | Android Quest files | `pp_platform_android_quest` | Compile/package gate |

docs/modernization/debt.md

@@ -34,6 +34,7 @@ agent or engineer to remove them without reconstructing context from chat.
 | DEBT-0013 | Open | Modernization | `pp_assets`, `pp_document`, `pano_cli inspect-project`, `pano_cli load-project`, and `pano_cli save-project` validate the fixed PPI header, thumbnail/body byte layout, generated multi-layer/multi-frame PPI writing with explicit layer opacity/blend/alpha-lock/visibility metadata, per-layer frame durations, metadata-only and targeted dirty-face-payload save/load round-trips, layer/frame index, dirty-face descriptors, dirty-face PNG payload metadata, asset-level RGBA PNG payload decoding, pure document-to-PPI export, CLI document export automation, file-writing document export automation, stroke-script-generated document payload export, and decoded pixel attachment to `pp_document`, but full legacy PPI round-trip parity is not yet extracted | Full PPI save parity requires staged extraction of legacy `Canvas` serialization and image/layer payload handling | `ctest --preset desktop-fast --build-config Debug`; `pp_assets_image_pixels_tests`; `pp_assets_ppi_header_tests`; `pp_document_ppi_import_tests`; `pp_document_ppi_export_tests`; `pano_cli_inspect_project_layout_smoke`; `pano_cli_load_project_metadata_smoke`; `pano_cli_save_project_roundtrip_smoke`; `pano_cli_save_project_payload_roundtrip_smoke`; `pano_cli_simulate_document_export_smoke`; `pano_cli_save_document_project_roundtrip_smoke`; `pano_cli_apply_stroke_script_roundtrip_smoke`; `pano_cli_apply_stroke_script_rejects_tiny_canvas` | Full PPI load/save fixtures cover thumbnails, decoded layer face payloads attached to documents, frames, corrupt payloads, dirty-face payload saving, arbitrary legacy canvas payload/layout combinations, and legacy app round-trip compatibility |
 | DEBT-0014 | Open | Modernization | `windows-clangcl-asan` now configures as a headless Ninja/clang-cl preset and uses the release MSVC runtime required by ASan, but local builds still fail because installed clang-cl 18.1.8 is paired with VS 2026-preview STL headers that require Clang 20 or newer | Sanitizer validation should be local and repeatable, but this machine's compiler/header pairing is incompatible | `cmake --fresh --preset windows-clangcl-asan`; `cmake --build --preset windows-clangcl-asan --target pp_foundation` | Install/use Clang 20+ with the VS 2026 STL, or point the preset at a compatible VS 2022 toolchain, then make `platform-build.ps1 -Presets windows-clangcl-asan` pass for the headless matrix |
 | DEBT-0015 | Open | Modernization | Cursor visibility requests now consume pure `pp_app_core` planning through `pano_cli plan-cursor-visibility`, but live cursor execution still reaches retained Win32/macOS platform bridges from `App::show_cursor` and `App::hide_cursor` | Keep canvas cursor behavior stable while platform shells are extracted incrementally | `pp_app_core_document_platform_io_tests`; `pano_cli plan-cursor-visibility --visible`; `ctest --preset desktop-fast --build-config Debug` | Cursor visibility execution is owned by `pp_platform_*` services and live app code depends on an injected platform interface instead of direct singleton/platform calls |
+| DEBT-0016 | Open | Modernization | Clipboard get/set requests now consume pure `pp_app_core` planning through `pano_cli plan-clipboard-read` and `pano_cli plan-clipboard-write`, but live clipboard execution still reaches retained Win32/Apple/Android platform bridges from `App::clipboard_get_text` and `App::clipboard_set_text` | Keep picker/color text clipboard behavior stable while platform shells are extracted incrementally | `pp_app_core_document_platform_io_tests`; `pano_cli plan-clipboard-write --text #ff00aa`; `ctest --preset desktop-fast --build-config Debug` | Clipboard execution is owned by `pp_platform_*` services and live app code depends on an injected platform interface instead of direct singleton/platform calls |
 
 ## Closed Debt
 

docs/modernization/roadmap.md

@@ -463,6 +463,9 @@ mobile platform keyboard bridges continue.
 `pano_cli plan-cursor-visibility` exposes the app-core cursor visibility
 decision used by live canvas cursor requests before retained desktop platform
 cursor bridges continue.
+`pano_cli plan-clipboard-read` and `pano_cli plan-clipboard-write` expose the
+app-core clipboard text decisions used by live clipboard get/set requests
+before retained platform clipboard bridges continue.
 `pano_cli plan-cloud-upload` exposes the app-core cloud upload decision used by
 the live cloud upload command for missing-canvas, new-document warning, publish
 prompt, and dirty-document save-before-upload states before legacy UI, canvas,
@@ -954,6 +957,7 @@ Results:
   callbacks, plus empty/non-empty display-file planning before platform
   display callbacks, plus virtual keyboard show/hide planning before platform
   keyboard callbacks, plus cursor visibility planning before platform cursor
+  callbacks, plus clipboard read/write planning before platform clipboard
   callbacks.
 - `pano_cli_plan_picked_path_empty_smoke` and
   `pano_cli_plan_picked_path_selected_smoke` passed and expose app-core picker
@@ -967,6 +971,10 @@ Results:
 - `pano_cli_plan_cursor_visibility_hidden_smoke` and
   `pano_cli_plan_cursor_visibility_visible_smoke` passed and expose app-core
   cursor visibility decisions as JSON.
+- `pano_cli_plan_clipboard_read_smoke`,
+  `pano_cli_plan_clipboard_write_smoke`, and
+  `pano_cli_plan_clipboard_write_empty_smoke` passed and expose app-core
+  clipboard decisions as JSON, including empty write text.
 - `panopainter_validate_shaders` passed, validating 25 shader programs and 7
   shader includes for stage markers and include graph integrity.
 - `pp_renderer_gl_capabilities_tests` passed on default MSVC, vcpkg-headless,