babysit

Acerca de babysit

Vigila una solicitud de extracción (pull request) o un ciclo de revisión hasta que esté genuinamente lista para fusionarse, continuando con las comprobaciones en lugar de detenerse tras un único pase mientras queden comentarios o hilos de revisión sin resolver. El flujo de trabajo identifica el número de la solicitud de extracción (PR), la rama y la rama base, confirma que la solicitud de extracción no es un borrador y examina la capacidad de fusión, las comprobaciones, la decisión de revisión, los comentarios y los hilos de revisión. Se supervisan las comprobaciones pendientes hasta que finalicen, realizando sondeos a un intervalo práctico de aproximadamente 30 a 60 segundos, salvo que el usuario solicite una cadencia diferente. Se leen los nuevos comentarios y los hilos de revisión sin resolver, tratando los resúmenes del bot como hallazgos útiles pero accionables que se verifican contra el código.

Los problemas reales se corrigen en commits enfocados, se ejecutan las pruebas o compilaciones relevantes, se envían los cambios y el ciclo vuelve a inspeccionar el estado. Los hilos de revisión obsoletos se resuelven únicamente después de verificar que el código o el artefacto generado ahora aborda el comentario. El proceso se detiene solo cuando las comprobaciones pasan o están intencionalmente omitidas, la decisión de revisión es aceptable, no quedan comentarios accionables y no hay hilos de revisión sin resolver.

La habilidad proporciona recetas concretas de la CLI de GitHub y GraphQL. gh pr view con una lista de campos JSON proporciona un estado general que incluye el estado, el estado de borrador, la capacidad de fusión, mergeStateStatus, reviewDecision, headRefOid y statusCheckRollup. El propietario y el nombre del repositorio se resuelven con gh repo view y jq antes de las consultas GraphQL. Los hilos de revisión sin resolver se obtienen mediante una consulta GraphQL reviewThreads que incluye pageInfo para la paginación, con un bucle documentado que avanza por los resultados utilizando endCursor mientras hasNextPage sea verdadero y filtra los hilos sin resolver con jq. Una mutación resolveReviewThread resuelve un hilo solo cuando se verifica la corrección. Las reglas de operación incluyen mantener el observador en ejecución durante comprobaciones largas, confirmar si los problemas informados por el bot se refieren a código obsoleto o actual, verificar que el código fuente y los artefactos generados coincidan antes de resolver, realizar una última comprobación exhaustiva y reportar pruebas concretas como el SHA del último commit, los resultados de las comprobaciones, el número de hilos sin resolver, las pruebas ejecutadas y cualquier archivo local modificado.

Preguntas frecuentes

¿Cuándo deja de vigilar una solicitud de extracción?

Solo cuando las comprobaciones pasan o están intencionalmente omitidas, la decisión de revisión es aceptable, no quedan comentarios accionables y no hay hilos de revisión sin resolver. No se detiene tras un único pase de comprobación si los hilos siguen abiertos.

¿Con qué frecuencia realiza sondeos de estado?

A un intervalo práctico, generalmente de 30 a 60 segundos, salvo que el usuario solicite una cadencia diferente. El observador se mantiene en ejecución mientras las comprobaciones largas siguen pendientes.

¿Cómo se encuentran los hilos de revisión sin resolver?

Mediante una consulta GraphQL reviewThreads que incluye pageInfo, avanzando por los resultados utilizando el endCursor anterior mientras hasNextPage sea verdadero, y luego filtrando los hilos donde isResolved es falso con jq.

¿Cuándo es seguro resolver un hilo de revisión obsoleto?

Solo después de verificar que el código o el artefacto generado ahora aborda el comentario, utilizando la mutación resolveReviewThread. Para los archivos generados distribuidos, primero se debe confirmar que el código fuente y el artefacto generado coinciden.

¿Qué se debe informar al final?

Pruebas concretas: el SHA del último commit, los nombres y resultados de las comprobaciones, el número de hilos sin resolver, las pruebas ejecutadas y cualquier archivo local modificado que haya quedado intacto, tras realizar una última comprobación exhaustiva del estado de la solicitud de extracción, los hilos, los comentarios recientes y el estado de git.