claude-mpm 3.7.4__py3-none-any.whl → 3.7.8__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 (48) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/agents/INSTRUCTIONS.md +18 -0
  3. claude_mpm/agents/schema/agent_schema.json +1 -1
  4. claude_mpm/agents/templates/code_analyzer.json +26 -11
  5. claude_mpm/agents/templates/data_engineer.json +3 -6
  6. claude_mpm/agents/templates/documentation.json +2 -2
  7. claude_mpm/agents/templates/engineer.json +1 -1
  8. claude_mpm/agents/templates/ops.json +3 -8
  9. claude_mpm/agents/templates/qa.json +2 -3
  10. claude_mpm/agents/templates/research.json +1 -2
  11. claude_mpm/agents/templates/security.json +2 -5
  12. claude_mpm/agents/templates/ticketing.json +3 -3
  13. claude_mpm/agents/templates/version_control.json +3 -3
  14. claude_mpm/agents/templates/web_qa.json +3 -3
  15. claude_mpm/agents/templates/web_ui.json +3 -3
  16. claude_mpm/cli/commands/agents.py +118 -1
  17. claude_mpm/cli/parser.py +11 -0
  18. claude_mpm/core/framework_loader.py +8 -7
  19. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +46 -2
  20. claude_mpm/dashboard/templates/index.html +5 -5
  21. claude_mpm/services/agents/deployment/agent_deployment.py +5 -1
  22. claude_mpm/services/agents/deployment/async_agent_deployment.py +5 -1
  23. claude_mpm/services/agents/management/agent_capabilities_generator.py +21 -11
  24. claude_mpm/services/ticket_manager.py +207 -44
  25. claude_mpm/utils/agent_dependency_loader.py +66 -15
  26. claude_mpm/utils/robust_installer.py +587 -0
  27. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/METADATA +17 -21
  28. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/RECORD +32 -47
  29. claude_mpm/.claude-mpm/logs/hooks_20250728.log +0 -10
  30. claude_mpm/agents/agent-template.yaml +0 -83
  31. claude_mpm/cli/README.md +0 -108
  32. claude_mpm/cli_module/refactoring_guide.md +0 -253
  33. claude_mpm/config/async_logging_config.yaml +0 -145
  34. claude_mpm/core/.claude-mpm/logs/hooks_20250730.log +0 -34
  35. claude_mpm/dashboard/.claude-mpm/memories/README.md +0 -36
  36. claude_mpm/dashboard/README.md +0 -121
  37. claude_mpm/dashboard/static/js/dashboard.js.backup +0 -1973
  38. claude_mpm/dashboard/templates/.claude-mpm/memories/README.md +0 -36
  39. claude_mpm/dashboard/templates/.claude-mpm/memories/engineer_agent.md +0 -39
  40. claude_mpm/dashboard/templates/.claude-mpm/memories/version_control_agent.md +0 -38
  41. claude_mpm/hooks/README.md +0 -96
  42. claude_mpm/schemas/agent_schema.json +0 -435
  43. claude_mpm/services/framework_claude_md_generator/README.md +0 -92
  44. claude_mpm/services/version_control/VERSION +0 -1
  45. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/WHEEL +0 -0
  46. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/entry_points.txt +0 -0
  47. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/licenses/LICENSE +0 -0
  48. {claude_mpm-3.7.4.dist-info → claude_mpm-3.7.8.dist-info}/top_level.txt +0 -0
@@ -1,145 +0,0 @@
1
- # Async Logging Configuration
2
- # Optimized logging configuration for high-performance scenarios
3
-
4
- logging:
5
- # Enable async logging for improved performance
6
- async:
7
- enabled: true
8
-
9
- # Log format options: json, syslog, journald
10
- format: json
11
-
12
- # Maximum queue size for async writes
13
- max_queue_size: 10000
14
-
15
- # Enable compression for JSON logs (reduces disk usage)
16
- compression: false
17
-
18
- # Worker threads for async processing
19
- worker_threads: 4
20
-
21
- # Flush timeout in seconds
22
- flush_timeout: 5.0
23
-
24
- # Session logger settings
25
- session:
26
- # Base directory for logs
27
- base_dir: ".claude-mpm/responses"
28
-
29
- # Use timestamp-based filenames (eliminates race conditions)
30
- timestamp_filenames: true
31
-
32
- # Include microseconds in timestamps for uniqueness
33
- microsecond_precision: true
34
-
35
- # Filename format with available variables:
36
- # {agent} - Agent name
37
- # {timestamp} - ISO timestamp
38
- # {microseconds} - Microsecond component
39
- # {session} - Session ID
40
- filename_format: "{agent}_{timestamp}_{microseconds}.json"
41
-
42
- # OS-native logging options (for extreme performance)
43
- syslog:
44
- # Syslog address (auto-detected by default)
45
- # address: /var/run/syslog # macOS
46
- # address: /dev/log # Linux
47
- # address: ["localhost", 514] # Network
48
-
49
- # Syslog facility
50
- facility: local0
51
-
52
- # Include structured data
53
- structured_data: true
54
-
55
- # Performance tuning
56
- performance:
57
- # Fire-and-forget mode (don't wait for write confirmation)
58
- fire_and_forget: true
59
-
60
- # Drop logs if queue is full (prevents blocking)
61
- drop_on_full: true
62
-
63
- # Batch writes for efficiency
64
- batch_writes: true
65
- batch_size: 10
66
- batch_timeout_ms: 100
67
-
68
- # Hook system optimization
69
- hooks:
70
- # Enable hook system
71
- enabled: true
72
-
73
- # Optimization settings
74
- optimization:
75
- # Cache hook configurations at startup
76
- cache_configs: true
77
-
78
- # Lazy load hook implementations
79
- lazy_loading: true
80
-
81
- # Use singleton pattern for hook service
82
- singleton: true
83
-
84
- # Enable async hook execution
85
- async_execution: true
86
-
87
- # Maximum workers for parallel hook execution
88
- max_workers: 4
89
-
90
- # Pre-delegation hooks
91
- pre_delegation:
92
- enabled: true
93
-
94
- # Parallel execution for independent hooks
95
- parallel_safe_hooks:
96
- - memory_context_hook
97
- - validation_hook
98
- - auth_hook
99
-
100
- # Post-delegation hooks
101
- post_delegation:
102
- enabled: true
103
-
104
- # Parallel execution for independent hooks
105
- parallel_safe_hooks:
106
- - logging_hook
107
- - metrics_hook
108
- - cleanup_hook
109
-
110
- # Registered hooks with lazy loading
111
- registered:
112
- # NOTE: The builtin hooks have been deprecated and removed
113
- # These references are kept commented for historical reference
114
- # memory_context_hook:
115
- # module: claude_mpm.hooks.builtin.memory_hooks
116
- # class: MemoryContextHook
117
- # priority: 10
118
- # enabled: true
119
- # params:
120
- # cache_size: 1000
121
- #
122
- # response_logger_hook:
123
- # module: claude_mpm.hooks.builtin.logging_hooks
124
- # class: ResponseLoggerHook
125
- # priority: 90
126
- # enabled: true
127
- # params:
128
- # async: true
129
- #
130
- # metrics_hook:
131
- # module: claude_mpm.hooks.builtin.metrics_hooks
132
- # class: MetricsCollectorHook
133
- # priority: 95
134
- # enabled: true
135
- # params:
136
- # buffer_size: 100
137
-
138
- # Environment variable overrides
139
- # These can override any setting above:
140
- #
141
- # CLAUDE_USE_ASYNC_LOG=true # Enable async logging
142
- # CLAUDE_LOG_FORMAT=syslog # Use syslog format
143
- # CLAUDE_LOG_SYNC=true # Disable async (for debugging)
144
- # CLAUDE_HOOKS_CACHE=true # Enable hook caching
145
- # CLAUDE_HOOKS_ASYNC=true # Enable async hooks
@@ -1,34 +0,0 @@
1
- 2025-07-30 12:40:20,992 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
2
- 2025-07-30 12:40:20,992 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Bash (exit code: N/A)
3
- 2025-07-30 12:40:33,117 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
4
- 2025-07-30 12:40:33,117 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Edit
5
- 2025-07-30 12:40:33,276 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
6
- 2025-07-30 12:40:33,276 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Edit (exit code: N/A)
7
- 2025-07-30 12:40:39,276 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
8
- 2025-07-30 12:40:39,276 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Bash
9
- 2025-07-30 12:40:39,541 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
10
- 2025-07-30 12:40:39,541 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Bash (exit code: N/A)
11
- 2025-07-30 12:40:48,610 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
12
- 2025-07-30 12:40:48,610 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Bash
13
- 2025-07-30 12:40:49,941 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
14
- 2025-07-30 12:40:49,941 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Bash (exit code: N/A)
15
- 2025-07-30 12:44:50,358 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: UserPromptSubmit (session: df539357)
16
- 2025-07-30 12:44:50,358 - claude_mpm_hooks_core - INFO - hook_handler.py:244 - UserPromptSubmit: OK. Let's make the subprocess the default method
17
- 2025-07-30 13:05:35,872 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: UserPromptSubmit (session: df539357)
18
- 2025-07-30 13:05:35,872 - claude_mpm_hooks_core - INFO - hook_handler.py:244 - UserPromptSubmit: actually leave as is. I want to figure out a simple test to trigger the terminal flow. Use docs/de...
19
- 2025-07-30 13:05:42,930 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
20
- 2025-07-30 13:05:42,930 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Read
21
- 2025-07-30 13:05:43,133 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
22
- 2025-07-30 13:05:43,133 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Read (exit code: N/A)
23
- 2025-07-30 13:05:49,996 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
24
- 2025-07-30 13:05:49,996 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Grep
25
- 2025-07-30 13:05:50,548 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
26
- 2025-07-30 13:05:50,548 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Grep (exit code: N/A)
27
- 2025-07-30 13:05:56,341 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
28
- 2025-07-30 13:05:56,341 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Read
29
- 2025-07-30 13:05:56,527 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PostToolUse (session: df539357)
30
- 2025-07-30 13:05:56,528 - claude_mpm_hooks_core - INFO - hook_handler.py:254 - PostToolUse: Read (exit code: N/A)
31
- 2025-07-30 13:06:01,890 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
32
- 2025-07-30 13:06:01,890 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Bash
33
- 2025-07-30 13:06:08,115 - claude_mpm_hooks_core - INFO - hook_handler.py:231 - Claude Code hook event: PreToolUse (session: df539357)
34
- 2025-07-30 13:06:08,115 - claude_mpm_hooks_core - INFO - hook_handler.py:247 - PreToolUse: Bash
@@ -1,36 +0,0 @@
1
- # Agent Memory System
2
-
3
- ## Purpose
4
- Each agent maintains project-specific knowledge in these files. Agents read their memory file before tasks and update it when they learn something new.
5
-
6
- ## Manual Editing
7
- Feel free to edit these files to:
8
- - Add project-specific guidelines
9
- - Remove outdated information
10
- - Reorganize for better clarity
11
- - Add domain-specific knowledge
12
-
13
- ## Memory Limits
14
- - Max file size: 8KB (~2000 tokens)
15
- - Max sections: 10
16
- - Max items per section: 15
17
- - Files auto-truncate when limits exceeded
18
-
19
- ## File Format
20
- Standard markdown with structured sections. Agents expect:
21
- - Project Architecture
22
- - Implementation Guidelines
23
- - Common Mistakes to Avoid
24
- - Current Technical Context
25
-
26
- ## How It Works
27
- 1. Agents read their memory file before starting tasks
28
- 2. Agents add learnings during or after task completion
29
- 3. Files automatically enforce size limits
30
- 4. Developers can manually edit for accuracy
31
-
32
- ## Memory File Lifecycle
33
- - Created automatically when agent first runs
34
- - Updated through hook system after delegations
35
- - Manually editable by developers
36
- - Version controlled with project
@@ -1,121 +0,0 @@
1
- # Claude MPM Web Dashboard
2
-
3
- This directory contains the modular web dashboard for Claude MPM monitoring and management.
4
-
5
- ## Structure
6
-
7
- ```
8
- src/claude_mpm/dashboard/
9
- ├── static/
10
- │ ├── css/
11
- │ │ └── dashboard.css # Main stylesheet
12
- │ └── js/
13
- │ ├── socket-client.js # Socket.IO connection management
14
- │ ├── dashboard.js # Main dashboard application
15
- │ └── components/
16
- │ ├── event-viewer.js # Event display and filtering
17
- │ ├── module-viewer.js # Event detail viewer
18
- │ └── session-manager.js # Session management
19
- ├── templates/
20
- │ └── index.html # Main dashboard HTML
21
- ├── index.html # Root index with redirect
22
- ├── test_dashboard.html # Test version for verification
23
- └── README.md # This file
24
- ```
25
-
26
- ## Components
27
-
28
- ### SocketClient (`socket-client.js`)
29
- - Manages WebSocket connections to the Claude MPM server
30
- - Handles event reception and processing
31
- - Provides callbacks for connection state changes
32
- - Maintains event history and session tracking
33
-
34
- ### EventViewer (`components/event-viewer.js`)
35
- - Displays events in a filterable list
36
- - Supports search, type filtering, and session filtering
37
- - Handles event selection and keyboard navigation
38
- - Updates metrics display (total events, events per minute, etc.)
39
-
40
- ### ModuleViewer (`components/module-viewer.js`)
41
- - Shows detailed information about selected events
42
- - Provides structured views for different event types
43
- - Displays raw JSON data for debugging
44
- - Organizes events by class/category
45
-
46
- ### SessionManager (`components/session-manager.js`)
47
- - Manages session selection and filtering
48
- - Updates session dropdown with available sessions
49
- - Tracks current active session
50
- - Updates footer information
51
-
52
- ### Dashboard (`dashboard.js`)
53
- - Main application coordinator
54
- - Handles tab switching between Events, Agents, Tools, and Files
55
- - Manages component interactions
56
- - Provides global functions for backward compatibility
57
-
58
- ## Features
59
-
60
- ### File-Centric Files Tab
61
- The Files tab now shows a file-centric view where:
62
- - Each file appears only once in the list
63
- - Files show read/write icons based on operations performed
64
- - Most recently accessed files appear at the bottom
65
- - Clicking a file shows all operations performed on it with timestamps and agent information
66
-
67
- ### Tab Organization
68
- - **Events**: All events with filtering and search
69
- - **Agents**: Agent-specific events and operations
70
- - **Tools**: Tool usage and parameters
71
- - **Files**: File operations organized by file path
72
-
73
- ### Enhanced Event Details
74
- - Structured views for different event types
75
- - Todo checklists with status indicators
76
- - Agent and tool information
77
- - Session tracking and filtering
78
-
79
- ## Usage
80
-
81
- ### Development
82
- For development and testing, use `test_dashboard.html` which includes module verification.
83
-
84
- ### Production
85
- Use `templates/dashboard.html` as the main template, ensuring all static files are served correctly.
86
-
87
- ### Integration
88
- The dashboard can be integrated into a Flask/FastAPI application by serving the static files and using the template.
89
-
90
- ## Migration from Original
91
-
92
- The original monolithic `claude_mpm_socketio_dashboard.html` has been replaced with a modular structure:
93
-
94
- 1. **CSS**: Extracted to `static/css/dashboard.css`
95
- 2. **JavaScript**: Split into logical modules in `static/js/`
96
- 3. **HTML**: Clean template in `templates/dashboard.html`
97
-
98
- All original functionality has been preserved while improving:
99
- - Code organization and maintainability
100
- - Module reusability
101
- - Easier debugging and development
102
- - Better separation of concerns
103
-
104
- ## Backward Compatibility
105
-
106
- Global functions are maintained for compatibility:
107
- - `connectSocket()`
108
- - `disconnectSocket()`
109
- - `clearEvents()`
110
- - `exportEvents()`
111
- - `clearSelection()`
112
- - `switchTab(tabName)`
113
-
114
- ## Browser Support
115
-
116
- Requires modern browsers with support for:
117
- - ES6 Classes
118
- - Fetch API
119
- - Custom Events
120
- - CSS Grid/Flexbox
121
- - Socket.IO 4.x