@followthecode/cli 1.2.40 → 1.2.43

package/README.md

@@ -52,7 +52,7 @@ docker run --rm -v "%cd%:/repo" ftc:latest collect code "/repo/meu-repo" --json
 Você não precisa mapear volumes para repositórios remotos:
 
 ```sh
-docker run --rm ftc:latest collect code "https://github.com/usuario/repositorio.git" --json
+docker run --rm ftc:latest collect code "https://github.com/exemplo/repositorio.git" --json
 ```
 
 ### 4. Exemplo com filtros de data
@@ -69,7 +69,7 @@ docker run --rm ftc:latest --help
 
 > **Resumo:**
 > - Sempre use `-v "$PWD:/repo"` (Linux/macOS) ou `-v "%cd%:/repo"` (Windows) para acessar repositórios locais.
-> - O caminho passado para `code` deve ser o caminho dentro do container, por exemplo, `"/repo/meu-repo"`.
+> - O caminho passado para `collect code` deve ser o caminho dentro do container, por exemplo, `"/repo/meu-repo"`.
 > - Para repositórios remotos, basta passar a URL.
 
 ## Uso moderno via Docker CLI
@@ -88,7 +88,7 @@ docker run --rm -v "%cd%:/repo" ftc:latest collect code "/repo/meu-repo" --json
 
 ### Repositório remoto
 ```sh
-docker run --rm ftc:latest collect code "https://github.com/usuario/repositorio.git" --json
+docker run --rm ftc:latest collect code "https://github.com/exemplo/repositorio.git" --json
 ```
 
 ### Com filtros de data
@@ -107,7 +107,7 @@ Se você encontrar problemas durante a instalação do CLI, como:
 - Erros de permissão EPERM no Windows
 - Problemas de limpeza de cache
 
-Consulte o guia completo de troubleshooting: **[TROUBLESHOOTING_INSTALL.md](TROUBLESHOOTING_INSTALL.md)**
+Consulte a seção de troubleshooting abaixo.
 
 ### Solução Rápida para Windows
 
@@ -115,10 +115,10 @@ Execute o script de correção como Administrador:
 
 ```powershell
 # Abrir PowerShell como Administrador
-.\scripts\fix-windows-permissions.ps1
+.\scripts\fix-permissions.ps1
 
 # Ou com limpeza forçada
-.\scripts\fix-windows-permissions.ps1 -Force
+.\scripts\fix-permissions.ps1 -Force
 ```
 
 ## 🧪 Testando a Instalação
@@ -159,11 +159,11 @@ cd ..
 
 # Testar funcionalidades
 bin/ftc collect code ./test-repo --json
-bin/ftc collect code https://github.com/microsoft/vscode.git --json
+bin/ftc collect code https://github.com/exemplo/repositorio.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.
+Para mais detalhes, consulte a seção de testes abaixo.
+> - O comando `collect code "/repo/meu-repo"` deve apontar para o caminho dentro do container.
 
 ## Uso como ferramenta global (dotnet tool)
 
@@ -182,7 +182,7 @@ ftc collect code "./caminho/para/meu-repo" --json
 Exemplo com repositório remoto e filtros:
 
 ```sh
-ftc collect code "https://github.com/usuario/repositorio.git" --startDate 2024-01-01 --endDate 2024-12-31 --json
+ftc collect code "https://github.com/exemplo/repositorio.git" --startDate 2024-01-01 --endDate 2024-12-31 --json
 ```
 
 Para ajuda:
@@ -202,7 +202,7 @@ dotnet run -- collect code /caminho/para/repositorio
 
 #### Análise de repositório remoto
 ```bash
-dotnet run -- collect code https://github.com/usuario/repositorio.git
+dotnet run -- collect code https://github.com/exemplo/repositorio.git
 ```
 
 #### Com filtros de data
@@ -239,19 +239,19 @@ scripts\docker-run.bat collect code C:\caminho\para\repositorio
 #### Análise de repositório remoto
 ```bash
 # Linux/macOS
-./scripts/docker-run.sh collect code https://github.com/usuario/repositorio.git
+./scripts/docker-run.sh collect code https://github.com/exemplo/repositorio.git
 
 # Windows
-scripts\docker-run.bat collect code https://github.com/usuario/repositorio.git
+scripts\docker-run.bat collect code https://github.com/exemplo/repositorio.git
 ```
 
 #### Com filtros e JSON
 ```bash
 # Linux/macOS
-./scripts/docker-run.sh collect code /caminho/para/repositorio --startDate 2024-01-01 --json
+./scripts/docker-run.sh code /caminho/para/repositorio --startDate 2024-01-01 --json
 
 # Windows
-scripts\docker-run.bat collect code C:\caminho\para\repositorio --startDate 2024-01-01 --json
+scripts\docker-run.bat code C:\caminho\para\repositorio --startDate 2024-01-01 --json
 ```
 
 #### Opções do Docker Runner
@@ -295,27 +295,27 @@ docker run --rm -v $(pwd)/repos:/repos:ro ftc:latest collect code /repos/meu-pro
 - Caminhos relativos: `./repositorio`, `../repositorio`
 
 ### Remotos
-- HTTPS: `https://github.com/usuario/repositorio.git`
-- HTTP: `http://github.com/usuario/repositorio.git`
-- SSH: `git@github.com/usuario/repositorio.git`
-- Git: `git://github.com/usuario/repositorio.git`
+- HTTPS: `https://github.com/exemplo/repositorio.git`
+- HTTP: `http://github.com/exemplo/repositorio.git`
+- SSH: `git@github.com/exemplo/repositorio.git`
+- Git: `git://github.com/exemplo/repositorio.git`
 
 ## Exemplo de Saída
 
 ### Formato padrão
 ```
-Analisando repositório: https://github.com/usuario/repositorio.git
+Analisando repositório: https://github.com/exemplo/repositorio.git
 Tipo: Remoto
-Clonando repositório: https://github.com/usuario/repositorio.git
-Pasta temporária: C:\Users\usuario\AppData\Local\Temp\ftc-cli-12345678-1234-1234-1234-123456789abc
+Clonando repositório: https://github.com/exemplo/repositorio.git
+Pasta temporária: /tmp/ftc-cli-12345678-1234-1234-1234-123456789abc
 Repositório clonado com sucesso.
 
 📊 Total de commits: 150
 
 👥 Autores:
-  • João Silva <joao@exemplo.com>: 45 commits
-  • Maria Santos <maria@exemplo.com>: 38 commits
-  • Pedro Oliveira <pedro@exemplo.com>: 27 commits
+  • Desenvolvedor A <dev.a@exemplo.com>: 45 commits
+  • Desenvolvedor B <dev.b@exemplo.com>: 38 commits
+  • Desenvolvedor C <dev.c@exemplo.com>: 27 commits
 
 📁 Total de arquivos alterados: 89
 📄 Arquivos alterados:
@@ -334,8 +334,8 @@ Repositório clonado com sucesso.
   "totalCommits": 150,
   "authors": [
     {
-      "name": "João Silva",
-      "email": "joao@exemplo.com",
+      "name": "Desenvolvedor A",
+      "email": "dev.a@exemplo.com",
       "commits": 45
     }
   ],
@@ -355,9 +355,9 @@ Repositório clonado com sucesso.
 ### Formato CSV
 ```csv
 nomeRepositorio;idRepositorio;dataCommit;idCommit;nomeAutor;emailAutor;nomeArquivo;caminhoArquivo;linhasAdicionadas;linhasRemovidas
-meu-repo;abc123;2024-01-15 10:30:00;def456;João Silva;joao@exemplo.com;Program.cs;src/Program.cs;120;45
-meu-repo;abc123;2024-01-15 10:30:00;def456;João Silva;joao@exemplo.com;Models.cs;src/Models.cs;89;12
-meu-repo;abc123;2024-01-16 14:20:00;ghi789;Maria Santos;maria@exemplo.com;README.md;README.md;15;3
+meu-repo;abc123;2024-01-15 10:30:00;def456;Desenvolvedor A;dev.a@exemplo.com;Program.cs;src/Program.cs;120;45
+meu-repo;abc123;2024-01-15 10:30:00;def456;Desenvolvedor A;dev.a@exemplo.com;Models.cs;src/Models.cs;89;12
+meu-repo;abc123;2024-01-16 14:20:00;ghi789;Desenvolvedor B;dev.b@exemplo.com;README.md;README.md;15;3
 ```
 
 O formato CSV inclui:
@@ -385,21 +385,7 @@ A CLI fornece mensagens de erro claras e específicas:
 
 ## Arquitetura
 
-O projeto segue a arquitetura Vertical Slice do FTC:
-
-```
-Features/
-└── AnalyzeRepository/
-    ├── Models.cs              # Request/Response records
-    └── AnalyzeRepositorySlice.cs  # Lógica de análise
-
-Common/
-└── RepositoryUtils.cs         # Utilitários para repositórios
-
-scripts/
-├── docker-run.sh             # Script Linux/macOS
-└── docker-run.bat            # Script Windows
-```
+O projeto segue a arquitetura Vertical Slice do FTC, organizando funcionalidades em slices independentes com suas próprias responsabilidades.
 
 ## Docker
 
@@ -408,9 +394,6 @@ scripts/
 Dockerfile                    # Multi-stage build otimizado
 .dockerignore                 # Exclusões para build
 docker-compose.yml            # Configuração do container
-scripts/
-├── docker-run.sh            # Script Linux/macOS
-└── docker-run.bat           # Script Windows
 ```
 
 ### Características da Imagem
@@ -418,11 +401,11 @@ scripts/
 - **Runtime .NET 8**: Imagem base leve
 - **Git instalado**: Suporte a repositórios remotos
 - **Volumes mapeados**: Acesso a repositórios locais
-- **Timezone configurado**: America/Sao_Paulo
+- **Timezone configurado**: UTC
 
 ### Volumes Docker
 - `./repos:/repos:ro`: Mapeia repositórios locais (somente leitura)
-- `./temp:/tmp/ftc-cli`: Pasta temporária para persistência
+- `./temp:/tmp`: Pasta temporária para persistência
 
 ## Testes
 
@@ -430,10 +413,10 @@ O projeto inclui testes automatizados para validação de funcionalidades:
 
 ```bash
 # Executar todos os testes
-dotnet test ../../ftc.cli.tests
+dotnet test
 
 # Executar testes específicos
-dotnet test ../../ftc.cli.tests --filter "IsRemoteRepository"
+dotnet test --filter "RepositoryTests"
 ```
 
 ### Cobertura de Testes
@@ -441,14 +424,6 @@ dotnet test ../../ftc.cli.tests --filter "IsRemoteRepository"
 - ✅ Validação de URLs HTTPS, HTTP, SSH, Git
 - ✅ Validação de caminhos locais e relativos
 
-## Dependências
-
-- **System.CommandLine**: Para parsing de argumentos da CLI
-- **LibGit2Sharp**: Para análise de repositórios Git
-- **System.Text.Json**: Para serialização JSON
-- **xUnit**: Para testes automatizados
-- **Docker**: Para containerização
-
 ## Desenvolvimento
 
 ### Compilar
@@ -473,19 +448,19 @@ scripts\docker-run.bat [argumentos]
 ### Testar
 ```bash
 # Testar com um repositório local
-dotnet run -- C:\caminho\para\repositorio
+dotnet run -- collect code C:\caminho\para\repositorio
 
 # Testar com repositório remoto
-dotnet run -- https://github.com/usuario/repositorio.git
+dotnet run -- collect code https://github.com/exemplo/repositorio.git
 
 # Testar com filtros
-dotnet run -- C:\caminho\para\repositorio --since 2024-01-01 --json
+dotnet run -- collect code C:\caminho\para\repositorio --startDate 2024-01-01 --endDate 2024-12-31 --json
 
 # Executar testes
-dotnet test ../../ftc.cli.tests
+dotnet test
 
 # Testar com Docker
-./scripts/docker-run.sh C:\caminho\para\repositorio
+./scripts/docker-run.sh collect code C:\caminho\para\repositorio
 ```
 
 ## Melhorias Implementadas
@@ -522,81 +497,35 @@ A CLI permite exportar o resultado da análise para um arquivo local ou diretame
 
 ### Exportar JSON localmente
 ```sh
-ftc code "./meu-repo" --json --export local:./resultado.json
+ftc collect code "./meu-repo" --json --export local:./resultado.json
 ```
 
 ### Exportar CSV localmente
 ```sh
-ftc code "./meu-repo" --csv --export local:./resultado.csv
+ftc collect code "./meu-repo" --csv --export local:./resultado.csv
 ```
 
 ### Exportar para S3 (JSON)
 ```sh
-ftc code "./meu-repo" --json --export s3
+ftc collect code "./meu-repo" --json --export s3
 ```
 
 ### Exportar para S3 (CSV)
 ```sh
-ftc code "./meu-repo" --csv --export s3
+ftc collect code "./meu-repo" --csv --export s3
 ```
 
 ### Exportar para S3 (bucket e key customizados)
 ```sh
-ftc code "./meu-repo" --csv --export s3: --s3-bucket "meu-bucket"
+ftc collect code "./meu-repo" --csv --export s3: --s3-bucket "meu-bucket"
 ```
 
 ### Exportar para S3 (bucket/key no próprio parâmetro)
 ```sh
-ftc code "./meu-repo" --csv --export s3://meu-bucket/analises/resultado.csv
+ftc collect 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`.
+- Se `--s3-bucket` não for informado, será usado o bucket padrão configurado.
 - 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. 
-
-## 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followthecode/cli",
-  "version": "1.2.40",
+  "version": "1.2.43",
   "description": "CLI tool for Git repository analysis and data collection",
   "main": "index.js",
   "license": "UNLICENSED",