@imenam/mcp-dependabot-tracker 1.0.27 → 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 +14 -8
- package/dist/shared/schemas/deploy.schema.d.ts +5 -1
- package/dist/src/core/deploy-servers.d.ts +2 -0
- package/dist/src/core/deploy-servers.js +10 -1
- package/dist/src/core/deployments.d.ts +5 -1
- package/dist/src/core/deployments.js +17 -0
- package/dist/src/core/operations.js +18 -0
- package/dist/src/server/app.js +5 -1
- package/gui/dist/assets/{index-BhIO2hHa.js → index-CAOy2g1q.js} +8 -8
- package/gui/dist/assets/{index-JLEsoQSQ.css → index-CYU7-6kP.css} +1 -1
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -232,12 +232,13 @@ 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
|
|
|
239
239
|
**Réglages** (écran Réglages, roue dentée de l'accueil) :
|
|
240
240
|
|
|
241
|
+
- **Serveurs de déploiement** — les serveurs connectés en SSH, partagés par les dépôts (voir [Le déploiement](#le-déploiement)).
|
|
241
242
|
- **GitHub** — le token du tracker et le token de déploiement (voir [Tokens GitHub](#tokens-github)) ; « Retirer », confirmé par un second clic, supprime le token de déploiement.
|
|
242
243
|
- **Organizer** — adresse du site (https, sauf pour un site de cette machine) et token d'agent, créé dans l'organizer (Paramètres › Agents) : il couvre un espace, avec les droits de son créateur. Une connexion modifiée est testée à l'enregistrement ; « Tester » la reteste. L'écran affiche l'espace et son propriétaire.
|
|
243
244
|
- **Claude** — un token d'abonnement (Pro, Max, Team ou Enterprise) : lancer `claude setup-token` sur un poste avec navigateur, autoriser l'accès, puis coller le token affiché (valable un an). Il est vérifié à l'enregistrement par une requête minimale ; un token refusé n'est pas enregistré. L'écran affiche sa date d'enregistrement et d'expiration.
|
|
@@ -254,17 +255,21 @@ Les tokens GitHub, de l'organizer et de Claude sont enregistrés dans `<données
|
|
|
254
255
|
|
|
255
256
|
Chaque dépôt peut se déployer sur un serveur, par SSH, avec un script shell écrit dans l'interface (onglet « Déploiement » de l'écran du dépôt).
|
|
256
257
|
|
|
257
|
-
**
|
|
258
|
+
**Serveurs** — les serveurs se gèrent dans les Réglages, section « Serveurs de déploiement », et se partagent entre dépôts. Chaque ligne donne le nom du serveur, `utilisateur@hôte:port`, le nombre de dépôts qui le choisissent et son état (« Connecté », « À tester », « Clé révoquée ») ; son menu « … » propose Modifier, Tester la connexion (ou Installer une clé, sans clé), Changer de clé, Révoquer la clé et Supprimer. Un serveur ne se supprime que si aucun dépôt ne le choisit et qu'il n'a plus de clé.
|
|
258
259
|
|
|
259
|
-
|
|
260
|
+
Dans l'onglet « Déploiement » d'un dépôt, le nom du serveur ouvre la liste des serveurs : un clic choisit celui du dépôt (un serveur sans clé n'est pas proposé), « Ne plus déployer ce dépôt » le détache, et un lien mène aux Réglages. Un dépôt sans serveur affiche « Choisir un serveur ». Changer de serveur est refusé pendant un déploiement.
|
|
261
|
+
|
|
262
|
+
**Connexion d'un serveur** — « Ajouter un serveur », dans les Réglages, suit la même procédure que [SSH Gate](https://www.npmjs.com/package/@imenam/mcp-ssh-gate), en trois étapes :
|
|
263
|
+
|
|
264
|
+
1. **Serveur** — nom, hôte, port et utilisateur. « Générer la clé » enregistre le serveur avec sa propre paire ed25519 (`dependabot-tracker@<serveur>`). La clé privée est chiffrée avec `VAULT_KEY` et n'est jamais affichée.
|
|
260
265
|
2. **Installation** — une commande d'une ligne, à coller dans une session ouverte sur le serveur avec l'utilisateur choisi. Elle écrit la clé dans le fichier dédié `~/.ssh/authorized_keys.d/dependabot-tracker` (ligne `restrict` : ni redirection, ni agent, ni pseudo-terminal), fait lire ce fichier à sshd en plus de `~/.ssh/authorized_keys` (`/etc/ssh/sshd_config.d/10-dependabot-tracker.conf`, avec sudo), et ne recharge sshd que si sa configuration est valide et prend le fichier en compte ; sinon le réglage est retiré. `~/.ssh/authorized_keys` n'est jamais modifié. Le réglage nomme aussi le fichier de SSH Gate : sshd ne retenant que le premier `AuthorizedKeysFile`, un serveur où les deux sont installés garde l'accès de SSH Gate. « Clé publique seule » affiche la clé, pour l'installer autrement.
|
|
261
266
|
3. **Test** — le tracker se connecte, enregistre l'empreinte de la clé d'hôte (vérifiée à chaque connexion suivante : une clé d'hôte changée refuse la connexion), puis limite la ligne de sa clé à son adresse vue par le serveur (`from="…"`, lue dans `$SSH_CLIENT`). La nouvelle ligne est vérifiée par une seconde connexion avant d'être gardée ; refusée, la ligne d'origine est remise. Les lignes des autres clés du fichier ne sont pas touchées. Le résultat dit si la clé est bien dans le fichier dédié, limitée à une adresse, et signale une copie restée dans `~/.ssh/authorized_keys`.
|
|
262
267
|
|
|
263
|
-
|
|
268
|
+
Modifier l'hôte ou le port d'un serveur oublie son empreinte et son test.
|
|
264
269
|
|
|
265
270
|
**Renouveler la clé** — comme dans SSH Gate, en quatre étapes : générer une nouvelle paire, ajouter sa ligne à côté de l'actuelle dans le fichier dédié (avec la même limite d'adresse), ouvrir une seconde connexion avec la nouvelle clé, puis ne garder qu'elle. Un échec avant la dernière étape remet le fichier dans son état d'origine et garde la clé actuelle : rien n'est perdu. Refusé tant que la connexion n'a pas été testée, quand la clé n'est pas dans le fichier dédié, ou quand elle figure aussi dans `~/.ssh/authorized_keys` (elle y resterait valable).
|
|
266
271
|
|
|
267
|
-
**Révoquer la clé** — le tracker retire sa ligne du fichier dédié (les autres lignes restent), vérifie qu'une nouvelle connexion est refusée, puis efface la clé : le serveur reste enregistré, «
|
|
272
|
+
**Révoquer la clé** — le tracker retire sa ligne du fichier dédié (les autres lignes restent), vérifie qu'une nouvelle connexion est refusée, puis efface la clé : le serveur reste enregistré, « Clé révoquée ». Si le serveur accepte encore la clé, elle figure ailleurs et rien n'est effacé. Si le tracker ne peut pas se connecter, la fenêtre donne la commande qui retire la ligne, à lancer soi-même, puis « C'est fait, effacer la clé » l'oublie sans toucher au serveur. « Installer une clé » (menu « … » du serveur, dans les Réglages) génère une nouvelle paire et rouvre l'assistant sur sa commande d'installation.
|
|
268
273
|
|
|
269
274
|
Le renouvellement et la révocation valent pour tous les dépôts qui utilisent le serveur, et sont refusés pendant un déploiement sur ce serveur.
|
|
270
275
|
|
|
@@ -307,9 +312,9 @@ Thème sombre, une information par ligne, une action principale par écran.
|
|
|
307
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.
|
|
308
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.
|
|
309
314
|
- **À déployer (`#/deploy`)** — les dépôts marqués « à déployer », non dépréciés, dans l'ordre où ils ont été marqués, avec les colonnes de l'accueil (la date de la marque en infobulle de la fusée) et son interrupteur. Le chevron ouvre le dépôt. « Déployé », sur chaque ligne, retire la marque sans toucher à sa catégorie ni à la file d'attente.
|
|
310
|
-
- **Réglages (`#/settings`)** — connexion à l'organizer, token Claude, limites des corrections par Claude et tokens d'accès des agents (voir [Les corrections par Claude](#les-corrections-par-claude)). Un token enregistré n'apparaît que par ses quatre derniers caractères, avec « Remplacer ». « Enregistrer » valide les
|
|
315
|
+
- **Réglages (`#/settings`)** — serveurs de déploiement, tokens GitHub, connexion à l'organizer, token Claude, limites des corrections par Claude et tokens d'accès des agents (voir [Les corrections par Claude](#les-corrections-par-claude)). Un token enregistré n'apparaît que par ses quatre derniers caractères, avec « Remplacer ». « Enregistrer » valide les tokens, l'organizer et les limites ; les serveurs et les tokens d'agent se créent, se modifient et se suppriment aussitôt.
|
|
311
316
|
- **Dépréciés (`#/deprecated`)** — les dépôts dépréciés, du plus récent au plus ancien, avec la date de dépréciation. « Rétablir », sur chaque ligne, remet le dépôt dans sa catégorie et relit aussitôt ses alertes. Le chevron ouvre l'écran du dépôt, où « Corriger » est désactivé.
|
|
312
|
-
- **Dépôt (`#/r/<propriétaire>/<nom>`, `#/r/<propriétaire>/<nom>/history`)** — le nom du dépôt, suivi d'une icône qui ouvre sa page GitHub dans un nouvel onglet (sur le serveur de `GITHUB_SERVER_URL`), 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) et date de la dernière lecture des alertes, puis trois onglets. **Alertes ouvertes**, avec leur nombre : 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 », une alerte sur une dépendance de développement l'étiquette « dév. ». 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. **Historique**, avec le nombre d'opérations : une ligne par opération conservée (les 20 dernières du dépôt), de la plus récente à la plus ancienne, avec audit ou correction, qui l'a lancée, le périmètre, la branche, la date, les vulnérabilités avant et après (le début de l'erreur pour une opération échouée), la part de Claude (« Claude » quand il a été lancé) et l'issue (la pull request, « terminée », « annulée », « échouée ») ; chaque ligne ouvre l'opération. **Déploiement** (`…/deploy`) : sans serveur, «
|
|
317
|
+
- **Dépôt (`#/r/<propriétaire>/<nom>`, `#/r/<propriétaire>/<nom>/history`)** — le nom du dépôt, suivi d'une icône qui ouvre sa page GitHub dans un nouvel onglet (sur le serveur de `GITHUB_SERVER_URL`), 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) et date de la dernière lecture des alertes, puis trois onglets. **Alertes ouvertes**, avec leur nombre : 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 », une alerte sur une dépendance de développement l'étiquette « dév. ». 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. **Historique**, avec le nombre d'opérations : une ligne par opération conservée (les 20 dernières du dépôt), de la plus récente à la plus ancienne, avec audit ou correction, qui l'a lancée, le périmètre, la branche, la date, les vulnérabilités avant et après (le début de l'erreur pour une opération échouée), la part de Claude (« Claude » quand il a été lancé) et l'issue (la pull request, « terminée », « annulée », « échouée ») ; chaque ligne ouvre l'opération. **Déploiement** (`…/deploy`) : sans serveur, « Choisir un serveur » ouvre la liste des serveurs des Réglages. Avec un serveur : sa ligne (le nom, qui ouvre la même liste pour changer de serveur ou ne plus déployer ce dépôt, l'adresse, le dernier déploiement, « Connecté », « À tester » ou « Clé révoquée », ces deux dernières menant aux Réglages, et « Déployer »), le script coloré avec « Modifier », puis les derniers déploiements (branche, commit, date, durée, issue), chacun ouvrant son détail (`…/deploy/<id>`) : le script avec la ligne en échec surlignée et la sortie. Pendant un déploiement, l'onglet montre son exécution : la ligne en cours surlignée, les suivantes estompées, la sortie qui défile, et « Interrompre » à la place de « Déployer ». « Corriger » lance une correction en production ; la flèche à côté ouvre le choix du périmètre (« Production » ou « Toutes les dépendances », Échap ferme). « Voir la correction en cours » rouvre celle en cours. À gauche de la corbeille, « Traité » retire de la file d'attente un dépôt qui y est et ramène à la file ; pour un dépôt hors de la file, « Ajouter à la file » l'y met (absent pour un dépôt déprécié). Juste avant, « À déployer » marque le dépôt ; une fois marqué, le bouton s'allume et devient « Déployé », qui retire la marque (absent pour un dépôt déprécié). La corbeille retire le dépôt du suivi : elle devient « Confirmer le retrait », qu'un second clic dans les 4 secondes confirme ; refusé pendant une opération.
|
|
313
318
|
- **Correction (`#/r/<propriétaire>/<nom>/op/<id>`)** — qui l'a lancée (vous ou l'agent), la branche clonée, le périmètre ; les flèches « 1 / 5 » passent à l'opération plus récente ou plus ancienne du dépôt, la flèche de retour ramène à son historique. Trois onglets : **Étapes**, **Claude** (quand Claude est intervenu) et **Journal**. Les étapes se suivent sans décision à prendre : chacune tient sur une ligne avec son résultat (« 4 vulnérabilités », « 3 corrigées », lien vers la pull request). Une étape passée en donne la raison : « 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. Pendant les corrections par Claude, l'étape montre leur durée, leurs tours et les trois dernières actions de Claude ; ensuite, ce qu'il a changé : résumé, fichiers, tests, vulnérabilités restantes et lien vers sa tâche de rapport. Un échec de Claude s'affiche sous l'étape (« échouées · corrections de npm audit fix seules »). Une fois la pull request ouverte, l'étape du push montre la branche et « voir les changements » (paquets mis à jour, replié) ; tant que la pull request attend, elle propose aussi « Mergée » et « Mergée, à déployer », comme l'onglet « PR en attente ». Une erreur s'affiche sous l'étape qui a échoué. L'onglet « Claude » montre la session : sa tâche de rapport, le déroulé complet de ses messages et de ses actions (500 derniers) et son résultat : le résumé des corrections, les fichiers modifiés, le commit, les tests et les vulnérabilités restantes, ou la raison de l'échec. L'onglet « Journal » montre les commandes lancées et leurs résultats ; « Annuler » arrête l'opération.
|
|
314
319
|
|
|
315
320
|
Les écrans se relisent par polling : toutes les 3 s pour les listes, toutes les secondes pendant une opération. Un écran rouvert affiche aussitôt la dernière réponse reçue, puis se met à jour ; seuls les réglages attendent une lecture fraîche.
|
|
@@ -350,8 +355,9 @@ Un point d'entrée, `src/index.ts`, et deux modes :
|
|
|
350
355
|
| `POST /api/settings/organizer/test` | Reteste la connexion enregistrée à l'organizer. |
|
|
351
356
|
| `GET /api/agent-tokens`, `POST /api/agent-tokens` | Tokens d'agent, du plus récent au plus ancien (nom, quatre derniers caractères, création, dernière utilisation) ; création (`{ name }`), qui rend le token en clair, une seule fois, et la commande `--claude-setup-mcp` qui le déclare. |
|
|
352
357
|
| `DELETE /api/agent-tokens/:id` | Révoque un token. |
|
|
353
|
-
| `GET /api/deploy-servers`, `POST /api/deploy-servers` | Serveurs de déploiement, avec la commande d'installation de leur clé ; création (`{ name, host, port, username }`), qui génère la paire de clés. |
|
|
358
|
+
| `GET /api/deploy-servers`, `POST /api/deploy-servers` | Serveurs de déploiement, avec la commande d'installation de leur clé et le nombre de dépôts qui les choisissent ; création (`{ name, host, port, username }`), qui génère la paire de clés. |
|
|
354
359
|
| `PUT /api/deploy-servers/:id` | Modifie un serveur ; un nouvel hôte ou port oublie son empreinte et son test. |
|
|
360
|
+
| `DELETE /api/deploy-servers/:id` | Supprime un serveur (`409` tant qu'un dépôt le choisit, qu'il a une clé ou qu'un déploiement y tourne). |
|
|
355
361
|
| `POST /api/deploy-servers/:id/test` | Teste la connexion, enregistre l'empreinte de l'hôte et limite la clé à l'adresse du tracker ; rend l'empreinte, le dossier du shell et la place de la clé. |
|
|
356
362
|
| `POST /api/deploy-servers/:id/key` | Nouvelle paire de clés pour un serveur dont la clé a été révoquée. |
|
|
357
363
|
| `POST /api/deploy-servers/:id/key/rotate` | Renouvelle la clé ; rend l'état des quatre étapes et l'erreur qui a arrêté le renouvellement (`409` pendant un déploiement sur le serveur). |
|
|
@@ -126,9 +126,13 @@ export interface RotationResponse {
|
|
|
126
126
|
steps: KeyStepStatus[];
|
|
127
127
|
error: string | null;
|
|
128
128
|
}
|
|
129
|
+
/** Serveur de la liste des réglages, avec le nombre de dépôts qui le choisissent. */
|
|
130
|
+
export interface DeployServerListItem extends DeployServerView {
|
|
131
|
+
repoCount: number;
|
|
132
|
+
}
|
|
129
133
|
/** Serveurs enregistrés, du plus ancien au plus récent. */
|
|
130
134
|
export interface DeployServersResponse {
|
|
131
|
-
servers:
|
|
135
|
+
servers: DeployServerListItem[];
|
|
132
136
|
}
|
|
133
137
|
/**
|
|
134
138
|
* Déploiement d'un dépôt : son serveur (null s'il n'en a pas), son script, le
|
|
@@ -70,6 +70,8 @@ export declare class DeployServerStore {
|
|
|
70
70
|
revoke(id: string): Promise<DeployServerView>;
|
|
71
71
|
/** Efface la clé sans toucher au serveur : le serveur reste enregistré, sans accès. */
|
|
72
72
|
forget(id: string): DeployServerView;
|
|
73
|
+
/** Supprime un serveur sans clé ; un serveur qui a encore une clé est refusé. */
|
|
74
|
+
remove(id: string): void;
|
|
73
75
|
/** Génère une nouvelle paire pour un serveur dont la clé a été révoquée. */
|
|
74
76
|
installNewKey(id: string): DeployServerView;
|
|
75
77
|
/** Remplace la paire de clés ; la limite d'adresse suit la ligne écrite sur le serveur. */
|
|
@@ -3,7 +3,7 @@ import fs from "fs";
|
|
|
3
3
|
import path from "path";
|
|
4
4
|
import ssh2 from "ssh2";
|
|
5
5
|
import { DeployServersFileSchema, } from "../../shared/schemas/deploy.schema.js";
|
|
6
|
-
import { NotFoundError, TrackerError } from "./errors.js";
|
|
6
|
+
import { ConflictError, NotFoundError, TrackerError } from "./errors.js";
|
|
7
7
|
import { AuthRefusedError, connectSsh, execScript } from "./ssh.js";
|
|
8
8
|
import { decryptSecret, encryptSecret } from "./vault.js";
|
|
9
9
|
/** Fichier de clés propre au tracker, relatif au dossier personnel de l'utilisateur distant. */
|
|
@@ -455,6 +455,15 @@ export class DeployServerStore {
|
|
|
455
455
|
return toPublic(server);
|
|
456
456
|
}));
|
|
457
457
|
}
|
|
458
|
+
/** Supprime un serveur sans clé ; un serveur qui a encore une clé est refusé. */
|
|
459
|
+
remove(id) {
|
|
460
|
+
this.mutate((servers) => {
|
|
461
|
+
const server = this.find(servers, id);
|
|
462
|
+
if (server.publicKey)
|
|
463
|
+
throw new ConflictError(`${server.name} a encore une clé : révoquez-la avant de supprimer le serveur.`);
|
|
464
|
+
servers.splice(servers.indexOf(server), 1);
|
|
465
|
+
});
|
|
466
|
+
}
|
|
458
467
|
/** Génère une nouvelle paire pour un serveur dont la clé a été révoquée. */
|
|
459
468
|
installNewKey(id) {
|
|
460
469
|
const server = this.get(id);
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type Deployment, type DeploymentSummary, type RepoDeployResponse } from "../../shared/schemas/deploy.schema.js";
|
|
1
|
+
import { type Deployment, type DeploymentSummary, type DeployServerListItem, type RepoDeployResponse } from "../../shared/schemas/deploy.schema.js";
|
|
2
2
|
import type { GitHubConfig } from "./config.js";
|
|
3
3
|
import type { DeployServerStore } from "./deploy-servers.js";
|
|
4
4
|
import { type Store } from "./store.js";
|
|
@@ -78,6 +78,10 @@ export declare class Deployer {
|
|
|
78
78
|
deployToken: () => string | null);
|
|
79
79
|
/** Serveur, script, déploiement en cours et derniers déploiements d'un dépôt. */
|
|
80
80
|
view(repoId: string): RepoDeployResponse;
|
|
81
|
+
/** Serveurs enregistrés, chacun avec le nombre de dépôts qui le choisissent. */
|
|
82
|
+
listServers(): DeployServerListItem[];
|
|
83
|
+
/** Supprime un serveur qu'aucun dépôt ne choisit et sur lequel aucun déploiement ne tourne. */
|
|
84
|
+
removeServer(serverId: string): void;
|
|
81
85
|
setServer(repoId: string, serverId: string | null): RepoDeployResponse;
|
|
82
86
|
saveScript(repoId: string, script: string): RepoDeployResponse;
|
|
83
87
|
/** Refuse une opération sur la clé d'un serveur pendant qu'un déploiement l'utilise. */
|
|
@@ -246,6 +246,23 @@ export class Deployer {
|
|
|
246
246
|
deployments: deployments.map(deploymentSummary),
|
|
247
247
|
};
|
|
248
248
|
}
|
|
249
|
+
/** Serveurs enregistrés, chacun avec le nombre de dépôts qui le choisissent. */
|
|
250
|
+
listServers() {
|
|
251
|
+
const repos = this.store.listRepos();
|
|
252
|
+
return this.servers.list().map((server) => ({
|
|
253
|
+
...this.servers.view(server),
|
|
254
|
+
repoCount: repos.filter((repo) => repo.deployServerId === server.id).length,
|
|
255
|
+
}));
|
|
256
|
+
}
|
|
257
|
+
/** Supprime un serveur qu'aucun dépôt ne choisit et sur lequel aucun déploiement ne tourne. */
|
|
258
|
+
removeServer(serverId) {
|
|
259
|
+
const server = this.servers.get(serverId);
|
|
260
|
+
this.assertServerIdle(server.id);
|
|
261
|
+
const users = this.store.listRepos().filter((repo) => repo.deployServerId === server.id);
|
|
262
|
+
if (users.length > 0)
|
|
263
|
+
throw new ConflictError(`${server.name} is the server of ${users.length} repositor${users.length > 1 ? "ies" : "y"}: choose another server for them before deleting it.`);
|
|
264
|
+
this.servers.remove(server.id);
|
|
265
|
+
}
|
|
249
266
|
setServer(repoId, serverId) {
|
|
250
267
|
if (serverId !== null)
|
|
251
268
|
this.servers.get(serverId);
|
|
@@ -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/dist/src/server/app.js
CHANGED
|
@@ -225,9 +225,13 @@ export function createApp(ctx) {
|
|
|
225
225
|
}));
|
|
226
226
|
app.get("/api/operations/:id", (c) => respond(c, () => ({ operation: store.getOperation(c.req.param("id")) })));
|
|
227
227
|
app.post("/api/operations/:id/cancel", (c) => respond(c, () => ({ operation: cancelOperation(operations, c.req.param("id")) })));
|
|
228
|
-
app.get("/api/deploy-servers", (c) => respond(c, () => ({ servers: deployer.
|
|
228
|
+
app.get("/api/deploy-servers", (c) => respond(c, () => ({ servers: deployer.listServers() })));
|
|
229
229
|
app.post("/api/deploy-servers", (c) => withBody(c, DeployServerBodySchema, (body) => deployer.servers.view(deployer.servers.create(body))));
|
|
230
230
|
app.put("/api/deploy-servers/:id", (c) => withBody(c, DeployServerBodySchema, (body) => deployer.servers.view(deployer.servers.update(c.req.param("id"), body))));
|
|
231
|
+
app.delete("/api/deploy-servers/:id", (c) => respond(c, () => {
|
|
232
|
+
deployer.removeServer(c.req.param("id"));
|
|
233
|
+
return { deleted: true };
|
|
234
|
+
}));
|
|
231
235
|
app.post("/api/deploy-servers/:id/test", (c) => respond(c, () => deployer.servers.test(c.req.param("id"))));
|
|
232
236
|
/** Opération sur la clé d'un serveur, refusée pendant un déploiement qui l'utilise. */
|
|
233
237
|
const withIdleServer = (c, fn) => {
|