AI CodeOps

Control de calidad (quality gate)

Última actualización

Un control de calidad es una comprobación de superado o no superado que un cambio debe pasar antes de avanzar. Qué comprueba, por qué importa con el código de IA y cómo lo aplica AI CodeOps.

Un control de calidad es un punto de control automatizado, de superado o no superado, que un cambio de código debe pasar antes de avanzar a la siguiente etapa, como convertirse en un pull request, fusionarse o desplegarse. El control convierte varias señales (pruebas, resultados de revisión, aprobaciones) en una sola decisión.

Qué es

Un control tiene un conjunto de condiciones y un veredicto. Las condiciones típicas son «las pruebas pasan», «no hay problemas críticos abiertos» y «un revisor lo aprobó». Si alguna condición falla, el cambio se detiene y el control dice por qué. Los controles suelen situarse en una transición: antes de fusionar, antes de publicar, antes de producción.

Los buenos controles son explícitos sobre lo que no saben. Una revisión que nunca se ejecutó no es una revisión limpia, y un resultado que falta no debería contar como superado.

Por qué importa

Los agentes de IA pueden escribir cambios más deprisa de lo que las personas pueden leerlos. Un control mantiene el mismo listón para todos los cambios, los escriba quien los escriba (o lo que los escriba), y registra por qué se retuvo un cambio. Sin uno, lo único que hay entre el código generado y tu rama principal es la atención de alguien en un día de mucho trabajo.

En AI CodeOps

Cada sesión de IA termina con un diff. Antes de que pueda convertirse en un pull request, AI CodeOps comprueba, en orden:

  1. La política del espacio de trabajo: un deny lo detiene; un ask necesita una revisión aprobada.
  2. La aprobación: una aprobación pendiente o rechazada lo detiene.
  3. El propio control de calidad: las pruebas no fallaron en la versión actual, la revisión de hallazgos de la IA se completó y ningún hallazgo high o critical sigue en estado open, acknowledged o in progress.

El panel Quality gates de la página de la ejecución muestra Release-ready o Not release-ready, con los motivos. El mismo control se vuelve a ejecutar antes de que la consola fusione un pull request que abrió una sesión.

Tu CI puede hacer la misma pregunta para cualquier pull request o commit:

curl -s -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pullRequestURL":"https://github.com/acme/api/pull/42","blockingSeverity":"medium"}'

Una respuesta denegada, recortada:

{
  "allowed": false,
  "summary": "HIGH security: Coupon code is passed to the pricing query without validation",
  "reasons": ["HIGH security: Coupon code is passed to the pricing query without validation"],
  "testFailures": [],
  "coverageShortfall": null
}

El endpoint responde HTTP 200 en ambos casos, así que un paso de CI debe leer allowed. Si ninguna sesión tocó el cambio, se deniega: el control no tiene nada que juzgar. La comprobación de CI también puede imponer un mínimo de cobertura, una política de licencias, flujos de trabajo obligatorios y un despliegue previo. La lista completa de campos está en la referencia de la API.

Preguntas frecuentes

¿Un control de calidad es lo mismo que una comprobación de CI?

Una comprobación de CI es una señal. Un control de calidad es la decisión construida sobre varias señales, como las pruebas, los hallazgos de revisión y las aprobaciones, que dice si el cambio puede avanzar.

¿Qué pasa en AI CodeOps si el propio control da error?

El cambio se rechaza. El control falla en cerrado (fail closed), así que un error durante la comprobación nunca deja pasar un cambio.

¿Puede mi pipeline de CI pedir un veredicto al control de AI CodeOps?

Sí. POST /api/release/check con una clave de API del espacio de trabajo y una URL de pull request o un SHA de commit devuelve allowed true o false con los motivos.