Intel GPU backend, shared graph cache, and checkpoint hardening (0.2.0)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,26 @@
+---
+name: Bug report
+about: Something built or ran, and did the wrong thing
+labels: bug
+---
+
+**What happened**
+
+**Expected**
+
+**Repro**
+
+```
+# command, including the model and backend
+```
+
+**Environment**
+- vla.cpp commit:
+- Backend: CPU / CUDA / Metal / SYCL
+- OS and compiler:
+- GPU and driver (if relevant):
+- Model and checkpoint:
+
+**Output**
+
+Paste the shortest decisive part of the log, not the whole run.

.github/ISSUE_TEMPLATE/model_request.md

@@ -0,0 +1,20 @@
+---
+name: Architecture request
+about: Ask for a VLA policy that vla.cpp does not run yet
+labels: enhancement
+---
+
+**Policy**
+
+Name, paper or repo link, and the reference implementation.
+
+**Checkpoint**
+
+Where the weights live and under what license.
+
+**Why it is worth adding**
+
+Benchmark numbers, or what it does that the supported archs do not.
+
+CONTRIBUTING.md has the six-site walkthrough if you want to send the port
+yourself.

.github/pull_request_template.md

@@ -0,0 +1,12 @@
+## What
+
+## Why
+
+## Verified
+
+- [ ] Builds clean under `-Wall -Wextra` (first-party code)
+- [ ] `ctest` passes
+- [ ] Numeric output unchanged (`vla_predict_check` diff), or the change is
+      meant to move it and a LIBERO sweep is below
+
+Archs and backends tested:

.github/workflows/build.yml

@@ -17,10 +17,14 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-      - name: pixel-shuffle channel order
+      # Compiled directly: pure, no llama.cpp or protobuf/zmq needed.
+      - name: pure unit tests
         run: |
-          g++ -std=c++17 -Isrc -Wall -Wextra tests/test_vision_common.cpp -o /tmp/test_vision_common
-          /tmp/test_vision_common
+          for t in test_vision_common test_rope_conventions; do
+            g++ -std=c++17 -Isrc -Wall -Wextra -fsanitize=address,undefined \
+                -fno-omit-frame-pointer "tests/$t.cpp" -o "/tmp/$t"
+            "/tmp/$t"
+          done
 
   py-tooling:
     runs-on: ubuntu-24.04
@@ -31,6 +35,8 @@ jobs:
           python-version: '3.11'
       - name: converter remap
         run: python tests/py/test_converters.py
+      - name: binding struct parity
+        run: python tests/py/test_bindings.py
 
   build-gate:
     runs-on: ubuntu-24.04
@@ -45,8 +51,11 @@ jobs:
       - uses: actions/cache@v4
         with:
           path: build/_deps
-          key: llama-b9866-${{ runner.os }}
-      - name: build vla-server + vlm-server + vla-cli (CPU, -Wall -Wextra)
+          key: llama-b10331-${{ runner.os }}
+      # Everything, not a target list: ctest registers tests this job must build,
+      # and a named list goes stale the next time one is added.
+      - name: build + ctest (CPU, -Wall -Wextra)
         run: |
-          cmake -B build -DCMAKE_BUILD_TYPE=Release -DGGML_CUDA=OFF
-          cmake --build build -j"$(nproc)" --target vla-server vlm-server vla-cli
+          cmake -B build -DCMAKE_BUILD_TYPE=Release -DGGML_CUDA=OFF -DVLA_BUILD_TESTS=ON
+          cmake --build build -j"$(nproc)"
+          ctest --test-dir build --output-on-failure

.github/workflows/release.yml

@@ -0,0 +1,144 @@
+# Tagged binaries and a container image. build.yml already compiles all of this
+# on every push; this is the same work with the artifacts kept.
+name: release
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Tag to build (dry run, nothing is published)
+        required: true
+
+permissions:
+  contents: write
+  packages: write
+
+env:
+  BINARIES: vla-server vlm-server vla-cli vla-bench
+
+jobs:
+  linux:
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: linux-x86_64-cpu
+            cmake: -DGGML_CUDA=OFF
+            cuda: false
+            runner: ubuntu-24.04
+          - name: linux-x86_64-cuda
+            cmake: -DGGML_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=75;86;89;120
+            cuda: true
+            runner: ubuntu-24.04
+          # Jetson and other aarch64 boards. Native arm64 runner, CPU only: the
+          # hosted images carry no CUDA for arm64, so a Jetson GPU build still
+          # has to happen on the device.
+          - name: linux-aarch64-cpu
+            cmake: -DGGML_CUDA=OFF
+            cuda: false
+            runner: ubuntu-24.04-arm
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: deps
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq --no-install-recommends \
+            build-essential cmake git ca-certificates pkg-config \
+            libzmq3-dev cppzmq-dev libprotobuf-dev protobuf-compiler
+
+      - name: cuda toolkit
+        if: matrix.cuda
+        run: |
+          wget -q https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-keyring_1.1-1_all.deb
+          sudo dpkg -i cuda-keyring_1.1-1_all.deb
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq --no-install-recommends cuda-toolkit-12-6
+          echo "/usr/local/cuda/bin" >> "$GITHUB_PATH"
+
+      - name: build
+        run: |
+          cmake -B build -DCMAKE_BUILD_TYPE=Release ${{ matrix.cmake }}
+          cmake --build build -j"$(nproc)" --target $BINARIES vla
+
+      - name: package
+        run: |
+          out="vla.cpp-${{ github.ref_name }}-${{ matrix.name }}"
+          mkdir -p "$out"
+          for b in $BINARIES; do cp "build/$b" "$out/"; done
+          cp build/libvla.so "$out/"
+          cp include/vla.h LICENSE.md README.md "$out/"
+          # vla-cli --text runs this; VLA_TOKENIZE_SCRIPT points at it.
+          mkdir -p "$out/scripts" && cp scripts/tokenize_prompt.py "$out/scripts/"
+          tar -czf "$out.tar.gz" "$out"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.name }}
+          path: '*.tar.gz'
+
+  macos:
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: deps
+        run: brew install cmake zeromq cppzmq protobuf
+
+      - name: build
+        run: |
+          cmake -B build -DCMAKE_BUILD_TYPE=Release -DGGML_METAL=ON
+          cmake --build build -j"$(sysctl -n hw.ncpu)" --target $BINARIES vla
+
+      - name: package
+        run: |
+          out="vla.cpp-${{ github.ref_name }}-macos-arm64-metal"
+          mkdir -p "$out"
+          for b in $BINARIES; do cp "build/$b" "$out/"; done
+          cp build/libvla.dylib "$out/"
+          cp include/vla.h LICENSE.md README.md "$out/"
+          mkdir -p "$out/scripts" && cp scripts/tokenize_prompt.py "$out/scripts/"
+          # Metal needs the shader library next to the binary.
+          find build -name 'default.metallib' -exec cp {} "$out/" \;
+          tar -czf "$out.tar.gz" "$out"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: macos-arm64-metal
+          path: '*.tar.gz'
+
+  docker:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ startsWith(github.ref, 'refs/tags/') }}
+          tags: |
+            ghcr.io/${{ github.repository }}:${{ github.ref_name }}
+            ghcr.io/${{ github.repository }}:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  publish:
+    needs: [linux, macos, docker]
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { path: dist, merge-multiple: true }
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*.tar.gz
+          generate_release_notes: true

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 Notable changes to vla.cpp. Format loosely follows [Keep a Changelog](https://keepachangelog.com).
 
+## [0.2.0] - 2026-08-09
+
+### Added
+- SYCL backend for Intel GPUs (Arc, Flex, Data Center Max, Xe iGPU). `VLA_DEVICE` picks the ordinal on CUDA and SYCL alike. See `docs/backend/sycl.md`.
+- Stable C ABI (`include/vla.h`, `libvla`) and Python bindings over it (`bindings/python`).
+- Four more architectures: π0.5, VLA-Adapter, OpenVLA-OFT and VLA-JEPA.
+- `vla-bench` for engine-only latency, and `-hf user/repo[:file.gguf]` to fetch a checkpoint on first use.
+- `vla-cli --text`, tokenized by `scripts/tokenize_prompt.py` with the tokenizer the architecture was trained on.
+- Release workflow publishing Linux x86-64 (CPU and CUDA), Linux aarch64 (CPU), macOS Metal and a GHCR image.
+
+### Changed
+- One shared backend ladder (`src/backend.h`) instead of a copy per arch. CMake rejects two accelerators in one build directory.
+- Shared headers for the Qwen3-VL tower, the DINOv2+SigLIP dual tower, the DiT time embeddings, the causal mask and CHW image preprocessing.
+- `vla::graph_cache` keeps the compute graph across `predict` calls in nine architectures, not just GR00T N1.7. Output is unchanged.
+- llama.cpp pinned at b10331. GR00T N1.5 and N1.6 shift by up to 4.6e-4 on actions peaking near 0.87, from an upstream ggml kernel change in the SigLIP tower they share. The other nine architectures are bit-identical.
+
+### Fixed
+- Reject checkpoint geometry that contradicts itself before it sizes a buffer, in smolvla, bitvla, gr00tn1d6, vla_adapter and the Qwen3-VL position resample.
+- A peer that stalls mid-message no longer parks either server.
+- Treat a missing state vector as zeros in every architecture rather than dereferencing it.
+- Build every registered test before `ctest`, so the four that were never built stop reporting as not run.
+
 ## [0.1.1] - 2026-07-04
 
 ### Added
@@ -40,5 +62,6 @@ expert + dataset stats), CPU or CUDA, no external mmproj and no patch to llama.c
 - llama.cpp is fetched + pinned via CMake `FetchContent` (tag `b9866`); bumping is a
   one-line `GIT_TAG` change. Removed the `patches/` fetch script.
 
+[0.2.0]: https://github.com/VinRobotics/vla.cpp/releases/tag/v0.2.0
 [0.1.1]: https://github.com/VinRobotics/vla.cpp/releases/tag/v0.1.1
 [0.1.0]: https://github.com/VinRobotics/vla.cpp/releases/tag/v0.1.0