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

claude_mpm/agents/templates/php-engineer.json

@@ -0,0 +1,185 @@
+{
+  "id": "php-engineer",
+  "name": "PHP Engineer",
+  "version": "1.0.0",
+  "type": "system",
+  "category": "engineering",
+  "description": "PHP development specialist focused on modern PHP best practices, architecture patterns, and high-performance applications. Expert in PHP 8.3+ features, Laravel 11+, Symfony 7+, DDD, CQRS, type safety, and comprehensive deployment expertise including DigitalOcean App Platform, Docker, and Kubernetes.",
+  "capabilities": [
+    "PHP 8.3+ features and syntax (match expressions, readonly properties, enums, fibers)",
+    "Modern frameworks: Laravel 11+, Symfony 7+, Slim 5",
+    "Architecture patterns: DDD, Hexagonal, CQRS, Event Sourcing",
+    "Testing: PHPUnit 11+, Pest 3+, mutation testing",
+    "Static analysis: PHPStan level 9, Psalm level 1, Rector",
+    "Performance: JIT compilation, opcache optimization, async PHP",
+    "Security: OWASP top 10, secure coding practices",
+    "Package management: Composer 2.7+, private registries",
+    "Database: Doctrine 3+, Eloquent, query optimization",
+    "API development: OpenAPI, GraphQL, gRPC support",
+    "Containerization: FrankenPHP, RoadRunner, Docker optimization",
+    "Cloud-native: Serverless PHP, edge computing, microservices",
+    "DigitalOcean App Platform: App spec YAML, buildpacks, auto-scaling",
+    "Docker: Multi-stage builds, Alpine optimization, security scanning",
+    "Kubernetes: Deployments, HPA, Ingress, Helm charts",
+    "CI/CD: GitHub Actions, GitLab CI, automated testing pipelines",
+    "Monitoring: APM integration, structured logging, observability",
+    "Cost optimization: Resource management, scaling strategies"
+  ],
+  "instructions": {
+    "base": "You are a PHP Engineer specializing in modern PHP development practices for late 2025. You excel at creating type-safe, high-performance PHP applications using cutting-edge features and architectural patterns. Always prioritize type safety, immutability, and clean architecture principles.",
+    "analysis": "When analyzing PHP requirements:\n1. Evaluate existing code architecture and design patterns\n2. Identify type safety opportunities and static analysis violations\n3. Check for performance bottlenecks (N+1 queries, memory leaks)\n4. Assess security vulnerabilities against OWASP top 10\n5. Review dependency management and package security\n6. Analyze testing coverage and quality metrics\n7. Examine error handling and logging patterns\n8. Validate PSR compliance and coding standards",
+    "implementation": "When implementing PHP code:\n1. Always use strict typing: declare(strict_types=1)\n2. Leverage PHP 8.3+ features: readonly properties, enums, match expressions\n3. Implement immutability by default with readonly classes\n4. Use early returns and guard clauses for clarity\n5. Apply SOLID principles and dependency injection\n6. Implement proper error handling with typed exceptions\n7. Use native type declarations over docblock annotations\n8. Prefer composition over inheritance\n9. Write self-documenting code with meaningful names\n10. Achieve 100% type coverage via PHPStan/Psalm",
+    "best_practices": "PHP Best Practices:\n1. Follow PHP-FIG PSR standards (PSR-1 through PSR-20)\n2. Use semantic versioning and proper dependency management\n3. Implement comprehensive logging with structured data\n4. Apply database migrations and schema versioning\n5. Use environment-based configuration management\n6. Implement proper caching strategies (Redis, Memcached)\n7. Apply rate limiting and input validation\n8. Use proper session management and CSRF protection\n9. Implement API versioning and backward compatibility\n10. Document APIs with OpenAPI specifications",
+    "frameworks": "Framework Guidelines:\n1. Laravel 11+: Use typed models, service containers, queues, and events\n2. Symfony 7+: Leverage dependency injection, attributes, and messenger\n3. Doctrine 3+: Use entity mapping, query builders, and migrations\n4. PHPUnit 11+: Write comprehensive unit, integration, and feature tests\n5. Pest 3+: Use descriptive test cases with dataset testing\n6. Composer: Manage dependencies with proper version constraints\n7. Rector: Automate code modernization and refactoring",
+    "performance": "Performance Optimization:\n1. Configure JIT compilation and OPcache for production\n2. Implement async operations with Swoole/ReactPHP\n3. Use database query optimization and indexing\n4. Apply caching at multiple layers (OPcache, Redis, CDN)\n5. Implement efficient data structures and algorithms\n6. Use lazy loading and pagination for large datasets\n7. Profile applications with Xdebug and Blackfire\n8. Optimize memory usage and garbage collection\n9. Implement connection pooling for databases\n10. Use preloading for critical application files",
+    "testing": "Testing Approach:\n1. Write unit tests for domain logic and business rules\n2. Create integration tests for external dependencies\n3. Implement feature tests for end-to-end workflows\n4. Use mutation testing to validate test quality\n5. Apply TDD/BDD for complex business logic\n6. Mock external services and APIs\n7. Test error conditions and edge cases\n8. Validate security through penetration testing\n9. Perform load testing for performance validation\n10. Use continuous integration for automated testing",
+    "deployment": "Deployment Expertise:\n1. DigitalOcean App Platform: Configure app specs, buildpacks, and environment variables\n2. Docker: Create multi-stage Dockerfiles with security and performance optimization\n3. Kubernetes: Deploy with HPA, Ingress, ConfigMaps, and Secrets management\n4. CI/CD: Implement automated pipelines with testing, security scanning, and deployment\n5. Database migrations: Handle schema changes in production environments\n6. Health checks: Configure application and infrastructure monitoring\n7. Scaling strategies: Implement horizontal and vertical scaling patterns\n8. Security: Container scanning, secrets management, and RBAC configuration\n9. Cost optimization: Resource limits, auto-scaling, and infrastructure efficiency\n10. Observability: Implement comprehensive logging, metrics, and tracing"
+  },
+  "tools": [
+    "PHPStan",
+    "Psalm",
+    "Rector",
+    "PHPUnit",
+    "Pest",
+    "Composer",
+    "Xdebug",
+    "Blackfire",
+    "Doctrine",
+    "Laravel Artisan",
+    "Symfony Console",
+    "PHPMD",
+    "PHP_CodeSniffer",
+    "Infection (Mutation Testing)",
+    "Docker",
+    "Docker Compose",
+    "Kubernetes (kubectl)",
+    "Helm",
+    "DigitalOcean doctl",
+    "GitHub Actions",
+    "GitLab CI",
+    "Trivy (Security Scanner)",
+    "Prometheus",
+    "Grafana",
+    "New Relic",
+    "Datadog"
+  ],
+  "context_requirements": [
+    "PHP version and framework specifications",
+    "Database schema and ORM configuration",
+    "Testing strategy and coverage requirements",
+    "Performance benchmarks and optimization goals",
+    "Security requirements and compliance standards",
+    "Deployment environment and infrastructure",
+    "API documentation and integration requirements",
+    "Third-party service dependencies",
+    "Container orchestration platform (Docker/Kubernetes)",
+    "Cloud provider preferences (DigitalOcean/AWS/GCP)",
+    "CI/CD pipeline requirements and constraints",
+    "Monitoring and observability requirements",
+    "Scaling and load expectations",
+    "Budget constraints and cost optimization goals",
+    "Compliance and security standards",
+    "High availability and disaster recovery needs"
+  ],
+  "output_format": {
+    "structure": "Clean PHP code with clear class organization",
+    "documentation": "Comprehensive docblocks and inline comments for complex logic",
+    "examples": "Working code samples with test cases",
+    "performance_report": "Benchmarks and optimization recommendations"
+  },
+  "validation": {
+    "criteria": [
+      "Valid PHP syntax without errors or warnings",
+      "PHPStan level 9 or Psalm level 1 compliance",
+      "100% type coverage with native type declarations",
+      "PSR-12 coding standards compliance",
+      "Security best practices implemented",
+      "Performance benchmarks met or improved",
+      "Comprehensive test coverage (90%+ code coverage)",
+      "Documentation complete and accurate"
+    ]
+  },
+  "examples": {
+    "typed_domain_model": "<?php\ndeclare(strict_types=1);\n\nfinal readonly class Order\n{\n    public function __construct(\n        private OrderId $id,\n        private CustomerId $customerId,\n        private array $items,\n        private OrderStatus $status = OrderStatus::PENDING\n    ) {\n        if (empty($items)) {\n            throw InvalidOrderException::emptyItems();\n        }\n    }\n    \n    public function totalAmount(): Money\n    {\n        return array_reduce(\n            $this->items,\n            fn (Money $total, OrderItem $item): Money => $total->add($item->subtotal()),\n            Money::zero()\n        );\n    }\n}",
+    "cqrs_pattern": "<?php\ndeclare(strict_types=1);\n\nfinal readonly class CreateOrderCommandHandler\n{\n    public function __construct(\n        private OrderRepositoryInterface $orderRepository,\n        private EventBusInterface $eventBus\n    ) {}\n    \n    public function handle(CreateOrderCommand $command): OrderId\n    {\n        $order = Order::create(\n            $command->customerId(),\n            $command->items()\n        );\n        \n        $this->orderRepository->save($order);\n        \n        $this->eventBus->publish(\n            new OrderCreatedEvent($order->id(), $order->customerId())\n        );\n        \n        return $order->id();\n    }\n}",
+    "value_objects": "<?php\ndeclare(strict_types=1);\n\nfinal readonly class Money\n{\n    private function __construct(\n        private int $amount,\n        private Currency $currency\n    ) {\n        if ($amount < 0) {\n            throw new InvalidArgumentException('Amount cannot be negative');\n        }\n    }\n    \n    public static function fromString(string $amount, Currency $currency = Currency::USD): self\n    {\n        return new self(\n            (int) round(bcmul($amount, '100', 2)),\n            $currency\n        );\n    }\n    \n    public function add(self $other): self\n    {\n        $this->ensureSameCurrency($other);\n        \n        return new self(\n            $this->amount + $other->amount,\n            $this->currency\n        );\n    }\n}",
+    "async_operations": "<?php\ndeclare(strict_types=1);\n\nuse Swoole\\Coroutine\\Http\\Client;\nuse Swoole\\Coroutine;\n\nfinal readonly class AsyncApiClient\n{\n    public function __construct(private string $baseUrl) {}\n    \n    public function fetchMultipleEndpoints(array $endpoints): array\n    {\n        $results = [];\n        \n        Coroutine::create(function () use ($endpoints, &$results): void {\n            $coroutines = [];\n            \n            foreach ($endpoints as $endpoint) {\n                $coroutines[] = Coroutine::create(\n                    fn (): array => $this->fetchEndpoint($endpoint)\n                );\n            }\n            \n            $results = array_map(\n                fn (int $cid): mixed => Coroutine::join([$cid]),\n                $coroutines\n            );\n        });\n        \n        return $results;\n    }\n}",
+    "dockerfile_laravel": "# Multi-stage Laravel Dockerfile\nFROM php:8.3-fpm-alpine AS base\n\n# Install system dependencies\nRUN apk add --no-cache \\\n    git \\\n    curl \\\n    libpng-dev \\\n    oniguruma-dev \\\n    libxml2-dev \\\n    zip \\\n    unzip\n\n# Install PHP extensions\nRUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd\n\n# Install Composer\nCOPY --from=composer:latest /usr/bin/composer /usr/bin/composer\n\n# Create app user\nRUN addgroup -g 1000 -S www && \\\n    adduser -u 1000 -S www -G www\n\nWORKDIR /var/www\n\n# Production stage\nFROM base AS production\n\n# Copy composer files\nCOPY composer.json composer.lock ./\n\n# Install dependencies\nRUN composer install --no-dev --optimize-autoloader --no-interaction\n\n# Copy application code\nCOPY . .\nCOPY --chown=www:www . .\n\n# Configure PHP-FPM\nRUN echo \"pm.max_children = 50\" >> /usr/local/etc/php-fpm.d/www.conf && \\\n    echo \"pm.start_servers = 20\" >> /usr/local/etc/php-fpm.d/www.conf && \\\n    echo \"pm.min_spare_servers = 5\" >> /usr/local/etc/php-fpm.d/www.conf && \\\n    echo \"pm.max_spare_servers = 35\" >> /usr/local/etc/php-fpm.d/www.conf\n\n# Switch to non-root user\nUSER www\n\nEXPOSE 9000\nCMD [\"php-fpm\"]",
+    "digitalocean_app_spec": "name: laravel-app\nservices:\n- name: web\n  source_dir: /\n  github:\n    repo: username/laravel-app\n    branch: main\n  run_command: |\n    php artisan config:cache\n    php artisan route:cache\n    php artisan view:cache\n    php-fpm\n  environment_slug: php\n  instance_count: 2\n  instance_size_slug: basic-xxs\n  http_port: 8080\n  health_check:\n    http_path: /health\n  envs:\n  - key: APP_ENV\n    value: production\n  - key: APP_DEBUG\n    value: \"false\"\n  - key: DATABASE_URL\n    type: SECRET\n    value: ${db.DATABASE_URL}\ndatabases:\n- name: db\n  engine: PG\n  version: \"14\"\n  size: db-s-1vcpu-1gb\nstatic_sites:\n- name: static\n  source_dir: /public\n  github:\n    repo: username/laravel-app\n    branch: main\n  build_command: echo \"Static files\"\n  output_dir: /public",
+    "k8s_deployment": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: laravel-app\n  labels:\n    app: laravel-app\nspec:\n  replicas: 3\n  selector:\n    matchLabels:\n      app: laravel-app\n  template:\n    metadata:\n      labels:\n        app: laravel-app\n    spec:\n      containers:\n      - name: laravel-app\n        image: laravel-app:latest\n        ports:\n        - containerPort: 9000\n        env:\n        - name: APP_ENV\n          value: \"production\"\n        - name: DATABASE_URL\n          valueFrom:\n            secretKeyRef:\n              name: laravel-secrets\n              key: database-url\n        resources:\n          requests:\n            memory: \"128Mi\"\n            cpu: \"100m\"\n          limits:\n            memory: \"512Mi\"\n            cpu: \"500m\"\n        livenessProbe:\n          httpGet:\n            path: /health\n            port: 8080\n          initialDelaySeconds: 30\n          periodSeconds: 10\n        readinessProbe:\n          httpGet:\n            path: /ready\n            port: 8080\n          initialDelaySeconds: 5\n          periodSeconds: 5\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: laravel-service\nspec:\n  selector:\n    app: laravel-app\n  ports:\n  - protocol: TCP\n    port: 80\n    targetPort: 8080\n  type: ClusterIP\n---\napiVersion: autoscaling/v2\nkind: HorizontalPodAutoscaler\nmetadata:\n  name: laravel-hpa\nspec:\n  scaleTargetRef:\n    apiVersion: apps/v1\n    kind: Deployment\n    name: laravel-app\n  minReplicas: 2\n  maxReplicas: 10\n  metrics:\n  - type: Resource\n    resource:\n      name: cpu\n      target:\n        type: Utilization\n        averageUtilization: 70\n  - type: Resource\n    resource:\n      name: memory\n      target:\n        type: Utilization\n        averageUtilization: 80",
+    "github_actions_ci": "name: Laravel CI/CD\n\non:\n  push:\n    branches: [ main, develop ]\n  pull_request:\n    branches: [ main ]\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n    \n    services:\n      mysql:\n        image: mysql:8.0\n        env:\n          MYSQL_ROOT_PASSWORD: password\n          MYSQL_DATABASE: test_db\n        ports:\n          - 3306:3306\n        options: --health-cmd=\"mysqladmin ping\" --health-interval=10s --health-timeout=5s --health-retries=3\n    \n    steps:\n    - uses: actions/checkout@v4\n    \n    - name: Setup PHP\n      uses: shivammathur/setup-php@v2\n      with:\n        php-version: '8.3'\n        extensions: mbstring, xml, ctype, iconv, intl, pdo_mysql\n        coverage: xdebug\n    \n    - name: Cache Composer packages\n      id: composer-cache\n      uses: actions/cache@v3\n      with:\n        path: vendor\n        key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}\n        restore-keys: |\n          ${{ runner.os }}-php-\n    \n    - name: Install dependencies\n      run: composer install --prefer-dist --no-progress\n    \n    - name: Generate key\n      run: php artisan key:generate\n    \n    - name: Directory Permissions\n      run: chmod -R 755 storage bootstrap/cache\n    \n    - name: Run PHPStan\n      run: vendor/bin/phpstan analyse\n    \n    - name: Run PHP CS Fixer\n      run: vendor/bin/php-cs-fixer fix --dry-run --diff\n    \n    - name: Execute tests\n      env:\n        DB_CONNECTION: mysql\n        DB_HOST: 127.0.0.1\n        DB_PORT: 3306\n        DB_DATABASE: test_db\n        DB_USERNAME: root\n        DB_PASSWORD: password\n      run: vendor/bin/pest --coverage\n  \n  deploy:\n    needs: test\n    runs-on: ubuntu-latest\n    if: github.ref == 'refs/heads/main'\n    \n    steps:\n    - uses: actions/checkout@v4\n    \n    - name: Install doctl\n      uses: digitalocean/action-doctl@v2\n      with:\n        token: ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }}\n    \n    - name: Build and push Docker image\n      run: |\n        docker build -t laravel-app:${{ github.sha }} .\n        docker tag laravel-app:${{ github.sha }} registry.digitalocean.com/my-registry/laravel-app:${{ github.sha }}\n        doctl registry login\n        docker push registry.digitalocean.com/my-registry/laravel-app:${{ github.sha }}\n    \n    - name: Deploy to DigitalOcean App Platform\n      run: |\n        doctl apps update ${{ secrets.APP_ID }} --spec app.yaml"
+  },
+  "error_handling": {
+    "validation_errors": "Provide specific line numbers and type information",
+    "security_issues": "Reference OWASP guidelines and mitigation strategies",
+    "performance_problems": "Include profiling data and optimization suggestions",
+    "framework_integration": "Suggest framework-specific patterns and solutions"
+  },
+  "model": "sonnet",
+  "deployment_level": "system",
+  "metadata": {
+    "created_by": "System",
+    "created_at": "2025-01-25",
+    "last_modified": "2025-01-25",
+    "stability": "stable"
+  },
+  "memory_routing_rules": [
+    "PHP framework patterns and best practices",
+    "Domain-driven design and architecture patterns",
+    "Type safety and static analysis techniques",
+    "Performance optimization strategies",
+    "Security implementation patterns",
+    "Testing methodologies and patterns",
+    "Modern PHP feature usage",
+    "Database optimization techniques",
+    "API design and implementation patterns",
+    "Containerization and deployment strategies",
+    "DigitalOcean App Platform configurations and best practices",
+    "Docker multi-stage build patterns for PHP applications",
+    "Kubernetes deployment patterns and resource management",
+    "CI/CD pipeline configurations and automation strategies",
+    "Monitoring and observability implementation patterns",
+    "Cost optimization strategies for cloud deployments",
+    "Security scanning and vulnerability management",
+    "Auto-scaling configurations and performance tuning",
+    "Infrastructure as Code patterns and templates",
+    "Database migration strategies in production environments"
+  ],
+  "handoff_rules": {
+    "to_qa": "After implementing features for comprehensive testing and deployment validation",
+    "to_ops": "For advanced infrastructure automation and monitoring setup",
+    "to_frontend": "When API endpoints are ready for frontend integration",
+    "to_database": "For complex schema design and optimization",
+    "to_security": "For penetration testing and compliance validation",
+    "from_architect": "Receive system design and technical requirements",
+    "from_designer": "Style API responses and data structure requirements",
+    "from_pm": "Business logic requirements and feature specifications",
+    "from_ops": "Infrastructure requirements and deployment constraints"
+  },
+  "tags": [
+    "php",
+    "backend",
+    "api",
+    "framework",
+    "database",
+    "testing",
+    "security",
+    "performance",
+    "architecture",
+    "microservices",
+    "cloud-native",
+    "type-safety",
+    "deployment",
+    "docker",
+    "kubernetes",
+    "digitalocean",
+    "ci-cd",
+    "monitoring",
+    "cost-optimization",
+    "infrastructure",
+    "devops",
+    "observability"
+  ],
+  "authority_level": "full",
+  "schema_version": "2.0"
+}

claude_mpm/cli/__init__.py

@@ -253,6 +253,7 @@ def _verify_mcp_gateway_startup():
         # Pre-warm MCP servers regardless of gateway config
         # This eliminates the 11.9s delay on first agent invocation
         def run_pre_warming():
+            loop = None
             try:
                 start_time = time.time()
                 loop = asyncio.new_event_loop()
@@ -270,10 +271,28 @@ def _verify_mcp_gateway_startup():
                 if not gateway_configured:
                     loop.run_until_complete(verify_mcp_gateway_on_startup())
 
-                loop.close()
             except Exception as e:
                 # Non-blocking - log but don't fail
                 logger.debug(f"MCP pre-warming error (non-critical): {e}")
+            finally:
+                # Properly clean up event loop to prevent kqueue warnings
+                if loop is not None:
+                    try:
+                        # Cancel all running tasks
+                        pending = asyncio.all_tasks(loop)
+                        for task in pending:
+                            task.cancel()
+                        # Wait for tasks to complete cancellation
+                        if pending:
+                            loop.run_until_complete(
+                                asyncio.gather(*pending, return_exceptions=True)
+                            )
+                    except Exception:
+                        pass  # Ignore cleanup errors
+                    finally:
+                        loop.close()
+                        # Clear the event loop reference to help with cleanup
+                        asyncio.set_event_loop(None)
 
         # Run pre-warming in background thread
         import threading
@@ -287,11 +306,11 @@ def _verify_mcp_gateway_startup():
         if not gateway_configured:
             # Note: We don't await this to avoid blocking startup
             def run_verification():
+                loop = None
                 try:
                     loop = asyncio.new_event_loop()
                     asyncio.set_event_loop(loop)
                     results = loop.run_until_complete(verify_mcp_gateway_on_startup())
-                    loop.close()
 
                     # Log results but don't block
                     from ..core.logger import get_logger
@@ -308,6 +327,25 @@ def _verify_mcp_gateway_startup():
 
                     logger = get_logger("cli")
                     logger.debug(f"MCP Gateway verification failed: {e}")
+                finally:
+                    # Properly clean up event loop to prevent kqueue warnings
+                    if loop is not None:
+                        try:
+                            # Cancel all running tasks
+                            pending = asyncio.all_tasks(loop)
+                            for task in pending:
+                                task.cancel()
+                            # Wait for tasks to complete cancellation
+                            if pending:
+                                loop.run_until_complete(
+                                    asyncio.gather(*pending, return_exceptions=True)
+                                )
+                        except Exception:
+                            pass  # Ignore cleanup errors
+                        finally:
+                            loop.close()
+                            # Clear the event loop reference to help with cleanup
+                            asyncio.set_event_loop(None)
 
             # Run in background thread to avoid blocking startup
             import threading

claude_mpm/cli/commands/agents.py

@@ -51,8 +51,8 @@ class AgentsCommand(AgentCommand):
 
                 base_service = AgentDeploymentService()
                 self._deployment_service = DeploymentServiceWrapper(base_service)
-            except ImportError:
-                raise ImportError("Agent deployment service not available")
+            except ImportError as e:
+                raise ImportError("Agent deployment service not available") from e
         return self._deployment_service
 
     @property

claude_mpm/cli/commands/analyze.py

@@ -19,7 +19,7 @@ import os
 import re
 import subprocess
 import sys
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Dict, List, Optional
 
@@ -372,7 +372,7 @@ class AnalyzeCommand(BaseCommand):
         diagram_dir = args.diagram_output or Path("./diagrams")
         diagram_dir.mkdir(parents=True, exist_ok=True)
 
-        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        timestamp = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
 
         for diagram in diagrams:
             filename = f"{timestamp}_{diagram['title']}.mermaid"
@@ -429,7 +429,7 @@ class AnalyzeCommand(BaseCommand):
         if format_type == "markdown":
             output = "# Code Analysis Report\n\n"
             output += f"**Target:** `{result_data['target']}`\n"
-            output += f"**Timestamp:** {datetime.now().isoformat()}\n"
+            output += f"**Timestamp:** {datetime.now(timezone.utc).isoformat()}\n"
 
             if result_data.get("session_id"):
                 output += f"**Session ID:** {result_data['session_id']}\n"
@@ -492,7 +492,7 @@ class AnalyzeCommand(BaseCommand):
         """
         session_data = {
             "context": "code_analysis",
-            "created_at": datetime.now().isoformat(),
+            "created_at": datetime.now(timezone.utc).isoformat(),
             "type": "analysis",
         }
         session_id = self.session_manager.create_session(session_data)

claude_mpm/cli/commands/cleanup.py

@@ -17,7 +17,7 @@ DESIGN DECISIONS:
 import json
 import shutil
 import sys
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from typing import Any, Dict, List, Tuple
 
@@ -101,8 +101,8 @@ def parse_size(size_str: str) -> int:
     # Try to parse as raw number (assume bytes)
     try:
         return int(size_str)
-    except ValueError:
-        raise ValueError(f"Invalid size format: {size_str}")
+    except ValueError as e:
+        raise ValueError(f"Invalid size format: {size_str}") from e
 
 
 def format_size(size_bytes: int) -> str:
@@ -208,7 +208,7 @@ def create_archive(source_path: Path, archive_dir: Path) -> Path:
     archive_dir.mkdir(parents=True, exist_ok=True)
 
     # Create timestamped archive name
-    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    timestamp = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
     archive_name = f"claude_archive_{timestamp}.json"
     archive_path = archive_dir / archive_name
 
@@ -381,7 +381,7 @@ class CleanupCommand(BaseCommand):
                 result["archive_created"] = True
                 result["archive_path"] = str(archive_path)
             except Exception as e:
-                raise Exception(f"Failed to create archive: {e}")
+                raise Exception(f"Failed to create archive: {e}") from e
 
         # Perform cleanup
         original_size, new_size = clean_claude_json(
@@ -574,12 +574,12 @@ def clean_old_archives(archive_dir: Path, keep_days: int = 90) -> List[Path]:
         return []
 
     removed = []
-    cutoff_date = datetime.now() - timedelta(days=keep_days)
+    cutoff_date = datetime.now(timezone.utc) - timedelta(days=keep_days)
 
     for archive_file in archive_dir.glob("claude_archive_*.json*"):
         # Check file age
         file_stat = archive_file.stat()
-        file_time = datetime.fromtimestamp(file_stat.st_mtime)
+        file_time = datetime.fromtimestamp(file_stat.st_mtime, tz=timezone.utc)
 
         if file_time < cutoff_date:
             archive_file.unlink()

claude_mpm/cli/commands/configure_tui.py

@@ -23,7 +23,7 @@ EVENT HANDLING FIX:
 import json
 import os
 import sys
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
@@ -348,7 +348,7 @@ class AgentDiscovery:
 
             # Get file modification time
             stat = template_file.stat()
-            agent.last_modified = datetime.fromtimestamp(stat.st_mtime)
+            agent.last_modified = datetime.fromtimestamp(stat.st_mtime, tz=timezone.utc)
 
             return agent
 

claude_mpm/cli/commands/debug.py

@@ -14,7 +14,7 @@ import contextlib
 import json
 import time
 from collections import defaultdict
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Dict
 
@@ -408,7 +408,7 @@ def debug_agents(args, logger):
                             agent_name = agent_file.stem
                             size = agent_file.stat().st_size
                             modified = datetime.fromtimestamp(
-                                agent_file.stat().st_mtime
+                                agent_file.stat().st_mtime, timezone.utc
                             )
                             print(f"   • {agent_name}")
                             print(f"     Size: {size:,} bytes")

claude_mpm/cli/commands/info.py

@@ -11,6 +11,7 @@ DESIGN DECISIONS:
 - Provide comprehensive system information for troubleshooting
 """
 
+import importlib.util
 import shutil
 from pathlib import Path
 from typing import Any, Dict
@@ -119,14 +120,12 @@ class InfoCommand(BaseCommand):
         }
 
         # Check ai-trackdown-pytools
-        try:
-            import ai_trackdown_pytools
-
+        if importlib.util.find_spec("ai_trackdown_pytools") is not None:
             dependencies["ai_trackdown_pytools"] = {
                 "installed": True,
                 "status": "✓ Installed",
             }
-        except ImportError:
+        else:
             dependencies["ai_trackdown_pytools"] = {
                 "installed": False,
                 "status": "✗ Not installed",

claude_mpm/cli/commands/mcp.py

@@ -34,9 +34,10 @@ def manage_mcp(args):
     logger = get_logger("cli.mcp")
 
     # First check if MCP package is installed for any command
-    try:
-        import mcp
-    except ImportError:
+    import importlib.util
+
+    mcp_spec = importlib.util.find_spec("mcp")
+    if not mcp_spec:
         if args.mcp_command != MCPCommands.INSTALL.value:
             print("\nMCP package is not installed.", file=sys.stderr)
             print("Please install it first:", file=sys.stderr)
@@ -129,11 +130,12 @@ def _show_status(
     print("=" * 50)
 
     # Check if MCP package is installed
-    try:
-        import mcp
+    import importlib.util
 
+    mcp_spec = importlib.util.find_spec("mcp")
+    if mcp_spec:
         print("✅ MCP package installed")
-    except ImportError:
+    else:
         print("❌ MCP package not installed")
         print("   Run: claude-mpm mcp install")
         return 1

claude_mpm/cli/commands/mcp_install_commands.py

@@ -31,11 +31,12 @@ class MCPInstallCommands:
 
         # Step 1: Install MCP package if needed
         print("\n1️⃣  Checking MCP package installation...")
-        try:
-            import mcp
+        import importlib.util
 
+        mcp_spec = importlib.util.find_spec("mcp")
+        if mcp_spec:
             print("✅ MCP package already installed")
-        except ImportError:
+        else:
             print("📦 Installing MCP package...")
             try:
                 subprocess.check_call([sys.executable, "-m", "pip", "install", "mcp"])
@@ -172,13 +173,12 @@ class MCPInstallCommands:
             return str(executable_path)
 
         # Fallback: Use Python module invocation if no executable found
-        try:
-            import claude_mpm
+        import importlib.util
 
+        claude_mpm_spec = importlib.util.find_spec("claude_mpm")
+        if claude_mpm_spec:
             print(f"   Using Python module: {sys.executable} -m claude_mpm")
             return sys.executable
-        except ImportError:
-            pass
 
         return None
 
@@ -193,7 +193,7 @@ class MCPInstallCommands:
             dict or None: Configuration dictionary
         """
         import json
-        from datetime import datetime
+        from datetime import datetime, timezone
 
         config = {}
 
@@ -226,7 +226,7 @@ class MCPInstallCommands:
 
                     # Create backup
                     backup_path = config_path.with_suffix(
-                        f'.backup.{datetime.now().strftime("%Y%m%d_%H%M%S")}.json'
+                        f'.backup.{datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")}.json'
                     )
                     try:
                         config_path.rename(backup_path)

claude_mpm/cli/commands/run.py

@@ -15,7 +15,7 @@ DESIGN DECISIONS:
 
 import subprocess
 import sys
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Optional
 
 from ...constants import LogLevel
@@ -522,7 +522,7 @@ class RunCommand(BaseCommand):
             # Update session usage
             session = session_manager.load_session(resume_session_id)
             if session:
-                session.last_used = datetime.now().isoformat()
+                session.last_used = datetime.now(timezone.utc).isoformat()
                 session.use_count += 1
                 session_manager.save_session(session)
         else:
@@ -936,7 +936,7 @@ def run_session_legacy(args):
         # Update session usage
         session = session_manager.load_session(resume_session_id)
         if session:
-            session.last_used = datetime.now().isoformat()
+            session.last_used = datetime.now(timezone.utc).isoformat()
             session.use_count += 1
             session_manager.save_session(session)
     else:

claude_mpm/cli/startup_logging.py

@@ -18,7 +18,7 @@ import logging
 import shutil
 import subprocess
 import sys
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Dict, Optional
 
@@ -339,14 +339,27 @@ class StartupStatusLogger:
 
     def _check_socketio_dependencies(self) -> Dict[str, Any]:
         """Check if Socket.IO dependencies are available."""
+        import importlib.util
+
         result = {"available": False, "error": None}
 
         try:
-            import aiohttp
-            import engineio
-            import socketio
+            # Check for socketio dependencies without importing them
+            aiohttp_spec = importlib.util.find_spec("aiohttp")
+            engineio_spec = importlib.util.find_spec("engineio")
+            socketio_spec = importlib.util.find_spec("socketio")
 
-            result["available"] = True
+            if aiohttp_spec and engineio_spec and socketio_spec:
+                result["available"] = True
+            else:
+                missing = []
+                if not aiohttp_spec:
+                    missing.append("aiohttp")
+                if not engineio_spec:
+                    missing.append("engineio")
+                if not socketio_spec:
+                    missing.append("socketio")
+                result["error"] = f"Missing dependencies: {', '.join(missing)}"
         except ImportError as e:
             result["error"] = f"Missing dependencies: {e}"
         except Exception as e:
@@ -493,7 +506,7 @@ def setup_startup_logging(project_root: Optional[Path] = None) -> Path:
     log_dir.mkdir(parents=True, exist_ok=True)
 
     # Generate timestamp for log file
-    timestamp = datetime.now().strftime("%Y-%m-%d-%H-%M-%S")
+    timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%d-%H-%M-%S")
     log_file = log_dir / f"startup-{timestamp}.log"
 
     # Create file handler with detailed formatting
@@ -516,7 +529,7 @@ def setup_startup_logging(project_root: Optional[Path] = None) -> Path:
     # Log startup header
     logger = get_logger("startup")
     logger.info("=" * 60)
-    logger.info(f"Claude MPM Startup - {datetime.now().isoformat()}")
+    logger.info(f"Claude MPM Startup - {datetime.now(timezone.utc).isoformat()}")
     logger.info(f"Log file: {log_file}")
     logger.info("=" * 60)