open-standards/.github/workflows/wai-conformance.yml

name: WAI conformance

# WAI's load-bearing claim is bit-exact reconstruction on every machine,
# no tolerance parameter. This workflow enforces it mechanically: every
# cargo-class corpus — and the one neural decoder that can make the same
# promise, the integer-synthesis path (i64-only, no float ONNX) — is
# re-derived on a four-platform matrix (x86-64 + arm64 across Linux, macOS,
# Windows) and must reproduce its frozen BLAKE3 hashes; and the integer
# byte-equality goldens (rANS / int_synth / JPEG-AI mANS, generated once on
# a reference machine) must decode identically everywhere. All of it is pure
# Rust (no C codec chain, no ONNX Runtime), so the matrix needs no system
# dependencies.

on:
  push:
    branches: [main]
    paths:
      - 'wai/wai-rs/**'
      - 'wai/*-conformance/**'
      - 'wai/byte-exact-conformance/**'
      - '.github/workflows/wai-conformance.yml'
  pull_request:
    paths:
      - 'wai/wai-rs/**'
      - 'wai/*-conformance/**'
      - 'wai/byte-exact-conformance/**'
      - '.github/workflows/wai-conformance.yml'

defaults:
  run:
    shell: bash

jobs:
  cargo-classes:
    name: cargo-class corpora · ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        # Self-hosted fleet labels. Both architectures across all three OS
        # families: x86_64 by linux + windows, arm64 by linux-arm64 + macos —
        # what matters for the Fx integer floor is the arch, not the OS. No
        # Intel-Mac runner exists in the fleet, and it would add no arch
        # coverage anyway.
        os: [linux, linux-arm64, macos, windows]
    steps:
      - uses: actions/checkout@v5
      # Bootstraps rustup on the minimal docker image (linux / linux-arm64 /
      # windows runners ship no Rust at all) and also covers the macOS `host`
      # runner, whose launchd PATH omits ~/.cargo/bin. dtolnay/rust-toolchain
      # is NOT usable here: it calls `rustup`, which the docker image lacks.
      - name: Install Rust 1.97.1
        run: |
          export PATH="$HOME/.cargo/bin:$PATH"
          command -v rustup >/dev/null 2>&1 || \
            curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal --default-toolchain 1.97.1
          rustup toolchain install 1.97.1 --profile minimal
          rustup default 1.97.1
          echo "$HOME/.cargo/bin" >> "$GITHUB_PATH"
      - name: Build the cargo classes (pure Rust, no C codec chain)
        working-directory: wai/wai-rs
        # neural_int joins the pure-Rust set: the integer-synthesis decoder is
        # i64-only (no ONNX, no float), so it carries the same bit-exact promise
        # and is checkable on this matrix with no ONNX Runtime present.
        run: cargo build --no-default-features --features world,audio_scene,haptic,splat4d,score,provenance,neural_int,film
      - name: Library unit tests (the fixed-point determinism floors)
        working-directory: wai/wai-rs
        run: cargo test --lib --no-default-features --features world,audio_scene,haptic,splat4d,score,provenance,neural_int,film
      - name: Carriage conformance — every registered capability round-trips byte-exact
        working-directory: wai/wai-rs
        run: cargo test --no-default-features --test carriage
      - name: Every cargo-class corpus reproduces its frozen hashes
        working-directory: wai/wai-rs
        run: |
          set -euo pipefail
          F=world,audio_scene,haptic,splat4d,score,provenance,neural_int,film
          v() { echo "::group::$1"; cargo run -q --no-default-features --features "$F" --bin "$2" -- verify "$3"; echo "::endgroup::"; }
          v worlds        wai_world_vectors      ../world-conformance
          v spatial-audio wai_audio_vectors      ../audio-conformance
          v haptics       wai_haptic_vectors     ../haptic-conformance
          v state-feeds   wai_feed_vectors       ../feed-conformance
          v avatars       wai_avatar_vectors     ../avatar-conformance
          v volumetric    wai_splat4d_vectors    ../volumetric-conformance
          v score         wai_score_vectors      ../score-conformance
          v int-synth     wai_int_synth_vectors  ../neural-conformance
          v film          wai_film_vectors       ../film-conformance

  byte-exact:
    name: cross-arch byte-equality · ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        # Self-hosted fleet labels. Both architectures across all three OS
        # families: x86_64 by linux + windows, arm64 by linux-arm64 + macos —
        # what matters for the Fx integer floor is the arch, not the OS. No
        # Intel-Mac runner exists in the fleet, and it would add no arch
        # coverage anyway.
        os: [linux, linux-arm64, macos, windows]
    steps:
      - uses: actions/checkout@v5
      # Bootstraps rustup on the minimal docker image (linux / linux-arm64 /
      # windows runners ship no Rust at all) and also covers the macOS `host`
      # runner, whose launchd PATH omits ~/.cargo/bin. dtolnay/rust-toolchain
      # is NOT usable here: it calls `rustup`, which the docker image lacks.
      - name: Install Rust 1.97.1
        run: |
          export PATH="$HOME/.cargo/bin:$PATH"
          command -v rustup >/dev/null 2>&1 || \
            curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal --default-toolchain 1.97.1
          rustup toolchain install 1.97.1 --profile minimal
          rustup default 1.97.1
          echo "$HOME/.cargo/bin" >> "$GITHUB_PATH"
      - name: Integer rANS + int_synth + JPEG-AI mANS goldens (one machine → every machine)
        working-directory: wai/byte-exact-conformance
        run: cargo test --release