diff --git a/cmake/PanoPainterPackageTargets.cmake b/cmake/PanoPainterPackageTargets.cmake index a4f3013..2fadb1e 100644 --- a/cmake/PanoPainterPackageTargets.cmake +++ b/cmake/PanoPainterPackageTargets.cmake @@ -34,3 +34,10 @@ pp_add_powershell_automation_target(panopainter_android_native_package_smoke -ReadinessOnly -AndroidNativeChecks -PackageKinds android-standard-apk,android-quest-apk,android-focus-apk) + +pp_add_powershell_automation_target(panopainter_linux_webgl_package_readiness + COMMENT "Report retained Linux and WebGL package readiness blockers." + ARGUMENTS + -File "${CMAKE_CURRENT_SOURCE_DIR}/scripts/automation/package-smoke.ps1" + -ReadinessOnly + -PackageKinds linux-app,webgl) diff --git a/docs/modernization/build-inventory.md b/docs/modernization/build-inventory.md index 82ce4ba..bbda723 100644 --- a/docs/modernization/build-inventory.md +++ b/docs/modernization/build-inventory.md @@ -81,6 +81,7 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -R powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly -AndroidNativeChecks -PackageKinds android-standard-apk,android-quest-apk,android-focus-apk cmake --build --preset windows-msvc-default --config Debug --target panopainter_windows_app_package_smoke cmake --build --preset windows-msvc-default --config Debug --target panopainter_android_native_package_smoke +cmake --build --preset windows-msvc-default --config Debug --target panopainter_linux_webgl_package_readiness cmake --build --preset windows-msvc-default --config Debug --target panopainter_platform_build_android_assets cmake --fresh --preset windows-clangcl-asan python scripts/dev/clangd_nav.py symbols --file src/app_core/brush_ui.h --name execute_brush @@ -201,9 +202,10 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p `panopainter_windows_app_package_smoke`, `panopainter_android_standard_native_package`, `panopainter_android_vr_native_package_configure`, and - `panopainter_android_native_package_smoke`. These targets call the automation - scripts from CMake but do not convert APK/AppX/Apple/WebGL package outputs to - root CMake package targets yet. + `panopainter_android_native_package_smoke`, and + `panopainter_linux_webgl_package_readiness`. These targets call the + automation scripts from CMake but do not convert APK/AppX/Linux/Apple/WebGL + package outputs to root CMake package targets yet. - Root CMake exposes non-default platform validation targets: `panopainter_platform_build_headless`, `panopainter_platform_build_android_assets`, diff --git a/docs/modernization/debt.md b/docs/modernization/debt.md index dca7882..f36dfd9 100644 --- a/docs/modernization/debt.md +++ b/docs/modernization/debt.md @@ -274,6 +274,9 @@ agent or engineer to remove them without reconstructing context from chat. CMake entrypoint, with both PowerShell and shell wrappers reporting the retained Linux/WebGL CMake baseline prerequisite guarded by `panopainter_retained_platform_cmake_self_test`. +- 2026-06-05: DEBT-0011 was narrowed again. Root CMake now exposes + `panopainter_linux_webgl_package_readiness`, a filtered package-smoke target + for the retained Linux app and WebGL readiness blockers. - 2026-06-05: DEBT-0011 was narrowed again. `package-smoke.ps1` now has `-AndroidNativeChecks`, which invokes the retained Android standard `native-lib` build and Quest/Focus configure helper for selected Android @@ -328,7 +331,7 @@ agent or engineer to remove them without reconstructing context from chat. | DEBT-0008 | Open | Modernization | `windows-msvc-default` preset is used for local validation because the VS 2026 generator is not installed here | The target VS 2026 preset must remain, but this machine configures with Visual Studio 17 2022 | `cmake --preset windows-msvc-default`; `ctest --preset desktop-fast --build-config Debug` | Validate `windows-vs2026-x64` on a machine with Visual Studio 2026 installed and make it the default Windows validation preset | | DEBT-0009 | Open | Modernization | Android root CMake validation currently builds headless targets only, while retained standard/Quest/Focus package CMake paths now have a refreshed CMake 3.10/C++23 baseline outside root CMake; automation queries `sdkmanager`, installs newer or missing SDK Manager NDK/CMake packages, selects the resulting pair before configure, and reports update decisions; root CMake exposes non-default platform-build and retained native package validation targets | Platform app entrypoints still live in legacy Gradle/CMake projects and need Phase 6 alignment | `powershell -ExecutionPolicy Bypass -File scripts\automation\platform-build.ps1 -Presets android-arm64`; `cmake --build --preset android-x64`; `cmake --build --preset android-quest-arm64`; `cmake --build --preset android-focus-arm64`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_platform_build_android_assets`; `powershell -ExecutionPolicy Bypass -File scripts\automation\android-legacy-package-build.ps1 -Packages standard`; `powershell -ExecutionPolicy Bypass -File scripts\automation\android-legacy-package-build.ps1 -Packages quest,focus -ConfigureOnly`; `powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly -AndroidNativeChecks -PackageKinds android-standard-apk,android-quest-apk,android-focus-apk`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_android_native_package_smoke` | Android standard, Quest, and Focus/Wave package targets consume shared component targets and have package smoke commands | | DEBT-0010 | Open | Modernization | `pp_document` is a pure layer/frame/document/undo-history model with alpha-lock metadata, snapshot construction, per-layer frame metadata, renderer-free RGBA8 face payload storage, snapshot-embedded face-payload validation, renderer-free alpha8 selection-mask storage, PPI import/export helpers, and stroke-script-to-face-payload CLI automation, but it is not yet wired to legacy `Canvas`, legacy save, or legacy action commands | Keep extraction incremental while preserving app behavior | `ctest --preset desktop-fast --build-config Debug`; `pano_cli create-document --width 64 --height 32 --layers 2`; `pano_cli load-project --path tests\data\projects\minimal-project.ppi`; `pp_document_tests`; `pp_document_ppi_import_tests`; `pp_document_ppi_export_tests`; `pano_cli_simulate_document_edits_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` | Legacy document behavior is represented by `pp_document` tests and the app consumes it through a boundary/facade | -| DEBT-0011 | Open | Modernization | `package-smoke` validates the Windows CMake app artifact and reports a structured package readiness matrix for Windows AppX, Android standard/Quest/Focus APKs, Apple bundles, Linux app output, and WebGL output; the Windows app smoke, retained Android package native CMake paths, and retained Linux/WebGL CMake baseline metadata are reachable from package validation, but Windows AppX/APK/Linux/Apple/WebGL package outputs are still `blocked` because root CMake package targets do not exist yet | Platform package targets are not migrated to root CMake yet | `powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -Preset windows-msvc-default -Configuration Debug`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_windows_app_package_smoke`; `powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly -AndroidNativeChecks -PackageKinds android-standard-apk,android-quest-apk,android-focus-apk`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_android_native_package_smoke`; `python scripts/dev/check_package_smoke_readiness.py`; `bash -n scripts/automation/package-smoke.sh` | Package-smoke builds and validates Windows AppX, Android APK variants, Linux app, Apple bundles, and WebGL output where local toolchains are present | +| DEBT-0011 | Open | Modernization | `package-smoke` validates the Windows CMake app artifact and reports a structured package readiness matrix for Windows AppX, Android standard/Quest/Focus APKs, Apple bundles, Linux app output, and WebGL output; the Windows app smoke, retained Android package native CMake paths, and retained Linux/WebGL CMake baseline metadata are reachable from package validation and root CMake package-readiness targets, but Windows AppX/APK/Linux/Apple/WebGL package outputs are still `blocked` because root CMake package targets do not exist yet | Platform package targets are not migrated to root CMake yet | `powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -Preset windows-msvc-default -Configuration Debug`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_windows_app_package_smoke`; `powershell -ExecutionPolicy Bypass -File scripts\automation\package-smoke.ps1 -ReadinessOnly -AndroidNativeChecks -PackageKinds android-standard-apk,android-quest-apk,android-focus-apk`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_android_native_package_smoke`; `cmake --build --preset windows-msvc-default --config Debug --target panopainter_linux_webgl_package_readiness`; `python scripts/dev/check_package_smoke_readiness.py`; `bash -n scripts/automation/package-smoke.sh` | Package-smoke builds and validates Windows AppX, Android APK variants, Linux app, Apple bundles, and WebGL output where local toolchains are present | | DEBT-0012 | Open | Modernization | `pp_ui_core` uses vcpkg tinyxml2 on `windows-msvc-vcpkg-headless`, but retains `pp_vendor_tinyxml2` for default and unproven platform presets | Mobile/AppX/Apple triplets and app packaging still need validation before removing the vendored fallback | `ctest --preset desktop-fast-vcpkg --build-config Debug`; `ctest --preset desktop-fast --build-config Debug`; `powershell -ExecutionPolicy Bypass -File scripts\automation\platform-build.ps1 -Presets android-arm64` | All supported presets consume vcpkg tinyxml2 or document a permanent vendored exception | | 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 | diff --git a/docs/modernization/roadmap.md b/docs/modernization/roadmap.md index c180a09..a544a6f 100644 --- a/docs/modernization/roadmap.md +++ b/docs/modernization/roadmap.md @@ -1410,9 +1410,11 @@ checks: `panopainter_package_readiness`, `panopainter_windows_app_package_smoke`, `panopainter_android_standard_native_package`, `panopainter_android_vr_native_package_configure`, and -`panopainter_android_native_package_smoke`. 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. +`panopainter_android_native_package_smoke`, plus the retained Linux/WebGL +blocker target `panopainter_linux_webgl_package_readiness`. 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. Retained Linux and WebGL app CMake entrypoints now match the interim platform baseline used by Android package paths: CMake 3.10 plus target-level `cxx_std_23`, with `panopainter_retained_platform_cmake_self_test` guarding @@ -2394,7 +2396,9 @@ Results: targets are migrated to 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, retained Linux/WebGL CMake metadata, and blocker - metadata aligned. + metadata aligned. Root CMake target + `panopainter_linux_webgl_package_readiness` now exposes the filtered retained + Linux/WebGL readiness matrix from the CMake target graph. - Android standard arm64/x64, Quest arm64, and Focus/Wave arm64 configure through the platform-build wrapper by default. Focused validation compiled representative headless component/tool targets across all four presets, and diff --git a/scripts/dev/check_package_smoke_readiness.py b/scripts/dev/check_package_smoke_readiness.py index dffbae4..afb6cb0 100644 --- a/scripts/dev/check_package_smoke_readiness.py +++ b/scripts/dev/check_package_smoke_readiness.py @@ -25,6 +25,7 @@ EXPECTED_CMAKE_PACKAGE_TARGETS = [ "panopainter_android_standard_native_package", "panopainter_android_vr_native_package_configure", "panopainter_android_native_package_smoke", + "panopainter_linux_webgl_package_readiness", ]