mutation-test

# zuvo:mutation-test -- LLM-Guided Mutation Testing Intelligent mutation testing that targets meaningful behavioral gaps rather than random code changes. For each production file, the LLM generates mutations in 7 categories (boundary, logic, null, error, state, async, security), runs only the tests that cover that file, and reports which mutations survived -- revealing exactly where tests need strengthening. **Scope:** Production files that have associated test files. Measures how well existing tests detect real behavioral changes. **When to use:** After writing tests, before releases, when mutation score is unknown, when test suite feels shallow despite high line coverage. **Out of scope:** Writing new tests (use `zuvo:write-tests`), fixing systematic test anti-patterns (use `zuvo:fix-tests`), auditing test quality without execution (use `zuvo:test-audit`), code quality review (use `zuvo:review`). ## Argument Parsing Parse `$ARGUMENTS` as: `[path | full] [--max N] [--category CATEGORY] [--dry-run] [--quick]` | Flag | Effect | |------|--------| | `[path]` | Scope to a specific directory or file | | `full` | All production files that have test coverage | | `--max N` | Max total mutations to execute (default: 50) | | `--category CATEGORY` | Only generate mutations of this category: `BOUNDARY`, `LOGIC`, `NULL`, `ERROR`, `STATE`, `ASYNC`, `SECURITY` | | `--dry-run` | Generate mutations and show the plan, but do not execute any | | `--quick` | Max 3 mutations per file, max 20...