claude-mpm 4.4.0__tar.gz → 4.4.4__tar.gz

claude_mpm-4.4.4/BUILD_NUMBER

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

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/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.4.0 → claude_mpm-4.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.4.0
+Version: 4.4.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
@@ -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
@@ -204,9 +204,15 @@ claude-mpm run --monitor
 # Use MCP Gateway for external tool integration
 claude-mpm mcp
 
-# Run health diagnostics  
+# Run comprehensive health diagnostics
 claude-mpm doctor
 
+# Generate detailed diagnostic report
+claude-mpm doctor --verbose --output-file doctor-report.md
+
+# Run specific diagnostic checks
+claude-mpm doctor --checks installation configuration agents
+
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
 ```
@@ -214,17 +220,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.
 
@@ -316,7 +322,7 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 #### 🚀 For Operations
 - **[🚀 Deployment](docs/DEPLOYMENT.md)** - Release management & versioning
 - **[📊 Monitoring](docs/MONITOR.md)** - Real-time dashboard & metrics
-- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Diagnostic & problem resolution
+- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Enhanced `doctor` command with detailed reports and auto-fix capabilities
 
 ### 🎯 Documentation Features
 - **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/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
@@ -57,9 +57,15 @@ claude-mpm run --monitor
 # Use MCP Gateway for external tool integration
 claude-mpm mcp
 
-# Run health diagnostics  
+# Run comprehensive health diagnostics
 claude-mpm doctor
 
+# Generate detailed diagnostic report
+claude-mpm doctor --verbose --output-file doctor-report.md
+
+# Run specific diagnostic checks
+claude-mpm doctor --checks installation configuration agents
+
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
 ```
@@ -67,17 +73,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.
 
@@ -169,7 +175,7 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 #### 🚀 For Operations
 - **[🚀 Deployment](docs/DEPLOYMENT.md)** - Release management & versioning
 - **[📊 Monitoring](docs/MONITOR.md)** - Real-time dashboard & metrics
-- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Diagnostic & problem resolution
+- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Enhanced `doctor` command with detailed reports and auto-fix capabilities
 
 ### 🎯 Documentation Features
 - **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub

claude_mpm-4.4.4/VERSION

@@ -0,0 +1 @@
+4.4.4

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/pyproject.toml

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

claude_mpm-4.4.4/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.4.4

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/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.4.0 → claude_mpm-4.4.4}/src/claude_mpm/agents/agent_loader.py

@@ -38,6 +38,9 @@ from enum import Enum
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple, Union
 
+# Module-level logger
+from claude_mpm.core.logging_utils import get_logger
+
 # Import modular components
 from claude_mpm.core.unified_agent_registry import (
     AgentTier,
@@ -49,8 +52,6 @@ from claude_mpm.services.memory.cache.shared_prompt_cache import SharedPromptCac
 from ..core.agent_name_normalizer import AgentNameNormalizer
 from .base_agent_loader import prepend_base_instructions
 
-# Module-level logger
-from claude_mpm.core.logging_utils import get_logger
 logger = get_logger(__name__)
 
 

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/src/claude_mpm/agents/agent_loader_integration.py

@@ -9,11 +9,12 @@ Provides backward compatibility while enabling advanced features.
 
 from typing import Any, Dict, Optional
 
+from claude_mpm.core.logging_utils import get_logger
+
 from ..models.agent_definition import AgentDefinition
 from ..services import AgentManager
 from .agent_loader import get_agent_prompt
 
-from claude_mpm.core.logging_utils import get_logger
 logger = get_logger(__name__)
 
 

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/src/claude_mpm/agents/frontmatter_validator.py

@@ -24,6 +24,7 @@ from typing import Any, Dict, List, Optional, Tuple
 import yaml
 
 from claude_mpm.core.logging_utils import get_logger
+
 logger = get_logger(__name__)
 
 

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/src/claude_mpm/agents/system_agent_config.py

@@ -18,6 +18,8 @@ Created: 2025-07-16
 from dataclasses import dataclass, field
 from typing import Any, Dict, List, Optional
 
+from claude_mpm.core.logging_utils import get_logger
+
 from ..config.default_model_config import (
     DefaultModelConfigManager,
     get_default_model_for_agent_type,
@@ -28,7 +30,6 @@ from ..config.model_env_defaults import (
 )
 from ..services.model_selector import ModelSelector, ModelType
 
-from claude_mpm.core.logging_utils import get_logger
 logger = get_logger(__name__)
 
 

{claude_mpm-4.4.0 → claude_mpm-4.4.4}/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.4.0 → claude_mpm-4.4.4}/src/claude_mpm/cli/commands/doctor.py

@@ -79,6 +79,15 @@ def add_doctor_parser(subparsers):
 
     parser.add_argument("--output", "-o", type=Path, help="Save output to file")
 
+    parser.add_argument(
+        "--output-file",
+        nargs="?",
+        const=".",
+        type=Path,
+        default=None,
+        help="Save report to file (default: mpm-doctor-report.md when used without path)",
+    )
+
     parser.set_defaults(func=doctor_command)
 
 
@@ -108,13 +117,30 @@ def doctor_command(args):
     """
     # Configure logging
     from claude_mpm.core.logging_utils import get_logger
+
     logger = get_logger(__name__)
 
+    # Handle output file parameter - support both --output and --output-file
+    output_file = args.output or args.output_file
+    if output_file is not None:
+        # If output_file is specified without a path, use default
+        if str(output_file) == ".":
+            output_file = Path("mpm-doctor-report.md")
+        elif not str(output_file).endswith((".md", ".json", ".txt")):
+            # Add .md extension if no extension provided
+            output_file = Path(str(output_file) + ".md")
+
     # Determine output format
     if args.json:
         output_format = "json"
     elif args.markdown:
         output_format = "markdown"
+    elif output_file:
+        # Force markdown format when writing to file (unless json specified)
+        if str(output_file).endswith(".json"):
+            output_format = "json"
+        else:
+            output_format = "markdown"
     else:
         output_format = "terminal"
 
@@ -152,17 +178,29 @@ def doctor_command(args):
     reporter = DoctorReporter(use_color=not args.no_color, verbose=args.verbose)
 
     # Output results
-    if args.output:
+    if output_file:
         # Save to file
         try:
             import sys
 
             original_stdout = sys.stdout
-            with open(args.output, "w") as f:
+            with open(output_file, "w") as f:
                 sys.stdout = f
                 reporter.report(summary, format=output_format)
             sys.stdout = original_stdout
-            print(f"Report saved to: {args.output}")
+            print(f"✅ Report saved to: {output_file}")
+
+            # Also print brief summary to terminal
+            if summary.error_count > 0:
+                print(
+                    f"❌ {summary.error_count} error(s) found - see report for details"
+                )
+            elif summary.warning_count > 0:
+                print(
+                    f"⚠️  {summary.warning_count} warning(s) found - see report for details"
+                )
+            else:
+                print("✅ System is healthy!")
         except Exception as e:
             logger.error(f"Failed to save report: {e}")
             print(f"❌ Failed to save report: {e!s}")
@@ -187,13 +225,14 @@ if __name__ == "__main__":
     parser = argparse.ArgumentParser(description="Claude MPM Doctor")
     parser.add_argument("--verbose", "-v", action="store_true")
     parser.add_argument("--json", action="store_true")
+    parser.add_argument("--markdown", action="store_true")
     parser.add_argument("--fix", action="store_true")
     parser.add_argument("--no-color", action="store_true")
     parser.add_argument("--checks", nargs="+")
     parser.add_argument("--parallel", action="store_true")
+    parser.add_argument("--output", "-o", type=Path)
+    parser.add_argument("--output-file", type=Path)
 
     args = parser.parse_args()
-    args.markdown = False
-    args.output = None
 
     sys.exit(doctor_command(args))