Skip to content

v1.3.7

Choose a tag to compare

@rawveg rawveg released this 15 Jul 09:52
· 5 commits to main since this release

Release Notes – v1.3.7

🚀 Highlights

This release marks a major leap forward for the openapi-directory-mcp project in code quality, test robustness, and automation maturity. The v1.3.7 milestone delivers industry-leading quality assurance, advanced CI/CD validation, and a new focus on security-critical mutation testing, establishing a new bar for reliability and maintainability.


✨ What's New

🧬 Comprehensive Mutation Testing

  • Advanced Mutation Testing Integration

    • Introduces mutation testing as a first-class quality gate in CI, focusing on security-critical modules (src/utils/validation.ts, src/utils/logger.ts).
    • Validates that tests effectively catch injected faults for XSS prevention, SQL injection, and input sanitization.
    • Mutation test reports are uploaded as artifacts for every run, with HTML and Markdown summaries for quick insights.
  • Weekly Automated Coverage

    • New .github/workflows/mutation-testing.yml runs full mutation testing weekly, generating detailed security-focused analysis and opening issues for low mutation scores.
    • Quality metrics are benchmarked against industry standards (70%+ for validation, 60%+ for logging/security).
  • Pull Request Mutation Comments

    • Automated comments on pull requests summarize mutation testing results, highlighting surviving mutants and areas for improvement.

✅ Post-Release Validation Workflow

  • Automated NPM Registry Validation
    • New .github/workflows/post-release-validation.yml waits for NPM propagation, then validates:
      • Package availability and installation.
      • CLI tool functionality (npx openapi-directory-mcp --help).
      • Published metadata (version, license, author).
    • Automated issue creation on validation failure, with self-healing detection when the registry update completes.

🏗️ CI/CD Pipeline Enhancements

  • CI Workflow Upgrades

    • Regression and integration test jobs now check for exact “Success Rate: 100.0%” output, improving consistency.
    • CLI functionality is explicitly tested as part of the release process, ensuring usability for end-users.
    • Artifact uploads for mutation and regression test runs streamline debugging and historic analysis.
  • All-Checks Job

    • Now depends on the new mutation-testing workflow, ensuring mutation quality is always visible in the full build status.
    • Reports on the success or warnings from mutation testing without blocking the full release, encouraging continuous improvement.

📝 Developer Experience & Documentation

  • Mutation and Release Documentation
    • Auto-generated mutation and post-release validation summaries are available in build artifacts for audit and learning.
    • Detailed README updates and new markdown documentation for deployment, changelog, release, rollback, and CI/CD setup (via Claude command suite).

🛡️ Security & Quality Focus

  • Security as a Code Quality Milestone

    • Security validation is now directly measured by mutation test survival in critical code paths, quantifying real-world protection.
    • Logger and input validation modules are continuously assessed for resilience against attack vectors and sensitive data leaks.
  • Automated Quality Regression Prevention

    • All critical paths (validation, logging, CLI, package release) are now validated by automated, reproducible workflows.
    • Human error and accidental regressions are dramatically reduced by layered, automated gates.

Full Changelog: v1.3.6...v1.3.7