@imenam/mcp-dependabot-tracker 1.0.28 → 1.0.30
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
|
@@ -211,7 +211,7 @@ Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit o
|
|
|
211
211
|
|
|
212
212
|
**Pull requests en attente** — à chaque lecture d'un dépôt (toutes les 10 minutes, ou « Synchroniser maintenant »), le tracker lit ses pull requests ouvertes sur GitHub et garde celles dont la branche suit le nommage `fix/npm-audit-<AAAA-MM-JJ>-<HHMMSS>` et appartient au dépôt lui-même (pas à une fourche). Les pull requests ouvertes avant cette fonction sont donc reconnues, même quand l'historique des opérations ne les contient plus. Une pull request mergée ou fermée disparaît à la lecture suivante, ou aussitôt quand l'utilisateur la marque mergée dans l'onglet « PR en attente » ; une pull request que le tracker vient d'ouvrir apparaît aussitôt.
|
|
213
213
|
|
|
214
|
-
**Auditer tout** — depuis l'accueil, un audit seul (clone et `npm audit`, sans correction) de la **branche
|
|
214
|
+
**Auditer tout** — depuis l'accueil, un audit seul (clone et `npm audit`, sans correction) de la **branche analysée** (celle que clone une correction) de chaque dépôt suivi de l'onglet affiché : tous les dépôts sur « Tous mes projets » et « Dépréciés », ceux de la catégorie quand une catégorie est affichée (le bouton s'intitule alors « Auditer la catégorie »), ceux de la file d'attente sur son onglet (« Auditer la file »). Trois audits tournent à la fois. Un dépôt où une opération est déjà en cours est laissé de côté ; un audit qui échoue (dépôt sans `package-lock.json`, clone impossible) n'arrête pas les autres. La série vit dans le serveur ; une seule à la fois.
|
|
215
215
|
|
|
216
216
|
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.
|
|
217
217
|
|
|
@@ -232,7 +232,7 @@ Quand `npm audit fix` laisse des vulnérabilités dans une correction, lancée d
|
|
|
232
232
|
|
|
233
233
|
Une tâche introuvable, sans le tag ou non assignée au propriétaire fait échouer la session, comme une erreur de Claude, un dépassement des limites, l'organizer ou le token Claude non réglés, ou un bac à sable impossible : le clone revient au commit de `npm audit fix`, l'erreur s'affiche sous l'étape, et la correction pousse quand même les corrections de `npm audit fix`, avec un avertissement en tête de la pull request. L'annulation de l'opération arrête Claude Code.
|
|
234
234
|
|
|
235
|
-
**Ce que Claude peut faire** — outils intégrés `Read`, `Grep`, `Glob`, `Edit` et `Write`, sans shell : ni `git`, ni push. `Edit` et `Write` refusent tout chemin hors du clone (`blockWritesOutsideWorkingDirectories`). Le clone n'a pas de dossier `.git` : le dépôt git de l'opération est à côté de lui (`GIT_DIR`), hors de portée de Claude et des commandes npm, et le tracker lance `git` sans hook (`core.hooksPath`) ni moniteur de fichiers (`core.fsmonitor`) ; un hook posé dans le clone par un paquet (husky…) ou par un script d'installation ne s'exécute donc jamais sur le serveur. Claude lance npm par les outils d'un second serveur MCP, `npm`, que le tracker lui fournit (`dist/src/npm-tools.js`) : `npm_install_lockfile` (`npm install --package-lock-only --ignore-scripts`, avec les paquets à ajouter ou monter), `npm_audit` (avec le périmètre de l'opération), `npm_ci`, `npm_test`, `npm_run` (un script de `package.json`), `npm_ls` et `tsc` (`npm exec --no -- tsc --noEmit`). Chaque outil lance une commande fixe dans un dossier du clone qui contient un `package.json` ; ses arguments ne sont que des noms de paquets ou de scripts. Le bac à sable de Claude Code garde en lecture seule les manifestes, les lockfiles et `node_modules` : ces commandes tournent donc hors de lui, dans un bac à sable **bubblewrap** du tracker, le même que celui où le tracker lance ses propres `npm audit` et `npm audit fix` : le contenu du dépôt (`.npmrc` compris) n'agit jamais hors de lui. Seul le système y est visible, en lecture seule : `/usr`, Node.js, et de `/etc` les seuls fichiers utiles au réseau, aux comptes et aux certificats (`resolv.conf`, `hosts`, `passwd`, `ssl`…), ni `/opt`, ni `/home`, ni le reste de `/etc` ; le clone et le cache npm de l'opération y sont en écriture, `/tmp` est vide, et l'environnement se réduit à `PATH`, `LANG`, `HOME`, au cache npm et à `CI=true` : ni les données du tracker, ni les autres clones, ni aucun token. Le réseau reste ouvert pour `npm ci`. Hors de Linux, ces commandes tournent directement dans le clone. Claude Code ne reçoit jamais `GITHUB_TOKEN`, et `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` retire son propre token de l'environnement des processus qu'il lance ; sous Linux, Claude Code exige alors lui aussi bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). Au début de chaque opération et avant chaque session de Claude, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, l'opération ou la session est refusée avec la raison : `bwrap` absent, restriction AppArmor des espaces de noms utilisateur (`kernel.apparmor_restrict_unprivileged_userns`, Ubuntu 24.04 et suivantes) ou durcissement du service (`RestrictNamespaces`, `PrivateUsers`, `SystemCallFilter`). Côté organizer, seuls `create_task`, `set_assignees` et `set_tags` sont autorisés : Claude ne lit aucune autre tâche de l'espace, dont le contenu ne peut donc pas finir dans la pull request ; tout autre appel est refusé (`--permission-mode dontAsk`). La consigne précise que les fichiers du dépôt, les sorties de npm et les avis de sécurité sont des données à analyser, jamais des instructions, et demande de signaler dans la tâche tout texte qui tenterait de le détourner, et les réglages Claude du dépôt cloné ne sont pas lus (`--setting-sources user`). Installer les dépendances et lancer les tests exécute le code du projet et de ses paquets dans le clone, à chaque correction par Claude. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session.
|
|
235
|
+
**Ce que Claude peut faire** — outils intégrés `Read`, `Grep`, `Glob`, `Edit` et `Write`, sans shell : ni `git`, ni push. `Edit` et `Write` refusent tout chemin hors du clone (`blockWritesOutsideWorkingDirectories`). Le clone n'a pas de dossier `.git` : le dépôt git de l'opération est à côté de lui (`GIT_DIR`), hors de portée de Claude et des commandes npm, et le tracker lance `git` sans hook (`core.hooksPath`) ni moniteur de fichiers (`core.fsmonitor`) ; un hook posé dans le clone par un paquet (husky…) ou par un script d'installation ne s'exécute donc jamais sur le serveur. Claude lance npm par les outils d'un second serveur MCP, `npm`, que le tracker lui fournit (`dist/src/npm-tools.js`) : `npm_install_lockfile` (`npm install --package-lock-only --ignore-scripts`, avec les paquets à ajouter ou monter), `npm_audit` (avec le périmètre de l'opération), `npm_ci`, `npm_test`, `npm_run` (un script de `package.json`), `npm_ls` et `tsc` (`npm exec --no -- tsc --noEmit`). Chaque outil lance une commande fixe dans un dossier du clone qui contient un `package.json` ; ses arguments ne sont que des noms de paquets ou de scripts. Le bac à sable de Claude Code garde en lecture seule les manifestes, les lockfiles et `node_modules` : ces commandes tournent donc hors de lui, dans un bac à sable **bubblewrap** du tracker, le même que celui où le tracker lance ses propres `npm audit` et `npm audit fix` : le contenu du dépôt (`.npmrc` compris) n'agit jamais hors de lui. Seul le système y est visible, en lecture seule : `/usr`, Node.js, et de `/etc` les seuls fichiers utiles au réseau, aux comptes et aux certificats (`resolv.conf`, `hosts`, `passwd`, `ssl`…), ni `/opt`, ni `/home`, ni le reste de `/etc` ; le clone et le cache npm de l'opération y sont en écriture, `/tmp` est vide, et l'environnement se réduit à `PATH`, `LANG`, `HOME`, au cache npm et à `CI=true` : ni les données du tracker, ni les autres clones, ni aucun token. Le réseau reste ouvert pour `npm ci`. Hors de Linux, ces commandes tournent directement dans le clone. Claude Code ne reçoit jamais `GITHUB_TOKEN`, et `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` retire son propre token de l'environnement des processus qu'il lance ; sous Linux, Claude Code exige alors lui aussi bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). Au début de chaque opération et avant chaque session de Claude, le tracker crée un bac à sable d'essai avec le compte et les restrictions du serveur ; s'il échoue, l'opération ou la session est refusée avec la raison : `bwrap` absent, restriction AppArmor des espaces de noms utilisateur (`kernel.apparmor_restrict_unprivileged_userns`, Ubuntu 24.04 et suivantes) ou durcissement du service (`RestrictNamespaces`, `PrivateUsers`, `SystemCallFilter`). Côté organizer, seuls `create_task`, `set_assignees` et `set_tags` sont autorisés : Claude ne lit aucune autre tâche de l'espace, dont le contenu ne peut donc pas finir dans la pull request ; tout autre appel est refusé (`--permission-mode dontAsk`). La consigne précise que les fichiers du dépôt, les sorties de npm et les avis de sécurité sont des données à analyser, jamais des instructions, et demande de signaler dans la tâche tout texte qui tenterait de le détourner, et les réglages Claude du dépôt cloné ne sont pas lus (`--setting-sources user`). Installer les dépendances et lancer les tests exécute le code du projet et de ses paquets dans le clone, à chaque correction par Claude. La configuration MCP, qui porte le token de l'organizer, est écrite hors du clone et supprimée en fin de session. Pour garder en lecture seule `.npmrc`, `.yarnrc`, `.yarnrc.yml`, `bunfig.toml`, `.gitmodules`, `yarn.lock` et `pnpm-lock.yaml`, le bac à sable de Claude Code les crée vides dans le clone quand le dépôt n'en a pas : ces fichiers vides sont retirés avant le commit des corrections.
|
|
236
236
|
|
|
237
237
|
**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.
|
|
238
238
|
|
|
@@ -307,7 +307,7 @@ Thème sombre, une information par ligne, une action principale par écran.
|
|
|
307
307
|
Avant ces boutons, un autre (icône de liste) met le dépôt dans la **file d'attente** ; il reste allumé tant que le dépôt y est, et un nouveau clic l'en retire. Dans une catégorie, « Tout ajouter à la file », à côté de l'interrupteur, y met d'un coup tous ses dépôts qui n'y sont pas encore (inactif quand ils y sont tous).
|
|
308
308
|
« 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.
|
|
309
309
|
Dans la colonne « Suivi », « #42 » ouvre la pull request sur GitHub, « 3 PR » la liste des pull requests du dépôt.
|
|
310
|
-
« 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
|
|
310
|
+
« 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 analysée de tous les dépôts (voir plus haut) : un clic l'audite en production, la flèche à côté propose « Production » ou « Toutes les dépendances » ; le bouton affiche la progression (« Audit 4/12… »), chaque dépôt audité affiche « Audit en cours », et un message final donne le nombre de dépôts audités, laissés de côté et en échec (avec leurs noms).
|
|
311
311
|
La roue dentée, à gauche de « Synchroniser maintenant », ouvre les réglages.
|
|
312
312
|
- **File d'attente (`#/queue`)** — les dépôts mis en file, non dépréciés, dans l'ordre de leur entrée dans la file, avec les mêmes informations et le même interrupteur que l'accueil. Le chevron ouvre le dépôt pour l'auditer ou le corriger. « Traité », sur chaque ligne, retire le dépôt de la file sans toucher à sa catégorie.
|
|
313
313
|
- **PR en attente (`#/pulls`)** — les dépôts non dépréciés dont une pull request du tracker attend d'être mergée, de la plus ancienne à la plus récente, avec l'interrupteur de l'accueil. Une correction aboutie y place son dépôt dès l'ouverture de sa pull request. Sur chaque ligne, « Mergée » retire aussitôt le dépôt de l'onglet, pour un dépôt au déploiement automatique ; « Mergée, à déployer » le fait passer en plus dans « À déployer ». Les deux lancent aussitôt, en arrière-plan, un audit de la branche par défaut, sur le périmètre de la correction qui a ouvert la pull request : la liste reflète la branche fusionnée sans attendre que Dependabot repasse. Ils sont refusés tant qu'une opération est en cours sur le dépôt. La relecture des 10 minutes retire aussi les pull requests mergées ou fermées sur GitHub ; une pull request marquée mergée mais encore ouverte sur GitHub y revient à la lecture suivante.
|
|
@@ -43,6 +43,12 @@ export declare function startFix(ctx: OperationContext, repoId: string, origin:
|
|
|
43
43
|
* Refusé si une opération est en cours sur le dépôt, ou s'il est déprécié.
|
|
44
44
|
*/
|
|
45
45
|
export declare function startAudit(ctx: OperationContext, repoId: string, origin: Origin, scope: AuditScope): Operation;
|
|
46
|
+
/**
|
|
47
|
+
* Audit de la branche analysée, sur le périmètre `scope`, lancé par
|
|
48
|
+
* l'utilisateur et attendu jusqu'à sa fin. Refusé si une opération est en
|
|
49
|
+
* cours sur le dépôt, ou s'il est déprécié.
|
|
50
|
+
*/
|
|
51
|
+
export declare function runAudit(ctx: OperationContext, repoId: string, scope: AuditScope): Promise<Operation>;
|
|
46
52
|
/**
|
|
47
53
|
* Audit de la branche par défaut, celle que Dependabot analyse, sur le
|
|
48
54
|
* périmètre `scope`, lancé par l'utilisateur et attendu jusqu'à sa fin. Refusé
|
|
@@ -26,6 +26,12 @@ const CLAUDE_ACTIVITY = 3;
|
|
|
26
26
|
const SESSION_EVENTS = 500;
|
|
27
27
|
/** Fichiers suivis par les commits du tracker : tout le clone, sauf les node_modules qu'installe Claude. */
|
|
28
28
|
const STAGED_PATHS = ["--", ".", ":(exclude,glob)**/node_modules/**"];
|
|
29
|
+
/**
|
|
30
|
+
* Fichiers que le bac à sable de Claude Code garde en lecture seule. Absents
|
|
31
|
+
* du dépôt, il les crée vides dans le clone pour les monter : ces fichiers-là
|
|
32
|
+
* ne font pas partie des corrections.
|
|
33
|
+
*/
|
|
34
|
+
const SANDBOX_PLACEHOLDERS = new Set([".gitmodules", ".npmrc", ".yarnrc", ".yarnrc.yml", "bunfig.toml", "pnpm-lock.yaml", "yarn.lock"]);
|
|
29
35
|
/** Co-auteur du commit des corrections par Claude. */
|
|
30
36
|
const CLAUDE_TRAILER = "Co-Authored-By: Claude <noreply@anthropic.com>";
|
|
31
37
|
function now() {
|
|
@@ -303,11 +309,23 @@ async function commitAuditFixes(runner) {
|
|
|
303
309
|
const base = (await runner.git(["rev-parse", "HEAD"])).trim();
|
|
304
310
|
return { base, auditCommit: committed ? base : null };
|
|
305
311
|
}
|
|
312
|
+
/** Supprime les fichiers vides non suivis que le bac à sable de Claude Code a créés pour les monter. */
|
|
313
|
+
async function removeSandboxPlaceholders(runner) {
|
|
314
|
+
const untracked = (await runner.git(["ls-files", "--others", "--exclude-standard", "-z"])).split("\0").filter(Boolean);
|
|
315
|
+
for (const file of untracked) {
|
|
316
|
+
if (!SANDBOX_PLACEHOLDERS.has(path.posix.basename(file)))
|
|
317
|
+
continue;
|
|
318
|
+
const full = path.join(runner.repoDir, file);
|
|
319
|
+
if (fs.lstatSync(full).isFile() && fs.statSync(full).size === 0)
|
|
320
|
+
fs.rmSync(full);
|
|
321
|
+
}
|
|
322
|
+
}
|
|
306
323
|
/**
|
|
307
324
|
* Remplace le commit des corrections par Claude par un seul commit de tout ce
|
|
308
325
|
* qui a changé depuis `base` ; rend ce commit, ou null quand rien n'a changé.
|
|
309
326
|
*/
|
|
310
327
|
async function commitRepair(runner, base, message) {
|
|
328
|
+
await removeSandboxPlaceholders(runner);
|
|
311
329
|
await runner.git(["reset", "--soft", base]);
|
|
312
330
|
await runner.git(["add", "-A", ...STAGED_PATHS]);
|
|
313
331
|
if (!(await hasStagedChanges(runner)))
|
|
@@ -546,21 +564,37 @@ export function startAudit(ctx, repoId, origin, scope) {
|
|
|
546
564
|
return operation;
|
|
547
565
|
}
|
|
548
566
|
/**
|
|
549
|
-
* Audit de la branche
|
|
567
|
+
* Audit de la branche que `branch` choisit parmi celles du dépôt, sur le
|
|
550
568
|
* périmètre `scope`, lancé par l'utilisateur et attendu jusqu'à sa fin. Refusé
|
|
551
569
|
* si une opération est en cours sur le dépôt, ou s'il est déprécié.
|
|
552
570
|
*/
|
|
553
|
-
|
|
571
|
+
async function runUserAudit(ctx, repoId, scope, branch) {
|
|
554
572
|
ctx.githubConfig();
|
|
555
573
|
const repo = ctx.store.getRepo(repoId);
|
|
556
574
|
assertNotDeprecated(repo);
|
|
557
|
-
const operation = ctx.store.createOperation({ ...newOperation(repo, "audit", "user", scope), baseBranch: repo
|
|
575
|
+
const operation = ctx.store.createOperation({ ...newOperation(repo, "audit", "user", scope), baseBranch: branch(repo) });
|
|
558
576
|
return execute(ctx, operation.id, async (runner) => {
|
|
559
577
|
await cloneStep(runner);
|
|
560
578
|
await auditStep(runner);
|
|
561
579
|
finish(runner);
|
|
562
580
|
});
|
|
563
581
|
}
|
|
582
|
+
/**
|
|
583
|
+
* Audit de la branche analysée, sur le périmètre `scope`, lancé par
|
|
584
|
+
* l'utilisateur et attendu jusqu'à sa fin. Refusé si une opération est en
|
|
585
|
+
* cours sur le dépôt, ou s'il est déprécié.
|
|
586
|
+
*/
|
|
587
|
+
export function runAudit(ctx, repoId, scope) {
|
|
588
|
+
return runUserAudit(ctx, repoId, scope, (repo) => repo.branch);
|
|
589
|
+
}
|
|
590
|
+
/**
|
|
591
|
+
* Audit de la branche par défaut, celle que Dependabot analyse, sur le
|
|
592
|
+
* périmètre `scope`, lancé par l'utilisateur et attendu jusqu'à sa fin. Refusé
|
|
593
|
+
* si une opération est en cours sur le dépôt, ou s'il est déprécié.
|
|
594
|
+
*/
|
|
595
|
+
export function runDefaultBranchAudit(ctx, repoId, scope) {
|
|
596
|
+
return runUserAudit(ctx, repoId, scope, (repo) => repo.defaultBranch);
|
|
597
|
+
}
|
|
564
598
|
/**
|
|
565
599
|
* Périmètre de l'audit qui suit la fusion des pull requests `numbers` : celui
|
|
566
600
|
* de la plus récente des corrections qui les ont ouvertes, ou la production,
|
package/dist/src/server/serve.js
CHANGED
|
@@ -13,7 +13,7 @@ import { resolveCloneDir, resolveDataDir } from "../core/data-dir.js";
|
|
|
13
13
|
import { DeployServerStore } from "../core/deploy-servers.js";
|
|
14
14
|
import { Deployer, DeploymentStore } from "../core/deployments.js";
|
|
15
15
|
import { resolveLogDir } from "../core/log-dir.js";
|
|
16
|
-
import {
|
|
16
|
+
import { runAudit } from "../core/operations.js";
|
|
17
17
|
import { OrganizerClient } from "../core/organizer.js";
|
|
18
18
|
import { refreshReportTask } from "../core/repair.js";
|
|
19
19
|
import { SYNC_INTERVAL_MS, staleRepos, syncRepository } from "../core/repos.js";
|
|
@@ -135,7 +135,7 @@ export async function serve() {
|
|
|
135
135
|
settings: () => readSettings(dataDir, vaultKey),
|
|
136
136
|
claude,
|
|
137
137
|
};
|
|
138
|
-
const auditAll = new AuditAll((repoId, scope) =>
|
|
138
|
+
const auditAll = new AuditAll((repoId, scope) => runAudit(operations, repoId, scope), (message) => logger.error(message));
|
|
139
139
|
const app = createApp({
|
|
140
140
|
store,
|
|
141
141
|
dataDir,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@imenam/mcp-dependabot-tracker",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.30",
|
|
4
4
|
"description": "Server and web GUI that track the Dependabot alerts of GitHub repositories and fix their npm vulnerabilities in a temporary clone: npm audit, audit fix, fixes by Claude, then a branch and a pull request. An MCP mode lets agents drive the server.",
|
|
5
5
|
"main": "dist/src/index.js",
|
|
6
6
|
"scripts": {
|