feat: Add comprehensive runtime debugging capabilities to web-performance-agent

Enhanced web-performance-agent with advanced runtime debugging features:
- Headless browser monitoring for freeze/hang detection
- Memory leak detection and heap analysis
- Main thread blocking detection
- Framework-specific debugging (Angular Zone.js, React re-renders, Vue watchers)
- Network request tracking and stuck request detection
- CPU profiling for hot function identification
- Auth token injection for protected apps
- Quick diagnosis scripts for rapid issue identification

Added new resources:
- runtime-debugging skill with patterns and best practices
- /diagnose-runtime command for quick runtime diagnostics

Updated versioning pattern documentation in CLAUDE.md to reflect custom scheme.

This enables debugging of complex runtime issues like app freezes, memory leaks,
infinite loops, and performance degradation that can't be detected with basic
Lighthouse audits alone.

Author: rubenCodeforges

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "cf-dev-toolkit",
       "source": "./",
       "description": "Specialized sub-agents, auto-loading skills, and commands that reduce context usage and prevent Claude from losing focus on complex tasks",
-      "version": "1.1.11"
+      "version": "1.1.12"
     }
   ]
 }

CLAUDE.md

@@ -146,25 +146,33 @@ If agents suggest code without checking:
 
 ## Version Management
 
-Current version: 1.1.1
+Current version: 1.1.12
 
 When incrementing:
 1. Update `manifest.json` version
 2. Update `.claude-plugin/marketplace.json` plugin version
 3. Update README.md badge
 4. Document changes in git commit
 
-### Semantic Versioning
+### Versioning Pattern (Custom for this project)
 
-Follow semver (MAJOR.MINOR.PATCH):
-- **MAJOR**: Breaking changes (agent removal, fundamental behavior changes)
-- **MINOR**: New features (new agents, skills, commands)
-- **PATCH**: Bug fixes, documentation updates, small improvements
+**IMPORTANT: This project uses a modified versioning pattern:**
+
+Format: `1.MINOR.PATCH`
+- **1.X.0**: Major feature releases (reserved for significant milestones)
+- **1.1.X**: All regular updates including:
+  - New agents, skills, commands
+  - Feature enhancements
+  - Bug fixes
+  - Documentation updates
+  - Performance improvements
 
 Examples:
-- Add new agent → 1.1.0
-- Fix agent trigger keywords → 1.0.1
-- Remove/rename agent → 2.0.0
+- Add new agent → 1.1.12 (increment patch)
+- Fix agent trigger keywords → 1.1.13 (increment patch)
+- Major rewrite/v2 → 2.0.0 (only for breaking changes)
+
+**Note**: We keep all backward-compatible changes as patch versions (1.1.X) to maintain stability and indicate continuous improvement rather than major version jumps.
 
 ## Installation Testing
 

README.md

@@ -1,6 +1,6 @@
 # cf Dev Toolkit
 
-[![Version](https://img.shields.io/badge/version-1.1.11-blue.svg)](https://github.com/rubenCodeforges/codeforges-claude-plugin)
+[![Version](https://img.shields.io/badge/version-1.1.12-blue.svg)](https://github.com/rubenCodeforges/codeforges-claude-plugin)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-purple.svg)](https://claude.com/claude-code)
 
@@ -73,7 +73,7 @@ No @ needed. Agents activate automatically.
 | **code-analyst** | Deep file analysis, smart reading for large files | "analyze", "review", "understand code" |
 | **usage-finder** | Tracks function/class usage across entire codebase | "where used", "find usages", "what calls this" |
 | **performance-analyzer** | Finds bottlenecks, N+1 queries, algorithmic issues | "slow", "performance", "optimize" |
-| **web-performance-agent** | Lighthouse analysis for live websites (Core Web Vitals) | URLs, "page speed", "lighthouse" |
+| **web-performance-agent** | Lighthouse analysis + runtime debugging (freezes, memory leaks) | URLs, "page speed", "app freeze", "memory leak" |
 | **api-analyzer** | Maps all endpoints (Express, FastAPI, Django, Spring, Go) | "API routes", "endpoints", "map API" |
 | **dependency-analyzer** | Security vulnerabilities, circular deps, bundle bloat | "dependencies", "npm audit", "security" |
 | **git-analyzer** | Shows who wrote what, when, why | "git blame", "who wrote", "recent changes" |
@@ -85,16 +85,19 @@ No @ needed. Agents activate automatically.
 - Verification before code suggestions
 - Automatic multi-agent coordination
 
-### 4 Auto-Loading Skills
+### 5 Auto-Loading Skills
 - **codebase-patterns** - Pattern recognition
 - **refactoring-guide** - Refactoring techniques
 - **performance-patterns** - Optimization strategies
 - **web-performance-optimization** - Core Web Vitals, Lighthouse metrics
+- **runtime-debugging** - Debug freezes, memory leaks, performance issues
 
-### 3 Quick Commands
+### 5 Quick Commands
 - `/analyze-file <path>` - Deep file analysis
 - `/scan-codebase` - Complete project scan
 - `/check-web-perf` - Web performance toolkit diagnostics
+- `/map-class-usage <class>` - Build usage map for a class
+- `/diagnose-runtime <url>` - Debug runtime issues (freezes, memory leaks)
 
 ---