add-unit-test

Add unit tests for an untested function. Category: testing. Scope: small.

omot bench start add-unit-test --param file=src/utils/format.ts --param function=formatPrice --agent <your-agent>

ParametersCopy Anchor Link

PreconditionsCopy Anchor Link

• A test script (scripts.test) and a test runner.
• The named file exists and contains the named function.

OutcomesCopy Anchor Link

• pass: New or changed test files reference the function, the test script passes, and, when omot can inject bugs into the function (up to three operator flips), the tests catch at least one bug not already caught by baseline tests; no non-test files changed.
• partial: Tests were added and pass, but non-test files changed, test files were deleted, or the tests caught none of the injected bugs not already caught by baseline tests.
• fail: No test files were added or changed, or the test script fails.

How it is verifiedCopy Anchor Link

• A test file is any *.test.*/*.spec.* file, .snap file, or file under test/, tests/, or __tests__/.
• Compares the working tree (including uncommitted and untracked files) with the baseline commit.
• Checks that a changed test file imports the target (including extensionless, index, and @//~/ aliases), uses the function in code, and adds at least one test case in a file that uses the function; comments and strings do not count.
• Requires scripts.test and verifies it passes at the baseline before starting. If it is missing, omot scan --fix can generate the test script and other CI pieces.
• Runs the test script after changes; the start-time test result is retained as baseline health.
• Mutation check: finds the function body with a source-offset-preserving lexical mask, flips up to three supported operators inside it, and runs the full test script once per flip. Boolean literals in type positions are excluded. If a mutant is caught, it reruns the suite with changed tests restored to baseline content and added test files removed; mutants caught by those baseline-only tests are excluded from the count. All changed test files and the source file are restored byte-for-byte, including line endings. The check is skipped when no body or supported operator is found, or when baseline tests already catch every mutant.

The prompt and verifier live in packages/benchmarks/src/tasks/add-unit-test. Changing either requires a version bump in task.json.