claude-mpm 5.4.3__py3-none-any.whl → 5.4.21__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 (90) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/__init__.py +4 -0
  3. claude_mpm/agents/CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md +1 -1
  4. claude_mpm/agents/PM_INSTRUCTIONS.md +166 -21
  5. claude_mpm/agents/agent_loader.py +3 -27
  6. claude_mpm/cli/__main__.py +4 -0
  7. claude_mpm/cli/chrome_devtools_installer.py +175 -0
  8. claude_mpm/cli/commands/agents.py +0 -31
  9. claude_mpm/cli/commands/auto_configure.py +210 -25
  10. claude_mpm/cli/commands/config.py +88 -2
  11. claude_mpm/cli/commands/configure.py +85 -43
  12. claude_mpm/cli/commands/configure_agent_display.py +3 -1
  13. claude_mpm/cli/commands/mpm_init/core.py +2 -45
  14. claude_mpm/cli/commands/skills.py +214 -189
  15. claude_mpm/cli/executor.py +3 -3
  16. claude_mpm/cli/parsers/agents_parser.py +0 -9
  17. claude_mpm/cli/parsers/auto_configure_parser.py +0 -138
  18. claude_mpm/cli/parsers/config_parser.py +153 -83
  19. claude_mpm/cli/parsers/skills_parser.py +3 -2
  20. claude_mpm/cli/startup.py +490 -41
  21. claude_mpm/commands/mpm-config.md +265 -0
  22. claude_mpm/commands/mpm-help.md +14 -95
  23. claude_mpm/commands/mpm-organize.md +350 -153
  24. claude_mpm/core/framework/formatters/content_formatter.py +3 -13
  25. claude_mpm/core/framework_loader.py +4 -2
  26. claude_mpm/core/logger.py +13 -0
  27. claude_mpm/hooks/claude_hooks/event_handlers.py +176 -76
  28. claude_mpm/hooks/claude_hooks/hook_handler.py +2 -0
  29. claude_mpm/hooks/claude_hooks/installer.py +33 -10
  30. claude_mpm/hooks/claude_hooks/memory_integration.py +26 -9
  31. claude_mpm/hooks/claude_hooks/response_tracking.py +2 -3
  32. claude_mpm/hooks/memory_integration_hook.py +46 -1
  33. claude_mpm/init.py +0 -19
  34. claude_mpm/scripts/claude-hook-handler.sh +58 -18
  35. claude_mpm/scripts/start_activity_logging.py +0 -0
  36. claude_mpm/services/agents/agent_recommendation_service.py +6 -7
  37. claude_mpm/services/agents/agent_review_service.py +280 -0
  38. claude_mpm/services/agents/deployment/agent_discovery_service.py +2 -3
  39. claude_mpm/services/agents/deployment/agent_template_builder.py +1 -0
  40. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +78 -9
  41. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +13 -0
  42. claude_mpm/services/agents/git_source_manager.py +14 -0
  43. claude_mpm/services/agents/loading/base_agent_manager.py +1 -13
  44. claude_mpm/services/agents/toolchain_detector.py +6 -3
  45. claude_mpm/services/command_deployment_service.py +81 -8
  46. claude_mpm/services/git/git_operations_service.py +93 -8
  47. claude_mpm/services/self_upgrade_service.py +120 -12
  48. claude_mpm/services/skills/__init__.py +3 -0
  49. claude_mpm/services/skills/git_skill_source_manager.py +32 -2
  50. claude_mpm/services/skills/selective_skill_deployer.py +704 -0
  51. claude_mpm/services/skills/skill_to_agent_mapper.py +406 -0
  52. claude_mpm/services/skills_deployer.py +126 -9
  53. {claude_mpm-5.4.3.dist-info → claude_mpm-5.4.21.dist-info}/METADATA +47 -8
  54. {claude_mpm-5.4.3.dist-info → claude_mpm-5.4.21.dist-info}/RECORD +58 -82
  55. {claude_mpm-5.4.3.dist-info → claude_mpm-5.4.21.dist-info}/entry_points.txt +0 -3
  56. claude_mpm-5.4.21.dist-info/licenses/LICENSE +94 -0
  57. claude_mpm-5.4.21.dist-info/licenses/LICENSE-FAQ.md +153 -0
  58. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +0 -292
  59. claude_mpm/agents/BASE_DOCUMENTATION.md +0 -53
  60. claude_mpm/agents/BASE_ENGINEER.md +0 -658
  61. claude_mpm/agents/BASE_OPS.md +0 -219
  62. claude_mpm/agents/BASE_PM.md +0 -480
  63. claude_mpm/agents/BASE_PROMPT_ENGINEER.md +0 -787
  64. claude_mpm/agents/BASE_QA.md +0 -167
  65. claude_mpm/agents/BASE_RESEARCH.md +0 -53
  66. claude_mpm/agents/base_agent.json +0 -31
  67. claude_mpm/agents/base_agent_loader.py +0 -601
  68. claude_mpm/cli/commands/agents_detect.py +0 -380
  69. claude_mpm/cli/commands/agents_recommend.py +0 -309
  70. claude_mpm/cli/ticket_cli.py +0 -35
  71. claude_mpm/commands/mpm-agents-auto-configure.md +0 -278
  72. claude_mpm/commands/mpm-agents-detect.md +0 -177
  73. claude_mpm/commands/mpm-agents-list.md +0 -131
  74. claude_mpm/commands/mpm-agents-recommend.md +0 -223
  75. claude_mpm/commands/mpm-config-view.md +0 -150
  76. claude_mpm/hooks/claude_hooks/__pycache__/__init__.cpython-313.pyc +0 -0
  77. claude_mpm/hooks/claude_hooks/__pycache__/correlation_manager.cpython-313.pyc +0 -0
  78. claude_mpm/hooks/claude_hooks/__pycache__/event_handlers.cpython-313.pyc +0 -0
  79. claude_mpm/hooks/claude_hooks/__pycache__/hook_handler.cpython-313.pyc +0 -0
  80. claude_mpm/hooks/claude_hooks/__pycache__/memory_integration.cpython-313.pyc +0 -0
  81. claude_mpm/hooks/claude_hooks/__pycache__/response_tracking.cpython-313.pyc +0 -0
  82. claude_mpm/hooks/claude_hooks/__pycache__/tool_analysis.cpython-313.pyc +0 -0
  83. claude_mpm/hooks/claude_hooks/services/__pycache__/__init__.cpython-313.pyc +0 -0
  84. claude_mpm/hooks/claude_hooks/services/__pycache__/connection_manager_http.cpython-313.pyc +0 -0
  85. claude_mpm/hooks/claude_hooks/services/__pycache__/duplicate_detector.cpython-313.pyc +0 -0
  86. claude_mpm/hooks/claude_hooks/services/__pycache__/state_manager.cpython-313.pyc +0 -0
  87. claude_mpm/hooks/claude_hooks/services/__pycache__/subagent_processor.cpython-313.pyc +0 -0
  88. claude_mpm-5.4.3.dist-info/licenses/LICENSE +0 -21
  89. {claude_mpm-5.4.3.dist-info → claude_mpm-5.4.21.dist-info}/WHEEL +0 -0
  90. {claude_mpm-5.4.3.dist-info → claude_mpm-5.4.21.dist-info}/top_level.txt +0 -0
@@ -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
@@ -1,150 +0,0 @@
1
- ---
2
- namespace: mpm/config
3
- command: view
4
- aliases: [mpm-config-view]
5
- migration_target: /mpm/config:view
6
- category: config
7
- deprecated_aliases: [mpm-config]
8
- description: View and validate Claude MPM configuration settings
9
- ---
10
- # View and validate claude-mpm configuration
11
-
12
- Manage Claude MPM configuration settings through validation, viewing, and status checks.
13
-
14
- ## Usage
15
-
16
- ```
17
- /mpm-config [subcommand] [options]
18
- ```
19
-
20
- ## Description
21
-
22
- This slash command provides access to Claude MPM's configuration management capabilities through the actual CLI commands.
23
-
24
- ## Available Subcommands
25
-
26
- ### Validate Configuration
27
- Validate configuration files for correctness and completeness.
28
-
29
- ```
30
- /mpm-config validate [--config-file PATH] [--strict] [--fix]
31
- ```
32
-
33
- **Options:**
34
- - `--config-file PATH`: Validate specific config file (default: all)
35
- - `--strict`: Use strict validation rules
36
- - `--fix`: Attempt to fix validation errors automatically
37
-
38
- **Example:**
39
- ```
40
- /mpm-config validate --strict
41
- /mpm-config validate --config-file .claude/config.yaml --fix
42
- ```
43
-
44
- ### View Configuration
45
- Display current configuration settings.
46
-
47
- ```
48
- /mpm-config view [--section SECTION] [--format FORMAT] [--show-defaults]
49
- ```
50
-
51
- **Options:**
52
- - `--section SECTION`: Specific configuration section to view
53
- - `--format FORMAT`: Output format (yaml, json, table)
54
- - `--show-defaults`: Include default values in output
55
-
56
- **Examples:**
57
- ```
58
- /mpm-config view
59
- /mpm-config view --section agents --format json
60
- /mpm-config view --show-defaults
61
- ```
62
-
63
- ### Configuration Status
64
- Show configuration health and status.
65
-
66
- ```
67
- /mpm-config status [--verbose]
68
- ```
69
-
70
- **Options:**
71
- - `--verbose`: Show detailed status information
72
-
73
- **Example:**
74
- ```
75
- /mpm-config status --verbose
76
- ```
77
-
78
- ## Implementation
79
-
80
- This command executes:
81
- ```bash
82
- claude-mpm config [subcommand] [options]
83
- ```
84
-
85
- The slash command passes through to the actual CLI configuration management system.
86
-
87
- ## Configuration Categories
88
-
89
- Configuration is organized into sections:
90
-
91
- - **agents**: Agent deployment and management settings
92
- - **memory**: Memory system configuration
93
- - **websocket**: WebSocket server settings (port, host)
94
- - **hooks**: Hook service configuration
95
- - **logging**: Logging levels and output
96
- - **tickets**: Ticket tracking settings
97
- - **monitor**: Dashboard and monitoring settings
98
-
99
- ## Expected Output
100
-
101
- ### Validation Output
102
- ```
103
- Validating configuration files...
104
-
105
- ✓ .claude/config.yaml: Valid
106
- ✓ .claude/agents/config.yaml: Valid
107
- ✓ Configuration schema: Valid
108
-
109
- Configuration is valid and ready to use.
110
- ```
111
-
112
- ### View Output
113
- ```yaml
114
- agents:
115
- deploy_mode: project
116
- auto_reload: true
117
-
118
- websocket:
119
- host: localhost
120
- port: 8765
121
-
122
- logging:
123
- level: INFO
124
- format: detailed
125
- ```
126
-
127
- ### Status Output
128
- ```
129
- Configuration Status
130
- ====================
131
-
132
- Files Found: 2
133
- ✓ .claude/config.yaml
134
- ✓ .claude/agents/config.yaml
135
-
136
- Validation: Passed
137
- Schema Version: 4.5
138
- Last Modified: 2025-01-15 14:30:22
139
-
140
- Active Settings:
141
- - WebSocket Port: 8765
142
- - Agent Deploy Mode: project
143
- - Logging Level: INFO
144
- ```
145
-
146
- ## Related Commands
147
-
148
- - `/mpm-status`: Show overall system status
149
- - `/mpm-doctor`: Diagnose configuration issues
150
- - `/mpm-init`: Initialize project configuration
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Claude MPM Team
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.