@imenam/mcp-dependabot-tracker 1.0.26 → 1.0.28
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 +41 -13
- package/dist/shared/schemas/deploy.schema.d.ts +5 -1
- package/dist/shared/schemas/settings.schema.d.ts +36 -1
- package/dist/shared/schemas/settings.schema.js +22 -1
- package/dist/src/core/config.d.ts +6 -2
- package/dist/src/core/config.js +11 -9
- 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 +22 -3
- package/dist/src/core/deployments.js +46 -4
- package/dist/src/core/github.d.ts +15 -2
- package/dist/src/core/github.js +21 -4
- package/dist/src/core/settings.d.ts +24 -1
- package/dist/src/core/settings.js +64 -8
- package/dist/src/server/app.d.ts +4 -1
- package/dist/src/server/app.js +13 -9
- package/dist/src/server/serve.js +29 -7
- package/gui/dist/assets/{index-FrRzRTkV.js → index-CAOy2g1q.js} +8 -8
- package/gui/dist/assets/{index-o3l3BAZD.css → index-CYU7-6kP.css} +1 -1
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -112,9 +112,18 @@ La commande crée (ou complète) le `.mcp.json` du répertoire courant avec une
|
|
|
112
112
|
|
|
113
113
|
`SERVER_URL` est l'adresse publique du serveur, `APP_URL`. Le mode MCP appelle `<SERVER_URL>/api/agent/…` avec l'en-tête `Authorization: Bearer <token>` : l'adresse doit joindre le serveur sans autre authentification. Sans `SERVER_URL` ou `AGENT_TOKEN`, le mode MCP refuse de démarrer.
|
|
114
114
|
|
|
115
|
-
###
|
|
115
|
+
### Tokens GitHub
|
|
116
116
|
|
|
117
|
-
|
|
117
|
+
Le tracker utilise deux tokens GitHub, saisis dans l'interface (écran Réglages, section « GitHub — accès aux dépôts ») et chiffrés avec `VAULT_KEY` dans `<données>/settings.json`. Chacun est vérifié auprès de GitHub à l'enregistrement : un token refusé n'est pas enregistré, et l'écran affiche ses quatre derniers caractères, son compte et sa date d'expiration. Ils se remplacent sans redémarrer le serveur.
|
|
118
|
+
|
|
119
|
+
- **Token du tracker** — lit les alertes, clone les dépôts, pousse les branches de correction et ouvre les pull requests. Il ne quitte jamais le processus du tracker. Sans lui, le serveur démarre et l'interface fonctionne, mais rien n'est synchronisé, audité ni corrigé : ces actions renvoient vers les Réglages, et le journal le signale au démarrage. Il se remplace, il ne se retire pas.
|
|
120
|
+
- **Token de déploiement** — facultatif, en lecture seule, transmis aux scripts de déploiement pour leur `git pull` (voir [Accès au code des dépôts privés](#le-déploiement)).
|
|
121
|
+
|
|
122
|
+
Deux tokens plutôt qu'un : le token de déploiement voyage jusqu'aux serveurs cibles, où les scripts d'installation des paquets peuvent le lire ; il ne doit donc rien permettre de plus que lire du code déjà présent sur ces serveurs. Le token du tracker, qui écrit sur les dépôts, reste dans le tracker.
|
|
123
|
+
|
|
124
|
+
**Reprise de `GITHUB_TOKEN`** — tant que les réglages n'ont pas de token du tracker, une variable `GITHUB_TOKEN` présente dans l'environnement est reprise au démarrage : vérifiée auprès de GitHub (un refus est signalé dans le journal, le token est repris quand même), chiffrée, puis enregistrée dans les réglages. Ensuite, c'est le token des réglages qui compte : une variable `GITHUB_TOKEN` encore présente est ignorée, avec un avertissement dans le journal. Retirez-la de l'environnement une fois reprise.
|
|
125
|
+
|
|
126
|
+
Le token du tracker est un token à grain fin, limité aux dépôts suivis, avec les permissions :
|
|
118
127
|
|
|
119
128
|
| Permission | Accès | Pour |
|
|
120
129
|
|---|---|---|
|
|
@@ -123,7 +132,7 @@ Un token à grain fin, limité aux dépôts suivis, avec les permissions :
|
|
|
123
132
|
| Pull requests | lecture et écriture | ouvrir la pull request, suivre celles qui attendent d'être mergées |
|
|
124
133
|
| Metadata | lecture | imposée par GitHub ; liste les dépôts proposés à l'ajout |
|
|
125
134
|
|
|
126
|
-
Un token classique convient aussi, avec
|
|
135
|
+
Un token classique convient aussi, avec le scope `repo` (qui comprend `security_events`), mais il ouvre tous vos dépôts, organisations comprises. 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 du serveur que ses variables système (`PATH`, `HOME`, langue, dossiers temporaires, proxy et certificats) : ni les tokens GitHub, ni `VAULT_KEY`, ni `AUTH_SECRET`, ni aucune autre variable du service.
|
|
127
136
|
|
|
128
137
|
### Variables d'environnement du serveur
|
|
129
138
|
|
|
@@ -131,7 +140,7 @@ Elles se renseignent dans l'environnement du service, ou dans un fichier `.env`
|
|
|
131
140
|
|
|
132
141
|
| Variable | Rôle |
|
|
133
142
|
|---|---|
|
|
134
|
-
| `GITHUB_TOKEN` |
|
|
143
|
+
| `GITHUB_TOKEN` | Facultatif. Repris au premier démarrage comme token du tracker, puis ignoré : le token se règle dans l'interface (voir [Tokens GitHub](#tokens-github)). |
|
|
135
144
|
| `DATA_DIR` | **Obligatoire, sans défaut.** Répertoire des données : comptes, sessions, tokens, scripts de déploiement, et clones des opérations dans `<DATA_DIR>/clones`. Il est créé s'il n'existe pas ; hors de Windows, le serveur le réserve à son compte (droits `700`) à chaque démarrage, et ses fichiers sont écrits en `600`. Requis par les modes `serve` et `user` ; le mode `mcp` ne stocke rien. |
|
|
136
145
|
| `VAULT_KEY` | **Obligatoire.** 32 octets en base64 (`--generate-vault-key`), qui chiffrent en AES-256-GCM les clés privées des serveurs de déploiement et les tokens de l'organizer et de Claude. Sans elle, ou si elle ne déchiffre pas les clés et les tokens déjà enregistrés, le serveur refuse de démarrer. La perdre oblige à reconnecter chaque serveur et à ressaisir les deux tokens. |
|
|
137
146
|
| `APP_PORT` | **Obligatoire.** Port d'écoute du serveur. |
|
|
@@ -229,12 +238,14 @@ Une tâche introuvable, sans le tag ou non assignée au propriétaire fait écho
|
|
|
229
238
|
|
|
230
239
|
**Réglages** (écran Réglages, roue dentée de l'accueil) :
|
|
231
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)).
|
|
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.
|
|
232
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.
|
|
233
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.
|
|
234
245
|
- **Corrections par Claude** — les limites d'une session.
|
|
235
246
|
- **Accès des agents** — les tokens d'agent, un par ligne : nom, quatre derniers caractères, date de création et de dernière utilisation ; « Révoquer », au survol (en permanence sur un écran tactile), le révoque après un second clic de confirmation dans les 4 secondes. « Nouveau token » ouvre un champ en place pour le nommer (Entrée crée, Échap annule) ; le token s'affiche alors une seule fois, avec « Copier » et la commande `--claude-setup-mcp` qui déclare le mode MCP. Créer ou révoquer un token prend effet aussitôt, sans « Enregistrer ».
|
|
236
247
|
|
|
237
|
-
Les tokens de l'organizer et de Claude sont enregistrés dans `<données>/settings.json`, chiffrés avec `VAULT_KEY` (un fichier écrit en clair par une version antérieure est chiffré au démarrage), ceux des agents par leur empreinte dans `<données>/agent-tokens.json`, lisibles par le seul compte du serveur ; la GUI n'en reçoit que les quatre derniers caractères. Claude Code garde sa configuration dans `<données>/claude`. L'écran est protégé comme le reste de l'interface, par la session de l'utilisateur.
|
|
248
|
+
Les tokens GitHub, de l'organizer et de Claude sont enregistrés dans `<données>/settings.json`, chiffrés avec `VAULT_KEY` (un fichier écrit en clair par une version antérieure est chiffré au démarrage), ceux des agents par leur empreinte dans `<données>/agent-tokens.json`, lisibles par le seul compte du serveur ; la GUI n'en reçoit que les quatre derniers caractères. Claude Code garde sa configuration dans `<données>/claude`. L'écran est protégé comme le reste de l'interface, par la session de l'utilisateur.
|
|
238
249
|
|
|
239
250
|
**Suivi** — la tâche du dernier rapport de Claude s'affiche dans la colonne « Suivi » de la ligne du dépôt (« MNT-12 », qui ouvre la tâche sur l'organizer) tant qu'elle n'est pas terminée : son statut est relu sur l'organizer avec les alertes, toutes les 10 minutes. La pull request de la correction mentionne la clé de la tâche.
|
|
240
251
|
|
|
@@ -244,24 +255,40 @@ Les tokens de l'organizer et de Claude sont enregistrés dans `<données>/settin
|
|
|
244
255
|
|
|
245
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).
|
|
246
257
|
|
|
247
|
-
**
|
|
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é.
|
|
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 :
|
|
248
263
|
|
|
249
|
-
1. **Serveur** — nom, hôte, port et utilisateur. « Générer la clé » enregistre le serveur avec sa propre paire ed25519 (`dependabot-tracker@<serveur>`)
|
|
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.
|
|
250
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.
|
|
251
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`.
|
|
252
267
|
|
|
253
|
-
|
|
268
|
+
Modifier l'hôte ou le port d'un serveur oublie son empreinte et son test.
|
|
254
269
|
|
|
255
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).
|
|
256
271
|
|
|
257
|
-
**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.
|
|
258
273
|
|
|
259
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.
|
|
260
275
|
|
|
261
|
-
**Script** — en bash, édité dans l'interface avec coloration syntaxique (la palette « sobre » de SSH Gate), numéros de ligne et ligne du curseur surlignée ; Tab indente, Ctrl+S enregistre, Échap annule. Le tracker définit trois variables : `$BRANCH` (la branche analysée du dépôt), `$COMMIT` (son dernier commit sur GitHub, lu au lancement) et `$REPO` (`propriétaire/nom`).
|
|
276
|
+
**Script** — en bash, édité dans l'interface avec coloration syntaxique (la palette « sobre » de SSH Gate), numéros de ligne et ligne du curseur surlignée ; Tab indente, Ctrl+S enregistre, Échap annule. Le tracker définit trois variables : `$BRANCH` (la branche analysée du dépôt), `$COMMIT` (son dernier commit sur GitHub, lu au lancement) et `$REPO` (`propriétaire/nom`). Avec un token de déploiement réglé, il définit aussi les variables qui authentifient `git` (voir ci-dessous).
|
|
262
277
|
|
|
263
278
|
**Déploiement** — « Déployer », actif quand le serveur est testé et le script écrit, lance le script sur le serveur et le suit en direct. Le script est copié dans un dossier temporaire du serveur (`mktemp -d`, supprimé à la fin), puis exécuté avec bash depuis le dossier personnel, l'entrée venant de `/dev/null` ; sa sortie (stdout et stderr) s'affiche au fil de l'eau, et sa ligne en cours est lue dans la trace de bash (`set -x`, sur un descripteur à part : la sortie n'en contient rien). Un déploiement réussi (code 0) retire la marque « à déployer » du dépôt ; un échec donne le code de sortie et la ligne du script en cours. « Interrompre » envoie SIGTERM à tout le groupe de processus du script, puis ferme la connexion. Un seul déploiement à la fois par dépôt ; le retrait d'un dépôt est refusé pendant un déploiement. Un déploiement que l'arrêt du serveur a interrompu passe en échec au démarrage suivant. Les 20 derniers déploiements de chaque dépôt sont conservés, avec le script lancé et la sortie (ses 200 000 derniers caractères).
|
|
264
279
|
|
|
280
|
+
**Accès au code des dépôts privés** — le `git pull` d'un script de déploiement doit s'authentifier auprès de GitHub pour un dépôt privé ; lancé par le tracker, il n'a ni terminal ni assistant d'identifiants (celui de VS Code n'existe que dans ses sessions). Le tracker lui fournit un **token de déploiement**, réglé une fois dans les Réglages : un token à grain fin en **lecture seule** (permission *Contents* : *Read-only*, *Metadata* imposée), limité aux dépôts déployés (*Only select repositories*). Un dépôt s'y ajoute en modifiant le token sur GitHub : sa valeur ne change pas, rien n'est à refaire. Ce n'est jamais le token du tracker, qui écrit sur les dépôts et ne quitte pas le processus du tracker.
|
|
281
|
+
|
|
282
|
+
À chaque déploiement, le tracker relit le token et l'exporte dans l'environnement du script sous forme de réglage git (`GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_0` = `http.<serveur GitHub>/.extraheader`, `GIT_CONFIG_VALUE_0` = en-tête `AUTHORIZATION`), avec `GIT_TERMINAL_PROMPT=0` : un simple `git pull` sur un remote https s'authentifie sans autre réglage, et un échec d'authentification est immédiat. Ces variables sont exportées avant le début de la trace de bash : le token n'apparaît ni dans la trace, ni dans le script enregistré. Rien n'est écrit sur le serveur cible : ni token, ni `~/.git-credentials`, ni configuration git, et les sessions VS Code ne sont pas touchées.
|
|
283
|
+
|
|
284
|
+
Tout processus lancé par le script hérite de ces variables, `npm ci` compris : retirez-les juste après le `git pull`, pour ne pas les transmettre aux commandes suivantes. Ce n'est pas une barrière étanche : l'environnement de départ du script reste lisible dans `/proc/<pid>/environ`, et du code qui tourne en root lit tout le serveur. La sécurité repose sur les droits du token : en lecture seule, limité à des dépôts dont le code est déjà sur le serveur cible, un token volé n'ouvre rien de plus.
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
git pull
|
|
288
|
+
unset GIT_CONFIG_COUNT GIT_CONFIG_KEY_0 GIT_CONFIG_VALUE_0
|
|
289
|
+
npm ci
|
|
290
|
+
```
|
|
291
|
+
|
|
265
292
|
Le déploiement se pilote depuis l'interface seulement : les outils de l'agent n'y ont pas accès.
|
|
266
293
|
|
|
267
294
|
---
|
|
@@ -285,9 +312,9 @@ Thème sombre, une information par ligne, une action principale par écran.
|
|
|
285
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.
|
|
286
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.
|
|
287
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.
|
|
288
|
-
- **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.
|
|
289
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é.
|
|
290
|
-
- **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.
|
|
291
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.
|
|
292
319
|
|
|
293
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.
|
|
@@ -328,8 +355,9 @@ Un point d'entrée, `src/index.ts`, et deux modes :
|
|
|
328
355
|
| `POST /api/settings/organizer/test` | Reteste la connexion enregistrée à l'organizer. |
|
|
329
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. |
|
|
330
357
|
| `DELETE /api/agent-tokens/:id` | Révoque un token. |
|
|
331
|
-
| `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. |
|
|
332
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). |
|
|
333
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é. |
|
|
334
362
|
| `POST /api/deploy-servers/:id/key` | Nouvelle paire de clés pour un serveur dont la clé a été révoquée. |
|
|
335
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
|
|
@@ -15,6 +15,17 @@ export declare const AnalysisSettingsSchema: z.ZodObject<{
|
|
|
15
15
|
maxMinutes: z.ZodNumber;
|
|
16
16
|
}, z.core.$strip>;
|
|
17
17
|
export type AnalysisSettings = z.infer<typeof AnalysisSettingsSchema>;
|
|
18
|
+
/**
|
|
19
|
+
* Token GitHub enregistré : `savedAt` est sa date d'enregistrement, `login` le
|
|
20
|
+
* compte et `expiresAt` la date d'expiration relevés par GitHub à sa
|
|
21
|
+
* vérification (null pour un token sans expiration ou pas encore vérifié).
|
|
22
|
+
*/
|
|
23
|
+
export declare const GitHubTokenSettingsSchema: z.ZodObject<{
|
|
24
|
+
token: z.ZodNullable<z.ZodString>;
|
|
25
|
+
savedAt: z.ZodNullable<z.ZodString>;
|
|
26
|
+
login: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
27
|
+
expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
28
|
+
}, z.core.$strip>;
|
|
18
29
|
/**
|
|
19
30
|
* Réglages enregistrés dans `<données>/settings.json`. `organizer.space` et
|
|
20
31
|
* `organizer.owner` sont l'espace du token et son propriétaire, relevés au
|
|
@@ -36,9 +47,28 @@ export declare const SettingsSchema: z.ZodObject<{
|
|
|
36
47
|
maxTurns: z.ZodNumber;
|
|
37
48
|
maxMinutes: z.ZodNumber;
|
|
38
49
|
}, z.core.$strip>;
|
|
50
|
+
github: z.ZodDefault<z.ZodObject<{
|
|
51
|
+
token: z.ZodNullable<z.ZodString>;
|
|
52
|
+
savedAt: z.ZodNullable<z.ZodString>;
|
|
53
|
+
login: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
54
|
+
expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
55
|
+
}, z.core.$strip>>;
|
|
56
|
+
deploy: z.ZodDefault<z.ZodObject<{
|
|
57
|
+
token: z.ZodNullable<z.ZodString>;
|
|
58
|
+
savedAt: z.ZodNullable<z.ZodString>;
|
|
59
|
+
login: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
60
|
+
expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
|
|
61
|
+
}, z.core.$strip>>;
|
|
39
62
|
}, z.core.$strip>;
|
|
40
63
|
export type Settings = z.infer<typeof SettingsSchema>;
|
|
41
64
|
export declare const DEFAULT_SETTINGS: Settings;
|
|
65
|
+
/** Token GitHub tel que la GUI le reçoit : ses quatre derniers caractères, jamais sa valeur. */
|
|
66
|
+
export interface GitHubTokenView {
|
|
67
|
+
tokenHint: string | null;
|
|
68
|
+
savedAt: string | null;
|
|
69
|
+
login: string | null;
|
|
70
|
+
expiresAt: string | null;
|
|
71
|
+
}
|
|
42
72
|
/**
|
|
43
73
|
* Réglages tels que la GUI les reçoit : les tokens n'y figurent que par leurs
|
|
44
74
|
* quatre derniers caractères. `ready` est vrai quand l'organizer et Claude sont
|
|
@@ -58,15 +88,20 @@ export interface SettingsView {
|
|
|
58
88
|
};
|
|
59
89
|
analysis: AnalysisSettings;
|
|
60
90
|
ready: boolean;
|
|
91
|
+
github: GitHubTokenView;
|
|
92
|
+
deploy: GitHubTokenView;
|
|
61
93
|
}
|
|
62
94
|
/**
|
|
63
95
|
* Corps de `PUT /api/settings`. Un token absent garde la valeur enregistrée ;
|
|
64
|
-
* une adresse vide retire la connexion à l'organizer
|
|
96
|
+
* une adresse vide retire la connexion à l'organizer, `deployToken: null` retire
|
|
97
|
+
* le token de déploiement. Le token du tracker se remplace, il ne se retire pas.
|
|
65
98
|
*/
|
|
66
99
|
export declare const SaveSettingsBodySchema: z.ZodObject<{
|
|
67
100
|
organizerUrl: z.ZodString;
|
|
68
101
|
organizerToken: z.ZodOptional<z.ZodString>;
|
|
69
102
|
claudeToken: z.ZodOptional<z.ZodString>;
|
|
103
|
+
githubToken: z.ZodOptional<z.ZodString>;
|
|
104
|
+
deployToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
70
105
|
analysis: z.ZodObject<{
|
|
71
106
|
maxTurns: z.ZodNumber;
|
|
72
107
|
maxMinutes: z.ZodNumber;
|
|
@@ -5,6 +5,18 @@ export const AnalysisSettingsSchema = z.object({
|
|
|
5
5
|
maxTurns: z.number().int().min(ANALYSIS_LIMITS.maxTurns.min).max(ANALYSIS_LIMITS.maxTurns.max),
|
|
6
6
|
maxMinutes: z.number().int().min(ANALYSIS_LIMITS.maxMinutes.min).max(ANALYSIS_LIMITS.maxMinutes.max),
|
|
7
7
|
});
|
|
8
|
+
/**
|
|
9
|
+
* Token GitHub enregistré : `savedAt` est sa date d'enregistrement, `login` le
|
|
10
|
+
* compte et `expiresAt` la date d'expiration relevés par GitHub à sa
|
|
11
|
+
* vérification (null pour un token sans expiration ou pas encore vérifié).
|
|
12
|
+
*/
|
|
13
|
+
export const GitHubTokenSettingsSchema = z.object({
|
|
14
|
+
token: z.string().nullable(),
|
|
15
|
+
savedAt: z.string().nullable(),
|
|
16
|
+
login: z.string().nullable().default(null),
|
|
17
|
+
expiresAt: z.string().nullable().default(null),
|
|
18
|
+
});
|
|
19
|
+
const NO_TOKEN = { token: null, savedAt: null, login: null, expiresAt: null };
|
|
8
20
|
/**
|
|
9
21
|
* Réglages enregistrés dans `<données>/settings.json`. `organizer.space` et
|
|
10
22
|
* `organizer.owner` sont l'espace du token et son propriétaire, relevés au
|
|
@@ -23,19 +35,28 @@ export const SettingsSchema = z.object({
|
|
|
23
35
|
savedAt: z.string().nullable(),
|
|
24
36
|
}),
|
|
25
37
|
analysis: AnalysisSettingsSchema,
|
|
38
|
+
/** Token du tracker : alertes, clones, branches de correction, pull requests. */
|
|
39
|
+
github: GitHubTokenSettingsSchema.default(NO_TOKEN),
|
|
40
|
+
/** Token en lecture seule transmis aux scripts de déploiement, pour leur `git pull`. */
|
|
41
|
+
deploy: GitHubTokenSettingsSchema.default(NO_TOKEN),
|
|
26
42
|
});
|
|
27
43
|
export const DEFAULT_SETTINGS = {
|
|
28
44
|
organizer: { url: null, token: null, space: null, owner: null },
|
|
29
45
|
claude: { token: null, savedAt: null },
|
|
30
46
|
analysis: { maxTurns: 40, maxMinutes: 15 },
|
|
47
|
+
github: NO_TOKEN,
|
|
48
|
+
deploy: NO_TOKEN,
|
|
31
49
|
};
|
|
32
50
|
/**
|
|
33
51
|
* Corps de `PUT /api/settings`. Un token absent garde la valeur enregistrée ;
|
|
34
|
-
* une adresse vide retire la connexion à l'organizer
|
|
52
|
+
* une adresse vide retire la connexion à l'organizer, `deployToken: null` retire
|
|
53
|
+
* le token de déploiement. Le token du tracker se remplace, il ne se retire pas.
|
|
35
54
|
*/
|
|
36
55
|
export const SaveSettingsBodySchema = z.object({
|
|
37
56
|
organizerUrl: z.string().trim(),
|
|
38
57
|
organizerToken: z.string().trim().min(1).optional(),
|
|
39
58
|
claudeToken: z.string().trim().min(1).optional(),
|
|
59
|
+
githubToken: z.string().trim().min(1).optional(),
|
|
60
|
+
deployToken: z.string().trim().min(1).nullable().optional(),
|
|
40
61
|
analysis: AnalysisSettingsSchema,
|
|
41
62
|
});
|
|
@@ -9,5 +9,9 @@ export interface GitHubConfig {
|
|
|
9
9
|
apiUrl: string;
|
|
10
10
|
serverUrl: string;
|
|
11
11
|
}
|
|
12
|
-
/**
|
|
13
|
-
export
|
|
12
|
+
/** Adresses du serveur GitHub, sans le token. */
|
|
13
|
+
export type GitHubServers = Omit<GitHubConfig, "token">;
|
|
14
|
+
/** Adresses de l'API et du serveur GitHub lues dans l'environnement, github.com par défaut. */
|
|
15
|
+
export declare function readGitHubServers(env?: NodeJS.ProcessEnv): GitHubServers;
|
|
16
|
+
/** Configuration GitHub avec le token du tracker ; lève une erreur qui renvoie aux réglages sans token. */
|
|
17
|
+
export declare function gitHubConfig(servers: GitHubServers, token: string | null): GitHubConfig;
|
package/dist/src/core/config.js
CHANGED
|
@@ -1,15 +1,17 @@
|
|
|
1
1
|
import { TrackerError } from "./errors.js";
|
|
2
2
|
const DEFAULT_API_URL = "https://api.github.com";
|
|
3
3
|
const DEFAULT_SERVER_URL = "https://github.com";
|
|
4
|
-
/**
|
|
5
|
-
export function
|
|
6
|
-
const token = process.env.GITHUB_TOKEN?.trim();
|
|
7
|
-
if (!token) {
|
|
8
|
-
throw new TrackerError("GITHUB_TOKEN is not set: declare a GitHub token in the environment of the server (Dependabot alerts: read, Contents: read and write, Pull requests: read and write).");
|
|
9
|
-
}
|
|
4
|
+
/** Adresses de l'API et du serveur GitHub lues dans l'environnement, github.com par défaut. */
|
|
5
|
+
export function readGitHubServers(env = process.env) {
|
|
10
6
|
return {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
serverUrl: (process.env.GITHUB_SERVER_URL?.trim() || DEFAULT_SERVER_URL).replace(/\/+$/, ""),
|
|
7
|
+
apiUrl: (env.GITHUB_API_URL?.trim() || DEFAULT_API_URL).replace(/\/+$/, ""),
|
|
8
|
+
serverUrl: (env.GITHUB_SERVER_URL?.trim() || DEFAULT_SERVER_URL).replace(/\/+$/, ""),
|
|
14
9
|
};
|
|
15
10
|
}
|
|
11
|
+
/** Configuration GitHub avec le token du tracker ; lève une erreur qui renvoie aux réglages sans token. */
|
|
12
|
+
export function gitHubConfig(servers, token) {
|
|
13
|
+
if (!token) {
|
|
14
|
+
throw new TrackerError("The GitHub token of the tracker is not set: enter it in the settings (Réglages › GitHub), with Dependabot alerts: read, Contents and Pull requests: read and write.");
|
|
15
|
+
}
|
|
16
|
+
return { ...servers, token };
|
|
17
|
+
}
|
|
@@ -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";
|
|
@@ -13,6 +13,12 @@ export declare const OUTPUT_LIMIT = 200000;
|
|
|
13
13
|
* stderr, sert à interrompre tout le groupe.
|
|
14
14
|
*/
|
|
15
15
|
export declare function remoteWrapper(script: string, variables: Record<string, string>): string;
|
|
16
|
+
/**
|
|
17
|
+
* Variables qui authentifient `git` auprès du serveur GitHub `serverUrl` par un
|
|
18
|
+
* en-tête HTTP, avec le token de déploiement ; aucune sans token. `git` ne pose
|
|
19
|
+
* alors aucune question : un échec d'authentification est immédiat.
|
|
20
|
+
*/
|
|
21
|
+
export declare function deployGitVariables(serverUrl: string, token: string | null): Record<string, string>;
|
|
16
22
|
/** Lit la trace de bash ligne à ligne et rend la dernière ligne du script commencée. */
|
|
17
23
|
export declare class TraceReader {
|
|
18
24
|
private readonly onLine;
|
|
@@ -51,18 +57,31 @@ export declare class DeploymentStore {
|
|
|
51
57
|
/**
|
|
52
58
|
* Déploiement des dépôts : chaque dépôt choisit un serveur et un script ; un
|
|
53
59
|
* déploiement exécute ce script sur le serveur, par SSH, et en suit la ligne en
|
|
54
|
-
* cours et la sortie.
|
|
60
|
+
* cours et la sortie. Le script reçoit BRANCH, COMMIT et REPO, et, quand un
|
|
61
|
+
* token de déploiement est réglé, les variables qui authentifient `git` auprès
|
|
62
|
+
* de GitHub. Un déploiement réussi retire la marque « à déployer ».
|
|
55
63
|
*/
|
|
56
64
|
export declare class Deployer {
|
|
57
65
|
private readonly store;
|
|
58
66
|
readonly servers: DeployServerStore;
|
|
59
67
|
readonly deployments: DeploymentStore;
|
|
68
|
+
/** Configuration GitHub, avec le token du tracker ; lève une erreur sans token. */
|
|
60
69
|
private readonly github;
|
|
61
70
|
private readonly logError;
|
|
71
|
+
/** Token de déploiement, relu à chaque déploiement ; null sans token réglé. */
|
|
72
|
+
private readonly deployToken;
|
|
62
73
|
private readonly running;
|
|
63
|
-
constructor(store: Store, servers: DeployServerStore, deployments: DeploymentStore,
|
|
74
|
+
constructor(store: Store, servers: DeployServerStore, deployments: DeploymentStore,
|
|
75
|
+
/** Configuration GitHub, avec le token du tracker ; lève une erreur sans token. */
|
|
76
|
+
github: () => GitHubConfig, logError: (message: string) => void,
|
|
77
|
+
/** Token de déploiement, relu à chaque déploiement ; null sans token réglé. */
|
|
78
|
+
deployToken: () => string | null);
|
|
64
79
|
/** Serveur, script, déploiement en cours et derniers déploiements d'un dépôt. */
|
|
65
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;
|
|
66
85
|
setServer(repoId: string, serverId: string | null): RepoDeployResponse;
|
|
67
86
|
saveScript(repoId: string, script: string): RepoDeployResponse;
|
|
68
87
|
/** Refuse une opération sur la clé d'un serveur pendant qu'un déploiement l'utilise. */
|
|
@@ -68,6 +68,22 @@ export function remoteWrapper(script, variables) {
|
|
|
68
68
|
``,
|
|
69
69
|
].join("\n");
|
|
70
70
|
}
|
|
71
|
+
/**
|
|
72
|
+
* Variables qui authentifient `git` auprès du serveur GitHub `serverUrl` par un
|
|
73
|
+
* en-tête HTTP, avec le token de déploiement ; aucune sans token. `git` ne pose
|
|
74
|
+
* alors aucune question : un échec d'authentification est immédiat.
|
|
75
|
+
*/
|
|
76
|
+
export function deployGitVariables(serverUrl, token) {
|
|
77
|
+
if (token === null)
|
|
78
|
+
return {};
|
|
79
|
+
const basic = Buffer.from(`x-access-token:${token}`).toString("base64");
|
|
80
|
+
return {
|
|
81
|
+
GIT_TERMINAL_PROMPT: "0",
|
|
82
|
+
GIT_CONFIG_COUNT: "1",
|
|
83
|
+
GIT_CONFIG_KEY_0: `http.${serverUrl}/.extraheader`,
|
|
84
|
+
GIT_CONFIG_VALUE_0: `AUTHORIZATION: basic ${basic}`,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
71
87
|
/** Lit la trace de bash ligne à ligne et rend la dernière ligne du script commencée. */
|
|
72
88
|
export class TraceReader {
|
|
73
89
|
onLine;
|
|
@@ -195,7 +211,9 @@ export class DeploymentStore {
|
|
|
195
211
|
/**
|
|
196
212
|
* Déploiement des dépôts : chaque dépôt choisit un serveur et un script ; un
|
|
197
213
|
* déploiement exécute ce script sur le serveur, par SSH, et en suit la ligne en
|
|
198
|
-
* cours et la sortie.
|
|
214
|
+
* cours et la sortie. Le script reçoit BRANCH, COMMIT et REPO, et, quand un
|
|
215
|
+
* token de déploiement est réglé, les variables qui authentifient `git` auprès
|
|
216
|
+
* de GitHub. Un déploiement réussi retire la marque « à déployer ».
|
|
199
217
|
*/
|
|
200
218
|
export class Deployer {
|
|
201
219
|
store;
|
|
@@ -203,13 +221,19 @@ export class Deployer {
|
|
|
203
221
|
deployments;
|
|
204
222
|
github;
|
|
205
223
|
logError;
|
|
224
|
+
deployToken;
|
|
206
225
|
running = new Map();
|
|
207
|
-
constructor(store, servers, deployments,
|
|
226
|
+
constructor(store, servers, deployments,
|
|
227
|
+
/** Configuration GitHub, avec le token du tracker ; lève une erreur sans token. */
|
|
228
|
+
github, logError,
|
|
229
|
+
/** Token de déploiement, relu à chaque déploiement ; null sans token réglé. */
|
|
230
|
+
deployToken) {
|
|
208
231
|
this.store = store;
|
|
209
232
|
this.servers = servers;
|
|
210
233
|
this.deployments = deployments;
|
|
211
234
|
this.github = github;
|
|
212
235
|
this.logError = logError;
|
|
236
|
+
this.deployToken = deployToken;
|
|
213
237
|
}
|
|
214
238
|
/** Serveur, script, déploiement en cours et derniers déploiements d'un dépôt. */
|
|
215
239
|
view(repoId) {
|
|
@@ -222,6 +246,23 @@ export class Deployer {
|
|
|
222
246
|
deployments: deployments.map(deploymentSummary),
|
|
223
247
|
};
|
|
224
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
|
+
}
|
|
225
266
|
setServer(repoId, serverId) {
|
|
226
267
|
if (serverId !== null)
|
|
227
268
|
this.servers.get(serverId);
|
|
@@ -257,7 +298,7 @@ export class Deployer {
|
|
|
257
298
|
throw new ConflictError(`The connection to ${server.name} has not been tested: test it before deploying.`);
|
|
258
299
|
if (this.deployments.active(repo.id))
|
|
259
300
|
throw new ConflictError(`A deployment is already running on ${repo.id}: wait for it to finish or interrupt it.`);
|
|
260
|
-
const commit = await new GitHubClient(this.github).getBranchCommit(repo.owner, repo.name, repo.branch);
|
|
301
|
+
const commit = await new GitHubClient(this.github()).getBranchCommit(repo.owner, repo.name, repo.branch);
|
|
261
302
|
const now = new Date().toISOString();
|
|
262
303
|
const deployment = this.deployments.create({
|
|
263
304
|
id: `dep-${Date.now().toString(36)}-${crypto.randomBytes(3).toString("hex")}`,
|
|
@@ -365,7 +406,8 @@ export class Deployer {
|
|
|
365
406
|
let code = null;
|
|
366
407
|
channel.on("exit", (exit) => (code = typeof exit === "number" ? exit : null));
|
|
367
408
|
channel.on("close", () => resolve(code));
|
|
368
|
-
|
|
409
|
+
const variables = { BRANCH: initial.branch, COMMIT: initial.commit ?? "", REPO: initial.repoId, ...deployGitVariables(this.github().serverUrl, this.deployToken()) };
|
|
410
|
+
channel.end(remoteWrapper(initial.script, variables));
|
|
369
411
|
});
|
|
370
412
|
append(stdout.end());
|
|
371
413
|
trace.push(`${stderr.end()}\n`);
|
|
@@ -14,6 +14,13 @@ export interface GitHubUser {
|
|
|
14
14
|
id: number;
|
|
15
15
|
name: string | null;
|
|
16
16
|
}
|
|
17
|
+
/** Compte d'un token et sa date d'expiration (ISO), null pour un token sans expiration. */
|
|
18
|
+
export interface TokenCheck {
|
|
19
|
+
login: string;
|
|
20
|
+
expiresAt: string | null;
|
|
21
|
+
}
|
|
22
|
+
/** Date d'expiration d'un token telle que GitHub l'envoie (`2026-12-14 14:31:47 UTC`), en ISO. */
|
|
23
|
+
export declare function tokenExpiration(header: string | null): string | null;
|
|
17
24
|
/** Pull request créée ; `createdAt` est sa date d'ouverture. */
|
|
18
25
|
export interface CreatedPullRequest {
|
|
19
26
|
number: number;
|
|
@@ -30,10 +37,14 @@ export interface OpenPullRequest {
|
|
|
30
37
|
}
|
|
31
38
|
/** URL de la page suivante dans un en-tête `Link` de pagination, ou null. */
|
|
32
39
|
export declare function nextPageUrl(link: string | null): string | null;
|
|
33
|
-
/**
|
|
40
|
+
/**
|
|
41
|
+
* Client REST minimal de l'API GitHub, authentifié par le token de la
|
|
42
|
+
* configuration ; `tokenName` désigne ce token dans le message d'un refus.
|
|
43
|
+
*/
|
|
34
44
|
export declare class GitHubClient {
|
|
35
45
|
private readonly config;
|
|
36
|
-
|
|
46
|
+
private readonly tokenName;
|
|
47
|
+
constructor(config: GitHubConfig, tokenName?: string);
|
|
37
48
|
private request;
|
|
38
49
|
getRepository(owner: string, name: string): Promise<GitHubRepository>;
|
|
39
50
|
/** Alertes Dependabot ouvertes du dépôt, toutes pages comprises. */
|
|
@@ -44,6 +55,8 @@ export declare class GitHubClient {
|
|
|
44
55
|
listBranches(owner: string, name: string): Promise<string[]>;
|
|
45
56
|
/** SHA du dernier commit de `branch`. */
|
|
46
57
|
getBranchCommit(owner: string, name: string, branch: string): Promise<string>;
|
|
58
|
+
/** Compte du token et sa date d'expiration ; un token refusé lève une erreur. */
|
|
59
|
+
checkToken(): Promise<TokenCheck>;
|
|
47
60
|
getAuthenticatedUser(): Promise<GitHubUser>;
|
|
48
61
|
/** Pull requests ouvertes du dépôt, toutes pages comprises. */
|
|
49
62
|
listOpenPullRequests(owner: string, name: string): Promise<OpenPullRequest[]>;
|
package/dist/src/core/github.js
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
import { ALERT_SEVERITIES, DEPENDENCY_SCOPES } from "../../shared/schemas/model.schema.js";
|
|
2
2
|
import { NotFoundError, TrackerError } from "./errors.js";
|
|
3
|
+
/** Date d'expiration d'un token telle que GitHub l'envoie (`2026-12-14 14:31:47 UTC`), en ISO. */
|
|
4
|
+
export function tokenExpiration(header) {
|
|
5
|
+
if (!header)
|
|
6
|
+
return null;
|
|
7
|
+
const date = new Date(header.trim().replace(/ UTC$/, "Z").replace(" ", "T"));
|
|
8
|
+
return Number.isNaN(date.getTime()) ? null : date.toISOString();
|
|
9
|
+
}
|
|
3
10
|
const REQUEST_TIMEOUT_MS = 30_000;
|
|
4
11
|
/** Nombre maximal de pages d'alertes lues (100 alertes par page). */
|
|
5
12
|
const MAX_ALERT_PAGES = 20;
|
|
@@ -16,11 +23,16 @@ export function nextPageUrl(link) {
|
|
|
16
23
|
}
|
|
17
24
|
return null;
|
|
18
25
|
}
|
|
19
|
-
/**
|
|
26
|
+
/**
|
|
27
|
+
* Client REST minimal de l'API GitHub, authentifié par le token de la
|
|
28
|
+
* configuration ; `tokenName` désigne ce token dans le message d'un refus.
|
|
29
|
+
*/
|
|
20
30
|
export class GitHubClient {
|
|
21
31
|
config;
|
|
22
|
-
|
|
32
|
+
tokenName;
|
|
33
|
+
constructor(config, tokenName = "GITHUB_TOKEN") {
|
|
23
34
|
this.config = config;
|
|
35
|
+
this.tokenName = tokenName;
|
|
24
36
|
}
|
|
25
37
|
async request(method, url, body) {
|
|
26
38
|
let response;
|
|
@@ -54,10 +66,10 @@ export class GitHubClient {
|
|
|
54
66
|
if (!response.ok) {
|
|
55
67
|
const message = typeof json?.message === "string" ? json.message : `HTTP ${response.status}`;
|
|
56
68
|
if (response.status === 401)
|
|
57
|
-
throw new TrackerError(`GitHub rejected
|
|
69
|
+
throw new TrackerError(`GitHub rejected ${this.tokenName} (401: ${message}).`);
|
|
58
70
|
throw new GitHubApiError(response.status, `GitHub API ${method} ${url} failed (${response.status}): ${message}`);
|
|
59
71
|
}
|
|
60
|
-
return { json, link: response.headers.get("link") };
|
|
72
|
+
return { json, link: response.headers.get("link"), expiration: response.headers.get("github-authentication-token-expiration") };
|
|
61
73
|
}
|
|
62
74
|
async getRepository(owner, name) {
|
|
63
75
|
try {
|
|
@@ -130,6 +142,11 @@ export class GitHubClient {
|
|
|
130
142
|
throw new TrackerError(`GitHub API returned no commit for the branch ${branch} of ${owner}/${name}.`);
|
|
131
143
|
return sha;
|
|
132
144
|
}
|
|
145
|
+
/** Compte du token et sa date d'expiration ; un token refusé lève une erreur. */
|
|
146
|
+
async checkToken() {
|
|
147
|
+
const { json, expiration } = await this.request("GET", "/user");
|
|
148
|
+
return { login: json.login, expiresAt: tokenExpiration(expiration) };
|
|
149
|
+
}
|
|
133
150
|
async getAuthenticatedUser() {
|
|
134
151
|
const { json } = await this.request("GET", "/user");
|
|
135
152
|
return { login: json.login, id: json.id, name: json.name ?? null };
|