Git : changements, diff et commit

Le panneau des fichiers non commités

Le panneau s’ouvre à droite de la conversation d’un agent. Dans la disposition classique, le compteur « Fichiers ▸ » de l’en-tête de la conversation l’ouvre et le ferme, comme Ctrl+Maj+B (⇧⌘B sous macOS) ; la croix du panneau le referme. Il a deux onglets : « Non commités », suivi du nombre de fichiers, et « Historique », décrit plus bas.

Sous les onglets, deux boutons choisissent ce que la liste montre :

Chaque ligne donne la lettre de l’état du fichier (M modifié en ambre, A ajouté en vert, D supprimé en rouge), son nom, son dossier, puis le nombre de lignes ajoutées (+29) et supprimées (−3). Un fichier nouveau et pas encore suivi par git compte comme ajouté. La liste se met à jour toute seule pendant que l’agent travaille, et dès que quelque chose change dans le dossier. Elle affiche au plus 500 lignes, puis « … et N autres fichiers » ; le diff et le commit portent sur tous les fichiers.

Quand il n’y a rien, la liste dit « Aucun fichier modifié par cet agent. » ou « Aucune modification non commitée. »

Ce qu’on peut faire d’un fichier

• Un clic sur une ligne ouvre son diff (disposition classique) ou l’affiche sous la liste (disposition côte à côte).
• Le bouton </> qui apparaît à droite de la ligne quand tu la survoles, ou « Ouvrir dans l’éditeur » dans son menu (clic droit), ouvre le fichier dans l’éditeur, dans le worktree de l’agent s’il en a un. Pour un fichier supprimé, le bouton n’existe pas et l’entrée du menu est grisée.
• Le clic droit propose aussi de défaire le fichier :

Les boutons du bas

• « Voir le diff » ouvre la visionneuse sur tous les fichiers de la liste (pour « Tout le projet », ceux du projet et de chaque worktree).
• « Commit… » (« Cet agent ») ou « Commit tout… » (« Tout le projet ») lance un commit. Les boutons sont grisés quand la liste est vide.
• Pour un agent qui a un worktree, « Merger escouade/refacto-auth → main… » fusionne son travail dans sa branche de base, et « Intégrer main » y fait entrer la base : voir un worktree par agent et les branches.

La visionneuse de diff

La visionneuse est une grande fenêtre. Elle s’ouvre avec « Voir le diff », par un clic sur un fichier de la liste (disposition classique), par un clic sur un commit de l’historique ou par une comparaison de branches. Son titre dit ce qu’elle montre (« Modifications de refacto-auth », « 4f2a9c1 · feat: pagination », « main ↔ feat/login ») et le nombre de fichiers. Avec plusieurs fichiers, la liste est à gauche, avec l’état de chacun, son chemin, l’agent à qui il appartient et ses lignes +/− ; le diff du fichier choisi est à droite. Échap ou la croix la ferme.

Deux présentations, au choix avec les boutons « Unifié » et « Côte à côte » :

• « Unifié » : une seule colonne, avec les numéros de l’ancienne et de la nouvelle ligne, et un signe + ou − devant chaque ligne changée ;
• « Côte à côte » : l’ancienne version à gauche, la nouvelle à droite, les lignes appariées l’une en face de l’autre. Les longues lignes passent à la ligne pour que les deux colonnes restent alignées.

Le choix est gardé d’une session à l’autre. Il vaut partout : la visionneuse, le diff du fichier choisi dans le panneau et les diffs que la conversation montre sous les appels d’outils d’édition de l’agent.

Quelques cas particuliers :

Un diff déplié s’affiche par tranches de 500 lignes : le bouton « Afficher 500 lignes de plus » ajoute la suivante.

Commiter

Les boutons « Commit… » et « Commit tout… » du panneau suivent le réglage « Commit » du projet (Réglages › Projets, groupe « Git »). Il a deux valeurs : « Rédigé par l’agent », par défaut, et « Direct, avec un message proposé ». La liste complète des réglages du projet est dans les réglages des projets.

Faire commiter l’agent

C’est le comportement par défaut. « Commit… » envoie un message à l’agent : il doit commiter les modifications qu’il a faites dans le dépôt, avec un message clair au format Conventional Commits, n’inclure que les fichiers qu’il a modifiés et faire plusieurs commits s’il y a plusieurs sujets. Un message « Demande de commit envoyée à refacto-auth » le confirme, et la suite se passe dans la conversation, comme pour tout message : l’agent peut demander des autorisations, par exemple pour lancer git.

« Commit tout… » demande à l’agent choisi de commiter toutes les modifications en cours du dépôt, regroupées en commits cohérents. Il faut donc qu’un agent soit sélectionné.

Le message est envoyé dans la langue réglée par « Langue des textes rédigés par Claude » (voir les réglages de l’application).

Commiter toi-même, avec un message proposé

Avec « Direct, avec un message proposé », « Commit… » ouvre la fenêtre « Commit ». Elle indique ce qui est commité (« Modifications de refacto-auth »), liste les fichiers du commit et propose le champ « Message ».

1. Haiku lit la liste des fichiers et leur diff, ainsi que les derniers sujets de commit du dépôt, et propose un message dans le même style (« Haiku rédige le message… »). Ça peut prendre quelques secondes, 90 au plus.
2. Relis le message et corrige-le comme tu veux. Si tu commences à écrire avant l’arrivée de la proposition, elle ne remplace pas ton texte. « Régénérer » en demande une autre, qui remplace le contenu du champ.
3. « Commiter » crée le commit, ferme la fenêtre et affiche « Commit 4f2a9c1 créé ».

Ce que tu dois savoir :

• Rien n’est commité sans que tu cliques « Commiter ».
• Le commit prend exactement les fichiers de la liste, nouveaux, modifiés et supprimés, et rien d’autre : ce qui était déjà indexé par ailleurs reste indexé, hors du commit. La liste n’a pas de cases à cocher : le commit prend tous les fichiers listés.
• Les hooks git s’exécutent. Si l’un refuse le commit, son message s’affiche dans la fenêtre, avec ton texte intact.
• Si Haiku ne propose rien, la fenêtre dit « Pas de proposition : … » et tu écris le message.
• « Cet agent » commite le worktree de l’agent, ou les fichiers qu’il a modifiés dans le dossier du projet. « Tout le projet » commite le dossier du projet seul : le worktree d’un agent se commite depuis « Cet agent ».
• Les fichiers que le projet copie dans ses worktrees (les .env*, par défaut) ne sont jamais commités. La fenêtre le dit (« Jamais commité : .env (copié dans les worktrees). ») et leur contenu n’est pas montré à Haiku.
• Par défaut, le message proposé reprend la langue des derniers commits du dépôt. Si tu règles « Langue des textes rédigés par Claude », c’est cette langue qui est demandée.
• Fermer la fenêtre avec un message que tu as écrit ou modifié demande confirmation (« Abandonner le message ? »).

Historique et git graph

L’onglet « Historique » dessine le graphe de tout le dépôt : les 300 derniers commits de toutes les branches, locales et distantes, et les tags, avec les lignes qui montrent d’où chaque branche part et où elle est mergée. Chaque ligne donne le commit, ses étiquettes, son sujet et son âge ; le survol d’un commit affiche son hash court et son auteur.

• La branche de l’agent est mise en avant : ses commits sont en pleine couleur, avec un point plus gros, et le reste est estompé. Au premier affichage, la liste défile jusqu’à elle. Sans agent à worktree, c’est la branche du dossier du projet qui est mise en avant.
• Les étiquettes distinguent la branche en cours (en couleur d’accent), les branches d’agents (affichées sous le nom de l’agent), les branches distantes (contour) et les tags.
• Un clic sur un commit ouvre son diff dans la visionneuse. Pour un commit de merge, le diff est celui par rapport au premier parent.
• Un clic droit (ou la touche Menu, ou Maj+F10) ouvre le menu du commit.

Une branche tenue par le worktree d’un agent ne peut ni recevoir de bascule ni être supprimée : l’entrée est grisée et dit pourquoi. Les questions que posent ces actions (changements non commités, branche pas encore mergée) sont décrites dans les branches.

Côte à côte : conversation et fichiers

Ctrl+Maj+L (⇧⌘L sous macOS), ou le bouton « Conversation et fichiers côte à côte » à droite de l’en-tête de la conversation, change la disposition. Le bouton voisin, « Disposition classique », revient en arrière. Le choix est gardé d’un redémarrage à l’autre.

Dans cette disposition, la conversation prend la moitié gauche et le panneau, toujours affiché, la moitié droite. La liste des fichiers est en haut (environ un tiers de la hauteur au plus), le diff du fichier choisi est en dessous, sur toute la largeur disponible. Un clic sur une ligne change de fichier ; le premier est choisi au départ, et le fichier choisi reste affiché quand la liste change. Liste et diff se rafraîchissent pendant que l’agent travaille : tu lis ses modifications au fur et à mesure.

Le panneau étant toujours là, Ctrl+Maj+B n’a plus d’effet et « Fichiers » devient un simple compteur dans l’en-tête. Les onglets « Non commités » et « Historique », les boutons du bas et la visionneuse (« Voir le diff ») sont les mêmes.

Les modifications du projet d’un coup d’œil

• L’onglet de chaque projet affiche « Δ 7 » quand le projet a des fichiers non commités (l’info-bulle dit « Modifications git non commitées »). Le nombre compte les fichiers modifiés, ajoutés ou supprimés dans le dossier du projet et dans les worktrees de ses agents. Il disparaît à zéro.
• Dans la barre latérale, chaque carte d’agent indique son nombre de fichiers (« 6 fich. »), et le pied de la barre détaille les totaux du projet (« ~2 modifiés », « +1 ajoutés », « −0 supprimés »).
• La branche du dossier du projet, avec son avance et son retard sur le dépôt distant, est dans la barre d’état : c’est le bouton qui ouvre le sélecteur de branches.