@followthecode/cli 1.1.10 → 1.1.12

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;