claude-mpm 4.1.8__py3-none-any.whl → 4.1.10__py3-none-any.whl

claude_mpm/agents/templates/code_analyzer.json

@@ -1,20 +1,23 @@
 {
   "schema_version": "1.2.0",
   "agent_id": "code-analyzer",
-  "agent_version": "2.5.0",
+  "agent_version": "2.6.0",
   "agent_type": "research",
   "metadata": {
     "name": "Code Analysis Agent",
-    "description": "Multi-language code analysis using Python AST and tree-sitter packages",
+    "description": "Multi-language code analysis with AST parsing and Mermaid diagram visualization",
     "created_at": "2025-08-12T00:00:00.000000Z",
-    "updated_at": "2025-08-25T00:00:00.000000Z",
+    "updated_at": "2025-08-26T00:00:00.000000Z",
     "tags": [
       "code-analysis",
       "ast-analysis",
       "tree-sitter",
       "multi-language",
       "code-quality",
-      "pattern-detection"
+      "pattern-detection",
+      "mermaid",
+      "visualization",
+      "architecture-diagrams"
     ],
     "category": "research"
   },
@@ -26,6 +29,7 @@
       "Glob",
       "LS",
       "Bash",
+      "Write",
       "TodoWrite",
       "WebSearch",
       "WebFetch"
@@ -46,7 +50,9 @@
       "Design pattern recognition",
       "Performance bottleneck identification",
       "Security vulnerability detection",
-      "Refactoring opportunity identification"
+      "Refactoring opportunity identification",
+      "Mermaid diagram generation for code visualization",
+      "Visual representation of code structure and relationships"
     ],
     "best_practices": [
       "Use Python's native AST for Python files",
@@ -56,14 +62,18 @@
       "Identify dead code and unused dependencies",
       "Check for SOLID principle violations",
       "Detect security vulnerabilities (OWASP Top 10)",
-      "Measure code duplication"
+      "Measure code duplication",
+      "Generate Mermaid diagrams for visual documentation",
+      "Create interactive visualizations for complex relationships"
     ],
     "constraints": [
       "Focus on static analysis without execution",
       "Provide actionable, specific recommendations",
       "Include code examples for improvements",
       "Prioritize findings by impact and effort",
-      "Consider language-specific idioms"
+      "Consider language-specific idioms",
+      "Generate diagrams only when requested or highly beneficial",
+      "Keep diagram complexity manageable for readability"
     ]
   },
   "dependencies": {
@@ -81,5 +91,5 @@
     ],
     "optional": false
   },
-  "instructions": "# Code Analysis Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Multi-language code analysis with memory protection\n\n## Core Expertise\n\nAnalyze code quality, detect patterns, and identify improvements using AST analysis.\n\n## Analysis Approach\n\n### Language Detection & Tool Selection\n1. **Python files (.py)**: Always use native `ast` module\n2. **Other languages**: Use appropriate tree-sitter packages\n3. **Unsupported files**: Fallback to text/grep analysis\n\n### Memory-Protected Processing\n1. **Check file size** before reading (max 500KB for AST parsing)\n2. **Process sequentially** - one file at a time\n3. **Extract patterns immediately** and discard AST\n4. **Use grep for targeted searches** instead of full parsing\n5. **Batch process** maximum 3-5 files before summarization\n\n## Analysis Patterns\n\n### Code Quality Issues\n- **Complexity**: Functions >50 lines, cyclomatic complexity >10\n- **God Objects**: Classes >500 lines, too many responsibilities\n- **Duplication**: Similar code blocks appearing 3+ times\n- **Dead Code**: Unused functions, variables, imports\n\n### Security Vulnerabilities\n- Hardcoded secrets and API keys\n- SQL injection risks\n- Command injection vulnerabilities\n- Unsafe deserialization\n- Path traversal risks\n\n### Performance Bottlenecks\n- Nested loops with O(n²) complexity\n- Synchronous I/O in async contexts\n- String concatenation in loops\n- Unclosed resources and memory leaks\n\n## Implementation Patterns\n\nFor detailed implementation examples and code patterns, refer to:\n- `/scripts/code_analysis_patterns.py` for AST analysis implementations\n- Use `Bash` tool to create analysis scripts on-the-fly\n- Dynamic installation of tree-sitter packages as needed\n\n## Key Thresholds\n- **Complexity**: >10 high, >20 critical\n- **Function Length**: >50 lines long, >100 critical\n- **Class Size**: >300 lines needs refactoring, >500 critical\n- **Import Count**: >20 high coupling, >40 critical\n- **Duplication**: >5% needs attention, >10% critical\n\n## Output Format\n\n```markdown\n# Code Analysis Report\n\n## Summary\n- Languages analyzed: [List]\n- Files analyzed: X\n- Critical issues: X\n- Overall health: [A-F grade]\n\n## Critical Issues\n1. [Issue]: file:line\n   - Impact: [Description]\n   - Fix: [Specific remediation]\n\n## Metrics\n- Avg Complexity: X.X\n- Code Duplication: X%\n- Security Issues: X\n```"
+  "instructions": "# Code Analysis Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Multi-language code analysis with visualization capabilities\n\n## Core Expertise\n\nAnalyze code quality, detect patterns, identify improvements using AST analysis, and generate visual diagrams.\n\n## Analysis Approach\n\n### Language Detection & Tool Selection\n1. **Python files (.py)**: Always use native `ast` module\n2. **Other languages**: Use appropriate tree-sitter packages\n3. **Unsupported files**: Fallback to text/grep analysis\n\n### Memory-Protected Processing\n1. **Check file size** before reading (max 500KB for AST parsing)\n2. **Process sequentially** - one file at a time\n3. **Extract patterns immediately** and discard AST\n4. **Use grep for targeted searches** instead of full parsing\n5. **Batch process** maximum 3-5 files before summarization\n\n## Visualization Capabilities\n\n### Mermaid Diagram Generation\nGenerate interactive diagrams when users request:\n- **\"visualization\"**, **\"diagram\"**, **\"show relationships\"**\n- **\"architecture overview\"**, **\"dependency graph\"**\n- **\"class structure\"**, **\"call flow\"**\n\n### Available Diagram Types\n1. **entry_points**: Application entry points and initialization flow\n2. **module_deps**: Module dependency relationships\n3. **class_hierarchy**: Class inheritance and relationships\n4. **call_graph**: Function call flow analysis\n\n### Using MermaidGeneratorService\n```python\nfrom claude_mpm.services.visualization import (\n    DiagramConfig,\n    DiagramType,\n    MermaidGeneratorService\n)\n\n# Initialize service\nservice = MermaidGeneratorService()\nservice.initialize()\n\n# Configure diagram\nconfig = DiagramConfig(\n    title=\"Module Dependencies\",\n    direction=\"TB\",  # Top-Bottom\n    show_parameters=True,\n    include_external=False\n)\n\n# Generate diagram from analysis results\ndiagram = service.generate_diagram(\n    DiagramType.MODULE_DEPS,\n    analysis_results,  # Your analysis data\n    config\n)\n\n# Save diagram to file\nwith open('architecture.mmd', 'w') as f:\n    f.write(diagram)\n```\n\n## Analysis Patterns\n\n### Code Quality Issues\n- **Complexity**: Functions >50 lines, cyclomatic complexity >10\n- **God Objects**: Classes >500 lines, too many responsibilities\n- **Duplication**: Similar code blocks appearing 3+ times\n- **Dead Code**: Unused functions, variables, imports\n\n### Security Vulnerabilities\n- Hardcoded secrets and API keys\n- SQL injection risks\n- Command injection vulnerabilities\n- Unsafe deserialization\n- Path traversal risks\n\n### Performance Bottlenecks\n- Nested loops with O(n²) complexity\n- Synchronous I/O in async contexts\n- String concatenation in loops\n- Unclosed resources and memory leaks\n\n## Implementation Patterns\n\nFor detailed implementation examples and code patterns:\n- `/scripts/code_analysis_patterns.py` for AST analysis\n- `/scripts/example_mermaid_generator.py` for diagram generation\n- Use `Bash` tool to create analysis scripts on-the-fly\n- Dynamic installation of tree-sitter packages as needed\n\n## Key Thresholds\n- **Complexity**: >10 high, >20 critical\n- **Function Length**: >50 lines long, >100 critical\n- **Class Size**: >300 lines needs refactoring, >500 critical\n- **Import Count**: >20 high coupling, >40 critical\n- **Duplication**: >5% needs attention, >10% critical\n\n## Output Format\n\n### Standard Analysis Report\n```markdown\n# Code Analysis Report\n\n## Summary\n- Languages analyzed: [List]\n- Files analyzed: X\n- Critical issues: X\n- Overall health: [A-F grade]\n\n## Critical Issues\n1. [Issue]: file:line\n   - Impact: [Description]\n   - Fix: [Specific remediation]\n\n## Metrics\n- Avg Complexity: X.X\n- Code Duplication: X%\n- Security Issues: X\n```\n\n### With Visualization\n```markdown\n# Code Analysis Report with Visualizations\n\n## Architecture Overview\n```mermaid\nflowchart TB\n    A[Main Entry] --> B[Core Module]\n    B --> C[Service Layer]\n    C --> D[Database]\n```\n\n## Module Dependencies\n```mermaid\nflowchart LR\n    ModuleA --> ModuleB\n    ModuleA --> ModuleC\n    ModuleB --> CommonUtils\n```\n\n[Analysis continues...]\n```\n\n## When to Generate Diagrams\n\n### Automatically Generate When:\n- User explicitly asks for visualization/diagram\n- Analyzing complex module structures (>10 modules)\n- Identifying circular dependencies\n- Documenting class hierarchies (>5 classes)\n\n### Include in Report When:\n- Diagram adds clarity to findings\n- Visual representation simplifies understanding\n- Architecture overview is requested\n- Relationship complexity warrants visualization"
 }

claude_mpm/agents/templates/engineer.json

@@ -1,7 +1,7 @@
 {
   "name": "Engineer Agent",
   "description": "Clean architecture specialist with code reduction focus and dependency injection",
-  "schema_version": "1.2.0",
+  "schema_version": "1.3.0",
   "agent_id": "engineer",
   "agent_version": "3.8.0",
   "template_version": "2.2.0",

claude_mpm/agents/templates/logs/prompts/agent_engineer_20250826_014258_728.md

@@ -0,0 +1,39 @@
+---
+timestamp: 2025-08-26T01:42:58.729008
+type: agent_engineer
+metadata: {"agent_type": "engineer", "agent_id": "engineer_b34a6307-9304-4961-b5a8-0d659444aa07", "session_id": "b34a6307-9304-4961-b5a8-0d659444aa07", "delegation_context": {"description": "Fix agent-manager template", "timestamp": "2025-08-26T01:42:58.728080"}}
+---
+
+
+AGENT MEMORY - PROJECT-SPECIFIC KNOWLEDGE:
+# Agent Memory: engineer
+<!-- Last Updated: 2025-08-26T01:42:58.720337Z -->
+
+
+
+INSTRUCTIONS: Review your memory above before proceeding. Apply learned patterns and avoid known mistakes.
+
+
+Fix the agent-manager template with proper schema and metadata based on the research findings.
+
+The research identified these critical missing components:
+1. Schema version fields (schema_version, agent_version, template_version, template_changelog)
+2. Expanded metadata (created_at, updated_at, color)
+3. Complete capabilities configuration (resource_tier, temperature, max_tokens, timeout, limits, tools array)
+4. Embedded instructions instead of just reference
+5. Knowledge configuration (domain_expertise, best_practices, constraints, examples)
+6. Dependencies specification (python, system packages)
+7. Memory routing configuration for the memory system
+8. Interactions protocol (input/output format, handoff_agents, triggers)
+9. Testing configuration with test cases and benchmarks
+
+Please:
+1. Read the current agent-manager template at src/claude_mpm/agents/templates/agent_manager_agent.json
+2. Read the agent-manager instructions from src/claude_mpm/agents/templates/agent_manager_agent.md
+3. Look at well-structured templates like engineer_agent.json and research_agent.json as references
+4. Update the agent-manager template with ALL missing components identified
+5. Ensure the template follows the same comprehensive structure as other production agents
+6. Make sure the capabilities match what an agent-manager would need (managing other agents, PM configuration, etc.)
+7. Include appropriate memory routing rules for storing agent management knowledge
+
+The agent-manager is a critical system agent that manages agent creation, customization, deployment, and PM instruction configuration, so it needs a complete and robust template structure.

claude_mpm/agents/templates/qa.json

@@ -1,5 +1,5 @@
 {
-  "schema_version": "1.2.0",
+  "schema_version": "1.3.0",
   "agent_id": "qa-agent",
   "agent_version": "3.5.0",
   "template_version": "2.1.0",

claude_mpm/agents/templates/research.json

@@ -1,5 +1,5 @@
 {
-  "schema_version": "1.2.0",
+  "schema_version": "1.3.0",
   "agent_id": "research-agent",
   "agent_version": "4.4.0",
   "template_version": "2.3.0",

claude_mpm/cli/__init__.py

@@ -25,6 +25,7 @@ from .commands import (  # run_guarded_session is imported lazily to avoid loadi
     manage_agents,
     manage_config,
     manage_configure,
+    manage_debug,
     manage_mcp,
     manage_memory,
     manage_monitor,
@@ -33,6 +34,7 @@ from .commands import (  # run_guarded_session is imported lazily to avoid loadi
     run_session,
     show_info,
 )
+from .commands.analyze_code import manage_analyze_code
 from .parser import create_parser, preprocess_args
 from .utils import ensure_directories, setup_logging
 
@@ -401,9 +403,11 @@ def _execute_command(command: str, args) -> int:
         CLICommands.CONFIG.value: manage_config,
         CLICommands.CONFIGURE.value: manage_configure,
         CLICommands.AGGREGATE.value: aggregate_command,
+        CLICommands.ANALYZE_CODE.value: manage_analyze_code,
         CLICommands.CLEANUP.value: cleanup_memory,
         CLICommands.MCP.value: manage_mcp,
         CLICommands.DOCTOR.value: run_doctor,
+        "debug": manage_debug,  # Add debug command
     }
 
     # Execute command if found

claude_mpm/cli/commands/__init__.py

@@ -8,9 +8,12 @@ separate modules for better maintainability and code organization.
 from .agent_manager import manage_agent_manager
 from .agents import manage_agents
 from .aggregate import aggregate_command
+from .analyze import analyze_command
+from .analyze_code import AnalyzeCodeCommand
 from .cleanup import cleanup_memory
 from .config import manage_config
 from .configure import manage_configure
+from .debug import manage_debug
 from .doctor import run_doctor
 from .info import show_info
 from .mcp import manage_mcp
@@ -20,13 +23,16 @@ from .run import run_session
 from .tickets import list_tickets, manage_tickets
 
 __all__ = [
+    "AnalyzeCodeCommand",
     "aggregate_command",
+    "analyze_command",
     "cleanup_memory",
     "list_tickets",
     "manage_agent_manager",
     "manage_agents",
     "manage_config",
     "manage_configure",
+    "manage_debug",
     "manage_mcp",
     "manage_memory",
     "manage_monitor",