Merge Iris-on-Metal with upstream master safety fixes

.github/workflows/build.yml

@@ -8,15 +8,23 @@ run-name: ${{ github.ref_name }}
 on:
   workflow_dispatch:
   push:
+    branches:
+      - '**'
     tags:
       - 'v*'
+  pull_request:
+    branches:
+      - master
 
 permissions:
   contents: write
 
 jobs:
   build:
-    runs-on: macos-15
+    # Keep release artifacts tied to the current macOS 26 SDK and arm64 ABI.
+    # Hosted runners cannot serve as a visual or physical-GPU acceptance gate;
+    # build.gradle keeps those executions local while CI compiles their code.
+    runs-on: macos-26
     steps:
       - name: checkout repository
         uses: actions/checkout@v6
@@ -29,8 +37,35 @@ jobs:
           distribution: 'microsoft'
       - name: make gradle wrapper executable
         run: chmod +x ./gradlew
+      - name: select latest xcode
+        run: |
+          set -euo pipefail
+          echo "xcode-select current path: $(xcode-select -p)"
+          LATEST_XCODE=$(ls -d /Applications/Xcode*.app 2>/dev/null | sort -V | tail -1)
+          if [ -n "${LATEST_XCODE}" ]; then
+            echo "Selecting latest Xcode: ${LATEST_XCODE}"
+            sudo xcode-select -s "${LATEST_XCODE}"
+          fi
+          echo "xcode-select new path: $(xcode-select -p)"
+          echo "swiftc version: $(xcrun -f swiftc)"
+          echo "SDK path: $(xcrun --show-sdk-path)"
+          echo "MetalFX framework check:"
+          ls -la "$(xcrun --show-sdk-path)/System/Library/Frameworks/MetalFX.framework/Headers/" 2>/dev/null || echo "MetalFX headers not found at default SDK path"
+          echo "=== MTLFXSpatialScaler.h ==="
+          cat "$(xcrun --show-sdk-path)/System/Library/Frameworks/MetalFX.framework/Headers/MTLFXSpatialScaler.h" 2>/dev/null
+          echo "=== MTLFXTemporalScaler.h ==="
+          cat "$(xcrun --show-sdk-path)/System/Library/Frameworks/MetalFX.framework/Headers/MTLFXTemporalScaler.h" 2>/dev/null
+          echo "=== MTLFXFrameInterpolator.h ==="
+          cat "$(xcrun --show-sdk-path)/System/Library/Frameworks/MetalFX.framework/Headers/MTLFXFrameInterpolator.h" 2>/dev/null
       - name: build
-        run: ./gradlew buildMacNative build
+        # The hosted virtual GPU aborts in libMTLHud counter sampling even when
+        # Metal validation is disabled. CI therefore runs compilation and
+        # headless tests only; physical-GPU readbacks and CAMetalLayer visual
+        # acceptance are local release evidence.
+        run: >-
+          ./gradlew buildMacNative build
+          -x metalFrameGenerationPresentationValidation
+          -x metalFxOffscreenValidation
       - name: capture build artifacts
         uses: actions/upload-artifact@v7
         with:
@@ -41,6 +76,8 @@ jobs:
     needs: build
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
     runs-on: ubuntu-latest
+    env:
+      MODRINTH_TOKEN: ${{ secrets.MODRINTH_TOKEN }}
     steps:
       - name: checkout repository
         uses: actions/checkout@v6
@@ -72,9 +109,10 @@ jobs:
           echo "main_jar=${MAIN_JAR}" >> "$GITHUB_OUTPUT"
 
       - name: publish to Modrinth
+        if: env.MODRINTH_TOKEN != ''
         uses: cloudnode-pro/modrinth-publish@v2
         with:
-          token: ${{ secrets.MODRINTH_TOKEN }}
+          token: ${{ env.MODRINTH_TOKEN }}
           project: w79ASAJD
           version: ${{ steps.meta.outputs.version }}
           channel: alpha

.gitignore

@@ -41,3 +41,6 @@ replay_*.log
 /src/main/resources/natives/macos/*
 /src/main/resources/natives/ios/*
 libs/
+
+# stray client rotated logs at repo root (runClient cwd artifacts)
+logs/