cciwon-code-review-cli 1.0.0 → 2.0.0

package/.ipynb_checkpoints/README-checkpoint.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

@@ -144,6 +144,24 @@ program
     }
   });
 
+// ==========================================
+// 인터랙티브 Chat 모드
+// ==========================================
+program
+  .command('chat')
+  .description('대화형 코드 리뷰 모드를 시작합니다')
+  .action(async () => {
+    const ChatMode = require('../lib/chat-mode');
+    const chatMode = new ChatMode();
+
+    try {
+      await chatMode.start();
+    } catch (error) {
+      console.error(chalk.red(`\n❌ 에러 발생: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
 // ==========================================
 // CLI 실행
 // ==========================================

package/lib/api-client.js

@@ -2,7 +2,7 @@
 const axios = require('axios');
 
 class CodeReviewClient {
-  constructor(serverUrl = 'http://192.168.10.152:8000') {
+  constructor(serverUrl = 'http://211.56.247.71:8000') {
     this.serverUrl = serverUrl;
     this.client = axios.create({
       baseURL: serverUrl,

package/lib/chat-mode.js

@@ -0,0 +1,234 @@
+// lib/chat-mode.js
+const readline = require('readline');
+const chalk = require('chalk');
+const FileReader = require('./file-reader');
+const CodeReviewClient = require('./api-client');
+
+class ChatMode {
+  constructor() {
+    this.fileReader = new FileReader();
+    this.client = new CodeReviewClient(process.env.CODE_REVIEW_SERVER);
+    this.projectFiles = [];
+    this.filesContent = {};
+    this.rl = null;
+  }
+
+  /**
+   * Chat 모드 시작
+   */
+  async start() {
+    console.log(chalk.bold.green('\n🛡️  안녕하세요, 코드가드입니다!\n'));
+
+    // 프로젝트 파일 분석 여부 물어보기
+    const shouldAnalyze = await this.askQuestion('현재 위치의 폴더 구조를 파악할까요? (y/n): ');
+
+    if (shouldAnalyze.toLowerCase() === 'y' || shouldAnalyze.toLowerCase() === 'yes') {
+      await this.analyzeProject();
+    }
+
+    // REPL 시작
+    await this.startREPL();
+  }
+
+  /**
+   * 프로젝트 파일 분석
+   */
+  async analyzeProject() {
+    console.log(chalk.cyan('\n📂 폴더 구조 분석 중...\n'));
+
+    try {
+      this.projectFiles = await this.fileReader.listFiles();
+
+      if (this.projectFiles.length === 0) {
+        console.log(chalk.yellow('⚠️  분석할 파일이 없습니다.'));
+        return;
+      }
+
+      // 폴더 트리 출력
+      console.log(chalk.bold('프로젝트 구조:'));
+      const tree = this.fileReader.generateTree(this.projectFiles);
+      console.log(tree);
+
+      console.log(chalk.green(`✅ 총 ${this.projectFiles.length}개 파일 발견\n`));
+    } catch (error) {
+      console.error(chalk.red(`❌ 파일 분석 실패: ${error.message}`));
+    }
+  }
+
+  /**
+   * REPL 모드 시작
+   */
+  async startREPL() {
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      prompt: chalk.bold.cyan('> ')
+    });
+
+    console.log(chalk.gray('무엇을 도와드릴까요? (종료하려면 "exit" 입력)\n'));
+    this.rl.prompt();
+
+    this.rl.on('line', async (input) => {
+      const command = input.trim();
+
+      if (!command) {
+        this.rl.prompt();
+        return;
+      }
+
+      if (command === 'exit' || command === 'quit') {
+        console.log(chalk.green('\n👋 안녕히 가세요!'));
+        this.rl.close();
+        process.exit(0);
+      }
+
+      await this.handleCommand(command);
+      this.rl.prompt();
+    });
+
+    this.rl.on('close', () => {
+      process.exit(0);
+    });
+  }
+
+  /**
+   * 사용자 명령어 처리
+   */
+  async handleCommand(command) {
+    const lowerCommand = command.toLowerCase();
+
+    // 파일 리뷰 요청 감지
+    if (lowerCommand.includes('리뷰') || lowerCommand.includes('review') ||
+        lowerCommand.includes('검사') || lowerCommand.includes('check')) {
+      await this.handleReviewRequest(command);
+    }
+    // 파일 목록 요청
+    else if (lowerCommand.includes('목록') || lowerCommand.includes('list') ||
+             lowerCommand.includes('파일')) {
+      this.showFileList();
+    }
+    // 도움말
+    else if (lowerCommand.includes('help') || lowerCommand.includes('도움말')) {
+      this.showHelp();
+    }
+    // 기타 - 일반 질문으로 처리
+    else {
+      console.log(chalk.yellow('\n💡 파일을 리뷰하려면 "파일명 리뷰해줘" 형식으로 입력해주세요.'));
+      console.log(chalk.gray('   예: api.py 리뷰해줘, 모든 Python 파일 검사해줘\n'));
+    }
+  }
+
+  /**
+   * 리뷰 요청 처리
+   */
+  async handleReviewRequest(command) {
+    // 파일 매칭
+    const matchedFiles = this.fileReader.matchFiles(command, this.projectFiles);
+
+    if (matchedFiles.length === 0) {
+      console.log(chalk.yellow('\n⚠️  매칭되는 파일을 찾을 수 없습니다.'));
+      console.log(chalk.gray('   사용 가능한 파일 목록을 보려면 "파일 목록" 입력\n'));
+      return;
+    }
+
+    console.log(chalk.cyan(`\n🔍 ${matchedFiles.length}개 파일 리뷰 중...\n`));
+
+    for (const filePath of matchedFiles) {
+      await this.reviewFile(filePath);
+    }
+  }
+
+  /**
+   * 단일 파일 리뷰
+   */
+  async reviewFile(filePath) {
+    try {
+      // 파일 내용 읽기
+      const content = await this.fileReader.readFile(filePath);
+
+      // 언어 감지
+      const language = this.detectLanguage(filePath);
+
+      console.log(chalk.bold(`\n=== ${filePath} ===\n`));
+
+      // 서버에 리뷰 요청
+      const result = await this.client.reviewCode(content, language);
+
+      // 결과 출력
+      console.log(result.review);
+      console.log('');
+
+    } catch (error) {
+      console.error(chalk.red(`❌ 리뷰 실패 (${filePath}): ${error.message}\n`));
+    }
+  }
+
+  /**
+   * 파일 목록 출력
+   */
+  showFileList() {
+    if (this.projectFiles.length === 0) {
+      console.log(chalk.yellow('\n⚠️  분석된 파일이 없습니다. 먼저 프로젝트를 분석해주세요.\n'));
+      return;
+    }
+
+    console.log(chalk.bold('\n📁 사용 가능한 파일:\n'));
+    this.projectFiles.forEach(file => {
+      console.log(chalk.gray(`  - ${file}`));
+    });
+    console.log('');
+  }
+
+  /**
+   * 도움말 출력
+   */
+  showHelp() {
+    console.log(chalk.bold('\n📖 사용 가능한 명령어:\n'));
+    console.log(chalk.cyan('  파일명 리뷰해줘') + chalk.gray('      - 특정 파일 리뷰'));
+    console.log(chalk.cyan('  모든 Python 파일 검사') + chalk.gray(' - 확장자별 리뷰'));
+    console.log(chalk.cyan('  파일 목록') + chalk.gray('            - 분석 가능한 파일 목록'));
+    console.log(chalk.cyan('  help') + chalk.gray('                 - 이 도움말'));
+    console.log(chalk.cyan('  exit') + chalk.gray('                 - 종료\n'));
+  }
+
+  /**
+   * 파일 확장자로 언어 감지
+   */
+  detectLanguage(filePath) {
+    const ext = filePath.split('.').pop().toLowerCase();
+    const langMap = {
+      'py': 'python',
+      'js': 'javascript',
+      'jsx': 'javascript',
+      'ts': 'typescript',
+      'tsx': 'typescript',
+      'java': 'java',
+      'cpp': 'cpp',
+      'c': 'c',
+      'go': 'go',
+      'rs': 'rust',
+      'rb': 'ruby',
+      'php': 'php'
+    };
+    return langMap[ext] || 'text';
+  }
+
+  /**
+   * 사용자에게 질문하고 답변 받기
+   */
+  askQuestion(question) {
+    return new Promise((resolve) => {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      rl.question(chalk.bold.cyan(question), (answer) => {
+        rl.close();
+        resolve(answer);
+      });
+    });
+  }
+}
+
+module.exports = ChatMode;

package/lib/file-reader.js

@@ -0,0 +1,159 @@
+// lib/file-reader.js
+const fs = require('fs').promises;
+const path = require('path');
+const fg = require('fast-glob');
+
+class FileReader {
+  constructor(basePath = process.cwd()) {
+    this.basePath = basePath;
+  }
+
+  /**
+   * 폴더 구조를 읽고 파일 목록 반환
+   * @param {object} options - { include, exclude, maxFiles }
+   * @returns {Promise<string[]>} 파일 경로 배열
+   */
+  async listFiles(options = {}) {
+    const {
+      include = ['**/*.{js,ts,py,java,cpp,go,jsx,tsx}'],
+      exclude = ['**/node_modules/**', '**/__pycache__/**', '**/.git/**', '**/*.pyc'],
+      maxFiles = 50
+    } = options;
+
+    const files = await fg(include, {
+      cwd: this.basePath,
+      ignore: exclude,
+      absolute: false,
+      onlyFiles: true
+    });
+
+    return files.slice(0, maxFiles);
+  }
+
+  /**
+   * 파일 내용 읽기
+   * @param {string} filePath - 상대 경로
+   * @returns {Promise<string>} 파일 내용
+   */
+  async readFile(filePath) {
+    const fullPath = path.join(this.basePath, filePath);
+    try {
+      return await fs.readFile(fullPath, 'utf-8');
+    } catch (error) {
+      throw new Error(`파일 읽기 실패 (${filePath}): ${error.message}`);
+    }
+  }
+
+  /**
+   * 여러 파일의 내용을 읽어서 객체로 반환
+   * @param {string[]} filePaths - 파일 경로 배열
+   * @returns {Promise<object>} { 파일경로: 내용 }
+   */
+  async readMultipleFiles(filePaths) {
+    const filesContent = {};
+
+    for (const filePath of filePaths) {
+      try {
+        filesContent[filePath] = await this.readFile(filePath);
+      } catch (error) {
+        console.warn(`⚠️  ${error.message}`);
+      }
+    }
+
+    return filesContent;
+  }
+
+  /**
+   * 폴더 구조 트리 생성 (시각화용)
+   * @param {string[]} filePaths - 파일 경로 배열
+   * @returns {string} 트리 형식 문자열
+   */
+  generateTree(filePaths) {
+    const tree = {};
+
+    filePaths.forEach(filePath => {
+      const parts = filePath.split(path.sep);
+      let current = tree;
+
+      parts.forEach((part, index) => {
+        if (index === parts.length - 1) {
+          // 파일
+          if (!current.__files) current.__files = [];
+          current.__files.push(part);
+        } else {
+          // 디렉토리
+          if (!current[part]) current[part] = {};
+          current = current[part];
+        }
+      });
+    });
+
+    return this._renderTree(tree, '', true);
+  }
+
+  _renderTree(node, prefix = '', isLast = true) {
+    let result = '';
+    const entries = Object.keys(node).filter(k => k !== '__files');
+    const files = node.__files || [];
+
+    // 디렉토리 먼저
+    entries.forEach((dir, index) => {
+      const isLastDir = index === entries.length - 1 && files.length === 0;
+      const connector = isLastDir ? '└── ' : '├── ';
+      const newPrefix = prefix + (isLastDir ? '    ' : '│   ');
+
+      result += `${prefix}${connector}${dir}/\n`;
+      result += this._renderTree(node[dir], newPrefix, isLastDir);
+    });
+
+    // 파일들
+    files.forEach((file, index) => {
+      const isLastFile = index === files.length - 1;
+      const connector = isLastFile ? '└── ' : '├── ';
+      result += `${prefix}${connector}${file}\n`;
+    });
+
+    return result;
+  }
+
+  /**
+   * 파일 경로에서 파일 찾기 (자연어 매칭)
+   * @param {string} query - "api.py", "모든 Python 파일"
+   * @param {string[]} availableFiles - 사용 가능한 파일 목록
+   * @returns {string[]} 매칭된 파일 경로들
+   */
+  matchFiles(query, availableFiles) {
+    const lowerQuery = query.toLowerCase();
+
+    // 정확한 파일명 매칭
+    const exactMatch = availableFiles.filter(f =>
+      path.basename(f).toLowerCase() === lowerQuery ||
+      f.toLowerCase().includes(lowerQuery)
+    );
+
+    if (exactMatch.length > 0) return exactMatch;
+
+    // 확장자 매칭 ("모든 Python 파일", "py 파일들")
+    const extMap = {
+      'python': '.py',
+      'javascript': '.js',
+      'typescript': '.ts',
+      'java': '.java',
+      'cpp': '.cpp',
+      'go': '.go'
+    };
+
+    for (const [lang, ext] of Object.entries(extMap)) {
+      if (lowerQuery.includes(lang) || lowerQuery.includes(ext.slice(1))) {
+        return availableFiles.filter(f => f.endsWith(ext));
+      }
+    }
+
+    // 키워드 매칭 ("api", "test", "model")
+    return availableFiles.filter(f =>
+      f.toLowerCase().includes(lowerQuery.replace(/\s+/g, ''))
+    );
+  }
+}
+
+module.exports = FileReader;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cciwon-code-review-cli",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "AI-powered code review CLI tool using Qwen3-Coder-30B model with IP whitelist support",
   "main": "lib/api-client.js",
   "bin": {
@@ -26,7 +26,9 @@
     "axios": "^1.6.0",
     "commander": "^11.1.0",
     "chalk": "^4.1.2",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "fast-glob": "^3.3.2",
+    "readline": "^1.3.0"
   },
   "engines": {
     "node": ">=14.0.0"