# Controles de calidad

> Cómo decide AI CodeOps si un cambio puede entregarse: los resultados de las pruebas, la revisión de hallazgos con IA, las aprobaciones y el control de publicación al que puede llamar tu CI.

Fuente: https://aicodeops.dev/es/docs/quality-gates

Toda sesión de IA termina con un cambio: un diff sobre el repositorio de tu proyecto. Antes de que ese cambio pueda convertirse en un pull request, AI CodeOps lo comprueba. Las comprobaciones son las mismas tanto si abres el pull request desde la consola como si preguntas desde tu CI.

## Qué comprueba el control

Un cambio está **release-ready** (listo para publicarse) cuando se cumple todo esto:

- **Las pruebas pasan.** Después de escribir el cambio, la sesión ejecuta el comando de pruebas de tu proyecto en su sandbox y registra el resultado. Las pruebas que fallan bloquean el cambio.
- **Hay un resultado de pruebas.** Una sesión que cambió código en un proyecto necesita un resultado de pruebas con recuentos. Si no se ejecutó ninguna prueba para ella, o el comando de pruebas se ejecutó pero no indicó recuentos de pruebas, el cambio se bloquea: "The test command ran but reported no test counts, so nothing shows a test passed. Check the project's test command". La falta de evidencia no equivale a superar el control. Si el proyecto no tiene suite de pruebas, activa **Don't run tests for this project** en sus ajustes, en **Plan → Projects** ([Proyectos](https://aicodeops.dev/es/docs/projects)). El control no exige entonces a ese proyecto ningún resultado de pruebas. A una sesión que no cambió código tampoco se le exige.
- **La revisión de hallazgos con IA se completó.** Un paso de revisión lee el diff y registra hallazgos (seguridad, calidad, rendimiento, fiabilidad, cobertura de pruebas y otras categorías). Si esa revisión no pudo terminar, los hallazgos se desconocen y el cambio queda retenido. La página de la sesión dice por qué: el revisor no respondió a tiempo, su respuesta no se pudo leer como hallazgos, o el presupuesto se agotó antes de la revisión. Vuelve a ejecutar la sesión (después de subir el presupuesto, en el último caso).
- **No hay hallazgos bloqueantes abiertos.** Los hallazgos de gravedad **high** o **critical** bloquean hasta que pasan por triaje.
- **Las pruebas cuentan para la versión sobre la que se ejecutaron.** Si alguien edita el cambio después de que se ejecutaran sus pruebas, el resultado antiguo ni lo da por superado ni lo bloquea: el control dice que esta versión no está probada y la aprobación se abre de nuevo, de modo que una persona decide antes de que se entregue. Vuelve a ejecutar la sesión para probar la versión nueva.

Las aprobaciones son una comprobación aparte en el mismo camino. Consulta [Aprobaciones y políticas](https://aicodeops.dev/es/docs/approvals-and-policies).

## Dónde lo ves

Abre la página de ejecución de una sesión. El panel **Quality gates** muestra **Release-ready** o **Not release-ready**, los totales de las pruebas, cada resultado de pruebas y los motivos por los que el cambio todavía no está listo. El panel **Findings** lista cada hallazgo con su gravedad, su archivo y su línea.

Los resultados de pruebas y los hallazgos abiertos de todo el espacio de trabajo están en **Build & Test → Quality**.

## Triaje de hallazgos

Cada hallazgo tiene un estado. Cámbialo desde el desplegable de la lista Findings de la ejecución:

| Estado                                      | ¿Bloquea el cambio?       |
| ------------------------------------------- | ------------------------- |
| open, acknowledged, in progress             | Sí, si es high o critical |
| fixed, won't fix, false positive, duplicate | No                        |

También puedes elegir **Fix** en un hallazgo para lanzar una ejecución de IA que lo corrija. Cambiar el estado de un hallazgo requiere un rol con permiso de triaje. Lo tienen los roles Owner, Admin, Developer, Member y Security Admin; el rol Viewer no.

## Qué bloquea el control

Cuando eliges abrir un pull request, AI CodeOps comprueba por este orden:

1. La política del espacio de trabajo. Una regla deny detiene el pull request; una regla ask necesita una revisión aprobada.
2. La aprobación. Una aprobación rechazada o pendiente lo detiene.
3. El control de calidad. Un cambio que no está release-ready recibe los primeros motivos, por ejemplo "This change isn't release-ready: HIGH security: …".

El mismo control de calidad se ejecuta otra vez antes de que la consola fusione un pull request que abrió. El pull request se abre en una rama llamada `codeops/run-<id>`.

## El control de publicación para CI

**Review & Gate → Release gate** evalúa la URL de un pull request o el SHA de un commit en todas las sesiones que lo tocaron, y muestra **Allowed** o **Denied** con los motivos. Tu CI puede hacer la misma pregunta mediante `POST /api/release/check` con una clave de API del espacio de trabajo. La comprobación de CI añade opciones que el control por ejecución no usa: flujos de trabajo obligatorios, un porcentaje mínimo de cobertura, licencias no permitidas (comprobadas con el SBOM del proyecto) y un despliegue previo obligatorio, como staging. Un mínimo de cobertura necesita una cifra de cobertura: si fijas uno y ninguna ejecución de pruebas del cambio indicó cobertura, la comprobación deniega.

La comprobación de CI aplica también la regla del resultado de pruebas de más arriba, y lista las sesiones sin resultado de pruebas en `testEvidenceMissing`. Enviar `"blockOnTestFailure": false` la desactiva para esa llamada.

Los campos y la respuesta están en la [página de la API](https://aicodeops.dev/es/docs/api). [El control de publicación en CI](https://aicodeops.dev/es/docs/release-gate-ci) tiene jobs para copiar en GitHub Actions, GitLab CI y Bitbucket Pipelines, y muestra cómo convertir el job en una comprobación obligatoria.

Si la propia comprobación del control no se puede ejecutar, por ejemplo durante una interrupción breve, el pull request no se abre: "The release check couldn't run just now." Inténtalo de nuevo en un momento.

## Siguientes pasos

- [El control de publicación en CI](https://aicodeops.dev/es/docs/release-gate-ci)
- [Aprobaciones y políticas](https://aicodeops.dev/es/docs/approvals-and-policies)
- [Seguridad y SBOM](https://aicodeops.dev/es/docs/security-and-sbom)
- [Paquetes de evidencias](https://aicodeops.dev/es/docs/evidence-packs)

## Preguntas frecuentes

### ¿Puedo abrir un pull request mientras hay hallazgos abiertos?

No mientras haya abierto un hallazgo de gravedad high o critical, las pruebas fallen o la revisión con IA no haya terminado. Pasa el hallazgo por triaje o vuelve a ejecutar la sesión, y después abre el pull request.

### ¿Y si mi proyecto no tiene pruebas?

Activa "Don't run tests for this project" en los ajustes del proyecto. Sin eso, una sesión que cambió código necesita un resultado de pruebas con recuentos. Si no se ejecutó ninguna prueba, o el comando de pruebas no indicó recuentos, el cambio se bloquea, porque la falta de evidencia no equivale a superar el control.
