Add Apple remote compile gate

docs/modernization/build-inventory.md

@@ -84,6 +84,7 @@ python scripts/dev/clangd_nav.py references --file src/app_core/brush_ui.h --lin
 python scripts/dev/clangd_nav.py self-test
 python scripts/dev/check_platform_build_targets.py
 python scripts/dev/check_package_smoke_readiness.py
+powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.ps1 -Presets macos,ios-simulator,ios-device
 ```
 
 Known local toolchain state:
@@ -122,6 +123,23 @@ Known local toolchain state:
   results or `--allow-incomplete-references` for explicitly
   current-translation-unit-only results, and do not treat incomplete references
   as proof that no other users exist.
+- Apple headless compile validation runs on the local Mac mini SSH alias
+  `panopainter-mac` with user `builder`. The host uses a Gitea SSH key for
+  `ssh://git@git.omar.synology.me:3022/omar/panopainter.git`, Homebrew
+  CMake/Ninja/Git, and full Xcode selected per command with
+  `DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer`. The repeatable
+  Windows-side command is:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.ps1 -Presets macos,ios-simulator,ios-device
+```
+
+  The wrapper updates `~/Dev/panopainter`, initializes the source submodules
+  required by the headless CMake matrix, and delegates to
+  `scripts/automation/platform-build.sh`. macOS, iOS simulator, and iOS device
+  currently validate shared component/test/tool targets only; signed Apple app
+  bundles remain tracked by DEBT-0011 and the iOS compile-only signing shortcut
+  is tracked by DEBT-0059.
 - Android standard arm64/x64, Quest arm64, and Focus/Wave arm64 headless
   configure/build pass through root CMake and the `platform-build` automation
   wrapper defaults for `pp_foundation`, `pp_assets`,