claude-mpm 5.6.14__py3-none-any.whl → 5.6.15__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-5.6.14
+5.6.15

claude_mpm/core/claude_runner.py

@@ -1,5 +1,7 @@
 """Claude runner with both exec and subprocess launch methods."""
 
+import hashlib
+import json
 import os
 from pathlib import Path
 from typing import Optional
@@ -211,9 +213,137 @@ class ClaudeRunner:
                 }
             )
 
+    def _get_deployment_state_path(self) -> Path:
+        """Get path to deployment state file."""
+        return Path.cwd() / ".claude" / "agents" / ".deployment-state.json"
+
+    def _calculate_deployment_hash(self, agents_dir: Path) -> str:
+        """Calculate hash of all agent files for change detection.
+
+        Args:
+            agents_dir: Directory containing agent .md files
+
+        Returns:
+            SHA256 hash of agent file contents
+        """
+        if not agents_dir.exists():
+            return ""
+
+        # Get all .md files sorted for consistent hashing
+        agent_files = sorted(agents_dir.glob("*.md"))
+
+        hash_obj = hashlib.sha256()
+        for agent_file in agent_files:
+            # Include filename and content in hash
+            hash_obj.update(agent_file.name.encode())
+            try:
+                hash_obj.update(agent_file.read_bytes())
+            except Exception as e:
+                self.logger.debug(f"Error reading {agent_file} for hash: {e}")
+
+        return hash_obj.hexdigest()
+
+    def _check_deployment_state(self) -> bool:
+        """Check if agents are already deployed and up-to-date.
+
+        Returns:
+            True if agents are already deployed and match current version, False otherwise
+        """
+        state_file = self._get_deployment_state_path()
+        agents_dir = Path.cwd() / ".claude" / "agents"
+
+        # If state file doesn't exist, need to deploy
+        if not state_file.exists():
+            return False
+
+        # If agents directory doesn't exist, need to deploy
+        if not agents_dir.exists():
+            return False
+
+        try:
+            # Load deployment state
+            state_data = json.loads(state_file.read_text())
+
+            # Get current version from package
+            from claude_mpm import __version__
+
+            # Check if version matches
+            if state_data.get("version") != __version__:
+                self.logger.debug(
+                    f"Version mismatch: {state_data.get('version')} != {__version__}"
+                )
+                return False
+
+            # Check if agent count and hash match
+            current_hash = self._calculate_deployment_hash(agents_dir)
+            stored_hash = state_data.get("deployment_hash", "")
+
+            if current_hash != stored_hash:
+                self.logger.debug("Agent deployment hash mismatch")
+                return False
+
+            # All checks passed - agents are already deployed
+            agent_count = state_data.get("agent_count", 0)
+            self.logger.debug(
+                f"Agents already deployed: {agent_count} agents (v{__version__})"
+            )
+            return True
+
+        except Exception as e:
+            self.logger.debug(f"Error checking deployment state: {e}")
+            return False
+
+    def _save_deployment_state(self, agent_count: int) -> None:
+        """Save current deployment state.
+
+        Args:
+            agent_count: Number of agents deployed
+        """
+        state_file = self._get_deployment_state_path()
+        agents_dir = Path.cwd() / ".claude" / "agents"
+
+        try:
+            import time
+
+            from claude_mpm import __version__
+
+            # Calculate deployment hash
+            deployment_hash = self._calculate_deployment_hash(agents_dir)
+
+            # Create state data
+            state_data = {
+                "version": __version__,
+                "agent_count": agent_count,
+                "deployment_hash": deployment_hash,
+                "deployed_at": time.time(),
+            }
+
+            # Ensure directory exists
+            state_file.parent.mkdir(parents=True, exist_ok=True)
+
+            # Write state file
+            state_file.write_text(json.dumps(state_data, indent=2))
+            self.logger.debug(f"Saved deployment state: {agent_count} agents")
+
+        except Exception as e:
+            self.logger.debug(f"Error saving deployment state: {e}")
+
     def setup_agents(self) -> bool:
         """Deploy native agents to .claude/agents/."""
         try:
+            # Check if agents are already deployed and up-to-date
+            if self._check_deployment_state():
+                agents_dir = Path.cwd() / ".claude" / "agents"
+                agent_count = len(list(agents_dir.glob("*.md")))
+                print(f"✓ Agents: {agent_count} cached")
+                if self.project_logger:
+                    self.project_logger.log_system(
+                        f"Agents already deployed: {agent_count} cached",
+                        level="INFO",
+                        component="deployment",
+                    )
+                return True
+
             if self.project_logger:
                 self.project_logger.log_system(
                     "Starting agent deployment", level="INFO", component="deployment"
@@ -239,6 +369,12 @@ class ClaudeRunner:
 
                 # Set Claude environment
                 self.deployment_service.set_claude_environment()
+
+                # Save deployment state for future runs
+                agents_dir = Path.cwd() / ".claude" / "agents"
+                total_agents = len(list(agents_dir.glob("*.md")))
+                self._save_deployment_state(total_agents)
+
                 return True
             self.logger.info("All agents already up to date")
             if self.project_logger:
@@ -247,6 +383,13 @@ class ClaudeRunner:
                     level="INFO",
                     component="deployment",
                 )
+
+            # Save deployment state even if no changes
+            agents_dir = Path.cwd() / ".claude" / "agents"
+            if agents_dir.exists():
+                total_agents = len(list(agents_dir.glob("*.md")))
+                self._save_deployment_state(total_agents)
+
             return True
 
         except PermissionError as e:

claude_mpm/skills/bundled/pm/mpm-session-pause/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: mpm-session-pause
+description: Pause session and save current work state for later resume
+user-invocable: true
+version: "1.0.0"
+category: mpm-command
+tags: [mpm-command, session, pm-recommended]
+---
+
+# /mpm-pause
+
+Pause the current session and save all work state for later resume.
+
+## What This Does
+
+When invoked, this skill:
+1. Captures current work state (todos, git status, context summary)
+2. Creates session file at `.claude-mpm/sessions/session-{timestamp}.md`
+3. Updates `.claude-mpm/sessions/LATEST-SESSION.txt` pointer
+4. Optionally commits session state to git
+5. Shows user the session file path for later resume
+
+## Usage
+
+```
+/mpm-pause [optional message describing current work]
+```
+
+**Examples:**
+```
+/mpm-pause
+/mpm-pause Working on authentication refactor, about to test login flow
+/mpm-pause Need to context switch to urgent bug fix
+```
+
+## Implementation
+
+**Execute the following Python code to pause the session:**
+
+```python
+from pathlib import Path
+from claude_mpm.services.cli.session_pause_manager import SessionPauseManager
+
+# Optional: Get message from user's command
+# If user provided message after /mpm-pause, extract it
+# Otherwise, message = None
+
+# Create session pause manager
+manager = SessionPauseManager(project_path=Path.cwd())
+
+# Create pause session
+session_id = manager.create_pause_session(
+    message=message,  # Optional context message
+    skip_commit=False,  # Will commit to git if in a repo
+    export_path=None,  # No additional export needed
+)
+
+# Report success to user
+print(f"✅ Session paused successfully!")
+print(f"")
+print(f"Session ID: {session_id}")
+print(f"Session files:")
+print(f"  - .claude-mpm/sessions/{session_id}.md (human-readable)")
+print(f"  - .claude-mpm/sessions/{session_id}.json (machine-readable)")
+print(f"  - .claude-mpm/sessions/{session_id}.yaml (config format)")
+print(f"")
+print(f"Quick resume:")
+print(f"  /mpm-resume")
+print(f"")
+print(f"View session context:")
+print(f"  cat .claude-mpm/sessions/LATEST-SESSION.txt")
+print(f"  cat .claude-mpm/sessions/{session_id}.md")
+```
+
+## What Gets Saved
+
+**Session State:**
+- Session ID and timestamp
+- Current working directory
+- Git branch, recent commits, and file status
+- Primary task and current phase
+- Context message (if provided)
+
+**Resume Instructions:**
+- Quick-start commands
+- Validation commands
+- Files to review
+
+**File Formats:**
+- `.md` - Human-readable markdown (for reading)
+- `.json` - Machine-readable (for tooling)
+- `.yaml` - Human-readable config (for editing)
+
+## Session File Location
+
+All session files are stored in:
+```
+.claude-mpm/sessions/
+├── LATEST-SESSION.txt          # Pointer to most recent session
+├── session-YYYYMMDD-HHMMSS.md
+├── session-YYYYMMDD-HHMMSS.json
+└── session-YYYYMMDD-HHMMSS.yaml
+```
+
+## Token Budget
+
+**Token usage:** ~5-10k tokens to execute (2-5% of context budget)
+
+**Benefit:** Saves all remaining context for future resume, allowing you to:
+- Context switch to urgent tasks
+- Take a break and resume later
+- Archive current work state before major changes
+
+## Resume Later
+
+To resume this session:
+```
+/mpm-resume
+```
+
+Or manually:
+```bash
+cat .claude-mpm/sessions/LATEST-SESSION.txt
+cat .claude-mpm/sessions/session-YYYYMMDD-HHMMSS.md
+```
+
+## Git Integration
+
+If in a git repository, the session will be automatically committed with message:
+```
+session: pause at YYYY-MM-DD HH:MM:SS
+
+Session ID: session-YYYYMMDD-HHMMSS
+Context: [your optional message]
+```
+
+## Use Cases
+
+**Context switching:**
+```
+/mpm-pause Switching to urgent production bug
+```
+
+**End of work session:**
+```
+/mpm-pause Completed API refactor, ready for testing tomorrow
+```
+
+**Before major changes:**
+```
+/mpm-pause Saving state before attempting risky refactor
+```
+
+**When approaching context limit:**
+```
+/mpm-pause Hit 150k tokens, starting fresh session
+```
+
+## Related Commands
+
+- `/mpm-resume` - Resume from most recent paused session
+- `/mpm-init resume` - Alternative resume command
+- See `docs/features/session-auto-resume.md` for auto-pause behavior
+
+## Notes
+
+- Session files are project-local (not synced across machines)
+- Git commit is optional (automatically skipped if not a repo)
+- LATEST-SESSION.txt always points to most recent session
+- Session format compatible with auto-pause feature (70% context trigger)

{claude_mpm-5.6.14.dist-info → claude_mpm-5.6.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 5.6.14
+Version: 5.6.15
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team

{claude_mpm-5.6.14.dist-info → claude_mpm-5.6.15.dist-info}/RECORD

@@ -1,5 +1,5 @@
 claude_mpm/BUILD_NUMBER,sha256=9JfxhnDtr-8l3kCP2U5TVXSErptHoga8m7XA8zqgGOc,4
-claude_mpm/VERSION,sha256=N3JXgSQF14_WNnDj_WQaXFRyVIXk9kjTMKcZXD7xw-M,7
+claude_mpm/VERSION,sha256=lmdMySaW5TqBtIgJf9AVG6eb87dY9SfKu-1p6Ru0_JI,7
 claude_mpm/__init__.py,sha256=AGfh00BHKvLYD-UVFw7qbKtl7NMRIzRXOWw7vEuZ-h4,2214
 claude_mpm/__main__.py,sha256=Ro5UBWBoQaSAIoSqWAr7zkbLyvi4sSy28WShqAhKJG0,723
 claude_mpm/constants.py,sha256=pz3lTrZZR5HhV3eZzYtIbtBwWo7iM6pkBHP_ixxmI6Y,6827
@@ -271,7 +271,7 @@ claude_mpm/core/agent_session_manager.py,sha256=F10LS-nyTQxzMP3fkhbI94klsJy5xpSA
 claude_mpm/core/api_validator.py,sha256=zxeUykC2asy1KwHBDu5w3Eoo64E51PJyNe4PT7CTJf0,12282
 claude_mpm/core/base_service.py,sha256=4Zrt-vQ6g_KVk4hEfvd4QccuItYoOf7wUHCimIW6zJQ,29953
 claude_mpm/core/cache.py,sha256=orh8B40oYnRRGmXdANR4P4f-KVMIHV0vg7vrsemk0no,17232
-claude_mpm/core/claude_runner.py,sha256=Wle-wI-ag25oC0EYX3n8dDC56I5GIdbpi5NtvT4IgBw,34263
+claude_mpm/core/claude_runner.py,sha256=kAZLgtkcOw4AZQxTc2zIba_BoUCOhVRNJ92vSFTP4Y4,39369
 claude_mpm/core/config.py,sha256=0R1ZLdwxTM2N3-uIBgcbr37jDiEe-G7h7x4YmYIVit0,43385
 claude_mpm/core/config_aliases.py,sha256=QpNNECkTY4TYYAhVlFZvB-msPnZrui90g19u0-v0HDE,9703
 claude_mpm/core/config_constants.py,sha256=MEF35Y2Lj5FMzRdhgSgZrZeTzHfCzistPGZVY8INta4,10073
@@ -1019,6 +1019,7 @@ claude_mpm/skills/bundled/pm/mpm-organize/SKILL.md,sha256=eMUxGO24f9FyaxAV_BvN0T
 claude_mpm/skills/bundled/pm/mpm-postmortem/SKILL.md,sha256=OjswFa5mRvlHpioAN02sjKISL1RJR4u4pVlfj-Hsuhc,516
 claude_mpm/skills/bundled/pm/mpm-pr-workflow/SKILL.md,sha256=HSeVxw_znHqiPA95gpHnPKavNkSgSLTKuVaHqV976Ao,3369
 claude_mpm/skills/bundled/pm/mpm-session-management/SKILL.md,sha256=GcGbCPoVs-N4MHZIoLf7q3EK1Noy4DLoCGvs3dVfZq4,8341
+claude_mpm/skills/bundled/pm/mpm-session-pause/SKILL.md,sha256=xwgFxX5Pi8eMno7UalnjVWBiX3aCb1e2Jwh9dS0Y8OU,4323
 claude_mpm/skills/bundled/pm/mpm-session-resume/SKILL.md,sha256=7O1iu6qORTglX1VlAy4da_oEGvBwZ53Vmg6yBc02DqY,722
 claude_mpm/skills/bundled/pm/mpm-status/SKILL.md,sha256=9cj2l-aEdQ7_pTqTjTn7_EZe-CyzM9ab8vzWpX62LFY,906
 claude_mpm/skills/bundled/pm/mpm-teaching-mode/SKILL.md,sha256=SRhxpc6EyiO-hH5pQ7FcxNDUaaj5pfTEV9FwkjxfCA4,17761
@@ -1127,10 +1128,10 @@ claude_mpm/utils/subprocess_utils.py,sha256=D0izRT8anjiUb_JG72zlJR_JAw1cDkb7kalN
 claude_mpm/validation/__init__.py,sha256=YZhwE3mhit-lslvRLuwfX82xJ_k4haZeKmh4IWaVwtk,156
 claude_mpm/validation/agent_validator.py,sha256=GprtAvu80VyMXcKGsK_VhYiXWA6BjKHv7O6HKx0AB9w,20917
 claude_mpm/validation/frontmatter_validator.py,sha256=YpJlYNNYcV8u6hIOi3_jaRsDnzhbcQpjCBE6eyBKaFY,7076
-claude_mpm-5.6.14.dist-info/licenses/LICENSE,sha256=ca3y_Rk4aPrbF6f62z8Ht5MJM9OAvbGlHvEDcj9vUQ4,3867
-claude_mpm-5.6.14.dist-info/licenses/LICENSE-FAQ.md,sha256=TxfEkXVCK98RzDOer09puc7JVCP_q_bN4dHtZKHCMcM,5104
-claude_mpm-5.6.14.dist-info/METADATA,sha256=A_iow_IpMJgpDMXTCkMOJuppdanbmP2-JL-WsljSmkE,15245
-claude_mpm-5.6.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-5.6.14.dist-info/entry_points.txt,sha256=n-Uk4vwHPpuvu-g_I7-GHORzTnN_m6iyOsoLveKKD0E,228
-claude_mpm-5.6.14.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-5.6.14.dist-info/RECORD,,
+claude_mpm-5.6.15.dist-info/licenses/LICENSE,sha256=ca3y_Rk4aPrbF6f62z8Ht5MJM9OAvbGlHvEDcj9vUQ4,3867
+claude_mpm-5.6.15.dist-info/licenses/LICENSE-FAQ.md,sha256=TxfEkXVCK98RzDOer09puc7JVCP_q_bN4dHtZKHCMcM,5104
+claude_mpm-5.6.15.dist-info/METADATA,sha256=oYFEVPPcmoJk4V558WRo8MS9Trx52xQKoUN5k6nCd14,15245
+claude_mpm-5.6.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-5.6.15.dist-info/entry_points.txt,sha256=n-Uk4vwHPpuvu-g_I7-GHORzTnN_m6iyOsoLveKKD0E,228
+claude_mpm-5.6.15.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-5.6.15.dist-info/RECORD,,