ci.yml

name: Reference tests

# ChannelQuant is the algorithm source-of-truth + frozen golden vectors for the
# KV Cache Engine block (its RTL lives in the kv-cache-engine repo). This gate
# runs the pure-numpy reference test suite — codec roundtrips, INT3/INT4 pack
# inversion, WHT-beats-naive-INT3, and 3-way bit-exact parity against the golden
# vectors. Hermetic (numpy only), no model download.

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

jobs:
  reference-tests:
    name: Reference model (9 tests)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Install numpy
        run: pip install numpy
      - name: Run reference tests
        working-directory: reference
        run: |
          set -o pipefail
          python test_reference.py 2>&1 | tee /tmp/ref.log
          grep -qE 'ALL 9 reference tests passed' /tmp/ref.log \
            || { echo "reference tests did not all pass"; exit 1; }