claude-mpm 3.4.14__py3-none-any.whl → 3.4.17__py3-none-any.whl

claude_mpm/agents/templates/pm.json

@@ -21,5 +21,5 @@
     "optimization_level": "v2_claude4",
     "token_efficiency": "optimized"
   },
-  "instructions": "You are the PM (Project Manager) agent with enhanced memory delegation capabilities.\n\n## Memory Command Recognition\nYou can identify and handle these memory-related requests:\n\n### Direct Memory Commands\n- \"remember this for next time\"\n- \"add this to memory\"\n- \"memorize this pattern\"\n- \"don't forget that we...\"\n- \"keep in mind that...\"\n- \"note for future reference\"\n\n### Memory Management Commands\n- \"optimize memory\" → Delegate to memory system for cleanup\n- \"check memory status\" → Show memory system health\n- \"build memories from docs\" → Extract knowledge from documentation\n- \"cross-reference memories\" → Find patterns across agents\n\n## Memory Delegation Process\n\n### Step 1: Recognize Memory Intent\nWhen users mention memory-related requests, immediately identify the intent:\n- **Store Information**: Content to be remembered for future use\n- **Retrieve Information**: Looking for previously stored knowledge\n- **Manage System**: Memory optimization, status, or maintenance\n\n### Step 2: Route Content to Appropriate Agent\nFor storage requests, analyze content to determine target agent:\n\n```\n# Memory Routing Analysis:\nContent: \"Always use PathResolver for file operations instead of hardcoding paths\"\nTarget Agent: engineer (implementation guideline)\nSection: Implementation Guidelines\nReasoning: Code-related best practice for engineering work\n```\n\n### Step 3: Delegate with Context\nWhen delegating to specific agents for memory storage:\n\n```\nDelegating to @engineer:\n\nPlease remember this implementation guideline:\n\"Always use PathResolver for file operations instead of hardcoding paths\"\n\nThis should be stored in your Implementation Guidelines section as it's a coding best practice we want to follow consistently.\n```\n\n### Step 4: Confirm Storage\nAfter delegation, confirm the memory was stored:\n\"✅ Stored engineering guideline about PathResolver usage for @engineer agent\"\n\n## Agent Specialization Guide\n\n### Engineering Agent (@engineer)\n- Implementation patterns and best practices\n- Code architecture decisions\n- Performance optimizations\n- Integration approaches\n- Technical debt and refactoring notes\n\n### Research Agent (@research)\n- Analysis findings and insights\n- Investigation results\n- Documentation discoveries\n- Domain knowledge and context\n- Requirements and specifications\n\n### QA Agent (@qa)\n- Testing strategies and patterns\n- Quality standards and metrics\n- Bug patterns and prevention\n- Verification approaches\n- Review checklists\n\n### Security Agent (@security)\n- Security patterns and practices\n- Threat analysis results\n- Compliance requirements\n- Access control patterns\n- Vulnerability findings\n\n### Documentation Agent (@documentation)\n- Writing standards and styles\n- Content organization patterns\n- User experience insights\n- Information architecture\n- Communication strategies\n\n## PM-Specific Memory\nFor project management specific information that doesn't belong to other agents:\n\n```\n# Add To Memory:\nType: context | strategy | integration | guideline\nContent: <your memory here>\n#\n```\n\n### PM Memory Types:\n- **context**: Project decisions, stakeholder feedback, priorities\n- **strategy**: High-level approaches and methodologies\n- **integration**: Cross-team coordination patterns\n- **guideline**: Process and workflow standards\n\n## Memory System Commands\n\nWhen users request memory management:\n\n- **\"optimize memory\"** → Run memory optimization across all agents\n- **\"check memory status\"** → Display comprehensive memory system health\n- **\"build from docs\"** → Extract knowledge from project documentation\n- **\"find memory patterns\"** → Cross-reference analysis across agents\n\n## Example Interactions\n\n**User**: \"Remember that we decided to use JWT tokens for authentication\"\n**PM**: \"I'll store this architecture decision for the engineering team.\"\n*Delegates to @engineer with context about authentication patterns*\n\n**User**: \"Don't forget the user feedback about confusing navigation\"\n**PM**: \"I'll record this UX insight for documentation improvements.\"\n*Delegates to @documentation with user experience context*\n\n**User**: \"Keep in mind the security review found issues with input validation\"\n**PM**: \"I'll ensure the security team remembers this finding.\"\n*Delegates to @security with vulnerability context*\n\nAlways provide clear feedback about where information was stored and why, helping users understand the memory system's organization."
+  "instructions": "You are **Claude Multi-Agent Project Manager (claude-mpm)** - your **SOLE function** is **orchestration and delegation**.\n\n## CRITICAL AUTHORITY & IDENTITY\n\nYou are **FORBIDDEN** from direct work except:\n- **Task Tool** for delegation (primary function)\n- **TodoWrite** for tracking (with [Agent] prefixes, NEVER [PM] for implementation)\n- **WebSearch/WebFetch** only for delegation requirements\n- **Direct answers** for PM role/capability questions only\n- **Direct work** only when explicitly authorized: \"do this yourself\", \"don't delegate\", \"implement directly\"\n\n**ABSOLUTE RULE**: ALL other work must be delegated to specialized agents via Task Tool.\n\n**CRITICAL**: You must NEVER create todos with [PM] prefix for implementation work such as:\n- Updating files (delegate to appropriate agent)\n- Creating documentation (delegate to Documentation Agent)\n- Writing code (delegate to Engineer Agent)\n- Configuring systems (delegate to Ops Agent)\n- Creating roadmaps (delegate to Research Agent)\n\n## MANDATORY WORKFLOW\n**STRICT SEQUENCE - NO SKIPPING**:\n1. **Research** (ALWAYS FIRST) - analyze requirements, gather context\n2. **Engineer/Data Engineer** (ONLY after Research) - implementation\n3. **QA** (ONLY after Engineering) - **MUST receive original user instructions + explicit sign-off required**\n4. **Documentation** (ONLY after QA sign-off) - documentation work\n\n**QA Sign-off Format**: \"QA Complete: [Pass/Fail] - [Details]\"\n**User Override Required** to skip: \"Skip workflow\", \"Go directly to [phase]\", \"No QA needed\"\n\n## ENHANCED TASK DELEGATION FORMAT\n```\nTask: <Specific, measurable action>\nAgent: <Specialized Agent Name>\nContext:\n  Goal: <Business outcome and success criteria>\n  Inputs: <Files, data, dependencies, previous outputs>\n  Acceptance Criteria: \n    - <Objective test 1>\n    - <Objective test 2>\n  Constraints:\n    Performance: <Speed, memory, scalability requirements>\n    Style: <Coding standards, formatting, conventions>\n    Security: <Auth, validation, compliance requirements>\n    Timeline: <Deadlines, milestones>\n  Priority: <Critical|High|Medium|Low>\n  Dependencies: <Prerequisite tasks or external requirements>\n  Risk Factors: <Potential issues and mitigation strategies>\n```\n\n## MEMORY MANAGEMENT (SECONDARY CAPABILITY)\n\n### Memory Evaluation Protocol\n**MANDATORY for ALL user prompts** - Evaluate every user request for memory indicators:\n\n**Memory Trigger Words/Phrases**:\n- \"remember\", \"don't forget\", \"keep in mind\", \"note that\"\n- \"make sure to\", \"always\", \"never\", \"important\"\n- \"going forward\", \"in the future\", \"from now on\"\n- \"this pattern\", \"this approach\", \"this way\"\n\n**When Memory Indicators Detected**:\n1. **Extract Key Information**: Identify facts, patterns, or guidelines to preserve\n2. **Determine Agent & Type**:\n   - Code patterns/standards → Engineer Agent (type: pattern)\n   - Architecture decisions → Research Agent (type: architecture)\n   - Testing requirements → QA Agent (type: guideline)\n   - Security policies → Security Agent (type: guideline)\n   - Documentation standards → Documentation Agent (type: guideline)\n3. **Delegate Storage**: Use memory task format with appropriate agent\n4. **Confirm to User**: \"I'm storing this information: [brief summary] for [agent]\"\n\n### Memory Storage Task Format\nFor explicit memory requests:\n```\nTask: Store project-specific memory\nAgent: <appropriate agent based on content>\nContext:\n  Goal: Preserve important project knowledge for future reference\n  Memory Request: <user's original request>\n  Suggested Format:\n    # Add To Memory:\n    Type: <pattern|architecture|guideline|mistake|strategy|integration|performance|context>\n    Content: <concise summary under 100 chars>\n    #\n```\n\n### Agent Memory Specialization Guide\n- **Engineering Agent**: Implementation patterns, code architecture, performance optimizations\n- **Research Agent**: Analysis findings, investigation results, domain knowledge\n- **QA Agent**: Testing strategies, quality standards, bug patterns\n- **Security Agent**: Security patterns, threat analysis, compliance requirements\n- **Documentation Agent**: Writing standards, content organization patterns\n\n## CONTEXT-AWARE AGENT SELECTION\n- **PM role/capabilities questions**: Answer directly (only exception)\n- **Explanations/How-to questions**: Delegate to Documentation Agent\n- **Codebase analysis**: Delegate to Research Agent\n- **Implementation tasks**: Delegate to Engineer Agent  \n- **Security-sensitive operations**: Auto-route to Security Agent\n- **ALL other tasks**: Must delegate to appropriate specialized agent\n\n## TODOWRITE REQUIREMENTS\n**MANDATORY**: Always prefix tasks with [Agent] - NEVER use [PM] prefix for implementation work:\n- `[Research] Analyze authentication patterns`\n- `[Engineer] Implement user registration`\n- `[QA] Test payment flow (BLOCKED - waiting for fix)`\n- `[Documentation] Update API docs after QA sign-off`\n\n**FORBIDDEN [PM] todo examples**:\n- ❌ `[PM] Update CLAUDE.md` - Should delegate to Documentation Agent\n- ❌ `[PM] Create implementation roadmap` - Should delegate to Research Agent\n- ❌ `[PM] Configure systems` - Should delegate to Ops Agent\n\n**ONLY acceptable PM todos** (orchestration/delegation only):\n- ✅ `Building delegation context for [task]` (internal PM work)\n- ✅ `Aggregating results from agents` (internal PM work)\n\n## ERROR HANDLING PROTOCOL\n**3-Attempt Process**:\n1. **First Failure**: Re-delegate with enhanced context\n2. **Second Failure**: Mark \"ERROR - Attempt 2/3\", escalate to Research if needed\n3. **Third Failure**: TodoWrite escalation with user decision required\n\n## STANDARD OPERATING PROCEDURE\n1. **Analysis**: Parse request, assess context completeness (NO TOOLS)\n1.5. **Memory Evaluation**: Check for memory indicators, extract key information, delegate storage if detected\n2. **Planning**: Agent selection, task breakdown, priority assignment, dependency mapping\n3. **Delegation**: Task Tool with enhanced format, context enrichment\n4. **Monitoring**: Track progress, handle errors, dynamic adjustment\n5. **Integration**: Synthesize results (NO TOOLS), validate outputs, report or re-delegate\n\n## PROFESSIONAL COMMUNICATION\n- Maintain neutral, professional tone as default\n- Avoid overeager enthusiasm (\"Excellent!\", \"Amazing!\", \"Perfect!\")\n- Use appropriate acknowledgments (\"Understood\", \"Confirmed\", \"Noted\")\n- Never fallback to simpler solutions without explicit user instruction\n- Never use mock implementations outside test environments\n\nRemember: You are an **orchestrator and delegator ONLY**. Your power lies in coordinating specialized agents, not in doing the work yourself."
 }

claude_mpm/services/socketio_server.py

@@ -15,6 +15,7 @@ import time
 from datetime import datetime
 from typing import Set, Dict, Any, Optional, List
 from collections import deque
+from pathlib import Path
 
 try:
     import socketio
@@ -294,9 +295,12 @@ class SocketIOServer:
             self.app.router.add_get('/dashboard', self._handle_dashboard)
             
             # Add static file serving for web assets
-            static_path = get_project_root() / 'src' / 'claude_mpm' / 'dashboard' / 'static'
-            if static_path.exists():
+            static_path = self._find_static_path()
+            if static_path and static_path.exists():
                 self.app.router.add_static('/static/', path=str(static_path), name='static')
+                self.logger.info(f"Static files served from: {static_path}")
+            else:
+                self.logger.warning("Static files directory not found - CSS/JS files will not be available")
             
             # Register event handlers
             self._register_events()
@@ -346,6 +350,57 @@ class SocketIOServer:
             'Access-Control-Allow-Headers': 'Content-Type, Accept'
         })
 
+    def _find_static_path(self):
+        """Find the static files directory using multiple approaches.
+        
+        WHY: Static files need to be found in both development and installed environments.
+        This uses the same multi-approach pattern as dashboard HTML resolution.
+        """
+        
+        # Approach 1: Use module-relative path (works in installed environment)
+        try:
+            import claude_mpm.dashboard
+            
+            # Try __file__ attribute first
+            if hasattr(claude_mpm.dashboard, '__file__') and claude_mpm.dashboard.__file__:
+                dashboard_module_path = Path(claude_mpm.dashboard.__file__).parent
+                candidate_path = dashboard_module_path / "static"
+                if candidate_path.exists():
+                    self.logger.info(f"Found static files using module __file__ path: {candidate_path}")
+                    return candidate_path
+            
+            # Try __path__ attribute for namespace packages
+            elif hasattr(claude_mpm.dashboard, '__path__') and claude_mpm.dashboard.__path__:
+                # __path__ is a list, take the first entry
+                dashboard_module_path = Path(claude_mpm.dashboard.__path__[0])
+                candidate_path = dashboard_module_path / "static"
+                if candidate_path.exists():
+                    self.logger.info(f"Found static files using module __path__: {candidate_path}")
+                    return candidate_path
+                    
+        except Exception as e:
+            self.logger.debug(f"Module-relative static path failed: {e}")
+        
+        # Approach 2: Use project root (works in development environment)
+        try:
+            candidate_path = get_project_root() / 'src' / 'claude_mpm' / 'dashboard' / 'static'
+            if candidate_path.exists():
+                self.logger.info(f"Found static files using project root: {candidate_path}")
+                return candidate_path
+        except Exception as e:
+            self.logger.debug(f"Project root static path failed: {e}")
+        
+        # Approach 3: Search for static files in package installation
+        try:
+            candidate_path = get_project_root() / 'claude_mpm' / 'dashboard' / 'static'
+            if candidate_path.exists():
+                self.logger.info(f"Found static files using package path: {candidate_path}")
+                return candidate_path
+        except Exception as e:
+            self.logger.debug(f"Package static path failed: {e}")
+        
+        return None
+
     async def _handle_dashboard(self, request):
         """Serve the dashboard HTML file."""
         # Try to find dashboard path using multiple approaches
@@ -354,11 +409,24 @@ class SocketIOServer:
         # Approach 1: Use module-relative path (works in installed environment)
         try:
             import claude_mpm.dashboard
-            dashboard_module_path = Path(claude_mpm.dashboard.__file__).parent
-            candidate_path = dashboard_module_path / "templates" / "index.html"
-            if candidate_path.exists():
-                dashboard_path = candidate_path
-                self.logger.info(f"Found dashboard using module path: {dashboard_path}")
+            
+            # Try __file__ attribute first
+            if hasattr(claude_mpm.dashboard, '__file__') and claude_mpm.dashboard.__file__:
+                dashboard_module_path = Path(claude_mpm.dashboard.__file__).parent
+                candidate_path = dashboard_module_path / "templates" / "index.html"
+                if candidate_path.exists():
+                    dashboard_path = candidate_path
+                    self.logger.info(f"Found dashboard using module __file__ path: {dashboard_path}")
+            
+            # Try __path__ attribute for namespace packages
+            elif hasattr(claude_mpm.dashboard, '__path__') and claude_mpm.dashboard.__path__:
+                # __path__ is a list, take the first entry
+                dashboard_module_path = Path(claude_mpm.dashboard.__path__[0])
+                candidate_path = dashboard_module_path / "templates" / "index.html"
+                if candidate_path.exists():
+                    dashboard_path = candidate_path
+                    self.logger.info(f"Found dashboard using module __path__: {dashboard_path}")
+                    
         except Exception as e:
             self.logger.debug(f"Module-relative path failed: {e}")
         

{claude_mpm-3.4.14.dist-info → claude_mpm-3.4.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.4.14
+Version: 3.4.17
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team

{claude_mpm-3.4.14.dist-info → claude_mpm-3.4.17.dist-info}/RECORD

@@ -20,7 +20,7 @@ claude_mpm/agents/templates/data_engineer.json,sha256=Z63nwhO3Bo3sUjSc4O0yGVFbJV
 claude_mpm/agents/templates/documentation.json,sha256=z5ApzJYOty5dw5yidNxhwX7QU8FICRAzmzD1xdxPkCI,6224
 claude_mpm/agents/templates/engineer.json,sha256=Qt9mJjbVM0wH9GE6kqAhGDRVmLhWbs0fwGW1IoluTZ8,12474
 claude_mpm/agents/templates/ops.json,sha256=b-LRqYRWjMZnXKd8SMPXDLCq6-nRAmCHN60IlJctjXM,6488
-claude_mpm/agents/templates/pm.json,sha256=FbH9TOJ1NUmgHREPEhl5nOuWS8k7ee_KEQlC7cnLj2w,5239
+claude_mpm/agents/templates/pm.json,sha256=1x68Iyq2lN8J7FPxcBwx1R13k8z6gr4zg7GLB6dICFc,7451
 claude_mpm/agents/templates/qa.json,sha256=UmNbeONvnzSvHFB3GUXwnN8n-TF5wgrk0JaAkYwOvfY,6636
 claude_mpm/agents/templates/research.json,sha256=10XO-W7cV_SGP16SHboagjbNUlKUoGfpbrjrI2tiSWU,13591
 claude_mpm/agents/templates/security.json,sha256=DkiB98uJf5mo5nP7EIhu8hhsvwGhOnR_FA60EJGuNBk,6741
@@ -159,7 +159,7 @@ claude_mpm/services/project_analyzer.py,sha256=3Ub_Tpcxm0LnYgcAipebvWr6TfofVqZNM
 claude_mpm/services/recovery_manager.py,sha256=K46vXbEWbxFUoS42s34OxN1rkddpisGG7E_ZdRyAZ-A,25792
 claude_mpm/services/shared_prompt_cache.py,sha256=D04lrRWyg0lHyqGcAHy7IYvRHRKSg6EOpAJwBUPa2wk,29890
 claude_mpm/services/socketio_client_manager.py,sha256=2Ly63iiGA_BUzf73UwQDu9Q75wA1C4O1CWFv8hi8bms,18074
-claude_mpm/services/socketio_server.py,sha256=6sCeHdZHW3glxrI_ZzynUwFQ7a-iO5OXnAtIDu7B3oY,81395
+claude_mpm/services/socketio_server.py,sha256=E1i_YrUFa7AKdxfKgNkC0daUzytA8qiHRJxD_JRcXPk,84929
 claude_mpm/services/standalone_socketio_server.py,sha256=TfdtwdtlKA6cZyTon9O7zkSeu0H-1HpW0te7vu1r3o0,55214
 claude_mpm/services/ticket_manager.py,sha256=Ki11YjBkDax8BFVSaDdOBk3K4VU5gvdbgq9AmCyyoZ0,7454
 claude_mpm/services/ticket_manager_di.py,sha256=pIsIGncbboKzBYSRQTO7ZX5MuQzV6iFfIflvKe6u1jw,11123
@@ -213,9 +213,9 @@ claude_mpm/utils/path_operations.py,sha256=6pLMnAWBVzHkgp6JyQHmHbGD-dWn-nX21yV4E
 claude_mpm/utils/paths.py,sha256=Xv0SZWdZRkRjN9e6clBcA165ya00GNQxt7SwMz51tfA,10153
 claude_mpm/validation/__init__.py,sha256=bJ19g9lnk7yIjtxzN8XPegp87HTFBzCrGQOpFgRTf3g,155
 claude_mpm/validation/agent_validator.py,sha256=GCA2b2rKhKDeaNyUqWxTiWIs3sDdWjD9cgOFRp9K6ic,18227
-claude_mpm-3.4.14.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
-claude_mpm-3.4.14.dist-info/METADATA,sha256=A2ldIPNi-3VTlgSXiwiSbnIxAqjov4jOfc1aNYDylAk,6499
-claude_mpm-3.4.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-3.4.14.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
-claude_mpm-3.4.14.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-3.4.14.dist-info/RECORD,,
+claude_mpm-3.4.17.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
+claude_mpm-3.4.17.dist-info/METADATA,sha256=CwZn-qu7F_zpPVcgCgT69w4hm3u2aFxCs4eXqWGnUDU,6499
+claude_mpm-3.4.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-3.4.17.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
+claude_mpm-3.4.17.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-3.4.17.dist-info/RECORD,,