~/daily/work 2026-11-20 · published 2026-11-21
Una deny list que nadie tiene que escribir
Los repositorios compartidos nunca deben contener nombres de otros proyectos. La lista de nombres sale de los checkouts que ya tienes en la máquina, así que no hay nada que rellenar a mano.
- harness
- neutrality
- python
- git
- ~/project/versatile-sh
Una regla que depende de una lista
Un repositorio de equipo que mañana debe poder ser público no puede contener el nombre de un empleador, de un cliente ni del otro proyecto de alguien. La protección obvia es una deny list. El problema obvio es que la propia lista es una lista de esos nombres. Commitearla anula el propósito.
El harness ya tenía la forma de una respuesta. `bin/harness_deny.py` combina tres fuentes, de la más fuerte a la más débil: patrones genéricos, nombres con hash y una lista personal que queda fuera de git. El pull request #174, del 2026-11-20, hizo que la tercera fuente se genere sola.
Tres capas
| Capa | Dónde vive | Qué detecta |
|---|---|---|
| Patrones genéricos | En el script, versionados | Rutas de home personales, direcciones de e-mail, direcciones IP, tokens, claves privadas, referencias a secret stores, trailers de atribución, la forma de un documento fiscal |
| Nombres con hash | Un archivo versionado con digests SHA-256 de palabras en minúsculas | Un nombre bloqueado para todos, sin que el nombre esté escrito en ningún lugar |
| Lista personal | Un archivo en el directorio de configuración del usuario, nunca commiteado | Una expresión regular por línea, sin distinguir mayúsculas: los nombres reales de esta máquina |
Un repositorio puede llevar un archivo allow con una excepción por línea, con un glob de ruta y un motivo. Los mismos patrones los comparten `bin/check`, `bin/harvest` y el validador que un repositorio pasa antes de hacerse público.
De dónde sale la lista personal
`bin/harness_scan.py` recorre los checkouts git bajo la carpeta Versatile. Un checkout es nuestro si su origin es un repositorio de `versatile-sh`. Todo lo demás, otra organización o ningún remote, se lista en un `local/repos.md` ignorado. El owner y los nombres distintivos de repositorio de esos remotes pasan a ser un bloque gestionado dentro de la lista personal.
Las palabras genéricas no pueden convertirse en patrones de bloqueo, o cada doc que mencione un servidor quedaría bloqueado. El scanner lleva una stoplist de palabras comunes de repositorio (app, api, docs, backend, platform, agent y 137 palabras en total) y las descarta.
- `bin/install` y `bin/sync` ejecutan el scan, así que un checkout nuevo entra en la lista en el siguiente sync.
- El bloque está marcado como generado y gestionado. Las líneas propias de la persona fuera del bloque se conservan.
- `local/repos.md` tiene una sección llamada Extra para todo lo que el scan no puede ver.
Límites
Solo conoce lo que hay en esta máquina. Un cliente que no existe en ningún checkout no está en la lista, y un nombre que además es una palabra común puede escaparse de la stoplist o ser descartado por ella. Por eso los patrones genéricos y el sanitizer de harvest siguen por encima.
No medí falsos positivos ni omisiones. Un harvest que retiene archivos que no debería, o uno que deja pasar un nombre, sería la primera evidencia, y todavía no hay ninguna registrada.