cciwon-code-review-cli 1.0.0

package/README.md

@@ -0,0 +1,233 @@
+# cciwon-code-review-cli
+
+AI 기반 코드 리뷰 CLI 도구 (Qwen3-Coder-30B DPO 파인튜닝 모델 사용)
+
+## 특징
+
+- 🔒 **폐쇄망 지원**: IP 화이트리스트 기반 (192.168.10.152)
+- 📁 **폴더 전체 리뷰**: 프로젝트 전체를 한 번에 분석
+- 📄 **파일 단위 리뷰**: 개별 파일 심층 분석
+- 🛡️ **보안 중심**: SQL Injection, XSS 등 보안 취약점 탐지
+- ⚡ **빠른 응답**: vLLM 기반 고성능 추론
+
+## 설치
+
+### 1. 서버 설정
+
+먼저 vLLM 서버를 시작해야 합니다:
+
+```bash
+# 필수 패키지 설치
+pip install vllm fastapi uvicorn
+
+# 서버 실행
+cd /home/cwk317/codereivew
+python vllm_server.py
+```
+
+서버가 `192.168.10.152:8000`에서 실행됩니다.
+
+### 2. CLI 설치
+
+```bash
+cd code-review-cli
+npm install
+npm link  # 전역 설치
+```
+
+또는 로컬에서 직접 사용:
+
+```bash
+node bin/code-review.js <command>
+```
+
+## 사용법
+
+### 서버 상태 확인
+
+```bash
+code-review health
+```
+
+출력 예시:
+```
+✅ 서버 정상 작동 중
+
+서버 정보:
+  - 상태: healthy
+  - 모델 로드: 완료
+  - 서버 URL: http://192.168.10.152:8000
+```
+
+### 폴더 전체 리뷰
+
+```bash
+code-review folder /path/to/project
+```
+
+옵션:
+- `-i, --include <patterns>`: 포함할 파일 패턴 (기본: `*.py,*.js,*.ts,*.java,*.cpp,*.go`)
+- `-e, --exclude <patterns>`: 제외할 패턴 (기본: `node_modules,__pycache__,.git,*.pyc`)
+- `-m, --max-files <number>`: 최대 파일 수 (기본: 50)
+
+예시:
+```bash
+# Python 프로젝트 리뷰
+code-review folder ./my-python-project -i "*.py" -e "__pycache__,*.pyc,venv"
+
+# JavaScript 프로젝트 리뷰
+code-review folder ./my-js-project -i "*.js,*.jsx" -e "node_modules,dist,build"
+
+# 모든 코드 파일 리뷰 (최대 100개)
+code-review folder ./my-project -m 100
+```
+
+### 단일 파일 리뷰
+
+```bash
+code-review file /path/to/file.py
+```
+
+옵션:
+- `-l, --language <lang>`: 프로그래밍 언어 (기본: python)
+- `-c, --checklist <path>`: 체크리스트 파일 경로
+
+예시:
+```bash
+# Python 파일 리뷰
+code-review file ./app.py -l python
+
+# TypeScript 파일 + 체크리스트
+code-review file ./api.ts -l typescript -c ./checklist.txt
+
+# Java 파일 리뷰
+code-review file ./Main.java -l java
+```
+
+## VSCode 통합
+
+### 방법 1: Tasks 사용
+
+`.vscode/tasks.json` 파일 생성:
+
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Code Review: Current Folder",
+      "type": "shell",
+      "command": "code-review folder ${workspaceFolder}",
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    },
+    {
+      "label": "Code Review: Current File",
+      "type": "shell",
+      "command": "code-review file ${file}",
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    }
+  ]
+}
+```
+
+사용법:
+1. `Ctrl+Shift+P` → `Tasks: Run Task`
+2. `Code Review: Current Folder` 또는 `Code Review: Current File` 선택
+
+### 방법 2: 터미널에서 직접 사용
+
+VSCode 내장 터미널에서:
+
+```bash
+# 현재 워크스페이스 리뷰
+code-review folder .
+
+# 특정 파일 리뷰
+code-review file src/main.py
+```
+
+## 환경 변수
+
+서버 URL을 변경하려면 환경 변수 설정:
+
+```bash
+export CODE_REVIEW_SERVER=http://192.168.10.152:8000
+code-review health
+```
+
+## IP 화이트리스트
+
+현재 허용된 IP:
+- `192.168.10.152` (서버 IP)
+- `127.0.0.1` (로컬 테스트용)
+
+다른 IP에서 접근 시:
+```
+❌ 허용된 아이피가 아닙니다
+현재 IP: 192.168.10.xxx
+허용된 IP: 192.168.10.152, 127.0.0.1
+```
+
+IP 추가하려면 `vllm_server.py`의 `ALLOWED_IPS` 수정:
+
+```python
+ALLOWED_IPS = ["192.168.10.152", "127.0.0.1", "192.168.10.100"]  # 새 IP 추가
+```
+
+## 트러블슈팅
+
+### 서버 연결 실패
+
+```
+❌ 서버 연결 실패
+서버 연결 실패: http://192.168.10.152:8000
+서버가 실행 중인지 확인하세요.
+```
+
+해결:
+1. vLLM 서버가 실행 중인지 확인: `ps aux | grep vllm_server`
+2. 서버 로그 확인: `tail -f /path/to/server.log`
+3. 방화벽 확인: `sudo ufw status`
+
+### IP 차단
+
+```
+❌ 허용된 아이피가 아닙니다
+```
+
+해결:
+1. 현재 IP 확인: `curl ifconfig.me`
+2. `vllm_server.py`의 `ALLOWED_IPS`에 추가
+3. 서버 재시작
+
+### 메모리 부족
+
+vLLM 서버가 OOM으로 죽는 경우:
+
+`vllm_server.py` 수정:
+```python
+llm = LLM(
+    model=OUTPUT_DIR,
+    tensor_parallel_size=2,
+    gpu_memory_utilization=0.7,  # 0.9 → 0.7로 감소
+    max_model_len=1024,  # 2048 → 1024로 감소
+)
+```
+
+## 성능
+
+- 평균 응답 시간: ~5초 (폴더 리뷰, 10개 파일 기준)
+- 동시 처리: vLLM 배치 처리로 여러 요청 동시 처리 가능
+- GPU 사용량: 2x RTX 5090 (50-60GB)
+
+## 라이선스
+
+MIT

package/bin/code-review.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+// bin/code-review.js
+const { Command } = require('commander');
+const chalk = require('chalk');
+const ora = require('ora');
+const fs = require('fs');
+const path = require('path');
+const CodeReviewClient = require('../lib/api-client');
+
+const program = new Command();
+
+// CLI 설정
+program
+  .name('code-review')
+  .description('AI-powered code review CLI using Qwen3-Coder model')
+  .version('1.0.0');
+
+// 서버 URL 설정 (환경변수 또는 기본값)
+const SERVER_URL = process.env.CODE_REVIEW_SERVER || 'http://192.168.10.152:8000';
+const client = new CodeReviewClient(SERVER_URL);
+
+// ==========================================
+// 폴더 리뷰 명령어
+// ==========================================
+program
+  .command('folder <path>')
+  .description('폴더 전체를 리뷰합니다')
+  .option('-i, --include <patterns>', '포함할 파일 패턴 (쉼표로 구분)', '*.py,*.js,*.ts,*.java,*.cpp,*.go')
+  .option('-e, --exclude <patterns>', '제외할 패턴 (쉼표로 구분)', 'node_modules,__pycache__,.git,*.pyc')
+  .option('-m, --max-files <number>', '최대 파일 수', '50')
+  .action(async (folderPath, options) => {
+    const spinner = ora('폴더 리뷰 진행 중...').start();
+
+    try {
+      // 절대 경로로 변환
+      const absolutePath = path.resolve(folderPath);
+
+      // 폴더 존재 확인
+      if (!fs.existsSync(absolutePath)) {
+        spinner.fail(chalk.red(`❌ 폴더가 존재하지 않습니다: ${absolutePath}`));
+        process.exit(1);
+      }
+
+      // API 호출
+      const result = await client.reviewFolder(absolutePath, {
+        includePatterns: options.include.split(','),
+        excludePatterns: options.exclude.split(','),
+        maxFiles: parseInt(options.maxFiles)
+      });
+
+      spinner.succeed(chalk.green(`✅ 리뷰 완료! (분석된 파일: ${result.files_analyzed}개)`));
+
+      // 결과 출력
+      console.log('\n' + chalk.bold.cyan('=== 코드 리뷰 결과 ==='));
+      console.log(result.review);
+
+      if (result.warnings.length > 0) {
+        console.log('\n' + chalk.yellow('⚠️  경고:'));
+        result.warnings.forEach(warning => {
+          console.log(chalk.yellow(`  - ${warning}`));
+        });
+      }
+
+    } catch (error) {
+      spinner.fail(chalk.red('❌ 리뷰 실패'));
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
+// ==========================================
+// 파일 리뷰 명령어
+// ==========================================
+program
+  .command('file <path>')
+  .description('단일 파일을 리뷰합니다')
+  .option('-l, --language <lang>', '프로그래밍 언어', 'python')
+  .option('-c, --checklist <path>', '체크리스트 파일 경로')
+  .action(async (filePath, options) => {
+    const spinner = ora('파일 리뷰 진행 중...').start();
+
+    try {
+      // 절대 경로로 변환
+      const absolutePath = path.resolve(filePath);
+
+      // 파일 존재 확인
+      if (!fs.existsSync(absolutePath)) {
+        spinner.fail(chalk.red(`❌ 파일이 존재하지 않습니다: ${absolutePath}`));
+        process.exit(1);
+      }
+
+      // 파일 읽기
+      const code = fs.readFileSync(absolutePath, 'utf-8');
+
+      // 체크리스트 읽기 (옵션)
+      let checklist = null;
+      if (options.checklist) {
+        const checklistPath = path.resolve(options.checklist);
+        if (fs.existsSync(checklistPath)) {
+          checklist = fs.readFileSync(checklistPath, 'utf-8');
+        } else {
+          spinner.warn(chalk.yellow(`⚠️  체크리스트 파일을 찾을 수 없습니다: ${checklistPath}`));
+        }
+      }
+
+      // API 호출
+      const result = await client.reviewCode(code, options.language, checklist);
+
+      spinner.succeed(chalk.green('✅ 리뷰 완료!'));
+
+      // 결과 출력
+      console.log('\n' + chalk.bold.cyan('=== 코드 리뷰 결과 ==='));
+      console.log(result.review);
+
+    } catch (error) {
+      spinner.fail(chalk.red('❌ 리뷰 실패'));
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
+// ==========================================
+// 헬스 체크 명령어
+// ==========================================
+program
+  .command('health')
+  .description('서버 상태를 확인합니다')
+  .action(async () => {
+    const spinner = ora('서버 연결 확인 중...').start();
+
+    try {
+      const health = await client.healthCheck();
+      spinner.succeed(chalk.green('✅ 서버 정상 작동 중'));
+
+      console.log(chalk.cyan('\n서버 정보:'));
+      console.log(`  - 상태: ${chalk.green(health.status)}`);
+      console.log(`  - 모델 로드: ${health.model_loaded ? chalk.green('완료') : chalk.red('실패')}`);
+      console.log(`  - 서버 URL: ${chalk.blue(SERVER_URL)}`);
+
+    } catch (error) {
+      spinner.fail(chalk.red('❌ 서버 연결 실패'));
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
+// ==========================================
+// CLI 실행
+// ==========================================
+program.parse(process.argv);
+
+// 명령어가 없으면 help 출력
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/lib/api-client.js

@@ -0,0 +1,91 @@
+// lib/api-client.js
+const axios = require('axios');
+
+class CodeReviewClient {
+  constructor(serverUrl = 'http://192.168.10.152:8000') {
+    this.serverUrl = serverUrl;
+    this.client = axios.create({
+      baseURL: serverUrl,
+      timeout: 120000, // 2분 타임아웃 (추론 시간 고려)
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    });
+  }
+
+  /**
+   * 서버 헬스 체크
+   */
+  async healthCheck() {
+    try {
+      const response = await this.client.get('/health');
+      return response.data;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+
+  /**
+   * 폴더 전체 리뷰
+   * @param {string} folderPath - 리뷰할 폴더 경로
+   * @param {object} options - 옵션 (include_patterns, exclude_patterns, max_files)
+   */
+  async reviewFolder(folderPath, options = {}) {
+    try {
+      const response = await this.client.post('/review/folder', {
+        folder_path: folderPath,
+        include_patterns: options.includePatterns || ['*.py', '*.js', '*.ts', '*.java', '*.cpp', '*.go'],
+        exclude_patterns: options.excludePatterns || ['node_modules', '__pycache__', '.git', '*.pyc'],
+        max_files: options.maxFiles || 50
+      });
+      return response.data;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+
+  /**
+   * 단일 코드 스니펫 리뷰
+   * @param {string} code - 리뷰할 코드
+   * @param {string} language - 프로그래밍 언어
+   * @param {string} checklist - 체크리스트 (선택)
+   */
+  async reviewCode(code, language = 'python', checklist = null) {
+    try {
+      const response = await this.client.post('/review/code', {
+        code,
+        language,
+        checklist
+      });
+      return response.data;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+
+  /**
+   * 에러 핸들링
+   */
+  handleError(error) {
+    if (error.response) {
+      // 서버 응답이 있는 경우
+      const data = error.response.data;
+
+      // IP 차단 메시지
+      if (data.error === '허용된 아이피가 아닙니다') {
+        throw new Error(`❌ ${data.error}\n현재 IP: ${data.client_ip}\n허용된 IP: ${data.allowed_ips.join(', ')}`);
+      }
+
+      // 기타 서버 에러
+      throw new Error(`서버 에러 (${error.response.status}): ${data.detail || JSON.stringify(data)}`);
+    } else if (error.request) {
+      // 요청은 보냈지만 응답이 없는 경우
+      throw new Error(`서버 연결 실패: ${this.serverUrl}\n서버가 실행 중인지 확인하세요.`);
+    } else {
+      // 요청 설정 중 에러
+      throw new Error(`요청 실패: ${error.message}`);
+    }
+  }
+}
+
+module.exports = CodeReviewClient;

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "cciwon-code-review-cli",
+  "version": "1.0.0",
+  "description": "AI-powered code review CLI tool using Qwen3-Coder-30B model with IP whitelist support",
+  "main": "lib/api-client.js",
+  "bin": {
+    "code-review": "bin/code-review.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "code-review",
+    "ai",
+    "qwen",
+    "qwen3-coder",
+    "code-analysis",
+    "security",
+    "llm",
+    "code-quality",
+    "static-analysis"
+  ],
+  "author": "cciwon",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "commander": "^11.1.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}