Relire les changements d’un agent avec Changes dans Paneflow

L'onglet Changes de Paneflow affiche les modifications locales près du terminal de ton agent. Tu peux comparer les fichiers au dernier commit (HEAD), les ouvrir dans l'éditeur pour lire le contexte ou restaurer un bloc que tu veux retirer.

Les étapes ci-dessous décrivent Paneflow 0.17.5. Changes inclut les modifications déjà ajoutées à l'index Git, celles qui ne le sont pas encore et les fichiers non suivis. Il les regroupe par checkout, quel que soit leur auteur. Si plusieurs agents travaillent sur les mêmes fichiers, leurs modifications apparaissent ensemble.

Guide actualisé. Cet article annonçait à l'origine l'interface Diff de Paneflow 0.3.7. Il décrit désormais l'onglet Changes du dock.

Choisir le checkout à relire

Ouvre ton projet Git, sélectionne l'onglet du checkout ou worktree à relire, puis ouvre Changes dans le dock. Vérifie les chemins des fichiers avant de lire le diff.

La comparaison montre l'état actuel des fichiers par rapport à HEAD. Les modifications ajoutées à l'index et celles qui ne le sont pas encore sont réunies dans cette vue. Pour voir exactement ce que contiendra ton prochain commit, examine séparément l'index Git avec git diff --cached.

Changes exclut les modifications déjà committées sur la branche. Dans un dépôt sans premier commit, il utilise un arbre vide comme base de comparaison.

Lire le diff avec son contexte

Choisis Split pour lire les versions côte à côte ou Unified pour lire les ajouts et les suppressions dans une seule vue. Le surlignage Words marque les changements à l'intérieur d'une ligne.

Les options d'espaces peuvent ignorer tout ou partie des différences d'espacement. Garde Default lorsque les espaces affectent le comportement, comme l'indentation en Python.

Si tu as besoin du code autour d'un bloc ou veux apporter une correction, ouvre le fichier dans Files, l'éditeur intégré. Sauvegarde tes modifications pour les retrouver dans Changes, qui lit les fichiers sur disque.

Quand un fichier n'affiche pas de diff textuel

Dans Paneflow 0.17.5, Changes liste les fichiers binaires, ceux de plus de 512 KiB et certains fichiers de verrouillage des dépendances sans afficher leur diff textuel. La liste montre jusqu'à 200 fichiers et signale lorsque d'autres fichiers sont omis.

Un fichier sans diff textuel peut quand même avoir changé. Utilise Git pour examiner la liste complète et un outil adapté pour relire les fichiers volumineux ou binaires.

Restaurer un bloc avec Revert

Dans un fichier texte modifié, Revert remplace un bloc par son contenu dans HEAD. Le clic écrit immédiatement sur disque, sans dialogue de confirmation. Copie ou préserve autrement les modifications que tu pourrais vouloir garder avant de l'utiliser, puis vérifie le diff restant.

Revert laisse l'index Git inchangé. Si tu avais déjà ajouté le bloc à l'index, il reste dans le prochain commit tant que tu ne mets pas l'index à jour. Vérifie git diff --cached après avoir restauré une modification déjà indexée. Revert ne supprime pas les fichiers non suivis.

Paneflow refuse la restauration dans ces deux cas :

• Le fichier contient des modifications non sauvegardées dans l'éditeur. Sauvegarde-les ou abandonne-les si tu n'en as plus besoin, puis relis le diff avant de réessayer.
• Le fichier a changé sur disque depuis le chargement du diff. Relis le diff actualisé avant de réessayer, surtout si un agent modifie encore le fichier.

Relire toute la branche avec un agent

Pour demander une revue à un agent, lance-le dans le checkout à examiner et nomme la branche de base. Par exemple, si ta branche part de main :

Relis cette branche par rapport à main, en incluant les commits et les modifications locales. Ne modifie aucun fichier. Signale les bugs et les risques de régression avec les chemins des fichiers, les numéros de ligne et les tests pertinents.

L'agent peut ainsi examiner les modifications committées que Changes n'affiche pas. Lis ses remarques avec le code, apporte les corrections nécessaires et lance les tests pertinents. Avant de committer, examine git diff --cached pour vérifier ce que tu vas enregistrer.