Release v0.3.5: Enhanced CLI, REPL, and Parameter Extraction

🎉 Highlights

This release brings major improvements to the CLI interactive experience, fixing critical issues with multi-turn conversations and parameter extraction across all tools.

✨ What's New

Enhanced Hybrid Matcher

• Complete Parameter Extraction: All 15 MCP tools now have comprehensive parameter extraction logic
• Multi-Strategy Matching: Improved tool selection using keyword, pattern, semantic, and LLM fallback strategies
• Task-List-Generator Fix: Now auto-generates default user stories when not explicitly provided, preventing validation errors
• Better Confidence Scoring: More accurate tool matching with improved confidence calculations

CLI/REPL Major Improvements

• Interactive Confirmations: Low-confidence matches now prompt for user confirmation
• Job Status Polling: Visual progress indicators for long-running jobs
• Enhanced Input Handling: Better queue management and non-TTY mode support
• Cleaner Output: JSON logs filtered from interactive display for better UX
• Session Persistence: Conversation history maintained across commands

Tool Enhancements

• Unified Security Config: Enhanced project root detection with CLI auto-detection
• Context Curator: Improved output formatting and parameter handling
• Code Map Generator: Better path resolution and configuration validation
• All Generator Tools: Enhanced parameter validation and error messages

🐛 Bug Fixes

• Fixed "Input validation failed for tool 'task-list-generator'" error
• Resolved multi-turn conversation parameter extraction issues
• Fixed REPL confirmation handling in non-TTY environments
• Corrected path resolution issues in various tools

📦 Installation

NPM (Global)

npm install -g vibe-coder-mcp@0.3.5

Quick Start

# Interactive mode with improved UX
vibe --interactive

# Direct command with auto-parameter extraction
vibe "generate tasklist to implement a seniors fitness app"

🔄 Upgrade Guide

No breaking changes - simply update to v0.3.5:

npm update -g vibe-coder-mcp

📊 Statistics

• Files Changed: 35
• Additions: 1,978 lines
• Deletions: 768 lines
• Commits: 4 logical groups

🙏 Contributors

• @freshtechbro
• Claude (AI Assistant)

📝 Full Changelog

• feat(hybrid-matcher): enhance parameter extraction for all tools
• feat(cli): major REPL and interactive mode improvements
• feat(tools): enhance multiple tools with improved validation and security
• chore: bump version to 0.3.5 and update documentation

For detailed documentation, visit our System Instructions

🤖 Generated with Claude Code

Release v0.3.1 - Global Installation Synchronization and System Enhancements

🔧 Installation & Version Management

• Fixed global and local version synchronization issues
• Enhanced clean build process for both local and global installations
• Improved global package installation workflow using proper tarball builds
• Better version consistency across all project files

🚀 Core System Enhancements

• Enhanced CLI gateway with improved context-aware extraction and intent registry
• Optimized hybrid matcher for better semantic routing
• Enhanced transport manager with better error handling and port allocation
• Improved LLM helper utilities and port allocator robustness

🛠️ Tool Improvements

• Enhanced code-map-generator with improved batch processing and graph building
• Optimized context-curator with better LLM integration and service improvements
• Updated multiple tools including fullstack-starter-kit-generator, task-list-generator, and others
• Added comprehensive test coverage for all tool improvements

⚙️ Configuration & Documentation

• Updated all configuration files with optimized settings
• Enhanced documentation with v0.3.1 release notes
• Updated system instructions and setup scripts
• Better integration between configuration files and core system

📦 Installation

npm install -g vibe-coder-mcp@0.3.1

🧪 What's Tested

• Global and local version alignment
• Clean build process for all installation methods
• TypeScript compilation with zero errors
• All tool functionality and integrations
• Configuration file consistency

Full Changelog: v0.3.0...v0.3.1

🎉 Release v0.3.0: Major NLP and Pattern Matching Improvements

🎯 Highlights

• 94%+ Accuracy: Reconnected pattern matching system achieving near-perfect accuracy
• 314 Patterns: Comprehensive pattern coverage across all 15 tools
• <1ms Response: Ultra-fast keyword prefiltering for instant matches
• Multi-layer Pipeline: Intelligent routing with progressive fallback

✨ What's New

Enhanced Natural Language Processing

• Reconnected previously disconnected pattern matching system
• Added 314 semantically relevant patterns across all tools
• Implemented ultra-fast keyword prefiltering
• Multi-layer matching pipeline for optimal performance

Comprehensive Pattern Coverage

• vibe-task-manager: 33 patterns
• research-manager: 27 patterns
• map-codebase: 25 patterns
• fullstack-starter-kit-generator: 23 patterns
• rules-generator: 23 patterns
• task-list-generator: 22 patterns
• curate-context: 22 patterns
• user-stories-generator: 21 patterns
• prd-generator: 20 patterns
• All other tools: 15-19 patterns each

Performance Improvements

• Pattern matching: <5ms for 90% confidence matches
• Keyword matching: <1ms for 85% confidence matches
• Overall accuracy improved from ~20% to 94%+
• Reduced fallback usage by 75%

🔧 Technical Details

• Fully type-safe implementation with zero TypeScript errors
• All changes follow existing architectural patterns
• Respects centralized configuration and security systems
• Comprehensive test coverage for all improvements

📦 Installation

npm install -g vibe-coder-mcp@latest

🚀 Quick Start

# Interactive REPL mode
vibe

# Process a natural language request
vibe "research best practices for React performance"

# Run setup wizard
vibe --setup

📚 Documentation

Full documentation available at: https://github.com/freshtechbro/Vibe-Coder-MCP

🙏 Contributors

Thanks to all contributors who helped make this release possible!

Full Changelog: v0.2.8...v0.3.0

🔧 What's New in Version 0.2.8

CLI Interactive Mode Enhancements

• ✅ Fixed CLI Interactive Mode Configuration Issues
  • Resolved configuration persistence problems in interactive mode
  • Fixed project root detection handling in CLI context
  • Improved configuration file management for better reliability
  • Enhanced unified configuration toggle behavior

📦 NPM Package Improvements

• Better handling of global npm installations
• Improved package reliability and installation experience
• Enhanced CLI binary execution and path resolution
• Fixed configuration loading for various installation scenarios
• Added missing configuration files to npm package

🎯 Configuration Management Refinements

• Fixed unified configuration enable/disable behavior
• Improved directory resolution for CLI operations
• Better fallback mechanisms for configuration loading
• Streamlined configuration file validation

📍 Developer Experience Updates

• Enhanced error handling in CLI interactive mode
• Improved configuration state management
• Better handling of edge cases in setup wizard
• More robust project directory detection

Installation

NPM (Recommended)

npm install -g vibe-coder-mcp@0.2.8

From Source

git clone https://github.com/freshtechbro/Vibe-Coder-MCP.git
cd Vibe-Coder-MCP
npm install
npm run build

Quick Start

After installation, run the CLI:

vibe

The interactive setup wizard will guide you through configuration.

Full Changelog

https://github.com/freshtechbro/Vibe-Coder-MCP/blob/master/CHANGELOG.md

Contributors

Thanks to all contributors who helped make this release possible!

🤖 Generated with Claude Code

🔧 Complete CLI Bug Resolution & Package Integrity

Version 0.2.7 represents the final resolution of all CLI-related issues, ensuring complete reliability and package integrity for all users.

🎯 Critical Fixes Summary

✅ CLI Onboarding Loop Bug (v0.2.5)

• Fixed persistent first-run detection issues where vibe command repeatedly triggered setup wizard
• Context-aware configuration system using enhanced TransportContext pattern for CLI vs Server differentiation
• Smart project root detection using process.cwd() instead of package directory
• Dual-location configuration saving (user directory + package fallback) for maximum reliability

✅ Runtime Dependency Issues (v0.2.6)

• Fixed "Cannot find package '@xenova/transformers'" errors by moving dependency to correct location
• Resolved CLI startup failures related to missing runtime dependencies
• Enhanced semantic matching functionality with proper dependency management
• Improved npm package reliability for global installations

✅ Missing Configuration Files (v0.2.7)

• Fixed "Failed to read file" errors by including all configuration files in npm package
• Added llm_config.json and job-timeout-config.json to package files array
• Ensured complete package functionality out of the box
• Enhanced package integrity for production deployments

🚀 Enhanced User Experience

Smart Auto-Detection

• Intelligent project root detection from current working directory
• Context-aware first-run detection with transport-specific validation
• Multi-directory support - run vibe from any directory in your project
• Proper configuration isolation between different projects

Robust File Management

• Enhanced error handling for configuration persistence and loading
• Better validation of configuration file locations and accessibility
• Comprehensive fallback mechanisms for maximum reliability
• Improved setup wizard with better user feedback

🧪 Quality Assurance & Testing

Comprehensive Validation

• Local package testing before each release to prevent runtime issues
• Extensive CLI onboarding flow testing covering all edge cases
• Enhanced error messages and debugging information throughout
• Security audits pass with zero vulnerabilities

Production Ready

• TypeScript compilation with strict typing enforcement (zero errors)
• ESLint validation passes with no issues
• Full build verification before each release
• Backward compatibility maintained for all existing setups

📦 Installation & Upgrade

# Install latest stable version
npm install -g vibe-coder-mcp@0.2.7

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

# Verify installation
vibe --help

🔍 What's Fixed

Before v0.2.7:

• CLI repeatedly asked for setup even after configuration
• Runtime errors for missing dependencies
• Configuration loading failures
• Inconsistent behavior between directories

After v0.2.7:

• ✅ CLI properly detects existing configuration
• ✅ All dependencies included and accessible
• ✅ Configuration files load correctly
• ✅ Consistent behavior from any project directory

🎉 User Benefits

• Zero Configuration Hassle: CLI works immediately after first setup
• Reliable Functionality: All features work out of the box
• Cross-Directory Support: Use from any location in your project
• Production Ready: Thoroughly tested and validated
• Complete Package: No missing files or dependencies

🔗 Links & Resources

• Documentation: https://github.com/freshtechbro/Vibe-Coder-MCP#readme
• Issues: https://github.com/freshtechbro/Vibe-Coder-MCP/issues
• Pull Request: #63
• Previous Releases: https://github.com/freshtechbro/Vibe-Coder-MCP/releases

Full Changelog: v0.2.6...v0.2.7

This release completes the CLI reliability initiative and ensures all users have a seamless, production-ready experience with vibe-coder-mcp.

🔧 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

• Pull Request: #62
• Documentation: https://github.com/freshtechbro/Vibe-Coder-MCP#readme
• Issues: https://github.com/freshtechbro/Vibe-Coder-MCP/issues

📦 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

v0.2.4: Unified Project Root Configuration 🎯

🎉 Highlights

This release introduces Unified Project Root Configuration, significantly simplifying the onboarding experience for both CLI and MCP users. Say goodbye to complex multi-variable configurations and hello to intelligent auto-detection!

🚀 What's New

For CLI Users

# Just navigate to your project and run:
cd /path/to/your/project
vibe

# That's it! Auto-detection handles the rest 🎉

For MCP Users (Claude Desktop, Cline, etc.)

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "VIBE_PROJECT_ROOT": "/path/to/your/project",
        "OPENROUTER_API_KEY": "your-api-key"
      }
    }
  }
}

📦 Installation

NPM Global Install

npm install -g vibe-coder-mcp@0.2.4

NPX Usage (No Install)

npx vibe-coder-mcp@0.2.4

🔥 Key Features

Unified Project Root Configuration

• Single Configuration Point: One VIBE_PROJECT_ROOT variable replaces multiple tool-specific variables
• Auto-Detection: CLI users get automatic project root detection - zero configuration needed!
• Transport Awareness: Different behavior based on runtime environment (CLI vs MCP)
• Backward Compatible: All legacy configurations continue to work

Enhanced Setup Wizard

• Interactive configuration with intelligent defaults
• Auto-detection toggle for zero-configuration usage
• Comprehensive validation before saving
• Improved user experience with clear prompts

Documentation Improvements

• Quick start guides for different user types
• Tool-specific documentation enhancements
• Troubleshooting section
• Migration guides from legacy configurations

📋 Full Changelog

Added

• Unified project root configuration system
• Auto-detection for CLI users
• Transport context awareness
• Enhanced setup wizard
• Comprehensive documentation updates

Changed

• Simplified environment variable structure
• Enhanced UnifiedSecurityConfigManager
• Improved CLI initialization sequence
• Updated all tool READMEs
• Refined configuration templates

Fixed

• CLI configuration persistence issues
• Version display problems
• Service initialization order
• Directory resolution edge cases
• Security boundary validation

Removed

• Redundant package-security-fix.sh script
• Outdated configuration complexity
• Unnecessary directory resolution duplication

🔄 Migration Guide

From v0.2.3 or Earlier

Your existing configurations will continue to work! However, we recommend migrating to the simplified approach:

Old Configuration (Multiple Variables):

CODE_MAP_ALLOWED_DIR="/path/to/project"
VIBE_TASK_MANAGER_READ_DIR="/path/to/project"
VIBE_TASK_MANAGER_WRITE_DIR="/path/to/project/output"
# ... and more

New Configuration (Single Variable):

VIBE_PROJECT_ROOT="/path/to/project"
# That's it! 🎉

🙏 Acknowledgments

Thanks to all contributors and users who provided feedback to improve the onboarding experience!

📚 Documentation

• README
• NPM Package
• Issues & Feedback

Full Release Notes: See RELEASE_NOTES_v0.2.4.md for detailed information.

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! 🚀

🎉 Vibe Coder MCP v0.1.0 - Now Available on NPM!

📦 NPM Package Available

Vibe Coder MCP is now published on npm for easy installation worldwide!

# Run instantly with npx (recommended)
npx vibe-coder-mcp

# Or install globally  
npm install -g vibe-coder-mcp
vibe-coder-mcp

# Or install locally in your project
npm install vibe-coder-mcp

NPM Package: https://www.npmjs.com/package/vibe-coder-mcp

✨ What's New in v0.1.0

🌍 Global Accessibility

• Published to npm - Install and run from anywhere with one command
• Zero-configuration npx support - No installation required
• Professional package presentation with comprehensive documentation

🔧 Easy Installation & Setup

• Executable binary via npm bin configuration
• Environment variable configuration for OpenRouter API
• Ready-to-use MCP client configurations for popular AI assistants

📚 Enhanced Documentation

• Comprehensive README with multiple installation options
• Quick Start guide for immediate value
• MCP client setup examples for Claude Desktop, Cursor, Windsurf, etc.
• Environment configuration guide with security boundaries

🚀 Key Features

• 15 Powerful Tools for complete development workflows
• Multi-Transport Support - stdio, SSE, WebSocket, HTTP
• 35+ Programming Languages supported for code analysis
• AI-Native Task Management with natural language processing
• Real-time Agent Coordination across all transport types
• Advanced Code Analysis with 95-97% token reduction
• Production-Ready Architecture with 99.9% test success rate

🎯 Perfect For

• AI Assistant Integration (Claude Desktop, Cursor, Windsurf, Cline)
• Development Workflow Automation
• Code Analysis & Context Curation
• Project Scaffolding & Planning
• Research & Requirements Generation

📖 Getting Started

1. Install & Run:

   npx vibe-coder-mcp

2. Get OpenRouter API Key: openrouter.ai

3. Configure Your MCP Client: See README for client-specific setup

4. Start Building: Access 15 powerful development tools instantly!

🔗 Important Links

• NPM Package: https://www.npmjs.com/package/vibe-coder-mcp
• Documentation: README.md
• Issues & Support: GitHub Issues

Thank you for using Vibe Coder MCP! 🚀

Built with ❤️ for the developer community