AI CodeOps

PR de Next.js: tres revisiones, tus pruebas y una comprobación de publicación en la CI

Última actualización

Un cambio de Next.js revisado por Parallel Review en corrección, seguridad y cobertura de pruebas, probado con tus propias pruebas y comprobado de nuevo desde la CI antes de fusionar.

Usar esta plantilla

Un route handler que acepta datos del navegador merece más de un par de ojos. Esta plantilla ejecuta tres revisiones específicas sobre un cambio de Next.js, ejecuta tus propias pruebas sobre el código que se escribió y deja que tu CI vuelva a hacer la misma pregunta antes de fusionar.

Qué agentes se ejecutan

PasoAgente
Correctness reviewReviewer
Security reviewSecurity Auditor
Test coverage reviewTester
Merge findingsArchitect

El Architect fusiona las tres revisiones en una sola lista. Después, la pasada de código escribe el cambio, y el paso verify ejecuta el script de pruebas de tu package.json, con el gestor de paquetes que indica tu lockfile, en un sandbox sin conexión. La salida de Vitest y de Jest se desglosa en totales.

Controles que se aplican

  • Hallazgos. Una revisión de hallazgos lee el diff real, con las tres revisiones como contexto. Los hallazgos abiertos de gravedad alta o crítica bloquean el pull request hasta que se pasan por triaje.
  • Pruebas sobre esta versión. Las pruebas fallidas bloquean. Editar el cambio después de ejecutarse sus pruebas lo marca como no probado.
  • Aprobación. La persona que empezó la sesión no puede emitir el voto de aprobación mientras otra persona del espacio de trabajo pueda aprobar.

Vuelve a comprobarlo desde la CI

La consola abre el pull request en una rama llamada codeops/run-<id>. En GitHub Actions, añade un paso al workflow que se ejecuta en los pull requests, con una clave de API del espacio de trabajo guardada como secreto:

- name: AI CodeOps release check
  if: startsWith(github.head_ref, 'codeops/run-')
  env:
    AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
    PR_URL: ${{ github.event.pull_request.html_url }}
  run: |
    curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
      -H "Authorization: Bearer $AICODEOPS_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"pullRequestURL\":\"$PR_URL\",\"blockOnInFlight\":true}" \
      | jq -e '.allowed == true'

El endpoint responde 200 tanto si el cambio está permitido como si no, así que el paso lee allowed. blockOnInFlight deniega mientras alguna sesión detrás del pull request siga en ejecución. Usa el host en el que abres la consola. Todos los campos están en la página de la API.

Siguiente paso

Cuando esto se supere y se fusione, la plantilla de despliegue controlado en staging cubre el camino hasta producción. Para el código que ningún pull request toca, programa una inspección semanal del código base.

Preguntas frecuentes

¿Las tres revisiones se ejecutan a la vez?

No. Se ejecutan una tras otra, y cada una lee lo que escribieron las anteriores. Parallel describe cómo se reparte el trabajo.

¿El paso de CI denegará los pull requests escritos a mano?

Sí, un pull request sin ninguna sesión detrás recibe No workflow runs found. Por eso el paso solo se ejecuta en las ramas codeops/run-.