@imenam/mcp-dependabot-tracker 1.0.28 → 1.0.29
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 +1 -1
- package/dist/src/core/operations.js +18 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -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
|
|
|
@@ -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)))
|
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.29",
|
|
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": {
|