ci.yml

name: CI

on:
  push:
    branches:
      - main
  pull_request:

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

env:
  CARGO_INCREMENTAL: "0"

jobs:
  rust:
    name: Rust lint and unit tests
    runs-on: macos-15
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.3.app/Contents/Developer

    steps:
      - uses: actions/checkout@v4

      - uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt, clippy

      - name: Install native build dependencies
        run: brew install pkg-config x264

      - name: Cache Rust build outputs
        uses: actions/cache@v4
        with:
          path: |
            ~/.cargo/git
            ~/.cargo/registry
            packages/server/target
          key: rust-${{ runner.os }}-${{ hashFiles('packages/server/Cargo.lock', 'packages/server/Cargo.toml', 'packages/server/build.rs', 'packages/server/src/**/*.rs', 'packages/server/native/**/*.m') }}
          restore-keys: |
            rust-${{ runner.os }}-

      - name: Check Rust formatting
        run: cargo fmt --manifest-path packages/server/Cargo.toml --check

      - name: Clippy
        run: cargo clippy --manifest-path packages/server/Cargo.toml --all-targets -- -D warnings

      - name: Rust unit tests
        run: cargo test --manifest-path packages/server/Cargo.toml

  client:
    name: Client lint, build, and tests
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
          cache-dependency-path: |
            package-lock.json
            packages/client/package-lock.json

      - name: Install root dependencies
        run: npm ci --ignore-scripts --force

      - name: Install client dependencies
        run: npm ci --prefix packages/client

      - name: Check Prettier formatting
        run: npx prettier --check .

      - name: Test studio provider bridge
        run: npm run test:studio-provider

      - name: Test integration harness helpers
        run: npm run test:integration-harness

      - name: Test workflow and CLI packaging guards
        run: npm run test:github-actions

      - name: Typecheck client
        run: npm run --prefix packages/client typecheck

      - name: Test client
        run: npm run --prefix packages/client test

      - name: Build client
        run: npm run --prefix packages/client build

  packages:
    name: Packages and VS Code extension
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
          cache-dependency-path: |
            package-lock.json
            packages/react-native-inspector/package-lock.json
            packages/nativescript-inspector/package-lock.json

      - name: Install root dependencies
        run: npm ci --ignore-scripts --force

      - name: Install NativeScript inspector dependencies
        run: npm ci --prefix packages/nativescript-inspector

      - name: Install React Native inspector dependencies
        run: npm ci --prefix packages/react-native-inspector

      - name: Build inspector and test packages
        run: npm run build:packages

      - name: Package VS Code extension
        run: npm run package:vscode-extension

  build-artifacts:
    name: Build integration artifacts
    runs-on: macos-15
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.3.app/Contents/Developer

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
          cache-dependency-path: |
            package-lock.json
            packages/client/package-lock.json

      - uses: dtolnay/rust-toolchain@stable

      - name: Install native build dependencies
        run: brew install pkg-config x264

      - name: Cache Rust build outputs and fixture app
        uses: actions/cache@v4
        with:
          path: |
            ~/.cargo/git
            ~/.cargo/registry
            packages/server/target
            .cache/simdeck/fixture
          key: rust-${{ runner.os }}-${{ hashFiles('packages/server/Cargo.lock', 'packages/server/Cargo.toml', 'packages/server/build.rs', 'packages/server/src/**/*.rs', 'packages/server/native/**/*.m', 'scripts/integration/fixture.mjs') }}
          restore-keys: |
            rust-${{ runner.os }}-

      - name: Install root dependencies
        run: npm ci --ignore-scripts

      - name: Install client dependencies
        run: npm ci --prefix packages/client

      - name: Build CLI, client, and JS test API
        run: |
          npm run build:cli
          npm run build:client
          npm run build:simdeck-test
          npm run test:integration:fixture

      - name: Upload integration artifacts
        uses: actions/upload-artifact@v4
        with:
          name: simdeck-integration-artifacts
          if-no-files-found: error
          include-hidden-files: true
          path: |
            build/simdeck
            build/simdeck-bin
            packages/client/dist
            packages/simdeck-test/dist
            .cache/simdeck/fixture

  integration-cli:
    name: CLI simulator integration
    runs-on: macos-15
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.3.app/Contents/Developer
    needs:
      - rust
      - client
      - packages
      - build-artifacts

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Download integration artifacts
        uses: actions/download-artifact@v4
        with:
          name: simdeck-integration-artifacts
          path: .

      - name: Make CLI executable
        run: chmod +x build/simdeck build/simdeck-bin

      - name: CLI simulator integration tests
        run: npm run test:integration:cli
        env:
          SIMDECK_INTEGRATION_VERBOSE: "1"

      - name: LaunchAgent service restart integration test
        run: npm run test:integration:service
        env:
          SIMDECK_INTEGRATION_LAUNCHAGENT: "1"

  integration-js-api:
    name: JS API simulator integration
    runs-on: macos-15
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.3.app/Contents/Developer
    needs:
      - rust
      - client
      - packages
      - build-artifacts

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Download integration artifacts
        uses: actions/download-artifact@v4
        with:
          name: simdeck-integration-artifacts
          path: .

      - name: Make CLI executable
        run: chmod +x build/simdeck build/simdeck-bin

      - name: JS API simulator integration tests
        run: npm run test:integration:js-api

  integration-webrtc:
    name: WebRTC stream benchmark
    runs-on: macos-15
    timeout-minutes: 20
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.3.app/Contents/Developer
    needs:
      - rust
      - client
      - packages
      - build-artifacts

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Download integration artifacts
        uses: actions/download-artifact@v4
        with:
          name: simdeck-integration-artifacts
          path: .

      - name: Make CLI executable
        run: chmod +x build/simdeck build/simdeck-bin

      - name: WebRTC software stream benchmark
        run: npm run test:integration:webrtc
        env:
          # The service still targets 60 fps at full device resolution. Hosted
          # macOS headless Chrome decode can dip under runner contention, so CI
          # gates 55+ received fps for the software stream plus a modest
          # hosted-browser decode floor. Local runs can keep 55+ fps thresholds.
          SIMDECK_E2E_MIN_DECODED_FPS: "18"
          SIMDECK_E2E_MIN_PRESENTED_FPS: "18"
          SIMDECK_E2E_MIN_RECEIVED_FPS: "55"
          SIMDECK_E2E_WEBRTC_MS: "20000"
          SIMDECK_INTEGRATION_DEVICE_TYPE: iPhone SE (3rd generation)

  integration-android:
    name: Android emulator integration (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    timeout-minutes: 65
    needs:
      - client
      - packages
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest]

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
          cache-dependency-path: package-lock.json

      - uses: dtolnay/rust-toolchain@stable

      - name: Enable KVM access
        if: runner.os == 'Linux'
        run: |
          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
          sudo udevadm control --reload-rules
          sudo udevadm trigger --name-match=kvm

      - name: Install root dependencies
        run: npm ci --ignore-scripts --force

      - name: Build Android integration artifacts
        run: |
          npm run build:cli
          npm run build:simdeck-test

      - name: Android emulator integration tests (Linux)
        if: runner.os == 'Linux'
        uses: reactivecircus/android-emulator-runner@v2
        with:
          api-level: 35
          target: google_apis
          arch: x86_64
          profile: pixel_6
          avd-name: SimDeck_Pixel_CI
          disable-animations: true
          emulator-options: -no-window -no-audio -no-boot-anim -no-snapshot -gpu swiftshader_indirect -grpc 8554
          script: npm run test:integration:android
        env:
          SIMDECK_INTEGRATION_ANDROID_AVD: SimDeck_Pixel_CI
          SIMDECK_INTEGRATION_REQUIRE_RUNNING_ANDROID: "1"
          SIMDECK_INTEGRATION_VERBOSE: "1"

      - name: Create, boot, and test Android emulator (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        timeout-minutes: 45
        run: |
          $ErrorActionPreference = "Stop"
          $sdk = $env:ANDROID_HOME
          if (-not $sdk) {
            $sdk = $env:ANDROID_SDK_ROOT
          }
          if (-not $sdk) {
            $sdk = Join-Path $env:LOCALAPPDATA "Android\Sdk"
          }
          $env:ANDROID_HOME = $sdk
          $env:ANDROID_SDK_ROOT = $sdk
          $cmdlineTools = Get-ChildItem -Path (Join-Path $sdk "cmdline-tools") -Directory -ErrorAction SilentlyContinue |
            Sort-Object Name -Descending |
            Select-Object -First 1
          $toolsBin = if (Test-Path (Join-Path $sdk "cmdline-tools\latest\bin")) {
            Join-Path $sdk "cmdline-tools\latest\bin"
          } elseif ($cmdlineTools) {
            Join-Path $cmdlineTools.FullName "bin"
          } else {
            Join-Path $sdk "tools\bin"
          }
          $sdkmanager = Join-Path $toolsBin "sdkmanager.bat"
          $avdmanager = Join-Path $toolsBin "avdmanager.bat"
          $adb = Join-Path $sdk "platform-tools\adb.exe"
          $emulator = Join-Path $sdk "emulator\emulator.exe"
          $windowsApi = "35"
          $windowsPlatform = "platforms;android-$windowsApi"
          $windowsSystemImage = "system-images;android-$windowsApi;google_atd;x86_64"

          $yesFile = Join-Path $env:RUNNER_TEMP "android-sdk-yes.txt"
          1..200 | ForEach-Object { "y" } | Set-Content -Path $yesFile -Encoding ascii
          $noFile = Join-Path $env:RUNNER_TEMP "android-avd-no.txt"
          "no" | Set-Content -Path $noFile -Encoding ascii

          function Invoke-AndroidToolWithInput($tool, $arguments, $inputFile) {
            $line = "`"$tool`" $arguments < `"$inputFile`""
            Write-Host "cmd /c $line"
            cmd /c $line
            if ($LASTEXITCODE -ne 0) {
              throw "$tool $arguments failed with exit code $LASTEXITCODE."
            }
          }

          Write-Host "Accepting Android SDK licenses"
          Invoke-AndroidToolWithInput $sdkmanager "--licenses" $yesFile
          Write-Host "Installing Android SDK emulator packages"
          Invoke-AndroidToolWithInput $sdkmanager "--install `"platform-tools`" `"emulator`" `"$windowsPlatform`" `"$windowsSystemImage`"" $yesFile
          Write-Host "Checking Android emulator acceleration"
          & $emulator -accel-check
          $accelSupported = $LASTEXITCODE -eq 0
          if (-not $accelSupported) {
            Write-Host "Hosted Windows runner did not report VM acceleration; forcing software acceleration for the CI smoke emulator."
          }
          Write-Host "Creating Android AVD"
          Invoke-AndroidToolWithInput $avdmanager "create avd --force --name SimDeck_Pixel_CI --package `"$windowsSystemImage`" --device `"pixel_6`"" $noFile

          $stdout = Join-Path $env:RUNNER_TEMP "simdeck-android-emulator.out.log"
          $stderr = Join-Path $env:RUNNER_TEMP "simdeck-android-emulator.err.log"
          $serial = "emulator-5554"
          $args = @(
            "-avd", "SimDeck_Pixel_CI",
            "-qt-hide-window",
            "-no-audio",
            "-no-boot-anim",
            "-no-snapshot-load",
            "-no-snapshot-save",
            "-wipe-data",
            "-gpu", "swiftshader_indirect",
            "-feature", "-Vulkan",
            "-grpc", "8554",
            "-port", "5554",
            "-no-metrics",
            "-skip-adb-auth",
            "-camera-back", "none",
            "-camera-front", "none",
            "-cores", "2",
            "-memory", "2048",
            "-verbose"
          )
          if ($accelSupported) {
            $args += @("-accel", "on")
          } else {
            $args += @("-accel", "off")
          }
          function Write-EmulatorDiagnostics {
            Write-Host "adb devices:"
            & $adb devices -l
            if (Test-Path $stdout) {
              Write-Host "emulator stdout tail:"
              Get-Content $stdout -Tail 80
            }
            if (Test-Path $stderr) {
              Write-Host "emulator stderr tail:"
              Get-Content $stderr -Tail 120
            }
          }
          Write-Host "Starting Android emulator"
          $process = Start-Process -FilePath $emulator -ArgumentList $args -PassThru -RedirectStandardOutput $stdout -RedirectStandardError $stderr
          $process.Id | Out-File -FilePath emulator.pid -Encoding ascii
          $deviceDeadline = (Get-Date).AddMinutes(10)
          $deviceSeen = $false
          do {
            if ($process.HasExited) {
              Write-EmulatorDiagnostics
              throw "Android emulator exited early with code $($process.ExitCode)."
            }
            $devices = (& $adb devices)
            if ($devices -match "$serial\s+device") {
              $deviceSeen = $true
              break
            }
            Start-Sleep -Seconds 5
          } while ((Get-Date) -lt $deviceDeadline)
          if (-not $deviceSeen) {
            Write-EmulatorDiagnostics
            throw "Android emulator did not appear in adb before the timeout."
          }
          $deadline = (Get-Date).AddMinutes(20)
          do {
            if ($process.HasExited) {
              Write-EmulatorDiagnostics
              throw "Android emulator exited early with code $($process.ExitCode)."
            }
            $booted = (& $adb -s $serial shell getprop sys.boot_completed 2>$null | Out-String).Trim()
            if ($booted -eq "1") {
              break
            }
            Start-Sleep -Seconds 5
          } while ((Get-Date) -lt $deadline)
          if ($booted -ne "1") {
            Write-EmulatorDiagnostics
            throw "Android emulator did not boot before the timeout."
          }
          & $adb -s $serial shell settings put global window_animation_scale 0
          & $adb -s $serial shell settings put global transition_animation_scale 0
          & $adb -s $serial shell settings put global animator_duration_scale 0
          $env:SIMDECK_INTEGRATION_ANDROID_AVD = "SimDeck_Pixel_CI"
          $env:SIMDECK_INTEGRATION_REQUIRE_RUNNING_ANDROID = "1"
          $env:SIMDECK_INTEGRATION_VERBOSE = "1"
          npm run test:integration:android
          $testExitCode = $LASTEXITCODE
          if ($testExitCode -ne 0) {
            Write-EmulatorDiagnostics
            throw "Android integration tests failed with exit code $testExitCode."
          }

      - name: Stop Android emulator (Windows)
        if: always() && runner.os == 'Windows'
        shell: pwsh
        run: |
          $sdk = $env:ANDROID_HOME
          if (-not $sdk) {
            $sdk = $env:ANDROID_SDK_ROOT
          }
          if ($sdk) {
            $adb = Join-Path $sdk "platform-tools\adb.exe"
            if (Test-Path $adb) {
              & $adb emu kill
              if ($LASTEXITCODE -ne 0) {
                Write-Host "No Android emulator accepted adb emu kill."
                $global:LASTEXITCODE = 0
              }
            }
          }
          if (Test-Path emulator.pid) {
            Stop-Process -Id (Get-Content emulator.pid) -Force -ErrorAction SilentlyContinue
          }
          exit 0