@imenam/mcp-dependabot-tracker 1.0.8 → 1.0.10
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 +47 -12
- package/dist/shared/schemas/api.schema.d.ts +5 -2
- package/dist/shared/schemas/ipc.schema.d.ts +1 -1
- package/dist/shared/schemas/ipc.schema.js +5 -0
- package/dist/shared/schemas/model.schema.d.ts +107 -3
- package/dist/shared/schemas/model.schema.js +38 -3
- package/dist/shared/schemas/settings.schema.d.ts +78 -0
- package/dist/shared/schemas/settings.schema.js +42 -0
- package/dist/src/core/analysis.d.ts +29 -0
- package/dist/src/core/analysis.js +177 -0
- package/dist/src/core/claude.d.ts +43 -0
- package/dist/src/core/claude.js +196 -0
- package/dist/src/core/commands.d.ts +2 -0
- package/dist/src/core/commands.js +1 -1
- package/dist/src/core/operations.d.ts +11 -4
- package/dist/src/core/operations.js +76 -8
- package/dist/src/core/organizer.d.ts +43 -0
- package/dist/src/core/organizer.js +95 -0
- package/dist/src/core/repos.d.ts +12 -4
- package/dist/src/core/repos.js +31 -6
- package/dist/src/core/settings.d.ts +21 -0
- package/dist/src/core/settings.js +108 -0
- package/dist/src/core/store.d.ts +2 -0
- package/dist/src/core/store.js +17 -4
- package/dist/src/gui-worker.js +11 -0
- package/dist/src/index.js +32 -4
- package/dist/src/tools/tools.d.ts +1 -1
- package/dist/src/tools/tools.js +2 -2
- package/gui/dist/assets/index-C1Ml-XiM.css +1 -0
- package/gui/dist/assets/index-DQPqW5Uq.js +64 -0
- package/gui/dist/index.html +2 -2
- package/package.json +2 -1
- package/gui/dist/assets/index-D_wlwOtv.js +0 -64
- package/gui/dist/assets/index-U8DEkNi4.css +0 -1
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
|
-
|
|
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)).
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
@@ -19,7 +19,7 @@ Le serveur n'appelle aucun LLM. L'agent n'exécute jamais `git` ni `npm` lui-mê
|
|
|
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.
|
|
22
|
+
Ou via `npx`, sans installation. Le serveur communique en JSON-RPC sur stdio : il est lancé par le client MCP, pas à la main. `git` et `npm` (npm 7 ou plus récent) doivent être dans le `PATH` de la machine qui exécute le serveur. Claude Code, utilisé par l'analyse, est une dépendance du package (`@anthropic-ai/claude-code`, Node 22 ou plus récent) : rien d'autre à installer.
|
|
23
23
|
|
|
24
24
|
### Déclaration dans un projet
|
|
25
25
|
|
|
@@ -121,13 +121,13 @@ Cinq outils, en anglais. Le résultat d'une opération se termine par le lien ve
|
|
|
121
121
|
|
|
122
122
|
| Outil | Droit | Effet |
|
|
123
123
|
|---|---|---|
|
|
124
|
-
| `list_repositories` | — | Dépôts suivis, 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. |
|
|
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, résumé, version corrigée, marque « corrigée à la main » de l'utilisateur, lien. |
|
|
126
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
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. |
|
|
128
128
|
| `reconnect_gui` | — | Relance le worker GUI et le réenregistre auprès du proxy. |
|
|
129
129
|
|
|
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 champ inconnu fait échouer l'appel. Les outils d'opération attendent la fin de l'opération.
|
|
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.
|
|
131
131
|
|
|
132
132
|
---
|
|
133
133
|
|
|
@@ -139,7 +139,8 @@ La **branche analysée** se choisit par dépôt dans la GUI ; c'est la branche p
|
|
|
139
139
|
|
|
140
140
|
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
141
|
2. **npm audit** — `npm audit --json` dans chaque projet.
|
|
142
|
-
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.
|
|
142
|
+
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
|
+
**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.
|
|
143
144
|
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.
|
|
144
145
|
5. **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. Son corps donne les vulnérabilités avant et après, l'application de `--force` et les paquets mis à jour.
|
|
145
146
|
|
|
@@ -151,7 +152,34 @@ Les paquets mis à jour sont lus en comparant chaque lockfile à celui du commit
|
|
|
151
152
|
|
|
152
153
|
Depuis la GUI, l'opération s'arrête aux étapes 4 et 5 pour la décision de l'utilisateur. Menée par l'agent, elle va d'un bout à l'autre selon `force` et `push`. Une seule opération à la fois par dépôt.
|
|
153
154
|
|
|
154
|
-
**Annulation** — une opération en attente se termine aussitôt. Une opération en cours reçoit une demande d'annulation que le processus qui l'exécute lit toutes les 500 ms : il arrête la commande en cours (arbre de processus compris) et supprime le clone. Une opération dont le processus a disparu passe en échec à la lecture suivante.
|
|
155
|
+
**Annulation** — une opération en attente se termine aussitôt. Une opération en cours reçoit une demande d'annulation que le processus qui l'exécute lit toutes les 500 ms : il arrête la commande en cours (arbre de processus compris, Claude Code compris) et supprime le clone. Une opération dont le processus a disparu passe en échec à la lecture suivante.
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## L'analyse par Claude
|
|
160
|
+
|
|
161
|
+
Quand `npm audit fix` laisse des vulnérabilités dans une correction lancée depuis la GUI, le tracker lance une session Claude Code non interactive (`claude -p`) dans le clone, avant la décision sur `--force`. Claude :
|
|
162
|
+
|
|
163
|
+
1. lit le code du clone pour voir comment chaque paquet vulnérable est utilisé, si la faille est atteignable et ce qui est urgent à corriger à la main ;
|
|
164
|
+
2. juge si `npm audit fix --force` vaut la peine, d'après les API des paquets montés de version que le projet utilise ;
|
|
165
|
+
3. crée **une tâche** dans l'espace organizer réglé : titre et description en français, rapport par paquet, décision sur `--force`, actions à mener dans l'ordre, fichiers concernés, vérifications — de quoi faire reprendre la correction par un autre agent. Elle est assignée au propriétaire de l'espace et porte pour tag le nom du dépôt ;
|
|
166
|
+
4. rend un rapport structuré (`--json-schema`) : clé de la tâche, résumé, corrections urgentes, avis sur `--force`.
|
|
167
|
+
|
|
168
|
+
Le tracker relit ensuite la tâche sur l'organizer : une tâche introuvable, sans le tag ou non assignée au propriétaire fait échouer l'analyse, avec la raison. Un échec de l'analyse s'affiche sous son étape et laisse la correction se poursuivre ; l'annulation de l'opération arrête Claude Code.
|
|
169
|
+
|
|
170
|
+
**Ce que Claude peut faire** — la session reçoit le prompt, les vulnérabilités restantes (extraites de `npm audit --json`) et les montées majeures que `--force` appliquerait. Ses seuls outils intégrés sont `Read`, `Grep` et `Glob`, dans le clone : ni shell, ni écriture. Elle charge un seul serveur MCP, `@imenam/mcp-organizer` lancé par `npx` avec l'adresse et le token réglés (`--strict-mcp-config`), dont seuls `create_task`, `set_assignees`, `set_tags` et `get_task` sont autorisés ; tout autre appel est refusé (`--permission-mode dontAsk`). Les réglages Claude du dépôt cloné ne sont pas lus (`--setting-sources user`). Claude Code reçoit son token et quelques variables système (`PATH`, `LANG`, dossiers temporaires) : jamais `GITHUB_TOKEN`. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session.
|
|
171
|
+
|
|
172
|
+
**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.
|
|
173
|
+
|
|
174
|
+
**Réglages** (écran Réglages, roue dentée de l'accueil) :
|
|
175
|
+
|
|
176
|
+
- **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.
|
|
177
|
+
- **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.
|
|
178
|
+
- **Analyse** — « Analyser automatiquement », qui exige l'organizer et Claude, et les limites.
|
|
179
|
+
|
|
180
|
+
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.
|
|
181
|
+
|
|
182
|
+
**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.
|
|
155
183
|
|
|
156
184
|
---
|
|
157
185
|
|
|
@@ -159,13 +187,17 @@ Depuis la GUI, l'opération s'arrête aux étapes 4 et 5 pour la décision de l'
|
|
|
159
187
|
|
|
160
188
|
Thème sombre, une information par ligne, une action principale par écran.
|
|
161
189
|
|
|
162
|
-
- **Accueil (`#/`, `#/c/<catégorie>`)** — à gauche, la barre des catégories : « Tous mes projets », 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.
|
|
163
|
-
À droite, les dépôts 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. En bout de ligne, une seule information : le nombre d'alertes coloré selon la gravité la plus haute, « Correction en cours », « Audit en cours », « Synchronisation impossible » (l'erreur en infobulle) ou « À jour ». 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. À 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.
|
|
190
|
+
- **Accueil (`#/`, `#/c/<catégorie>`)** — à gauche, la barre des catégories : « Tous mes projets », 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.
|
|
191
|
+
À 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. En bout de ligne, une seule information : le nombre d'alertes coloré selon la gravité la plus haute, « Correction en cours », « Analyse par Claude… », « Audit en cours », « Synchronisation impossible » (l'erreur en infobulle) ou « À jour ». Devant, « Tâche MNT-12 » ouvre la tâche organizer de la dernière analyse, tant qu'elle n'est pas terminée. Quand le dernier audit (de l'utilisateur ou de l'agent) n'a trouvé aucune vulnérabilité alors que Dependabot signale encore des alertes, la ligne affiche « Audit OK le <jour> à <heure> » et estompe la pastille des alertes : Dependabot n'a pas encore repassé. La mention ne vaut que pour un audit de la branche par défaut, la seule que Dependabot analyse ; elle disparaît dès qu'un audit plus récent trouve une vulnérabilité, que Dependabot n'a plus d'alerte, ou qu'il en émet une après l'audit. À 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.
|
|
192
|
+
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.
|
|
164
193
|
« 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.
|
|
165
194
|
« 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.
|
|
166
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).
|
|
196
|
+
La roue dentée, à gauche de « Synchroniser maintenant », ouvre les réglages.
|
|
197
|
+
- **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
|
+
- **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é.
|
|
167
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, ou « 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).
|
|
168
|
-
- **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. L'étape `--force` liste les montées majeures avec « Appliquer --force » et « Passer » ; 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 ». 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.
|
|
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 ; 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 ». 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.
|
|
169
201
|
|
|
170
202
|
Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les secondes pendant une opération.
|
|
171
203
|
|
|
@@ -181,11 +213,12 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
|
|
|
181
213
|
| Route | Effet |
|
|
182
214
|
|---|---|
|
|
183
215
|
| `GET /api/config` | Version, répertoire des données, présence du token. |
|
|
184
|
-
| `GET /api/repos`, `POST /api/repos` | Dépôts suivis (avec catégorie, opération en cours et dernière opération) et catégories ; ajout d'un dépôt (`{ repository, categoryId? }`). |
|
|
185
|
-
| `POST /api/sync` | Relit tout de suite les alertes et les pull requests de chaque dépôt suivi
|
|
216
|
+
| `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
|
+
| `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. |
|
|
186
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). |
|
|
187
219
|
| `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
|
|
188
220
|
| `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
|
|
221
|
+
| `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. |
|
|
189
222
|
| `PUT /api/repos/:propriétaire/:nom/rights` | Droits de l'agent. |
|
|
190
223
|
| `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). |
|
|
191
224
|
| `PUT` / `DELETE /api/repos/:propriétaire/:nom/alerts/:numéro/handled` | Marque une alerte ouverte corrigée à la main ; retire la marque. |
|
|
@@ -195,12 +228,14 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
|
|
|
195
228
|
| `POST /api/repos/:propriétaire/:nom/operations` | Lance une correction. |
|
|
196
229
|
| `GET /api/operations/:id` | Opération. |
|
|
197
230
|
| `POST /api/operations/:id/force`, `/push`, `/cancel` | Décision `--force` (`{ apply }`), push (`{ commitMessage }`), annulation. |
|
|
231
|
+
| `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
|
+
| `POST /api/settings/organizer/test` | Reteste la connexion enregistrée à l'organizer. |
|
|
198
233
|
|
|
199
234
|
Erreurs : `400` requête invalide, `404` introuvable, `409` conflit (opération déjà en cours, étape qui n'attend pas cette décision), `500` sinon.
|
|
200
235
|
|
|
201
236
|
### Persistance
|
|
202
237
|
|
|
203
|
-
`<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)
|
|
238
|
+
`<données>/repos.json` pour les catégories et les dépôts (catégorie, droits, alertes, alertes corrigées à la main, dernière lecture, date de dépréciation), `<données>/operations/<id>.json` pour chaque opération (analyse par Claude comprise) ; les 20 plus récentes sont conservées par dépôt. `<données>/settings.json` porte les réglages de l'analyse et ses tokens, `<données>/claude` la configuration de Claude Code. Plusieurs instances du serveur (une par session d'agent) partagent le répertoire : les écritures sont atomiques et passent par le verrou `<données>/data.lock`. Une opération lancée par une instance se poursuit, s'annule ou se décide depuis la GUI d'une autre.
|
|
204
239
|
|
|
205
240
|
---
|
|
206
241
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import { type AlertSeverity, type Category, type Operation, type Repo } from "./model.schema.js";
|
|
2
|
+
import { type AlertSeverity, type AnalysisTask, 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;
|
|
@@ -74,7 +74,9 @@ export interface AuditFindings {
|
|
|
74
74
|
* signale encore des alertes émises avant lui ; `auditFindings` ce qu'a trouvé
|
|
75
75
|
* le dernier audit de la branche par défaut alors que Dependabot ne signale
|
|
76
76
|
* aucune alerte ; `unfixable` les paquets pour lesquels le dernier audit n'a
|
|
77
|
-
* trouvé aucune version corrigée, hors ceux marqués corrigés à la main
|
|
77
|
+
* trouvé aucune version corrigée, hors ceux marqués corrigés à la main ;
|
|
78
|
+
* `analysisTask` la tâche organizer de la dernière analyse par Claude, tant
|
|
79
|
+
* qu'elle n'est pas terminée.
|
|
78
80
|
*/
|
|
79
81
|
export interface RepoView {
|
|
80
82
|
repo: Repo;
|
|
@@ -84,6 +86,7 @@ export interface RepoView {
|
|
|
84
86
|
cleanAuditAt: string | null;
|
|
85
87
|
auditFindings: AuditFindings | null;
|
|
86
88
|
unfixable: string[];
|
|
89
|
+
analysisTask: AnalysisTask | null;
|
|
87
90
|
}
|
|
88
91
|
/**
|
|
89
92
|
* Série « Auditer tout » : `done` dépôts traités sur `total`, dont ceux laissés
|
|
@@ -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", "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"];
|
|
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"];
|
|
26
26
|
export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];
|
|
@@ -25,6 +25,8 @@ export const GUI_REQUEST_TYPES = [
|
|
|
25
25
|
"GET_REPO",
|
|
26
26
|
"ADD_REPO",
|
|
27
27
|
"REMOVE_REPO",
|
|
28
|
+
"DEPRECATE_REPO",
|
|
29
|
+
"RESTORE_REPO",
|
|
28
30
|
"SET_RIGHTS",
|
|
29
31
|
"LIST_BRANCHES",
|
|
30
32
|
"SET_BRANCH",
|
|
@@ -40,4 +42,7 @@ export const GUI_REQUEST_TYPES = [
|
|
|
40
42
|
"DECIDE_FORCE",
|
|
41
43
|
"PUSH_OPERATION",
|
|
42
44
|
"CANCEL_OPERATION",
|
|
45
|
+
"GET_SETTINGS",
|
|
46
|
+
"SAVE_SETTINGS",
|
|
47
|
+
"TEST_ORGANIZER",
|
|
43
48
|
];
|
|
@@ -64,7 +64,9 @@ export type Category = z.infer<typeof CategorySchema>;
|
|
|
64
64
|
* la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
|
|
65
65
|
* `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
|
|
66
66
|
* `handledAlerts` les alertes qu'il a marquées corrigées à la main ;
|
|
67
|
-
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture
|
|
67
|
+
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture ;
|
|
68
|
+
* `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
|
|
69
|
+
* dépôt déprécié n'est plus synchronisé ni audité.
|
|
68
70
|
*/
|
|
69
71
|
export declare const RepoSchema: z.ZodObject<{
|
|
70
72
|
id: z.ZodString;
|
|
@@ -109,6 +111,7 @@ export declare const RepoSchema: z.ZodObject<{
|
|
|
109
111
|
}, z.core.$strip>>;
|
|
110
112
|
syncedAt: z.ZodNullable<z.ZodString>;
|
|
111
113
|
syncError: z.ZodNullable<z.ZodString>;
|
|
114
|
+
deprecatedAt: z.ZodNullable<z.ZodString>;
|
|
112
115
|
}, z.core.$strip>;
|
|
113
116
|
export type Repo = z.infer<typeof RepoSchema>;
|
|
114
117
|
export declare const ReposFileSchema: z.ZodObject<{
|
|
@@ -159,6 +162,7 @@ export declare const ReposFileSchema: z.ZodObject<{
|
|
|
159
162
|
}, z.core.$strip>>;
|
|
160
163
|
syncedAt: z.ZodNullable<z.ZodString>;
|
|
161
164
|
syncError: z.ZodNullable<z.ZodString>;
|
|
165
|
+
deprecatedAt: z.ZodNullable<z.ZodString>;
|
|
162
166
|
}, z.core.$strip>>;
|
|
163
167
|
}, z.core.$strip>;
|
|
164
168
|
export type ReposFile = z.infer<typeof ReposFileSchema>;
|
|
@@ -175,7 +179,7 @@ export type Origin = (typeof ORIGINS)[number];
|
|
|
175
179
|
export declare const OPERATION_STATUSES: readonly ["running", "waiting_force", "waiting_push", "done", "failed", "cancelled"];
|
|
176
180
|
export type OperationStatus = (typeof OPERATION_STATUSES)[number];
|
|
177
181
|
export declare const ACTIVE_STATUSES: readonly OperationStatus[];
|
|
178
|
-
export declare const STEP_NAMES: readonly ["clone", "audit", "fix", "force", "push"];
|
|
182
|
+
export declare const STEP_NAMES: readonly ["clone", "audit", "fix", "analysis", "force", "push"];
|
|
179
183
|
export type StepName = (typeof STEP_NAMES)[number];
|
|
180
184
|
export declare const STEP_STATES: readonly ["pending", "running", "done", "skipped", "failed"];
|
|
181
185
|
export type StepState = (typeof STEP_STATES)[number];
|
|
@@ -222,11 +226,75 @@ export declare const LogEntrySchema: z.ZodObject<{
|
|
|
222
226
|
text: z.ZodString;
|
|
223
227
|
}, z.core.$strip>;
|
|
224
228
|
export type LogEntry = z.infer<typeof LogEntrySchema>;
|
|
229
|
+
/** Rapport rendu par Claude à la fin d'une analyse : résumé, corrections urgentes à la main, avis sur `--force`. */
|
|
230
|
+
export declare const AnalysisReportSchema: z.ZodObject<{
|
|
231
|
+
summary: z.ZodString;
|
|
232
|
+
urgent: z.ZodArray<z.ZodObject<{
|
|
233
|
+
package: z.ZodString;
|
|
234
|
+
reason: z.ZodString;
|
|
235
|
+
}, z.core.$strip>>;
|
|
236
|
+
force: z.ZodObject<{
|
|
237
|
+
recommended: z.ZodBoolean;
|
|
238
|
+
reason: z.ZodString;
|
|
239
|
+
}, z.core.$strip>;
|
|
240
|
+
}, z.core.$strip>;
|
|
241
|
+
export type AnalysisReport = z.infer<typeof AnalysisReportSchema>;
|
|
242
|
+
/** Statuts d'une tâche de l'organizer. */
|
|
243
|
+
export declare const TASK_STATUSES: readonly ["todo", "doing", "review", "done"];
|
|
244
|
+
/** Tâche créée dans l'organizer par une analyse ; `url` ouvre la tâche sur le site, `status` est relu à chaque synchronisation. */
|
|
245
|
+
export declare const AnalysisTaskSchema: z.ZodObject<{
|
|
246
|
+
key: z.ZodString;
|
|
247
|
+
title: z.ZodString;
|
|
248
|
+
url: z.ZodString;
|
|
249
|
+
status: z.ZodEnum<{
|
|
250
|
+
doing: "doing";
|
|
251
|
+
done: "done";
|
|
252
|
+
review: "review";
|
|
253
|
+
todo: "todo";
|
|
254
|
+
}>;
|
|
255
|
+
}, z.core.$strip>;
|
|
256
|
+
export type AnalysisTask = z.infer<typeof AnalysisTaskSchema>;
|
|
257
|
+
/**
|
|
258
|
+
* Analyse par Claude des vulnérabilités restantes après `npm audit fix`.
|
|
259
|
+
* `turns` et `activity` (dernières actions de Claude) suivent la session en
|
|
260
|
+
* cours ; `report` et `task` sont remplis à la fin, `error` en cas d'échec.
|
|
261
|
+
*/
|
|
262
|
+
export declare const AnalysisSchema: z.ZodObject<{
|
|
263
|
+
startedAt: z.ZodString;
|
|
264
|
+
endedAt: z.ZodNullable<z.ZodString>;
|
|
265
|
+
turns: z.ZodNumber;
|
|
266
|
+
activity: z.ZodArray<z.ZodString>;
|
|
267
|
+
report: z.ZodNullable<z.ZodObject<{
|
|
268
|
+
summary: z.ZodString;
|
|
269
|
+
urgent: z.ZodArray<z.ZodObject<{
|
|
270
|
+
package: z.ZodString;
|
|
271
|
+
reason: z.ZodString;
|
|
272
|
+
}, z.core.$strip>>;
|
|
273
|
+
force: z.ZodObject<{
|
|
274
|
+
recommended: z.ZodBoolean;
|
|
275
|
+
reason: z.ZodString;
|
|
276
|
+
}, z.core.$strip>;
|
|
277
|
+
}, z.core.$strip>>;
|
|
278
|
+
task: z.ZodNullable<z.ZodObject<{
|
|
279
|
+
key: z.ZodString;
|
|
280
|
+
title: z.ZodString;
|
|
281
|
+
url: z.ZodString;
|
|
282
|
+
status: z.ZodEnum<{
|
|
283
|
+
doing: "doing";
|
|
284
|
+
done: "done";
|
|
285
|
+
review: "review";
|
|
286
|
+
todo: "todo";
|
|
287
|
+
}>;
|
|
288
|
+
}, z.core.$strip>>;
|
|
289
|
+
error: z.ZodNullable<z.ZodString>;
|
|
290
|
+
}, z.core.$strip>;
|
|
291
|
+
export type Analysis = z.infer<typeof AnalysisSchema>;
|
|
225
292
|
/**
|
|
226
293
|
* Opération d'audit ou de correction sur un clone temporaire. `workDir` est le
|
|
227
294
|
* clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
|
|
228
295
|
* qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
|
|
229
|
-
* audit, `remaining` celles qui restent après la dernière étape.
|
|
296
|
+
* 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.
|
|
230
298
|
*/
|
|
231
299
|
export declare const OperationSchema: z.ZodObject<{
|
|
232
300
|
id: z.ZodString;
|
|
@@ -275,6 +343,13 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
275
343
|
running: "running";
|
|
276
344
|
skipped: "skipped";
|
|
277
345
|
}>;
|
|
346
|
+
analysis: z.ZodEnum<{
|
|
347
|
+
done: "done";
|
|
348
|
+
failed: "failed";
|
|
349
|
+
pending: "pending";
|
|
350
|
+
running: "running";
|
|
351
|
+
skipped: "skipped";
|
|
352
|
+
}>;
|
|
278
353
|
force: z.ZodEnum<{
|
|
279
354
|
done: "done";
|
|
280
355
|
failed: "failed";
|
|
@@ -347,6 +422,35 @@ export declare const OperationSchema: z.ZodObject<{
|
|
|
347
422
|
number: z.ZodNumber;
|
|
348
423
|
url: z.ZodString;
|
|
349
424
|
}, z.core.$strip>>;
|
|
425
|
+
analysis: z.ZodNullable<z.ZodObject<{
|
|
426
|
+
startedAt: z.ZodString;
|
|
427
|
+
endedAt: z.ZodNullable<z.ZodString>;
|
|
428
|
+
turns: z.ZodNumber;
|
|
429
|
+
activity: z.ZodArray<z.ZodString>;
|
|
430
|
+
report: z.ZodNullable<z.ZodObject<{
|
|
431
|
+
summary: z.ZodString;
|
|
432
|
+
urgent: z.ZodArray<z.ZodObject<{
|
|
433
|
+
package: z.ZodString;
|
|
434
|
+
reason: z.ZodString;
|
|
435
|
+
}, z.core.$strip>>;
|
|
436
|
+
force: z.ZodObject<{
|
|
437
|
+
recommended: z.ZodBoolean;
|
|
438
|
+
reason: z.ZodString;
|
|
439
|
+
}, z.core.$strip>;
|
|
440
|
+
}, z.core.$strip>>;
|
|
441
|
+
task: z.ZodNullable<z.ZodObject<{
|
|
442
|
+
key: z.ZodString;
|
|
443
|
+
title: z.ZodString;
|
|
444
|
+
url: z.ZodString;
|
|
445
|
+
status: z.ZodEnum<{
|
|
446
|
+
doing: "doing";
|
|
447
|
+
done: "done";
|
|
448
|
+
review: "review";
|
|
449
|
+
todo: "todo";
|
|
450
|
+
}>;
|
|
451
|
+
}, z.core.$strip>>;
|
|
452
|
+
error: z.ZodNullable<z.ZodString>;
|
|
453
|
+
}, z.core.$strip>>;
|
|
350
454
|
error: z.ZodNullable<z.ZodString>;
|
|
351
455
|
log: z.ZodArray<z.ZodObject<{
|
|
352
456
|
at: z.ZodString;
|
|
@@ -51,7 +51,9 @@ export const CategorySchema = z.object({
|
|
|
51
51
|
* la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
|
|
52
52
|
* `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
|
|
53
53
|
* `handledAlerts` les alertes qu'il a marquées corrigées à la main ;
|
|
54
|
-
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture
|
|
54
|
+
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture ;
|
|
55
|
+
* `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
|
|
56
|
+
* dépôt déprécié n'est plus synchronisé ni audité.
|
|
55
57
|
*/
|
|
56
58
|
export const RepoSchema = z.object({
|
|
57
59
|
id: z.string(),
|
|
@@ -67,6 +69,7 @@ export const RepoSchema = z.object({
|
|
|
67
69
|
pullRequests: z.array(PullRequestSchema),
|
|
68
70
|
syncedAt: z.string().nullable(),
|
|
69
71
|
syncError: z.string().nullable(),
|
|
72
|
+
deprecatedAt: z.string().nullable(),
|
|
70
73
|
});
|
|
71
74
|
export const ReposFileSchema = z.object({ categories: z.array(CategorySchema), repos: z.array(RepoSchema) });
|
|
72
75
|
/** `audit` : clone et `npm audit` seulement ; `fix` : jusqu'aux corrections, à la branche et à la PR. */
|
|
@@ -79,7 +82,7 @@ export const ORIGINS = ["user", "agent"];
|
|
|
79
82
|
*/
|
|
80
83
|
export const OPERATION_STATUSES = ["running", "waiting_force", "waiting_push", "done", "failed", "cancelled"];
|
|
81
84
|
export const ACTIVE_STATUSES = ["running", "waiting_force", "waiting_push"];
|
|
82
|
-
export const STEP_NAMES = ["clone", "audit", "fix", "force", "push"];
|
|
85
|
+
export const STEP_NAMES = ["clone", "audit", "fix", "analysis", "force", "push"];
|
|
83
86
|
export const STEP_STATES = ["pending", "running", "done", "skipped", "failed"];
|
|
84
87
|
/** Correction proposée par `npm audit` : aucune, dans les plages déclarées, ou par une version majeure (`--force`). */
|
|
85
88
|
export const FIX_KINDS = ["none", "available", "major"];
|
|
@@ -106,11 +109,41 @@ export const ChangeSchema = z.object({
|
|
|
106
109
|
to: z.string().nullable(),
|
|
107
110
|
});
|
|
108
111
|
export const LogEntrySchema = z.object({ at: z.string(), text: z.string() });
|
|
112
|
+
/** Rapport rendu par Claude à la fin d'une analyse : résumé, corrections urgentes à la main, avis sur `--force`. */
|
|
113
|
+
export const AnalysisReportSchema = z.object({
|
|
114
|
+
summary: z.string(),
|
|
115
|
+
urgent: z.array(z.object({ package: z.string(), reason: z.string() })),
|
|
116
|
+
force: z.object({ recommended: z.boolean(), reason: z.string() }),
|
|
117
|
+
});
|
|
118
|
+
/** Statuts d'une tâche de l'organizer. */
|
|
119
|
+
export const TASK_STATUSES = ["todo", "doing", "review", "done"];
|
|
120
|
+
/** Tâche créée dans l'organizer par une analyse ; `url` ouvre la tâche sur le site, `status` est relu à chaque synchronisation. */
|
|
121
|
+
export const AnalysisTaskSchema = z.object({
|
|
122
|
+
key: z.string(),
|
|
123
|
+
title: z.string(),
|
|
124
|
+
url: z.string(),
|
|
125
|
+
status: z.enum(TASK_STATUSES),
|
|
126
|
+
});
|
|
127
|
+
/**
|
|
128
|
+
* Analyse par Claude des vulnérabilités restantes après `npm audit fix`.
|
|
129
|
+
* `turns` et `activity` (dernières actions de Claude) suivent la session en
|
|
130
|
+
* cours ; `report` et `task` sont remplis à la fin, `error` en cas d'échec.
|
|
131
|
+
*/
|
|
132
|
+
export const AnalysisSchema = z.object({
|
|
133
|
+
startedAt: z.string(),
|
|
134
|
+
endedAt: z.string().nullable(),
|
|
135
|
+
turns: z.number().int(),
|
|
136
|
+
activity: z.array(z.string()),
|
|
137
|
+
report: AnalysisReportSchema.nullable(),
|
|
138
|
+
task: AnalysisTaskSchema.nullable(),
|
|
139
|
+
error: z.string().nullable(),
|
|
140
|
+
});
|
|
109
141
|
/**
|
|
110
142
|
* Opération d'audit ou de correction sur un clone temporaire. `workDir` est le
|
|
111
143
|
* clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
|
|
112
144
|
* qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
|
|
113
|
-
* audit, `remaining` celles qui restent après la dernière étape.
|
|
145
|
+
* audit, `remaining` celles qui restent après la dernière étape. `analysis` est
|
|
146
|
+
* l'analyse par Claude, null quand elle n'a pas été lancée.
|
|
114
147
|
*/
|
|
115
148
|
export const OperationSchema = z.object({
|
|
116
149
|
id: z.string(),
|
|
@@ -128,6 +161,7 @@ export const OperationSchema = z.object({
|
|
|
128
161
|
clone: z.enum(STEP_STATES),
|
|
129
162
|
audit: z.enum(STEP_STATES),
|
|
130
163
|
fix: z.enum(STEP_STATES),
|
|
164
|
+
analysis: z.enum(STEP_STATES),
|
|
131
165
|
force: z.enum(STEP_STATES),
|
|
132
166
|
push: z.enum(STEP_STATES),
|
|
133
167
|
}),
|
|
@@ -144,6 +178,7 @@ export const OperationSchema = z.object({
|
|
|
144
178
|
commitMessage: z.string(),
|
|
145
179
|
branch: z.string().nullable(),
|
|
146
180
|
pullRequest: z.object({ number: z.number().int(), url: z.string() }).nullable(),
|
|
181
|
+
analysis: AnalysisSchema.nullable(),
|
|
147
182
|
error: z.string().nullable(),
|
|
148
183
|
log: z.array(LogEntrySchema),
|
|
149
184
|
});
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/** Limites d'une analyse par Claude : tours appliqués par Claude Code, durée appliquée par le tracker. */
|
|
3
|
+
export declare const ANALYSIS_LIMITS: {
|
|
4
|
+
readonly maxTurns: {
|
|
5
|
+
readonly min: 1;
|
|
6
|
+
readonly max: 200;
|
|
7
|
+
};
|
|
8
|
+
readonly maxMinutes: {
|
|
9
|
+
readonly min: 1;
|
|
10
|
+
readonly max: 60;
|
|
11
|
+
};
|
|
12
|
+
};
|
|
13
|
+
export declare const AnalysisSettingsSchema: z.ZodObject<{
|
|
14
|
+
auto: z.ZodBoolean;
|
|
15
|
+
maxTurns: z.ZodNumber;
|
|
16
|
+
maxMinutes: z.ZodNumber;
|
|
17
|
+
}, z.core.$strip>;
|
|
18
|
+
export type AnalysisSettings = z.infer<typeof AnalysisSettingsSchema>;
|
|
19
|
+
/**
|
|
20
|
+
* Réglages enregistrés dans `<données>/settings.json`. `organizer.space` et
|
|
21
|
+
* `organizer.owner` sont l'espace du token et son propriétaire, relevés au
|
|
22
|
+
* dernier test de la connexion ; `claude.savedAt` est la date d'enregistrement
|
|
23
|
+
* du token Claude, valable un an.
|
|
24
|
+
*/
|
|
25
|
+
export declare const SettingsSchema: z.ZodObject<{
|
|
26
|
+
organizer: z.ZodObject<{
|
|
27
|
+
url: z.ZodNullable<z.ZodString>;
|
|
28
|
+
token: z.ZodNullable<z.ZodString>;
|
|
29
|
+
space: z.ZodNullable<z.ZodString>;
|
|
30
|
+
owner: z.ZodNullable<z.ZodString>;
|
|
31
|
+
}, z.core.$strip>;
|
|
32
|
+
claude: z.ZodObject<{
|
|
33
|
+
token: z.ZodNullable<z.ZodString>;
|
|
34
|
+
savedAt: z.ZodNullable<z.ZodString>;
|
|
35
|
+
}, z.core.$strip>;
|
|
36
|
+
analysis: z.ZodObject<{
|
|
37
|
+
auto: z.ZodBoolean;
|
|
38
|
+
maxTurns: z.ZodNumber;
|
|
39
|
+
maxMinutes: z.ZodNumber;
|
|
40
|
+
}, z.core.$strip>;
|
|
41
|
+
}, z.core.$strip>;
|
|
42
|
+
export type Settings = z.infer<typeof SettingsSchema>;
|
|
43
|
+
export declare const DEFAULT_SETTINGS: Settings;
|
|
44
|
+
/**
|
|
45
|
+
* Réglages tels que la GUI les reçoit : les tokens n'y figurent que par leurs
|
|
46
|
+
* quatre derniers caractères. `ready` est vrai quand l'organizer et Claude sont
|
|
47
|
+
* configurés, condition de l'analyse automatique.
|
|
48
|
+
*/
|
|
49
|
+
export interface SettingsView {
|
|
50
|
+
organizer: {
|
|
51
|
+
url: string | null;
|
|
52
|
+
tokenHint: string | null;
|
|
53
|
+
space: string | null;
|
|
54
|
+
owner: string | null;
|
|
55
|
+
};
|
|
56
|
+
claude: {
|
|
57
|
+
tokenHint: string | null;
|
|
58
|
+
savedAt: string | null;
|
|
59
|
+
expiresAt: string | null;
|
|
60
|
+
};
|
|
61
|
+
analysis: AnalysisSettings;
|
|
62
|
+
ready: boolean;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Corps de `PUT /api/settings`. Un token absent garde la valeur enregistrée ;
|
|
66
|
+
* une adresse vide retire la connexion à l'organizer.
|
|
67
|
+
*/
|
|
68
|
+
export declare const SaveSettingsBodySchema: z.ZodObject<{
|
|
69
|
+
organizerUrl: z.ZodString;
|
|
70
|
+
organizerToken: z.ZodOptional<z.ZodString>;
|
|
71
|
+
claudeToken: z.ZodOptional<z.ZodString>;
|
|
72
|
+
analysis: z.ZodObject<{
|
|
73
|
+
auto: z.ZodBoolean;
|
|
74
|
+
maxTurns: z.ZodNumber;
|
|
75
|
+
maxMinutes: z.ZodNumber;
|
|
76
|
+
}, z.core.$strip>;
|
|
77
|
+
}, z.core.$strip>;
|
|
78
|
+
export type SaveSettingsBody = z.infer<typeof SaveSettingsBodySchema>;
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/** Limites d'une analyse par Claude : tours appliqués par Claude Code, durée appliquée par le tracker. */
|
|
3
|
+
export const ANALYSIS_LIMITS = { maxTurns: { min: 1, max: 200 }, maxMinutes: { min: 1, max: 60 } };
|
|
4
|
+
export const AnalysisSettingsSchema = z.object({
|
|
5
|
+
auto: z.boolean(),
|
|
6
|
+
maxTurns: z.number().int().min(ANALYSIS_LIMITS.maxTurns.min).max(ANALYSIS_LIMITS.maxTurns.max),
|
|
7
|
+
maxMinutes: z.number().int().min(ANALYSIS_LIMITS.maxMinutes.min).max(ANALYSIS_LIMITS.maxMinutes.max),
|
|
8
|
+
});
|
|
9
|
+
/**
|
|
10
|
+
* Réglages enregistrés dans `<données>/settings.json`. `organizer.space` et
|
|
11
|
+
* `organizer.owner` sont l'espace du token et son propriétaire, relevés au
|
|
12
|
+
* dernier test de la connexion ; `claude.savedAt` est la date d'enregistrement
|
|
13
|
+
* du token Claude, valable un an.
|
|
14
|
+
*/
|
|
15
|
+
export const SettingsSchema = z.object({
|
|
16
|
+
organizer: z.object({
|
|
17
|
+
url: z.string().nullable(),
|
|
18
|
+
token: z.string().nullable(),
|
|
19
|
+
space: z.string().nullable(),
|
|
20
|
+
owner: z.string().nullable(),
|
|
21
|
+
}),
|
|
22
|
+
claude: z.object({
|
|
23
|
+
token: z.string().nullable(),
|
|
24
|
+
savedAt: z.string().nullable(),
|
|
25
|
+
}),
|
|
26
|
+
analysis: AnalysisSettingsSchema,
|
|
27
|
+
});
|
|
28
|
+
export const DEFAULT_SETTINGS = {
|
|
29
|
+
organizer: { url: null, token: null, space: null, owner: null },
|
|
30
|
+
claude: { token: null, savedAt: null },
|
|
31
|
+
analysis: { auto: false, maxTurns: 40, maxMinutes: 15 },
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Corps de `PUT /api/settings`. Un token absent garde la valeur enregistrée ;
|
|
35
|
+
* une adresse vide retire la connexion à l'organizer.
|
|
36
|
+
*/
|
|
37
|
+
export const SaveSettingsBodySchema = z.object({
|
|
38
|
+
organizerUrl: z.string().trim(),
|
|
39
|
+
organizerToken: z.string().trim().min(1).optional(),
|
|
40
|
+
claudeToken: z.string().trim().min(1).optional(),
|
|
41
|
+
analysis: AnalysisSettingsSchema,
|
|
42
|
+
});
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { type AnalysisReport, type AnalysisTask, type ForceCandidate, type Operation } from "../../shared/schemas/model.schema.js";
|
|
2
|
+
import type { Settings } from "../../shared/schemas/settings.schema.js";
|
|
3
|
+
import { type ClaudeRuntime } from "./claude.js";
|
|
4
|
+
import type { Store } from "./store.js";
|
|
5
|
+
/** Vulnérabilités d'un rapport `npm audit --json`, réduites à ce qui sert l'analyse. */
|
|
6
|
+
export declare function auditFacts(report: any, project: string): unknown[];
|
|
7
|
+
export interface AnalysisInput {
|
|
8
|
+
repoId: string;
|
|
9
|
+
branch: string;
|
|
10
|
+
/** Clone du dépôt : dossier de travail de Claude. */
|
|
11
|
+
cwd: string;
|
|
12
|
+
/** Dossier de l'opération, hors du clone : configuration MCP de la session. */
|
|
13
|
+
workDir: string;
|
|
14
|
+
facts: unknown[];
|
|
15
|
+
forceCandidates: ForceCandidate[];
|
|
16
|
+
settings: Settings;
|
|
17
|
+
claude: ClaudeRuntime;
|
|
18
|
+
signal: AbortSignal;
|
|
19
|
+
onLine: (line: string, turns: number) => void;
|
|
20
|
+
}
|
|
21
|
+
/** Lance l'analyse, puis vérifie sur l'organizer la tâche que Claude dit avoir créée. */
|
|
22
|
+
export declare function analyseVulnerabilities(input: AnalysisInput): Promise<{
|
|
23
|
+
report: AnalysisReport;
|
|
24
|
+
task: AnalysisTask;
|
|
25
|
+
}>;
|
|
26
|
+
/** Dernière opération du dépôt dont l'analyse a créé une tâche ; `operations` va de la plus récente à la plus ancienne. */
|
|
27
|
+
export declare function latestAnalysed(operations: Operation[]): Operation | null;
|
|
28
|
+
/** Relit sur l'organizer le statut de la dernière tâche d'analyse du dépôt, tant qu'elle n'est pas terminée. */
|
|
29
|
+
export declare function refreshAnalysisTask(store: Store, settings: Settings, repoId: string): Promise<void>;
|