Pruebas de contrato en CI

Cada control responde a algo distinto. El linter pregunta si el contrato cumple las reglas del equipo. La comparación entre versiones pregunta qué cambió respecto a la anterior y si ese cambio rompe a quienes ya consumen la API. Las pruebas de contrato pregunta si el servicio real responde como dice el contrato (códigos, campos, tipos).

Ninguno sustituye a los otros: el linter no ve la API, la comparación no ve su comportamiento y las pruebas no ven las reglas del equipo.

En un pipeline, un trabajo con allow_failure: true puede fallar sin detener nada: el resultado queda como «advertencia» y nadie lo mira si no hay una política que lo exija. A veces es legítimo para un control que se está introduciendo; sin fecha para volverlo bloqueante es un control decorativo.

Lee el pipeline del repositorio y busca el trabajo que puede fallar sin frenar el cambio.

La comparación entre versiones clasifica cada cambio. Un cambio incompatible rompe a quien ya integró la API: se elimina una operación, se añade un parámetro obligatorio, cambia el tipo de un campo. Se publican con una versión mayor nueva o con un aviso a los consumidores, no por sorpresa.

La salida de este laboratorio está escrita a mano: no es de ninguna herramienta real, pero sigue la forma de las que sí existen.

Quitar un requisito de seguridad a una operación no rompe a ningún consumidor: todos siguen funcionando, y por eso una comparación de compatibilidad lo clasifica como compatible. Es un cambio de seguridad grave que ese tipo de control no sabe valorar. La revisión humana, o una regla específica que alerte de cualquier requisito eliminado, debe cubrir esa mirada.

Lee la comparación y busca el cambio que quita el requisito de seguridad.

El pipeline del repositorio solo se dispara con main, es decir, después de fusionar. Un control que corre tras la fusión avisa cuando el cambio ya está en la rama principal y quizá ya desplegado. Para frenar de verdad, los controles corren en la solicitud de fusión y su resultado es condición para fusionar.