@imenam/mcp-dependabot-tracker 1.0.25 → 1.0.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -65,7 +65,7 @@ TRUSTED_PROXIES=127.0.0.1
65
65
 
66
66
  ### Comptes de l'interface
67
67
 
68
- Il n'y a pas d'inscription : les comptes se créent sur la machine du serveur, avec le même environnement que lui (`MCP_DATA_DIR`, `APP_URL`, `AUTH_SECRET`, ou le `.env` du package). Le mot de passe est demandé deux fois, sans être affiché ; il fait au moins 12 caractères.
68
+ Il n'y a pas d'inscription : les comptes se créent sur la machine du serveur, avec le même environnement que lui (`DATA_DIR`, `APP_URL`, `AUTH_SECRET`, ou le `.env` du package). Le mot de passe est demandé deux fois, sans être affiché ; il fait au moins 12 caractères.
69
69
 
70
70
  ```bash
71
71
  mcp-dependabot-tracker user add admin@example.com --name="Admin"
@@ -132,7 +132,7 @@ Elles se renseignent dans l'environnement du service, ou dans un fichier `.env`
132
132
  | Variable | Rôle |
133
133
  |---|---|
134
134
  | `GITHUB_TOKEN` | **Obligatoire.** Token GitHub (voir ci-dessus). Sans lui, le serveur refuse de démarrer. |
135
- | `CLONE_DIR` | **Obligatoire.** Dossier où chaque opération crée son clone ; il est créé s'il n'existe pas. Sans lui, le serveur refuse de démarrer. |
135
+ | `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
136
  | `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
137
  | `APP_PORT` | **Obligatoire.** Port d'écoute du serveur. |
138
138
  | `APP_URL` | **Obligatoire.** Adresse publique de l'interface, sans chemin : `https://…`, ou `http://localhost:<port>` sur la machine elle-même (voir [Exposition et authentification](#exposition-et-authentification)). |
@@ -141,8 +141,7 @@ Elles se renseignent dans l'environnement du service, ou dans un fichier `.env`
141
141
  | `TRUSTED_PROXIES` | Adresses IP ou plages CIDR des reverse proxies, séparées par des virgules, dont l'en-tête `X-Forwarded-For` est cru. |
142
142
  | `GITHUB_API_URL` | API GitHub (défaut `https://api.github.com`), à changer pour GitHub Enterprise Server. |
143
143
  | `GITHUB_SERVER_URL` | Serveur git des clones (défaut `https://github.com`) : un dépôt se clone depuis `<serveur>/<propriétaire>/<nom>.git`. |
144
- | `MCP_DATA_DIR` | Répertoire des données (défaut `~/.mcp-dependabot-tracker`). Hors de Windows, le serveur le réserve à son compte (droits `700`) à chaque démarrage, et ses fichiers sont écrits en `600`. |
145
- | `MCP_LOG_DIR` | Répertoire des logs. Défaut : `<données>/logs`. |
144
+ | `MCP_LOG_DIR` | Répertoire des logs. Défaut : `<DATA_DIR>/logs`. |
146
145
 
147
146
  Sans une variable obligatoire, ou avec une valeur invalide (`APP_URL` en http hors `localhost`, `AUTH_SECRET` trop court, `LISTEN_HOST` qui n'est pas une adresse IP), le serveur refuse de démarrer en nommant la variable.
148
147
 
@@ -189,7 +188,7 @@ Un dépôt déprécié est refusé par tous les outils, jusqu'à ce que l'utilis
189
188
 
190
189
  ## Une opération
191
190
 
192
- Chaque opération travaille dans un clone temporaire (`<CLONE_DIR>/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche analysée), supprimé dès qu'elle se termine, réussie, échouée ou annulée.
191
+ Chaque opération travaille dans un clone temporaire (`<DATA_DIR>/clones/mcp-dependabot-tracker-*/repo`, `git clone --depth 1` de la branche analysée), supprimé dès qu'elle se termine, réussie, échouée ou annulée.
193
192
 
194
193
  La **branche analysée** se choisit par dépôt dans la GUI ; c'est la branche par défaut tant qu'aucune autre n'est choisie. L'agent l'utilise aussi, sans pouvoir en changer. Les alertes Dependabot, elles, portent toujours sur la branche par défaut, la seule que GitHub analyse : sur une autre branche, c'est `npm audit` qui mesure les vulnérabilités.
195
194
 
@@ -1,13 +1,9 @@
1
1
  /**
2
- * Répertoire des données : MCP_DATA_DIR, puis `~/.mcp-dependabot-tracker`. Les
3
- * dépôts suivis ne dépendent d'aucun projet : le répertoire par défaut est
4
- * propre à l'utilisateur. Il est créé s'il n'existe pas, et réservé au compte
5
- * du serveur (droits 700) hors de Windows : il porte les comptes, les sessions,
6
- * les tokens et les scripts de déploiement.
2
+ * Répertoire des données, fixé par DATA_DIR. Il est créé s'il n'existe pas, et
3
+ * réservé au compte du serveur (droits 700) hors de Windows : il porte les
4
+ * comptes, les sessions, les tokens, les scripts de déploiement et les clones.
5
+ * Lève une erreur si la variable n'est pas renseignée.
7
6
  */
8
7
  export declare function resolveDataDir(): string;
9
- /**
10
- * Dossier où chaque opération crée son clone, fixé par CLONE_DIR et créé s'il
11
- * n'existe pas. Lève une erreur si la variable n'est pas renseignée.
12
- */
13
- export declare function resolveCloneDir(): string;
8
+ /** Dossier où chaque opération crée son clone : `<dataDir>/clones`, créé s'il n'existe pas. */
9
+ export declare function resolveCloneDir(dataDir: string): string;
@@ -1,33 +1,29 @@
1
1
  import fs from "fs";
2
- import os from "os";
3
2
  import path from "path";
4
3
  /** Droits du répertoire des données : lecture, écriture et parcours par le seul compte du serveur. */
5
4
  const DATA_DIR_MODE = 0o700;
5
+ /** Sous-dossier du répertoire des données où chaque opération crée son clone. */
6
+ const CLONES_SUBDIR = "clones";
6
7
  /**
7
- * Répertoire des données : MCP_DATA_DIR, puis `~/.mcp-dependabot-tracker`. Les
8
- * dépôts suivis ne dépendent d'aucun projet : le répertoire par défaut est
9
- * propre à l'utilisateur. Il est créé s'il n'existe pas, et réservé au compte
10
- * du serveur (droits 700) hors de Windows : il porte les comptes, les sessions,
11
- * les tokens et les scripts de déploiement.
8
+ * Répertoire des données, fixé par DATA_DIR. Il est créé s'il n'existe pas, et
9
+ * réservé au compte du serveur (droits 700) hors de Windows : il porte les
10
+ * comptes, les sessions, les tokens, les scripts de déploiement et les clones.
11
+ * Lève une erreur si la variable n'est pas renseignée.
12
12
  */
13
13
  export function resolveDataDir() {
14
- const configured = process.env.MCP_DATA_DIR?.trim();
15
- const dir = configured ? path.resolve(configured) : path.join(os.homedir(), ".mcp-dependabot-tracker");
14
+ const configured = process.env.DATA_DIR?.trim();
15
+ if (!configured) {
16
+ throw new Error("DATA_DIR is not set. It is the folder where the accounts, the sessions, the tokens, the deployment scripts and the repository clones are stored.");
17
+ }
18
+ const dir = path.resolve(configured);
16
19
  fs.mkdirSync(dir, { recursive: true, mode: DATA_DIR_MODE });
17
20
  if (process.platform !== "win32")
18
21
  fs.chmodSync(dir, DATA_DIR_MODE);
19
22
  return dir;
20
23
  }
21
- /**
22
- * Dossier où chaque opération crée son clone, fixé par CLONE_DIR et créé s'il
23
- * n'existe pas. Lève une erreur si la variable n'est pas renseignée.
24
- */
25
- export function resolveCloneDir() {
26
- const configured = process.env.CLONE_DIR?.trim();
27
- if (!configured) {
28
- throw new Error("CLONE_DIR is not set: declare the folder where the repositories are cloned for npm audit in the environment of the server.");
29
- }
30
- const dir = path.resolve(configured);
24
+ /** Dossier où chaque opération crée son clone : `<dataDir>/clones`, créé s'il n'existe pas. */
25
+ export function resolveCloneDir(dataDir) {
26
+ const dir = path.join(dataDir, CLONES_SUBDIR);
31
27
  fs.mkdirSync(dir, { recursive: true });
32
28
  return dir;
33
29
  }
@@ -1,2 +1,2 @@
1
1
  /** Répertoire des logs : MCP_LOG_DIR s'il est renseigné, sinon <dataDir>/logs. */
2
- export declare function resolveLogDir(): string;
2
+ export declare function resolveLogDir(dataDir: string): string;
@@ -1,9 +1,8 @@
1
1
  import path from "path";
2
- import { resolveDataDir } from "./data-dir.js";
3
2
  /** Répertoire des logs : MCP_LOG_DIR s'il est renseigné, sinon <dataDir>/logs. */
4
- export function resolveLogDir() {
3
+ export function resolveLogDir(dataDir) {
5
4
  const configured = process.env.MCP_LOG_DIR?.trim();
6
5
  if (configured)
7
6
  return path.resolve(configured);
8
- return path.join(resolveDataDir(), "logs");
7
+ return path.join(dataDir, "logs");
9
8
  }
@@ -57,7 +57,15 @@ function listen(app, port, hostname) {
57
57
  export async function serve() {
58
58
  const root = packageRoot();
59
59
  loadPackageEnv();
60
- setupLogging({ processLabel: "mcp-dependabot-tracker", logDir: resolveLogDir() });
60
+ let dataDir;
61
+ try {
62
+ dataDir = resolveDataDir();
63
+ }
64
+ catch (err) {
65
+ console.error(err.message);
66
+ process.exit(1);
67
+ }
68
+ setupLogging({ processLabel: "mcp-dependabot-tracker", logDir: resolveLogDir(dataDir) });
61
69
  const logger = createLogger("mcp-dependabot-tracker");
62
70
  process.on("uncaughtException", (err) => {
63
71
  logger.error(`Uncaught exception: ${err.stack ?? err.message}`);
@@ -73,7 +81,7 @@ export async function serve() {
73
81
  let vaultKey;
74
82
  try {
75
83
  github = readGitHubConfig();
76
- cloneDir = resolveCloneDir();
84
+ cloneDir = resolveCloneDir(dataDir);
77
85
  config = readServerConfig();
78
86
  vaultKey = parseVaultKey(process.env.VAULT_KEY);
79
87
  }
@@ -81,7 +89,6 @@ export async function serve() {
81
89
  logger.error(err.message);
82
90
  process.exit(1);
83
91
  }
84
- const dataDir = resolveDataDir();
85
92
  let auth;
86
93
  try {
87
94
  auth = createAuth(dataDir, config);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@imenam/mcp-dependabot-tracker",
3
- "version": "1.0.25",
3
+ "version": "1.0.26",
4
4
  "description": "Server and web GUI that track the Dependabot alerts of GitHub repositories and fix their npm vulnerabilities in a temporary clone: npm audit, audit fix, fixes by Claude, then a branch and a pull request. An MCP mode lets agents drive the server.",
5
5
  "main": "dist/src/index.js",
6
6
  "scripts": {