pymutant-mcp 2026-03-08
Initial prerelease hardening with restructured package layout and expanded CI
108 files · 10,191+ · 2,593-

Flatten package layout from server/ to src/

decouple architectural
5 files changed
  • __init__.py Moved from server/src/pymutant/ to src/pymutant/
  • main.py Consolidated main entry point with new MCP tools
  • api.py Runner API relocated from server subtree
  • helpers.py Runner helpers relocated from server subtree
  • pyproject.toml Updated build config to single-package layout with dev dependency groups
  • Removed server/ subdirectory and pyproject.toml; all pymutant source now lives under src/pymutant decouple architectural
    3 files
    • __init__.py
    • main.py
    • pyproject.toml
  • Moved Claude commands and skills into .claude/ directory from top-level commands/ and skills/ decouple internal
    3 files
    • mutation-analyze.md
    • mutation-run.md
    • SKILL.md

Add new mutation analysis modules

instantiate behavioral
10 files changed
  • baseline.py Execution-baseline tracking with fingerprint and drift detection
  • config.py Centralized runtime config via environment variables
  • failure_explain.py Classify failure sources and suggest remediation
  • patch_suggest.py Generate pytest patch suggestions for surviving mutants
  • policy.py Policy gate evaluation with baseline-drop and absolute floor
  • prioritization.py Rank survivors by impact, frequency, and churn priority
  • profiles.py Profile resolution from CLI, env, or config file
  • quarantine.py Quarantine management for flaky mutants
  • reporting.py HTML report bundle renderer
  • trends.py Mutation drift and regression summary from score history
  • Added nine new feature modules covering baseline tracking, policy gating, trend reporting, quarantine, and prioritization instantiate behavioral
    5 files
    • baseline.py
    • policy.py
    • trends.py
    • prioritization.py
    • quarantine.py
  • Introduced runtime config module centralizing all PYMUTANT_* environment variable access instantiate internal
    1 file
    • config.py

Expand CI and pre-commit quality gates

harden behavioral
3 files changed
  • ci.yml Added multi-Python matrix (3.11-3.15), compliance job, mutation-gate job, and MCP smoke step
  • release-readiness.yml Added MCP smoke, schema validation, and HTML report rendering
  • .pre-commit-config.yaml Added max-LOC, SPDX header, event literal, pytest, schema validation, and mutation-sweep hooks
  • CI now tests across Python 3.11 through 3.15 with separate quality and compliance jobs harden behavioral
    1 file
    • ci.yml
  • Added zero-survivor mutation gate enforced on push and pull request events harden behavioral
    1 file
    • ci.yml
  • Pre-commit suite expanded with max-LOC guard, SPDX header check, xenon complexity with baseline, and JSON schema validation harden internal
    1 file
    • .pre-commit-config.yaml

Add CI policy baselines and JSON schemas

baseline internal
7 files changed
  • pymutant-policy-baseline.json Policy baseline with default profile score floor
  • pymutant-profiles.json Mutation root paths and policy thresholds
  • xenon-baseline.json Complexity violation allowlist
  • max-loc-baseline.json File size exception list
  • baseline-state.schema.json JSON schema for baseline state artifacts
  • benchmark-quality.schema.json JSON schema for quality benchmark output
  • benchmark-throughput.schema.json JSON schema for throughput benchmark output
  • Added six JSON schemas for CI artifact validation and five CI baseline config files baseline internal
    3 files
    • baseline-state.schema.json
    • pymutant-policy-baseline.json
    • pymutant-profiles.json

Comprehensive test suite expansion

qualify behavioral
6 files changed
  • test_helpers.py 624 lines of runner helper unit tests
  • test_run_api_core.py 543 lines of core run API tests
  • test_baseline_state.py Baseline state management tests
  • test_feature_modules.py Tests for new feature modules
  • test_main_api.py MCP tool endpoint tests
  • test_mutation_gate_cli.py Mutation gate CLI integration tests
  • Reorganized test suite from flat tests/ into tests/pymutant/ and tests/repo_verify/ with feature-scoped modules qualify behavioral
    3 files
    • test_helpers.py
    • test_baseline_state.py
    • test_mutation_gate_cli.py
  • Removed legacy flat test files (test_runner.py, test_main.py, test_init.py, test_score.py) qualify internal
    4 files
    • test_runner.py
    • test_main.py
    • test_init.py
    • test_score.py

Add verification and mutation gate tooling

instantiate behavioral
3 files changed
  • mutation_gate.py Zero-survivor mutation gate with changed-only targeting
  • mcp_smoke.py MCP smoke test for root/setup/run path validation
  • benchmark.py Extended benchmark with quality cold-start and artifact compaction
  • Added mutation-gate CLI that enforces zero surviving mutants on changed files instantiate behavioral
    1 file
    • mutation_gate.py
  • Added MCP smoke test verifying server startup and tool availability instantiate behavioral
    1 file
    • mcp_smoke.py

Documentation and operational guides

specify external
5 files changed
  • operator-runbook.md Operational runbook for CI maintenance
  • policy-tooling-plan.md Policy tooling design plan
  • reporting-artifacts.md CI artifact inventory and descriptions
  • README.md Updated for MCP server identity, installation via uvx, and new tool inventory
  • AGENTS.md Updated project structure and build commands for flat layout
  • README rewritten to describe pymutant as an MCP server rather than Claude Code plugin specify external
    1 file
    • README.md
  • Added operator runbook and policy tooling plan documentation specify external
    2 files
    • operator-runbook.md
    • policy-tooling-plan.md
changelog → 2026-03-09 pymutant-mcp →