@followthecode/cli 1.1.10 → 1.1.11

package/NODEJS-TROUBLESHOOTING.md

@@ -0,0 +1,143 @@
+# 🔧 Troubleshooting - Problemas com Node.js no Linux
+
+## ❌ Erro: `node: not found`
+
+Se você está recebendo o erro `node: not found` após instalar o FTC CLI no Linux, isso significa que o Node.js não está instalado ou não está no PATH do sistema.
+
+## 🔍 Diagnóstico
+
+### 1. Verificar se o Node.js está instalado:
+```bash
+node --version
+npm --version
+```
+
+### 2. Se o Node.js não estiver instalado:
+
+#### Opção A: Instalar via NodeSource (Recomendado)
+```bash
+# Para Ubuntu/Debian
+curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# Para CentOS/RHEL/Fedora
+curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
+sudo yum install -y nodejs
+```
+
+#### Opção B: Instalar via Snap
+```bash
+sudo snap install node --classic
+```
+
+#### Opção C: Instalar via NVM (Node Version Manager)
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
+source ~/.bashrc
+nvm install --lts
+nvm use --lts
+```
+
+### 3. Verificar o PATH:
+```bash
+echo $PATH
+which node
+```
+
+## 🛠️ Soluções Alternativas
+
+### Solução 1: Usar o Wrapper Shell (Recomendado para Linux sem Node.js)
+
+O FTC CLI agora inclui um wrapper shell script que não depende do Node.js:
+
+```bash
+# Execute diretamente o wrapper shell
+ftc --help
+
+# Ou use o comando alternativo
+ftc-linux --help
+```
+
+### Solução 2: Instalar Node.js apenas para o usuário atual
+
+Se você não tem permissões de administrador:
+
+```bash
+# Baixar e instalar Node.js localmente
+mkdir ~/.nodejs
+cd ~/.nodejs
+wget https://nodejs.org/dist/v18.17.0/node-v18.17.0-linux-x64.tar.xz
+tar -xf node-v18.17.0-linux-x64.tar.xz
+echo 'export PATH="$HOME/.nodejs/node-v18.17.0-linux-x64/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Solução 3: Usar o binário .NET diretamente
+
+Se nenhuma das opções acima funcionar, você pode executar o binário .NET diretamente:
+
+```bash
+# Navegar para o diretório de instalação
+cd /usr/local/lib/node_modules/@followthecode/cli/bin/linux-x64
+
+# Executar diretamente
+./ftc.cli --help
+```
+
+## 🔧 Configuração Automática
+
+O FTC CLI agora detecta automaticamente qual wrapper usar:
+
+```bash
+# Reinstalar o pacote para executar a configuração automática
+npm uninstall -g @followthecode/cli
+npm install -g @followthecode/cli
+```
+
+## 📋 Verificação
+
+Após a instalação, verifique se está funcionando:
+
+```bash
+# Verificar se o comando está disponível
+which ftc
+
+# Testar o comando
+ftc --help
+
+# Verificar a versão
+ftc --version
+```
+
+## 🆘 Ainda com Problemas?
+
+Se você ainda está enfrentando problemas:
+
+1. **Verifique as permissões**:
+   ```bash
+   ls -la $(which ftc)
+   chmod +x $(which ftc)
+   ```
+
+2. **Reinstale o pacote**:
+   ```bash
+   npm uninstall -g @followthecode/cli
+   npm cache clean --force
+   npm install -g @followthecode/cli
+   ```
+
+3. **Execute o script de configuração manualmente**:
+   ```bash
+   cd /usr/local/lib/node_modules/@followthecode/cli
+   node scripts/install-wrapper.js
+   ```
+
+## 📞 Suporte
+
+Se nenhuma das soluções acima funcionar, abra uma issue no repositório do projeto com:
+
+- Sistema operacional e versão
+- Saída do comando `node --version`
+- Saída do comando `npm --version`
+- Mensagem de erro completa
+- Conteúdo do arquivo `/etc/environment` (se aplicável) 

package/bin/ftc

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+# Follow The Code CLI - Wrapper Shell Script
+# Este script executa o binário .NET diretamente sem depender do Node.js
+
+# Detecta a plataforma
+PLATFORM=$(uname -s | tr '[:upper:]' '[:lower:]')
+ARCH=$(uname -m)
+
+# Mapeia a plataforma para o diretório correto
+case "$PLATFORM" in
+    "linux")
+        PLATFORM_DIR="linux-x64"
+        EXECUTABLE="ftc.cli"
+        ;;
+    "darwin")
+        PLATFORM_DIR="osx-x64"
+        EXECUTABLE="ftc.cli"
+        ;;
+    *)
+        echo "❌ Plataforma não suportada: $PLATFORM"
+        echo "💡 Plataformas suportadas: Linux, macOS"
+        exit 1
+        ;;
+esac
+
+# Obtém o diretório do script
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXECUTABLE_PATH="$SCRIPT_DIR/$PLATFORM_DIR/$EXECUTABLE"
+
+# Verifica se o executável existe
+if [ ! -f "$EXECUTABLE_PATH" ]; then
+    echo "❌ Erro: Executável .NET não encontrado em: $EXECUTABLE_PATH"
+    echo "💡 Certifique-se de que o projeto foi compilado para todas as plataformas."
+    exit 1
+fi
+
+# Verifica permissões de execução
+if [ ! -x "$EXECUTABLE_PATH" ]; then
+    echo "❌ Erro: Arquivo não tem permissões de execução: $EXECUTABLE_PATH"
+    echo "💡 Execute: chmod +x $EXECUTABLE_PATH"
+    exit 1
+fi
+
+# Se não há argumentos ou é --help, mostra o help
+if [ $# -eq 0 ] || [[ "$*" == *"--help"* ]] || [[ "$*" == *"-h"* ]]; then
+    echo "
+🚀 Follow The Code CLI - Ferramenta de Análise de Repositórios Git
+
+📋 USO:
+    ftc <comando> [opções]
+
+📝 COMANDOS:
+    collect code <repo>    Analisa um repositório Git e coleta dados
+
+📊 OPÇÕES DE EXPORTAÇÃO:
+    --csv                 Exporta resultados em formato CSV
+    --json                Exporta resultados em formato JSON
+    --export <destino>    Define o destino da exportação
+
+🎯 DESTINOS DE EXPORTAÇÃO:
+    local:<caminho>       Salva arquivo local (ex: local:./output.csv)
+    s3:<bucket>/<key>     Envia para AWS S3 (ex: s3:meu-bucket/resultado.csv)
+
+📖 EXEMPLOS:
+    ftc collect code https://github.com/user/repo --csv --export local:./resultado.csv
+    ftc collect code https://github.com/user/repo --json --export s3:meu-bucket/analise.json
+    ftc collect code https://github.com/user/repo --csv
+
+🔧 OPÇÕES GLOBAIS:
+    --help, -h            Mostra esta ajuda
+    --version, -v         Mostra a versão
+
+🌍 PLATAFORMAS SUPORTADAS:
+    Windows (x64), macOS (x64), Linux (x64)
+
+📚 MAIS INFORMAÇÕES:
+    Visite: https://github.com/your-org/follow-the-code
+    "
+    exit 0
+fi
+
+# Executa o binário .NET
+cd "$(dirname "$EXECUTABLE_PATH")"
+exec "$EXECUTABLE_PATH" "$@" 

package/bin/ftc.js

@@ -4,6 +4,18 @@ const { spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
+// Verifica se o Node.js está disponível
+function checkNodeAvailability() {
+    try {
+        // Tenta executar node --version
+        const { execSync } = require('child_process');
+        execSync('node --version', { stdio: 'pipe' });
+        return true;
+    } catch (error) {
+        return false;
+    }
+}
+
 // Detecta a plataforma e arquitetura
 const platform = process.platform;
 const arch = process.arch;

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.1.10",
+  "version": "1.1.11",
   "description": "CLI tool for Git repository analysis and data collection",
   "main": "index.js",
   "license": "UNLICENSED",
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "bin": {
-    "ftc": "./bin/ftc.js"
+    "ftc": "./bin/ftc.js",
+    "ftc-linux": "./bin/ftc"
   },
   "scripts": {
     "prepublishOnly": "npm run build",
@@ -18,7 +19,7 @@
     "build:linux": "dotnet publish ftc.cli.csproj -c Release -r linux-x64 --self-contained true -o ./bin/linux-x64",
     "copy-config": "node scripts/copy-config.js",
     "set-permissions": "node scripts/set-permissions.js",
-    "postinstall": "node scripts/set-permissions.js",
+    "postinstall": "node scripts/set-permissions.js && node scripts/install-wrapper.js",
     "fix-permissions": "node scripts/fix-permissions.js",
     "test": "dotnet test",
     "test-permissions": "node scripts/test-permissions.js",
@@ -69,6 +70,7 @@
   ],
   "files": [
     "bin/ftc.js",
+    "bin/ftc",
     "bin/win-x64/ftc.cli.exe",
     "bin/win-x64/ftc.cli.dll",
     "bin/win-x64/ftc.cli.deps.json",
@@ -86,10 +88,12 @@
     "bin/linux-x64/*.dll",
     "scripts/set-permissions.js",
     "scripts/fix-permissions.js",
+    "scripts/install-wrapper.js",
     "README.md",
     "LICENSE",
     "TROUBLESHOOTING.md",
-    "TESTING.md"
+    "TESTING.md",
+    "NODEJS-TROUBLESHOOTING.md"
   ],
   "dependencies": {
     "@followthecode/cli": "^1.0.1",

package/scripts/install-wrapper.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🔧 Configurando wrapper do FTC CLI...');
+
+// Detecta a plataforma
+const platform = process.platform;
+const isWindows = platform === 'win32';
+
+// Verifica se o Node.js está disponível
+function checkNodeAvailability() {
+    try {
+        execSync('node --version', { stdio: 'pipe' });
+        return true;
+    } catch (error) {
+        return false;
+    }
+}
+
+// Caminhos dos wrappers
+const ftcJsPath = path.join(__dirname, '..', 'bin', 'ftc.js');
+const ftcShellPath = path.join(__dirname, '..', 'bin', 'ftc');
+
+// Verifica qual wrapper usar
+const nodeAvailable = checkNodeAvailability();
+const ftcJsExists = fs.existsSync(ftcJsPath);
+const ftcShellExists = fs.existsSync(ftcShellPath);
+
+console.log(`📋 Detecção de ambiente:`);
+console.log(`   Plataforma: ${platform}`);
+console.log(`   Node.js disponível: ${nodeAvailable ? '✅ Sim' : '❌ Não'}`);
+console.log(`   Wrapper Node.js: ${ftcJsExists ? '✅ Existe' : '❌ Não existe'}`);
+console.log(`   Wrapper Shell: ${ftcShellExists ? '✅ Existe' : '❌ Não existe'}`);
+
+// Recomenda o wrapper apropriado
+if (nodeAvailable && ftcJsExists) {
+    console.log('✅ Usando wrapper Node.js (ftc.js)');
+    console.log('💡 Execute: ftc --help');
+} else if (ftcShellExists) {
+    console.log('✅ Usando wrapper Shell (ftc)');
+    console.log('💡 Execute: ftc --help');
+    
+    if (!nodeAvailable) {
+        console.log('⚠️  Node.js não encontrado, usando wrapper shell como fallback');
+    }
+} else {
+    console.error('❌ Nenhum wrapper disponível!');
+    console.error('💡 Certifique-se de que o projeto foi compilado corretamente.');
+    process.exit(1);
+}
+
+// Define permissões para os wrappers
+if (ftcJsExists) {
+    try {
+        fs.chmodSync(ftcJsPath, 0o755);
+        console.log('✅ Permissões definidas para ftc.js');
+    } catch (error) {
+        console.warn('⚠️  Não foi possível definir permissões para ftc.js:', error.message);
+    }
+}
+
+if (ftcShellExists) {
+    try {
+        fs.chmodSync(ftcShellPath, 0o755);
+        console.log('✅ Permissões definidas para ftc (shell)');
+    } catch (error) {
+        console.warn('⚠️  Não foi possível definir permissões para ftc (shell):', error.message);
+    }
+}
+
+console.log('🎉 Configuração concluída!'); 

package/scripts/set-permissions.js

@@ -59,4 +59,26 @@ if (fs.existsSync(ftcJsPath)) {
     }
 }
 
+// Define permissões para o wrapper shell script
+const ftcShellPath = path.join('bin', 'ftc');
+if (fs.existsSync(ftcShellPath)) {
+    try {
+        if (isWindows) {
+            try {
+                fs.chmodSync(ftcShellPath, 0o755);
+                console.log(`✅ Permissões definidas para ${ftcShellPath} (Windows)`);
+            } catch (error) {
+                console.log(`✅ Arquivo preparado para ${ftcShellPath} (Windows - permissões não aplicáveis)`);
+            }
+        } else {
+            fs.chmodSync(ftcShellPath, 0o755);
+            console.log(`✅ Permissões definidas para ${ftcShellPath}`);
+        }
+    } catch (error) {
+        console.error(`❌ Erro ao definir permissões para ${ftcShellPath}:`, error.message);
+    }
+} else {
+    console.warn(`⚠️  Wrapper shell script não encontrado: ${ftcShellPath}`);
+}
+
 console.log('✅ Permissões de execução definidas com sucesso');