claude-mpm 4.14.0__py3-none-any.whl → 4.14.2__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.14.0
+4.14.2

claude_mpm/agents/templates/local_ops_agent.json

@@ -2,7 +2,7 @@
   "name": "local-ops",
   "display_name": "Local Operations Agent",
   "description": "Specialized agent for managing local development deployments with focus on maintaining single stable instances, protecting existing services, and never interfering with other projects or Claude Code services",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "author": "Claude MPM",
   "authority": {
     "level": "deployment_manager",
@@ -15,6 +15,73 @@
     ]
   },
   "capabilities": {
+    "local_deploy_cli": {
+      "description": "Use claude-mpm local-deploy CLI for advanced process management",
+      "commands": {
+        "start": {
+          "syntax": "claude-mpm local-deploy start --command <cmd> [--port <port>] [--auto-restart] [--health-check <url>]",
+          "description": "Start a deployment with background process spawning, health monitoring, and auto-restart",
+          "example": "claude-mpm local-deploy start --command 'uvicorn main:app --reload' --port 8000 --auto-restart --health-check http://localhost:8000/health"
+        },
+        "status": {
+          "syntax": "claude-mpm local-deploy status <deployment-id>",
+          "description": "Get detailed deployment status including process info, health, and resource usage",
+          "provides": ["process_info", "health_status", "resource_usage", "uptime", "restart_count"]
+        },
+        "monitor": {
+          "syntax": "claude-mpm local-deploy monitor <deployment-id> [--refresh 2]",
+          "description": "Live dashboard with real-time updates of deployment metrics"
+        },
+        "health": {
+          "syntax": "claude-mpm local-deploy health <deployment-id>",
+          "description": "Run comprehensive health checks (HTTP endpoint, process responsive, resource limits)",
+          "checks": ["http_endpoint", "process_responsive", "resource_limits"]
+        },
+        "stop": {
+          "syntax": "claude-mpm local-deploy stop <deployment-id>",
+          "description": "Gracefully stop a deployment"
+        },
+        "restart": {
+          "syntax": "claude-mpm local-deploy restart <deployment-id>",
+          "description": "Restart a deployment with graceful shutdown"
+        },
+        "list": {
+          "syntax": "claude-mpm local-deploy list [--status running|stopped|crashed]",
+          "description": "List all deployments with optional status filtering"
+        },
+        "history": {
+          "syntax": "claude-mpm local-deploy history <deployment-id>",
+          "description": "View deployment restart history and crash logs"
+        },
+        "enable-auto-restart": {
+          "syntax": "claude-mpm local-deploy enable-auto-restart <deployment-id>",
+          "description": "Enable automatic restart on crashes with exponential backoff"
+        },
+        "disable-auto-restart": {
+          "syntax": "claude-mpm local-deploy disable-auto-restart <deployment-id>",
+          "description": "Disable automatic restart for a deployment"
+        }
+      },
+      "features": [
+        "background_process_spawning",
+        "automatic_health_monitoring",
+        "auto_restart_with_exponential_backoff",
+        "memory_leak_detection",
+        "log_pattern_monitoring",
+        "resource_usage_tracking",
+        "graceful_shutdown_handling"
+      ],
+      "integration_workflow": [
+        "detect_framework",
+        "build_start_command",
+        "execute_local_deploy_start",
+        "configure_health_endpoint",
+        "enable_auto_restart",
+        "verify_health_endpoint",
+        "monitor_initial_stability",
+        "report_deployment_url_and_status"
+      ]
+    },
     "port_allocation": {
       "description": "Deterministic hash-based port allocation for consistent project ports",
       "features": [
@@ -55,7 +122,12 @@
         "svelte",
         "nuxt",
         "gatsby",
-        "vite"
+        "vite",
+        "express",
+        "nestjs",
+        "remix",
+        "sveltekit",
+        "astro"
       ],
       "python": [
         "django",
@@ -64,6 +136,23 @@
         "streamlit",
         "gradio"
       ],
+      "rust": [
+        "actix-web",
+        "rocket",
+        "axum",
+        "warp"
+      ],
+      "go": [
+        "gin",
+        "echo",
+        "fiber",
+        "net/http"
+      ],
+      "java": [
+        "spring-boot",
+        "tomcat",
+        "jetty"
+      ],
       "ruby": [
         "rails",
         "sinatra"
@@ -72,6 +161,10 @@
         "laravel",
         "symfony"
       ],
+      "dart": [
+        "flutter-web",
+        "shelf"
+      ],
       "static": [
         "hugo",
         "jekyll",
@@ -384,6 +477,204 @@
         "dev": "flask run",
         "prod": "gunicorn app:app"
       }
+    },
+    "python_fastapi": {
+      "files": [
+        "main.py",
+        "app.py"
+      ],
+      "requirements": [
+        "fastapi",
+        "uvicorn"
+      ],
+      "commands": {
+        "dev": "uvicorn main:app --reload --port {port}",
+        "prod": "uvicorn main:app --workers 4 --port {port}"
+      }
+    },
+    "nodejs_express": {
+      "files": [
+        "server.js",
+        "app.js",
+        "index.js"
+      ],
+      "package_json": [
+        "express"
+      ],
+      "commands": {
+        "dev": "nodemon server.js",
+        "prod": "node server.js"
+      }
+    },
+    "rust_actix": {
+      "files": [
+        "Cargo.toml",
+        "Cargo.lock",
+        "src/main.rs"
+      ],
+      "cargo_dependencies": [
+        "actix-web"
+      ],
+      "commands": {
+        "dev": "cargo run",
+        "watch": "cargo watch -x run",
+        "build": "cargo build --release",
+        "start": "./target/release/{app_name}"
+      }
+    },
+    "rust_rocket": {
+      "files": [
+        "Cargo.toml",
+        "Rocket.toml",
+        "src/main.rs"
+      ],
+      "cargo_dependencies": [
+        "rocket"
+      ],
+      "commands": {
+        "dev": "cargo run",
+        "watch": "cargo watch -x run",
+        "build": "cargo build --release",
+        "start": "./target/release/{app_name}"
+      }
+    },
+    "rust_axum": {
+      "files": [
+        "Cargo.toml",
+        "src/main.rs"
+      ],
+      "cargo_dependencies": [
+        "axum"
+      ],
+      "commands": {
+        "dev": "cargo run",
+        "watch": "cargo watch -x run",
+        "build": "cargo build --release",
+        "start": "./target/release/{app_name}"
+      }
+    },
+    "go_gin": {
+      "files": [
+        "go.mod",
+        "go.sum",
+        "main.go"
+      ],
+      "go_imports": [
+        "github.com/gin-gonic/gin"
+      ],
+      "commands": {
+        "dev": "go run .",
+        "watch": "air",
+        "build": "go build -o {app_name}",
+        "start": "./{app_name}"
+      }
+    },
+    "go_echo": {
+      "files": [
+        "go.mod",
+        "go.sum",
+        "main.go"
+      ],
+      "go_imports": [
+        "github.com/labstack/echo"
+      ],
+      "commands": {
+        "dev": "go run .",
+        "watch": "air",
+        "build": "go build -o {app_name}",
+        "start": "./{app_name}"
+      }
+    },
+    "go_fiber": {
+      "files": [
+        "go.mod",
+        "go.sum",
+        "main.go"
+      ],
+      "go_imports": [
+        "github.com/gofiber/fiber"
+      ],
+      "commands": {
+        "dev": "go run .",
+        "watch": "air",
+        "build": "go build -o {app_name}",
+        "start": "./{app_name}"
+      }
+    },
+    "java_spring_boot_maven": {
+      "files": [
+        "pom.xml",
+        "src/main/java",
+        "application.properties"
+      ],
+      "dependencies": [
+        "spring-boot"
+      ],
+      "commands": {
+        "dev": "mvn spring-boot:run",
+        "build": "mvn clean package",
+        "start": "java -jar target/{app_name}.jar"
+      }
+    },
+    "java_spring_boot_gradle": {
+      "files": [
+        "build.gradle",
+        "src/main/java",
+        "application.properties"
+      ],
+      "dependencies": [
+        "spring-boot"
+      ],
+      "commands": {
+        "dev": "gradle bootRun",
+        "build": "gradle clean build",
+        "start": "java -jar build/libs/{app_name}.jar"
+      }
+    },
+    "ruby_rails": {
+      "files": [
+        "Gemfile",
+        "Rakefile",
+        "config.ru",
+        "config/application.rb"
+      ],
+      "gemfile": [
+        "rails"
+      ],
+      "commands": {
+        "dev": "bundle exec rails server -p {port}",
+        "build": "bundle exec rails assets:precompile",
+        "start": "bundle exec puma -C config/puma.rb"
+      }
+    },
+    "php_laravel": {
+      "files": [
+        "artisan",
+        "composer.json",
+        "app/Http/Kernel.php"
+      ],
+      "composer": [
+        "laravel/framework"
+      ],
+      "commands": {
+        "dev": "php artisan serve --port={port}",
+        "prod": "php artisan serve --port={port} --env=production"
+      }
+    },
+    "dart_flutter_web": {
+      "files": [
+        "pubspec.yaml",
+        "lib/main.dart",
+        "web"
+      ],
+      "dependencies": [
+        "flutter"
+      ],
+      "commands": {
+        "dev": "flutter run -d web-server --web-port={port}",
+        "build": "flutter build web",
+        "start": "serve -s build/web -p {port}"
+      }
     }
   },
   "deployment_strategies": {
@@ -416,6 +707,133 @@
           "pm2 start gunicorn --name '{app_name}' -- app:app --bind 0.0.0.0:{port}"
         ],
         "health_check": "http://localhost:{port}/health"
+      },
+      "fastapi": {
+        "method": "local-deploy",
+        "steps": [
+          "pip install -r requirements.txt",
+          "claude-mpm local-deploy start --command 'uvicorn main:app --workers 4 --port {port}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "UVICORN_LOG_LEVEL": "info"
+        }
+      },
+      "rust_actix": {
+        "method": "local-deploy",
+        "steps": [
+          "cargo build --release",
+          "claude-mpm local-deploy start --command './target/release/{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "RUST_LOG": "info"
+        }
+      },
+      "rust_rocket": {
+        "method": "local-deploy",
+        "steps": [
+          "cargo build --release",
+          "claude-mpm local-deploy start --command './target/release/{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "RUST_LOG": "info",
+          "ROCKET_PORT": "{port}"
+        }
+      },
+      "rust_axum": {
+        "method": "local-deploy",
+        "steps": [
+          "cargo build --release",
+          "claude-mpm local-deploy start --command './target/release/{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "RUST_LOG": "info"
+        }
+      },
+      "go_gin": {
+        "method": "local-deploy",
+        "steps": [
+          "go build -o {app_name}",
+          "claude-mpm local-deploy start --command './{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/ping"
+        ],
+        "health_check": "http://localhost:{port}/ping",
+        "environment": {
+          "GO_ENV": "production"
+        }
+      },
+      "go_echo": {
+        "method": "local-deploy",
+        "steps": [
+          "go build -o {app_name}",
+          "claude-mpm local-deploy start --command './{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "GO_ENV": "production"
+        }
+      },
+      "go_fiber": {
+        "method": "local-deploy",
+        "steps": [
+          "go build -o {app_name}",
+          "claude-mpm local-deploy start --command './{app_name}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "GO_ENV": "production"
+        }
+      },
+      "java_spring_boot_maven": {
+        "method": "local-deploy",
+        "steps": [
+          "mvn clean package",
+          "claude-mpm local-deploy start --command 'java -jar target/{app_name}.jar' --port {port} --auto-restart --health-check http://localhost:{port}/actuator/health"
+        ],
+        "health_check": "http://localhost:{port}/actuator/health",
+        "environment": {
+          "SPRING_PROFILES_ACTIVE": "prod",
+          "JAVA_OPTS": "-Xmx512m -Xms256m"
+        }
+      },
+      "java_spring_boot_gradle": {
+        "method": "local-deploy",
+        "steps": [
+          "gradle clean build",
+          "claude-mpm local-deploy start --command 'java -jar build/libs/{app_name}.jar' --port {port} --auto-restart --health-check http://localhost:{port}/actuator/health"
+        ],
+        "health_check": "http://localhost:{port}/actuator/health",
+        "environment": {
+          "SPRING_PROFILES_ACTIVE": "prod",
+          "JAVA_OPTS": "-Xmx512m -Xms256m"
+        }
+      },
+      "ruby_rails": {
+        "method": "local-deploy",
+        "steps": [
+          "bundle install --deployment",
+          "bundle exec rails db:migrate",
+          "claude-mpm local-deploy start --command 'bundle exec puma -C config/puma.rb' --port {port} --auto-restart --health-check http://localhost:{port}/up"
+        ],
+        "health_check": "http://localhost:{port}/up",
+        "environment": {
+          "RAILS_ENV": "production",
+          "RAILS_LOG_TO_STDOUT": "1"
+        }
+      },
+      "php_laravel": {
+        "method": "local-deploy",
+        "steps": [
+          "composer install --optimize-autoloader --no-dev",
+          "php artisan migrate --force",
+          "claude-mpm local-deploy start --command 'php artisan serve --port={port} --env=production' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "health_check": "http://localhost:{port}/health",
+        "environment": {
+          "APP_ENV": "production"
+        }
       }
     },
     "development": {
@@ -435,6 +853,132 @@
           "npm install",
           "pm2 start npm --name '{app_name}-dev' -- start"
         ]
+      },
+      "fastapi": {
+        "method": "local-deploy",
+        "steps": [
+          "pip install -r requirements.txt",
+          "claude-mpm local-deploy start --command 'uvicorn main:app --reload --port {port}' --port {port} --auto-restart --health-check http://localhost:{port}/docs"
+        ],
+        "environment": {
+          "ENVIRONMENT": "development",
+          "DEBUG": "True"
+        }
+      },
+      "express": {
+        "method": "local-deploy",
+        "steps": [
+          "npm install",
+          "claude-mpm local-deploy start --command 'nodemon server.js' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "environment": {
+          "NODE_ENV": "development"
+        }
+      },
+      "rust_actix": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'cargo watch -x run' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "environment": {
+          "RUST_LOG": "debug"
+        }
+      },
+      "rust_rocket": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'cargo watch -x run' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "environment": {
+          "RUST_LOG": "debug"
+        }
+      },
+      "rust_axum": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'cargo watch -x run' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "environment": {
+          "RUST_LOG": "debug"
+        }
+      },
+      "go_gin": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'air' --port {port} --auto-restart --health-check http://localhost:{port}/ping",
+          "fallback: go run ."
+        ],
+        "environment": {
+          "GO_ENV": "development"
+        }
+      },
+      "go_echo": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'air' --port {port} --auto-restart --health-check http://localhost:{port}/health",
+          "fallback: go run ."
+        ],
+        "environment": {
+          "GO_ENV": "development"
+        }
+      },
+      "go_fiber": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'air' --port {port} --auto-restart --health-check http://localhost:{port}/health",
+          "fallback: go run ."
+        ],
+        "environment": {
+          "GO_ENV": "development"
+        }
+      },
+      "java_spring_boot_maven": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'mvn spring-boot:run' --port {port} --auto-restart --health-check http://localhost:{port}/actuator/health"
+        ],
+        "environment": {
+          "SPRING_PROFILES_ACTIVE": "dev",
+          "LOGGING_LEVEL_ROOT": "DEBUG"
+        }
+      },
+      "java_spring_boot_gradle": {
+        "method": "local-deploy",
+        "steps": [
+          "claude-mpm local-deploy start --command 'gradle bootRun' --port {port} --auto-restart --health-check http://localhost:{port}/actuator/health"
+        ],
+        "environment": {
+          "SPRING_PROFILES_ACTIVE": "dev",
+          "LOGGING_LEVEL_ROOT": "DEBUG"
+        }
+      },
+      "ruby_rails": {
+        "method": "local-deploy",
+        "steps": [
+          "bundle install",
+          "claude-mpm local-deploy start --command 'bundle exec rails server -p {port}' --port {port} --auto-restart --health-check http://localhost:{port}/up"
+        ],
+        "environment": {
+          "RAILS_ENV": "development"
+        }
+      },
+      "php_laravel": {
+        "method": "local-deploy",
+        "steps": [
+          "composer install",
+          "claude-mpm local-deploy start --command 'php artisan serve --port={port}' --port {port} --auto-restart --health-check http://localhost:{port}/health"
+        ],
+        "environment": {
+          "APP_ENV": "local"
+        }
+      },
+      "dart_flutter_web": {
+        "method": "local-deploy",
+        "steps": [
+          "flutter pub get",
+          "claude-mpm local-deploy start --command 'flutter run -d web-server --web-port={port}' --port {port} --auto-restart"
+        ],
+        "hot_reload": true
       }
     },
     "docker": {
@@ -482,6 +1026,302 @@
       "action": "increase_memory_limit"
     }
   },
+  "best_practices": {
+    "port_selection": {
+      "description": "Recommended default ports by language and framework",
+      "nodejs": {
+        "default_ports": [3000, 3001, 3002],
+        "frameworks": {
+          "express": 3000,
+          "nextjs": 3000,
+          "nestjs": 3000
+        }
+      },
+      "python": {
+        "default_ports": [8000, 5000, 8080],
+        "frameworks": {
+          "fastapi": 8000,
+          "django": 8000,
+          "flask": 5000
+        }
+      },
+      "rust": {
+        "default_ports": [8080, 3000],
+        "frameworks": {
+          "actix-web": 8080,
+          "rocket": 8000,
+          "axum": 3000
+        }
+      },
+      "go": {
+        "default_ports": [8080, 8000],
+        "frameworks": {
+          "gin": 8080,
+          "echo": 1323,
+          "fiber": 3000
+        }
+      },
+      "java": {
+        "default_ports": [8080, 8443],
+        "frameworks": {
+          "spring-boot": 8080,
+          "tomcat": 8080
+        }
+      },
+      "ruby": {
+        "default_ports": [3000, 9292],
+        "frameworks": {
+          "rails": 3000,
+          "sinatra": 4567
+        }
+      },
+      "php": {
+        "default_ports": [8000, 8080],
+        "frameworks": {
+          "laravel": 8000,
+          "symfony": 8000
+        }
+      },
+      "dart": {
+        "default_ports": [8080],
+        "frameworks": {
+          "flutter-web": 8080,
+          "shelf": 8080
+        }
+      }
+    },
+    "health_checks": {
+      "description": "Framework-specific health check endpoints",
+      "python_fastapi": {
+        "primary": "/health",
+        "alternatives": ["/docs", "/openapi.json"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "python_django": {
+        "primary": "/health",
+        "alternatives": ["/admin"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "nodejs_express": {
+        "primary": "/health",
+        "alternatives": ["/ping", "/ready"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "rust_actix": {
+        "primary": "/health",
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "rust_rocket": {
+        "primary": "/health",
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "rust_axum": {
+        "primary": "/health",
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "go_gin": {
+        "primary": "/ping",
+        "alternatives": ["/health"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "go_echo": {
+        "primary": "/health",
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "go_fiber": {
+        "primary": "/health",
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "java_spring_boot": {
+        "primary": "/actuator/health",
+        "alternatives": ["/actuator/info"],
+        "expected_status": 200,
+        "timeout": 10,
+        "management_port": 8081
+      },
+      "ruby_rails": {
+        "primary": "/up",
+        "alternatives": ["/health"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "php_laravel": {
+        "primary": "/health",
+        "alternatives": ["/api/health"],
+        "expected_status": 200,
+        "timeout": 5
+      },
+      "recommendation": {
+        "endpoint": "Always configure /health endpoint",
+        "check_interval": "30 seconds recommended",
+        "timeout": "5 seconds maximum",
+        "retry_attempts": 3
+      }
+    },
+    "auto_restart": {
+      "description": "Auto-restart configuration best practices",
+      "enabled": true,
+      "max_attempts": 5,
+      "backoff_strategy": "exponential (2s, 4s, 8s, 16s, 32s)",
+      "circuit_breaker": {
+        "enabled": true,
+        "threshold": 3,
+        "window_seconds": 300,
+        "reset_seconds": 600
+      },
+      "recommendation": "Enable auto-restart for all production deployments"
+    },
+    "log_monitoring": {
+      "description": "Framework-specific log patterns to monitor",
+      "python": {
+        "error_patterns": ["ERROR", "CRITICAL", "Exception", "Traceback", "Failed to"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "nodejs": {
+        "error_patterns": ["ERROR", "Error:", "Exception", "Unhandled", "ECONNREFUSED"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "rust": {
+        "error_patterns": ["ERROR", "FATAL", "panic", "thread .* panicked"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "go": {
+        "error_patterns": ["ERROR", "FATAL", "panic:", "runtime error"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "java": {
+        "error_patterns": ["ERROR", "SEVERE", "Exception", "java.lang.", "OutOfMemoryError"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "ruby": {
+        "error_patterns": ["ERROR", "FATAL", "Exception"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "php": {
+        "error_patterns": ["Fatal error", "Parse error", "Exception"],
+        "action": "Trigger auto-restart on critical patterns"
+      },
+      "enabled": true
+    },
+    "graceful_shutdown": {
+      "description": "Graceful shutdown patterns by language",
+      "nodejs": {
+        "signal": "SIGTERM",
+        "timeout": 10,
+        "pattern": "process.on('SIGTERM', gracefulShutdown)"
+      },
+      "python": {
+        "signal": "SIGTERM",
+        "timeout": 30,
+        "pattern": "signal.signal(signal.SIGTERM, shutdown_handler)"
+      },
+      "rust": {
+        "signal": "SIGTERM",
+        "timeout": 10,
+        "pattern": "tokio::signal::ctrl_c() or signal handlers"
+      },
+      "go": {
+        "signal": "SIGTERM",
+        "timeout": 10,
+        "pattern": "signal.Notify(quit, syscall.SIGTERM)"
+      },
+      "java": {
+        "signal": "SIGTERM",
+        "timeout": 30,
+        "pattern": "server.shutdown=graceful in application.properties"
+      },
+      "ruby": {
+        "signal": "SIGTERM",
+        "timeout": 30,
+        "pattern": "Puma graceful shutdown via config"
+      },
+      "php": {
+        "signal": "SIGTERM",
+        "timeout": 10,
+        "pattern": "PHP-FPM graceful shutdown"
+      },
+      "recommendation": "Always implement graceful shutdown handlers"
+    },
+    "environment_configuration": {
+      "description": "Environment variable patterns by framework",
+      "development": {
+        "python_fastapi": {
+          "ENVIRONMENT": "development",
+          "DEBUG": "True",
+          "LOG_LEVEL": "debug",
+          "RELOAD": "true"
+        },
+        "nodejs_express": {
+          "NODE_ENV": "development",
+          "DEBUG": "*"
+        },
+        "rust": {
+          "RUST_LOG": "debug"
+        },
+        "go": {
+          "GO_ENV": "development"
+        },
+        "java_spring_boot": {
+          "SPRING_PROFILES_ACTIVE": "dev",
+          "LOGGING_LEVEL_ROOT": "DEBUG"
+        },
+        "ruby_rails": {
+          "RAILS_ENV": "development"
+        },
+        "php_laravel": {
+          "APP_ENV": "local",
+          "APP_DEBUG": "true"
+        }
+      },
+      "production": {
+        "python_fastapi": {
+          "ENVIRONMENT": "production",
+          "DEBUG": "False",
+          "LOG_LEVEL": "info",
+          "WORKERS": "4"
+        },
+        "nodejs_express": {
+          "NODE_ENV": "production"
+        },
+        "rust": {
+          "RUST_LOG": "info"
+        },
+        "go": {
+          "GO_ENV": "production"
+        },
+        "java_spring_boot": {
+          "SPRING_PROFILES_ACTIVE": "prod",
+          "LOGGING_LEVEL_ROOT": "INFO",
+          "JAVA_OPTS": "-Xmx512m -Xms256m"
+        },
+        "ruby_rails": {
+          "RAILS_ENV": "production",
+          "RAILS_LOG_TO_STDOUT": "1"
+        },
+        "php_laravel": {
+          "APP_ENV": "production",
+          "APP_DEBUG": "false"
+        }
+      }
+    },
+    "resource_monitoring": {
+      "description": "Resource thresholds for health monitoring",
+      "cpu_threshold": 80.0,
+      "memory_threshold_mb": 500,
+      "fd_threshold_percent": 0.8,
+      "check_interval": 30,
+      "alert_on_sustained_high_usage": true
+    }
+  },
   "security": {
     "port_exposure": "localhost_only",
     "process_isolation": "user_level",
@@ -582,6 +1422,106 @@
         "analyze_crash_pattern",
         "suggest_fixes"
       ]
+    },
+    {
+      "user": "Deploy my FastAPI app with auto-restart",
+      "response": "I'll deploy your FastAPI application with uvicorn and enable auto-restart for production stability...",
+      "actions": [
+        "detect_fastapi_framework",
+        "install_dependencies",
+        "execute_local_deploy_with_uvicorn",
+        "configure_health_check_at_/health",
+        "enable_auto_restart",
+        "verify_endpoint_responds",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Start my Rust Actix-web app in dev mode",
+      "response": "I'll start your Actix-web application with cargo watch for hot reloading...",
+      "actions": [
+        "detect_rust_actix",
+        "execute_cargo_watch",
+        "configure_health_check_at_/health",
+        "monitor_compilation",
+        "verify_server_running",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Deploy my Go Gin app to production",
+      "response": "I'll build and deploy your Go Gin application with auto-restart enabled...",
+      "actions": [
+        "detect_go_gin",
+        "build_go_binary",
+        "execute_local_deploy_start",
+        "configure_health_check_at_/ping",
+        "enable_auto_restart",
+        "verify_endpoint_responds",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Run my Spring Boot app in development",
+      "response": "I'll start your Spring Boot application with Maven in development mode...",
+      "actions": [
+        "detect_spring_boot",
+        "execute_mvn_spring_boot_run",
+        "configure_health_check_at_/actuator/health",
+        "wait_for_startup",
+        "verify_actuator_endpoint",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Deploy my Rails app with Puma",
+      "response": "I'll deploy your Rails application with Puma and enable auto-restart...",
+      "actions": [
+        "detect_rails",
+        "bundle_install",
+        "run_migrations",
+        "execute_local_deploy_with_puma",
+        "configure_health_check_at_/up",
+        "enable_auto_restart",
+        "verify_endpoint_responds",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Start my Laravel app locally",
+      "response": "I'll start your Laravel application with php artisan serve...",
+      "actions": [
+        "detect_laravel",
+        "composer_install",
+        "run_migrations",
+        "execute_local_deploy_artisan_serve",
+        "configure_health_check_at_/health",
+        "verify_endpoint_responds",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Deploy my Express.js API",
+      "response": "I'll deploy your Express.js API with nodemon for development...",
+      "actions": [
+        "detect_express",
+        "npm_install",
+        "execute_local_deploy_with_nodemon",
+        "configure_health_check_at_/health",
+        "enable_auto_restart",
+        "verify_endpoint_responds",
+        "report_deployment_url"
+      ]
+    },
+    {
+      "user": "Check health of all deployments",
+      "response": "I'll check the health status of all active deployments...",
+      "actions": [
+        "list_all_deployments",
+        "check_health_for_each",
+        "report_health_status",
+        "identify_unhealthy_services"
+      ]
     }
   ],
   "usage_guide": {
@@ -618,12 +1558,104 @@
       "state_file_corruption": "Delete .claude-mpm/deployment-state.json to reset (will lose tracking)"
     }
   },
-  "agent_version": "1.0.2",
+  "agent_version": "2.0.0",
   "knowledge": {
     "best_practices": [
       "Review file commit history before modifications: git log --oneline -5 <file_path>",
       "Write succinct commit messages explaining WHAT changed and WHY",
       "Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
     ]
+  },
+  "tool_use_patterns": {
+    "framework_detection": {
+      "description": "Detect the framework before deployment",
+      "workflow": [
+        "Check for framework-specific files (Cargo.toml, go.mod, pom.xml, package.json, etc.)",
+        "Read configuration files to identify dependencies",
+        "Match against detection_patterns to determine framework",
+        "Select appropriate deployment strategy based on framework"
+      ]
+    },
+    "deployment_workflow": {
+      "description": "Standard deployment workflow for all frameworks",
+      "steps": [
+        "1. Detect framework using detection_patterns",
+        "2. Choose deployment mode (development or production)",
+        "3. Install dependencies if needed",
+        "4. Build application if production mode",
+        "5. Execute local-deploy start command with appropriate flags",
+        "6. Configure health check endpoint based on framework",
+        "7. Enable auto-restart for production deployments",
+        "8. Verify endpoint responds before reporting success",
+        "9. Report deployment URL with health status"
+      ]
+    },
+    "health_check_configuration": {
+      "description": "Configure health checks based on framework",
+      "examples": {
+        "fastapi": "claude-mpm local-deploy start --command 'uvicorn main:app --reload' --port 8000 --auto-restart --health-check http://localhost:8000/health",
+        "spring_boot": "claude-mpm local-deploy start --command 'mvn spring-boot:run' --port 8080 --auto-restart --health-check http://localhost:8080/actuator/health",
+        "gin": "claude-mpm local-deploy start --command './app' --port 8080 --auto-restart --health-check http://localhost:8080/ping",
+        "actix": "claude-mpm local-deploy start --command 'cargo run' --port 8080 --auto-restart --health-check http://localhost:8080/health"
+      }
+    },
+    "auto_restart_patterns": {
+      "description": "Enable auto-restart for production stability",
+      "when_to_use": [
+        "Production deployments",
+        "Long-running services",
+        "APIs with high availability requirements",
+        "Services that may encounter transient failures"
+      ],
+      "configuration": {
+        "max_attempts": 5,
+        "backoff_strategy": "exponential",
+        "circuit_breaker_enabled": true
+      }
+    },
+    "log_monitoring_setup": {
+      "description": "Configure log monitoring for automatic issue detection",
+      "python_example": "Monitor for: ERROR, CRITICAL, Exception, Traceback",
+      "rust_example": "Monitor for: ERROR, FATAL, panic, thread .* panicked",
+      "go_example": "Monitor for: ERROR, FATAL, panic:, runtime error",
+      "java_example": "Monitor for: ERROR, SEVERE, Exception, OutOfMemoryError"
+    },
+    "multi_language_support": {
+      "description": "Support for multiple programming languages and frameworks",
+      "languages": {
+        "python": ["FastAPI", "Django", "Flask"],
+        "nodejs": ["Express", "Next.js", "NestJS"],
+        "rust": ["Actix-web", "Rocket", "Axum"],
+        "go": ["Gin", "Echo", "Fiber"],
+        "java": ["Spring Boot"],
+        "ruby": ["Rails"],
+        "php": ["Laravel"],
+        "dart": ["Flutter Web"]
+      },
+      "detection_priority": [
+        "1. Check for language-specific lock files (Cargo.lock, go.sum, pom.xml)",
+        "2. Check for framework-specific config files",
+        "3. Check for main entry points (main.rs, main.go, server.js)",
+        "4. Read dependencies to identify framework"
+      ]
+    },
+    "troubleshooting_patterns": {
+      "port_conflicts": {
+        "detection": "EADDRINUSE or 'port already in use'",
+        "action": "Use hash-based port allocation with linear probing to find available port",
+        "never": "Kill existing process without verification"
+      },
+      "build_failures": {
+        "rust": "Check Cargo.toml dependencies and run 'cargo check'",
+        "go": "Check go.mod and run 'go mod tidy'",
+        "java": "Check pom.xml or build.gradle and run dependency resolution",
+        "nodejs": "Check package.json and run 'npm install'"
+      },
+      "health_check_failures": {
+        "action": "Wait for application startup (up to 30 seconds for Java, 10 seconds for others)",
+        "retry": "Retry health check 3 times with backoff",
+        "report": "Show startup logs if health check fails"
+      }
+    }
   }
 }

{claude_mpm-4.14.0.dist-info → claude_mpm-4.14.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.14.0
+Version: 4.14.2
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team

{claude_mpm-4.14.0.dist-info → claude_mpm-4.14.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 claude_mpm/BUILD_NUMBER,sha256=9JfxhnDtr-8l3kCP2U5TVXSErptHoga8m7XA8zqgGOc,4
-claude_mpm/VERSION,sha256=EsbNzYeGHvP0ZGb62vJDP5N02JE01T8kfdSU_SmCX9U,7
+claude_mpm/VERSION,sha256=rbLlIbQiWCgMPTPwuqeiHsgsiTRD_NG0Tr2g6Sr13S0,7
 claude_mpm/__init__.py,sha256=UCw6j9e_tZQ3kJtTqmdfNv7MHyw9nD1jkj80WurwM2g,2064
 claude_mpm/__main__.py,sha256=Ro5UBWBoQaSAIoSqWAr7zkbLyvi4sSy28WShqAhKJG0,723
 claude_mpm/constants.py,sha256=sLjJF6Kw7H4V9WWeaEYltM-77TgXqzEMX5vx4ukM5-0,5977
@@ -46,7 +46,7 @@ claude_mpm/agents/templates/git_file_tracking.md,sha256=r8qckL8pS2nIvZAImFgbjAzp
 claude_mpm/agents/templates/golang_engineer.json,sha256=6ONJV8hs257AYiHdG1ZKz7p1iCP9NpSpno5QTS_1kzw,12686
 claude_mpm/agents/templates/imagemagick.json,sha256=dZRlUWgOjYsms93CnXshoO5w1o73uUJgcqUcnAMFDy0,17994
 claude_mpm/agents/templates/java_engineer.json,sha256=cdVOoxOCEPZdMv0EApLjvojnOW4xe6hOxL-J5u4ho1A,50068
-claude_mpm/agents/templates/local_ops_agent.json,sha256=pOrN6Dt8uWcefAIJ23lBI1-6RHuqTmWB3UzbHpLWGIc,17412
+claude_mpm/agents/templates/local_ops_agent.json,sha256=xmogxjgfBtfRAATSfMn--ytP0OV70lqezeCIgkUFVHk,50367
 claude_mpm/agents/templates/memory_manager.json,sha256=dQJzrXuxpSUmS99854St14tyAlS70OKqMoGbOrQ9wi4,12980
 claude_mpm/agents/templates/nextjs_engineer.json,sha256=4bXN4IkxgXvRoVyS0NPDa-cZ-LozbT3sCOD_0v47rEE,18444
 claude_mpm/agents/templates/ops.json,sha256=S7TkcvaHFw7SJLYKwwm8eCvK0iMbvcHv7KTDBm7vvjc,11159
@@ -854,9 +854,9 @@ claude_mpm/utils/subprocess_utils.py,sha256=D0izRT8anjiUb_JG72zlJR_JAw1cDkb7kalN
 claude_mpm/validation/__init__.py,sha256=YZhwE3mhit-lslvRLuwfX82xJ_k4haZeKmh4IWaVwtk,156
 claude_mpm/validation/agent_validator.py,sha256=GprtAvu80VyMXcKGsK_VhYiXWA6BjKHv7O6HKx0AB9w,20917
 claude_mpm/validation/frontmatter_validator.py,sha256=YpJlYNNYcV8u6hIOi3_jaRsDnzhbcQpjCBE6eyBKaFY,7076
-claude_mpm-4.14.0.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
-claude_mpm-4.14.0.dist-info/METADATA,sha256=L28lbbRPKyA6pa5TC_vZhqbq1Sn2fH2G-YtSjOGzepM,17967
-claude_mpm-4.14.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-4.14.0.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
-claude_mpm-4.14.0.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-4.14.0.dist-info/RECORD,,
+claude_mpm-4.14.2.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
+claude_mpm-4.14.2.dist-info/METADATA,sha256=Df7_gDbERLNbITmqxjLckk7YBJ8JMa50aG31QyxXxss,17967
+claude_mpm-4.14.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-4.14.2.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
+claude_mpm-4.14.2.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-4.14.2.dist-info/RECORD,,