claude-mpm 4.0.25 → 4.1.2

package/README.md

@@ -7,7 +7,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
+- 🧠 **Agent Memory System**: Simple list-based persistent learning with JSON response field updates
 - 🔄 **Session Management**: Resume previous sessions with `--resume` 
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
 - 🔌 **MCP Gateway**: Model Context Protocol integration for extensible tool capabilities
@@ -23,6 +23,13 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 pip install claude-mpm
 ```
 
+Or with pipx (recommended for isolated installation):
+```bash
+pipx install claude-mpm
+# Configure MCP for pipx users:
+claude-mpm mcp-pipx-config
+```
+
 **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
@@ -37,6 +44,9 @@ claude-mpm run --monitor
 # Use MCP Gateway for external tool integration
 claude-mpm mcp
 
+# Run health diagnostics  
+claude-mpm doctor
+
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
 ```
@@ -44,15 +54,17 @@ claude-mpm cleanup-memory
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture (v3.8.2+)
+## Architecture (v4.1.0+)
 
-Following the TSK-0053 refactoring, Claude MPM features:
+Following continuous improvements through v4.1.0, Claude MPM features:
 
-- **Service-Oriented Architecture**: Five specialized service domains
+- **Service-Oriented Architecture**: Five specialized service domains with Socket.IO stability improvements
 - **Interface-Based Contracts**: All services implement explicit interfaces
 - **Dependency Injection**: Service container with automatic resolution
 - **50-80% Performance Improvement**: Through lazy loading and intelligent caching
 - **Enhanced Security**: Comprehensive input validation and sanitization framework
+- **Improved Monitoring**: Enhanced dashboard with hierarchical agent display
+- **Socket.IO Stability**: Major reliability improvements for real-time communication
 
 See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
 
@@ -88,7 +100,7 @@ Claude MPM includes 15 specialized agents:
 - **Code Analyzer** - Static code analysis with AST and tree-sitter
 
 ### Agent Memory System
-Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
+Agents learn project-specific patterns using a simple list format and can update memories via JSON response fields (`remember` for incremental updates, `MEMORIES` for complete replacement). Initialize with `claude-mpm memory init`.
 
 ### MCP Gateway (Model Context Protocol)
 
@@ -141,11 +153,15 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 ### API Documentation
 Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
 
-## Recent Updates (v3.8.2)
+## Recent Updates (v4.1.0)
+
+**Socket.IO Stability Improvements**: Major reliability enhancements for real-time communication with improved error handling and connection management.
+
+**Project Organization**: Comprehensive cleanup and reorganization with structured script directories for better maintainability.
 
-**Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
+**Documentation Consolidation**: Streamlined documentation structure with consolidated guides and improved navigation.
 
-**Process Management Improvements**: Enhanced hook system reliability with automatic process cleanup, timeout protection, and orphan process monitoring to prevent resource leaks.
+**Agent Hierarchy Display**: Enhanced dashboard with hierarchical agent display showing PM at top level with visual distinction for implied vs explicit nodes.
 
 See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
 

package/README.npm.md

@@ -1,6 +1,6 @@
 # Claude MPM (npm wrapper)
 
-This is the npm wrapper for the **Claude Multi-Agent Project Manager (claude-mpm)**, a Python framework that extends Claude Desktop with multi-agent orchestration capabilities.
+This is the npm wrapper for the **Claude Multi-Agent Project Manager (claude-mpm)**, a Python framework that extends Claude Code with multi-agent orchestration capabilities.
 
 ## Requirements
 
@@ -55,7 +55,7 @@ pip install claude-mpm
 - **Memory System**: Persistent agent memory and context management
 - **WebSocket Dashboard**: Real-time monitoring of agent activities
 - **MCP Gateway**: Model Context Protocol server integration
-- **Claude Desktop Integration**: Seamless integration with Anthropic's Claude Desktop
+- **Claude Code Integration**: Seamless integration with Anthropic's Claude Code
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mpm",
-  "version": "4.0.25",
+  "version": "4.1.2",
   "description": "NPM wrapper for claude-mpm Python package - Requires Python 3.8+. Orchestrate Claude with agent delegation and ticket tracking",
   "keywords": [
     "claude",
@@ -52,7 +52,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "vite": "^5.0.0",
-    "terser": "^5.24.0"
+    "terser": "^5.24.0",
+    "vite": "^5.0.0"
+  },
+  "dependencies": {
+    "playwright": "^1.55.0"
   }
 }