Improve CLI User Experience

[codegen-sh]

🎨 CLI UX Enhancement

This PR significantly improves the grain-chain CLI user experience with better error messages, progress indicators, colored output, and enhanced functionality.

✨ Key Features

🎯 Enhanced CLI Utilities (grainchain/cli/utils.py)

• Colored Output: Success (green), error (red), warning (yellow), info (blue) styling
• Progress Indicators: Spinner and progress bar for long-running operations
• Table Formatting: Clean, readable tables for benchmark results
• Duration Formatting: Human-readable time display (ms, s, m)
• Dependency Checking: Automated validation of required tools
• Confirmation Prompts: Safety checks for destructive operations

🚨 Smart Error Handling (grainchain/cli/exceptions.py)

• Custom Exception Classes: Specialized errors with actionable suggestions
• DependencyError: Missing tools with installation instructions
• ProviderError: Sandbox provider issues with troubleshooting tips
• BenchmarkError: Test failures with debugging guidance
• ConfigurationError: Setup problems with fix suggestions

🔧 Enhanced Main CLI (grainchain/cli/main.py)

• Global Verbose Mode: --verbose flag for detailed debugging output
• Improved Commands: All commands now have progress tracking and better error handling
• Safety Features: Confirmation prompts for destructive operations
• Better Messaging: Clear, actionable error messages with suggestions

📊 Enhanced Benchmark CLI (grainchain/cli/benchmark.py)

• Progress Tracking: Real-time progress for each test execution
• Formatted Results: Clean tables with success/failure indicators
• Summary Statistics: Total duration, success rate, average execution time
• Provider-Specific Errors: Tailored error messages for different providers
• Verbose Mode Support: Detailed logging for debugging

🧪 Testing

• Comprehensive test suite for all new utilities
• Mock-based testing for CLI interactions
• Coverage for error handling scenarios
• Tests for table formatting and duration display

🎯 Addresses Issue Requirements

• ✅ Progress indicators for benchmark operations
• ✅ Improved error messages with actionable suggestions
• ✅ Colored output for better readability
• ✅ Helpful tips in error scenarios
• ✅ Verbose mode for debugging
• ✅ Improved benchmark result formatting
• ✅ Confirmation prompts for destructive operations

🔍 Example Usage

# Verbose mode for debugging
grainchain --verbose benchmark

# Enhanced error messages
grainchain benchmark --provider nonexistent
# ❌ Invalid provider: 'nonexistent'
# 💡 Available providers: local|e2b|daytona

# Progress indicators and formatted results
grainchain benchmark --provider local
# 🔄 Running benchmarks...
# ✅ File Operations (1.23s)
# ✅ Snapshot Lifecycle (0.85s)
# 📊 Results table with statistics

📁 Files Modified

• grainchain/cli/main.py - Enhanced main CLI interface
• grainchain/cli/benchmark.py - Improved benchmark implementation
• grainchain/cli/utils.py - New CLI utilities (created)
• grainchain/cli/exceptions.py - Custom exception classes (created)
• tests/cli/ - Comprehensive test suite (created)

🎉 Impact

This enhancement significantly improves the developer experience by:

• Reducing confusion with clear, actionable error messages
• Providing visual feedback during long operations
• Making output more readable and professional
• Helping users troubleshoot common issues independently
• Adding safety features to prevent accidental damage

---

💻 View my work • About Codegen