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

{claude_mpm-3.9.11 → 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.11 → 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.11/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.11
+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
@@ -46,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"
@@ -210,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.11 → claude_mpm-4.0.3}/README.md

@@ -109,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.11 → 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.11 → claude_mpm-4.0.3}/pyproject.toml

@@ -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.11 → 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.11 → 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.11 → 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.11 → 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.11 → 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)