add cli package

Author: John Costa

EXPANSION_PLAN.md

@@ -3,14 +3,16 @@
 ## 📈 Current Progress Status
 
 **✅ Phase 1.1 COMPLETED** - Core Library Extraction  
-**🎯 Next Up:** Phase 1.2 - Enhanced MCP Server  
+**✅ Phase 1.2 COMPLETED** - Enhanced MCP Server  
+**🎯 Next Up:** Phase 2.1 - Google Slides Integration / CLI Tool  
 **📅 Updated:** August 2025
 
 ### 🏆 Major Milestones Achieved
 - ✅ **Core Library**: `@mermaid-converter/core` package created and tested
 - ✅ **Plugin Architecture**: Extensible system for outputs and renderers
-- ✅ **Local Testing**: Both VSCode extension and core library validated
-- ✅ **Production Ready**: 10/10 tests passing, professional tooling setup
+- ✅ **Enhanced MCP Server**: Fully functional with PDF generation and templates
+- ✅ **Local Testing**: VSCode extension, core library, and MCP server all validated
+- ✅ **Production Ready**: Comprehensive test suites, professional tooling setup
 
 ### 🔧 Ready for Use
 ```bash
@@ -72,10 +74,10 @@ export interface OutputGenerator {
 - ✅ **Developer Experience**: Professional documentation, examples, ESLint + Jest setup
 - ✅ **Validated Locally**: Both VSCode extension and core library tested and working
 
-### 1.2 Enhanced MCP Server 🎯 NEXT
-**Priority: High** | **Status: 🎯 IN PROGRESS**
+### 1.2 Enhanced MCP Server ✅ COMPLETED
+**Priority: High** | **Status: ✅ DONE**
 
-Build production-ready MCP server with advanced features:
+Built production-ready MCP server with advanced features:
 
 ```typescript
 // Enhanced MCP tools
@@ -97,11 +99,12 @@ interface MCPTools {
 ```
 
 **Deliverables:**
-- [ ] Docker containerization for easy deployment
-- [ ] Comprehensive caching system
-- [ ] Rate limiting and authentication
-- [ ] Webhook support for automation
-- [ ] Health monitoring and metrics
+- [x] ✅ Simplified MCP server with PDF generation
+- [x] ✅ Template system (4 professional templates)
+- [x] ✅ Claude Desktop integration working
+- [x] ✅ PDF files saved to Downloads folder
+- [x] ✅ Comprehensive test suites
+- [ ] 🔄 Advanced features (Docker, caching, webhooks) deferred to later phase
 
 ## Phase 2: High-Impact Integrations (Weeks 5-12)
 

packages/cli/README.md

@@ -0,0 +1,299 @@
+# Mermaid Converter CLI
+
+> Convert Markdown files with Mermaid diagrams to PDF and other formats from the command line
+
+## Installation
+
+```bash
+npm install -g @mermaid-converter/cli
+```
+
+## Quick Start
+
+```bash
+# Convert a single file
+mermaid-convert document.md
+
+# Convert with a specific template
+mermaid-convert document.md -t report -o professional-report.pdf
+
+# Convert multiple files
+mermaid-convert docs/*.md --batch -d output/
+
+# Watch for changes
+mermaid-convert watch docs/
+```
+
+## Features
+
+- 🚀 **Fast conversions** with high-quality Mermaid diagram rendering
+- 📋 **6 built-in templates** for different use cases
+- 📦 **Batch processing** with progress bars and concurrent conversions
+- 👁️ **Watch mode** for automatic conversion on file changes
+- ⚙️ **Configurable** with project-level configuration files
+- 🎨 **Professional output** with customizable formatting options
+
+## Commands
+
+### `convert` - Convert Markdown files
+
+Convert one or more Markdown files to PDF (or other formats).
+
+```bash
+mermaid-convert convert input.md [options]
+```
+
+**Options:**
+- `-f, --format <format>` - Output format (default: pdf)
+- `-o, --output <file>` - Output file (single file mode)
+- `-d, --output-dir <dir>` - Output directory (batch mode)
+- `-t, --template <name>` - Template to use (default: default)
+- `-b, --batch` - Enable batch processing for multiple files
+- `-c, --concurrency <n>` - Number of concurrent conversions (default: 3)
+- `--overwrite` - Overwrite existing files
+
+**Examples:**
+```bash
+# Basic conversion
+mermaid-convert convert README.md
+
+# Use specific template and output location
+mermaid-convert convert docs/guide.md -t presentation -o slides.pdf
+
+# Batch convert with custom settings
+mermaid-convert convert docs/*.md --batch -d output -t report -c 5
+
+# Convert multiple files with glob pattern
+mermaid-convert convert "src/**/*.md" --batch -d dist/
+```
+
+### `watch` - Monitor files for changes
+
+Watch Markdown files and automatically convert them when they change.
+
+```bash
+mermaid-convert watch <path> [options]
+```
+
+**Options:**
+- `-f, --format <format>` - Output format (default: pdf)
+- `-d, --output-dir <dir>` - Output directory (default: current)
+- `-t, --template <name>` - Template to use (default: default)
+- `-i, --ignore <pattern>` - Ignore pattern (default: node_modules/**)
+- `--debounce <ms>` - Debounce delay in milliseconds (default: 300)
+
+**Examples:**
+```bash
+# Watch current directory
+mermaid-convert watch .
+
+# Watch specific directory with custom template
+mermaid-convert watch docs/ -t documentation -d output/
+
+# Watch with custom ignore patterns
+mermaid-convert watch . -i "*.tmp,node_modules/**,dist/**"
+```
+
+### `templates` - Manage templates
+
+List and inspect available conversion templates.
+
+```bash
+mermaid-convert templates [options]
+```
+
+**Options:**
+- `-l, --list` - List all available templates (default)
+- `-s, --show <name>` - Show details for a specific template
+- `-i, --interactive` - Interactive template selection
+
+**Examples:**
+```bash
+# List all templates
+mermaid-convert templates
+
+# Show template details
+mermaid-convert templates --show report
+
+# Interactive template browser
+mermaid-convert templates --interactive
+```
+
+### `config` - Configuration management
+
+Create and manage CLI configuration files.
+
+```bash
+mermaid-convert config [options]
+```
+
+**Options:**
+- `-i, --init` - Create a new configuration file
+- `-s, --show` - Show current configuration
+- `-p, --path` - Show configuration file path
+
+**Examples:**
+```bash
+# Create configuration file
+mermaid-convert config --init
+
+# Show current config
+mermaid-convert config --show
+```
+
+## Templates
+
+The CLI comes with 6 built-in templates:
+
+| Template | Description | Use Case |
+|----------|-------------|----------|
+| `default` | Standard PDF with professional formatting | General documents |
+| `report` | High-quality with generous margins | Business reports |
+| `presentation` | Landscape format for slides | Presentations |
+| `documentation` | Optimized for technical docs | API docs, guides |
+| `dark` | Dark theme for code/diagrams | Developer documentation |
+| `compact` | Minimal margins for maximum content | Reference materials |
+
+### Template Options
+
+Each template includes settings for:
+- **Quality**: draft, standard, high
+- **Theme**: light, dark
+- **Page Size**: A4, Letter, Legal
+- **Margins**: Customizable spacing
+- **Orientation**: Portrait or landscape
+
+## Configuration
+
+Create a `.mermaid-convertrc.json` file in your project root:
+
+```json
+{
+  "defaultFormat": "pdf",
+  "defaultTemplate": "documentation",
+  "outputDirectory": "./dist",
+  "overwrite": false,
+  "concurrency": 3,
+  "templates": {
+    "custom": {
+      "description": "My custom template",
+      "options": {
+        "quality": "high",
+        "theme": "light",
+        "margins": {
+          "top": "30mm",
+          "bottom": "30mm"
+        }
+      }
+    }
+  }
+}
+```
+
+## Examples
+
+### Basic Usage
+
+```bash
+# Convert single file
+mermaid-convert convert documentation.md
+
+# Use professional template
+mermaid-convert convert report.md -t report
+```
+
+### Batch Processing
+
+```bash
+# Convert all markdown files in docs/
+mermaid-convert convert docs/*.md --batch -d output/
+
+# Process with 5 concurrent conversions
+mermaid-convert convert docs/**/*.md --batch -c 5
+```
+
+### Development Workflow
+
+```bash
+# Watch for changes during development
+mermaid-convert watch docs/ -t documentation -d dist/
+
+# Convert on save with custom debounce
+mermaid-convert watch . --debounce 1000
+```
+
+### Advanced Usage
+
+```bash
+# Custom output location and template
+mermaid-convert convert api.md -t presentation -o slides/api-overview.pdf
+
+# Batch with overwrite enabled
+mermaid-convert convert docs/*.md --batch --overwrite -d output/
+```
+
+## Global Options
+
+Available for all commands:
+
+- `-q, --quiet` - Suppress non-error output
+- `-v, --verbose` - Enable verbose logging
+- `--no-color` - Disable colored output
+
+## Output
+
+### Success Messages
+- ✅ File conversion progress and results
+- 📊 Processing statistics (file size, duration)
+- 📁 Output file locations
+
+### Error Handling
+- ❌ Clear error messages with suggestions
+- 🐛 Verbose mode for debugging
+- 📝 Automatic error logging to files
+
+## Troubleshooting
+
+### Common Issues
+
+**"No files found"**
+- Check your glob pattern syntax
+- Ensure Markdown files have `.md` extension
+- Use absolute paths if relative paths aren't working
+
+**"Diagram render failed"**
+- Verify Mermaid syntax is valid
+- Check for special characters in diagrams
+- Try with `--verbose` for detailed error information
+
+**"Permission denied"**
+- Ensure write permissions for output directory
+- Use `--overwrite` to replace existing files
+
+### Debug Mode
+
+```bash
+# Enable verbose logging
+mermaid-convert convert file.md --verbose
+
+# Check log files
+cat mermaid-convert.log
+cat mermaid-convert-error.log
+```
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## Related Packages
+
+- `@mermaid-converter/core` - Core conversion library
+- `@mermaid-converter/mcp-server` - MCP server for Claude Desktop integration

packages/cli/example.md

@@ -0,0 +1,29 @@
+# CLI Example Document
+
+This is an example document to test the Mermaid Converter CLI.
+
+## Simple Process Flow
+
+```mermaid
+graph LR
+    A[Write Markdown] --> B[Run CLI]
+    B --> C[Generate PDF]
+    C --> D[Professional Output]
+```
+
+## Usage
+
+Convert this file with:
+
+```bash
+mermaid-convert convert example.md -t report
+```
+
+## Features Tested
+
+- ✅ Basic markdown parsing
+- ✅ Mermaid diagram rendering
+- ✅ Professional PDF output
+- ✅ Command-line interface
+
+The CLI tool successfully processes this content and generates a high-quality PDF with the embedded diagram.