PR brouillon et suivi
Quand la politique du dépôt l'autorise, 101Maintain publie son travail dans une pull request en mode brouillon, sur une branche dédiée. L'équipe du dépôt relit, teste et décide seule de la fusion.
Qui peut le faire : tout membre du projet consulte l'onglet Suivi. La publication est automatique ; elle dépend de la politique réglée par le Responsable et de la notification configurée par l'Administrateur.
Conditions de publication#
- Le dépôt est surveillé et la case Autoriser la proposition de correctifs est cochée.
- Un responsable GitHub est renseigné et une destination de notification est configurée.
- La notification correspondante est Acceptée (voir Notification avant publication (effet)).
- La fonction de publication est activée par l'exploitant.
Comment la PR est créée#
Avec le brouillon précoce (case Autoriser le brouillon précoce cochée) :
- Dès le début de l'exécution, après la notification Ouverture de la PR, la plateforme crée une branche
agents/mvp-<identifiant de l'exécution>à partir de la branche par défaut, avec un commit marqueur vide, puis ouvre une PR brouillon d'analyse. - Quand le correctif est prêt et la notification Proposition acceptée, elle ajoute le commit du correctif sur cette branche et demande une revue au responsable GitHub.
Sans brouillon précoce, rien n'est écrit avant la notification Proposition : la branche, la PR et la demande de revue arrivent ensemble à la fin.
Le corps de la PR indique que les tests du dépôt n'ont pas été exécutés. Les règles de protection et les workflows déjà présents sur le dépôt s'appliquent normalement à la branche et à la PR.
Lire l'onglet Suivi#
La carte Pull request affiche PR #<numéro> et l'état de publication :
| État de publication | Signification |
|---|---|
| En attente | Publication préparée, en attente de reçu ou de traitement |
| Brouillon | PR brouillon d'analyse ouverte, correctif pas encore poussé |
| Publié | Correctif poussé et revue demandée |
| Bloqué | Publication arrêtée par un contrôle (voir plus bas) |
| Indéterminé | Une écriture est partie sans réponse et sa preuve n'a pas été retrouvée |
Sans PR, la carte affiche « Aucune PR liée. ». Quand une PR existe, quatre indicateurs sont lus en direct sur GitHub :
| Indicateur | Valeurs possibles |
|---|---|
| État GitHub | Brouillon, Ouverte, Fermée, Fusionnée |
| Branche | Vérifiée (la tête est celle poussée par 101Maintain) ou Tête modifiée (un commit tiers a été ajouté) |
| Revue | En attente de revue, Modifications demandées, Approuvée |
| CI GitHub | Réussie, Échec, En attente, Aucun contrôle signalé |
Toute valeur qui ne peut pas être attestée s'affiche Indéterminé. La CI s'affiche ainsi si la GitHub App n'a pas le droit de lire les contrôles. Si GitHub ne répond pas, la carte affiche Suivi GitHub indisponible.
Revue et reprise automatique#
Le responsable GitHub relit la PR sur GitHub. S'il soumet une revue Request changes sur le dernier commit et que la case Autoriser la reprise automatique est cochée, la plateforme crée une tentative Réécriture avec ses commentaires de revue.
La nouvelle proposition obtient sa propre notification, puis un nouveau commit est ajouté à la même PR, sans réécrire l'historique, et une nouvelle revue est demandée.
Aucune reprise n'est déclenchée si la PR est fermée, fusionnée ou approuvée, si sa tête a été modifiée par un tiers, ou si deux reprises automatiques ont déjà eu lieu sur cette PR. Les avis d'autres personnes sont ignorés.
Quand la publication s'arrête#
La publication s'arrête si :
- la branche contient un commit qui n'a pas été poussé par 101Maintain, ou la PR a été fermée ou n'est plus en brouillon : l'état passe à Bloqué ;
- le responsable GitHub, la politique, le besoin, la base ou le correctif ont changé depuis la notification : aucune écriture n'a lieu pour cette exécution.
Si une écriture est restée sans réponse, la plateforme recherche la preuve sur GitHub avant toute nouvelle tentative. Sans preuve, l'état reste Indéterminé et rien n'est renvoyé automatiquement : une vérification humaine est nécessaire.
Fusion et clôture#
101Maintain ne fusionne jamais. Il observe la PR en lecture seule pendant 90 jours au plus. La fusion ou la fermeture, avec sa date GitHub, alimente la clôture du rapport d'incident. Seule une fusion vaut rétablissement dans le rapport.