claude-mpm 4.10.0__tar.gz → 4.11.1__tar.gz

claude_mpm-4.11.1/BUILD_NUMBER

@@ -0,0 +1 @@
+449

{claude_mpm-4.10.0 → claude_mpm-4.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.10.0
+Version: 4.11.1
 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-4.11.1/VERSION

@@ -0,0 +1 @@
+4.11.1

{claude_mpm-4.10.0 → claude_mpm-4.11.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.10.0"
+version = "4.11.1"
 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.10.0"
+version = "4.11.1"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.11.1/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.11.1

{claude_mpm-4.10.0 → claude_mpm-4.11.1}/src/claude_mpm/cli/commands/mpm_init.py

@@ -1464,6 +1464,198 @@ preserving valuable project-specific information while refreshing standard secti
             logger.error(f"Initialization failed: {e}")
             return {"status": "error", "message": str(e)}
 
+    def handle_context(
+        self,
+        session_id: Optional[str] = None,
+        list_sessions: bool = False,
+        days: int = 7,
+    ) -> Dict[str, Any]:
+        """
+        Provide intelligent context for resuming work based on git history.
+
+        Analyzes recent commits to identify:
+        - Active work streams (what was being worked on)
+        - Intent and motivation (why this work)
+        - Risks and blockers
+        - Recommended next actions
+
+        This delegates to Research agent for deep analysis.
+
+        Args:
+            session_id: Unused parameter (for compatibility)
+            list_sessions: Unused parameter (for compatibility)
+            days: Number of days of git history to analyze (default: 7)
+
+        Returns:
+            Dict containing context result
+        """
+        from claude_mpm.utils.git_analyzer import analyze_recent_activity
+
+        # 1. Analyze git history
+        console.print(f"\n🔍 Analyzing last {days} days of git history...\n")
+        git_analysis = analyze_recent_activity(
+            repo_path=str(self.project_path), days=days, max_commits=50
+        )
+
+        if git_analysis.get("error"):
+            console.print(
+                f"[yellow]⚠️  Could not analyze git history: {git_analysis['error']}[/yellow]"
+            )
+            console.print(
+                "[dim]Ensure this is a git repository with commit history.[/dim]\n"
+            )
+            return {
+                "status": "error",
+                "message": git_analysis["error"],
+            }
+
+        if not git_analysis.get("has_activity"):
+            console.print(
+                f"[yellow]⚠️  No git activity found in the last {days} days.[/yellow]"
+            )
+            console.print("[dim]Try increasing the --days parameter.[/dim]\n")
+            return {
+                "status": "error",
+                "message": f"No git activity in last {days} days",
+            }
+
+        # 2. Build Research delegation prompt
+        research_prompt = self._build_research_context_prompt(git_analysis, days)
+
+        # 3. Display prompt for PM to delegate
+        console.print("\n" + "=" * 80)
+        console.print("📋 DELEGATE TO RESEARCH AGENT:")
+        console.print("=" * 80 + "\n")
+        console.print(research_prompt)
+        console.print("\n" + "=" * 80 + "\n")
+
+        return {
+            "status": "context_ready",
+            "git_analysis": git_analysis,
+            "research_prompt": research_prompt,
+            "recommendation": "PM should delegate this prompt to Research agent",
+        }
+
+    def _build_research_context_prompt(
+        self, git_analysis: Dict[str, Any], days: int
+    ) -> str:
+        """Build structured Research agent delegation prompt from git analysis."""
+
+        # Extract key data
+        commits = git_analysis.get("commits", [])
+        branches = git_analysis.get("branches", [])
+        contributors = git_analysis.get("contributors", {})
+        file_changes = git_analysis.get("file_changes", {})
+
+        # Build prompt following Prompt Engineer's template
+        prompt = f"""# Project Context Analysis Mission
+
+You are Research agent analyzing git history to provide PM with intelligent project context for resuming work.
+
+## Analysis Scope
+- **Time Range**: Last {days} days
+- **Commits Analyzed**: {len(commits)} commits
+- **Branches**: {', '.join(branches[:5]) if branches else 'main'}
+- **Contributors**: {', '.join(contributors.keys()) if contributors else 'Unknown'}
+
+## Your Mission
+
+Analyze git history to answer these questions for PM:
+
+1. **What was being worked on?** (Active work streams)
+2. **Why was this work happening?** (Intent and motivation)
+3. **What's the natural next step?** (Continuation recommendations)
+4. **What needs attention?** (Risks, stalls, conflicts)
+
+## Git Data Provided
+
+### Recent Commits ({min(len(commits), 10)} most recent):
+"""
+
+        # Add recent commits
+        for commit in commits[:10]:
+            author = commit.get("author", "Unknown")
+            timestamp = commit.get("timestamp", "Unknown date")
+            message = commit.get("message", "No message")
+            files = commit.get("files", [])
+
+            prompt += f"\n- **{timestamp}** by {author}"
+            prompt += f"\n  {message}"
+            prompt += f"\n  Files changed: {len(files)}\n"
+
+        # Add file change summary
+        if file_changes:
+            # Sort by modifications count
+            sorted_files = sorted(
+                file_changes.items(),
+                key=lambda x: x[1].get("modifications", 0),
+                reverse=True,
+            )
+            prompt += "\n### Most Changed Files:\n"
+            for file_path, file_data in sorted_files[:10]:
+                modifications = file_data.get("modifications", 0)
+                file_contributors = file_data.get("contributors", [])
+                prompt += f"- {file_path}: {modifications} changes ({len(file_contributors)} contributor{'s' if len(file_contributors) != 1 else ''})\n"
+
+        # Add contributor summary
+        if contributors:
+            prompt += "\n### Contributors:\n"
+            sorted_contributors = sorted(
+                contributors.items(),
+                key=lambda x: x[1].get("commits", 0),
+                reverse=True,
+            )
+            for name, info in sorted_contributors[:5]:
+                commit_count = info.get("commits", 0)
+                prompt += f"- {name}: {commit_count} commit{'s' if commit_count != 1 else ''}\n"
+
+        # Add analysis instructions
+        prompt += """
+
+## Analysis Instructions
+
+### Phase 1: Work Stream Identification
+Group related commits into thematic work streams. For each stream:
+- **Name**: Infer from commit messages (e.g., "Authentication refactor")
+- **Status**: ongoing/completed/stalled
+- **Commits**: Count of commits in this stream
+- **Intent**: WHY this work (from commit bodies/messages)
+- **Key Files**: Most changed files in this stream
+
+### Phase 2: Risk Detection
+Identify:
+- **Stalled Work**: Work streams with no activity >3 days
+- **Anti-Patterns**: WIP commits, temp commits, debug commits
+- **Documentation Lag**: Code changes without doc updates
+- **Conflicts**: Merge conflicts or divergent branches
+
+### Phase 3: Recommendations
+Based on analysis:
+1. **Primary Focus**: Most active/recent work to continue
+2. **Quick Wins**: Small tasks that could be finished
+3. **Blockers**: Issues preventing progress
+4. **Next Steps**: Logical continuation points
+
+## Output Format
+
+Provide a clear markdown summary with:
+
+1. **Active Work Streams** (What was being worked on)
+2. **Intent Summary** (Why this work matters)
+3. **Risks Detected** (What needs attention)
+4. **Recommended Next Actions** (What to work on)
+
+Keep it concise (<1000 words) but actionable.
+
+## Success Criteria
+- Work streams accurately reflect development themes
+- Intent captures the "why" not just "what"
+- Recommendations are specific and actionable
+- Risks are prioritized by impact
+"""
+
+        return prompt
+
     def _display_results(self, result: Dict, verbose: bool):
         """Display initialization results."""
         if result["status"] == "success":
@@ -1500,7 +1692,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 +1781,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 +1813,27 @@ def mpm_init(
     - Optimize for AI agent understanding
     - Perform AST analysis for enhanced developer documentation
 
+    Context Management:
+    - resume: Analyze git history to provide context for resuming work
+    - --catchup: Show recent commit history for PM context
+
     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 --catchup                 # Show recent git history for context
         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 +1871,105 @@ def mpm_init(
         sys.exit(1)
 
 
+@mpm_init.command(name="context")
+@click.option(
+    "--session-id",
+    "-i",
+    type=str,
+    help="Unused (for compatibility) - will be removed in future version",
+)
+@click.option(
+    "--days",
+    type=int,
+    default=7,
+    help="Number of days of git history to analyze (default: 7)",
+)
+@click.argument(
+    "project_path",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True),
+    required=False,
+    default=".",
+)
+def context_command(session_id, days, project_path):
+    """
+    Provide intelligent context for resuming work based on git history.
+
+    Analyzes recent git history and generates a Research agent delegation
+    prompt for intelligent project context reconstruction.
+
+    Examples:
+        claude-mpm mpm-init context                  # Analyze last 7 days
+        claude-mpm mpm-init context --days 14        # Analyze last 14 days
+        claude-mpm mpm-init context --days 30        # Analyze last 30 days
+
+    Note: 'resume' is deprecated, use 'context' instead.
+    """
+    try:
+        command = MPMInitCommand(Path(project_path))
+
+        result = command.handle_context(session_id=session_id, days=days)
+
+        if result["status"] == "success" or result["status"] == "context_ready":
+            sys.exit(0)
+        else:
+            sys.exit(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Context analysis cancelled by user[/yellow]")
+        sys.exit(130)
+    except Exception as e:
+        console.print(f"[red]Context analysis failed: {e}[/red]")
+        sys.exit(1)
+
+
+# Add deprecated 'resume' alias for backward compatibility
+@mpm_init.command(name="resume", hidden=True)
+@click.option(
+    "--session-id",
+    "-i",
+    type=str,
+    help="Unused (for compatibility) - will be removed in future version",
+)
+@click.option(
+    "--days",
+    type=int,
+    default=7,
+    help="Number of days of git history to analyze (default: 7)",
+)
+@click.argument(
+    "project_path",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True),
+    required=False,
+    default=".",
+)
+def resume_session(session_id, days, project_path):
+    """
+    [DEPRECATED] Use 'context' instead.
+
+    This command is deprecated and will be removed in a future version.
+    Please use 'claude-mpm mpm-init context' instead.
+    """
+    console.print(
+        "[yellow]⚠️  Warning: 'resume' is deprecated. Use 'context' instead.[/yellow]"
+    )
+    console.print("[dim]Run: claude-mpm mpm-init context[/dim]\n")
+
+    try:
+        command = MPMInitCommand(Path(project_path))
+        result = command.handle_context(session_id=session_id, days=days)
+
+        if result["status"] == "success" or result["status"] == "context_ready":
+            sys.exit(0)
+        else:
+            sys.exit(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Context analysis cancelled by user[/yellow]")
+        sys.exit(130)
+    except Exception as e:
+        console.print(f"[red]Context analysis failed: {e}[/red]")
+        sys.exit(1)
+
+
 # Export for CLI registration
 __all__ = ["mpm_init"]

{claude_mpm-4.10.0 → claude_mpm-4.11.1}/src/claude_mpm/cli/commands/mpm_init_handler.py

@@ -25,6 +25,36 @@ def manage_mpm_init(args):
         # Import the command implementation
         from .mpm_init import MPMInitCommand
 
+        # Handle context subcommands
+        subcommand = getattr(args, "subcommand", None)
+
+        if subcommand in ("context", "resume"):
+            # Show deprecation warning for 'resume'
+            if subcommand == "resume":
+                console.print(
+                    "[yellow]⚠️  Warning: 'resume' is deprecated. Use 'context' instead.[/yellow]"
+                )
+                console.print("[dim]Run: claude-mpm mpm-init context[/dim]\n")
+
+            # 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 context with optional session ID and days
+            result = command.handle_context(
+                session_id=getattr(args, "session_id", None),
+                days=getattr(args, "days", 7),
+            )
+
+            # Return appropriate exit code
+            if result.get("status") in ("success", "context_ready"):
+                return 0
+            return 1
+
         # Handle special flags
         if getattr(args, "list_templates", False):
             # List available templates
@@ -55,7 +85,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),

{claude_mpm-4.10.0 → claude_mpm-4.11.1}/src/claude_mpm/cli/parsers/mpm_init_parser.py

@@ -31,6 +31,7 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         epilog=(
             "Examples:\n"
             "  claude-mpm mpm-init                                    # Initialize/update current directory\n"
+            "  claude-mpm mpm-init --catchup                          # Show recent git history for context\n"
             "  claude-mpm mpm-init --review                           # Review project state without changes\n"
             "  claude-mpm mpm-init --update                           # Update existing CLAUDE.md\n"
             "  claude-mpm mpm-init --quick-update                     # Quick update based on recent git activity\n"
@@ -205,5 +206,64 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         help="Path to project directory (default: current directory)",
     )
 
+    # Add subparsers for context commands
+    subcommands = mpm_init_parser.add_subparsers(
+        dest="subcommand",
+        title="context management",
+        description="Commands for managing project context",
+    )
+
+    # Context subcommand (primary name)
+    context_parser = subcommands.add_parser(
+        "context",
+        help="Provide intelligent context for resuming work",
+        description="Analyze git history to provide context for resuming work",
+        epilog="Note: 'resume' is deprecated, use 'context' instead",
+    )
+    context_parser.add_argument(
+        "--session-id",
+        "-i",
+        type=str,
+        help="Unused (for compatibility) - will be removed in future version",
+    )
+    context_parser.add_argument(
+        "--days",
+        type=int,
+        default=7,
+        help="Number of days of git history to analyze (default: 7)",
+    )
+    context_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        help="Path to project directory (default: current directory)",
+    )
+
+    # Resume subcommand (deprecated alias for backward compatibility)
+    resume_parser = subcommands.add_parser(
+        "resume",
+        help="[DEPRECATED] Use 'context' instead",
+        description="[DEPRECATED] This command is deprecated. Use 'context' instead.\n\n"
+        "Analyze git history to provide context for resuming work",
+    )
+    resume_parser.add_argument(
+        "--session-id",
+        "-i",
+        type=str,
+        help="Unused (for compatibility) - will be removed in future version",
+    )
+    resume_parser.add_argument(
+        "--days",
+        type=int,
+        default=7,
+        help="Number of days of git history to analyze (default: 7)",
+    )
+    resume_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        help="Path to project directory (default: current directory)",
+    )
+
     # Set the command handler
     mpm_init_parser.set_defaults(command="mpm-init")