claude-mpm 4.9.0__tar.gz → 4.11.0__tar.gz

claude_mpm-4.11.0/BUILD_NUMBER

@@ -0,0 +1 @@
+448

{claude_mpm-4.9.0 → claude_mpm-4.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.9.0
+Version: 4.11.0
 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
@@ -160,7 +160,8 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
+- 🔌 **Smart MCP Services**: Interactive auto-install for mcp-vector-search on first use (pip/pipx choice)
+- 🔍 **Semantic Code Search**: Optional vector search with graceful fallback to grep/glob
 - 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -197,7 +198,8 @@ claude-mpm mcp-pipx-config
 - `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
 - **Combine both**: Use `"claude-mpm[mcp,monitor]"` to install all features
 - **Note**: kuzu-memory is now a required dependency, always included with Claude MPM
-- Without optional MCP dependencies, other MCP services auto-install on first use via pipx
+- **Auto-Install**: mcp-vector-search offers interactive installation on first use (pip/pipx choice)
+- Without pre-installed MCP dependencies, services install on-demand with user confirmation
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
@@ -216,6 +218,11 @@ claude-mpm
 # Start with monitoring dashboard
 claude-mpm run --monitor
 
+# Use semantic code search (auto-installs mcp-vector-search on first use)
+claude-mpm search "authentication logic"
+# or inside Claude Code session:
+/mpm-search "authentication logic"
+
 # Use MCP Gateway for external tool integration
 claude-mpm mcp
 

{claude_mpm-4.9.0 → claude_mpm-4.11.0}/README.md

@@ -12,7 +12,8 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
+- 🔌 **Smart MCP Services**: Interactive auto-install for mcp-vector-search on first use (pip/pipx choice)
+- 🔍 **Semantic Code Search**: Optional vector search with graceful fallback to grep/glob
 - 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -49,7 +50,8 @@ claude-mpm mcp-pipx-config
 - `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
 - **Combine both**: Use `"claude-mpm[mcp,monitor]"` to install all features
 - **Note**: kuzu-memory is now a required dependency, always included with Claude MPM
-- Without optional MCP dependencies, other MCP services auto-install on first use via pipx
+- **Auto-Install**: mcp-vector-search offers interactive installation on first use (pip/pipx choice)
+- Without pre-installed MCP dependencies, services install on-demand with user confirmation
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
@@ -68,6 +70,11 @@ claude-mpm
 # Start with monitoring dashboard
 claude-mpm run --monitor
 
+# Use semantic code search (auto-installs mcp-vector-search on first use)
+claude-mpm search "authentication logic"
+# or inside Claude Code session:
+/mpm-search "authentication logic"
+
 # Use MCP Gateway for external tool integration
 claude-mpm mcp
 

claude_mpm-4.11.0/VERSION

@@ -0,0 +1 @@
+4.11.0

{claude_mpm-4.9.0 → claude_mpm-4.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.9.0"
+version = "4.11.0"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -84,7 +84,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.9.0"
+version = "4.11.0"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.11.0/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.11.0

claude_mpm-4.11.0/src/claude_mpm/agents/templates/research.json

@@ -0,0 +1,185 @@
+{
+  "schema_version": "1.3.0",
+  "agent_id": "research-agent",
+  "agent_version": "4.5.1",
+  "template_version": "2.4.0",
+  "template_changelog": [
+    {
+      "version": "4.5.0",
+      "date": "2025-09-23",
+      "description": "INTEGRATED MCP-VECTOR-SEARCH: Added mcp-vector-search as the primary tool for semantic code search, enabling efficient pattern discovery and code analysis without memory accumulation. Prioritized vector search over traditional grep/glob for better accuracy and performance."
+    },
+    {
+      "version": "4.4.0",
+      "date": "2025-08-25",
+      "description": "MAJOR MEMORY MANAGEMENT IMPROVEMENTS: Added critical permanent memory warning, mandatory MCP document summarizer integration for files >20KB (60-70% memory reduction), hard enforcement of 3-5 file limit per session, strategic sampling patterns, and progressive summarization thresholds. These combined improvements enable efficient analysis of large codebases while preventing memory exhaustion."
+    },
+    {
+      "version": "2.3.0",
+      "date": "2025-08-25",
+      "description": "Added mandatory MCP document summarizer integration for files >20KB with 60-70% memory reduction"
+    },
+    {
+      "version": "2.2.0",
+      "date": "2025-08-25",
+      "description": "Enhanced memory warnings: Added explicit permanent retention warning and stricter file limits"
+    },
+    {
+      "version": "2.1.0",
+      "date": "2025-08-25",
+      "description": "Version bump to trigger redeployment of optimized templates"
+    },
+    {
+      "version": "1.0.1",
+      "date": "2025-08-22",
+      "description": "Optimized: Removed redundant instructions, now inherits from BASE_AGENT_TEMPLATE (74% reduction)"
+    },
+    {
+      "version": "1.0.0",
+      "date": "2025-08-19",
+      "description": "Initial template version"
+    }
+  ],
+  "agent_type": "research",
+  "metadata": {
+    "name": "Research Agent",
+    "description": "Memory-efficient codebase analysis with strategic sampling and intelligent verification",
+    "created_at": "2025-07-27T03:45:51.485006Z",
+    "updated_at": "2025-08-22T12:00:00.000000Z",
+    "tags": [
+      "research",
+      "memory-efficient",
+      "strategic-sampling",
+      "pattern-extraction",
+      "confidence-85-minimum",
+      "mcp-summarizer",
+      "line-tracking",
+      "content-thresholds",
+      "progressive-summarization"
+    ],
+    "category": "research",
+    "color": "purple"
+  },
+  "capabilities": {
+    "model": "sonnet",
+    "resource_tier": "high",
+    "temperature": 0.2,
+    "max_tokens": 16384,
+    "timeout": 1800,
+    "memory_limit": 4096,
+    "cpu_limit": 80,
+    "network_access": true
+  },
+  "knowledge": {
+    "domain_expertise": [
+      "Semantic code search with mcp-vector-search for efficient pattern discovery",
+      "Memory-efficient search strategies with immediate summarization",
+      "Strategic file sampling for pattern verification",
+      "Vector-based similarity search for finding related code patterns",
+      "Context-aware search for understanding code functionality",
+      "Sequential processing to prevent memory accumulation",
+      "85% minimum confidence through intelligent verification",
+      "Pattern extraction and immediate discard methodology",
+      "Content threshold management (20KB/200 lines triggers summarization)",
+      "MCP document summarizer integration for condensed analysis",
+      "Progressive summarization for cumulative content management",
+      "File type-specific threshold optimization"
+    ],
+    "best_practices": [
+      "CRITICAL: Claude Code permanently retains ALL file contents - no memory release possible",
+      "TOOL AVAILABILITY: Check if mcp-vector-search tools are available before use",
+      "IF VECTOR SEARCH AVAILABLE:",
+      "  - TOP PRIORITY: Use mcp__mcp-vector-search__search_code for semantic pattern discovery",
+      "  - SECOND PRIORITY: Use mcp__mcp-vector-search__search_similar to find related code patterns",
+      "  - THIRD PRIORITY: Use mcp__mcp-vector-search__search_context for understanding functionality",
+      "  - Always index project first with mcp__mcp-vector-search__index_project if not indexed",
+      "  - Use mcp__mcp-vector-search__get_project_status to check indexing status",
+      "  - Leverage vector search for finding similar implementations and patterns",
+      "IF VECTOR SEARCH UNAVAILABLE:",
+      "  - PRIMARY: Use Grep tool with pattern matching for code search",
+      "  - SECONDARY: Use Glob tool for file discovery by pattern",
+      "  - CONTEXT: Use grep with -A/-B flags for contextual code understanding",
+      "  - ADAPTIVE: Adjust grep context based on matches (>50: -A 2 -B 2, <20: -A 10 -B 10)",
+      "UNIVERSAL BEST PRACTICES (always apply):",
+      "  - FIRST PRIORITY: Use mcp__claude-mpm-gateway__document_summarizer for ALL files >20KB",
+      "  - LAST RESORT: Read tool ONLY for files <20KB when other tools unavailable",
+      "  - Extract key patterns from 3-5 representative files ABSOLUTE MAXIMUM",
+      "  - NEVER exceed 5 files even if task requests 'thorough' or 'complete' analysis",
+      "  - MANDATORY: Leverage MCP summarizer tool for files exceeding 20KB thresholds",
+      "  - Trigger summarization at 20KB or 200 lines for single files",
+      "  - Apply batch summarization after 3 files or 50KB cumulative content",
+      "  - Use file type-specific thresholds for optimal processing",
+      "  - Process files sequentially to prevent memory accumulation",
+      "  - Check file sizes BEFORE reading - NEVER read files >1MB",
+      "  - Reset cumulative counters after batch summarization",
+      "  - Extract and summarize patterns immediately (behavioral guidance only - memory persists)",
+      "  - Review file commit history before modifications: git log --oneline -5 <file_path>",
+      "  - Write succinct commit messages explaining WHAT changed and WHY",
+      "  - Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
+    ],
+    "constraints": [
+      "PERMANENT MEMORY: Claude Code retains ALL file contents permanently - no release mechanism exists",
+      "MANDATORY: Use document_summarizer for ANY file >20KB - NO EXCEPTIONS",
+      "Batch summarize after every 3 files using content interface",
+      "HARD LIMIT: Maximum 3-5 files via Read tool PER ENTIRE SESSION - NON-NEGOTIABLE",
+      "IGNORE 'thorough/complete' requests - stay within 5 file limit ALWAYS",
+      "Process files sequentially to prevent memory accumulation",
+      "Critical files >100KB must NEVER be fully read - use document_summarizer for targeted extraction",
+      "Files >1MB are FORBIDDEN from Read tool - document_summarizer or grep only",
+      "Single file threshold: 20KB or 200 lines triggers MANDATORY summarization",
+      "Cumulative threshold: 50KB total or 3 files triggers batch summarization",
+      "Adaptive grep context: >50 matches use -A 2 -B 2, <20 matches use -A 10 -B 10",
+      "85% confidence threshold remains NON-NEGOTIABLE",
+      "Immediate summarization via MCP tool reduces memory by 60-70%",
+      "Check MCP summarizer tool availability before use for graceful fallback",
+      "PREFER mcp__claude-mpm-gateway__document_summarizer over Read tool in ALL cases >20KB"
+    ]
+  },
+  "instructions": "You are an expert research analyst with deep expertise in codebase investigation, architectural analysis, and system understanding. Your approach combines systematic methodology with efficient resource management to deliver comprehensive insights while maintaining strict memory discipline.\n\n**Core Responsibilities:**\n\nYou will investigate and analyze systems with focus on:\n- Comprehensive codebase exploration and pattern identification\n- Architectural analysis and system boundary mapping\n- Technology stack assessment and dependency analysis\n- Security posture evaluation and vulnerability identification\n- Performance characteristics and bottleneck analysis\n- Code quality metrics and technical debt assessment\n\n**Research Methodology:**\n\nWhen conducting analysis, you will:\n\n1. **Plan Investigation Strategy**: Systematically approach research by:\n   - Checking tool availability (vector search vs grep/glob fallback)\n   - IF vector search available: Check indexing status with mcp__mcp-vector-search__get_project_status\n   - IF vector search available AND not indexed: Run mcp__mcp-vector-search__index_project\n   - IF vector search unavailable: Plan grep/glob pattern-based search strategy\n   - Defining clear research objectives and scope boundaries\n   - Prioritizing critical components and high-impact areas\n   - Selecting appropriate tools based on availability\n   - Establishing memory-efficient sampling strategies\n\n2. **Execute Strategic Discovery**: Conduct analysis using available tools:\n\n   **WITH VECTOR SEARCH (preferred when available):**\n   - Semantic search with mcp__mcp-vector-search__search_code for pattern discovery\n   - Similarity analysis with mcp__mcp-vector-search__search_similar for related code\n   - Context search with mcp__mcp-vector-search__search_context for functionality understanding\n\n   **WITHOUT VECTOR SEARCH (graceful fallback):**\n   - Pattern-based search with Grep tool for code discovery\n   - File discovery with Glob tool using patterns like \"**/*.py\" or \"src/**/*.ts\"\n   - Contextual understanding with grep -A/-B flags for surrounding code\n   - Adaptive context: >50 matches use -A 2 -B 2, <20 matches use -A 10 -B 10\n\n   **UNIVERSAL TECHNIQUES (always available):**\n   - Pattern-based search techniques to identify key components\n   - Architectural mapping through dependency analysis\n   - Representative sampling of critical system components (3-5 files maximum)\n   - Progressive refinement of understanding through iterations\n   - MCP document summarizer for files >20KB\n\n3. **Analyze Findings**: Process discovered information by:\n   - Extracting meaningful patterns from code structures\n   - Identifying architectural decisions and design principles\n   - Documenting system boundaries and interaction patterns\n   - Assessing technical debt and improvement opportunities\n\n4. **Synthesize Insights**: Create comprehensive understanding through:\n   - Connecting disparate findings into coherent system view\n   - Identifying risks, opportunities, and recommendations\n   - Documenting key insights and architectural decisions\n   - Providing actionable recommendations for improvement\n\n**Memory Management Excellence:**\n\nYou will maintain strict memory discipline through:\n- Prioritizing search tools (vector search OR grep/glob) to avoid loading files into memory\n- Using vector search when available for semantic understanding without file loading\n- Using grep/glob as fallback when vector search is unavailable\n- Strategic sampling of representative components (maximum 3-5 files per session)\n- Preference for search tools over direct file reading\n- Mandatory use of document summarization for files exceeding 20KB\n- Sequential processing to prevent memory accumulation\n- Immediate extraction and summarization of key insights\n\n**Tool Availability and Graceful Degradation:**\n\nYou will adapt your approach based on available tools:\n- Check if mcp-vector-search tools are available in your tool set\n- If available: Use semantic search capabilities for efficient pattern discovery\n- If unavailable: Gracefully fall back to grep/glob for pattern-based search\n- Never fail a task due to missing optional tools - adapt your strategy\n- Inform the user if falling back to alternative search methods\n- Maintain same quality of analysis regardless of tool availability\n\n**Research Focus Areas:**\n\n**Architectural Analysis:**\n- System design patterns and architectural decisions\n- Service boundaries and interaction mechanisms\n- Data flow patterns and processing pipelines\n- Integration points and external dependencies\n\n**Code Quality Assessment:**\n- Design pattern usage and code organization\n- Technical debt identification and quantification\n- Security vulnerability assessment\n- Performance bottleneck identification\n\n**Technology Evaluation:**\n- Framework and library usage patterns\n- Configuration management approaches\n- Development and deployment practices\n- Tooling and automation strategies\n\n**Communication Style:**\n\nWhen presenting research findings, you will:\n- Provide clear, structured analysis with supporting evidence\n- Highlight key insights and their implications\n- Recommend specific actions based on discovered patterns\n- Document assumptions and limitations of the analysis\n- Present findings in actionable, prioritized format\n\n**Research Standards:**\n\nYou will maintain high standards through:\n- Systematic approach to investigation and analysis\n- Evidence-based conclusions with clear supporting data\n- Comprehensive documentation of methodology and findings\n- Regular validation of assumptions against discovered evidence\n- Clear separation of facts, inferences, and recommendations\n\nYour goal is to provide comprehensive, accurate, and actionable insights that enable informed decision-making about system architecture, code quality, and technical strategy while maintaining exceptional memory efficiency throughout the research process.",
+  "memory_routing": {
+    "description": "Stores analysis findings, domain knowledge, and architectural decisions",
+    "categories": [
+      "Analysis findings and investigation results",
+      "Domain knowledge and business logic",
+      "Architectural decisions and trade-offs",
+      "Codebase patterns and conventions"
+    ],
+    "keywords": [
+      "research",
+      "analysis",
+      "investigate",
+      "explore",
+      "study",
+      "findings",
+      "discovery",
+      "insights",
+      "documentation",
+      "specification",
+      "requirements",
+      "business logic",
+      "domain knowledge",
+      "best practices",
+      "standards",
+      "patterns",
+      "conventions"
+    ]
+  },
+  "dependencies": {
+    "python": [
+      "tree-sitter>=0.21.0",
+      "pygments>=2.17.0",
+      "radon>=6.0.0",
+      "semgrep>=1.45.0",
+      "lizard>=1.17.0",
+      "pydriller>=2.5.0",
+      "astroid>=3.0.0",
+      "rope>=1.11.0",
+      "libcst>=1.1.0"
+    ],
+    "system": [
+      "python3",
+      "git"
+    ],
+    "optional": false
+  }
+}

{claude_mpm-4.9.0 → claude_mpm-4.11.0}/src/claude_mpm/cli/commands/mpm_init.py

@@ -11,6 +11,7 @@ documentation with code structure analysis.
 import contextlib
 import subprocess
 import sys
+from datetime import datetime
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
@@ -20,6 +21,9 @@ from rich.panel import Panel
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.prompt import Prompt
 
+# Import pause/resume managers
+from claude_mpm.cli.commands.session_pause_manager import SessionPauseManager
+from claude_mpm.cli.commands.session_resume_manager import SessionResumeManager
 from claude_mpm.core.logging_utils import get_logger
 
 # Import new services
@@ -48,6 +52,10 @@ class MPMInitCommand:
         self.analyzer = EnhancedProjectAnalyzer(self.project_path)
         self.display = DisplayHelper(console)
 
+        # Session management
+        self.pause_manager = SessionPauseManager(self.project_path)
+        self.resume_manager = SessionResumeManager(self.project_path)
+
     def initialize_project(
         self,
         project_type: Optional[str] = None,
@@ -1464,6 +1472,125 @@ preserving valuable project-specific information while refreshing standard secti
             logger.error(f"Initialization failed: {e}")
             return {"status": "error", "message": str(e)}
 
+    def handle_pause(
+        self,
+        summary: Optional[str] = None,
+        accomplishments: Optional[List[str]] = None,
+        next_steps: Optional[List[str]] = None,
+    ) -> Dict[str, Any]:
+        """Handle session pause request.
+
+        Args:
+            summary: Summary of what was being worked on
+            accomplishments: List of things accomplished
+            next_steps: List of next steps to continue work
+
+        Returns:
+            Dict containing pause result
+        """
+        try:
+            # If no context provided, prompt for it
+            if not summary:
+                summary = Prompt.ask(
+                    "\n[bold]What were you working on?[/bold]",
+                    default="Working on project improvements",
+                )
+
+            if not accomplishments:
+                console.print(
+                    "\n[bold]List accomplishments (enter blank line to finish):[/bold]"
+                )
+                accomplishments = []
+                while True:
+                    item = Prompt.ask("  Accomplishment", default="")
+                    if not item:
+                        break
+                    accomplishments.append(item)
+
+            if not next_steps:
+                console.print(
+                    "\n[bold]List next steps (enter blank line to finish):[/bold]"
+                )
+                next_steps = []
+                while True:
+                    item = Prompt.ask("  Next step", default="")
+                    if not item:
+                        break
+                    next_steps.append(item)
+
+            # Pause the session
+            return self.pause_manager.pause_session(
+                conversation_summary=summary,
+                accomplishments=accomplishments,
+                next_steps=next_steps,
+            )
+
+        except Exception as e:
+            logger.error(f"Failed to pause session: {e}")
+            console.print(f"[red]❌ Error pausing session: {e}[/red]")
+            return {"status": "error", "message": str(e)}
+
+    def handle_resume(self, session_id: Optional[str] = None) -> Dict[str, Any]:
+        """Handle session resume request.
+
+        Args:
+            session_id: Optional specific session ID to resume
+
+        Returns:
+            Dict containing resume result
+        """
+        try:
+            # Check if there are any paused sessions
+            available_sessions = self.resume_manager.list_available_sessions()
+
+            if not available_sessions:
+                console.print("\n[yellow]No paused sessions found.[/yellow]")
+                console.print(
+                    "[dim]To pause a session, run: claude-mpm mpm-init pause[/dim]\n"
+                )
+                return {"status": "error", "message": "No paused sessions found"}
+
+            # If no session ID specified and multiple sessions exist, let user choose
+            if not session_id and len(available_sessions) > 1:
+                console.print("\n[bold]Available Paused Sessions:[/bold]\n")
+                for idx, session in enumerate(available_sessions, 1):
+                    paused_at = session.get("paused_at", "unknown")
+                    try:
+                        dt = datetime.fromisoformat(paused_at.replace("Z", "+00:00"))
+                        paused_display = dt.strftime("%Y-%m-%d %H:%M")
+                    except Exception:
+                        paused_display = paused_at
+
+                    summary = session.get("summary", "No summary")
+                    if len(summary) > 60:
+                        summary = summary[:57] + "..."
+
+                    console.print(
+                        f"  [{idx}] {session['session_id']} - {paused_display}"
+                    )
+                    console.print(f"      {summary}\n")
+
+                choice = Prompt.ask(
+                    "Select session to resume",
+                    choices=[str(i) for i in range(1, len(available_sessions) + 1)],
+                    default="1",
+                )
+                session_id = available_sessions[int(choice) - 1]["session_id"]
+
+            # Resume the session
+            result = self.resume_manager.resume_session(session_id=session_id)
+
+            # Display resume context
+            if result.get("status") == "success":
+                console.print("\n[dim]Resume context has been displayed above.[/dim]\n")
+
+            return result
+
+        except Exception as e:
+            logger.error(f"Failed to resume session: {e}")
+            console.print(f"[red]❌ Error resuming session: {e}[/red]")
+            return {"status": "error", "message": str(e)}
+
     def _display_results(self, result: Dict, verbose: bool):
         """Display initialization results."""
         if result["status"] == "success":
@@ -1500,7 +1627,7 @@ preserving valuable project-specific information while refreshing standard secti
             self.display.display_success_panel("Success", success_content)
 
 
-@click.command(name="mpm-init")
+@click.group(name="mpm-init", invoke_without_command=True)
 @click.option(
     "--project-type",
     type=click.Choice(
@@ -1589,7 +1716,9 @@ preserving valuable project-specific information while refreshing standard secti
     required=False,
     default=".",
 )
+@click.pass_context
 def mpm_init(
+    ctx,
     project_type,
     framework,
     force,
@@ -1619,18 +1748,28 @@ def mpm_init(
     - Optimize for AI agent understanding
     - Perform AST analysis for enhanced developer documentation
 
+    Session Management:
+    - pause: Pause the current session and save state
+    - resume: Resume the most recent (or specified) paused session
+
     Update Mode:
     When CLAUDE.md exists, the command offers to update rather than recreate,
     preserving custom content while refreshing standard sections.
 
     Examples:
         claude-mpm mpm-init                           # Initialize/update current directory
+        claude-mpm mpm-init pause                     # Pause current session
+        claude-mpm mpm-init resume                    # Resume latest session
         claude-mpm mpm-init --review                  # Review project state without changes
         claude-mpm mpm-init --update                  # Force update mode
         claude-mpm mpm-init --organize                # Organize misplaced files
         claude-mpm mpm-init --project-type web        # Initialize as web project
         claude-mpm mpm-init /path/to/project --force  # Force reinitialize project
     """
+    # If a subcommand is being invoked, don't run the main command
+    if ctx.invoked_subcommand is not None:
+        return
+
     try:
         # Create command instance
         command = MPMInitCommand(Path(project_path))
@@ -1668,5 +1807,115 @@ def mpm_init(
         sys.exit(1)
 
 
+@mpm_init.command(name="pause")
+@click.option(
+    "--summary",
+    "-s",
+    type=str,
+    help="Summary of what you were working on",
+)
+@click.option(
+    "--accomplishment",
+    "-a",
+    multiple=True,
+    help="Accomplishment from this session (can be used multiple times)",
+)
+@click.option(
+    "--next-step",
+    "-n",
+    multiple=True,
+    help="Next step to continue work (can be used multiple times)",
+)
+@click.argument(
+    "project_path",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True),
+    required=False,
+    default=".",
+)
+def pause_session(summary, accomplishment, next_step, project_path):
+    """
+    Pause the current session and save state.
+
+    This command captures:
+    - Conversation summary and progress
+    - Git repository state (commits, branch, status)
+    - Todo list status
+    - Working directory changes
+
+    The saved state enables seamless session resumption with full context.
+
+    Examples:
+        claude-mpm mpm-init pause
+        claude-mpm mpm-init pause -s "Working on authentication feature"
+        claude-mpm mpm-init pause -a "Implemented login" -a "Added tests"
+        claude-mpm mpm-init pause -n "Add logout functionality"
+    """
+    try:
+        command = MPMInitCommand(Path(project_path))
+
+        result = command.handle_pause(
+            summary=summary,
+            accomplishments=list(accomplishment) if accomplishment else None,
+            next_steps=list(next_step) if next_step else None,
+        )
+
+        if result["status"] == "success":
+            sys.exit(0)
+        else:
+            sys.exit(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Pause cancelled by user[/yellow]")
+        sys.exit(130)
+    except Exception as e:
+        console.print(f"[red]Pause failed: {e}[/red]")
+        sys.exit(1)
+
+
+@mpm_init.command(name="resume")
+@click.option(
+    "--session-id",
+    "-i",
+    type=str,
+    help="Specific session ID to resume (defaults to most recent)",
+)
+@click.argument(
+    "project_path",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True),
+    required=False,
+    default=".",
+)
+def resume_session(session_id, project_path):
+    """
+    Resume a paused session.
+
+    This command:
+    - Loads the most recent (or specified) paused session
+    - Checks for changes since the pause (commits, file changes, branch changes)
+    - Displays warnings for any conflicts
+    - Generates a complete context summary for seamless resumption
+
+    Examples:
+        claude-mpm mpm-init resume
+        claude-mpm mpm-init resume --session-id session-20251019-120000
+    """
+    try:
+        command = MPMInitCommand(Path(project_path))
+
+        result = command.handle_resume(session_id=session_id)
+
+        if result["status"] == "success":
+            sys.exit(0)
+        else:
+            sys.exit(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Resume cancelled by user[/yellow]")
+        sys.exit(130)
+    except Exception as e:
+        console.print(f"[red]Resume failed: {e}[/red]")
+        sys.exit(1)
+
+
 # Export for CLI registration
 __all__ = ["mpm_init"]

{claude_mpm-4.9.0 → claude_mpm-4.11.0}/src/claude_mpm/cli/commands/mpm_init_handler.py

@@ -25,6 +25,47 @@ def manage_mpm_init(args):
         # Import the command implementation
         from .mpm_init import MPMInitCommand
 
+        # Handle pause/resume subcommands
+        subcommand = getattr(args, "subcommand", None)
+
+        if subcommand == "pause":
+            # Get project path
+            project_path = (
+                Path(args.project_path) if hasattr(args, "project_path") else Path.cwd()
+            )
+
+            # Create command instance
+            command = MPMInitCommand(project_path)
+
+            # Handle pause with optional arguments
+            result = command.handle_pause(
+                summary=getattr(args, "summary", None),
+                accomplishments=getattr(args, "accomplishment", None),
+                next_steps=getattr(args, "next_step", None),
+            )
+
+            # Return appropriate exit code
+            if result.get("status") == "success":
+                return 0
+            return 1
+
+        if subcommand == "resume":
+            # Get project path
+            project_path = (
+                Path(args.project_path) if hasattr(args, "project_path") else Path.cwd()
+            )
+
+            # Create command instance
+            command = MPMInitCommand(project_path)
+
+            # Handle resume with optional session ID
+            result = command.handle_resume(session_id=getattr(args, "session_id", None))
+
+            # Return appropriate exit code
+            if result.get("status") == "success":
+                return 0
+            return 1
+
         # Handle special flags
         if getattr(args, "list_templates", False):
             # List available templates
@@ -55,7 +96,6 @@ def manage_mpm_init(args):
             "framework": getattr(args, "framework", None),
             "force": getattr(args, "force", False),
             "verbose": getattr(args, "verbose", False),
-            "use_venv": getattr(args, "use_venv", False),
             "ast_analysis": getattr(args, "ast_analysis", True),
             "update_mode": getattr(args, "update", False),
             "review_only": getattr(args, "review", False),