@imenam/mcp-dependabot-tracker 1.0.31 → 1.0.32

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.
Files changed (48) hide show
  1. package/README.md +41 -28
  2. package/dist/shared/schemas/model.schema.d.ts +64 -8
  3. package/dist/shared/schemas/model.schema.js +23 -8
  4. package/dist/src/core/commands.d.ts +5 -7
  5. package/dist/src/core/commands.js +7 -11
  6. package/dist/src/core/containers.d.ts +82 -0
  7. package/dist/src/core/containers.js +144 -0
  8. package/dist/src/core/managers/composer.d.ts +15 -0
  9. package/dist/src/core/managers/composer.js +234 -0
  10. package/dist/src/core/managers/index.d.ts +14 -0
  11. package/dist/src/core/managers/index.js +46 -0
  12. package/dist/src/core/managers/npm.d.ts +25 -0
  13. package/dist/src/core/managers/npm.js +203 -0
  14. package/dist/src/core/managers/php-version.d.ts +18 -0
  15. package/dist/src/core/managers/php-version.js +113 -0
  16. package/dist/src/core/managers/pnpm.d.ts +28 -0
  17. package/dist/src/core/managers/pnpm.js +249 -0
  18. package/dist/src/core/managers/tool-args.d.ts +17 -0
  19. package/dist/src/core/managers/tool-args.js +26 -0
  20. package/dist/src/core/managers/types.d.ts +61 -0
  21. package/dist/src/core/managers/types.js +11 -0
  22. package/dist/src/core/operations.d.ts +8 -5
  23. package/dist/src/core/operations.js +106 -77
  24. package/dist/src/core/repair.d.ts +20 -13
  25. package/dist/src/core/repair.js +110 -84
  26. package/dist/src/core/repos.d.ts +1 -1
  27. package/dist/src/core/repos.js +1 -1
  28. package/dist/src/core/sandbox.d.ts +7 -0
  29. package/dist/src/core/sandbox.js +31 -0
  30. package/dist/src/core/settings.d.ts +1 -1
  31. package/dist/src/core/settings.js +2 -2
  32. package/dist/src/core/store.js +3 -0
  33. package/dist/src/mcp.js +6 -5
  34. package/dist/src/package-tools.d.ts +13 -0
  35. package/dist/src/package-tools.js +92 -0
  36. package/dist/src/server/serve.js +2 -0
  37. package/dist/src/tools/format.js +11 -11
  38. package/dist/src/tools/tools.js +4 -4
  39. package/gui/dist/assets/index-DrVmedqf.js +71 -0
  40. package/gui/dist/index.html +1 -1
  41. package/package.json +2 -2
  42. package/dist/src/core/npm-audit.d.ts +0 -26
  43. package/dist/src/core/npm-audit.js +0 -76
  44. package/dist/src/core/npm-sandbox.d.ts +0 -33
  45. package/dist/src/core/npm-sandbox.js +0 -159
  46. package/dist/src/npm-tools.d.ts +0 -10
  47. package/dist/src/npm-tools.js +0 -136
  48. package/gui/dist/assets/index-CAOy2g1q.js +0 -71
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # @imenam/mcp-dependabot-tracker
2
2
 
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 web ou par un agent.
3
+ Suivi des alertes Dependabot de dépôts GitHub, et correction de leurs dépendances vulnérables (projets npm, pnpm et Composer) dans un clone temporaire, depuis une interface web ou par un agent.
4
4
 
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.
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), audit de chaque projet, corrections automatiques de son gestionnaire de paquets, corrections par Claude s'il reste des vulnérabilités, puis commit sur une nouvelle branche, push et pull request.
6
6
 
7
7
  Le paquet s'utilise de deux façons, qui ne se recouvrent pas :
8
8
 
@@ -17,7 +17,7 @@ Agent ──stdio──▶ mode MCP ──│ interface, API, │ ─
17
17
  + token└──────────────────────────┘
18
18
  ```
19
19
 
20
- L'agent fait ce que fait l'utilisateur pour les corrections : il liste les dépôts, lance des audits et des corrections, corrections par Claude comprises, les suit et les annule. Il n'exécute jamais `git` ni `npm` lui-même. Les réglages, les catégories, la file d'attente et les tokens restent dans l'interface. Quand `npm audit fix` laisse des vulnérabilités, une correction fait **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)).
20
+ L'agent fait ce que fait l'utilisateur pour les corrections : il liste les dépôts, lance des audits et des corrections, corrections par Claude comprises, les suit et les annule. Il n'exécute jamais `git` ni un gestionnaire de paquets lui-même. Les réglages, les catégories, la file d'attente et les tokens restent dans l'interface. Quand `npm audit fix` laisse des vulnérabilités, une correction fait **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)).
21
21
 
22
22
  ---
23
23
 
@@ -30,7 +30,18 @@ npm install -g @imenam/mcp-dependabot-tracker
30
30
  mcp-dependabot-tracker serve
31
31
  ```
32
32
 
33
- Ou via `npx -y @imenam/mcp-dependabot-tracker serve`. Le serveur se lance comme un service (systemd, conteneur…) : il tourne en continu, que des agents soient connectés ou non, et une correction en cours survit à la fermeture de l'agent qui l'a lancée. `git` et `npm` (npm 7 ou plus récent) doivent être dans le `PATH` de la machine qui l'exécute, ainsi que bubblewrap sous Linux (`sudo apt-get install -y bubblewrap socat`) : toutes les commandes npm d'une opération y tournent en bac à sable. 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.
33
+ Ou via `npx -y @imenam/mcp-dependabot-tracker serve`. Le serveur se lance comme un service (systemd, conteneur…) : il tourne en continu, que des agents soient connectés ou non, et une correction en cours survit à la fermeture de l'agent qui l'a lancée. `git` et **Podman** doivent être dans le `PATH` de la machine qui l'exécute : toutes les commandes des gestionnaires de paquets d'une opération (`npm audit`, `npm audit fix`, installations et tests des corrections par Claude) tournent dans des conteneurs Podman jetables (voir [Une opération](#une-opération)), si bien que le serveur n'a besoin ni de npm ni d'aucun autre outil des projets audités. Claude Code, utilisé par les corrections par Claude, est une dépendance du package (`@anthropic-ai/claude-code`, Node 22 ou plus récent) ; sous Linux, il exige bubblewrap (`sudo apt-get install -y bubblewrap socat`, voir [Les corrections par Claude](#les-corrections-par-claude)).
34
+
35
+ Podman doit tourner en mode **rootless**, sous le compte non privilégié du service : le tracker le vérifie au début de chaque opération (`podman info`) et refuse de travailler avec un Podman rootful. Sur Ubuntu 24.04 :
36
+
37
+ ```bash
38
+ sudo apt-get install -y podman uidmap passt
39
+ grep "^$(whoami):" /etc/subuid /etc/subgid
40
+ sudo loginctl enable-linger "$(whoami)"
41
+ podman info --format '{{.Host.Security.Rootless}}'
42
+ ```
43
+
44
+ La deuxième commande doit afficher une plage pour le compte dans `/etc/subuid` et dans `/etc/subgid` ; sinon, ajoutez-en une (`sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 "$(whoami)"`), puis lancez `podman system migrate`. La dernière doit afficher `true`. Un service systemd lancé sous ce compte déclare aussi le dossier d'exécution de l'utilisateur, que Podman rootless attend : `Environment=XDG_RUNTIME_DIR=/run/user/<uid du compte>`.
34
45
 
35
46
  Le serveur exige une clé de coffre, `VAULT_KEY`, qui chiffre les clés privées SSH des serveurs de déploiement et les tokens de l'organizer et de Claude. Générez-la une fois et déclarez-la comme variable secrète du service :
36
47
 
@@ -174,7 +185,7 @@ Le mode MCP se déclare dans un gateway ([mcp-http-gateway](https://www.npmjs.co
174
185
  }
175
186
  ```
176
187
 
177
- Le gateway n'héberge que le mode MCP : clones, `npm`, Claude Code et appels à GitHub ont lieu sur la machine du serveur, qui doit joindre GitHub et le registre npm. Aucune route d'exécution (`GATEWAY_EXEC_ROUTES`) n'est nécessaire côté agent.
188
+ Le gateway n'héberge que le mode MCP : clones, conteneurs Podman, Claude Code et appels à GitHub ont lieu sur la machine du serveur, qui doit joindre GitHub et le registre npm. Aucune route d'exécution (`GATEWAY_EXEC_ROUTES`) n'est nécessaire côté agent.
178
189
 
179
190
  ---
180
191
 
@@ -186,8 +197,8 @@ Six outils, en anglais, servis par le mode MCP. Le compte rendu d'une opération
186
197
  |---|---|
187
198
  | `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), pull requests du tracker pas encore mergées, opération en cours. |
188
199
  | `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. |
189
- | `run_audit` | Lance `npm audit` dans un clone temporaire de la branche analysée, sur le périmètre `scope` (`production` par défaut, ou `all`). Rien n'est modifié. Rend aussitôt l'identifiant de l'opération. |
190
- | `fix_vulnerabilities` | Lance la même correction que le bouton « Corriger » de l'interface, sur le périmètre `scope` : `npm audit`, `npm audit fix`, corrections par Claude s'il reste des vulnérabilités, puis commit, push et pull request vers la branche analysée. Avec `claude: false`, les corrections par Claude sont passées et seules celles de `npm audit fix` sont poussées. Rend aussitôt l'identifiant de l'opération. |
200
+ | `run_audit` | Lance l'audit de chaque projet (`npm audit`, `pnpm audit`, `composer audit`) dans un clone temporaire de la branche analysée, sur le périmètre `scope` (`production` par défaut, ou `all`). Rien n'est modifié. Rend aussitôt l'identifiant de l'opération. |
201
+ | `fix_vulnerabilities` | Lance la même correction que le bouton « Corriger » de l'interface, sur le périmètre `scope` : audit, corrections automatiques, corrections par Claude s'il reste des vulnérabilités, puis commit, push et pull request vers la branche analysée. Avec `claude: false`, les corrections par Claude sont passées et seules les corrections automatiques sont poussées. Rend aussitôt l'identifiant de l'opération. |
191
202
  | `get_operation` | État d'une opération (`operation`) : en cours, terminée, échouée ou annulée ; l'étape en cours (et, pendant les corrections par Claude, ses tours et ses dernières actions), les vulnérabilités avant et après, les paquets mis à jour, le résumé des corrections par Claude, leurs tests et leur tâche, la pull request, l'erreur. |
192
203
  | `cancel_operation` | Annule une opération en cours (`operation`) : sa commande s'arrête, Claude Code compris, le clone est supprimé et rien n'est poussé. |
193
204
 
@@ -199,19 +210,21 @@ Un dépôt déprécié est refusé par tous les outils, jusqu'à ce que l'utilis
199
210
 
200
211
  Chaque opération travaille dans un clone temporaire (`<DATA_DIR>/clones/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.
201
212
 
213
+ **Conteneurs** — chaque commande d'un gestionnaire de paquets tourne dans un conteneur Podman rootless créé pour elle et supprimé à sa fin (`podman run --rm`), à partir d'une image officielle (`docker.io/library/node:26-slim` pour npm et pnpm), ou d'une image construite par le tracker pour Composer : `localhost/mcp-dependabot-tracker/composer:php<version>`, faite de l'image officielle `docker.io/library/php:<version>-cli`, du binaire de `docker.io/composer/composer:2-bin`, de `git` et de `unzip`. La version de PHP suit `config.platform.php` du `composer.json` (la version que Composer suppose pour résoudre), sinon la plus ancienne des versions des images officielles (8.2 à 8.5) qui satisfait `require.php`, sinon la plus récente ; un projet qu'aucune ne satisfait fait échouer l'opération avec la raison. Au début de l'opération, le tracker vérifie que Podman est rootless, puis met chaque image à jour, une fois par opération (`podman pull`, ou `podman build --pull=newer`, qui reprend les couches déjà construites, à partir d'un dossier temporaire qui ne contient que le Containerfile) ; chaque conteneur l'utilise ensuite telle quelle (`--pull=never`). Quand une image a changé, sa version précédente est supprimée (`podman rmi`, qui emporte aussi ses couches devenues orphelines) : les mises à jour n'accumulent pas d'anciennes images sur le disque. Une version précédente encore utilisée par un conteneur est laissée, et le refus noté au journal de l'opération. Les caches de npm, de pnpm et de Composer, eux, vivent et meurent avec l'opération. Seuls le clone (`/work`, en écriture) et le cache de l'opération (`/cache`, à côté du clone) y sont montés : ni les données du tracker, ni les autres clones, ni aucun autre dossier du serveur. Le conteneur n'a aucune capacité (`--cap-drop=all`), ne peut pas gagner de privilèges (`no-new-privileges`), garde son système de fichiers en lecture seule hors de ces montages et d'un `/tmp` vide (`--read-only`), et tourne sous l'identité du compte du serveur (`--userns=keep-id`) : les fichiers qu'il écrit dans le clone lui appartiennent. Il ne reçoit aucune variable du serveur, hormis le proxy (`HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY`) : ni token, ni secret. Le réseau reste ouvert pour le registre. pnpm est lancé par `npm exec --package=pnpm@<version> -- pnpm`, dans la version du champ `packageManager` du projet si elle sait auditer (pnpm 11 ou plus récent), en pnpm 11 sinon : l'API d'audit qu'interrogent les versions précédentes a fermé (`pnpm_config_pm_on_fail=ignore` empêche pnpm de basculer vers la version de `packageManager`). Une annulation ou un dépassement de délai supprime le conteneur (`podman rm --force`), qui survivrait sinon à l'arrêt du client `podman`.
214
+
202
215
  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.
203
216
 
204
- 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.
217
+ Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit ou de « Auditer tout » : **production** (par défaut) laisse de côté les dépendances de développement (`--omit=dev` pour npm, `--prod` pour pnpm, `--no-dev` pour l'audit Composer) ; **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.
205
218
 
206
- 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é.
207
- 2. **npm audit** — `npm audit --json` dans chaque projet, avec `--omit=dev` en production.
208
- 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.
209
- 4. **Corrections par Claude** — pour une correction, 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 quand l'agent lance la correction avec `claude: false`. Un échec, Claude non configuré compris, laisse la correction se poursuivre avec les seules corrections de `npm audit fix`.
210
- 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.
219
+ 1. **Cloner le dépôt** — puis repérer les projets : chaque dossier dont le lockfile d'un gestionnaire de paquets est suivi par git, `package-lock.json` pour npm (racine, `gui/`…), `pnpm-lock.yaml` pour pnpm, `composer.lock` pour Composer. Un workspace pnpm est un seul projet : ses paquets n'ont pas de lockfile à eux. Un dépôt peut mêler les gestionnaires (une API PHP et son interface npm) : une même opération les audite et les corrige tous. Un dépôt sans lockfile fait échouer l'opération. Un lockfile v1 de npm (npm 6) et un lockfile pnpm antérieur au format 9 sont refusés. Puis mettre à jour les images des conteneurs, ou construire celles des projets Composer.
220
+ 2. **Audit** — dans chaque projet : `npm audit --json`, avec `--omit=dev` en production ; `pnpm audit --json`, avec `--prod` en production ; `composer audit --locked --format=json --no-scripts --no-plugins`, avec `--no-dev` en production. pnpm donne un avis par faille : le tracker en fait une vulnérabilité par paquet, avec la gravité la plus haute de ses avis ; la correction est « majeure » quand la plus petite version corrigée change la version majeure installée, absente quand aucune version corrigée n'est publiée. Composer ne donne que les versions touchées, sans version corrigée : la correction d'une vulnérabilité Composer est « inconnue », et un avis sans gravité compte comme `info`.
221
+ 3. **Corrections automatiques** — dans chaque projet vulnérable, seuls les lockfiles (et, pour pnpm, les plages des `package.json`) changent, sans installation de `node_modules` ni script de paquet : `npm audit fix --package-lock-only --ignore-scripts` ; `pnpm audit --fix=update --lockfile-only --ignore-scripts`, avec `--prod` en production ; `composer update <paquets vulnérables> --with-all-dependencies --no-install --no-scripts --no-plugins --no-audit --ignore-platform-req=ext-*`, dans les contraintes de `composer.json` (les extensions PHP du projet ne changent pas la résolution, et l'image ne les a pas forcément). Quand Composer ne trouve aucune mise à jour possible dans ces contraintes (code de sortie 2), le journal le note et l'opération continue : il reste des vulnérabilités, comme quand `npm audit fix` n'en corrige pas. 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.
222
+ 4. **Corrections par Claude** — pour une correction, dès que des vulnérabilités restent : la branche `fix/deps-audit-<AAAA-MM-JJ>-<HHMMSS>` (heure locale du serveur) est créée, les fichiers modifiés par les corrections automatiques 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 quand l'agent lance la correction avec `claude: false`. Un échec, Claude non configuré compris, laisse la correction se poursuivre avec les seules corrections de `npm audit fix`.
223
+ 5. **Commit et push** — commit des fichiers modifiés sur la branche `fix/deps-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.
211
224
 
212
- **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.
225
+ **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/deps-audit-<AAAA-MM-JJ>-<HHMMSS>` (ou `fix/npm-audit-…`, celui des versions précédentes) 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.
213
226
 
214
- **Auditer tout** — depuis l'accueil, un audit seul (clone et `npm audit`, sans correction) de la **branche analysée** (celle que clone une correction) 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 »). 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 serveur ; une seule à la fois.
227
+ **Auditer tout** — depuis l'accueil, un audit seul (clone et audit, sans correction) de la **branche analysée** (celle que clone une correction) 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 »). 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 lockfile, clone impossible) n'arrête pas les autres. La série vit dans le serveur ; une seule à la fois.
215
228
 
216
229
  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.
217
230
 
@@ -223,16 +236,16 @@ Depuis l'interface comme pour l'agent, une opération se lance aussitôt et va d
223
236
 
224
237
  ## Les corrections par Claude
225
238
 
226
- Quand `npm audit fix` laisse des vulnérabilités dans une correction, lancée depuis l'interface ou par un agent qui n'a pas passé `claude: false`, le tracker enchaîne sans attendre :
239
+ Quand les corrections automatiques laissent des vulnérabilités dans une correction, lancée depuis l'interface ou par un agent qui n'a pas passé `claude: false`, le tracker enchaîne sans attendre :
227
240
 
228
- 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é ;
229
- 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 ;
230
- 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 ;
231
- 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.
241
+ 1. il crée la branche `fix/deps-audit-…` et y commite les fichiers modifiés par les corrections automatiques (premier commit, avec le message par défaut), s'ils ont changé ;
242
+ 2. il lance une session Claude Code non interactive (`claude -p`) dans le clone, avec les vulnérabilités restantes (extraites du dernier audit, avec le gestionnaire de chaque projet) et la consigne propre à chaque gestionnaire du dépôt. Claude analyse chaque vulnérabilité dans le code (usage du paquet, faille atteignable ou non, urgence), monte ou épingle les dépendances (`package.json` et ses `overrides`, `overrides` de `pnpm-workspace.yaml`, contraintes de `composer.json`, puis mise à jour du lockfile), adapte le code, relance l'audit, installe les dépendances et lance les tests, par les outils du tracker ;
243
+ 3. Claude rédige son rapport, en français : 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. Avec un organizer réglé, ce rapport est **une seule tâche** « Rapport de correction — … » de l'espace, assignée à son propriétaire et taguée du nom du dépôt ; l'organizer est facultatif : sans lui, le rapport rejoint la pull request, dans un bloc repliable « Rapport de Claude ». Claude rend un rapport structuré (`--json-schema`) : clé de la tâche (avec l'organizer) ou rapport détaillé (sans), résumé, fichiers modifiés, message de commit, résultat des tests ;
244
+ 4. le tracker vérifie la tâche, avec l'organizer (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` ni le `vendor` des projets Composer, relance `npm audit`, puis pousse la branche et ouvre la pull request.
232
245
 
233
- 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.
246
+ 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, le token Claude non réglé, ou un bac à sable impossible : le clone revient au commit des corrections automatiques, l'erreur s'affiche sous l'étape, et la correction pousse quand même les corrections automatiques, avec un avertissement en tête de la pull request. L'annulation de l'opération arrête Claude Code.
234
247
 
235
- **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`). Le clone n'a pas de dossier `.git` : le dépôt git de l'opération est à côté de lui (`GIT_DIR`), hors de portée de Claude et des commandes npm, et le tracker lance `git` sans hook (`core.hooksPath`) ni moniteur de fichiers (`core.fsmonitor`) ; un hook posé dans le clone par un paquet (husky…) ou par un script d'installation ne s'exécute donc jamais sur le serveur. 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, le même que celui où le tracker lance ses propres `npm audit` et `npm audit fix` : le contenu du dépôt (`.npmrc` compris) n'agit jamais hors de lui. Seul le système y est visible, en lecture seule : `/usr`, Node.js, et de `/etc` les seuls fichiers utiles au réseau, aux comptes et aux certificats (`resolv.conf`, `hosts`, `passwd`, `ssl`…), ni `/opt`, ni `/home`, ni le reste de `/etc` ; 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`). Au début de chaque opération et avant chaque session de Claude, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, l'opération ou la session est refusée 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` et `set_tags` sont autorisés : Claude ne lit aucune autre tâche de l'espace, dont le contenu ne peut donc pas finir dans la pull request ; tout autre appel est refusé (`--permission-mode dontAsk`). La consigne précise que les fichiers du dépôt, les sorties de npm et les avis de sécurité sont des données à analyser, jamais des instructions, et demande de signaler dans la tâche tout texte qui tenterait de le détourner, 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 par Claude. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session. Pour garder en lecture seule `.npmrc`, `.yarnrc`, `.yarnrc.yml`, `bunfig.toml`, `.gitmodules`, `yarn.lock` et `pnpm-lock.yaml`, le bac à sable de Claude Code les crée vides dans le clone quand le dépôt n'en a pas : ces fichiers vides sont retirés avant le commit des corrections.
248
+ **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`). Le clone n'a pas de dossier `.git` : le dépôt git de l'opération est à côté de lui (`GIT_DIR`), hors de portée de Claude et des commandes npm, et le tracker lance `git` sans hook (`core.hooksPath`) ni moniteur de fichiers (`core.fsmonitor`) ; un hook posé dans le clone par un paquet (husky…) ou par un script d'installation ne s'exécute donc jamais sur le serveur. Claude lance les gestionnaires de paquets par les outils d'un second serveur MCP, `packages`, que le tracker lui fournit (`dist/src/package-tools.js`) avec les seuls outils des gestionnaires des projets du dépôt ; pour npm : `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`) ; pour pnpm : `pnpm_install_lockfile` (`pnpm install --lockfile-only --ignore-scripts`), `pnpm_audit`, `pnpm_install` (`--frozen-lockfile`), `pnpm_test` (`pnpm -r --if-present run test`), `pnpm_run` (un script, à la racine ou dans un paquet du workspace avec `--filter`) et `pnpm_why` (`pnpm why -r`) ; pour Composer : `composer_update_lock` (`composer update <paquets> --with-all-dependencies --no-install --no-scripts --no-plugins --ignore-platform-req=ext-*`, paquets obligatoires), `composer_audit`, `composer_install`, `composer_test` (`composer run-script test`), `composer_run` (un script de `composer.json`) et `composer_why` (`composer depends --locked --tree`). L'image n'a que les extensions par défaut de l'image officielle de PHP : une extension manquante à l'installation ou aux tests est signalée dans le rapport, pas corrigée. 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, chacune dans un conteneur jetable du tracker, comme ses propres `npm audit` et `npm audit fix` (voir [Une opération](#une-opération)) : le code du projet et de ses paquets, `.npmrc` compris, ne s'exécute jamais sur le serveur, et le conteneur ne voit que le clone et le cache de l'opération, sans aucun token. 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, cette variable active d'office le bac à sable de Claude Code, qui refuse alors de démarrer sans bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). Avant chaque session de Claude, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, la session est refusée 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` et `set_tags` sont autorisés : Claude ne lit aucune autre tâche de l'espace, dont le contenu ne peut donc pas finir dans la pull request ; tout autre appel est refusé (`--permission-mode dontAsk`). La consigne précise que les fichiers du dépôt, les sorties de npm et les avis de sécurité sont des données à analyser, jamais des instructions, et demande de signaler dans la tâche tout texte qui tenterait de le détourner, 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 par Claude. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session. Pour garder en lecture seule `.npmrc`, `.yarnrc`, `.yarnrc.yml`, `bunfig.toml`, `.gitmodules`, `yarn.lock` et `pnpm-lock.yaml`, le bac à sable de Claude Code les crée vides dans le clone quand le dépôt n'en a pas : ces fichiers vides sont retirés avant le commit des corrections.
236
249
 
237
250
  **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.
238
251
 
@@ -240,7 +253,7 @@ Une tâche introuvable, sans le tag ou non assignée au propriétaire fait écho
240
253
 
241
254
  - **Serveurs de déploiement** — les serveurs connectés en SSH, partagés par les dépôts (voir [Le déploiement](#le-déploiement)).
242
255
  - **GitHub** — le token du tracker et le token de déploiement (voir [Tokens GitHub](#tokens-github)) ; « Retirer », confirmé par un second clic, supprime le token de déploiement.
243
- - **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.
256
+ - **Organizer** (facultatif) — où Claude dépose son rapport ; sans organizer, le rapport est dans la pull request. 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.
244
257
  - **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.
245
258
  - **Corrections par Claude** — les limites d'une session.
246
259
  - **Accès des agents** — les tokens d'agent, un par ligne : nom, quatre derniers caractères, date de création et de dernière utilisation ; « Révoquer », au survol (en permanence sur un écran tactile), le révoque après un second clic de confirmation dans les 4 secondes. « Nouveau token » ouvre un champ en place pour le nommer (Entrée crée, Échap annule) ; le token s'affiche alors une seule fois, avec « Copier » et la commande `--claude-setup-mcp` qui déclare le mode MCP. Créer ou révoquer un token prend effet aussitôt, sans « Enregistrer ».
@@ -315,7 +328,7 @@ Thème sombre, une information par ligne, une action principale par écran.
315
328
  - **Réglages (`#/settings`)** — serveurs de déploiement, tokens GitHub, connexion à l'organizer, token Claude, limites des corrections par Claude et tokens d'accès des agents (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 les tokens, l'organizer et les limites ; les serveurs et les tokens d'agent se créent, se modifient et se suppriment aussitôt.
316
329
  - **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é.
317
330
  - **Dépôt (`#/r/<propriétaire>/<nom>`, `#/r/<propriétaire>/<nom>/history`)** — le nom du dépôt, suivi d'une icône qui ouvre sa page GitHub dans un nouvel onglet (sur le serveur de `GITHUB_SERVER_URL`), 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 trois 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. **Déploiement** (`…/deploy`) : sans serveur, « Choisir un serveur » ouvre la liste des serveurs des Réglages. Avec un serveur : sa ligne (le nom, qui ouvre la même liste pour changer de serveur ou ne plus déployer ce dépôt, l'adresse, le dernier déploiement, « Connecté », « À tester » ou « Clé révoquée », ces deux dernières menant aux Réglages, et « Déployer »), le script coloré avec « Modifier », puis les derniers déploiements (branche, commit, date, durée, issue), chacun ouvrant son détail (`…/deploy/<id>`) : le script avec la ligne en échec surlignée et la sortie. Pendant un déploiement, l'onglet montre son exécution : la ligne en cours surlignée, les suivantes estompées, la sortie qui défile, et « Interrompre » à la place de « Déployer ». « 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 de la corbeille, « 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é). La corbeille retire le dépôt du suivi : elle devient « Confirmer le retrait », qu'un second clic dans les 4 secondes confirme ; refusé pendant une opération.
318
- - **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.
331
+ - **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 les corrections automatiques ont 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 (pour npm, `fixAvailable: false`, par exemple `xlsx`, que SheetJS ne publie plus sur npm ; pour pnpm, aucune version corrigée dans l'avis) 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 automatiques 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.
319
332
 
320
333
  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.
321
334
 
@@ -403,18 +416,18 @@ cd gui && npm run lint # oxlint
403
416
  | `src/server/` | Serveur : démarrage, exposition, relecture périodique (`serve.ts`) ; routes de l'interface, de l'API des agents et fichiers de la SPA (`app.ts`). |
404
417
  | `src/mcp.ts` | Mode MCP : `instructions` et serveur stdio des outils. |
405
418
  | `src/tools/` | Outils du mode MCP, client de l'API des agents, mise en forme des résultats. |
406
- | `src/core/` | Stockage, tokens d'agent, client GitHub, commandes `git`/`npm`, rapports `npm audit` et lockfiles, opérations, dépôts ; coffre (`vault.ts`), connexion SSH (`ssh.ts`), serveurs de déploiement (`deploy-servers.ts`) et déploiements (`deployments.ts`) ; configuration du serveur (`server-config.ts`) et authentification (`auth.ts`). |
407
- | `src/npm-tools.ts` | Serveur MCP des commandes npm fourni à Claude Code pendant ses corrections. |
419
+ | `src/core/` | Stockage, tokens d'agent, client GitHub, commandes `git`, conteneurs Podman (`containers.ts`), gestionnaires de paquets (`managers/` : repérage des projets, audit, corrections automatiques, lecture des lockfiles, outils de Claude ; un fichier par gestionnaire), rapports `npm audit` et lockfiles, opérations, dépôts ; coffre (`vault.ts`), connexion SSH (`ssh.ts`), serveurs de déploiement (`deploy-servers.ts`) et déploiements (`deployments.ts`) ; configuration du serveur (`server-config.ts`) et authentification (`auth.ts`). |
420
+ | `src/package-tools.ts` | Serveur MCP des commandes des gestionnaires de paquets fourni à Claude Code pendant ses corrections. |
408
421
  | `src/cli/setup-mcp.ts` | Commande `--claude-setup-mcp`. |
409
422
  | `src/cli/users.ts` | Commandes `user add`, `user password`, `user totp`, `user remove`, `user list`. |
410
423
  | `shared/schemas/` | Schémas zod communs au serveur et à la GUI. |
411
424
  | `gui/` | Vite + React 19 + zustand, CSS écrit à la main. |
412
425
  | `test/` | Tests `node --test`. |
413
426
 
414
- 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). Leurs manifestes s'appellent `package.fixture.json` et `package-lock.fixture.json`, pour que ni le tracker ni Dependabot ne les auditent dans ce dépôt ; la copie dans les dépôts de test leur rend leur nom. Ces tests ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` crée un compte (`user add`), lance le serveur (`serve`) sur un port libre, ouvre une session, vérifie l'authentification (session exigée, inscription fermée, requêtes d'un autre site, commandes `user`, limitation des connexions), crée un token d'agent par l'API de l'interface, puis lance le mode MCP (`mcp`) sur stdio : il parcourt les outils, les tokens et la correction complète depuis l'API de l'interface. 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). `test/deploy.test.ts` connecte un serveur et déploie sur un faux serveur SSH (`test/fake-ssh.ts`, bâti sur `ssh2`) qui n'accepte que les clés du fichier dédié, en respectant leur option `from`, et exécute réellement les commandes avec bash : `bash` doit être dans le `PATH` (Git Bash sous Windows). `test/two-factor.test.ts` active la double authentification d'un compte (`user totp`) sur son propre serveur et vérifie la connexion en deux étapes, par code TOTP puis par code de secours.
427
+ 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). Leurs manifestes s'appellent `package.fixture.json` et `package-lock.fixture.json`, pour que ni le tracker ni Dependabot ne les auditent dans ce dépôt ; la copie dans les dépôts de test leur rend leur nom. Ces tests ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. Les conteneurs y passent par un faux Podman (`test/fake-podman.ts`), qui note ses appels et lance la commande directement sur la machine, dans le dossier de l'hôte qui correspond au dossier de travail du conteneur : npm doit donc être dans le `PATH` pour les tests. `test/server.test.ts` le trouve dans le `PATH` du serveur, par un script POSIX : ses tests d'opérations sont ignorés sous Windows. `test/podman.test.ts` lance de vrais conteneurs, sous Linux quand Podman est installé : npm dans l'image officielle, lockfile écrit dans le clone sous le compte courant, isolation du conteneur. `test/server.test.ts` crée un compte (`user add`), lance le serveur (`serve`) sur un port libre, ouvre une session, vérifie l'authentification (session exigée, inscription fermée, requêtes d'un autre site, commandes `user`, limitation des connexions), crée un token d'agent par l'API de l'interface, puis lance le mode MCP (`mcp`) sur stdio : il parcourt les outils, les tokens et la correction complète depuis l'API de l'interface. 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). `test/deploy.test.ts` connecte un serveur et déploie sur un faux serveur SSH (`test/fake-ssh.ts`, bâti sur `ssh2`) qui n'accepte que les clés du fichier dédié, en respectant leur option `from`, et exécute réellement les commandes avec bash : `bash` doit être dans le `PATH` (Git Bash sous Windows). `test/two-factor.test.ts` active la double authentification d'un compte (`user totp`) sur son propre serveur et vérifie la connexion en deux étapes, par code TOTP puis par code de secours.
415
428
 
416
429
  ## Publication
417
430
 
418
- Chaque push sur `master`, merge de pull request compris, publie une nouvelle version sur npm (`.github/workflows/publish.yml`), en deux jobs. Le job `build`, en lecture seule sur le dépôt et sans accès à l'OIDC, installe bubblewrap (les tests passent par le bac à sable des commandes npm), lance `npm ci`, le build (dont `npm ci` dans `gui/`) et les tests, puis transmet le paquet compilé (`dist/`, `gui/dist/`) comme artefact. Le job `publish`, seul à pouvoir écrire sur le dépôt et obtenir un jeton OIDC, récupère cet artefact sans rien installer, lance `npm version patch`, puis `npm publish --ignore-scripts` et enfin le push sur `master` du commit et du tag de version : aucun code des dépendances ne s'exécute là où la publication est possible. Les actions sont épinglées par SHA de commit. La publication passe par le trusted publishing de npm (OIDC, sans token), avec attestation de provenance. Un échec du build ou des tests arrête le workflow avant la montée de version ; un échec de `npm publish` l'arrête avant le push, si bien que relancer le run reprend la même version.
431
+ Chaque push sur `master`, merge de pull request compris, publie une nouvelle version sur npm (`.github/workflows/publish.yml`), en deux jobs. Le job `build`, en lecture seule sur le dépôt et sans accès à l'OIDC, installe bubblewrap (les tests des corrections par Claude vérifient le bac à sable de Claude Code ; Podman est déjà installé sur le runner, et `test/podman.test.ts` s'en sert), lance `npm ci`, le build (dont `npm ci` dans `gui/`) et les tests, puis transmet le paquet compilé (`dist/`, `gui/dist/`) comme artefact. Le job `publish`, seul à pouvoir écrire sur le dépôt et obtenir un jeton OIDC, récupère cet artefact sans rien installer, lance `npm version patch`, puis `npm publish --ignore-scripts` et enfin le push sur `master` du commit et du tag de version : aucun code des dépendances ne s'exécute là où la publication est possible. Les actions sont épinglées par SHA de commit. La publication passe par le trusted publishing de npm (OIDC, sans token), avec attestation de provenance. Un échec du build ou des tests arrête le workflow avant la montée de version ; un échec de `npm publish` l'arrête avant le push, si bien que relancer le run reprend la même version.
419
432
 
420
433
  Sur npmjs.com, le paquet déclare ce workflow comme publieur de confiance (Settings → Trusted publishing → GitHub Actions : `Matthieu-Pesnot-Pin`, `mcp-dependabot-tracker`, `publish.yml`, avec `npm publish` dans les actions autorisées). Le commit de version est poussé avec `GITHUB_TOKEN` : si `master` est protégée, la règle doit autoriser GitHub Actions à y pousser.
@@ -2,9 +2,22 @@ import { z } from "zod";
2
2
  /** Gravités d'une alerte Dependabot, de la plus grave à la moins grave. */
3
3
  export declare const ALERT_SEVERITIES: readonly ["critical", "high", "medium", "low"];
4
4
  export type AlertSeverity = (typeof ALERT_SEVERITIES)[number];
5
- /** Gravités d'une vulnérabilité rapportée par `npm audit`, de la plus grave à la moins grave. */
5
+ /** Gravités d'une vulnérabilité rapportée par un audit, de la plus grave à la moins grave (échelle de `npm audit`). */
6
6
  export declare const NPM_SEVERITIES: readonly ["critical", "high", "moderate", "low", "info"];
7
7
  export type NpmSeverity = (typeof NPM_SEVERITIES)[number];
8
+ /** Gestionnaires de paquets des projets d'un dépôt. */
9
+ export declare const MANAGERS: readonly ["npm", "pnpm", "composer"];
10
+ export type ManagerId = (typeof MANAGERS)[number];
11
+ /** Projet d'un dépôt : dossier de son lockfile (`""` pour la racine) et gestionnaire de paquets. */
12
+ export declare const ProjectSchema: z.ZodObject<{
13
+ path: z.ZodString;
14
+ manager: z.ZodEnum<{
15
+ composer: "composer";
16
+ npm: "npm";
17
+ pnpm: "pnpm";
18
+ }>;
19
+ }, z.core.$strip>;
20
+ export type Project = z.infer<typeof ProjectSchema>;
8
21
  /**
9
22
  * Périmètre d'un audit et de ses corrections : `production` laisse de côté les
10
23
  * devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
@@ -51,7 +64,7 @@ export declare const HandledAlertSchema: z.ZodObject<{
51
64
  markedAt: z.ZodString;
52
65
  }, z.core.$strip>;
53
66
  export type HandledAlert = z.infer<typeof HandledAlertSchema>;
54
- /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/npm-audit-…`. */
67
+ /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/deps-audit-…`. */
55
68
  export declare const PullRequestSchema: z.ZodObject<{
56
69
  number: z.ZodNumber;
57
70
  url: z.ZodString;
@@ -194,12 +207,21 @@ export declare const STEP_NAMES: readonly ["clone", "audit", "fix", "repair", "p
194
207
  export type StepName = (typeof STEP_NAMES)[number];
195
208
  export declare const STEP_STATES: readonly ["pending", "running", "done", "skipped", "failed"];
196
209
  export type StepState = (typeof STEP_STATES)[number];
197
- /** Correction proposée par `npm audit` : aucune, dans les plages déclarées, ou par une version majeure. */
198
- export declare const FIX_KINDS: readonly ["none", "available", "major"];
210
+ /**
211
+ * Correction d'une vulnérabilité d'après l'audit : aucune version corrigée,
212
+ * correction dans la même version majeure, par une version majeure, ou
213
+ * inconnue quand l'audit ne donne pas de version corrigée (Composer).
214
+ */
215
+ export declare const FIX_KINDS: readonly ["none", "available", "major", "unknown"];
199
216
  export type FixKind = (typeof FIX_KINDS)[number];
200
- /** Vulnérabilité d'un projet npm du dépôt ; `project` est le dossier du lockfile, `""` pour la racine. */
217
+ /** Vulnérabilité d'un projet du dépôt ; `project` est le dossier du lockfile, `""` pour la racine. */
201
218
  export declare const VulnerabilitySchema: z.ZodObject<{
202
219
  project: z.ZodString;
220
+ manager: z.ZodDefault<z.ZodEnum<{
221
+ composer: "composer";
222
+ npm: "npm";
223
+ pnpm: "pnpm";
224
+ }>>;
203
225
  name: z.ZodString;
204
226
  severity: z.ZodEnum<{
205
227
  critical: "critical";
@@ -212,12 +234,18 @@ export declare const VulnerabilitySchema: z.ZodObject<{
212
234
  available: "available";
213
235
  major: "major";
214
236
  none: "none";
237
+ unknown: "unknown";
215
238
  }>;
216
239
  }, z.core.$strip>;
217
240
  export type Vulnerability = z.infer<typeof VulnerabilitySchema>;
218
241
  /** Paquet du lockfile dont la version a changé ; `from` null pour un ajout, `to` null pour un retrait. */
219
242
  export declare const ChangeSchema: z.ZodObject<{
220
243
  project: z.ZodString;
244
+ manager: z.ZodDefault<z.ZodEnum<{
245
+ composer: "composer";
246
+ npm: "npm";
247
+ pnpm: "pnpm";
248
+ }>>;
221
249
  name: z.ZodString;
222
250
  from: z.ZodNullable<z.ZodString>;
223
251
  to: z.ZodNullable<z.ZodString>;
@@ -232,10 +260,12 @@ export type LogEntry = z.infer<typeof LogEntrySchema>;
232
260
  export declare const TEST_OUTCOMES: readonly ["passed", "failed", "not_run"];
233
261
  /**
234
262
  * Rapport rendu par Claude à la fin de ses corrections : résumé, changement de
235
- * chaque fichier, message du commit et résultat des tests.
263
+ * chaque fichier, message du commit, résultat des tests et, sans organizer, son
264
+ * rapport détaillé en markdown, repris dans la pull request.
236
265
  */
237
266
  export declare const RepairReportSchema: z.ZodObject<{
238
267
  summary: z.ZodString;
268
+ details: z.ZodOptional<z.ZodString>;
239
269
  changes: z.ZodArray<z.ZodObject<{
240
270
  file: z.ZodString;
241
271
  change: z.ZodString;
@@ -302,6 +332,7 @@ export declare const RepairSchema: z.ZodObject<{
302
332
  commit: z.ZodNullable<z.ZodString>;
303
333
  report: z.ZodNullable<z.ZodObject<{
304
334
  summary: z.ZodString;
335
+ details: z.ZodOptional<z.ZodString>;
305
336
  changes: z.ZodArray<z.ZodObject<{
306
337
  file: z.ZodString;
307
338
  change: z.ZodString;
@@ -400,7 +431,14 @@ export declare const OperationSchema: z.ZodObject<{
400
431
  skipped: "skipped";
401
432
  }>;
402
433
  }, z.core.$strip>;
403
- projects: z.ZodArray<z.ZodString>;
434
+ projects: z.ZodArray<z.ZodObject<{
435
+ path: z.ZodString;
436
+ manager: z.ZodEnum<{
437
+ composer: "composer";
438
+ npm: "npm";
439
+ pnpm: "pnpm";
440
+ }>;
441
+ }, z.core.$strip>>;
404
442
  counts: z.ZodObject<{
405
443
  initial: z.ZodNullable<z.ZodNumber>;
406
444
  afterFix: z.ZodNullable<z.ZodNumber>;
@@ -408,6 +446,11 @@ export declare const OperationSchema: z.ZodObject<{
408
446
  }, z.core.$strip>;
409
447
  found: z.ZodArray<z.ZodObject<{
410
448
  project: z.ZodString;
449
+ manager: z.ZodDefault<z.ZodEnum<{
450
+ composer: "composer";
451
+ npm: "npm";
452
+ pnpm: "pnpm";
453
+ }>>;
411
454
  name: z.ZodString;
412
455
  severity: z.ZodEnum<{
413
456
  critical: "critical";
@@ -420,10 +463,16 @@ export declare const OperationSchema: z.ZodObject<{
420
463
  available: "available";
421
464
  major: "major";
422
465
  none: "none";
466
+ unknown: "unknown";
423
467
  }>;
424
468
  }, z.core.$strip>>;
425
469
  remaining: z.ZodArray<z.ZodObject<{
426
470
  project: z.ZodString;
471
+ manager: z.ZodDefault<z.ZodEnum<{
472
+ composer: "composer";
473
+ npm: "npm";
474
+ pnpm: "pnpm";
475
+ }>>;
427
476
  name: z.ZodString;
428
477
  severity: z.ZodEnum<{
429
478
  critical: "critical";
@@ -436,10 +485,16 @@ export declare const OperationSchema: z.ZodObject<{
436
485
  available: "available";
437
486
  major: "major";
438
487
  none: "none";
488
+ unknown: "unknown";
439
489
  }>;
440
490
  }, z.core.$strip>>;
441
491
  changes: z.ZodArray<z.ZodObject<{
442
492
  project: z.ZodString;
493
+ manager: z.ZodDefault<z.ZodEnum<{
494
+ composer: "composer";
495
+ npm: "npm";
496
+ pnpm: "pnpm";
497
+ }>>;
443
498
  name: z.ZodString;
444
499
  from: z.ZodNullable<z.ZodString>;
445
500
  to: z.ZodNullable<z.ZodString>;
@@ -467,6 +522,7 @@ export declare const OperationSchema: z.ZodObject<{
467
522
  commit: z.ZodNullable<z.ZodString>;
468
523
  report: z.ZodNullable<z.ZodObject<{
469
524
  summary: z.ZodString;
525
+ details: z.ZodOptional<z.ZodString>;
470
526
  changes: z.ZodArray<z.ZodObject<{
471
527
  file: z.ZodString;
472
528
  change: z.ZodString;
@@ -501,4 +557,4 @@ export declare const OperationSchema: z.ZodObject<{
501
557
  }, z.core.$strip>>;
502
558
  }, z.core.$strip>;
503
559
  export type Operation = z.infer<typeof OperationSchema>;
504
- export declare const DEFAULT_COMMIT_MESSAGE = "fix(deps): resolve npm audit vulnerabilities";
560
+ export declare const DEFAULT_COMMIT_MESSAGE = "fix(deps): resolve vulnerable dependencies";
@@ -1,8 +1,15 @@
1
1
  import { z } from "zod";
2
2
  /** Gravités d'une alerte Dependabot, de la plus grave à la moins grave. */
3
3
  export const ALERT_SEVERITIES = ["critical", "high", "medium", "low"];
4
- /** Gravités d'une vulnérabilité rapportée par `npm audit`, de la plus grave à la moins grave. */
4
+ /** Gravités d'une vulnérabilité rapportée par un audit, de la plus grave à la moins grave (échelle de `npm audit`). */
5
5
  export const NPM_SEVERITIES = ["critical", "high", "moderate", "low", "info"];
6
+ /** Gestionnaires de paquets des projets d'un dépôt. */
7
+ export const MANAGERS = ["npm", "pnpm", "composer"];
8
+ /** Projet d'un dépôt : dossier de son lockfile (`""` pour la racine) et gestionnaire de paquets. */
9
+ export const ProjectSchema = z.object({
10
+ path: z.string(),
11
+ manager: z.enum(MANAGERS),
12
+ });
6
13
  /**
7
14
  * Périmètre d'un audit et de ses corrections : `production` laisse de côté les
8
15
  * devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
@@ -37,7 +44,7 @@ export const HandledAlertSchema = z.object({
37
44
  package: z.string(),
38
45
  markedAt: z.string(),
39
46
  });
40
- /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/npm-audit-…`. */
47
+ /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/deps-audit-…`. */
41
48
  export const PullRequestSchema = z.object({
42
49
  number: z.number().int(),
43
50
  url: z.string(),
@@ -91,11 +98,16 @@ export const OPERATION_STATUSES = ["running", "done", "failed", "cancelled"];
91
98
  export const ACTIVE_STATUSES = ["running"];
92
99
  export const STEP_NAMES = ["clone", "audit", "fix", "repair", "push"];
93
100
  export const STEP_STATES = ["pending", "running", "done", "skipped", "failed"];
94
- /** Correction proposée par `npm audit` : aucune, dans les plages déclarées, ou par une version majeure. */
95
- export const FIX_KINDS = ["none", "available", "major"];
96
- /** Vulnérabilité d'un projet npm du dépôt ; `project` est le dossier du lockfile, `""` pour la racine. */
101
+ /**
102
+ * Correction d'une vulnérabilité d'après l'audit : aucune version corrigée,
103
+ * correction dans la même version majeure, par une version majeure, ou
104
+ * inconnue quand l'audit ne donne pas de version corrigée (Composer).
105
+ */
106
+ export const FIX_KINDS = ["none", "available", "major", "unknown"];
107
+ /** Vulnérabilité d'un projet du dépôt ; `project` est le dossier du lockfile, `""` pour la racine. */
97
108
  export const VulnerabilitySchema = z.object({
98
109
  project: z.string(),
110
+ manager: z.enum(MANAGERS).default("npm"),
99
111
  name: z.string(),
100
112
  severity: z.enum(NPM_SEVERITIES),
101
113
  fix: z.enum(FIX_KINDS),
@@ -103,6 +115,7 @@ export const VulnerabilitySchema = z.object({
103
115
  /** Paquet du lockfile dont la version a changé ; `from` null pour un ajout, `to` null pour un retrait. */
104
116
  export const ChangeSchema = z.object({
105
117
  project: z.string(),
118
+ manager: z.enum(MANAGERS).default("npm"),
106
119
  name: z.string(),
107
120
  from: z.string().nullable(),
108
121
  to: z.string().nullable(),
@@ -112,10 +125,12 @@ export const LogEntrySchema = z.object({ at: z.string(), text: z.string() });
112
125
  export const TEST_OUTCOMES = ["passed", "failed", "not_run"];
113
126
  /**
114
127
  * Rapport rendu par Claude à la fin de ses corrections : résumé, changement de
115
- * chaque fichier, message du commit et résultat des tests.
128
+ * chaque fichier, message du commit, résultat des tests et, sans organizer, son
129
+ * rapport détaillé en markdown, repris dans la pull request.
116
130
  */
117
131
  export const RepairReportSchema = z.object({
118
132
  summary: z.string(),
133
+ details: z.string().optional(),
119
134
  changes: z.array(z.object({ file: z.string(), change: z.string() })),
120
135
  commitMessage: z.string(),
121
136
  tests: z.object({ outcome: z.enum(TEST_OUTCOMES), detail: z.string() }),
@@ -180,7 +195,7 @@ export const OperationSchema = z.object({
180
195
  repair: z.enum(STEP_STATES),
181
196
  push: z.enum(STEP_STATES),
182
197
  }),
183
- projects: z.array(z.string()),
198
+ projects: z.array(ProjectSchema),
184
199
  counts: z.object({
185
200
  initial: z.number().int().nullable(),
186
201
  afterFix: z.number().int().nullable(),
@@ -196,4 +211,4 @@ export const OperationSchema = z.object({
196
211
  error: z.string().nullable(),
197
212
  log: z.array(LogEntrySchema),
198
213
  });
199
- export const DEFAULT_COMMIT_MESSAGE = "fix(deps): resolve npm audit vulnerabilities";
214
+ export const DEFAULT_COMMIT_MESSAGE = "fix(deps): resolve vulnerable dependencies";
@@ -13,16 +13,14 @@ export interface CommandOptions {
13
13
  export declare class CommandAbortedError extends Error {
14
14
  constructor();
15
15
  }
16
- /** Arrête le processus et ses enfants : sous Windows, `npm` tourne dans un `cmd.exe` qui ne transmet pas le signal. */
16
+ /** Arrête le processus et ses enfants. */
17
17
  export declare function killTree(pid: number): void;
18
18
  /**
19
- * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
20
- * les variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus `options.env`. Sous Windows,
21
- * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
22
- * arguments sont alors des options fixes, jamais une valeur venue de
23
- * l'utilisateur. Le code de sortie n'est pas interprété ici ; un dépassement de
19
+ * Lance une commande sans shell, et attend sa fin. La commande reçoit les
20
+ * variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus
21
+ * `options.env`. Le code de sortie n'est pas interprété ici ; un dépassement de
24
22
  * `timeoutMs` ou l'annulation par `signal` arrêtent la commande.
25
23
  */
26
- export declare function runCommand(command: "git" | "npm" | "bwrap", args: string[], options: CommandOptions): Promise<CommandResult>;
24
+ export declare function runCommand(command: string, args: string[], options: CommandOptions): Promise<CommandResult>;
27
25
  /** Dernières lignes non vides d'une sortie, pour un message d'erreur ou le journal. */
28
26
  export declare function tail(text: string, lines?: number): string;
@@ -8,7 +8,7 @@ export class CommandAbortedError extends Error {
8
8
  }
9
9
  }
10
10
  const DEFAULT_TIMEOUT_MS = 10 * 60_000;
11
- /** Arrête le processus et ses enfants : sous Windows, `npm` tourne dans un `cmd.exe` qui ne transmet pas le signal. */
11
+ /** Arrête le processus et ses enfants. */
12
12
  export function killTree(pid) {
13
13
  if (process.platform === "win32") {
14
14
  spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore" });
@@ -59,6 +59,9 @@ const PASSED_ENV = [
59
59
  "SSL_CERT_DIR",
60
60
  "NODE_EXTRA_CA_CERTS",
61
61
  "GIT_SSL_CAINFO",
62
+ "XDG_RUNTIME_DIR",
63
+ "XDG_CONFIG_HOME",
64
+ "XDG_DATA_HOME",
62
65
  ];
63
66
  /** Environnement du serveur transmis aux commandes : les seules variables de `PASSED_ENV`. */
64
67
  function inheritedEnv() {
@@ -70,25 +73,18 @@ function inheritedEnv() {
70
73
  return env;
71
74
  }
72
75
  /**
73
- * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
74
- * les variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus `options.env`. Sous Windows,
75
- * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
76
- * arguments sont alors des options fixes, jamais une valeur venue de
77
- * l'utilisateur. Le code de sortie n'est pas interprété ici ; un dépassement de
76
+ * Lance une commande sans shell, et attend sa fin. La commande reçoit les
77
+ * variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus
78
+ * `options.env`. Le code de sortie n'est pas interprété ici ; un dépassement de
78
79
  * `timeoutMs` ou l'annulation par `signal` arrêtent la commande.
79
80
  */
80
81
  export function runCommand(command, args, options) {
81
- const viaShell = command === "npm" && process.platform === "win32";
82
- if (viaShell && args.some((arg) => !/^[A-Za-z0-9=._-]+$/.test(arg))) {
83
- throw new TrackerError(`Refused npm argument list: ${JSON.stringify(args)}.`);
84
- }
85
82
  if (options.signal?.aborted)
86
83
  return Promise.reject(new CommandAbortedError());
87
84
  return new Promise((resolve, reject) => {
88
85
  const child = spawn(command, args, {
89
86
  cwd: options.cwd,
90
87
  env: { ...inheritedEnv(), ...options.env },
91
- shell: viaShell,
92
88
  detached: process.platform !== "win32",
93
89
  windowsHide: true,
94
90
  stdio: ["ignore", "pipe", "pipe"],