Pitch: Kuuhaku, um mapa de como os seus repositórios conversam, com arquivo e linha de cada chamada
No meu trabalho temos uma dúzia de repositórios: dois front-ends, dois apps Flutter, várias APIs em Express e workers no RabbitMQ. Ninguém conseguia responder "quem chama o PUT /devices/:id?" sem dar grep em tudo, e o documento de arquitetura estava dois anos atrasado.
O Kuuhaku escaneia os repositórios com análise estática (tree-sitter e leitores por framework, nada de LLM no scanner), liga cada chamada HTTP à rota que ela atinge, encontra filas, gRPC, sockets e bancos compartilhados, e desenha o mapa. Cada conexão traz a sua evidência: o arquivo e a linha dos dois lados, e se veio da configuração, de inferência ou da decisão de uma pessoa. Nada de porcentagem de confiança.
Como foi feito
- Sem LLM no scanner. O mesmo código gera sempre o mesmo mapa, e cada seta aponta para a linha que a justifica. O que a análise não consegue decidir vai para uma caixa de revisão, em vez de virar um palpite desenhado.
- A parte difícil é ligar a chamada à rota. Em
axios.get(`${API_URL}/devices/${id}`)a URL base vem de um.env, de umdocker-compose.ymlou de um proxy na frente. O scanner segue a URL base por esses arquivos até achar o serviço, e só então casa o caminho com as rotas dele. - Qualidade medida, não chutada. Montei um benchmark com 40 sistemas públicos e gabaritos conferidos à mão. Toda mudança no scanner roda contra ele, e uma mudança que baixa a nota não entra. Um sistema novo é medido antes de qualquer correção: na primeira medição de 14 sistemas novos o recall foi de 67%. As correções que eles pediram são sempre regras gerais, nunca um caso de um repositório só, e hoje o F1 das conexões está em 97% nos 40.
- Stack: CLI em Node com ast-grep, front em Next.js, API em Express com MongoDB, tudo num VPS só com Docker Compose e Caddy.
O que dá pra fazer
- Mapa, uma página por repositório e uma caixa de revisão para o que o scanner não resolveu sozinho
- Checagem de pull request: "este PR remove
PUT /devices/:id, que o web chama emsrc/api.js:42" - Mapa de dados pessoais (útil pra LGPD), com revisão e assinatura de quem revisou
- Servidor MCP pra o seu assistente de código perguntar o que depende de uma rota antes de editar
- Exportação para Mermaid, C4 (Structurizr), Backstage,
architecture.yamle relatório em PDF
Dá pra ver sem cadastro em nove sistemas públicos. O demo do OpenTelemetry tem 23 serviços em 10 linguagens e 30 conexões, lidos sem nenhuma configuração; contra o gabarito, ele acha 27 das 28 conexões e não inventa nenhuma:
https://app.kuuhaku.dev/explore/otel_demo?utm_source=tabnews&utm_medium=community&utm_campaign=launch
A CLI (npx kuuhaku scan) roda na sua máquina; só o grafo sai dela.
Está em acesso antecipado grátis até 14/11. Quero muito feedback, principalmente onde ele erra a sua stack.
https://kuuhaku.dev/pt-br/?utm_source=tabnews&utm_medium=community&utm_campaign=launch