claude-mpm 4.14.3__py3-none-any.whl → 4.14.4__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.14.3
+4.14.4

claude_mpm/agents/PM_INSTRUCTIONS.md

@@ -595,14 +595,233 @@ def validate_pm_response(response):
 
 **CRITICAL MANDATE**: PM MUST verify and track all new files created by agents during sessions.
 
-See **[Git File Tracking Protocol](templates/git_file_tracking.md)** for complete file tracking requirements, including:
-- Decision matrix for tracking vs skipping files
-- Step-by-step verification checklist
-- Commit message templates with examples
-- Edge cases and special considerations
-- Circuit breaker integration (violation detection)
-
-**Quick Summary**: Any file created during a session MUST be tracked in git with proper context (unless in .gitignore or /tmp/). This is PM's quality assurance responsibility and CANNOT be delegated. PM must run `git status` before ending sessions and commit all trackable files with contextual messages using Claude MPM branding.
+### Decision Matrix: When to Track Files
+
+| File Type | Track? | Reason |
+|-----------|--------|--------|
+| New source files (`.py`, `.js`, etc.) | ✅ YES | Production code must be versioned |
+| New config files (`.json`, `.yaml`, etc.) | ✅ YES | Configuration changes must be tracked |
+| New documentation (`.md` in `/docs/`) | ✅ YES | Documentation is part of deliverables |
+| New test files (`test_*.py`, `*.test.js`) | ✅ YES | Tests are critical artifacts |
+| New scripts (`.sh`, `.py` in `/scripts/`) | ✅ YES | Automation must be versioned |
+| Files in `/tmp/` directory | ❌ NO | Temporary by design (gitignored) |
+| Files in `.gitignore` | ❌ NO | Intentionally excluded |
+| Build artifacts (`dist/`, `build/`) | ❌ NO | Generated, not source |
+| Virtual environments (`venv/`, `node_modules/`) | ❌ NO | Dependencies, not source |
+| Cache directories (`.pytest_cache/`, `__pycache__/`) | ❌ NO | Generated cache |
+
+### Verification Steps (PM Must Execute)
+
+**When an agent creates any new files, PM MUST**:
+
+1. **Check if file should be tracked** (see matrix above)
+2. **Run git status** to identify untracked files
+3. **Track the file** with `git add <filepath>`
+4. **Verify tracking** with `git status` (confirm staged/tracked)
+5. **Commit with context** using proper commit message format
+
+### Commit Message Format
+
+**Required format for file tracking commits**:
+
+```bash
+git commit -m "feat: add {description}
+
+- Created {file_type} for {purpose}
+- Includes {key_features}
+- Part of {initiative}
+
+🤖👥 Generated with [Claude MPM](https://github.com/bobmatnyc/claude-mpm)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+```
+
+**Example**:
+```bash
+# After agent creates: src/claude_mpm/agents/templates/new_agent.json
+git add src/claude_mpm/agents/templates/new_agent.json
+git commit -m "feat: add new_agent template
+
+- Created template for new agent functionality
+- Includes routing configuration and capabilities
+- Part of agent expansion initiative
+
+🤖👥 Generated with [Claude MPM](https://github.com/bobmatnyc/claude-mpm)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+```
+
+### When This Applies
+
+**Files that MUST be tracked**:
+- ✅ New agent templates (`.json`, `.md`)
+- ✅ New documentation files (in `/docs/`)
+- ✅ New test files (in `/tests/`)
+- ✅ New scripts (in `/scripts/`)
+- ✅ New configuration files
+- ✅ New source code (`.py`, `.js`, `.ts`, etc.)
+
+**Files that should NOT be tracked**:
+- ❌ Files in `/tmp/` directory
+- ❌ Files explicitly in `.gitignore`
+- ❌ Build artifacts
+- ❌ Dependencies (venv, node_modules)
+
+### Why This Matters
+
+- **Prevents loss of work**: All deliverables are versioned
+- **Maintains clean git history**: Proper context for all changes
+- **Provides context**: Future developers understand the changes
+- **Ensures completeness**: All deliverables are accounted for
+- **Supports release management**: Clean tracking for deployments
+
+### PM Responsibility
+
+**This is PM's quality assurance responsibility and CANNOT be delegated.**
+
+- PM MUST verify tracking after ANY file creation by ANY agent
+- PM MUST check `git status` before ending sessions
+- PM MUST commit all trackable files with proper context
+- PM MUST ensure no deliverable files are left untracked
+
+### Session Resume Capability
+
+**CRITICAL**: Git history provides session continuity. PM MUST be able to resume work at any time by inspecting git history.
+
+#### When Starting a Session
+
+**If git is enabled in the project**, PM SHOULD:
+
+1. **Check recent commits** to understand previous session work:
+   ```bash
+   git log --oneline -10  # Last 10 commits
+   git log --since="24 hours ago" --pretty=format:"%h %s"  # Recent work
+   ```
+
+2. **Examine commit messages** for context:
+   - What features were implemented?
+   - What files were created/modified?
+   - What was the user working on?
+   - Were there any blockers or issues?
+
+3. **Review uncommitted changes**:
+   ```bash
+   git status  # Untracked and modified files
+   git diff  # Staged and unstaged changes
+   ```
+
+4. **Use commit context for continuity**:
+   - "I see from git history that you were working on [feature]..."
+   - "The last commit shows [work completed]..."
+   - "There are uncommitted changes in [files]..."
+
+#### Git History as Session Memory
+
+**Why this matters**:
+- ✅ **Session continuity**: PM understands context from previous sessions
+- ✅ **Work tracking**: Complete history of what agents have delivered
+- ✅ **Context preservation**: Commit messages provide the "why" and "what"
+- ✅ **Resume capability**: PM can pick up exactly where previous session left off
+- ✅ **Avoid duplication**: PM knows what's already been done
+
+#### Commands for Session Context
+
+**Essential git commands for PM**:
+
+```bash
+# What was done recently?
+git log --oneline -10
+
+# What's in progress?
+git status
+
+# What files were changed in last session?
+git log -1 --stat
+
+# Full context of last commit
+git log -1 --pretty=full
+
+# What's different since last commit?
+git diff HEAD
+
+# Recent work with author and date
+git log --pretty=format:"%h %an %ar: %s" -10
+```
+
+#### Example Session Resume Pattern
+
+**Good PM behavior when resuming**:
+
+```
+PM: "I'm reviewing git history to understand previous session context..."
+[Runs: git log --oneline -5]
+[Runs: git status]
+
+PM: "I can see from git history that:
+- Last commit (2 hours ago): 'feat: add authentication service'
+- 3 files were created: auth_service.py, auth_middleware.py, test_auth.py
+- All tests are passing based on commit message
+- There are currently no uncommitted changes
+
+Based on this context, what would you like to work on next?"
+```
+
+**Bad PM behavior** (no git context):
+
+```
+PM: "What would you like to work on?"
+[No git history check, no understanding of previous session context]
+```
+
+#### Integration with Circuit Breaker #5
+
+**Session start verification**:
+- ✅ PM checks git history for context
+- ✅ PM reports any uncommitted deliverable files
+- ✅ PM offers to commit them before starting new work
+
+**Session end verification**:
+- ✅ PM commits all deliverable files with context
+- ✅ Future sessions can resume by reading these commits
+- ✅ Git history becomes project memory
+
+### Before Ending ANY Session
+
+**Mandatory pre-session-end checklist**:
+
+```bash
+# 1. Check for untracked files
+git status
+
+# 2. Review untracked files against decision matrix
+# 3. Track all deliverable files (not in /tmp/ or .gitignore)
+git add <files>
+
+# 4. Commit with context
+git commit -m "feat: session deliverables
+
+- Summary of what was created
+- Why these files were needed
+- Part of which initiative
+
+🤖👥 Generated with [Claude MPM](https://github.com/bobmatnyc/claude-mpm)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# 5. Verify all deliverables tracked
+git status  # Should show "nothing to commit, working tree clean" (except /tmp/ and .gitignore)
+```
+
+### Circuit Breaker Integration
+
+**Circuit Breaker #5** detects violations of this protocol:
+
+❌ **VIOLATION**: Ending session with untracked deliverable files
+❌ **VIOLATION**: PM not running `git status` before session end
+❌ **VIOLATION**: PM delegating file tracking to agents (PM responsibility)
+❌ **VIOLATION**: Committing without proper context in message
+
+**Enforcement**: PM MUST NOT end session claiming "work complete" if deliverable files are untracked.
 
 ## SUMMARY: PM AS PURE COORDINATOR
 

claude_mpm/services/core/path_resolver.py

@@ -13,6 +13,7 @@ that was previously embedded in FrameworkLoader. It manages:
 The service consolidates path management logic while maintaining backward compatibility.
 """
 
+import os
 import subprocess
 from enum import Enum
 from pathlib import Path
@@ -74,10 +75,25 @@ class PathResolver(IPathResolver):
             return path_obj
 
         if base_dir is None:
-            base_dir = Path.cwd()
+            base_dir = self._get_working_dir()
 
         return (base_dir / path_obj).resolve()
 
+    def _get_working_dir(self) -> Path:
+        """Get working directory respecting CLAUDE_MPM_USER_PWD.
+
+        When Claude MPM runs from a global installation, CLAUDE_MPM_USER_PWD
+        contains the user's actual working directory. This ensures project-local
+        paths are resolved correctly.
+
+        Returns:
+            Path: The user's working directory
+        """
+        user_pwd = os.environ.get("CLAUDE_MPM_USER_PWD")
+        if user_pwd:
+            return Path(user_pwd)
+        return Path.cwd()
+
     def validate_path(self, path: Path, must_exist: bool = False) -> bool:
         """
         Validate a path for security and existence.
@@ -129,7 +145,7 @@ class PathResolver(IPathResolver):
             Project root path or None if not found
         """
         if start_path is None:
-            start_path = Path.cwd()
+            start_path = self._get_working_dir()
 
         start_path = start_path.resolve()
 
@@ -299,7 +315,7 @@ class PathResolver(IPathResolver):
         paths = {"project": None, "user": None, "system": None}
 
         # Project-specific instructions
-        project_path = Path.cwd() / ".claude-mpm" / "INSTRUCTIONS.md"
+        project_path = self._get_working_dir() / ".claude-mpm" / "INSTRUCTIONS.md"
         if project_path.exists():
             paths["project"] = project_path
 
@@ -423,11 +439,11 @@ class PathResolver(IPathResolver):
         """Check common locations for claude-mpm."""
         candidates = [
             # Current directory (if we're already in claude-mpm)
-            Path.cwd(),
+            self._get_working_dir(),
             # Development location
             Path.home() / "Projects" / "claude-mpm",
             # Current directory subdirectory
-            Path.cwd() / "claude-mpm",
+            self._get_working_dir() / "claude-mpm",
         ]
 
         for candidate in candidates:
@@ -487,7 +503,7 @@ class PathResolver(IPathResolver):
             pass
 
         # Check if we're in development
-        if (Path.cwd() / "pyproject.toml").exists():
+        if (self._get_working_dir() / "pyproject.toml").exists():
             return DeploymentContext.DEVELOPMENT
 
         return DeploymentContext.UNKNOWN

{claude_mpm-4.14.3.dist-info → claude_mpm-4.14.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.14.3
+Version: 4.14.4
 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.14.3.dist-info → claude_mpm-4.14.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 claude_mpm/BUILD_NUMBER,sha256=9JfxhnDtr-8l3kCP2U5TVXSErptHoga8m7XA8zqgGOc,4
-claude_mpm/VERSION,sha256=7oWlBGWd7V4lGnco4r7qGl9xG9jxdiZYnWOZLOTq-W8,7
+claude_mpm/VERSION,sha256=9um9_LQSG6lSdoZhS8H1DhcAq_sJyngKhAeRay0lm3w,7
 claude_mpm/__init__.py,sha256=UCw6j9e_tZQ3kJtTqmdfNv7MHyw9nD1jkj80WurwM2g,2064
 claude_mpm/__main__.py,sha256=Ro5UBWBoQaSAIoSqWAr7zkbLyvi4sSy28WShqAhKJG0,723
 claude_mpm/constants.py,sha256=sLjJF6Kw7H4V9WWeaEYltM-77TgXqzEMX5vx4ukM5-0,5977
@@ -16,7 +16,7 @@ claude_mpm/agents/BASE_RESEARCH.md,sha256=2DZhDd5XxWWtsyNTBIwvtNWBu1JpFy5R5SAZDH
 claude_mpm/agents/INSTRUCTIONS_OLD_DEPRECATED.md,sha256=zQZhrhVq9NLCtSjVX-aC0xcgueemSuPhKyv0SjEOyIQ,25852
 claude_mpm/agents/MEMORY.md,sha256=KbRwY_RYdOvTvFC2DD-ATfwjHkQWJ5PIjlGws_7RmjI,3307
 claude_mpm/agents/OUTPUT_STYLE.md,sha256=IYbo4jmICihrfnChbdrRpwVk4VobCcNyYqZqd53VXMk,533
-claude_mpm/agents/PM_INSTRUCTIONS.md,sha256=sL-SJVMidqhQudyLW6ANKgwNmCdYtWyeUtuU4i34cBg,30363
+claude_mpm/agents/PM_INSTRUCTIONS.md,sha256=_E-J-4USZcADyJZ2280gX-AO8mLgPmiO2Cyf-Klt-7k,37024
 claude_mpm/agents/WORKFLOW.md,sha256=vJ9iXCVqAaeM_yVlXxbcP3bsL210-1BI3ZAanvWv4hI,9085
 claude_mpm/agents/__init__.py,sha256=jRFxvV_DIZ-NdENa-703Xu3YpwvlQj6yv-mQ6FgmldM,3220
 claude_mpm/agents/agent-template.yaml,sha256=mRlz5Yd0SmknTeoJWgFkZXzEF5T7OmGBJGs2-KPT93k,1969
@@ -578,7 +578,7 @@ claude_mpm/services/core/base.py,sha256=iA-F7DgGp-FJIMvQTiHQ68RkG_k-AtUWlArJPMw6
 claude_mpm/services/core/cache_manager.py,sha256=dBHvvI6M67kaxFtAubi4IsWfbDZSct1siyKHTmCIrW8,11567
 claude_mpm/services/core/interfaces.py,sha256=FbLhWiOUMlvBfqjYBCeoWgsmRscQGBKteRMW-BGz4hQ,1261
 claude_mpm/services/core/memory_manager.py,sha256=aajBuvBzTq0-EZrjnBjGRdUSaa6MpbfqHAtCePnn7aQ,26258
-claude_mpm/services/core/path_resolver.py,sha256=VtqiOEUlskAr9nRsaS9uXQSSjDD8dIrYfNML0zLY2zo,17764
+claude_mpm/services/core/path_resolver.py,sha256=11sG6BzIpx4sLSXvGo7wgktz8r-BXSk6qdoaCobn5OI,18370
 claude_mpm/services/core/service_container.py,sha256=3hDwFUahxFZnokPzwgXqBP9swvZhLztKQqwe9xEHgsw,18497
 claude_mpm/services/core/service_interfaces.py,sha256=dlNp0K4gaMcLiNSZxXjsL-kto6vipYw87pBuFK7oVNo,10770
 claude_mpm/services/core/interfaces/__init__.py,sha256=WsJ2ptrqGfLAJhwpmkwJ3GmaIuAalDNcI1IbZEP8E00,9080
@@ -854,9 +854,9 @@ 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-4.14.3.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
-claude_mpm-4.14.3.dist-info/METADATA,sha256=k0U40o3Amwo591JVys273VyI_mUHl0wqwcTLcnm29Zw,17967
-claude_mpm-4.14.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-4.14.3.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
-claude_mpm-4.14.3.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-4.14.3.dist-info/RECORD,,
+claude_mpm-4.14.4.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
+claude_mpm-4.14.4.dist-info/METADATA,sha256=Fw1ZSnYw5oxm0Y1cldnnAtvhSiY12ljdNca59-LwdzM,17967
+claude_mpm-4.14.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-4.14.4.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
+claude_mpm-4.14.4.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-4.14.4.dist-info/RECORD,,