ci: create workflow

Author: msg7086

.github/workflows/coverage-pages.yml

@@ -0,0 +1,123 @@
+name: Verification Coverage
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  report:
+    name: Build, test, and render report
+    runs-on: ubuntu-24.04
+    outputs:
+      ctest_exit_code: ${{ steps.tests.outputs.exit_code }}
+      ctest_status: ${{ steps.tests.outputs.status }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install gcovr
+        run: python -m pip install --disable-pip-version-check --no-cache-dir gcovr==7.2
+
+      - name: Configure GCC coverage build
+        run: cmake --preset gcc-coverage
+
+      - name: Build test suite
+        run: cmake --build --preset gcc-coverage --parallel 2
+
+      - name: Clear old coverage counters
+        run: find "$GITHUB_WORKSPACE/build/gcc-coverage" -name '*.gcda' -delete
+
+      - name: Seed zero-count AvsCore coverage data
+        run: "$GITHUB_WORKSPACE/build/gcc-coverage/tests/coverage/avs_coverage_inventory"
+
+      - name: Run CTest
+        id: tests
+        shell: bash
+        run: |
+          set +e
+          ctest --preset gcc-coverage --output-junit "$GITHUB_WORKSPACE/build/gcc-coverage/test-results.xml"
+          exit_code=$?
+          set -e
+          if [ "$exit_code" -eq 0 ]; then
+            status=PASS
+          else
+            status=FAIL
+          fi
+          printf 'exit_code=%s\n' "$exit_code" >> "$GITHUB_OUTPUT"
+          printf 'status=%s\n' "$status" >> "$GITHUB_OUTPUT"
+
+      - name: Generate full AvsCore coverage report
+        run: |
+          mkdir -p site/coverage site/data
+          gcovr \
+            --root "$GITHUB_WORKSPACE/third_party/AviSynthPlus" \
+            --filter "$GITHUB_WORKSPACE/third_party/AviSynthPlus/avs_core/" \
+            --html-details "$GITHUB_WORKSPACE/site/coverage/index.html" \
+            --json-summary "$GITHUB_WORKSPACE/site/data/coverage-summary.json" \
+            --print-summary \
+            "$GITHUB_WORKSPACE/build/gcc-coverage"
+
+      - name: Render latest-result dashboard
+        env:
+          TEST_STATUS: ${{ steps.tests.outputs.status }}
+        run: |
+          upstream_sha="$(git -C third_party/AviSynthPlus rev-parse HEAD)"
+          python tools/render_coverage_dashboard.py \
+            --junit "$GITHUB_WORKSPACE/build/gcc-coverage/test-results.xml" \
+            --coverage-summary "$GITHUB_WORKSPACE/site/data/coverage-summary.json" \
+            --output-dir "$GITHUB_WORKSPACE/site" \
+            --source-root "$GITHUB_WORKSPACE/third_party/AviSynthPlus" \
+            --test-status "$TEST_STATUS" \
+            --repository-sha "$GITHUB_SHA" \
+            --upstream-sha "$upstream_sha" \
+            --run-url "https://github.com/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}"
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    name: Deploy latest report
+    needs: report
+    runs-on: ubuntu-24.04
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+  verify:
+    name: Preserve test result
+    needs:
+      - report
+      - deploy
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Fail after publishing a failed test run
+        shell: bash
+        run: |
+          test "${{ needs.report.outputs.ctest_exit_code }}" = "0"

CMakeLists.txt

@@ -6,11 +6,26 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_CXX_EXTENSIONS OFF)
 
 option(AVSUT_ENABLE_SANITIZERS "Enable AddressSanitizer and UBSan" OFF)
+option(AVSUT_ENABLE_COVERAGE "Enable GCC gcov coverage instrumentation" OFF)
+
+if(AVSUT_ENABLE_SANITIZERS AND AVSUT_ENABLE_COVERAGE)
+  message(FATAL_ERROR
+    "AVSUT_ENABLE_SANITIZERS and AVSUT_ENABLE_COVERAGE require separate builds")
+endif()
+
 if(AVSUT_ENABLE_SANITIZERS)
   add_compile_options(-fsanitize=address,undefined -fno-omit-frame-pointer)
   add_link_options(-fsanitize=address,undefined -fno-omit-frame-pointer)
 endif()
 
+if(AVSUT_ENABLE_COVERAGE)
+  if(NOT CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+    message(FATAL_ERROR "AVSUT_ENABLE_COVERAGE requires GCC")
+  endif()
+  add_compile_options(-O0 -g --coverage)
+  add_link_options(--coverage)
+endif()
+
 include(FetchContent)
 include(CTest)
 
@@ -31,4 +46,7 @@ FetchContent_Declare(
 FetchContent_MakeAvailable(googletest xxhash)
 
 include(cmake/UpstreamTargets.cmake)
+if(AVSUT_ENABLE_COVERAGE)
+  add_subdirectory(tests/coverage)
+endif()
 add_subdirectory(tests)

CMakePresets.json

@@ -42,6 +42,14 @@
         "AVSUT_ENABLE_SANITIZERS": "ON"
       }
     },
+    {
+      "name": "gcc-coverage",
+      "inherits": "gcc-debug",
+      "binaryDir": "${sourceDir}/build/gcc-coverage",
+      "cacheVariables": {
+        "AVSUT_ENABLE_COVERAGE": "ON"
+      }
+    },
     {
       "name": "msvc-debug",
       "generator": "Visual Studio 18 2026",
@@ -58,6 +66,7 @@
     { "name": "clang19-debug", "configurePreset": "clang19-debug" },
     { "name": "clang22-debug", "configurePreset": "clang22-debug" },
     { "name": "gcc-sanitize", "configurePreset": "gcc-sanitize" },
+    { "name": "gcc-coverage", "configurePreset": "gcc-coverage" },
     {
       "name": "msvc-debug",
       "configurePreset": "msvc-debug",
@@ -97,6 +106,14 @@
         "outputOnFailure": true
       }
     },
+    {
+      "name": "gcc-coverage",
+      "configurePreset": "gcc-coverage",
+      "output": {
+        "shortProgress": true,
+        "outputOnFailure": true
+      }
+    },
     {
       "name": "msvc-debug",
       "configurePreset": "msvc-debug",

README.md

@@ -21,7 +21,8 @@ ctest --preset gcc-debug
 ```
 
 Use `clang19-debug` or `clang22-debug` for Clang, or `gcc-sanitize` for ASan
-plus UBSan.
+plus UBSan. Use `gcc-coverage` to build the GCC gcov instrumentation profile
+used by the hosted source-coverage report.
 
 The upstream `AvsCore` static library is built in a separate ExternalProject
 build tree and linked as a normal imported target. The sanitizer preset applies
@@ -41,8 +42,17 @@ ctest --preset msvc-debug
 The Visual Studio 2026 generator requires a CMake version that supports it
 (CMake 4.2 or newer).
 
-Windows/MSVC is part of the supported test matrix. Continuous integration is
-not configured in this repository yet.
+Windows/MSVC is part of the supported test matrix. On pushes to `master` and
+manual dispatches, GitHub Actions builds the `gcc-coverage` profile, runs
+CTest, and publishes the latest test result plus full Linux/GCC-compiled
+`AvsCore` coverage report to GitHub Pages. Enable GitHub Pages with the
+`GitHub Actions` source in repository settings before the first deployment.
+
+The coverage profile links a reporting-only inventory executable against every
+object in the upstream static library. This records zero-count files as well
+as executed files, so the report represents the full set of Linux/GCC-compiled
+`AvsCore` sources. It does not include platform-specific sources that the
+Linux upstream build does not compile.
 
 ## Layout
 

cmake/UpstreamTargets.cmake

@@ -20,6 +20,12 @@ set(AVS_UPSTREAM_CMAKE_ARGS
   -DENABLE_CUDA=OFF
   -DENABLE_INTEL_SIMD=ON
 )
+if(AVSUT_ENABLE_COVERAGE)
+  list(APPEND AVS_UPSTREAM_CMAKE_ARGS
+    "-DCMAKE_C_FLAGS:STRING=-O0 -g --coverage"
+    "-DCMAKE_CXX_FLAGS:STRING=-O0 -g --coverage"
+  )
+endif()
 if(CMAKE_C_COMPILER)
   list(APPEND AVS_UPSTREAM_CMAKE_ARGS
     -DCMAKE_C_COMPILER=${CMAKE_C_COMPILER}

memory-bank/coverage.md

@@ -10,9 +10,25 @@ sources and test vectors.
 
 | Environment | Presets | Coverage role |
 | --- | --- | --- |
-| Linux x86_64, GCC | `gcc-debug`, `gcc-sanitize` | Supported test matrix; SIMD cases run only when their runtime ISA requirements are available |
+| Linux x86_64, GCC | `gcc-debug`, `gcc-sanitize`, `gcc-coverage` | Supported test matrix; SIMD cases run only when their runtime ISA requirements are available. `gcc-coverage` measures the complete Linux/GCC-compiled `AvsCore` source set. |
 | Linux x86_64, Clang | `clang19-debug`, `clang22-debug` | Supported test matrix; SIMD cases run only when their runtime ISA requirements are available |
-| Windows x64, native MSVC | `msvc-debug` | Supported test matrix with the same CPU-gated SIMD behavior as GCC; continuous integration is outside the current scope |
+| Windows x64, native MSVC | `msvc-debug` | Supported test matrix with the same CPU-gated SIMD behavior as GCC |
+
+## Hosted Coverage Reporting
+
+The `gcc-coverage` preset is a GCC gcov reporting profile, separate from the
+sanitizer profile. It instruments both the test targets and the external
+`AvsCore` static-library build with `-O0 -g --coverage`. A reporting-only
+whole-archive inventory executable runs before CTest so every Linux/GCC-
+compiled `AvsCore` object produces zero-count data even when no test references
+it. gcovr filters the report to `avs_core/` using the AviSynthPlus submodule as
+the report root, so published source paths begin with `avs_core/`.
+
+GitHub Actions runs this profile only for `master` pushes and manual dispatches.
+It publishes the latest CTest status plus line, branch, and function coverage
+to GitHub Pages without a coverage threshold or retained report history. A
+failing CTest run is published as `FAIL` before the workflow is marked failed;
+its coverage result can therefore be partial.
 
 ## Support Coverage
 

memory-bank/project-context.md

@@ -24,6 +24,8 @@ pointer or retaining a minimal production fix is an explicit, reviewed change.
 - Differential checks between scalar C and available SIMD implementations.
 - Memory-integrity checks for active pixels, row padding, and allocation guards.
 - Linux GCC/Clang and native Windows x64 MSVC builds, with C++17 throughout.
+- A master-branch GitHub Actions GCC coverage profile with a latest-result
+  GitHub Pages report for test status and compiled `AvsCore` source coverage.
 
 The test project owns its support layer and converts RAII views to the exact
 raw-pointer and pitch arguments expected by upstream functions at the call
@@ -32,6 +34,12 @@ boundary.
 ## Architecture
 
 - CMake and CMake Presets define configure, build, and test entry points.
+- The `gcc-coverage` preset instruments both the test project and the external
+  upstream `AvsCore` build. A reporting-only whole-archive inventory executable
+  creates zero-count data for every Linux/GCC-compiled upstream object before
+  CTest runs.
+- GitHub Actions runs `gcc-coverage` on `master` pushes and manual dispatches,
+  then publishes only the latest CTest and gcovr report through GitHub Pages.
 - GoogleTest `v1.17.0` is acquired with `FetchContent`.
 - xxHash `v0.8.3` provides explicit `XXH3_64bits`-based stable hashes.
 - CTest discovers individual GoogleTest cases using module prefixes.
@@ -110,7 +118,9 @@ disassembly.
 - `.avs` script execution, filter `Create` entry points, `Invoke` conversion
   orchestration, or black-box filter-graph tests.
 - Filter registration, full distribution, or plugin-loading tests.
-- Continuous-integration configuration and hosted execution.
+- Pull-request-triggered, scheduled, or historical hosted reporting. Hosted
+  reporting runs only on `master` pushes and manual dispatches, and Pages keeps
+  the latest generated report rather than a result history.
 - Performance benchmarks and unbounded fuzzing.
 - ISA-dispatch contract testing, illegal-instruction testing, or FMA-specific
   environment simulation.

tests/coverage/CMakeLists.txt

@@ -0,0 +1,4 @@
+add_executable(avs_coverage_inventory coverage_inventory.cpp)
+target_link_libraries(avs_coverage_inventory PRIVATE
+  "$<LINK_LIBRARY:WHOLE_ARCHIVE,AvsCoreExternal>"
+)

tests/coverage/coverage_inventory.cpp

@@ -0,0 +1,3 @@
+int main() {
+  return 0;
+}