claude-mpm 4.3.22__tar.gz → 4.4.3__tar.gz

claude_mpm-4.4.3/BUILD_NUMBER

@@ -0,0 +1 @@
+401

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/CLAUDE.md

@@ -2,7 +2,33 @@
 
 This document provides development guidelines for the claude-mpm project codebase.
 
-## IMPORTANT: Git Commit Message Format
+---
+
+## 🔴 Critical Priority Index
+
+**Essential items you MUST know immediately:**
+
+1. **🔴 [Git Commit Format](#important-git-commit-message-format)** - Use Claude MPM branding, not Claude Code
+2. **🔴 [Never Assume - Always Verify](#critical-principles)** - Core development principle
+3. **🔴 [Quality Commands](#daily-development-commands)** - `make lint-fix`, `make quality`, `make safe-release-build`
+4. **🔴 [File Organization](#project-structure-requirements)** - Scripts in `/scripts/`, tests in `/tests/`, modules in `/src/claude_mpm/`
+5. **🔴 [Development Environment](#development-environment)** - Use `./scripts/claude-mpm --use-venv` for reliable operation
+6. **🔴 [Temporary Files](#temporary-files-and-test-outputs)** - All temp files go in `/tmp/` directory
+
+**🟡 Important items for effective development:**
+- **[Architecture Overview](#architecture-v442)** - Service-oriented architecture with interfaces
+- **[Documentation Index](#-primary-entry-point)** - Start here for navigation
+- **[Service Development](#adding-a-new-service)** - Interface-based patterns
+- **[Version Management](#version-management)** - Dual tracking system
+
+**🟢 Recommended for comprehensive understanding:**
+- **[Common Issues](#common-issues-and-solutions)** - Troubleshooting guide
+- **[Contributing Guidelines](#contributing)** - Code quality standards
+- **[Deployment Process](#deployment-process)** - Release procedures
+
+---
+
+## 🔴 IMPORTANT: Git Commit Message Format
 
 When creating git commits in this project, ALWAYS use the Claude MPM branding:
 
@@ -23,7 +49,7 @@ Note: A git hook at `.git/hooks/prepare-commit-msg` will automatically fix this
 
 Claude MPM (Multi-Agent Project Manager) is a framework that extends Claude Code with orchestration capabilities for multiple specialized agents, featuring a modern service-oriented architecture with interface-based contracts and dependency injection.
 
-## Architecture (v4.0.25+)
+## 🟡 Architecture (v4.4.2)
 
 Following the TSK-0053 refactoring, Claude MPM features:
 
@@ -68,7 +94,7 @@ Claude MPM supports both Mamba and traditional Python venv environments:
 - **Mamba status**: Currently experiencing dependency conflicts (see [DEVELOPMENT_SETUP.md](docs/user/getting-started/DEVELOPMENT_SETUP.md))
 - **Force venv**: Use `./scripts/claude-mpm --use-venv` for reliable operation
 
-### Critical Principles
+### 🔴 Critical Principles
 
 **🔴 NEVER ASSUME - ALWAYS VERIFY**
 - **NEVER assume** file locations, configurations, or implementations
@@ -77,7 +103,7 @@ Claude MPM supports both Mamba and traditional Python venv environments:
 - **NEVER guess** at directory structures or file contents
 - **ALWAYS confirm** dependencies and imports exist before using them
 
-### Project Structure Requirements
+### 🔴 Project Structure Requirements
 
 1. **File Organization**: Always refer to `docs/developer/STRUCTURE.md` when creating new files
    - **Scripts**: ALL scripts go in `/scripts/`, NEVER in project root
@@ -89,7 +115,7 @@ Claude MPM supports both Mamba and traditional Python venv environments:
    - Never use relative imports in main code
    - Check existing patterns before adding new imports
 
-### Testing Requirements
+### 🔴 Testing Requirements
 
 **Modern Quality Commands (Recommended):**
 ```bash

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.3.22
+Version: 4.4.3
 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
@@ -41,6 +41,7 @@ Requires-Dist: python-frontmatter>=1.0.0
 Requires-Dist: mistune>=3.0.0
 Requires-Dist: tree-sitter>=0.21.0
 Requires-Dist: ijson>=3.2.0
+Requires-Dist: kuzu-memory>=1.1.1
 Requires-Dist: mcp>=0.1.0
 Requires-Dist: mcp-vector-search>=0.1.0
 Requires-Dist: mcp-browser>=0.1.0
@@ -49,7 +50,6 @@ Requires-Dist: toml>=0.10.2
 Requires-Dist: packaging>=21.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: textual>=0.47.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pyee>=13.0.0
 Requires-Dist: importlib-resources>=5.0; python_version < "3.9"
@@ -147,21 +147,21 @@ Dynamic: license-file
 
 # Claude MPM - Multi-Agent Project Manager
 
-A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
+A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
 
 > **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
 
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🧠 **Agent Memory System**: Simple list-based persistent learning with JSON response field updates
-- 🔄 **Session Management**: Resume previous sessions with `--resume` 
+- 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
+- 🔄 **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
-- 📁 **Multi-Project Support**: Per-session working directories
+- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
-- ⚡ **50-80% Performance Improvement**: Through intelligent caching and lazy loading
+- ⚡ **Simplified Architecture**: ~3,700 lines removed for better performance and maintainability
 - 🔒 **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 ## Quick Installation
@@ -214,17 +214,17 @@ claude-mpm cleanup-memory
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture (v4.3.3)
+## Architecture (v4.4.1)
 
-Following continuous improvements through v4.3.3, Claude MPM features:
+Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
-- **Service-Oriented Architecture**: Five specialized service domains with Socket.IO stability improvements
+- **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
+- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
+- **Service-Oriented Architecture**: Simplified five specialized service domains
 - **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 Performance**: ~3,700 lines removed for better startup time and maintainability
 - **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.
 

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/README.md

@@ -1,20 +1,20 @@
 # Claude MPM - Multi-Agent Project Manager
 
-A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
+A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
 
 > **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
 
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🧠 **Agent Memory System**: Simple list-based persistent learning with JSON response field updates
-- 🔄 **Session Management**: Resume previous sessions with `--resume` 
+- 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
+- 🔄 **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
-- 📁 **Multi-Project Support**: Per-session working directories
+- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
-- ⚡ **50-80% Performance Improvement**: Through intelligent caching and lazy loading
+- ⚡ **Simplified Architecture**: ~3,700 lines removed for better performance and maintainability
 - 🔒 **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 ## Quick Installation
@@ -67,17 +67,17 @@ claude-mpm cleanup-memory
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture (v4.3.3)
+## Architecture (v4.4.1)
 
-Following continuous improvements through v4.3.3, Claude MPM features:
+Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
 
-- **Service-Oriented Architecture**: Five specialized service domains with Socket.IO stability improvements
+- **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
+- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
+- **Service-Oriented Architecture**: Simplified five specialized service domains
 - **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 Performance**: ~3,700 lines removed for better startup time and maintainability
 - **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.
 

claude_mpm-4.4.3/VERSION

@@ -0,0 +1 @@
+4.4.3

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.3.22"
+version = "4.4.3"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
 keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
 classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "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", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "tree-sitter>=0.21.0", "ijson>=3.2.0", "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.0", "toml>=0.10.2", "packaging>=21.0", "pydantic>=2.0.0", "pydantic-settings>=2.0.0", "textual>=0.47.0", "rich>=13.0.0", "pyee>=13.0.0", "importlib-resources>=5.0; python_version < '3.9'", "pathspec>=0.11.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", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "tree-sitter>=0.21.0", "ijson>=3.2.0", "kuzu-memory>=1.1.1", "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.0", "toml>=0.10.2", "packaging>=21.0", "pydantic>=2.0.0", "pydantic-settings>=2.0.0", "rich>=13.0.0", "pyee>=13.0.0", "importlib-resources>=5.0; python_version < '3.9'", "pathspec>=0.11.0",]
 [[project.authors]]
 name = "Bob Matsuoka"
 email = "bob@matsuoka.com"
@@ -79,7 +79,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.3.22"
+version = "4.4.3"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.4.3/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.4.3

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/src/claude_mpm/agents/WORKFLOW.md

@@ -67,20 +67,8 @@ Return: Clean or list of blocked items
 **When user mentions**: ticket, epic, issue, task tracking
 
 **Process**:
-1. Create ISS (single session) or EP (multi-session)
-2. Create TSK for each phase completed
-3. Update with `aitrackdown comment/transition`
-
-**Hierarchy**:
-```
-EP-0001 (Epic)
-└── ISS-0001 (Session Issue)
-    ├── TSK-0001 (Research)
-    ├── TSK-0002 (Code Analyzer)
-    ├── TSK-0003 (Implementation)
-    ├── TSK-0004 (QA)
-    └── TSK-0005 (Documentation)
-```
+Use the mcp-ticketer MCP service for ticket management.
+Ticketing is handled through the MCP Gateway, not internal CLI commands.
 
 ## Structural Delegation Format
 

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/src/claude_mpm/cli/commands/configure.py

@@ -246,35 +246,8 @@ class ConfigureCommand(BaseCommand):
         return self._run_interactive_tui(args)
 
     def _run_interactive_tui(self, args) -> CommandResult:
-        """Run the main interactive TUI."""
-        # Check if we can use the modern Textual TUI
-        use_textual = getattr(args, "use_textual", True)
-        force_rich = getattr(args, "force_rich", False)
-
-        if use_textual and not force_rich:
-            try:
-                # Try to import and use Textual TUI
-                from .configure_tui import can_use_tui, launch_tui
-
-                if can_use_tui():
-                    self.console.print(
-                        "[cyan]Launching full-screen configuration interface...[/cyan]"
-                    )
-                    return launch_tui(self.current_scope, self.project_dir)
-                # Fall back to Rich TUI if terminal doesn't support full-screen
-                self.console.print(
-                    "[yellow]Terminal doesn't support full-screen mode. Using menu interface.[/yellow]"
-                )
-            except ImportError:
-                # Textual not available, fall back to Rich
-                self.console.print(
-                    "[yellow]Textual not installed. Using menu interface.[/yellow]"
-                )
-                self.console.print(
-                    "[dim]Install textual for a better experience: pip install textual[/dim]"
-                )
-
-        # Original Rich-based TUI
+        """Run the main interactive menu interface."""
+        # Rich-based menu interface
         try:
             self.console.clear()
 

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/src/claude_mpm/cli/commands/doctor.py

@@ -107,8 +107,8 @@ def doctor_command(args):
         Exit code (0 for success, 1 for warnings, 2 for errors)
     """
     # Configure logging
-from claude_mpm.core.logging_utils import get_logger
-logger = get_logger(__name__)
+    from claude_mpm.core.logging_utils import get_logger
+    logger = get_logger(__name__)
 
     # Determine output format
     if args.json:

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/src/claude_mpm/cli/commands/mpm_init.py

@@ -643,9 +643,9 @@ The final CLAUDE.md should be a comprehensive, well-organized guide that any AI
             ):
                 checks_passed.append("Archived existing CLAUDE.md")
 
-        # Check for issues
-        if structure_report.get('issues'):
-            for issue in structure_report['issues']:
+        # Check for issues in validation report
+        if validation.get('issues'):
+            for issue in validation['issues']:
                 warnings.append(issue['description'])
 
         if warnings:

{claude_mpm-4.3.22 → claude_mpm-4.4.3}/src/claude_mpm/cli/parsers/configure_parser.py

@@ -25,11 +25,11 @@ def add_configure_subparser(subparsers) -> argparse.ArgumentParser:
     Returns:
         The configured configure subparser
     """
-    # Configure command - interactive TUI configuration
+    # Configure command - interactive configuration
     configure_parser = subparsers.add_parser(
         CLICommands.CONFIGURE.value,
-        help="Interactive terminal-based configuration interface for managing agents and behaviors",
-        description="Launch an interactive Rich-based TUI for configuring claude-mpm agents, templates, and behavior files",
+        help="Interactive configuration interface for managing agents and behaviors",
+        description="Launch an interactive Rich-based menu for configuring claude-mpm agents, templates, and behavior files",
     )
 
     # Add common arguments
@@ -122,21 +122,10 @@ def add_configure_subparser(subparsers) -> argparse.ArgumentParser:
     # Display options
     display_group = configure_parser.add_argument_group("display options")
     display_group.add_argument(
-        "--no-colors", action="store_true", help="Disable colored output in the TUI"
+        "--no-colors", action="store_true", help="Disable colored output in the interface"
     )
     display_group.add_argument(
         "--compact", action="store_true", help="Use compact display mode"
     )
-    display_group.add_argument(
-        "--force-rich",
-        action="store_true",
-        help="Force use of Rich menu interface instead of full-screen Textual TUI",
-    )
-    display_group.add_argument(
-        "--no-textual",
-        dest="use_textual",
-        action="store_false",
-        help="Disable Textual TUI and use Rich menu interface",
-    )
 
     return configure_parser

claude_mpm-4.4.3/src/claude_mpm/core/framework/__init__.py

@@ -0,0 +1,38 @@
+"""Framework module for Claude MPM.
+
+This module provides the modular framework loading system with specialized components
+for handling different aspects of framework initialization and management.
+"""
+
+from .loaders import (
+    AgentLoader,
+    FileLoader,
+    InstructionLoader,
+    PackagedLoader,
+)
+from .formatters import (
+    CapabilityGenerator,
+    ContentFormatter,
+    ContextGenerator,
+)
+from .processors import (
+    MemoryProcessor,
+    MetadataProcessor,
+    TemplateProcessor,
+)
+
+__all__ = [
+    # Loaders
+    "FileLoader",
+    "PackagedLoader",
+    "InstructionLoader",
+    "AgentLoader",
+    # Formatters
+    "ContentFormatter",
+    "CapabilityGenerator",
+    "ContextGenerator",
+    # Processors
+    "MetadataProcessor",
+    "TemplateProcessor",
+    "MemoryProcessor",
+]

claude_mpm-4.4.3/src/claude_mpm/core/framework/formatters/__init__.py

@@ -0,0 +1,11 @@
+"""Framework formatters for content generation and formatting."""
+
+from .capability_generator import CapabilityGenerator
+from .content_formatter import ContentFormatter
+from .context_generator import ContextGenerator
+
+__all__ = [
+    "ContentFormatter",
+    "CapabilityGenerator",
+    "ContextGenerator",
+]