~/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.
- harness
- conformance
- semgrep
- dependabot
- ~/project/versatile-sh
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ça | O que conta |
|---|---|
| Dependabot | Um `dependabot.yml` com uma entrada por ecossistema presente, semanal, com minor e patch agrupados |
| Semgrep | Um 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 |
| lefthook | Pre-push roda o comando de check |
| Higiene | LICENSE em todos, SECURITY.md nos produtos, um README que passa no lint |
| go-lint | No check de todo repositório Go |
| Comando de check | Um `mise.toml` com a task check e nenhum Makefile com targets reais |
| Limpeza de branches | Delete-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
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.