Pular para o conteúdo
Build log · ● williandsantos.com

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.

Projeto: williandsantos.comWillian D. Santos3 min de leitura
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 repositories nos 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.

Ver o projeto williandsantos.com →