claude-mpm 4.20.2__tar.gz → 4.20.4__tar.gz

claude_mpm-4.20.4/BUILD_NUMBER

@@ -0,0 +1 @@
+495

{claude_mpm-4.20.2 → claude_mpm-4.20.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.20.2
+Version: 4.20.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
@@ -158,13 +158,11 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
 - 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
-- 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📋 **Resume Log System**: Proactive context management with automatic 10k-token session logs at 70%/85%/95% thresholds
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **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
+- 🔌 **MCP Integration**: Full support for Model Context Protocol services
+- 📁 **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
 - ⚡ **Simplified Architecture**: ~3,700 lines removed for better performance and maintainability
@@ -176,8 +174,8 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 # Basic installation
 pip install claude-mpm
 
-# Install with optional MCP services (recommended)
-pip install "claude-mpm[mcp]"
+# Install with monitoring dashboard (recommended)
+pip install "claude-mpm[monitor]"
 ```
 
 Or with pipx (recommended for isolated installation):
@@ -185,30 +183,87 @@ Or with pipx (recommended for isolated installation):
 # Basic installation
 pipx install claude-mpm
 
-# Install with optional MCP services (recommended)
-pipx install "claude-mpm[mcp]"
-
-# Install with all features
-pipx install "claude-mpm[mcp,monitor]"
-
-# Configure MCP for pipx users:
-claude-mpm mcp-pipx-config
+# Install with monitoring dashboard (recommended)
+pipx install "claude-mpm[monitor]"
 ```
 
 **💡 Optional Dependencies**:
-- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer)
 - `[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
-- **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
+- `[mcp]` - Additional MCP services (mcp-browser, mcp-ticketer) - most users won't need this
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
-- ✅ Commands directory access (fixed) 
+- ✅ Commands directory access (fixed)
 - ✅ Resource files properly packaged for pipx environments
 - ✅ Python 3.13+ fully supported
 
+## 🤝 Recommended Partner Products
+
+Claude MPM works excellently with these complementary MCP tools. While optional, we **strongly recommend** installing them for enhanced capabilities:
+
+### kuzu-memory - Advanced Memory Management
+
+**What it does**: Provides persistent, project-specific knowledge graphs that enable agents to learn and retain context across sessions. Your agents will remember project patterns, architectural decisions, and important context automatically.
+
+**Installation:**
+```bash
+pipx install kuzu-memory
+```
+
+**Benefits with Claude MPM:**
+- 🧠 **Persistent Context**: Agents remember project-specific patterns and decisions across sessions
+- 🎯 **Intelligent Prompts**: Automatically enriches agent prompts with relevant historical context
+- 📊 **Knowledge Graphs**: Structured storage of project knowledge, not just flat memory
+- 🔄 **Seamless Integration**: Works transparently in the background with zero configuration
+- 💡 **Smart Learning**: Agents improve over time as they learn your project's patterns
+
+**Perfect for**: Long-running projects, teams needing consistent context, complex codebases with deep architectural patterns.
+
+**Learn more**: [kuzu-memory on PyPI](https://pypi.org/project/kuzu-memory/) | [GitHub Repository](https://github.com/bobmatnyc/kuzu-memory)
+
+---
+
+### mcp-vector-search - Semantic Code Search
+
+**What it does**: Enables semantic code search across your entire codebase using AI embeddings. Find code by what it *does*, not just what it's *named*. Search for "authentication logic" and find relevant functions even if they're named differently.
+
+**Installation:**
+```bash
+pipx install mcp-vector-search
+```
+
+**Benefits with Claude MPM:**
+- 🔍 **Semantic Discovery**: Find code by intent and functionality, not just keywords
+- 🎯 **Context-Aware**: Understand code relationships and similarities automatically
+- ⚡ **Fast Indexing**: Efficient vector embeddings for large codebases
+- 🔄 **Live Updates**: Automatically tracks code changes and updates index
+- 📊 **Pattern Recognition**: Discover similar code patterns and potential refactoring opportunities
+
+**Use with**: `/mpm-search "authentication logic"` command in Claude Code sessions or `claude-mpm search` CLI command.
+
+**Perfect for**: Large codebases, discovering existing functionality, finding similar implementations, architectural exploration.
+
+**Learn more**: [mcp-vector-search on PyPI](https://pypi.org/project/mcp-vector-search/) | [GitHub Repository](https://github.com/bobmatnyc/mcp-vector-search)
+
+---
+
+### Quick Setup - Both Tools
+
+Install both recommended tools in one go:
+
+```bash
+pipx install kuzu-memory
+pipx install mcp-vector-search
+```
+
+Then verify they're working:
+
+```bash
+claude-mpm verify
+```
+
+**That's it!** These tools integrate automatically with Claude MPM once installed. No additional configuration needed.
+
 **That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
 
 ## Quick Usage
@@ -264,8 +319,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
 - **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
-- **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
-- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
+- **MCP Integration**: Full support for Model Context Protocol services with automatic detection
 - **Service-Oriented Architecture**: Simplified five specialized service domains
 - **Interface-Based Contracts**: All services implement explicit interfaces
 - **Enhanced Performance**: ~3,700 lines removed for better startup time and maintainability

{claude_mpm-4.20.2 → claude_mpm-4.20.4}/README.md

@@ -10,13 +10,11 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
 - 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
-- 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📋 **Resume Log System**: Proactive context management with automatic 10k-token session logs at 70%/85%/95% thresholds
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
-- 🔌 **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
+- 🔌 **MCP Integration**: Full support for Model Context Protocol services
+- 📁 **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
 - ⚡ **Simplified Architecture**: ~3,700 lines removed for better performance and maintainability
@@ -28,8 +26,8 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 # Basic installation
 pip install claude-mpm
 
-# Install with optional MCP services (recommended)
-pip install "claude-mpm[mcp]"
+# Install with monitoring dashboard (recommended)
+pip install "claude-mpm[monitor]"
 ```
 
 Or with pipx (recommended for isolated installation):
@@ -37,30 +35,87 @@ Or with pipx (recommended for isolated installation):
 # Basic installation
 pipx install claude-mpm
 
-# Install with optional MCP services (recommended)
-pipx install "claude-mpm[mcp]"
-
-# Install with all features
-pipx install "claude-mpm[mcp,monitor]"
-
-# Configure MCP for pipx users:
-claude-mpm mcp-pipx-config
+# Install with monitoring dashboard (recommended)
+pipx install "claude-mpm[monitor]"
 ```
 
 **💡 Optional Dependencies**:
-- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer)
 - `[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
-- **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
+- `[mcp]` - Additional MCP services (mcp-browser, mcp-ticketer) - most users won't need this
 
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
-- ✅ Commands directory access (fixed) 
+- ✅ Commands directory access (fixed)
 - ✅ Resource files properly packaged for pipx environments
 - ✅ Python 3.13+ fully supported
 
+## 🤝 Recommended Partner Products
+
+Claude MPM works excellently with these complementary MCP tools. While optional, we **strongly recommend** installing them for enhanced capabilities:
+
+### kuzu-memory - Advanced Memory Management
+
+**What it does**: Provides persistent, project-specific knowledge graphs that enable agents to learn and retain context across sessions. Your agents will remember project patterns, architectural decisions, and important context automatically.
+
+**Installation:**
+```bash
+pipx install kuzu-memory
+```
+
+**Benefits with Claude MPM:**
+- 🧠 **Persistent Context**: Agents remember project-specific patterns and decisions across sessions
+- 🎯 **Intelligent Prompts**: Automatically enriches agent prompts with relevant historical context
+- 📊 **Knowledge Graphs**: Structured storage of project knowledge, not just flat memory
+- 🔄 **Seamless Integration**: Works transparently in the background with zero configuration
+- 💡 **Smart Learning**: Agents improve over time as they learn your project's patterns
+
+**Perfect for**: Long-running projects, teams needing consistent context, complex codebases with deep architectural patterns.
+
+**Learn more**: [kuzu-memory on PyPI](https://pypi.org/project/kuzu-memory/) | [GitHub Repository](https://github.com/bobmatnyc/kuzu-memory)
+
+---
+
+### mcp-vector-search - Semantic Code Search
+
+**What it does**: Enables semantic code search across your entire codebase using AI embeddings. Find code by what it *does*, not just what it's *named*. Search for "authentication logic" and find relevant functions even if they're named differently.
+
+**Installation:**
+```bash
+pipx install mcp-vector-search
+```
+
+**Benefits with Claude MPM:**
+- 🔍 **Semantic Discovery**: Find code by intent and functionality, not just keywords
+- 🎯 **Context-Aware**: Understand code relationships and similarities automatically
+- ⚡ **Fast Indexing**: Efficient vector embeddings for large codebases
+- 🔄 **Live Updates**: Automatically tracks code changes and updates index
+- 📊 **Pattern Recognition**: Discover similar code patterns and potential refactoring opportunities
+
+**Use with**: `/mpm-search "authentication logic"` command in Claude Code sessions or `claude-mpm search` CLI command.
+
+**Perfect for**: Large codebases, discovering existing functionality, finding similar implementations, architectural exploration.
+
+**Learn more**: [mcp-vector-search on PyPI](https://pypi.org/project/mcp-vector-search/) | [GitHub Repository](https://github.com/bobmatnyc/mcp-vector-search)
+
+---
+
+### Quick Setup - Both Tools
+
+Install both recommended tools in one go:
+
+```bash
+pipx install kuzu-memory
+pipx install mcp-vector-search
+```
+
+Then verify they're working:
+
+```bash
+claude-mpm verify
+```
+
+**That's it!** These tools integrate automatically with Claude MPM once installed. No additional configuration needed.
+
 **That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
 
 ## Quick Usage
@@ -116,8 +171,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
 - **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
-- **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
-- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
+- **MCP Integration**: Full support for Model Context Protocol services with automatic detection
 - **Service-Oriented Architecture**: Simplified five specialized service domains
 - **Interface-Based Contracts**: All services implement explicit interfaces
 - **Enhanced Performance**: ~3,700 lines removed for better startup time and maintainability

claude_mpm-4.20.4/VERSION

@@ -0,0 +1 @@
+4.20.4

{claude_mpm-4.20.2 → claude_mpm-4.20.4}/pyproject.toml

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

claude_mpm-4.20.4/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.20.4

{claude_mpm-4.20.2 → claude_mpm-4.20.4}/src/claude_mpm/agents/templates/php-engineer.json

@@ -3,9 +3,14 @@
   "description": "PHP 8.4-8.5 + Laravel 11-12 specialist: strict types, modern security (WebAuthn/passkeys), performance-first applications",
   "schema_version": "1.3.0",
   "agent_id": "php_engineer",
-  "agent_version": "2.0.0",
-  "template_version": "2.0.0",
+  "agent_version": "2.1.0",
+  "template_version": "2.1.0",
   "template_changelog": [
+    {
+      "version": "2.1.0",
+      "date": "2025-11-07",
+      "description": "Added EspoCRM development skill: comprehensive guide for metadata-driven CRM development with progressive disclosure"
+    },
     {
       "version": "2.0.0",
       "date": "2025-10-17",
@@ -36,7 +41,7 @@
     ],
     "author": "Claude MPM Team",
     "created_at": "2025-01-25T00:00:00.000000Z",
-    "updated_at": "2025-10-17T00:00:00.000000Z",
+    "updated_at": "2025-11-07T00:00:00.000000Z",
     "color": "blue"
   },
   "capabilities": {
@@ -276,6 +281,7 @@
     "security-scanning",
     "code-review",
     "refactoring-patterns",
-    "git-workflow"
+    "git-workflow",
+    "espocrm-development"
   ]
 }

{claude_mpm-4.20.2 → claude_mpm-4.20.4}/src/claude_mpm/cli/commands/__init__.py

@@ -20,6 +20,7 @@ from .mcp import manage_mcp
 from .memory import manage_memory
 from .monitor import manage_monitor
 from .run import run_session
+from .skills import manage_skills
 from .tickets import list_tickets, manage_tickets
 
 __all__ = [
@@ -36,6 +37,7 @@ __all__ = [
     "manage_mcp",
     "manage_memory",
     "manage_monitor",
+    "manage_skills",
     # 'run_guarded_session',  # Excluded from default exports (experimental)
     "manage_tickets",
     "run_doctor",