@followthecode/cli 1.1.8 → 1.1.9

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/README.md

@@ -488,4 +488,50 @@ ftc code "./meu-repo" --csv --export s3://meu-bucket/analises/resultado.csv
 - Se `--s3-bucket` não for informado, será usado o bucket padrão `ftc-analyzer`.
 - Para JSON: Se `--s3-key` não for informado, será usado o padrão `analises/<nome_repositorio>-ano-mes-dia.json`.
 - Para CSV: Se `--s3-key` não for informado, será usado o padrão `analises/<nome_repositorio>-ano-mes-dia.csv`.
-- O parâmetro `--s3-region` pode ser usado para especificar a região AWS. 
+- O parâmetro `--s3-region` pode ser usado para especificar a região AWS. 
+
+## Exportação via API HTTP (x-apikey)
+
+Agora é possível exportar arquivos diretamente para uma API HTTP utilizando o header `x-apikey`.
+
+**Exemplo de configuração:**
+
+```
+api:https://sua-api.com/upload?apikey=SEU_API_KEY
+```
+
+- O arquivo será compactado (gzip) e enviado via POST para a URL informada.
+- O header `x-apikey` será preenchido automaticamente com o valor fornecido.
+- O header `x-provider` será enviado se especificado na URL.
+- O conteúdo enviado será do tipo `application/octet-stream` com encoding `gzip`.
+
+**Uso no código:**
+
+```csharp
+await ExportHelper.ExportDataAsync(
+    dados, 
+    "api:https://sua-api.com/upload?apikey=SEU_API_KEY",
+    repoPath,
+    serviceProvider,
+    ExportFormat.Json
+);
+``` 
+
+### Exemplo: Envio de arquivo compactado para o endpoint de commit-files
+
+```
+api:https://ftc-api.eximia.co/collect/commit-files?apikey=xpt-apikey&provider=Azure
+```
+
+- O arquivo será compactado (gzip) e enviado via POST.
+- Headers enviados: x-apikey, x-provider
+- Suporta CSV ou JSON.
+- Formato: application/octet-stream com encoding gzip
+
+### Exemplo: Consulta do last-sync via GET
+
+```csharp
+var client = new ApiKeyHttpGetClient(serviceProvider.GetRequiredService<IHttpClientFactory>(), "xpt-apikey");
+var lastSync = await client.GetLastSyncAsync("https://ftc-api.eximia.co/collect/repositories/repo01/last-sync");
+Console.WriteLine($"Última sincronização: {lastSync}");
+``` 

package/TESTING.md

@@ -0,0 +1,169 @@
+# 🧪 Guia de Testes - Follow The Code CLI
+
+## Testes de Permissões
+
+### 1. **Teste Básico de Permissões**
+```bash
+cd contexts/ftc.cli
+npm run test-permissions
+```
+
+Este comando verifica:
+- ✅ Permissões dos arquivos executáveis
+- ✅ Existência dos arquivos
+- ✅ Funcionamento dos scripts de correção
+
+### 2. **Teste Completo do Build**
+```bash
+npm run build
+```
+
+Verifica todo o processo:
+- 🔨 Compilação para todas as plataformas
+- 📋 Cópia de configurações
+- 🔐 Definição de permissões
+
+### 3. **Teste Individual dos Scripts**
+```bash
+# Teste de cópia de configuração
+npm run copy-config
+
+# Teste de definição de permissões
+npm run set-permissions
+
+# Teste de correção manual
+npm run fix-permissions
+```
+
+### 4. **Teste com Docker (Linux)**
+```bash
+# Requer Docker instalado
+npm run test-linux
+```
+
+Simula instalação em ambiente Linux limpo.
+
+## Verificação Manual
+
+### Verificar Permissões
+```bash
+# Linux/macOS
+ls -la bin/linux-x64/ftc.cli
+ls -la bin/osx-x64/ftc.cli
+ls -la bin/ftc.js
+
+# Deve mostrar: -rwxr-xr-x (755)
+```
+
+### Testar Execução
+```bash
+# Teste do CLI
+./bin/ftc.js --help
+
+# Deve mostrar a ajuda do CLI
+```
+
+## Teste de Publicação
+
+### 1. **Teste Local de Publicação**
+```bash
+# Simula publicação sem enviar para npm
+npm run build
+npm pack
+
+# Verifica o conteúdo do pacote
+tar -tzf followthecode-cli-*.tgz
+```
+
+### 2. **Teste de Instalação Local**
+```bash
+# Instala o pacote localmente
+npm install -g ./followthecode-cli-*.tgz
+
+# Testa a instalação
+ftc --help
+```
+
+## Cenários de Teste
+
+### ✅ **Cenário 1: Build Completo**
+1. Execute `npm run build`
+2. Verifique se todos os arquivos foram criados
+3. Verifique permissões com `npm run test-permissions`
+
+### ✅ **Cenário 2: Instalação Limpa**
+1. Delete a pasta `bin/`
+2. Execute `npm run build`
+3. Verifique se as permissões foram definidas
+
+### ✅ **Cenário 3: Correção Manual**
+1. Remova permissões: `chmod -x bin/linux-x64/ftc.cli`
+2. Execute `npm run fix-permissions`
+3. Verifique se as permissões foram restauradas
+
+### ✅ **Cenário 4: Teste Cross-Platform**
+1. Execute em Windows
+2. Execute em Linux (via Docker)
+3. Execute em macOS (se disponível)
+
+## Resultados Esperados
+
+### ✅ **Sucesso**
+```
+🧪 Testando permissões de execução...
+
+🔍 Verificando arquivos...
+
+📁 bin/ftc.js
+   Permissões: 755
+   Executável: ✅ Sim
+   Tamanho: 2048 bytes
+
+📁 bin/linux-x64/ftc.cli
+   Permissões: 755
+   Executável: ✅ Sim
+   Tamanho: 51200 bytes
+
+📊 Resultado do teste:
+✅ Todas as permissões estão corretas!
+```
+
+### ❌ **Falha**
+```
+📁 bin/linux-x64/ftc.cli
+   Permissões: 644
+   Executável: ❌ Não
+   Tamanho: 51200 bytes
+
+📊 Resultado do teste:
+❌ Algumas permissões precisam ser corrigidas
+💡 Execute: npm run fix-permissions
+```
+
+## Troubleshooting
+
+### Problema: "Script não encontrado"
+```bash
+# Verifique se os scripts existem
+ls -la scripts/
+```
+
+### Problema: "Permissão negada"
+```bash
+# No Linux/macOS
+chmod +x scripts/*.js
+chmod +x scripts/*.sh
+```
+
+### Problema: "Docker não encontrado"
+```bash
+# Instale Docker ou use apenas os testes Node.js
+npm run test-permissions
+```
+
+## Próximos Passos
+
+Após os testes:
+1. ✅ Se tudo passar: Pronto para publicação
+2. ❌ Se houver falhas: Corrija e teste novamente
+3. 🔄 Para publicação: `npm run publish:patch` 

package/TROUBLESHOOTING.md

@@ -0,0 +1,60 @@
+# 🔧 Troubleshooting - Follow The Code CLI
+
+## Problemas de Permissão no Linux
+
+### Sintoma
+Após instalar a CLI no Linux, você recebe um erro como:
+```
+bash: ./ftc.cli: Permission denied
+```
+
+### Solução Automática
+Execute o comando de correção de permissões:
+```bash
+npm run fix-permissions
+```
+
+### Solução Manual
+Se a solução automática não funcionar, execute manualmente:
+```bash
+chmod +x bin/linux-x64/ftc.cli
+chmod +x bin/ftc.js
+```
+
+### Verificação
+Para verificar se as permissões estão corretas:
+```bash
+ls -la bin/linux-x64/ftc.cli
+ls -la bin/ftc.js
+```
+
+As permissões devem aparecer como `-rwxr-xr-x` (755).
+
+## Outros Problemas Comuns
+
+### Erro: "Executável .NET não encontrado"
+Certifique-se de que o projeto foi compilado para todas as plataformas:
+```bash
+npm run build
+```
+
+### Erro: "Plataforma não suportada"
+A CLI suporta apenas:
+- Windows (x64)
+- macOS (x64) 
+- Linux (x64)
+
+### Problemas de Rede
+Se houver problemas de conectividade, verifique:
+- Configuração de proxy
+- Firewall
+- DNS
+
+## Logs de Debug
+Para obter mais informações sobre erros, execute:
+```bash
+ftc --help
+```
+
+## Suporte
+Se os problemas persistirem, abra uma issue no repositório do projeto. 

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;
@@ -75,6 +87,24 @@ if (!fs.existsSync(executablePath)) {
     process.exit(1);
 }
 
+// Verifica permissões de execução no Linux/macOS
+if (platform !== 'win32') {
+    try {
+        const stats = fs.statSync(executablePath);
+        const isExecutable = (stats.mode & fs.constants.S_IXUSR) !== 0;
+        
+        if (!isExecutable) {
+            console.error('❌ Erro: Arquivo não tem permissões de execução:', executablePath);
+            console.error('💡 Execute: npm run fix-permissions');
+            console.error('💡 Ou manualmente: chmod +x', executablePath);
+            process.exit(1);
+        }
+    } catch (error) {
+        console.error('❌ Erro ao verificar permissões:', error.message);
+        process.exit(1);
+    }
+}
+
 // Executa o binário .NET
 const executableDir = path.dirname(executablePath);
 const child = spawn(executablePath, args, {

package/bin/linux-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/linux-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/bin/osx-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/osx-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/bin/win-x64/appsettings.json

@@ -29,27 +29,7 @@
         "Args": {
           "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] [{ThreadId}] [{TraceId}/{SpanId}] {Message:lj}{NewLine}{Exception}"
         }
-      },
-      {
-        "Name": "OpenTelemetry",
-        "Args": {
-          "endpoint": "http://10.0.17.241:4317",
-          "protocol": "Grpc",
-          "timeout": 1000,
-          "batchSizeLimit": 10,
-          "period": 1
-        }
       }
     ]
-  },
-  "OpenTelemetry": {
-    "ServiceName": "ftc.cli",
-    "OtlpEndpoint": "http://10.0.17.241:4317"
-  },
-  "AWS": {
-    "Region": "us-east-1",
-    "S3": {
-      "BucketName": "ftc-analyzer"
-    }
   }
 } 

package/bin/win-x64/ftc.cli.deps.json

@@ -13,6 +13,7 @@
           "LibGit2Sharp": "0.27.0",
           "Microsoft.Extensions.Configuration.Binder": "9.0.0",
           "Microsoft.Extensions.Configuration.Json": "8.0.0",
+          "Microsoft.Extensions.Http": "8.0.0",
           "OpenTelemetry": "1.11.2",
           "OpenTelemetry.Exporter.OpenTelemetryProtocol": "1.11.2",
           "OpenTelemetry.Extensions.Hosting": "1.11.2",
@@ -910,6 +911,19 @@
           }
         }
       },
+      "Microsoft.Extensions.Diagnostics/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration": "9.0.0",
+          "Microsoft.Extensions.Diagnostics.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options.ConfigurationExtensions": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Diagnostics.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
@@ -970,6 +984,22 @@
           }
         }
       },
+      "Microsoft.Extensions.Http/8.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.Configuration.Abstractions": "9.0.0",
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Diagnostics": "8.0.0",
+          "Microsoft.Extensions.Logging": "9.0.0",
+          "Microsoft.Extensions.Logging.Abstractions": "9.0.0",
+          "Microsoft.Extensions.Options": "9.0.0"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.Http.dll": {
+            "assemblyVersion": "8.0.0.0",
+            "fileVersion": "8.0.23.53103"
+          }
+        }
+      },
       "Microsoft.Extensions.Logging/9.0.0": {
         "dependencies": {
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
@@ -1420,6 +1450,13 @@
       "path": "microsoft.extensions.dependencymodel/9.0.0",
       "hashPath": "microsoft.extensions.dependencymodel.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Diagnostics/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-3PZp/YSkIXrF7QK7PfC1bkyRYwqOHpWFad8Qx+4wkuumAeXo1NHaxpS9LboNA9OvNSAu+QOVlXbMyoY+pHSqcw==",
+      "path": "microsoft.extensions.diagnostics/8.0.0",
+      "hashPath": "microsoft.extensions.diagnostics.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Diagnostics.Abstractions/9.0.0": {
       "type": "package",
       "serviceable": true,
@@ -1455,6 +1492,13 @@
       "path": "microsoft.extensions.hosting.abstractions/9.0.0",
       "hashPath": "microsoft.extensions.hosting.abstractions.9.0.0.nupkg.sha512"
     },
+    "Microsoft.Extensions.Http/8.0.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-cWz4caHwvx0emoYe7NkHPxII/KkTI8R/LC9qdqJqnKv2poTJ4e2qqPGQqvRoQ5kaSA4FU5IV3qFAuLuOhoqULQ==",
+      "path": "microsoft.extensions.http/8.0.0",
+      "hashPath": "microsoft.extensions.http.8.0.0.nupkg.sha512"
+    },
     "Microsoft.Extensions.Logging/9.0.0": {
       "type": "package",
       "serviceable": true,

package/package.json

@@ -1,23 +1,35 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "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",
-    "build": "npm run build:win && npm run build:mac && npm run build:linux && npm run copy-config",
+    "build": "npm run build:win && npm run build:mac && npm run build:linux && npm run copy-config && npm run set-permissions",
     "build:win": "dotnet publish ftc.cli.csproj -c Release -r win-x64 --self-contained true -o ./bin/win-x64",
     "build:mac": "dotnet publish ftc.cli.csproj -c Release -r osx-x64 --self-contained true -o ./bin/osx-x64",
     "build:linux": "dotnet publish ftc.cli.csproj -c Release -r linux-x64 --self-contained true -o ./bin/linux-x64",
-    "copy-config": "copy appsettings.json bin\\win-x64\\ && copy appsettings.json bin\\osx-x64\\ && copy appsettings.json bin\\linux-x64\\",
+    "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",
     "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",
     "clean": "dotnet clean",
     "publish:patch": "node scripts/publish.js --patch",
     "publish:minor": "node scripts/publish.js --minor",
@@ -58,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",
@@ -73,8 +86,14 @@
     "bin/linux-x64/ftc.cli.deps.json",
     "bin/linux-x64/appsettings.json",
     "bin/linux-x64/*.dll",
+    "scripts/set-permissions.js",
+    "scripts/fix-permissions.js",
+    "scripts/install-wrapper.js",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "TROUBLESHOOTING.md",
+    "TESTING.md",
+    "NODEJS-TROUBLESHOOTING.md"
   ],
   "dependencies": {
     "@followthecode/cli": "^1.0.1",

package/scripts/fix-permissions.js

@@ -0,0 +1,58 @@
+#!/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'); 

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

@@ -0,0 +1,84 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🔐 Definindo permissões de execução...');
+
+// Detecta a plataforma
+const platform = process.platform;
+const isWindows = platform === 'win32';
+
+const platforms = [
+    { dir: 'linux-x64', executable: 'ftc.cli' },
+    { dir: 'osx-x64', executable: 'ftc.cli' }
+];
+
+platforms.forEach(platformConfig => {
+    const executablePath = path.join('bin', platformConfig.dir, platformConfig.executable);
+    
+    if (fs.existsSync(executablePath)) {
+        try {
+            if (isWindows) {
+                // No Windows, tenta definir permissões mesmo assim
+                try {
+                    fs.chmodSync(executablePath, 0o755);
+                    console.log(`✅ Permissões definidas para ${executablePath} (Windows)`);
+                } catch (error) {
+                    console.log(`✅ Arquivo preparado para ${executablePath} (Windows - permissões não aplicáveis)`);
+                }
+            } else {
+                // No Linux/macOS, define permissões reais
+                fs.chmodSync(executablePath, 0o755);
+                console.log(`✅ Permissões definidas para ${executablePath}`);
+            }
+        } catch (error) {
+            console.error(`❌ Erro ao definir permissões para ${executablePath}:`, error.message);
+        }
+    } else {
+        console.warn(`⚠️  Executável não encontrado: ${executablePath}`);
+    }
+});
+
+// Também define permissões para o arquivo ftc.js
+const ftcJsPath = path.join('bin', 'ftc.js');
+if (fs.existsSync(ftcJsPath)) {
+    try {
+        if (isWindows) {
+            try {
+                fs.chmodSync(ftcJsPath, 0o755);
+                console.log(`✅ Permissões definidas para ${ftcJsPath} (Windows)`);
+            } catch (error) {
+                console.log(`✅ Arquivo preparado para ${ftcJsPath} (Windows - permissões não aplicáveis)`);
+            }
+        } else {
+            fs.chmodSync(ftcJsPath, 0o755);
+            console.log(`✅ Permissões definidas para ${ftcJsPath}`);
+        }
+    } catch (error) {
+        console.error(`❌ Erro ao definir permissões para ${ftcJsPath}:`, error.message);
+    }
+}
+
+// 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');