@intentsolutionsio/performance-test-suite 1.0.0 → 1.0.5

package/README.md

@@ -64,6 +64,7 @@ export let options = {
 ```
 
 **Validates:**
+
 - Normal performance under expected load
 - Response times remain acceptable
 - Error rates stay low
@@ -87,6 +88,7 @@ export let options = {
 ```
 
 **Validates:**
+
 - Maximum capacity before failure
 - Graceful degradation under stress
 - Recovery after overload
@@ -109,6 +111,7 @@ export let options = {
 ```
 
 **Validates:**
+
 - Auto-scaling response
 - Rate limiting effectiveness
 - System stability during surge
@@ -130,6 +133,7 @@ export let options = {
 ```
 
 **Validates:**
+
 - Memory leaks over time
 - Resource exhaustion
 - Connection pool issues
@@ -165,24 +169,28 @@ export let options = {
 The agent identifies common performance issues:
 
 ### High CPU Usage
+
 - Inefficient algorithms
 - Missing caching
 - Excessive computations
 - Unoptimized loops
 
 ### High Memory Usage
+
 - Memory leaks
 - Large object retention
 - Inefficient data structures
 - Missing garbage collection
 
 ### Slow Database
+
 - N+1 query problems
 - Missing indexes
 - Inefficient queries
 - Connection pool exhaustion
 
 ### Network Saturation
+
 - Large response payloads
 - Missing compression
 - Too many requests

package/agents/performance-tester.md

@@ -11,6 +11,7 @@ You are a performance testing specialist that designs and executes load tests, a
 ## Your Capabilities
 
 ### 1. Load Testing
+
 - **Gradual ramp-up** - Incrementally increase load
 - **Sustained load** - Constant traffic over time
 - **Peak load** - Maximum capacity testing
@@ -18,24 +19,28 @@ You are a performance testing specialist that designs and executes load tests, a
 - **Think time** - Realistic user behavior patterns
 
 ### 2. Stress Testing
+
 - **Breaking point identification** - Find maximum capacity
 - **Graceful degradation** - Verify failure handling
 - **Recovery testing** - System recovery after overload
 - **Resource saturation** - CPU, memory, disk, network limits
 
 ### 3. Spike Testing
+
 - **Sudden traffic surges** - Rapid load increases
 - **Flash sale scenarios** - High-traffic events
 - **Auto-scaling validation** - Infrastructure response
 - **Rate limiting** - Throttling effectiveness
 
 ### 4. Endurance Testing (Soak Testing)
+
 - **Memory leaks** - Long-running stability
 - **Resource exhaustion** - Gradual degradation
 - **Connection pool issues** - Resource management
 - **Database connection leaks** - Connection handling
 
 ### 5. Metrics Analysis
+
 - **Response times** - P50, P95, P99 percentiles
 - **Throughput** - Requests per second
 - **Error rates** - Success vs failure ratio
@@ -45,6 +50,7 @@ You are a performance testing specialist that designs and executes load tests, a
 ## When to Activate
 
 Activate when the user needs to:
+
 - Perform load or stress testing
 - Benchmark application performance
 - Identify performance bottlenecks
@@ -220,6 +226,7 @@ class WebsiteUser(HttpUser):
 ## Metrics to Report
 
 ### Response Time Metrics
+
 - **Average** - Mean response time
 - **Median (P50)** - 50th percentile
 - **P95** - 95% of requests faster than this
@@ -227,16 +234,19 @@ class WebsiteUser(HttpUser):
 - **Max** - Slowest request
 
 ### Throughput Metrics
+
 - **Requests/second** - Total throughput
 - **Data transferred** - Bandwidth usage
 - **Concurrent users** - Active connections
 
 ### Error Metrics
+
 - **Error rate** - Percentage of failed requests
 - **Error types** - Breakdown by HTTP status
 - **First error** - When errors started appearing
 
 ### Resource Metrics
+
 - **CPU usage** - Average and peak
 - **Memory usage** - Average and peak
 - **Network I/O** - Bandwidth utilization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/performance-test-suite",
-  "version": "1.0.0",
+  "version": "1.0.5",
   "description": "Load testing and performance benchmarking with metrics analysis and bottleneck identification",
   "keywords": [
     "testing",

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

@@ -1,16 +1,22 @@
 ---
 name: running-performance-tests
-description: |
-  Execute load testing, stress testing, and performance benchmarking.
+description: 'Execute load testing, stress testing, and performance benchmarking.
+
   Use when performing specialized testing.
-  Trigger with phrases like "run load tests", "test performance", or "benchmark the system".
 
+  Trigger with phrases like "run load tests", "test performance", or "benchmark the
+  system".
+
+  '
 allowed-tools: Read, Write, Edit, Grep, Glob, Bash(test:perf-*)
 version: 1.0.0
 author: Jeremy Longshore <jeremy@intentsolutions.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [testing, performance, performance-tests]
+tags:
+- testing
+- performance
+- performance-tests
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # Performance Test Suite
 
@@ -79,6 +85,7 @@ Execute load testing, stress testing, and performance benchmarking to identify b
 ## Examples
 
 **k6 load test script:**
+
 ```javascript
 import http from 'k6/http';
 import { check, sleep } from 'k6';
@@ -107,6 +114,7 @@ export default function () {
 ```
 
 **Artillery test configuration:**
+
 ```yaml
 config:
   target: "https://api.test.com"
@@ -137,4 +145,4 @@ scenarios:
 - Locust (Python): https://docs.locust.io/
 - Apache JMeter: https://jmeter.apache.org/
 - autocannon (Node.js): https://github.com/mcollina/autocannon
-- Performance testing best practices: https://grafana.com/blog/2024/01/30/load-testing-best-practices/
+- Performance testing best practices:

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

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for performance-test-suite skill
-

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

@@ -6,6 +6,6 @@ Bundled resources for performance-test-suite skill
 - [x] run_test.sh: Script to execute the performance test using k6 or other tools.
 - [x] analyze_results.py: Script to analyze the test results and generate a report.
 
-
 ## Auto-Generated
+
 Scripts generated on 2025-12-10 03:48:17

package/skills/running-performance-tests/scripts/analyze_results.py

@@ -5,31 +5,25 @@ Script to analyze the test results and generate a report.
 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 - performance-test-suite")
-        report.append("="*60)
+        report.append("\n" + "=" * 60)
+        report.append("ANALYSIS REPORT - performance-test-suite")
+        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,35 @@ 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="Script to analyze the test results and generate a report.")
-    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.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 +122,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())

package/skills/running-performance-tests/scripts/init_test.py

@@ -5,23 +5,17 @@ Script to initialize a performance test based on user input.
 Generated: 2025-12-10 03:48:17
 """
 
-import os
 import json
 import argparse
 from pathlib import Path
 
+
 def create_project_structure(project_name: str, output_dir: str = "."):
     """Create project structure for performance-test-suite."""
     base_path = Path(output_dir) / project_name
 
     # Create directories
-    directories = [
-        base_path,
-        base_path / "config",
-        base_path / "data",
-        base_path / "output",
-        base_path / "logs"
-    ]
+    directories = [base_path, base_path / "config", base_path / "data", base_path / "output", base_path / "logs"]
 
     for dir_path in directories:
         dir_path.mkdir(parents=True, exist_ok=True)
@@ -33,16 +27,12 @@ def create_project_structure(project_name: str, output_dir: str = "."):
         "version": "1.0.0",
         "skill": "performance-test-suite",
         "category": "testing",
-        "created": time.strftime('%Y-%m-%d %H:%M:%S'),
-        "settings": {
-            "debug": False,
-            "verbose": True,
-            "max_workers": 4
-        }
+        "created": time.strftime("%Y-%m-%d %H:%M:%S"),
+        "settings": {"debug": False, "verbose": True, "max_workers": 4},
     }
 
     config_file = base_path / "config" / "settings.json"
-    with open(config_file, 'w') as f:
+    with open(config_file, "w") as f:
         json.dump(config, f, indent=2)
     print(f"✓ Created configuration: {config_file}")
 
@@ -67,11 +57,12 @@ See skill documentation for usage instructions.
 
     return base_path
 
+
 def main():
     parser = argparse.ArgumentParser(description="Script to initialize a performance test based on user input.")
-    parser.add_argument('--project', '-p', required=True, help='Project name')
-    parser.add_argument('--output', '-o', default='.', help='Output directory')
-    parser.add_argument('--config', '-c', help='Configuration file')
+    parser.add_argument("--project", "-p", required=True, help="Project name")
+    parser.add_argument("--output", "-o", default=".", help="Output directory")
+    parser.add_argument("--config", "-c", help="Configuration file")
 
     args = parser.parse_args()
 
@@ -82,13 +73,15 @@ def main():
         # Load additional configuration
         if Path(args.config).exists():
             with open(args.config) as f:
-                extra_config = json.load(f)
+                json.load(f)
             print(f"✓ Loaded configuration from {args.config}")
 
     print(f"\n✅ Project initialized successfully at {project_path}")
     return 0
 
+
 if __name__ == "__main__":
     import sys
     import time
+
     sys.exit(main())

package/skills/running-performance-tests/scripts/{run_test.sh → run_test.py}

@@ -5,12 +5,11 @@ Script to execute the performance test using k6 or other tools.
 Generated: 2025-12-10 03:48:17
 """
 
-import os
 import sys
 import json
 import argparse
 from pathlib import Path
-from datetime import datetime
+
 
 def process_file(file_path: Path) -> bool:
     """Process individual file."""
@@ -24,7 +23,7 @@ def process_file(file_path: Path) -> bool:
     # This is a template that can be customized
 
     try:
-        if file_path.suffix == '.json':
+        if file_path.suffix == ".json":
             with open(file_path) as f:
                 data = json.load(f)
             print(f"  ✓ Valid JSON with {len(data)} keys")
@@ -37,12 +36,13 @@ def process_file(file_path: Path) -> bool:
         print(f"  ✗ Error: {e}")
         return False
 
+
 def process_directory(dir_path: Path) -> int:
     """Process all files in directory."""
     processed = 0
     failed = 0
 
-    for file_path in dir_path.rglob('*'):
+    for file_path in dir_path.rglob("*"):
         if file_path.is_file():
             if process_file(file_path):
                 processed += 1
@@ -51,28 +51,27 @@ def process_directory(dir_path: Path) -> int:
 
     return processed, failed
 
+
 def main():
-    parser = argparse.ArgumentParser(
-        description="Script to execute the performance test using k6 or other tools."
-    )
-    parser.add_argument('input', help='Input file or directory')
-    parser.add_argument('--output', '-o', help='Output directory')
-    parser.add_argument('--verbose', '-v', action='store_true', help='Verbose output')
-    parser.add_argument('--config', '-c', help='Configuration file')
+    parser = argparse.ArgumentParser(description="Script to execute the performance test using k6 or other tools.")
+    parser.add_argument("input", help="Input file or directory")
+    parser.add_argument("--output", "-o", help="Output directory")
+    parser.add_argument("--verbose", "-v", action="store_true", help="Verbose output")
+    parser.add_argument("--config", "-c", help="Configuration file")
 
     args = parser.parse_args()
 
     input_path = Path(args.input)
 
-    print(f"🚀 performance-test-suite - run_test.sh")
-    print(f"   Category: testing")
-    print(f"   Plugin: performance-test-suite")
+    print("🚀 performance-test-suite - run_test.sh")
+    print("   Category: testing")
+    print("   Plugin: performance-test-suite")
     print(f"   Input: {input_path}")
 
     if args.config:
         if Path(args.config).exists():
             with open(args.config) as f:
-                config = json.load(f)
+                json.load(f)
             print(f"   Config: {args.config}")
 
     # Process input
@@ -81,7 +80,7 @@ def main():
         result = 0 if success else 1
     elif input_path.is_dir():
         processed, failed = process_directory(input_path)
-        print(f"\n📊 SUMMARY")
+        print("\n📊 SUMMARY")
         print(f"   ✅ Processed: {processed}")
         print(f"   ❌ Failed: {failed}")
         result = 0 if failed == 0 else 1
@@ -96,5 +95,6 @@ def main():
 
     return result
 
+
 if __name__ == "__main__":
     sys.exit(main())