@imenam/mcp-dependabot-tracker 1.0.10 → 1.0.12

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.
Files changed (44) hide show
  1. package/README.md +33 -14
  2. package/dist/shared/alerts.d.ts +6 -1
  3. package/dist/shared/alerts.js +7 -0
  4. package/dist/shared/schemas/api.schema.d.ts +41 -9
  5. package/dist/shared/schemas/api.schema.js +5 -1
  6. package/dist/shared/schemas/ipc.schema.d.ts +1 -1
  7. package/dist/shared/schemas/ipc.schema.js +2 -0
  8. package/dist/shared/schemas/model.schema.d.ts +159 -7
  9. package/dist/shared/schemas/model.schema.js +63 -8
  10. package/dist/src/core/analysis.d.ts +26 -1
  11. package/dist/src/core/analysis.js +6 -3
  12. package/dist/src/core/audit-all.d.ts +6 -6
  13. package/dist/src/core/audit-all.js +6 -6
  14. package/dist/src/core/claude.d.ts +2 -0
  15. package/dist/src/core/claude.js +8 -4
  16. package/dist/src/core/commands.d.ts +2 -2
  17. package/dist/src/core/commands.js +1 -1
  18. package/dist/src/core/github.js +2 -1
  19. package/dist/src/core/npm-sandbox.d.ts +17 -0
  20. package/dist/src/core/npm-sandbox.js +89 -0
  21. package/dist/src/core/operations.d.ts +22 -12
  22. package/dist/src/core/operations.js +239 -44
  23. package/dist/src/core/organizer.d.ts +14 -0
  24. package/dist/src/core/organizer.js +17 -2
  25. package/dist/src/core/repair.d.ts +38 -0
  26. package/dist/src/core/repair.js +191 -0
  27. package/dist/src/core/repos.d.ts +11 -8
  28. package/dist/src/core/repos.js +38 -20
  29. package/dist/src/core/store.d.ts +2 -0
  30. package/dist/src/core/store.js +14 -5
  31. package/dist/src/gui-worker.js +20 -3
  32. package/dist/src/index.js +23 -8
  33. package/dist/src/npm-tools.d.ts +10 -0
  34. package/dist/src/npm-tools.js +136 -0
  35. package/dist/src/tools/format.js +20 -8
  36. package/dist/src/tools/tools.js +8 -6
  37. package/dist/src/tools/types.d.ts +2 -0
  38. package/dist/src/tools/types.js +9 -0
  39. package/gui/dist/assets/index-D98CR3xl.js +64 -0
  40. package/gui/dist/assets/index-DETLqB3f.css +1 -0
  41. package/gui/dist/index.html +2 -2
  42. package/package.json +1 -1
  43. package/gui/dist/assets/index-C1Ml-XiM.css +0 -1
  44. package/gui/dist/assets/index-DQPqW5Uq.js +0 -64
@@ -13,7 +13,19 @@ export const RightsSchema = z.object({
13
13
  });
14
14
  /** Droits d'un dépôt qui vient d'être ajouté : l'audit seul. */
15
15
  export const DEFAULT_RIGHTS = { audit: true, fix: false, force: false, push: false };
16
- /** Alerte Dependabot ouverte, telle que la renvoie l'API GitHub, réduite à ce qui s'affiche ; `createdAt` est sa date d'émission. */
16
+ /**
17
+ * Périmètre d'un audit et de ses corrections : `production` laisse de côté les
18
+ * devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
19
+ */
20
+ export const AUDIT_SCOPES = ["production", "all"];
21
+ export const DEFAULT_AUDIT_SCOPE = "production";
22
+ /** Portée d'une dépendance vulnérable selon Dependabot : exécution ou développement. */
23
+ export const DEPENDENCY_SCOPES = ["runtime", "development"];
24
+ /**
25
+ * Alerte Dependabot ouverte, telle que la renvoie l'API GitHub, réduite à ce qui
26
+ * s'affiche ; `createdAt` est sa date d'émission, `scope` la portée de la
27
+ * dépendance, null quand GitHub ne la connaît pas.
28
+ */
17
29
  export const AlertSchema = z.object({
18
30
  number: z.number().int(),
19
31
  severity: z.enum(ALERT_SEVERITIES),
@@ -24,6 +36,7 @@ export const AlertSchema = z.object({
24
36
  url: z.string(),
25
37
  patchedVersion: z.string().nullable(),
26
38
  createdAt: z.string(),
39
+ scope: z.enum(DEPENDENCY_SCOPES).nullable(),
27
40
  });
28
41
  /**
29
42
  * Alerte que l'utilisateur a corrigée à la main alors que Dependabot la signale
@@ -77,12 +90,13 @@ export const OPERATION_KINDS = ["audit", "fix"];
77
90
  /** Qui a lancé l'opération : l'utilisateur depuis la GUI, ou l'agent par un outil MCP. */
78
91
  export const ORIGINS = ["user", "agent"];
79
92
  /**
80
- * `running` : une étape s'exécute ; `waiting_force` et `waiting_push` : l'utilisateur
81
- * doit décider de la suite ; les trois derniers états sont terminaux.
93
+ * `running` : une étape s'exécute ; `waiting_force`, `waiting_repair` et
94
+ * `waiting_push` : l'utilisateur doit décider de la suite ; les trois derniers
95
+ * états sont terminaux.
82
96
  */
83
- export const OPERATION_STATUSES = ["running", "waiting_force", "waiting_push", "done", "failed", "cancelled"];
84
- export const ACTIVE_STATUSES = ["running", "waiting_force", "waiting_push"];
85
- export const STEP_NAMES = ["clone", "audit", "fix", "analysis", "force", "push"];
97
+ export const OPERATION_STATUSES = ["running", "waiting_force", "waiting_repair", "waiting_push", "done", "failed", "cancelled"];
98
+ export const ACTIVE_STATUSES = ["running", "waiting_force", "waiting_repair", "waiting_push"];
99
+ export const STEP_NAMES = ["clone", "audit", "fix", "analysis", "force", "repair", "push"];
86
100
  export const STEP_STATES = ["pending", "running", "done", "skipped", "failed"];
87
101
  /** Correction proposée par `npm audit` : aucune, dans les plages déclarées, ou par une version majeure (`--force`). */
88
102
  export const FIX_KINDS = ["none", "available", "major"];
@@ -115,6 +129,18 @@ export const AnalysisReportSchema = z.object({
115
129
  urgent: z.array(z.object({ package: z.string(), reason: z.string() })),
116
130
  force: z.object({ recommended: z.boolean(), reason: z.string() }),
117
131
  });
132
+ /** Résultat des tests lancés par Claude après ses corrections. */
133
+ export const TEST_OUTCOMES = ["passed", "failed", "not_run"];
134
+ /**
135
+ * Rapport rendu par Claude à la fin de ses corrections : résumé, changement de
136
+ * chaque fichier, message du commit et résultat des tests.
137
+ */
138
+ export const RepairReportSchema = z.object({
139
+ summary: z.string(),
140
+ changes: z.array(z.object({ file: z.string(), change: z.string() })),
141
+ commitMessage: z.string(),
142
+ tests: z.object({ outcome: z.enum(TEST_OUTCOMES), detail: z.string() }),
143
+ });
118
144
  /** Statuts d'une tâche de l'organizer. */
119
145
  export const TASK_STATUSES = ["todo", "doing", "review", "done"];
120
146
  /** Tâche créée dans l'organizer par une analyse ; `url` ouvre la tâche sur le site, `status` est relu à chaque synchronisation. */
@@ -139,17 +165,43 @@ export const AnalysisSchema = z.object({
139
165
  error: z.string().nullable(),
140
166
  });
141
167
  /**
142
- * Opération d'audit ou de correction sur un clone temporaire. `workDir` est le
168
+ * Corrections par Claude, d'après la tâche de l'analyse et les commentaires de
169
+ * l'utilisateur. `base` est le commit sur lequel repose celui de Claude : le
170
+ * commit de `npm audit fix` (`auditCommit`), ou le commit cloné quand
171
+ * `npm audit fix` n'a rien changé et que `auditCommit` est null.
172
+ * `commit` est le commit de Claude, null tant qu'il n'a rien modifié ; `task`
173
+ * la sous-tâche « rapport de développement ». `turns` et `activity` suivent la
174
+ * session en cours ; `error` est la raison de l'échec du dernier passage, les
175
+ * résultats du passage précédent restant valables.
176
+ */
177
+ export const RepairSchema = z.object({
178
+ runs: z.number().int(),
179
+ startedAt: z.string(),
180
+ endedAt: z.string().nullable(),
181
+ turns: z.number().int(),
182
+ activity: z.array(z.string()),
183
+ base: z.string(),
184
+ auditCommit: z.string().nullable(),
185
+ commit: z.string().nullable(),
186
+ report: RepairReportSchema.nullable(),
187
+ task: AnalysisTaskSchema.nullable(),
188
+ error: z.string().nullable(),
189
+ });
190
+ /**
191
+ * Opération d'audit ou de correction sur un clone temporaire, limitée aux
192
+ * dépendances de `scope`. `workDir` est le
143
193
  * clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
144
194
  * qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
145
195
  * audit, `remaining` celles qui restent après la dernière étape. `analysis` est
146
- * l'analyse par Claude, null quand elle n'a pas été lancée.
196
+ * l'analyse par Claude, null quand elle n'a pas été lancée ; `repair` ses
197
+ * corrections, null tant qu'elles n'ont pas été lancées.
147
198
  */
148
199
  export const OperationSchema = z.object({
149
200
  id: z.string(),
150
201
  repoId: z.string(),
151
202
  kind: z.enum(OPERATION_KINDS),
152
203
  origin: z.enum(ORIGINS),
204
+ scope: z.enum(AUDIT_SCOPES),
153
205
  status: z.enum(OPERATION_STATUSES),
154
206
  createdAt: z.string(),
155
207
  updatedAt: z.string(),
@@ -163,6 +215,7 @@ export const OperationSchema = z.object({
163
215
  fix: z.enum(STEP_STATES),
164
216
  analysis: z.enum(STEP_STATES),
165
217
  force: z.enum(STEP_STATES),
218
+ repair: z.enum(STEP_STATES),
166
219
  push: z.enum(STEP_STATES),
167
220
  }),
168
221
  projects: z.array(z.string()),
@@ -170,6 +223,7 @@ export const OperationSchema = z.object({
170
223
  initial: z.number().int().nullable(),
171
224
  afterFix: z.number().int().nullable(),
172
225
  afterForce: z.number().int().nullable(),
226
+ afterRepair: z.number().int().nullable(),
173
227
  }),
174
228
  found: z.array(VulnerabilitySchema),
175
229
  remaining: z.array(VulnerabilitySchema),
@@ -179,6 +233,7 @@ export const OperationSchema = z.object({
179
233
  branch: z.string().nullable(),
180
234
  pullRequest: z.object({ number: z.number().int(), url: z.string() }).nullable(),
181
235
  analysis: AnalysisSchema.nullable(),
236
+ repair: RepairSchema.nullable(),
182
237
  error: z.string().nullable(),
183
238
  log: z.array(LogEntrySchema),
184
239
  });
@@ -1,12 +1,28 @@
1
- import { type AnalysisReport, type AnalysisTask, type ForceCandidate, type Operation } from "../../shared/schemas/model.schema.js";
1
+ import { type AnalysisReport, type AnalysisTask, type AuditScope, type ForceCandidate, type Operation } from "../../shared/schemas/model.schema.js";
2
2
  import type { Settings } from "../../shared/schemas/settings.schema.js";
3
3
  import { type ClaudeRuntime } from "./claude.js";
4
+ import { type OrganizerConnection } from "./organizer.js";
4
5
  import type { Store } from "./store.js";
6
+ /**
7
+ * Analyse par Claude des vulnérabilités que `npm audit fix` laisse dans un
8
+ * clone. Claude lit le code du clone (Read, Grep, Glob, sans commande ni
9
+ * écriture) et n'a accès qu'à quelques outils du MCP organizer, lancé pour la
10
+ * session avec le token réglé dans la GUI : il crée une tâche de reprise,
11
+ * l'assigne au propriétaire de l'espace, lui donne pour tag le nom du dépôt, et
12
+ * rend un rapport structuré. Le tracker relit ensuite la tâche sur
13
+ * l'organizer : une tâche absente, mal assignée ou mal taguée fait échouer
14
+ * l'analyse.
15
+ */
16
+ /** Nom du serveur MCP organizer dans la configuration de la session. */
17
+ export declare const ORGANIZER_SERVER = "organizer";
5
18
  /** Vulnérabilités d'un rapport `npm audit --json`, réduites à ce qui sert l'analyse. */
6
19
  export declare function auditFacts(report: any, project: string): unknown[];
20
+ /** JSON des vulnérabilités dans la limite de taille ; au-delà, les dernières sont seulement comptées. */
21
+ export declare function factsJson(facts: unknown[]): string;
7
22
  export interface AnalysisInput {
8
23
  repoId: string;
9
24
  branch: string;
25
+ scope: AuditScope;
10
26
  /** Clone du dépôt : dossier de travail de Claude. */
11
27
  cwd: string;
12
28
  /** Dossier de l'opération, hors du clone : configuration MCP de la session. */
@@ -18,6 +34,15 @@ export interface AnalysisInput {
18
34
  signal: AbortSignal;
19
35
  onLine: (line: string, turns: number) => void;
20
36
  }
37
+ /** Serveur MCP organizer de la session, lancé par `npx` avec le token réglé dans la GUI. */
38
+ export declare function organizerServer(connection: OrganizerConnection): {
39
+ command: string;
40
+ args: string[];
41
+ env: {
42
+ ORGANIZER_URL: string;
43
+ ORGANIZER_TOKEN: string;
44
+ };
45
+ };
21
46
  /** Lance l'analyse, puis vérifie sur l'organizer la tâche que Claude dit avoir créée. */
22
47
  export declare function analyseVulnerabilities(input: AnalysisInput): Promise<{
23
48
  report: AnalysisReport;
@@ -17,7 +17,7 @@ import { organizerConnection } from "./settings.js";
17
17
  * l'analyse.
18
18
  */
19
19
  /** Nom du serveur MCP organizer dans la configuration de la session. */
20
- const ORGANIZER_SERVER = "organizer";
20
+ export const ORGANIZER_SERVER = "organizer";
21
21
  const ORGANIZER_PACKAGE = "@imenam/mcp-organizer";
22
22
  /** Outils organizer autorisés ; tout autre appel est refusé par `dontAsk`. */
23
23
  const ORGANIZER_TOOLS = ["create_task", "set_assignees", "set_tags", "get_task"];
@@ -67,7 +67,7 @@ export function auditFacts(report, project) {
67
67
  }));
68
68
  }
69
69
  /** JSON des vulnérabilités dans la limite de taille ; au-delà, les dernières sont seulement comptées. */
70
- function factsJson(facts) {
70
+ export function factsJson(facts) {
71
71
  for (let count = facts.length; count > 0; count--) {
72
72
  const json = JSON.stringify(facts.slice(0, count), null, 1);
73
73
  if (json.length <= MAX_FACTS_CHARS)
@@ -84,6 +84,9 @@ function prompt(input, space, owner, tag) {
84
84
  ].join("\n");
85
85
  return [
86
86
  `You analyse the npm vulnerabilities that \`npm audit fix\` could not fix in the GitHub repository ${input.repoId} (branch ${input.branch}).`,
87
+ input.scope === "production"
88
+ ? "The audit and the fixes ran with `--omit=dev`: they cover the production dependencies only, and the vulnerabilities of the devDependencies are out of scope."
89
+ : "The audit and the fixes cover all the dependencies, devDependencies included.",
87
90
  "The current directory is a clone of that branch where `npm audit fix --package-lock-only` already updated the lockfiles. Read the code with Read, Grep and Glob; you cannot run commands nor change files.",
88
91
  "",
89
92
  "Remaining vulnerabilities, from `npm audit --json` (`project` is the folder of the package-lock.json):",
@@ -102,7 +105,7 @@ function prompt(input, space, owner, tag) {
102
105
  ].join("\n");
103
106
  }
104
107
  /** Serveur MCP organizer de la session, lancé par `npx` avec le token réglé dans la GUI. */
105
- function organizerServer(connection) {
108
+ export function organizerServer(connection) {
106
109
  const launch = process.platform === "win32" ? { command: "cmd", args: ["/c", "npx", "-y", ORGANIZER_PACKAGE] } : { command: "npx", args: ["-y", ORGANIZER_PACKAGE] };
107
110
  return { ...launch, env: { ORGANIZER_URL: connection.url, ORGANIZER_TOKEN: connection.token } };
108
111
  }
@@ -1,10 +1,10 @@
1
1
  import type { AuditAllState } from "../../shared/schemas/api.schema.js";
2
- import type { Operation } from "../../shared/schemas/model.schema.js";
2
+ import type { AuditScope, Operation } from "../../shared/schemas/model.schema.js";
3
3
  /** Audits menés en même temps par « Auditer tout ». */
4
4
  export declare const AUDIT_ALL_CONCURRENCY = 3;
5
5
  /**
6
- * Audit de tous les dépôts suivis, lancé depuis la GUI : `AUDIT_ALL_CONCURRENCY`
7
- * audits à la fois. Un dépôt dont une opération est déjà en cours est laissé de
6
+ * Audit de tous les dépôts suivis sur un même périmètre, lancé depuis la GUI :
7
+ * `AUDIT_ALL_CONCURRENCY` audits à la fois. Un dépôt dont une opération est déjà en cours est laissé de
8
8
  * côté. Une seule série à la fois dans ce processus.
9
9
  */
10
10
  export declare class AuditAll {
@@ -12,11 +12,11 @@ export declare class AuditAll {
12
12
  private readonly logError;
13
13
  private state;
14
14
  private run;
15
- constructor(audit: (repoId: string) => Promise<Operation>, logError: (message: string) => void);
15
+ constructor(audit: (repoId: string, scope: AuditScope) => Promise<Operation>, logError: (message: string) => void);
16
16
  /** État de la dernière série, null si aucune n'a été lancée. */
17
17
  status(): AuditAllState | null;
18
- /** Lance la série sur `repoIds` et rend aussitôt son état ; refusé si une série est en cours. */
19
- start(repoIds: string[]): AuditAllState;
18
+ /** Lance la série sur `repoIds`, périmètre `scope`, et rend aussitôt son état ; refusé si une série est en cours. */
19
+ start(repoIds: string[], scope: AuditScope): AuditAllState;
20
20
  /** Attend la fin de la série en cours. */
21
21
  finished(): Promise<void>;
22
22
  private auditAll;
@@ -2,8 +2,8 @@ import { ConflictError } from "./errors.js";
2
2
  /** Audits menés en même temps par « Auditer tout ». */
3
3
  export const AUDIT_ALL_CONCURRENCY = 3;
4
4
  /**
5
- * Audit de tous les dépôts suivis, lancé depuis la GUI : `AUDIT_ALL_CONCURRENCY`
6
- * audits à la fois. Un dépôt dont une opération est déjà en cours est laissé de
5
+ * Audit de tous les dépôts suivis sur un même périmètre, lancé depuis la GUI :
6
+ * `AUDIT_ALL_CONCURRENCY` audits à la fois. Un dépôt dont une opération est déjà en cours est laissé de
7
7
  * côté. Une seule série à la fois dans ce processus.
8
8
  */
9
9
  export class AuditAll {
@@ -19,11 +19,11 @@ export class AuditAll {
19
19
  status() {
20
20
  return this.state && { ...this.state, skipped: [...this.state.skipped], failed: [...this.state.failed] };
21
21
  }
22
- /** Lance la série sur `repoIds` et rend aussitôt son état ; refusé si une série est en cours. */
23
- start(repoIds) {
22
+ /** Lance la série sur `repoIds`, périmètre `scope`, et rend aussitôt son état ; refusé si une série est en cours. */
23
+ start(repoIds, scope) {
24
24
  if (this.state?.running)
25
25
  throw new ConflictError("An audit of every repository is already running.");
26
- this.state = { running: true, startedAt: new Date().toISOString(), finishedAt: null, total: repoIds.length, done: 0, skipped: [], failed: [] };
26
+ this.state = { running: true, scope, startedAt: new Date().toISOString(), finishedAt: null, total: repoIds.length, done: 0, skipped: [], failed: [] };
27
27
  this.run = this.auditAll(this.state, [...repoIds]);
28
28
  return this.status();
29
29
  }
@@ -42,7 +42,7 @@ export class AuditAll {
42
42
  }
43
43
  async auditOne(state, repoId) {
44
44
  try {
45
- const operation = await this.audit(repoId);
45
+ const operation = await this.audit(repoId, state.scope);
46
46
  if (operation.status !== "done")
47
47
  state.failed.push({ repoId, error: operation.error ?? operation.status });
48
48
  }
@@ -20,6 +20,8 @@ export interface ClaudeSessionOptions {
20
20
  prompt: string;
21
21
  /** Options propres à la session : outils, configuration MCP, schéma du résultat. */
22
22
  args: string[];
23
+ /** Variables propres à la session, en plus de celles du système. */
24
+ env?: Record<string, string>;
23
25
  token: string;
24
26
  maxTurns: number;
25
27
  maxMinutes: number;
@@ -11,8 +11,8 @@ export function packagedClaudeCommand() {
11
11
  }
12
12
  /** Variables du serveur transmises à Claude Code : chemins système et langue, aucun secret. */
13
13
  const PASSED_ENV = ["PATH", "LANG", "TMPDIR", "TEMP", "TMP", "SystemRoot", "SYSTEMROOT", "APPDATA", "LOCALAPPDATA"];
14
- function sessionEnv(runtime, token) {
15
- const env = { HOME: runtime.home, CLAUDE_CONFIG_DIR: runtime.home, CLAUDE_CODE_OAUTH_TOKEN: token };
14
+ function sessionEnv(runtime, token, extra) {
15
+ const env = { ...extra, HOME: runtime.home, CLAUDE_CONFIG_DIR: runtime.home, CLAUDE_CODE_OAUTH_TOKEN: token };
16
16
  for (const name of PASSED_ENV) {
17
17
  if (process.env[name] !== undefined)
18
18
  env[name] = process.env[name];
@@ -24,7 +24,7 @@ function shorten(text) {
24
24
  const first = text.trim().split(/\r?\n/)[0];
25
25
  return first.length > MAX_LINE ? `${first.slice(0, MAX_LINE)}…` : first;
26
26
  }
27
- /** Appel d'outil en clair : `Read src/app.ts`, `Grep mermaid`, `organizer create_task`. */
27
+ /** Appel d'outil en clair : `Read src/app.ts`, `Grep mermaid`, `Edit src/app.ts`, `$ npm test`, `organizer create_task`. */
28
28
  function describeTool(name, input, cwd) {
29
29
  const relative = (file) => (typeof file === "string" && path.isAbsolute(file) ? path.relative(cwd, file) || "." : String(file ?? ""));
30
30
  if (name === "Read")
@@ -33,6 +33,10 @@ function describeTool(name, input, cwd) {
33
33
  return `Grep ${input?.pattern ?? ""}${input?.path ? ` in ${relative(input.path)}` : ""}`;
34
34
  if (name === "Glob")
35
35
  return `Glob ${input?.pattern ?? ""}`;
36
+ if (name === "Edit" || name === "Write")
37
+ return `${name} ${relative(input?.file_path)}`;
38
+ if (name === "Bash")
39
+ return shorten(`$ ${input?.command ?? ""}`);
36
40
  const mcp = /^mcp__(.+?)__(.+)$/.exec(name);
37
41
  if (mcp)
38
42
  return `${mcp[1]} ${mcp[2]}`;
@@ -129,7 +133,7 @@ export function runClaudeSession(runtime, options) {
129
133
  return new Promise((resolve, reject) => {
130
134
  const child = spawn(command, args, {
131
135
  cwd: options.cwd,
132
- env: sessionEnv(runtime, options.token),
136
+ env: sessionEnv(runtime, options.token, options.env ?? {}),
133
137
  stdio: ["ignore", "pipe", "pipe"],
134
138
  detached: process.platform !== "win32",
135
139
  windowsHide: true,
@@ -16,13 +16,13 @@ export declare class CommandAbortedError extends Error {
16
16
  /** Arrête le processus et ses enfants : sous Windows, `npm` tourne dans un `cmd.exe` qui ne transmet pas le signal. */
17
17
  export declare function killTree(pid: number): void;
18
18
  /**
19
- * Lance `git` ou `npm` sans shell, et attend sa fin. La commande reçoit
19
+ * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
20
20
  * l'environnement du serveur sans GITHUB_TOKEN, plus `options.env`. Sous Windows,
21
21
  * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
22
22
  * arguments sont alors des options fixes, jamais une valeur venue de
23
23
  * l'utilisateur. Le code de sortie n'est pas interprété ici ; un dépassement de
24
24
  * `timeoutMs` ou l'annulation par `signal` arrêtent la commande.
25
25
  */
26
- export declare function runCommand(command: "git" | "npm", args: string[], options: CommandOptions): Promise<CommandResult>;
26
+ export declare function runCommand(command: "git" | "npm" | "bwrap", args: string[], options: CommandOptions): Promise<CommandResult>;
27
27
  /** Dernières lignes non vides d'une sortie, pour un message d'erreur ou le journal. */
28
28
  export declare function tail(text: string, lines?: number): string;
@@ -27,7 +27,7 @@ function inheritedEnv() {
27
27
  return env;
28
28
  }
29
29
  /**
30
- * Lance `git` ou `npm` sans shell, et attend sa fin. La commande reçoit
30
+ * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
31
31
  * l'environnement du serveur sans GITHUB_TOKEN, plus `options.env`. Sous Windows,
32
32
  * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
33
33
  * arguments sont alors des options fixes, jamais une valeur venue de
@@ -1,4 +1,4 @@
1
- import { ALERT_SEVERITIES } from "../../shared/schemas/model.schema.js";
1
+ import { ALERT_SEVERITIES, DEPENDENCY_SCOPES } from "../../shared/schemas/model.schema.js";
2
2
  import { NotFoundError, TrackerError } from "./errors.js";
3
3
  const REQUEST_TIMEOUT_MS = 30_000;
4
4
  /** Nombre maximal de pages d'alertes lues (100 alertes par page). */
@@ -176,5 +176,6 @@ function toAlert(raw) {
176
176
  url: raw.html_url ?? "",
177
177
  patchedVersion: raw.security_vulnerability?.first_patched_version?.identifier ?? null,
178
178
  createdAt: raw.created_at,
179
+ scope: DEPENDENCY_SCOPES.includes(raw.dependency?.scope) ? raw.dependency.scope : null,
179
180
  };
180
181
  }
@@ -0,0 +1,17 @@
1
+ import { type CommandResult } from "./commands.js";
2
+ export interface NpmSandbox {
3
+ /** Clone du dépôt, seul dossier du projet en écriture. */
4
+ root: string;
5
+ /** Cache npm de l'opération, hors du clone. */
6
+ cache: string;
7
+ }
8
+ /** Arguments de bubblewrap pour lancer `npm <args>` dans `cwd`, un dossier du clone. */
9
+ export declare function bwrapArgs(sandbox: NpmSandbox, cwd: string, args: string[]): string[];
10
+ /**
11
+ * Dossier d'un projet du clone, d'après son chemin relatif (`""` pour la
12
+ * racine) ; lève une erreur hors du clone, dans `node_modules` ou sans
13
+ * `package.json`.
14
+ */
15
+ export declare function projectDir(sandbox: NpmSandbox, project: string): string;
16
+ /** Lance `npm <args>` dans un projet du clone et rend son code de sortie et ses sorties. */
17
+ export declare function runSandboxedNpm(sandbox: NpmSandbox, project: string, args: string[], platform?: NodeJS.Platform): Promise<CommandResult>;
@@ -0,0 +1,89 @@
1
+ import fs from "fs";
2
+ import path from "path";
3
+ import { runCommand } from "./commands.js";
4
+ import { TrackerError } from "./errors.js";
5
+ /**
6
+ * Commandes npm lancées pour Claude pendant ses corrections, hors du bac à sable
7
+ * de Claude Code, qui garde en lecture seule les manifestes, les lockfiles et
8
+ * `node_modules`. Sous Linux, chaque commande tourne dans un bac à sable
9
+ * bubblewrap du tracker : système en lecture seule (`/usr`, `/etc`, Node.js…),
10
+ * clone et cache npm de l'opération en écriture, `/tmp` vide, aucun autre
11
+ * dossier du serveur visible (ni les données du tracker, ni les autres clones),
12
+ * environnement réduit à PATH, LANG, HOME et au cache npm. Ailleurs, la
13
+ * commande tourne directement dans le clone, avec le cache de l'opération.
14
+ */
15
+ /** Dossiers système montés en lecture seule, ou recréés en lien symbolique quand ils en sont un. */
16
+ const SYSTEM_DIRS = ["/usr", "/bin", "/sbin", "/lib", "/lib32", "/lib64", "/etc", "/opt", "/run/systemd/resolve"];
17
+ /** Variables transmises à npm : chemins, langue, HOME dans `/tmp`, cache de l'opération, mode CI pour que les tests ne restent pas en veille. */
18
+ function npmEnv(sandbox, home) {
19
+ return {
20
+ PATH: process.env.PATH ?? "/usr/bin:/bin",
21
+ LANG: process.env.LANG ?? "C.UTF-8",
22
+ HOME: home,
23
+ npm_config_cache: sandbox.cache,
24
+ npm_config_update_notifier: "false",
25
+ CI: "true",
26
+ };
27
+ }
28
+ /** Préfixe d'installation de Node.js (`<préfixe>/bin/node`), où se trouve aussi npm. */
29
+ function nodePrefix() {
30
+ return path.dirname(path.dirname(fs.realpathSync(process.execPath)));
31
+ }
32
+ /** Arguments de bubblewrap pour lancer `npm <args>` dans `cwd`, un dossier du clone. */
33
+ export function bwrapArgs(sandbox, cwd, args) {
34
+ const mounts = [];
35
+ for (const dir of [...SYSTEM_DIRS, nodePrefix()]) {
36
+ let stat;
37
+ try {
38
+ stat = fs.lstatSync(dir);
39
+ }
40
+ catch {
41
+ continue;
42
+ }
43
+ if (stat.isSymbolicLink())
44
+ mounts.push("--symlink", fs.readlinkSync(dir), dir);
45
+ else
46
+ mounts.push("--ro-bind", dir, dir);
47
+ }
48
+ const env = Object.entries(npmEnv(sandbox, "/tmp")).flatMap(([name, value]) => ["--setenv", name, value]);
49
+ return [
50
+ "--die-with-parent",
51
+ "--new-session",
52
+ "--unshare-pid",
53
+ "--unshare-ipc",
54
+ ...mounts,
55
+ "--dev", "/dev",
56
+ "--proc", "/proc",
57
+ "--tmpfs", "/tmp",
58
+ "--bind", sandbox.root, sandbox.root,
59
+ "--bind", sandbox.cache, sandbox.cache,
60
+ "--chdir", cwd,
61
+ "--clearenv",
62
+ ...env,
63
+ "npm",
64
+ ...args,
65
+ ];
66
+ }
67
+ /**
68
+ * Dossier d'un projet du clone, d'après son chemin relatif (`""` pour la
69
+ * racine) ; lève une erreur hors du clone, dans `node_modules` ou sans
70
+ * `package.json`.
71
+ */
72
+ export function projectDir(sandbox, project) {
73
+ const dir = path.resolve(sandbox.root, project);
74
+ const relative = path.relative(sandbox.root, dir);
75
+ if (relative.startsWith("..") || path.isAbsolute(relative) || relative.split(path.sep).includes("node_modules")) {
76
+ throw new TrackerError(`"${project}" is not a project folder of the repository.`);
77
+ }
78
+ if (!fs.existsSync(path.join(dir, "package.json")))
79
+ throw new TrackerError(`"${project || "."}" has no package.json.`);
80
+ return dir;
81
+ }
82
+ /** Lance `npm <args>` dans un projet du clone et rend son code de sortie et ses sorties. */
83
+ export function runSandboxedNpm(sandbox, project, args, platform = process.platform) {
84
+ const cwd = projectDir(sandbox, project);
85
+ fs.mkdirSync(sandbox.cache, { recursive: true });
86
+ if (platform === "linux")
87
+ return runCommand("bwrap", bwrapArgs(sandbox, cwd, args), { cwd: sandbox.root, env: {} });
88
+ return runCommand("npm", args, { cwd, env: npmEnv(sandbox, sandbox.cache) });
89
+ }
@@ -1,4 +1,4 @@
1
- import { type Operation, type OperationKind } from "../../shared/schemas/model.schema.js";
1
+ import { type AuditScope, type Operation, type OperationKind } from "../../shared/schemas/model.schema.js";
2
2
  import type { Settings } from "../../shared/schemas/settings.schema.js";
3
3
  import type { ClaudeRuntime } from "./claude.js";
4
4
  import type { GitHubConfig } from "./config.js";
@@ -19,6 +19,7 @@ export interface OperationContext {
19
19
  }
20
20
  /** Choix de l'agent pour une opération qu'il mène d'un bout à l'autre. */
21
21
  export interface AgentPlan {
22
+ scope: AuditScope;
22
23
  force: boolean;
23
24
  push: boolean;
24
25
  commitMessage: string;
@@ -28,19 +29,27 @@ export declare function branchName(date: Date): string;
28
29
  /** Vrai pour une branche nommée par `branchName`. */
29
30
  export declare function isTrackerBranch(branch: string): boolean;
30
31
  /**
31
- * Lance une correction depuis la GUI : clone, audit, `npm audit fix` et
32
- * l'analyse par Claude s'exécutent en arrière-plan, puis l'opération attend la
33
- * décision sur `--force` ou le push. Refusé sur un dépôt déprécié.
32
+ * Lance une correction depuis la GUI, sur le périmètre `scope` : clone, audit,
33
+ * `npm audit fix` et l'analyse par Claude s'exécutent en arrière-plan, puis
34
+ * l'opération attend la décision sur `--force`, les corrections par Claude ou
35
+ * le push. Refusé sur un dépôt déprécié.
34
36
  */
35
- export declare function startUserFix(ctx: OperationContext, repoId: string): Operation;
37
+ export declare function startUserFix(ctx: OperationContext, repoId: string, scope: AuditScope): Operation;
36
38
  /**
37
- * Audit de la branche par défaut, celle que Dependabot analyse, lancé par
38
- * l'utilisateur et attendu jusqu'à sa fin. Refusé si une opération est en
39
- * cours sur le dépôt, ou s'il est déprécié.
39
+ * Audit de la branche par défaut, celle que Dependabot analyse, sur le
40
+ * périmètre `scope`, lancé par l'utilisateur et attendu jusqu'à sa fin. Refusé
41
+ * si une opération est en cours sur le dépôt, ou s'il est déprécié.
40
42
  */
41
- export declare function runDefaultBranchAudit(ctx: OperationContext, repoId: string): Promise<Operation>;
43
+ export declare function runDefaultBranchAudit(ctx: OperationContext, repoId: string, scope: AuditScope): Promise<Operation>;
42
44
  /** Applique ou passe `npm audit fix --force` sur une opération qui attend cette décision. */
43
45
  export declare function decideForce(ctx: OperationContext, id: string, apply: boolean): Operation;
46
+ /**
47
+ * Lance ou passe les corrections par Claude d'une opération qui les attend ;
48
+ * `run` sur une opération qui attend le push après un passage relance Claude
49
+ * avec les remarques de l'utilisateur. Un lancement est refusé tant que le
50
+ * bac à sable de Claude Code ne peut pas démarrer sur le serveur.
51
+ */
52
+ export declare function decideRepair(ctx: OperationContext, id: string, run: boolean): Promise<Operation>;
44
53
  /** Commit, push et pull request d'une opération qui attend le push. */
45
54
  export declare function pushOperation(ctx: OperationContext, id: string, commitMessage: string): Operation;
46
55
  /**
@@ -50,8 +59,9 @@ export declare function pushOperation(ctx: OperationContext, id: string, commitM
50
59
  */
51
60
  export declare function cancelOperation(ctx: OperationContext, id: string): Operation;
52
61
  /**
53
- * Opération menée par l'agent d'un bout à l'autre, attendue jusqu'à sa fin :
54
- * `audit` s'arrête après `npm audit` ; `fix` enchaîne `npm audit fix`, puis
55
- * `--force` et le push selon `plan`. Refusé sur un dépôt déprécié.
62
+ * Opération menée par l'agent d'un bout à l'autre, sur le périmètre de `plan`,
63
+ * attendue jusqu'à sa fin : `audit` s'arrête après `npm audit` ; `fix` enchaîne
64
+ * `npm audit fix`, puis `--force` et le push selon `plan`. Refusé sur un dépôt
65
+ * déprécié.
56
66
  */
57
67
  export declare function runAgentOperation(ctx: OperationContext, repoId: string, kind: OperationKind, plan: AgentPlan): Promise<Operation>;