ci.yml

name: CI

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

env:
  CARGO_TERM_COLOR: always

jobs:
  check:
    name: Check & Lint
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          components: clippy, rustfmt
      - name: Rustfmt
        run: cargo fmt --all -- --check
      - name: Clippy
        # Rust 1.97 added manual_filter; existing crud code is unrelated to this PR.
        run: cargo clippy --quiet --all-targets --all-features -- -D warnings -A clippy::manual_filter

  test:
    name: Test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
      - name: Run Tests
        run: cargo test --quiet --all-features

  version-check:
    name: Version Consistency
    if: github.actor != 'dependabot[bot]'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Check version consistency
        run: |
          for f in Cargo.toml npm/package.json python/pyproject.toml; do
            [ -f "$f" ] || { echo "::error::Required manifest not found: $f"; exit 1; }
          done
          CARGO_VER=$(python3 -c "import tomllib; print(tomllib.load(open('Cargo.toml','rb'))['package']['version'])")
          NPM_VER=$(python3 -c "import json; print(json.load(open('npm/package.json'))['version'])")
          PYPI_VER_RAW=$(python3 -c "import tomllib; print(tomllib.load(open('python/pyproject.toml','rb'))['project']['version'])")
          # Normalise PEP 440 dev versions: 0.1.6.dev0 → 0.1.6-dev
          PYPI_VER=$(echo "$PYPI_VER_RAW" | sed 's/\.dev[0-9]*$/-dev/')
          echo "Cargo: $CARGO_VER | npm: $NPM_VER | PyPI: $PYPI_VER (raw: $PYPI_VER_RAW)"
          if [ "$CARGO_VER" != "$NPM_VER" ] || [ "$CARGO_VER" != "$PYPI_VER" ]; then
            echo "::error::Version mismatch: Cargo=$CARGO_VER npm=$NPM_VER PyPI=$PYPI_VER"
            exit 1
          fi
          echo "All versions match: $CARGO_VER"

  python-wrapper-test:
    name: Python Wrapper (${{ matrix.python-version }})
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        python-version: ["3.8", "3.13"]
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-python@v6
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install wrapper package
        run: python -m pip install --disable-pip-version-check -e ./python
      - name: Run wrapper tests
        run: python -m unittest discover -s python/tests -v

  shell-installer-test:
    name: Shell Installer Integrity (${{ matrix.hash-tool }} on ${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: ubuntu-latest
            hash-tool: sha256sum
          - os: macos-latest
            hash-tool: shasum
          - os: ubuntu-latest
            hash-tool: openssl
    env:
      MAG_TEST_HASH_TOOL: ${{ matrix.hash-tool }}
    steps:
      - uses: actions/checkout@v7
      - name: Run installer checksum tests
        run: sh tests/install_checksum_test.sh

  benchmark:
    name: Benchmark Gate
    runs-on: ubuntu-latest
    if: github.event_name == 'pull_request'
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0

      - name: Test retrieval benchmark classifier
        run: python3 -m unittest tests/test_retrieval_benchmark_gate.py

      - name: Detect retrieval and scoring changes
        id: filter
        env:
          BASE_SHA: ${{ github.event.pull_request.base.sha }}
          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
        run: |
          required="$(python3 scripts/retrieval_benchmark_gate.py --base "$BASE_SHA" --head "$HEAD_SHA")"
          case "$required" in
            true|false) ;;
            *) echo "::error::Unexpected classifier output: $required"; exit 1 ;;
          esac
          echo "required=$required" >> "$GITHUB_OUTPUT"

      - name: Install Rust
        if: steps.filter.outputs.required == 'true'
        uses: dtolnay/rust-toolchain@stable

      - name: Cache Rust build artifacts
        if: steps.filter.outputs.required == 'true'
        uses: Swatinem/rust-cache@v2

      - name: Run benchmark gate
        if: steps.filter.outputs.required == 'true'
        run: ./scripts/bench.sh --gate

  smoke-test:
    name: Smoke Test
    runs-on: ubuntu-latest
    if: github.event_name == 'pull_request'
    steps:
      - uses: actions/checkout@v7
      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
      - name: Cache Rust build artifacts
        uses: Swatinem/rust-cache@v2
      - name: Run smoke test
        run: bash scripts/smoke-test.sh

  npm-install-test:
    name: npm Install Test
    runs-on: ubuntu-latest
    if: github.event_name == 'pull_request'
    steps:
      - uses: actions/checkout@v7
      - name: Install Node 20
        uses: actions/setup-node@v6
        with:
          node-version: '20'
      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
      - name: Cache Rust build artifacts
        uses: Swatinem/rust-cache@v2
      - name: Build release binary
        run: cargo build --release
      - name: Test npm install
        run: |
          cd npm
          # Pack and install globally using the local binary
          MAG_BINARY_PATH="$GITHUB_WORKSPACE/target/release/mag" npm install -g "$(npm pack -q)"
          # Verify the wrapper exists and works
          mag --version
          INSTALLED_VER=$(mag --version | awk '{print $2}')
          CARGO_VER=$(python3 -c "import tomllib; print(tomllib.load(open('../Cargo.toml','rb'))['package']['version'])")
          echo "Installed=$INSTALLED_VER  Expected=$CARGO_VER"
          if [ "$INSTALLED_VER" != "$CARGO_VER" ]; then
            echo "::error::npm install test: version mismatch ($INSTALLED_VER != $CARGO_VER)"
            exit 1
          fi
          echo "npm install test passed: mag $INSTALLED_VER"