~/daily/work 2026-11-21
El piso que todo repositorio tiene
bin/conformance lista lo que a cada repositorio de la organización le falta de un baseline: Dependabot, Semgrep fijado por tag, lefthook, licencia, lint de README, go-lint.
- harness
- conformance
- semgrep
- dependabot
- ~/project/versatile-sh
Un estándar que solo recuerda un reviewer
Un repositorio nuevo recibe el baseline si quien lo crea lo recuerda entero. Si no, silenciosamente no lo recibe. El archivo de reglas del baseline lo dice sin rodeos: el piso es el mismo en todas partes, y una máquina dice dónde no lo es. El pull request #192 añadió `bin/conformance` el 2026-11-21.
El piso
| Pieza | Qué cuenta |
|---|---|
| Dependabot | Un `dependabot.yml` con una entrada por ecosistema presente, semanal, con minor y patch agrupados |
| Semgrep | Un target en el comando de check: packs del registry para los lenguajes del repositorio más las reglas compartidas cargadas por URL en un tag; los repositorios sin código ejecutan solo el pack de secrets |
| Forma del gate | `--baseline-commit` sobre el merge base con `origin/main`, de modo que una rama falla solo por los hallazgos que añade |
| lefthook | Pre-push ejecuta el comando de check |
| Higiene | LICENSE en todos, SECURITY.md en los productos, un README que pasa el lint |
| go-lint | En el check de todo repositorio Go |
| Comando de check | Un `mise.toml` con la tarea check y ningún Makefile con targets reales |
| Limpieza de ramas | Delete-branch-on-merge activado |
Dos detalles que me gustan. Las reglas compartidas de Semgrep se referencian por URL de tag y nunca se copian, así que adoptar una regla nueva es cambiar una línea. Y el escaneo es local: puede existir un workflow para cuando vuelva el CI, pero nunca como único gate.
Cómo funciona la herramienta
bin/conformance [--org <org>] [--only <repo>,...] [--json]
bin/conformance --summary [--cached <hours>]
bin/conformance --repo <dir> [--name <repo>]Sin argumentos lee cada repositorio no archivado a través de la API de GitHub, leyendo el árbol de archivos y los pocos archivos que necesita. Con `--repo` revisa un checkout local sin la API, que es lo que ejecuta un repositorio nuevo antes de su primer merge. Sale con 1 mientras falte algo. Los fixtures de tests, el código vendored, las plantillas y los spikes de investigación se saltan al buscar ecosistemas, así que el lockfile de un fixture no exige una entrada de Dependabot.
`bin/sync` imprime el resumen de una línea y lo cachea durante 12 horas. Eso hace visible el piso cada mañana sin ser una molestia.
Lo que no afirmo
El mismo día se registró el despliegue de Semgrep para cada repositorio no archivado, y el baseline recibió su propio archivo de reglas. No ejecuté la herramienta contra toda la organización para este post, así que no tengo un conteo de lo que falta. Ese número es lo primero que da la herramienta, y merece su propio post.
La serie de pull requests también añadió un layout de tareas de mise en #198 para que el check, conformance y los lints compartan un mismo nombre de comando. La misma lección que el resto del harness: una sola definición de verde.