claude-mpm 4.3.11__py3-none-any.whl → 4.3.13__py3-none-any.whl

claude_mpm/cli/parsers/search_parser.py

@@ -0,0 +1,245 @@
+"""
+Search command parser for mcp-vector-search integration.
+
+This module provides argument parsing for the /mpm-search command.
+"""
+
+import argparse
+from typing import Optional
+
+
+def add_search_subparser(
+    subparsers: argparse._SubParsersAction,
+) -> argparse.ArgumentParser:
+    """
+    Add the search command parser.
+
+    Args:
+        subparsers: The subparsers action to add the search parser to.
+
+    Returns:
+        The created search parser.
+    """
+    search_parser = subparsers.add_parser(
+        "mpm-search",
+        aliases=["search"],
+        help="Search codebase using semantic search",
+        description=(
+            "Search the codebase using semantic search powered by mcp-vector-search. "
+            "Can search by query, find similar code, search by context, or manage the search index."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Search for code by query
+  claude-mpm mpm-search "authentication logic"
+
+  # Find code similar to a file
+  claude-mpm mpm-search --similar src/auth.py
+
+  # Search by contextual description
+  claude-mpm mpm-search --context "find all API endpoints"
+
+  # Index the project (required before searching)
+  claude-mpm mpm-search --index
+
+  # Force reindex the project
+  claude-mpm mpm-search --index --force
+
+  # Check index status
+  claude-mpm mpm-search --status
+
+  # Search with filters
+  claude-mpm mpm-search "database" --language python --limit 20
+
+  # Search with multiple file extensions
+  claude-mpm mpm-search "test" --extensions .py --extensions .js
+
+  # Find similar code to a specific function
+  claude-mpm mpm-search --similar src/auth.py --function authenticate_user
+
+  # Search with context and focus areas
+  claude-mpm mpm-search --context "security vulnerabilities" --focus authentication --focus encryption
+
+  # Output as JSON for processing
+  claude-mpm mpm-search "api" --json
+""",
+    )
+
+    # Primary search modes (mutually exclusive)
+    search_mode = search_parser.add_mutually_exclusive_group()
+
+    search_mode.add_argument(
+        "query",
+        nargs="?",
+        help="Search query for semantic code search",
+    )
+
+    search_mode.add_argument(
+        "--similar",
+        "-s",
+        metavar="FILE",
+        help="Find code similar to the specified file",
+    )
+
+    search_mode.add_argument(
+        "--context",
+        "-c",
+        metavar="DESCRIPTION",
+        help="Search by contextual description of what you're looking for",
+    )
+
+    # Index management options
+    search_parser.add_argument(
+        "--index",
+        action="store_true",
+        help="Index or reindex the project codebase",
+    )
+
+    search_parser.add_argument(
+        "--status",
+        action="store_true",
+        help="Check project indexing status and statistics",
+    )
+
+    # Search filters and options
+    search_parser.add_argument(
+        "--limit",
+        "-l",
+        type=int,
+        default=10,
+        metavar="N",
+        help="Maximum number of results to return (default: 10, max: 50)",
+    )
+
+    search_parser.add_argument(
+        "--threshold",
+        "-t",
+        type=float,
+        default=0.3,
+        metavar="SCORE",
+        help="Similarity threshold between 0.0 and 1.0 (default: 0.3)",
+    )
+
+    search_parser.add_argument(
+        "--language",
+        metavar="LANG",
+        help="Filter by programming language (e.g., python, javascript, go)",
+    )
+
+    search_parser.add_argument(
+        "--extensions",
+        action="append",
+        metavar="EXT",
+        help="Filter by file extensions (e.g., .py, .js). Can be specified multiple times",
+    )
+
+    # Options for --similar mode
+    search_parser.add_argument(
+        "--function",
+        "-f",
+        metavar="NAME",
+        help="Function name within the file (used with --similar)",
+    )
+
+    # Options for --context mode
+    search_parser.add_argument(
+        "--focus",
+        action="append",
+        metavar="AREA",
+        help="Focus areas for contextual search (e.g., security, performance). Can be specified multiple times",
+    )
+
+    # Options for --index mode
+    search_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force reindexing even if index already exists (used with --index)",
+    )
+
+    # Output options
+    search_parser.add_argument(
+        "--json",
+        action="store_true",
+        dest="output_json",
+        help="Output results as JSON instead of formatted text",
+    )
+
+    # Additional filters
+    search_parser.add_argument(
+        "--class",
+        dest="class_name",
+        metavar="NAME",
+        help="Filter by class name",
+    )
+
+    search_parser.add_argument(
+        "--files",
+        metavar="PATTERN",
+        help="Filter by file patterns (e.g., '*.py' or 'src/*.js')",
+    )
+
+    # Verbose output
+    search_parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Enable verbose output with additional details",
+    )
+
+    return search_parser
+
+
+def validate_search_args(args: argparse.Namespace) -> Optional[str]:  # noqa: PLR0911
+    """
+    Validate search command arguments.
+
+    Args:
+        args: Parsed command line arguments.
+
+    Returns:
+        Error message if validation fails, None otherwise.
+    """
+    # Check threshold is in valid range
+    if hasattr(args, "threshold") and args.threshold is not None:
+        if not 0.0 <= args.threshold <= 1.0:
+            return "Similarity threshold must be between 0.0 and 1.0"
+
+    # Check limit is reasonable
+    if hasattr(args, "limit") and args.limit is not None:
+        if args.limit < 1:
+            return "Limit must be at least 1"
+        if args.limit > 50:
+            return "Limit cannot exceed 50"
+
+    # Check that function is only used with --similar
+    if (
+        hasattr(args, "function")
+        and args.function
+        and not getattr(args, "similar", None)
+    ):
+        return "--function can only be used with --similar"
+
+    # Check that focus is only used with --context
+    if hasattr(args, "focus") and args.focus and not getattr(args, "context", None):
+        return "--focus can only be used with --context"
+
+    # Check that force is only used with --index
+    if hasattr(args, "force") and args.force and not getattr(args, "index", False):
+        return "--force can only be used with --index"
+
+    # Ensure at least one operation is specified
+    if hasattr(args, "command") and args.command in ["mpm-search", "search"]:
+        has_operation = any(
+            [
+                getattr(args, "query", None),
+                getattr(args, "similar", None),
+                getattr(args, "context", None),
+                getattr(args, "index", False),
+                getattr(args, "status", False),
+            ]
+        )
+        if not has_operation:
+            return "No search operation specified. Use --help for options."
+
+    return None

claude_mpm/cli/startup_logging.py

@@ -69,7 +69,7 @@ def log_memory_stats(logger=None, prefix="Memory Usage"):
                     f"{prefix}: RSS={rss_mb:.1f}MB, System={memory_percent:.1f}%"
                 )
                 return {"rss_mb": rss_mb, "vms_mb": None, "percent": memory_percent}
-            except:
+            except Exception:
                 logger.info(f"{prefix}: RSS={rss_mb:.1f}MB")
                 return {"rss_mb": rss_mb, "vms_mb": None, "percent": None}
         else:
@@ -82,7 +82,7 @@ def log_memory_stats(logger=None, prefix="Memory Usage"):
                     f"System={memory_percent:.1f}%"
                 )
                 return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": memory_percent}
-            except:
+            except Exception:
                 logger.info(f"{prefix}: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB")
                 return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": None}
 
@@ -114,12 +114,10 @@ class StartupStatusLogger:
             if mcp_executable:
                 self.logger.info(f"MCP Server: Installed at {mcp_executable}")
 
-                # Try to get version
+                # Try to get version (only log if version is found)
                 version = self._get_mcp_version(mcp_executable)
                 if version:
                     self.logger.info(f"MCP Server: Version {version}")
-                else:
-                    self.logger.info("MCP Server: Version unknown")
             else:
                 self.logger.info("MCP Server: Not found in PATH")
 

claude_mpm/cli/utils.py

@@ -106,7 +106,7 @@ def get_agent_versions_display() -> Optional[str]:
                     base_version_tuple
                 )
                 output_lines.append(f"\n  Base Agent Version:  {base_version_str}")
-        except:
+        except Exception:
             pass
 
         # Check for agents needing migration

claude_mpm/constants.py

@@ -140,6 +140,7 @@ class MCPCommands(str, Enum):
     TEST = "test"
     CONFIG = "config"
     SERVER = "server"
+    EXTERNAL = "external"
 
 
 class TicketCommands(str, Enum):

claude_mpm/core/agent_registry.py

@@ -14,23 +14,27 @@ This module provides:
 import contextlib
 import warnings
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Set
 
 # Import from the unified agent registry system
+from .unified_agent_registry import AgentMetadata as UnifiedAgentMetadata
 from .unified_agent_registry import (
-    AgentMetadata as UnifiedAgentMetadata,
     AgentTier,
     AgentType,
-    discover_agents as unified_discover_agents,
-    get_agent as unified_get_agent,
+)
+from .unified_agent_registry import discover_agents as unified_discover_agents
+from .unified_agent_registry import get_agent as unified_get_agent
+from .unified_agent_registry import (
     get_agent_registry,
-    get_core_agents as unified_get_core_agents,
-    get_registry_stats as unified_get_registry_stats,
+)
+from .unified_agent_registry import get_core_agents as unified_get_core_agents
+from .unified_agent_registry import get_registry_stats as unified_get_registry_stats
+from .unified_agent_registry import (
     get_specialized_agents as unified_get_specialized_agents,
-    list_agents as unified_list_agents,
 )
+from .unified_agent_registry import list_agents as unified_list_agents
 
 try:
     from ..core.logger import get_logger
@@ -379,7 +383,7 @@ class AgentRegistryAdapter:
         }
 
         nickname = nicknames.get(agent_name, agent_name.title())
-        today = datetime.now().strftime("%Y-%m-%d")
+        today = datetime.now(timezone.utc).strftime("%Y-%m-%d")
 
         return f"""**{nickname}**: {task}
 

claude_mpm/core/agent_session_manager.py

@@ -3,7 +3,7 @@
 import json
 import uuid
 from collections import defaultdict
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from typing import Dict, Optional
 
@@ -53,10 +53,10 @@ class AgentSessionManager:
             if not self.session_locks.get(session_id, False):
                 # Check if session is still fresh (not too old)
                 created = datetime.fromisoformat(session_data["created_at"])
-                if datetime.now() - created < timedelta(hours=1):
+                if datetime.now(timezone.utc) - created < timedelta(hours=1):
                     # Use this session
                     self.session_locks[session_id] = True
-                    session_data["last_used"] = datetime.now().isoformat()
+                    session_data["last_used"] = datetime.now(timezone.utc).isoformat()
                     session_data["use_count"] += 1
                     logger.info(f"Reusing session {session_id} for {agent_type} agent")
                     return session_id
@@ -85,8 +85,8 @@ class AgentSessionManager:
         session_data = {
             "id": session_id,
             "agent_type": agent_type,
-            "created_at": datetime.now().isoformat(),
-            "last_used": datetime.now().isoformat(),
+            "created_at": datetime.now(timezone.utc).isoformat(),
+            "last_used": datetime.now(timezone.utc).isoformat(),
             "use_count": 0,
             "tasks_completed": [],
         }
@@ -122,7 +122,7 @@ class AgentSessionManager:
                 sessions[session_id]["tasks_completed"].append(
                     {
                         "task": task[:100],  # Truncate long tasks
-                        "timestamp": datetime.now().isoformat(),
+                        "timestamp": datetime.now(timezone.utc).isoformat(),
                         "success": success,
                     }
                 )
@@ -135,7 +135,7 @@ class AgentSessionManager:
         Args:
             max_age_hours: Maximum age in hours
         """
-        now = datetime.now()
+        now = datetime.now(timezone.utc)
         max_age = timedelta(hours=max_age_hours)
 
         for agent_type in list(self.agent_sessions.keys()):
@@ -207,7 +207,7 @@ class AgentSessionManager:
         try:
             data = {
                 "agent_sessions": dict(self.agent_sessions),
-                "updated_at": datetime.now().isoformat(),
+                "updated_at": datetime.now(timezone.utc).isoformat(),
             }
             with open(session_file, "w") as f:
                 json.dump(data, f, indent=2)

claude_mpm/core/api_validator.py

@@ -84,7 +84,7 @@ class APIKeyValidator:
 
         return not bool(self.errors), self.errors, self.warnings
 
-    def _validate_openai_key(self, api_key: str) -> bool:
+    def _validate_openai_key(self, api_key: str) -> bool:  # noqa: PLR0911
         """Validate OpenAI API key.
 
         Args:
@@ -133,7 +133,7 @@ class APIKeyValidator:
             self.errors.append(f"❌ OpenAI API validation failed with error: {e}")
             return False
 
-    def _validate_anthropic_key(self, api_key: str) -> bool:
+    def _validate_anthropic_key(self, api_key: str) -> bool:  # noqa: PLR0911
         """Validate Anthropic API key.
 
         Args:
@@ -196,7 +196,7 @@ class APIKeyValidator:
             self.errors.append(f"❌ Anthropic API validation failed with error: {e}")
             return False
 
-    def _validate_github_token(self, token: str) -> bool:
+    def _validate_github_token(self, token: str) -> bool:  # noqa: PLR0911
         """Validate GitHub personal access token.
 
         Args:
@@ -244,7 +244,7 @@ class APIKeyValidator:
             self.errors.append(f"❌ GitHub token validation failed with error: {e}")
             return False
 
-    def _validate_custom_api(self, api_name: str, validation_config: Dict) -> bool:
+    def _validate_custom_api(self, api_name: str, validation_config: Dict) -> bool:  # noqa: PLR0911
         """Validate a custom API key based on configuration.
 
         Args:

claude_mpm/core/base_service.py

@@ -26,7 +26,7 @@ import traceback
 from abc import ABC, abstractmethod
 from contextlib import asynccontextmanager
 from dataclasses import dataclass, field
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
@@ -144,7 +144,7 @@ class BaseService(LoggerMixin, ABC):
         self._health = ServiceHealth(
             status="unknown",
             message="Service not started",
-            timestamp=datetime.now().isoformat(),
+            timestamp=datetime.now(timezone.utc).isoformat(),
         )
         self._metrics = ServiceMetrics()
         self._last_health_check: Optional[float] = None
@@ -199,7 +199,7 @@ class BaseService(LoggerMixin, ABC):
     def uptime(self) -> Optional[float]:
         """Get service uptime in seconds."""
         if self._start_time and self._running:
-            return (datetime.now() - self._start_time).total_seconds()
+            return (datetime.now(timezone.utc) - self._start_time).total_seconds()
         return None
 
     @property
@@ -237,7 +237,7 @@ class BaseService(LoggerMixin, ABC):
             self._health = ServiceHealth(
                 status="unhealthy",
                 message=f"Startup failed: {e!s}",
-                timestamp=datetime.now().isoformat(),
+                timestamp=datetime.now(timezone.utc).isoformat(),
                 checks={"startup": False},
             )
 
@@ -268,13 +268,13 @@ class BaseService(LoggerMixin, ABC):
 
         # Mark as running
         self._running = True
-        self._start_time = datetime.now()
+        self._start_time = datetime.now(timezone.utc)
 
         # Update health status
         self._health = ServiceHealth(
             status="healthy",
             message="Service started successfully",
-            timestamp=datetime.now().isoformat(),
+            timestamp=datetime.now(timezone.utc).isoformat(),
             checks={"startup": True},
             metrics=self._get_health_metrics() if self._enable_enhanced else {},
         )
@@ -338,7 +338,7 @@ class BaseService(LoggerMixin, ABC):
         self._health = ServiceHealth(
             status="unknown",
             message="Service stopped",
-            timestamp=datetime.now().isoformat(),
+            timestamp=datetime.now(timezone.utc).isoformat(),
             checks={"running": False},
         )
 
@@ -388,7 +388,7 @@ class BaseService(LoggerMixin, ABC):
             self._health = ServiceHealth(
                 status=status,
                 message=message,
-                timestamp=datetime.now().isoformat(),
+                timestamp=datetime.now(timezone.utc).isoformat(),
                 checks=checks,
                 metrics={
                     "uptime": self.uptime,
@@ -404,7 +404,7 @@ class BaseService(LoggerMixin, ABC):
             self._health = ServiceHealth(
                 status="unhealthy",
                 message=f"Health check error: {e!s}",
-                timestamp=datetime.now().isoformat(),
+                timestamp=datetime.now(timezone.utc).isoformat(),
                 checks={"health_check_error": True},
             )
             return self._health
@@ -586,7 +586,7 @@ class BaseService(LoggerMixin, ABC):
                     return ServiceHealth(
                         status="degraded",
                         message="Service circuit breaker is open",
-                        timestamp=datetime.now().isoformat(),
+                        timestamp=datetime.now(timezone.utc).isoformat(),
                         checks={"circuit_breaker": False},
                         metrics=self._get_health_metrics(),
                     )

claude_mpm/core/cache.py

@@ -19,7 +19,7 @@ import pickle
 import threading
 from collections import OrderedDict
 from dataclasses import dataclass, field
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Any, Callable, Dict, Optional, TypeVar, Union
 
 from ..core.logger import get_logger
@@ -43,12 +43,12 @@ class CacheEntry:
         """Check if entry has expired based on TTL."""
         if self.ttl is None:
             return False
-        age = (datetime.now() - self.created_at).total_seconds()
+        age = (datetime.now(timezone.utc) - self.created_at).total_seconds()
         return age > self.ttl
 
     def touch(self):
         """Update last access time and increment counter."""
-        self.last_accessed = datetime.now()
+        self.last_accessed = datetime.now(timezone.utc)
         self.access_count += 1
 
 
@@ -129,13 +129,13 @@ class FileSystemCache:
             # Rough estimate using JSON serialization
             try:
                 return len(json.dumps(value))
-            except:
+            except Exception:
                 return 1000  # Default estimate
         else:
             # Use pickle for size estimation
             try:
                 return len(pickle.dumps(value))
-            except:
+            except Exception:
                 return 100  # Default small size
 
     def _evict_lru(self):

claude_mpm/core/config_constants.py

@@ -99,7 +99,7 @@ class ConfigConstants:
         cls._config_service = config_service
 
     @classmethod
-    def get_timeout(cls, timeout_type: str) -> int:
+    def get_timeout(cls, timeout_type: str) -> int:  # noqa: PLR0911
         """
         Get timeout value by type.
 

claude_mpm/core/container.py

@@ -636,7 +636,7 @@ class DIContainer(IServiceContainer):
                                 if reg_type.__name__ == param_type:
                                     param_type = reg_type
                                     break
-                    except:
+                    except Exception:
                         # If we can't resolve, skip this parameter
                         if param.default != param.empty:
                             kwargs[param_name] = param.default

claude_mpm/core/error_handler.py

@@ -384,7 +384,7 @@ def with_error_handling(
                     if callable(fallback_value):
                         try:
                             fb_value = fallback_value(*args, **kwargs)
-                        except:
+                        except Exception:
                             fb_value = None
 
                     return handle_error(
@@ -428,7 +428,7 @@ def safe_operation(
                 if callable(fallback_value):
                     try:
                         return fallback_value(*args, **kwargs)
-                    except:
+                    except Exception:
                         return None
                 return fallback_value
 

claude_mpm/core/file_utils.py

@@ -652,7 +652,7 @@ def file_lock(filepath: Union[str, Path], timeout: float = 5.0):
                 fcntl.flock(lock_handle, fcntl.LOCK_UN)
                 lock_handle.close()
                 lock_file.unlink(missing_ok=True)
-            except:
+            except Exception:
                 pass
 
 

claude_mpm/core/framework_loader.py

@@ -6,7 +6,7 @@ import logging
 import os
 import platform
 import time
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Dict, Optional
 
@@ -1432,7 +1432,7 @@ Extract tickets from these patterns:
 
         try:
             # Get current datetime with timezone awareness
-            now = datetime.now()
+            now = datetime.now(timezone.utc)
 
             # Try to get timezone info - fallback to UTC offset if timezone name not available
             try:
@@ -1470,7 +1470,7 @@ Extract tickets from these patterns:
             # Fallback to basic date if enhanced datetime fails
             self.logger.debug(f"Error generating enhanced datetime context: {e}")
             context_lines.append(
-                f"**Today's Date**: {datetime.now().strftime('%Y-%m-%d')}\n"
+                f"**Today's Date**: {datetime.now(timezone.utc).strftime('%Y-%m-%d')}\n"
             )
 
         try: