@followthecode/cli 1.2.5 → 1.2.7

package/TESTING_INSTALLATION.md

@@ -0,0 +1,344 @@
+# 🧪 Guia de Teste de Instalação - FTC CLI
+
+Este guia explica como testar a instalação do FTC CLI antes de publicar uma nova versão.
+
+## 🎯 Objetivo
+
+Garantir que o CLI funcione corretamente em diferentes ambientes antes da publicação, evitando problemas para os usuários.
+
+## 📋 Pré-requisitos
+
+Antes de executar os testes, certifique-se de ter instalado:
+
+- **Node.js** (versão 14 ou superior)
+- **npm** (versão 6 ou superior)
+- **.NET 8 SDK**
+- **Docker** (opcional, para testes Docker)
+- **Git** (para clonar repositórios de teste)
+
+## 🚀 Testes Automatizados
+
+### Windows (PowerShell)
+
+```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
+
+# Teste pulando build (útil para testes rápidos)
+npm run test-installation:skip-build
+```
+
+### Linux/macOS (Bash)
+
+```bash
+# Teste básico
+npm run test:install:linux
+
+# Teste WSL
+npm run test:install:wsl
+```
+
+### Execução Direta dos Scripts
+
+#### Windows
+```powershell
+# Executar diretamente
+.\scripts\test-installation.ps1
+
+# Com parâmetros
+.\scripts\test-installation.ps1 -Clean -Verbose
+```
+
+#### Linux/macOS
+```bash
+# Tornar executável (se necessário)
+chmod +x scripts/test-installation.sh
+
+# Executar diretamente
+./scripts/test-installation.sh
+
+# Com parâmetros
+./scripts/test-installation.sh --clean
+```
+
+## 🧪 O que os Testes Verificam
+
+### 1. **Pré-requisitos**
+- ✅ Node.js instalado e funcionando
+- ✅ npm instalado e funcionando
+- ✅ .NET SDK instalado e funcionando
+
+### 2. **Build do Projeto**
+- ✅ Compilação em modo Release
+- ✅ Publicação para diferentes plataformas
+- ✅ Geração de binários executáveis
+
+### 3. **Package NPM**
+- ✅ package.json válido
+- ✅ Dependências instaladas
+- ✅ Scripts npm funcionando
+- ✅ Build para Windows/Linux/macOS
+
+### 4. **Instalação Local**
+- ✅ Binários criados corretamente
+- ✅ Wrapper Node.js funcionando
+- ✅ Executável .NET funcionando
+- ✅ Arquivos de configuração presentes
+
+### 5. **Instalação Global Simulada**
+- ✅ Instalação em diretório temporário
+- ✅ Binários instalados corretamente
+- ✅ CLI executável globalmente
+- ✅ Permissões configuradas
+
+### 6. **Docker**
+- ✅ Build da imagem Docker
+- ✅ Execução do container
+- ✅ CLI funcionando no Docker
+- ✅ Limpeza da imagem de teste
+
+### 7. **Funcionalidades Básicas**
+- ✅ Comando de ajuda funcionando
+- ✅ Análise de repositório (se disponível)
+- ✅ Tratamento de erros
+
+## 📊 Interpretando os Resultados
+
+### ✅ Todos os Testes Passaram
+```
+🎉 Todos os testes passaram! CLI está pronto para publicação.
+💡 Próximos passos:
+   1. npm version patch|minor|major
+   2. npm publish
+   3. git push --tags
+```
+
+### ❌ Alguns Testes Falharam
+```
+❌ Alguns testes falharam. Corrija os problemas antes de publicar.
+💡 Verifique os logs acima para identificar os problemas.
+```
+
+## 🔧 Solução de Problemas Comuns
+
+### Build Falhou
+```bash
+# Verificar versão do .NET
+dotnet --version
+
+# Limpar cache
+dotnet clean
+dotnet restore
+
+# Tentar build novamente
+dotnet build --configuration Release
+```
+
+### NPM Scripts Falharam
+```bash
+# Limpar node_modules
+rm -rf node_modules package-lock.json
+
+# Reinstalar dependências
+npm install
+
+# Verificar scripts
+npm run build:win
+```
+
+### Docker Falhou
+```bash
+# Verificar se Docker está rodando
+docker --version
+docker ps
+
+# Limpar imagens antigas
+docker system prune -f
+
+# Tentar build novamente
+docker build -t ftc:test .
+```
+
+### Permissões no Linux/macOS
+```bash
+# Definir permissões manualmente
+chmod +x bin/ftc
+chmod +x bin/linux-x64/ftc.cli
+
+# Verificar permissões
+ls -la bin/
+```
+
+## 🧪 Testes Manuais Adicionais
+
+### 1. **Teste com Repositório Real**
+
+Crie um repositório de teste:
+
+```bash
+# Criar repositório de teste
+mkdir test-repo
+cd test-repo
+git init
+echo "# Test Repository" > README.md
+git add README.md
+git commit -m "Initial commit"
+cd ..
+```
+
+Execute o CLI:
+
+```bash
+# Testar análise
+bin/ftc collect code ./test-repo --json
+
+# Testar com filtros
+bin/ftc collect code ./test-repo --startDate 2024-01-01 --json
+
+# Testar exportação
+bin/ftc collect code ./test-repo --csv --export local:./resultado.csv
+```
+
+### 2. **Teste com Repositório Remoto**
+
+```bash
+# Testar com GitHub
+bin/ftc collect code https://github.com/microsoft/vscode.git --json
+
+# Testar com filtros
+bin/ftc collect code https://github.com/microsoft/vscode.git --startDate 2024-01-01 --endDate 2024-12-31 --json
+```
+
+### 3. **Teste de Instalação Global Real**
+
+```bash
+# Instalar globalmente (em ambiente de teste)
+npm install -g .
+
+# Verificar instalação
+ftc --version
+ftc --help
+
+# Testar funcionalidade
+ftc collect code ./test-repo --json
+
+# Desinstalar
+npm uninstall -g @followthecode/cli
+```
+
+### 4. **Teste de Docker Real**
+
+```bash
+# Build da imagem
+docker build -t ftc:latest .
+
+# Testar com repositório local
+docker run --rm -v "$PWD:/repo" ftc:latest collect code "/repo/test-repo" --json
+
+# Testar com repositório remoto
+docker run --rm ftc:latest collect code "https://github.com/microsoft/vscode.git" --json
+```
+
+## 🔄 Workflow de Teste Completo
+
+### 1. **Preparação**
+```bash
+# Limpar builds anteriores
+npm run clean
+rm -rf bin/ node_modules/
+
+# Instalar dependências
+npm install
+```
+
+### 2. **Testes Automatizados**
+```bash
+# Windows
+npm run test-installation:clean
+
+# Linux/macOS
+npm run test-installation:linux:clean
+```
+
+### 3. **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 ./test-repo --csv
+bin/ftc collect code https://github.com/microsoft/vscode.git --json
+```
+
+### 4. **Teste de Instalação Global**
+```bash
+# Instalar globalmente
+npm install -g .
+
+# Testar
+ftc --version
+ftc collect code ./test-repo --json
+
+# Desinstalar
+npm uninstall -g @followthecode/cli
+```
+
+### 5. **Teste Docker**
+```bash
+# Build e teste
+docker build -t ftc:test .
+docker run --rm ftc:test --help
+docker run --rm -v "$PWD:/repo" ftc:test collect code "/repo/test-repo" --json
+docker rmi ftc:test
+```
+
+## 📝 Checklist de Publicação
+
+Antes de publicar, confirme que:
+
+- [ ] Todos os testes automatizados passaram
+- [ ] Testes manuais com repositório real funcionaram
+- [ ] Instalação global funciona corretamente
+- [ ] Docker build e execução funcionam
+- [ ] Versão no package.json foi atualizada
+- [ ] Changelog foi atualizado
+- [ ] Documentação está atualizada
+- [ ] Commits foram feitos e tags criadas
+
+## 🚨 Problemas Conhecidos
+
+### Windows
+- **Problema**: Scripts PowerShell podem ser bloqueados
+- **Solução**: Executar `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
+### Linux/macOS
+- **Problema**: Permissões de execução não definidas
+- **Solução**: Executar `chmod +x scripts/test-installation.sh`
+
+### Docker
+- **Problema**: Imagens antigas podem causar conflitos
+- **Solução**: Executar `docker system prune -f` antes dos testes
+
+## 📞 Suporte
+
+Se encontrar problemas durante os testes:
+
+1. **Verificar logs** detalhados com `-Verbose`
+2. **Executar testes individuais** para isolar problemas
+3. **Verificar pré-requisitos** e versões
+4. **Consultar troubleshooting** em `TROUBLESHOOTING_INSTALL.md`
+5. **Reportar issues** com logs completos
+
+---
+
+**💡 Dica**: Execute os testes em um ambiente limpo (máquina virtual ou container) para simular a experiência real do usuário. 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "CLI tool for Git repository analysis and data collection",
   "main": "index.js",
   "license": "UNLICENSED",
@@ -21,7 +21,7 @@
     "setup": "npm run copy-config && npm run set-permissions",
     "copy-config": "node scripts/copy-config.js",
     "set-permissions": "node scripts/set-permissions.js",
-    "postinstall": "npm run setup && node scripts/install-wrapper.js",
+    "postinstall": "node scripts/install-wrapper.js",
     "test": "dotnet test",
     "test:install": "npm run test:install:win",
     "test:install:win": "powershell -ExecutionPolicy Bypass -File scripts/test-simple.ps1",
@@ -76,14 +76,13 @@
     "bin/linux-x64/ftc.cli",
     "bin/linux-x64/appsettings.json",
     "bin/linux-x64/libgit2-c058aa8.so",
+    "scripts/copy-config.js",
     "scripts/set-permissions.js",
-    "scripts/fix-permissions.js",
     "scripts/install-wrapper.js",
+    "scripts/README.md",
     "README.md",
     "LICENSE",
-    "TROUBLESHOOTING.md",
-    "TROUBLESHOOTING_INSTALL.md",
-    "TESTING.md"
+    "TESTING_INSTALLATION.md"
   ],
   "dependencies": {
     "node-fetch": "^3.3.0"

package/scripts/copy-config.js

@@ -0,0 +1,33 @@
+const fs = require('fs');
+const path = require('path');
+
+console.log('📋 Copiando arquivo de configuração...');
+
+const configFile = 'appsettings.json';
+const platforms = ['win-x64', 'osx-x64', 'linux-x64'];
+
+// Verifica se o arquivo de configuração existe
+if (!fs.existsSync(configFile)) {
+    console.error(`❌ Arquivo de configuração não encontrado: ${configFile}`);
+    process.exit(1);
+}
+
+// Copia o arquivo para cada plataforma
+platforms.forEach(platform => {
+    const targetDir = path.join('bin', platform);
+    const targetFile = path.join(targetDir, configFile);
+    
+    // Cria o diretório se não existir
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    
+    try {
+        fs.copyFileSync(configFile, targetFile);
+        console.log(`✅ Copiado para ${targetFile}`);
+    } catch (error) {
+        console.error(`❌ Erro ao copiar para ${targetFile}:`, error.message);
+    }
+});
+
+console.log('✅ Arquivo de configuração copiado para todas as plataformas'); 

package/TESTING.md

@@ -1,169 +0,0 @@
-# 🧪 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

@@ -1,60 +0,0 @@
-# 🔧 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/TROUBLESHOOTING_INSTALL.md

@@ -1,212 +0,0 @@
-# 🔧 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
-```