add-missing-unit-test

Skill: Add Missing Unit Test

You are tasked with adding a new unit test for a class that currently lacks one, or adding a new test case to an existing test file, to improve code coverage and reliability.

Objective

Add a new unit test for a class that currently lacks one, or add a new test case to an existing test file, to improve code coverage and reliability.

Workflow Instructions

1. Identify Target

• Choose a class in src/ that has complex logic but logic coverage is missing or incomplete.

2. Establish Baseline

• Run ./gradlew testClasses to compile all sources (production and test) and ensure the project is in a valid state.
• Run ./gradlew verifyPlugin to ensure no plugin verification issues exist.
• Run ./gradlew test (or specific test if it exists) to establish current pass/fail status.
• Run tests with Kover (./gradlew koverHtmlReport or ./gradlew koverXmlReport) to determine current coverage percentage for target class.

3. Implement Test

• Create a new test class ([ClassName]Test) in testSrc/ if it doesn't exist.
• Add test cases to cover specific methods, edge cases, and branches.
• Ensure the test follows project testing conventions (naming, mocking, assertions).

4. Verify

• Run ./gradlew testClasses to ensure new test compiles.
• Run new test (and related tests) to ensure it passes.
• Run ./gradlew verifyPlugin to ensure no regressions in plugin verification.
• Run Kover again to confirm coverage improvement.

5. Report & Review

• Summarize test added and coverage improvement.
• Test Location: Explicitly state where in the IDE user should go to test changed functionality (e.g., "Run the new test file [TestFileName]").
• Action: Ask user to review new test closely. Validate that code being tested is actively used (e.g., check that it is not dead code/0 references).
• Do not commit or push.
• Provide a suggested Git commit message, explicitly including the Kover coverage improvement:
  • Example Pattern: Add unit tests for [Class Name]. Coverage verified using Kover. Coverage improvement: [Class Name]: ~[X]% line coverage ([Y] covered, [Z] uncovered).