@imenam/mcp-dependabot-tracker 1.0.1 → 1.0.3
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 +11 -7
- package/dist/shared/repo-search.d.ts +9 -0
- package/dist/shared/repo-search.js +24 -0
- package/dist/shared/schemas/api.schema.d.ts +12 -0
- package/dist/shared/schemas/api.schema.js +1 -0
- package/dist/shared/schemas/ipc.schema.d.ts +1 -1
- package/dist/shared/schemas/ipc.schema.js +3 -0
- package/dist/shared/schemas/model.schema.d.ts +6 -1
- package/dist/shared/schemas/model.schema.js +5 -1
- package/dist/src/core/github.d.ts +4 -0
- package/dist/src/core/github.js +36 -0
- package/dist/src/core/operations.js +1 -1
- package/dist/src/core/repos.d.ts +6 -0
- package/dist/src/core/repos.js +22 -1
- package/dist/src/core/store.js +7 -1
- package/dist/src/gui-worker.js +9 -1
- package/dist/src/index.js +18 -6
- package/dist/src/tools/format.js +1 -1
- package/gui/dist/assets/index-DFY8u9sj.js +63 -0
- package/gui/dist/assets/{index-BBJkUr54.css → index-Djyhcaqb.css} +1 -1
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
- package/gui/dist/assets/index-DbT51E3H.js +0 -63
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Suivi des alertes Dependabot de dépôts GitHub, et correction de leurs vulnérabilités npm dans un clone temporaire, depuis une interface graphique ou par un agent.
|
|
4
4
|
|
|
5
|
-
Pour chaque dépôt suivi, l'interface montre les alertes Dependabot ouvertes et lance une **correction** : clone temporaire de la branche par défaut, `npm audit`, `npm audit fix`, `npm audit fix --force` sur décision, puis commit sur une nouvelle branche, push et pull request. L'utilisateur décide, dépôt par dépôt, de ce que l'agent peut faire par les outils MCP : audit, audit fix, audit fix --force, push.
|
|
5
|
+
Pour chaque dépôt suivi, l'interface montre les alertes Dependabot ouvertes et lance une **correction** : clone temporaire de la branche choisie pour le dépôt (la branche par défaut tant qu'aucune autre n'est choisie), `npm audit`, `npm audit fix`, `npm audit fix --force` sur décision, puis commit sur une nouvelle branche, push et pull request. L'utilisateur décide, dépôt par dépôt, de ce que l'agent peut faire par les outils MCP : audit, audit fix, audit fix --force, push.
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
Utilisateur (GUI) ──ajoute un dépôt, accorde les droits, corrige──▶ Tracker ──API GitHub──▶ alertes, PR
|
|
@@ -64,7 +64,7 @@ Un token à grain fin, limité aux dépôts suivis, avec les permissions :
|
|
|
64
64
|
| Dependabot alerts | lecture | lire les alertes |
|
|
65
65
|
| Contents | lecture et écriture | cloner, pousser la branche de correction |
|
|
66
66
|
| Pull requests | lecture et écriture | ouvrir la pull request |
|
|
67
|
-
| Metadata | lecture | imposée par GitHub |
|
|
67
|
+
| Metadata | lecture | imposée par GitHub ; liste les dépôts proposés à l'ajout |
|
|
68
68
|
|
|
69
69
|
Un token classique convient aussi, avec les scopes `repo` et `security_events`. Les commits sont signés du compte du token, avec son adresse `noreply` GitHub. Le token est transmis à `git` par un en-tête HTTP (`http.<serveur>/.extraheader`, dans l'environnement de la commande) : il n'est écrit ni dans le clone ni dans la ligne de commande. Les commandes `git` et `npm` ne reçoivent pas `GITHUB_TOKEN` dans leur environnement.
|
|
70
70
|
|
|
@@ -124,7 +124,7 @@ Cinq outils, en anglais. Le résultat d'une opération se termine par le lien ve
|
|
|
124
124
|
| `list_repositories` | — | Dépôts suivis : alertes Dependabot ouvertes par gravité, date de la dernière lecture (et son erreur), droits de l'agent, 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, 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
|
-
| `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
|
|
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
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.
|
|
@@ -133,13 +133,15 @@ Un outil refuse une action dont l'agent n'a pas le droit, en le disant ; seul l'
|
|
|
133
133
|
|
|
134
134
|
## Une opération
|
|
135
135
|
|
|
136
|
-
Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche
|
|
136
|
+
Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche analysée), supprimé dès qu'elle se termine, réussie, échouée ou annulée. Il reste sur le disque tant qu'une correction lancée depuis la GUI attend une décision.
|
|
137
|
+
|
|
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.
|
|
137
139
|
|
|
138
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é.
|
|
139
141
|
2. **npm audit** — `npm audit --json` dans chaque projet.
|
|
140
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.
|
|
141
143
|
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.
|
|
142
|
-
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
|
|
144
|
+
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.
|
|
143
145
|
|
|
144
146
|
Les paquets mis à jour sont lus en comparant chaque lockfile à celui du commit cloné : version changée, paquet ajouté ou retiré. S'il n'y a rien à corriger, ou si les corrections ne changent rien, l'opération se termine sans push.
|
|
145
147
|
|
|
@@ -153,8 +155,8 @@ Depuis la GUI, l'opération s'arrête aux étapes 4 et 5 pour la décision de l'
|
|
|
153
155
|
|
|
154
156
|
Thème sombre, une information par ligne, une action principale par écran.
|
|
155
157
|
|
|
156
|
-
- **Accueil (`#/`)** — les dépôts suivis, du plus exposé au moins exposé (gravité la plus haute, puis nombre d'alertes). En bout de ligne, une seule information : le nombre d'alertes coloré selon la gravité la plus haute, « Correction en cours », « Synchronisation impossible » (l'erreur en infobulle) ou « À jour ». « Ajouter un dépôt » ouvre une fenêtre à un seul champ, `propriétaire/dépôt` ou lien GitHub
|
|
157
|
-
- **Dépôt (`#/r/<propriétaire>/<nom>`)** — branche par défaut, 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. « 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).
|
|
158
|
+
- **Accueil (`#/`)** — les dépôts suivis, du plus exposé au moins exposé (gravité la plus haute, puis nombre d'alertes). En bout de ligne, une seule information : le nombre d'alertes coloré selon la gravité la plus haute, « Correction en cours », « Synchronisation impossible » (l'erreur en infobulle) ou « À jour ». « Ajouter un dépôt » ouvre une fenêtre à un seul champ de recherche : 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 ↓ choisissent, Entrée ou un clic ajoutent le dépôt choisi ; Échap referme la liste, puis la fenêtre. Sans suggestion, « Ajouter » prend la saisie telle quelle, `propriétaire/dépôt` ou lien GitHub. Un nouveau dépôt n'accorde que l'audit à l'agent.
|
|
159
|
+
- **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), 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. « 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).
|
|
158
160
|
- **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. 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.
|
|
159
161
|
|
|
160
162
|
Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les secondes pendant une opération.
|
|
@@ -172,8 +174,10 @@ Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`
|
|
|
172
174
|
|---|---|
|
|
173
175
|
| `GET /api/config` | Version, répertoire des données, présence du token. |
|
|
174
176
|
| `GET /api/repos`, `POST /api/repos` | Dépôts suivis (avec opération en cours et dernière opération) ; ajout d'un dépôt. |
|
|
177
|
+
| `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
|
|
175
178
|
| `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
|
|
176
179
|
| `PUT /api/repos/:propriétaire/:nom/rights` | Droits de l'agent. |
|
|
180
|
+
| `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). |
|
|
177
181
|
| `POST /api/repos/:propriétaire/:nom/operations` | Lance une correction. |
|
|
178
182
|
| `GET /api/operations/:id` | Opération. |
|
|
179
183
|
| `POST /api/operations/:id/force`, `/push`, `/cancel` | Décision `--force` (`{ apply }`), push (`{ commitMessage }`), annulation. |
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** Nombre maximal de suggestions affichées sous le champ d'ajout d'un dépôt. */
|
|
2
|
+
export declare const MAX_SUGGESTIONS = 10;
|
|
3
|
+
/**
|
|
4
|
+
* Dépôts dont le nom complet contient `query`, sans tenir compte de la casse :
|
|
5
|
+
* d'abord ceux dont le nom (après `propriétaire/`) commence par la recherche,
|
|
6
|
+
* puis les autres, chacun dans l'ordre alphabétique ; au plus `limit`.
|
|
7
|
+
* Une recherche vide ne propose rien.
|
|
8
|
+
*/
|
|
9
|
+
export declare function searchRepositories(repositories: string[], query: string, limit?: number): string[];
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** Nombre maximal de suggestions affichées sous le champ d'ajout d'un dépôt. */
|
|
2
|
+
export const MAX_SUGGESTIONS = 10;
|
|
3
|
+
/**
|
|
4
|
+
* Dépôts dont le nom complet contient `query`, sans tenir compte de la casse :
|
|
5
|
+
* d'abord ceux dont le nom (après `propriétaire/`) commence par la recherche,
|
|
6
|
+
* puis les autres, chacun dans l'ordre alphabétique ; au plus `limit`.
|
|
7
|
+
* Une recherche vide ne propose rien.
|
|
8
|
+
*/
|
|
9
|
+
export function searchRepositories(repositories, query, limit = MAX_SUGGESTIONS) {
|
|
10
|
+
const needle = query.trim().toLowerCase();
|
|
11
|
+
if (needle === "")
|
|
12
|
+
return [];
|
|
13
|
+
const startsWith = [];
|
|
14
|
+
const contains = [];
|
|
15
|
+
for (const repository of repositories) {
|
|
16
|
+
const full = repository.toLowerCase();
|
|
17
|
+
if (!full.includes(needle))
|
|
18
|
+
continue;
|
|
19
|
+
const name = full.slice(full.indexOf("/") + 1);
|
|
20
|
+
(name.startsWith(needle) || full.startsWith(needle) ? startsWith : contains).push(repository);
|
|
21
|
+
}
|
|
22
|
+
const byName = (a, b) => a.localeCompare(b);
|
|
23
|
+
return [...startsWith.sort(byName), ...contains.sort(byName)].slice(0, limit);
|
|
24
|
+
}
|
|
@@ -14,6 +14,14 @@ export declare const SetRightsBodySchema: z.ZodObject<{
|
|
|
14
14
|
}, z.core.$strip>;
|
|
15
15
|
}, z.core.$strip>;
|
|
16
16
|
export type SetRightsBody = z.infer<typeof SetRightsBodySchema>;
|
|
17
|
+
export declare const SetBranchBodySchema: z.ZodObject<{
|
|
18
|
+
branch: z.ZodString;
|
|
19
|
+
}, z.core.$strip>;
|
|
20
|
+
export type SetBranchBody = z.infer<typeof SetBranchBodySchema>;
|
|
21
|
+
/** Branches du dépôt, la branche par défaut en tête. */
|
|
22
|
+
export interface BranchesResponse {
|
|
23
|
+
branches: string[];
|
|
24
|
+
}
|
|
17
25
|
/** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
|
|
18
26
|
export declare const ForceBodySchema: z.ZodObject<{
|
|
19
27
|
apply: z.ZodBoolean;
|
|
@@ -39,6 +47,10 @@ export interface RepoView {
|
|
|
39
47
|
export interface ReposResponse {
|
|
40
48
|
repos: RepoView[];
|
|
41
49
|
}
|
|
50
|
+
/** Dépôts accessibles au token GitHub et pas encore suivis, `propriétaire/nom`. */
|
|
51
|
+
export interface AddableReposResponse {
|
|
52
|
+
repositories: string[];
|
|
53
|
+
}
|
|
42
54
|
export interface OperationResponse {
|
|
43
55
|
operation: Operation;
|
|
44
56
|
}
|
|
@@ -3,6 +3,7 @@ import { RightsSchema } from "./model.schema.js";
|
|
|
3
3
|
/** Corps de `POST /api/repos` : `propriétaire/nom` ou lien GitHub. */
|
|
4
4
|
export const AddRepoBodySchema = z.object({ repository: z.string().trim().min(1) });
|
|
5
5
|
export const SetRightsBodySchema = z.object({ rights: RightsSchema });
|
|
6
|
+
export const SetBranchBodySchema = z.object({ branch: z.string().trim().min(1) });
|
|
6
7
|
/** `apply` : lancer `npm audit fix --force` ; sinon l'étape est passée. */
|
|
7
8
|
export const ForceBodySchema = z.object({ apply: z.boolean() });
|
|
8
9
|
export const PushBodySchema = z.object({ commitMessage: z.string().trim().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", "GET_REPO", "ADD_REPO", "REMOVE_REPO", "SET_RIGHTS", "START_FIX", "GET_OPERATION", "DECIDE_FORCE", "PUSH_OPERATION", "CANCEL_OPERATION"];
|
|
25
|
+
export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_REPOS", "LIST_ADDABLE_REPOS", "GET_REPO", "ADD_REPO", "REMOVE_REPO", "SET_RIGHTS", "LIST_BRANCHES", "SET_BRANCH", "START_FIX", "GET_OPERATION", "DECIDE_FORCE", "PUSH_OPERATION", "CANCEL_OPERATION"];
|
|
26
26
|
export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];
|
|
@@ -18,10 +18,13 @@ export const IPCMessageSchema = z.object({
|
|
|
18
18
|
export const GUI_REQUEST_TYPES = [
|
|
19
19
|
"GET_CONFIG",
|
|
20
20
|
"LIST_REPOS",
|
|
21
|
+
"LIST_ADDABLE_REPOS",
|
|
21
22
|
"GET_REPO",
|
|
22
23
|
"ADD_REPO",
|
|
23
24
|
"REMOVE_REPO",
|
|
24
25
|
"SET_RIGHTS",
|
|
26
|
+
"LIST_BRANCHES",
|
|
27
|
+
"SET_BRANCH",
|
|
25
28
|
"START_FIX",
|
|
26
29
|
"GET_OPERATION",
|
|
27
30
|
"DECIDE_FORCE",
|
|
@@ -34,12 +34,16 @@ export declare const AlertSchema: z.ZodObject<{
|
|
|
34
34
|
patchedVersion: z.ZodNullable<z.ZodString>;
|
|
35
35
|
}, z.core.$strip>;
|
|
36
36
|
export type Alert = z.infer<typeof AlertSchema>;
|
|
37
|
-
/**
|
|
37
|
+
/**
|
|
38
|
+
* Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
|
|
39
|
+
* la branche que les opérations clonent et vers laquelle la pull request est ouverte.
|
|
40
|
+
*/
|
|
38
41
|
export declare const RepoSchema: z.ZodObject<{
|
|
39
42
|
id: z.ZodString;
|
|
40
43
|
owner: z.ZodString;
|
|
41
44
|
name: z.ZodString;
|
|
42
45
|
defaultBranch: z.ZodString;
|
|
46
|
+
branch: z.ZodString;
|
|
43
47
|
addedAt: z.ZodString;
|
|
44
48
|
rights: z.ZodObject<{
|
|
45
49
|
audit: z.ZodBoolean;
|
|
@@ -72,6 +76,7 @@ export declare const ReposFileSchema: z.ZodObject<{
|
|
|
72
76
|
owner: z.ZodString;
|
|
73
77
|
name: z.ZodString;
|
|
74
78
|
defaultBranch: z.ZodString;
|
|
79
|
+
branch: z.ZodString;
|
|
75
80
|
addedAt: z.ZodString;
|
|
76
81
|
rights: z.ZodObject<{
|
|
77
82
|
audit: z.ZodBoolean;
|
|
@@ -24,12 +24,16 @@ export const AlertSchema = z.object({
|
|
|
24
24
|
url: z.string(),
|
|
25
25
|
patchedVersion: z.string().nullable(),
|
|
26
26
|
});
|
|
27
|
-
/**
|
|
27
|
+
/**
|
|
28
|
+
* Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
|
|
29
|
+
* la branche que les opérations clonent et vers laquelle la pull request est ouverte.
|
|
30
|
+
*/
|
|
28
31
|
export const RepoSchema = z.object({
|
|
29
32
|
id: z.string(),
|
|
30
33
|
owner: z.string(),
|
|
31
34
|
name: z.string(),
|
|
32
35
|
defaultBranch: z.string(),
|
|
36
|
+
branch: z.string(),
|
|
33
37
|
addedAt: z.string(),
|
|
34
38
|
rights: RightsSchema,
|
|
35
39
|
alerts: z.array(AlertSchema),
|
|
@@ -28,6 +28,10 @@ export declare class GitHubClient {
|
|
|
28
28
|
getRepository(owner: string, name: string): Promise<GitHubRepository>;
|
|
29
29
|
/** Alertes Dependabot ouvertes du dépôt, toutes pages comprises. */
|
|
30
30
|
listOpenAlerts(owner: string, name: string): Promise<Alert[]>;
|
|
31
|
+
/** Noms complets (`propriétaire/nom`) des dépôts accessibles au token, toutes pages comprises. */
|
|
32
|
+
listAccessibleRepositories(): Promise<string[]>;
|
|
33
|
+
/** Noms des branches du dépôt, toutes pages comprises. */
|
|
34
|
+
listBranches(owner: string, name: string): Promise<string[]>;
|
|
31
35
|
getAuthenticatedUser(): Promise<GitHubUser>;
|
|
32
36
|
createPullRequest(owner: string, name: string, pr: {
|
|
33
37
|
title: string;
|
package/dist/src/core/github.js
CHANGED
|
@@ -3,6 +3,8 @@ import { NotFoundError, TrackerError } from "./errors.js";
|
|
|
3
3
|
const REQUEST_TIMEOUT_MS = 30_000;
|
|
4
4
|
/** Nombre maximal de pages d'alertes lues (100 alertes par page). */
|
|
5
5
|
const MAX_ALERT_PAGES = 20;
|
|
6
|
+
/** Nombre maximal de pages de dépôts ou de branches lues (100 par page). */
|
|
7
|
+
const MAX_REPOSITORY_PAGES = 30;
|
|
6
8
|
/** URL de la page suivante dans un en-tête `Link` de pagination, ou null. */
|
|
7
9
|
export function nextPageUrl(link) {
|
|
8
10
|
if (!link)
|
|
@@ -86,6 +88,40 @@ export class GitHubClient {
|
|
|
86
88
|
}
|
|
87
89
|
return alerts;
|
|
88
90
|
}
|
|
91
|
+
/** Noms complets (`propriétaire/nom`) des dépôts accessibles au token, toutes pages comprises. */
|
|
92
|
+
async listAccessibleRepositories() {
|
|
93
|
+
const names = [];
|
|
94
|
+
let url = "/user/repos?per_page=100&sort=full_name";
|
|
95
|
+
for (let page = 0; url !== null; page += 1) {
|
|
96
|
+
if (page === MAX_REPOSITORY_PAGES) {
|
|
97
|
+
throw new TrackerError(`GITHUB_TOKEN can access more than ${MAX_REPOSITORY_PAGES * 100} repositories; the tracker lists at most that many.`);
|
|
98
|
+
}
|
|
99
|
+
const { json, link } = await this.request("GET", url);
|
|
100
|
+
if (!Array.isArray(json))
|
|
101
|
+
throw new TrackerError("GitHub API returned an unexpected list of repositories.");
|
|
102
|
+
for (const raw of json)
|
|
103
|
+
names.push(raw.full_name);
|
|
104
|
+
url = nextPageUrl(link);
|
|
105
|
+
}
|
|
106
|
+
return names;
|
|
107
|
+
}
|
|
108
|
+
/** Noms des branches du dépôt, toutes pages comprises. */
|
|
109
|
+
async listBranches(owner, name) {
|
|
110
|
+
const names = [];
|
|
111
|
+
let url = `/repos/${owner}/${name}/branches?per_page=100`;
|
|
112
|
+
for (let page = 0; url !== null; page += 1) {
|
|
113
|
+
if (page === MAX_REPOSITORY_PAGES) {
|
|
114
|
+
throw new TrackerError(`${owner}/${name} has more than ${MAX_REPOSITORY_PAGES * 100} branches; the tracker lists at most that many.`);
|
|
115
|
+
}
|
|
116
|
+
const { json, link } = await this.request("GET", url);
|
|
117
|
+
if (!Array.isArray(json))
|
|
118
|
+
throw new TrackerError(`GitHub API returned an unexpected list of branches for ${owner}/${name}.`);
|
|
119
|
+
for (const raw of json)
|
|
120
|
+
names.push(raw.name);
|
|
121
|
+
url = nextPageUrl(link);
|
|
122
|
+
}
|
|
123
|
+
return names;
|
|
124
|
+
}
|
|
89
125
|
async getAuthenticatedUser() {
|
|
90
126
|
const { json } = await this.request("GET", "/user");
|
|
91
127
|
return { login: json.login, id: json.id, name: json.name ?? null };
|
|
@@ -55,7 +55,7 @@ function newOperation(repo, kind, origin) {
|
|
|
55
55
|
updatedAt: createdAt,
|
|
56
56
|
pid: process.pid,
|
|
57
57
|
workDir: null,
|
|
58
|
-
baseBranch: repo.
|
|
58
|
+
baseBranch: repo.branch,
|
|
59
59
|
cancelRequested: false,
|
|
60
60
|
steps: { clone: "pending", audit: "pending", fix: "pending", force: "pending", push: "pending" },
|
|
61
61
|
projects: [],
|
package/dist/src/core/repos.d.ts
CHANGED
|
@@ -18,6 +18,12 @@ export declare function listRepoViews(store: Store): RepoView[];
|
|
|
18
18
|
export declare function syncRepository(store: Store, config: GitHubConfig, repoId: string): Promise<Repo>;
|
|
19
19
|
/** Suit un nouveau dépôt, avec l'audit pour seul droit de l'agent, puis lit ses alertes. */
|
|
20
20
|
export declare function addRepository(store: Store, config: GitHubConfig, input: string): Promise<Repo>;
|
|
21
|
+
/** Dépôts accessibles au token qui ne sont pas encore suivis, proposés à l'ajout. */
|
|
22
|
+
export declare function listAddableRepositories(store: Store, config: GitHubConfig): Promise<string[]>;
|
|
23
|
+
/** Branches du dépôt sur GitHub, la branche par défaut en tête, les autres dans l'ordre alphabétique. */
|
|
24
|
+
export declare function listRepoBranches(store: Store, config: GitHubConfig, repoId: string): Promise<string[]>;
|
|
25
|
+
/** Choisit la branche analysée ; elle doit exister sur GitHub. */
|
|
26
|
+
export declare function setBranch(store: Store, config: GitHubConfig, repoId: string, branch: string): Promise<Repo>;
|
|
21
27
|
export declare function setRights(store: Store, repoId: string, rights: Rights): Repo;
|
|
22
28
|
/** Dépôts jamais synchronisés, ou synchronisés il y a plus de `maxAgeMs`. */
|
|
23
29
|
export declare function staleRepos(store: Store, maxAgeMs: number, at?: number): Repo[];
|
package/dist/src/core/repos.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { ALERT_SEVERITIES, DEFAULT_RIGHTS } from "../../shared/schemas/model.schema.js";
|
|
2
|
-
import { ConflictError } from "./errors.js";
|
|
2
|
+
import { ConflictError, NotFoundError } from "./errors.js";
|
|
3
3
|
import { GitHubClient } from "./github.js";
|
|
4
4
|
import { parseRepoRef } from "./repo-ref.js";
|
|
5
5
|
import { isActive } from "./store.js";
|
|
@@ -67,6 +67,7 @@ export async function addRepository(store, config, input) {
|
|
|
67
67
|
owner: remote.owner,
|
|
68
68
|
name: remote.name,
|
|
69
69
|
defaultBranch: remote.defaultBranch,
|
|
70
|
+
branch: remote.defaultBranch,
|
|
70
71
|
addedAt: new Date().toISOString(),
|
|
71
72
|
rights: DEFAULT_RIGHTS,
|
|
72
73
|
alerts: [],
|
|
@@ -75,6 +76,26 @@ export async function addRepository(store, config, input) {
|
|
|
75
76
|
});
|
|
76
77
|
return syncRepository(store, config, remote.fullName);
|
|
77
78
|
}
|
|
79
|
+
/** Dépôts accessibles au token qui ne sont pas encore suivis, proposés à l'ajout. */
|
|
80
|
+
export async function listAddableRepositories(store, config) {
|
|
81
|
+
const tracked = new Set(store.listRepos().map((repo) => repo.id.toLowerCase()));
|
|
82
|
+
const accessible = await new GitHubClient(config).listAccessibleRepositories();
|
|
83
|
+
return accessible.filter((name) => !tracked.has(name.toLowerCase()));
|
|
84
|
+
}
|
|
85
|
+
/** Branches du dépôt sur GitHub, la branche par défaut en tête, les autres dans l'ordre alphabétique. */
|
|
86
|
+
export async function listRepoBranches(store, config, repoId) {
|
|
87
|
+
const repo = store.getRepo(repoId);
|
|
88
|
+
const branches = await new GitHubClient(config).listBranches(repo.owner, repo.name);
|
|
89
|
+
const others = branches.filter((branch) => branch !== repo.defaultBranch).sort((a, b) => a.localeCompare(b));
|
|
90
|
+
return branches.includes(repo.defaultBranch) ? [repo.defaultBranch, ...others] : others;
|
|
91
|
+
}
|
|
92
|
+
/** Choisit la branche analysée ; elle doit exister sur GitHub. */
|
|
93
|
+
export async function setBranch(store, config, repoId, branch) {
|
|
94
|
+
const branches = await listRepoBranches(store, config, repoId);
|
|
95
|
+
if (!branches.includes(branch))
|
|
96
|
+
throw new NotFoundError(`Branch "${branch}" does not exist in ${store.getRepo(repoId).id}.`);
|
|
97
|
+
return store.updateRepo(repoId, (repo) => ({ ...repo, branch }));
|
|
98
|
+
}
|
|
78
99
|
export function setRights(store, repoId, rights) {
|
|
79
100
|
return store.updateRepo(repoId, (repo) => ({ ...repo, rights }));
|
|
80
101
|
}
|
package/dist/src/core/store.js
CHANGED
|
@@ -35,6 +35,12 @@ export function processAlive(pid) {
|
|
|
35
35
|
return err.code === "EPERM";
|
|
36
36
|
}
|
|
37
37
|
}
|
|
38
|
+
/** Un dépôt enregistré sans branche choisie analyse sa branche par défaut. */
|
|
39
|
+
function withBranches(file) {
|
|
40
|
+
if (!Array.isArray(file?.repos))
|
|
41
|
+
return file;
|
|
42
|
+
return { ...file, repos: file.repos.map((repo) => (typeof repo?.branch === "string" ? repo : { ...repo, branch: repo?.defaultBranch })) };
|
|
43
|
+
}
|
|
38
44
|
export function isActive(operation) {
|
|
39
45
|
return ACTIVE_STATUSES.includes(operation.status);
|
|
40
46
|
}
|
|
@@ -106,7 +112,7 @@ export class Store {
|
|
|
106
112
|
return [];
|
|
107
113
|
throw err;
|
|
108
114
|
}
|
|
109
|
-
const parsed = ReposFileSchema.safeParse(JSON.parse(raw));
|
|
115
|
+
const parsed = ReposFileSchema.safeParse(withBranches(JSON.parse(raw)));
|
|
110
116
|
if (!parsed.success)
|
|
111
117
|
throw new TrackerError(`${this.reposPath} is invalid: ${parsed.error.message}`);
|
|
112
118
|
return parsed.data.repos;
|
package/dist/src/gui-worker.js
CHANGED
|
@@ -6,7 +6,7 @@ import path from "path";
|
|
|
6
6
|
import fs from "fs";
|
|
7
7
|
import { fileURLToPath } from "url";
|
|
8
8
|
import { IPCMessageSchema } from "../shared/schemas/ipc.schema.js";
|
|
9
|
-
import { AddRepoBodySchema, ForceBodySchema, PushBodySchema, SetRightsBodySchema } from "../shared/schemas/api.schema.js";
|
|
9
|
+
import { AddRepoBodySchema, ForceBodySchema, PushBodySchema, SetBranchBodySchema, SetRightsBodySchema } from "../shared/schemas/api.schema.js";
|
|
10
10
|
import { resolveLogDir } from "./core/log-dir.js";
|
|
11
11
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
12
12
|
function findProjectRoot(startDir) {
|
|
@@ -195,6 +195,7 @@ app.post("/api/repos", async (c) => {
|
|
|
195
195
|
return read.response;
|
|
196
196
|
return forward(c, "ADD_REPO", { body: read.body });
|
|
197
197
|
});
|
|
198
|
+
app.get("/api/github/repos", (c) => forward(c, "LIST_ADDABLE_REPOS"));
|
|
198
199
|
app.get("/api/repos/:owner/:name", (c) => forward(c, "GET_REPO", { repoId: repoId(c) }));
|
|
199
200
|
app.delete("/api/repos/:owner/:name", (c) => forward(c, "REMOVE_REPO", { repoId: repoId(c) }));
|
|
200
201
|
app.put("/api/repos/:owner/:name/rights", async (c) => {
|
|
@@ -203,6 +204,13 @@ app.put("/api/repos/:owner/:name/rights", async (c) => {
|
|
|
203
204
|
return read.response;
|
|
204
205
|
return forward(c, "SET_RIGHTS", { repoId: repoId(c), body: read.body });
|
|
205
206
|
});
|
|
207
|
+
app.get("/api/repos/:owner/:name/branches", (c) => forward(c, "LIST_BRANCHES", { repoId: repoId(c) }));
|
|
208
|
+
app.put("/api/repos/:owner/:name/branch", async (c) => {
|
|
209
|
+
const read = await readBody(c, SetBranchBodySchema);
|
|
210
|
+
if ("response" in read)
|
|
211
|
+
return read.response;
|
|
212
|
+
return forward(c, "SET_BRANCH", { repoId: repoId(c), body: read.body });
|
|
213
|
+
});
|
|
206
214
|
app.post("/api/repos/:owner/:name/operations", (c) => forward(c, "START_FIX", { repoId: repoId(c) }));
|
|
207
215
|
app.get("/api/operations/:id", (c) => forward(c, "GET_OPERATION", { operationId: c.req.param("id") }));
|
|
208
216
|
app.post("/api/operations/:id/force", async (c) => {
|
package/dist/src/index.js
CHANGED
|
@@ -14,9 +14,9 @@ import { githubConfigured, readGitHubConfig } from "./core/config.js";
|
|
|
14
14
|
import { ConflictError, NotFoundError, TrackerError } from "./core/errors.js";
|
|
15
15
|
import { Store } from "./core/store.js";
|
|
16
16
|
import { cancelOperation, decideForce, pushOperation, startUserFix } from "./core/operations.js";
|
|
17
|
-
import { SYNC_INTERVAL_MS, addRepository, listRepoViews, repoView, setRights, staleRepos, syncRepository } from "./core/repos.js";
|
|
17
|
+
import { SYNC_INTERVAL_MS, addRepository, listAddableRepositories, listRepoBranches, listRepoViews, setBranch, repoView, setRights, staleRepos, syncRepository } from "./core/repos.js";
|
|
18
18
|
import { GUI_REQUEST_TYPES, IPCMessageSchema } from "../shared/schemas/ipc.schema.js";
|
|
19
|
-
import { AddRepoBodySchema, ForceBodySchema, OperationRequestSchema, PushBodySchema, RepoRequestSchema, SetRightsBodySchema, } from "../shared/schemas/api.schema.js";
|
|
19
|
+
import { AddRepoBodySchema, ForceBodySchema, OperationRequestSchema, PushBodySchema, RepoRequestSchema, SetBranchBodySchema, SetRightsBodySchema, } from "../shared/schemas/api.schema.js";
|
|
20
20
|
import { errorResult, textResult } from "./tools/types.js";
|
|
21
21
|
import { fixVulnerabilities, getAlerts, listRepositories, runAudit } from "./tools/tools.js";
|
|
22
22
|
const __filename = fileURLToPath(import.meta.url);
|
|
@@ -77,7 +77,8 @@ const INSTRUCTIONS = `mcp-dependabot-tracker follows the Dependabot alerts of Gi
|
|
|
77
77
|
Concepts:
|
|
78
78
|
- A **tracked repository** is a GitHub repository the user added in the GUI. Its open Dependabot alerts are read from GitHub and refreshed every 10 minutes.
|
|
79
79
|
- **Rights**: for each repository, the user allows you to run npm audit (audit), npm audit fix (fix), npm audit fix --force (force) and to push the fixes (push). A tool refuses an action you are not allowed to do; only the user can change the rights.
|
|
80
|
-
-
|
|
80
|
+
- The **analysed branch** of a repository is chosen by the user in the GUI (the default branch unless changed). Dependabot alerts always describe the default branch; npm audit describes the analysed branch.
|
|
81
|
+
- An **operation** runs in a temporary clone of the analysed branch, deleted at the end: npm audit in every directory that holds a package-lock.json, then npm audit fix with --package-lock-only and --ignore-scripts (lockfiles only, no install, no scripts), optionally --force, then a commit on a new branch fix/npm-audit-<date>-<time> and a pull request to the analysed branch.
|
|
81
82
|
|
|
82
83
|
Workflow:
|
|
83
84
|
1. list_repositories to see the tracked repositories, their open alerts and your rights.
|
|
@@ -131,6 +132,8 @@ async function handleGuiRequest(msg) {
|
|
|
131
132
|
return { version: APP_VERSION, dataDir, githubConfigured: githubConfigured() };
|
|
132
133
|
case "LIST_REPOS":
|
|
133
134
|
return { repos: listRepoViews(store) };
|
|
135
|
+
case "LIST_ADDABLE_REPOS":
|
|
136
|
+
return { repositories: await listAddableRepositories(store, readGitHubConfig()) };
|
|
134
137
|
case "GET_REPO": {
|
|
135
138
|
store.failOrphanedOperations();
|
|
136
139
|
return repoView(store, store.getRepo(parseRequest(RepoRequestSchema, msg.data).repoId));
|
|
@@ -147,6 +150,15 @@ async function handleGuiRequest(msg) {
|
|
|
147
150
|
const body = parseRequest(SetRightsBodySchema, msg.data?.body);
|
|
148
151
|
return repoView(store, setRights(store, repoId, body.rights));
|
|
149
152
|
}
|
|
153
|
+
case "LIST_BRANCHES": {
|
|
154
|
+
const { repoId } = parseRequest(RepoRequestSchema, msg.data);
|
|
155
|
+
return { branches: await listRepoBranches(store, readGitHubConfig(), repoId) };
|
|
156
|
+
}
|
|
157
|
+
case "SET_BRANCH": {
|
|
158
|
+
const { repoId } = parseRequest(RepoRequestSchema, msg.data);
|
|
159
|
+
const body = parseRequest(SetBranchBodySchema, msg.data?.body);
|
|
160
|
+
return repoView(store, await setBranch(store, readGitHubConfig(), repoId, body.branch));
|
|
161
|
+
}
|
|
150
162
|
case "START_FIX":
|
|
151
163
|
return { operation: startUserFix(operations, parseRequest(RepoRequestSchema, msg.data).repoId) };
|
|
152
164
|
case "GET_OPERATION": {
|
|
@@ -264,7 +276,7 @@ const REPOSITORY_DOC = "Tracked repository, as owner/name (see list_repositories
|
|
|
264
276
|
const TOOLS = [
|
|
265
277
|
{
|
|
266
278
|
name: "list_repositories",
|
|
267
|
-
description: "List the tracked repositories with their open Dependabot alerts by severity, the time of the last sync, the rights the user gave you (audit, fix, force, push) and the operation in progress. Start here.",
|
|
279
|
+
description: "List the tracked repositories with their analysed branch, their open Dependabot alerts by severity, the time of the last sync, the rights the user gave you (audit, fix, force, push) and the operation in progress. Start here.",
|
|
268
280
|
inputSchema: { type: "object", properties: {} },
|
|
269
281
|
},
|
|
270
282
|
{
|
|
@@ -278,7 +290,7 @@ const TOOLS = [
|
|
|
278
290
|
},
|
|
279
291
|
{
|
|
280
292
|
name: "run_audit",
|
|
281
|
-
description: "Run npm audit on a temporary clone of the
|
|
293
|
+
description: "Run npm audit on a temporary clone of the analysed branch, in every directory that holds a package-lock.json, and report the vulnerabilities with the fix npm proposes (none, within the declared ranges, or a major upgrade that needs --force). Needs the audit right. Nothing is changed; the clone is deleted.",
|
|
282
294
|
inputSchema: {
|
|
283
295
|
type: "object",
|
|
284
296
|
properties: { repository: { type: "string", description: REPOSITORY_DOC } },
|
|
@@ -287,7 +299,7 @@ const TOOLS = [
|
|
|
287
299
|
},
|
|
288
300
|
{
|
|
289
301
|
name: "fix_vulnerabilities",
|
|
290
|
-
description: "Fix the npm vulnerabilities of a tracked repository in a temporary clone of its
|
|
302
|
+
description: "Fix the npm vulnerabilities of a tracked repository in a temporary clone of its analysed branch: npm audit, then npm audit fix --package-lock-only --ignore-scripts, then optionally npm audit fix --force, then optionally a commit on a new branch fix/npm-audit-<date>-<time>, its push and a pull request to the analysed branch. " +
|
|
291
303
|
"Needs the fix right, plus the force right with force and the push right with push. Without push, nothing leaves the clone: the result reports what the fixes change. Waits until the operation ends and reports the vulnerabilities before and after, the updated packages and the pull request.",
|
|
292
304
|
inputSchema: {
|
|
293
305
|
type: "object",
|
package/dist/src/tools/format.js
CHANGED
|
@@ -17,7 +17,7 @@ function alertsLabel(repo) {
|
|
|
17
17
|
export function describeRepo(view) {
|
|
18
18
|
const { repo, activeOperation } = view;
|
|
19
19
|
const lines = [
|
|
20
|
-
`- ${repo.id} (default branch ${repo.defaultBranch})`,
|
|
20
|
+
`- ${repo.id} (analysed branch ${repo.branch}${repo.branch === repo.defaultBranch ? ", the default one" : `; default branch ${repo.defaultBranch}`})`,
|
|
21
21
|
` Open Dependabot alerts: ${alertsLabel(repo)}${repo.syncedAt ? ` · synced ${repo.syncedAt}` : " · not synced yet"}`,
|
|
22
22
|
];
|
|
23
23
|
if (repo.syncError)
|