@intentsolutionsio/mutation-test-runner 1.0.0 → 1.0.5

package/agents/mutation-tester.md

@@ -1,6 +1,35 @@
 ---
 name: mutation-tester
 description: Validate test quality through mutation testing
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: orange
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- mutation
+- tester
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
 # Mutation Test Runner Agent
 
@@ -9,6 +38,7 @@ Validate test suite quality by introducing code mutations and verifying tests ca
 ## Mutation Testing Concept
 
 Mutation testing modifies ("mutates") code to check if tests detect the changes:
+
 - **Mutant killed**  - Test failed (good, caught the bug)
 - **Mutant survived**  - Test passed (bad, missed the bug)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/mutation-test-runner",
-  "version": "1.0.0",
+  "version": "1.0.5",
   "description": "Mutation testing to validate test quality by introducing code changes and verifying tests catch them",
   "keywords": [
     "testing",

package/skills/running-mutation-tests/SKILL.md

@@ -1,16 +1,21 @@
 ---
 name: running-mutation-tests
-description: |
-  Execute mutation testing to evaluate test suite effectiveness.
+description: 'Execute mutation testing to evaluate test suite effectiveness.
+
   Use when performing specialized testing.
-  Trigger with phrases like "run mutation tests", "test the tests", or "validate test effectiveness".
 
+  Trigger with phrases like "run mutation tests", "test the tests", or "validate test
+  effectiveness".
+
+  '
 allowed-tools: Read, Write, Edit, Grep, Glob, Bash(test:mutation-*)
 version: 1.0.0
 author: Jeremy Longshore <jeremy@intentsolutions.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [testing, mutation-tests]
+tags:
+- testing
+- mutation-tests
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # Mutation Test Runner
 
@@ -75,6 +80,7 @@ Execute mutation testing to evaluate the effectiveness of a test suite by system
 ## Examples
 
 **Stryker configuration for TypeScript project:**
+
 ```javascript
 // stryker.config.mjs
 export default {
@@ -89,6 +95,7 @@ export default {
 ```
 
 **Example surviving mutant and fix:**
+
 ```
 Mutant: src/utils/discount.ts:15 -- ConditionalExpression
   Original:  if (total > 100)
@@ -105,6 +112,7 @@ it('applies discount above 100', () => {
 ```
 
 **mutmut for Python:**
+
 ```bash
 # Run mutation testing
 mutmut run --paths-to-mutate=src/ --tests-dir=tests/
@@ -122,4 +130,4 @@ mutmut show 42
 - mutmut (Python): https://github.com/boxed/mutmut
 - PITest (Java): https://pitest.org/
 - go-mutesting: https://github.com/zimmski/go-mutesting
-- Mutation testing theory: https://en.wikipedia.org/wiki/Mutation_testing
+- Mutation testing theory: https://en.wikipedia.org/wiki/Mutation_testing

package/skills/running-mutation-tests/assets/mutation_report_template.md

@@ -143,12 +143,12 @@ def is_valid_email(email):
 
 **Example Recommendations:**
 
-*   **Increase Test Coverage:** Focus on adding tests to cover the areas identified by the surviving mutants and no coverage mutants.
-*   **Strengthen Assertions:** Review existing test assertions to ensure they are robust enough to detect subtle changes in behavior.
-*   **Test Edge Cases:**  Pay particular attention to testing edge cases and boundary conditions.
-*   **Refactor Code:** In some cases, the surviving mutants may indicate areas of code that are overly complex or difficult to test. Consider refactoring these areas to improve testability.
-*   **Improve Test Data:**  Ensure the test data used is diverse and representative of real-world scenarios.
+* **Increase Test Coverage:** Focus on adding tests to cover the areas identified by the surviving mutants and no coverage mutants.
+* **Strengthen Assertions:** Review existing test assertions to ensure they are robust enough to detect subtle changes in behavior.
+* **Test Edge Cases:**  Pay particular attention to testing edge cases and boundary conditions.
+* **Refactor Code:** In some cases, the surviving mutants may indicate areas of code that are overly complex or difficult to test. Consider refactoring these areas to improve testability.
+* **Improve Test Data:**  Ensure the test data used is diverse and representative of real-world scenarios.
 
 ## Conclusion
 
-`[Summarize the key findings and recommendations. Reiterate the importance of mutation testing as a tool for improving test suite effectiveness and ensuring code quality.  State the next steps for addressing the identified issues.]`
+`[Summarize the key findings and recommendations. Reiterate the importance of mutation testing as a tool for improving test suite effectiveness and ensuring code quality.  State the next steps for addressing the identified issues.]`

package/skills/running-mutation-tests/references/README.md

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for mutation-test-runner skill
-

package/skills/running-mutation-tests/scripts/README.md

@@ -6,6 +6,6 @@ Bundled resources for mutation-test-runner skill
 - [x] mutation_analyzer.py: Analyzes the mutation test results to identify weak coverage areas and suggest improvements.
 - [x] test_selector.py: Selects the most relevant tests to run based on the mutations introduced, optimizing testing time.
 
-
 ## Auto-Generated
+
 Scripts generated on 2025-12-10 03:48:17

package/skills/running-mutation-tests/scripts/mutation_analyzer.py

@@ -5,31 +5,25 @@ Analyzes the mutation test results to identify weak coverage areas and suggest i
 Generated: 2025-12-10 03:48:17
 """
 
-import os
 import json
 import argparse
 from pathlib import Path
-from typing import Dict, List
+from typing import Dict
 from datetime import datetime
 
+
 class Analyzer:
     def __init__(self, target_path: str):
         self.target_path = Path(target_path)
-        self.stats = {
-            'total_files': 0,
-            'total_size': 0,
-            'file_types': {},
-            'issues': [],
-            'recommendations': []
-        }
+        self.stats = {"total_files": 0, "total_size": 0, "file_types": {}, "issues": [], "recommendations": []}
 
     def analyze_directory(self) -> Dict:
         """Analyze directory structure and contents."""
         if not self.target_path.exists():
-            self.stats['issues'].append(f"Path does not exist: {self.target_path}")
+            self.stats["issues"].append(f"Path does not exist: {self.target_path}")
             return self.stats
 
-        for file_path in self.target_path.rglob('*'):
+        for file_path in self.target_path.rglob("*"):
             if file_path.is_file():
                 self.analyze_file(file_path)
 
@@ -37,38 +31,38 @@ class Analyzer:
 
     def analyze_file(self, file_path: Path):
         """Analyze individual file."""
-        self.stats['total_files'] += 1
-        self.stats['total_size'] += file_path.stat().st_size
+        self.stats["total_files"] += 1
+        self.stats["total_size"] += file_path.stat().st_size
 
         # Track file types
         ext = file_path.suffix.lower()
         if ext:
-            self.stats['file_types'][ext] = self.stats['file_types'].get(ext, 0) + 1
+            self.stats["file_types"][ext] = self.stats["file_types"].get(ext, 0) + 1
 
         # Check for potential issues
         if file_path.stat().st_size > 100 * 1024 * 1024:  # 100MB
-            self.stats['issues'].append(f"Large file: {file_path} ({file_path.stat().st_size // 1024 // 1024}MB)")
+            self.stats["issues"].append(f"Large file: {file_path} ({file_path.stat().st_size // 1024 // 1024}MB)")
 
         if file_path.stat().st_size == 0:
-            self.stats['issues'].append(f"Empty file: {file_path}")
+            self.stats["issues"].append(f"Empty file: {file_path}")
 
     def generate_recommendations(self):
         """Generate recommendations based on analysis."""
-        if self.stats['total_files'] == 0:
-            self.stats['recommendations'].append("No files found - check target path")
+        if self.stats["total_files"] == 0:
+            self.stats["recommendations"].append("No files found - check target path")
 
-        if len(self.stats['file_types']) > 20:
-            self.stats['recommendations'].append("Many file types detected - consider organizing")
+        if len(self.stats["file_types"]) > 20:
+            self.stats["recommendations"].append("Many file types detected - consider organizing")
 
-        if self.stats['total_size'] > 1024 * 1024 * 1024:  # 1GB
-            self.stats['recommendations'].append("Large total size - consider archiving old data")
+        if self.stats["total_size"] > 1024 * 1024 * 1024:  # 1GB
+            self.stats["recommendations"].append("Large total size - consider archiving old data")
 
     def generate_report(self) -> str:
         """Generate analysis report."""
         report = []
-        report.append("\n" + "="*60)
-        report.append(f"ANALYSIS REPORT - mutation-test-runner")
-        report.append("="*60)
+        report.append("\n" + "=" * 60)
+        report.append("ANALYSIS REPORT - mutation-test-runner")
+        report.append("=" * 60)
         report.append(f"Target: {self.target_path}")
         report.append(f"Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
         report.append("")
@@ -80,34 +74,37 @@ class Analyzer:
         report.append(f"  File Types: {len(self.stats['file_types'])}")
 
         # Top file types
-        if self.stats['file_types']:
+        if self.stats["file_types"]:
             report.append("\n📁 TOP FILE TYPES")
-            sorted_types = sorted(self.stats['file_types'].items(), key=lambda x: x[1], reverse=True)[:5]
+            sorted_types = sorted(self.stats["file_types"].items(), key=lambda x: x[1], reverse=True)[:5]
             for ext, count in sorted_types:
                 report.append(f"  {ext or 'no extension'}: {count} files")
 
         # Issues
-        if self.stats['issues']:
+        if self.stats["issues"]:
             report.append(f"\n⚠️  ISSUES ({len(self.stats['issues'])})")
-            for issue in self.stats['issues'][:10]:
+            for issue in self.stats["issues"][:10]:
                 report.append(f"  - {issue}")
-            if len(self.stats['issues']) > 10:
+            if len(self.stats["issues"]) > 10:
                 report.append(f"  ... and {len(self.stats['issues']) - 10} more")
 
         # Recommendations
-        if self.stats['recommendations']:
+        if self.stats["recommendations"]:
             report.append("\n💡 RECOMMENDATIONS")
-            for rec in self.stats['recommendations']:
+            for rec in self.stats["recommendations"]:
                 report.append(f"  - {rec}")
 
         report.append("")
         return "\n".join(report)
 
+
 def main():
-    parser = argparse.ArgumentParser(description="Analyzes the mutation test results to identify weak coverage areas and suggest improvements.")
-    parser.add_argument('target', help='Target directory to analyze')
-    parser.add_argument('--output', '-o', help='Output report file')
-    parser.add_argument('--json', action='store_true', help='Output as JSON')
+    parser = argparse.ArgumentParser(
+        description="Analyzes the mutation test results to identify weak coverage areas and suggest improvements."
+    )
+    parser.add_argument("target", help="Target directory to analyze")
+    parser.add_argument("--output", "-o", help="Output report file")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
 
     args = parser.parse_args()
 
@@ -127,8 +124,10 @@ def main():
     else:
         print(output)
 
-    return 0 if len(stats['issues']) == 0 else 1
+    return 0 if len(stats["issues"]) == 0 else 1
+
 
 if __name__ == "__main__":
     import sys
+
     sys.exit(main())