# PMAT v2.177.0: Mutation Testing Documentation Complete

Sprint 64 delivers comprehensive mutation testing documentation across 6,486+ lines.

## What's New

### Mutation Testing Documentation (Sprint 64 Complete)

**Comprehensive Guides** (2,769 lines):
- 📖 **User Guide** (750+ lines): Complete walkthrough from basics to advanced usage
- 📋 **API Reference** (1,050 lines): All CLI flags and options documented
- 🏆 **Best Practices** (969 lines): Team adoption strategies and performance optimization

**CI/CD Integration** (3,340 lines):
- ⚙️ **GitHub Actions** (680+ lines): Workflows, matrix builds, PR commenting
- 🦊 **GitLab CI** (1,204 lines): Pipelines, MR widgets, scheduled runs
- 🔧 **Jenkins** (1,456 lines): Declarative/scripted pipelines, shared libraries

**Example Projects** (1,225+ lines):
- 🦀 **Rust Example**: 8 functions, 8 tests, ~90% mutation score
- 🐍 **Python Example**: 8 functions, 24 tests, comprehensive coverage
- 📘 **TypeScript Example**: 8 functions, 24 tests, Jest integration

**Total**: 6,486+ lines of documentation and examples

## Key Features

- Multi-language mutation testing (Rust, Python, TypeScript, JavaScript, Go, C++)
- Quality gates with configurable thresholds
- Performance optimization (parallel execution, differential testing)
- CI/CD integration (GitHub Actions, GitLab CI, Jenkins)
- 3-phase team adoption roadmap
- Comprehensive troubleshooting and FAQ

## Documentation

- [Mutation Testing User Guide](../../docs/docs/guides/mutation-testing.md)
- [CLI API Reference](../../docs/docs/guides/mutation-testing-api-reference.md)
- [Best Practices Guide](../../docs/docs/guides/mutation-testing-best-practices.md)
- [GitHub Actions Integration](../../docs/docs/ci-cd/github-actions-integration.md)
- [GitLab CI Integration](../../docs/docs/ci-cd/gitlab-ci-integration.md)
- [Jenkins Integration](../../docs/docs/ci-cd/jenkins-integration.md)
- [Rust Example](../../examples/rust-mutation-testing/)
- [Python Example](../../examples/python-mutation-testing/)
- [TypeScript Example](../../examples/typescript-mutation-testing/)

## Installation

```bash
# Rust (recommended)
cargo install pmat

# macOS/Linux
brew install pmat

# Windows
choco install pmat

# npm (global)
npm install -g pmat-agent
```

## Quick Start

```bash
# Basic mutation testing
pmat mutate --target src/lib.rs

# With quality gate (fail if score < 85%)
pmat mutate --target src/ --threshold 85

# Failures only (CI/CD optimization)
pmat mutate --target src/ --failures-only

# JSON output for integration
pmat mutate --target src/ --output-format json > results.json
```

## Contributors

- Claude (AI Pair Programmer)
- Noah Gift (PAIML)

## Full Changelog

https://github.com/paiml/paiml-mcp-agent-toolkit/blob/master/CHANGELOG.md
