claude-mpm 5.4.14__py3-none-any.whl → 5.4.36__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of claude-mpm might be problematic. Click here for more details.

Files changed (103) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/agents/BASE_AGENT.md +164 -0
  3. claude_mpm/agents/BASE_ENGINEER.md +658 -0
  4. claude_mpm/agents/CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md +1 -1
  5. claude_mpm/agents/MEMORY.md +1 -1
  6. claude_mpm/agents/PM_INSTRUCTIONS.md +363 -817
  7. claude_mpm/agents/WORKFLOW.md +5 -254
  8. claude_mpm/agents/agent_loader.py +1 -1
  9. claude_mpm/agents/base_agent.json +31 -0
  10. claude_mpm/cli/chrome_devtools_installer.py +175 -0
  11. claude_mpm/cli/commands/agent_state_manager.py +10 -10
  12. claude_mpm/cli/commands/agents.py +9 -40
  13. claude_mpm/cli/commands/auto_configure.py +4 -4
  14. claude_mpm/cli/commands/configure.py +1 -1
  15. claude_mpm/cli/commands/postmortem.py +1 -1
  16. claude_mpm/cli/commands/skills.py +193 -187
  17. claude_mpm/cli/interactive/agent_wizard.py +2 -2
  18. claude_mpm/cli/parsers/agents_parser.py +0 -9
  19. claude_mpm/cli/parsers/auto_configure_parser.py +0 -138
  20. claude_mpm/cli/startup.py +330 -78
  21. claude_mpm/commands/mpm-config.md +1 -2
  22. claude_mpm/commands/mpm-help.md +14 -95
  23. claude_mpm/commands/mpm-organize.md +350 -153
  24. claude_mpm/core/config.py +2 -4
  25. claude_mpm/core/framework/loaders/agent_loader.py +1 -1
  26. claude_mpm/core/framework/loaders/instruction_loader.py +52 -11
  27. claude_mpm/core/unified_agent_registry.py +1 -1
  28. claude_mpm/dashboard/static/svelte-build/_app/env.js +1 -0
  29. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/0.B_FtCwCQ.css +1 -0
  30. claude_mpm/dashboard/static/svelte-build/_app/immutable/assets/2.Cl_eSA4x.css +1 -0
  31. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/BgChzWQ1.js +1 -0
  32. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CIXEwuWe.js +1 -0
  33. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/CWc5urbQ.js +1 -0
  34. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DMkZpdF2.js +2 -0
  35. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/DjhvlsAc.js +1 -0
  36. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/N4qtv3Hx.js +2 -0
  37. claude_mpm/dashboard/static/svelte-build/_app/immutable/chunks/uj46x2Wr.js +1 -0
  38. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/app.DTL5mJO-.js +2 -0
  39. claude_mpm/dashboard/static/svelte-build/_app/immutable/entry/start.DzuEhzqh.js +1 -0
  40. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/0.CAGBuiOw.js +1 -0
  41. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/1.DFLC8jdE.js +1 -0
  42. claude_mpm/dashboard/static/svelte-build/_app/immutable/nodes/2.DPvEihJJ.js +10 -0
  43. claude_mpm/dashboard/static/svelte-build/_app/version.json +1 -0
  44. claude_mpm/dashboard/static/svelte-build/favicon.svg +7 -0
  45. claude_mpm/dashboard/static/svelte-build/index.html +36 -0
  46. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-311.pyc +0 -0
  47. claude_mpm/hooks/claude_hooks/__pycache__/correlation_manager.cpython-311.pyc +0 -0
  48. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-311.pyc +0 -0
  49. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-311.pyc +0 -0
  50. claude_mpm/hooks/claude_hooks/__pycache__/installer.cpython-311.pyc +0 -0
  51. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-311.pyc +0 -0
  52. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-311.pyc +0 -0
  53. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-311.pyc +0 -0
  54. claude_mpm/hooks/claude_hooks/event_handlers.py +5 -0
  55. claude_mpm/hooks/claude_hooks/hook_handler.py +149 -1
  56. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-311.pyc +0 -0
  57. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager.cpython-311.pyc +0 -0
  58. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-311.pyc +0 -0
  59. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-311.pyc +0 -0
  60. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-311.pyc +0 -0
  61. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-311.pyc +0 -0
  62. claude_mpm/hooks/claude_hooks/services/connection_manager.py +26 -6
  63. claude_mpm/models/git_repository.py +3 -3
  64. claude_mpm/scripts/start_activity_logging.py +0 -0
  65. claude_mpm/services/agents/cache_git_manager.py +6 -6
  66. claude_mpm/services/agents/deployment/agent_deployment.py +7 -7
  67. claude_mpm/services/agents/deployment/agent_discovery_service.py +2 -2
  68. claude_mpm/services/agents/deployment/agent_template_builder.py +2 -2
  69. claude_mpm/services/agents/deployment/agents_directory_resolver.py +2 -2
  70. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +20 -22
  71. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +55 -53
  72. claude_mpm/services/agents/git_source_manager.py +2 -2
  73. claude_mpm/services/agents/recommender.py +5 -3
  74. claude_mpm/services/agents/single_tier_deployment_service.py +2 -2
  75. claude_mpm/services/agents/sources/git_source_sync_service.py +5 -5
  76. claude_mpm/services/agents/startup_sync.py +22 -2
  77. claude_mpm/services/command_deployment_service.py +10 -0
  78. claude_mpm/services/diagnostics/checks/agent_check.py +2 -2
  79. claude_mpm/services/diagnostics/checks/agent_sources_check.py +1 -1
  80. claude_mpm/services/git/git_operations_service.py +8 -8
  81. claude_mpm/services/monitor/server.py +473 -3
  82. claude_mpm/services/skills/selective_skill_deployer.py +475 -1
  83. claude_mpm/services/skills_deployer.py +62 -6
  84. claude_mpm/services/socketio/dashboard_server.py +1 -0
  85. claude_mpm/services/socketio/event_normalizer.py +37 -6
  86. claude_mpm/services/socketio/server/core.py +262 -123
  87. claude_mpm/utils/agent_dependency_loader.py +14 -2
  88. claude_mpm/utils/agent_filters.py +1 -1
  89. claude_mpm/utils/migration.py +4 -4
  90. claude_mpm/utils/robust_installer.py +47 -3
  91. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/METADATA +5 -3
  92. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/RECORD +96 -66
  93. claude_mpm/cli/commands/agents_detect.py +0 -380
  94. claude_mpm/cli/commands/agents_recommend.py +0 -309
  95. claude_mpm/commands/mpm-agents-auto-configure.md +0 -278
  96. claude_mpm/commands/mpm-agents-detect.md +0 -177
  97. claude_mpm/commands/mpm-agents-list.md +0 -131
  98. claude_mpm/commands/mpm-agents-recommend.md +0 -223
  99. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/WHEEL +0 -0
  100. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/entry_points.txt +0 -0
  101. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/licenses/LICENSE +0 -0
  102. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/licenses/LICENSE-FAQ.md +0 -0
  103. {claude_mpm-5.4.14.dist-info → claude_mpm-5.4.36.dist-info}/top_level.txt +0 -0
claude_mpm/commands/mpm-agents-recommend.md DELETED
@@ -1,223 +0,0 @@
1
- ---
2
- namespace: mpm/agents
3
- command: recommend
4
- aliases: [mpm-agents-recommend]
5
- migration_target: /mpm/agents:recommend
6
- category: agents
7
- deprecated_aliases: []
8
- description: Get intelligent agent recommendations based on detected project toolchain
9
- ---
10
- # Show recommended agents for detected project stack
11
-
12
- Get intelligent agent recommendations based on your project's detected toolchain.
13
-
14
- ## Usage
15
-
16
- ```
17
- /mpm-agents-recommend
18
- ```
19
-
20
- ## Description
21
-
22
- This command analyzes your detected project stack and recommends the most appropriate agents, organized by priority:
23
- - **Essential agents**: Core agents required for your primary stack
24
- - **Recommended agents**: Complementary agents for full functionality
25
- - **Optional agents**: Specialized agents for detected tools
26
-
27
- Each recommendation includes an explanation of why that agent is suggested.
28
-
29
- ## Implementation
30
-
31
- When you run `/mpm-agents-recommend`, the PM will execute:
32
- ```bash
33
- claude-mpm agents recommend
34
- ```
35
-
36
- This runs the detection phase and then applies recommendation rules to suggest the best agents for your specific technology stack.
37
-
38
- ## Expected Output
39
-
40
- ```
41
- 🤖 Agent Recommendations
42
- =========================
43
-
44
- Based on detected stack:
45
- Python 3.11, FastAPI 0.104.0, pytest, Docker, Vercel
46
-
47
- Essential Agents (Must Have):
48
- ✓ fastapi-engineer
49
- Reason: FastAPI framework detected - specialized agent for FastAPI development
50
- Capabilities: FastAPI routes, Pydantic models, async endpoints, dependency injection
51
-
52
- ✓ python-engineer
53
- Reason: Python project - general Python development support
54
- Capabilities: Python code, testing, debugging, package management
55
-
56
- ✓ api-qa
57
- Reason: API testing for FastAPI backend
58
- Capabilities: API endpoint testing, validation, load testing, contract testing
59
-
60
- Recommended Agents (Strongly Suggested):
61
- ○ docker-ops
62
- Reason: Docker configuration detected
63
- Capabilities: Docker builds, container management, docker-compose orchestration
64
-
65
- ○ vercel-ops
66
- Reason: Vercel deployment configuration found
67
- Capabilities: Vercel deployments, serverless functions, domain management
68
-
69
- ○ playwright-qa
70
- Reason: Comprehensive E2E testing capability
71
- Capabilities: Browser automation, visual testing, API testing
72
-
73
- Optional Agents (Nice to Have):
74
- ○ local-ops-agent
75
- Reason: Local development and PM2 process management
76
- Capabilities: Local server management, port handling, PM2 operations
77
-
78
- ○ security-agent
79
- Reason: Security scanning and best practices
80
- Capabilities: Dependency scanning, code security, auth patterns
81
-
82
- Summary:
83
- Recommended: 3 essential + 2 recommended = 5 agents
84
- Optional: 2 additional agents for enhanced capabilities
85
-
86
- Total recommended deployment: 5 agents
87
- Maximum useful deployment: 7 agents
88
-
89
- Next Steps:
90
- 1. Review recommendations above
91
- 2. Run '/mpm-auto-configure --preview' to see deployment plan
92
- 3. Run '/mpm-auto-configure' to deploy recommended agents
93
- 4. Or deploy individually: '/mpm-agents deploy <agent-name>'
94
- ```
95
-
96
- ## Recommendation Logic
97
-
98
- ### Python Projects
99
-
100
- **If FastAPI detected:**
101
- - Essential: fastapi-engineer, python-engineer, api-qa
102
- - Recommended: docker-ops (if Docker), vercel-ops (if Vercel)
103
-
104
- **If Flask detected:**
105
- - Essential: flask-engineer, python-engineer, api-qa
106
- - Recommended: docker-ops (if Docker)
107
-
108
- **If Django detected:**
109
- - Essential: django-engineer, python-engineer, api-qa
110
- - Recommended: docker-ops (if Docker)
111
-
112
- **If pytest detected:**
113
- - Add to recommended: api-qa, playwright-qa
114
-
115
- ### JavaScript/TypeScript Projects
116
-
117
- **If Next.js detected:**
118
- - Essential: nextjs-engineer, react-engineer, web-qa
119
- - Recommended: playwright-qa, vercel-ops (if Vercel)
120
-
121
- **If React detected (without Next.js):**
122
- - Essential: react-engineer, web-qa
123
- - Recommended: playwright-qa
124
-
125
- **If Vue detected:**
126
- - Essential: vue-engineer, web-qa
127
- - Recommended: playwright-qa
128
-
129
- **If Express detected:**
130
- - Essential: node-engineer, api-qa
131
- - Recommended: docker-ops (if Docker)
132
-
133
- **If Nest.js detected:**
134
- - Essential: nestjs-engineer, node-engineer, api-qa
135
- - Recommended: docker-ops (if Docker)
136
-
137
- ### Full-Stack Projects
138
-
139
- **Python backend + React frontend:**
140
- - Essential: fastapi-engineer (or flask-engineer), python-engineer, react-engineer, api-qa, web-qa
141
- - Recommended: playwright-qa, docker-ops, local-ops-agent
142
-
143
- **Node.js backend + React frontend:**
144
- - Essential: node-engineer, react-engineer, api-qa, web-qa
145
- - Recommended: playwright-qa, docker-ops
146
-
147
- ### Testing-Focused Projects
148
-
149
- **If Playwright detected:**
150
- - Add to recommended: playwright-qa
151
-
152
- **If Jest/Vitest detected:**
153
- - Ensure web-qa or api-qa in recommended
154
-
155
- ### Deployment-Focused Projects
156
-
157
- **If Vercel detected:**
158
- - Add to recommended: vercel-ops
159
-
160
- **If Railway detected:**
161
- - Add to recommended: railway-ops
162
-
163
- **If Docker detected:**
164
- - Add to recommended: docker-ops
165
-
166
- **If PM2 detected:**
167
- - Add to recommended: local-ops-agent
168
-
169
- ## Agent Descriptions
170
-
171
- ### Backend Specialists
172
- - **fastapi-engineer**: FastAPI expert - routes, Pydantic, async, websockets
173
- - **flask-engineer**: Flask expert - blueprints, extensions, templates
174
- - **django-engineer**: Django expert - models, views, ORM, admin
175
- - **node-engineer**: Node.js expert - Express, async, streams
176
- - **nestjs-engineer**: NestJS expert - modules, decorators, DI
177
-
178
- ### Frontend Specialists
179
- - **nextjs-engineer**: Next.js expert - app router, server components, SSR
180
- - **react-engineer**: React expert - hooks, state, components
181
- - **vue-engineer**: Vue expert - composition API, components
182
-
183
- ### QA Specialists
184
- - **api-qa**: API testing expert - REST, GraphQL, validation
185
- - **web-qa**: Web testing expert - fetch, integration, E2E
186
- - **playwright-qa**: Browser automation expert - UI testing, visual regression
187
-
188
- ### Ops Specialists
189
- - **docker-ops**: Docker expert - builds, compose, containers
190
- - **vercel-ops**: Vercel deployment expert - serverless, edge
191
- - **railway-ops**: Railway deployment expert
192
- - **local-ops-agent**: Local development expert - PM2, ports, processes
193
-
194
- ## Use Cases
195
-
196
- 1. **Planning**: Understand what agents you should deploy before starting work
197
- 2. **Validation**: Verify that auto-configuration will suggest the right agents
198
- 3. **Learning**: Discover what capabilities are available for your stack
199
- 4. **Optimization**: Find additional agents that could enhance your workflow
200
-
201
- ## Tips
202
-
203
- 1. **Start here**: Run this before `/mpm-auto-configure` to preview recommendations
204
- 2. **Essential vs Optional**: Focus on essential agents first, add others as needed
205
- 3. **Stack-specific**: Recommendations are tailored to YOUR detected stack
206
- 4. **Flexible**: You can always deploy additional agents later or skip some
207
- 5. **Explanations**: Pay attention to the "Reason" for each recommendation
208
-
209
- ## Customizing Recommendations
210
-
211
- After seeing recommendations, you can:
212
- 1. **Accept all**: Run `/mpm-auto-configure` to deploy all recommended agents
213
- 2. **Pick and choose**: Deploy specific agents with `/mpm-agents deploy <name>`
214
- 3. **Skip optional**: Deploy only essential and recommended agents
215
- 4. **Add more**: Deploy additional agents not in recommendations
216
-
217
- ## Related Commands
218
-
219
- - `/mpm-agents-detect` - See what was detected in your project
220
- - `/mpm-auto-configure` - Automatically deploy recommended agents
221
- - `/mpm-agents deploy <name>` - Deploy specific agents manually
222
- - `/mpm-agents` - View all available and deployed agents
223
- - `/mpm-help agents` - Learn more about agent management