coverage-check

name	coverage-check
description	Run tests for a project with code coverage and report uncovered source lines. Use when the user asks about test coverage, wants to know which lines are uncovered, asks to check coverage for a project, or says "run coverage" or "what's not covered".

Coverage Check

Run tests with coverlet coverage and produce a diff-coverage report — mirroring the CI pipeline locally.

Input: test project path relative to the repo root (e.g. tests/MakaMek.Core.Tests/MakaMek.Core.Tests.csproj).

Step 1: Locate and validate the test project

Resolve the test project path. Confirm the .csproj file exists. Read it to extract the <AssemblyName> value.

Completion criterion: test project found and its assembly name extracted.

Step 2: Derive the source assembly name

Remove the .Tests suffix from the test project's assembly name to obtain the source assembly name. Example: Sanet.MakaMek.Core.Tests → Sanet.MakaMek.Core.

Completion criterion: source assembly name derived and ready for the coverage filter.

Step 3: Run tests with coverage

Execute the test command matching the CI pipeline:

dotnet test {testProjectPath} /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:ExcludeByAttribute=GeneratedCodeAttribute /p:Include=[{SourceAssemblyName}]*

Stop and report if tests fail. Do not proceed to parsing.

Completion criterion: tests pass and coverage.opencover.xml exists in the test project directory.

Step 4: Diff-coverage report with Cocodif

Cocodif is a .NET global tool that parses the OpenCover XML, filters changed files via git diff, and produces a Markdown diff-coverage report.

Install (if not already available):

dotnet tool install --global Sanet.Cocodif

Run against the module (after Step 3 produces coverage.opencover.xml):

Cocodif \
  -c tests/{TestProjectDir}/coverage.opencover.xml \
  -o diff-coverage.md \
  --include 'src/{ModuleName}/**' \
  --exclude '**/obj/**,**/bin/**' \
  --title '{ModuleName} Coverage'

If Cocodif cannot be installed, skip this step — the coverage.opencover.xml is still available for manual inspection.

Completion criterion: diff-coverage.md produced with per-file diff-coverage breakdown, or step skipped.