claude-mpm 4.15.3__py3-none-any.whl → 4.15.6__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": "2.0.0",
   "author": "Claude MPM",
   "authority": {
     "level": "deployment_manager",
@@ -26,7 +25,13 @@
         "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"]
+          "provides": [
+            "process_info",
+            "health_status",
+            "resource_usage",
+            "uptime",
+            "restart_count"
+          ]
         },
         "monitor": {
           "syntax": "claude-mpm local-deploy monitor <deployment-id> [--refresh 2]",
@@ -35,7 +40,11 @@
         "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"]
+          "checks": [
+            "http_endpoint",
+            "process_responsive",
+            "resource_limits"
+          ]
         },
         "stop": {
           "syntax": "claude-mpm local-deploy stop <deployment-id>",
@@ -681,10 +690,19 @@
     "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": {
@@ -839,9 +857,16 @@
     "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"
@@ -1026,11 +1051,61 @@
       "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],
+        "default_ports": [
+          3000,
+          3001,
+          3002
+        ],
         "frameworks": {
           "express": 3000,
           "nextjs": 3000,
@@ -1038,7 +1113,11 @@
         }
       },
       "python": {
-        "default_ports": [8000, 5000, 8080],
+        "default_ports": [
+          8000,
+          5000,
+          8080
+        ],
         "frameworks": {
           "fastapi": 8000,
           "django": 8000,
@@ -1046,7 +1125,10 @@
         }
       },
       "rust": {
-        "default_ports": [8080, 3000],
+        "default_ports": [
+          8080,
+          3000
+        ],
         "frameworks": {
           "actix-web": 8080,
           "rocket": 8000,
@@ -1054,7 +1136,10 @@
         }
       },
       "go": {
-        "default_ports": [8080, 8000],
+        "default_ports": [
+          8080,
+          8000
+        ],
         "frameworks": {
           "gin": 8080,
           "echo": 1323,
@@ -1062,28 +1147,39 @@
         }
       },
       "java": {
-        "default_ports": [8080, 8443],
+        "default_ports": [
+          8080,
+          8443
+        ],
         "frameworks": {
           "spring-boot": 8080,
           "tomcat": 8080
         }
       },
       "ruby": {
-        "default_ports": [3000, 9292],
+        "default_ports": [
+          3000,
+          9292
+        ],
         "frameworks": {
           "rails": 3000,
           "sinatra": 4567
         }
       },
       "php": {
-        "default_ports": [8000, 8080],
+        "default_ports": [
+          8000,
+          8080
+        ],
         "frameworks": {
           "laravel": 8000,
           "symfony": 8000
         }
       },
       "dart": {
-        "default_ports": [8080],
+        "default_ports": [
+          8080
+        ],
         "frameworks": {
           "flutter-web": 8080,
           "shelf": 8080
@@ -1094,19 +1190,27 @@
       "description": "Framework-specific health check endpoints",
       "python_fastapi": {
         "primary": "/health",
-        "alternatives": ["/docs", "/openapi.json"],
+        "alternatives": [
+          "/docs",
+          "/openapi.json"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
       "python_django": {
         "primary": "/health",
-        "alternatives": ["/admin"],
+        "alternatives": [
+          "/admin"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
       "nodejs_express": {
         "primary": "/health",
-        "alternatives": ["/ping", "/ready"],
+        "alternatives": [
+          "/ping",
+          "/ready"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
@@ -1127,7 +1231,9 @@
       },
       "go_gin": {
         "primary": "/ping",
-        "alternatives": ["/health"],
+        "alternatives": [
+          "/health"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
@@ -1143,20 +1249,26 @@
       },
       "java_spring_boot": {
         "primary": "/actuator/health",
-        "alternatives": ["/actuator/info"],
+        "alternatives": [
+          "/actuator/info"
+        ],
         "expected_status": 200,
         "timeout": 10,
         "management_port": 8081
       },
       "ruby_rails": {
         "primary": "/up",
-        "alternatives": ["/health"],
+        "alternatives": [
+          "/health"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
       "php_laravel": {
         "primary": "/health",
-        "alternatives": ["/api/health"],
+        "alternatives": [
+          "/api/health"
+        ],
         "expected_status": 200,
         "timeout": 5
       },
@@ -1183,31 +1295,67 @@
     "log_monitoring": {
       "description": "Framework-specific log patterns to monitor",
       "python": {
-        "error_patterns": ["ERROR", "CRITICAL", "Exception", "Traceback", "Failed to"],
+        "error_patterns": [
+          "ERROR",
+          "CRITICAL",
+          "Exception",
+          "Traceback",
+          "Failed to"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "nodejs": {
-        "error_patterns": ["ERROR", "Error:", "Exception", "Unhandled", "ECONNREFUSED"],
+        "error_patterns": [
+          "ERROR",
+          "Error:",
+          "Exception",
+          "Unhandled",
+          "ECONNREFUSED"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "rust": {
-        "error_patterns": ["ERROR", "FATAL", "panic", "thread .* panicked"],
+        "error_patterns": [
+          "ERROR",
+          "FATAL",
+          "panic",
+          "thread .* panicked"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "go": {
-        "error_patterns": ["ERROR", "FATAL", "panic:", "runtime error"],
+        "error_patterns": [
+          "ERROR",
+          "FATAL",
+          "panic:",
+          "runtime error"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "java": {
-        "error_patterns": ["ERROR", "SEVERE", "Exception", "java.lang.", "OutOfMemoryError"],
+        "error_patterns": [
+          "ERROR",
+          "SEVERE",
+          "Exception",
+          "java.lang.",
+          "OutOfMemoryError"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "ruby": {
-        "error_patterns": ["ERROR", "FATAL", "Exception"],
+        "error_patterns": [
+          "ERROR",
+          "FATAL",
+          "Exception"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "php": {
-        "error_patterns": ["Fatal error", "Parse error", "Exception"],
+        "error_patterns": [
+          "Fatal error",
+          "Parse error",
+          "Exception"
+        ],
         "action": "Trigger auto-restart on critical patterns"
       },
       "enabled": true
@@ -1558,7 +1706,7 @@
       "state_file_corruption": "Delete .claude-mpm/deployment-state.json to reset (will lose tracking)"
     }
   },
-  "agent_version": "2.0.0",
+  "agent_version": "2.0.1",
   "knowledge": {
     "best_practices": [
       "Review file commit history before modifications: git log --oneline -5 <file_path>",
@@ -1623,14 +1771,38 @@
     "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"]
+        "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)",
@@ -1657,5 +1829,12 @@
         "report": "Show startup logs if health check fails"
       }
     }
-  }
+  },
+  "skills": [
+    "docker-containerization",
+    "database-migration",
+    "security-scanning",
+    "git-workflow",
+    "systematic-debugging"
+  ]
 }

claude_mpm/agents/templates/nextjs_engineer.json

@@ -271,5 +271,15 @@
       "npm>=10"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/ops.json

@@ -174,5 +174,12 @@
       "git"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "docker-containerization",
+    "database-migration",
+    "security-scanning",
+    "git-workflow",
+    "systematic-debugging"
+  ]
 }

claude_mpm/agents/templates/php-engineer.json

@@ -267,5 +267,15 @@
       "composer>=2.7"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/project_organizer.json

@@ -129,5 +129,12 @@
       "token_usage": 8192,
       "success_rate": 0.9
     }
-  }
-}
+  },
+  "skills": [
+    "docker-containerization",
+    "database-migration",
+    "security-scanning",
+    "git-workflow",
+    "systematic-debugging"
+  ]
+}

claude_mpm/agents/templates/prompt-engineer.json

@@ -729,5 +729,9 @@
       "Write succinct commit messages explaining WHAT changed and WHY",
       "Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
     ]
-  }
+  },
+  "skills": [
+    "systematic-debugging",
+    "code-review"
+  ]
 }

claude_mpm/agents/templates/python_engineer.json

@@ -368,5 +368,15 @@
       "python3.12+"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/qa.json

@@ -232,5 +232,11 @@
       "git"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling"
+  ]
 }

claude_mpm/agents/templates/react_engineer.json

@@ -224,5 +224,15 @@
       "npm"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/refactoring_engineer.json

@@ -265,5 +265,12 @@
       "memory_usage": 500,
       "chunk_size": 200
     }
-  }
+  },
+  "skills": [
+    "refactoring-patterns",
+    "code-review",
+    "systematic-debugging",
+    "performance-profiling",
+    "test-driven-development"
+  ]
 }

claude_mpm/agents/templates/research.json

@@ -181,5 +181,8 @@
       "git"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "systematic-debugging"
+  ]
 }

claude_mpm/agents/templates/ruby-engineer.json

@@ -266,5 +266,15 @@
       "bundler>=2.5"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/rust_engineer.json

@@ -256,5 +256,15 @@
       "cargo>=1.75"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/security.json

@@ -193,5 +193,10 @@
       "git"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "security-scanning",
+    "code-review",
+    "systematic-debugging"
+  ]
 }

claude_mpm/agents/templates/ticketing.json

@@ -168,5 +168,10 @@
       "git"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "api-documentation",
+    "code-review",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/typescript_engineer.json

@@ -271,5 +271,15 @@
       "npm>=10"
     ],
     "optional": false
-  }
+  },
+  "skills": [
+    "test-driven-development",
+    "systematic-debugging",
+    "async-testing",
+    "performance-profiling",
+    "security-scanning",
+    "code-review",
+    "refactoring-patterns",
+    "git-workflow"
+  ]
 }

claude_mpm/agents/templates/vercel_ops_agent.json

@@ -401,5 +401,12 @@
       "environment": "https://api.vercel.com/v10/projects/{projectId}/env",
       "teams": "https://api.vercel.com/v2/teams"
     }
-  }
+  },
+  "skills": [
+    "docker-containerization",
+    "database-migration",
+    "security-scanning",
+    "git-workflow",
+    "systematic-debugging"
+  ]
 }