chimera-run-the-projects-own-gate-command

Estás a punto de ejecutar la compuerta de calidad del proyecto — lint, verificación de tipos, pruebas — y de reportar el resultado como evidencia de que un cambio es seguro. La tentación es estrecharla («solo toqué chimera/») o apretarla («--strict seguro que es mejor»).

No aplica a la exploración. Ejecutar pytest tests/test_governed_surfaces.py -x mientras iteras sobre un archivo es lo correcto; la regla trata de a qué puedes llamar la compuerta. Una ejecución estrechada es una ayuda de depuración, nunca la verificación.

1. Encuentra dónde está escrito el comando, y nombra UNA fuente como canónica. En Chimera ese es el target check del Makefile — make check — porque un target es ejecutable y una línea en prosa es una copia de uno. Las tres comprobaciones que ejecuta son ruff check ., mypy chimera y pytest -q.
2. Ejecuta la forma canónica byte por byte. Sin argumento de ruta añadido, sin flag añadido, sin runner sustituido. Ten en cuenta que una copia en prosa puede diferir de maneras que parecen cosméticas y no lo son: Makefile:21 lo envuelve como uv run --no-sync, CONTRIBUTING.md:105 como uv run --extra dev --extra desktop. La misma herramienta, entornos distintos — que es exactamente por qué una de las dos tiene que ser la fuente.
3. Si dos fuentes discrepan, trata el workflow de CI como autoritativo, ejecuta ese, y corrige el documento desactualizado en el mismo PR — CONTRIBUTING.md cargó una línea mypy --strict equivocada durante un tiempo, y una instrucción desactualizada se propaga a todo el que la lea.
4. Si el comando canónico no puede ejecutarse en tu entorno, di que la compuerta no se ejecutó. En Windows el .venv local está roto (litellm quiere Rust/MSVC), así que la compuerta corre en WSL — mover el shell está permitido, editar el comando no.
5. Reporta el comando y su salida literalmente, no un resumen de cómo fue.

El comando canónico suele ser el más lento, y una regla que prohíbe la variante rápida empuja hacia no ejecutar nada en absoluto. Eso es peor resultado que una ejecución estrechada etiquetada con honestidad.

Mide el costo antes de decidir que la regla es barata, y vuelve a medirlo a medida que la suite crece. El primer borrador de esta tarjeta decía que la suite completa de Chimera tardaba «unos quince segundos» — un número que fue cierto una vez y que ya había derivado a unos 100 segundos en cuatro ejecuciones medidas para cuando se escribió la tarjeta. Una tarjeta sobre no improvisar comandos es mal sitio para publicar una cifra que no sobrevive a ejecutar el comando.

Y la receta misma puede estar equivocada. Seguirla literalmente significa heredar sus puntos ciegos: make check no te dirá que una prueba lee un bench/local_lift/results/paired.json ignorado por git que un clon nuevo no tiene. El arreglo para una compuerta mala es cambiar la receta en un PR, no ejecutar calladamente una mejor en privado — una mejora privada protege exactamente a una persona y deja a CI, y a todos los demás, con el comando viejo.