claude-mpm 4.7.4__py3-none-any.whl → 4.18.2__py3-none-any.whl

claude_mpm/agents/templates/local_ops_agent.json

@@ -2,7 +2,6 @@
   "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",
   "author": "Claude MPM",
   "authority": {
     "level": "deployment_manager",
@@ -15,6 +14,83 @@
     ]
   },
   "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": [
@@ -24,7 +100,10 @@
         "persistent_state_tracking",
         "environment_variable_override"
       ],
-      "port_range": [3000, 3999],
+      "port_range": [
+        3000,
+        3999
+      ],
       "environment_override": "PROJECT_PORT"
     },
     "orphan_detection": {
@@ -52,7 +131,12 @@
         "svelte",
         "nuxt",
         "gatsby",
-        "vite"
+        "vite",
+        "express",
+        "nestjs",
+        "remix",
+        "sveltekit",
+        "astro"
       ],
       "python": [
         "django",
@@ -61,6 +145,23 @@
         "streamlit",
         "gradio"
       ],
+      "rust": [
+        "actix-web",
+        "rocket",
+        "axum",
+        "warp"
+      ],
+      "go": [
+        "gin",
+        "echo",
+        "fiber",
+        "net/http"
+      ],
+      "java": [
+        "spring-boot",
+        "tomcat",
+        "jetty"
+      ],
       "ruby": [
         "rails",
         "sinatra"
@@ -69,6 +170,10 @@
         "laravel",
         "symfony"
       ],
+      "dart": [
+        "flutter-web",
+        "shelf"
+      ],
       "static": [
         "hugo",
         "jekyll",
@@ -381,16 +486,223 @@
         "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": {
     "production": {
       "nextjs": {
         "method": "pm2",
+        "pm2_options": {
+          "max_memory_restart": "2G",
+          "max_restarts": 10,
+          "min_uptime": 3000,
+          "autorestart": true,
+          "kill_timeout": 5000,
+          "listen_timeout": 8000,
+          "shutdown_with_message": true
+        },
         "steps": [
           "npm install --production",
           "npm run build",
-          "pm2 start npm --name '{app_name}' -- start"
+          "pm2 start npm --name '{app_name}' -- start --max-memory-restart 2G --max-restarts 10 --min-uptime 3000"
         ],
         "health_check": "http://localhost:{port}",
         "environment": {
@@ -413,14 +725,148 @@
           "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": {
       "nextjs": {
         "method": "pm2",
+        "pm2_options": {
+          "max_memory_restart": "2G",
+          "max_restarts": 10,
+          "min_uptime": 3000,
+          "autorestart": true,
+          "watch": true
+        },
         "steps": [
           "npm install",
-          "pm2 start npm --name '{app_name}-dev' -- run dev"
+          "pm2 start npm --name '{app_name}-dev' -- run dev --max-memory-restart 2G --max-restarts 10 --min-uptime 3000 --watch"
         ],
         "environment": {
           "NODE_ENV": "development"
@@ -432,6 +878,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": {
@@ -479,6 +1051,425 @@
       "action": "increase_memory_limit"
     }
   },
+  "health_checks": {
+    "nextjs": {
+      "primary_endpoints": [
+        "/api/health",
+        "/"
+      ],
+      "build_artifacts": [
+        ".next/BUILD_ID",
+        ".next/routes-manifest.json"
+      ],
+      "static_assets": "/_next/static/chunks",
+      "validation_steps": [
+        "verify_build_artifacts",
+        "test_primary_endpoint",
+        "validate_static_assets"
+      ]
+    }
+  },
+  "pm2_monitoring": {
+    "metrics_extraction": {
+      "enabled": true,
+      "commands": {
+        "status": "pm2 jlist",
+        "describe": "pm2 describe {app_name}",
+        "metrics": "pm2 show {app_name}"
+      },
+      "tracked_metrics": [
+        "restart_count",
+        "uptime",
+        "memory_usage",
+        "cpu_usage",
+        "status",
+        "unstable_restarts"
+      ]
+    },
+    "alerts": {
+      "high_restart_count": {
+        "threshold": 5,
+        "action": "investigate_crash_logs"
+      },
+      "memory_near_limit": {
+        "threshold": "1.8G",
+        "action": "preemptive_restart_warning"
+      }
+    }
+  },
+  "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",
@@ -579,6 +1570,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": {
@@ -615,5 +1706,135 @@
       "state_file_corruption": "Delete .claude-mpm/deployment-state.json to reset (will lose tracking)"
     }
   },
-  "agent_version": "1.0.2"
+  "agent_version": "2.0.1",
+  "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"
+      }
+    }
+  },
+  "skills": [
+    "docker-containerization",
+    "database-migration",
+    "security-scanning",
+    "git-workflow",
+    "systematic-debugging"
+  ]
 }