Skip to content

Commit 5c9f2e1

Browse files
authored
Merge pull request #67 from freshtechbro/enhancement/cli-repl-hybrid-matcher-multi-tool-improvements
Release v0.3.5: Enhanced CLI, REPL, and Parameter Extraction
2 parents 2ac3e33 + c463e4d commit 5c9f2e1

File tree

43 files changed

+3237
-785
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+3237
-785
lines changed

.env.example

Lines changed: 14 additions & 173 deletions
Original file line numberDiff line numberDiff line change
@@ -1,177 +1,18 @@
1-
# =============================================================================
2-
# VIBE CODER MCP SERVER ENVIRONMENT CONFIGURATION
3-
# =============================================================================
4-
# This file contains all environment variables used by the Vibe Coder MCP Server.
5-
# Copy this file to .env and configure the values according to your setup.
1+
# Vibe Coder MCP Configuration
2+
# Generated by setup wizard
63

7-
# =============================================================================
8-
# REQUIRED CONFIGURATION
9-
# =============================================================================
4+
# Required: Your OpenRouter API key
5+
OPENROUTER_API_KEY="YOUR_OPENROUTER_API_KEY_HERE"
106

11-
# OpenRouter API Configuration (REQUIRED)
12-
OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY_HERE
13-
# Get your API key from: https://openrouter.ai/
7+
# Directory Configuration
8+
VIBE_CODER_OUTPUT_DIR="./VibeCoderOutput"
149

15-
# =============================================================================
16-
# OPTIONAL LLM MODEL CONFIGURATION
17-
# =============================================================================
10+
# Legacy Directory Configuration (Fallbacks)
11+
CODE_MAP_ALLOWED_DIR="."
12+
VIBE_TASK_MANAGER_READ_DIR="."
13+
VIBE_TASK_MANAGER_SECURITY_MODE="strict"
1814

19-
# OpenRouter Base URL (default: https://openrouter.ai/api/v1)
20-
# OPENROUTER_BASE_URL="https://openrouter.ai/api/v1"
21-
22-
# Preferred models for different tasks
23-
# GEMINI_MODEL="google/gemini-2.5-flash-preview-05-20"
24-
# PERPLEXITY_MODEL="perplexity/sonar-deep-research"
25-
26-
# =============================================================================
27-
# SERVER CONFIGURATION
28-
# =============================================================================
29-
30-
# Application Environment (development, production, test)
31-
# NODE_ENV="production"
32-
33-
# Logging Configuration
34-
# LOG_LEVEL="info"
35-
36-
# SSE Server Port (default: 3000)
37-
# SSE_PORT=3000
38-
39-
# HTTP Agent Port (default: 3011)
40-
# HTTP_AGENT_PORT=3011
41-
42-
# =============================================================================
43-
# CLI CONFIGURATION
44-
# =============================================================================
45-
46-
# CLI Output Format (text, json, yaml)
47-
# VIBE_CLI_DEFAULT_FORMAT="text"
48-
49-
# CLI Verbosity Level (quiet, normal, verbose)
50-
# VIBE_CLI_VERBOSITY="normal"
51-
52-
# Enable CLI Colors (true, false)
53-
# VIBE_CLI_COLORS="true"
54-
55-
# CLI Session Persistence
56-
# VIBE_CLI_PERSIST_SESSIONS="true"
57-
58-
# Setup Wizard Configuration
59-
# VIBE_SETUP_AUTO_RUN="true"
60-
# VIBE_SETUP_SKIP_VALIDATION="false"
61-
62-
# =============================================================================
63-
# 🆕 UNIFIED PROJECT ROOT CONFIGURATION (v0.2.4+) - RECOMMENDED
64-
# =============================================================================
65-
66-
# Single variable for all project operations (replaces separate tool configurations)
67-
# Set this to your project's root directory for unified configuration across all tools
68-
# VIBE_PROJECT_ROOT="/path/to/your/project"
69-
70-
# Enable automatic project root detection for CLI users
71-
# Set to "true" for CLI usage (zero configuration), "false" for MCP client usage
72-
# VIBE_USE_PROJECT_ROOT_AUTO_DETECTION="true"
73-
74-
# =============================================================================
75-
# DIRECTORY CONFIGURATION
76-
# =============================================================================
77-
78-
# Base output directory for all tools (default: ./VibeCoderOutput)
79-
# VIBE_CODER_OUTPUT_DIR="/path/to/your/output/directory"
80-
81-
# LLM Configuration File Path (default: ./llm_config.json)
82-
# LLM_CONFIG_PATH="/absolute/path/to/llm_config.json"
83-
84-
# Port Allocator Instance Tracking Directory (default: OS temp directory)
85-
# VIBE_CODER_INSTANCE_DIR="/path/to/your/output/directory/.temp/instances"
86-
87-
# =============================================================================
88-
# LEGACY DIRECTORY CONFIGURATION (Still Supported for Backward Compatibility)
89-
# =============================================================================
90-
# These variables are used as fallbacks if VIBE_PROJECT_ROOT is not set
91-
92-
# Task Manager Read Directory (for file operations)
93-
# VIBE_TASK_MANAGER_READ_DIR="/path/to/your/project/directory"
94-
95-
# Code Map Allowed Directory (for code analysis)
96-
# CODE_MAP_ALLOWED_DIR="/path/to/your/codebase/directory"
97-
98-
# =============================================================================
99-
# SECURITY CONFIGURATION
100-
# =============================================================================
101-
102-
# Security Features
103-
# VIBE_SECURITY_ENABLED="true"
104-
# VIBE_SECURITY_STRICT_MODE="true"
105-
# VIBE_SECURITY_LOG_VIOLATIONS="true"
106-
107-
# Path Security
108-
# VIBE_PATH_SECURITY_ENABLED="true"
109-
# VIBE_PATH_ALLOW_SYMLINKS="false"
110-
111-
# Data Sanitization
112-
# VIBE_DATA_SANITIZATION_ENABLED="true"
113-
114-
# Lock Management
115-
# VIBE_LOCK_TIMEOUT="30000"
116-
# VIBE_DEADLOCK_DETECTION="true"
117-
118-
# Performance Monitoring
119-
# VIBE_SECURITY_PERFORMANCE_THRESHOLD="50"
120-
121-
# =============================================================================
122-
# FEATURE FLAGS
123-
# =============================================================================
124-
125-
# Code Map Generator Features
126-
# ENHANCED_FUNCTION_DETECTION="true"
127-
# CONTEXT_ANALYSIS="true"
128-
# FRAMEWORK_DETECTION="true"
129-
# ROLE_IDENTIFICATION="true"
130-
# HEURISTIC_NAMING="true"
131-
# MEMORY_OPTIMIZATION="true"
132-
133-
# =============================================================================
134-
# DEVELOPMENT & DEBUGGING
135-
# =============================================================================
136-
137-
# Development Mode Settings (uncomment for development)
138-
# NODE_ENV="development"
139-
# LOG_LEVEL="debug"
140-
141-
# Performance Monitoring
142-
# ENABLE_PERFORMANCE_MONITORING="true"
143-
144-
# =============================================================================
145-
# CONFIGURATION NOTES
146-
# =============================================================================
147-
#
148-
# 🆕 UNIFIED CONFIGURATION BENEFITS (v0.2.4+):
149-
# - One variable (VIBE_PROJECT_ROOT) replaces multiple tool-specific variables
150-
# - Zero configuration for CLI users with auto-detection enabled
151-
# - Context-aware behavior for different usage modes (CLI vs MCP client)
152-
# - Backward compatible with existing legacy configurations
153-
#
154-
# TRANSPORT-SPECIFIC BEHAVIOR:
155-
# - CLI Transport: Uses auto-detection if enabled, otherwise VIBE_PROJECT_ROOT
156-
# - STDIO/MCP Transport: Uses VIBE_PROJECT_ROOT from environment or client config
157-
# - Legacy variables (CODE_MAP_ALLOWED_DIR, VIBE_TASK_MANAGER_READ_DIR) used as fallbacks
158-
#
159-
# DIRECTORY RESOLUTION PRIORITY:
160-
# 1. Auto-detection (CLI only, if enabled)
161-
# 2. VIBE_PROJECT_ROOT environment variable
162-
# 3. MCP client configuration
163-
# 4. Legacy environment variables
164-
# 5. Current working directory (fallback)
165-
#
166-
# GENERAL NOTES:
167-
# 1. OPENROUTER_API_KEY is required for the server to function
168-
# 2. Most other variables have sensible defaults and are optional
169-
# 3. Directory paths should be absolute paths for best compatibility
170-
# 4. Security settings are enabled by default in production
171-
# 5. Feature flags allow you to enable/disable specific functionality
172-
# 6. For development, set NODE_ENV=development and LOG_LEVEL=debug
173-
#
174-
# For more information, see:
175-
# - README.md: Complete setup guide
176-
# - VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md: System documentation
177-
# - docs/: Additional documentation
15+
# Advanced Configuration
16+
OPENROUTER_BASE_URL="https://openrouter.ai/api/v1"
17+
GEMINI_MODEL="google/gemini-2.5-flash-preview-05-20"
18+
PERPLEXITY_MODEL="perplexity/sonar"

.vibe-config.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"version": "0.3.1",
3-
"setupDate": "2025-08-15T13:08:59.215Z",
2+
"version": "1.0.0",
3+
"setupDate": "2025-08-20T19:09:44.388Z",
44
"unified": {
55
"enabled": false
66
},

README.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,15 @@ Vibe Coder is an MCP (Model Context Protocol) server designed to supercharge you
3131
- Better CI/CD preparation with proper version management
3232
- Improved packaging workflow for NPM publication
3333

34+
### Latest Release
35+
36+
#### Version 0.3.5 - Enhanced CLI and Parameter Extraction
37+
- **Major Hybrid Matcher Enhancements**: Complete parameter extraction logic for all 15 tools
38+
- **CLI/REPL Improvements**: Interactive confirmation for low-confidence matches, improved input handling
39+
- **Fixed Task-List-Generator**: Now auto-generates user stories when not provided
40+
- **Enhanced Tool Matching**: Multi-strategy approach (keyword, pattern, semantic, LLM fallback)
41+
- **Better User Experience**: Clear validation messages and job status polling
42+
3443
### Previous Releases
3544

3645
#### Version 0.2.8 - CLI Interactive Mode Fixes
@@ -208,6 +217,81 @@ vibe --help # Show all options
208217
- **Configuration templates** provided in `src/config-templates/`
209218
- Run `vibe --setup` manually to reconfigure at any time
210219

220+
## 🎯 MCP Client Integration (Claude Desktop, Cursor, Cline AI)
221+
222+
### Quick Integration Guide
223+
224+
Vibe-Coder MCP integrates seamlessly with any MCP-compatible client. Here's how to configure it:
225+
226+
#### Option 1: Using NPX (Recommended)
227+
In your MCP client's server configuration dialog:
228+
- **Server Name**: `vibe-coder-mcp`
229+
- **Command/URL**: `npx`
230+
- **Arguments**: `vibe-coder-mcp`
231+
- **Environment Variables**:
232+
- `OPENROUTER_API_KEY`: Your OpenRouter API key (required)
233+
- `VIBE_PROJECT_ROOT`: `/path/to/your/project` (required)
234+
- `LOG_LEVEL`: `info` (optional)
235+
- `NODE_ENV`: `production` (optional)
236+
237+
#### Option 2: Global Installation
238+
```bash
239+
# First install globally
240+
npm install -g vibe-coder-mcp
241+
```
242+
Then configure:
243+
- **Command/URL**: `vibe`
244+
- **Arguments**: (leave empty)
245+
- **Environment Variables**: Same as Option 1
246+
247+
#### Option 3: Node with Full Path
248+
- **Command/URL**: `node`
249+
- **Arguments**: `/path/to/node_modules/vibe-coder-mcp/build/index.js`
250+
- **Environment Variables**: Same as Option 1
251+
252+
### Claude Desktop Specific Configuration
253+
254+
For Claude Desktop users, add this to your `claude_desktop_config.json`:
255+
256+
```json
257+
{
258+
"mcpServers": {
259+
"vibe-coder-mcp": {
260+
"command": "npx",
261+
"args": ["vibe-coder-mcp"],
262+
"env": {
263+
"OPENROUTER_API_KEY": "your-openrouter-api-key",
264+
"VIBE_PROJECT_ROOT": "/path/to/your/project",
265+
"LOG_LEVEL": "info",
266+
"NODE_ENV": "production"
267+
}
268+
}
269+
}
270+
}
271+
```
272+
273+
See `example_claude_desktop_config.json` for a complete example.
274+
275+
### Available Tools After Integration
276+
277+
Once configured, your MCP client will have access to:
278+
- **vibe-task-manager**: AI-native task management with RDD methodology
279+
- **research-manager**: Deep research using Perplexity integration
280+
- **map-codebase**: Advanced codebase analysis (35+ languages)
281+
- **curate-context**: Intelligent context curation for AI development
282+
- **generate-prd**: Product requirements document generator
283+
- **generate-user-stories**: User story generator
284+
- **generate-task-list**: Task list generator
285+
- **generate-fullstack-starter-kit**: Project scaffolding tool
286+
- **run-workflow**: Multi-step workflow execution
287+
288+
### Testing Your Integration
289+
290+
After configuration, test by asking your AI assistant:
291+
- "Use vibe to research React best practices"
292+
- "Map the codebase for this project"
293+
- "Generate a PRD for a task management app"
294+
211295
## 🆕 Unified Project Root Configuration
212296

213297
**New in v0.2.4+**: Simplified configuration with automatic project detection!

VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Vibe Coder MCP System Instructions
22

3-
**Version**: 0.3.1 (Production Ready)
3+
**Version**: 0.3.5 (Production Ready)
44
**NPM Package**: `vibe-coder-mcp`
55
**Purpose**: Comprehensive system prompt for AI agents and MCP clients consuming the Vibe Coder MCP server
66
**Target Clients**: Claude Desktop, Augment, Cursor, Windsurf, Roo Code, Cline, and other MCP-compatible clients
7-
**Last Updated**: August 2025 (NPM publication ready)
7+
**Last Updated**: August 2025 (Enhanced CLI and Parameter Extraction)
88

99
## Installation
1010

@@ -60,6 +60,13 @@ You are an AI assistant with access to the Vibe Coder MCP server, a comprehensiv
6060
- **Agent Coordination and Communication**: Multi-agent task distribution and response handling
6161
- **Asynchronous Job Processing**: Intelligent polling with adaptive intervals and rate limiting
6262

63+
**New in v0.3.5:**
64+
- **Enhanced Hybrid Matcher**: Complete parameter extraction for all 15 tools with intelligent defaults
65+
- **CLI/REPL Major Improvements**: Interactive confirmation for low-confidence matches, job status polling, enhanced input handling
66+
- **Parameter Validation Fixes**: Task-list-generator now generates default user stories when not provided
67+
- **Improved Tool Matching**: Multi-strategy approach with keyword, pattern, semantic, and LLM fallback
68+
- **Better Error Handling**: Clear validation messages and user-friendly feedback
69+
6370
**Architecture Evolution (v2.4.0):**
6471
- **Testing Framework**: Complete migration from Jest to Vitest with @vitest/coverage-v8
6572
- **Build System**: TypeScript ESM with NodeNext module resolution, outputs to `/build` directory
@@ -841,22 +848,22 @@ This section provides detailed instructions, examples, and natural language comm
841848
**Input Parameters**:
842849
```json
843850
{
844-
"description": "string (required) - Project or feature description",
845-
"userStories": "string (optional) - User stories to break down into tasks"
851+
"productDescription": "string (required) - Project or feature description (min 10 chars)",
852+
"userStories": "string (required, auto-generated if not provided) - User stories to break down into tasks (min 20 chars)"
846853
}
847854
```
848855

849856
**Usage Examples**:
850857
```json
851-
// From feature description
858+
// From feature description (userStories auto-generated)
852859
{
853-
"description": "Implement user authentication system with OAuth 2.0, JWT tokens, and role-based access control"
860+
"productDescription": "Implement user authentication system with OAuth 2.0, JWT tokens, and role-based access control"
854861
}
855862

856-
// From user stories
863+
// With explicit user stories
857864
{
858-
"description": "E-commerce checkout process",
859-
"userStories": "User stories for cart management, payment processing, and order confirmation"
865+
"productDescription": "E-commerce checkout process",
866+
"userStories": "As a customer, I want to review my cart before checkout. As a customer, I want multiple payment options. As a customer, I want to receive order confirmation."
860867
}
861868
```
862869

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,15 @@
11
{
22
"name": "vibe-coder-mcp",
3-
"version": "0.3.1",
3+
"version": "0.3.5",
44
"description": "Production-ready MCP server with complete agent integration, multi-transport support, and comprehensive development automation tools for AI-assisted workflows.",
55
"main": "build/index.js",
66
"type": "module",
77
"scripts": {
88
"build": "tsc && npm run copy-assets && npm run fix-permissions",
9-
"copy-assets": "mkdir -p build/tools/vibe-task-manager && cp -r src/tools/vibe-task-manager/prompts build/tools/vibe-task-manager/",
9+
"copy-assets": "npm run copy-prompts && npm run copy-grammars && npm run copy-templates",
10+
"copy-prompts": "mkdir -p build/tools/vibe-task-manager && cp -r src/tools/vibe-task-manager/prompts build/tools/vibe-task-manager/",
11+
"copy-grammars": "mkdir -p build/tools/code-map-generator && cp -r src/tools/code-map-generator/grammars build/tools/code-map-generator/",
12+
"copy-templates": "mkdir -p build/tools/context-curator && cp -r src/tools/context-curator/templates build/tools/context-curator/",
1013
"fix-permissions": "chmod +x build/unified-cli.js",
1114
"start": "cross-env NODE_ENV=production LOG_LEVEL=info node build/index.js",
1215
"start:sse": "cross-env NODE_ENV=production LOG_LEVEL=info node build/index.js --sse",
@@ -178,6 +181,7 @@
178181
"workflows.json",
179182
"src/config-templates/**/*",
180183
"src/tools/fullstack-starter-kit-generator/templates/**/*",
184+
"src/tools/context-curator/templates/**/*",
181185
"src/config/prompt-optimization.yaml"
182186
],
183187
"repository": {

0 commit comments

Comments
 (0)