run-coverage

name	run-coverage
description	Runs code coverage checker on the fastest available device. Use when the user asks to run the coverage, or to check the code coverage.

Checking the code coverage

Run every instrumented test suite in the workspace, picking the fastest compiled device backend for the host, then make sure everything is within required limits.

Makefile is the source of truth for the gated values, and the code coverage setup.

Step 1: detect the device

Run this once at the start and echo the chosen device:

if [[ "$OSTYPE" == "darwin"* ]]; then
  DEVICE=metal
elif command -v nvidia-smi >/dev/null 2>&1 && nvidia-smi >/dev/null 2>&1; then
  DEVICE=cuda
else
  DEVICE=cpu
fi
echo "Device: $DEVICE"

$DEVICE selects the backend feature for every suite in Step 2, including test.unit. Passing the same device through every target keeps the cmake hash stable, so llama.cpp is compiled once and reused across all suites.

Step 2: run the suites

Translate $DEVICE into the value the Makefile expects. TEST_DEVICE holds only the backend name (cuda / metal / vulkan / rocm), or empty for CPU since there is no cpu feature:

[ "$DEVICE" = "cpu" ] && FEAT= || FEAT="$DEVICE"

Then run exactly:

make coverage TEST_DEVICE="$FEAT"

Step 4: report

After all suites finish, sum up the results in an actionable report. Make sure all code coverage gates are met.