@imenam/mcp-dependabot-tracker 1.0.10 → 1.0.12
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 +33 -14
- package/dist/shared/alerts.d.ts +6 -1
- package/dist/shared/alerts.js +7 -0
- package/dist/shared/schemas/api.schema.d.ts +41 -9
- package/dist/shared/schemas/api.schema.js +5 -1
- package/dist/shared/schemas/ipc.schema.d.ts +1 -1
- package/dist/shared/schemas/ipc.schema.js +2 -0
- package/dist/shared/schemas/model.schema.d.ts +159 -7
- package/dist/shared/schemas/model.schema.js +63 -8
- package/dist/src/core/analysis.d.ts +26 -1
- package/dist/src/core/analysis.js +6 -3
- package/dist/src/core/audit-all.d.ts +6 -6
- package/dist/src/core/audit-all.js +6 -6
- package/dist/src/core/claude.d.ts +2 -0
- package/dist/src/core/claude.js +8 -4
- package/dist/src/core/commands.d.ts +2 -2
- package/dist/src/core/commands.js +1 -1
- package/dist/src/core/github.js +2 -1
- package/dist/src/core/npm-sandbox.d.ts +17 -0
- package/dist/src/core/npm-sandbox.js +89 -0
- package/dist/src/core/operations.d.ts +22 -12
- package/dist/src/core/operations.js +239 -44
- package/dist/src/core/organizer.d.ts +14 -0
- package/dist/src/core/organizer.js +17 -2
- package/dist/src/core/repair.d.ts +38 -0
- package/dist/src/core/repair.js +191 -0
- package/dist/src/core/repos.d.ts +11 -8
- package/dist/src/core/repos.js +38 -20
- package/dist/src/core/store.d.ts +2 -0
- package/dist/src/core/store.js +14 -5
- package/dist/src/gui-worker.js +20 -3
- package/dist/src/index.js +23 -8
- package/dist/src/npm-tools.d.ts +10 -0
- package/dist/src/npm-tools.js +136 -0
- package/dist/src/tools/format.js +20 -8
- package/dist/src/tools/tools.js +8 -6
- package/dist/src/tools/types.d.ts +2 -0
- package/dist/src/tools/types.js +9 -0
- package/gui/dist/assets/index-D98CR3xl.js +64 -0
- package/gui/dist/assets/index-DETLqB3f.css +1 -0
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
- package/gui/dist/assets/index-C1Ml-XiM.css +0 -1
- package/gui/dist/assets/index-DQPqW5Uq.js +0 -64
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@ Utilisateur (GUI) ──ajoute un dépôt, accorde les droits, corrige──▶
|
|
|
9
9
|
Agent ──list_repositories / get_alerts / run_audit / fix_vulnerabilities──▶ (dans la limite des droits)
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
L'agent n'exécute jamais `git` ni `npm` lui-même : tout passe par les outils. Quand `npm audit fix` laisse des vulnérabilités, une correction lancée depuis l'interface peut les faire **analyser par Claude** (Claude Code, avec un abonnement Claude) : il lit le code, juge ce qui est urgent à corriger à la main et si `--force` vaut la peine, et crée une tâche de reprise dans un [organizer](https://www.npmjs.com/package/@imenam/mcp-organizer) (voir [L'analyse par Claude](#lanalyse-par-claude)).
|
|
12
|
+
L'agent n'exécute jamais `git` ni `npm` lui-même : tout passe par les outils. Quand `npm audit fix` laisse des vulnérabilités, une correction lancée depuis l'interface peut les faire **analyser par Claude** (Claude Code, avec un abonnement Claude) : il lit le code, juge ce qui est urgent à corriger à la main et si `--force` vaut la peine, et crée une tâche de reprise dans un [organizer](https://www.npmjs.com/package/@imenam/mcp-organizer) (voir [L'analyse par Claude](#lanalyse-par-claude)). Après vos remarques en commentaire de cette tâche, Claude peut ensuite **appliquer les corrections** lui-même, dans un commit séparé (voir [Les corrections par Claude](#les-corrections-par-claude)).
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
@@ -122,9 +122,9 @@ Cinq outils, en anglais. Le résultat d'une opération se termine par le lien ve
|
|
|
122
122
|
| Outil | Droit | Effet |
|
|
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
|
-
| `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, résumé, version corrigée, marque « corrigée à la main » de l'utilisateur, lien. |
|
|
126
|
-
| `run_audit` | audit | `npm audit` dans un clone temporaire : vulnérabilités par projet npm, avec la correction proposée (aucune, dans les plages déclarées, ou montée majeure qui demande `--force`). Rien n'est modifié. |
|
|
127
|
-
| `fix_vulnerabilities` | fix (+ force, + push) | Clone, `npm audit`, `npm audit fix` ; avec `force: true`, `npm audit fix --force` s'il reste des vulnérabilités qu'une montée majeure corrige ; avec `push: true`, commit (`commit_message`, défaut `fix(deps): resolve npm audit vulnerabilities`), push d'une nouvelle branche et pull request vers la branche analysée. Sans `push`, rien ne sort du clone : le résultat décrit ce que les corrections changent. |
|
|
125
|
+
| `get_alerts` | — | Relit sur GitHub les alertes ouvertes d'un dépôt (`repository`) et les liste de la plus grave à la moins grave : numéro, gravité, paquet, écosystème, manifeste, portée de la dépendance (exécution ou développement), résumé, version corrigée, marque « corrigée à la main » de l'utilisateur, lien. |
|
|
126
|
+
| `run_audit` | audit | `npm audit` dans un clone temporaire, sur le périmètre `scope` (`production` par défaut, ou `all`) : vulnérabilités par projet npm, avec la correction proposée (aucune, dans les plages déclarées, ou montée majeure qui demande `--force`). Rien n'est modifié. |
|
|
127
|
+
| `fix_vulnerabilities` | fix (+ force, + push) | Clone, `npm audit`, `npm audit fix`, sur le périmètre `scope` (`production` par défaut, ou `all`) ; avec `force: true`, `npm audit fix --force` s'il reste des vulnérabilités qu'une montée majeure corrige ; avec `push: true`, commit (`commit_message`, défaut `fix(deps): resolve npm audit vulnerabilities`), push d'une nouvelle branche et pull request vers la branche analysée. Sans `push`, rien ne sort du clone : le résultat décrit ce que les corrections changent. |
|
|
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.
|
|
@@ -137,12 +137,15 @@ Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabo
|
|
|
137
137
|
|
|
138
138
|
La **branche analysée** se choisit par dépôt dans la GUI ; c'est la branche par défaut tant qu'aucune autre n'est choisie. L'agent l'utilise aussi, sans pouvoir en changer. Les alertes Dependabot, elles, portent toujours sur la branche par défaut, la seule que GitHub analyse : sur une autre branche, c'est `npm audit` qui mesure les vulnérabilités.
|
|
139
139
|
|
|
140
|
+
Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit ou de « Auditer tout » : **production** (par défaut) ajoute `--omit=dev` à `npm audit`, `npm audit fix` et `npm audit fix --force`, qui laissent alors les devDependencies de côté ; **toutes les dépendances** les couvre aussi. Chaque alerte Dependabot porte la portée de sa dépendance (`dependency.scope` de l'API GitHub : exécution ou développement). Un audit de production ne se compare qu'aux alertes qui ne portent pas sur une dépendance de développement ; une alerte de portée inconnue compte comme une alerte de production. Une opération enregistrée avant ce choix est lue comme un audit de toutes les dépendances.
|
|
141
|
+
|
|
140
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é.
|
|
141
|
-
2. **npm audit** — `npm audit --json` dans chaque projet.
|
|
143
|
+
2. **npm audit** — `npm audit --json` dans chaque projet, avec `--omit=dev` en production.
|
|
142
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.
|
|
143
145
|
**Analyse par Claude** — pour une correction lancée depuis la GUI, quand des vulnérabilités restent et que l'analyse automatique est activée (voir [L'analyse par Claude](#lanalyse-par-claude)). Passée sinon, et toujours pour une opération de l'agent.
|
|
144
146
|
4. **npm audit fix --force** — proposé quand des vulnérabilités restantes ne se corrigent que par une version majeure (`fixAvailable.isSemVerMajor` du rapport npm). L'écran liste les paquets concernés, leur version installée et la version cible, et le nombre de vulnérabilités en jeu.
|
|
145
|
-
5. **
|
|
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.
|
|
146
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
151
|
|
|
@@ -181,6 +184,21 @@ Les tokens sont enregistrés dans `<données>/settings.json`, lisible par le seu
|
|
|
181
184
|
|
|
182
185
|
**Suivi** — la tâche de la dernière analyse s'affiche sur la ligne du dépôt (« Tâche MNT-12 », qui ouvre la tâche sur l'organizer) tant qu'elle n'est pas terminée : son statut est relu sur l'organizer avec les alertes, toutes les 10 minutes. La pull request de la correction mentionne la clé de la tâche.
|
|
183
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.
|
|
201
|
+
|
|
184
202
|
---
|
|
185
203
|
|
|
186
204
|
## L'interface
|
|
@@ -192,14 +210,14 @@ Thème sombre, une information par ligne, une action principale par écran.
|
|
|
192
210
|
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.
|
|
193
211
|
« 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.
|
|
194
212
|
« PR en attente » ne garde que les dépôts où une pull request du tracker attend d'être mergée ; combiné à « Vulnérables seulement », les deux conditions s'appliquent. Le navigateur retient sa position. Sur la ligne, « PR #42 en attente » ouvre la pull request sur GitHub, « 3 PR en attente » la liste des pull requests du dépôt.
|
|
195
|
-
« 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) : 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).
|
|
213
|
+
« 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).
|
|
196
214
|
La roue dentée, à gauche de « Synchroniser maintenant », ouvre les réglages.
|
|
197
215
|
- **Réglages (`#/settings`)** — connexion à l'organizer, token Claude et analyse automatique (voir [L'analyse par Claude](#lanalyse-par-claude)). Un token enregistré n'apparaît que par ses quatre derniers caractères, avec « Remplacer ». « Enregistrer » valide tout l'écran.
|
|
198
216
|
- **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é.
|
|
199
|
-
- **Dépôt (`#/r/<propriétaire>/<nom>`)** — 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), date de la dernière lecture des alertes et lien vers la dernière correction ; 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 ». 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. « Corriger » lance une correction
|
|
200
|
-
- **Correction (`#/r/<propriétaire>/<nom>/op/<id>`)** — qui l'a lancée (vous ou l'agent), la branche clonée, puis les étapes : celles qui sont faites tiennent sur une ligne avec leur résultat (« 4 vulnérabilités », « 3 corrigées », lien vers la pull request), seule l'étape qui attend une décision est dépliée. Une étape passée en donne la raison : « aucune correction possible » pour `--force` quand npm ne propose aucune montée majeure, « rien à corriger » quand `npm audit fix` a tout corrigé, « rien à pousser » quand les corrections n'ont rien changé, « ignorée » sinon. Les vulnérabilités sans aucune version corrigée publiée sur le registre npm (`fixAvailable: false`, par exemple `xlsx`, que SheetJS ne publie plus sur npm) sont comptées sur la ligne du dernier audit (« 1 sans correctif ») ; un clic les liste avec leur gravité : leur mise à jour est à faire à la main. Quand Claude analyse les vulnérabilités restantes, l'étape « Analyse par Claude » montre sa durée, ses tours et ses trois dernières actions, puis le lien vers la tâche organizer et un résumé. L'étape `--force` liste les montées majeures avec « Appliquer --force » et « Passer » ; après une analyse, elle donne l'avis de Claude et ce qu'il juge urgent de corriger à la main, et le bouton principal suit sa recommandation ;
|
|
217
|
+
- **Dépôt (`#/r/<propriétaire>/<nom>`)** — 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), date de la dernière lecture des alertes et lien vers la dernière correction ; 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. « Corriger » lance une correction en production ; la flèche à côté ouvre le choix du périmètre (« Production » ou « Toutes les dépendances », Échap ferme). « Reprendre la correction » rouvre celle en cours. « Agent » ouvre le volet des droits : quatre interrupteurs, enregistrés aussitôt, et « Retirer le dépôt » (un second clic confirme dans les 4 secondes ; refusé pendant une opération).
|
|
218
|
+
- **Correction (`#/r/<propriétaire>/<nom>/op/<id>`)** — qui l'a lancée (vous ou l'agent), la branche clonée, le périmètre, puis les étapes : celles qui sont faites tiennent sur une ligne avec leur résultat (« 4 vulnérabilités », « 3 corrigées », lien vers la pull request), seule l'étape qui attend une décision est dépliée. Une étape passée en donne la raison : « aucune correction possible » pour `--force` quand npm ne propose aucune montée majeure, « rien à corriger » quand `npm audit fix` a tout corrigé, « rien à pousser » quand les corrections n'ont rien changé, « passé » quand l'utilisateur a passé `--force` (« passé · déconseillé par Claude » après son avis), « ignorée » sinon. Les vulnérabilités sans aucune version corrigée publiée sur le registre npm (`fixAvailable: false`, par exemple `xlsx`, que SheetJS ne publie plus sur npm) sont comptées sur la ligne du dernier audit (« 1 sans correctif ») ; un clic les liste avec leur gravité : leur mise à jour est à faire à la main. Quand Claude analyse les vulnérabilités restantes, l'étape « Analyse par Claude » montre sa durée, ses tours et ses trois dernières actions, puis le lien vers la tâche organizer et un résumé. L'étape `--force` liste les montées majeures avec « Appliquer --force » et « Passer » ; après une analyse, elle donne l'avis de Claude et ce qu'il juge urgent de corriger à la main, et le bouton principal suit sa recommandation. L'étape « Corrections par Claude » affiche les remarques de la tâche, « Commenter la tâche », « Lancer les corrections » et « Passer au push » ; pendant le passage, sa durée, ses tours et les dernières actions de Claude (fichiers modifiés, commandes lancées) ; ensuite, sur sa ligne, les vulnérabilités corrigées et le nombre de fichiers modifiés. L'étape du push montre le message de commit modifiable, le nom de la branche, « voir les changements » (paquets mis à jour, replié) et « Pousser et ouvrir la PR » ; après des corrections par Claude, elle montre d'abord ce qu'il a changé, le nombre de commits de la branche, et « Relancer avec mes remarques ». Une erreur s'affiche sous l'étape qui a échoué. « Journal » déplie les commandes lancées et leurs résultats ; « Annuler » arrête l'opération.
|
|
201
219
|
|
|
202
|
-
Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les secondes pendant une opération.
|
|
220
|
+
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.
|
|
203
221
|
|
|
204
222
|
---
|
|
205
223
|
|
|
@@ -215,7 +233,7 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
|
|
|
215
233
|
| `GET /api/config` | Version, répertoire des données, présence du token. |
|
|
216
234
|
| `GET /api/repos`, `POST /api/repos` | Dépôts suivis, dépréciés compris (avec catégorie, opération en cours et dernière opération) et catégories ; ajout d'un dépôt (`{ repository, categoryId? }`). |
|
|
217
235
|
| `POST /api/sync` | Relit tout de suite les alertes et les pull requests de chaque dépôt suivi non déprécié, en parallèle ; renvoie les dépôts et les catégories. |
|
|
218
|
-
| `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 (`409` si une série est en cours). |
|
|
236
|
+
| `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` ; `409` si une série est en cours). |
|
|
219
237
|
| `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
|
|
220
238
|
| `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
|
|
221
239
|
| `PUT` / `DELETE /api/repos/:propriétaire/:nom/deprecated` | Marque le dépôt déprécié (`409` pendant une opération) ; le rétablit et relit ses alertes. |
|
|
@@ -225,9 +243,10 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
|
|
|
225
243
|
| `PUT /api/repos/:propriétaire/:nom/category` | Catégorie du dépôt (`{ categoryId }`, null pour aucune). |
|
|
226
244
|
| `GET /api/categories`, `POST /api/categories` | Catégories dans l'ordre alphabétique ; création (`{ name }`, unique sans tenir compte de la casse). |
|
|
227
245
|
| `PUT` / `DELETE /api/categories/:id` | Renommage (`{ name }`) ; suppression, ses dépôts restant sans catégorie. |
|
|
228
|
-
| `POST /api/repos/:propriétaire/:nom/operations` | Lance une correction. |
|
|
246
|
+
| `POST /api/repos/:propriétaire/:nom/operations` | Lance une correction sur le périmètre `scope` du corps (`production` ou `all`). |
|
|
229
247
|
| `GET /api/operations/:id` | Opération. |
|
|
230
|
-
| `POST /api/operations/:id/force`, `/push`, `/cancel` | Décision `--force` (`{ apply }`), push (`{ commitMessage }`), annulation. |
|
|
248
|
+
| `POST /api/operations/:id/force`, `/repair`, `/push`, `/cancel` | Décision `--force` (`{ apply }`), corrections par Claude lancées, relancées ou passées (`{ run }`), push (`{ commitMessage }`), annulation. |
|
|
249
|
+
| `GET /api/operations/:id/remarks` | Tâche de l'analyse de l'opération et ses commentaires récents, lus sur l'organizer. |
|
|
231
250
|
| `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. |
|
|
232
251
|
| `POST /api/settings/organizer/test` | Reteste la connexion enregistrée à l'organizer. |
|
|
233
252
|
|
|
@@ -259,4 +278,4 @@ cd gui && npm run lint # oxlint
|
|
|
259
278
|
| `gui/` | Vite + React 19 + zustand, CSS écrit à la main. |
|
|
260
279
|
| `test/` | Tests `node --test`. |
|
|
261
280
|
|
|
262
|
-
Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, création et liste des pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, corrigé seulement par `--force`) : 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.
|
|
281
|
+
Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, création et liste des pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, corrigé seulement par `--force` ; `test/fixtures/vulnerable-dev`, le même avec `nth-check` en devDependency, pour le périmètre production) : ils ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` lance le serveur sur stdio avec sa GUI sur un port libre et parcourt les outils, les droits et la correction complète depuis l'API de la GUI. L'analyse et les corrections par Claude passent par un faux Claude Code (`test/fake-claude.ts`, qui note ses appels, appelle les outils du serveur `npm` du tracker et répond en `stream-json`) et un faux organizer (tâches, sous-tâches, commentaires).
|
package/dist/shared/alerts.d.ts
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
|
-
import { type Alert, type AlertSeverity, type NpmSeverity, type Repo } from "./schemas/model.schema.js";
|
|
1
|
+
import { type Alert, type AlertSeverity, type AuditScope, type NpmSeverity, type Repo } from "./schemas/model.schema.js";
|
|
2
2
|
/** Alertes ouvertes que l'utilisateur n'a pas marquées corrigées à la main. */
|
|
3
3
|
export declare function pendingAlerts(repo: Repo): Alert[];
|
|
4
|
+
/**
|
|
5
|
+
* Alertes qu'un audit de périmètre `scope` peut retrouver : toutes pour `all`,
|
|
6
|
+
* celles qui ne portent pas sur une dépendance de développement pour `production`.
|
|
7
|
+
*/
|
|
8
|
+
export declare function alertsInScope(alerts: Alert[], scope: AuditScope): Alert[];
|
|
4
9
|
/** Alertes ouvertes marquées corrigées à la main. */
|
|
5
10
|
export declare function handledAlerts(repo: Repo): Alert[];
|
|
6
11
|
/** Gravité d'alerte correspondant à une gravité npm (`moderate` → `medium`, `info` → `low`). */
|
package/dist/shared/alerts.js
CHANGED
|
@@ -4,6 +4,13 @@ export function pendingAlerts(repo) {
|
|
|
4
4
|
const handled = new Set(repo.handledAlerts.map((mark) => mark.number));
|
|
5
5
|
return repo.alerts.filter((alert) => !handled.has(alert.number));
|
|
6
6
|
}
|
|
7
|
+
/**
|
|
8
|
+
* Alertes qu'un audit de périmètre `scope` peut retrouver : toutes pour `all`,
|
|
9
|
+
* celles qui ne portent pas sur une dépendance de développement pour `production`.
|
|
10
|
+
*/
|
|
11
|
+
export function alertsInScope(alerts, scope) {
|
|
12
|
+
return scope === "all" ? alerts : alerts.filter((alert) => alert.scope !== "development");
|
|
13
|
+
}
|
|
7
14
|
/** Alertes ouvertes marquées corrigées à la main. */
|
|
8
15
|
export function handledAlerts(repo) {
|
|
9
16
|
const handled = new Set(repo.handledAlerts.map((mark) => mark.number));
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import { type AlertSeverity, type AnalysisTask, type Category, type Operation, type Repo } from "./model.schema.js";
|
|
2
|
+
import { type AlertSeverity, type AnalysisTask, type AuditScope, type Category, type Operation, 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;
|
|
@@ -40,11 +40,24 @@ export interface CategoriesResponse {
|
|
|
40
40
|
export interface BranchesResponse {
|
|
41
41
|
branches: string[];
|
|
42
42
|
}
|
|
43
|
+
/** Corps de `POST /api/repos/:owner/:name/operations` et de `POST /api/audit-all` : le périmètre de l'audit. */
|
|
44
|
+
export declare const ScopeBodySchema: z.ZodObject<{
|
|
45
|
+
scope: z.ZodEnum<{
|
|
46
|
+
all: "all";
|
|
47
|
+
production: "production";
|
|
48
|
+
}>;
|
|
49
|
+
}, z.core.$strip>;
|
|
50
|
+
export type ScopeBody = z.infer<typeof ScopeBodySchema>;
|
|
43
51
|
/** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
|
|
44
52
|
export declare const ForceBodySchema: z.ZodObject<{
|
|
45
53
|
apply: z.ZodBoolean;
|
|
46
54
|
}, z.core.$strip>;
|
|
47
55
|
export type ForceBody = z.infer<typeof ForceBodySchema>;
|
|
56
|
+
/** `run` : lancer ou relancer les corrections par Claude ; sinon l'étape est passée. */
|
|
57
|
+
export declare const RepairBodySchema: z.ZodObject<{
|
|
58
|
+
run: z.ZodBoolean;
|
|
59
|
+
}, z.core.$strip>;
|
|
60
|
+
export type RepairBody = z.infer<typeof RepairBodySchema>;
|
|
48
61
|
export declare const PushBodySchema: z.ZodObject<{
|
|
49
62
|
commitMessage: z.ZodString;
|
|
50
63
|
}, z.core.$strip>;
|
|
@@ -61,19 +74,25 @@ export declare const AlertRequestSchema: z.ZodObject<{
|
|
|
61
74
|
export declare const OperationRequestSchema: z.ZodObject<{
|
|
62
75
|
operationId: z.ZodString;
|
|
63
76
|
}, z.core.$strip>;
|
|
64
|
-
/** Vulnérabilités trouvées par un audit : leur nombre, la plus haute gravité,
|
|
77
|
+
/** Vulnérabilités trouvées par un audit : leur nombre, la plus haute gravité, la date et le périmètre de l'audit. */
|
|
65
78
|
export interface AuditFindings {
|
|
66
79
|
at: string;
|
|
80
|
+
scope: AuditScope;
|
|
67
81
|
count: number;
|
|
68
82
|
severity: AlertSeverity;
|
|
69
83
|
}
|
|
84
|
+
/** Audit qui n'a trouvé aucune vulnérabilité : sa date et son périmètre. */
|
|
85
|
+
export interface CleanAudit {
|
|
86
|
+
at: string;
|
|
87
|
+
scope: AuditScope;
|
|
88
|
+
}
|
|
70
89
|
/**
|
|
71
90
|
* Dépôt, sa catégorie, et l'état de son opération en cours et de la dernière
|
|
72
|
-
* opération, pour la liste et l'écran du dépôt. `
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
* le dernier audit de la branche par défaut alors que Dependabot ne
|
|
76
|
-
* aucune alerte ; `unfixable` les paquets pour lesquels le dernier audit n'a
|
|
91
|
+
* opération, pour la liste et l'écran du dépôt. `cleanAudit` est le dernier
|
|
92
|
+
* audit quand il n'a trouvé aucune vulnérabilité alors que Dependabot signale
|
|
93
|
+
* encore, dans son périmètre, des alertes émises avant lui ; `auditFindings` ce
|
|
94
|
+
* qu'a trouvé le dernier audit de la branche par défaut alors que Dependabot ne
|
|
95
|
+
* signale aucune alerte dans son périmètre ; `unfixable` les paquets pour lesquels le dernier audit n'a
|
|
77
96
|
* trouvé aucune version corrigée, hors ceux marqués corrigés à la main ;
|
|
78
97
|
* `analysisTask` la tâche organizer de la dernière analyse par Claude, tant
|
|
79
98
|
* qu'elle n'est pas terminée.
|
|
@@ -83,7 +102,7 @@ export interface RepoView {
|
|
|
83
102
|
category: Category | null;
|
|
84
103
|
activeOperation: Operation | null;
|
|
85
104
|
latestOperation: Operation | null;
|
|
86
|
-
|
|
105
|
+
cleanAudit: CleanAudit | null;
|
|
87
106
|
auditFindings: AuditFindings | null;
|
|
88
107
|
unfixable: string[];
|
|
89
108
|
analysisTask: AnalysisTask | null;
|
|
@@ -91,10 +110,12 @@ export interface RepoView {
|
|
|
91
110
|
/**
|
|
92
111
|
* Série « Auditer tout » : `done` dépôts traités sur `total`, dont ceux laissés
|
|
93
112
|
* de côté parce qu'une opération y était en cours (`skipped`) et ceux dont
|
|
94
|
-
* l'audit a échoué, avec la raison (`failed`)
|
|
113
|
+
* l'audit a échoué, avec la raison (`failed`) ; `scope` est le périmètre des
|
|
114
|
+
* audits.
|
|
95
115
|
*/
|
|
96
116
|
export interface AuditAllState {
|
|
97
117
|
running: boolean;
|
|
118
|
+
scope: AuditScope;
|
|
98
119
|
startedAt: string;
|
|
99
120
|
finishedAt: string | null;
|
|
100
121
|
total: number;
|
|
@@ -121,6 +142,17 @@ export interface AddableReposResponse {
|
|
|
121
142
|
export interface OperationResponse {
|
|
122
143
|
operation: Operation;
|
|
123
144
|
}
|
|
145
|
+
/** Commentaire d'une tâche organizer : son auteur, son texte et sa date. */
|
|
146
|
+
export interface Remark {
|
|
147
|
+
author: string;
|
|
148
|
+
body: string;
|
|
149
|
+
createdAt: string;
|
|
150
|
+
}
|
|
151
|
+
/** Tâche de l'analyse d'une opération et ses commentaires récents, du plus ancien au plus récent. */
|
|
152
|
+
export interface RemarksResponse {
|
|
153
|
+
task: AnalysisTask;
|
|
154
|
+
remarks: Remark[];
|
|
155
|
+
}
|
|
124
156
|
export interface AppConfig {
|
|
125
157
|
version: string;
|
|
126
158
|
dataDir: string;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import { RightsSchema } from "./model.schema.js";
|
|
2
|
+
import { AUDIT_SCOPES, RightsSchema } 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 const AddRepoBodySchema = z.object({
|
|
5
5
|
repository: z.string().trim().min(1),
|
|
@@ -12,8 +12,12 @@ export const SetCategoryBodySchema = z.object({ categoryId: z.string().min(1).nu
|
|
|
12
12
|
/** Corps de `POST /api/categories` et de `PUT /api/categories/:id`. */
|
|
13
13
|
export const CategoryBodySchema = z.object({ name: z.string().trim().min(1).max(60) });
|
|
14
14
|
export const CategoryRequestSchema = z.object({ categoryId: z.string().min(1) });
|
|
15
|
+
/** Corps de `POST /api/repos/:owner/:name/operations` et de `POST /api/audit-all` : le périmètre de l'audit. */
|
|
16
|
+
export const ScopeBodySchema = z.object({ scope: z.enum(AUDIT_SCOPES) });
|
|
15
17
|
/** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
|
|
16
18
|
export const ForceBodySchema = z.object({ apply: z.boolean() });
|
|
19
|
+
/** `run` : lancer ou relancer les corrections par Claude ; sinon l'étape est passée. */
|
|
20
|
+
export const RepairBodySchema = z.object({ run: z.boolean() });
|
|
17
21
|
export const PushBodySchema = z.object({ commitMessage: z.string().trim().min(1) });
|
|
18
22
|
/** Identifiant d'un dépôt dans une requête IPC. */
|
|
19
23
|
export const RepoRequestSchema = z.object({ repoId: z.string().min(1) });
|
|
@@ -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", "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", "DECIDE_FORCE", "PUSH_OPERATION", "CANCEL_OPERATION", "GET_SETTINGS", "SAVE_SETTINGS", "TEST_ORGANIZER"];
|
|
25
|
+
export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_REPOS", "SYNC_REPOS", "GET_AUDIT_ALL", "START_AUDIT_ALL", "LIST_ADDABLE_REPOS", "GET_REPO", "ADD_REPO", "REMOVE_REPO", "DEPRECATE_REPO", "RESTORE_REPO", "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", "DECIDE_FORCE", "DECIDE_REPAIR", "GET_REMARKS", "PUSH_OPERATION", "CANCEL_OPERATION", "GET_SETTINGS", "SAVE_SETTINGS", "TEST_ORGANIZER"];
|
|
26
26
|
export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];
|
|
@@ -17,7 +17,21 @@ export declare const RightsSchema: z.ZodObject<{
|
|
|
17
17
|
export type Rights = z.infer<typeof RightsSchema>;
|
|
18
18
|
/** Droits d'un dépôt qui vient d'être ajouté : l'audit seul. */
|
|
19
19
|
export declare const DEFAULT_RIGHTS: Rights;
|
|
20
|
-
/**
|
|
20
|
+
/**
|
|
21
|
+
* Périmètre d'un audit et de ses corrections : `production` laisse de côté les
|
|
22
|
+
* devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
|
|
23
|
+
*/
|
|
24
|
+
export declare const AUDIT_SCOPES: readonly ["production", "all"];
|
|
25
|
+
export type AuditScope = (typeof AUDIT_SCOPES)[number];
|
|
26
|
+
export declare const DEFAULT_AUDIT_SCOPE: AuditScope;
|
|
27
|
+
/** Portée d'une dépendance vulnérable selon Dependabot : exécution ou développement. */
|
|
28
|
+
export declare const DEPENDENCY_SCOPES: readonly ["runtime", "development"];
|
|
29
|
+
export type DependencyScope = (typeof DEPENDENCY_SCOPES)[number];
|
|
30
|
+
/**
|
|
31
|
+
* Alerte Dependabot ouverte, telle que la renvoie l'API GitHub, réduite à ce qui
|
|
32
|
+
* s'affiche ; `createdAt` est sa date d'émission, `scope` la portée de la
|
|
33
|
+
* dépendance, null quand GitHub ne la connaît pas.
|
|
34
|
+
*/
|
|
21
35
|
export declare const AlertSchema: z.ZodObject<{
|
|
22
36
|
number: z.ZodNumber;
|
|
23
37
|
severity: z.ZodEnum<{
|
|
@@ -33,6 +47,10 @@ export declare const AlertSchema: z.ZodObject<{
|
|
|
33
47
|
url: z.ZodString;
|
|
34
48
|
patchedVersion: z.ZodNullable<z.ZodString>;
|
|
35
49
|
createdAt: z.ZodString;
|
|
50
|
+
scope: z.ZodNullable<z.ZodEnum<{
|
|
51
|
+
development: "development";
|
|
52
|
+
runtime: "runtime";
|
|
53
|
+
}>>;
|
|
36
54
|
}, z.core.$strip>;
|
|
37
55
|
export type Alert = z.infer<typeof AlertSchema>;
|
|
38
56
|
/**
|
|
@@ -97,6 +115,10 @@ export declare const RepoSchema: z.ZodObject<{
|
|
|
97
115
|
url: z.ZodString;
|
|
98
116
|
patchedVersion: z.ZodNullable<z.ZodString>;
|
|
99
117
|
createdAt: z.ZodString;
|
|
118
|
+
scope: z.ZodNullable<z.ZodEnum<{
|
|
119
|
+
development: "development";
|
|
120
|
+
runtime: "runtime";
|
|
121
|
+
}>>;
|
|
100
122
|
}, z.core.$strip>>;
|
|
101
123
|
handledAlerts: z.ZodArray<z.ZodObject<{
|
|
102
124
|
number: z.ZodNumber;
|
|
@@ -148,6 +170,10 @@ export declare const ReposFileSchema: z.ZodObject<{
|
|
|
148
170
|
url: z.ZodString;
|
|
149
171
|
patchedVersion: z.ZodNullable<z.ZodString>;
|
|
150
172
|
createdAt: z.ZodString;
|
|
173
|
+
scope: z.ZodNullable<z.ZodEnum<{
|
|
174
|
+
development: "development";
|
|
175
|
+
runtime: "runtime";
|
|
176
|
+
}>>;
|
|
151
177
|
}, z.core.$strip>>;
|
|
152
178
|
handledAlerts: z.ZodArray<z.ZodObject<{
|
|
153
179
|
number: z.ZodNumber;
|
|
@@ -173,13 +199,14 @@ export type OperationKind = (typeof OPERATION_KINDS)[number];
|
|
|
173
199
|
export declare const ORIGINS: readonly ["user", "agent"];
|
|
174
200
|
export type Origin = (typeof ORIGINS)[number];
|
|
175
201
|
/**
|
|
176
|
-
* `running` : une étape s'exécute ; `waiting_force
|
|
177
|
-
* doit décider de la suite ; les trois derniers
|
|
202
|
+
* `running` : une étape s'exécute ; `waiting_force`, `waiting_repair` et
|
|
203
|
+
* `waiting_push` : l'utilisateur doit décider de la suite ; les trois derniers
|
|
204
|
+
* états sont terminaux.
|
|
178
205
|
*/
|
|
179
|
-
export declare const OPERATION_STATUSES: readonly ["running", "waiting_force", "waiting_push", "done", "failed", "cancelled"];
|
|
206
|
+
export declare const OPERATION_STATUSES: readonly ["running", "waiting_force", "waiting_repair", "waiting_push", "done", "failed", "cancelled"];
|
|
180
207
|
export type OperationStatus = (typeof OPERATION_STATUSES)[number];
|
|
181
208
|
export declare const ACTIVE_STATUSES: readonly OperationStatus[];
|
|
182
|
-
export declare const STEP_NAMES: readonly ["clone", "audit", "fix", "analysis", "force", "push"];
|
|
209
|
+
export declare const STEP_NAMES: readonly ["clone", "audit", "fix", "analysis", "force", "repair", "push"];
|
|
183
210
|
export type StepName = (typeof STEP_NAMES)[number];
|
|
184
211
|
export declare const STEP_STATES: readonly ["pending", "running", "done", "skipped", "failed"];
|
|
185
212
|
export type StepState = (typeof STEP_STATES)[number];
|
|
@@ -239,6 +266,29 @@ export declare const AnalysisReportSchema: z.ZodObject<{
|
|
|
239
266
|
}, z.core.$strip>;
|
|
240
267
|
}, z.core.$strip>;
|
|
241
268
|
export type AnalysisReport = z.infer<typeof AnalysisReportSchema>;
|
|
269
|
+
/** Résultat des tests lancés par Claude après ses corrections. */
|
|
270
|
+
export declare const TEST_OUTCOMES: readonly ["passed", "failed", "not_run"];
|
|
271
|
+
/**
|
|
272
|
+
* Rapport rendu par Claude à la fin de ses corrections : résumé, changement de
|
|
273
|
+
* chaque fichier, message du commit et résultat des tests.
|
|
274
|
+
*/
|
|
275
|
+
export declare const RepairReportSchema: z.ZodObject<{
|
|
276
|
+
summary: z.ZodString;
|
|
277
|
+
changes: z.ZodArray<z.ZodObject<{
|
|
278
|
+
file: z.ZodString;
|
|
279
|
+
change: z.ZodString;
|
|
280
|
+
}, z.core.$strip>>;
|
|
281
|
+
commitMessage: z.ZodString;
|
|
282
|
+
tests: z.ZodObject<{
|
|
283
|
+
outcome: z.ZodEnum<{
|
|
284
|
+
failed: "failed";
|
|
285
|
+
not_run: "not_run";
|
|
286
|
+
passed: "passed";
|
|
287
|
+
}>;
|
|
288
|
+
detail: z.ZodString;
|
|
289
|
+
}, z.core.$strip>;
|
|
290
|
+
}, z.core.$strip>;
|
|
291
|
+
export type RepairReport = z.infer<typeof RepairReportSchema>;
|
|
242
292
|
/** Statuts d'une tâche de l'organizer. */
|
|
243
293
|
export declare const TASK_STATUSES: readonly ["todo", "doing", "review", "done"];
|
|
244
294
|
/** Tâche créée dans l'organizer par une analyse ; `url` ouvre la tâche sur le site, `status` est relu à chaque synchronisation. */
|
|
@@ -290,11 +340,62 @@ export declare const AnalysisSchema: z.ZodObject<{
|
|
|
290
340
|
}, z.core.$strip>;
|
|
291
341
|
export type Analysis = z.infer<typeof AnalysisSchema>;
|
|
292
342
|
/**
|
|
293
|
-
*
|
|
343
|
+
* Corrections par Claude, d'après la tâche de l'analyse et les commentaires de
|
|
344
|
+
* l'utilisateur. `base` est le commit sur lequel repose celui de Claude : le
|
|
345
|
+
* commit de `npm audit fix` (`auditCommit`), ou le commit cloné quand
|
|
346
|
+
* `npm audit fix` n'a rien changé et que `auditCommit` est null.
|
|
347
|
+
* `commit` est le commit de Claude, null tant qu'il n'a rien modifié ; `task`
|
|
348
|
+
* la sous-tâche « rapport de développement ». `turns` et `activity` suivent la
|
|
349
|
+
* session en cours ; `error` est la raison de l'échec du dernier passage, les
|
|
350
|
+
* résultats du passage précédent restant valables.
|
|
351
|
+
*/
|
|
352
|
+
export declare const RepairSchema: z.ZodObject<{
|
|
353
|
+
runs: z.ZodNumber;
|
|
354
|
+
startedAt: z.ZodString;
|
|
355
|
+
endedAt: z.ZodNullable<z.ZodString>;
|
|
356
|
+
turns: z.ZodNumber;
|
|
357
|
+
activity: z.ZodArray<z.ZodString>;
|
|
358
|
+
base: z.ZodString;
|
|
359
|
+
auditCommit: z.ZodNullable<z.ZodString>;
|
|
360
|
+
commit: z.ZodNullable<z.ZodString>;
|
|
361
|
+
report: z.ZodNullable<z.ZodObject<{
|
|
362
|
+
summary: z.ZodString;
|
|
363
|
+
changes: z.ZodArray<z.ZodObject<{
|
|
364
|
+
file: z.ZodString;
|
|
365
|
+
change: z.ZodString;
|
|
366
|
+
}, z.core.$strip>>;
|
|
367
|
+
commitMessage: z.ZodString;
|
|
368
|
+
tests: z.ZodObject<{
|
|
369
|
+
outcome: z.ZodEnum<{
|
|
370
|
+
failed: "failed";
|
|
371
|
+
not_run: "not_run";
|
|
372
|
+
passed: "passed";
|
|
373
|
+
}>;
|
|
374
|
+
detail: z.ZodString;
|
|
375
|
+
}, z.core.$strip>;
|
|
376
|
+
}, z.core.$strip>>;
|
|
377
|
+
task: z.ZodNullable<z.ZodObject<{
|
|
378
|
+
key: z.ZodString;
|
|
379
|
+
title: z.ZodString;
|
|
380
|
+
url: z.ZodString;
|
|
381
|
+
status: z.ZodEnum<{
|
|
382
|
+
doing: "doing";
|
|
383
|
+
done: "done";
|
|
384
|
+
review: "review";
|
|
385
|
+
todo: "todo";
|
|
386
|
+
}>;
|
|
387
|
+
}, z.core.$strip>>;
|
|
388
|
+
error: z.ZodNullable<z.ZodString>;
|
|
389
|
+
}, z.core.$strip>;
|
|
390
|
+
export type Repair = z.infer<typeof RepairSchema>;
|
|
391
|
+
/**
|
|
392
|
+
* Opération d'audit ou de correction sur un clone temporaire, limitée aux
|
|
393
|
+
* dépendances de `scope`. `workDir` est le
|
|
294
394
|
* clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
|
|
295
395
|
* qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
|
|
296
396
|
* audit, `remaining` celles qui restent après la dernière étape. `analysis` est
|
|
297
|
-
* l'analyse par Claude, null quand elle n'a pas été lancée
|
|
397
|
+
* l'analyse par Claude, null quand elle n'a pas été lancée ; `repair` ses
|
|
398
|
+
* corrections, null tant qu'elles n'ont pas été lancées.
|
|
298
399
|
*/
|
|
299
400
|
export declare const OperationSchema: z.ZodObject<{
|
|
300
401
|
id: z.ZodString;
|
|
@@ -307,6 +408,10 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
307
408
|
agent: "agent";
|
|
308
409
|
user: "user";
|
|
309
410
|
}>;
|
|
411
|
+
scope: z.ZodEnum<{
|
|
412
|
+
all: "all";
|
|
413
|
+
production: "production";
|
|
414
|
+
}>;
|
|
310
415
|
status: z.ZodEnum<{
|
|
311
416
|
cancelled: "cancelled";
|
|
312
417
|
done: "done";
|
|
@@ -314,6 +419,7 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
314
419
|
running: "running";
|
|
315
420
|
waiting_force: "waiting_force";
|
|
316
421
|
waiting_push: "waiting_push";
|
|
422
|
+
waiting_repair: "waiting_repair";
|
|
317
423
|
}>;
|
|
318
424
|
createdAt: z.ZodString;
|
|
319
425
|
updatedAt: z.ZodString;
|
|
@@ -357,6 +463,13 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
357
463
|
running: "running";
|
|
358
464
|
skipped: "skipped";
|
|
359
465
|
}>;
|
|
466
|
+
repair: z.ZodEnum<{
|
|
467
|
+
done: "done";
|
|
468
|
+
failed: "failed";
|
|
469
|
+
pending: "pending";
|
|
470
|
+
running: "running";
|
|
471
|
+
skipped: "skipped";
|
|
472
|
+
}>;
|
|
360
473
|
push: z.ZodEnum<{
|
|
361
474
|
done: "done";
|
|
362
475
|
failed: "failed";
|
|
@@ -370,6 +483,7 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
370
483
|
initial: z.ZodNullable<z.ZodNumber>;
|
|
371
484
|
afterFix: z.ZodNullable<z.ZodNumber>;
|
|
372
485
|
afterForce: z.ZodNullable<z.ZodNumber>;
|
|
486
|
+
afterRepair: z.ZodNullable<z.ZodNumber>;
|
|
373
487
|
}, z.core.$strip>;
|
|
374
488
|
found: z.ZodArray<z.ZodObject<{
|
|
375
489
|
project: z.ZodString;
|
|
@@ -451,6 +565,44 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
451
565
|
}, z.core.$strip>>;
|
|
452
566
|
error: z.ZodNullable<z.ZodString>;
|
|
453
567
|
}, z.core.$strip>>;
|
|
568
|
+
repair: z.ZodNullable<z.ZodObject<{
|
|
569
|
+
runs: z.ZodNumber;
|
|
570
|
+
startedAt: z.ZodString;
|
|
571
|
+
endedAt: z.ZodNullable<z.ZodString>;
|
|
572
|
+
turns: z.ZodNumber;
|
|
573
|
+
activity: z.ZodArray<z.ZodString>;
|
|
574
|
+
base: z.ZodString;
|
|
575
|
+
auditCommit: z.ZodNullable<z.ZodString>;
|
|
576
|
+
commit: z.ZodNullable<z.ZodString>;
|
|
577
|
+
report: z.ZodNullable<z.ZodObject<{
|
|
578
|
+
summary: z.ZodString;
|
|
579
|
+
changes: z.ZodArray<z.ZodObject<{
|
|
580
|
+
file: z.ZodString;
|
|
581
|
+
change: z.ZodString;
|
|
582
|
+
}, z.core.$strip>>;
|
|
583
|
+
commitMessage: z.ZodString;
|
|
584
|
+
tests: z.ZodObject<{
|
|
585
|
+
outcome: z.ZodEnum<{
|
|
586
|
+
failed: "failed";
|
|
587
|
+
not_run: "not_run";
|
|
588
|
+
passed: "passed";
|
|
589
|
+
}>;
|
|
590
|
+
detail: z.ZodString;
|
|
591
|
+
}, z.core.$strip>;
|
|
592
|
+
}, z.core.$strip>>;
|
|
593
|
+
task: z.ZodNullable<z.ZodObject<{
|
|
594
|
+
key: z.ZodString;
|
|
595
|
+
title: z.ZodString;
|
|
596
|
+
url: z.ZodString;
|
|
597
|
+
status: z.ZodEnum<{
|
|
598
|
+
doing: "doing";
|
|
599
|
+
done: "done";
|
|
600
|
+
review: "review";
|
|
601
|
+
todo: "todo";
|
|
602
|
+
}>;
|
|
603
|
+
}, z.core.$strip>>;
|
|
604
|
+
error: z.ZodNullable<z.ZodString>;
|
|
605
|
+
}, z.core.$strip>>;
|
|
454
606
|
error: z.ZodNullable<z.ZodString>;
|
|
455
607
|
log: z.ZodArray<z.ZodObject<{
|
|
456
608
|
at: z.ZodString;
|