coverage-check

coverage-check

Validate coverage against configured thresholds and identify gaps in critical files.

Commands

/coverage-check            # Validate last snapshot against config
/coverage-check --strict   # Fail on any critical gap
/coverage-check --pr       # Compare current branch vs main

Execution Flow

1. Load Configuration

cat coverage-config.json

Extract:

• thresholds.global - Global minimums (lines, branches, functions)
• thresholds.<module> - Module-specific thresholds
• criticalPaths - Glob patterns for critical files
• criticalFiles - Explicit critical files list
• criticalMinCoverage - Minimum for critical files (default 90%)

2. Load Latest Snapshot

tail -1 .coverage-history/snapshots.jsonl

Parse JSON to get current coverage metrics for each stack.

If no snapshot exists, run /coverage-run first.

3. Validate Global Thresholds

For each metric in thresholds.global:

global_check:
  lines:
    actual: <from vitest snapshot>
    threshold: <from config>
    status: PASS | FAIL
  branches:
    actual: <from vitest snapshot>
    threshold: <from config>
    status: PASS | FAIL
  functions:
    actual: <from vitest snapshot>
    threshold: <from config>
    status: PASS | FAIL

4. Validate Module Thresholds

For each module in thresholds (except "global"):

# Get module-specific coverage from detailed report
cat coverage/coverage-final.json | jq '[to_entries[] | select(.key | contains("packages/api"))] |
  map(.value.s | to_entries | map(if .value > 0 then 1 else 0 end) | add / length * 100) | add / length'

5. Identify Critical Gaps

By Convention (criticalPaths):

For each pattern in criticalPaths:

# Find matching files
find . -path "**/services/**" -name "*.ts" -not -path "**/node_modules/**" -not -path "**/*.test.ts"

By Explicit List (criticalFiles):

Check each file in the criticalFiles array.

For each critical file found:

1. Look up coverage in coverage/coverage-final.json
2. Calculate statement coverage percentage
3. Compare against criticalMinCoverage (90%)
4. If below threshold, extract uncovered line numbers
5. Add to gaps list with risk assessment