dc3-coverage is a report-only Maven module. It aggregates JaCoCo execution data from the covered handwritten-code modules and applies the repository's absolute coverage gate.

Generate and Verify the Report

From the repository root:

make coverage

Equivalent Maven command:

mvn -s .mvn/settings.xml -B -Dmaven.test.skip=false -pl dc3-coverage -am verify

Outputs:

HTML: dc3-coverage/target/site/jacoco-aggregate/index.html
XML: dc3-coverage/target/site/jacoco-aggregate/jacoco.xml

Gate

The minimum line and branch ratios are configured in this module's pom.xml. The verify phase passes the aggregate XML to scripts/check_coverage.py, which checks those absolute thresholds.

There is currently no baseline-relative regression calculation. Do not describe the build as enforcing a percentage drop against a previous commit unless such a comparison is implemented.

Use -Dcoverage.check.skip=true only for local diagnosis; do not disable the gate in normal CI or release validation.

Adding covered modules

Add a dependency in pom.xml only for a module whose handwritten classes should contribute to the aggregate. Generated API artifacts and deployment-only wrappers should remain excluded unless the coverage policy changes deliberately.