La revue de code des exécutions d’agents

Avec les worktrees Git activés, l’agent travaille dans une arborescence et sur une branche isolées. Vos fichiers courants restent intacts et rien n’est fusionné tant que vous n’avez pas approuvé.

La seule exception est la fusion automatique : si elle est activée, Singularity réintègre le résultat dès la fin réussie de l’exécution. Désactivez-la dans Réglages → Git → Worktrees pour imposer une revue humaine.

Ouvrez l’onglet Revue. La vue d’accueil liste les exécutions terminées qui attendent une approbation, avec l’agent, la branche source et la branche de base, le nombre de projets et de fichiers, les additions et suppressions, ainsi que l’heure relative.

Sélectionnez une exécution pour ouvrir son onglet review:<id>. Le diff occupe le centre ; la liste des fichiers, la discussion et les décisions restent réunies dans le panneau de revue.

La section Fichiers présente chaque fichier modifié et ses statistiques. Sélectionnez-en un pour afficher son contenu complet : les lignes ajoutées sont teintées en vert et les suppressions en rouge. Les blocs inchangés peuvent être repliés afin de garder le changement lisible.

Activez Approuver ce fichier lorsque son changement vous convient. Le pied de panneau suit l’avancement avec x/y approuvés. Un fichier marqué « Approuvé — inclus dans la fusion » fera partie de la décision finale.

Utilisez Note de fichier pour une remarque générale — architecture, test manquant ou convention à respecter. Pour une correction précise, sélectionnez du code, ouvrez le menu contextuel et choisissez Ajouter une note sur la sélection. Sans sélection, Singularity vous invite d’abord à sélectionner du code.

Les notes affichent leur portée (FILE ou les lignes concernées), peuvent être supprimées et rejoignent le retour transmis à l’agent lorsque vous choisissez Relancer avec le retour. La zone Discussion permet d’ajouter un message plus global.

Le fichier affiché est modifiable quand Singularity a enregistré le chemin physique du worktree. Modifiez le contenu puis utilisez Cmd/Ctrl + S, ou le bouton Enregistrer. Les états Enregistrement…, Enregistré et les notifications d’échec confirment le résultat.

Sans chemin de worktree enregistré, l’éditeur affiche Lecture seule — aucun chemin de worktree enregistré. Vous pouvez toujours lire et copier le contenu, mais il faut relancer l’exécution dans un worktree correctement enregistré pour modifier le fichier depuis la revue.

• Approuver et fusionner réintègre tous les fichiers lorsque chacun est approuvé.
• Fusionner x/y réalise une fusion partielle avec les seuls fichiers approuvés ; le bouton reste désactivé tant qu’aucun fichier ne l’est.
• Rejeter refuse la revue et marque l’exécution comme rejetée.
• Relancer avec le retour renvoie votre message et vos annotations à l’agent ; cette action attend un retour non vide.

Une erreur de chargement du diff, de sauvegarde ou de copie est signalée sans valider silencieusement l’action : corrigez la cause, puis recommencez.

L’absence de diff correspond toujours à un état explicite :

• L’agent travaille encore. Cause : le ticket est toujours en cours. Remède : suivez sa progression dans le terminal ; il apparaîtra après l’appel de fin d’exécution.
• Déjà fusionné. Cause : la fusion automatique était active. Remède : inspectez les commits dans Graphe ; désactivez la fusion automatique pour les prochaines missions.
• Exécution directe — aucun worktree. Cause : « Utiliser les worktrees Git » était désactivé et l’agent a écrit dans votre arborescence. Remède : activez les worktrees et désactivez la fusion automatique dans Réglages → Git → Worktrees pour les prochaines exécutions.
• L’agent attend une réponse. Cause : une question bloque la mission. Remède : répondez depuis la carte kanban ; la revue reviendra après la reprise et la fin de l’agent.
• Le ticket ne peut pas être révisé. Cause : son statut ou ses métadonnées ne satisfont pas les conditions de revue. Remède : consultez le statut affiché, puis relancez une exécution terminée dans un worktree non fusionné.

Si aucune exécution ne correspond, l’onglet affiche simplement « Aucun travail d’agent à réviser ».