Build log: o fluxo diário que lê os commits e publica sozinho
Um fluxo do n8n passou a ler os commits do dia, escrever o registro de build log e publicar sozinho quando o CI passa, sem eu revisar cada PR.
- commit
a3df05c(williandsantos.com)- Author:
- Willian D. Santos
- Date:
Build log: o fluxo diário que lê os commits e publica sozinho
registro 7 de 8 no ramo williandsantos.com
Contexto
Até aqui, o build log dependia de mim. No fim de uma sessão de trabalho eu lembrava de escrever o registro, e muita decisão ficava sem nada escrito. Os artigos diários já tinham um fluxo automático, mas o build log continuava manual. O risco era claro: o registro de decisões só funciona se for constante, e a constância dependia de memória.
O que mudou
Criei um workflow no n8n que roda todo dia às 7h e faz o seguinte:
- lê os commits do dia anterior nos repositórios dos projetos;
- ignora merges, commits de conteúdo, dependências e robôs;
- encerra antes de chamar o Claude quando não houve nada relevante, sem custo;
- quando houve decisão ou marco, pede ao Claude a triagem e o texto numa chamada só;
- confere slug, links, segredos e se o MDX é seguro;
- abre um PR com o registro e, com o CI verde, faz o merge.
Duas mudanças vieram junto. A lista de repositórios saiu do fluxo e foi para o campo repositories de cada projeto, que não aparece no site. Projeto novo entra sozinho no dia seguinte ao merge, e projeto arquivado deixa de ser lido, com os registros antigos preservados. E o token de leitura passou a ser um por dono, já que um token fine-grained só enxerga a conta ou a organização que o criou.
A decisão
A decisão mais pesada foi tirar a revisão. Num primeiro desenho, o merge do PR era a aprovação, como nos artigos diários. No mesmo dia mudei: o próprio fluxo faz o merge quando o CI passa. Escolhi isso para não acumular uma aprovação por dia na minha fila. Em troca, ficam as travas no código: conferência de slug, de links, de segredo e de MDX. Se o CI falhar, o PR fica aberto como está. Se eu quiser barrar um registro, fecho o PR antes do CI terminar.
O merge é feito pelo fluxo porque o GitHub gratuito não tem auto-merge em repositório privado.
Sobre a lista de repositórios: deixar dentro do fluxo me obrigaria a mexer no n8n a cada projeto novo. Colocar no cadastro do projeto faz a lista seguir a vida do projeto. Se um repositório não for acessível, a execução falha e diz qual, em vez de passar em silêncio.
Sobre os tokens: um único token não serve para repositórios de dono diferente. Por isso há uma variável por organização. Sem o token do dono, a execução diz qual variável falta e não chama o GitHub com o token errado. A validade dos tokens fica registrada em um arquivo, com aviso a partir de 30 dias antes do vencimento.
Por que importa
O build log deixa de depender da minha disciplina. Dia com decisão vira registro, dia sem decisão não custa nada e não gera ruído. Ao mesmo tempo, abro mão de ler o texto antes de ele ir ao ar. Estou aceitando esse risco de propósito, com as travas no lugar e a correção sempre possível: o registro é um arquivo, e editar ou apagar depois é simples.
Pendências e próximo passo
- Criar no n8n os tokens de leitura de cada dono e preencher a validade deles no arquivo de controle.
- Acompanhar as primeiras execuções reais para ver se o critério de decisão está calibrado e se o Claude não está forçando registro em dia fraco.
- Preencher
repositoriesnos projetos que ainda não têm o campo, como a Dark n Black, para eles entrarem no fluxo.
Registro escrito depois da decisão, a partir dos commits e da documentação do projeto.
