claude-mpm 4.1.14__py3-none-any.whl → 4.1.17__py3-none-any.whl

claude_mpm/commands/mpm-tickets.md

@@ -0,0 +1,102 @@
+# mpm-tickets
+
+Create and manage tickets using aitrackdown
+
+## Usage
+
+Use this command to create and manage tickets (epics, issues, tasks) through aitrackdown CLI integration.
+
+## Commands
+
+### Create tickets
+```bash
+# Create an epic
+aitrackdown create epic "Title" --description "Description"
+
+# Create an issue  
+aitrackdown create issue "Title" --description "Description"
+
+# Create a task
+aitrackdown create task "Title" --description "Description"
+
+# Create task under an issue
+aitrackdown create task "Title" --issue ISS-0001
+```
+
+### View tickets
+```bash
+# Show all tasks
+aitrackdown status tasks
+
+# Show specific ticket
+aitrackdown show ISS-0001
+```
+
+### Update tickets
+```bash
+# Change status
+aitrackdown transition ISS-0001 in-progress
+aitrackdown transition ISS-0001 done
+
+# Add comment
+aitrackdown comment ISS-0001 "Your comment"
+```
+
+### Search tickets
+```bash
+aitrackdown search tasks "keyword"
+```
+
+## Ticket Types
+
+- **EP-XXXX**: Epics (major initiatives)
+- **ISS-XXXX**: Issues (bugs, features, user requests)  
+- **TSK-XXXX**: Tasks (individual work items)
+
+## Workflow States
+
+Valid transitions:
+- `open` → `in-progress` → `ready` → `tested` → `done`
+- Any state → `waiting` (when blocked)
+- Any state → `closed` (to close)
+
+## Examples
+
+### Bug Report Flow
+```bash
+# Create issue for bug
+aitrackdown create issue "Login bug" --description "Users can't login" --severity high
+
+# Create investigation task
+aitrackdown create task "Investigate login bug" --issue ISS-0001
+
+# Update status
+aitrackdown transition TSK-0001 in-progress
+aitrackdown comment TSK-0001 "Found the issue"
+
+# Complete
+aitrackdown transition TSK-0001 done
+aitrackdown transition ISS-0001 done
+```
+
+### Feature Implementation
+```bash
+# Create epic
+aitrackdown create epic "OAuth2 Support"
+
+# Create issues
+aitrackdown create issue "Google OAuth2" --description "Add Google auth"
+aitrackdown create issue "GitHub OAuth2" --description "Add GitHub auth"
+
+# Create tasks
+aitrackdown create task "Design OAuth flow" --issue ISS-0001
+aitrackdown create task "Implement Google client" --issue ISS-0001
+```
+
+## Tips
+
+- Always use aitrackdown directly (not claude-mpm tickets)
+- Check ticket exists with `show` before updating
+- Add comments to document progress
+- Use `--severity` for bugs, `--priority` for features
+- Associate tasks with issues using `--issue`

claude_mpm/commands/mpm.md

@@ -0,0 +1,19 @@
+# Claude MPM - Multi-Agent Project Manager
+
+Access Claude MPM functionality and manage your multi-agent orchestration.
+
+Available MPM commands:
+- /mpm-agents - Show available agents and versions
+- /mpm-doctor - Run diagnostic checks
+- /mpm-help - Show command help
+- /mpm-status - Show MPM status
+- /mpm-config - Manage configuration
+
+Claude MPM extends Claude Code with:
+- Multi-agent orchestration
+- Project-specific PM instructions
+- Agent memory management
+- WebSocket monitoring
+- Hook system for automation
+
+For more information, use /mpm-help [command]

claude_mpm/dashboard/__init__.py

@@ -0,0 +1,12 @@
+"""
+Dashboard package for Claude MPM.
+
+This package contains the web-based dashboard components for Claude MPM,
+including the analysis runner, dashboard opener, and static web assets.
+
+The dashboard provides real-time monitoring, analysis visualization, and
+interactive debugging capabilities for Claude MPM operations.
+
+This __init__.py file is required to make this directory recognizable as a
+Python package by setuptools for proper distribution and imports.
+"""

claude_mpm/dashboard/static/css/activity.css

@@ -261,6 +261,14 @@
     flex-shrink: 0;
 }
 
+.tree-status-icon {
+    font-size: 14px;
+    width: 18px;
+    text-align: center;
+    flex-shrink: 0;
+    margin-left: 2px;
+}
+
 .tree-expand-icon {
     font-size: 12px;
     width: 16px;
@@ -470,6 +478,7 @@ body .activity-tree-container .linear-tree .tree-node.tool.status-in_progress,
     background: #e6fffa !important;
     border-left-color: #38b2ac !important;
     border-left-width: 3px !important;
+    animation: pulse-tool 2s infinite;
 }
 
 body .activity-tree-container .linear-tree .tree-node.tool.status-completed,
@@ -486,6 +495,43 @@ body .activity-tree-container .linear-tree .tree-node.tool.status-failed,
     border-left-width: 2px !important;
 }
 
+/* Tool Status Icons */
+.tree-node.tool .tree-status-icon {
+    color: #718096;
+}
+
+.tree-node.tool.status-in_progress .tree-status-icon {
+    color: #38b2ac;
+    animation: spin 2s linear infinite;
+}
+
+.tree-node.tool.status-completed .tree-status-icon {
+    color: #38a169;
+}
+
+.tree-node.tool.status-failed .tree-status-icon {
+    color: #e53e3e;
+}
+
+/* Spinning animation for in-progress tools */
+@keyframes spin {
+    0% { transform: rotate(0deg); }
+    100% { transform: rotate(360deg); }
+}
+
+/* Pulse animation for in-progress tools */
+@keyframes pulse-tool {
+    0% {
+        background: #e6fffa !important;
+    }
+    50% {
+        background: #b2f5ea !important;
+    }
+    100% {
+        background: #e6fffa !important;
+    }
+}
+
 /* Privileged Tool (TodoWrite) - High Specificity */
 body .activity-tree-container .linear-tree .tree-node.tool.privileged-tool,
 .tree-node.tool.privileged-tool {
@@ -523,6 +569,7 @@ body .activity-tree-container .linear-tree .tree-node.tool.privileged-tool .tree
     background: #e6fffa !important;
     border-left-color: #38b2ac !important;
     border-left-width: 3px !important;
+    animation: pulse-tool 2s infinite;
 }
 
 .tree-node.tool:not(.privileged-tool).status-completed {
@@ -612,6 +659,44 @@ body .activity-tree-container .linear-tree .tree-node.tool.privileged-tool .tree
     }
 }
 
+/* Pinned TODOs Styles */
+.tree-node.pinned-todos {
+    background: linear-gradient(135deg, #fff8dc 0%, #f0e68c 100%) !important;
+    border-left: 4px solid #daa520 !important;
+    border-radius: 6px !important;
+    margin: 4px 0 !important;
+    font-weight: 600 !important;
+}
+
+.tree-node.pinned-todos:hover {
+    background: linear-gradient(135deg, #f0e68c 0%, #daa520 100%) !important;
+    box-shadow: 0 4px 8px rgba(218, 165, 32, 0.3) !important;
+}
+
+.tree-node.pinned-todos .tree-label {
+    color: #b8860b !important;
+    font-weight: bold !important;
+}
+
+.tree-node.pinned-todos .tree-icon {
+    color: #daa520 !important;
+    font-size: 18px !important;
+}
+
+.tree-node.pinned-todos .tree-params {
+    background: #f5deb3 !important;
+    color: #8b4513 !important;
+    font-weight: 600 !important;
+    border: 1px solid #daa520 !important;
+}
+
+.tree-node.pinned-todos .tree-status {
+    background: #daa520 !important;
+    color: white !important;
+    font-weight: bold !important;
+    text-transform: uppercase !important;
+}
+
 /* Tree Legend */
 .tree-legend {
     position: absolute;
@@ -1518,4 +1603,84 @@ body .activity-tree-container .linear-tree .tree-node.tool.privileged-tool .tree
 .tree-expand-icon:focus {
     outline: 2px solid #4299e1;
     outline-offset: 2px;
+}
+
+/* Active/current item highlighting */
+.tree-node.current-active {
+    background: linear-gradient(90deg, rgba(245, 158, 11, 0.1) 0%, transparent 100%);
+    border-left: 3px solid #f59e0b;
+    animation: pulse-active 2s ease-in-out infinite;
+}
+
+.tree-node.has-active .tree-node-content {
+    font-weight: 600;
+}
+
+.tree-node.todowrite.has-active .tree-icon {
+    animation: rotate-icon 3s linear infinite;
+}
+
+@keyframes pulse-active {
+    0%, 100% {
+        background: linear-gradient(90deg, rgba(245, 158, 11, 0.1) 0%, transparent 100%);
+    }
+    50% {
+        background: linear-gradient(90deg, rgba(245, 158, 11, 0.2) 0%, transparent 100%);
+    }
+}
+
+@keyframes rotate-icon {
+    from {
+        transform: rotate(0deg);
+    }
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+/* Collapsed state indicators */
+.tree-node.agent:not(.expanded) .tree-label {
+    font-style: italic;
+    color: #4b5563;
+}
+
+.tree-node.agent .tree-label .current-status {
+    color: #f59e0b;
+    font-weight: 600;
+    margin-left: 10px;
+}
+
+/* TodoWrite specific styles */
+.tree-node.todowrite {
+    background: rgba(99, 102, 241, 0.05);
+    border-radius: 4px;
+    margin: 2px 0;
+}
+
+.tree-node.todowrite .tree-node-content {
+    padding: 4px 8px;
+}
+
+/* Multiple call/update indicators */
+.tree-node .tree-label .call-count,
+.tree-node .tree-label .update-count {
+    color: #6366f1;
+    font-weight: 600;
+    font-size: 0.85em;
+    opacity: 0.8;
+}
+
+.tree-node.tool .tree-label {
+    position: relative;
+}
+
+.tree-node.tool .call-indicator {
+    display: inline-block;
+    background: #f59e0b;
+    color: white;
+    border-radius: 10px;
+    padding: 0 6px;
+    font-size: 0.75em;
+    margin-left: 5px;
+    font-weight: 600;
 }

claude_mpm/dashboard/static/css/dashboard.css

@@ -661,8 +661,8 @@ label {
 }
 
 .status-pending {
-    background: #fed7d7;
-    color: #742a2a;
+    background: #f3f4f6;
+    color: #4b5563;
     padding: 2px 6px;
     border-radius: 4px;
     font-size: 11px;
@@ -2779,13 +2779,15 @@ button:disabled:hover {
 }
 
 .tool-phase.pre_tool {
-    background: #fef3c7;
-    color: #92400e;
+    background: #f0f9ff;
+    color: #0369a1;
+    border: 1px solid #bae6fd;
 }
 
 .tool-phase.post_tool {
     background: #d1fae5;
     color: #065f46;
+    border: 1px solid #a7f3d0;
 }
 
 .tool-timestamp {
@@ -2838,8 +2840,9 @@ button:disabled:hover {
 }
 
 .tool-status-indicator.status-blocked {
-    background: #fef3c7;
-    color: #d97706;
+    background: #fef2f2;
+    color: #dc2626;
+    border: 1px solid #fecaca;
 }
 
 .tool-status-indicator.status-running {
@@ -2909,9 +2912,9 @@ button:disabled:hover {
 }
 
 .tool-result-status.tool-blocked {
-    background: #fef3c7;
-    color: #92400e;
-    border: 1px solid #fde68a;
+    background: #fff1f2;
+    color: #be123c;
+    border: 1px solid #fecdd3;
 }
 
 .tool-result-status.tool-running {
@@ -3686,8 +3689,8 @@ button:disabled:hover {
 }
 
 .status-pending {
-    background: #faf089;
-    color: #744210;
+    background: #f3f4f6;
+    color: #4b5563;
 }
 
 .agent-event-details {
@@ -3942,8 +3945,8 @@ button:disabled:hover {
 }
 
 .status-count.pending {
-    background: #faf089;
-    color: #744210;
+    background: #f3f4f6;
+    color: #4b5563;
 }
 
 .todo-list {
@@ -3973,8 +3976,8 @@ button:disabled:hover {
 }
 
 .todo-item.pending {
-    border-left-color: #d69e2e;
-    background: #fffbeb;
+    border-left-color: #9ca3af;
+    background: #f9fafb;
 }
 
 .todo-icon {