claude-mpm 3.9.9__tar.gz → 4.0.3__tar.gz

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/MANIFEST.in

@@ -41,4 +41,4 @@ global-exclude __pycache__
 global-exclude *.py[co]
 global-exclude .DS_Store
 recursive-exclude tests *
-recursive-exclude docs *
+recursive-exclude docs *

{claude_mpm-3.9.9/src/claude_mpm.egg-info → claude_mpm-4.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.9.9
+Version: 4.0.3
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -38,6 +38,7 @@ Requires-Dist: python-frontmatter>=1.0.0
 Requires-Dist: mistune>=3.0.0
 Requires-Dist: aiofiles>=23.0.0
 Requires-Dist: mcp>=0.1.0
+Requires-Dist: ijson>=3.2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -45,6 +46,7 @@ Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.2.0; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
@@ -110,6 +112,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume` 
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 🛡️ **Memory Guardian (Experimental)**: Automatic memory monitoring and intelligent restarts to prevent crashes
 - 📁 **Multi-Project Support**: Per-session working directories
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -130,6 +133,9 @@ claude-mpm
 
 # Start with monitoring dashboard
 claude-mpm run --monitor
+
+# Start with memory protection (prevents crashes from large conversations)
+claude-mpm run-guarded
 ```
 
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
@@ -149,10 +155,25 @@ The PM agent automatically delegates work to specialized agents including Resear
 ### Agent Memory System
 Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
 
+### Memory Guardian System (Experimental)
+**⚠️ Beta Feature** - Prevents memory-related crashes through intelligent monitoring and automatic restarts with state preservation.
+
+```bash
+# Start with memory protection (recommended for long sessions)
+claude-mpm run-guarded --accept-experimental
+
+# Custom memory threshold for your system
+claude-mpm run-guarded --memory-threshold 16000 --accept-experimental  # 16GB
+```
+
+**Why Memory Guardian?** Large conversation histories can consume 2GB+ of memory, causing system instability. The Memory Guardian monitors memory usage and performs controlled restarts while preserving your conversation context and work progress.
+
+**Note:** This is an experimental feature in beta. Use `--accept-experimental` to suppress warnings.
+
 ### Real-Time Monitoring
 The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
 
-See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+See [docs/MEMORY.md](docs/MEMORY.md), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/USER_GUIDE_MEMORY_GUARDIAN.md), and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## Documentation
@@ -162,12 +183,15 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **[Installation Guide](docs/user/installation.md)** - Complete installation options
 - **[User Guide](docs/user/)** - Detailed usage documentation
 - **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Memory Guardian Guide](docs/USER_GUIDE_MEMORY_GUARDIAN.md)** - Comprehensive memory protection documentation
 - **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
 
 ### Developer Documentation
 - **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
 - **[API Reference](docs/api/)** - Complete API documentation with Sphinx
 - **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Memory Guardian Technical](docs/MEMORY_GUARDIAN_TECHNICAL.md)** - Technical architecture and implementation details
+- **[Memory Guardian Configuration](docs/MEMORY_GUARDIAN_CONFIG.md)** - Complete configuration reference
 - **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
 - **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
 - **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
@@ -187,9 +211,34 @@ See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/M
 
 ## Development
 
+### Quick Development Setup
+```bash
+# Complete development setup with code formatting and quality tools
+make dev-complete
+
+# Or step by step:
+make setup-dev          # Install in development mode
+make setup-pre-commit    # Set up automated code formatting
+```
+
+### Code Quality & Formatting
+The project uses automated code formatting and quality checks:
+- **Black** for code formatting
+- **isort** for import sorting
+- **flake8** for linting
+- **mypy** for type checking
+- **Pre-commit hooks** for automatic enforcement
+
+See [docs/developer/CODE_FORMATTING.md](docs/developer/CODE_FORMATTING.md) for details.
+
 ### Contributing
 Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
 
+**Development Workflow**:
+1. Run `make dev-complete` to set up your environment
+2. Code formatting happens automatically on commit
+3. All code must pass quality checks before merging
+
 ### Project Structure
 See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
 

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/README.md

@@ -10,6 +10,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume` 
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 🛡️ **Memory Guardian (Experimental)**: Automatic memory monitoring and intelligent restarts to prevent crashes
 - 📁 **Multi-Project Support**: Per-session working directories
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
@@ -30,6 +31,9 @@ claude-mpm
 
 # Start with monitoring dashboard
 claude-mpm run --monitor
+
+# Start with memory protection (prevents crashes from large conversations)
+claude-mpm run-guarded
 ```
 
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
@@ -49,10 +53,25 @@ The PM agent automatically delegates work to specialized agents including Resear
 ### Agent Memory System
 Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
 
+### Memory Guardian System (Experimental)
+**⚠️ Beta Feature** - Prevents memory-related crashes through intelligent monitoring and automatic restarts with state preservation.
+
+```bash
+# Start with memory protection (recommended for long sessions)
+claude-mpm run-guarded --accept-experimental
+
+# Custom memory threshold for your system
+claude-mpm run-guarded --memory-threshold 16000 --accept-experimental  # 16GB
+```
+
+**Why Memory Guardian?** Large conversation histories can consume 2GB+ of memory, causing system instability. The Memory Guardian monitors memory usage and performs controlled restarts while preserving your conversation context and work progress.
+
+**Note:** This is an experimental feature in beta. Use `--accept-experimental` to suppress warnings.
+
 ### Real-Time Monitoring
 The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
 
-See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+See [docs/MEMORY.md](docs/MEMORY.md), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/USER_GUIDE_MEMORY_GUARDIAN.md), and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## Documentation
@@ -62,12 +81,15 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **[Installation Guide](docs/user/installation.md)** - Complete installation options
 - **[User Guide](docs/user/)** - Detailed usage documentation
 - **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Memory Guardian Guide](docs/USER_GUIDE_MEMORY_GUARDIAN.md)** - Comprehensive memory protection documentation
 - **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
 
 ### Developer Documentation
 - **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
 - **[API Reference](docs/api/)** - Complete API documentation with Sphinx
 - **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Memory Guardian Technical](docs/MEMORY_GUARDIAN_TECHNICAL.md)** - Technical architecture and implementation details
+- **[Memory Guardian Configuration](docs/MEMORY_GUARDIAN_CONFIG.md)** - Complete configuration reference
 - **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
 - **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
 - **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
@@ -87,9 +109,34 @@ See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/M
 
 ## Development
 
+### Quick Development Setup
+```bash
+# Complete development setup with code formatting and quality tools
+make dev-complete
+
+# Or step by step:
+make setup-dev          # Install in development mode
+make setup-pre-commit    # Set up automated code formatting
+```
+
+### Code Quality & Formatting
+The project uses automated code formatting and quality checks:
+- **Black** for code formatting
+- **isort** for import sorting
+- **flake8** for linting
+- **mypy** for type checking
+- **Pre-commit hooks** for automatic enforcement
+
+See [docs/developer/CODE_FORMATTING.md](docs/developer/CODE_FORMATTING.md) for details.
+
 ### Contributing
 Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
 
+**Development Workflow**:
+1. Run `make dev-complete` to set up your environment
+2. Code formatting happens automatically on commit
+3. All code must pass quality checks before merging
+
 ### Project Structure
 See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
 

claude_mpm-4.0.3/VERSION

@@ -0,0 +1 @@
+4.0.3

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/claude-mpm

@@ -26,7 +26,7 @@ elif command -v claude-mpm &> /dev/null; then
     FOUND_CLAUDE_MPM=$(command -v claude-mpm)
     RESOLVED_CLAUDE_MPM=$(readlink -f "$FOUND_CLAUDE_MPM" 2>/dev/null || echo "$FOUND_CLAUDE_MPM")
     THIS_SCRIPT=$(readlink -f "$0" 2>/dev/null || echo "$0")
-    
+
     if [ "$RESOLVED_CLAUDE_MPM" = "$THIS_SCRIPT" ]; then
         # The found claude-mpm is actually this script, use the scripts version
         if [ -f "$SCRIPT_DIR/scripts/claude-mpm" ]; then
@@ -42,4 +42,4 @@ elif command -v claude-mpm &> /dev/null; then
 else
     echo "Error: claude-mpm not found. Please run ./install.sh"
     exit 1
-fi
+fi

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
 classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12",]
-dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0", "mcp>=0.1.0",]
+dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0", "mcp>=0.1.0", "ijson>=3.2.0",]
 [[project.authors]]
 name = "Claude MPM Team"
 
@@ -18,7 +18,7 @@ name = "Claude MPM Team"
 text = "MIT"
 
 [project.optional-dependencies]
-dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
+dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy", "pre-commit",]
 docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
 monitor = []
 # Pure Python agent dependencies - no compilation required
@@ -31,6 +31,7 @@ ticket = "claude_mpm.cli.ticket_cli:main"
 claude-mpm-version = "claude_mpm.scripts.manage_version:main"
 claude-mpm-monitor = "claude_mpm.scripts.launch_monitor:main"
 claude-mpm-socketio = "claude_mpm.scripts.socketio_daemon:main"
+claude-mpm-mcp = "claude_mpm.services.mcp_gateway.server.stdio_server:main_sync"
 
 [tool.uv]
 dev-dependencies = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
@@ -54,3 +55,14 @@ claude_mpm = [ "VERSION", "scripts/*", "dashboard/*.html", "dashboard/templates/
 
 [tool.setuptools.packages.find]
 where = [ "src",]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "4.0.3"
+version_files = [
+    "VERSION",
+    "package.json:version"
+]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_incremental = true

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/requirements.txt

@@ -12,7 +12,14 @@ watchdog>=3.0.0
 websockets>=12.0
 python-frontmatter>=1.0.0
 mistune>=3.0.0
+pydantic>=2.0.0
+pydantic-settings>=2.0.0
 
 # Build and dependency management dependencies
 toml>=0.10.2
-packaging>=21.0
+packaging>=21.0
+
+# Development and type checking dependencies
+mypy>=1.0.0
+types-PyYAML>=6.0.0
+types-requests>=2.25.0

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/scripts/ticket

@@ -35,4 +35,4 @@ if [ $# -eq 0 ] || [ "$1" = "help" ] || [ "$1" = "--help" ] || [ "$1" = "-h" ];
 else
     # Pass all arguments to claude-mpm tickets
     exec "$CLAUDE_MPM" tickets "$@"
-fi
+fi

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/setup.py

@@ -1,15 +1,16 @@
 #!/usr/bin/env python3
 """Setup script for claude-mpm."""
 
-from setuptools import setup, find_packages
-from setuptools.command.install import install
-from setuptools.command.develop import develop
 import os
-import sys
 import shutil
 import subprocess
+import sys
 from pathlib import Path
 
+from setuptools import find_packages, setup
+from setuptools.command.develop import develop
+from setuptools.command.install import install
+
 # Read version from VERSION file - single source of truth
 version_file = Path(__file__).parent / "VERSION"
 if version_file.exists():
@@ -17,11 +18,14 @@ if version_file.exists():
 else:
     # Default version if VERSION file is missing
     __version__ = "0.0.0"
-    print("WARNING: VERSION file not found, using default version 0.0.0", file=sys.stderr)
+    print(
+        "WARNING: VERSION file not found, using default version 0.0.0", file=sys.stderr
+    )
 
 
 class PostInstallCommand(install):
     """Post-installation for installation mode."""
+
     def run(self):
         install.run(self)
         self.execute(self._post_install, [], msg="Running post-installation setup...")
@@ -31,27 +35,30 @@ class PostInstallCommand(install):
         # Create user .claude-mpm directory
         user_dir = Path.home() / ".claude-mpm"
         user_dir.mkdir(exist_ok=True)
-        
+
         # Create subdirectories
         (user_dir / "agents" / "user-defined").mkdir(parents=True, exist_ok=True)
         (user_dir / "logs").mkdir(exist_ok=True)
         (user_dir / "config").mkdir(exist_ok=True)
-        
+
+        # Build dashboard assets
+        build_dashboard_assets()
+
         # Install ticket command
         self._install_ticket_command()
-    
+
     def _install_ticket_command(self):
         """Install ticket command wrapper."""
         import site
-        
+
         # Get the scripts directory
-        if hasattr(site, 'USER_BASE'):
+        if hasattr(site, "USER_BASE"):
             scripts_dir = Path(site.USER_BASE) / "bin"
         else:
             scripts_dir = Path(sys.prefix) / "bin"
-        
+
         scripts_dir.mkdir(exist_ok=True)
-        
+
         # Create ticket wrapper script
         ticket_script = scripts_dir / "ticket"
         ticket_content = '''#!/usr/bin/env python3
@@ -68,6 +75,7 @@ if __name__ == "__main__":
 
 class PostDevelopCommand(develop):
     """Post-installation for development mode."""
+
     def run(self):
         develop.run(self)
         self.execute(self._post_develop, [], msg="Running post-development setup...")
@@ -77,17 +85,44 @@ class PostDevelopCommand(develop):
         PostInstallCommand._post_install(self)
 
 
+def build_dashboard_assets():
+    """Build dashboard assets using Vite if Node.js is available."""
+    try:
+        build_script = Path(__file__).parent / "scripts" / "build-dashboard.sh"
+        if build_script.exists():
+            print("Building dashboard assets...")
+            result = subprocess.run(
+                ["bash", str(build_script)],
+                capture_output=True,
+                text=True,
+                cwd=Path(__file__).parent,
+            )
+            if result.returncode != 0:
+                print(f"Warning: Dashboard build failed: {result.stderr}")
+                print(
+                    "Dashboard will use individual script files instead of optimized bundles."
+                )
+            else:
+                print("Dashboard assets built successfully")
+        else:
+            print("Dashboard build script not found, skipping...")
+    except Exception as e:
+        print(f"Warning: Failed to build dashboard assets: {e}")
+
+
 def aggregate_agent_dependencies():
     """Run agent dependency aggregation script."""
     try:
-        script_path = Path(__file__).parent / "scripts" / "aggregate_agent_dependencies.py"
+        script_path = (
+            Path(__file__).parent / "scripts" / "aggregate_agent_dependencies.py"
+        )
         if script_path.exists():
             print("Aggregating agent dependencies...")
             result = subprocess.run(
                 [sys.executable, str(script_path)],
                 capture_output=True,
                 text=True,
-                cwd=Path(__file__).parent
+                cwd=Path(__file__).parent,
             )
             if result.returncode != 0:
                 print(f"Warning: Agent dependency aggregation failed: {result.stderr}")
@@ -103,8 +138,10 @@ def read_requirements():
     """Read requirements from requirements.txt if it exists."""
     req_file = Path(__file__).parent / "requirements.txt"
     if req_file.exists():
-        with open(req_file, 'r') as f:
-            return [line.strip() for line in f if line.strip() and not line.startswith('#')]
+        with open(req_file, "r") as f:
+            return [
+                line.strip() for line in f if line.strip() and not line.startswith("#")
+            ]
     return []
 
 
@@ -116,19 +153,22 @@ def read_optional_dependencies():
             # Try different TOML libraries based on Python version
             if sys.version_info >= (3, 11):
                 import tomllib
-                with open(pyproject_path, 'rb') as f:
+
+                with open(pyproject_path, "rb") as f:
                     data = tomllib.load(f)
             else:
                 try:
                     import tomli as tomllib
-                    with open(pyproject_path, 'rb') as f:
+
+                    with open(pyproject_path, "rb") as f:
                         data = tomllib.load(f)
                 except ImportError:
                     import toml
-                    with open(pyproject_path, 'r') as f:
+
+                    with open(pyproject_path, "r") as f:
                         data = toml.load(f)
-                
-            optional_deps = data.get('project', {}).get('optional-dependencies', {})
+
+            optional_deps = data.get("project", {}).get("optional-dependencies", {})
             return optional_deps
         return {}
     except ImportError:
@@ -156,7 +196,8 @@ setup(
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     include_package_data=True,
-    install_requires=read_requirements() or [
+    install_requires=read_requirements()
+    or [
         "ai-trackdown-pytools>=1.4.0",
         "pyyaml>=6.0",
         "python-dotenv>=0.19.0",
@@ -181,8 +222,8 @@ setup(
         ],
     },
     cmdclass={
-        'install': PostInstallCommand,
-        'develop': PostDevelopCommand,
+        "install": PostInstallCommand,
+        "develop": PostDevelopCommand,
     },
     classifiers=[
         "Development Status :: 3 - Alpha",
@@ -197,4 +238,4 @@ setup(
         "Programming Language :: Python :: 3.12",
     ],
     keywords="claude ai orchestration multi-agent project-management",
-)
+)

claude_mpm-4.0.3/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.0.2

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/src/claude_mpm/__init__.py

@@ -40,6 +40,6 @@ MPMOrchestrator = ClaudeRunner
 
 __all__ = [
     "ClaudeRunner",
-    "MPMOrchestrator", 
+    "MPMOrchestrator",
     "TicketManager",
-]
+]

{claude_mpm-3.9.9 → claude_mpm-4.0.3}/src/claude_mpm/__main__.py

@@ -1,3 +1,5 @@
+from pathlib import Path
+
 """
 Main entry point for claude-mpm package.
 
@@ -9,7 +11,6 @@ keeping this file minimal and focused on its single responsibility.
 """
 
 import sys
-from pathlib import Path
 
 # Add parent directory to path to ensure proper imports
 sys.path.insert(0, str(Path(__file__).parent.parent))
@@ -18,4 +19,4 @@ sys.path.insert(0, str(Path(__file__).parent.parent))
 from claude_mpm.cli import main
 
 if __name__ == "__main__":
-    sys.exit(main())
+    sys.exit(main())

claude_mpm-4.0.3/src/claude_mpm/agents/__init__.py

@@ -0,0 +1,124 @@
+"""
+Claude PM Framework Agents Package
+
+System-level agent implementations with Task Tool integration.
+These agents provide specialized prompts and capabilities for PM orchestration.
+
+Uses unified agent loader to load prompts from JSON templates in agents/templates/
+for better structure and maintainability.
+"""
+
+# Import from unified agent loader
+from .agent_loader import (
+    clear_agent_cache,
+    get_agent_prompt,
+    list_available_agents,
+    validate_agent_files,
+)
+
+# Import agent metadata (previously AGENT_CONFIG)
+from .agents_metadata import (
+    ALL_AGENT_CONFIGS,
+    DATA_ENGINEER_CONFIG,
+    DOCUMENTATION_CONFIG,
+    ENGINEER_CONFIG,
+    OPS_CONFIG,
+    QA_CONFIG,
+    RESEARCH_CONFIG,
+    SECURITY_CONFIG,
+    VERSION_CONTROL_CONFIG,
+)
+
+# Available system agents
+__all__ = [
+    # Generic agent interface
+    "get_agent_prompt",
+    # Agent utility functions
+    "list_available_agents",
+    "clear_agent_cache",
+    "validate_agent_files",
+    # Agent configs
+    "DOCUMENTATION_CONFIG",
+    "VERSION_CONTROL_CONFIG",
+    "QA_CONFIG",
+    "RESEARCH_CONFIG",
+    "OPS_CONFIG",
+    "SECURITY_CONFIG",
+    "ENGINEER_CONFIG",
+    "DATA_ENGINEER_CONFIG",
+    "ALL_AGENT_CONFIGS",
+    # System registry
+    "SYSTEM_AGENTS",
+]
+
+# System agent registry - using generic agent loading
+SYSTEM_AGENTS = {
+    "documentation": {
+        "agent_id": "documentation-agent",
+        "config": DOCUMENTATION_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "version_control": {
+        "agent_id": "version-control-agent",
+        "config": VERSION_CONTROL_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "qa": {
+        "agent_id": "qa-agent",
+        "config": QA_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "research": {
+        "agent_id": "research-agent",
+        "config": RESEARCH_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "ops": {
+        "agent_id": "ops-agent",
+        "config": OPS_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "security": {
+        "agent_id": "security-agent",
+        "config": SECURITY_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "engineer": {
+        "agent_id": "engineer-agent",
+        "config": ENGINEER_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+    "data_engineer": {
+        "agent_id": "data-engineer-agent",
+        "config": DATA_ENGINEER_CONFIG,
+        "version": "2.0.0",
+        "integration": "claude_pm_framework",
+    },
+}
+
+
+def get_system_agent_prompt(agent_type: str) -> str:
+    """
+    Get system agent prompt using the generic interface.
+
+    Args:
+        agent_type: Agent type (e.g., "documentation", "qa", "engineer")
+
+    Returns:
+        Agent prompt string
+
+    Raises:
+        ValueError: If agent type is not found
+    """
+    if agent_type not in SYSTEM_AGENTS:
+        raise ValueError(f"Unknown agent type: {agent_type}")
+
+    agent_id = SYSTEM_AGENTS[agent_type]["agent_id"]
+    return get_agent_prompt(agent_id)