@imenam/mcp-dependabot-tracker 1.0.31 → 1.0.33
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 +63 -28
- package/dist/shared/schemas/model.schema.d.ts +64 -8
- package/dist/shared/schemas/model.schema.js +23 -8
- package/dist/src/cli/prompt.d.ts +4 -0
- package/dist/src/cli/prompt.js +28 -0
- package/dist/src/cli/setup.d.ts +55 -0
- package/dist/src/cli/setup.js +484 -0
- package/dist/src/cli/users.js +1 -28
- package/dist/src/core/auth.d.ts +2 -0
- package/dist/src/core/auth.js +4 -0
- package/dist/src/core/commands.d.ts +7 -7
- package/dist/src/core/commands.js +8 -12
- package/dist/src/core/containers.d.ts +82 -0
- package/dist/src/core/containers.js +144 -0
- package/dist/src/core/managers/composer.d.ts +15 -0
- package/dist/src/core/managers/composer.js +234 -0
- package/dist/src/core/managers/index.d.ts +14 -0
- package/dist/src/core/managers/index.js +46 -0
- package/dist/src/core/managers/npm.d.ts +25 -0
- package/dist/src/core/managers/npm.js +203 -0
- package/dist/src/core/managers/php-version.d.ts +18 -0
- package/dist/src/core/managers/php-version.js +113 -0
- package/dist/src/core/managers/pnpm.d.ts +28 -0
- package/dist/src/core/managers/pnpm.js +249 -0
- package/dist/src/core/managers/tool-args.d.ts +17 -0
- package/dist/src/core/managers/tool-args.js +26 -0
- package/dist/src/core/managers/types.d.ts +61 -0
- package/dist/src/core/managers/types.js +11 -0
- package/dist/src/core/operations.d.ts +8 -5
- package/dist/src/core/operations.js +106 -77
- package/dist/src/core/repair.d.ts +34 -13
- package/dist/src/core/repair.js +118 -84
- package/dist/src/core/repos.d.ts +1 -1
- package/dist/src/core/repos.js +1 -1
- package/dist/src/core/sandbox.d.ts +7 -0
- package/dist/src/core/sandbox.js +31 -0
- package/dist/src/core/settings.d.ts +1 -1
- package/dist/src/core/settings.js +2 -2
- package/dist/src/core/setup-files.d.ts +48 -0
- package/dist/src/core/setup-files.js +147 -0
- package/dist/src/core/store.js +3 -0
- package/dist/src/index.d.ts +1 -0
- package/dist/src/index.js +12 -0
- package/dist/src/mcp.js +6 -5
- package/dist/src/package-tools.d.ts +13 -0
- package/dist/src/package-tools.js +92 -0
- package/dist/src/server/serve.d.ts +2 -0
- package/dist/src/server/serve.js +3 -1
- package/dist/src/tools/format.js +11 -11
- package/dist/src/tools/tools.js +4 -4
- package/gui/dist/assets/index-DrVmedqf.js +71 -0
- package/gui/dist/index.html +1 -1
- package/package.json +2 -2
- package/dist/src/core/npm-audit.d.ts +0 -26
- package/dist/src/core/npm-audit.js +0 -76
- package/dist/src/core/npm-sandbox.d.ts +0 -33
- package/dist/src/core/npm-sandbox.js +0 -159
- package/dist/src/npm-tools.d.ts +0 -10
- package/dist/src/npm-tools.js +0 -136
- 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
|
|
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),
|
|
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,12 +17,34 @@ 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
|
|
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
|
|
|
24
24
|
## Installation
|
|
25
25
|
|
|
26
|
+
### Installation sur un serveur Linux : `setup`
|
|
27
|
+
|
|
28
|
+
Sur une machine Linux avec systemd (Debian, Ubuntu), une seule commande, en root, installe tout le serveur :
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
sudo mcp-dependabot-tracker setup
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Elle pose ses questions, en proposant les valeurs du `.env` existant : adresse publique (`https://…`), port d'écoute sur `127.0.0.1` (4700), compte système du service (`dependabot-tracker`), répertoire des données (`<dossier du compte>/data`), nginx et certificat, premier compte de l'interface (mot de passe saisi sans écho). Elle récapitule, demande confirmation, puis :
|
|
35
|
+
|
|
36
|
+
1. installe les paquets manquants : `git`, `podman`, `uidmap`, `passt`, `slirp4netns`, `catatonit`, `bubblewrap`, `socat`, plus `nginx`, `certbot` et `python3-certbot-nginx` s'ils sont demandés ;
|
|
37
|
+
2. crée le compte système du service, lui attribue une plage de sous-identifiants libre (la suite de toutes celles de `/etc/subuid` et `/etc/subgid`) et active son lingering (`/run/user/<uid>`) ;
|
|
38
|
+
3. écrit le `.env` de la racine du paquet (`DATA_DIR`, `APP_URL`, `APP_PORT`, `TRUSTED_PROXIES`, et `VAULT_KEY` et `AUTH_SECRET`, générés au premier passage puis conservés), lisible par root et le groupe du service seulement ; les autres lignes du fichier sont gardées ;
|
|
39
|
+
4. crée le premier compte de l'interface ;
|
|
40
|
+
5. prépare Podman rootless sous le compte du service (`podman system migrate`) et vérifie qu'il est bien rootless ;
|
|
41
|
+
6. écrit l'unité `/etc/systemd/system/dependabot-tracker.service`, l'active et (re)démarre le service, puis attend que le serveur réponde ;
|
|
42
|
+
7. avec nginx, écrit et active le site `/etc/nginx/sites-available/dependabot-tracker` (proxy vers `127.0.0.1:<port>`), recharge nginx, puis obtient le certificat avec certbot (`--redirect`). Un site nginx déjà activé qui sert la même adresse est gardé tel quel.
|
|
43
|
+
|
|
44
|
+
L'unité garde le durcissement compatible avec Podman rootless et le bac à sable de Claude Code : `ProtectSystem=strict`, `ProtectHome=read-only`, `PrivateTmp`, l'écriture limitée au dossier du compte, aux données et à `/run/user/<uid>`, mais ni `NoNewPrivileges` (`newuidmap` et `newgidmap` sont setuid), ni `RestrictSUIDSGID` (la copie d'une image aux identifiants décalés de `--userns=keep-id` remet les bits setuid et setgid de ses fichiers), ni `RestrictNamespaces`, `PrivateUsers` ou `SystemCallFilter` (bubblewrap).
|
|
45
|
+
|
|
46
|
+
Relancée, la commande reprend la configuration en place : clés, compte de service, plage de sous-identifiants et comptes existants sont gardés, l'unité est réécrite. Sans terminal, ou avec `--non-interactive`, rien n'est demandé : chaque réponse vient d'une option (`--app-url`, `--port`, `--service-user`, `--data-dir`, `--nginx=oui|non`, `--certbot=oui|non`, `--admin-email`, `--admin-name`), sinon du `.env` ou du défaut, et le mot de passe de `SETUP_ADMIN_PASSWORD`. `setup --help` les liste. Il reste ensuite à saisir dans l'interface le token GitHub du tracker, puis le token Claude.
|
|
47
|
+
|
|
26
48
|
### Le serveur
|
|
27
49
|
|
|
28
50
|
```bash
|
|
@@ -30,7 +52,18 @@ npm install -g @imenam/mcp-dependabot-tracker
|
|
|
30
52
|
mcp-dependabot-tracker serve
|
|
31
53
|
```
|
|
32
54
|
|
|
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
|
|
55
|
+
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)).
|
|
56
|
+
|
|
57
|
+
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 :
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
sudo apt-get install -y podman uidmap passt
|
|
61
|
+
grep "^$(whoami):" /etc/subuid /etc/subgid
|
|
62
|
+
sudo loginctl enable-linger "$(whoami)"
|
|
63
|
+
podman info --format '{{.Host.Security.Rootless}}'
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
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>`, le laisse en écriture (`ReadWritePaths=/run/user/<uid du compte>` avec `ProtectSystem=strict`), et ne pose ni `NoNewPrivileges` ni `RestrictSUIDSGID` (voir l'unité écrite par `setup`, ci-dessus).
|
|
34
67
|
|
|
35
68
|
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
69
|
|
|
@@ -174,7 +207,7 @@ Le mode MCP se déclare dans un gateway ([mcp-http-gateway](https://www.npmjs.co
|
|
|
174
207
|
}
|
|
175
208
|
```
|
|
176
209
|
|
|
177
|
-
Le gateway n'héberge que le mode MCP : clones,
|
|
210
|
+
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
211
|
|
|
179
212
|
---
|
|
180
213
|
|
|
@@ -186,8 +219,8 @@ Six outils, en anglais, servis par le mode MCP. Le compte rendu d'une opération
|
|
|
186
219
|
|---|---|
|
|
187
220
|
| `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
221
|
| `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` :
|
|
222
|
+
| `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. |
|
|
223
|
+
| `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
224
|
| `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
225
|
| `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
226
|
|
|
@@ -199,19 +232,21 @@ Un dépôt déprécié est refusé par tous les outils, jusqu'à ce que l'utilis
|
|
|
199
232
|
|
|
200
233
|
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
234
|
|
|
235
|
+
**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`.
|
|
236
|
+
|
|
202
237
|
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
238
|
|
|
204
|
-
Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit ou de « Auditer tout » : **production** (par défaut)
|
|
239
|
+
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
240
|
|
|
206
|
-
1. **Cloner le dépôt** — puis repérer les projets
|
|
207
|
-
2. **
|
|
208
|
-
3. **
|
|
209
|
-
4. **Corrections par Claude** — pour une correction, dès que des vulnérabilités restent : la branche `fix/
|
|
210
|
-
5. **Commit et push** — commit des fichiers modifiés sur la branche `fix/
|
|
241
|
+
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.
|
|
242
|
+
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`.
|
|
243
|
+
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.
|
|
244
|
+
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`.
|
|
245
|
+
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
246
|
|
|
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/
|
|
247
|
+
**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
248
|
|
|
214
|
-
**Auditer tout** — depuis l'accueil, un audit seul (clone et
|
|
249
|
+
**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
250
|
|
|
216
251
|
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
252
|
|
|
@@ -223,16 +258,16 @@ Depuis l'interface comme pour l'agent, une opération se lance aussitôt et va d
|
|
|
223
258
|
|
|
224
259
|
## Les corrections par Claude
|
|
225
260
|
|
|
226
|
-
Quand
|
|
261
|
+
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
262
|
|
|
228
|
-
1. il crée la branche `fix/
|
|
229
|
-
2. il lance une session Claude Code non interactive (`claude -p`) dans le clone, avec les vulnérabilités restantes (extraites
|
|
230
|
-
3. Claude
|
|
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
|
|
263
|
+
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é ;
|
|
264
|
+
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 ;
|
|
265
|
+
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 ;
|
|
266
|
+
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
267
|
|
|
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,
|
|
268
|
+
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
269
|
|
|
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
|
|
270
|
+
**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, et avec les variables système du serveur (`HOME`, `XDG_RUNTIME_DIR`, `PATH`, proxy), qui remplacent celles de Claude Code : Podman rootless y retrouve le stockage du compte du serveur, où sont ses images ; 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
271
|
|
|
237
272
|
**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
273
|
|
|
@@ -240,7 +275,7 @@ Une tâche introuvable, sans le tag ou non assignée au propriétaire fait écho
|
|
|
240
275
|
|
|
241
276
|
- **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
277
|
- **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** —
|
|
278
|
+
- **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
279
|
- **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
280
|
- **Corrections par Claude** — les limites d'une session.
|
|
246
281
|
- **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 +350,7 @@ Thème sombre, une information par ligne, une action principale par écran.
|
|
|
315
350
|
- **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
351
|
- **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
352
|
- **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
|
|
353
|
+
- **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
354
|
|
|
320
355
|
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
356
|
|
|
@@ -403,18 +438,18 @@ cd gui && npm run lint # oxlint
|
|
|
403
438
|
| `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
439
|
| `src/mcp.ts` | Mode MCP : `instructions` et serveur stdio des outils. |
|
|
405
440
|
| `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
|
|
407
|
-
| `src/
|
|
441
|
+
| `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`). |
|
|
442
|
+
| `src/package-tools.ts` | Serveur MCP des commandes des gestionnaires de paquets fourni à Claude Code pendant ses corrections. |
|
|
408
443
|
| `src/cli/setup-mcp.ts` | Commande `--claude-setup-mcp`. |
|
|
409
444
|
| `src/cli/users.ts` | Commandes `user add`, `user password`, `user totp`, `user remove`, `user list`. |
|
|
410
445
|
| `shared/schemas/` | Schémas zod communs au serveur et à la GUI. |
|
|
411
446
|
| `gui/` | Vite + React 19 + zustand, CSS écrit à la main. |
|
|
412
447
|
| `test/` | Tests `node --test`. |
|
|
413
448
|
|
|
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.
|
|
449
|
+
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
450
|
|
|
416
451
|
## Publication
|
|
417
452
|
|
|
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
|
|
453
|
+
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
454
|
|
|
420
455
|
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
|
|
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/
|
|
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
|
-
/**
|
|
198
|
-
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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/
|
|
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
|
-
/**
|
|
95
|
-
|
|
96
|
-
|
|
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
|
|
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(
|
|
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
|
|
214
|
+
export const DEFAULT_COMMIT_MESSAGE = "fix(deps): resolve vulnerable dependencies";
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import readline from "readline";
|
|
2
|
+
/** Lit une ligne sur le terminal sans l'afficher. */
|
|
3
|
+
export function promptHidden(question) {
|
|
4
|
+
return new Promise((resolve) => {
|
|
5
|
+
const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
|
|
6
|
+
const output = rl;
|
|
7
|
+
let muted = false;
|
|
8
|
+
output._writeToOutput = (text) => {
|
|
9
|
+
if (!muted || text.includes("\n"))
|
|
10
|
+
output.output.write(muted ? "\n" : text);
|
|
11
|
+
};
|
|
12
|
+
rl.question(question, (answer) => {
|
|
13
|
+
rl.close();
|
|
14
|
+
resolve(answer);
|
|
15
|
+
});
|
|
16
|
+
muted = true;
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
/** Lit une ligne sur le terminal. */
|
|
20
|
+
export function promptLine(question) {
|
|
21
|
+
return new Promise((resolve) => {
|
|
22
|
+
const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
|
|
23
|
+
rl.question(question, (answer) => {
|
|
24
|
+
rl.close();
|
|
25
|
+
resolve(answer.trim());
|
|
26
|
+
});
|
|
27
|
+
});
|
|
28
|
+
}
|