Mergerie
Sommaire

Réglages

Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab

Groupes de dépôts

Vingt micro-services d'une même équipe partagent les mêmes règles de review, les mêmes commandes de vérification, le même gabarit. Un fichier de configuration dans chaque dépôt les dupliquerait vingt fois ; un groupe les porte une fois. Réglages → Dépôts → Groupes de dépôts : un nom, ses membres (cochés derrière un filtre qui masque sans décocher), et, repliés, ses gabarits (review, correction, modification) et ses consignes permanentes — vides, ce sont les réglages globaux qui valent. La résolution est global → groupe(s) → dépôt : un dépôt peut être dans plusieurs groupes, le plus ancien qui porte une valeur gagne, et la fiche du dépôt dit d'où vient chaque valeur.

Ce qu'un groupe porte encore : une règle de review peut lui être limitée (elle vaut pour tous ses membres, présents et futurs), et un vérificateur peut le couvrir en bloc (en worktree — le mode « in place » et son consentement restent ligne à ligne, un dossier de poste ne se déclare pas pour vingt dépôts). Partout où l'on choisit des dépôts — une session multi-dépôts, une action Git, la couverture d'un vérificateur — une pastille par groupe ajoute ou coche tous ses membres.

Le groupe est d'équipe : il voyage par le dépôt de données, ses membres désignés par leur adresse (forge/projet), et un dépôt qu'un poste ne suit pas est gardé en marge, jamais perdu. Ce qui exécute garde la règle des vérificateurs : une couverture par groupe arrivée par la synchro attend l'approbation sur chaque poste ; un gabarit ou une règle voyagent librement, leur texte entrant dans le prompt balisé comme donnée.

Chaque champ porte un badge « équipe » ou « ce poste », parce que les réglages ne sont pas tous de même nature. Un réglage d'équipe décrit l'outil : les gabarits de prompt, les seuils, les politiques de review, l'adresse de la forge — deux reviews de la même merge request faites avec des consignes différentes ne sont pas comparables, donc ces réglages-là sont faits pour être communs. Un réglage de ce poste n'appartient qu'à ta machine : les jetons d'API, le dossier de clonage, la langue. Ils sont rangés à part, dans une table qui n'a pas vocation à voyager : c'est ce qui permettra plus tard à une équipe de partager son outil sans que le moindre secret quitte les machines.

Sous-onglets, dans l'ordre du parcours — connecter, choisir le code, régler la review, régler l'outil, les intégrations optionnelles, le banc d'essai :

Git (connexion GitLab — URL + access token, avec Tester la connexion —, connexion GitHub — URL (vide = github.com, sinon GitHub Enterprise) + token, avec Tester GitHub —, dossier de clonage, et la palette de commandes git de l'onglet Git → Commandes Git : ajout/édition/suppression de commandes nom + commande figée). C'est le premier onglet, et celui qui s'ouvre d'office la première fois : sans jeton, aucun autre réglage ne sert à rien · Dépôts (ajout un par un ou en masse depuis GitLab ou depuis GitHub — chaque dépôt porte un badge de forge, et un même chemin peut exister sur les deux ; une adresse collée est rangée dans sa forge d'après son hôte, comparé d'abord à ceux configurés dans Réglages → Git — un GitHub Enterprise sur git.entreprise.com n'est plus pris pour un GitLab ; sans jeton pour cette forge, la fenêtre d'ajout en masse le dit et renvoie vers le champ à remplir —, plus les répertoires locaux — un dossier de ta machine contenant un sous-dossier par projet git, qui alimente l'onglet Git → Navigation et le Codage hors dépôt ; le décompte affiché « n projets git sur m dossiers » confirme d'un coup d'œil qu'on a désigné le bon niveau d'arborescence, et un bouton relit le répertoire sur le disque — un dossier supprimé à la main disparaît, un dépôt cloné depuis apparaît, partout où le répertoire est proposé) ; chaque dépôt affiche aussi ses merge requests ouvertes, la date de la dernière recherche et l'état de son clone, avec un bouton Re-cloner — rien n'est perdu côté forge, mais les modifications non poussées du clone local le sont, d'où la confirmation) ; un bouton Fiche déplie ce qui est rattaché à ce dépôt — vérificateurs, jobs Jenkins, règles de review limitées à lui, services de la grille, projets liés par défaut, agents dont il fait partie. La ligne disait ce qui le concerne LUI ; la fiche répond à « qu'est-ce qui casse si je le retire ? » et « quel vérificateur le teste, déjà ? ». Chaque entrée mène à l'écran où l'objet se modifie, et rien n'est demandé au serveur tant que le panneau n'est pas déplié) · Merge Request (rafraîchissement auto, convergence, le seuil « dormante » après N jours (venu de Général), et sous Découverte les trois réglages des croisements — Relever les fichiers des MR ouvertes (coché ; décoché, aucun appel forge supplémentaire et aucun badge), Au plus N listes relevées par découverte (20 ; 0 = sans limite) et Croiser aussi les MR de branches cibles différentes (décoché), puis Relever les commits des MR ouvertes (coché ; il partage le plafond des fichiers, une MR relevée pour ses fichiers l'est pour ses commits dans le même tour ; décoché, aucun appel de plus et aucun badge « contient !214 ») —, puis ceux des tests touchés — Afficher les tests touchés (coché ; il dépend du relevé des fichiers, et le dit), Signaler l'absence de test à partir de N fichiers de code (3 ; 0 = toujours), et les deux listes de motifs, de test et neutres, un glob par ligne, avec Remettre les défauts et un aperçu « sur les MR ouvertes, ces motifs classent 41 fichiers en tests, 12 en neutres » ; un glob invalide est refusé à l'enregistrement avec sa ligne, une liste de plus de 100 lignes aussi. Les mêmes deux listes se posent sur un dépôt (sa ligne dépliée dans Dépôts) et sur un groupe (son formulaire) : remplies, elles remplacent le niveau au-dessus ; vides, on remonte ; puis ceux des dépendances — Afficher les dépendances (coché ; décoché, aucun diff de manifeste n'est gardé et aucun badge ne s'affiche) et les motifs de manifestes, un glob par ligne, avec Remettre les défauts et l'aperçu « sur les MR ouvertes, ces motifs désignent 3 manifestes », eux aussi posables sur un dépôt et sur un groupe, au même endroit que les motifs de tests —, puis le contrôle au registre — Contrôler les dépendances ajoutées auprès des registres publics (décoché d'office : c'est le premier appel réseau de Mergerie qui ne va ni à la forge ni à Jira, et le libellé nomme les hôtes contactés : registry.npmjs.org, repo.packagist.org, pypi.org, crates.io, rubygems.org, proxy.golang.org, search.maven.org, api.nuget.org — uniquement pour les paquets ajoutés par vos merge requests, et seulement leur nom), Récent : publié depuis moins de N jours (30), Au plus N appels par tour (30 ; 0 = sans limite, indépendant du plafond des fichiers), les motifs de paquets privés (un glob de nom par ligne, vides ; aussi sur un dépôt et sur un groupe, même résolution que les motifs de manifestes) et, de ce poste et jamais partagées, les URL par registre (une ligne écosystème=url par registre à surcharger — un miroir, un proxy d'entreprise ; vide après le =, l'écosystème n'est pas contrôlé) —, templates de prompt — le gabarit livré demande un rapport structuré : constats classés 🔴 bloquant / 🟠 important / 🟡 mineur, note calibrée sur des repères nommés (une note ≥ 7 exclut tout bloquant restant), une section « ce qui est bien » et une checklist de merge ; un prompt personnalisé n'est pas touché, et une installation restée sur l'ancien défaut passe au nouveau d'elle-même, dans sa langue ; il n'invoque aucun skill, celui qui en a un l'y écrit ; la note globale, elle, est réclamée par l'application quel que soit le gabarit, parce que la liste s'en sert pour filtrer) · Règles de review spécifiques (une règle peut être limitée à un dépôt — sans quoi il fallait deviner un path_match que seul ce dépôt satisferait ; critères ajoutés au prompt quand le nom de branche contient un fragment donné ou quand le diff touche un chemin — glob type **/migrations/**, *.sql —, plus précis ; une règle par chemin peut porter un badge « risque » affiché sur les MR concernées, calculé sans IA juste sur les chemins du diff, pour voir d'un coup d'œil laquelle reviewer en premier) · Vérificateurs (tes commandes de tests, et les dépôts que chacun sait tester — voir Vérification objective plus bas ; la page montre d'abord la liste, et le formulaire s'ouvre sur Ajouter un vérificateur, Modifier ou Dupliquer — celui-ci le rouvre pré-rempli sans identifiant, donc enregistrer crée au lieu d'écraser l'original, avec un nom libre proposé (« X (copie) », les noms étant uniques) et le champ sélectionné : renommer est le premier geste ; le formulaire propose les commandes que les dépôts couverts savent déjà lancer — scripts package.json (avec npm, pnpm ou yarn selon le lockfile), scripts composer.json et phpunit, cibles du Makefile, pytest / tox / ruff, go build|vet|test ./..., cargo build|test|clippy, mvn/./mvnw -B test, gradle/./gradlew test, dotnet test, lus dans le clone sur disque, rien n'est exécuté — et, quand un fichier compose est dans le clone, la variante docker compose run --rm <service> <commande> de chaque commande de test : les commandes tournent sur l'hôte, c'est dans la ligne qu'on dit d'entrer dans un conteneur. Chaque suggestion est une ligne exacte, celle qui sera approuvée telle quelle — à ajouter d'un clic) · Notifications (sous-onglet dédié, voir ci-dessous) · Général (thème clair/sombre/auto, langue, densité, arrangement des menus, brief du matin, conservation des données, sauvegarde, et une zone dangereuse pour la remise à zéro) · Données partagées (le dépôt git où l'équipe partage son travail accumulé, voir Partager avec une équipe plus bas) · Jira (connexion Jira — URL + email + jeton d'API, avec un bouton Tester Jira — ; alimente l'onglet Jira et l'enrichissement d'une session depuis un ticket ; et la case « Prévenir Jira » à la création d'une merge request, cochée d'office, avec son propre gabarit de commentaire — {url} obligatoire, plus {iid}, {project}, {title}, {branch}, {target}, {key}, aperçu en direct ; vide reprend le texte livré ; et la case « Prévenir Jira quand une merge request est mergée », décochée par défaut, avec son gabarit à elle — mêmes variables, même aperçu : quand Mergerie voit la merge request mergée (découverte, Mettre à jour depuis la forge), le ticket reçoit un commentaire — un seul par ticket, réécrit avec la liste complète à chaque merge request suivante —, rien pour une fermeture sans merge ni depuis le rattrapage d'une période) · Plugins (la liste des plugins installés — version, état, permissions, événements —, activer ou désactiver sans redémarrer (la page recharge, les données restent), un bouton Mettre à jour par plugin installé depuis git ou un dossier (reclone, désactive, remplace le dossier, réactive si besoin, sans toucher à ses données ni ses secrets ; un échec réseau laisse le plugin tel quel ; grisé pour un plugin installé avant cette fonctionnalité — une réinstallation depuis git l'active), et l'installation d'un nouveau plugin depuis un dossier local ou une adresse git — Jenkins, Docker et Liens, entre autres, s'installent ainsi) · AI sessions (les binaires de l'agent — le défaut et les autres, voir Configuration —, les consignes permanentes, voir ci-dessous, les bornes du jour, le mode sécurisé ou yolo, les trois cases cochées d'office d'une nouvelle session — auto-push, questions de l'IA, converger après (venues de Général) — et un test technique : deux passes dans la même session d'agent — mémorise un marqueur puis le rappelle en reprise — pour vérifier que la reprise de session fonctionne avec ton CLI ; c'est le socle de la continuité de contexte entre review, corrections et convergence).

Les trois premiers sont ce qu'on remplit pour démarrer ; Règles et Vérificateurs complètent la review ; le reste se règle quand le besoin s'en fait sentir. Le dernier sous-onglet consulté est mémorisé — on revient dans Réglages pour finir ce qu'on y faisait. Toute la page tient sous une seule barre Enregistrer, fixée en bas : elle dit « modifications non enregistrées » dès qu'un champ change, puis confirme par un toast à chaque sauvegarde (une erreur si le serveur refuse) — et un jeton déjà enregistré (affiché ***) a un bouton copier à côté : la valeur part dans le presse-papiers sans jamais s'afficher à l'écran, y compris pour un jeton qu'un plugin déclare secret.

Consignes permanentes

Réglages → AI sessions. Un texte libre ajouté à la fin du prompt de toutes les sessions de codage — dépôt et hors dépôt, au premier lancement comme à chaque suivi. C'est ce qu'on redit à chaque fois : la langue des commentaires, une commande à lancer avant de committer, une interdiction. Les recopier dans chaque prompt marche jusqu'au jour où on oublie — et c'est toujours celui-là qu'on relit trois heures plus tard.

Elles arrivent après la tâche (ce qu'on demande d'abord, comment le faire ensuite) et avant le bloc de questions, qui reste le dernier mot. Elles sont relues à chaque prompt : une consigne ajoutée maintenant vaut pour la session lancée juste après, sans redémarrer l'outil. Le champ vide n'ajoute rien — pas même un titre de section orphelin. ⚠ Elles ne s'appliquent pas à l'exploration, qui ne produit pas de code.