Mutation Testing OMP

A 5-agent mutation testing system for Kotlin (JVM-first) projects, powered by mutflow and built on the OMP agent/task/skill architecture.

This ports Scott-CC's multi-agent orchestration to OMP, adapting from per-mutant git worktrees to mutflow's compile-once meta-mutant approach.

Quick start

# 1. Install the system into your Kotlin project
./.omp/bootstrap-mutation-testing.sh /path/to/kotlin-project

# 2. Run mutation testing
omp mutation-test /path/to/kotlin-project

Prerequisites: Java 21+, Gradle 9.x, Kotlin 2.4.x.

See the documentation index for tutorials, how-to guides, and reference material.

Sample project

The sample/ directory contains a reference Kotlin project with a Calculator class at 100% mutation coverage (31/31 mutations killed, Excellent band, Medium confidence). Run gradle mutationResults in sample/ to reproduce.

The sample exercises all mutation strategies including validateInput, which throws IllegalArgumentException — demonstrating exception type mutation support via the fork.

Known limitations

• Kotlin Multiplatform (JVM-first): mutflow is JVM-only. The --kmp bootstrap flag targets JVM source sets only.
• Upstream mutflow: Exception type swap and full per-test-per-mutation zombie detection are implemented in the fork (PR #16, PR #17), pending upstream merge.

See CONTEXT.md for details.