Merge pull request #61 from freshtechbro/cli-patch

Release v0.2.4: Unified Project Root Configuration

Author: freshtechbro

.env.example

@@ -59,6 +59,18 @@ OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY_HERE
 # VIBE_SETUP_AUTO_RUN="true"
 # VIBE_SETUP_SKIP_VALIDATION="false"
 
+# =============================================================================
+# 🆕 UNIFIED PROJECT ROOT CONFIGURATION (v0.2.4+) - RECOMMENDED
+# =============================================================================
+
+# Single variable for all project operations (replaces separate tool configurations)
+# Set this to your project's root directory for unified configuration across all tools
+# VIBE_PROJECT_ROOT="/path/to/your/project"
+
+# Enable automatic project root detection for CLI users
+# Set to "true" for CLI usage (zero configuration), "false" for MCP client usage
+# VIBE_USE_PROJECT_ROOT_AUTO_DETECTION="true"
+
 # =============================================================================
 # DIRECTORY CONFIGURATION
 # =============================================================================
@@ -69,15 +81,20 @@ OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY_HERE
 # LLM Configuration File Path (default: ./llm_config.json)
 # LLM_CONFIG_PATH="/absolute/path/to/llm_config.json"
 
+# Port Allocator Instance Tracking Directory (default: OS temp directory)
+# VIBE_CODER_INSTANCE_DIR="/path/to/your/output/directory/.temp/instances"
+
+# =============================================================================
+# LEGACY DIRECTORY CONFIGURATION (Still Supported for Backward Compatibility)
+# =============================================================================
+# These variables are used as fallbacks if VIBE_PROJECT_ROOT is not set
+
 # Task Manager Read Directory (for file operations)
 # VIBE_TASK_MANAGER_READ_DIR="/path/to/your/project/directory"
 
 # Code Map Allowed Directory (for code analysis)
 # CODE_MAP_ALLOWED_DIR="/path/to/your/codebase/directory"
 
-# Port Allocator Instance Tracking Directory (default: OS temp directory)
-# VIBE_CODER_INSTANCE_DIR="/path/to/your/output/directory/.temp/instances"
-
 # =============================================================================
 # SECURITY CONFIGURATION
 # =============================================================================
@@ -125,9 +142,28 @@ OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY_HERE
 # ENABLE_PERFORMANCE_MONITORING="true"
 
 # =============================================================================
-# NOTES
+# CONFIGURATION NOTES
 # =============================================================================
 #
+# 🆕 UNIFIED CONFIGURATION BENEFITS (v0.2.4+):
+# - One variable (VIBE_PROJECT_ROOT) replaces multiple tool-specific variables
+# - Zero configuration for CLI users with auto-detection enabled
+# - Context-aware behavior for different usage modes (CLI vs MCP client)
+# - Backward compatible with existing legacy configurations
+#
+# TRANSPORT-SPECIFIC BEHAVIOR:
+# - CLI Transport: Uses auto-detection if enabled, otherwise VIBE_PROJECT_ROOT
+# - STDIO/MCP Transport: Uses VIBE_PROJECT_ROOT from environment or client config
+# - Legacy variables (CODE_MAP_ALLOWED_DIR, VIBE_TASK_MANAGER_READ_DIR) used as fallbacks
+#
+# DIRECTORY RESOLUTION PRIORITY:
+# 1. Auto-detection (CLI only, if enabled)
+# 2. VIBE_PROJECT_ROOT environment variable
+# 3. MCP client configuration
+# 4. Legacy environment variables
+# 5. Current working directory (fallback)
+#
+# GENERAL NOTES:
 # 1. OPENROUTER_API_KEY is required for the server to function
 # 2. Most other variables have sensible defaults and are optional
 # 3. Directory paths should be absolute paths for best compatibility

.github/workflows/ci.yml

@@ -1,5 +1,10 @@
 name: CI Pipeline
 
+# Simplified CI pipeline focusing on essential checks for faster feedback
+# Performance: ~70% faster than previous full test suite (3 min vs 10+ min)
+# Runs: Type checking, linting, and build validation only
+# Tests: Unit tests run locally by developers before PR submission
+
 on:
   push:
     branches: [ main, master, develop, 'feature/**', 'fix/**', 'cli-fixes' ]
@@ -10,7 +15,8 @@ env:
   NODE_VERSION: '20.x'
 
 jobs:
-  # Type checking
+  # Type checking - Critical for TypeScript ESM codebase
+  # Ensures no 'any' types and strict typing requirements
   type-check:
     name: TypeScript Type Check
     runs-on: ubuntu-latest
@@ -30,7 +36,8 @@ jobs:
       - name: TypeScript compilation check
         run: npm run type-check
 
-  # Linting
+  # Linting - Enforces code quality standards
+  # Catches style issues and potential bugs early
   lint:
     name: Code Quality (Lint)
     runs-on: ubuntu-latest
@@ -50,7 +57,9 @@ jobs:
       - name: Run ESLint
         run: npm run lint
 
-  # Build validation
+  # Build validation - Ensures package compiles correctly
+  # Creates distributable artifacts for deployment
+  # Dependencies: Runs after type-check and lint pass
   build:
     name: Build
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -5,6 +5,203 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.2.4] - 2025-08-14
+
+### Added
+- **Unified Project Root Configuration**
+  - Single `VIBE_PROJECT_ROOT` environment variable replaces multiple tool-specific variables
+  - Automatic project root detection for CLI users with `VIBE_USE_PROJECT_ROOT_AUTO_DETECTION`
+  - Transport context awareness for different runtime environments (CLI vs MCP clients)
+  - Intelligent directory resolution priority chain
+  - Full backward compatibility with legacy environment variables
+
+- **Enhanced Setup Wizard**
+  - Interactive configuration with intelligent defaults
+  - Auto-detection toggle for zero-configuration CLI usage
+  - Comprehensive validation before saving configurations
+  - Improved user experience with clear prompts and descriptions
+
+- **Documentation Improvements**
+  - Comprehensive README updates with quick start guides
+  - Enhanced tool-specific documentation for all major tools
+  - Added troubleshooting section
+  - Updated configuration examples with unified approach
+
+### Changed
+- **UnifiedSecurityConfigManager Enhancement**
+  - Added transport context support for CLI auto-detection
+  - Implemented directory resolution priority chain
+  - Maintained backward compatibility while simplifying configuration
+  - Enhanced error messages and logging
+
+- **Configuration Management**
+  - Simplified `.env.example` with clear sections
+  - Updated `example_claude_desktop_config.json` with unified variables
+  - Improved configuration templates for setup wizard
+  - Enhanced validation and error handling
+
+- **CLI Improvements**
+  - Fixed initialization sequence for proper service startup
+  - Added proper singleton service initialization order
+  - Improved error handling and user feedback
+  - Enhanced version display functionality
+
+### Fixed
+- CLI configuration persistence issues
+- Version display problems in CLI
+- Service initialization order for singleton managers
+- Directory resolution in various transport contexts
+- Security boundary validation in unified configuration
+
+### Removed
+- Redundant `package-security-fix.sh` script
+- Outdated configuration complexity
+- Unnecessary directory resolution duplication
+
+## [0.2.3] - 2025-08-13
+
+### Added
+- **Configuration Infrastructure**
+  - UserConfigManager for intelligent OS-specific configuration directory management
+    - Windows: `%APPDATA%\vibe-coder`
+    - macOS: `~/Library/Application Support/vibe-coder`
+    - Linux: `~/.config/vibe-coder` (XDG compliant)
+  - ConfigValidator with comprehensive Zod-based validation and actionable error messages
+  - Automatic configuration backup system with timestamped archives
+  - Configuration templates for new users:
+    - `.env.template` with inline documentation
+    - `llm_config.template.json` with complete model mappings
+    - `mcp-config.template.json` with tool-specific configurations
+  - First-time user detection with multiple indicators
+  - Non-interactive setup support for CI/CD environments
+
+- **Setup Wizard Enhancements**
+  - ASCII art banner for visual polish
+  - Improved user prompts and guidance for OpenRouter API setup
+  - Multi-location configuration saving (user and project directories)
+  - Smart detection of existing configurations
+  - Streamlined onboarding flow for new users
+  - Directory permissions setup assistance
+  - Security mode selection (strict/permissive)
+  - Model preferences configuration
+
+- **Documentation**
+  - NPM Publishing Guide for maintainers
+  - Comprehensive Release Notes for v0.2.3
+  - Updated package contents documentation
+
+### Changed
+- **CI/CD Pipeline Simplification**
+  - Simplified pipeline to run unit tests only (70% faster execution)
+  - Adjusted coverage threshold to 70% for unit tests
+  - Added proper NODE_OPTIONS configuration for memory optimization
+  - Made integration tests available for manual runs only
+  - Optimized GitHub Actions workflow for faster builds
+  - Removed redundant test runs during publishing
+
+- **Documentation Cleanup**
+  - Removed outdated CI-CD-ANALYSIS.md after implementation
+  - Removed CONFIG_ONBOARDING_PLAN.md after feature completion
+  - Consolidated redundant documentation files
+  - Updated inline code documentation for clarity
+
+- **Configuration Updates**
+  - Enhanced mcp-config.json with better default settings
+  - Improved research-manager tool configuration
+  - Updated default timeout settings for better performance
+
+### Fixed
+- **CLI Configuration Issues**
+  - CLI configuration persistence across sessions now works correctly
+  - Version display in CLI commands (`--version` flag) now shows correct version
+  - First-time user crash when API key is missing resolved
+  - Interactive mode banner display in REPL fixed
+  - Executable permissions for CLI binary in build process corrected
+
+- **REPL Mode Improvements**
+  - Fixed banner display timing in interactive mode
+  - Resolved context preservation issues in REPL sessions
+  - Fixed command history navigation
+  - Corrected auto-completion behavior
+
+- **Build Process**
+  - Pre-publish validation script improvements
+  - Better handling of package contents verification
+  - Fixed asset copying during build process
+
+### Improved
+- **Performance Optimizations**
+  - CI pipeline execution time reduced by ~70%
+  - Memory usage optimized for test runs
+  - Faster npm package installation
+  - Better resource cleanup in tests
+  - Reduced package size through documentation cleanup
+
+- **User Experience**
+  - More intuitive first-run experience
+  - Better error messages with actionable suggestions
+  - Improved help system with contextual examples
+  - Enhanced progress indicators during setup
+
+- **Code Quality**
+  - Better TypeScript type definitions
+  - Enhanced error handling throughout the codebase
+  - Improved test coverage for new features
+  - Cleaner separation of concerns in configuration management
+
+## [0.2.2] - 2025-08-11
+
+### Added
+- **Interactive REPL Mode**
+  - `--interactive` flag for unified CLI to enable REPL mode
+  - Context-aware command processing in interactive sessions
+  - Command history and auto-completion support
+  - Persistent session state across commands
+  - Multi-line input support for complex commands
+  - Exit commands (`exit`, `quit`, `.exit`)
+
+### Fixed
+- **CLI Integration Issues**
+  - Fixed CLI mode detection in unified-cli.ts
+  - Resolved path resolution for global installations
+  - Corrected argument parsing for interactive mode
+
+### Improved
+- **Developer Experience**
+  - Better error messages in CLI mode
+  - Enhanced help system with more examples
+  - Improved command parsing and validation
+  - Better handling of interrupted commands
+
+## [0.2.1] - 2025-08-10
+
+### Fixed
+- **CLI Binary Installation**
+  - Fixed executable permissions for CLI binaries (`vibe`, `vibe-coder-mcp`)
+  - Resolved npm global installation path issues
+  - Corrected binary linking in package.json
+  - Fixed post-install script execution
+
+- **Build Process Issues**
+  - Added proper chmod +x for CLI files during build
+  - Fixed asset copying for binary distribution
+  - Resolved TypeScript compilation issues for CLI
+
+### Changed
+- **CI/CD Optimizations**
+  - Disabled tests during npm publish to speed up releases
+  - Optimized publishing pipeline for faster deployments
+  - Added pre-publish validation script
+
+### Improved
+- **Installation Process**
+  - Better handling of global npm installations
+  - Improved post-install scripts with error handling
+  - Enhanced binary path resolution for different platforms
+  - Added fallback mechanisms for permission issues
+
 ## [0.2.0] - 2025-08-09
 
 ### 🚀 Added
@@ -173,4 +370,12 @@ This release introduces a complete CLI system while maintaining full backward co
 - **Tool-Specific Documentation** with detailed examples
 - **Architecture Documentation** with clear patterns and conventions
 - **Contributing Guidelines** for community development
-- **Security Policy** with vulnerability reporting procedures
+- **Security Policy** with vulnerability reporting procedures
+
+---
+
+[0.2.3]: https://github.com/freshtechbro/Vibe-Coder-MCP/compare/v0.2.2...v0.2.3
+[0.2.2]: https://github.com/freshtechbro/Vibe-Coder-MCP/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/freshtechbro/Vibe-Coder-MCP/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/freshtechbro/Vibe-Coder-MCP/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/freshtechbro/Vibe-Coder-MCP/releases/tag/v0.1.0