Skip to content

Release v0.2.5: CLI Onboarding Bug Fix & Context-Aware Configuration

Choose a tag to compare

@freshtechbro freshtechbro released this 14 Aug 18:51
3ff6f71

🔧 Critical CLI Bug Fixes & Enhancements

Fixed CLI Onboarding Loop Bug

  • ✅ Resolved critical issue where vibe command repeatedly triggered first-run setup
  • CLI now correctly detects user's project directory using process.cwd() instead of package directory
  • Configuration files (.env, llm_config.json, .vibe-config.json) now save to user's working directory

Context-Aware Configuration System

  • 🎯 Enhanced TransportContext pattern for intelligent CLI vs Server differentiation
  • 💾 Dual-location configuration saving (user directory + package fallback) for reliability
  • 📍 Intelligent path resolution based on transport type
  • 🔄 Enhanced OpenRouterConfigManager with context-aware path resolution
  • ⚙️ Updated SetupWizard with transport context support

User Experience Improvements

  • 🚀 CLI users can now run vibe from any directory in their project
  • ✨ Enhanced error handling and debugging information for configuration persistence
  • 🛠️ Improved setup wizard experience with better validation
  • 📖 Comprehensive documentation of CLI behavior and configuration

🧪 Technical Improvements

Architecture Enhancements

  • Context-aware configuration using enhanced TransportContext pattern
  • Dual-location configuration saving strategy for robust file management
  • Precedence-based configuration loading (user directory → package directory)
  • Enhanced first-run detection logic with transport-specific validation

Developer Experience

  • 🔍 Comprehensive test coverage for CLI onboarding flows
  • 📝 Enhanced error messages and debugging information
  • 🎯 Better setup wizard user experience with improved validation
  • 📚 Updated documentation for CLI auto-detection features

Backward Compatibility

  • ✅ Full backward compatibility for all existing server setups
  • 🔧 Zero breaking changes for MCP client integrations
  • 🏗️ Follows DRY principles and existing architectural patterns
  • 🛡️ Enhanced UnifiedSecurityConfigManager integration

📊 Quality Assurance

  • ✅ TypeScript compilation passes with zero errors
  • ✅ ESLint validation passes with no issues
  • ✅ Build process completes successfully
  • ✅ Maintains strict typing enforcement standards
  • ✅ All tests pass with comprehensive coverage

🔗 Links

📦 Installation

# Install globally
npm install -g vibe-coder-mcp@0.2.5

# Or update existing installation
npm update -g vibe-coder-mcp

🚀 Quick Start

# Run setup (first time)
vibe --setup

# Start using Vibe
vibe --help

Full Changelog: v0.2.4...v0.2.5