claude-mpm 5.0.9__py3-none-any.whl → 5.6.23__py3-none-any.whl

claude_mpm/cli/interactive/agent_wizard.py

@@ -6,13 +6,18 @@ local agents with user-friendly prompts, intelligent defaults, and validation.
 
 import json
 import re
+import shutil
 import sys
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple
 
 import questionary
-from questionary import Style
 
+from claude_mpm.cli.interactive.questionary_styles import (
+    BANNER_WIDTH,
+    MPM_STYLE,
+    print_section_header,
+)
 from claude_mpm.core.logging_config import get_logger
 from claude_mpm.services.agents.local_template_manager import (
     LocalAgentTemplate,
@@ -22,16 +27,6 @@ from claude_mpm.utils.agent_filters import apply_all_filters
 
 logger = get_logger(__name__)
 
-# Questionary style matching Rich cyan theme (consistent with configure.py)
-QUESTIONARY_STYLE = Style(
-    [
-        ("selected", "fg:cyan bold"),
-        ("pointer", "fg:cyan bold"),
-        ("highlighted", "fg:cyan"),
-        ("question", "fg:cyan bold"),
-    ]
-)
-
 
 class AgentWizard:
     """
@@ -61,6 +56,50 @@ class AgentWizard:
             self.source_manager = None
             self.discovery_enabled = False
 
+    @staticmethod
+    def _calculate_column_widths(
+        terminal_width: int, columns: Dict[str, int]
+    ) -> Dict[str, int]:
+        """Calculate dynamic column widths based on terminal size.
+
+        Args:
+            terminal_width: Current terminal width in characters
+            columns: Dict mapping column names to minimum widths
+
+        Returns:
+            Dict mapping column names to calculated widths
+
+        Design:
+            - Ensures minimum widths are respected
+            - Distributes extra space proportionally
+            - Handles narrow terminals gracefully (minimum 80 chars)
+        """
+        # Ensure minimum terminal width
+        min_terminal_width = 80
+        terminal_width = max(terminal_width, min_terminal_width)
+
+        # Calculate total minimum width needed
+        total_min_width = sum(columns.values())
+
+        # Account for spacing between columns
+        overhead = len(columns) + 1
+        available_width = terminal_width - overhead
+
+        # If we have extra space, distribute proportionally
+        if available_width > total_min_width:
+            extra_space = available_width - total_min_width
+            total_weight = sum(columns.values())
+
+            result = {}
+            for col_name, min_width in columns.items():
+                # Distribute extra space based on minimum width proportion
+                proportion = min_width / total_weight
+                extra = int(extra_space * proportion)
+                result[col_name] = min_width + extra
+            return result
+        # Terminal too narrow, use minimum widths
+        return columns.copy()
+
     def run_interactive_create(self) -> Tuple[bool, str]:
         """Run interactive agent creation wizard.
 
@@ -68,9 +107,7 @@ class AgentWizard:
             Tuple of (success, message)
         """
         try:
-            print("\n" + "=" * 60)
-            print("🧙‍♂️  Agent Creation Wizard")
-            print("=" * 60)
+            print_section_header("🧙‍♂️", "Agent Creation Wizard", width=BANNER_WIDTH)
             print("\nI'll guide you through creating a custom local agent.")
             print("Press Ctrl+C anytime to cancel.\n")
 
@@ -236,9 +273,7 @@ class AgentWizard:
                 # Get merged agents from all sources
                 all_agents = self._merge_agent_sources()
 
-                print("\n" + "=" * 60)
-                print("🔧  Agent Management Menu")
-                print("=" * 60)
+                print_section_header("🔧", "Agent Management Menu", width=BANNER_WIDTH)
 
                 if not all_agents:
                     print(
@@ -259,25 +294,55 @@ class AgentWizard:
                     print("❌ Invalid choice. Please try again.")
                     continue
 
-                # Show existing agents in a table
+                # Show existing agents in a table with dynamic widths
                 print(f"\n📋 Found {len(all_agents)} agent(s):\n")
+
+                # Calculate dynamic column widths based on terminal size
+                terminal_width = shutil.get_terminal_size().columns
+                min_widths = {
+                    "#": 4,
+                    "Agent ID": 30,
+                    "Name": 20,
+                    "Source": 15,
+                    "Status": 10,
+                }
+                widths = self._calculate_column_widths(terminal_width, min_widths)
+
+                # Print header with dynamic widths
                 print(
-                    f"{'#':<4} {'Agent ID':<40} {'Name':<25} {'Source':<20} {'Status':<10}"
+                    f"{'#':<{widths['#']}} "
+                    f"{'Agent ID':<{widths['Agent ID']}} "
+                    f"{'Name':<{widths['Name']}} "
+                    f"{'Source':<{widths['Source']}} "
+                    f"{'Status':<{widths['Status']}}"
                 )
-                print("-" * 105)
+                separator_width = sum(widths.values()) + len(widths) - 1
+                print("-" * separator_width)
 
                 for i, agent in enumerate(all_agents, 1):
                     agent_id = agent["agent_id"]
-                    name = (
-                        agent["name"][:24] if len(agent["name"]) > 24 else agent["name"]
-                    )
+                    # Truncate to fit dynamic width
+                    if len(agent_id) > widths["Agent ID"]:
+                        agent_id = agent_id[: widths["Agent ID"] - 1] + "…"
+
+                    name = agent["name"]
+                    if len(name) > widths["Name"]:
+                        name = name[: widths["Name"] - 1] + "…"
+
                     source_label = (
-                        f"[{agent['source_type']}] {agent['source_identifier']}"[:19]
+                        f"[{agent['source_type']}] {agent['source_identifier']}"
                     )
+                    if len(source_label) > widths["Source"]:
+                        source_label = source_label[: widths["Source"] - 1] + "…"
+
                     status = "✓ Deployed" if agent["deployed"] else "Available"
 
                     print(
-                        f"{i:<4} {agent_id:<40} {name:<25} {source_label:<20} {status:<10}"
+                        f"{i:<{widths['#']}} "
+                        f"{agent_id:<{widths['Agent ID']}} "
+                        f"{name:<{widths['Name']}} "
+                        f"{source_label:<{widths['Source']}} "
+                        f"{status:<{widths['Status']}}"
                     )
 
                 # Build menu choices with arrow-key navigation
@@ -309,7 +374,7 @@ class AgentWizard:
                 choice = questionary.select(
                     "Agent Management Menu:",
                     choices=menu_choices,
-                    style=QUESTIONARY_STYLE,
+                    style=MPM_STYLE,
                 ).ask()
 
                 if not choice:  # User pressed Esc
@@ -701,9 +766,7 @@ class AgentWizard:
 
     def _confirm_creation(self, config: Dict[str, Any]) -> bool:
         """Show preview and get confirmation from user."""
-        print("\n" + "=" * 60)
-        print("📋  Agent Configuration Preview")
-        print("=" * 60)
+        print_section_header("📋", "Agent Configuration Preview", width=BANNER_WIDTH)
 
         print(f"Agent ID:     {config['agent_id']}")
         print(f"Name:         {config['name']}")
@@ -720,7 +783,8 @@ class AgentWizard:
         print("\nInstructions Preview:")
         print(f"  {config['instructions_preview']}")
 
-        print("\n" + "=" * 60)
+        print()
+        print("=" * BANNER_WIDTH)
 
         while True:
             confirm = input("\nCreate this agent? [Y/n]: ").strip().lower()
@@ -971,8 +1035,7 @@ class AgentWizard:
 
     def _interactive_delete_menu(self, templates: list) -> Tuple[bool, str]:
         """Interactive deletion menu for multiple agents."""
-        print("\n🗑️  Delete Agents")
-        print("=" * 50)
+        print_section_header("🗑️", "Delete Agents", width=BANNER_WIDTH)
 
         if not templates:
             return False, "No agents available to delete"
@@ -1079,9 +1142,9 @@ class AgentWizard:
         Args:
             agent: Agent metadata dictionary
         """
-        print("\n" + "=" * 60)
-        print(f"📄 Agent Details: {agent['agent_id']}")
-        print("=" * 60)
+        print_section_header(
+            "📄", f"Agent Details: {agent['agent_id']}", width=BANNER_WIDTH
+        )
         print(f"Name:         {agent['name']}")
         print(f"Category:     {agent['category'] or 'N/A'}")
         print(f"Source:       [{agent['source_type']}] {agent['source_identifier']}")
@@ -1113,9 +1176,7 @@ class AgentWizard:
             input("\nPress Enter to continue...")
             return
 
-        print("\n" + "=" * 60)
-        print("📦 Deploy Agent")
-        print("=" * 60)
+        print_section_header("📦", "Deploy Agent", width=BANNER_WIDTH)
         print(f"\n{len(deployable)} agent(s) available to deploy:\n")
 
         # Build agent selection choices with arrow-key navigation
@@ -1125,7 +1186,7 @@ class AgentWizard:
         ]
 
         choice = questionary.select(
-            "Select agent to deploy:", choices=agent_choices, style=QUESTIONARY_STYLE
+            "Select agent to deploy:", choices=agent_choices, style=MPM_STYLE
         ).ask()
 
         if not choice:  # User pressed Esc
@@ -1221,9 +1282,7 @@ class AgentWizard:
             return
 
         while True:
-            print("\n" + "=" * 60)
-            print("🔍 Browse & Filter Agents")
-            print("=" * 60)
+            print_section_header("🔍", "Browse & Filter Agents", width=BANNER_WIDTH)
 
             # Show filter menu with arrow-key navigation
             print("\n[bold]Filter by:[/bold]")
@@ -1239,7 +1298,7 @@ class AgentWizard:
             choice = questionary.select(
                 "Browse & Filter Agents:",
                 choices=filter_choices,
-                style=QUESTIONARY_STYLE,
+                style=MPM_STYLE,
             ).ask()
 
             if not choice or "Back" in choice:
@@ -1268,7 +1327,7 @@ class AgentWizard:
                 cat_choices = [f"{idx}. {cat}" for idx, cat in enumerate(categories, 1)]
 
                 cat_choice = questionary.select(
-                    "Select category:", choices=cat_choices, style=QUESTIONARY_STYLE
+                    "Select category:", choices=cat_choices, style=MPM_STYLE
                 ).ask()
 
                 if not cat_choice:  # User pressed Esc
@@ -1299,7 +1358,7 @@ class AgentWizard:
                         Path.home()
                         / ".claude-mpm"
                         / "cache"
-                        / "remote-agents"
+                        / "agents"
                         / "bobmatnyc"
                         / "claude-mpm-agents"
                         / "AUTO-DEPLOY-INDEX.md"
@@ -1344,7 +1403,7 @@ class AgentWizard:
                         Path.home()
                         / ".claude-mpm"
                         / "cache"
-                        / "remote-agents"
+                        / "agents"
                         / "bobmatnyc"
                         / "claude-mpm-agents"
                         / "AUTO-DEPLOY-INDEX.md"
@@ -1382,9 +1441,11 @@ class AgentWizard:
                 continue
 
             # Display filtered results
-            print("\n" + "=" * 60)
-            print(f"📋 {filter_description} ({len(filtered_agents)} agents)")
-            print("=" * 60)
+            print_section_header(
+                "📋",
+                f"{filter_description} ({len(filtered_agents)} agents)",
+                width=BANNER_WIDTH,
+            )
 
             if not filtered_agents:
                 print("\n[yellow]No agents found matching filter[/yellow]")
@@ -1448,7 +1509,7 @@ class AgentWizard:
         ]
 
         agent_choice = questionary.select(
-            "Select agent to deploy:", choices=agent_choices, style=QUESTIONARY_STYLE
+            "Select agent to deploy:", choices=agent_choices, style=MPM_STYLE
         ).ask()
 
         if not agent_choice:  # User pressed Esc
@@ -1554,7 +1615,7 @@ class AgentWizard:
         ]
 
         agent_choice = questionary.select(
-            "Select agent to view:", choices=agent_choices, style=QUESTIONARY_STYLE
+            "Select agent to view:", choices=agent_choices, style=MPM_STYLE
         ).ask()
 
         if not agent_choice:  # User pressed Esc
@@ -1577,9 +1638,7 @@ class AgentWizard:
         preset_service = AgentPresetService(self.source_manager)
 
         while True:
-            print("\n" + "=" * 60)
-            print("📦 Deploy Agent Preset")
-            print("=" * 60)
+            print_section_header("📦", "Deploy Agent Preset", width=BANNER_WIDTH)
 
             # List available presets
             presets = preset_service.list_presets()
@@ -1615,9 +1674,7 @@ class AgentWizard:
                 preset_name = presets[idx]["name"]
 
                 # Show preset details
-                print("\n" + "=" * 60)
-                print(f"📦 Preset: {preset_name}")
-                print("=" * 60)
+                print_section_header("📦", f"Preset: {preset_name}", width=BANNER_WIDTH)
                 print(f"\n[bold]Description:[/bold] {presets[idx]['description']}\n")
 
                 # Resolve preset
@@ -1797,9 +1854,7 @@ class AgentWizard:
             input("\nPress Enter to continue...")
             return
 
-        print("\n" + "=" * 60)
-        print("🔗 Manage Agent Sources")
-        print("=" * 60)
+        print_section_header("🔗", "Manage Agent Sources", width=BANNER_WIDTH)
 
         try:
             from claude_mpm.config.agent_sources import AgentSourceConfiguration

claude_mpm/cli/interactive/questionary_styles.py

@@ -0,0 +1,65 @@
+"""Shared questionary styles for consistent TUI across Claude MPM.
+
+This module provides unified styling for all interactive questionary interfaces
+to ensure visual consistency across agent wizard, skill selector, and other TUI components.
+"""
+
+from questionary import Style
+
+# Standard cyan-themed style for all selectors
+# Matches the pattern used in agent_wizard.py and skill_selector.py
+MPM_STYLE = Style(
+    [
+        ("qmark", "fg:cyan bold"),
+        ("question", "bold"),
+        ("answer", "fg:cyan"),
+        ("pointer", "fg:cyan bold"),
+        ("highlighted", "fg:cyan bold"),
+        ("selected", "fg:cyan"),
+    ]
+)
+
+# Banner constants for consistent formatting
+BANNER_WIDTH = 60
+BANNER_CHAR = "="
+
+
+def print_banner(title: str, width: int = BANNER_WIDTH) -> None:
+    """Print a styled banner matching agent selector format.
+
+    Args:
+        title: Title text to display in the banner
+        width: Total width of the banner in characters (default: 60)
+
+    Example:
+        >>> print_banner("Agent Creation Wizard")
+        ============================================================
+                        Agent Creation Wizard
+        ============================================================
+    """
+    print()
+    print(BANNER_CHAR * width)
+    print(f"{title:^{width}}")
+    print(BANNER_CHAR * width)
+    print()
+
+
+def print_section_header(emoji: str, title: str, width: int = BANNER_WIDTH) -> None:
+    """Print a section header with emoji and title.
+
+    Args:
+        emoji: Emoji to display before the title
+        title: Section title text
+        width: Total width of the header line (default: 60)
+
+    Example:
+        >>> print_section_header("🔧", "Agent Management Menu")
+
+        ============================================================
+        🔧  Agent Management Menu
+        ============================================================
+    """
+    print()
+    print(BANNER_CHAR * width)
+    print(f"{emoji}  {title}")
+    print(BANNER_CHAR * width)