~/daily/work 2026-11-21

O piso que todo repositório tem

bin/conformance lista o que cada repositório da organização não tem de um baseline: Dependabot, Semgrep fixado por tag, lefthook, licença, lint de README, go-lint.

Um padrão que só um reviewer lembra

Um repositório novo recebe o baseline se quem o cria lembra dele inteiro. Senão, silenciosamente não recebe. O arquivo de regras do baseline diz sem rodeios: o piso é o mesmo em todo lugar, e uma máquina diz onde não é. O pull request #192 adicionou o `bin/conformance` em 2026-11-21.

O piso

PeçaO que conta
DependabotUm `dependabot.yml` com uma entrada por ecossistema presente, semanal, com minor e patch agrupados
SemgrepUm target no comando de check: packs do registry para as linguagens do repositório mais as regras compartilhadas carregadas por URL em um tag; repositórios sem código rodam só o pack de secrets
Formato do gate`--baseline-commit` no merge base com `origin/main`, de modo que uma branch falha só pelos achados que ela adiciona
lefthookPre-push roda o comando de check
HigieneLICENSE em todos, SECURITY.md nos produtos, um README que passa no lint
go-lintNo check de todo repositório Go
Comando de checkUm `mise.toml` com a task check e nenhum Makefile com targets reais
Limpeza de branchesDelete-branch-on-merge ligado

Dois detalhes de que gosto. As regras compartilhadas do Semgrep são referenciadas por URL de tag e nunca copiadas, então adotar uma regra nova é mudar uma linha. E o scan é local: pode existir um workflow para quando o CI voltar, mas nunca como único gate.

Como a ferramenta funciona

text
bin/conformance [--org <org>] [--only <repo>,...] [--json]
bin/conformance --summary [--cached <hours>]
bin/conformance --repo <dir> [--name <repo>]

Sem argumentos, ela lê todo repositório não arquivado pela API do GitHub, lendo a árvore de arquivos e os poucos arquivos de que precisa. Com `--repo`, verifica um checkout local sem a API, que é o que um repositório novo roda antes do primeiro merge. Sai com 1 enquanto faltar algo. Fixtures de testes, código vendored, templates e spikes de pesquisa são ignorados ao procurar ecossistemas, então o lockfile de um fixture não exige uma entrada do Dependabot.

`bin/sync` imprime o resumo de uma linha e o guarda em cache por 12 horas. Isso torna o piso visível toda manhã sem virar uma chateação.

O que eu não estou afirmando

No mesmo dia foi registrado o rollout do Semgrep para todo repositório não arquivado, e o baseline ganhou seu próprio arquivo de regras. Não rodei a ferramenta contra a organização inteira para este post, então não tenho uma contagem do que falta. Esse número é a primeira coisa que a ferramenta entrega, e merece o próprio post.

A série de pull requests também adicionou um layout de tasks do mise em #198 para que o check, o conformance e os lints compartilhem um único nome de comando. Mesma lição do resto do harness: uma única definição de verde.