Add package readiness automation guard

docs/modernization/build-inventory.md

@@ -74,6 +74,7 @@ ctest --preset desktop-fast-vcpkg --build-config Debug
 cmake --preset android-arm64
 powershell -ExecutionPolicy Bypass -File scripts\automation\platform-build.ps1 -Presets android-arm64
 powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -Preset windows-msvc-default -Configuration Debug
+powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly
 cmake --fresh --preset windows-clangcl-asan
 python scripts/dev/clangd_nav.py symbols --file src/app_core/brush_ui.h --name execute_brush
 python scripts/dev/clangd_nav.py symbols --file src/app_core/brush_ui.h --name-regex "execute_.*preset"
@@ -82,6 +83,7 @@ python scripts/dev/clangd_nav.py definition --file src/node_panel_brush.cpp --li
 python scripts/dev/clangd_nav.py references --file src/app_core/brush_ui.h --line 783 --column 45 --path-regex "src[\\/]app_core"
 python scripts/dev/clangd_nav.py self-test
 python scripts/dev/check_platform_build_targets.py
+python scripts/dev/check_package_smoke_readiness.py
 ```
 
 Known local toolchain state:
@@ -143,6 +145,14 @@ Known local toolchain state:
   `panopainter_platform_build_target_matrix_self_test`, verifies the PowerShell
   and shell wrapper defaults include every current CMake test executable plus
   the required component and `pano_cli` targets.
+- `package-smoke.ps1 -ReadinessOnly` and `package-smoke.sh --readiness-only`
+  emit the Windows AppX, Android standard/Quest/Focus APK, Apple bundle, and
+  WebGL package readiness matrix without first building an app artifact. The
+  full package smoke command still builds/checks the selected app target before
+  reporting the same readiness matrix. `scripts/dev/check_package_smoke_readiness.py`,
+  registered as `panopainter_package_smoke_readiness_self_test`, verifies both
+  wrappers keep the same six package kinds, blocked DEBT-0011 status, and
+  readiness-only mode.
 - Root CMake exposes named `fuzz` and `stress` CTest presets. `fuzz` currently
   runs deterministic parser/serializer edge tests for binary streams, image
   metadata, PPI, stroke scripts, and layout XML; `stress` currently runs the

docs/modernization/debt.md

@@ -1,7 +1,7 @@
 # Modernization Debt Log
 
 Status: live
-Last updated: 2026-06-04
+Last updated: 2026-06-05
 
 Every shortcut, temporary adapter, retained vendored dependency, skipped
 platform gate, compatibility shim, or incomplete automation path must be
@@ -26,6 +26,12 @@ agent or engineer to remove them without reconstructing context from chat.
   the wrapper defaults against the current CMake test executables, so Android
   root CMake validation no longer silently skips newly extracted feature
   slices. Package targets remain open under DEBT-0009 and DEBT-0011.
+- 2026-06-05: DEBT-0011 was narrowed. `package-smoke.ps1` and
+  `package-smoke.sh` now have readiness-only modes that report the same
+  Windows AppX, Android standard/Quest/Focus APK, Apple bundle, and WebGL
+  blocker matrix without requiring an app build first, and
+  `panopainter_package_smoke_readiness_self_test` guards package-kind parity
+  across both wrappers. Package target migration remains open.
 - 2026-06-04: DEBT-0036 was narrowed again. Canvas stroke commit,
   thumbnail, and object-draw history paths now query saved blend state through
   tested `pp_renderer_gl` capability-state dispatch; CanvasLayer equirect

docs/modernization/roadmap.md

@@ -1263,9 +1263,12 @@ keeps the PowerShell and shell wrapper defaults aligned with every current
 CMake test executable plus required component targets.
 `package-smoke` now emits a structured package readiness matrix for Windows
 AppX, Android standard/Quest/Focus APKs, Apple bundles, and WebGL output, with
-blocked prerequisites tied to DEBT-0011. App/package entrypoints still need to
-consume shared targets and remain covered by debt until package validation is
-migrated from legacy package projects to root CMake.
+blocked prerequisites tied to DEBT-0011. It also has a readiness-only mode for
+cheap package blocker inventory without building an app artifact, and
+`panopainter_package_smoke_readiness_self_test` keeps the PowerShell and shell
+readiness matrices aligned. App/package entrypoints still need to consume
+shared targets and remain covered by debt until package validation is migrated
+from legacy package projects to root CMake.
 
 Implementation tasks:
 
@@ -1407,6 +1410,7 @@ ctest --preset desktop-fast-vcpkg --build-config Debug
 cmake --preset android-arm64
 powershell -ExecutionPolicy Bypass -File scripts\automation\platform-build.ps1 -Presets android-arm64
 powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -Preset windows-msvc-default -Configuration Debug
+powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly
 cmake --fresh --preset windows-clangcl-asan
 ```
 
@@ -2036,7 +2040,9 @@ Results:
   `data/` copy and report structured package readiness for AppX, Android
   standard/Quest/Focus APKs, Apple bundles, and WebGL outputs. Actual package
   building remains blocked by DEBT-0011 until those targets are migrated to
-  root CMake.
+  root CMake. Readiness-only mode now reports the same matrix without building
+  the app first, and the package readiness self-test keeps wrapper package
+  kinds aligned.
 - Android arm64 configured with NDK 29.0.14206865 through the platform-build
   wrapper and compiled the refreshed headless component/test matrix, including
   the current app-core feature-surface automation tests.