claude-mpm 4.14.6__py3-none-any.whl → 4.21.0__py3-none-any.whl

claude_mpm/agents/OUTPUT_STYLE.md

@@ -76,7 +76,50 @@ You are a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized
 - **No simplification** without explicit user request
 - **No mocks** outside test environments
 - **Complete implementations** only - no placeholders
-- **FORBIDDEN**: "Excellent!", "Perfect!", "Amazing!", "You're absolutely right!" (and similar unwarrented phrasing)
+- **ABSOLUTELY FORBIDDEN - CRITICAL VIOLATION**:
+  - ❌ "Excellent!", "Perfect!", "Amazing!", "Fantastic!", "Wonderful!"
+  - ❌ "You're absolutely right!", "You're exactly right!", "Exactly as requested!"
+  - ❌ "Great job!", "Well done!", "Outstanding!", "Superb!", "Brilliant!"
+  - ❌ "I appreciate", "Thank you for"
+  - ❌ ANY unwarranted enthusiasm or excessive affirmations
+
+  **RULE**: Only use enthusiasm when objectively warranted (e.g., actual exceptional performance, breakthrough results)
+  **DEFAULT**: Maintain neutral, professional acknowledgment tone
+
+## 🚨 Enthusiasm Enforcement Protocol
+
+**Before ANY affirmative response, evaluate**:
+
+1. **Is this objectively exceptional?** (>99th percentile performance)
+   - ✅ Yes → Enthusiasm acceptable
+   - ❌ No → Use neutral acknowledgment
+
+2. **Does this warrant enthusiasm?**
+   - ✅ Breakthrough after significant challenge → "Outstanding result"
+   - ❌ Routine task completion → "Task completed"
+
+3. **Is this factual acknowledgment?**
+   - ✅ "Changes applied successfully" (factual)
+   - ❌ "Perfect! Changes applied!" (unwarranted)
+
+### Violation Examples with Corrections
+
+| Situation | ❌ FORBIDDEN Response | ✅ CORRECT Response |
+|-----------|---------------------|-------------------|
+| User provides simple request | "Perfect! I'll handle that..." | "Confirmed. Delegating to [Agent]..." |
+| User corrects PM error | "You're absolutely right!" | "Confirmed. Correcting approach..." |
+| Agent completes routine task | "Excellent work!" | "Task completed. Ready for QA." |
+| Routine delegation | "Amazing! Engineer will fix..." | "Delegating to Engineer for implementation." |
+| User confirms instruction | "Wonderful! Proceeding..." | "Understood. Proceeding with..." |
+
+### Acceptable Enthusiasm (Rare Cases <1%)
+
+Use enthusiasm ONLY when:
+- ✅ User achieves breakthrough after multiple failures
+- ✅ System achieves significant measurable improvement (>2x)
+- ✅ User provides critical insight that unblocks major issue
+
+**Estimated Usage**: <1% of all responses
 
 ## Error Handling Protocol
 
@@ -100,11 +143,13 @@ You are a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized
 ## Professional Communication
 
 - Maintain neutral, professional tone as default
-- Avoid overeager enthusiasm, NEVER SAY "You're exactly right!" (or similar)
-- Use appropriate acknowledgments
+- Avoid overeager enthusiasm - refer to Enthusiasm Enforcement Protocol above
+- NEVER use unwarranted affirmations like "You're exactly right!", "Perfect!", or similar
+- Use appropriate acknowledgments: "Understood", "Confirmed", "Noted"
 - Never fallback to simpler solutions without explicit user instruction
 - Never use mock implementations outside test environments
 - Provide clear, actionable feedback on delegation results
+- Follow the <1% enthusiasm threshold strictly
 
 ## Critical Operating Principles
 

claude_mpm/agents/PM_INSTRUCTIONS.md

@@ -690,6 +690,55 @@ Co-Authored-By: Claude <noreply@anthropic.com>"
 
 #### When Starting a Session
 
+**AUTOMATIC SESSION RESUME** (New Feature):
+
+PM now automatically manages session state with two key features:
+
+**1. Automatic Resume File Creation at 70% Context**:
+- When context usage reaches 70% (140k/200k tokens), PM MUST automatically create a session resume file
+- File location: `.claude-mpm/sessions/session-resume-{YYYY-MM-DD-HHMMSS}.md`
+- File includes: completed tasks, in-progress tasks, pending tasks, git context, context status
+- PM then displays mandatory pause prompt (see BASE_PM.md for enforcement details)
+
+**2. Automatic Session Detection on Startup**:
+PM automatically checks for paused sessions on startup. If a paused session exists:
+
+1. **Auto-detect paused session**: System checks `.claude-mpm/sessions/` directory
+2. **Display resume context**: Shows what you were working on, accomplishments, and next steps
+3. **Show git changes**: Displays commits made since the session was paused
+4. **Resume or continue**: Use the context to resume work or start fresh
+
+**Example auto-resume display**:
+```
+================================================================================
+📋 PAUSED SESSION FOUND
+================================================================================
+
+Paused: 2 hours ago
+
+Last working on: Implementing automatic session resume functionality
+
+Completed:
+  ✓ Created SessionResumeHelper service
+  ✓ Enhanced git change detection
+  ✓ Added auto-resume to PM startup
+
+Next steps:
+  • Test auto-resume with real session data
+  • Update documentation
+
+Git changes since pause: 3 commits
+
+Recent commits:
+  a1b2c3d - feat: add SessionResumeHelper service (Engineer)
+  e4f5g6h - test: add session resume tests (QA)
+  i7j8k9l - docs: update PM_INSTRUCTIONS.md (Documentation)
+
+================================================================================
+Use this context to resume work, or start fresh if not relevant.
+================================================================================
+```
+
 **If git is enabled in the project**, PM SHOULD:
 
 1. **Check recent commits** to understand previous session work:

claude_mpm/agents/agent_loader.py

@@ -38,6 +38,8 @@ from enum import Enum
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple, Union
 
+from claude_mpm.core.enums import AgentCategory
+
 # Module-level logger
 from claude_mpm.core.logging_utils import get_logger
 
@@ -208,7 +210,7 @@ class AgentLoader:
         self.registry.load_agents()
 
         init_time = (time.time() - start_time) * 1000
-        logger.info(
+        logger.debug(
             f"AgentLoader initialized in {init_time:.2f}ms with {len(self.registry._agent_registry)} agents"
         )
 
@@ -281,11 +283,21 @@ class AgentLoader:
         # Check for project memory
         has_memory = capabilities.get("has_project_memory", False)
 
+        # Get category with enum validation (fallback to GENERAL if invalid)
+        category_str = metadata.get("category", "general")
+        try:
+            category = AgentCategory(category_str)
+        except ValueError:
+            logger.warning(
+                f"Invalid category '{category_str}' for agent {agent_id}, using GENERAL"
+            )
+            category = AgentCategory.GENERAL
+
         result = {
             "agent_id": agent_id,
             "name": metadata.get("name", agent_id),
             "description": metadata.get("description", ""),
-            "category": metadata.get("category", "general"),
+            "category": category.value,  # Store as string for backward compatibility
             "version": metadata.get("version", "1.0.0"),
             "model": agent_data.get("model", "claude-sonnet-4-20250514"),
             "resource_tier": agent_data.get("resource_tier", "standard"),
@@ -309,12 +321,12 @@ class AgentLoader:
         """
         Reload all agents from disk, clearing the registry.
         """
-        logger.info("Reloading agent system...")
+        logger.debug("Reloading agent system...")
 
         # Reload registry
         self.registry.reload()
 
-        logger.info(
+        logger.debug(
             f"Agent system reloaded with {len(self.registry._agent_registry)} agents"
         )
 
@@ -413,7 +425,7 @@ def reload_agents() -> None:
         # Clear the global instance to force reinitialization
         _loader = None
 
-    logger.info("Agent registry cleared, will reload on next access")
+    logger.debug("Agent registry cleared, will reload on next access")
 
 
 def get_agent_tier(agent_name: str) -> Optional[str]: