Validate-Tests 150 Protocol

Goal

Cover current uncommitted changes with meaningful tests at >70% coverage (including the changed lines) and confirm the entire test suite is green.

Workflow

1. Identify current changes

   • Check staged and unstaged changes (

     git status

     ).
   • List changed files (

     git diff --name-only

     and

     git diff --name-only --staged

     ).
   • Focus testing on these files and their direct dependencies.

2. Find the coverage command

   • Check

     package.json

     scripts for

     test

     ,

     coverage

     , or

     ci

     .
   • If unclear, search for Jest/Vitest config files and default coverage options.

3. Run coverage

   • Execute the project’s coverage command.
   • Save the exact overall percentage and per‑file coverage for changed files (lines/branches).
   • Passing tests ≠ coverage: verify that the changed lines are executed (use coverage reports to confirm).

4. Prioritize targets

   • Start with changed files that are <70% covered.
   • Prefer pure functions, utilities, and deterministic logic.

5. Add tests

   • Write tests that directly exercise the changed logic/markup and assert behavior, edge cases, and failure paths.
   • Prefer behavior- or structure-level assertions that map to the changed lines (e.g., DOM structure/classes for UI changes).
   • Avoid snapshot‑only tests unless behavior is visual and stable.

6. Re‑run coverage

   • Confirm each changed file is > 70% covered (lines/branches where available).
   • Confirm the specific changed lines are covered (use coverage reports or direct evidence in tests).
   • If coverage tooling only provides overall numbers, explain the limitation and justify how tests exercise the changed code.
   • If not met, repeat steps 4–6.

7. Run full test suite

   • Execute the standard full test command for the repo (not just a subset).
   • Ensure all tests are green.

8. Run lint

   • Execute the standard lint command for the repo.
   • Ensure lint is green and fix lint errors introduced or surfaced in the process.
   • Do not leave lint in a failing state.

9. Run compile

   • Execute the standard compile command for the repo

     npm run compile

     or

     tsc --noEmit

     , best way is from root directory

     npm run test && npm run lint:full

   • Ensure compile is green and fix compile errors introduced or surfaced in the process.
   • Do not leave compile in a failing state.

10. Report

• Summarize added tests, coverage changes, and full test results.
• Note any files intentionally excluded or skipped and why.

Validation checklist

• Staged and unstaged changes identified.
• Coverage command found and recorded.
• Baseline coverage captured.
• Tests added for changed files and direct dependencies.
• Changed files are >70% covered (lines/branches where available).
• Full test suite executed.
• All tests are green.
• Lint executed and green.
• Compile executed and green.

Output expectations

• Provide the command used to measure coverage, to run the full test suite, and to run lint.
• Provide before/after coverage numbers and per‑file coverage for changed files.
• Explicitly state how the changed lines are exercised by the tests.
• List which files were targeted and why.
• Confirm the final threshold is met for changed files, or report remaining gaps.
• Confirm all tests and lint are green.
• Confirm compile is green.