claude-mpm 3.8.1__py3-none-any.whl → 3.9.2__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.
Files changed (33) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/agents/BASE_AGENT_TEMPLATE.md +59 -135
  3. claude_mpm/agents/MEMORY.md +39 -30
  4. claude_mpm/agents/WORKFLOW.md +54 -4
  5. claude_mpm/agents/agents_metadata.py +25 -1
  6. claude_mpm/agents/schema/agent_schema.json +1 -1
  7. claude_mpm/agents/templates/backup/research_agent_2025011_234551.json +88 -0
  8. claude_mpm/agents/templates/project_organizer.json +178 -0
  9. claude_mpm/agents/templates/research.json +33 -30
  10. claude_mpm/agents/templates/ticketing.json +3 -3
  11. claude_mpm/cli/commands/agents.py +8 -3
  12. claude_mpm/core/claude_runner.py +31 -10
  13. claude_mpm/core/config.py +2 -2
  14. claude_mpm/core/container.py +96 -25
  15. claude_mpm/core/framework_loader.py +43 -1
  16. claude_mpm/core/interactive_session.py +47 -0
  17. claude_mpm/hooks/claude_hooks/hook_handler_fixed.py +454 -0
  18. claude_mpm/services/agents/deployment/agent_deployment.py +144 -43
  19. claude_mpm/services/agents/memory/agent_memory_manager.py +4 -3
  20. claude_mpm/services/framework_claude_md_generator/__init__.py +10 -3
  21. claude_mpm/services/framework_claude_md_generator/deployment_manager.py +14 -11
  22. claude_mpm/services/response_tracker.py +3 -5
  23. claude_mpm/services/ticket_manager.py +2 -2
  24. claude_mpm/services/ticket_manager_di.py +1 -1
  25. claude_mpm/services/version_control/semantic_versioning.py +80 -7
  26. claude_mpm/services/version_control/version_parser.py +528 -0
  27. claude_mpm-3.9.2.dist-info/METADATA +200 -0
  28. {claude_mpm-3.8.1.dist-info → claude_mpm-3.9.2.dist-info}/RECORD +32 -28
  29. claude_mpm-3.8.1.dist-info/METADATA +0 -327
  30. {claude_mpm-3.8.1.dist-info → claude_mpm-3.9.2.dist-info}/WHEEL +0 -0
  31. {claude_mpm-3.8.1.dist-info → claude_mpm-3.9.2.dist-info}/entry_points.txt +0 -0
  32. {claude_mpm-3.8.1.dist-info → claude_mpm-3.9.2.dist-info}/licenses/LICENSE +0 -0
  33. {claude_mpm-3.8.1.dist-info → claude_mpm-3.9.2.dist-info}/top_level.txt +0 -0
@@ -1,327 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: claude-mpm
3
- Version: 3.8.1
4
- Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
5
- Home-page: https://github.com/bobmatnyc/claude-mpm
6
- Author: Claude MPM Team
7
- Author-email: bob@matsuoka.com
8
- License: MIT
9
- Keywords: claude,orchestration,multi-agent,ticket-management
10
- Classifier: Development Status :: 3 - Alpha
11
- Classifier: Intended Audience :: Developers
12
- Classifier: License :: OSI Approved :: MIT License
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Programming Language :: Python :: 3.8
15
- Classifier: Programming Language :: Python :: 3.9
16
- Classifier: Programming Language :: Python :: 3.10
17
- Classifier: Programming Language :: Python :: 3.11
18
- Classifier: Programming Language :: Python :: 3.12
19
- Requires-Python: >=3.8
20
- Description-Content-Type: text/markdown
21
- License-File: LICENSE
22
- Requires-Dist: ai-trackdown-pytools>=1.4.0
23
- Requires-Dist: pyyaml>=6.0
24
- Requires-Dist: python-dotenv>=0.19.0
25
- Requires-Dist: click>=8.0.0
26
- Requires-Dist: pexpect>=4.8.0
27
- Requires-Dist: psutil>=5.9.0
28
- Requires-Dist: requests>=2.25.0
29
- Requires-Dist: flask>=3.0.0
30
- Requires-Dist: flask-cors>=4.0.0
31
- Requires-Dist: watchdog>=3.0.0
32
- Requires-Dist: tree-sitter>=0.21.0
33
- Requires-Dist: python-socketio>=5.11.0
34
- Requires-Dist: aiohttp>=3.9.0
35
- Requires-Dist: aiohttp-cors>=0.8.0
36
- Requires-Dist: python-engineio>=4.8.0
37
- Requires-Dist: python-frontmatter>=1.0.0
38
- Requires-Dist: mistune>=3.0.0
39
- Requires-Dist: aiofiles>=23.0.0
40
- Provides-Extra: dev
41
- Requires-Dist: pytest>=7.0; extra == "dev"
42
- Requires-Dist: pytest-asyncio; extra == "dev"
43
- Requires-Dist: pytest-cov; extra == "dev"
44
- Requires-Dist: black; extra == "dev"
45
- Requires-Dist: flake8; extra == "dev"
46
- Requires-Dist: mypy; extra == "dev"
47
- Provides-Extra: monitor
48
- Provides-Extra: agents
49
- Requires-Dist: bandit>=1.7.5; extra == "agents"
50
- Requires-Dist: black>=23.0.0; extra == "agents"
51
- Requires-Dist: commitizen>=3.13.0; extra == "agents"
52
- Requires-Dist: dask>=2023.12.0; extra == "agents"
53
- Requires-Dist: detect-secrets>=1.4.0; extra == "agents"
54
- Requires-Dist: diagrams>=0.23.0; extra == "agents"
55
- Requires-Dist: docstring-parser>=0.15.0; extra == "agents"
56
- Requires-Dist: faker>=20.0.0; extra == "agents"
57
- Requires-Dist: gitlint>=0.19.0; extra == "agents"
58
- Requires-Dist: gitpython>=3.1.40; extra == "agents"
59
- Requires-Dist: hypothesis>=6.92.0; extra == "agents"
60
- Requires-Dist: isort>=5.12.0; extra == "agents"
61
- Requires-Dist: lizard>=1.17.0; extra == "agents"
62
- Requires-Dist: mermaid-py>=0.2.0; extra == "agents"
63
- Requires-Dist: mkdocs>=1.5.0; extra == "agents"
64
- Requires-Dist: mutmut>=2.4.0; extra == "agents"
65
- Requires-Dist: mypy>=1.8.0; extra == "agents"
66
- Requires-Dist: pandas>=2.1.0; extra == "agents"
67
- Requires-Dist: pre-commit>=3.5.0; extra == "agents"
68
- Requires-Dist: prometheus-client>=0.19.0; extra == "agents"
69
- Requires-Dist: pydoc-markdown>=4.8.0; extra == "agents"
70
- Requires-Dist: pydriller>=2.5.0; extra == "agents"
71
- Requires-Dist: pygments>=2.17.0; extra == "agents"
72
- Requires-Dist: pytest>=7.4.0; extra == "agents"
73
- Requires-Dist: pytest-benchmark>=4.0.0; extra == "agents"
74
- Requires-Dist: pytest-cov>=4.1.0; extra == "agents"
75
- Requires-Dist: radon>=6.0.0; extra == "agents"
76
- Requires-Dist: rope>=1.11.0; extra == "agents"
77
- Requires-Dist: sphinx>=7.2.0; extra == "agents"
78
- Requires-Dist: sqlalchemy>=2.0.0; extra == "agents"
79
- Requires-Dist: sqlparse>=0.4.4; extra == "agents"
80
- Requires-Dist: tree-sitter>=0.21.0; extra == "agents"
81
- Requires-Dist: tree-sitter-python>=0.21.0; extra == "agents"
82
- Requires-Dist: tree-sitter-javascript>=0.21.0; extra == "agents"
83
- Requires-Dist: tree-sitter-typescript>=0.21.0; extra == "agents"
84
- Requires-Dist: tree-sitter-go>=0.21.0; extra == "agents"
85
- Requires-Dist: tree-sitter-rust>=0.21.0; extra == "agents"
86
- Requires-Dist: tree-sitter-java>=0.21.0; extra == "agents"
87
- Requires-Dist: tree-sitter-cpp>=0.21.0; extra == "agents"
88
- Requires-Dist: tree-sitter-c>=0.21.0; extra == "agents"
89
- Requires-Dist: tree-sitter-ruby>=0.21.0; extra == "agents"
90
- Requires-Dist: tree-sitter-php>=0.21.0; extra == "agents"
91
- Dynamic: author-email
92
- Dynamic: home-page
93
- Dynamic: license-file
94
- Dynamic: requires-python
95
-
96
- # Claude MPM - Multi-Agent Project Manager
97
-
98
- A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
99
-
100
- > **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
101
-
102
- ## Features
103
-
104
- - 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
105
- - 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
106
- - 🔄 **Session Management**: Resume previous sessions with `--resume`
107
- - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
108
- - 📁 **Multi-Project Support**: Per-session working directories
109
- - 🔍 **Git Integration**: View diffs and track changes across projects
110
- - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
111
-
112
- ## Installation
113
-
114
- ```bash
115
- # Basic installation - pure Python, no compilation required
116
- pip install claude-mpm
117
-
118
- # Install with development dependencies
119
- pip install "claude-mpm[dev]"
120
-
121
- # Install with agent dependencies - pure Python tools
122
- pip install "claude-mpm[agents]"
123
-
124
- # Install with all optional dependencies
125
- pip install "claude-mpm[agents,dev]"
126
- ```
127
-
128
- All dependencies are pure Python - no Rust or compilation required. The `agents` dependency group includes tools for testing, code analysis, documentation, and development workflows.
129
-
130
- ## Basic Usage
131
-
132
- ```bash
133
- # Interactive mode (recommended)
134
- claude-mpm
135
-
136
- # Non-interactive with task
137
- claude-mpm run -i "analyze this codebase" --non-interactive
138
-
139
- # With monitoring dashboard
140
- claude-mpm run --monitor
141
-
142
- # Resume last session
143
- claude-mpm run --resume
144
- ```
145
-
146
- ### Agent Management
147
-
148
- ```bash
149
- # View agent hierarchy and precedence
150
- claude-mpm agents list --by-tier
151
-
152
- # Inspect specific agent configuration
153
- claude-mpm agents view engineer
154
-
155
- # Fix agent configuration issues
156
- claude-mpm agents fix --all --dry-run
157
- ```
158
-
159
- For detailed usage, see [QUICKSTART.md](QUICKSTART.md)
160
-
161
- ### Agent Dependencies
162
-
163
- Claude MPM automatically manages Python dependencies required by agents. All dependencies are pure Python packages that don't require compilation. Agents can declare their dependencies in their configuration files, and the system aggregates them for easy installation.
164
-
165
- ```bash
166
- # Install all agent dependencies (pure Python)
167
- pip install "claude-mpm[agents]"
168
-
169
- # View current agent dependencies
170
- python scripts/aggregate_agent_dependencies.py --dry-run
171
-
172
- # Update pyproject.toml with latest agent dependencies
173
- python scripts/aggregate_agent_dependencies.py
174
- ```
175
-
176
- **Agent developers** can declare dependencies in their agent configurations:
177
-
178
- ```json
179
- {
180
- "agent_id": "my_agent",
181
- "dependencies": {
182
- "python": ["pandas>=2.0.0", "numpy>=1.24.0"],
183
- "system": ["ripgrep", "git"]
184
- }
185
- }
186
- ```
187
-
188
- Dependencies are automatically aggregated from all agent sources (PROJECT > USER > SYSTEM) during the build process, with intelligent version conflict resolution taking the highest compatible version.
189
-
190
- For comprehensive documentation, see [docs/AGENT_DEPENDENCIES.md](docs/AGENT_DEPENDENCIES.md).
191
-
192
- ## Architecture
193
-
194
- Claude MPM v3.7.8+ features a **modern service-oriented architecture** with:
195
-
196
- ### Service Layer Organization
197
- - **Core Services**: Foundation interfaces and dependency injection
198
- - **Agent Services**: Agent lifecycle, deployment, and management
199
- - **Communication Services**: Real-time WebSocket and SocketIO
200
- - **Project Services**: Project analysis and workspace management
201
- - **Infrastructure Services**: Logging, monitoring, and error handling
202
-
203
- ### Key Architectural Features
204
- - **Interface-Based Design**: All services implement well-defined contracts
205
- - **Dependency Injection**: Loose coupling through service container
206
- - **Lazy Loading**: Performance optimization with deferred initialization
207
- - **Multi-Level Caching**: Intelligent caching with TTL and invalidation
208
- - **Security Framework**: Input validation, path sanitization, and secure operations
209
-
210
- For detailed architecture information, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
211
-
212
- ## Key Capabilities
213
-
214
- ### Multi-Agent Orchestration
215
- The PM agent automatically delegates work to specialized agents:
216
- - **Research**: Codebase analysis and investigation
217
- - **Engineer**: Implementation and coding
218
- - **QA**: Testing and validation
219
- - **Documentation**: Docs and guides
220
- - **Security**: Security analysis
221
- - **Ops**: Deployment and infrastructure
222
- - **Data Engineer**: Data pipelines and AI integrations
223
- - **Test Integration**: E2E testing and cross-system validation
224
- - **Version Control**: Git workflows and release management
225
-
226
- **Three-Tier Agent System**: PROJECT > USER > SYSTEM precedence allows project-specific agent customization while maintaining fallbacks. Use `claude-mpm agents list --by-tier` to see the active agent hierarchy.
227
-
228
- ### Session Management
229
- - All work is tracked in persistent sessions
230
- - Resume any session with `--resume`
231
- - Switch between projects with per-session directories
232
- - View session history and activity
233
-
234
- ### Agent Memory System
235
- Agents learn and improve over time with persistent memory:
236
- - **Project-Specific Knowledge**: Automatically analyzes your codebase to understand patterns
237
- - **Continuous Learning**: Agents remember insights across sessions
238
- - **Memory Management**: Initialize, optimize, and manage agent memories
239
- - **Quick Initialization**: Use `/mpm memory init` to scan project and create memories
240
-
241
- ```bash
242
- # Initialize project-specific memories
243
- claude-mpm memory init
244
-
245
- # View memory status
246
- claude-mpm memory status
247
-
248
- # Add specific learning
249
- claude-mpm memory add engineer pattern "Always use async/await for I/O"
250
-
251
- # Start with monitoring dashboard
252
- claude-mpm run --monitor
253
- ```
254
-
255
- See [docs/MEMORY.md](docs/MEMORY.md) for comprehensive memory system documentation.
256
-
257
- ### Real-Time Monitoring
258
- The `--monitor` flag opens a web dashboard showing:
259
- - Live agent activity and delegations
260
- - File operations with git diff viewer
261
- - Tool usage and results
262
- - Session management UI
263
-
264
- See [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for full monitoring guide.
265
-
266
-
267
- ## Documentation
268
-
269
- ### User Documentation
270
- - **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
271
- - **[Agent Memory System](docs/MEMORY.md)** - Comprehensive memory documentation
272
- - **[Monitoring Dashboard](docs/developer/11-dashboard/README.md)** - Real-time monitoring features
273
- - **[User Guide](docs/user/)** - Detailed usage documentation
274
-
275
- ### Developer Documentation
276
- - **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
277
- - **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
278
- - **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
279
- - **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
280
- - **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
281
- - **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
282
- - **[Project Structure](docs/STRUCTURE.md)** - Codebase organization
283
- - **[Deployment Guide](docs/DEPLOY.md)** - Publishing and versioning
284
- - **[Developer Guide](docs/developer/)** - API reference and internals
285
-
286
- ## Recent Updates (v3.7.8)
287
-
288
- ### TSK-0053: Service Layer Architecture Refactoring
289
- - **Service-Oriented Architecture**: Complete redesign with five service domains
290
- - **Interface-Based Contracts**: All services implement explicit interfaces
291
- - **Dependency Injection System**: Service container with automatic dependency resolution
292
- - **Performance Optimizations**: Lazy loading, multi-level caching, connection pooling
293
- - **Security Framework**: Input validation, path traversal prevention, secure operations
294
- - **Backward Compatibility**: Lazy imports maintain existing import paths
295
-
296
- ### Key Improvements
297
- - **50-80% Performance Improvement**: Optimized caching and lazy loading
298
- - **Enhanced Security**: Comprehensive input validation and sanitization
299
- - **Better Testability**: Interface-based architecture enables easy mocking
300
- - **Improved Maintainability**: Clear separation of concerns and service boundaries
301
- - **Developer Experience**: Rich documentation and migration guides
302
-
303
- ### Architecture Benefits
304
- - **Scalability**: Service-oriented design supports future growth
305
- - **Extensibility**: Plugin architecture through interfaces and hooks
306
- - **Reliability**: Comprehensive testing with 85%+ coverage
307
- - **Security**: Defense-in-depth security architecture
308
- - **Performance**: Intelligent caching and resource optimization
309
-
310
- See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
311
-
312
- ## Development
313
-
314
- ### Contributing
315
- Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
316
-
317
- ### Project Structure
318
- See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
319
-
320
- ### License
321
- MIT License - see [LICENSE](LICENSE) file.
322
-
323
- ## Credits
324
-
325
- - Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
326
- - Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
327
- - Built with ❤️ by the Claude MPM community