vg-coder-cli 2.0.3 → 2.0.5

package/README.md

@@ -1,135 +1,361 @@
-# VG Coder CLI - Migration Complete! 🎉
+# VG Coder CLI
 
-## Overview
+🚀 **Powerful CLI tool & API Server** để phân tích dự án, nối file mã nguồn, đếm token, xuất HTML và thực thi bash scripts qua REST API.
 
-This project has been successfully migrated from Express/HTML to a modern **NestJS + Angular** architecture using Nx monorepo.
+## ✨ Tính năng
 
-## Quick Start
+### 📊 Code Analysis & Export
+- 🔍 **Phát hiện loại dự án**: Tự động nhận diện Angular, Spring Boot, React, Vue, Node.js, Python, Java, .NET
+- 📁 **Xử lý `.gitignore`**: Tuân thủ chuẩn Git với multi-level ignore rules
+- 🛡️ **Hỗ trợ `.vgignore`**: Có độ ưu tiên cao hơn `.gitignore`, với cú pháp giống hệt
+- 📜 **Bỏ qua file mặc định**: Tự động bỏ qua `node_modules`, `dist`, `.git`, `build`, `target`
+- 📄 **Scan và nối file**: Quét toàn bộ dự án và nối các file mã nguồn
+- 🧮 **Đếm token**: Sử dụng `tiktoken` để đếm token chính xác cho AI models
+- ✂️ **Chia nhỏ nội dung**: Chia nội dung thông minh thành chunks nhỏ hơn
+- 🌐 **Xuất HTML**: Tạo báo cáo HTML tương tác với syntax highlighting
+- 📋 **Sao chép vào Clipboard**: Chế độ `-c` sao chép toàn bộ code vào clipboard
+- 🤖 **Tối ưu cho AI**: Xuất file `combined.txt` với định dạng thân thiện cho AI
 
-### Development Mode
+### 🚀 API Server (NEW!)
+- 🌐 **REST API Server**: Khởi động server với `vg start`
+- 🎨 **Beautiful Dashboard**: Tự động mở web UI để test API
+- 📡 **5 API Endpoints**:
+  - `GET /health` - Health check
+  - `POST /api/analyze` - Phân tích dự án, download project.txt
+  - `GET /api/info` - Lấy thông tin dự án (JSON)
+  - `POST /api/execute` - **Thực thi bash scripts** với validation
+  - `DELETE /api/clean` - Xóa output directory
+- ⚡ **Real-time Status**: Dashboard hiển thị server status live
+- 🔒 **Syntax Validation**: Validate bash syntax trước khi execute
+- 🧹 **Auto Cleanup**: Tự động dọn dẹp temp files
+
+## 📦 Cài đặt
+
+### Từ NPM (Recommended)
 ```bash
-cd vg
-./start-dev.sh
+# Global install
+npm install -g vg-coder-cli
+
+# Local install
+npm install vg-coder-cli
 ```
 
-Or manually:
+### Từ Source
 ```bash
-nx run-many --target=serve --projects=api,ng-app
+git clone https://github.com/tinhthanh/vg-coder-cli.git
+cd vg-coder-cli
+npm install
 ```
 
-This starts:
-- **API Backend**: http://localhost:3000
-- **Dashboard**: http://localhost:4200
+## 🚀 Sử dụng
 
-### Production Build
+### CLI Commands
+
+#### 1. Phân tích dự án
 ```bash
-cd vg
-nx run-many --target=build --all --configuration=production
+# Phân tích và xuất HTML
+vg analyze
+vg a                    # Alias rút gọn
+
+# Với options
+vg analyze /path/to/project --max-tokens 8192 --output ./my-output
+
+# Copy vào clipboard (không tạo file)
+vg analyze -c
+vg analyze --clipboard
 ```
 
-## Project Structure
+#### 2. Xem thông tin dự án
+```bash
+vg info
+vg info /path/to/project
+```
 
+#### 3. Xóa output
+```bash
+vg clean
+vg clean --output ./my-output
 ```
-vg-coder-cli/
-├── src/                    # Original Express/HTML app (legacy)
-│   ├── server/
-│   ├── scanner/
-│   └── ...
-└── vg/                     # New Nx monorepo
-    ├── apps/
-    │   ├── api/           # NestJS backend
-    │   └── ng-app/        # Angular frontend
-    └── packages/
-        └── core/          # Shared TypeScript library
+
+#### 4. **Khởi động API Server** 🆕
+```bash
+# Start server (mặc định port 6868)
+vg start
+vg s                    # Alias rút gọn
+
+# Custom port
+vg start -p 8080
+
+# Browser tự động mở dashboard tại http://localhost:6868
+```
+
+### API Endpoints
+
+#### Health Check
+```bash
+GET http://localhost:6868/health
+```
+
+**Response:**
+```json
+{
+  "status": "ok",
+  "version": "1.0.10",
+  "timestamp": "2025-11-24T15:00:00.000Z"
+}
+```
+
+#### Analyze Project
+```bash
+POST http://localhost:6868/api/analyze
+Content-Type: application/json
+
+{
+  "path": ".",
+  "options": {
+    "maxTokens": 8000
+  }
+}
+```
+
+**Response:** Downloads `project.txt` file
+
+#### Get Project Info
+```bash
+GET http://localhost:6868/api/info?path=.
+```
+
+**Response:**
+```json
+{
+  "path": "/path/to/project",
+  "primaryType": "nodejs",
+  "stats": {
+    "totalFiles": 42,
+    "totalSize": 123456,
+    "totalLines": 5000
+  },
+  "tokens": {
+    "total": 15000,
+    "averagePerFile": 357
+  }
+}
+```
+
+#### Execute Bash Script 🆕
+```bash
+POST http://localhost:6868/api/execute
+Content-Type: application/json
+
+{
+  "bash": "mkdir -p $(dirname \"src/test.js\")\ncat <<'EOF' > src/test.js\nconsole.log('Hello');\nEOF"
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "stdout": "",
+  "stderr": "",
+  "exitCode": 0,
+  "executionTime": 15
+}
+```
+
+**Features:**
+- ✅ Syntax validation trong `.vg/temp-execute`
+- ✅ Execute tại working directory
+- ✅ Auto cleanup temp files
+- ✅ Return stdout/stderr/exitCode
+
+#### Clean Output
+```bash
+DELETE http://localhost:6868/api/clean
+Content-Type: application/json
+
+{
+  "output": "./vg-output"
+}
 ```
 
-## What's New
+## ⚙️ Options
+
+### CLI Options
+
+| Option | Mô tả | Default |
+|--------|-------|---------|
+| `-o, --output <path>` | Thư mục output | ./vg-output |
+| `-m, --max-tokens <number>` | Số token tối đa mỗi chunk | 8000 |
+| `-t, --model <model>` | Model AI để đếm token | gpt-4 |
+| `--extensions <list>` | Extensions (comma-separated) | Auto-detect |
+| `--include-hidden` | Bao gồm file ẩn | false |
+| `--no-structure` | Không giữ cấu trúc file | false |
+| `--theme <theme>` | Theme cho syntax highlighting | github |
+| `-c, --clipboard` | Copy vào clipboard | false |
+| `--save-txt` | Lưu vào vg-projects.txt | false |
+
+### Server Options
+
+| Option | Mô tả | Default |
+|--------|-------|---------|
+| `-p, --port <port>` | Port cho server | 6868 |
+
+## 🎨 Dashboard UI
+
+Khi chạy `vg start`, browser tự động mở dashboard với:
 
-### ✅ Migrated Components
+- 🎯 **Interactive Forms** cho tất cả endpoints
+- 🎨 **Beautiful Gradient UI** (purple to violet)
+- 📊 **Real-time Server Status** (green/red indicator)
+- 💻 **Syntax Highlighting** cho responses
+- ⚡ **Loading States** cho async operations
+- 📥 **Auto Download** cho analyze endpoint
 
-1. **Core Library** (`@vg/core`)
-   - ProjectDetector
-   - FileScanner
-   - TokenManager
-   - BashExecutor
-   - IgnoreManager
+## 🤖 Tích hợp AI
 
-2. **NestJS Backend** (`apps/api`)
-   - REST API with controllers & services
-   - CORS enabled
-   - Global `/api` prefix
+### System Prompt cho AI
 
-3. **Angular Frontend** (`apps/ng-app`)
-   - Modern standalone components
-   - Reactive forms
-   - HTTP client integration
-   - Proxy configuration
+Xem file [SYSTEM_PROMPT.md](SYSTEM_PROMPT.md) để biết cách tích hợp với AI.
 
-### 📡 API Endpoints
+**Command Prefixes:**
+- `/ask` - Q&A mode (Markdown response)
+- `/plan` - Planning mode (Checklist + bash)
+- `/fix` - Bug fix mode (Analysis + solution)
+- `/code` - Code generation (Bash script only)
 
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/analyze` | POST | Analyze project and return source code |
-| `/api/execute` | POST | Execute bash scripts with validation |
-| `/api/info` | GET | Get project information and statistics |
-| `/api/clean` | DELETE | Clean output directories |
+### Bash Script Format
 
-## Development
+Khi AI generate code với `/code`, format chuẩn:
 
-### Build Individual Projects
 ```bash
-nx build core
-nx build api
-nx build ng-app
+mkdir -p $(dirname "path/to/file.ext")
+cat <<'EOF' > path/to/file.ext
+... file content ...
+EOF
 ```
 
-### Run Tests
+**Quy tắc:**
+- ✅ Luôn có `mkdir -p $(dirname "...")` trước mỗi file
+- ✅ Sử dụng `<<'EOF'` (có quotes) để tránh expansion
+- ✅ Chỉ include files có thay đổi
+- ✅ Ghi đè hoàn toàn file content
+
+## 📁 Cấu trúc Output
+
+```
+vg-output/
+├── index.html          # Trang chính với navigation
+├── combined.html       # Tất cả code, có search
+├── combined.txt        # Text format, tối ưu cho AI
+├── chunks/             # Chunks riêng biệt
+│   ├── chunk-1.html
+│   └── ...
+└── assets/             # CSS, JS
+```
+
+## 🎯 Dự án được hỗ trợ
+
+- **Frontend**: Angular, React, Vue.js, Svelte
+- **Backend**: Node.js, Spring Boot, Python, .NET
+- **Mobile**: React Native, Flutter
+- **Languages**: JavaScript, TypeScript, Java, Python, C#, Go, Rust
+- **Config**: JSON, YAML, XML, TOML
+
+## 🛡️ Quy tắc bỏ qua file
+
+Thứ tự ưu tiên:
+1. **`.vgignore`** - Cao nhất
+2. **`.gitignore`** - Trung bình
+3. **Default rules** - Thấp nhất (node_modules, .git, dist, build, target)
+
+## 📝 Examples
+
+### Example 1: Analyze và Copy
+```bash
+# Analyze project và copy vào clipboard
+vg a . -c
+
+# Paste vào AI tool (Claude, ChatGPT, etc.)
+```
+
+### Example 2: API Server Workflow
+```bash
+# 1. Start server
+vg start
+
+# 2. Browser mở dashboard tự động
+# 3. Test endpoints trực tiếp trên UI
+# 4. Hoặc dùng Postman/curl
+
+# 5. Execute bash script từ AI
+curl -X POST http://localhost:6868/api/execute \
+  -H "Content-Type: application/json" \
+  -d '{"bash": "mkdir -p src && echo \"test\" > src/file.js"}'
+```
+
+### Example 3: AI Integration
 ```bash
-nx test core
-nx test api
-nx test ng-app
+# 1. Analyze project
+vg a . -c
+
+# 2. Paste vào AI với prompt:
+# "/code Thêm authentication vào project này"
+
+# 3. AI trả về bash script
+# 4. Copy bash script
+
+# 5. Execute qua API
+curl -X POST http://localhost:6868/api/execute \
+  -H "Content-Type: application/json" \
+  -d '{"bash": "..."}'
 ```
 
-### Lint
+## 🔧 Development
+
 ```bash
-nx lint api
-nx lint ng-app
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run in dev mode
+npm run dev
+
+# Build and publish
+npm run push
 ```
 
-## Documentation
+## 🤝 Đóng góp
 
-- **Implementation Plan**: See `.gemini/antigravity/brain/.../implementation_plan.md`
-- **Walkthrough**: See `.gemini/antigravity/brain/.../walkthrough.md`
-- **Workspace README**: See `vg/README.md`
+1. Fork repository
+2. Create feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit changes (`git commit -m 'Add amazing feature'`)
+4. Push to branch (`git push origin feature/amazing-feature`)
+5. Create Pull Request
 
-## Legacy vs New
+## 📄 License
 
-| Feature | Legacy (src/) | New (vg/) |
-|---------|--------------|-----------|
-| Backend | Express.js | NestJS |
-| Frontend | HTML/jQuery | Angular |
-| Language | JavaScript | TypeScript |
-| Architecture | Monolithic | Nx Monorepo |
-| Type Safety | ❌ | ✅ |
-| Dependency Injection | ❌ | ✅ |
-| Reactive Patterns | ❌ | ✅ |
+MIT License - xem file [LICENSE](LICENSE) để biết thêm chi tiết.
 
-## Next Steps
+## 🔗 Links
 
-1. ✅ Core library migration
-2. ✅ Backend implementation
-3. ✅ Frontend implementation
-4. ✅ CORS & Proxy configuration
-5. ✅ Testing & verification
-6. 🔄 E2E tests (optional)
-7. 🔄 Production deployment (when ready)
+- **GitHub**: https://github.com/tinhthanh/vg-coder-cli
+- **NPM**: https://www.npmjs.com/package/vg-coder-cli
+- **Issues**: https://github.com/tinhthanh/vg-coder-cli/issues
 
-## Contributing
+## 📊 Version History
 
-The new architecture makes it easier to:
-- Add new features
-- Write tests
-- Scale the application
-- Maintain code quality
+### v1.0.10 (Latest)
+- ✨ Added API Server with REST endpoints
+- 🎨 Beautiful dashboard UI with auto-open browser
+- ⚡ Bash script execution with validation
+- 🔧 Shortened commands: `vg`, `a`, `-c`, `s`
+- 📝 System prompt documentation
 
-For more details, see the documentation in the `vg/` directory.
+### v1.0.9
+- 🚀 Initial release
+- 📊 Code analysis and token counting
+- 🌐 HTML export with syntax highlighting
+- 📋 Clipboard integration

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vg-coder-cli",
-  "version": "2.0.3",
-  "description": "🚀 CLI tool to analyze projects, concatenate source files, count tokens, and export HTML with syntax highlighting. Now with modern NestJS API and Angular dashboard!",
+  "version": "2.0.5",
+  "description": "🚀 CLI tool to analyze projects, concatenate source files, count tokens, and export HTML with syntax highlighting and copy functionality",
   "main": "src/index.js",
   "bin": {
     "vg": "./bin/vg.js",
@@ -12,9 +12,7 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "dev": "nodemon src/index.js",
-    "push": "npm pack && npm publish",
-    "build:vg": "cd vg && nx run-many --target=build --all --configuration=production",
-    "start:vg": "cd vg && ./start-dev.sh"
+    "push": "npm pack && npm publish"
   },
   "keywords": [
     "cli",
@@ -33,12 +31,7 @@
     "vue",
     "java",
     "javascript",
-    "typescript",
-    "nestjs",
-    "nx-monorepo",
-    "modern-stack",
-    "api-server",
-    "dashboard"
+    "typescript"
   ],
   "author": "VG Coder",
   "license": "MIT",

package/src/index.js

@@ -66,7 +66,6 @@ class VGCoderCLI {
       .alias('s')
       .description('Khởi động API server')
       .option('-p, --port <port>', 'Port cho server', '6868')
-      .option('--new', 'Khởi động NestJS/Angular stack (modern)')
       .action(this.handleStart.bind(this));
   }
 
@@ -368,69 +367,11 @@ class VGCoderCLI {
     }
   }
 
-
   /**
    * Handle start command
    */
   async handleStart(options) {
     try {
-      // Check if --new flag is set
-      if (options.new) {
-        console.log(chalk.blue('🚀 VG Coder - Modern NestJS/Angular Stack'));
-        console.log('');
-        console.log(chalk.yellow('Starting the modern workspace...'));
-        console.log('');
-        
-        // Use npx to run the workspace package
-        const { spawn } = require('child_process');
-        
-        console.log(chalk.cyan('Running: npx vg-coder-workspace@latest'));
-        console.log('');
-        console.log(chalk.gray('This will:'));
-        console.log(chalk.gray('  • Install the workspace package (if needed)'));
-        console.log(chalk.gray('  • Start NestJS API on http://localhost:3000'));
-        console.log(chalk.gray('  • Start Angular Dashboard on http://localhost:4200'));
-        console.log('');
-        
-        const child = spawn('npx', ['vg-coder-workspace@latest'], {
-          stdio: 'inherit',
-          shell: true
-        });
-        
-        child.on('error', (error) => {
-          console.error(chalk.red('\n❌ Failed to start workspace:'), error.message);
-          console.log('');
-          console.log(chalk.yellow('💡 Alternative: Clone and run locally'));
-          console.log(chalk.cyan('   git clone https://github.com/tinhthanh/vg-coder-cli.git'));
-          console.log(chalk.cyan('   cd vg-coder-cli/vg && npm install && ./start-dev.sh'));
-          process.exit(1);
-        });
-        
-        child.on('exit', (code) => {
-          if (code !== 0 && code !== null) {
-            console.error(chalk.red(`\nProcess exited with code ${code}`));
-          }
-          process.exit(code || 0);
-        });
-        
-        // Handle graceful shutdown
-        const shutdown = () => {
-          console.log(chalk.yellow('\n\nShutting down...'));
-          child.kill('SIGTERM');
-          setTimeout(() => process.exit(0), 1000);
-        };
-        
-        process.on('SIGINT', shutdown);
-        process.on('SIGTERM', shutdown);
-        
-        return;
-      }
-      
-      // Legacy Express server
-      console.log(chalk.blue('🚀 Starting Express server (legacy)...'));
-      console.log(chalk.yellow('💡 Tip: Use --new flag to start the modern NestJS/Angular stack'));
-      console.log('');
-      
       const port = parseInt(options.port);
       const server = new ApiServer(port);
       
@@ -474,7 +415,6 @@ class VGCoderCLI {
     }
   }
 
-
   /**
    * Run CLI
    */