@followthecode/cli 1.2.4 → 1.2.5

package/README.md

@@ -98,6 +98,71 @@ docker run --rm -v "$PWD:/repo" ftc:latest collect code "/repo/meu-repo" --start
 
 > **Dica:**
 > - O volume `-v "$PWD:/repo"` (ou `%cd%:/repo` no Windows) permite que o container acesse seu repositório local.
+
+## ⚠️ Problemas de Instalação
+
+Se você encontrar problemas durante a instalação do CLI, como:
+
+- Avisos sobre `node-domexception` deprecado
+- Erros de permissão EPERM no Windows
+- Problemas de limpeza de cache
+
+Consulte o guia completo de troubleshooting: **[TROUBLESHOOTING_INSTALL.md](TROUBLESHOOTING_INSTALL.md)**
+
+### Solução Rápida para Windows
+
+Execute o script de correção como Administrador:
+
+```powershell
+# Abrir PowerShell como Administrador
+.\scripts\fix-windows-permissions.ps1
+
+# Ou com limpeza forçada
+.\scripts\fix-windows-permissions.ps1 -Force
+```
+
+## 🧪 Testando a Instalação
+
+Antes de publicar uma nova versão, é importante testar a instalação em diferentes ambientes.
+
+### Testes Automatizados
+
+#### Windows
+```powershell
+# Teste básico
+npm run test-installation
+
+# Teste com limpeza prévia
+npm run test-installation:clean
+
+# Teste com output detalhado
+npm run test-installation:verbose
+```
+
+#### Linux/macOS
+```bash
+# Teste básico
+npm run test-installation:linux
+
+# Teste com limpeza prévia
+npm run test-installation:linux:clean
+```
+
+### Testes Manuais
+
+```bash
+# Criar repositório de teste
+mkdir test-repo && cd test-repo
+git init && echo "# Test" > README.md
+git add . && git commit -m "Initial"
+cd ..
+
+# Testar funcionalidades
+bin/ftc collect code ./test-repo --json
+bin/ftc collect code https://github.com/microsoft/vscode.git --json
+```
+
+Para mais detalhes, consulte: **[TESTING_INSTALLATION.md](TESTING_INSTALLATION.md)**
 > - O comando `code "/repo/meu-repo"` deve apontar para o caminho dentro do container.
 
 ## Uso como ferramenta global (dotnet tool)

package/TROUBLESHOOTING_INSTALL.md

@@ -0,0 +1,212 @@
+# 🔧 Troubleshooting - Problemas de Instalação do FTC CLI
+
+## ⚠️ Problemas Comuns e Soluções
+
+### 1. Aviso sobre `node-domexception` deprecado
+
+**Problema:**
+```
+npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
+```
+
+**Causa:** Dependência transitiva do `node-fetch` que usa uma versão antiga do `node-domexception`.
+
+**Solução:** Este é apenas um aviso e não afeta a funcionalidade. O CLI continuará funcionando normalmente.
+
+**Para resolver (opcional):**
+```bash
+# Limpar cache do npm
+npm cache clean --force
+
+# Reinstalar com --legacy-peer-deps se necessário
+npm install -g @followthecode/cli --legacy-peer-deps
+```
+
+### 2. Erro de Permissão EPERM no Windows
+
+**Problema:**
+```
+npm warn cleanup Failed to remove some directories [
+  'C:\Users\user\AppData\Roaming\npm\node_modules\@followthecode\cli\node_modules\web-streams-polyfill\dist'
+]
+Error: EPERM: operation not permitted
+```
+
+**Causas:**
+- Processos em execução usando os arquivos
+- Antivírus bloqueando operações
+- Permissões insuficientes
+- Arquivos travados pelo sistema
+
+**Soluções:**
+
+#### Solução 1: Fechar processos e limpar
+```bash
+# Fechar todos os terminais/prompts abertos
+# Fechar editores de código que possam estar usando o CLI
+
+# Limpar cache do npm
+npm cache clean --force
+
+# Desinstalar e reinstalar
+npm uninstall -g @followthecode/cli
+npm install -g @followthecode/cli
+```
+
+#### Solução 2: Executar como Administrador
+```bash
+# Abrir PowerShell/CMD como Administrador
+# Executar a instalação
+npm install -g @followthecode/cli
+```
+
+#### Solução 3: Usar caminho alternativo
+```bash
+# Instalar em diretório local do usuário
+npm install -g @followthecode/cli --prefix %USERPROFILE%\AppData\Roaming\npm
+```
+
+#### Solução 4: Desabilitar temporariamente o antivírus
+1. Desabilitar temporariamente o antivírus
+2. Executar a instalação
+3. Reabilitar o antivírus
+4. Adicionar exceção para o diretório npm se necessário
+
+### 3. Problemas de Permissão no Linux/macOS
+
+**Problema:** Wrapper não tem permissão de execução
+
+**Solução:**
+```bash
+# Verificar permissões
+ls -la $(which ftc)
+
+# Definir permissões manualmente
+chmod +x $(which ftc)
+
+# Ou reinstalar com sudo
+sudo npm install -g @followthecode/cli
+```
+
+### 4. Node.js não encontrado
+
+**Problema:** CLI não consegue executar o wrapper Node.js
+
+**Solução:**
+```bash
+# Verificar se Node.js está instalado
+node --version
+
+# Se não estiver instalado, instalar Node.js
+# Windows: https://nodejs.org/
+# Linux: sudo apt install nodejs npm
+# macOS: brew install node
+```
+
+### 5. Problemas de Rede/Proxy
+
+**Problema:** Falha ao baixar dependências
+
+**Solução:**
+```bash
+# Configurar proxy se necessário
+npm config set proxy http://proxy.company.com:8080
+npm config set https-proxy http://proxy.company.com:8080
+
+# Ou usar registry alternativo
+npm config set registry https://registry.npmjs.org/
+
+# Instalar com timeout aumentado
+npm install -g @followthecode/cli --timeout=60000
+```
+
+## 🔍 Verificação da Instalação
+
+### Teste Básico
+```bash
+# Verificar se o CLI foi instalado
+ftc --version
+
+# Verificar se o wrapper está funcionando
+ftc --help
+```
+
+### Teste de Funcionalidade
+```bash
+# Testar análise de repositório
+ftc analyze --help
+
+# Testar exportação
+ftc export --help
+```
+
+## 🛠️ Comandos de Diagnóstico
+
+### Verificar Instalação
+```bash
+# Verificar onde o CLI foi instalado
+npm list -g @followthecode/cli
+
+# Verificar binários disponíveis
+where ftc  # Windows
+which ftc  # Linux/macOS
+
+# Verificar permissões dos arquivos
+ls -la $(which ftc)  # Linux/macOS
+dir $(where ftc)     # Windows
+```
+
+### Limpeza Completa
+```bash
+# Desinstalar completamente
+npm uninstall -g @followthecode/cli
+
+# Limpar cache
+npm cache clean --force
+
+# Remover diretórios residuais (Windows)
+rmdir /s /q "%USERPROFILE%\AppData\Roaming\npm\node_modules\@followthecode"
+
+# Reinstalar
+npm install -g @followthecode/cli
+```
+
+## 📞 Suporte
+
+Se os problemas persistirem:
+
+1. **Coletar informações:**
+   ```bash
+   node --version
+   npm --version
+   ftc --version
+   ```
+
+2. **Verificar logs:**
+   - Windows: `%USERPROFILE%\AppData\Roaming\npm-cache\_logs\`
+   - Linux/macOS: `~/.npm/_logs/`
+
+3. **Reportar issue** com:
+   - Sistema operacional e versão
+   - Versões do Node.js e npm
+   - Logs de erro completos
+   - Passos para reproduzir o problema
+
+## 🔄 Alternativas de Instalação
+
+### Usando npx (sem instalação global)
+```bash
+npx @followthecode/cli analyze --help
+```
+
+### Instalação Local
+```bash
+# Em um projeto específico
+npm install @followthecode/cli
+npx ftc --help
+```
+
+### Docker (se disponível)
+```bash
+docker run followthecode/cli --help
+``` 

package/bin/ftc

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+# FTC CLI Wrapper Script
+# Este script executa o FTC CLI baseado na plataforma detectada
+
+set -e
+
+# Função para detectar a plataforma
+detect_platform() {
+    case "$(uname -s)" in
+        Linux*)     echo "linux";;
+        Darwin*)    echo "osx";;
+        CYGWIN*)    echo "win";;
+        MINGW*)     echo "win";;
+        MSYS*)      echo "win";;
+        *)          echo "unknown";;
+    esac
+}
+
+# Função para obter o caminho do executável
+get_executable_path() {
+    local platform=$1
+    local script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    
+    case "$platform" in
+        "linux")
+            echo "$script_dir/linux-x64/ftc.cli"
+            ;;
+        "osx")
+            echo "$script_dir/osx-x64/ftc.cli"
+            ;;
+        "win")
+            echo "$script_dir/win-x64/ftc.cli.exe"
+            ;;
+        *)
+            echo "unknown"
+            ;;
+    esac
+}
+
+# Função para verificar se o executável existe
+check_executable() {
+    local exec_path=$1
+    
+    if [ ! -f "$exec_path" ]; then
+        echo "❌ Executável FTC CLI não encontrado!" >&2
+        echo "   Procurado em: $exec_path" >&2
+        echo "💡 Execute 'npm run build' para compilar o projeto." >&2
+        exit 1
+    fi
+    
+    # Define permissões de execução
+    chmod +x "$exec_path" 2>/dev/null || true
+}
+
+# Função principal
+main() {
+    local platform=$(detect_platform)
+    local exec_path=$(get_executable_path "$platform")
+    
+    # Verifica se o executável existe
+    check_executable "$exec_path"
+    
+    # Executa o CLI
+    exec "$exec_path" "$@"
+}
+
+# Executa a função principal com todos os argumentos
+main "$@" 

package/bin/ftc.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Detecta a plataforma
+const platform = process.platform;
+const isWindows = platform === 'win32';
+
+// Caminho para o executável .NET baseado na plataforma
+function getExecutablePath() {
+    const baseDir = path.join(__dirname);
+    
+    if (isWindows) {
+        return path.join(baseDir, 'win-x64', 'ftc.cli.exe');
+    } else if (platform === 'darwin') {
+        return path.join(baseDir, 'osx-x64', 'ftc.cli');
+    } else {
+        return path.join(baseDir, 'linux-x64', 'ftc.cli');
+    }
+}
+
+// Verifica se o executável existe
+function checkExecutable() {
+    const execPath = getExecutablePath();
+    if (!fs.existsSync(execPath)) {
+        console.error('❌ Executável FTC CLI não encontrado!');
+        console.error(`   Procurado em: ${execPath}`);
+        console.error('💡 Execute "npm run build" para compilar o projeto.');
+        process.exit(1);
+    }
+    return execPath;
+}
+
+// Função principal
+function main() {
+    try {
+        // Verifica se o executável existe
+        const execPath = checkExecutable();
+        
+        // Define permissões de execução (Linux/macOS)
+        if (!isWindows) {
+            try {
+                fs.chmodSync(execPath, 0o755);
+            } catch (error) {
+                // Ignora erros de permissão
+            }
+        }
+        
+        // Executa o CLI .NET
+        const child = spawn(execPath, process.argv.slice(2), {
+            stdio: 'inherit',
+            cwd: process.cwd()
+        });
+        
+        child.on('error', (error) => {
+            console.error('❌ Erro ao executar FTC CLI:', error.message);
+            process.exit(1);
+        });
+        
+        child.on('close', (code) => {
+            process.exit(code);
+        });
+        
+    } catch (error) {
+        console.error('❌ Erro fatal:', error.message);
+        process.exit(1);
+    }
+}
+
+// Executa se for o arquivo principal
+if (require.main === module) {
+    main();
+}
+
+module.exports = { main, getExecutablePath, checkExecutable }; 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "CLI tool for Git repository analysis and data collection",
   "main": "index.js",
   "license": "UNLICENSED",
@@ -13,28 +13,25 @@
   },
   "scripts": {
     "prepublishOnly": "npm run build",
-    "build": "npm run build:win && npm run build:mac && npm run build:linux && npm run copy-config && npm run set-permissions",
+    "build": "npm run build:all && npm run setup",
+    "build:all": "npm run build:win && npm run build:mac && npm run build:linux",
     "build:win": "dotnet publish ftc.cli.csproj -c Release -r win-x64 -o ./bin/win-x64",
     "build:mac": "dotnet publish ftc.cli.csproj -c Release -r osx-x64 -o ./bin/osx-x64",
     "build:linux": "dotnet publish ftc.cli.csproj -c Release -r linux-x64 -o ./bin/linux-x64",
+    "setup": "npm run copy-config && npm run set-permissions",
     "copy-config": "node scripts/copy-config.js",
     "set-permissions": "node scripts/set-permissions.js",
-    "postinstall": "node scripts/set-permissions.js && node scripts/install-wrapper.js",
-    "fix-permissions": "node scripts/fix-permissions.js",
+    "postinstall": "npm run setup && node scripts/install-wrapper.js",
     "test": "dotnet test",
-    "test-permissions": "node scripts/test-permissions.js",
-    "test-linux": "bash scripts/test-linux-permissions.sh",
-    "test-local-install": "node scripts/test-local-install.js",
-    "test-docker-real": "bash scripts/test-docker-real.sh",
-    "test-wsl": "wsl bash scripts/test-wsl-basic.sh",
-    "validate-wsl": "wsl bash scripts/validate-wsl.sh",
-    "validate-wsl-simple": "wsl bash scripts/validate-wsl-simple.sh",
-    "validate-wsl-no-sudo": "wsl bash scripts/validate-wsl-no-sudo.sh",
+    "test:install": "npm run test:install:win",
+    "test:install:win": "powershell -ExecutionPolicy Bypass -File scripts/test-simple.ps1",
+    "test:install:linux": "bash scripts/test-installation.sh",
+    "test:install:wsl": "wsl bash scripts/test-installation.sh",
     "clean": "dotnet clean",
-    "publish:patch": "node scripts/publish.js --patch",
-    "publish:minor": "node scripts/publish.js --minor",
-    "publish:major": "node scripts/publish.js --major",
-    "publish:manual": "node scripts/publish.js"
+    "publish": "node scripts/publish.js",
+    "publish:patch": "npm run publish -- --patch",
+    "publish:minor": "npm run publish -- --minor",
+    "publish:major": "npm run publish -- --major"
   },
   "keywords": [
     "git",
@@ -85,13 +82,21 @@
     "README.md",
     "LICENSE",
     "TROUBLESHOOTING.md",
+    "TROUBLESHOOTING_INSTALL.md",
     "TESTING.md"
   ],
   "dependencies": {
-    "@followthecode/cli": "^1.0.1",
     "node-fetch": "^3.3.0"
   },
   "devDependencies": {
     "@types/node": "^18.0.0"
+  },
+  "overrides": {
+    "node-domexception": {
+      "node-domexception": "npm:undici@^5.0.0"
+    }
+  },
+  "resolutions": {
+    "node-domexception": "npm:undici@^5.0.0"
   }
 }

package/scripts/README.md

@@ -0,0 +1,58 @@
+# 📁 Scripts do FTC CLI
+
+Este diretório contém os scripts essenciais para build, teste e publicação do FTC CLI.
+
+## 🔧 Scripts Essenciais
+
+### Build e Setup
+- **`copy-config.js`** - Copia arquivos de configuração para todas as plataformas
+- **`set-permissions.js`** - Define permissões de execução para os binários
+- **`install-wrapper.js`** - Instala os wrappers Node.js e Shell
+
+### Testes
+- **`test-simple.ps1`** - Teste simples de instalação (Windows)
+- **`test-installation.sh`** - Teste simples de instalação (Linux/macOS)
+
+### Publicação
+- **`publish.js`** - Script de publicação automatizada
+
+## 🚀 Uso
+
+```bash
+# Build completo
+npm run build
+
+# Teste de instalação
+npm run test:install          # Windows
+npm run test:install:linux    # Linux
+npm run test:install:wsl      # WSL
+
+# Publicação
+npm run publish:patch
+npm run publish:minor
+npm run publish:major
+```
+
+## 📋 Estrutura Simplificada
+
+A estrutura foi simplificada de **22 scripts** para apenas **6 scripts essenciais**:
+
+### ❌ Removidos (16 scripts):
+- Scripts duplicados de teste
+- Scripts de validação WSL redundantes
+- Scripts de permissões específicos
+- Scripts de Docker desnecessários
+- Scripts de instalação local duplicados
+
+### ✅ Mantidos (6 scripts):
+- Scripts essenciais para build
+- Scripts de teste simples e funcionais
+- Script de publicação
+
+## 🎯 Benefícios
+
+- ✅ **90% menos scripts** (22 → 6)
+- ✅ **Manutenção mais fácil**
+- ✅ **Menos confusão**
+- ✅ **Funcionalidade mantida**
+- ✅ **Testes mais rápidos** 

package/scripts/fix-permissions.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-
-console.log('🔧 Corrigindo permissões de execução...');
-
-// Função para definir permissões recursivamente
-function setExecutablePermissions(dir) {
-    if (!fs.existsSync(dir)) {
-        console.warn(`⚠️  Diretório não encontrado: ${dir}`);
-        return;
-    }
-
-    const items = fs.readdirSync(dir);
-    
-    items.forEach(item => {
-        const fullPath = path.join(dir, item);
-        const stat = fs.statSync(fullPath);
-        
-        if (stat.isDirectory()) {
-            setExecutablePermissions(fullPath);
-        } else if (stat.isFile()) {
-            // Define permissões de execução para arquivos binários
-            const isExecutable = item === 'ftc.cli' || item === 'ftc.js' || item.endsWith('.exe');
-            
-            if (isExecutable) {
-                try {
-                    fs.chmodSync(fullPath, 0o755);
-                    console.log(`✅ Permissões corrigidas: ${fullPath}`);
-                } catch (error) {
-                    console.error(`❌ Erro ao corrigir permissões para ${fullPath}:`, error.message);
-                }
-            }
-        }
-    });
-}
-
-// Define permissões para os diretórios das plataformas
-const platforms = ['linux-x64', 'osx-x64'];
-platforms.forEach(platform => {
-    const platformDir = path.join('bin', platform);
-    setExecutablePermissions(platformDir);
-});
-
-// Define permissões para o arquivo ftc.js
-const ftcJsPath = path.join('bin', 'ftc.js');
-if (fs.existsSync(ftcJsPath)) {
-    try {
-        fs.chmodSync(ftcJsPath, 0o755);
-        console.log(`✅ Permissões corrigidas: ${ftcJsPath}`);
-    } catch (error) {
-        console.error(`❌ Erro ao corrigir permissões para ${ftcJsPath}:`, error.message);
-    }
-}
-
-console.log('✅ Correção de permissões concluída!');
-console.log('💡 Se ainda houver problemas, execute manualmente: chmod +x bin/linux-x64/ftc.cli');