@imenam/mcp-dependabot-tracker 1.0.5 → 1.0.7

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 CHANGED
@@ -63,7 +63,7 @@ Un token à grain fin, limité aux dépôts suivis, avec les permissions :
63
63
  |---|---|---|
64
64
  | Dependabot alerts | lecture | lire les alertes |
65
65
  | Contents | lecture et écriture | cloner, pousser la branche de correction |
66
- | Pull requests | lecture et écriture | ouvrir la pull request |
66
+ | Pull requests | lecture et écriture | ouvrir la pull request, suivre celles qui attendent d'être mergées |
67
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.
@@ -121,7 +121,7 @@ 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, date de la dernière lecture (et son erreur), droits de l'agent, opération en cours. |
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, 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. |
@@ -143,6 +143,8 @@ La **branche analysée** se choisit par dépôt dans la GUI ; c'est la branche p
143
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.
144
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.
145
145
 
146
+ **Pull requests en attente** — à chaque lecture d'un dépôt (toutes les 10 minutes, ou « Synchroniser maintenant »), le tracker lit ses pull requests ouvertes sur GitHub et garde celles dont la branche suit le nommage `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` et appartient au dépôt lui-même (pas à une fourche). Les pull requests ouvertes avant cette fonction sont donc reconnues, même quand l'historique des opérations ne les contient plus. Une pull request mergée ou fermée disparaît à la lecture suivante ; une pull request que le tracker vient d'ouvrir apparaît aussitôt.
147
+
146
148
  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.
147
149
 
148
150
  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.
@@ -155,9 +157,11 @@ Depuis la GUI, l'opération s'arrête aux étapes 4 et 5 pour la décision de l'
155
157
 
156
158
  Thème sombre, une information par ligne, une action principale par écran.
157
159
 
158
- - **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). « 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.
159
- À droite, les dépôts de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre d'alertes). L'interrupteur « Vulnérables seulement » cache les dépôts sans alerte ouverte ; 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 », « 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. « ⚠ 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, ni pour « Vulnérables seulement » ; quand elles le sont toutes, la ligne affiche « Corrigé à la main » et estompe la pastille.
160
+ - **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.
161
+ À droite, les dépôts de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre d'alertes). 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, ou des alertes non corrigées à la main que le dernier audit ne contredit pas (« Audit OK » et « Corrigé à la main » sont donc cachés) ; 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 », « 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. « ⚠ 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.
160
162
  « 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.
163
+ « 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.
164
+ « 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.
161
165
  - **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).
162
166
  - **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.
163
167
 
@@ -169,13 +173,14 @@ Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les
169
173
 
170
174
  Deux processus, selon le standard de l'écosystème (`@imenam/mcp-gui-interface`) :
171
175
 
172
- - **Maître MCP** (`src/index.ts`) — JSON-RPC sur stdio, outils (`src/tools/`), logique (`src/core/`), relecture des alertes toutes les 10 minutes, cycle de vie du worker via `GuiLauncher`.
176
+ - **Maître MCP** (`src/index.ts`) — JSON-RPC sur stdio, outils (`src/tools/`), logique (`src/core/`), relecture des alertes et des pull requests toutes les 10 minutes, cycle de vie du worker via `GuiLauncher`.
173
177
  - **Worker GUI** (`src/gui-worker.ts`) — Hono, enregistrement auprès du proxy ou écoute sur `APP_PORT`, API REST transmise au maître par IPC, fichiers de la SPA avec la balise `<base>` du chemin de montage. Il écoute sur `127.0.0.1` derrière `honoGuiGuard`.
174
178
 
175
179
  | Route | Effet |
176
180
  |---|---|
177
181
  | `GET /api/config` | Version, répertoire des données, présence du token. |
178
182
  | `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? }`). |
183
+ | `POST /api/sync` | Relit tout de suite les alertes et les pull requests de chaque dépôt suivi, en parallèle ; renvoie les dépôts et les catégories. |
179
184
  | `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
180
185
  | `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
181
186
  | `PUT /api/repos/:propriétaire/:nom/rights` | Droits de l'agent. |
@@ -216,4 +221,4 @@ cd gui && npm run lint # oxlint
216
221
  | `gui/` | Vite + React 19 + zustand, CSS écrit à la main. |
217
222
  | `test/` | Tests `node --test`. |
218
223
 
219
- Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, corrigé seulement par `--force`) : ils ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` lance le serveur sur stdio avec sa GUI sur un port libre et parcourt les outils, les droits et la correction complète depuis l'API de la GUI.
224
+ Les tests utilisent une fausse API GitHub (dépôts, alertes paginées, utilisateur, création et liste des pull requests) et des dépôts nus locaux servis par `file://` (`GITHUB_API_URL`, `GITHUB_SERVER_URL`). `test/operations.test.ts` et `test/server.test.ts` lancent un vrai `npm audit` sur un petit projet vulnérable (`test/fixtures/vulnerable` : `lodash`, corrigé par `audit fix`, et `nth-check`, corrigé seulement par `--force`) : ils ont besoin du registre npm et sont ignorés, avec la raison, s'il est injoignable. `test/server.test.ts` lance le serveur sur stdio avec sa GUI sur un port libre et parcourt les outils, les droits et la correction complète depuis l'API de la GUI.
@@ -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", "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", "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"];
26
26
  export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];
@@ -18,6 +18,7 @@ export const IPCMessageSchema = z.object({
18
18
  export const GUI_REQUEST_TYPES = [
19
19
  "GET_CONFIG",
20
20
  "LIST_REPOS",
21
+ "SYNC_REPOS",
21
22
  "LIST_ADDABLE_REPOS",
22
23
  "GET_REPO",
23
24
  "ADD_REPO",
@@ -45,6 +45,14 @@ export declare const HandledAlertSchema: z.ZodObject<{
45
45
  markedAt: z.ZodString;
46
46
  }, z.core.$strip>;
47
47
  export type HandledAlert = z.infer<typeof HandledAlertSchema>;
48
+ /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/npm-audit-…`. */
49
+ export declare const PullRequestSchema: z.ZodObject<{
50
+ number: z.ZodNumber;
51
+ url: z.ZodString;
52
+ branch: z.ZodString;
53
+ createdAt: z.ZodString;
54
+ }, z.core.$strip>;
55
+ export type PullRequest = z.infer<typeof PullRequestSchema>;
48
56
  /** Catégorie de dépôts, choisie par l'utilisateur ; un dépôt appartient à une catégorie au plus. */
49
57
  export declare const CategorySchema: z.ZodObject<{
50
58
  id: z.ZodString;
@@ -55,7 +63,8 @@ export type Category = z.infer<typeof CategorySchema>;
55
63
  * Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
56
64
  * la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
57
65
  * `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
58
- * `handledAlerts` les alertes qu'il a marquées corrigées à la main.
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.
59
68
  */
60
69
  export declare const RepoSchema: z.ZodObject<{
61
70
  id: z.ZodString;
@@ -92,6 +101,12 @@ export declare const RepoSchema: z.ZodObject<{
92
101
  package: z.ZodString;
93
102
  markedAt: z.ZodString;
94
103
  }, z.core.$strip>>;
104
+ pullRequests: z.ZodArray<z.ZodObject<{
105
+ number: z.ZodNumber;
106
+ url: z.ZodString;
107
+ branch: z.ZodString;
108
+ createdAt: z.ZodString;
109
+ }, z.core.$strip>>;
95
110
  syncedAt: z.ZodNullable<z.ZodString>;
96
111
  syncError: z.ZodNullable<z.ZodString>;
97
112
  }, z.core.$strip>;
@@ -136,6 +151,12 @@ export declare const ReposFileSchema: z.ZodObject<{
136
151
  package: z.ZodString;
137
152
  markedAt: z.ZodString;
138
153
  }, z.core.$strip>>;
154
+ pullRequests: z.ZodArray<z.ZodObject<{
155
+ number: z.ZodNumber;
156
+ url: z.ZodString;
157
+ branch: z.ZodString;
158
+ createdAt: z.ZodString;
159
+ }, z.core.$strip>>;
139
160
  syncedAt: z.ZodNullable<z.ZodString>;
140
161
  syncError: z.ZodNullable<z.ZodString>;
141
162
  }, z.core.$strip>>;
@@ -34,6 +34,13 @@ export const HandledAlertSchema = z.object({
34
34
  package: z.string(),
35
35
  markedAt: z.string(),
36
36
  });
37
+ /** Pull request ouverte par le tracker, ni mergée ni fermée ; `branch` est sa branche `fix/npm-audit-…`. */
38
+ export const PullRequestSchema = z.object({
39
+ number: z.number().int(),
40
+ url: z.string(),
41
+ branch: z.string(),
42
+ createdAt: z.string(),
43
+ });
37
44
  /** Catégorie de dépôts, choisie par l'utilisateur ; un dépôt appartient à une catégorie au plus. */
38
45
  export const CategorySchema = z.object({
39
46
  id: z.string(),
@@ -43,7 +50,8 @@ export const CategorySchema = z.object({
43
50
  * Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
44
51
  * la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
45
52
  * `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
46
- * `handledAlerts` les alertes qu'il a marquées corrigées à la main.
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.
47
55
  */
48
56
  export const RepoSchema = z.object({
49
57
  id: z.string(),
@@ -56,6 +64,7 @@ export const RepoSchema = z.object({
56
64
  rights: RightsSchema,
57
65
  alerts: z.array(AlertSchema),
58
66
  handledAlerts: z.array(HandledAlertSchema),
67
+ pullRequests: z.array(PullRequestSchema),
59
68
  syncedAt: z.string().nullable(),
60
69
  syncError: z.string().nullable(),
61
70
  });
@@ -14,9 +14,19 @@ export interface GitHubUser {
14
14
  id: number;
15
15
  name: string | null;
16
16
  }
17
- export interface PullRequest {
17
+ /** Pull request créée ; `createdAt` est sa date d'ouverture. */
18
+ export interface CreatedPullRequest {
18
19
  number: number;
19
20
  url: string;
21
+ createdAt: string;
22
+ }
23
+ /** Pull request ouverte ; `headRepo` est le dépôt de sa branche, null si ce dépôt a été supprimé. */
24
+ export interface OpenPullRequest {
25
+ number: number;
26
+ url: string;
27
+ branch: string;
28
+ headRepo: string | null;
29
+ createdAt: string;
20
30
  }
21
31
  /** URL de la page suivante dans un en-tête `Link` de pagination, ou null. */
22
32
  export declare function nextPageUrl(link: string | null): string | null;
@@ -33,12 +43,14 @@ export declare class GitHubClient {
33
43
  /** Noms des branches du dépôt, toutes pages comprises. */
34
44
  listBranches(owner: string, name: string): Promise<string[]>;
35
45
  getAuthenticatedUser(): Promise<GitHubUser>;
46
+ /** Pull requests ouvertes du dépôt, toutes pages comprises. */
47
+ listOpenPullRequests(owner: string, name: string): Promise<OpenPullRequest[]>;
36
48
  createPullRequest(owner: string, name: string, pr: {
37
49
  title: string;
38
50
  head: string;
39
51
  base: string;
40
52
  body: string;
41
- }): Promise<PullRequest>;
53
+ }): Promise<CreatedPullRequest>;
42
54
  }
43
55
  /** Échec HTTP de l'API GitHub, avec son code. */
44
56
  export declare class GitHubApiError extends TrackerError {
@@ -126,9 +126,27 @@ export class GitHubClient {
126
126
  const { json } = await this.request("GET", "/user");
127
127
  return { login: json.login, id: json.id, name: json.name ?? null };
128
128
  }
129
+ /** Pull requests ouvertes du dépôt, toutes pages comprises. */
130
+ async listOpenPullRequests(owner, name) {
131
+ const pulls = [];
132
+ let url = `/repos/${owner}/${name}/pulls?state=open&per_page=100`;
133
+ for (let page = 0; url !== null; page += 1) {
134
+ if (page === MAX_REPOSITORY_PAGES) {
135
+ throw new TrackerError(`${owner}/${name} has more than ${MAX_REPOSITORY_PAGES * 100} open pull requests; the tracker reads at most that many.`);
136
+ }
137
+ const { json, link } = await this.request("GET", url);
138
+ if (!Array.isArray(json))
139
+ throw new TrackerError(`GitHub API returned an unexpected list of pull requests for ${owner}/${name}.`);
140
+ for (const raw of json) {
141
+ pulls.push({ number: raw.number, url: raw.html_url, branch: raw.head?.ref ?? "", headRepo: raw.head?.repo?.full_name ?? null, createdAt: raw.created_at });
142
+ }
143
+ url = nextPageUrl(link);
144
+ }
145
+ return pulls;
146
+ }
129
147
  async createPullRequest(owner, name, pr) {
130
148
  const { json } = await this.request("POST", `/repos/${owner}/${name}/pulls`, pr);
131
- return { number: json.number, url: json.html_url };
149
+ return { number: json.number, url: json.html_url, createdAt: json.created_at };
132
150
  }
133
151
  }
134
152
  /** Échec HTTP de l'API GitHub, avec son code. */
@@ -19,6 +19,8 @@ export interface AgentPlan {
19
19
  }
20
20
  /** `fix/npm-audit-2026-10-28-143205`, à l'heure locale du serveur. */
21
21
  export declare function branchName(date: Date): string;
22
+ /** Vrai pour une branche nommée par `branchName`. */
23
+ export declare function isTrackerBranch(branch: string): boolean;
22
24
  /**
23
25
  * Lance une correction depuis la GUI : clone, audit et `npm audit fix` s'exécutent
24
26
  * en arrière-plan, puis l'opération attend la décision sur `--force` ou le push.
@@ -24,6 +24,10 @@ export function branchName(date) {
24
24
  const day = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
25
25
  return `fix/npm-audit-${day}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
26
26
  }
27
+ /** Vrai pour une branche nommée par `branchName`. */
28
+ export function isTrackerBranch(branch) {
29
+ return /^fix\/npm-audit-\d{4}-\d{2}-\d{2}-\d{6}$/.test(branch);
30
+ }
27
31
  /** Variables qui authentifient git auprès de GitHub par un en-tête HTTP, sans écrire le token dans le clone. */
28
32
  function gitAuthEnv(config) {
29
33
  const basic = Buffer.from(`x-access-token:${config.token}`).toString("base64");
@@ -90,6 +94,13 @@ class Runner {
90
94
  update(fn) {
91
95
  return this.ctx.store.updateOperation(this.id, fn);
92
96
  }
97
+ /** Ajoute une pull request ouverte à celles en attente du dépôt. */
98
+ addPullRequest(pullRequest) {
99
+ this.ctx.store.updateRepo(this.operation.repoId, (repo) => ({
100
+ ...repo,
101
+ pullRequests: [...repo.pullRequests.filter((candidate) => candidate.number !== pullRequest.number), pullRequest],
102
+ }));
103
+ }
93
104
  setStep(step, state) {
94
105
  this.update((operation) => ({ ...operation, steps: { ...operation.steps, [step]: state } }));
95
106
  }
@@ -262,7 +273,8 @@ async function pushStep(runner) {
262
273
  throw new TrackerError(`Branch ${branch} was pushed, but the pull request could not be opened: ${err?.message ?? err}`);
263
274
  }
264
275
  runner.log(`Pull request #${pullRequest.number}: ${pullRequest.url}`);
265
- runner.update((current) => ({ ...current, pullRequest }));
276
+ runner.update((current) => ({ ...current, pullRequest: { number: pullRequest.number, url: pullRequest.url } }));
277
+ runner.addPullRequest({ number: pullRequest.number, url: pullRequest.url, branch, createdAt: pullRequest.createdAt });
266
278
  runner.setStep("push", "done");
267
279
  }
268
280
  // --- Enchaînement ------------------------------------------------------------
@@ -1,6 +1,7 @@
1
- import { type Alert, type AlertSeverity, type HandledAlert, type Operation, type Repo, type Rights } from "../../shared/schemas/model.schema.js";
1
+ import { type Alert, type AlertSeverity, type HandledAlert, type Operation, type PullRequest, type Repo, type Rights } from "../../shared/schemas/model.schema.js";
2
2
  import type { RepoView } from "../../shared/schemas/api.schema.js";
3
3
  import type { GitHubConfig } from "./config.js";
4
+ import { type OpenPullRequest } from "./github.js";
4
5
  import { type Store } from "./store.js";
5
6
  /** Ancienneté au-delà de laquelle les alertes d'un dépôt sont relues sur GitHub. */
6
7
  export declare const SYNC_INTERVAL_MS: number;
@@ -35,10 +36,22 @@ export declare function unfixablePackages(repo: Repo, operations: Operation[]):
35
36
  * depuis le marquage.
36
37
  */
37
38
  export declare function pruneHandledAlerts(handled: HandledAlert[], alerts: Alert[]): HandledAlert[];
39
+ /**
40
+ * Pull requests ouvertes par le tracker parmi celles ouvertes sur le dépôt :
41
+ * leur branche suit le nommage `fix/npm-audit-…` et appartient au dépôt
42
+ * lui-même, pas à une fourche. Par numéro croissant.
43
+ */
44
+ export declare function trackerPullRequests(repoId: string, pulls: OpenPullRequest[]): PullRequest[];
38
45
  export declare function repoView(store: Store, repo: Repo): RepoView;
39
46
  export declare function listRepoViews(store: Store): RepoView[];
40
- /** Relit les alertes Dependabot ouvertes du dépôt ; un échec est enregistré dans `syncError`, alertes précédentes conservées. */
47
+ /**
48
+ * Relit les alertes Dependabot ouvertes du dépôt et ses pull requests ouvertes
49
+ * par le tracker ; un échec est enregistré dans `syncError`, données précédentes
50
+ * conservées.
51
+ */
41
52
  export declare function syncRepository(store: Store, config: GitHubConfig, repoId: string): Promise<Repo>;
53
+ /** Relit tout de suite, en parallèle, les alertes et les pull requests de chaque dépôt suivi. */
54
+ export declare function syncAllRepositories(store: Store, config: GitHubConfig): Promise<void>;
42
55
  /** Suit un nouveau dépôt, rangé dans `categoryId`, avec l'audit pour seul droit de l'agent, puis lit ses alertes. */
43
56
  export declare function addRepository(store: Store, config: GitHubConfig, input: string, categoryId: string | null): Promise<Repo>;
44
57
  /** Dépôts accessibles au token qui ne sont pas encore suivis, proposés à l'ajout. */
@@ -2,6 +2,7 @@ import { pendingAlerts } from "../../shared/alerts.js";
2
2
  import { ALERT_SEVERITIES, DEFAULT_RIGHTS } from "../../shared/schemas/model.schema.js";
3
3
  import { ConflictError, NotFoundError } from "./errors.js";
4
4
  import { GitHubClient } from "./github.js";
5
+ import { isTrackerBranch } from "./operations.js";
5
6
  import { parseRepoRef } from "./repo-ref.js";
6
7
  import { isActive } from "./store.js";
7
8
  /** Ancienneté au-delà de laquelle les alertes d'un dépôt sont relues sur GitHub. */
@@ -74,6 +75,17 @@ export function pruneHandledAlerts(handled, alerts) {
74
75
  const open = new Set(alerts.map((alert) => alert.number));
75
76
  return handled.filter((mark) => open.has(mark.number) && !alerts.some((alert) => alert.package === mark.package && Date.parse(alert.createdAt) > Date.parse(mark.markedAt)));
76
77
  }
78
+ /**
79
+ * Pull requests ouvertes par le tracker parmi celles ouvertes sur le dépôt :
80
+ * leur branche suit le nommage `fix/npm-audit-…` et appartient au dépôt
81
+ * lui-même, pas à une fourche. Par numéro croissant.
82
+ */
83
+ export function trackerPullRequests(repoId, pulls) {
84
+ return pulls
85
+ .filter((pull) => isTrackerBranch(pull.branch) && pull.headRepo?.toLowerCase() === repoId.toLowerCase())
86
+ .sort((a, b) => a.number - b.number)
87
+ .map(({ number, url, branch, createdAt }) => ({ number, url, branch, createdAt }));
88
+ }
77
89
  export function repoView(store, repo) {
78
90
  const operations = store.listOperations(repo.id);
79
91
  return {
@@ -89,16 +101,21 @@ export function listRepoViews(store) {
89
101
  store.failOrphanedOperations();
90
102
  return sortRepos(store.listRepos().map((repo) => repoView(store, repo)));
91
103
  }
92
- /** Relit les alertes Dependabot ouvertes du dépôt ; un échec est enregistré dans `syncError`, alertes précédentes conservées. */
104
+ /**
105
+ * Relit les alertes Dependabot ouvertes du dépôt et ses pull requests ouvertes
106
+ * par le tracker ; un échec est enregistré dans `syncError`, données précédentes
107
+ * conservées.
108
+ */
93
109
  export async function syncRepository(store, config, repoId) {
94
110
  const repo = store.getRepo(repoId);
95
111
  const github = new GitHubClient(config);
96
112
  try {
97
- const alerts = await github.listOpenAlerts(repo.owner, repo.name);
113
+ const [alerts, pulls] = await Promise.all([github.listOpenAlerts(repo.owner, repo.name), github.listOpenPullRequests(repo.owner, repo.name)]);
98
114
  return store.updateRepo(repo.id, (current) => ({
99
115
  ...current,
100
116
  alerts,
101
117
  handledAlerts: pruneHandledAlerts(current.handledAlerts, alerts),
118
+ pullRequests: trackerPullRequests(current.id, pulls),
102
119
  syncedAt: new Date().toISOString(),
103
120
  syncError: null,
104
121
  }));
@@ -108,6 +125,10 @@ export async function syncRepository(store, config, repoId) {
108
125
  return store.updateRepo(repo.id, (current) => ({ ...current, syncedAt: new Date().toISOString(), syncError: message }));
109
126
  }
110
127
  }
128
+ /** Relit tout de suite, en parallèle, les alertes et les pull requests de chaque dépôt suivi. */
129
+ export async function syncAllRepositories(store, config) {
130
+ await Promise.all(store.listRepos().map((repo) => syncRepository(store, config, repo.id)));
131
+ }
111
132
  /** Suit un nouveau dépôt, rangé dans `categoryId`, avec l'audit pour seul droit de l'agent, puis lit ses alertes. */
112
133
  export async function addRepository(store, config, input, categoryId) {
113
134
  const ref = parseRepoRef(input);
@@ -127,6 +148,7 @@ export async function addRepository(store, config, input, categoryId) {
127
148
  rights: DEFAULT_RIGHTS,
128
149
  alerts: [],
129
150
  handledAlerts: [],
151
+ pullRequests: [],
130
152
  syncedAt: null,
131
153
  syncError: null,
132
154
  });
@@ -39,7 +39,8 @@ export function processAlive(pid) {
39
39
  * Complète un fichier écrit par une version antérieure : un dépôt sans branche
40
40
  * choisie analyse sa branche par défaut, un dépôt sans catégorie n'est rangé
41
41
  * dans aucune, un fichier sans catégories n'en a aucune, un dépôt sans alerte
42
- * corrigée à la main n'en a aucune. Une alerte sans date
42
+ * corrigée à la main n'en a aucune, un dépôt sans pull request en attente n'en
43
+ * a aucune jusqu'à sa lecture suivante. Une alerte sans date
43
44
  * d'émission prend celle de la lecture qui l'a rapportée ; la lecture suivante
44
45
  * la remplace par la vraie.
45
46
  */
@@ -54,6 +55,7 @@ function normalizeReposFile(file) {
54
55
  branch: typeof repo?.branch === "string" ? repo.branch : repo?.defaultBranch,
55
56
  categoryId: repo?.categoryId ?? null,
56
57
  handledAlerts: repo?.handledAlerts ?? [],
58
+ pullRequests: repo?.pullRequests ?? [],
57
59
  alerts: Array.isArray(repo?.alerts)
58
60
  ? repo.alerts.map((alert) => ({ ...alert, createdAt: alert?.createdAt ?? repo.syncedAt ?? repo.addedAt }))
59
61
  : repo?.alerts,
@@ -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.post("/api/sync", (c) => forward(c, "SYNC_REPOS"));
198
199
  app.get("/api/github/repos", (c) => forward(c, "LIST_ADDABLE_REPOS"));
199
200
  app.get("/api/repos/:owner/:name", (c) => forward(c, "GET_REPO", { repoId: repoId(c) }));
200
201
  app.delete("/api/repos/:owner/:name", (c) => forward(c, "REMOVE_REPO", { repoId: repoId(c) }));
package/dist/src/index.js CHANGED
@@ -14,7 +14,7 @@ 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, listAddableRepositories, listRepoBranches, listRepoViews, markAlertHandled, setBranch, setCategory, repoView, setRights, staleRepos, syncRepository, unmarkAlertHandled } from "./core/repos.js";
17
+ import { SYNC_INTERVAL_MS, addRepository, listAddableRepositories, listRepoBranches, listRepoViews, markAlertHandled, setBranch, setCategory, repoView, setRights, staleRepos, syncAllRepositories, syncRepository, unmarkAlertHandled } from "./core/repos.js";
18
18
  import { GUI_REQUEST_TYPES, IPCMessageSchema } from "../shared/schemas/ipc.schema.js";
19
19
  import { AddRepoBodySchema, AlertRequestSchema, CategoryBodySchema, CategoryRequestSchema, ForceBodySchema, OperationRequestSchema, PushBodySchema, RepoRequestSchema, SetBranchBodySchema, SetCategoryBodySchema, SetRightsBodySchema, } from "../shared/schemas/api.schema.js";
20
20
  import { errorResult, textResult } from "./tools/types.js";
@@ -75,7 +75,7 @@ const operations = {
75
75
  const INSTRUCTIONS = `mcp-dependabot-tracker follows the Dependabot alerts of GitHub repositories and fixes their npm vulnerabilities. The user tracks repositories and decides what you may do on each of them in a web GUI; you act only through these tools, never with git or npm yourself.
76
76
 
77
77
  Concepts:
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.
78
+ - A **tracked repository** is a GitHub repository the user added in the GUI. Its open Dependabot alerts, and the pull requests the tracker opened that are not merged or closed yet, 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
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.
@@ -132,6 +132,9 @@ async function handleGuiRequest(msg) {
132
132
  return { version: APP_VERSION, dataDir, githubConfigured: githubConfigured() };
133
133
  case "LIST_REPOS":
134
134
  return { repos: listRepoViews(store), categories: store.listCategories() };
135
+ case "SYNC_REPOS":
136
+ await syncAllRepositories(store, readGitHubConfig());
137
+ return { repos: listRepoViews(store), categories: store.listCategories() };
135
138
  case "LIST_ADDABLE_REPOS":
136
139
  return { repositories: await listAddableRepositories(store, readGitHubConfig()) };
137
140
  case "GET_REPO": {
@@ -300,7 +303,7 @@ const REPOSITORY_DOC = "Tracked repository, as owner/name (see list_repositories
300
303
  const TOOLS = [
301
304
  {
302
305
  name: "list_repositories",
303
- description: "List the tracked repositories with their category, 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.",
306
+ description: "List the tracked repositories with their category, 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), the pull requests the tracker opened that are still open, and the operation in progress. Start here.",
304
307
  inputSchema: {
305
308
  type: "object",
306
309
  properties: { category: { type: "string", description: "Only list the repositories of this category, by name (case-insensitive). The user creates the categories in the GUI." } },
@@ -29,6 +29,9 @@ export function describeRepo(view, category) {
29
29
  ];
30
30
  if (repo.syncError)
31
31
  lines.push(` Last sync failed: ${repo.syncError}`);
32
+ if (repo.pullRequests.length > 0) {
33
+ lines.push(` Pull requests opened by the tracker, not merged yet: ${repo.pullRequests.map((pull) => `#${pull.number} ${pull.url}`).join(", ")}`);
34
+ }
32
35
  if (view.unfixable.length > 0)
33
36
  lines.push(` Last npm audit found no published fix for: ${view.unfixable.join(", ")}`);
34
37
  if (view.cleanAuditAt) {