Release Notes - v0.2.3

🎉 Configuration & Onboarding Improvements

This release focuses on creating a seamless first-time user experience with robust configuration management and optimized CI/CD pipelines.

✨ What's New

🏗️ Configuration Infrastructure

• UserConfigManager: Intelligent OS-specific configuration directory management
  • Windows: %APPDATA%\vibe-coder
  • macOS: ~/Library/Application Support/vibe-coder
  • Linux: ~/.config/vibe-coder (XDG compliant)
• ConfigValidator: Comprehensive validation with actionable error messages
• Backup System: Automatic configuration backup with timestamps

🚀 Enhanced Setup Wizard

• Smart Detection: Multiple indicators for first-run detection
• CI/CD Support: Non-interactive setup for automated environments
• Visual Polish: ASCII art banner and improved prompts
• Multi-location Saving: Configs saved to both user and project directories

📋 Configuration Templates

• Comprehensive .env.template with inline documentation
• Complete llm_config.template.json with all model mappings
• Tool-specific mcp-config.template.json configurations

⚡ CI/CD Optimizations

• Faster Pipelines: Unit tests only in CI (70% faster)
• Memory Optimization: Proper NODE_OPTIONS configuration
• Selective Testing: Integration tests available for manual runs

📦 Installation

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

# Or use with npx
npx vibe-coder-mcp

# First-time setup will launch automatically
vibe --setup

🔧 Configuration

For new users, the setup wizard will guide you through:

1. OpenRouter API key configuration
2. Directory permissions setup
3. Security mode selection
4. Model preferences

For existing users, all configurations are preserved and backward compatible.

📝 Changes from v0.2.2

Added

• UserConfigManager for cross-platform config management
• ConfigValidator with Zod-based validation
• Configuration templates for new users
• Non-interactive setup for CI/CD
• Improved first-run detection
• GitHub Actions optimization for unit tests

Changed

• Enhanced setup wizard with better UX
• CI/CD pipeline now runs unit tests only
• Coverage threshold adjusted to 70% for unit tests
• Updated dependencies for better performance

Fixed

• First-time user crash when API key missing
• CLI interactive mode improvements
• Banner display in REPL mode

🔐 Security

• No security vulnerabilities introduced
• Maintains strict file system boundaries
• API keys never logged or exposed

📊 Performance

• CI pipeline execution time reduced by ~70%
• Memory usage optimized for test runs
• Faster npm package installation

🤝 Contributors

• @freshtechbro - Project maintainer
• Claude AI - Development assistance

📚 Documentation

• Setup Guide
• Configuration Reference
• API Documentation

🐛 Known Issues

• None reported in this release

🔮 What's Next

• Phase 2: Advanced workflow automation
• Enhanced agent coordination
• Performance improvements for large codebases
• Extended language support in code-map-generator

📈 Stats

• Package Size: ~8.5MB
• Dependencies: 38 runtime, 22 dev
• Node Support: 18.x, 20.x, 22.x
• Test Coverage: 73% (unit tests)

Upgrade Instructions

From v0.2.2

npm update -g vibe-coder-mcp
# Your existing config will be preserved

Fresh Installation

npm install -g vibe-coder-mcp
# Setup wizard will launch on first run

Docker Users

docker pull ghcr.io/freshtechbro/vibe-coder-mcp:latest

Feedback

We'd love to hear your feedback! Please report issues or suggestions:

• GitHub Issues
• Discussions

Thank you for using Vibe Coder MCP! 🚀