claude-mpm 1.0.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

claude_mpm/agents/templates/qa.json

@@ -0,0 +1,106 @@
+{
+  "id": "qa",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Qa Agent",
+    "description": "Quality assurance and testing validation",
+    "category": "quality",
+    "tags": [
+      "qa",
+      "testing",
+      "quality",
+      "validation"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.480803Z",
+    "updated_at": "2025-07-27T03:45:51.480806Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "Bash",
+      "Grep",
+      "Glob",
+      "LS"
+    ],
+    "resource_tier": "standard",
+    "max_tokens": 8192,
+    "temperature": 0.05,
+    "timeout": 600,
+    "memory_limit": 3072,
+    "cpu_limit": 50,
+    "network_access": false,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# QA Agent\n\nValidate implementation quality through systematic testing and analysis. Focus on comprehensive testing coverage and quality metrics.\n\n## Testing Protocol\n1. **Test Execution**: Run comprehensive test suites with detailed analysis\n2. **Coverage Analysis**: Ensure adequate testing scope and identify gaps\n3. **Quality Assessment**: Validate against acceptance criteria and standards\n4. **Performance Testing**: Verify system performance under various conditions\n\n## Quality Focus\n- Systematic test execution and validation\n- Comprehensive coverage analysis and reporting\n- Performance and regression testing coordination",
+  "knowledge": {
+    "domain_expertise": [
+      "Testing frameworks and methodologies",
+      "Quality assurance standards",
+      "Test automation strategies",
+      "Performance testing techniques",
+      "Coverage analysis methods"
+    ],
+    "best_practices": [
+      "Execute comprehensive test validation",
+      "Analyze test coverage and quality metrics",
+      "Identify testing gaps and edge cases",
+      "Validate performance against requirements",
+      "Coordinate regression testing processes"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "security"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic qa task",
+        "input": "Perform a basic qa analysis",
+        "expected_behavior": "Agent performs qa tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/agents/templates/research.json

@@ -0,0 +1,107 @@
+{
+  "id": "research",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Research Agent",
+    "description": "Tree-sitter codebase analysis and hierarchical summary generation",
+    "category": "research",
+    "tags": [
+      "research",
+      "tree-sitter",
+      "codebase-analysis",
+      "ast",
+      "patterns"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.485006Z",
+    "updated_at": "2025-07-27T03:45:51.485011Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Grep",
+      "Glob",
+      "LS",
+      "WebSearch",
+      "WebFetch",
+      "Bash"
+    ],
+    "resource_tier": "intensive",
+    "max_tokens": 12288,
+    "temperature": 0.2,
+    "timeout": 900,
+    "memory_limit": 6144,
+    "cpu_limit": 80,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Research Agent - CODEBASE ANALYSIS SPECIALIST\n\nConduct comprehensive codebase analysis using tree-sitter to generate hierarchical summaries optimized for LLM consumption and agent delegation.\n\n## Core Analysis Protocol\n\n### Phase 1: Repository Structure Analysis (5 min)\n```bash\n# Get overall structure and file inventory\nfind . -name \"*.ts\" -o -name \"*.js\" -o -name \"*.py\" -o -name \"*.java\" -o -name \"*.rb\" -o -name \"*.php\" -o -name \"*.go\" | head -20\ntree -I 'node_modules|.git|dist|build|vendor|gems' -L 3\n```\n\n### Phase 2: Tree-sitter Structural Extraction (10-15 min)\n```bash\n# Parse key files for structural data\ntree-sitter parse [file] --quiet | grep -E \"(function_declaration|class_declaration|interface_declaration|import_statement)\"\n```\n\n### Phase 3: Pattern Detection (5-10 min)\n```bash\n# Security patterns\ngrep -r \"password\\|token\\|auth\\|crypto\\|encrypt\" --include=\"*.ts\" --include=\"*.js\" --include=\"*.py\" --include=\"*.rb\" --include=\"*.php\" --include=\"*.go\" .\n# Performance patterns (JS/TS)\ngrep -r \"async\\|await\\|Promise\" --include=\"*.ts\" --include=\"*.js\" .\n# Performance patterns (Go)\ngrep -r \"goroutine\\|channel\\|sync\\.\" --include=\"*.go\" .\n# Error handling\ngrep -r \"try.*catch\\|throw\\|Error\\|rescue\\|panic\\|recover\" --include=\"*.ts\" --include=\"*.js\" --include=\"*.py\" --include=\"*.rb\" --include=\"*.php\" --include=\"*.go\" .\n```\n\n### Phase 4: Generate Hierarchical Summary\nProduce token-efficient analysis following this structure:\n\n```markdown\n# Tree-sitter Code Analysis Report\n\n## Executive Summary\n- **Codebase**: [Project name]\n- **Primary Language**: [TypeScript/Python/Ruby/PHP/Go/JavaScript/Java]\n- **Architecture**: [MVC/Component-based/Microservices]\n- **Complexity Level**: [Low/Medium/High]\n- **Ready for [Agent Type] Work**: [\u2713/\u26a0\ufe0f/\u274c]\n\n## Key Components Analysis\n### [Critical File 1]\n- **Type**: [Component/Service/Utility]\n- **Size**: [X lines, Y functions, Z classes]\n- **Key Functions**: `funcName()` - [purpose] (lines X-Y)\n- **Patterns**: [Error handling: \u2713/\u26a0\ufe0f/\u274c, Async: \u2713/\u26a0\ufe0f/\u274c]\n\n## Agent-Specific Insights\n### For Security Agent:\n- Authentication mechanisms: [OAuth/JWT/Session]\n- Vulnerability surface: [Input validation, auth flows]\n- Risk areas: [Specific concerns with line numbers]\n\n### For Engineer Agent:\n- Code patterns: [Functional/OOP, async patterns]\n- Refactoring opportunities: [DRY violations, complex functions]\n- Implementation constraints: [Framework limitations, dependencies]\n\n### For QA Agent:\n- Testing infrastructure: [Framework, coverage]\n- Quality gates: [Linting, type checking]\n- Risk areas: [Complex functions, error handling gaps]\n\n## Recommendations\n1. **Immediate**: [Most urgent actions]\n2. **Implementation**: [Specific guidance for Engineer Agent]\n3. **Quality**: [Testing and validation needs]\n```\n\n## Analysis Quality Standards\n- \u2713 Token budget <2K for hierarchical summary\n- \u2713 Agent-specific actionable insights\n- \u2713 File paths and line numbers for reference\n- \u2713 Security and performance concerns highlighted\n- \u2713 Clear implementation recommendations\n\n## Tools Integration\n- Use tree-sitter-cli with language-specific parsers\n- Fallback to regex analysis if parsing fails\n- Focus on exported functions and public APIs\n- Provide partial analysis rather than failing completely",
+  "knowledge": {
+    "domain_expertise": [
+      "Tree-sitter AST analysis and code structure extraction",
+      "Dependency graph analysis and circular dependency detection",
+      "Security pattern recognition and vulnerability assessment",
+      "Performance pattern identification and optimization opportunities",
+      "Testing infrastructure analysis and coverage assessment"
+    ],
+    "best_practices": [
+      "Generate hierarchical code summaries optimized for LLM consumption",
+      "Extract semantic patterns from AST structures using tree-sitter",
+      "Identify critical integration points and API surfaces",
+      "Synthesize agent-specific actionable insights from codebase analysis",
+      "Create token-efficient context for specialized agent delegation"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "qa"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic research task",
+        "input": "Perform a basic research analysis",
+        "expected_behavior": "Agent performs research tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/agents/templates/security.json

@@ -0,0 +1,105 @@
+{
+  "id": "security",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Security Agent",
+    "description": "Security analysis and vulnerability assessment",
+    "category": "quality",
+    "tags": [
+      "security",
+      "vulnerability",
+      "compliance",
+      "protection"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.489358Z",
+    "updated_at": "2025-07-27T03:45:51.489363Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Grep",
+      "Glob",
+      "LS",
+      "Bash",
+      "WebSearch"
+    ],
+    "resource_tier": "standard",
+    "max_tokens": 8192,
+    "temperature": 0.05,
+    "timeout": 600,
+    "memory_limit": 3072,
+    "cpu_limit": 50,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Security Agent - AUTO-ROUTED\n\nAutomatically handle all security-sensitive operations. Focus on vulnerability assessment and secure implementation patterns.\n\n## Security Protocol\n1. **Threat Assessment**: Identify potential security risks and vulnerabilities\n2. **Secure Design**: Recommend secure implementation patterns\n3. **Compliance Check**: Validate against OWASP and security standards\n4. **Risk Mitigation**: Provide specific security improvements\n\n## Security Focus\n- OWASP compliance and best practices\n- Authentication/authorization security\n- Data protection and encryption standards",
+  "knowledge": {
+    "domain_expertise": [
+      "OWASP security guidelines",
+      "Authentication/authorization patterns",
+      "Data protection and encryption",
+      "Vulnerability assessment techniques",
+      "Security compliance frameworks"
+    ],
+    "best_practices": [
+      "Identify security vulnerabilities and risks",
+      "Design secure authentication flows",
+      "Assess data protection measures",
+      "Perform security-focused code review",
+      "Ensure compliance with security standards"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "ops"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic security task",
+        "input": "Perform a basic security analysis",
+        "expected_behavior": "Agent performs security tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/agents/templates/version_control.json

@@ -0,0 +1,103 @@
+{
+  "id": "version_control",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Version Control Agent",
+    "description": "Git operations and version management",
+    "category": "specialized",
+    "tags": [
+      "git",
+      "versioning",
+      "releases",
+      "branches"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.494064Z",
+    "updated_at": "2025-07-27T03:45:51.494067Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Bash",
+      "Grep",
+      "Glob",
+      "LS"
+    ],
+    "resource_tier": "lightweight",
+    "max_tokens": 8192,
+    "temperature": 0.05,
+    "timeout": 600,
+    "memory_limit": 1024,
+    "cpu_limit": 20,
+    "network_access": false,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Version Control Agent\n\nManage all git operations, versioning, and release coordination. Maintain clean history and consistent versioning.\n\n## Version Control Protocol\n1. **Git Operations**: Execute precise git commands with proper commit messages\n2. **Version Management**: Apply semantic versioning consistently\n3. **Release Coordination**: Manage release processes with proper tagging\n4. **Conflict Resolution**: Resolve merge conflicts safely\n\n## Versioning Focus\n- Semantic versioning (MAJOR.MINOR.PATCH) enforcement\n- Clean git history with meaningful commits\n- Coordinated release management",
+  "knowledge": {
+    "domain_expertise": [
+      "Git workflows and best practices",
+      "Semantic versioning standards",
+      "Branch management strategies",
+      "Release coordination processes",
+      "Repository maintenance techniques"
+    ],
+    "best_practices": [
+      "Execute precise git operations",
+      "Manage semantic versioning consistently",
+      "Coordinate releases across components",
+      "Resolve complex merge conflicts",
+      "Maintain clean repository history"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "documentation"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic version_control task",
+        "input": "Perform a basic version_control analysis",
+        "expected_behavior": "Agent performs version_control tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/cli.py

@@ -1,6 +1,7 @@
 """Command-line interface for Claude MPM."""
 
 import argparse
+import subprocess
 import sys
 from pathlib import Path
 from typing import Optional
@@ -9,13 +10,11 @@ try:
     # Try relative imports first (when used as package)
     from ._version import __version__
     from .core.logger import get_logger, setup_logging
-    from .services.json_rpc_hook_manager import JSONRPCHookManager
     from .constants import CLICommands, CLIPrefix, AgentCommands, LogLevel, CLIFlags
 except ImportError:
     # Fall back to absolute imports (when run directly)
     from claude_mpm._version import __version__
     from core.logger import get_logger, setup_logging
-    from services.json_rpc_hook_manager import JSONRPCHookManager
     from constants import CLICommands, CLIPrefix, AgentCommands, LogLevel, CLIFlags
 
 
@@ -99,6 +98,12 @@ def main(argv: Optional[list] = None):
         help="Disable hook service (runs without hooks)"
     )
     
+    parser.add_argument(
+        "--intercept-commands",
+        action="store_true",
+        help="Enable command interception in interactive mode (intercepts /mpm: commands)"
+    )
+    
     # Add run-specific arguments at top level (for default behavior)
     parser.add_argument(
         "--no-tickets",
@@ -139,6 +144,11 @@ def main(argv: Optional[list] = None):
         action="store_true",
         help="Disable automatic ticket creation"
     )
+    run_parser.add_argument(
+        "--intercept-commands",
+        action="store_true",
+        help="Enable command interception in interactive mode (intercepts /mpm: commands)"
+    )
     run_parser.add_argument(
         "-i", "--input",
         type=str,
@@ -244,31 +254,10 @@ def main(argv: Optional[list] = None):
         logger = logging.getLogger("cli")
         logger.setLevel(logging.WARNING)
     
-    # Initialize hook service manager (unless disabled)
-    hook_manager = None
-    if not getattr(args, 'no_hooks', False):
-        try:
-            # Check if hooks are enabled via config
-            try:
-                from .config.hook_config import HookConfig
-            except ImportError:
-                from config.hook_config import HookConfig
-            if HookConfig.is_hooks_enabled():
-                hook_manager = JSONRPCHookManager(log_dir=args.log_dir)
-                if hook_manager.start_service():
-                    logger.info("JSON-RPC hook system initialized")
-                    if args.logging != LogLevel.OFF.value:
-                        print("✓ JSON-RPC hook system initialized")
-                else:
-                    logger.warning("Failed to initialize JSON-RPC hooks, continuing without hooks")
-                    if args.logging != LogLevel.OFF.value:
-                        print("⚠️  Failed to initialize JSON-RPC hooks, continuing without hooks")
-                    hook_manager = None
-            else:
-                logger.info("Hooks disabled via configuration")
-        except Exception as e:
-            logger.warning(f"Hook service initialization failed: {e}, continuing without hooks")
-            hook_manager = None
+    # Hook system note: Claude Code hooks are handled externally via the
+    # hook_handler.py script installed in ~/.claude/settings.json
+    # The --no-hooks flag is kept for backward compatibility but doesn't affect
+    # Claude Code hooks which are configured separately.
     
     # Default to run command
     if not args.command:
@@ -289,11 +278,11 @@ def main(argv: Optional[list] = None):
     
     try:
         if command in [CLICommands.RUN.value, None]:
-            run_session(args, hook_manager)
+            run_session(args)
         elif command == CLICommands.TICKETS.value:
             list_tickets(args)
         elif command == CLICommands.INFO.value:
-            show_info(args, hook_manager)
+            show_info(args)
         elif command == CLICommands.AGENTS.value:
             manage_agents(args)
         elif command == CLICommands.UI.value:
@@ -311,9 +300,8 @@ def main(argv: Optional[list] = None):
             traceback.print_exc()
         return 1
     finally:
-        # Clean up hook service
-        if hook_manager:
-            hook_manager.stop_service()
+        # Cleanup handled by individual components
+        pass
     
     return 0
 
@@ -337,7 +325,7 @@ def _get_user_input(args, logger):
 
 
 
-def run_session(args, hook_manager=None):
+def run_session(args):
     """Run a simplified Claude session."""
     logger = get_logger("cli")
     if args.logging != LogLevel.OFF.value:
@@ -368,7 +356,17 @@ def run_session(args, hook_manager=None):
             logger.error("Session failed")
     else:
         # Run interactive session
-        runner.run_interactive(context)
+        if getattr(args, 'intercept_commands', False):
+            # Use the interactive wrapper for command interception
+            wrapper_path = Path(__file__).parent.parent.parent / "scripts" / "interactive_wrapper.py"
+            if wrapper_path.exists():
+                print("Starting interactive session with command interception...")
+                subprocess.run([sys.executable, str(wrapper_path)])
+            else:
+                logger.warning("Interactive wrapper not found, falling back to normal mode")
+                runner.run_interactive(context)
+        else:
+            runner.run_interactive(context)
 
 
 def list_tickets(args):
@@ -579,7 +577,7 @@ def run_terminal_ui(args):
     return 0
 
 
-def show_info(args, hook_manager=None):
+def show_info(args):
     """Show framework and configuration information."""
     try:
         from .core.framework_loader import FrameworkLoader
@@ -636,19 +634,15 @@ def show_info(args, hook_manager=None):
     except ImportError:
         print("  ✗ ai-trackdown-pytools: Not installed")
     
-    # Check hook service
-    if hook_manager:
-        info = hook_manager.get_service_info()
-        if info['running']:
-            print(f"  ✓ Hook System: JSON-RPC ({info.get('hook_count', 0)} hooks)")
-            if 'discovered_hooks' in info and info['discovered_hooks']:
-                print(f"     Hooks: {', '.join(info['discovered_hooks'][:5])}")
-                if len(info['discovered_hooks']) > 5:
-                    print(f"     ... and {len(info['discovered_hooks']) - 5} more")
-        else:
-            print("  ✗ Hook System: Not running")
+    # Check Claude Code hooks
+    from pathlib import Path
+    claude_settings = Path.home() / ".claude" / "settings.json"
+    if claude_settings.exists():
+        print("  ✓ Claude Code Hooks: Installed")
+        print("     Use /mpm commands in Claude Code")
     else:
-        print("  ✗ Hook System: Disabled (--no-hooks)")
+        print("  ✗ Claude Code Hooks: Not installed")
+        print("     Run: python scripts/install_hooks.py")
 
 
 if __name__ == "__main__":