claude-mpm 5.4.102__tar.gz → 5.4.104__tar.gz

{claude_mpm-5.4.102/src/claude_mpm.egg-info → claude_mpm-5.4.104}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 5.4.102
+Version: 5.4.104
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "5.4.102"
+version = "5.4.104"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -189,7 +189,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "5.4.102"
+version = "5.4.104"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-5.4.104/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+5.4.104

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm/cli/executor.py

@@ -206,27 +206,33 @@ def execute_command(command: str, args) -> int:
             "status": show_status,
         }
 
-        # Get handler and invoke
+        # Get handler and call it with argument list (same pattern as autotodos)
         handler = handlers.get(subcommand)
         if handler:
-            # Build Click context programmatically
-            import click
-
-            ctx = click.Context(command=handler)
+            try:
+                # Build argument list for Click command based on subcommand
+                click_args = []
 
-            # Prepare keyword arguments from args
-            kwargs = {}
-            if hasattr(args, "format"):
-                kwargs["format"] = args.format
-            if hasattr(args, "hook_type"):
-                kwargs["hook_type"] = args.hook_type
-            if hasattr(args, "yes"):
-                kwargs["yes"] = args.yes
+                # list command: --format, --hook-type
+                if subcommand == "list":
+                    if hasattr(args, "format") and args.format:
+                        click_args.extend(["--format", args.format])
+                    if hasattr(args, "hook_type") and args.hook_type:
+                        click_args.extend(["--hook-type", args.hook_type])
+                # clear command: --hook-type, -y
+                elif subcommand == "clear":
+                    if hasattr(args, "hook_type") and args.hook_type:
+                        click_args.extend(["--hook-type", args.hook_type])
+                    if hasattr(args, "yes") and args.yes:
+                        click_args.append("-y")
+                # diagnose command: hook_type (positional argument)
+                elif subcommand == "diagnose":
+                    if hasattr(args, "hook_type") and args.hook_type:
+                        click_args.append(args.hook_type)
+                # status and summary commands: no options
 
-            try:
-                # Invoke handler with arguments
-                with ctx:
-                    handler.invoke(ctx, **kwargs)
+                # Call Click command with argument list and standalone_mode=False
+                handler(click_args, standalone_mode=False)
                 return 0
             except SystemExit as e:
                 return e.code if e.code is not None else 0

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm/config/agent_presets.py

@@ -25,12 +25,16 @@ from typing import Any, Callable, Dict, List, Union
 PresetResolver = Union[List[str], Callable[[], List[str]]]
 
 # Core agents included in ALL presets (MIN and MAX)
+# Standard 6 core agents for essential PM workflow functionality
 CORE_AGENTS = [
     "claude-mpm/mpm-agent-manager",  # Agent lifecycle management
     "claude-mpm/mpm-skills-manager",  # Skills management
-    "universal/research",  # Codebase investigation
+    "engineer/core/engineer",  # General-purpose implementation
+    "universal/research",  # Codebase exploration and analysis
+    "qa/qa",  # Testing and quality assurance
     "documentation/documentation",  # Documentation generation
-    "engineer/core/engineer",  # General-purpose engineering
+    "ops/core/ops",  # Basic deployment operations
+    "documentation/ticketing",  # Ticket tracking (essential for PM workflow)
 ]
 
 PRESETS: Dict[str, Dict[str, Any]] = {
@@ -39,11 +43,7 @@ PRESETS: Dict[str, Dict[str, Any]] = {
     # ========================================
     "minimal": {
         "description": "Core agents only - universal starter kit",
-        "agents": CORE_AGENTS
-        + [
-            "qa/qa",
-            "ops/core/ops",
-        ],
+        "agents": CORE_AGENTS,  # All 8 core agents (no additional needed)
         "use_cases": ["Any project type", "Quick start", "Learning"],
     },
     # ========================================

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm/core/unified_config.py

@@ -73,15 +73,18 @@ class AgentConfig(BaseModel):
     )
 
     # Required agents that are always deployed
+    # Standard 6 core agents for essential PM workflow functionality
+    # These are auto-deployed when no agents are specified in configuration
     required: List[str] = Field(
         default_factory=lambda: [
-            "research",
-            "mpm-skills-manager",
-            "mpm-agent-manager",
-            "memory-manager-agent",  # Specific agent ID (not generic "memory-manager")
-            "ticketing",
+            "engineer",  # General-purpose implementation
+            "research",  # Codebase exploration and analysis
+            "qa",  # Testing and quality assurance
+            "documentation",  # Documentation generation
+            "ops",  # Basic deployment operations
+            "ticketing",  # Ticket tracking (essential for PM workflow)
         ],
-        description="Agents that are always deployed (core system agents)",
+        description="Agents that are always deployed (standard 6 core agents)",
     )
 
     include_universal: bool = Field(

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm/services/agents/agent_recommendation_service.py

@@ -30,16 +30,16 @@ class AgentRecommendationService:
     Can be used by CLI, API, or future auto-configuration features.
     """
 
-    # Core agents always included - matches ToolchainDetector.CORE_AGENTS
+    # Core agents always included - Standard 6 core agents for essential PM workflow
+    # These agents are auto-deployed when no configuration exists
     # Uses exact agent IDs from repository for consistency
     CORE_AGENTS = {
-        "engineer",
-        "qa-agent",
-        "memory-manager-agent",
-        "local-ops-agent",
-        "research-agent",
-        "documentation-agent",
-        "security-agent",
+        "engineer",  # General-purpose implementation
+        "research",  # Codebase exploration and analysis
+        "qa",  # Testing and quality assurance
+        "documentation",  # Documentation generation
+        "ops",  # Basic deployment operations
+        "ticketing",  # Ticket tracking (essential for PM workflow)
     }
 
     # Map detected languages to recommended engineer agents

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm/services/agents/loading/framework_agent_loader.py

@@ -10,10 +10,19 @@ Loading precedence: Project → User → System
 
 This service integrates with the main agent_loader.py to provide
 markdown-based agent profiles alongside JSON-based templates.
+
+Auto-Deployment: When no agents are configured, the standard 6 core agents
+are automatically deployed:
+- engineer: General-purpose implementation
+- research: Codebase exploration and analysis
+- qa: Testing and quality assurance
+- documentation: Documentation generation
+- ops: Basic deployment operations
+- ticketing: Ticket tracking (essential for PM workflow)
 """
 
 from pathlib import Path
-from typing import Any, Dict, Optional
+from typing import Any, Dict, List, Optional
 
 from claude_mpm.agents.agent_loader import AgentTier, list_agents_by_tier
 from claude_mpm.core.logging_utils import get_logger
@@ -21,6 +30,17 @@ from claude_mpm.core.unified_paths import get_path_manager
 
 logger = get_logger(__name__)
 
+# Standard 6 core agents that are auto-deployed when no agents are specified
+# This list is the canonical source - other modules should import from here
+CORE_AGENTS: List[str] = [
+    "engineer",  # General-purpose implementation
+    "research",  # Codebase exploration and analysis
+    "qa",  # Testing and quality assurance
+    "documentation",  # Documentation generation
+    "ops",  # Basic deployment operations
+    "ticketing",  # Ticket tracking (essential for PM workflow)
+]
+
 
 class FrameworkAgentLoader:
     """Loads agent profiles from project, user, and system directories with proper precedence"""
@@ -86,7 +106,7 @@ class FrameworkAgentLoader:
                 data_claude = package_path / "data" / "agents" / "CLAUDE.md"
                 if data_instructions.exists() or data_claude.exists():
                     return package_path / "data"
-        except Exception:
+        except Exception:  # nosec B110 - intentional fallthrough to next location
             pass
 
         current = Path.cwd()
@@ -431,3 +451,56 @@ Please operate according to your profile specifications and maintain quality sta
 """
 
         return instruction.strip()
+
+    def get_core_agents(self) -> List[str]:
+        """
+        Get the standard 6 core agents for auto-deployment.
+
+        These agents are automatically deployed when no agents are specified
+        in the configuration. They provide essential PM workflow functionality.
+
+        Returns:
+            List of core agent IDs
+
+        Example:
+            >>> loader = FrameworkAgentLoader()
+            >>> core = loader.get_core_agents()
+            >>> 'engineer' in core
+            True
+            >>> len(core)
+            6
+        """
+        return CORE_AGENTS.copy()
+
+    def get_agents_with_fallback(self) -> Dict[str, list]:
+        """
+        Get available agents, falling back to core agents if none found.
+
+        This method implements the auto-deployment logic: when no agents
+        are found in any tier (project, user, system), it returns the
+        standard 6 core agents as a fallback.
+
+        Returns:
+            Dictionary with agent lists by tier. If no agents found in any tier,
+            returns core agents under 'fallback' key.
+
+        Example:
+            >>> loader = FrameworkAgentLoader()
+            >>> loader.initialize()
+            >>> agents = loader.get_agents_with_fallback()
+            >>> if 'fallback' in agents:
+            ...     print("Using core agents as fallback")
+        """
+        available = self.get_available_agents()
+
+        # Check if any agents are found
+        total_agents = sum(len(agents) for agents in available.values())
+
+        if total_agents == 0:
+            logger.info(
+                "No agents found in configuration. "
+                "Auto-deploying standard 6 core agents."
+            )
+            return {"fallback": CORE_AGENTS.copy()}
+
+        return available

{claude_mpm-5.4.102 → claude_mpm-5.4.104/src/claude_mpm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 5.4.102
+Version: 5.4.104
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team

{claude_mpm-5.4.102 → claude_mpm-5.4.104}/src/claude_mpm.egg-info/SOURCES.txt

@@ -353,12 +353,27 @@ src/claude_mpm/hooks/claude_hooks/installer.py
 src/claude_mpm/hooks/claude_hooks/memory_integration.py
 src/claude_mpm/hooks/claude_hooks/response_tracking.py
 src/claude_mpm/hooks/claude_hooks/tool_analysis.py
+src/claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/auto_pause_handler.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/correlation_manager.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/installer.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-311.pyc
 src/claude_mpm/hooks/claude_hooks/services/__init__.py
 src/claude_mpm/hooks/claude_hooks/services/connection_manager.py
 src/claude_mpm/hooks/claude_hooks/services/connection_manager_http.py
 src/claude_mpm/hooks/claude_hooks/services/duplicate_detector.py
 src/claude_mpm/hooks/claude_hooks/services/state_manager.py
 src/claude_mpm/hooks/claude_hooks/services/subagent_processor.py
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-311.pyc
+src/claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-311.pyc
 src/claude_mpm/hooks/failure_learning/__init__.py
 src/claude_mpm/hooks/failure_learning/failure_detection_hook.py
 src/claude_mpm/hooks/failure_learning/fix_detection_hook.py
@@ -1255,7 +1270,6 @@ tests/test_react_events.py
 tests/test_real_startup_duplicate_messages.py
 tests/test_refactored_deployment_integration.py
 tests/test_release_makefile.py
-tests/test_research_memory.py
 tests/test_response_logging_auto_switch.py
 tests/test_response_logging_comprehensive.py
 tests/test_response_logging_integration.py

claude_mpm-5.4.102/src/claude_mpm/VERSION

@@ -1 +0,0 @@
-5.4.102

claude_mpm-5.4.102/tests/test_research_memory.py

@@ -1,280 +0,0 @@
-#!/usr/bin/env python3
-"""
-Test script for Research Agent memory management with content thresholds.
-
-This script verifies:
-1. Content threshold triggers for summarization
-2. MCP document summarizer integration
-3. Cumulative content tracking
-4. Adaptive grep context management
-5. File type-specific thresholds
-"""
-
-import json
-import sys
-from pathlib import Path
-
-# Add parent directory to path for imports
-sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
-
-# No direct import needed - we'll just read the JSON file
-
-
-def test_research_agent_thresholds():
-    """Test the Research agent configuration for content thresholds."""
-
-    print("Testing Research Agent Memory Management Configuration...")
-    print("=" * 60)
-
-    # Load the Research agent configuration
-    research_config_path = (
-        Path(__file__).parent.parent / "src/claude_mpm/agents/templates/research.json"
-    )
-
-    if not research_config_path.exists():
-        print(f"❌ Research agent config not found at {research_config_path}")
-        return False
-
-    with research_config_path.open() as f:
-        config = json.load(f)
-
-    # Test 1: Check MCP tool configuration
-    print("\n1. MCP Document Summarizer Integration:")
-    tools = config.get("capabilities", {}).get("tools", [])
-    mcp_tool = "mcp__claude-mpm-gateway__document_summarizer"
-
-    if mcp_tool in tools:
-        print(f"   ✅ MCP summarizer tool configured: {mcp_tool}")
-    else:
-        print("   ❌ MCP summarizer tool missing from tools list")
-        return False
-
-    # Test 2: Check knowledge domain expertise
-    print("\n2. Knowledge Domain Expertise:")
-    expertise = config.get("knowledge", {}).get("domain_expertise", [])
-    threshold_expertise = [
-        e for e in expertise if "threshold" in e.lower() or "20KB" in e
-    ]
-
-    if threshold_expertise:
-        print("   ✅ Content threshold expertise found:")
-        for exp in threshold_expertise:
-            print(f"      - {exp}")
-    else:
-        print("   ⚠️  No explicit threshold expertise found")
-
-    # Test 3: Check best practices
-    print("\n3. Best Practices:")
-    practices = config.get("knowledge", {}).get("best_practices", [])
-    threshold_practices = [
-        p
-        for p in practices
-        if any(
-            word in p.lower()
-            for word in [
-                "threshold",
-                "20kb",
-                "200 lines",
-                "50kb",
-                "batch",
-                "cumulative",
-            ]
-        )
-    ]
-
-    if threshold_practices:
-        print("   ✅ Threshold-related best practices found:")
-        for practice in threshold_practices[:3]:  # Show first 3
-            print(f"      - {practice[:80]}...")
-    else:
-        print("   ⚠️  No threshold-specific best practices found")
-
-    # Test 4: Check constraints
-    print("\n4. Constraints:")
-    constraints = config.get("knowledge", {}).get("constraints", [])
-    threshold_constraints = [
-        c
-        for c in constraints
-        if any(
-            word in c.lower()
-            for word in ["20kb", "100kb", "50kb", "adaptive", "threshold"]
-        )
-    ]
-
-    if threshold_constraints:
-        print("   ✅ Threshold constraints found:")
-        for constraint in threshold_constraints:
-            print(f"      - {constraint[:80]}...")
-    else:
-        print("   ❌ No threshold constraints found")
-        return False
-
-    # Test 5: Check instructions for threshold system
-    print("\n5. Instructions Content:")
-    instructions = config.get("instructions", "")
-
-    # Check for critical threshold sections
-    checks = {
-        "Content Threshold System": "CONTENT THRESHOLD SYSTEM" in instructions,
-        "Threshold Constants": "SUMMARIZE_THRESHOLD_LINES = 200" in instructions,
-        "Critical File Size": "CRITICAL_FILE_SIZE = 100_000" in instructions,
-        "Cumulative Limit": "CUMULATIVE_CONTENT_LIMIT = 50_000" in instructions,
-        "Batch Count": "BATCH_SUMMARIZE_COUNT = 3" in instructions,
-        "File Type Thresholds": "FILE_TYPE_THRESHOLDS" in instructions,
-        "Progressive Summarization": "Progressive Summarization Strategy"
-        in instructions,
-        "Adaptive Grep Context": "Adaptive Grep Context" in instructions,
-        "MCP Integration Patterns": "MCP Summarizer Integration Patterns"
-        in instructions,
-    }
-
-    all_passed = True
-    for check_name, result in checks.items():
-        if result:
-            print(f"   ✅ {check_name}: Found")
-        else:
-            print(f"   ❌ {check_name}: Missing")
-            all_passed = False
-
-    # Test 6: Verify specific threshold values
-    print("\n6. Threshold Values Verification:")
-    threshold_values = {
-        "Single File Lines": "200" in instructions
-        and "SUMMARIZE_THRESHOLD_LINES" in instructions,
-        "Single File Size": "20_000" in instructions or "20KB" in instructions,
-        "Critical Size": "100_000" in instructions or "100KB" in instructions,
-        "Cumulative Size": "50_000" in instructions or "50KB" in instructions,
-        "Batch Count": "3" in instructions and "BATCH_SUMMARIZE_COUNT" in instructions,
-    }
-
-    for value_name, found in threshold_values.items():
-        if found:
-            print(f"   ✅ {value_name}: Configured")
-        else:
-            print(f"   ⚠️  {value_name}: May need verification")
-
-    # Test 7: Check for file type specific handling
-    print("\n7. File Type Specific Thresholds:")
-    file_types = [".py", ".js", ".json", ".yaml", ".md", ".csv"]
-    found_types = [ft for ft in file_types if ft in instructions]
-
-    if len(found_types) >= 4:
-        print(
-            f"   ✅ File type specific thresholds found for: {', '.join(found_types)}"
-        )
-    else:
-        print(
-            f"   ⚠️  Limited file type coverage: {', '.join(found_types) if found_types else 'None'}"
-        )
-
-    # Test 8: Memory metrics reporting
-    print("\n8. Memory Metrics Reporting:")
-    memory_metrics = [
-        "Files Sampled",
-        "Sections Extracted",
-        "Full Files Read",
-        "Memory Usage",
-        "MCP Summarizer Used",
-    ]
-
-    found_metrics = [m for m in memory_metrics if m in instructions]
-    if len(found_metrics) >= 4:
-        print(
-            f"   ✅ Memory metrics reporting configured ({len(found_metrics)}/{len(memory_metrics)})"
-        )
-    else:
-        print(
-            f"   ⚠️  Incomplete memory metrics: {len(found_metrics)}/{len(memory_metrics)}"
-        )
-
-    print("\n" + "=" * 60)
-    if all_passed:
-        print("✅ All critical threshold checks passed!")
-    else:
-        print("⚠️  Some threshold configurations may need adjustment")
-
-    return all_passed
-
-
-def display_threshold_summary():
-    """Display a summary of the configured thresholds."""
-
-    print("\n📊 CONFIGURED THRESHOLDS SUMMARY")
-    print("=" * 60)
-
-    thresholds = {
-        "Single File Thresholds": {
-            "Trigger Summarization": "200 lines or 20KB",
-            "Critical (Always Summarize)": ">100KB",
-            "Skip Unless Critical": ">1MB",
-        },
-        "Cumulative Thresholds": {
-            "Total Content Limit": "50KB",
-            "File Count Limit": "3 files",
-            "Action": "Triggers batch summarization",
-        },
-        "Adaptive Grep Context": {
-            ">50 matches": "-A 2 -B 2 with head -50",
-            "20-50 matches": "-A 5 -B 5 with head -40",
-            "<20 matches": "-A 10 -B 10 (default)",
-        },
-        "File Type Specific (lines)": {
-            "Code (.py, .js, .ts)": "500 lines",
-            "Config (.json, .yaml, .toml)": "100 lines",
-            "Docs (.md, .rst, .txt)": "200 lines",
-            "Data (.csv, .sql, .xml)": "50 lines",
-        },
-        "MCP Summarizer Styles": {
-            "Code Files": "bullet_points (200 words max)",
-            "Documentation": "brief (150 words max)",
-            "Config Files": "detailed (250 words max)",
-            "Batch Summary": "executive (300 words max)",
-        },
-    }
-
-    for category, items in thresholds.items():
-        print(f"\n{category}:")
-        for key, value in items.items():
-            print(f"  • {key}: {value}")
-
-    print("\n" + "=" * 60)
-    print("These thresholds ensure the Research agent maintains")
-    print("85% confidence while preventing memory accumulation.")
-
-
-def main():
-    """Main test execution."""
-
-    print("\n🔬 Research Agent Memory Management Test")
-    print("=" * 60)
-
-    # Run threshold configuration test
-    success = test_research_agent_thresholds()
-
-    # Display threshold summary
-    display_threshold_summary()
-
-    # Final summary
-    print("\n📋 TEST SUMMARY")
-    print("=" * 60)
-
-    if success:
-        print("✅ Research agent is properly configured with:")
-        print("   • Content threshold system (20KB/200 lines)")
-        print("   • MCP document summarizer integration")
-        print("   • Progressive summarization strategy")
-        print("   • Cumulative content tracking (50KB/3 files)")
-        print("   • Adaptive grep context management")
-        print("   • File type-specific thresholds")
-        print("\n✨ The Research agent will maintain 85% confidence")
-        print("   while preventing memory accumulation through")
-        print("   intelligent content management and summarization.")
-    else:
-        print("⚠️  Some configuration elements need attention.")
-        print("   Review the test output above for details.")
-
-    return 0 if success else 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())