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