claude-mpm 4.14.8__tar.gz → 4.15.0__tar.gz

claude_mpm-4.15.0/BUILD_NUMBER

@@ -0,0 +1 @@
+471

claude_mpm-4.15.0/CLAUDE.md

@@ -0,0 +1,51 @@
+# Project Memory Configuration
+
+This project uses KuzuMemory for intelligent context management.
+
+## Project Information
+- **Path**: /Users/masa/Projects/claude-mpm
+- **Language**: Python
+- **Framework**: Flask
+
+## Memory Integration
+
+KuzuMemory is configured to enhance all AI interactions with project-specific context.
+
+### Available Commands:
+- `kuzu-memory enhance <prompt>` - Enhance prompts with project context
+- `kuzu-memory learn <content>` - Store learning from conversations (async)
+- `kuzu-memory recall <query>` - Query project memories
+- `kuzu-memory stats` - View memory statistics
+
+### MCP Tools Available:
+When interacting with Claude Desktop, the following MCP tools are available:
+- **kuzu_enhance**: Enhance prompts with project memories
+- **kuzu_learn**: Store new learnings asynchronously
+- **kuzu_recall**: Query specific memories
+- **kuzu_stats**: Get memory system statistics
+
+## Project Context
+
+Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
+
+## Key Technologies
+- Python
+- Flask
+- Flask
+
+## Development Guidelines
+- Use kuzu-memory enhance for all AI interactions
+- Store important decisions with kuzu-memory learn
+- Query context with kuzu-memory recall when needed
+- Keep memories project-specific and relevant
+
+## Memory Guidelines
+
+- Store project decisions and conventions
+- Record technical specifications and API details
+- Capture user preferences and patterns
+- Document error solutions and workarounds
+
+---
+
+*Generated by KuzuMemory Claude Hooks Installer*

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.14.8
+Version: 4.15.0
 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

claude_mpm-4.15.0/VERSION

@@ -0,0 +1 @@
+4.15.0

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/pyproject.toml

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

claude_mpm-4.15.0/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.15.0

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/agents/agent_loader.py

@@ -38,6 +38,8 @@ from enum import Enum
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple, Union
 
+from claude_mpm.core.enums import AgentCategory
+
 # Module-level logger
 from claude_mpm.core.logging_utils import get_logger
 
@@ -281,11 +283,21 @@ class AgentLoader:
         # Check for project memory
         has_memory = capabilities.get("has_project_memory", False)
 
+        # Get category with enum validation (fallback to GENERAL if invalid)
+        category_str = metadata.get("category", "general")
+        try:
+            category = AgentCategory(category_str)
+        except ValueError:
+            logger.warning(
+                f"Invalid category '{category_str}' for agent {agent_id}, using GENERAL"
+            )
+            category = AgentCategory.GENERAL
+
         result = {
             "agent_id": agent_id,
             "name": metadata.get("name", agent_id),
             "description": metadata.get("description", ""),
-            "category": metadata.get("category", "general"),
+            "category": category.value,  # Store as string for backward compatibility
             "version": metadata.get("version", "1.0.0"),
             "model": agent_data.get("model", "claude-sonnet-4-20250514"),
             "resource_tier": agent_data.get("resource_tier", "standard"),

claude_mpm-4.15.0/src/claude_mpm/agents/templates/project_organizer.json

@@ -0,0 +1,133 @@
+{
+  "schema_version": "1.2.0",
+  "agent_id": "project-organizer",
+  "agent_version": "1.2.0",
+  "agent_type": "ops",
+  "metadata": {
+    "name": "Project Organizer Agent",
+    "description": "Intelligent project file organization manager that learns patterns and enforces consistent structure",
+    "category": "project-management",
+    "tags": [
+      "organization",
+      "file-management",
+      "project-structure",
+      "pattern-detection"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-08-15T00:00:00.000000Z",
+    "updated_at": "2025-10-26T00:00:00.000000Z",
+    "color": "purple"
+  },
+  "capabilities": {
+    "model": "sonnet",
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Bash",
+      "Grep",
+      "Glob",
+      "LS",
+      "TodoWrite"
+    ],
+    "resource_tier": "standard",
+    "max_tokens": 8192,
+    "temperature": 0.2,
+    "timeout": 600,
+    "memory_limit": 2048,
+    "cpu_limit": 40,
+    "network_access": false,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Project Organizer Agent\n\n**Inherits from**: BASE_OPS_AGENT.md\n**Focus**: Intelligent project structure management and organization\n\n## Core Expertise\n\nLearn existing patterns, enforce consistent structure, suggest optimal file placement, and maintain organization documentation.\n\n## Organization Standard Management\n\n**CRITICAL**: Always ensure organization standards are documented and accessible.\n\n### Standard Documentation Protocol\n\n1. **Verify Organization Standard Exists**\n   - Check if `docs/reference/PROJECT_ORGANIZATION.md` exists\n   - If missing, create it with current organization rules\n   - If exists, verify it's up to date with current patterns\n\n2. **Update CLAUDE.md Linking**\n   - Verify CLAUDE.md links to PROJECT_ORGANIZATION.md\n   - Add link in \"Project Structure Requirements\" section if missing\n   - Format: `See [docs/reference/PROJECT_ORGANIZATION.md](docs/reference/PROJECT_ORGANIZATION.md)`\n\n3. **Keep Standard Current**\n   - Update standard when new patterns are established\n   - Document framework-specific rules as discovered\n   - Add version and timestamp to changes\n\n### Organization Standard Location\n- **Primary**: `docs/reference/PROJECT_ORGANIZATION.md`\n- **Reference from**: CLAUDE.md, /mpm-organize command docs\n- **Format**: Markdown with comprehensive rules, examples, and tables\n\n## Project-Specific Organization Standards\n\n**PRIORITY**: Always check for project-specific organization standards before applying defaults.\n\n### Standard Detection and Application Protocol\n\n1. **Check for PROJECT_ORGANIZATION.md** (in order of precedence):\n   - First: Project root (`./PROJECT_ORGANIZATION.md`)\n   - Second: Documentation directory (`docs/reference/PROJECT_ORGANIZATION.md`)\n   - Third: Docs root (`docs/PROJECT_ORGANIZATION.md`)\n\n2. **If PROJECT_ORGANIZATION.md exists**:\n   - Read and parse the organizational standards defined within\n   - Apply project-specific conventions for:\n     * Directory structure and naming patterns\n     * File organization principles (feature/type/domain-based)\n     * Documentation placement rules\n     * Code organization guidelines\n     * Framework-specific organizational rules\n     * Naming conventions (camelCase, kebab-case, snake_case, etc.)\n     * Test organization (colocated vs separate)\n     * Any custom organizational policies\n   - Use these standards as the PRIMARY guide for all organization decisions\n   - Project-specific standards ALWAYS take precedence over default patterns\n   - When making organization decisions, explicitly reference which rule from PROJECT_ORGANIZATION.md is being applied\n\n3. **If PROJECT_ORGANIZATION.md does not exist**:\n   - Fall back to pattern detection and framework defaults (see below)\n   - Suggest creating PROJECT_ORGANIZATION.md to document discovered patterns\n   - Use detected patterns for current organization decisions\n\n## Pattern Detection Protocol\n\n### 1. Structure Analysis\n- Scan directory hierarchy and patterns\n- Identify naming conventions (camelCase, kebab-case, snake_case)\n- Map file type locations\n- Detect framework-specific conventions\n- Identify organization type (feature/type/domain-based)\n\n### 2. Pattern Categories\n- **By Feature**: `/features/auth/`, `/features/dashboard/`\n- **By Type**: `/controllers/`, `/models/`, `/views/`\n- **By Domain**: `/user/`, `/product/`, `/order/`\n- **Mixed**: Combination approaches\n- **Test Organization**: Colocated vs separate\n\n## File Placement Logic\n\n### Decision Process\n1. Consult PROJECT_ORGANIZATION.md for official rules\n2. Analyze file purpose and type\n3. Apply learned project patterns\n4. Consider framework requirements\n5. Provide clear reasoning\n\n### Framework Handling\n- **Next.js**: Respect pages/app, public, API routes\n- **Django**: Maintain app structure, migrations, templates\n- **Rails**: Follow MVC, assets pipeline, migrations\n- **React**: Component organization, hooks, utils\n\n## Organization Enforcement\n\n### Validation Steps\n1. Check files against PROJECT_ORGANIZATION.md rules\n2. Flag convention violations\n3. Generate safe move operations\n4. Use `git mv` for version control\n5. Update import paths\n6. Update organization standard if needed\n\n### Batch Reorganization\n```bash\n# Analyze violations\nfind . -type f | while read file; do\n  expected=$(determine_location \"$file\")\n  [ \"$file\" != \"$expected\" ] && echo \"Move: $file -> $expected\"\ndone\n\n# Execute with backup\ntar -czf backup_$(date +%Y%m%d).tar.gz .\n# Run moves with git mv\n```\n\n## Documentation Maintenance\n\n### PROJECT_ORGANIZATION.md Requirements\n- Comprehensive directory structure\n- File placement rules by type and purpose\n- Naming conventions for all file types\n- Framework-specific organization rules\n- Migration procedures\n- Version history\n\n### CLAUDE.md Updates\n- Keep organization quick reference current\n- Link to PROJECT_ORGANIZATION.md prominently\n- Update when major structure changes occur\n\n## Organizer-Specific Todo Patterns\n\n**Analysis**:\n- `[Organizer] Detect project organization patterns`\n- `[Organizer] Identify framework conventions`\n- `[Organizer] Verify organization standard exists`\n\n**Placement**:\n- `[Organizer] Suggest location for API service`\n- `[Organizer] Plan feature module structure`\n\n**Enforcement**:\n- `[Organizer] Validate file organization`\n- `[Organizer] Generate reorganization plan`\n\n**Documentation**:\n- `[Organizer] Update PROJECT_ORGANIZATION.md`\n- `[Organizer] Update CLAUDE.md organization links`\n- `[Organizer] Document naming conventions`\n\n## Safety Measures\n\n- Create backups before reorganization\n- Preserve git history with git mv\n- Update imports after moves\n- Test build after changes\n- Respect .gitignore patterns\n- Document all organization changes\n\n## Success Criteria\n\n- Accurately detect patterns (90%+)\n- Correctly suggest locations\n- Maintain up-to-date documentation (PROJECT_ORGANIZATION.md)\n- Ensure CLAUDE.md links are current\n- Adapt to user corrections\n- Provide clear reasoning",
+  "knowledge": {
+    "domain_expertise": [
+      "Project structure patterns",
+      "Framework conventions",
+      "Naming conventions",
+      "Directory best practices",
+      "Asset organization"
+    ],
+    "best_practices": [
+      "Analyze before suggesting",
+      "Respect framework rules",
+      "Preserve git history",
+      "Document decisions",
+      "Incremental improvements",
+      "Review file commit history before modifications: git log --oneline -5 <file_path>",
+      "Write succinct commit messages explaining WHAT changed and WHY",
+      "Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
+    ],
+    "constraints": [
+      "Never move gitignored files",
+      "Respect build requirements",
+      "Maintain compatibility"
+    ]
+  },
+  "dependencies": {
+    "python": [
+      "pathlib",
+      "gitpython>=3.1.0"
+    ],
+    "system": [
+      "python3",
+      "git",
+      "find",
+      "tree"
+    ],
+    "optional": false
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "file_type",
+        "purpose",
+        "framework"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "patterns",
+        "suggestions",
+        "reasoning"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "documentation",
+      "version_control"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Pattern detection",
+        "input": "Analyze project structure",
+        "expected_behavior": "Identifies organization pattern",
+        "validation_criteria": [
+          "identifies_pattern",
+          "detects_conventions"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.9
+    }
+  }
+}

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/cli/commands/auto_configure.py

@@ -26,12 +26,10 @@ try:
 except ImportError:
     RICH_AVAILABLE = False
 
+from ...core.enums import OperationResult
 from ...services.agents.auto_config_manager import AutoConfigManagerService
 from ...services.agents.observers import NullObserver
-from ...services.core.models.agent_config import (
-    ConfigurationResult,
-    ConfigurationStatus,
-)
+from ...services.core.models.agent_config import ConfigurationResult
 from ..shared import BaseCommand, CommandResult
 
 
@@ -419,7 +417,7 @@ class AutoConfigureCommand(BaseCommand):
             return self._display_result_plain(result)
 
         # Display summary
-        if result.status == ConfigurationStatus.SUCCESS:
+        if result.status == OperationResult.SUCCESS:
             panel = Panel(
                 f"✅ Auto-configuration completed successfully!\n\n"
                 f"Deployed {len(result.deployed_agents)} agent(s)",
@@ -436,7 +434,7 @@ class AutoConfigureCommand(BaseCommand):
 
             return CommandResult.success_result()
 
-        if result.status == ConfigurationStatus.PARTIAL_SUCCESS:
+        if result.status == OperationResult.WARNING:
             panel = Panel(
                 f"⚠️  Auto-configuration partially completed\n\n"
                 f"Deployed: {len(result.deployed_agents)}\n"
@@ -465,7 +463,7 @@ class AutoConfigureCommand(BaseCommand):
 
     def _display_result_plain(self, result: ConfigurationResult) -> CommandResult:
         """Display result in plain text (fallback)."""
-        if result.status == ConfigurationStatus.SUCCESS:
+        if result.status == OperationResult.SUCCESS:
             print("\n✅ Auto-configuration completed successfully!")
             print(f"Deployed {len(result.deployed_agents)} agent(s)")
 
@@ -476,7 +474,7 @@ class AutoConfigureCommand(BaseCommand):
 
             return CommandResult.success_result()
 
-        if result.status == ConfigurationStatus.PARTIAL_SUCCESS:
+        if result.status == OperationResult.WARNING:
             print("\n⚠️  Auto-configuration partially completed")
             print(f"Deployed: {len(result.deployed_agents)}")
             print(f"Failed: {len(result.failed_agents)}")
@@ -565,7 +563,7 @@ class AutoConfigureCommand(BaseCommand):
 
         print(json.dumps(output, indent=2))
 
-        if result.status == ConfigurationStatus.SUCCESS:
+        if result.status == OperationResult.SUCCESS:
             return CommandResult.success_result(data=output)
         return CommandResult.error_result(
             "Configuration failed or partial", exit_code=1, data=output

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/cli/commands/local_deploy.py

@@ -23,8 +23,9 @@ from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
 
+from claude_mpm.core.enums import ServiceState
+
 from ...services.local_ops import (
-    ProcessStatus,
     StartConfig,
     UnifiedLocalOpsManager,
 )
@@ -298,7 +299,7 @@ class LocalDeployCommand(BaseCommand):
         try:
             status_filter_str = getattr(args, "status", None)
             status_filter = (
-                ProcessStatus(status_filter_str) if status_filter_str else None
+                ServiceState(status_filter_str) if status_filter_str else None
             )
 
             deployments = self.manager.list_deployments(status_filter=status_filter)

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/cli/commands/mpm_init.py

@@ -157,7 +157,7 @@ class MPMInitCommand:
                 pre_check_result = self._run_pre_initialization_checks(
                     organize_files, skip_archive, has_existing
                 )
-                if pre_check_result.get("status") == "error":
+                if pre_check_result.get("status") == OperationResult.ERROR:
                     return pre_check_result
 
             # Build the delegation prompt
@@ -200,7 +200,7 @@ class MPMInitCommand:
                 progress.update(task, description=complete_desc)
 
             # Post-processing for update mode
-            if update_mode and result.get("status") == "success":
+            if update_mode and result.get("status") == OperationResult.SUCCESS:
                 self._handle_update_post_processing()
 
             return result
@@ -1685,7 +1685,7 @@ Keep it concise (<1000 words) but actionable.
 
     def _display_results(self, result: Dict, verbose: bool):
         """Display initialization results."""
-        if result["status"] == "success":
+        if result["status"] == OperationResult.SUCCESS:
             console.print("\n[green]✅ Project Initialization Complete![/green]\n")
 
             # Display files created
@@ -1885,7 +1885,7 @@ def mpm_init(
         )
 
         # Exit with appropriate code
-        if result["status"] == "success":
+        if result["status"] == OperationResult.SUCCESS:
             sys.exit(0)
         else:
             sys.exit(1)

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/cli/commands/mpm_init_handler.py

@@ -8,6 +8,8 @@ from pathlib import Path
 
 from rich.console import Console
 
+from claude_mpm.core.enums import OperationResult
+
 console = Console()
 
 
@@ -51,7 +53,10 @@ def manage_mpm_init(args):
             )
 
             # Return appropriate exit code
-            if result.get("status") in ("success", "context_ready"):
+            if result.get("status") in (
+                OperationResult.SUCCESS,
+                OperationResult.CONTEXT_READY,
+            ):
                 return 0
             return 1
 
@@ -102,9 +107,9 @@ def manage_mpm_init(args):
         result = command.initialize_project(**init_params)
 
         # Return appropriate exit code
-        if result.get("status") == "success":
+        if result.get("status") == OperationResult.SUCCESS:
             return 0
-        if result.get("status") == "cancelled":
+        if result.get("status") == OperationResult.CANCELLED:
             return 130  # User cancelled
         return 1  # Error
 

{claude_mpm-4.14.8 → claude_mpm-4.15.0}/src/claude_mpm/core/base_service.py

@@ -31,6 +31,7 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional
 
 from .config import Config
+from .enums import HealthStatus
 from .mixins import LoggerMixin
 
 
@@ -38,7 +39,7 @@ from .mixins import LoggerMixin
 class ServiceHealth:
     """Service health status information."""
 
-    status: str  # healthy, degraded, unhealthy, unknown
+    status: HealthStatus  # Type-safe health status using enum
     message: str
     timestamp: str
     metrics: Dict[str, Any] = field(default_factory=dict)
@@ -142,7 +143,7 @@ class BaseService(LoggerMixin, ABC):
 
         # Health and metrics
         self._health = ServiceHealth(
-            status="unknown",
+            status=HealthStatus.UNKNOWN,
             message="Service not started",
             timestamp=datetime.now(timezone.utc).isoformat(),
         )
@@ -235,7 +236,7 @@ class BaseService(LoggerMixin, ABC):
         except Exception as e:
             self.logger.error(f"Failed to start service {self.name}: {e}")
             self._health = ServiceHealth(
-                status="unhealthy",
+                status=HealthStatus.UNHEALTHY,
                 message=f"Startup failed: {e!s}",
                 timestamp=datetime.now(timezone.utc).isoformat(),
                 checks={"startup": False},
@@ -272,7 +273,7 @@ class BaseService(LoggerMixin, ABC):
 
         # Update health status
         self._health = ServiceHealth(
-            status="healthy",
+            status=HealthStatus.HEALTHY,
             message="Service started successfully",
             timestamp=datetime.now(timezone.utc).isoformat(),
             checks={"startup": True},
@@ -336,7 +337,7 @@ class BaseService(LoggerMixin, ABC):
 
         # Update health status
         self._health = ServiceHealth(
-            status="unknown",
+            status=HealthStatus.UNKNOWN,
             message="Service stopped",
             timestamp=datetime.now(timezone.utc).isoformat(),
             checks={"running": False},
@@ -372,16 +373,16 @@ class BaseService(LoggerMixin, ABC):
 
             # Determine overall status
             if not checks["running"]:
-                status = "unhealthy"
+                status = HealthStatus.UNHEALTHY
                 message = "Service is not running"
             elif all(checks.values()):
-                status = "healthy"
+                status = HealthStatus.HEALTHY
                 message = "All health checks passed"
             elif any(checks.values()):
-                status = "degraded"
+                status = HealthStatus.DEGRADED
                 message = "Some health checks failed"
             else:
-                status = "unhealthy"
+                status = HealthStatus.UNHEALTHY
                 message = "Multiple health checks failed"
 
             # Update health status
@@ -402,7 +403,7 @@ class BaseService(LoggerMixin, ABC):
         except Exception as e:
             self.logger.error(f"Health check failed for {self.name}: {e}")
             self._health = ServiceHealth(
-                status="unhealthy",
+                status=HealthStatus.UNHEALTHY,
                 message=f"Health check error: {e!s}",
                 timestamp=datetime.now(timezone.utc).isoformat(),
                 checks={"health_check_error": True},
@@ -593,7 +594,7 @@ class BaseService(LoggerMixin, ABC):
                     )
                 else:
                     return ServiceHealth(
-                        status="degraded",
+                        status=HealthStatus.DEGRADED,
                         message="Service circuit breaker is open",
                         timestamp=datetime.now(timezone.utc).isoformat(),
                         checks={"circuit_breaker": False},
@@ -604,7 +605,7 @@ class BaseService(LoggerMixin, ABC):
             health = await self.health_check()
 
             # Update circuit breaker
-            if health.status in ["healthy", "degraded"]:
+            if health.status in (HealthStatus.HEALTHY, HealthStatus.DEGRADED):
                 self._record_circuit_success()
             else:
                 self._record_circuit_failure()