claude-mpm 4.4.0__py3-none-any.whl → 4.4.3__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.4.0
+4.4.3

claude_mpm/agents/WORKFLOW.md

@@ -67,20 +67,8 @@ Return: Clean or list of blocked items
 **When user mentions**: ticket, epic, issue, task tracking
 
 **Process**:
-1. Create ISS (single session) or EP (multi-session)
-2. Create TSK for each phase completed
-3. Update with `aitrackdown comment/transition`
-
-**Hierarchy**:
-```
-EP-0001 (Epic)
-└── ISS-0001 (Session Issue)
-    ├── TSK-0001 (Research)
-    ├── TSK-0002 (Code Analyzer)
-    ├── TSK-0003 (Implementation)
-    ├── TSK-0004 (QA)
-    └── TSK-0005 (Documentation)
-```
+Use the mcp-ticketer MCP service for ticket management.
+Ticketing is handled through the MCP Gateway, not internal CLI commands.
 
 ## Structural Delegation Format
 

claude_mpm/cli/commands/configure.py

@@ -246,35 +246,8 @@ class ConfigureCommand(BaseCommand):
         return self._run_interactive_tui(args)
 
     def _run_interactive_tui(self, args) -> CommandResult:
-        """Run the main interactive TUI."""
-        # Check if we can use the modern Textual TUI
-        use_textual = getattr(args, "use_textual", True)
-        force_rich = getattr(args, "force_rich", False)
-
-        if use_textual and not force_rich:
-            try:
-                # Try to import and use Textual TUI
-                from .configure_tui import can_use_tui, launch_tui
-
-                if can_use_tui():
-                    self.console.print(
-                        "[cyan]Launching full-screen configuration interface...[/cyan]"
-                    )
-                    return launch_tui(self.current_scope, self.project_dir)
-                # Fall back to Rich TUI if terminal doesn't support full-screen
-                self.console.print(
-                    "[yellow]Terminal doesn't support full-screen mode. Using menu interface.[/yellow]"
-                )
-            except ImportError:
-                # Textual not available, fall back to Rich
-                self.console.print(
-                    "[yellow]Textual not installed. Using menu interface.[/yellow]"
-                )
-                self.console.print(
-                    "[dim]Install textual for a better experience: pip install textual[/dim]"
-                )
-
-        # Original Rich-based TUI
+        """Run the main interactive menu interface."""
+        # Rich-based menu interface
         try:
             self.console.clear()
 

claude_mpm/cli/commands/mpm_init.py

@@ -643,9 +643,9 @@ The final CLAUDE.md should be a comprehensive, well-organized guide that any AI
             ):
                 checks_passed.append("Archived existing CLAUDE.md")
 
-        # Check for issues
-        if structure_report.get('issues'):
-            for issue in structure_report['issues']:
+        # Check for issues in validation report
+        if validation.get('issues'):
+            for issue in validation['issues']:
                 warnings.append(issue['description'])
 
         if warnings:

claude_mpm/cli/parsers/configure_parser.py

@@ -25,11 +25,11 @@ def add_configure_subparser(subparsers) -> argparse.ArgumentParser:
     Returns:
         The configured configure subparser
     """
-    # Configure command - interactive TUI configuration
+    # Configure command - interactive configuration
     configure_parser = subparsers.add_parser(
         CLICommands.CONFIGURE.value,
-        help="Interactive terminal-based configuration interface for managing agents and behaviors",
-        description="Launch an interactive Rich-based TUI for configuring claude-mpm agents, templates, and behavior files",
+        help="Interactive configuration interface for managing agents and behaviors",
+        description="Launch an interactive Rich-based menu for configuring claude-mpm agents, templates, and behavior files",
     )
 
     # Add common arguments
@@ -122,21 +122,10 @@ def add_configure_subparser(subparsers) -> argparse.ArgumentParser:
     # Display options
     display_group = configure_parser.add_argument_group("display options")
     display_group.add_argument(
-        "--no-colors", action="store_true", help="Disable colored output in the TUI"
+        "--no-colors", action="store_true", help="Disable colored output in the interface"
     )
     display_group.add_argument(
         "--compact", action="store_true", help="Use compact display mode"
     )
-    display_group.add_argument(
-        "--force-rich",
-        action="store_true",
-        help="Force use of Rich menu interface instead of full-screen Textual TUI",
-    )
-    display_group.add_argument(
-        "--no-textual",
-        dest="use_textual",
-        action="store_false",
-        help="Disable Textual TUI and use Rich menu interface",
-    )
 
     return configure_parser

claude_mpm/core/framework/__init__.py

@@ -0,0 +1,38 @@
+"""Framework module for Claude MPM.
+
+This module provides the modular framework loading system with specialized components
+for handling different aspects of framework initialization and management.
+"""
+
+from .loaders import (
+    AgentLoader,
+    FileLoader,
+    InstructionLoader,
+    PackagedLoader,
+)
+from .formatters import (
+    CapabilityGenerator,
+    ContentFormatter,
+    ContextGenerator,
+)
+from .processors import (
+    MemoryProcessor,
+    MetadataProcessor,
+    TemplateProcessor,
+)
+
+__all__ = [
+    # Loaders
+    "FileLoader",
+    "PackagedLoader",
+    "InstructionLoader",
+    "AgentLoader",
+    # Formatters
+    "ContentFormatter",
+    "CapabilityGenerator",
+    "ContextGenerator",
+    # Processors
+    "MetadataProcessor",
+    "TemplateProcessor",
+    "MemoryProcessor",
+]

claude_mpm/core/framework/formatters/__init__.py

@@ -0,0 +1,11 @@
+"""Framework formatters for content generation and formatting."""
+
+from .capability_generator import CapabilityGenerator
+from .content_formatter import ContentFormatter
+from .context_generator import ContextGenerator
+
+__all__ = [
+    "ContentFormatter",
+    "CapabilityGenerator",
+    "ContextGenerator",
+]

claude_mpm/core/framework/formatters/capability_generator.py

@@ -0,0 +1,356 @@
+"""Agent capability generator for dynamic agent discovery."""
+
+import json
+import time
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+import yaml
+
+from claude_mpm.core.logging_utils import get_logger
+
+# Import resource handling for packaged installations
+try:
+    from importlib.resources import files
+except ImportError:
+    try:
+        from importlib_resources import files
+    except ImportError:
+        files = None
+
+
+class CapabilityGenerator:
+    """Generates agent capability sections from deployed agents."""
+
+    def __init__(self):
+        """Initialize the capability generator."""
+        self.logger = get_logger("capability_generator")
+
+    def generate_capabilities_section(
+        self,
+        deployed_agents: List[Dict[str, Any]],
+        local_agents: Dict[str, Dict[str, Any]],
+    ) -> str:
+        """Generate dynamic agent capabilities section.
+
+        Args:
+            deployed_agents: List of deployed agent metadata
+            local_agents: Dictionary of local JSON template agents
+
+        Returns:
+            Formatted capabilities section string
+        """
+        # Build capabilities section
+        section = "\n\n## Available Agent Capabilities\n\n"
+
+        # Combine deployed and local agents
+        all_agents = {}  # key: agent_id, value: (agent_data, priority)
+
+        # Add local agents first (highest priority)
+        for agent_id, agent_data in local_agents.items():
+            all_agents[agent_id] = (agent_data, -1)  # Priority -1 for local agents
+
+        # Add deployed agents with lower priority
+        for priority, agent_data in enumerate(deployed_agents):
+            agent_id = agent_data["id"]
+            # Only add if not already present
+            if agent_id not in all_agents:
+                all_agents[agent_id] = (agent_data, priority)
+
+        # Extract just the agent data and sort
+        final_agents = [agent_data for agent_data, _ in all_agents.values()]
+
+        if not final_agents:
+            return self.get_fallback_capabilities()
+
+        # Sort agents alphabetically by ID
+        final_agents.sort(key=lambda x: x["id"])
+
+        # Display all agents with their rich descriptions
+        for agent in final_agents:
+            # Clean up display name - handle common acronyms
+            display_name = agent.get("display_name", agent["id"])
+            display_name = (
+                display_name.replace("Qa ", "QA ")
+                .replace("Ui ", "UI ")
+                .replace("Api ", "API ")
+            )
+            if display_name.lower() == "qa agent":
+                display_name = "QA Agent"
+
+            # Add local indicator if this is a local agent
+            if agent.get("is_local"):
+                tier_label = f" [LOCAL-{agent.get('tier', 'PROJECT').upper()}]"
+                section += f"\n### {display_name} (`{agent['id']}`) {tier_label}\n"
+            else:
+                section += f"\n### {display_name} (`{agent['id']}`)\n"
+
+            section += f"{agent.get('description', 'Specialized agent')}\n"
+
+            # Add routing information if available
+            if agent.get("routing"):
+                routing = agent["routing"]
+                routing_hints = []
+
+                if routing.get("keywords"):
+                    # Show first 5 keywords for brevity
+                    keywords = routing["keywords"][:5]
+                    routing_hints.append(f"Keywords: {', '.join(keywords)}")
+
+                if routing.get("paths"):
+                    # Show first 3 paths for brevity
+                    paths = routing["paths"][:3]
+                    routing_hints.append(f"Paths: {', '.join(paths)}")
+
+                if routing.get("priority"):
+                    routing_hints.append(f"Priority: {routing['priority']}")
+
+                if routing_hints:
+                    section += f"- **Routing**: {' | '.join(routing_hints)}\n"
+
+                # Add when_to_use if present
+                if routing.get("when_to_use"):
+                    section += f"- **When to use**: {routing['when_to_use']}\n"
+
+            # Add any additional metadata if present
+            if agent.get("authority"):
+                section += f"- **Authority**: {agent['authority']}\n"
+            if agent.get("primary_function"):
+                section += f"- **Primary Function**: {agent['primary_function']}\n"
+            if agent.get("handoff_to"):
+                section += f"- **Handoff To**: {agent['handoff_to']}\n"
+            if agent.get("tools") and agent["tools"] != "standard":
+                section += f"- **Tools**: {agent['tools']}\n"
+            if agent.get("model") and agent["model"] != "opus":
+                section += f"- **Model**: {agent['model']}\n"
+
+            # Add memory routing information if available
+            if agent.get("memory_routing"):
+                memory_routing = agent["memory_routing"]
+                if memory_routing.get("description"):
+                    section += f"- **Memory Routing**: {memory_routing['description']}\n"
+
+        # Add simple Context-Aware Agent Selection
+        section += "\n## Context-Aware Agent Selection\n\n"
+        section += "Select agents based on their descriptions above. Key principles:\n"
+        section += "- **PM questions** → Answer directly (only exception)\n"
+        section += "- Match task requirements to agent descriptions and authority\n"
+        section += "- Consider agent handoff recommendations\n"
+        section += "- Use the agent ID in parentheses when delegating via Task tool\n"
+
+        # Add summary
+        section += f"\n**Total Available Agents**: {len(final_agents)}\n"
+
+        return section
+
+    def parse_agent_metadata(self, agent_file: Path) -> Optional[Dict[str, Any]]:
+        """Parse agent metadata from deployed agent file.
+
+        Args:
+            agent_file: Path to deployed agent file
+
+        Returns:
+            Dictionary with agent metadata or None
+        """
+        try:
+            with open(agent_file) as f:
+                content = f.read()
+
+            # Default values
+            agent_data = {
+                "id": agent_file.stem,
+                "display_name": agent_file.stem.replace("_", " ").replace("-", " ").title(),
+                "description": "Specialized agent",
+            }
+
+            # Extract YAML frontmatter if present
+            if content.startswith("---"):
+                end_marker = content.find("---", 3)
+                if end_marker > 0:
+                    frontmatter = content[3:end_marker]
+                    metadata = yaml.safe_load(frontmatter)
+                    if metadata:
+                        # Use name as ID for Task tool
+                        agent_data["id"] = metadata.get("name", agent_data["id"])
+                        agent_data["display_name"] = (
+                            metadata.get("name", agent_data["display_name"])
+                            .replace("-", " ")
+                            .title()
+                        )
+
+                        # Copy all metadata fields directly
+                        for key, value in metadata.items():
+                            if key not in ["name"]:  # Skip already processed fields
+                                agent_data[key] = value
+
+            # Try to load routing metadata from JSON template if not in YAML frontmatter
+            if "routing" not in agent_data:
+                routing_data = self.load_routing_from_template(agent_file.stem)
+                if routing_data:
+                    agent_data["routing"] = routing_data
+
+            # Try to load memory routing metadata from JSON template
+            if "memory_routing" not in agent_data:
+                memory_routing_data = self.load_memory_routing_from_template(agent_file.stem)
+                if memory_routing_data:
+                    agent_data["memory_routing"] = memory_routing_data
+
+            return agent_data
+
+        except Exception as e:
+            self.logger.debug(f"Could not parse metadata from {agent_file}: {e}")
+            return None
+
+    def load_routing_from_template(
+        self, agent_name: str, framework_path: Optional[Path] = None
+    ) -> Optional[Dict[str, Any]]:
+        """Load routing metadata from agent JSON template.
+
+        Args:
+            agent_name: Name of the agent
+            framework_path: Path to framework installation
+
+        Returns:
+            Dictionary with routing metadata or None if not found
+        """
+        try:
+            # Check if we have a framework path
+            if not framework_path or framework_path == Path("__PACKAGED__"):
+                # For packaged installations, try to load from package resources
+                if files:
+                    try:
+                        templates_package = files("claude_mpm.agents.templates")
+                        template_file = templates_package / f"{agent_name}.json"
+
+                        if template_file.is_file():
+                            template_content = template_file.read_text()
+                            template_data = json.loads(template_content)
+                            return template_data.get("routing")
+                    except Exception as e:
+                        self.logger.debug(
+                            f"Could not load routing from packaged template for {agent_name}: {e}"
+                        )
+                return None
+
+            # For development mode, load from filesystem
+            templates_dir = framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            template_file = templates_dir / f"{agent_name}.json"
+
+            if template_file.exists():
+                with open(template_file) as f:
+                    template_data = json.load(f)
+                    return template_data.get("routing")
+
+            # Also check for variations in naming (underscore vs dash)
+            alternative_names = list(
+                {
+                    agent_name.replace("-", "_"),
+                    agent_name.replace("_", "-"),
+                    agent_name.replace("-", ""),
+                    agent_name.replace("_", ""),
+                }
+            )
+
+            for alt_name in alternative_names:
+                if alt_name != agent_name:
+                    alt_file = templates_dir / f"{alt_name}.json"
+                    if alt_file.exists():
+                        with open(alt_file) as f:
+                            template_data = json.load(f)
+                            return template_data.get("routing")
+
+            return None
+
+        except Exception as e:
+            self.logger.debug(f"Could not load routing metadata for {agent_name}: {e}")
+            return None
+
+    def load_memory_routing_from_template(
+        self, agent_name: str, framework_path: Optional[Path] = None
+    ) -> Optional[Dict[str, Any]]:
+        """Load memory routing metadata from agent JSON template.
+
+        Args:
+            agent_name: Name of the agent
+            framework_path: Path to framework installation
+
+        Returns:
+            Dictionary with memory routing metadata or None if not found
+        """
+        try:
+            # Check if we have a framework path
+            if not framework_path or framework_path == Path("__PACKAGED__"):
+                # For packaged installations, try to load from package resources
+                if files:
+                    try:
+                        templates_package = files("claude_mpm.agents.templates")
+                        template_file = templates_package / f"{agent_name}.json"
+
+                        if template_file.is_file():
+                            template_content = template_file.read_text()
+                            template_data = json.loads(template_content)
+                            return template_data.get("memory_routing")
+                    except Exception as e:
+                        self.logger.debug(
+                            f"Could not load memory routing from packaged template for {agent_name}: {e}"
+                        )
+                return None
+
+            # For development mode, load from filesystem
+            templates_dir = framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            template_file = templates_dir / f"{agent_name}.json"
+
+            if template_file.exists():
+                with open(template_file) as f:
+                    template_data = json.load(f)
+                    return template_data.get("memory_routing")
+
+            # Also check for variations in naming
+            alternative_names = list(
+                {
+                    agent_name.replace("-", "_"),
+                    agent_name.replace("_", "-"),
+                    agent_name.replace("-agent", ""),
+                    agent_name.replace("_agent", ""),
+                    agent_name + "_agent",
+                    agent_name + "-agent",
+                }
+            )
+
+            for alt_name in alternative_names:
+                if alt_name != agent_name:
+                    alt_file = templates_dir / f"{alt_name}.json"
+                    if alt_file.exists():
+                        with open(alt_file) as f:
+                            template_data = json.load(f)
+                            return template_data.get("memory_routing")
+
+            return None
+
+        except Exception as e:
+            self.logger.debug(f"Could not load memory routing from template for {agent_name}: {e}")
+            return None
+
+    def get_fallback_capabilities(self) -> str:
+        """Return fallback capabilities when dynamic discovery fails.
+
+        Returns:
+            Fallback agent capabilities section
+        """
+        return """
+
+## Available Agent Capabilities
+
+You have the following specialized agents available for delegation:
+
+- **Engineer** (`engineer`): Code implementation and development
+- **Research** (`research-agent`): Investigation and analysis
+- **QA** (`qa-agent`): Testing and quality assurance
+- **Documentation** (`documentation-agent`): Documentation creation and maintenance
+- **Security** (`security-agent`): Security analysis and protection
+- **Data Engineer** (`data-engineer`): Data management and pipelines
+- **Ops** (`ops-agent`): Deployment and operations
+- **Version Control** (`version-control`): Git operations and version management
+
+**IMPORTANT**: Use the exact agent ID in parentheses when delegating tasks.
+"""