@imenam/mcp-dependabot-tracker 1.0.32 → 1.0.34
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 +31 -8
- package/dist/shared/schemas/api.schema.d.ts +12 -1
- package/dist/shared/schemas/api.schema.js +4 -1
- package/dist/shared/schemas/model.schema.d.ts +3 -0
- package/dist/shared/schemas/model.schema.js +2 -0
- package/dist/src/cli/prompt.d.ts +4 -0
- package/dist/src/cli/prompt.js +28 -0
- package/dist/src/cli/setup.d.ts +55 -0
- package/dist/src/cli/setup.js +484 -0
- package/dist/src/cli/users.js +1 -28
- package/dist/src/core/auth.d.ts +2 -0
- package/dist/src/core/auth.js +4 -0
- package/dist/src/core/commands.d.ts +2 -0
- package/dist/src/core/commands.js +1 -1
- package/dist/src/core/repair.d.ts +14 -0
- package/dist/src/core/repair.js +10 -2
- package/dist/src/core/repos.d.ts +6 -0
- package/dist/src/core/repos.js +26 -0
- package/dist/src/core/setup-files.d.ts +48 -0
- package/dist/src/core/setup-files.js +147 -0
- package/dist/src/core/store.js +2 -1
- package/dist/src/index.d.ts +1 -0
- package/dist/src/index.js +12 -0
- package/dist/src/server/app.js +3 -2
- package/dist/src/server/serve.d.ts +2 -0
- package/dist/src/server/serve.js +1 -1
- package/dist/src/tools/format.js +1 -0
- package/gui/dist/assets/{index-CYU7-6kP.css → index-YTYdDo9D.css} +1 -1
- package/gui/dist/assets/index-b-kJ06Dn.js +71 -0
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
- package/gui/dist/assets/index-DrVmedqf.js +0 -71
package/README.md
CHANGED
|
@@ -23,6 +23,28 @@ L'agent fait ce que fait l'utilisateur pour les corrections : il liste les dép
|
|
|
23
23
|
|
|
24
24
|
## Installation
|
|
25
25
|
|
|
26
|
+
### Installation sur un serveur Linux : `setup`
|
|
27
|
+
|
|
28
|
+
Sur une machine Linux avec systemd (Debian, Ubuntu), une seule commande, en root, installe tout le serveur :
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
sudo mcp-dependabot-tracker setup
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Elle pose ses questions, en proposant les valeurs du `.env` existant : adresse publique (`https://…`), port d'écoute sur `127.0.0.1` (4700), compte système du service (`dependabot-tracker`), répertoire des données (`<dossier du compte>/data`), nginx et certificat, premier compte de l'interface (mot de passe saisi sans écho). Elle récapitule, demande confirmation, puis :
|
|
35
|
+
|
|
36
|
+
1. installe les paquets manquants : `git`, `podman`, `uidmap`, `passt`, `slirp4netns`, `catatonit`, `bubblewrap`, `socat`, plus `nginx`, `certbot` et `python3-certbot-nginx` s'ils sont demandés ;
|
|
37
|
+
2. crée le compte système du service, lui attribue une plage de sous-identifiants libre (la suite de toutes celles de `/etc/subuid` et `/etc/subgid`) et active son lingering (`/run/user/<uid>`) ;
|
|
38
|
+
3. écrit le `.env` de la racine du paquet (`DATA_DIR`, `APP_URL`, `APP_PORT`, `TRUSTED_PROXIES`, et `VAULT_KEY` et `AUTH_SECRET`, générés au premier passage puis conservés), lisible par root et le groupe du service seulement ; les autres lignes du fichier sont gardées ;
|
|
39
|
+
4. crée le premier compte de l'interface ;
|
|
40
|
+
5. prépare Podman rootless sous le compte du service (`podman system migrate`) et vérifie qu'il est bien rootless ;
|
|
41
|
+
6. écrit l'unité `/etc/systemd/system/dependabot-tracker.service`, l'active et (re)démarre le service, puis attend que le serveur réponde ;
|
|
42
|
+
7. avec nginx, écrit et active le site `/etc/nginx/sites-available/dependabot-tracker` (proxy vers `127.0.0.1:<port>`), recharge nginx, puis obtient le certificat avec certbot (`--redirect`). Un site nginx déjà activé qui sert la même adresse est gardé tel quel.
|
|
43
|
+
|
|
44
|
+
L'unité garde le durcissement compatible avec Podman rootless et le bac à sable de Claude Code : `ProtectSystem=strict`, `ProtectHome=read-only`, `PrivateTmp`, l'écriture limitée au dossier du compte, aux données et à `/run/user/<uid>`, mais ni `NoNewPrivileges` (`newuidmap` et `newgidmap` sont setuid), ni `RestrictSUIDSGID` (la copie d'une image aux identifiants décalés de `--userns=keep-id` remet les bits setuid et setgid de ses fichiers), ni `RestrictNamespaces`, `PrivateUsers` ou `SystemCallFilter` (bubblewrap).
|
|
45
|
+
|
|
46
|
+
Relancée, la commande reprend la configuration en place : clés, compte de service, plage de sous-identifiants et comptes existants sont gardés, l'unité est réécrite. Sans terminal, ou avec `--non-interactive`, rien n'est demandé : chaque réponse vient d'une option (`--app-url`, `--port`, `--service-user`, `--data-dir`, `--nginx=oui|non`, `--certbot=oui|non`, `--admin-email`, `--admin-name`), sinon du `.env` ou du défaut, et le mot de passe de `SETUP_ADMIN_PASSWORD`. `setup --help` les liste. Il reste ensuite à saisir dans l'interface le token GitHub du tracker, puis le token Claude.
|
|
47
|
+
|
|
26
48
|
### Le serveur
|
|
27
49
|
|
|
28
50
|
```bash
|
|
@@ -41,7 +63,7 @@ sudo loginctl enable-linger "$(whoami)"
|
|
|
41
63
|
podman info --format '{{.Host.Security.Rootless}}'
|
|
42
64
|
```
|
|
43
65
|
|
|
44
|
-
La deuxième commande doit afficher une plage pour le compte dans `/etc/subuid` et dans `/etc/subgid` ; sinon, ajoutez-en une (`sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 "$(whoami)"`), puis lancez `podman system migrate`. La dernière doit afficher `true`. Un service systemd lancé sous ce compte déclare aussi le dossier d'exécution de l'utilisateur, que Podman rootless attend : `Environment=XDG_RUNTIME_DIR=/run/user/<uid du compte
|
|
66
|
+
La deuxième commande doit afficher une plage pour le compte dans `/etc/subuid` et dans `/etc/subgid` ; sinon, ajoutez-en une (`sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 "$(whoami)"`), puis lancez `podman system migrate`. La dernière doit afficher `true`. Un service systemd lancé sous ce compte déclare aussi le dossier d'exécution de l'utilisateur, que Podman rootless attend : `Environment=XDG_RUNTIME_DIR=/run/user/<uid du compte>`, le laisse en écriture (`ReadWritePaths=/run/user/<uid du compte>` avec `ProtectSystem=strict`), et ne pose ni `NoNewPrivileges` ni `RestrictSUIDSGID` (voir l'unité écrite par `setup`, ci-dessus).
|
|
45
67
|
|
|
46
68
|
Le serveur exige une clé de coffre, `VAULT_KEY`, qui chiffre les clés privées SSH des serveurs de déploiement et les tokens de l'organizer et de Claude. Générez-la une fois et déclarez-la comme variable secrète du service :
|
|
47
69
|
|
|
@@ -195,7 +217,7 @@ Six outils, en anglais, servis par le mode MCP. Le compte rendu d'une opération
|
|
|
195
217
|
|
|
196
218
|
| Outil | Effet |
|
|
197
219
|
|---|---|
|
|
198
|
-
| `list_repositories` | Dépôts suivis non dépréciés, tous ou ceux d'une catégorie (`category`, son nom) : catégorie, alertes Dependabot ouvertes par gravité (hors celles que l'utilisateur a corrigées à la main, comptées à part), paquets sans version corrigée au dernier audit, dernier audit sans vulnérabilité qui contredit les alertes, vulnérabilités trouvées par le dernier audit de la branche par défaut quand Dependabot ne signale rien, date de la dernière lecture (et son erreur), pull requests du tracker pas encore mergées, opération en cours. |
|
|
220
|
+
| `list_repositories` | Dépôts suivis non dépréciés, tous ou ceux d'une catégorie (`category`, son nom) : catégorie, tags, alertes Dependabot ouvertes par gravité (hors celles que l'utilisateur a corrigées à la main, comptées à part), paquets sans version corrigée au dernier audit, dernier audit sans vulnérabilité qui contredit les alertes, vulnérabilités trouvées par le dernier audit de la branche par défaut quand Dependabot ne signale rien, date de la dernière lecture (et son erreur), pull requests du tracker pas encore mergées, opération en cours. |
|
|
199
221
|
| `get_alerts` | Relit sur GitHub les alertes ouvertes d'un dépôt (`repository`) et les liste de la plus grave à la moins grave : numéro, gravité, paquet, écosystème, manifeste, portée de la dépendance (exécution ou développement), résumé, version corrigée, marque « corrigée à la main » de l'utilisateur, lien. |
|
|
200
222
|
| `run_audit` | Lance l'audit de chaque projet (`npm audit`, `pnpm audit`, `composer audit`) dans un clone temporaire de la branche analysée, sur le périmètre `scope` (`production` par défaut, ou `all`). Rien n'est modifié. Rend aussitôt l'identifiant de l'opération. |
|
|
201
223
|
| `fix_vulnerabilities` | Lance la même correction que le bouton « Corriger » de l'interface, sur le périmètre `scope` : audit, corrections automatiques, corrections par Claude s'il reste des vulnérabilités, puis commit, push et pull request vers la branche analysée. Avec `claude: false`, les corrections par Claude sont passées et seules les corrections automatiques sont poussées. Rend aussitôt l'identifiant de l'opération. |
|
|
@@ -224,7 +246,7 @@ Le **périmètre** se choisit à chaque lancement d'une correction, d'un audit o
|
|
|
224
246
|
|
|
225
247
|
**Pull requests en attente** — à chaque lecture d'un dépôt (toutes les 10 minutes, ou « Synchroniser maintenant »), le tracker lit ses pull requests ouvertes sur GitHub et garde celles dont la branche suit le nommage `fix/deps-audit-<AAAA-MM-JJ>-<HHMMSS>` (ou `fix/npm-audit-…`, celui des versions précédentes) et appartient au dépôt lui-même (pas à une fourche). Les pull requests ouvertes avant cette fonction sont donc reconnues, même quand l'historique des opérations ne les contient plus. Une pull request mergée ou fermée disparaît à la lecture suivante, ou aussitôt quand l'utilisateur la marque mergée dans l'onglet « PR en attente » ; une pull request que le tracker vient d'ouvrir apparaît aussitôt.
|
|
226
248
|
|
|
227
|
-
**Auditer tout** — depuis l'accueil, un audit seul (clone et audit, sans correction) de la **branche analysée** (celle que clone une correction) de chaque dépôt suivi de l'onglet affiché : tous les dépôts sur « Tous mes projets » et « Dépréciés », ceux de la catégorie quand une catégorie est affichée (le bouton s'intitule alors « Auditer la catégorie »), ceux de la file d'attente sur son onglet (« Auditer la file »). Trois audits tournent à la fois. Un dépôt où une opération est déjà en cours est laissé de côté ; un audit qui échoue (dépôt sans lockfile, clone impossible) n'arrête pas les autres. La série vit dans le serveur ; une seule à la fois.
|
|
249
|
+
**Auditer tout** — depuis l'accueil, un audit seul (clone et audit, sans correction) de la **branche analysée** (celle que clone une correction) de chaque dépôt suivi de l'onglet affiché : tous les dépôts sur « Tous mes projets » et « Dépréciés », ceux de la catégorie quand une catégorie est affichée (le bouton s'intitule alors « Auditer la catégorie »), ceux du tag quand un tag est affiché (« Auditer le tag »), ceux de la file d'attente sur son onglet (« Auditer la file »). Trois audits tournent à la fois. Un dépôt où une opération est déjà en cours est laissé de côté ; un audit qui échoue (dépôt sans lockfile, clone impossible) n'arrête pas les autres. La série vit dans le serveur ; une seule à la fois.
|
|
228
250
|
|
|
229
251
|
Les paquets mis à jour sont lus en comparant chaque lockfile à celui du commit cloné : version changée, paquet ajouté ou retiré. S'il n'y a rien à corriger, ou si les corrections ne changent rien, l'opération se termine sans push.
|
|
230
252
|
|
|
@@ -245,7 +267,7 @@ Quand les corrections automatiques laissent des vulnérabilités dans une correc
|
|
|
245
267
|
|
|
246
268
|
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, le token Claude non réglé, ou un bac à sable impossible : le clone revient au commit des corrections automatiques, l'erreur s'affiche sous l'étape, et la correction pousse quand même les corrections automatiques, avec un avertissement en tête de la pull request. L'annulation de l'opération arrête Claude Code.
|
|
247
269
|
|
|
248
|
-
**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 les gestionnaires de paquets par les outils d'un second serveur MCP, `packages`, que le tracker lui fournit (`dist/src/package-tools.js`) avec les seuls outils des gestionnaires des projets du dépôt ; pour npm : `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`) ; pour pnpm : `pnpm_install_lockfile` (`pnpm install --lockfile-only --ignore-scripts`), `pnpm_audit`, `pnpm_install` (`--frozen-lockfile`), `pnpm_test` (`pnpm -r --if-present run test`), `pnpm_run` (un script, à la racine ou dans un paquet du workspace avec `--filter`) et `pnpm_why` (`pnpm why -r`) ; pour Composer : `composer_update_lock` (`composer update <paquets> --with-all-dependencies --no-install --no-scripts --no-plugins --ignore-platform-req=ext-*`, paquets obligatoires), `composer_audit`, `composer_install`, `composer_test` (`composer run-script test`), `composer_run` (un script de `composer.json`) et `composer_why` (`composer depends --locked --tree`). L'image n'a que les extensions par défaut de l'image officielle de PHP : une extension manquante à l'installation ou aux tests est signalée dans le rapport, pas corrigée. 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, chacune dans un conteneur jetable du tracker, comme ses propres `npm audit` et `npm audit fix` (voir [Une opération](#une-opération)) : le code du projet et de ses paquets, `.npmrc` compris, ne s'exécute jamais sur le serveur, et le conteneur ne voit que le clone et le cache de l'opération, sans aucun token. 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, cette variable active d'office le bac à sable de Claude Code, qui refuse alors de démarrer sans bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). 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, 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.
|
|
270
|
+
**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 les gestionnaires de paquets par les outils d'un second serveur MCP, `packages`, que le tracker lui fournit (`dist/src/package-tools.js`) avec les seuls outils des gestionnaires des projets du dépôt, et avec les variables système du serveur (`HOME`, `XDG_RUNTIME_DIR`, `PATH`, proxy), qui remplacent celles de Claude Code : Podman rootless y retrouve le stockage du compte du serveur, où sont ses images ; pour npm : `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`) ; pour pnpm : `pnpm_install_lockfile` (`pnpm install --lockfile-only --ignore-scripts`), `pnpm_audit`, `pnpm_install` (`--frozen-lockfile`), `pnpm_test` (`pnpm -r --if-present run test`), `pnpm_run` (un script, à la racine ou dans un paquet du workspace avec `--filter`) et `pnpm_why` (`pnpm why -r`) ; pour Composer : `composer_update_lock` (`composer update <paquets> --with-all-dependencies --no-install --no-scripts --no-plugins --ignore-platform-req=ext-*`, paquets obligatoires), `composer_audit`, `composer_install`, `composer_test` (`composer run-script test`), `composer_run` (un script de `composer.json`) et `composer_why` (`composer depends --locked --tree`). L'image n'a que les extensions par défaut de l'image officielle de PHP : une extension manquante à l'installation ou aux tests est signalée dans le rapport, pas corrigée. 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, chacune dans un conteneur jetable du tracker, comme ses propres `npm audit` et `npm audit fix` (voir [Une opération](#une-opération)) : le code du projet et de ses paquets, `.npmrc` compris, ne s'exécute jamais sur le serveur, et le conteneur ne voit que le clone et le cache de l'opération, sans aucun token. 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, cette variable active d'office le bac à sable de Claude Code, qui refuse alors de démarrer sans bubblewrap. Installez-le sur le serveur (`sudo apt-get install -y bubblewrap socat`). 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, 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.
|
|
249
271
|
|
|
250
272
|
**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.
|
|
251
273
|
|
|
@@ -310,8 +332,8 @@ Le déploiement se pilote depuis l'interface seulement : les outils de l'agent n
|
|
|
310
332
|
|
|
311
333
|
Thème sombre, une information par ligne, une action principale par écran.
|
|
312
334
|
|
|
313
|
-
- **Accueil (`#/`, `#/c/<catégorie>`)** — à gauche, la barre des catégories : « Tous mes projets », « File d'attente » avec le nombre de dépôts qu'elle contient, « PR en attente » avec le nombre de dépôts dont une pull request du tracker attend, « À déployer » avec le nombre de dépôts marqués, puis chaque catégorie, chacune avec le nombre d'alertes ouvertes de ses dépôts, coloré selon la plus grave (aucune pastille sans alerte), précédé du nombre de pull requests du tracker en attente (aucune pastille sans pull request). « Nouvelle catégorie » ouvre un champ en place (Entrée crée, Échap annule) ; au survol d'une catégorie, « … » propose de la renommer ou de la supprimer (un second clic confirme ; ses dépôts restent suivis, sans catégorie). Un dépôt appartient à une catégorie au plus. En bas de la barre, « Dépréciés » ouvre l'onglet des dépôts dépréciés, avec leur nombre.
|
|
314
|
-
À droite, les dépôts non dépréciés de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre de vulnérabilités). L'interrupteur « Vulnérables seulement » ne garde que les dépôts réellement vulnérables : des paquets sans version corrigée au dernier audit, des alertes non corrigées à la main que le dernier audit ne contredit pas, ou des vulnérabilités trouvées par l'audit alors que Dependabot ne signale rien ; le navigateur retient sa position. Les dépôts forment un tableau à en-tête, une ligne par dépôt : le nom (`propriétaire/dépôt` en infobulle), suivi au survol d'une icône qui ouvre sa page GitHub dans un nouvel onglet (en permanence sur un écran tactile), trois colonnes de largeur fixe, « Sécurité », « Dernier audit » et « Suivi », puis les boutons et le chevron. Un contenu trop long est coupé, jamais poussé sur la colonne voisine, et l'infobulle le donne en entier.
|
|
335
|
+
- **Accueil (`#/`, `#/c/<catégorie>`, `#/t/<tag>`)** — à gauche, la barre des catégories : « Tous mes projets », « File d'attente » avec le nombre de dépôts qu'elle contient, « PR en attente » avec le nombre de dépôts dont une pull request du tracker attend, « À déployer » avec le nombre de dépôts marqués, puis chaque catégorie, chacune avec le nombre d'alertes ouvertes de ses dépôts, coloré selon la plus grave (aucune pastille sans alerte), précédé du nombre de pull requests du tracker en attente (aucune pastille sans pull request). « Nouvelle catégorie » ouvre un champ en place (Entrée crée, Échap annule) ; au survol d'une catégorie, « … » propose de la renommer ou de la supprimer (un second clic confirme ; ses dépôts restent suivis, sans catégorie). Un dépôt appartient à une catégorie au plus. Sous les catégories, la section « Tags » liste les tags portés par les dépôts non dépréciés, avec les mêmes pastilles ; un clic n'affiche que les dépôts qui portent ce tag, son nom en titre. Un tag n'existe que tant qu'un dépôt le porte. En bas de la barre, « Dépréciés » ouvre l'onglet des dépôts dépréciés, avec leur nombre.
|
|
336
|
+
À droite, les dépôts non dépréciés de la catégorie choisie, du plus exposé au moins exposé (gravité la plus haute, puis nombre de vulnérabilités). L'interrupteur « Vulnérables seulement » ne garde que les dépôts réellement vulnérables : des paquets sans version corrigée au dernier audit, des alertes non corrigées à la main que le dernier audit ne contredit pas, ou des vulnérabilités trouvées par l'audit alors que Dependabot ne signale rien ; le navigateur retient sa position. Les dépôts forment un tableau à en-tête, une ligne par dépôt : le nom (`propriétaire/dépôt` en infobulle), suivi au survol d'une icône qui ouvre sa page GitHub dans un nouvel onglet (en permanence sur un écran tactile), puis de ses tags (celui de l'onglet affiché mis en avant) et, au survol (en permanence sur un écran tactile), d'un bouton « + ». Ce bouton ouvre le menu des tags du dépôt : le champ filtre les tags existants, chacun avec une case et son nombre de dépôts ; un nom inconnu propose « Créer « … » ». ↑ ↓ et Entrée ou un clic cochent et décochent, Échap ferme ; chaque changement s'enregistre aussitôt. Un nom déjà porté par un autre dépôt, à la casse près, reprend son écriture. Viennent ensuite trois colonnes de largeur fixe, « Sécurité », « Dernier audit » et « Suivi », puis les boutons et le chevron. Un contenu trop long est coupé, jamais poussé sur la colonne voisine, et l'infobulle le donne en entier.
|
|
315
337
|
**Sécurité** — la pastille des alertes Dependabot non corrigées à la main, colorée selon la plus grave. Elle est estompée quand le dernier audit de la branche par défaut, plus récent que chacune d'elles, n'a trouvé aucune vulnérabilité : Dependabot n'a pas encore repassé. Elle est suivie de « dév. » quand toutes portent sur des dépendances de développement et que le dernier audit de production de la branche par défaut n'a rien trouvé. Des alertes toutes marquées corrigées à la main gardent une pastille estompée et ne comptent plus, ni ici, ni dans la barre des catégories. Sans alerte Dependabot, une pastille « N vulnérabilités » reprend ce qu'a trouvé le dernier audit de la branche par défaut, que Dependabot n'a pas encore vu ; ces vulnérabilités comptent dans la barre des catégories comme les alertes. « à la main » (icône de clé) signale les paquets pour lesquels le dernier audit n'a trouvé aucune version corrigée publiée, listés en infobulle. Sinon, la cellule affiche « Synchronisation impossible » (l'erreur en infobulle), « Synchronisation… » avant la première lecture, ou « — ».
|
|
316
338
|
**Dernier audit** — l'opération en cours (« Audit en cours », « Correction en cours », « Corrections par Claude… »), sinon le résultat du dernier audit, quelle que soit sa branche, et sa date : « OK », « Prod. OK » pour un audit des seules dépendances de production, ou « N vulnérabilités » ; le périmètre et la branche sont en infobulle. Pour une correction qui a ouvert une pull request, c'est l'audit qui suit ses corrections, sur la branche de la pull request : la colonne montre tout de suite ce qu'il restera après la fusion. « — » sans audit.
|
|
317
339
|
**Suivi** — des marqueurs discrets, chacun avec son infobulle : la pull request du tracker en attente (« #42 », ou « 2 PR », qui ouvre la liste des pull requests du dépôt), la tâche organizer du dernier rapport de Claude tant qu'elle n'est pas terminée (« MNT-12 », qui ouvre la tâche), la file d'attente et la marque « à déployer », leur date en infobulle.
|
|
@@ -347,7 +369,7 @@ Un point d'entrée, `src/index.ts`, et deux modes :
|
|
|
347
369
|
| `GET /api/config` | Version, répertoire des données, adresse du serveur GitHub. |
|
|
348
370
|
| `GET /api/repos`, `POST /api/repos` | Dépôts suivis, dépréciés compris (avec catégorie, opération en cours et dernière opération) et catégories ; ajout d'un dépôt (`{ repository, categoryId? }`). |
|
|
349
371
|
| `POST /api/sync` | Relit tout de suite les alertes et les pull requests de chaque dépôt suivi non déprécié, en parallèle ; renvoie les dépôts et les catégories. |
|
|
350
|
-
| `GET /api/audit-all`, `POST /api/audit-all` | État de la dernière série « Auditer tout » (`null` si aucune depuis le démarrage) : en cours ou non, dépôts traités sur le total, laissés de côté, en échec avec la raison ; lancement d'une série sur le périmètre `scope` du corps (`production` ou `all`) et les dépôts de `target` : `{ "kind": "all" }`, `{ "kind": "category", "categoryId": … }` ou `{ "kind": "queue" }` (`404` si la catégorie n'existe pas, `409` si une série est en cours). |
|
|
372
|
+
| `GET /api/audit-all`, `POST /api/audit-all` | État de la dernière série « Auditer tout » (`null` si aucune depuis le démarrage) : en cours ou non, dépôts traités sur le total, laissés de côté, en échec avec la raison ; lancement d'une série sur le périmètre `scope` du corps (`production` ou `all`) et les dépôts de `target` : `{ "kind": "all" }`, `{ "kind": "category", "categoryId": … }`, `{ "kind": "tag", "tag": … }` ou `{ "kind": "queue" }` (`404` si la catégorie n'existe pas, `409` si une série est en cours). |
|
|
351
373
|
| `GET /api/github/repos` | Dépôts accessibles au token (`/user/repos`) et pas encore suivis, pour les suggestions d'ajout. |
|
|
352
374
|
| `GET` / `DELETE /api/repos/:propriétaire/:nom` | Dépôt ; retrait. |
|
|
353
375
|
| `PUT` / `DELETE /api/repos/:propriétaire/:nom/deprecated` | Marque le dépôt déprécié (`409` pendant une opération) et lui retire la file d'attente et la marque « à déployer » ; le rétablit et relit ses alertes. |
|
|
@@ -357,6 +379,7 @@ Un point d'entrée, `src/index.ts`, et deux modes :
|
|
|
357
379
|
| `GET /api/repos/:propriétaire/:nom/branches`, `PUT …/branch` | Branches du dépôt, la branche par défaut en tête ; choix de la branche analysée (`{ branch }`, qui doit exister). |
|
|
358
380
|
| `PUT` / `DELETE /api/repos/:propriétaire/:nom/alerts/:numéro/handled` | Marque une alerte ouverte corrigée à la main ; retire la marque. |
|
|
359
381
|
| `PUT /api/repos/:propriétaire/:nom/category` | Catégorie du dépôt (`{ categoryId }`, null pour aucune). |
|
|
382
|
+
| `PUT /api/repos/:propriétaire/:nom/tags` | Tags du dépôt (`{ tags }`, 20 au plus, 30 caractères chacun), qui remplacent les précédents ; sans doublon à la casse près, dans l'ordre alphabétique. |
|
|
360
383
|
| `GET /api/categories`, `POST /api/categories` | Catégories dans l'ordre alphabétique ; création (`{ name }`, unique sans tenir compte de la casse). |
|
|
361
384
|
| `PUT` / `DELETE /api/categories/:id` | Renommage (`{ name }`) ; suppression, ses dépôts restant sans catégorie. |
|
|
362
385
|
| `PUT /api/categories/:id/queued` | Met dans la file d'attente les dépôts non dépréciés de la catégorie qui n'y sont pas encore ; rend la liste des dépôts et des catégories. |
|
|
@@ -397,7 +420,7 @@ Erreurs : `400` requête invalide, `401` token d'agent absent ou révoqué, `404
|
|
|
397
420
|
|
|
398
421
|
### Persistance
|
|
399
422
|
|
|
400
|
-
`<données>/repos.json` pour les catégories et les dépôts (catégorie, alertes, alertes corrigées à la main, dernière lecture, date de dépréciation), `<données>/operations/<id>.json` pour chaque opération (session de Claude comprise) ; les 20 plus récentes sont conservées par dépôt. `<données>/settings.json` porte les réglages des corrections par Claude et leurs tokens, `<données>/agent-tokens.json` les tokens d'agent, dont seule l'empreinte SHA-256 est conservée ; les deux fichiers ne sont lisibles que par le compte du serveur. `<données>/claude` garde la configuration de Claude Code. `<données>/deploy-servers.json` porte les serveurs de déploiement, leur clé privée chiffrée avec `VAULT_KEY`, lisible par le seul compte du serveur ; `<données>/deployments/<id>.json` chaque déploiement, les 20 plus récents par dépôt. Le serveur et le script de déploiement d'un dépôt sont dans `repos.json`. Le serveur est le seul processus qui écrit ces fichiers ; chaque écriture est atomique. Une opération enregistrée par une version qui attendait une décision de l'utilisateur est lue comme annulée.
|
|
423
|
+
`<données>/repos.json` pour les catégories et les dépôts (catégorie, tags, alertes, alertes corrigées à la main, dernière lecture, date de dépréciation), `<données>/operations/<id>.json` pour chaque opération (session de Claude comprise) ; les 20 plus récentes sont conservées par dépôt. `<données>/settings.json` porte les réglages des corrections par Claude et leurs tokens, `<données>/agent-tokens.json` les tokens d'agent, dont seule l'empreinte SHA-256 est conservée ; les deux fichiers ne sont lisibles que par le compte du serveur. `<données>/claude` garde la configuration de Claude Code. `<données>/deploy-servers.json` porte les serveurs de déploiement, leur clé privée chiffrée avec `VAULT_KEY`, lisible par le seul compte du serveur ; `<données>/deployments/<id>.json` chaque déploiement, les 20 plus récents par dépôt. Le serveur et le script de déploiement d'un dépôt sont dans `repos.json`. Le serveur est le seul processus qui écrit ces fichiers ; chaque écriture est atomique. Une opération enregistrée par une version qui attendait une décision de l'utilisateur est lue comme annulée.
|
|
401
424
|
|
|
402
425
|
---
|
|
403
426
|
|
|
@@ -15,6 +15,11 @@ export declare const SetCategoryBodySchema: z.ZodObject<{
|
|
|
15
15
|
categoryId: z.ZodNullable<z.ZodString>;
|
|
16
16
|
}, z.core.$strip>;
|
|
17
17
|
export type SetCategoryBody = z.infer<typeof SetCategoryBodySchema>;
|
|
18
|
+
/** Tags du dépôt, qui remplacent les précédents. */
|
|
19
|
+
export declare const SetTagsBodySchema: z.ZodObject<{
|
|
20
|
+
tags: z.ZodArray<z.ZodString>;
|
|
21
|
+
}, z.core.$strip>;
|
|
22
|
+
export type SetTagsBody = z.infer<typeof SetTagsBodySchema>;
|
|
18
23
|
/** Corps de `POST /api/categories` et de `PUT /api/categories/:id`. */
|
|
19
24
|
export declare const CategoryBodySchema: z.ZodObject<{
|
|
20
25
|
name: z.ZodString;
|
|
@@ -36,12 +41,15 @@ export declare const ScopeBodySchema: z.ZodObject<{
|
|
|
36
41
|
}>;
|
|
37
42
|
}, z.core.$strip>;
|
|
38
43
|
export type ScopeBody = z.infer<typeof ScopeBodySchema>;
|
|
39
|
-
/** Dépôts visés par « Auditer tout » : tous les dépôts suivis, ceux d'une catégorie, ou ceux de la file d'attente. */
|
|
44
|
+
/** Dépôts visés par « Auditer tout » : tous les dépôts suivis, ceux d'une catégorie, ceux d'un tag, ou ceux de la file d'attente. */
|
|
40
45
|
export declare const AuditTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
41
46
|
kind: z.ZodLiteral<"all">;
|
|
42
47
|
}, z.core.$strip>, z.ZodObject<{
|
|
43
48
|
kind: z.ZodLiteral<"category">;
|
|
44
49
|
categoryId: z.ZodString;
|
|
50
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
51
|
+
kind: z.ZodLiteral<"tag">;
|
|
52
|
+
tag: z.ZodString;
|
|
45
53
|
}, z.core.$strip>, z.ZodObject<{
|
|
46
54
|
kind: z.ZodLiteral<"queue">;
|
|
47
55
|
}, z.core.$strip>], "kind">;
|
|
@@ -57,6 +65,9 @@ export declare const AuditAllBodySchema: z.ZodObject<{
|
|
|
57
65
|
}, z.core.$strip>, z.ZodObject<{
|
|
58
66
|
kind: z.ZodLiteral<"category">;
|
|
59
67
|
categoryId: z.ZodString;
|
|
68
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
69
|
+
kind: z.ZodLiteral<"tag">;
|
|
70
|
+
tag: z.ZodString;
|
|
60
71
|
}, z.core.$strip>, z.ZodObject<{
|
|
61
72
|
kind: z.ZodLiteral<"queue">;
|
|
62
73
|
}, z.core.$strip>], "kind">;
|
|
@@ -8,14 +8,17 @@ export const AddRepoBodySchema = z.object({
|
|
|
8
8
|
export const SetBranchBodySchema = z.object({ branch: z.string().trim().min(1) });
|
|
9
9
|
/** Catégorie du dépôt ; null le sort de toute catégorie. */
|
|
10
10
|
export const SetCategoryBodySchema = z.object({ categoryId: z.string().min(1).nullable() });
|
|
11
|
+
/** Tags du dépôt, qui remplacent les précédents. */
|
|
12
|
+
export const SetTagsBodySchema = z.object({ tags: z.array(z.string().trim().min(1).max(30)).max(20) });
|
|
11
13
|
/** Corps de `POST /api/categories` et de `PUT /api/categories/:id`. */
|
|
12
14
|
export const CategoryBodySchema = z.object({ name: z.string().trim().min(1).max(60) });
|
|
13
15
|
/** Corps de `POST /api/repos/:owner/:name/operations` : le périmètre de l'audit. */
|
|
14
16
|
export const ScopeBodySchema = z.object({ scope: z.enum(AUDIT_SCOPES) });
|
|
15
|
-
/** Dépôts visés par « Auditer tout » : tous les dépôts suivis, ceux d'une catégorie, ou ceux de la file d'attente. */
|
|
17
|
+
/** Dépôts visés par « Auditer tout » : tous les dépôts suivis, ceux d'une catégorie, ceux d'un tag, ou ceux de la file d'attente. */
|
|
16
18
|
export const AuditTargetSchema = z.discriminatedUnion("kind", [
|
|
17
19
|
z.object({ kind: z.literal("all") }),
|
|
18
20
|
z.object({ kind: z.literal("category"), categoryId: z.string().min(1) }),
|
|
21
|
+
z.object({ kind: z.literal("tag"), tag: z.string().min(1) }),
|
|
19
22
|
z.object({ kind: z.literal("queue") }),
|
|
20
23
|
]);
|
|
21
24
|
/** Corps de `POST /api/audit-all` : le périmètre des audits et les dépôts visés. */
|
|
@@ -82,6 +82,7 @@ export type Category = z.infer<typeof CategorySchema>;
|
|
|
82
82
|
* Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
|
|
83
83
|
* la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
|
|
84
84
|
* `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
|
|
85
|
+
* `tags` ses tags, dans l'ordre alphabétique, sans doublon à la casse près ;
|
|
85
86
|
* `handledAlerts` les alertes qu'il a marquées corrigées à la main ;
|
|
86
87
|
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture ;
|
|
87
88
|
* `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
|
|
@@ -98,6 +99,7 @@ export declare const RepoSchema: z.ZodObject<{
|
|
|
98
99
|
defaultBranch: z.ZodString;
|
|
99
100
|
branch: z.ZodString;
|
|
100
101
|
categoryId: z.ZodNullable<z.ZodString>;
|
|
102
|
+
tags: z.ZodArray<z.ZodString>;
|
|
101
103
|
addedAt: z.ZodString;
|
|
102
104
|
alerts: z.ZodArray<z.ZodObject<{
|
|
103
105
|
number: z.ZodNumber;
|
|
@@ -151,6 +153,7 @@ export declare const ReposFileSchema: z.ZodObject<{
|
|
|
151
153
|
defaultBranch: z.ZodString;
|
|
152
154
|
branch: z.ZodString;
|
|
153
155
|
categoryId: z.ZodNullable<z.ZodString>;
|
|
156
|
+
tags: z.ZodArray<z.ZodString>;
|
|
154
157
|
addedAt: z.ZodString;
|
|
155
158
|
alerts: z.ZodArray<z.ZodObject<{
|
|
156
159
|
number: z.ZodNumber;
|
|
@@ -60,6 +60,7 @@ export const CategorySchema = z.object({
|
|
|
60
60
|
* Dépôt suivi. `id` est le nom complet GitHub, `propriétaire/nom` ; `branch` est
|
|
61
61
|
* la branche que les opérations clonent et vers laquelle la pull request est ouverte ;
|
|
62
62
|
* `categoryId` est sa catégorie, null s'il n'est rangé dans aucune ;
|
|
63
|
+
* `tags` ses tags, dans l'ordre alphabétique, sans doublon à la casse près ;
|
|
63
64
|
* `handledAlerts` les alertes qu'il a marquées corrigées à la main ;
|
|
64
65
|
* `pullRequests` les pull requests du tracker encore ouvertes à la dernière lecture ;
|
|
65
66
|
* `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
|
|
@@ -76,6 +77,7 @@ export const RepoSchema = z.object({
|
|
|
76
77
|
defaultBranch: z.string(),
|
|
77
78
|
branch: z.string(),
|
|
78
79
|
categoryId: z.string().nullable(),
|
|
80
|
+
tags: z.array(z.string()),
|
|
79
81
|
addedAt: z.string(),
|
|
80
82
|
alerts: z.array(AlertSchema),
|
|
81
83
|
handledAlerts: z.array(HandledAlertSchema),
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import readline from "readline";
|
|
2
|
+
/** Lit une ligne sur le terminal sans l'afficher. */
|
|
3
|
+
export function promptHidden(question) {
|
|
4
|
+
return new Promise((resolve) => {
|
|
5
|
+
const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
|
|
6
|
+
const output = rl;
|
|
7
|
+
let muted = false;
|
|
8
|
+
output._writeToOutput = (text) => {
|
|
9
|
+
if (!muted || text.includes("\n"))
|
|
10
|
+
output.output.write(muted ? "\n" : text);
|
|
11
|
+
};
|
|
12
|
+
rl.question(question, (answer) => {
|
|
13
|
+
rl.close();
|
|
14
|
+
resolve(answer);
|
|
15
|
+
});
|
|
16
|
+
muted = true;
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
/** Lit une ligne sur le terminal. */
|
|
20
|
+
export function promptLine(question) {
|
|
21
|
+
return new Promise((resolve) => {
|
|
22
|
+
const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
|
|
23
|
+
rl.question(question, (answer) => {
|
|
24
|
+
rl.close();
|
|
25
|
+
resolve(answer.trim());
|
|
26
|
+
});
|
|
27
|
+
});
|
|
28
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Commande `setup` : installation complète du serveur sur une machine Linux
|
|
3
|
+
* avec systemd, lancée en root. Elle pose ses questions (adresse publique,
|
|
4
|
+
* port, compte de service, données, nginx et certificat, premier compte), en
|
|
5
|
+
* proposant les valeurs du `.env` existant, puis : installe les paquets
|
|
6
|
+
* manquants, crée le compte de service, lui attribue une plage libre de
|
|
7
|
+
* sous-identifiants et active son lingering, écrit le `.env` (clés générées
|
|
8
|
+
* une fois, puis conservées), crée le premier compte de l'interface, prépare
|
|
9
|
+
* Podman rootless, écrit et démarre l'unité systemd, vérifie que le serveur
|
|
10
|
+
* répond, puis configure nginx et le certificat quand ils sont demandés.
|
|
11
|
+
* Relancée, elle reprend la configuration en place.
|
|
12
|
+
*/
|
|
13
|
+
export declare const SETUP_USAGE = "Usage : mcp-dependabot-tracker setup [options]\n\nInstalle le serveur sur cette machine (Linux, systemd), en root. Les questions\nproposent les valeurs du .env existant ; sans terminal, ou avec --non-interactive,\nchaque r\u00E9ponse vient d'une option, sinon du .env existant ou du d\u00E9faut.\n\n --app-url=<url> adresse publique de l'interface (https://\u2026)\n --port=<n> port d'\u00E9coute, sur 127.0.0.1 [4700]\n --service-user=<compte> compte syst\u00E8me du service [dependabot-tracker]\n --data-dir=<chemin> r\u00E9pertoire des donn\u00E9es [<dossier du compte>/data]\n --nginx=oui|non servir l'adresse publique par nginx [oui en https]\n --certbot=oui|non obtenir le certificat avec certbot [oui avec nginx]\n --admin-email=<adresse> premier compte de l'interface\n --admin-name=<nom> nom affich\u00E9 de ce compte\n --non-interactive ne rien demander\n\nLe mot de passe du compte n'est jamais un argument : il est saisi sans \u00E9cho, ou\nlu dans SETUP_ADMIN_PASSWORD.";
|
|
14
|
+
declare const VALUE_OPTIONS: readonly ["app-url", "port", "service-user", "data-dir", "nginx", "certbot", "admin-email", "admin-name"];
|
|
15
|
+
type ValueOption = (typeof VALUE_OPTIONS)[number];
|
|
16
|
+
/** Paquets nécessaires au serveur : git, Podman rootless, et le bac à sable de Claude Code. */
|
|
17
|
+
export declare const BASE_PACKAGES: string[];
|
|
18
|
+
/** Résultat d'une commande système. */
|
|
19
|
+
export interface CommandOutcome {
|
|
20
|
+
code: number;
|
|
21
|
+
stdout: string;
|
|
22
|
+
stderr: string;
|
|
23
|
+
}
|
|
24
|
+
/** Ce que la commande touche sur la machine ; remplaçable dans les tests. */
|
|
25
|
+
export interface SetupHost {
|
|
26
|
+
platform: NodeJS.Platform;
|
|
27
|
+
isRoot: boolean;
|
|
28
|
+
interactive: boolean;
|
|
29
|
+
/** Racine des fichiers système (`/etc`, `/run`) : `/` sur la machine. */
|
|
30
|
+
root: string;
|
|
31
|
+
packageRoot: string;
|
|
32
|
+
nodePath: string;
|
|
33
|
+
/** Lance une commande ; `inherit` montre sa sortie à l'utilisateur. */
|
|
34
|
+
run: (command: string, args: string[], options?: {
|
|
35
|
+
cwd?: string;
|
|
36
|
+
env?: Record<string, string>;
|
|
37
|
+
inherit?: boolean;
|
|
38
|
+
}) => CommandOutcome;
|
|
39
|
+
ask: (question: string) => Promise<string>;
|
|
40
|
+
askSecret: (question: string) => Promise<string>;
|
|
41
|
+
say: (line: string) => void;
|
|
42
|
+
/** Attend que le serveur réponde sur `port` ; rend faux après `timeoutMs`. */
|
|
43
|
+
waitHealthy: (port: number, timeoutMs: number) => Promise<boolean>;
|
|
44
|
+
}
|
|
45
|
+
/** Machine réelle : commandes, terminal et fichiers de la machine. */
|
|
46
|
+
export declare function realHost(packageRoot: string): SetupHost;
|
|
47
|
+
interface ParsedArgs {
|
|
48
|
+
values: Partial<Record<ValueOption, string>>;
|
|
49
|
+
nonInteractive: boolean;
|
|
50
|
+
}
|
|
51
|
+
/** Lit les options `--nom=valeur` ; une option inconnue ou répétée est refusée. */
|
|
52
|
+
export declare function parseSetupArgs(argv: readonly string[]): ParsedArgs;
|
|
53
|
+
/** Exécute la commande ; rend le code de sortie. */
|
|
54
|
+
export declare function runSetup(argv: readonly string[], host: SetupHost): Promise<number>;
|
|
55
|
+
export {};
|