vg-coder-cli 1.0.6 → 1.0.8

package/README.md

@@ -4,14 +4,18 @@
 
 ## ✨ Tính năng
 
-- 🔍 **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
-- 📄 **Scan và nối file**: Quét toàn bộ dự án và nối file mã nguồn
-- 🧮 **Đếm token**: Sử dụng tiktoken để đếm token chính xác cho AI models
-- ✂️ **Chia nhỏ nội dung**: Smart chunking với preserve structure
-- 🌐 **Xuất HTML**: Tạo HTML với syntax highlighting và copy buttons
-- 🎨 **Syntax Highlighting**: Hỗ trợ nhiều ngôn ngữ lập trình
-- 📋 **Copy to Clipboard**: Dễ dàng copy code với một click
+- 🔍 **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 các thư mục phổ biến như `node_modules`, `dist`, `.git`, `build`, `target` và các file cấu hình IDE.
+- 📄 **Scan và nối file**: Quét toàn bộ dự án và nối các file mã nguồn lại với nhau.
+- 🧮 **Đếm token**: Sử dụng `tiktoken` để đếm token chính xác cho các mô hình AI.
+- ✂️ **Chia nhỏ nội dung**: Chia nội dung thông minh thành các chunk nhỏ hơn mà vẫn giữ cấu trúc file.
+- 🌐 **Xuất HTML**: Tạo báo cáo HTML tương tác với syntax highlighting và các nút bấm sao chép.
+- 📋 **Sao chép vào Clipboard**: Chế độ `--clipboard-only` giúp sao chép toàn bộ mã nguồn đã xử lý vào clipboard, không cần tạo file.
+- 🤖 **Tối ưu cho AI**: Xuất file `combined.txt` với định dạng thân thiện cho các mô hình AI và cung cấp mẫu script để hướng dẫn AI.
+- 🌳 **Cây thư mục**: Hiển thị và cho phép sao chép cấu trúc cây thư mục của dự án trong giao diện HTML.
+- 🔍 **Tìm kiếm tích hợp**: Giao diện HTML đi kèm chức năng tìm kiếm nội dung trực tiếp trong code.
 
 ## 📦 Cài đặt
 
@@ -39,7 +43,7 @@ chmod +x bin/vg-coder.js
 
 ## 🚀 Sử dụng
 
-### Phân tích dự án
+### Phân tích dự án và xuất HTML
 ```bash
 # Nếu cài global
 vg-coder analyze
@@ -54,6 +58,16 @@ vg-coder analyze /path/to/project
 vg-coder analyze /path/to/project --max-tokens 8192 --output ./my-output --theme monokai
 ```
 
+### Sao chép nhanh vào Clipboard (Không tạo file)
+Chế độ này rất hữu ích để nhanh chóng đưa toàn bộ ngữ cảnh dự án vào các công cụ AI.
+```bash
+# Phân tích và sao chép toàn bộ code vào clipboard
+vg-coder analyze --clipboard-only
+
+# Hoặc dùng alias ngắn gọn
+vg-coder analyze --clipboard
+```
+
 ### Xem thông tin dự án
 ```bash
 # Thông tin dự án hiện tại
@@ -66,10 +80,43 @@ vg-coder info /path/to/project
 ### Xóa output
 ```bash
 # Xóa output mặc định
-node src/index.js clean
+vg-coder clean
 
 # Xóa output tùy chỉnh
-node src/index.js clean --output ./my-output
+vg-coder clean --output ./my-output
+```
+
+## 📜 Trợ giúp (Help)
+
+Bạn có thể xem tất cả các lệnh và tùy chọn có sẵn bằng cách sử dụng cờ `--help` hoặc `-h`.
+
+### Trợ giúp chung
+Để xem danh sách các lệnh chính:
+```bash
+vg-coder --help
+```
+
+**Output (ví dụ):**
+```
+Usage: vg-coder [command] [options]
+
+CLI tool để phân tích dự án, nối file mã nguồn, đếm token và xuất HTML
+
+Options:
+  -V, --version      output the version number
+  -h, --help         display help for command
+
+Commands:
+  analyze [path]     Phân tích dự án và tạo output HTML
+  info [path]        Hiển thị thông tin về dự án
+  clean              Xóa thư mục output
+  help [command]     display help for command
+```
+
+### Trợ giúp cho lệnh cụ thể
+Để xem chi tiết các tùy chọn cho một lệnh cụ thể (ví dụ: `analyze`):
+```bash
+vg-coder analyze --help
 ```
 
 ## ⚙️ Options
@@ -79,68 +126,42 @@ node src/index.js clean --output ./my-output
 | `--max-tokens <number>` | Số token tối đa mỗi chunk | 8000 |
 | `--model <model>` | Model AI để đếm token | gpt-4 |
 | `--output <path>` | Thư mục output | ./vg-output |
-| `--extensions <list>` | Danh sách extensions (comma-separated) | Auto-detect |
-| `--include-hidden` | Bao gồm file ẩn | false |
-| `--no-structure` | Không ưu tiên giữ cấu trúc file | false |
+| `--extensions <list>` | Danh sách extensions (comma-separated) | Tự động phát hiện |
+| `--include-hidden` | Bao gồm file ẩn (bị bỏ qua mặc định) | false |
+| `--no-structure` | Không ưu tiên giữ cấu trúc file khi chia chunk | false |
 | `--theme <theme>` | Theme cho syntax highlighting | github |
+| `--clipboard-only` | Sao chép nội dung vào clipboard thay vì tạo file output. | false |
+| `--clipboard` | Alias cho `--clipboard-only` | false |
 
-## 📋 Ví dụ chi tiết
 
-### Phân tích dự án Angular
-```bash
-node src/index.js analyze ./my-angular-app --max-tokens 6000 --theme monokai
-```
+## 🤖 Tối ưu cho AI (AI Optimization)
 
-### Phân tích với extensions tùy chỉnh
-```bash
-node src/index.js analyze ./my-project --extensions "js,ts,vue,css" --include-hidden
-```
+### File `combined.txt`
+Công cụ tạo ra file `combined.txt` được định dạng đặc biệt để dễ dàng đưa vào các mô hình ngôn ngữ lớn. Mỗi file được phân tách rõ ràng bằng một header duy nhất, giúp AI nhận biết và xử lý chính xác từng file.
 
-### Xem thông tin chi tiết
-```bash
-node src/index.js info ./my-project
-# Output:
-# 📁 Project Information:
-# Path: /path/to/my-project
-# Primary Type: nodejs
-#
-# Detected Technologies:
-#   nodejs: high confidence
-#
-# 📊 File Statistics:
-# Total Files: 25
-# Total Size: 156.7 KB
-# Total Lines: 4,523
-# Extensions: js, ts, json, md
+**Ví dụ định dạng:**
 ```
+// ===== FILE: src/index.js =====
+... nội dung file index.js ...
 
-## 🧪 Testing
-
-```bash
-# Chạy tất cả tests
-npm test
-
-# Chạy tests với coverage
-npm run test:coverage
-
-# Chạy specific test
-npm test -- --testNamePattern="project detection"
+// ===== FILE: src/utils.js =====
+... nội dung file utils.js ...
 ```
 
+### Mẫu Script Hướng Dẫn AI
+Trang `combined.html` có sẵn một mẫu hướng dẫn (prompt template) để yêu cầu AI trả về các thay đổi dưới dạng script shell. Điều này giúp tự động hóa việc áp dụng các thay đổi do AI đề xuất một cách an toàn và có thể kiểm soát.
+
 ## 📁 Cấu trúc Output
 
 ```
 vg-output/
-├── index.html          # Trang chính với navigation
-├── combined.html       # Tất cả code trong một file
-├── chunks/             # Các chunk riêng biệt
+├── index.html          # Trang chính với navigation và cây thư mục
+├── combined.html       # Tất cả code trong một file HTML, có chức năng tìm kiếm
+├── combined.txt        # Tất cả code trong một file text, tối ưu cho AI
+├── chunks/             # Các chunk riêng biệt (nếu nội dung lớn)
 │   ├── chunk-1.html
-│   ├── chunk-2.html
 │   └── ...
-└── assets/             # CSS, JS, themes
-    ├── styles.css
-    ├── scripts.js
-    └── highlight.css
+└── assets/             # CSS, JS cho trang HTML
 ```
 
 ## 🎯 Các loại dự án được hỗ trợ
@@ -151,28 +172,20 @@ vg-output/
 - **Languages**: JavaScript, TypeScript, Java, Python, C#, Go, Rust
 - **Config**: JSON, YAML, XML, TOML
 
-## 🔧 Tùy chỉnh
-
-### Extensions mặc định
-Tool tự động detect extensions phù hợp với loại dự án:
-- **Web**: .js, .jsx, .ts, .tsx, .vue, .html, .css, .scss
-- **Backend**: .java, .py, .cs, .go, .rs, .php
-- **Config**: .json, .yaml, .xml, .toml, .env
+## 🛡️ Quy tắc bỏ qua file (Ignoring Files)
 
-### Themes có sẵn
-- github (default)
-- monokai
-- atom-one-dark
-- vs2015
-- rainbow
+Công cụ tuân thủ các quy tắc bỏ qua file theo thứ tự ưu tiên sau:
+1.  **`.vgignore`**: Các quy tắc trong file này có độ ưu tiên cao nhất.
+2.  **`.gitignore`**: Các quy tắc trong file `.gitignore` sẽ được áp dụng.
+3.  **Quy tắc mặc định**: Nếu không có các file trên, công cụ sẽ tự động bỏ qua các thư mục và file phổ biến như `node_modules`, `.git`, `dist`, `build`, `target`, các file log, và các thư mục cấu hình của IDE (`.vscode`, `.idea`).
 
 ## 🤝 Đóng góp
 
-1. Fork repository
-2. Tạo 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. Tạo Pull Request
+1.  Fork repository
+2.  Tạo 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.  Tạo Pull Request
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vg-coder-cli",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "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": {

package/src/exporter/html-exporter.js

@@ -39,11 +39,15 @@ class HtmlExporter {
     
     // Tạo combined view
     await this.createCombinedPage(chunks, metadata);
-    
+
+    // Tạo combined.txt cho AI tools
+    await this.createCombinedTxtFile(chunks, metadata);
+
     return {
       indexPath: path.join(this.outputPath, 'index.html'),
       chunksPath: path.join(this.outputPath, 'chunks'),
       combinedPath: path.join(this.outputPath, 'combined.html'),
+      combinedTxtPath: path.join(this.outputPath, 'combined.txt'),
       totalFiles: chunks.length
     };
   }
@@ -250,6 +254,126 @@ Nếu file chưa tồn tại, script sẽ tự tạo file và thư mục cha.</c
     await fs.writeFile(path.join(this.outputPath, 'combined.html'), html);
   }
 
+  /**
+   * Tạo combined.txt file cho AI tools với formatting tối ưu
+   */
+  async createCombinedTxtFile(chunks, metadata) {
+    // Sử dụng files gốc nếu có, nếu không thì dùng chunks
+    const files = metadata.files;
+
+    if (files && files.length > 0) {
+      // Tạo content từ files gốc với formatting AI-friendly
+      let content = '';
+
+      // Minimal header cho AI context
+      content += `// VG Coder Analysis - ${metadata.projectInfo?.primary || 'Unknown'} Project\n`;
+      content += `// Files: ${files.length} | Generated: ${new Date().toISOString()}\n\n`;
+
+      // Nội dung từng file với boundaries rõ ràng
+      for (let i = 0; i < files.length; i++) {
+        const file = files[i];
+
+        // File boundary marker
+        content += `// ===== FILE: ${file.relativePath} =====\n`;
+
+        // Nội dung file nguyên bản
+        content += file.content;
+
+        // Đảm bảo file kết thúc bằng newline
+        if (!file.content.endsWith('\n')) {
+          content += '\n';
+        }
+
+        // Separator giữa các files
+        if (i < files.length - 1) {
+          content += '\n';
+        }
+      }
+
+      await fs.writeFile(path.join(this.outputPath, 'combined.txt'), content, 'utf8');
+    } else {
+      // Fallback: sử dụng chunks (legacy)
+      let content = '';
+
+      // Minimal header cho AI context
+      content += `// VG Coder Analysis - ${metadata.projectInfo?.primary || 'Unknown'} Project\n`;
+      content += `// Files: ${chunks.length} | Generated: ${new Date().toISOString()}\n\n`;
+
+      // Parse chunks để extract file content với boundaries rõ ràng
+      for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+
+        // Extract file content từ chunk, bỏ qua headers và separators
+        const cleanContent = this.extractCleanContent(chunk.content);
+
+        if (cleanContent.trim()) {
+          content += cleanContent;
+
+          // Đảm bảo kết thúc bằng newline
+          if (!cleanContent.endsWith('\n')) {
+            content += '\n';
+          }
+
+          // Separator giữa các chunks (minimal)
+          if (i < chunks.length - 1) {
+            content += '\n';
+          }
+        }
+      }
+
+      await fs.writeFile(path.join(this.outputPath, 'combined.txt'), content, 'utf8');
+    }
+  }
+
+  /**
+   * Extract clean content từ chunk, loại bỏ headers và formatting
+   */
+  extractCleanContent(chunkContent) {
+    const lines = chunkContent.split('\n');
+    let cleanLines = [];
+    let inFileContent = false;
+    let currentFilePath = '';
+
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+
+      // Detect file header
+      if (line.includes('================================================================================')) {
+        if (i + 1 < lines.length && lines[i + 1].startsWith('File: ')) {
+          // Start of new file
+          currentFilePath = lines[i + 1].replace('File: ', '').trim();
+          cleanLines.push(`// ===== FILE: ${currentFilePath} =====`);
+          inFileContent = false;
+          i += 2; // Skip header lines
+          continue;
+        }
+      }
+
+      // Skip project headers and structure
+      if (line.startsWith('# Project Analysis Report') ||
+          line.startsWith('Generated:') ||
+          line.startsWith('Project Path:') ||
+          line.startsWith('## Statistics') ||
+          line.startsWith('## Project Structure') ||
+          line.startsWith('- Total') ||
+          line.startsWith('- Extensions:') ||
+          line.startsWith('```') ||
+          line.startsWith('├──') ||
+          line.startsWith('└──') ||
+          line.trim() === '') {
+        continue;
+      }
+
+      // Add actual file content
+      if (currentFilePath && !line.includes('================================================================================')) {
+        cleanLines.push(line);
+        inFileContent = true;
+      }
+    }
+
+    return cleanLines.join('\n');
+  }
+
   /**
    * Copy static assets
    */

package/src/index.js

@@ -9,6 +9,7 @@ const ProjectDetector = require('./detectors/project-detector');
 const FileScanner = require('./scanner/file-scanner');
 const TokenManager = require('./tokenizer/token-manager');
 const HtmlExporter = require('./exporter/html-exporter');
+const ClipboardManager = require('./utils/clipboard');
 
 /**
  * Main CLI Application
@@ -39,6 +40,8 @@ class VGCoderCLI {
       .option('--include-hidden', 'Bao gồm file ẩn')
       .option('--no-structure', 'Không ưu tiên giữ cấu trúc file')
       .option('--theme <theme>', 'Theme cho syntax highlighting', 'github')
+      .option('--clipboard-only', 'Copy content to clipboard without creating files')
+      .option('--clipboard', 'Alias for --clipboard-only')
       .action(this.handleAnalyze.bind(this));
 
     // Info command
@@ -60,17 +63,25 @@ class VGCoderCLI {
    */
   async handleAnalyze(projectPath, options) {
     const spinner = ora('Initializing analysis...').start();
-    
+
     try {
       // Resolve project path
       projectPath = path.resolve(projectPath || process.cwd());
-      const outputPath = path.resolve(options.output);
+
+      // Check if clipboard-only mode
+      const clipboardMode = options.clipboardOnly || options.clipboard;
+      const outputPath = clipboardMode ? null : path.resolve(options.output || './vg-output');
       
       // Validate project path
       if (!await fs.pathExists(projectPath)) {
         throw new Error(`Project path does not exist: ${projectPath}`);
       }
 
+      // Validate output path for non-clipboard mode
+      if (!clipboardMode && !outputPath) {
+        throw new Error('Output path is required for non-clipboard mode');
+      }
+
       spinner.text = 'Detecting project type...';
       
       // Detect project type
@@ -123,10 +134,42 @@ class VGCoderCLI {
       console.log(`Estimated Chunks: ${tokenAnalysis.summary.estimatedChunks}`);
 
       spinner.text = 'Creating content chunks...';
-      
-      // Create combined content
+
+      if (clipboardMode) {
+        // Clipboard mode: create AI-friendly content and copy to clipboard
+        spinner.text = 'Creating AI-friendly content...';
+
+        const aiContent = await scanner.createCombinedContentForAI(scanResult.files, {
+          includeStats: false,
+          includeTree: false,
+          preserveLineNumbers: true
+        });
+
+        spinner.text = 'Copying to clipboard...';
+
+        await ClipboardManager.copyToClipboard(aiContent);
+        const contentInfo = ClipboardManager.getContentInfo(aiContent);
+
+        // Cleanup
+        tokenManager.cleanup();
+
+        spinner.succeed('Content copied to clipboard successfully!');
+
+        console.log(chalk.green('\n📋 Clipboard Content:'));
+        console.log(`Files: ${chalk.cyan(scanResult.files.length)}`);
+        console.log(`Lines: ${chalk.cyan(contentInfo.lines.toLocaleString())}`);
+        console.log(`Characters: ${chalk.cyan(contentInfo.characters.toLocaleString())}`);
+        console.log(`Size: ${chalk.cyan(contentInfo.size)}`);
+
+        console.log(chalk.blue('\n💡 Ready for AI analysis!'));
+        console.log('Content is now in your clipboard and ready to paste into AI tools.');
+
+        return; // Exit early for clipboard mode
+      }
+
+      // Normal mode: create HTML output
       const combinedContent = await scanner.createCombinedContent(scanResult.files);
-      
+
       // Chunk content
       const chunks = await tokenManager.chunkContent(combinedContent, {
         projectType: projectInfo.primary,
@@ -153,7 +196,8 @@ class VGCoderCLI {
         projectInfo: projectInfo,
         scanStats: scanResult.stats,
         tokenStats: tokenAnalysis.summary,
-        directoryStructure: treeStructure
+        directoryStructure: treeStructure,
+        files: scanResult.files // Thêm files gốc để tạo combined.txt
       });
       
       // Cleanup
@@ -164,6 +208,9 @@ class VGCoderCLI {
       console.log(chalk.green('\n✅ Output Generated:'));
       console.log(`Index: ${chalk.cyan(exportResult.indexPath)}`);
       console.log(`Combined: ${chalk.cyan(exportResult.combinedPath)}`);
+      if (exportResult.combinedTxtPath) {
+        console.log(`Combined.txt: ${chalk.cyan(exportResult.combinedTxtPath)}`);
+      }
       console.log(`Chunks: ${chalk.cyan(exportResult.chunksPath)}`);
       console.log(`Total Files: ${exportResult.totalFiles}`);
       

package/src/scanner/file-scanner.js

@@ -446,6 +446,54 @@ Size: {size} bytes | Lines: {lines}
     return '\n\n';
   }
 
+  /**
+   * Tạo nội dung kết hợp cho AI tools với formatting chính xác
+   */
+  async createCombinedContentForAI(files, options = {}) {
+    const {
+      includeStats = false,
+      includeTree = false,
+      preserveLineNumbers = true
+    } = options;
+
+    let content = '';
+
+    // Header với thông tin project (tùy chọn)
+    if (includeStats) {
+      content += this.generateProjectHeader(files);
+      content += '\n\n';
+    }
+
+    // Cấu trúc thư mục (tùy chọn)
+    if (includeTree) {
+      content += this.generateTreeStructure(files);
+      content += '\n\n';
+    }
+
+    // Nội dung từng file với formatting chính xác
+    for (let i = 0; i < files.length; i++) {
+      const file = files[i];
+
+      // File boundary marker - không ảnh hưởng line numbering
+      content += `// ===== FILE: ${file.relativePath} =====\n`;
+
+      // Nội dung file nguyên bản
+      content += file.content;
+
+      // Đảm bảo file kết thúc bằng newline
+      if (!file.content.endsWith('\n')) {
+        content += '\n';
+      }
+
+      // Separator giữa các files
+      if (i < files.length - 1) {
+        content += '\n';
+      }
+    }
+
+    return content;
+  }
+
   /**
    * Tạo header thông tin project
    */

package/src/utils/clipboard.js

@@ -0,0 +1,170 @@
+const { spawn } = require('child_process');
+const os = require('os');
+
+/**
+ * Cross-platform clipboard utility
+ */
+class ClipboardManager {
+  /**
+   * Copy text to clipboard
+   */
+  static async copyToClipboard(text) {
+    const platform = os.platform();
+    
+    try {
+      switch (platform) {
+        case 'darwin': // macOS
+          return await this.copyMacOS(text);
+        case 'win32': // Windows
+          return await this.copyWindows(text);
+        case 'linux': // Linux
+          return await this.copyLinux(text);
+        default:
+          throw new Error(`Unsupported platform: ${platform}`);
+      }
+    } catch (error) {
+      throw new Error(`Failed to copy to clipboard: ${error.message}`);
+    }
+  }
+
+  /**
+   * Copy to clipboard on macOS
+   */
+  static async copyMacOS(text) {
+    return new Promise((resolve, reject) => {
+      const pbcopy = spawn('pbcopy');
+      
+      pbcopy.stdin.write(text);
+      pbcopy.stdin.end();
+      
+      pbcopy.on('close', (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`pbcopy exited with code ${code}`));
+        }
+      });
+      
+      pbcopy.on('error', (error) => {
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Copy to clipboard on Windows
+   */
+  static async copyWindows(text) {
+    return new Promise((resolve, reject) => {
+      const clip = spawn('clip');
+      
+      clip.stdin.write(text);
+      clip.stdin.end();
+      
+      clip.on('close', (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`clip exited with code ${code}`));
+        }
+      });
+      
+      clip.on('error', (error) => {
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Copy to clipboard on Linux
+   */
+  static async copyLinux(text) {
+    // Try xclip first, then xsel as fallback
+    try {
+      return await this.copyLinuxXclip(text);
+    } catch (error) {
+      try {
+        return await this.copyLinuxXsel(text);
+      } catch (xselError) {
+        throw new Error('Neither xclip nor xsel is available. Please install one of them.');
+      }
+    }
+  }
+
+  /**
+   * Copy using xclip
+   */
+  static async copyLinuxXclip(text) {
+    return new Promise((resolve, reject) => {
+      const xclip = spawn('xclip', ['-selection', 'clipboard']);
+      
+      xclip.stdin.write(text);
+      xclip.stdin.end();
+      
+      xclip.on('close', (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`xclip exited with code ${code}`));
+        }
+      });
+      
+      xclip.on('error', (error) => {
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Copy using xsel
+   */
+  static async copyLinuxXsel(text) {
+    return new Promise((resolve, reject) => {
+      const xsel = spawn('xsel', ['--clipboard', '--input']);
+      
+      xsel.stdin.write(text);
+      xsel.stdin.end();
+      
+      xsel.on('close', (code) => {
+        if (code === 0) {
+          resolve();
+        } else {
+          reject(new Error(`xsel exited with code ${code}`));
+        }
+      });
+      
+      xsel.on('error', (error) => {
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Get clipboard content size info
+   */
+  static getContentInfo(text) {
+    const lines = text.split('\n').length;
+    const chars = text.length;
+    const bytes = Buffer.byteLength(text, 'utf8');
+    
+    return {
+      lines,
+      characters: chars,
+      bytes,
+      size: this.formatBytes(bytes)
+    };
+  }
+
+  /**
+   * Format bytes to human readable
+   */
+  static formatBytes(bytes) {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+  }
+}
+
+module.exports = ClipboardManager;

package/test-small/package-lock.json

@@ -1 +0,0 @@
-{"name": "test-large", "version": "1.0.0"}

package/test-small/package.json

@@ -1 +0,0 @@
-{"name": "test-small", "version": "1.0.0"}

package/test-small/src/index.js

@@ -1 +0,0 @@
-console.log("Hello World");