PS4 feasibility: ThreeNative experiments in the shadPS4 emulator (PRD-784)

.github/actions/native-engine-wasm/action.yml

@@ -44,8 +44,9 @@ runs:
           sh "$GITHUB_WORKSPACE/scripts/retry-download.sh" "$GITHUB_WORKSPACE/.cache/emsdk/emsdk" install "$TN_EMSDK_VERSION"
         fi
         "$GITHUB_WORKSPACE/.cache/emsdk/emsdk" activate "$TN_EMSDK_VERSION"
-        # The web engine reads three pinned sources: stb (images), cgltf (glTF) and libwebp.
-        for dependency in stb cgltf webp-source; do
+        # The web engine reads four pinned sources: stb (images), cgltf (glTF), libwebp and
+        # meshoptimizer (EXT/KHR_meshopt_compression in the same glTF loader).
+        for dependency in stb cgltf webp-source meshopt; do
           node scripts/download-deps.mjs --only "$dependency"
         done
         source "$GITHUB_WORKSPACE/.cache/emsdk/emsdk_env.sh"

.github/workflows/ci.yml

@@ -1564,8 +1564,9 @@ jobs:
         run: |
           set -euo pipefail
           ccache --zero-stats
-          # The core reads the web engine's pinned sources too (stb decodes SMAANode's tables).
-          for dependency in stb cgltf webp-source; do
+          # The core reads the web engine's pinned sources too (stb decodes SMAANode's tables), and
+          # the glTF loader decodes meshopt-compressed models with the pinned meshoptimizer.
+          for dependency in stb cgltf webp-source meshopt; do
             node scripts/download-deps.mjs --only "$dependency"
           done
           cmake -S . -B build/native-engine -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DTN_ENGINE_CORE_ONLY=ON

.github/workflows/integration.yml

@@ -73,6 +73,7 @@ jobs:
       native-assets: ${{ steps.filter.outputs.native-assets }}
       tone: ${{ steps.filter.outputs.tone }}
       vegetation: ${{ steps.filter.outputs.vegetation }}
+      playstation: ${{ steps.filter.outputs.playstation }}
       velocity: ${{ steps.filter.outputs.velocity }}
       world-capture: ${{ steps.filter.outputs.world-capture }}
       # PRD-620: the caller's admitted heavy slice, validated and re-emitted as safe JSON. Absent
@@ -109,6 +110,7 @@ jobs:
             velocity ^packages/core/src/renderProjection\.ts$|^packages/core/src/render/velocity\.ts$|^packages/core/src/render/batched-velocity\.ts$|^packages/core/__tests__/render-velocity\.spec\.ts$|^packages/core/__tests__/instance-velocity-upload\.spec\.ts$|^packages/core/__tests__/velocity-coverage-proof\.spec\.ts$|^packages/core/__tests__/skinned-velocity-bind-history\.spec\.ts$|^packages/core/patches/three@0\.185\.1\.patch$|^packages/playtest/.*$|^examples/abyss-framework/velocity-main\.ts$|^examples/abyss-framework/velocity-cost-main\.ts$|^examples/abyss-framework/velocity-cost\.html$|^examples/abyss-framework/src/render/velocityCost\.ts$|^examples/abyss-framework/playtests/velocity-cost\.playtest\.json$|^scripts/__tests__/velocity-cost-proof\.spec\.ts$|^examples/abyss-framework/src/render/velocityReadback\.ts$|^examples/abyss-framework/src/render/velocityCoverage\.ts$|^examples/abyss-framework/velocity\.html$|^examples/abyss-framework/velocity\.vite\.config\.ts$|^examples/abyss-framework/velocity\.tsconfig\.json$|^examples/abyss-framework/playtests/velocity-history\.playtest\.json$|^scripts/verify-velocity-history\.ts$|^scripts/velocity-capture-proof\.ts$|^scripts/__tests__/velocity-capture-proof\.spec\.ts$|^pnpm-lock\.yaml$
             tone ^scripts/xvfb\.sh$|^packages/playtest/.*$|^examples/abyss-framework/src/render/toneCalibration\.ts$|^examples/abyss-framework/src/tone-main\.ts$|^examples/abyss-framework/tone\.html$|^examples/abyss-framework/tone\.vite\.config\.ts$|^examples/abyss-framework/playtests/tone\.playtest\.json$|^examples/abyss-framework/package\.json$|^scripts/verify-tone-exposure\.ts$|^scripts/tone-capture-proof\.ts$|^scripts/__tests__/tone-capture-proof\.spec\.ts$|^scripts/non-visual-scenarios\.mjs$|^package\.json$|^pnpm-lock\.yaml$|^\.github/actions/pnpm/.*$|^\.github/actions/playwright-chromium/.*$|^packages/create-threenative/(template-assets|templates/[^/]+/src/render)/(autoExposure|exposure|exposureGraph|exposureReadback|exposureSettings|worldEnvironment)\.ts$
             vegetation ^examples/integrations/vegetation/.*$
+            playstation ^packages/runtime-native/scripts/ps4/.*$|^packages/runtime-native/tests/ps4-[^/]*\.test\.mjs$|^packages/runtime-native/tests/fixtures/ps4-frames/.*$|^packages/runtime-native/cmake/ps4\.toolchain\.cmake$|^packages/runtime-native/src/platform/ps4_main\.cpp$
             world-capture ^packages/core/src/world[^/]*\.ts$|^packages/core/__tests__/world-capture-fixture\.spec\.ts$|^packages/playtest/.*$|^packages/assets/.*$|^examples/abyss-framework/src/scenes/WorldProbe\.ts$|^examples/abyss-framework/src/world-main\.ts$|^examples/abyss-framework/src/style\.css$|^examples/abyss-framework/assets/world/.*$|^examples/abyss-framework/index\.html$|^examples/abyss-framework/vite\.config\.ts$|^examples/abyss-framework/threenative\.config\.ts$|^examples/abyss-framework/playtests/phase477-world-capture\.playtest\.json$|^examples/abyss-framework/package\.json$|^scripts/verify-world-capture\.ts$|^scripts/world-capture-manifest\.ts$|^scripts/world-visual-gate\.ts$|^scripts/capture-guard\.ts$|^scripts/__tests__/verify-world-capture\.spec\.ts$|^scripts/__tests__/world-capture-manifest\.spec\.ts$|^scripts/__tests__/world-visual-gate\.spec\.ts$|^package\.json$|^pnpm-lock\.yaml$|^pnpm-workspace\.yaml$|^\.github/actions/pnpm/.*$|^\.github/actions/playwright-chromium/.*$
         run: |
           node scripts/ci-integration-scope.mjs
@@ -215,6 +217,44 @@ jobs:
           path: ${{ github.workspace }}/artifacts/ci-integration-receipts/${{ github.job }}.json
           if-no-files-found: error
 
+  # PRD-784: the PS4 visual parity lock, only when PS4 code changes. It checks the driver patches, the
+  # CPU mip chain and the region claims on the kept Cube Spin frames. PS4 code inside the engine tree
+  # (texture_copy.h, gamepads.cpp) selects the native-engine job instead, and the `test` job runs these
+  # same files. The emulator capture needs the OpenOrbis toolchain, a PS4 V8 build and shadPS4, which
+  # no runner has: it stays local (`run-experiment.mjs e5`, then `check-frame.mjs` on its screenshots).
+  playstation:
+    name: playstation
+    if: ${{ needs.paths.outputs.playstation == 'true' && !github.event.pull_request.draft }}
+    needs: paths
+    runs-on: ${{ (github.event.pull_request.head.repo.fork || !vars.TN_RUNNER || !contains(fromJSON(needs.paths.outputs.runner_admission || '[]'), 'integration:playstation')) && 'ubuntu-24.04' || vars.TN_RUNNER }}
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha }}
+      - uses: ./.github/actions/pnpm
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        with:
+          node-version: '22'
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile --filter @threenative/runtime-native
+      - name: PS4 parity lock (patches, CPU mip chain, Cube Spin frame claims)
+        working-directory: packages/runtime-native
+        run: pnpm exec vitest run --config vitest.config.ts tests/ps4-stage-guest-ui.test.mjs tests/ps4-frame-check.test.mjs
+      - name: Record exact current-attempt integration receipt
+        if: ${{ always() }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TN_CI_JOB_RESULT: ${{ job.status }}
+        run: node "$GITHUB_WORKSPACE/scripts/ci-integration-receipts.mjs" --write
+      - uses: actions/upload-artifact@v7
+        if: ${{ always() }}
+        with:
+          name: ci-integration-receipt-${{ github.run_id }}-${{ github.run_attempt }}-${{ inputs.candidate_sha }}-${{ github.job }}
+          path: ${{ github.workspace }}/artifacts/ci-integration-receipts/${{ github.job }}.json
+          if-no-files-found: error
+
   decals:
     name: decals
     if: ${{ needs.paths.outputs.decals == 'true' && !github.event.pull_request.draft }}
@@ -1094,7 +1134,7 @@ jobs:
 
   completion:
     name: Verify required integration receipts
-    needs: [paths, csg, ik, vegetation, decals, decals-native, tone, animation, animation-native, fog, fog-native, capture, fluid-collision, fluid-collision-native, packaged-quickjs, exposure, cold-boot, temporal, velocity]
+    needs: [paths, csg, ik, vegetation, playstation, decals, decals-native, tone, animation, animation-native, fog, fog-native, capture, fluid-collision, fluid-collision-native, packaged-quickjs, exposure, cold-boot, temporal, velocity]
     if: ${{ always() }}
     runs-on: ${{ (github.event.pull_request.head.repo.fork || !vars.TN_RUNNER_LIGHT) && 'ubuntu-24.04' || vars.TN_RUNNER_LIGHT }}
     # 5 was read off a quiet runner: 40534772948 (develop) collected in 3m35s. It has no headroom —