claude-mpm 4.3.0__tar.gz → 4.3.4__tar.gz

claude_mpm-4.3.4/BUILD_NUMBER

@@ -0,0 +1 @@
+380

{claude_mpm-4.3.0 → claude_mpm-4.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.3.0
+Version: 4.3.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
@@ -191,9 +191,9 @@ claude-mpm cleanup-memory
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture (v4.1.0+)
+## Architecture (v4.3.3)
 
-Following continuous improvements through v4.1.0, Claude MPM features:
+Following continuous improvements through v4.3.3, Claude MPM features:
 
 - **Service-Oriented Architecture**: Five specialized service domains with Socket.IO stability improvements
 - **Interface-Based Contracts**: All services implement explicit interfaces
@@ -267,40 +267,53 @@ The `--monitor` flag opens a web dashboard showing live agent activity, file ope
 See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
-## Documentation
+## 📚 Documentation
 
-### User Documentation
-- **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
-- **[Installation Guide](docs/user/installation.md)** - Complete installation options
-- **[User Guide](docs/user/)** - Detailed usage documentation
-- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
-- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+**👉 [Complete Documentation Hub](docs/README.md)** - Start here for all documentation!
 
-### 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
-- **[MCP Gateway Guide](docs/developer/13-mcp-gateway/README.md)** - Model Context Protocol integration
-- **[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
-- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
-- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
+### Quick Links by User Type
 
-### API Documentation
-Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
+#### 👥 For Users
+- **[🚀 5-Minute Quick Start](docs/user/quickstart.md)** - Get running immediately
+- **[📦 Installation Guide](docs/user/installation.md)** - All installation methods
+- **[📖 User Guide](docs/user/README.md)** - Complete user documentation
+- **[❓ FAQ](docs/user/faq.md)** - Common questions answered
 
-## Recent Updates (v4.1.0)
+#### 💻 For Developers
+- **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
+- **[💻 Developer Guide](docs/developer/README.md)** - Complete development documentation
+- **[🧪 Contributing](docs/developer/03-development/README.md)** - How to contribute
+- **[📊 API Reference](docs/API.md)** - Complete API documentation
 
-**Socket.IO Stability Improvements**: Major reliability enhancements for real-time communication with improved error handling and connection management.
+#### 🤖 For Agent Creators
+- **[🤖 Agent System](docs/AGENTS.md)** - Complete agent development guide
+- **[📝 Creation Guide](docs/developer/07-agent-system/creation-guide.md)** - Step-by-step tutorials
+- **[📋 Schema Reference](docs/developer/10-schemas/agent_schema_documentation.md)** - Agent format specifications
 
-**Project Organization**: Comprehensive cleanup and reorganization with structured script directories for better maintainability.
+#### 🚀 For Operations
+- **[🚀 Deployment](docs/DEPLOYMENT.md)** - Release management & versioning
+- **[📊 Monitoring](docs/MONITOR.md)** - Real-time dashboard & metrics
+- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Diagnostic & problem resolution
 
-**Documentation Consolidation**: Streamlined documentation structure with consolidated guides and improved navigation.
+### 🎯 Documentation Features
+- **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
+- **Clear User Paths**: Organized by user type and experience level
+- **Cross-Referenced**: Links between related topics and sections
+- **Up-to-Date**: Version 4.3.3 with current information
 
-**Agent Hierarchy Display**: Enhanced dashboard with hierarchical agent display showing PM at top level with visual distinction for implied vs explicit nodes.
+## Recent Updates (v4.3.3)
 
-See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
+**Enhanced PM Instructions**: PM2 deployment support and mandatory web-qa verification for quality assurance.
+
+**Improved Version Management**: Better version comparison logic and agent override warnings for smoother operations.
+
+**Code Quality Improvements**: Auto-fix code formatting and import management with enhanced standard tools recognition.
+
+**Documentation Overhaul**: Unified documentation architecture with single entry point and clear navigation paths.
+
+**Performance Enhancements**: Continued 50-80% performance improvements through intelligent caching and lazy loading.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/user/MIGRATION.md](docs/user/MIGRATION.md) for upgrade instructions.
 
 ## Development
 

{claude_mpm-4.3.0 → claude_mpm-4.3.4}/README.md

@@ -67,9 +67,9 @@ claude-mpm cleanup-memory
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture (v4.1.0+)
+## Architecture (v4.3.3)
 
-Following continuous improvements through v4.1.0, Claude MPM features:
+Following continuous improvements through v4.3.3, Claude MPM features:
 
 - **Service-Oriented Architecture**: Five specialized service domains with Socket.IO stability improvements
 - **Interface-Based Contracts**: All services implement explicit interfaces
@@ -143,40 +143,53 @@ The `--monitor` flag opens a web dashboard showing live agent activity, file ope
 See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
-## Documentation
+## 📚 Documentation
 
-### User Documentation
-- **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
-- **[Installation Guide](docs/user/installation.md)** - Complete installation options
-- **[User Guide](docs/user/)** - Detailed usage documentation
-- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
-- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+**👉 [Complete Documentation Hub](docs/README.md)** - Start here for all documentation!
 
-### 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
-- **[MCP Gateway Guide](docs/developer/13-mcp-gateway/README.md)** - Model Context Protocol integration
-- **[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
-- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
-- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
+### Quick Links by User Type
 
-### API Documentation
-Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
+#### 👥 For Users
+- **[🚀 5-Minute Quick Start](docs/user/quickstart.md)** - Get running immediately
+- **[📦 Installation Guide](docs/user/installation.md)** - All installation methods
+- **[📖 User Guide](docs/user/README.md)** - Complete user documentation
+- **[❓ FAQ](docs/user/faq.md)** - Common questions answered
 
-## Recent Updates (v4.1.0)
+#### 💻 For Developers
+- **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
+- **[💻 Developer Guide](docs/developer/README.md)** - Complete development documentation
+- **[🧪 Contributing](docs/developer/03-development/README.md)** - How to contribute
+- **[📊 API Reference](docs/API.md)** - Complete API documentation
 
-**Socket.IO Stability Improvements**: Major reliability enhancements for real-time communication with improved error handling and connection management.
+#### 🤖 For Agent Creators
+- **[🤖 Agent System](docs/AGENTS.md)** - Complete agent development guide
+- **[📝 Creation Guide](docs/developer/07-agent-system/creation-guide.md)** - Step-by-step tutorials
+- **[📋 Schema Reference](docs/developer/10-schemas/agent_schema_documentation.md)** - Agent format specifications
 
-**Project Organization**: Comprehensive cleanup and reorganization with structured script directories for better maintainability.
+#### 🚀 For Operations
+- **[🚀 Deployment](docs/DEPLOYMENT.md)** - Release management & versioning
+- **[📊 Monitoring](docs/MONITOR.md)** - Real-time dashboard & metrics
+- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Diagnostic & problem resolution
 
-**Documentation Consolidation**: Streamlined documentation structure with consolidated guides and improved navigation.
+### 🎯 Documentation Features
+- **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
+- **Clear User Paths**: Organized by user type and experience level
+- **Cross-Referenced**: Links between related topics and sections
+- **Up-to-Date**: Version 4.3.3 with current information
 
-**Agent Hierarchy Display**: Enhanced dashboard with hierarchical agent display showing PM at top level with visual distinction for implied vs explicit nodes.
+## Recent Updates (v4.3.3)
 
-See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
+**Enhanced PM Instructions**: PM2 deployment support and mandatory web-qa verification for quality assurance.
+
+**Improved Version Management**: Better version comparison logic and agent override warnings for smoother operations.
+
+**Code Quality Improvements**: Auto-fix code formatting and import management with enhanced standard tools recognition.
+
+**Documentation Overhaul**: Unified documentation architecture with single entry point and clear navigation paths.
+
+**Performance Enhancements**: Continued 50-80% performance improvements through intelligent caching and lazy loading.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/user/MIGRATION.md](docs/user/MIGRATION.md) for upgrade instructions.
 
 ## Development
 

claude_mpm-4.3.4/VERSION

@@ -0,0 +1 @@
+4.3.4

{claude_mpm-4.3.0 → claude_mpm-4.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.3.0"
+version = "4.3.4"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -78,7 +78,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.3.0"
+version = "4.3.4"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.3.4/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.3.4

{claude_mpm-4.3.0 → claude_mpm-4.3.4}/src/claude_mpm/agents/PM_INSTRUCTIONS.md

@@ -37,7 +37,7 @@
 ## Workflow Pipeline
 
 ```
-START → Research → Code Analyzer → Implementation → QA → Documentation → END
+START → Research → Code Analyzer → Implementation → Site Deployment → QA → Documentation → END
 ```
 
 ### Phase Details
@@ -45,8 +45,15 @@ START → Research → Code Analyzer → Implementation → QA → Documentation
 1. **Research**: Requirements analysis, success criteria, risks
 2. **Code Analyzer**: Solution review (APPROVED/NEEDS_IMPROVEMENT/BLOCKED)
 3. **Implementation**: Selected agent builds complete solution
-4. **QA**: Real-world testing with evidence (MANDATORY)
-5. **Documentation**: Update docs if code changed
+4. **Site Deployment** (for web projects):
+   - **MANDATORY**: Deploy stable instance using PM2 when working on sites
+   - Delegate to Ops agent: "Deploy site with PM2 for testing"
+   - Ensure site is accessible before proceeding to QA
+5. **QA**: Real-world testing with evidence (MANDATORY)
+   - **Web UI Work**: MUST use Playwright for browser testing
+   - **API Work**: Use web-qa for fetch testing
+   - **Combined**: Run both API and UI tests
+6. **Documentation**: Update docs if code changed
 
 ### Error Handling
 - Attempt 1: Re-delegate with context
@@ -57,13 +64,19 @@ START → Research → Code Analyzer → Implementation → QA → Documentation
 
 **Rule**: No QA = Work incomplete
 
+**MANDATORY Final Verification Step**:
+- **ALL projects**: Must verify work with web-qa agent for fetch tests
+- **Web UI projects**: MUST also use Playwright for browser automation
+- **Site projects**: Verify PM2 deployment is stable and accessible
+
 **Testing Matrix**:
-| Type | Verification | Evidence |
-|------|-------------|----------|
-| API | HTTP calls | curl output |
-| Web | Browser load | Console screenshot |
-| Database | Query execution | SELECT results |
-| Deploy | Live URL | HTTP 200 |
+| Type | Verification | Evidence | Required Agent |
+|------|-------------|----------|----------------|
+| API | HTTP calls | curl/fetch output | web-qa (MANDATORY) |
+| Web UI | Browser automation | Playwright results | web-qa with Playwright |
+| Site Deploy | PM2 status | Process running | Ops → web-qa verify |
+| Database | Query execution | SELECT results | QA |
+| Deploy | Live URL | HTTP 200 | web-qa |
 
 **Reject if**: "should work", "looks correct", "theoretically"
 **Accept if**: "tested with output:", "verification shows:", "actual results:"
@@ -108,14 +121,24 @@ User Request
   ↓
 Override? → YES → PM executes
   ↓ NO
-Research → Code Analyzer → Implementation → QA (MANDATORY) → Documentation → Report
+Research → Code Analyzer → Implementation →
+  ↓
+Is Site? → YES → PM2 Deploy (Ops)
+  ↓ NO
+QA Verification (MANDATORY):
+  - web-qa for ALL projects (fetch tests)
+  - Playwright for Web UI
+  ↓
+Documentation → Report
 ```
 
 ### Common Patterns
-- Full Stack: Research → Analyzer → react-engineer + Engineer → api-qa + web-qa → Docs
-- API: Research → Analyzer → Engineer → api-qa → Docs
-- Deploy: Research → Ops → web-qa → Docs
-- Bug Fix: Research → Analyzer → Engineer → QA → version-control
+- Full Stack: Research → Analyzer → react-engineer + Engineer → Ops (PM2) → api-qa + web-qa (Playwright) → Docs
+- API: Research → Analyzer → Engineer → web-qa (fetch tests) → Docs
+- Web UI: Research → Analyzer → web-ui/react-engineer → Ops (PM2) → web-qa (Playwright) → Docs
+- Site Project: Research → Analyzer → Engineer → Ops (PM2 deploy) → web-qa (verify deployment) → Docs
+- Deploy: Research → Ops (PM2 for sites) → web-qa (verify accessible) → Docs
+- Bug Fix: Research → Analyzer → Engineer → web-qa (regression test) → version-control
 
 ### Success Criteria
 ✅ Measurable: "API returns 200", "Tests pass 80%+"