Bumblebee Security Scan

Bumblebee (https://github.com/perplexityai/bumblebee) é um coletor de inventário somente leitura que exibe metadados de pacotes, extensões e ferramentas de desenvolvedor em endpoints de desenvolvedores. Ele responde a uma pergunta focada sobre a cadeia de suprimentos: quando um aviso nomeia um pacote ou versão, existem correspondências nesta máquina agora?

Esta habilidade executa uma única varredura Bumblebee do início ao fim:

1. Verifique se o Go está no PATH (forneça orientação de instalação, se não estiver).
2. Verifique ou instale o binário bumblebee.
3. Execute o perfil de varredura solicitado (baseline, project ou deep).
4. Salve a saída NDJSON bruta mais um relatório Markdown no espaço de trabalho do usuário.
5. Resuma as descobertas — especialmente as correspondências do catálogo de exposição — na resposta do chat.

Comunique-se com o usuário no idioma que ele usou (alemão para Stefan). Código, mensagens de commit e conteúdo de arquivos no disco permanecem em inglês para corresponder às convenções existentes do projeto.

Quando Usar Esta Habilidade

Use esta habilidade quando um aviso, relatório de incidente ou catálogo de exposição nomear pacotes comprometidos, ferramentas de desenvolvedor, extensões de navegador/editor ou configuração de host MCP que possam existir em um endpoint de desenvolvedor local macOS ou Linux.

Use-o para inventário somente leitura e verificações de exposição. Não o use para corrigir, desinstalar, colocar em quarentena ou de outra forma mutar a máquina escaneada.

Passo 1 — Clarificar a solicitação de varredura

Antes de executar qualquer coisa, confirme duas coisas com o usuário via AskUserQuestion, a menos que a mensagem já os defina:

• Perfil: baseline (raízes de pacotes globais), project (pastas de desenvolvimento específicas como ~/code) ou deep (caminhos explícitos de --root, incluindo $HOME para resposta a incidentes).
• Raízes: Para os perfis project e deep, pergunte quais diretórios escanear. deep é o único perfil que aceita uma raiz de "home" simples.

Se o usuário tiver um arquivo de aviso ou catálogo de exposição pronto, pergunte também se ele deseja passá-lo via --exposure-catalog. A habilidade não envia seus próprios catálogos — aponte-os para threat_intel/ no repositório Bumblebee se eles perguntarem onde encontrar os prontos.

Pule as perguntas para solicitações de linha única como "lauf mal ne Baseline-Scan" — apenas execute um baseline.

Passo 2 — Verificar Go

Execute command -v go && go version no bash. Três resultados:

• Go ≥ 1.25 presente → continue.
• Go presente, mas < 1.25 → informe ao usuário a versão, explique que o Bumblebee precisa do Go 1.25+ e pare até que eles atualizem.
• Go ausente → não instale o Go automaticamente. Mostre instruções apropriadas para a plataforma e pare:
  • macOS: brew install go (ou baixe de https://go.dev/dl/).
  • Debian/Ubuntu: prefira o tarball oficial de https://go.dev/dl/ porque os repositórios da distribuição demoram; sudo apt install golang-go apenas como fallback.
  • Fedora/RHEL: sudo dnf install golang ou o tarball oficial.

Após a instalação, o usuário deve garantir que $GOBIN (ou $HOME/go/bin) esteja no $PATH para que bumblebee seja encontrado mais tarde.

Passo 3 — Verificar ou instalar Bumblebee

Execute command -v bumblebee && bumblebee version. Se ausente:

go install github.com/perplexityai/bumblebee/cmd/bumblebee@latest

Em seguida, verifique novamente bumblebee version. Se o binário ainda não puder ser localizado, a configuração GOBIN/PATH do usuário provavelmente está incorreta — exiba o go env GOPATH e o go env GOBIN resolvidos para que eles possam corrigi-lo. Não recorra à execução do binário por caminho absoluto silenciosamente; explique o que está acontecendo.

Uma vez instalado, execute também bumblebee selftest como uma verificação de sanidade. Uma saída diferente de zero significa que a instalação local está quebrada e a varredura não deve prosseguir.

Passo 4 — Executar a varredura

Todas as varreduras gravam NDJSON em um arquivo. Use a pasta de espaço de trabalho para saída para que o usuário possa abrir os resultados depois.

Nomes de arquivos de saída (use o caminho do espaço de trabalho do usuário; o exemplo abaixo assume que $OUT está definido):

• bumblebee-<profile>-<UTC-timestamp>.ndjson — registros brutos.
• bumblebee-<profile>-<UTC-timestamp>.report.md — relatório Markdown (gerado na Etapa 5).

Escolha um --max-duration sensato para que uma varredura descontrolada não trave a sessão. Padrões razoáveis:

• baseline: 5m
• project: 10m
• deep: 15m (avise o usuário que escanear $HOME ainda pode levar mais tempo; ofereça-se para aumentar o limite)

Sempre transmita stderr para um arquivo .log irmão — o Bumblebee emite NDJSON de diagnóstico lá que ajuda a explicar varreduras parciais.

Baseline

bumblebee scan --profile baseline \
  --max-duration 5m \
  > "$OUT/bumblebee-baseline-$TS.ndjson" \
  2> "$OUT/bumblebee-baseline-$TS.log"

…