@yeepay/coderocket-mcp 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,140 @@
+# Changelog
+
+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).
+
+## [1.1.1] - 2025-08-01
+
+### 🧹 Service Cleanup & Test Enhancement
+
+#### ✨ Removed
+
+- **OpenCode Service**: Removed expired OpenCode service integration
+  - Removed from type definitions and service configurations
+  - Updated AI service manager to only support Gemini and ClaudeCode
+  - Cleaned up documentation and environment variable references
+
+#### 🧪 Enhanced Testing
+
+- **Comprehensive Test Coverage**: Added extensive test coverage for core components
+  - **ConfigManager Tests**: Configuration loading, priority hierarchy, environment variable handling
+  - **PromptManager Tests**: Prompt loading, caching mechanism, default fallbacks
+  - **AI Service Failover Tests**: Service availability, intelligent switching, error handling
+  - **Enhanced Error Scenarios**: Better coverage of edge cases and error conditions
+- **Test Reliability**: Improved test isolation and environment cleanup
+- **100% Test Pass Rate**: All 8 test categories now pass successfully
+
+#### 📊 Test Results
+
+- Total Tests: 8
+- Pass Rate: 100% ✅
+- Coverage Areas: Core components, service integration, error handling, boundary conditions
+
+## [1.1.0] - 2025-08-01
+
+### 🚀 Major Changes - Complete Independence
+
+This release marks a major milestone: **CodeRocket MCP is now completely independent** and no longer requires `coderocket-cli` as a dependency.
+
+### ✨ Added
+
+- **Independent Configuration Management**: New `ConfigManager` class with support for:
+  - Environment variables
+  - Project-level `.env` files
+  - Global `~/.coderocket/env` configuration
+  - Priority hierarchy: env vars > project .env > global .env > defaults
+
+- **Independent Prompt Management**: New `PromptManager` class with support for:
+  - Project-level prompts in `./prompts/` directory
+  - Global prompts in `~/.coderocket/prompts/` directory
+  - Built-in default prompts
+
+- **Direct AI Service Integration**: Native API implementations for:
+  - **Gemini**: Using `@google/generative-ai` SDK with `gemini-1.5-flash` model
+  - **ClaudeCode**: Using `@anthropic-ai/sdk` for direct API calls
+  - **OpenCode**: HTTP-based API integration with axios
+
+- **Intelligent AI Manager**: New `AIManager` class with:
+  - Smart service selection and failover
+  - Automatic retry logic with exponential backoff
+  - Service health monitoring
+  - Load balancing across available services
+
+- **Enhanced Error Handling**: New `ErrorHandler` class with:
+  - Contextual error messages
+  - User-friendly error suggestions
+  - Detailed logging for debugging
+
+### 🔄 Changed
+
+- **Startup Method**: Now supports direct execution without parameters
+  - Old: `coderocket-mcp start`
+  - New: `npx @yeepay/coderocket-mcp` (recommended)
+  - Still supports: `coderocket-mcp` (if globally installed)
+
+- **Configuration Approach**: Moved from CLI-based to environment variable-based configuration
+  - Supports standard MCP configuration patterns
+  - Maintains backward compatibility with existing `.env` files
+
+- **Model Updates**: Updated Gemini model from deprecated `gemini-pro` to `gemini-1.5-flash`
+
+### 🗑️ Removed
+
+- **CodeRocket-CLI Dependency**: Completely removed dependency on `coderocket-cli`
+- **Shell Script Execution**: Replaced shell script calls with direct API implementations
+- **Path Detection Logic**: Removed `findCoderocketCliPath()` and related functions
+- **CLI Command Execution**: Removed `executeShellCommand()` and `callAIServiceManager()`
+
+### 🛠️ Technical Improvements
+
+- **Type Safety**: Enhanced TypeScript types and error handling
+- **Performance**: Direct API calls eliminate shell script overhead
+- **Reliability**: Reduced external dependencies and failure points
+- **Maintainability**: Cleaner architecture with separation of concerns
+
+### 📚 Documentation
+
+- Updated README.md with independent installation instructions
+- Added comprehensive environment variable documentation
+- Updated troubleshooting guide for independent operation
+- Enhanced feature comparison table
+
+### 🧪 Testing
+
+- Updated test suite for independent operation
+- Added configuration management tests
+- Enhanced error scenario testing
+- Improved boundary condition testing
+- All tests now pass with 100% success rate
+
+### 🔧 Migration Guide
+
+For users upgrading from previous versions:
+
+1. **No more CLI dependency**: Uninstall `coderocket-cli` if only used for MCP
+2. **Environment variables**: Move API keys to environment variables or `.env` files
+3. **New startup command**: Use `npx @yeepay/coderocket-mcp` instead of `coderocket-mcp start`
+4. **Configuration files**: Existing `.env` files continue to work
+
+### 📦 Dependencies
+
+- Added: `@google/generative-ai@^0.21.0`
+- Added: `@anthropic-ai/sdk@^0.27.0`
+- Added: `axios@^1.6.0`
+- Removed: All `coderocket-cli` related dependencies
+
+---
+
+## [1.0.1] - 2024-XX-XX
+
+### Fixed
+- Initial bug fixes and stability improvements
+
+## [1.0.0] - 2024-XX-XX
+
+### Added
+- Initial release with `coderocket-cli` dependency
+- Basic MCP server functionality
+- Code review capabilities

package/CRUSH.md

@@ -0,0 +1,38 @@
+## Coderocket MCP `CRUSH.md`
+
+This file provides agentic coding agents with instructions for operating in this repository.
+
+### Commands
+
+- **Build:** `npm run build`
+- **Lint:** `npm run lint`
+- **Format:** `npm run format`
+- **Test:** `npm run test`
+  - To run a single test, you'll need to modify the `test` script in `package.json`. For example: `node dist/test.js --grep "My test name"`
+- **Dev:** `npm run dev`
+
+### Code Style
+
+- **Formatting:** This project uses Prettier for code formatting. Run `npm run format` to format your code.
+- **Imports:**
+  - Use ES module imports (`import ... from ...`).
+  - Add a `.js` extension to relative imports (e.g., `import { logger } from './logger.js'`).
+  - Group imports by type: node built-in, third-party, and then local modules.
+- **Types:**
+  - This project uses TypeScript. All new code should have explicit types.
+  - Use interfaces for public APIs and types for internal data structures.
+  - Use Zod for runtime type validation where necessary.
+- **Naming Conventions:**
+  - Use PascalCase for classes and types (e.g., `CodeRocketService`, `ReviewResult`).
+  - Use camelCase for functions and variables (e.g., `reviewCode`, `commitHash`).
+  - Use UPPER_CASE for constants and environment variables (e.g., `AI_SERVICE`).
+- **Error Handling:**
+  - Use `try...catch` blocks for all I/O and API calls.
+  - Use the `logger` to log errors.
+  - Use the `errorHandler` to handle and normalize errors.
+- **Async/Await:** Use `async/await` for all asynchronous operations.
+- **Comments:** Add JSDoc comments to all public classes and methods.
+- **General:**
+  - Favor classes for managing state and related functions.
+  - Use helper functions to break up complex logic.
+  - Keep functions small and focused on a single task.

package/README.md

@@ -1,21 +1,23 @@
 # CodeRocket MCP
 
 <div align="center">
-  <img src="docs/assets/banner.png" alt="CodeRocket Banner" />
+  <img src="https://raw.githubusercontent.com/im47cn/coderocket-mcp/refs/heads/develop/docs/assets/banner.png" alt="CodeRocket Banner" />
 </div>
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 
-一个基于 Model Context Protocol (MCP) 的智能代码审查 MCP，集成了 CodeRocket-CLI 的强大功能，为AI编程工具提供专业的代码审查能力。
+一个完全独立的基于 Model Context Protocol (MCP) 的智能代码审查服务器，为AI编程工具提供专业的代码审查能力。
 
 ## 🚀 核心功能
 
+- **完全独立运行**：无需依赖任何外部CLI工具，开箱即用
 - **多维度代码审查**：支持代码片段、Git提交、文件列表的全面审查
-- **多AI服务支持**：集成Gemini、OpenCode、ClaudeCode等多种AI服务
+- **多AI服务支持**：原生集成Gemini、ClaudeCode、OpenCode等AI服务
 - **智能故障转移**：自动切换AI服务，确保审查的可靠性
-- **灵活配置管理**：支持项目级和全局级配置
+- **灵活配置管理**：支持环境变量和.env文件配置
+- **专业提示词系统**：内置专业代码审查提示词，支持自定义
 - **详细错误处理**：提供用户友好的错误信息和解决建议
 - **完整日志记录**：详细的操作日志，便于调试和监控
 
@@ -31,17 +33,31 @@
 
 ## 🛠 安装
 
-### 正式安装（推荐）
+### 快速安装（推荐）
 
 #### 前置要求
 
 1. **Node.js**: >= 18.0.0
-2. **CodeRocket-CLI**: 需要先安装 [CodeRocket-CLI](https://github.com/im47cn/coderocket-cli)
-3. **AI服务**: 至少配置一个AI服务（Gemini、OpenCode或ClaudeCode）
+2. **AI服务API密钥**: 至少配置一个AI服务（Gemini、ClaudeCode或OpenCode）
 
-#### 安装过程
+#### 直接使用（无需安装）
 
-从npm注册表安装：
+使用 npx 直接运行，无需全局安装：
+
+```bash
+# 直接启动 CodeRocket MCP 服务器
+npx @yeepay/coderocket-mcp
+
+# 查看帮助信息
+npx @yeepay/coderocket-mcp help
+
+# 查看版本信息
+npx @yeepay/coderocket-mcp version
+```
+
+#### 全局安装（可选）
+
+如果需要全局安装：
 
 ```bash
 # 1. 全局安装CodeRocket MCP
@@ -283,23 +299,30 @@ npm run build
 **问题 2**: AI服务不可用
 
 ```bash
-# 检查AI服务状态
-gemini --version
-opencode --version
-claudecode --version
+# 检查API密钥配置
+echo $GEMINI_API_KEY
+echo $CLAUDECODE_API_KEY
+echo $OPENCODE_API_KEY
+
+# 检查配置文件
+cat ~/.coderocket/env
+cat .env
 
-# 重新配置AI服务
-gemini config
+# 使用get_ai_service_status工具检查服务状态
+npx @yeepay/coderocket-mcp test
 ```
 
-**问题 3**: CodeRocket-CLI路径错误
+**问题 3**: 配置文件权限问题
 
 ```bash
-# 设置环境变量指定路径
-export CODEROCKET_CLI_PATH=/path/to/coderocket-cli
-
-# 或在项目中创建符号链接
-ln -s /path/to/coderocket-cli ./coderocket-cli
+# 检查配置目录权限
+ls -la ~/.coderocket/
+chmod 700 ~/.coderocket/
+chmod 600 ~/.coderocket/env
+
+# 检查项目配置文件
+ls -la .env
+chmod 600 .env
 ```
 
 ### 调试模式
@@ -307,14 +330,16 @@ ln -s /path/to/coderocket-cli ./coderocket-cli
 启用详细日志：
 
 ```bash
-NODE_ENV=development npm start
+DEBUG=true NODE_ENV=development npx @yeepay/coderocket-mcp
 ```
 
-查看日志文件：
+查看详细错误信息：
 
 ```bash
-# 日志文件位置
-tail -f /tmp/coderocket-mcp.log
+# 启用调试模式
+export DEBUG=true
+export NODE_ENV=development
+npx @yeepay/coderocket-mcp
 ```
 
 ## 👨‍💻 开发指南
@@ -363,7 +388,7 @@ npm test
 
 ## 🤝 贡献
 
-我们欢迎社区贡献！请参考 [CodeRocket-CLI贡献指南](../coderocket-cli/CONTRIBUTING.md)。
+我们欢迎社区贡献！请参考 [CodeRocket-CLI贡献指南](https://github.com/im47cn/coderocket-mcp/blob/main/CONTRIBUTING.md)。
 
 ### 快速开始
 
@@ -379,21 +404,24 @@ npm test
 
 ## 🔗 相关链接
 
-- [CodeRocket-CLI](../coderocket-cli) - 核心CLI工具
+- [CodeRocket-CLI](https://github.com/im47cn/coderocket-cli) - 命令行版本的代码审查工具
 - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP官方文档
-- [问题反馈](https://github.com/im47cn/coderocket-cli/issues) - 报告问题或建议
+- [问题反馈](https://github.com/im47cn/coderocket-mcp/issues) - 报告问题或建议
+- [NPM包](https://www.npmjs.com/package/@yeepay/coderocket-mcp) - NPM官方页面
 
 ## 📊 特性对比
 
 | 功能 | CodeRocket-CLI | CodeRocket-MCP |
 |------|----------------|----------------|
-| Git Hooks集成 | ✅ | ❌ |
+| 独立运行 | ❌ (需要配置) | ✅ (开箱即用) |
 | MCP协议支持 | ❌ | ✅ |
 | 代码片段审查 | ❌ | ✅ |
 | AI工具集成 | ❌ | ✅ |
 | 多AI服务支持 | ✅ | ✅ |
+| Git Hooks集成 | ✅ | ❌ |
 | 自动MR创建 | ✅ | ❌ |
 | 详细审查报告 | ✅ | ✅ |
+| 环境变量配置 | ✅ | ✅ |
 
 ---
 

package/bin/coderocket-mcp

@@ -1,108 +1,112 @@
 #!/usr/bin/env node
 
 /**
- * CodeRocket MCP 启动脚本
+ * CodeRocket MCP 独立启动脚本
+ *
+ * 符合 MCP 标准，直接启动服务器，无需额外参数
  */
 
-import { spawn } from 'child_process';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { readFileSync } from 'fs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 const command = process.argv[2];
 
-switch (command) {
-  case 'start':
-  case undefined:
-    // 启动MCP服务器
-    console.error('🚀 启动 CodeRocket MCP 服务器...');
-    const serverPath = resolve(__dirname, '../dist/index.js');
-    const server = spawn('node', [serverPath], {
-      stdio: 'inherit',
-      env: process.env,
-    });
-    
-    server.on('error', (error) => {
-      console.error('❌ 服务器启动失败:', error.message);
+// 如果没有命令或命令是 start，直接启动 MCP 服务器
+if (!command || command === 'start') {
+  // 直接导入并启动 MCP 服务器（不使用 spawn）
+  const serverPath = resolve(__dirname, '../dist/index.js');
+
+  try {
+    // 动态导入服务器模块并启动
+    import(serverPath).catch((error) => {
+      console.error('❌ CodeRocket MCP 服务器启动失败:', error.message);
       process.exit(1);
     });
-    
-    server.on('exit', (code) => {
-      if (code !== 0) {
-        console.error(`❌ 服务器异常退出，代码: ${code}`);
-        process.exit(code || 1);
+  } catch (error) {
+    console.error('❌ 无法加载 CodeRocket MCP 服务器:', error.message);
+    process.exit(1);
+  }
+} else {
+  // 处理其他命令
+  switch (command) {
+
+    case 'test':
+      // 运行测试
+      console.error('🧪 运行 CodeRocket MCP 测试...');
+      const testPath = resolve(__dirname, '../dist/test.js');
+
+      try {
+        import(testPath).catch((error) => {
+          console.error('❌ 测试运行失败:', error.message);
+          process.exit(1);
+        });
+      } catch (error) {
+        console.error('❌ 无法加载测试模块:', error.message);
+        process.exit(1);
       }
-    });
-    break;
-
-  case 'test':
-    // 运行测试
-    console.error('🧪 运行 CodeRocket MCP 测试...');
-    const testPath = resolve(__dirname, '../dist/test.js');
-    const test = spawn('node', [testPath], {
-      stdio: 'inherit',
-      env: process.env,
-    });
-    
-    test.on('error', (error) => {
-      console.error('❌ 测试运行失败:', error.message);
-      process.exit(1);
-    });
-    
-    test.on('exit', (code) => {
-      process.exit(code || 0);
-    });
-    break;
+      break;
 
-  case 'help':
-  case '--help':
-  case '-h':
-    console.log(`
-CodeRocket MCP - AI驱动的代码审查服务器
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(`
+CodeRocket MCP - 独立的AI驱动代码审查服务器
 
 用法:
-  coderocket-mcp [命令]
+  npx @yeepay/coderocket-mcp [命令]
 
 命令:
-  start, (默认)    启动MCP服务器
-  test             运行功能测试
-  help             显示帮助信息
+  (默认)               启动MCP服务器
+  test                 运行功能测试
+  help                 显示帮助信息
+  version              显示版本信息
 
 示例:
-  coderocket-mcp start     # 启动服务器
-  coderocket-mcp test      # 运行测试
-  coderocket-mcp help      # 显示帮助
+  npx @yeepay/coderocket-mcp        # 启动服务器
+  npx @yeepay/coderocket-mcp test   # 运行测试
+  npx @yeepay/coderocket-mcp help   # 显示帮助
 
-环境变量:
-  AI_SERVICE              默认AI服务 (gemini/opencode/claudecode)
+环境变量配置:
+  AI_SERVICE              默认AI服务 (gemini/claudecode)
   AI_AUTO_SWITCH          启用自动切换 (true/false)
-  AI_TIMEOUT              超时时间（秒）
-  AI_MAX_RETRIES          最大重试次数
+  AI_TIMEOUT              超时时间（秒，默认30）
+  AI_MAX_RETRIES          最大重试次数（默认3）
+  GEMINI_API_KEY          Gemini API密钥
+  CLAUDECODE_API_KEY      ClaudeCode API密钥
   NODE_ENV                环境模式 (development/production)
+  DEBUG                   调试模式 (true/false)
 
-更多信息请访问: https://github.com/im47cn/coderocket-cli
+配置文件:
+  项目级: .env
+  全局级: ~/.coderocket/env
+
+更多信息请访问: https://github.com/im47cn/coderocket-mcp
 `);
-    break;
-
-  case 'version':
-  case '--version':
-  case '-v':
-    // 读取package.json获取版本信息
-    try {
-      const packagePath = resolve(__dirname, '../package.json');
-      const packageJson = JSON.parse(
-        require('fs').readFileSync(packagePath, 'utf-8')
-      );
-      console.log(`CodeRocket MCP v${packageJson.version}`);
-    } catch (error) {
-      console.log('CodeRocket MCP v1.0.0');
-    }
-    break;
-
-  default:
-    console.error(`❌ 未知命令: ${command}`);
-    console.error('使用 "coderocket-mcp help" 查看可用命令');
-    process.exit(1);
+      break;
+
+    case 'version':
+    case '--version':
+    case '-v':
+      // 读取package.json获取版本信息
+      try {
+        const packagePath = resolve(__dirname, '../package.json');
+        const packageJson = JSON.parse(
+          readFileSync(packagePath, 'utf-8')
+        );
+        console.log(`CodeRocket MCP v${packageJson.version}`);
+        console.log(`独立版本 - 无需 coderocket-cli 依赖`);
+      } catch (error) {
+        console.log('CodeRocket MCP v1.0.1 (独立版本)');
+      }
+      break;
+
+    default:
+      console.error(`❌ 未知命令: ${command}`);
+      console.error('使用 "npx @yeepay/coderocket-mcp help" 查看可用命令');
+      process.exit(1);
+  }
 }