v1.0.0 — Initial stable release

[ericodx]

The first stable release of swift-mutation-testing — an AST-based CLI that finds untested behaviour in Swift codebases by systematically introducing code mutations and verifying that your test suite detects them.

---

What's included

Mutation pipeline

• Two-phase architecture: discovery (AST parsing + mutant identification + schematization) followed by execution (sandbox → build → test → results)
• Schema-based execution: all mutants are embedded behind a runtime switch and the project is built exactly once — no per-mutant recompilation
• The original project is never modified — all mutations happen inside an isolated sandbox in $TMPDIR
• Parallel test execution via withThrowingTaskGroup across cloned simulators
• Incompatible mutants (those that cannot be schematized) are handled in a sequential fallback path with one build per file

Mutation operators

• RelationalOperatorReplacement — replaces > >= < <= == !=
• BooleanLiteralReplacement — swaps true ↔ false
• LogicalOperatorReplacement — swaps && ↔ ||
• ArithmeticOperatorReplacement — replaces + - * / %
• NegateConditional — wraps conditions in !()
• SwapTernary — swaps ternary branches
• RemoveSideEffects — removes standalone function call statements

Platform support

• macOS — runs directly without a simulator
• iOS, tvOS, watchOS — parallel execution via a pool of cloned simulators
• Destination specified as a standard xcodebuild destination string

Developer experience

• swift-mutation-testing init generates a project-scoped .swift-mutation-testing.yml with auto-detected scheme and destination
• @SwiftMutationTestingDisabled attribute suppresses mutations within any function, type, or property scope
• --operator and --disable-mutator flags for per-run operator control
• --quiet flag for CI-friendly output
• --no-cache flag to force a full re-run

Reports

• Text summary always printed to stdout — per-file scores, survived mutants, and overall score
• JSON report (--output) in Stryker-compatible format
• Interactive HTML report (--html-output) with colour-coded per-file dashboards
• SonarQube Generic Issue Import report (--sonar-output) — survived mutants as MAJOR CODE_SMELL, no-coverage mutants as MINOR

Caching

• Results are persisted at .swift-mutation-testing-cache/results.json, keyed by SHA256 of source and test file contents
• Unchanged mutants are skipped entirely on subsequent runs

---

Requirements

• macOS 15+
• Swift 6.2+
• Xcode project with a valid scheme and test target

---

Installation

See the [Installation Guide](Docs/INSTALLATION.md) for Homebrew, pre-built binary, and build from source instructions.

---

What's Changed

• Repo setup by @ericodx in Repo setup #2
• Bootstrap by @ericodx in Bootstrap #3
• feat: CLI and configuration by @ericodx in feat: CLI and configuration #4
• feat: process launcher and sandbox by @ericodx in feat: process launcher and sandbox #5
• feat: build stage by @ericodx in feat: build stage #6
• feat: Simulator Pool by @ericodx in feat: Simulator Pool #7
• feat: Test Execution Stage by @ericodx in feat: Test Execution Stage #8
• feat: IncompatibleMutantExecutor by @ericodx in feat: IncompatibleMutantExecutor #9
• feat: PerFileBuildFallback by @ericodx in feat: PerFileBuildFallback #10
• Cache by @ericodx in Cache #11
• Reporting by @ericodx in Reporting #12
• MutantExecutor and wire @main entry point (Phase 10) by @ericodx in MutantExecutor and wire @main entry point (Phase 10) #13
• Validation and Integration by @ericodx in Validation and Integration #14
• Models and discovery layer by @ericodx in Models and discovery layer #15
• Operators infrastructure by @ericodx in Operators infrastructure #16
• Operators implementation by @ericodx in Operators implementation #17
• feat: add suppression annotation mechanism by @ericodx in feat: add suppression annotation mechanism #18
• feat: add discovery pipeline stages by @ericodx in feat: add discovery pipeline stages #19
• Schematization by @ericodx in Schematization #20
• feat: Phase 8 — DiscoveryPipeline integration by @ericodx in feat: Phase 8 — DiscoveryPipeline integration #21
• CLI update and self-contained entry point by @ericodx in CLI update and self-contained entry point #22
• test: Phase 10 — DiscoveryPipeline integration tests by @ericodx in test: Phase 10 — DiscoveryPipeline integration tests #23
• Performance baseline by @ericodx in Performance baseline #24
• test: cover critical attention points 6.1 and 6.3 by @ericodx in test: cover critical attention points 6.1 and 6.3 #25
• refactor: remove legacy --input mode and SMT integration code by @ericodx in refactor: remove legacy --input mode and SMT integration code #26
• Improve CLI and console experience by @ericodx in Improve CLI and console experience #27
• Fix mutant classification by @ericodx in Fix mutant classification #28
• Reports revision: relative paths, cache feedback, UX polish and score accuracy by @ericodx in Reports revision: relative paths, cache feedback, UX polish and score accuracy #29
• refactor: architecture review — dissolve Models, one type per file, reorganize directories by @ericodx in refactor: architecture review — dissolve Models, one type per file, reorganize directories #30
• refactor: Swift 6 strict concurrency audit and SOLID corrections by @ericodx in refactor: Swift 6 strict concurrency audit and SOLID corrections #31
• feat: enrich reports and simplify CLI invocation by @ericodx in feat: enrich reports and simplify CLI invocation #32
• Increase test coverage by @ericodx in Increase test coverage #33
• docs: add project documentation by @ericodx in docs: add project documentation #34
• Update swift-syntax by @ericodx in Update swift-syntax #35
• Code refinement: structural improvements and coverage expansion by @ericodx in Code refinement: structural improvements and coverage expansion #36
• CI/CD: workflows, Version enum and test coverage improvements by @ericodx in CI/CD: workflows, Version enum and test coverage improvements #37
• Fix main branch analysis by @ericodx in Fix main branch analysis #38
• Simplify workflows by @ericodx in Simplify workflows #39
• Update CI badge by @ericodx in Update CI badge #40

New Contributors

• @ericodx made their first contribution in Repo setup #2

Full Changelog: https://github.com/ericodx/swift-mutation-testing/commits/v1.0.0

---

This discussion was created from the release v1.0.0 — Initial stable release.