Vue d'ensemble de la maintenance
La maintenance assistée transforme une issue GitHub en correctif proposé, relu par cinq agents, puis publié en PR brouillon. L'équipe du dépôt garde toujours la décision finale.
Qui peut le faire : tout membre du projet consulte les issues et les exécutions. L'Opérateur, le Responsable et l'Administrateur agissent sur une exécution. Voir Rôles et droits.
Le cycle d'une issue#
| Étape | Ce qui se passe | Où le suivre |
|---|---|---|
| 1. Réception | Une issue s'ouvre sur un dépôt surveillé, ou un membre clique sur Demander une exécution. | Page de l'issue |
| 2. Lecture | La plateforme fixe le commit de base de la branche et lit un nombre borné de fichiers. | Onglet Agents et besoin, carte Fichiers de contexte |
| 3. Agents | Exploration, Analyse, Conception, Développement et Revue se succèdent. | Carte Résultat des agents |
| 4. Résultat | Correctif prêt, Précisions requises, Refusé, Échec, Annulé ou Indéterminé. | Badge de l'exécution |
| 5. Information | Le destinataire configuré est prévenu avant toute écriture sur GitHub. | Onglet Suivi, carte Notifications |
| 6. Publication | Une PR brouillon est ouverte sur une branche dédiée, puis une revue est demandée au responsable GitHub. | Onglet Suivi, carte Pull request |
| 7. Suivi | La plateforme observe la revue, la CI GitHub et la clôture de la PR. | Onglet Suivi |
Une issue peut connaître plusieurs tentatives : une précision, une relance ou une demande de modifications crée une nouvelle tentative liée à la précédente. L'historique les conserve toutes.
Ce que 101Maintain ne fait jamais#
- Il ne fusionne aucune PR. La fusion appartient à l'équipe du dépôt maintenu.
- Il ne modifie jamais la branche de base et ne force jamais un push.
- Il ne déclenche aucun déploiement et ne change aucune protection de branche.
- Il n'exécute pas les tests du dépôt. Chaque proposition porte la mention Tests du dépôt non exécutés.
- Il n'écrit rien sur GitHub sans reçu de notification accepté pour cette proposition.
- Il ne donne aux agents ni shell, ni outil, ni identifiant serveur. Les agents ne modifient que des fichiers qu'ils ont lus.
Limites de lecture#
Chaque exécution lit au plus 32 fichiers, 20 000 octets par fichier et 96 000 octets au total. L'agent Exploration voit jusqu'à 1 500 chemins. L'agent Analyse peut demander au plus trois compléments de lecture. Une proposition modifie au plus 8 fichiers. Les fichiers binaires, les liens et les chemins sensibles (clés, certificats, dossiers d'authentification, secrets) sont écartés.
Les issues, les fichiers du dépôt et les réponses du modèle sont traités comme des données non fiables. Une demande qui contient un marqueur de secret est refusée.
Prérequis#
Avant la première exécution, le dépôt doit être :
- rattaché à la GitHub App (Lier le dépôt à la GitHub App) ;
- actif, case Autoriser les travaux sur ce dépôt cochée (Rattacher un dépôt) ;
- surveillé, case Surveiller les nouvelles issues cochée (Surveillance et politique du dépôt).
Pour publier, il faut aussi un responsable GitHub, une destination de notification et la case Autoriser la proposition de correctifs (Responsable GitHub et notification avant publication).