Skip to content

Release v0.2.4: Unified Project Root Configuration#61

Merged
freshtechbro merged 8 commits intomasterfrom
cli-patch
Aug 14, 2025
Merged

Release v0.2.4: Unified Project Root Configuration#61
freshtechbro merged 8 commits intomasterfrom
cli-patch

Conversation

@freshtechbro
Copy link
Owner

Summary

This PR introduces v0.2.4 with the Unified Project Root Configuration feature, significantly simplifying the onboarding experience for both CLI and MCP users.

Key Features

  • Unified Project Root Configuration: Single VIBE_PROJECT_ROOT variable replaces multiple tool-specific variables
  • 🚀 Auto-Detection for CLI Users: Zero-configuration setup with automatic project root detection
  • 🔄 Full Backward Compatibility: All legacy environment variables continue to work
  • 📚 Enhanced Documentation: Comprehensive updates to all READMEs and configuration examples
  • 🛠️ Improved Setup Wizard: Interactive configuration with intelligent defaults

Changes Included

Core Implementation

  • Enhanced UnifiedSecurityConfigManager with transport context support
  • Added directory resolution priority chain
  • Implemented auto-detection for CLI users
  • Fixed CLI initialization sequence

Documentation

  • Updated main README with quick start guides
  • Enhanced tool-specific documentation
  • Added migration guides and troubleshooting section
  • Created comprehensive release notes

Configuration

  • Simplified environment variables structure
  • Updated example configurations
  • Enhanced setup wizard with auto-detection toggle
  • Improved configuration templates

CI/CD

  • Streamlined pipeline to focus on code quality checks
  • Removed testing from automated pipeline (as requested)
  • Maintains lint, type-check, and build verification

Testing

All code quality checks pass:

  • ✅ ESLint (no errors)
  • ✅ TypeScript type checking (no errors)
  • ✅ Build successful

Release Preparation

  • Version bumped to 0.2.4
  • CHANGELOG updated with all changes
  • Release notes prepared for GitHub and NPM
  • NPM publishing guide updated

Breaking Changes

None - This release maintains full backward compatibility.

Next Steps

After merging:

  1. Create GitHub release with prepared release notes
  2. Publish to NPM registry
  3. Update documentation site if applicable

🤖 Generated with Claude Code

Oladotun Olatunji and others added 8 commits August 10, 2025 18:23
- Load dotenv config before first-run check to properly detect existing configuration
- Enhanced isFirstRun() to load .env file if it exists before checking environment variables
- Fixed version display to use dynamic package.json version instead of hardcoded values
- Improved post-setup flow to continue to interactive mode instead of exiting
- Ensures setup wizard only runs once for first-time users

These changes resolve the issue where the setup wizard was repeatedly triggered
even after configuration was saved, and fix incorrect version display (was showing
v0.3.0 instead of actual v0.2.3).

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Bump version from 0.2.3 to 0.2.4
- Add comprehensive release notes for v0.2.4
- Update CHANGELOG with v0.2.4 features and improvements
- Update NPM publishing guide with clearer instructions

Key features in this release:
- Unified project root configuration with VIBE_PROJECT_ROOT
- Auto-detection for CLI users
- Transport context awareness
- Enhanced setup wizard
- Comprehensive documentation improvements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update main README with quick start guides for different user types
- Add unified project root configuration examples
- Enhance tool-specific READMEs for code-map-generator, context-curator, and vibe-task-manager
- Include auto-detection documentation and examples
- Add troubleshooting section and configuration migration guides
- Update system instructions with unified configuration details
- Clarify security boundaries and permissions

Documentation now provides clear guidance for:
- MCP client users (Claude Desktop, Cline, etc.)
- CLI users with auto-detection capabilities
- Migration from legacy configurations
- Tool-specific configuration requirements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update .env.example with unified VIBE_PROJECT_ROOT variable
- Add VIBE_USE_PROJECT_ROOT_AUTO_DETECTION for CLI users
- Enhance configuration templates with clear sections and descriptions
- Update example_claude_desktop_config.json with simplified configuration
- Improve .env.template for setup wizard with comprehensive comments
- Maintain backward compatibility with legacy variables

Configuration improvements:
- Single VIBE_PROJECT_ROOT replaces multiple tool-specific variables
- Auto-detection option for zero-configuration CLI usage
- Clear documentation inline with configuration files
- Intelligent defaults for new users

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Enhance UnifiedSecurityConfigManager with transport context support
- Add directory resolution priority chain for intelligent path detection
- Implement auto-detection for CLI users when enabled
- Add comprehensive logging for configuration resolution
- Maintain full backward compatibility with legacy variables

Implementation details:
- Transport-aware configuration (CLI vs STDIO vs SSE/HTTP)
- Priority chain: Auto-detection → VIBE_PROJECT_ROOT → MCP config → Legacy vars → CWD
- Enhanced error messages and debug logging
- DRY compliance by enhancing existing services

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add auto-detection toggle in setup wizard
- Improve setup wizard user experience with clear prompts
- Fix CLI initialization sequence for singleton services
- Add structured logging with transport context
- Enhance error handling and user feedback
- Fix version display functionality in CLI

Setup wizard improvements:
- Interactive configuration with intelligent defaults
- Auto-detection option for zero-configuration
- Comprehensive validation before saving
- Clear descriptions for all settings

CLI improvements:
- Proper service initialization order
- Better error messages and logging
- Fixed configuration persistence issues

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update code-map-generator configValidator with unified variables
- Enhance context-curator with unified project root support
- Update vibe-task-manager to use unified configuration
- Improve error messages and validation across all tools
- Maintain backward compatibility with legacy configurations

Tool improvements:
- Simplified configuration validation
- Consistent error handling across tools
- Better integration with unified security manager
- Enhanced logging for debugging configuration issues

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Update GitHub Actions workflow for code quality checks only
- Remove testing from CI/CD pipeline as requested
- Keep lint, type-check, and build in CI pipeline
- Remove obsolete package-security-fix.sh script
- Remove old release notes for v0.2.3

CI/CD now focuses on:
- ESLint checks
- TypeScript type checking
- Build verification

This aligns with the project's focus on code quality
without running tests in automated pipelines.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@freshtechbro freshtechbro merged commit 30daeb0 into master Aug 14, 2025
3 checks passed
@freshtechbro freshtechbro deleted the cli-patch branch August 14, 2025 04:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant