BuildSight Collector

CLI para coletar commits e métricas de repositórios locais e enviar para a API do BuildSight.

Instalação

Instalar globalmente:

npm install -g buildsight-collector

Ou usar diretamente com npx (sem instalar):

npx buildsight-collector <token>

Comandos

Coletar e enviar dados

Executa a coleta dos repositórios configurados e envia os commits para o BuildSight.

npx buildsight-collector <token>

Configurar repositórios

Abre o assistente interativo para selecionar quais repositórios locais serão monitorados.

npx buildsight-collector config-repos <token>

Dry-run (testar sem gravar)

Executa toda a pipeline de coleta e validação, mas não grava nenhum dado em produção. Útil para verificar o funcionamento antes de subir uma atualização.

npx buildsight-collector <token> --dry-run

O dry-run realiza as mesmas etapas da coleta normal — autenticação, leitura do git, normalização dos commits — e consulta o banco de dados para checar duplicatas, mas não escreve nada. Ao final, exibe um relatório:

🧪 Modo Dry-Run — nenhum dado será gravado em produção.

📂 Testando repositório: meu-projeto
   Período: últimos 7 dia(s) (desde 14/02/2026)

   Amostra de commits que seriam inseridos:
   • [a1b2c3d] João Silva — fix: corrige validação do formulário
   • [e4f5g6h] Maria Santos — feat: adiciona exportação CSV

   📊 Resultado para meu-projeto:
      Commits coletados localmente : 50
      Commits válidos              : 48
      Já existem no banco          : 10
      Seriam inseridos             : 38
      Branches detectadas          : 4
      Arquivos com métricas        : 120

✅ Dry-run concluído. Nenhum dado foi gravado.

Autenticar com GitHub, GitLab ou Azure DevOps

Conecta o collector ao seu provedor de Git para coletar métricas de Pull Requests. Usa o fluxo OAuth Device Flow — nenhuma senha é armazenada localmente.

npx buildsight-collector auth github
npx buildsight-collector auth gitlab
npx buildsight-collector auth azure

O comando exibe um código e uma URL. Acesse a URL, insira o código e o collector salvará o token automaticamente em ~/.buildsight/credentials.json.

Ver status das conexões

Exibe quais providers estão autenticados e quando foi feita a última autenticação.

npx buildsight-collector auth status

Exemplo de saída:

  Status das conexões BuildSight:

  ✓ github   autenticado em 14/03/2026, 10:23:45
  ○ gitlab   não conectado
  ○ azure    não conectado

Desconectar um provider

Remove as credenciais locais do provider especificado.

npx buildsight-collector auth logout github
npx buildsight-collector auth logout gitlab
npx buildsight-collector auth logout azure

Parâmetros

| Parâmetro | Descrição | |-----------------------------------|--------------------------------------------------------------| | <token> | Token de autenticação gerado pelo BuildSight | | --dry-run | Simula a coleta sem gravar nada no banco de dados | | auth <github\|gitlab\|azure> | Autentica com o provider para coletar métricas de PRs | | auth status | Exibe o status de todas as conexões de providers | | auth logout <provider> | Remove as credenciais locais do provider especificado |

Requisitos

• Node.js 14+