Files
ECC/pi/core/commands/test-coverage.md
T
Affaan MustafaandGitHub c70874fae9 feat(pi): curated pi/core skills+prompts profile, CI load test, and 2.2.2 release sync (#3264)
Adds a curated, Pi-native, skills+prompts-only profile at pi/core/ for downstream packagers that mirror GitHub Releases.

- manifests/pi-core.json: explicit include lists, per-item exclusion reasons, curation rules, safety allowlists; every root skill and command must be classified.
- scripts/build-pi-core.js regenerates pi/core deterministically (package.json from VERSION, LICENSE, README.md, CURATION.md, skills/, commands/); --check fails CI on drift. council is renamed ecc-council inside pi/core only.
- Safety checks: no callable endpoints outside the allowlist, no npx/curl|sh/pip install, no secrets, no absolute home paths, no symlinks, valid frontmatter, no duplicate names.
- CI: build + drift check and an offline Pi CLI load test of pi/core.
- Release: VERSION, package.json and pi/core/package.json at 2.2.2, CHANGELOG, tag-triggered release verification, and a two-week cadence in CONTRIBUTING.md.

pi/core: 123 of 293 skills and 24 of 94 commands; 35,006 characters of skill description text.
2026-09-29 20:24:05 -05:00

2.7 KiB

description
description
Analyze coverage, identify gaps, and generate missing tests toward the target threshold.

Test Coverage

Analyze test coverage, identify gaps, and generate missing tests to reach 80%+ coverage.

Step 1: Detect Test Framework

Indicator Coverage Command
jest.config.* or package.json jest npx jest --coverage --coverageReporters=json-summary
vitest.config.* npx vitest run --coverage
pytest.ini / pyproject.toml pytest pytest --cov=src --cov-report=json
Cargo.toml cargo llvm-cov --json
pom.xml with JaCoCo mvn test jacoco:report
go.mod go test -coverprofile=coverage.out ./...

Step 2: Analyze Coverage Report

  1. Run the coverage command
  2. Parse the output (JSON summary or terminal output)
  3. List files below 80% coverage, sorted worst-first
  4. For each under-covered file, identify:
    • Untested functions or methods
    • Missing branch coverage (if/else, switch, error paths)
    • Dead code that inflates the denominator

Step 3: Generate Missing Tests

For each under-covered file, generate tests following this priority:

  1. Happy path — Core functionality with valid inputs
  2. Error handling — Invalid inputs, missing data, network failures
  3. Edge cases — Empty arrays, null/undefined, boundary values (0, -1, MAX_INT)
  4. Branch coverage — Each if/else, switch case, ternary

Test Generation Rules

  • Place tests adjacent to source: foo.ts → foo.test.ts (or project convention)
  • Use existing test patterns from the project (import style, assertion library, mocking approach)
  • Mock external dependencies (database, APIs, file system)
  • Each test should be independent — no shared mutable state between tests
  • Name tests descriptively: test_create_user_with_duplicate_email_returns_409

Step 4: Verify

  1. Run the full test suite — all tests must pass
  2. Re-run coverage — verify improvement
  3. If still below 80%, repeat Step 3 for remaining gaps

Step 5: Report

Show before/after comparison:

Coverage Report
──────────────────────────────
File                   Before  After
src/services/auth.ts   45%     88%
src/utils/validation.ts 32%    82%
──────────────────────────────
Overall:               67%     84%  PASS:

Focus Areas

  • Functions with complex branching (high cyclomatic complexity)
  • Error handlers and catch blocks
  • Utility functions used across the codebase
  • API endpoint handlers (request → response flow)
  • Edge cases: null, undefined, empty string, empty array, zero, negative numbers