babysit

À propos de babysit

Surveille une demande de tirage (pull request) ou un cycle de revue jusqu'à ce qu'elle soit véritablement prête à être fusionnée, en continuant à vérifier plutôt qu'en s'arrêtant après un seul passage tant que des commentaires ou des fils de revue restent non résolus. Le workflow identifie le numéro de la PR, la branche et la branche de base, confirme que la PR n'est pas un brouillon, et inspecte la possibilité de fusion, les vérifications (checks), la décision de revue, les commentaires et les fils de revue. Les vérifications en attente sont surveillées jusqu'à leur achèvement, avec un sondage (polling) à un intervalle pratique d'environ 30 à 60 secondes, sauf si l'utilisateur demande une fréquence différente. Les nouveaux commentaires et les fils de revue non résolus sont lus, les résumés du bot étant traités comme des résultats utiles mais actionnables, vérifiés par rapport au code.

Les problèmes réels sont corrigés dans des commits ciblés, des tests ou des builds pertinents sont exécutés, les modifications sont poussées, et le cycle revient à réinspecter l'état. Les fils de revue obsolètes ne sont résolus qu'après avoir vérifié que le code ou l'artefact généré adresse désormais le commentaire. Le processus s'arrête uniquement lorsque les vérifications passent ou sont intentionnellement ignorées, que la décision de revue est acceptable, qu'il ne reste aucun commentaire actionnable et qu'il ne reste aucun fil de revue non résolu.

La compétence fournit des recettes concrètes pour la CLI GitHub et GraphQL. gh pr view avec une liste de champs JSON donne un état grossier incluant l'état, le statut de brouillon, la possibilité de fusion, mergeStateStatus, reviewDecision, headRefOid et statusCheckRollup. Le propriétaire et le nom du référentiel sont résolus avec gh repo view et jq avant les requêtes GraphQL. Les fils de revue non résolus sont récupérés avec une requête GraphQL reviewThreads qui inclut pageInfo pour la pagination, avec une boucle documentée qui parcourt les résultats en utilisant endCursor tant que hasNextPage est vrai et filtre les fils non résolus avec jq. Une mutation resolveReviewThread résout un fil uniquement lorsque la correction est vérifiée. Les règles de fonctionnement incluent le maintien du watcher en cours d'exécution pendant les longues vérifications, la confirmation de la pertinence des problèmes signalés par le bot par rapport au code obsolète ou actuel, la vérification que le code source et les artefacts générés concordent avant de résoudre, l'effectuer un dernier balayage frais, et rapporter des preuves concrètes telles que le SHA du dernier commit, les résultats des vérifications, le nombre de fils non résolus, les tests exécutés et tout fichier local modifié non traité.

FAQ

Quand la compétence cesse-t-elle de surveiller une PR ?

Uniquement lorsque les vérifications passent ou sont intentionnellement ignorées, que la décision de revue est acceptable, qu'il ne reste aucun commentaire actionnable et qu'il ne reste aucun fil de revue non résolu. Elle ne s'arrête pas après un seul passage de vérification si des fils sont toujours ouverts.

À quelle fréquence effectue-t-elle un sondage d'état ?

À un intervalle pratique, généralement de 30 à 60 secondes, sauf si l'utilisateur demande une fréquence différente. Le watcher est maintenu en cours d'exécution tant que les longues vérifications sont toujours en attente.

Comment trouve-t-elle les fils de revue non résolus ?

Avec une requête GraphQL reviewThreads qui inclut pageInfo, en parcourant les résultats en utilisant le endCursor précédent tant que hasNextPage est vrai, puis en filtrant les fils où isResolved est faux avec jq.

Quand est-il sûr de résoudre un fil de revue obsolète ?

Uniquement après avoir vérifié que le code ou l'artefact généré adresse désormais le commentaire, en utilisant la mutation resolveReviewThread. Pour les fichiers générés distribués, le code source et l'artefact généré doivent être confirmés comme concordants en premier.

Que doit-on rapporter à la fin ?

Des preuves concrètes : le SHA du dernier commit, les noms et résultats des vérifications, le nombre de fils non résolus, les tests exécutés, et tout fichier local modifié laissé intact, après avoir effectué un dernier balayage frais de l'état de la PR, des fils, des commentaires récents et de l'état git.