/configure:coverage

Check and configure code coverage thresholds and reporting for test frameworks.

When to Use This Skill

Context

• Project root: !pwd
• Package files: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' \) 2>/dev/null
• Vitest config: !find . -maxdepth 1 -name 'vitest.config.*' 2>/dev/null
• Jest config: !find . -maxdepth 1 -name 'jest.config.*' 2>/dev/null
• Coverage dir: !find . -maxdepth 1 -type d -name 'coverage' 2>/dev/null
• Codecov config: !find . -maxdepth 1 \( -name 'codecov.yml' -o -name '.codecov.yml' \) 2>/dev/null
• Project standards: !find . -maxdepth 1 -name '.project-standards.yaml' 2>/dev/null

Parameters

Parse from command arguments:

• --check-only: Report compliance status without modifications (CI/CD mode)
• --fix: Apply fixes automatically without prompting
• --threshold <percentage>: Set coverage threshold (default: 80)

Default threshold: 80% (lines, branches, functions, statements)

Supported frameworks:

• Vitest: @vitest/coverage-v8 or @vitest/coverage-istanbul
• Jest: Built-in coverage with --coverage
• pytest: pytest-cov plugin
• Rust: cargo-llvm-cov or cargo-tarpaulin

Execution

Execute this code coverage compliance check:

Step 1: Detect test framework and coverage configuration

Check for framework indicators:

Use WebSearch or WebFetch to verify latest versions of coverage tools before configuring.

Step 2: Analyze current coverage state

For the detected framework, check configuration completeness:

Vitest:

• Coverage provider configured (v8 or istanbul)
• Coverage reporters configured (text, json, html, lcov)
• Thresholds set for lines, functions, branches, statements
• Exclusions configured (node_modules, dist, tests, config files)
• Output directory specified

Jest:

• collectCoverage enabled
• coverageProvider set (v8 or babel)
• collectCoverageFrom patterns configured
• coverageThresholds configured
• coverageReporters configured

pytest:

• pytest-cov installed
• [tool.coverage.run] section exists
• [tool.coverage.report] section exists
• Coverage threshold configured (--cov-fail-under)

Rust (cargo-llvm-cov):

• cargo-llvm-cov installed
• Coverage configuration in workspace
• HTML/LCOV output configured

Step 3: Generate compliance report

Print a formatted compliance report:

Code Coverage Compliance Report
================================
Project: [name]
Framework: [Vitest 2.x | pytest 8.x | cargo-llvm-cov 0.6.x]

Coverage Configuration:
  Provider                @vitest/coverage-v8        [CONFIGURED | MISSING]
  Reporters               text, json, html, lcov     [ALL | PARTIAL]
  Output directory        coverage/                  [CONFIGURED | DEFAULT]
  Exclusions              node_modules, dist, tests  [CONFIGURED | INCOMPLETE]

Thresholds:
  Lines                   80%                        [PASS | LOW | NOT SET]
  Branches                80%                        [PASS | LOW | NOT SET]
  Functions               80%                        [PASS | LOW | NOT SET]
  Statements              80%                        [PASS | LOW | NOT SET]

CI/CD Integration:
  Coverage upload         codecov/coveralls          [CONFIGURED | MISSING]
  Artifact upload         coverage reports           [CONFIGURED | MISSING]

Overall: [X issues found]

If --check-only, stop here.

Step 4: Configure coverage (if --fix or user confirms)

Apply coverage configuration based on detected framework. Use templates from REFERENCE.md:

1. Install coverage provider (e.g., @vitest/coverage-v8, pytest-cov)
2. Update config file with thresholds, reporters, exclusions
3. Add scripts to package.json or pyproject.toml
4. Configure CI/CD with Codecov upload and artifact storage

Step 5: Update standards tracking

Update .project-standards.yaml:

standards_version: "2025.1"
last_configured: "[timestamp]"
components:
  coverage: "2025.1"
  coverage_threshold: 80
  coverage_provider: "[v8|istanbul|pytest-cov|llvm-cov]"
  coverage_reporters: ["text", "json", "html", "lcov"]
  coverage_ci: "codecov"

Step 6: Print final report

Print a summary of changes applied, scripts added, and next steps for verifying coverage.

For detailed configuration templates, see REFERENCE.md.

Agentic Optimizations

Flags

Examples

# Check compliance and offer fixes
/configure:coverage

# Check only, no modifications
/configure:coverage --check-only

# Auto-fix with custom threshold
/configure:coverage --fix --threshold 90

Error Handling

• No test framework detected: Suggest running /configure:tests first
• Coverage provider missing: Offer to install
• Invalid threshold: Reject values <0 or >100
• CI token missing: Warn about Codecov/Coveralls setup

See Also

• /configure:tests - Configure testing frameworks
• /test:coverage - Run tests with coverage
• /configure:all - Run all compliance checks
• Codecov documentation: https://docs.codecov.com
• pytest-cov documentation: https://pytest-cov.readthedocs.io