ci: add VK-GL-CTS build validation workflow

Add a CI job that clones VK-GL-CTS, replaces the pinned
vulkan-video-samples sources with the current PR code, and
builds CTS to validate compile-time compatibility on both Linux
and Win32.

The build can be triggered manually by adding a 'cts-build'
label or automatically on '[release]' pattern in the commit message.

Author: dabrain34

.github/workflows/cts-build.yml

@@ -0,0 +1,97 @@
+name: "VK-GL-CTS build validation"
+run-name: CTS build validation by ${{ github.actor }}
+on:
+  pull_request:
+    branches:
+      - main
+    types: [opened, synchronize, labeled]
+
+jobs:
+  cts-build-linux:
+    runs-on: ubuntu-24.04
+    if: >
+      contains(github.event.pull_request.title || '', '[release]') ||
+      github.event.label.name == 'cts-build' ||
+      contains(github.event.pull_request.labels.*.name, 'cts-build')
+    env:
+      TERM: dumb
+
+    steps:
+      - name: Checkout Vulkan-Video-Samples
+        uses: actions/checkout@v6
+        with:
+          path: vulkan-video-samples
+
+      - name: Install dependencies
+        run: |
+          sudo apt update
+          sudo apt install --assume-yes --no-install-recommends \
+            cmake \
+            ninja-build \
+            python3 \
+            python3-lxml \
+            build-essential \
+            libx11-dev \
+            libwayland-dev \
+            libvulkan-dev \
+            libxrandr-dev
+
+      - name: Clone VK-GL-CTS
+        run: |
+          git clone --depth 1 https://github.com/KhronosGroup/VK-GL-CTS.git vk-gl-cts
+
+      - name: Fetch CTS external sources
+        run: |
+          cd vk-gl-cts
+          python3 external/fetch_sources.py
+
+      - name: Replace vulkan-video-samples sources
+        run: |
+          rm -rf vk-gl-cts/external/vulkan-video-samples/src
+          cp -r vulkan-video-samples vk-gl-cts/external/vulkan-video-samples/src
+
+      - name: Build CTS
+        run: |
+          cd vk-gl-cts
+          python3 scripts/check_build_sanity.py --skip-prerequisites -r gcc-64-release -t /tmp/cts-build
+
+  cts-build-windows:
+    runs-on: windows-latest
+    if: >
+      contains(github.event.pull_request.title || '', '[release]') ||
+      github.event.label.name == 'cts-build' ||
+      contains(github.event.pull_request.labels.*.name, 'cts-build')
+
+    steps:
+      - name: Checkout Vulkan-Video-Samples
+        uses: actions/checkout@v6
+        with:
+          path: vulkan-video-samples
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install lxml
+        run: pip install lxml
+
+      - name: Clone VK-GL-CTS
+        run: |
+          git clone --depth=1 https://github.com/KhronosGroup/VK-GL-CTS.git vk-gl-cts
+
+      - name: Fetch CTS external sources
+        run: |
+          cd vk-gl-cts
+          python3 external/fetch_sources.py
+
+      - name: Replace vulkan-video-samples sources
+        shell: pwsh
+        run: |
+          Remove-Item -Recurse -Force vk-gl-cts/external/vulkan-video-samples/src
+          Copy-Item -Recurse vulkan-video-samples vk-gl-cts/external/vulkan-video-samples/src
+
+      - name: Build CTS
+        run: |
+          cd vk-gl-cts
+          python3 scripts/check_build_sanity.py -r vs-64-debug

CONTRIBUTING

@@ -118,13 +118,20 @@ Use this section for any extra context that doesn't fit elsewhere:
 
 PR titles and bodies are automatically validated via GitHub Actions. The check will fail if required sections are missing or incorrectly formatted.
 
+### CTS Build Validation
+
+A CI job validates that changes compile correctly within the [VK-GL-CTS](https://github.com/KhronosGroup/VK-GL-CTS) (Vulkan Conformance Test Suite). This ensures integration compatibility before changes reach CTS upstream.
+
+The CTS build runs automatically when the PR title contains `[release]`. It can also be triggered manually by adding the `cts-build` label to the pull request. The job clones VK-GL-CTS, replaces the pinned vulkan-video-samples sources with the PR code, and builds CTS on both Linux (GCC 64-bit Release) and Windows (VS 64-bit Debug).
+
 ---
 
 ## Release Process
 
 1. Update `Changelog.md` with the new version entry
 2. Update the version in `common/include/VkVSCommon.h`
-3. Create a tag (e.g. `v0.4.0`) and push it — GitHub will automatically create a release
+3. Create a PR with `[release]: create vx.x.x` as title to trigger a CTS build
+4. When PR has been merged, create a tag (e.g. `v0.4.0`) on this release commit and push it — GitHub will automatically create a release
 
 ---