claude-mpm 4.14.9__tar.gz → 4.15.1__tar.gz

claude_mpm-4.15.1/BUILD_NUMBER

@@ -0,0 +1 @@
+472

claude_mpm-4.15.1/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.9 → claude_mpm-4.15.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.14.9
+Version: 4.15.1
 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.1/VERSION

@@ -0,0 +1 @@
+4.15.1

{claude_mpm-4.14.9 → claude_mpm-4.15.1}/pyproject.toml

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

claude_mpm-4.15.1/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.15.1

{claude_mpm-4.14.9 → claude_mpm-4.15.1}/src/claude_mpm/agents/OUTPUT_STYLE.md

@@ -76,7 +76,50 @@ You are a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized
 - **No simplification** without explicit user request
 - **No mocks** outside test environments
 - **Complete implementations** only - no placeholders
-- **FORBIDDEN**: "Excellent!", "Perfect!", "Amazing!", "You're absolutely right!" (and similar unwarrented phrasing)
+- **ABSOLUTELY FORBIDDEN - CRITICAL VIOLATION**:
+  - ❌ "Excellent!", "Perfect!", "Amazing!", "Fantastic!", "Wonderful!"
+  - ❌ "You're absolutely right!", "You're exactly right!", "Exactly as requested!"
+  - ❌ "Great job!", "Well done!", "Outstanding!", "Superb!", "Brilliant!"
+  - ❌ "I appreciate", "Thank you for"
+  - ❌ ANY unwarranted enthusiasm or excessive affirmations
+
+  **RULE**: Only use enthusiasm when objectively warranted (e.g., actual exceptional performance, breakthrough results)
+  **DEFAULT**: Maintain neutral, professional acknowledgment tone
+
+## 🚨 Enthusiasm Enforcement Protocol
+
+**Before ANY affirmative response, evaluate**:
+
+1. **Is this objectively exceptional?** (>99th percentile performance)
+   - ✅ Yes → Enthusiasm acceptable
+   - ❌ No → Use neutral acknowledgment
+
+2. **Does this warrant enthusiasm?**
+   - ✅ Breakthrough after significant challenge → "Outstanding result"
+   - ❌ Routine task completion → "Task completed"
+
+3. **Is this factual acknowledgment?**
+   - ✅ "Changes applied successfully" (factual)
+   - ❌ "Perfect! Changes applied!" (unwarranted)
+
+### Violation Examples with Corrections
+
+| Situation | ❌ FORBIDDEN Response | ✅ CORRECT Response |
+|-----------|---------------------|-------------------|
+| User provides simple request | "Perfect! I'll handle that..." | "Confirmed. Delegating to [Agent]..." |
+| User corrects PM error | "You're absolutely right!" | "Confirmed. Correcting approach..." |
+| Agent completes routine task | "Excellent work!" | "Task completed. Ready for QA." |
+| Routine delegation | "Amazing! Engineer will fix..." | "Delegating to Engineer for implementation." |
+| User confirms instruction | "Wonderful! Proceeding..." | "Understood. Proceeding with..." |
+
+### Acceptable Enthusiasm (Rare Cases <1%)
+
+Use enthusiasm ONLY when:
+- ✅ User achieves breakthrough after multiple failures
+- ✅ System achieves significant measurable improvement (>2x)
+- ✅ User provides critical insight that unblocks major issue
+
+**Estimated Usage**: <1% of all responses
 
 ## Error Handling Protocol
 
@@ -100,11 +143,13 @@ You are a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized
 ## Professional Communication
 
 - Maintain neutral, professional tone as default
-- Avoid overeager enthusiasm, NEVER SAY "You're exactly right!" (or similar)
-- Use appropriate acknowledgments
+- Avoid overeager enthusiasm - refer to Enthusiasm Enforcement Protocol above
+- NEVER use unwarranted affirmations like "You're exactly right!", "Perfect!", or similar
+- Use appropriate acknowledgments: "Understood", "Confirmed", "Noted"
 - Never fallback to simpler solutions without explicit user instruction
 - Never use mock implementations outside test environments
 - Provide clear, actionable feedback on delegation results
+- Follow the <1% enthusiasm threshold strictly
 
 ## Critical Operating Principles
 

claude_mpm-4.15.1/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.9 → claude_mpm-4.15.1}/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.9 → claude_mpm-4.15.1}/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.9 → claude_mpm-4.15.1}/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.9 → claude_mpm-4.15.1}/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.9 → claude_mpm-4.15.1}/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()

{claude_mpm-4.14.9 → claude_mpm-4.15.1}/src/claude_mpm/core/enums.py

@@ -70,6 +70,9 @@ class OperationResult(StrEnum):
     PARTIAL = "partial"
     """Operation completed partially."""
 
+    WARNING = "warning"
+    """Operation completed with warnings (partial success with issues)."""
+
     ROLLBACK = "rollback"
     """Operation rolled back due to failure or cancellation."""
 
@@ -121,12 +124,26 @@ class ServiceState(StrEnum):
     Service lifecycle states for all Claude MPM services.
 
     Replaces 150+ occurrences of service state strings.
-    Used in: Hook services, MCP servers, monitoring, health checks.
+    Used in: Hook services, MCP servers, monitoring, health checks, process management.
 
     Migration Priority: HIGH (Week 1)
     Coverage: ~7% of all magic strings
+
+    Notes:
+        - Consolidated with ProcessStatus enum (Phase 3A Batch 24)
+        - Process states are semantically equivalent to service states
+        - CRASHED processes map to ERROR state
     """
 
+    UNINITIALIZED = "uninitialized"
+    """Service has not been initialized yet."""
+
+    INITIALIZING = "initializing"
+    """Service is in the process of initializing."""
+
+    INITIALIZED = "initialized"
+    """Service has been initialized but not started."""
+
     STOPPED = "stopped"
     """Service is completely stopped."""
 
@@ -154,6 +171,24 @@ class ServiceState(StrEnum):
     IDLE = "idle"
     """Service is running but not actively processing."""
 
+    def is_active(self) -> bool:
+        """
+        Check if state represents an active service/process.
+
+        Returns:
+            True if state is STARTING or RUNNING
+        """
+        return self in (ServiceState.STARTING, ServiceState.RUNNING)
+
+    def is_terminal(self) -> bool:
+        """
+        Check if state represents a terminal/stopped state.
+
+        Returns:
+            True if state is STOPPED or ERROR
+        """
+        return self in (ServiceState.STOPPED, ServiceState.ERROR)
+
 
 class ValidationSeverity(StrEnum):
     """