@imenam/mcp-dependabot-tracker 1.0.18 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,14 +2,14 @@
2
2
 
3
3
  Suivi des alertes Dependabot de dépôts GitHub, et correction de leurs vulnérabilités npm dans un clone temporaire, depuis une interface graphique ou par un agent.
4
4
 
5
- Pour chaque dépôt suivi, l'interface montre les alertes Dependabot ouvertes et lance une **correction** : clone temporaire de la branche choisie pour le dépôt (la branche par défaut tant qu'aucune autre n'est choisie), `npm audit`, `npm audit fix`, `npm audit fix --force` sur décision, puis commit sur une nouvelle branche, push et pull request. L'utilisateur décide, dépôt par dépôt, de ce que l'agent peut faire par les outils MCP : audit, audit fix, audit fix --force, push.
5
+ Pour chaque dépôt suivi, l'interface montre les alertes Dependabot ouvertes et lance une **correction**, menée de bout en bout sans intervention : clone temporaire de la branche choisie pour le dépôt (la branche par défaut tant qu'aucune autre n'est choisie), `npm audit`, `npm audit fix`, corrections par Claude s'il reste des vulnérabilités, puis commit sur une nouvelle branche, push et pull request. L'utilisateur décide, dépôt par dépôt, de ce que l'agent peut faire par les outils MCP : audit, audit fix, push.
6
6
 
7
7
  ```
8
8
  Utilisateur (GUI) ──ajoute un dépôt, accorde les droits, corrige──▶ Tracker ──API GitHub──▶ alertes, PR
9
9
  Agent ──list_repositories / get_alerts / run_audit / fix_vulnerabilities──▶ (dans la limite des droits)
10
10
  ```
11
11
 
12
- L'agent n'exécute jamais `git` ni `npm` lui-même : tout passe par les outils. Quand `npm audit fix` laisse des vulnérabilités, une correction lancée depuis l'interface peut les faire **analyser par Claude** (Claude Code, avec un abonnement Claude) : il lit le code, juge ce qui est urgent à corriger à la main et si `--force` vaut la peine, et crée une tâche de reprise dans un [organizer](https://www.npmjs.com/package/@imenam/mcp-organizer) (voir [L'analyse par Claude](#lanalyse-par-claude)). Après vos remarques en commentaire de cette tâche, Claude peut ensuite **appliquer les corrections** lui-même, dans un commit séparé (voir [Les corrections par Claude](#les-corrections-par-claude)).
12
+ L'agent n'exécute jamais `git` ni `npm` lui-même : tout passe par les outils. Quand `npm audit fix` laisse des vulnérabilités, une correction lancée depuis l'interface fait aussitôt **corriger par Claude** (Claude Code, avec un abonnement Claude) : il analyse chaque vulnérabilité dans le code, corrige ce qu'il peut dans un commit séparé, et rend compte de son travail dans une seule tâche d'un [organizer](https://www.npmjs.com/package/@imenam/mcp-organizer) (voir [Les corrections par Claude](#les-corrections-par-claude)).
13
13
 
14
14
  ---
15
15
 
@@ -19,7 +19,7 @@ L'agent n'exécute jamais `git` ni `npm` lui-même : tout passe par les outils.
19
19
  npm install -g @imenam/mcp-dependabot-tracker
20
20
  ```
21
21
 
22
- Ou via `npx`, sans installation. Le serveur communique en JSON-RPC sur stdio : il est lancé par le client MCP, pas à la main. `git` et `npm` (npm 7 ou plus récent) doivent être dans le `PATH` de la machine qui exécute le serveur. Claude Code, utilisé par l'analyse, est une dépendance du package (`@anthropic-ai/claude-code`, Node 22 ou plus récent) : rien d'autre à installer.
22
+ Ou via `npx`, sans installation. Le serveur communique en JSON-RPC sur stdio : il est lancé par le client MCP, pas à la main. `git` et `npm` (npm 7 ou plus récent) doivent être dans le `PATH` de la machine qui exécute le serveur. Claude Code, utilisé par les corrections par Claude, est une dépendance du package (`@anthropic-ai/claude-code`, Node 22 ou plus récent) : rien d'autre à installer.
23
23
 
24
24
  ### Déclaration dans un projet
25
25
 
@@ -123,8 +123,8 @@ Cinq outils, en anglais. Le résultat d'une opération se termine par le lien ve
123
123
  |---|---|---|
124
124
  | `list_repositories` | — | Dépôts suivis non dépréciés, tous ou ceux d'une catégorie (`category`, son nom) : catégorie, alertes Dependabot ouvertes par gravité (hors celles que l'utilisateur a corrigées à la main, comptées à part), paquets sans version corrigée au dernier audit, dernier audit sans vulnérabilité qui contredit les alertes, vulnérabilités trouvées par le dernier audit de la branche par défaut quand Dependabot ne signale rien, date de la dernière lecture (et son erreur), droits de l'agent, pull requests du tracker pas encore mergées, opération en cours. |
125
125
  | `get_alerts` | — | Relit sur GitHub les alertes ouvertes d'un dépôt (`repository`) et les liste de la plus grave à la moins grave : numéro, gravité, paquet, écosystème, manifeste, portée de la dépendance (exécution ou développement), résumé, version corrigée, marque « corrigée à la main » de l'utilisateur, lien. |
126
- | `run_audit` | audit | `npm audit` dans un clone temporaire, sur le périmètre `scope` (`production` par défaut, ou `all`) : vulnérabilités par projet npm, avec la correction proposée (aucune, dans les plages déclarées, ou montée majeure qui demande `--force`). Rien n'est modifié. |
127
- | `fix_vulnerabilities` | fix (+ force, + push) | Clone, `npm audit`, `npm audit fix`, sur le périmètre `scope` (`production` par défaut, ou `all`) ; avec `force: true`, `npm audit fix --force` s'il reste des vulnérabilités qu'une montée majeure corrige ; avec `push: true`, commit (`commit_message`, défaut `fix(deps): resolve npm audit vulnerabilities`), push d'une nouvelle branche et pull request vers la branche analysée. Sans `push`, rien ne sort du clone : le résultat décrit ce que les corrections changent. |
126
+ | `run_audit` | audit | `npm audit` dans un clone temporaire, sur le périmètre `scope` (`production` par défaut, ou `all`) : vulnérabilités par projet npm, avec la correction proposée (aucune, dans les plages déclarées, ou montée majeure). Rien n'est modifié. |
127
+ | `fix_vulnerabilities` | fix (+ push) | Clone, `npm audit`, `npm audit fix`, sur le périmètre `scope` (`production` par défaut, ou `all`), sans corrections par Claude ; avec `push: true`, commit (`commit_message`, défaut `fix(deps): resolve npm audit vulnerabilities`), push d'une nouvelle branche et pull request vers la branche analysée. Sans `push`, rien ne sort du clone : le résultat décrit ce que les corrections changent. |
128
128
  | `reconnect_gui` | — | Relance le worker GUI et le réenregistre auprès du proxy. |
129
129
 
130
130
  Un outil refuse une action dont l'agent n'a pas le droit, en le disant ; seul l'utilisateur change les droits, dans la GUI. L'agent ne peut ni ajouter ni retirer de dépôt. Un dépôt déprécié est refusé par tous les outils, jusqu'à ce que l'utilisateur le rétablisse. Un champ inconnu fait échouer l'appel. Les outils d'opération attendent la fin de l'opération.
@@ -133,44 +133,42 @@ Un outil refuse une action dont l'agent n'a pas le droit, en le disant ; seul l'
133
133
 
134
134
  ## Une opération
135
135
 
136
- Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche analysée), supprimé dès qu'elle se termine, réussie, échouée ou annulée. Il reste sur le disque tant qu'une correction lancée depuis la GUI attend une décision.
136
+ Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche analysée), supprimé dès qu'elle se termine, réussie, échouée ou annulée.
137
137
 
138
138
  La **branche analysée** se choisit par dépôt dans la GUI ; c'est la branche par défaut tant qu'aucune autre n'est choisie. L'agent l'utilise aussi, sans pouvoir en changer. Les alertes Dependabot, elles, portent toujours sur la branche par défaut, la seule que GitHub analyse : sur une autre branche, c'est `npm audit` qui mesure les vulnérabilités.
139
139
 
140
- Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit ou de « Auditer tout » : **production** (par défaut) ajoute `--omit=dev` à `npm audit`, `npm audit fix` et `npm audit fix --force`, qui laissent alors les devDependencies de côté ; **toutes les dépendances** les couvre aussi. Chaque alerte Dependabot porte la portée de sa dépendance (`dependency.scope` de l'API GitHub : exécution ou développement). Un audit de production ne se compare qu'aux alertes qui ne portent pas sur une dépendance de développement ; une alerte de portée inconnue compte comme une alerte de production. Une opération enregistrée avant ce choix est lue comme un audit de toutes les dépendances.
140
+ Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit ou de « Auditer tout » : **production** (par défaut) ajoute `--omit=dev` à `npm audit` et `npm audit fix`, qui laissent alors les devDependencies de côté ; **toutes les dépendances** les couvre aussi. Chaque alerte Dependabot porte la portée de sa dépendance (`dependency.scope` de l'API GitHub : exécution ou développement). Un audit de production ne se compare qu'aux alertes qui ne portent pas sur une dépendance de développement ; une alerte de portée inconnue compte comme une alerte de production. Une opération enregistrée avant ce choix est lue comme un audit de toutes les dépendances.
141
141
 
142
142
  1. **Cloner le dépôt** — puis repérer les projets npm : chaque dossier dont le `package-lock.json` est suivi par git (racine, `gui/`…). Un dépôt sans lockfile fait échouer l'opération : `npm audit` en a besoin. Un lockfile v1 (npm 6) est refusé.
143
143
  2. **npm audit** — `npm audit --json` dans chaque projet, avec `--omit=dev` en production.
144
144
  3. **npm audit fix** — `npm audit fix --package-lock-only --ignore-scripts` dans chaque projet vulnérable : seuls les lockfiles changent, sans installation de `node_modules` ni script de paquet. Puis un nouvel audit. Les commandes npm du tracker reçoivent `npm_config_allow_remote=all` : avec `--package-lock-only`, npm 12 refuse sinon les archives des paquets à `bundleDependencies` comme `@tailwindcss/oxide-wasm32-wasi` ([npm/cli#9800](https://github.com/npm/cli/issues/9800)). Ce réglage ne vaut que pour ces commandes, pas pour la configuration npm de la machine.
145
- **Analyse par Claude** — pour une correction lancée depuis la GUI, quand des vulnérabilités restent et que l'analyse automatique est activée (voir [L'analyse par Claude](#lanalyse-par-claude)). Passée sinon, et toujours pour une opération de l'agent.
146
- 4. **npm audit fix --force** — proposé quand des vulnérabilités restantes ne se corrigent que par une version majeure (`fixAvailable.isSemVerMajor` du rapport npm). L'écran liste les paquets concernés, leur version installée et la version cible, et le nombre de vulnérabilités en jeu.
147
- 5. **Corrections par Claude** — proposées après une analyse qui a créé sa tâche, quand des vulnérabilités restent : l'opération attend que l'utilisateur les lance ou les passe (voir [Les corrections par Claude](#les-corrections-par-claude)). Passées sinon, et toujours pour une opération de l'agent.
148
- 6. **Commit et push** — commit des fichiers modifiés sur la branche `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` (heure locale du serveur, fixée quand la correction est prête), push, puis pull request vers la branche analysée. Après des corrections par Claude, la branche porte déjà ses deux commits : seuls le push et la pull request restent à faire, et le champ donne le titre de la pull request. Son corps donne le périmètre et la commande exacte, les vulnérabilités avant et après, l'application de `--force`, les paquets mis à jour et, le cas échéant, le résumé des corrections par Claude, fichier par fichier, avec le résultat des tests.
145
+ 4. **Corrections par Claude** — pour une correction lancée depuis la GUI, dès que des vulnérabilités restent : la branche `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` (heure locale du serveur) est créée, les lockfiles de `npm audit fix` y sont commités, puis Claude analyse et corrige en une session (voir [Les corrections par Claude](#les-corrections-par-claude)). Passées quand rien ne reste, et toujours pour une opération de l'agent. Un échec, Claude non configuré compris, laisse la correction se poursuivre avec les seules corrections de `npm audit fix`.
146
+ 5. **Commit et push** — commit des fichiers modifiés sur la branche `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>`, push, puis pull request vers la branche analysée, titrée du message de commit par défaut. Après les corrections par Claude, la branche porte déjà ses commits : seuls le push et la pull request restent à faire. Le corps de la pull request donne le périmètre et la commande exacte, les vulnérabilités avant et après, les paquets mis à jour et, le cas échéant, le résumé des corrections par Claude, fichier par fichier, avec le résultat des tests et la clé de sa tâche. Un avertissement en tête signale l'échec de Claude (la pull request ne porte alors que les corrections de `npm audit fix`) ou des tests en échec après ses corrections.
149
147
 
150
- **Pull requests en attente** — à chaque lecture d'un dépôt (toutes les 10 minutes, ou « Synchroniser maintenant »), le tracker lit ses pull requests ouvertes sur GitHub et garde celles dont la branche suit le nommage `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` et appartient au dépôt lui-même (pas à une fourche). Les pull requests ouvertes avant cette fonction sont donc reconnues, même quand l'historique des opérations ne les contient plus. Une pull request mergée ou fermée disparaît à la lecture suivante ; une pull request que le tracker vient d'ouvrir apparaît aussitôt.
148
+ **Pull requests en attente** — à chaque lecture d'un dépôt (toutes les 10 minutes, ou « Synchroniser maintenant »), le tracker lit ses pull requests ouvertes sur GitHub et garde celles dont la branche suit le nommage `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` et appartient au dépôt lui-même (pas à une fourche). Les pull requests ouvertes avant cette fonction sont donc reconnues, même quand l'historique des opérations ne les contient plus. Une pull request mergée ou fermée disparaît à la lecture suivante, ou aussitôt quand l'utilisateur la marque mergée dans l'onglet « PR en attente » ; une pull request que le tracker vient d'ouvrir apparaît aussitôt.
151
149
 
152
150
  **Auditer tout** — depuis l'accueil, un audit seul (clone et `npm audit`, sans correction) de la **branche par défaut** de chaque dépôt suivi de l'onglet affiché : tous les dépôts sur « Tous mes projets » et « Dépréciés », ceux de la catégorie quand une catégorie est affichée (le bouton s'intitule alors « Auditer la catégorie »), ceux de la file d'attente sur son onglet (« Auditer la file »), quelle que soit sa branche analysée : c'est la branche que Dependabot analyse, et la seule sur laquelle les deux se comparent. Trois audits tournent à la fois. Un dépôt où une opération est déjà en cours est laissé de côté ; un audit qui échoue (dépôt sans `package-lock.json`, clone impossible) n'arrête pas les autres. La série vit dans le processus qui sert la GUI ; une seule à la fois.
153
151
 
154
152
  Les paquets mis à jour sont lus en comparant chaque lockfile à celui du commit cloné : version changée, paquet ajouté ou retiré. S'il n'y a rien à corriger, ou si les corrections ne changent rien, l'opération se termine sans push.
155
153
 
156
- Depuis la GUI, l'opération s'arrête aux étapes 4 et 5 pour la décision de l'utilisateur. Menée par l'agent, elle va d'un bout à l'autre selon `force` et `push`. Une seule opération à la fois par dépôt.
154
+ Depuis la GUI comme pour l'agent, une opération va d'un bout à l'autre sans attendre de décision ; l'agent choisit seulement de pousser ou non (`push`). Une seule opération à la fois par dépôt.
157
155
 
158
- **Annulation** — une opération en attente se termine aussitôt. Une opération en cours reçoit une demande d'annulation que le processus qui l'exécute lit toutes les 500 ms : il arrête la commande en cours (arbre de processus compris, Claude Code compris) et supprime le clone. Une opération dont le processus a disparu passe en échec à la lecture suivante.
156
+ **Annulation** — une opération en cours reçoit une demande d'annulation que le processus qui l'exécute lit toutes les 500 ms : il arrête la commande en cours (arbre de processus compris, Claude Code compris) et supprime le clone ; rien n'est poussé. Une opération dont le processus a disparu passe en échec à la lecture suivante.
159
157
 
160
158
  ---
161
159
 
162
- ## L'analyse par Claude
160
+ ## Les corrections par Claude
163
161
 
164
- Quand `npm audit fix` laisse des vulnérabilités dans une correction lancée depuis la GUI, le tracker lance une session Claude Code non interactive (`claude -p`) dans le clone, avant la décision sur `--force`. Claude :
162
+ Quand `npm audit fix` laisse des vulnérabilités dans une correction lancée depuis la GUI, le tracker enchaîne sans attendre :
165
163
 
166
- 1. lit le code du clone pour voir comment chaque paquet vulnérable est utilisé, si la faille est atteignable et ce qui est urgent à corriger à la main ;
167
- 2. juge si `npm audit fix --force` vaut la peine, d'après les API des paquets montés de version que le projet utilise ;
168
- 3. crée **une tâche** dans l'espace organizer réglé : titre et description en français, rapport par paquet, décision sur `--force`, actions à mener dans l'ordre, fichiers concernés, vérifications — de quoi faire reprendre la correction par un autre agent. Elle est assignée au propriétaire de l'espace et porte pour tag le nom du dépôt ;
169
- 4. rend un rapport structuré (`--json-schema`) : clé de la tâche, résumé, corrections urgentes, avis sur `--force`.
164
+ 1. il crée la branche `fix/npm-audit-…` et y commite les lockfiles modifiés par `npm audit fix` (premier commit, avec le message par défaut), s'ils ont changé ;
165
+ 2. il lance une session Claude Code non interactive (`claude -p`) dans le clone, avec les vulnérabilités restantes (extraites de `npm audit --json`). Claude analyse chaque vulnérabilité dans le code (usage du paquet, faille atteignable ou non, urgence), monte ou épingle les dépendances (`package.json`, entrées `overrides`, puis mise à jour du lockfile), adapte le code, relance `npm audit`, installe les dépendances (`npm ci`) et lance les tests, par les outils npm du tracker ;
166
+ 3. Claude crée **une seule tâche** « Rapport de correction — … » dans l'espace organizer réglé, assignée au propriétaire de l'espace et taguée du nom du dépôt : son unique rapport, en français, avec l'analyse de chaque paquet vulnérable, chaque changement fichier par fichier et sa raison, le résultat de l'audit et des tests (un avertissement en tête quand ils échouent), et ce qui reste à corriger ou à vérifier à la main. Il rend un rapport structuré (`--json-schema`) : clé de la tâche, résumé, fichiers modifiés, message de commit, résultat des tests ;
167
+ 4. le tracker vérifie la tâche (assignée, taguée), commite les changements de Claude (second commit, au message proposé par Claude, avec `Co-Authored-By: Claude`), sans les `node_modules`, relance `npm audit`, puis pousse la branche et ouvre la pull request.
170
168
 
171
- Le tracker relit ensuite la tâche sur l'organizer : une tâche introuvable, sans le tag ou non assignée au propriétaire fait échouer l'analyse, avec la raison. Un échec de l'analyse s'affiche sous son étape et laisse la correction se poursuivre ; l'annulation de l'opération arrête Claude Code.
169
+ Une tâche introuvable, sans le tag ou non assignée au propriétaire fait échouer la session, comme une erreur de Claude, un dépassement des limites, l'organizer ou le token Claude non réglés, ou un bac à sable impossible : le clone revient au commit de `npm audit fix`, l'erreur s'affiche sous l'étape, et la correction pousse quand même les corrections de `npm audit fix`, avec un avertissement en tête de la pull request. L'annulation de l'opération arrête Claude Code.
172
170
 
173
- **Ce que Claude peut faire** — la session reçoit le prompt, les vulnérabilités restantes (extraites de `npm audit --json`) et les montées majeures que `--force` appliquerait. Ses seuls outils intégrés sont `Read`, `Grep` et `Glob`, dans le clone : ni shell, ni écriture. Elle charge un seul serveur MCP, `@imenam/mcp-organizer` lancé par `npx` avec l'adresse et le token réglés (`--strict-mcp-config`), dont seuls `create_task`, `set_assignees`, `set_tags` et `get_task` sont autorisés ; tout autre appel est refusé (`--permission-mode dontAsk`). Les réglages Claude du dépôt cloné ne sont pas lus (`--setting-sources user`). Claude Code reçoit son token et quelques variables système (`PATH`, `LANG`, dossiers temporaires) : jamais `GITHUB_TOKEN`. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session.
171
+ **Ce que Claude peut faire** — outils intégrés `Read`, `Grep`, `Glob`, `Edit` et `Write`, sans shell : ni `git`, ni push. `Edit` et `Write` refusent tout chemin hors du clone (`blockWritesOutsideWorkingDirectories`). Claude lance npm par les outils d'un second serveur MCP, `npm`, que le tracker lui fournit (`dist/src/npm-tools.js`) : `npm_install_lockfile` (`npm install --package-lock-only --ignore-scripts`, avec les paquets à ajouter ou monter), `npm_audit` (avec le périmètre de l'opération), `npm_ci`, `npm_test`, `npm_run` (un script de `package.json`), `npm_ls` et `tsc` (`npm exec --no -- tsc --noEmit`). Chaque outil lance une commande fixe dans un dossier du clone qui contient un `package.json` ; ses arguments ne sont que des noms de paquets ou de scripts. Le bac à sable de Claude Code garde en lecture seule les manifestes, les lockfiles et `node_modules` : ces commandes tournent donc hors de lui, dans un bac à sable **bubblewrap** du tracker. Seuls le système (`/usr`, `/etc`, Node.js…) y est visible, en lecture seule ; le clone et le cache npm de l'opération y sont en écriture, `/tmp` est vide, et l'environnement se réduit à `PATH`, `LANG`, `HOME`, au cache npm et à `CI=true` : ni les données du tracker, ni les autres clones, ni aucun token. Le réseau reste ouvert pour `npm ci`. Hors de Linux, ces commandes tournent directement dans le clone. Claude Code ne reçoit jamais `GITHUB_TOKEN`, et `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` retire son propre token de l'environnement des processus qu'il lance ; sous Linux, Claude Code exige alors lui aussi bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). Avant chaque lancement, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, le lancement est refusé avec la raison : `bwrap` absent, restriction AppArmor des espaces de noms utilisateur (`kernel.apparmor_restrict_unprivileged_userns`, Ubuntu 24.04 et suivantes) ou durcissement du service (`RestrictNamespaces`, `PrivateUsers`, `SystemCallFilter`). Côté organizer, seuls `create_task`, `set_assignees`, `set_tags` et `get_task` sont autorisés ; tout autre appel est refusé (`--permission-mode dontAsk`), et les réglages Claude du dépôt cloné ne sont pas lus (`--setting-sources user`). Installer les dépendances et lancer les tests exécute le code du projet et de ses paquets dans le clone, à chaque correction lancée depuis la GUI qui laisse des vulnérabilités. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session.
174
172
 
175
173
  **Limites** — nombre de tours (`--max-turns`, défaut 40) et durée (défaut 15 min, au-delà de laquelle le tracker arrête Claude Code), réglables dans la GUI.
176
174
 
@@ -178,26 +176,11 @@ Le tracker relit ensuite la tâche sur l'organizer : une tâche introuvable, san
178
176
 
179
177
  - **Organizer** — adresse du site (https, sauf pour un site de cette machine) et token d'agent, créé dans l'organizer (Paramètres › Agents) : il couvre un espace, avec les droits de son créateur. Une connexion modifiée est testée à l'enregistrement ; « Tester » la reteste. L'écran affiche l'espace et son propriétaire.
180
178
  - **Claude** — un token d'abonnement (Pro, Max, Team ou Enterprise) : lancer `claude setup-token` sur un poste avec navigateur, autoriser l'accès, puis coller le token affiché (valable un an). Il est vérifié à l'enregistrement par une requête minimale ; un token refusé n'est pas enregistré. L'écran affiche sa date d'enregistrement et d'expiration.
181
- - **Analyse** — « Analyser automatiquement », qui exige l'organizer et Claude, et les limites.
179
+ - **Corrections par Claude** — les limites d'une session.
182
180
 
183
181
  Les tokens sont enregistrés dans `<données>/settings.json`, lisible par le seul compte du serveur ; la GUI n'en reçoit que les quatre derniers caractères. Claude Code garde sa configuration dans `<données>/claude`. Derrière le gateway manager, l'écran est protégé comme le reste de l'interface, par la session du hub.
184
182
 
185
- **Suivi** — la tâche de la dernière analyse s'affiche sur la ligne du dépôt (« Tâche MNT-12 », qui ouvre la tâche sur l'organizer) tant qu'elle n'est pas terminée : son statut est relu sur l'organizer avec les alertes, toutes les 10 minutes. La pull request de la correction mentionne la clé de la tâche.
186
-
187
- ## Les corrections par Claude
188
-
189
- Quand l'analyse a créé sa tâche et que des vulnérabilités restent après `npm audit fix` (et `--force`, s'il a été appliqué), la correction attend, à l'étape « Corrections par Claude », que l'utilisateur les lance ou les passe. L'étape affiche les commentaires de la tâche, relus toutes les 10 secondes, et un lien pour en ajouter : ce sont les **remarques** que Claude suivra, avant son analyse.
190
-
191
- « Lancer les corrections » :
192
-
193
- 1. crée la branche `fix/npm-audit-…` et y commite les lockfiles modifiés par `npm audit fix` (premier commit, avec le message par défaut), s'ils ont changé ;
194
- 2. lance une session Claude Code dans le clone. Claude relit la tâche et ses commentaires, monte ou épingle les dépendances (`package.json`, entrées `overrides`, puis mise à jour du lockfile), adapte le code, relance `npm audit`, installe les dépendances (`npm ci`) et lance les tests, par les outils npm du tracker ;
195
- 3. Claude crée une **sous-tâche « Rapport de développement »** de la tâche de l'analyse, assignée au propriétaire de l'espace et taguée du nom du dépôt : le détail de chaque changement, la prise en compte de chaque remarque, le résultat de l'audit et des tests, ce qui reste à vérifier à la main. Il rend un rapport structuré : clé de la sous-tâche, résumé, fichiers modifiés, message de commit, résultat des tests ;
196
- 4. le tracker vérifie la sous-tâche (rattachée à la tâche de l'analyse, assignée, taguée), commite les changements de Claude (second commit, au message proposé par Claude, avec `Co-Authored-By: Claude`), sans les `node_modules`, puis relance `npm audit`.
197
-
198
- L'étape « Commit et push » montre alors ce que Claude a changé : résumé, fichiers, tests, vulnérabilités restantes et lien vers la sous-tâche. « Relancer avec mes remarques » refait un passage après de nouveaux commentaires : Claude repart de ses changements précédents, met à jour la même sous-tâche, et son commit remplace le précédent. La branche garde ainsi deux commits, celui de `npm audit fix` et celui de Claude. Un passage qui échoue remet le clone dans l'état du passage précédent et affiche l'erreur sous l'étape ; l'annulation de l'opération arrête Claude Code.
199
-
200
- **Ce que Claude peut faire** — outils intégrés `Read`, `Grep`, `Glob`, `Edit` et `Write`, sans shell : ni `git`, ni push. `Edit` et `Write` refusent tout chemin hors du clone (`blockWritesOutsideWorkingDirectories`). Claude lance npm par les outils d'un second serveur MCP, `npm`, que le tracker lui fournit (`dist/src/npm-tools.js`) : `npm_install_lockfile` (`npm install --package-lock-only --ignore-scripts`, avec les paquets à ajouter ou monter), `npm_audit` (avec le périmètre de l'opération), `npm_ci`, `npm_test`, `npm_run` (un script de `package.json`), `npm_ls` et `tsc` (`npm exec --no -- tsc --noEmit`). Chaque outil lance une commande fixe dans un dossier du clone qui contient un `package.json` ; ses arguments ne sont que des noms de paquets ou de scripts. Le bac à sable de Claude Code garde en lecture seule les manifestes, les lockfiles et `node_modules` : ces commandes tournent donc hors de lui, dans un bac à sable **bubblewrap** du tracker. Seuls le système (`/usr`, `/etc`, Node.js…) y est visible, en lecture seule ; le clone et le cache npm de l'opération y sont en écriture, `/tmp` est vide, et l'environnement se réduit à `PATH`, `LANG`, `HOME`, au cache npm et à `CI=true` : ni les données du tracker, ni les autres clones, ni aucun token. Le réseau reste ouvert pour `npm ci`. Hors de Linux, ces commandes tournent directement dans le clone. Claude Code ne reçoit jamais `GITHUB_TOKEN`, et `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` retire son propre token de l'environnement des processus qu'il lance ; sous Linux, Claude Code exige alors lui aussi bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). Avant chaque lancement, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, le lancement est refusé avec la raison : `bwrap` absent, restriction AppArmor des espaces de noms utilisateur (`kernel.apparmor_restrict_unprivileged_userns`, Ubuntu 24.04 et suivantes) ou durcissement du service (`RestrictNamespaces`, `PrivateUsers`, `SystemCallFilter`). Côté organizer, seuls `get_task`, `create_task`, `update_task`, `set_assignees` et `set_tags` sont autorisés. Installer les dépendances et lancer les tests exécute le code du projet et de ses paquets dans le clone : les corrections ne se lancent qu'à la demande de l'utilisateur. Les limites de tours et de durée sont celles de l'analyse.
183
+ **Suivi** — la tâche du dernier rapport de Claude s'affiche sur la ligne du dépôt (« Tâche MNT-12 », qui ouvre la tâche sur l'organizer) tant qu'elle n'est pas terminée : son statut est relu sur l'organizer avec les alertes, toutes les 10 minutes. La pull request de la correction mentionne la clé de la tâche.
201
184
 
202
185
  ---
203
186
 
@@ -205,21 +188,22 @@ L'étape « Commit et push » montre alors ce que Claude a changé : résumé, f
205
188
 
206
189
  Thème sombre, une information par ligne, une action principale par écran.
207
190
 
208
- - **Accueil (`#/`, `#/c/<catégorie>`)** — à gauche, la barre des catégories : « Tous mes projets », « File d'attente » avec le nombre de dépôts qu'elle contient, « À déployer » avec le nombre de dépôts marqués, puis chaque catégorie, chacune avec le nombre d'alertes ouvertes de ses dépôts, coloré selon la plus grave (aucune pastille sans alerte), précédé du nombre de pull requests du tracker en attente (aucune pastille sans pull request). « Nouvelle catégorie » ouvre un champ en place (Entrée crée, Échap annule) ; au survol d'une catégorie, « … » propose de la renommer ou de la supprimer (un second clic confirme ; ses dépôts restent suivis, sans catégorie). Un dépôt appartient à une catégorie au plus. En bas de la barre, « Dépréciés » ouvre l'onglet des dépôts dépréciés, avec leur nombre.
209
- À droite, les dépôts non dépréciés de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre de vulnérabilités). L'interrupteur « Vulnérables seulement » ne garde que les dépôts réellement vulnérables : des paquets sans version corrigée au dernier audit, des alertes non corrigées à la main que le dernier audit ne contredit pas (« Audit OK » et « Corrigé à la main » sont donc cachés), ou des vulnérabilités trouvées par l'audit alors que Dependabot ne signale rien ; le navigateur retient sa position. Chaque ligne tient sur deux niveaux : sur la première, le nom du dépôt suivi de son état (« Correction en cours », « Analyse par Claude… », « Audit en cours », « Synchronisation impossible » avec l'erreur en infobulle, « À jour », ou la mention d'audit décrite plus bas) et de la pastille du nombre d'alertes, colorée selon la gravité la plus haute ; en dessous, à gauche, la pull request en attente et la tâche, à droite les boutons de la ligne ; le chevron est centré sur la hauteur de la ligne. « Tâche MNT-12 » ouvre la tâche organizer de la dernière analyse, tant qu'elle n'est pas terminée. Quand le dernier audit (de l'utilisateur ou de l'agent) n'a trouvé aucune vulnérabilité alors que Dependabot signale encore des alertes, la ligne affiche « Audit OK le <jour> à <heure> » et estompe la pastille des alertes : Dependabot n'a pas encore repassé. La mention ne vaut que pour un audit de la branche par défaut, la seule que Dependabot analyse ; elle disparaît dès qu'un audit plus récent trouve une vulnérabilité, que Dependabot n'a plus d'alerte, ou qu'il en émet une après l'audit. Quand toutes les alertes ouvertes portent sur des dépendances de développement et que le dernier audit de la branche par défaut, limité à la production, n'a trouvé aucune vulnérabilité, la ligne affiche « Audit production OK le <jour> à <heure> » devant la pastille des alertes, qui garde sa couleur. À l'inverse, quand Dependabot ne signale aucune alerte mais que le dernier audit de la branche par défaut a trouvé des vulnérabilités, la ligne affiche « ⚠ Audit du <jour> à <heure> » et une pastille « N vulnérabilités » colorée selon la plus grave : Dependabot n'a pas encore repassé. Ces vulnérabilités comptent dans la barre des catégories comme les alertes. « ⚠ N sans correctif », devant la pastille, compte les paquets pour lesquels le dernier audit n'a trouvé aucune version corrigée publiée : ils sont à mettre à jour à la main. Les alertes marquées corrigées à la main ne comptent plus, ni dans la pastille, ni dans la barre des catégories ; quand elles le sont toutes, la ligne affiche « Corrigé à la main » et estompe la pastille.
191
+ - **Accueil (`#/`, `#/c/<catégorie>`)** — à gauche, la barre des catégories : « Tous mes projets », « File d'attente » avec le nombre de dépôts qu'elle contient, « PR en attente » avec le nombre de dépôts dont une pull request du tracker attend, « À déployer » avec le nombre de dépôts marqués, puis chaque catégorie, chacune avec le nombre d'alertes ouvertes de ses dépôts, coloré selon la plus grave (aucune pastille sans alerte), précédé du nombre de pull requests du tracker en attente (aucune pastille sans pull request). « Nouvelle catégorie » ouvre un champ en place (Entrée crée, Échap annule) ; au survol d'une catégorie, « … » propose de la renommer ou de la supprimer (un second clic confirme ; ses dépôts restent suivis, sans catégorie). Un dépôt appartient à une catégorie au plus. En bas de la barre, « Dépréciés » ouvre l'onglet des dépôts dépréciés, avec leur nombre.
192
+ À droite, les dépôts non dépréciés de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre de vulnérabilités). L'interrupteur « Vulnérables seulement » ne garde que les dépôts réellement vulnérables : des paquets sans version corrigée au dernier audit, des alertes non corrigées à la main que le dernier audit ne contredit pas (« Audit OK » et « Corrigé à la main » sont donc cachés), ou des vulnérabilités trouvées par l'audit alors que Dependabot ne signale rien ; le navigateur retient sa position. Chaque ligne tient sur deux niveaux : sur la première, le nom du dépôt suivi de son état (« Correction en cours », « Corrections par Claude… », « Audit en cours », « Synchronisation impossible » avec l'erreur en infobulle, « À jour », ou la mention d'audit décrite plus bas) et de la pastille du nombre d'alertes, colorée selon la gravité la plus haute ; en dessous, à gauche, la pull request en attente et la tâche, à droite les boutons de la ligne ; le chevron est centré sur la hauteur de la ligne. « Tâche MNT-12 » ouvre la tâche organizer du dernier rapport de Claude, tant qu'elle n'est pas terminée. Quand le dernier audit (de l'utilisateur ou de l'agent) n'a trouvé aucune vulnérabilité alors que Dependabot signale encore des alertes, la ligne affiche « Audit OK le <jour> à <heure> » et estompe la pastille des alertes : Dependabot n'a pas encore repassé. La mention ne vaut que pour un audit de la branche par défaut, la seule que Dependabot analyse ; elle disparaît dès qu'un audit plus récent trouve une vulnérabilité, que Dependabot n'a plus d'alerte, ou qu'il en émet une après l'audit. Quand toutes les alertes ouvertes portent sur des dépendances de développement et que le dernier audit de la branche par défaut, limité à la production, n'a trouvé aucune vulnérabilité, la ligne affiche « Audit production OK le <jour> à <heure> » devant la pastille des alertes, qui garde sa couleur. À l'inverse, quand Dependabot ne signale aucune alerte mais que le dernier audit de la branche par défaut a trouvé des vulnérabilités, la ligne affiche « ⚠ Audit du <jour> à <heure> » et une pastille « N vulnérabilités » colorée selon la plus grave : Dependabot n'a pas encore repassé. Ces vulnérabilités comptent dans la barre des catégories comme les alertes. « ⚠ N sans correctif », devant la pastille, compte les paquets pour lesquels le dernier audit n'a trouvé aucune version corrigée publiée : ils sont à mettre à jour à la main. Les alertes marquées corrigées à la main ne comptent plus, ni dans la pastille, ni dans la barre des catégories ; quand elles le sont toutes, la ligne affiche « Corrigé à la main » et estompe la pastille.
210
193
  Chaque ligne porte, avant le chevron, un bouton discret (icône archive) mis en relief au survol : il marque le dépôt **déprécié** (refusé pendant une opération). Un dépôt déprécié n'est plus synchronisé ni audité (ni par la relecture des 10 minutes, ni par « Synchroniser maintenant » et « Auditer tout », ni par l'agent), ne compte dans aucune pastille et quitte sa catégorie à l'affichage tout en la gardant. Le marquer déprécié le retire aussi de la file d'attente et lui retire la marque « à déployer ».
211
194
  Juste avant, un bouton (icône de fusée) marque le dépôt **à déployer**, pour un dépôt sans déploiement automatique dont la correction reste à déployer : il reste allumé tant que le dépôt est marqué, et un nouveau clic retire la marque.
212
- Avant ces boutons, un autre (icône de liste) met le dépôt dans la **file d'attente** ; il reste allumé tant que le dépôt y est, et un nouveau clic l'en retire. Dans une catégorie, « Tout ajouter à la file », à côté des interrupteurs, y met d'un coup tous ses dépôts qui n'y sont pas encore (inactif quand ils y sont tous).
195
+ Avant ces boutons, un autre (icône de liste) met le dépôt dans la **file d'attente** ; il reste allumé tant que le dépôt y est, et un nouveau clic l'en retire. Dans une catégorie, « Tout ajouter à la file », à côté de l'interrupteur, y met d'un coup tous ses dépôts qui n'y sont pas encore (inactif quand ils y sont tous).
213
196
  « Ajouter un dépôt » ouvre une fenêtre avec un champ de recherche et la catégorie. Dès la première lettre, jusqu'à dix dépôts accessibles au token et pas encore suivis sont proposés (ceux dont le nom commence par la saisie d'abord) ; ↑ et ↓ parcourent, Entrée ou un clic reportent le dépôt dans le champ, Échap referme la liste, puis la fenêtre. La catégorie part de celle affichée. « Ajouter » valide ; sans suggestion, Entrée aussi. La saisie peut être `propriétaire/dépôt` ou un lien GitHub. Un nouveau dépôt n'accorde que l'audit à l'agent.
214
- « PR en attente » ne garde que les dépôts où une pull request du tracker attend d'être mergée ; combiné à « Vulnérables seulement », les deux conditions s'appliquent. Le navigateur retient sa position. Sur la ligne, « PR #42 en attente » ouvre la pull request sur GitHub, « 3 PR en attente » la liste des pull requests du dépôt.
197
+ Sur la ligne, « PR #42 en attente » ouvre la pull request sur GitHub, « 3 PR en attente » la liste des pull requests du dépôt.
215
198
  « Synchroniser maintenant », à côté, relit tout de suite les alertes et les pull requests de tous les dépôts, sans attendre la relecture des 10 minutes ; l'icône tourne jusqu'à la fin. « Auditer tout » audite la branche par défaut de tous les dépôts (voir plus haut) : un clic l'audite en production, la flèche à côté propose « Production » ou « Toutes les dépendances » ; le bouton affiche la progression (« Audit 4/12… »), chaque dépôt audité affiche « Audit en cours », et un message final donne le nombre de dépôts audités, laissés de côté et en échec (avec leurs noms).
216
199
  La roue dentée, à gauche de « Synchroniser maintenant », ouvre les réglages.
217
- - **File d'attente (`#/queue`)** — les dépôts mis en file, non dépréciés, dans l'ordre de leur entrée dans la file, avec les mêmes informations et interrupteurs que l'accueil. Le chevron ouvre le dépôt pour l'auditer ou le corriger. « Traité », sur chaque ligne, retire le dépôt de la file sans toucher à sa catégorie.
218
- - **À déployer (`#/deploy`)** — les dépôts marqués « à déployer », non dépréciés, dans l'ordre où ils ont été marqués, avec la date de la marque (« À déployer depuis le <jour> à <heure> ») devant les informations habituelles, et les interrupteurs de l'accueil. Le chevron ouvre le dépôt. « Déployé », sur chaque ligne, retire la marque sans toucher à sa catégorie ni à la file d'attente.
219
- - **Réglages (`#/settings`)** — connexion à l'organizer, token Claude et analyse automatique (voir [L'analyse par Claude](#lanalyse-par-claude)). Un token enregistré n'apparaît que par ses quatre derniers caractères, avec « Remplacer ». « Enregistrer » valide tout l'écran.
200
+ - **File d'attente (`#/queue`)** — les dépôts mis en file, non dépréciés, dans l'ordre de leur entrée dans la file, avec les mêmes informations et le même interrupteur que l'accueil. Le chevron ouvre le dépôt pour l'auditer ou le corriger. « Traité », sur chaque ligne, retire le dépôt de la file sans toucher à sa catégorie.
201
+ - **PR en attente (`#/pulls`)** — les dépôts non dépréciés dont une pull request du tracker attend d'être mergée, de la plus ancienne à la plus récente, avec l'interrupteur de l'accueil. Une correction aboutie y place son dépôt dès l'ouverture de sa pull request. Sur chaque ligne, « Mergée » retire aussitôt le dépôt de l'onglet, pour un dépôt au déploiement automatique ; « Mergée, à déployer » le fait passer en plus dans « À déployer ». La relecture des 10 minutes retire aussi les pull requests mergées ou fermées sur GitHub ; une pull request marquée mergée mais encore ouverte sur GitHub y revient à la lecture suivante.
202
+ - **À déployer (`#/deploy`)** — les dépôts marqués « à déployer », non dépréciés, dans l'ordre où ils ont été marqués, avec la date de la marque (« À déployer depuis le <jour> à <heure> ») devant les informations habituelles, et l'interrupteur de l'accueil. Le chevron ouvre le dépôt. « Déployé », sur chaque ligne, retire la marque sans toucher à sa catégorie ni à la file d'attente.
203
+ - **Réglages (`#/settings`)** — connexion à l'organizer, token Claude et limites des corrections par Claude (voir [Les corrections par Claude](#les-corrections-par-claude)). Un token enregistré n'apparaît que par ses quatre derniers caractères, avec « Remplacer ». « Enregistrer » valide tout l'écran.
220
204
  - **Dépréciés (`#/deprecated`)** — les dépôts dépréciés, du plus récent au plus ancien, avec la date de dépréciation. « Rétablir », sur chaque ligne, remet le dépôt dans sa catégorie et relit aussitôt ses alertes. Le chevron ouvre l'écran du dépôt, où « Corriger » est désactivé.
221
- - **Dépôt (`#/r/<propriétaire>/<nom>`, `#/r/<propriétaire>/<nom>/history`)** — sélecteur de la branche analysée (un clic ouvre la liste des branches avec un champ de recherche, la branche par défaut en tête ; ↑ ↓ et Entrée ou un clic choisissent, Échap ferme), sélecteur de la catégorie (« Sans catégorie » ou l'une des catégories) et date de la dernière lecture des alertes, puis deux onglets. **Alertes ouvertes**, avec leur nombre : les alertes ouvertes (gravité, paquet, résumé), chacune ouvrant l'alerte sur GitHub. Une alerte dont le paquet n'a aucune version corrigée publiée porte « ⚠ sans correctif », une alerte sur une dépendance de développement l'étiquette « dév. ». Au survol d'une alerte, « Corrigée à la main » la range dans la section « Corrigées à la main », avec la date du marquage ; « Rétablir » la remet à traiter. Dependabot continue souvent de signaler une alerte corrigée à la main (un paquet installé hors du registre npm, par exemple) : la marque tient tant que l'alerte reste ouverte, et tombe à la lecture suivante si Dependabot émet une nouvelle alerte sur le même paquet. **Historique**, avec le nombre d'opérations : une ligne par opération conservée (les 20 dernières du dépôt), de la plus récente à la plus ancienne, avec audit ou correction, qui l'a lancée, le périmètre, la branche, la date, les vulnérabilités avant et après (le début de l'erreur pour une opération échouée), la part de Claude (« analyse », « analyse · 2 passages ») et l'issue (la pull request, « attend le push », « terminée », « annulée », « échouée ») ; chaque ligne ouvre l'opération. « Corriger » lance une correction en production ; la flèche à côté ouvre le choix du périmètre (« Production » ou « Toutes les dépendances », Échap ferme). « Reprendre la correction » rouvre celle en cours. À gauche d'« Agent », « Traité » retire de la file d'attente un dépôt qui y est et ramène à la file ; pour un dépôt hors de la file, « Ajouter à la file » l'y met (absent pour un dépôt déprécié). Juste avant, « À déployer » marque le dépôt ; une fois marqué, le bouton s'allume et devient « Déployé », qui retire la marque (absent pour un dépôt déprécié). « Agent » ouvre le volet des droits : quatre interrupteurs, enregistrés aussitôt, et « Retirer le dépôt » (un second clic confirme dans les 4 secondes ; refusé pendant une opération).
222
- - **Correction (`#/r/<propriétaire>/<nom>/op/<id>`)** — qui l'a lancée (vous ou l'agent), la branche clonée, le périmètre ; les flèches « 1 / 5 » passent à l'opération plus récente ou plus ancienne du dépôt, la flèche de retour ramène à son historique. Trois onglets : **Étapes**, **Claude** (quand Claude est intervenu) et **Journal**. Les étapes : celles qui sont faites tiennent sur une ligne avec leur résultat (« 4 vulnérabilités », « 3 corrigées », lien vers la pull request), seule l'étape qui attend une décision est dépliée. Une étape passée en donne la raison : « aucune correction possible » pour `--force` quand npm ne propose aucune montée majeure, « rien à corriger » quand `npm audit fix` a tout corrigé, « rien à pousser » quand les corrections n'ont rien changé, « passé » quand l'utilisateur a passé `--force` (« passé · déconseillé par Claude » après son avis), « ignorée » sinon. Les vulnérabilités sans aucune version corrigée publiée sur le registre npm (`fixAvailable: false`, par exemple `xlsx`, que SheetJS ne publie plus sur npm) sont comptées sur la ligne du dernier audit (« 1 sans correctif ») ; un clic les liste avec leur gravité : leur mise à jour est à faire à la main. Quand Claude analyse les vulnérabilités restantes, l'étape « Analyse par Claude » montre sa durée, ses tours et ses trois dernières actions, puis le lien vers la tâche organizer et un résumé. L'étape `--force` liste les montées majeures avec « Appliquer --force » et « Passer » ; après une analyse, elle donne l'avis de Claude et ce qu'il juge urgent de corriger à la main, et le bouton principal suit sa recommandation. L'étape « Corrections par Claude » affiche les remarques de la tâche, « Commenter la tâche », « Lancer les corrections » et « Passer au push » ; pendant le passage, sa durée, ses tours et les dernières actions de Claude (fichiers modifiés, commandes lancées) ; ensuite, sur sa ligne, les vulnérabilités corrigées et le nombre de fichiers modifiés. L'étape du push montre le message de commit modifiable, le nom de la branche, « voir les changements » (paquets mis à jour, replié) et « Pousser et ouvrir la PR » ; après des corrections par Claude, elle montre d'abord ce qu'il a changé, le nombre de commits de la branche, et « Relancer avec mes remarques ». Une fois la pull request ouverte, l'étape propose « Marquer à déployer » ; le dépôt marqué, elle l'indique, avec « Annuler » pour retirer la marque. Une erreur s'affiche sous l'étape qui a échoué. L'onglet « Claude » liste chaque session (l'analyse, puis chaque passage des corrections) avec son heure, sa durée, ses tours et son issue ; la session choisie, la plus récente par défaut, montre les tâches organizer relues, créées ou mises à jour, les remarques que Claude a reçues au lancement, le déroulé complet de ses messages et de ses actions (500 dernières par session), et son résultat : le rapport de l'analyse et l'avis sur `--force`, ou le résumé des corrections, les fichiers modifiés, le commit, les tests et les vulnérabilités restantes ; ou la raison de l'échec. L'onglet « Journal » montre les commandes lancées et leurs résultats ; « Annuler » arrête l'opération.
205
+ - **Dépôt (`#/r/<propriétaire>/<nom>`, `#/r/<propriétaire>/<nom>/history`)** — sélecteur de la branche analysée (un clic ouvre la liste des branches avec un champ de recherche, la branche par défaut en tête ; ↑ ↓ et Entrée ou un clic choisissent, Échap ferme), sélecteur de la catégorie (« Sans catégorie » ou l'une des catégories) et date de la dernière lecture des alertes, puis deux onglets. **Alertes ouvertes**, avec leur nombre : les alertes ouvertes (gravité, paquet, résumé), chacune ouvrant l'alerte sur GitHub. Une alerte dont le paquet n'a aucune version corrigée publiée porte « ⚠ sans correctif », une alerte sur une dépendance de développement l'étiquette « dév. ». Au survol d'une alerte, « Corrigée à la main » la range dans la section « Corrigées à la main », avec la date du marquage ; « Rétablir » la remet à traiter. Dependabot continue souvent de signaler une alerte corrigée à la main (un paquet installé hors du registre npm, par exemple) : la marque tient tant que l'alerte reste ouverte, et tombe à la lecture suivante si Dependabot émet une nouvelle alerte sur le même paquet. **Historique**, avec le nombre d'opérations : une ligne par opération conservée (les 20 dernières du dépôt), de la plus récente à la plus ancienne, avec audit ou correction, qui l'a lancée, le périmètre, la branche, la date, les vulnérabilités avant et après (le début de l'erreur pour une opération échouée), la part de Claude (« Claude » quand il a été lancé) et l'issue (la pull request, « terminée », « annulée », « échouée ») ; chaque ligne ouvre l'opération. « Corriger » lance une correction en production ; la flèche à côté ouvre le choix du périmètre (« Production » ou « Toutes les dépendances », Échap ferme). « Voir la correction en cours » rouvre celle en cours. À gauche d'« Agent », « Traité » retire de la file d'attente un dépôt qui y est et ramène à la file ; pour un dépôt hors de la file, « Ajouter à la file » l'y met (absent pour un dépôt déprécié). Juste avant, « À déployer » marque le dépôt ; une fois marqué, le bouton s'allume et devient « Déployé », qui retire la marque (absent pour un dépôt déprécié). « Agent » ouvre le volet des droits : trois interrupteurs (audit, audit fix, push), enregistrés aussitôt, et « Retirer le dépôt » (un second clic confirme dans les 4 secondes ; refusé pendant une opération).
206
+ - **Correction (`#/r/<propriétaire>/<nom>/op/<id>`)** — qui l'a lancée (vous ou l'agent), la branche clonée, le périmètre ; les flèches « 1 / 5 » passent à l'opération plus récente ou plus ancienne du dépôt, la flèche de retour ramène à son historique. Trois onglets : **Étapes**, **Claude** (quand Claude est intervenu) et **Journal**. Les étapes se suivent sans décision à prendre : chacune tient sur une ligne avec son résultat (« 4 vulnérabilités », « 3 corrigées », lien vers la pull request). Une étape passée en donne la raison : « rien à corriger » quand `npm audit fix` a tout corrigé, « rien à pousser » quand les corrections n'ont rien changé, « ignorée » sinon. Les vulnérabilités sans aucune version corrigée publiée sur le registre npm (`fixAvailable: false`, par exemple `xlsx`, que SheetJS ne publie plus sur npm) sont comptées sur la ligne du dernier audit (« 1 sans correctif ») ; un clic les liste avec leur gravité : leur mise à jour est à faire à la main. Pendant les corrections par Claude, l'étape montre leur durée, leurs tours et les trois dernières actions de Claude ; ensuite, ce qu'il a changé : résumé, fichiers, tests, vulnérabilités restantes et lien vers sa tâche de rapport. Un échec de Claude s'affiche sous l'étape (« échouées · corrections de npm audit fix seules »). Une fois la pull request ouverte, l'étape du push montre la branche et « voir les changements » (paquets mis à jour, replié) ; tant que la pull request attend, elle propose aussi « Mergée » et « Mergée, à déployer », comme l'onglet « PR en attente ». Une erreur s'affiche sous l'étape qui a échoué. L'onglet « Claude » montre la session : sa tâche de rapport, le déroulé complet de ses messages et de ses actions (500 derniers) et son résultat : le résumé des corrections, les fichiers modifiés, le commit, les tests et les vulnérabilités restantes, ou la raison de l'échec. L'onglet « Journal » montre les commandes lancées et leurs résultats ; « Annuler » arrête l'opération.
223
207
 
224
208
  Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les secondes pendant une opération. Un écran rouvert affiche aussitôt la dernière réponse reçue, puis se met à jour ; seuls les réglages attendent une lecture fraîche.
225
209
 
@@ -240,9 +224,10 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
240
224
  | `GET /api/audit-all`, `POST /api/audit-all` | État de la dernière série « Auditer tout » (`null` si aucune depuis le démarrage) : en cours ou non, dépôts traités sur le total, laissés de côté, en échec avec la raison ; lancement d'une série sur le périmètre `scope` du corps (`production` ou `all`) et les dépôts de `target` : `{ "kind": "all" }`, `{ "kind": "category", "categoryId": … }` ou `{ "kind": "queue" }` (`404` si la catégorie n'existe pas, `409` si une série est en cours). |
241
225
  | `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
242
226
  | `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
243
- | `PUT` / `DELETE /api/repos/:propriétaire/:nom/deprecated` | Marque le dépôt déprécié (`409` pendant une opération) et le retire de la file d'attente ; le rétablit et relit ses alertes. |
227
+ | `PUT` / `DELETE /api/repos/:propriétaire/:nom/deprecated` | Marque le dépôt déprécié (`409` pendant une opération) et lui retire la file d'attente et la marque « à déployer » ; le rétablit et relit ses alertes. |
244
228
  | `PUT` / `DELETE /api/repos/:propriétaire/:nom/queued` | Met le dépôt dans la file d'attente (`409` pour un dépôt déprécié ; sans effet s'il y est déjà) ; l'en retire. |
245
229
  | `PUT` / `DELETE /api/repos/:propriétaire/:nom/deploy-pending` | Marque le dépôt « à déployer » (`409` pour un dépôt déprécié ; sans effet s'il l'est déjà) ; retire la marque. |
230
+ | `PUT /api/repos/:propriétaire/:nom/merged` | Retire les pull requests en attente du dépôt, que l'utilisateur dit mergées (`{ deploy }` : avec `true`, le dépôt passe aussi « à déployer » ; `409` pour un dépôt déprécié). |
246
231
  | `PUT /api/repos/:propriétaire/:nom/rights` | Droits de l'agent. |
247
232
  | `GET /api/repos/:propriétaire/:nom/branches`, `PUT …/branch` | Branches du dépôt, la branche par défaut en tête ; choix de la branche analysée (`{ branch }`, qui doit exister). |
248
233
  | `PUT` / `DELETE /api/repos/:propriétaire/:nom/alerts/:numéro/handled` | Marque une alerte ouverte corrigée à la main ; retire la marque. |
@@ -251,18 +236,17 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
251
236
  | `PUT` / `DELETE /api/categories/:id` | Renommage (`{ name }`) ; suppression, ses dépôts restant sans catégorie. |
252
237
  | `PUT /api/categories/:id/queued` | Met dans la file d'attente les dépôts non dépréciés de la catégorie qui n'y sont pas encore ; rend la liste des dépôts et des catégories. |
253
238
  | `POST /api/repos/:propriétaire/:nom/operations` | Lance une correction sur le périmètre `scope` du corps (`production` ou `all`). |
254
- | `GET /api/repos/:owner/:name/operations` | Historique du dépôt : ses opérations conservées, sans journal ni sessions de Claude. |
255
- | `GET /api/operations/:id` | Opération, avec les sessions de Claude. |
256
- | `POST /api/operations/:id/force`, `/repair`, `/push`, `/cancel` | Décision `--force` (`{ apply }`), corrections par Claude lancées, relancées ou passées (`{ run }`), push (`{ commitMessage }`), annulation. |
257
- | `GET /api/operations/:id/remarks` | Tâche de l'analyse de l'opération et ses commentaires récents, lus sur l'organizer. |
258
- | `GET /api/settings`, `PUT /api/settings` | Réglages de l'analyse, tokens réduits à leurs quatre derniers caractères ; enregistrement (`{ organizerUrl, organizerToken?, claudeToken?, analysis }`, un token absent est gardé), refusé si la connexion à l'organizer ou le token Claude échoue. |
239
+ | `GET /api/repos/:owner/:name/operations` | Historique du dépôt : ses opérations conservées, sans journal ni session de Claude. |
240
+ | `GET /api/operations/:id` | Opération, avec la session de Claude. |
241
+ | `POST /api/operations/:id/cancel` | Annulation d'une opération en cours. |
242
+ | `GET /api/settings`, `PUT /api/settings` | Réglages des corrections par Claude, tokens réduits à leurs quatre derniers caractères ; enregistrement (`{ organizerUrl, organizerToken?, claudeToken?, analysis }`, un token absent est gardé), refusé si la connexion à l'organizer ou le token Claude échoue. |
259
243
  | `POST /api/settings/organizer/test` | Reteste la connexion enregistrée à l'organizer. |
260
244
 
261
- Erreurs : `400` requête invalide, `404` introuvable, `409` conflit (opération déjà en cours, étape qui n'attend pas cette décision), `500` sinon.
245
+ Erreurs : `400` requête invalide, `404` introuvable, `409` conflit (opération déjà en cours ou déjà terminée, dépôt déprécié), `500` sinon.
262
246
 
263
247
  ### Persistance
264
248
 
265
- `<données>/repos.json` pour les catégories et les dépôts (catégorie, droits, alertes, alertes corrigées à la main, dernière lecture, date de dépréciation), `<données>/operations/<id>.json` pour chaque opération (analyse par Claude comprise) ; les 20 plus récentes sont conservées par dépôt. `<données>/settings.json` porte les réglages de l'analyse et ses tokens, `<données>/claude` la configuration de Claude Code. Plusieurs instances du serveur (une par session d'agent) partagent le répertoire : les écritures sont atomiques et passent par le verrou `<données>/data.lock`. Une opération lancée par une instance se poursuit, s'annule ou se décide depuis la GUI d'une autre.
249
+ `<données>/repos.json` pour les catégories et les dépôts (catégorie, droits, alertes, alertes corrigées à la main, dernière lecture, date de dépréciation), `<données>/operations/<id>.json` pour chaque opération (session de Claude comprise) ; les 20 plus récentes sont conservées par dépôt. `<données>/settings.json` porte les réglages des corrections par Claude et leurs tokens, `<données>/claude` la configuration de Claude Code. Plusieurs instances du serveur (une par session d'agent) partagent le répertoire : les écritures sont atomiques et passent par le verrou `<données>/data.lock`. Une opération lancée par une instance se suit et s'annule depuis la GUI d'une autre. Une opération enregistrée par une version qui attendait une décision de l'utilisateur est lue comme annulée.
266
250
 
267
251
  ---
268
252
 
@@ -286,7 +270,7 @@ cd gui && npm run lint # oxlint
286
270
  | `gui/` | Vite + React 19 + zustand, CSS écrit à la main. |
287
271
  | `test/` | Tests `node --test`. |
288
272
 
289
- Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, création et liste des pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, corrigé seulement par `--force` ; `test/fixtures/vulnerable-dev`, le même avec `nth-check` en devDependency, pour le périmètre production) : ils ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` lance le serveur sur stdio avec sa GUI sur un port libre et parcourt les outils, les droits et la correction complète depuis l'API de la GUI. L'analyse et les corrections par Claude passent par un faux Claude Code (`test/fake-claude.ts`, qui note ses appels, appelle les outils du serveur `npm` du tracker et répond en `stream-json`) et un faux organizer (tâches, sous-tâches, commentaires).
273
+ Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, création et liste des pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, qui demande une montée majeure ; `test/fixtures/vulnerable-dev`, le même avec `nth-check` en devDependency, pour le périmètre production) : ils ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` lance le serveur sur stdio avec sa GUI sur un port libre et parcourt les outils, les droits et la correction complète depuis l'API de la GUI. Les corrections par Claude passent par un faux Claude Code (`test/fake-claude.ts`, qui note ses appels, appelle les outils du serveur `npm` du tracker et répond en `stream-json`) et un faux organizer (tâches, assignations, tags).
290
274
 
291
275
  ## Publication
292
276
 
@@ -1,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import { type AlertSeverity, type AnalysisTask, type AuditScope, type Category, type Operation, type Remark, type Repo } from "./model.schema.js";
2
+ import { type AlertSeverity, type AuditScope, type Category, type Operation, type OrganizerTask, type Repo } from "./model.schema.js";
3
3
  /** Corps de `POST /api/repos` : `propriétaire/nom` ou lien GitHub, et la catégorie où le ranger (aucune par défaut). */
4
4
  export declare const AddRepoBodySchema: z.ZodObject<{
5
5
  repository: z.ZodString;
@@ -10,7 +10,6 @@ export declare const SetRightsBodySchema: z.ZodObject<{
10
10
  rights: z.ZodObject<{
11
11
  audit: z.ZodBoolean;
12
12
  fix: z.ZodBoolean;
13
- force: z.ZodBoolean;
14
13
  push: z.ZodBoolean;
15
14
  }, z.core.$strip>;
16
15
  }, z.core.$strip>;
@@ -74,20 +73,11 @@ export declare const AuditAllBodySchema: z.ZodObject<{
74
73
  }, z.core.$strip>], "kind">;
75
74
  }, z.core.$strip>;
76
75
  export type AuditAllBody = z.infer<typeof AuditAllBodySchema>;
77
- /** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
78
- export declare const ForceBodySchema: z.ZodObject<{
79
- apply: z.ZodBoolean;
76
+ /** `deploy` : le dépôt passe aussi « à déployer », son déploiement n'étant pas automatique. */
77
+ export declare const MergedBodySchema: z.ZodObject<{
78
+ deploy: z.ZodBoolean;
80
79
  }, z.core.$strip>;
81
- export type ForceBody = z.infer<typeof ForceBodySchema>;
82
- /** `run` : lancer ou relancer les corrections par Claude ; sinon l'étape est passée. */
83
- export declare const RepairBodySchema: z.ZodObject<{
84
- run: z.ZodBoolean;
85
- }, z.core.$strip>;
86
- export type RepairBody = z.infer<typeof RepairBodySchema>;
87
- export declare const PushBodySchema: z.ZodObject<{
88
- commitMessage: z.ZodString;
89
- }, z.core.$strip>;
90
- export type PushBody = z.infer<typeof PushBodySchema>;
80
+ export type MergedBody = z.infer<typeof MergedBodySchema>;
91
81
  /** Identifiant d'un dépôt dans une requête IPC. */
92
82
  export declare const RepoRequestSchema: z.ZodObject<{
93
83
  repoId: z.ZodString;
@@ -123,8 +113,8 @@ export interface CleanAudit {
123
113
  * qu'a trouvé le dernier audit de la branche par défaut alors que Dependabot ne
124
114
  * signale aucune alerte dans son périmètre ; `unfixable` les paquets pour lesquels le dernier audit n'a
125
115
  * trouvé aucune version corrigée, hors ceux marqués corrigés à la main ;
126
- * `analysisTask` la tâche organizer de la dernière analyse par Claude, tant
127
- * qu'elle n'est pas terminée.
116
+ * `reportTask` la tâche organizer du dernier rapport de Claude, tant qu'elle
117
+ * n'est pas terminée.
128
118
  */
129
119
  export interface RepoView {
130
120
  repo: Repo;
@@ -135,7 +125,7 @@ export interface RepoView {
135
125
  cleanProductionAudit: CleanAudit | null;
136
126
  auditFindings: AuditFindings | null;
137
127
  unfixable: string[];
138
- analysisTask: AnalysisTask | null;
128
+ reportTask: OrganizerTask | null;
139
129
  }
140
130
  /**
141
131
  * Série « Auditer tout » : `done` dépôts traités sur `total`, dont ceux laissés
@@ -176,8 +166,8 @@ export interface OperationResponse {
176
166
  /**
177
167
  * Ligne de l'historique d'un dépôt : une opération sans son journal ni le
178
168
  * déroulé de ses sessions. `after` est le nombre de vulnérabilités après la
179
- * dernière étape qui a audité ; `claudeRuns` le nombre de passages des
180
- * corrections par Claude.
169
+ * dernière étape qui a audité ; `claude` est vrai quand Claude a été lancé
170
+ * pour corriger.
181
171
  */
182
172
  export interface OperationSummary {
183
173
  id: string;
@@ -189,8 +179,7 @@ export interface OperationSummary {
189
179
  createdAt: string;
190
180
  before: number | null;
191
181
  after: number | null;
192
- analysed: boolean;
193
- claudeRuns: number;
182
+ claude: boolean;
194
183
  pullRequest: Operation["pullRequest"];
195
184
  error: string | null;
196
185
  }
@@ -198,11 +187,6 @@ export interface OperationSummary {
198
187
  export interface OperationsResponse {
199
188
  operations: OperationSummary[];
200
189
  }
201
- /** Tâche de l'analyse d'une opération et ses commentaires récents, du plus ancien au plus récent. */
202
- export interface RemarksResponse {
203
- task: AnalysisTask;
204
- remarks: Remark[];
205
- }
206
190
  export interface AppConfig {
207
191
  version: string;
208
192
  dataDir: string;
@@ -22,11 +22,8 @@ export const AuditTargetSchema = z.discriminatedUnion("kind", [
22
22
  ]);
23
23
  /** Corps de `POST /api/audit-all` : le périmètre des audits et les dépôts visés. */
24
24
  export const AuditAllBodySchema = ScopeBodySchema.extend({ target: AuditTargetSchema });
25
- /** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
26
- export const ForceBodySchema = z.object({ apply: z.boolean() });
27
- /** `run` : lancer ou relancer les corrections par Claude ; sinon l'étape est passée. */
28
- export const RepairBodySchema = z.object({ run: z.boolean() });
29
- export const PushBodySchema = z.object({ commitMessage: z.string().trim().min(1) });
25
+ /** `deploy` : le dépôt passe aussi « à déployer », son déploiement n'étant pas automatique. */
26
+ export const MergedBodySchema = z.object({ deploy: z.boolean() });
30
27
  /** Identifiant d'un dépôt dans une requête IPC. */
31
28
  export const RepoRequestSchema = z.object({ repoId: z.string().min(1) });
32
29
  /** Alerte d'un dépôt, par son numéro GitHub. */
@@ -22,5 +22,5 @@ export declare const IPCMessageSchema: z.ZodObject<{
22
22
  }, z.core.$strip>;
23
23
  export type IPCMessage = z.infer<typeof IPCMessageSchema>;
24
24
  /** Requêtes du GUI worker au maître ; chacune reçoit une réponse de même `correlationId`. */
25
- export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_REPOS", "SYNC_REPOS", "GET_AUDIT_ALL", "START_AUDIT_ALL", "LIST_ADDABLE_REPOS", "GET_REPO", "ADD_REPO", "REMOVE_REPO", "DEPRECATE_REPO", "RESTORE_REPO", "QUEUE_REPO", "UNQUEUE_REPO", "MARK_DEPLOY_PENDING", "UNMARK_DEPLOY_PENDING", "QUEUE_CATEGORY", "SET_RIGHTS", "LIST_BRANCHES", "SET_BRANCH", "SET_CATEGORY", "MARK_ALERT_HANDLED", "UNMARK_ALERT_HANDLED", "LIST_CATEGORIES", "CREATE_CATEGORY", "RENAME_CATEGORY", "DELETE_CATEGORY", "START_FIX", "GET_OPERATION", "LIST_OPERATIONS", "DECIDE_FORCE", "DECIDE_REPAIR", "GET_REMARKS", "PUSH_OPERATION", "CANCEL_OPERATION", "GET_SETTINGS", "SAVE_SETTINGS", "TEST_ORGANIZER"];
25
+ export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_REPOS", "SYNC_REPOS", "GET_AUDIT_ALL", "START_AUDIT_ALL", "LIST_ADDABLE_REPOS", "GET_REPO", "ADD_REPO", "REMOVE_REPO", "DEPRECATE_REPO", "RESTORE_REPO", "QUEUE_REPO", "UNQUEUE_REPO", "MARK_DEPLOY_PENDING", "UNMARK_DEPLOY_PENDING", "MARK_PULL_REQUESTS_MERGED", "QUEUE_CATEGORY", "SET_RIGHTS", "LIST_BRANCHES", "SET_BRANCH", "SET_CATEGORY", "MARK_ALERT_HANDLED", "UNMARK_ALERT_HANDLED", "LIST_CATEGORIES", "CREATE_CATEGORY", "RENAME_CATEGORY", "DELETE_CATEGORY", "START_FIX", "GET_OPERATION", "LIST_OPERATIONS", "CANCEL_OPERATION", "GET_SETTINGS", "SAVE_SETTINGS", "TEST_ORGANIZER"];
26
26
  export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];
@@ -31,6 +31,7 @@ export const GUI_REQUEST_TYPES = [
31
31
  "UNQUEUE_REPO",
32
32
  "MARK_DEPLOY_PENDING",
33
33
  "UNMARK_DEPLOY_PENDING",
34
+ "MARK_PULL_REQUESTS_MERGED",
34
35
  "QUEUE_CATEGORY",
35
36
  "SET_RIGHTS",
36
37
  "LIST_BRANCHES",
@@ -45,10 +46,6 @@ export const GUI_REQUEST_TYPES = [
45
46
  "START_FIX",
46
47
  "GET_OPERATION",
47
48
  "LIST_OPERATIONS",
48
- "DECIDE_FORCE",
49
- "DECIDE_REPAIR",
50
- "GET_REMARKS",
51
- "PUSH_OPERATION",
52
49
  "CANCEL_OPERATION",
53
50
  "GET_SETTINGS",
54
51
  "SAVE_SETTINGS",