@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.
- package/README.md +33 -14
- package/dist/shared/alerts.d.ts +6 -1
- package/dist/shared/alerts.js +7 -0
- package/dist/shared/schemas/api.schema.d.ts +41 -9
- package/dist/shared/schemas/api.schema.js +5 -1
- package/dist/shared/schemas/ipc.schema.d.ts +1 -1
- package/dist/shared/schemas/ipc.schema.js +2 -0
- package/dist/shared/schemas/model.schema.d.ts +159 -7
- package/dist/shared/schemas/model.schema.js +63 -8
- package/dist/src/core/analysis.d.ts +26 -1
- package/dist/src/core/analysis.js +6 -3
- package/dist/src/core/audit-all.d.ts +6 -6
- package/dist/src/core/audit-all.js +6 -6
- package/dist/src/core/claude.d.ts +2 -0
- package/dist/src/core/claude.js +8 -4
- package/dist/src/core/commands.d.ts +2 -2
- package/dist/src/core/commands.js +1 -1
- package/dist/src/core/github.js +2 -1
- package/dist/src/core/npm-sandbox.d.ts +17 -0
- package/dist/src/core/npm-sandbox.js +89 -0
- package/dist/src/core/operations.d.ts +22 -12
- package/dist/src/core/operations.js +239 -44
- package/dist/src/core/organizer.d.ts +14 -0
- package/dist/src/core/organizer.js +17 -2
- package/dist/src/core/repair.d.ts +38 -0
- package/dist/src/core/repair.js +191 -0
- package/dist/src/core/repos.d.ts +11 -8
- package/dist/src/core/repos.js +38 -20
- package/dist/src/core/store.d.ts +2 -0
- package/dist/src/core/store.js +14 -5
- package/dist/src/gui-worker.js +20 -3
- package/dist/src/index.js +23 -8
- package/dist/src/npm-tools.d.ts +10 -0
- package/dist/src/npm-tools.js +136 -0
- package/dist/src/tools/format.js +20 -8
- package/dist/src/tools/tools.js +8 -6
- package/dist/src/tools/types.d.ts +2 -0
- package/dist/src/tools/types.js +9 -0
- package/gui/dist/assets/index-D98CR3xl.js +64 -0
- package/gui/dist/assets/index-DETLqB3f.css +1 -0
- package/gui/dist/index.html +2 -2
- package/package.json +1 -1
- package/gui/dist/assets/index-C1Ml-XiM.css +0 -1
- 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
|
-
/**
|
|
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
|
|
81
|
-
* doit décider de la suite ; les trois derniers
|
|
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
|
-
*
|
|
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 :
|
|
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 :
|
|
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;
|
package/dist/src/core/claude.js
CHANGED
|
@@ -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 `
|
|
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 `
|
|
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
|
package/dist/src/core/github.js
CHANGED
|
@@ -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,
|
|
32
|
-
* l'analyse par Claude s'exécutent en arrière-plan, puis
|
|
33
|
-
* décision sur `--force
|
|
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,
|
|
38
|
-
* l'utilisateur et attendu jusqu'à sa fin. Refusé
|
|
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,
|
|
54
|
-
* `audit` s'arrête après `npm audit` ; `fix` enchaîne
|
|
55
|
-
* `--force` et le push selon `plan`. Refusé sur un dépôt
|
|
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>;
|