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

claude_mpm/cli/commands/summarize.py

@@ -0,0 +1,413 @@
+"""
+Document Summarization Command.
+
+Shell-based alternative to MCP document_summarizer tool.
+Provides algorithmic summarization without ML dependencies.
+
+Design Decision: Uses simple text processing techniques:
+- Brief: First paragraph extraction
+- Detailed: Key sentence extraction based on position and length
+- Bullet Points: Convert to markdown bullet list
+- Executive: Opening + conclusion extraction
+
+Why: Lightweight, fast, no dependencies, works offline.
+"""
+
+import json
+import re
+from enum import Enum
+from pathlib import Path
+from typing import Optional
+
+
+class SummaryStyle(str, Enum):
+    """Summary output styles."""
+
+    BRIEF = "brief"
+    DETAILED = "detailed"
+    BULLET_POINTS = "bullet_points"
+    EXECUTIVE = "executive"
+
+
+class OutputFormat(str, Enum):
+    """Output format types."""
+
+    TEXT = "text"
+    JSON = "json"
+    MARKDOWN = "markdown"
+
+
+class DocumentSummarizer:
+    """
+    Algorithmic document summarizer.
+
+    Design Decision: Use simple heuristics instead of ML:
+    - Position-based extraction (opening, closing paragraphs)
+    - Length-based filtering (key sentences)
+    - Structure detection (headings, lists)
+
+    Trade-offs:
+    - Performance: O(n) single pass vs. complex NLP models
+    - Accuracy: ~70% vs. ~90% for ML models
+    - Simplicity: Zero dependencies vs. heavy ML packages
+    """
+
+    def __init__(self, max_words: int = 150):
+        """Initialize summarizer with word limit."""
+        self.max_words = max_words
+
+    def summarize(
+        self, content: str, style: SummaryStyle, lines_limit: Optional[int] = None
+    ) -> str:
+        """
+        Summarize document content.
+
+        Args:
+            content: Document text to summarize
+            style: Summary style (brief, detailed, bullet_points, executive)
+            lines_limit: Optional line limit (reads first N lines only)
+
+        Returns:
+            Summary text
+
+        Complexity: O(n) where n is content length
+        """
+        # Apply line limit if specified
+        if lines_limit:
+            content = self._limit_lines(content, lines_limit)
+
+        # Route to style-specific summarizer
+        summarizers = {
+            SummaryStyle.BRIEF: self._summarize_brief,
+            SummaryStyle.DETAILED: self._summarize_detailed,
+            SummaryStyle.BULLET_POINTS: self._summarize_bullet_points,
+            SummaryStyle.EXECUTIVE: self._summarize_executive,
+        }
+
+        summary = summarizers[style](content)
+        return self._truncate_to_word_limit(summary)
+
+    def _limit_lines(self, content: str, limit: int) -> str:
+        """Limit content to first N lines."""
+        lines = content.split("\n")
+        return "\n".join(lines[:limit])
+
+    def _truncate_to_word_limit(self, text: str) -> str:
+        """Truncate text to max_words limit."""
+        words = text.split()
+        if len(words) <= self.max_words:
+            return text
+
+        # Truncate and add ellipsis
+        truncated = " ".join(words[: self.max_words])
+        return f"{truncated}..."
+
+    def _summarize_brief(self, content: str) -> str:
+        """
+        Brief summary: Extract first paragraph.
+
+        Heuristic: First non-empty paragraph usually introduces document.
+        """
+        paragraphs = self._extract_paragraphs(content)
+        if not paragraphs:
+            return content.strip()
+
+        return paragraphs[0]
+
+    def _summarize_detailed(self, content: str) -> str:
+        """
+        Detailed summary: Extract key sentences.
+
+        Heuristics:
+        - First paragraph (introduction)
+        - Sentences with important markers (however, therefore, important)
+        - Last paragraph (conclusion)
+        """
+        paragraphs = self._extract_paragraphs(content)
+        if not paragraphs:
+            return content.strip()
+
+        key_sentences = []
+
+        # Add first paragraph
+        if paragraphs:
+            key_sentences.append(paragraphs[0])
+
+        # Add sentences with key markers from middle paragraphs
+        if len(paragraphs) > 2:
+            key_markers = [
+                "however",
+                "therefore",
+                "important",
+                "note",
+                "critical",
+                "key",
+                "must",
+                "should",
+                "recommended",
+            ]
+
+            for para in paragraphs[1:-1]:
+                sentences = self._split_sentences(para)
+                for sentence in sentences:
+                    if any(marker in sentence.lower() for marker in key_markers):
+                        key_sentences.append(sentence)
+                        break  # One sentence per paragraph max
+
+        # Add last paragraph
+        if len(paragraphs) > 1:
+            key_sentences.append(paragraphs[-1])
+
+        return " ".join(key_sentences)
+
+    def _summarize_bullet_points(self, content: str) -> str:
+        """
+        Bullet point summary: Convert paragraphs to markdown list.
+
+        Heuristic: Each paragraph becomes a bullet point.
+        """
+        paragraphs = self._extract_paragraphs(content)
+        if not paragraphs:
+            return content.strip()
+
+        # Take key paragraphs (first, middle with markers, last)
+        key_paragraphs = []
+
+        # Always include first
+        if paragraphs:
+            key_paragraphs.append(paragraphs[0])
+
+        # Include middle paragraphs with key content
+        if len(paragraphs) > 2:
+            key_markers = ["however", "therefore", "important", "note", "critical"]
+            for para in paragraphs[1:-1]:
+                if any(marker in para.lower() for marker in key_markers):
+                    # Take first sentence only for bullet point
+                    first_sentence = self._split_sentences(para)[0]
+                    key_paragraphs.append(first_sentence)
+
+        # Include last if different from first
+        if len(paragraphs) > 1:
+            key_paragraphs.append(paragraphs[-1])
+
+        # Format as markdown bullets
+        bullets = [f"- {para}" for para in key_paragraphs]
+        return "\n".join(bullets)
+
+    def _summarize_executive(self, content: str) -> str:
+        """
+        Executive summary: Opening + conclusion.
+
+        Heuristic: First and last paragraphs capture overview and conclusion.
+        """
+        paragraphs = self._extract_paragraphs(content)
+        if not paragraphs:
+            return content.strip()
+
+        if len(paragraphs) == 1:
+            return paragraphs[0]
+
+        # Opening paragraph + conclusion paragraph
+        return f"{paragraphs[0]}\n\n{paragraphs[-1]}"
+
+    def _extract_paragraphs(self, content: str) -> list[str]:
+        """
+        Extract paragraphs from content.
+
+        Filters out:
+        - Empty lines
+        - Short lines (< 40 chars, likely headers/formatting artifacts)
+        - Code blocks (lines with multiple indentation)
+        - Lines that look like code (contain def, class, =, {, etc.)
+        """
+        # Split on double newlines for paragraph boundaries
+        raw_paragraphs = re.split(r"\n\s*\n", content)
+
+        paragraphs = []
+        for para in raw_paragraphs:
+            # Clean and normalize whitespace
+            para = " ".join(para.split())
+
+            # Skip empty or very short paragraphs (likely headers)
+            if len(para) < 40:
+                continue
+
+            # Skip code blocks (heuristic: contains code-like patterns)
+            code_indicators = ["def ", "class ", " = ", "{", "}", "return ", "import "]
+            if any(indicator in para for indicator in code_indicators):
+                continue
+
+            paragraphs.append(para)
+
+        return paragraphs
+
+    def _split_sentences(self, text: str) -> list[str]:
+        """
+        Split text into sentences.
+
+        Simple heuristic: Split on '. ' but handle common abbreviations.
+        """
+        # Handle common abbreviations to avoid false splits
+        text = text.replace("Dr.", "Dr<DOT>")
+        text = text.replace("Mr.", "Mr<DOT>")
+        text = text.replace("Mrs.", "Mrs<DOT>")
+        text = text.replace("e.g.", "e<DOT>g<DOT>")
+        text = text.replace("i.e.", "i<DOT>e<DOT>")
+
+        # Split on sentence boundaries
+        sentences = re.split(r"(?<=[.!?])\s+", text)
+
+        # Restore abbreviations
+        sentences = [s.replace("<DOT>", ".") for s in sentences]
+
+        return [s.strip() for s in sentences if s.strip()]
+
+
+def format_output(summary: str, output_format: OutputFormat, file_path: Path) -> str:
+    """
+    Format summary output.
+
+    Args:
+        summary: Summary text
+        output_format: Output format (text, json, markdown)
+        file_path: Original file path for metadata
+
+    Returns:
+        Formatted output string
+    """
+    if output_format == OutputFormat.TEXT:
+        return summary
+
+    if output_format == OutputFormat.JSON:
+        result = {
+            "file": str(file_path),
+            "summary": summary,
+            "word_count": len(summary.split()),
+        }
+        return json.dumps(result, indent=2)
+
+    if output_format == OutputFormat.MARKDOWN:
+        return f"# Summary: {file_path.name}\n\n{summary}\n"
+
+    return summary
+
+
+def summarize_command(args) -> int:
+    """
+    Execute summarize command.
+
+    Args:
+        args: Parsed command line arguments with:
+            - file_path: Path to file to summarize
+            - style: Summary style
+            - max_words: Maximum words in summary
+            - output: Output format
+            - lines: Optional line limit
+
+    Returns:
+        Exit code (0 for success, 1 for error)
+    """
+    file_path = Path(args.file_path)
+
+    # Validate file exists
+    if not file_path.exists():
+        print(f"Error: File not found: {file_path}")
+        return 1
+
+    if not file_path.is_file():
+        print(f"Error: Not a file: {file_path}")
+        return 1
+
+    try:
+        # Read file content
+        content = file_path.read_text(encoding="utf-8")
+
+        # Create summarizer
+        summarizer = DocumentSummarizer(max_words=args.max_words)
+
+        # Generate summary
+        summary = summarizer.summarize(
+            content, style=SummaryStyle(args.style), lines_limit=args.lines
+        )
+
+        # Format output
+        output = format_output(summary, OutputFormat(args.output), file_path)
+
+        # Print result
+        print(output)
+
+        return 0
+
+    except UnicodeDecodeError:
+        print(f"Error: Cannot read file (not valid UTF-8): {file_path}")
+        return 1
+    except Exception as e:
+        print(f"Error: {e}")
+        return 1
+
+
+def add_summarize_parser(subparsers) -> None:
+    """
+    Add summarize subcommand parser.
+
+    Args:
+        subparsers: Subparsers object from argparse
+    """
+    parser = subparsers.add_parser(
+        "summarize",
+        help="Summarize document content (shell-based alternative to MCP document_summarizer)",
+        description="""
+Algorithmic document summarization without ML dependencies.
+
+Styles:
+  brief         - First paragraph only (quick overview)
+  detailed      - Key sentences from opening, middle, closing
+  bullet_points - Markdown bullet list of key points
+  executive     - Opening + conclusion (for quick decisions)
+
+Examples:
+  claude-mpm summarize README.md
+  claude-mpm summarize docs/guide.md --style detailed --max-words 200
+  claude-mpm summarize src/main.py --style bullet_points --output markdown
+  claude-mpm summarize large.txt --lines 100 --style brief
+        """,
+        formatter_class=lambda prog: __import__("argparse").RawDescriptionHelpFormatter(
+            prog, max_help_position=40
+        ),
+    )
+
+    # Required arguments
+    parser.add_argument("file_path", type=str, help="Path to file to summarize")
+
+    # Optional arguments
+    parser.add_argument(
+        "--style",
+        type=str,
+        choices=["brief", "detailed", "bullet_points", "executive"],
+        default="brief",
+        help="Summary style (default: brief)",
+    )
+
+    parser.add_argument(
+        "--max-words",
+        type=int,
+        default=150,
+        help="Maximum words in summary (default: 150)",
+    )
+
+    parser.add_argument(
+        "--output",
+        type=str,
+        choices=["text", "json", "markdown"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    parser.add_argument(
+        "--lines",
+        type=int,
+        default=None,
+        help="Limit to first N lines of file (default: no limit)",
+    )
+
+    parser.set_defaults(command="summarize")

claude_mpm/cli/executor.py

@@ -24,6 +24,7 @@ from .commands import (
     show_info,
 )
 from .commands.analyze_code import manage_analyze_code
+from .commands.config import manage_config
 from .commands.dashboard import manage_dashboard
 from .commands.skills import manage_skills
 from .commands.upgrade import upgrade
@@ -141,6 +142,24 @@ def execute_command(command: str, args) -> int:
         result = agent_source_command(args)
         return result if result is not None else 0
 
+    # Handle summarize command with lazy import
+    if command == "summarize":
+        # Lazy import to avoid loading unless needed
+        from .commands.summarize import summarize_command
+
+        result = summarize_command(args)
+        return result if result is not None else 0
+
+    # Handle profile command with lazy import
+    if command == "profile":
+        # Lazy import to avoid loading unless needed
+        from .commands.profile import ProfileCommand
+
+        cmd = ProfileCommand()
+        result = cmd.run(args)
+        # Convert CommandResult to exit code
+        return result.exit_code if result else 0
+
     # Handle auto-configure command with lazy import
     if command == "auto-configure":
         # Lazy import to avoid loading unless needed
@@ -228,9 +247,8 @@ def execute_command(command: str, args) -> int:
         CLICommands.MEMORY.value: manage_memory,
         CLICommands.MONITOR.value: manage_monitor,
         CLICommands.DASHBOARD.value: manage_dashboard,
-        # Configuration management commands (synonymous)
-        # Both 'config' and 'configure' launch the interactive configuration TUI
-        CLICommands.CONFIG.value: manage_configure,  # Alias to configure
+        # Configuration management commands
+        CLICommands.CONFIG.value: manage_config,  # Unified config with subcommands
         CLICommands.CONFIGURE.value: manage_configure,  # Interactive configuration TUI
         CLICommands.AGGREGATE.value: aggregate_command,
         CLICommands.ANALYZE_CODE.value: manage_analyze_code,

claude_mpm/cli/interactive/agent_wizard.py

@@ -6,6 +6,7 @@ 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
@@ -61,6 +62,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.
 
@@ -259,25 +304,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
@@ -1299,7 +1374,7 @@ class AgentWizard:
                         Path.home()
                         / ".claude-mpm"
                         / "cache"
-                        / "remote-agents"
+                        / "agents"
                         / "bobmatnyc"
                         / "claude-mpm-agents"
                         / "AUTO-DEPLOY-INDEX.md"
@@ -1344,7 +1419,7 @@ class AgentWizard:
                         Path.home()
                         / ".claude-mpm"
                         / "cache"
-                        / "remote-agents"
+                        / "agents"
                         / "bobmatnyc"
                         / "claude-mpm-agents"
                         / "AUTO-DEPLOY-INDEX.md"

claude_mpm/cli/parsers/agents_parser.py

@@ -406,15 +406,6 @@ Available commands:
         help="Show descriptions and metadata for each agent",
     )
 
-    # Auto-configuration commands (TSK-0054 Phase 5)
-    from .auto_configure_parser import (
-        add_agents_detect_subparser,
-        add_agents_recommend_subparser,
-    )
-
-    add_agents_detect_subparser(agents_subparsers)
-    add_agents_recommend_subparser(agents_subparsers)
-
     # Phase 3: Agent Selection Modes (single-tier deployment)
     # Minimal configuration - deploy 6 core agents
     deploy_minimal_parser = agents_subparsers.add_parser(
@@ -444,6 +435,60 @@ Available commands:
         help="Show what would be deployed without actually deploying",
     )
 
+    # ============================================================================
+    # Collection-Based Agent Management Commands
+    # ============================================================================
+    # Purpose: Enable collection-based agent selection and deployment
+    # Commands: list-collections, deploy-collection, list-by-collection
+    # NEW: Enhanced agent matching with collection_id support
+    # ============================================================================
+
+    # list-collections: List all available agent collections
+    agents_subparsers.add_parser(
+        "list-collections",
+        help="List all available agent collections",
+        description="Display all agent collections with agent counts and collection metadata",
+    )
+
+    # deploy-collection: Deploy all agents from a specific collection
+    deploy_collection_parser = agents_subparsers.add_parser(
+        "deploy-collection",
+        help="Deploy all agents from a specific collection",
+        description="Deploy all agents from a named collection (e.g., 'bobmatnyc/claude-mpm-agents')",
+    )
+    deploy_collection_parser.add_argument(
+        "collection_id",
+        help="Collection ID in format 'owner/repo-name' (e.g., 'bobmatnyc/claude-mpm-agents')",
+    )
+    deploy_collection_parser.add_argument(
+        "--force",
+        "-f",
+        action="store_true",
+        help="Force redeployment even if agents are already deployed",
+    )
+    deploy_collection_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be deployed without actually deploying",
+    )
+
+    # list-by-collection: List agents filtered by collection
+    list_by_collection_parser = agents_subparsers.add_parser(
+        "list-by-collection",
+        help="List agents from a specific collection",
+        description="Display agents from a specific collection with metadata",
+    )
+    list_by_collection_parser.add_argument(
+        "collection_id",
+        help="Collection ID to filter by (e.g., 'bobmatnyc/claude-mpm-agents')",
+    )
+    list_by_collection_parser.add_argument(
+        "--format",
+        choices=["table", "json", "yaml"],
+        default="table",
+        help="Output format (default: table)",
+    )
+
     # ============================================================================
     # Cache Git Management Commands (claude-mpm Issue 1M-442 Phase 2)
     # ============================================================================