@imenam/mcp-dependabot-tracker 1.0.9 → 1.0.11

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 +69 -18
  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 +45 -10
  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 +5 -0
  8. package/dist/shared/schemas/model.schema.d.ts +259 -7
  9. package/dist/shared/schemas/model.schema.js +95 -8
  10. package/dist/shared/schemas/settings.schema.d.ts +78 -0
  11. package/dist/shared/schemas/settings.schema.js +42 -0
  12. package/dist/src/core/analysis.d.ts +54 -0
  13. package/dist/src/core/analysis.js +180 -0
  14. package/dist/src/core/audit-all.d.ts +6 -6
  15. package/dist/src/core/audit-all.js +6 -6
  16. package/dist/src/core/claude.d.ts +45 -0
  17. package/dist/src/core/claude.js +200 -0
  18. package/dist/src/core/commands.d.ts +2 -0
  19. package/dist/src/core/commands.js +1 -1
  20. package/dist/src/core/github.js +2 -1
  21. package/dist/src/core/operations.d.ts +27 -12
  22. package/dist/src/core/operations.js +282 -42
  23. package/dist/src/core/organizer.d.ts +57 -0
  24. package/dist/src/core/organizer.js +110 -0
  25. package/dist/src/core/repair.d.ts +31 -0
  26. package/dist/src/core/repair.js +150 -0
  27. package/dist/src/core/repos.d.ts +14 -9
  28. package/dist/src/core/repos.js +45 -20
  29. package/dist/src/core/settings.d.ts +21 -0
  30. package/dist/src/core/settings.js +108 -0
  31. package/dist/src/core/store.d.ts +2 -0
  32. package/dist/src/core/store.js +20 -6
  33. package/dist/src/gui-worker.js +29 -3
  34. package/dist/src/index.js +47 -9
  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-CPYr3dz7.css +1 -0
  40. package/gui/dist/assets/index-CSbeloLm.js +64 -0
  41. package/gui/dist/index.html +2 -2
  42. package/package.json +2 -1
  43. package/gui/dist/assets/index-BdMhGHUf.css +0 -1
  44. package/gui/dist/assets/index-CIIsKFR9.js +0 -64
@@ -0,0 +1,54 @@
1
+ import { type AnalysisReport, type AnalysisTask, type AuditScope, type ForceCandidate, type Operation } from "../../shared/schemas/model.schema.js";
2
+ import type { Settings } from "../../shared/schemas/settings.schema.js";
3
+ import { type ClaudeRuntime } from "./claude.js";
4
+ import { type OrganizerConnection } from "./organizer.js";
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";
18
+ /** Vulnérabilités d'un rapport `npm audit --json`, réduites à ce qui sert l'analyse. */
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;
22
+ export interface AnalysisInput {
23
+ repoId: string;
24
+ branch: string;
25
+ scope: AuditScope;
26
+ /** Clone du dépôt : dossier de travail de Claude. */
27
+ cwd: string;
28
+ /** Dossier de l'opération, hors du clone : configuration MCP de la session. */
29
+ workDir: string;
30
+ facts: unknown[];
31
+ forceCandidates: ForceCandidate[];
32
+ settings: Settings;
33
+ claude: ClaudeRuntime;
34
+ signal: AbortSignal;
35
+ onLine: (line: string, turns: number) => void;
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
+ };
46
+ /** Lance l'analyse, puis vérifie sur l'organizer la tâche que Claude dit avoir créée. */
47
+ export declare function analyseVulnerabilities(input: AnalysisInput): Promise<{
48
+ report: AnalysisReport;
49
+ task: AnalysisTask;
50
+ }>;
51
+ /** Dernière opération du dépôt dont l'analyse a créé une tâche ; `operations` va de la plus récente à la plus ancienne. */
52
+ export declare function latestAnalysed(operations: Operation[]): Operation | null;
53
+ /** Relit sur l'organizer le statut de la dernière tâche d'analyse du dépôt, tant qu'elle n'est pas terminée. */
54
+ export declare function refreshAnalysisTask(store: Store, settings: Settings, repoId: string): Promise<void>;
@@ -0,0 +1,180 @@
1
+ import fs from "fs";
2
+ import path from "path";
3
+ import { z } from "zod";
4
+ import { AnalysisReportSchema } from "../../shared/schemas/model.schema.js";
5
+ import { runClaudeSession } from "./claude.js";
6
+ import { TrackerError } from "./errors.js";
7
+ import { OrganizerClient } from "./organizer.js";
8
+ import { organizerConnection } from "./settings.js";
9
+ /**
10
+ * Analyse par Claude des vulnérabilités que `npm audit fix` laisse dans un
11
+ * clone. Claude lit le code du clone (Read, Grep, Glob, sans commande ni
12
+ * écriture) et n'a accès qu'à quelques outils du MCP organizer, lancé pour la
13
+ * session avec le token réglé dans la GUI : il crée une tâche de reprise,
14
+ * l'assigne au propriétaire de l'espace, lui donne pour tag le nom du dépôt, et
15
+ * rend un rapport structuré. Le tracker relit ensuite la tâche sur
16
+ * l'organizer : une tâche absente, mal assignée ou mal taguée fait échouer
17
+ * l'analyse.
18
+ */
19
+ /** Nom du serveur MCP organizer dans la configuration de la session. */
20
+ export const ORGANIZER_SERVER = "organizer";
21
+ const ORGANIZER_PACKAGE = "@imenam/mcp-organizer";
22
+ /** Outils organizer autorisés ; tout autre appel est refusé par `dontAsk`. */
23
+ const ORGANIZER_TOOLS = ["create_task", "set_assignees", "set_tags", "get_task"];
24
+ /** Taille maximale des vulnérabilités transmises dans la consigne. */
25
+ const MAX_FACTS_CHARS = 20_000;
26
+ /** Chemins d'installation gardés par vulnérabilité. */
27
+ const MAX_NODES = 5;
28
+ /** Résultat demandé à Claude : le rapport et la clé de la tâche créée. */
29
+ const OutputSchema = AnalysisReportSchema.extend({ task: z.string().min(1) });
30
+ const OUTPUT_JSON_SCHEMA = {
31
+ type: "object",
32
+ additionalProperties: false,
33
+ required: ["task", "summary", "urgent", "force"],
34
+ properties: {
35
+ task: { type: "string", description: "Key of the organizer task you created, e.g. ORG-42." },
36
+ summary: { type: "string", description: "One sentence, in French." },
37
+ urgent: {
38
+ type: "array",
39
+ description: "Vulnerabilities to fix by hand urgently; empty when none.",
40
+ items: {
41
+ type: "object",
42
+ additionalProperties: false,
43
+ required: ["package", "reason"],
44
+ properties: { package: { type: "string" }, reason: { type: "string", description: "In French." } },
45
+ },
46
+ },
47
+ force: {
48
+ type: "object",
49
+ additionalProperties: false,
50
+ required: ["recommended", "reason"],
51
+ properties: { recommended: { type: "boolean" }, reason: { type: "string", description: "One or two sentences, in French." } },
52
+ },
53
+ },
54
+ };
55
+ /** Vulnérabilités d'un rapport `npm audit --json`, réduites à ce qui sert l'analyse. */
56
+ export function auditFacts(report, project) {
57
+ return Object.values((report?.vulnerabilities ?? {})).map((entry) => ({
58
+ project: project === "" ? "." : project,
59
+ name: entry.name,
60
+ severity: entry.severity,
61
+ isDirect: entry.isDirect,
62
+ range: entry.range,
63
+ via: (Array.isArray(entry.via) ? entry.via : []).map((via) => typeof via === "string" ? via : { title: via?.title, url: via?.url, range: via?.range, severity: via?.severity }),
64
+ effects: entry.effects,
65
+ fixAvailable: entry.fixAvailable,
66
+ nodes: (Array.isArray(entry.nodes) ? entry.nodes : []).slice(0, MAX_NODES),
67
+ }));
68
+ }
69
+ /** JSON des vulnérabilités dans la limite de taille ; au-delà, les dernières sont seulement comptées. */
70
+ export function factsJson(facts) {
71
+ for (let count = facts.length; count > 0; count--) {
72
+ const json = JSON.stringify(facts.slice(0, count), null, 1);
73
+ if (json.length <= MAX_FACTS_CHARS)
74
+ return count === facts.length ? json : `${json}\n(${facts.length - count} more vulnerabilities not listed)`;
75
+ }
76
+ return `(${facts.length} vulnerabilities, too large to list)`;
77
+ }
78
+ function prompt(input, space, owner, tag) {
79
+ const force = input.forceCandidates.length === 0
80
+ ? "No major upgrade fixes them: `npm audit fix --force` would change nothing."
81
+ : [
82
+ "`npm audit fix --force` would apply these major upgrades:",
83
+ ...input.forceCandidates.map((candidate) => `- ${candidate.project === "" ? "" : `${candidate.project}/`}${candidate.name} ${candidate.from ?? "?"} → ${candidate.to}`),
84
+ ].join("\n");
85
+ return [
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.",
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.",
91
+ "",
92
+ "Remaining vulnerabilities, from `npm audit --json` (`project` is the folder of the package-lock.json):",
93
+ "```json",
94
+ factsJson(input.facts),
95
+ "```",
96
+ "",
97
+ force,
98
+ "",
99
+ "Your job:",
100
+ "1. For each vulnerability, find in the code how the vulnerable package is used (directly, or through which dependency), whether the vulnerable code is reachable from this project, and how urgent a fix by hand is.",
101
+ "2. Decide whether `npm audit fix --force` is worth it: check which APIs of the upgraded packages this project uses and whether the major upgrade breaks them.",
102
+ `3. Create one task in the organizer space "${space}" with create_task, without request_id. Write its title and description in French. The description, in markdown, is a complete handover for another agent who will make the fix: the report per vulnerable package (usage in the code, reachability, urgency, advisory link), the decision about --force with its reason, the ordered list of actions, the files concerned, and how to check the result. Set its priority from the urgency.`,
103
+ `4. Assign the task to ${owner.name} with set_assignees (member id ${owner.id}), and set its tags to exactly ["${tag}"] with set_tags.`,
104
+ "5. Finish with the structured report: the key of the task, a one-sentence summary in French, the vulnerabilities to fix by hand urgently (empty when none), and your recommendation about `npm audit fix --force` with its reason, in French.",
105
+ ].join("\n");
106
+ }
107
+ /** Serveur MCP organizer de la session, lancé par `npx` avec le token réglé dans la GUI. */
108
+ export function organizerServer(connection) {
109
+ const launch = process.platform === "win32" ? { command: "cmd", args: ["/c", "npx", "-y", ORGANIZER_PACKAGE] } : { command: "npx", args: ["-y", ORGANIZER_PACKAGE] };
110
+ return { ...launch, env: { ORGANIZER_URL: connection.url, ORGANIZER_TOKEN: connection.token } };
111
+ }
112
+ /** Lance l'analyse, puis vérifie sur l'organizer la tâche que Claude dit avoir créée. */
113
+ export async function analyseVulnerabilities(input) {
114
+ const connection = organizerConnection(input.settings);
115
+ const token = input.settings.claude.token;
116
+ if (!connection || !token)
117
+ throw new TrackerError("The analysis needs the organizer connection and the Claude token: set them in the settings.");
118
+ const organizer = new OrganizerClient(connection);
119
+ const { space, owner } = await organizer.space();
120
+ const tag = input.repoId.split("/")[1];
121
+ const configFile = path.join(input.workDir, "analysis-mcp.json");
122
+ fs.writeFileSync(configFile, JSON.stringify({ mcpServers: { [ORGANIZER_SERVER]: organizerServer(connection) } }), { encoding: "utf-8", mode: 0o600 });
123
+ let structured;
124
+ try {
125
+ ({ structured } = await runClaudeSession(input.claude, {
126
+ cwd: input.cwd,
127
+ prompt: prompt(input, space.name, owner, tag),
128
+ args: [
129
+ "--tools",
130
+ "Read,Grep,Glob",
131
+ "--allowedTools",
132
+ ORGANIZER_TOOLS.map((tool) => `mcp__${ORGANIZER_SERVER}__${tool}`).join(","),
133
+ "--mcp-config",
134
+ configFile,
135
+ "--strict-mcp-config",
136
+ "--json-schema",
137
+ JSON.stringify(OUTPUT_JSON_SCHEMA),
138
+ ],
139
+ token,
140
+ maxTurns: input.settings.analysis.maxTurns,
141
+ maxMinutes: input.settings.analysis.maxMinutes,
142
+ signal: input.signal,
143
+ onLine: input.onLine,
144
+ }));
145
+ }
146
+ finally {
147
+ fs.rmSync(configFile, { force: true });
148
+ }
149
+ const output = OutputSchema.safeParse(structured);
150
+ if (!output.success)
151
+ throw new TrackerError("Claude Code ended without the structured report.");
152
+ const task = await organizer.task(output.data.task);
153
+ if (!task.tags.some((candidate) => candidate.toLowerCase() === tag.toLowerCase())) {
154
+ throw new TrackerError(`Task ${task.key} was created without the tag "${tag}".`);
155
+ }
156
+ if (!task.assigneeIds.includes(owner.id)) {
157
+ throw new TrackerError(`Task ${task.key} was created without being assigned to ${owner.name}.`);
158
+ }
159
+ const { task: _key, ...report } = output.data;
160
+ return { report, task: { key: task.key, title: task.title, url: organizer.taskUrl(task.id), status: task.status } };
161
+ }
162
+ /** Dernière opération du dépôt dont l'analyse a créé une tâche ; `operations` va de la plus récente à la plus ancienne. */
163
+ export function latestAnalysed(operations) {
164
+ return operations.find((operation) => operation.analysis?.task) ?? null;
165
+ }
166
+ /** Relit sur l'organizer le statut de la dernière tâche d'analyse du dépôt, tant qu'elle n'est pas terminée. */
167
+ export async function refreshAnalysisTask(store, settings, repoId) {
168
+ const connection = organizerConnection(settings);
169
+ const operation = latestAnalysed(store.listOperations(repoId));
170
+ const current = operation?.analysis?.task;
171
+ if (!connection || !operation || !current || current.status === "done")
172
+ return;
173
+ const { status } = await new OrganizerClient(connection).task(current.key);
174
+ if (status === current.status)
175
+ return;
176
+ store.updateOperation(operation.id, (latest) => ({
177
+ ...latest,
178
+ analysis: latest.analysis && latest.analysis.task ? { ...latest.analysis, task: { ...latest.analysis.task, status } } : latest.analysis,
179
+ }));
180
+ }
@@ -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
  }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Sessions Claude Code non interactives (`claude -p`, sortie `stream-json`).
3
+ * Claude Code s'authentifie par un token d'abonnement (`claude setup-token`)
4
+ * passé dans CLAUDE_CODE_OAUTH_TOKEN et garde sa configuration dans un dossier
5
+ * propre au tracker. Il ne reçoit aucune autre variable du serveur : ni
6
+ * GITHUB_TOKEN, ni les réglages du tracker. Seuls les réglages du dossier de
7
+ * configuration sont lus, jamais ceux du dossier de travail.
8
+ */
9
+ export interface ClaudeRuntime {
10
+ /** Commande de Claude Code et ses arguments fixes. */
11
+ command: string[];
12
+ /** Dossier personnel et de configuration de Claude Code. */
13
+ home: string;
14
+ }
15
+ /** Commande du paquet `@anthropic-ai/claude-code` : son lanceur Node, qui exécute le binaire natif de la plateforme. */
16
+ export declare function packagedClaudeCommand(): string[];
17
+ export interface ClaudeSessionOptions {
18
+ /** Dossier de travail : le seul que Claude Code lit sans autorisation. */
19
+ cwd: string;
20
+ prompt: string;
21
+ /** Options propres à la session : outils, configuration MCP, schéma du résultat. */
22
+ args: string[];
23
+ /** Variables propres à la session, en plus de celles du système. */
24
+ env?: Record<string, string>;
25
+ token: string;
26
+ maxTurns: number;
27
+ maxMinutes: number;
28
+ signal?: AbortSignal;
29
+ /** Reçoit chaque action lisible de Claude (texte ou appel d'outil) et le nombre de tours écoulés. */
30
+ onLine?: (line: string, turns: number) => void;
31
+ }
32
+ export interface ClaudeSessionResult {
33
+ /** Résultat validé par `--json-schema`, absent sans schéma. */
34
+ structured: unknown;
35
+ turns: number | null;
36
+ }
37
+ /**
38
+ * Lance une session et attend sa fin. Les tours sont limités par Claude Code,
39
+ * la durée par le tracker, qui tue alors la session avec ses descendants, comme
40
+ * à l'annulation par `signal`. Une session qui n'aboutit pas lève une erreur
41
+ * avec sa raison ; une annulation lève `CommandAbortedError`.
42
+ */
43
+ export declare function runClaudeSession(runtime: ClaudeRuntime, options: ClaudeSessionOptions): Promise<ClaudeSessionResult>;
44
+ /** Vérifie un token d'abonnement par une requête minimale ; lève une erreur avec la réponse de Claude Code s'il est refusé. */
45
+ export declare function checkClaudeToken(runtime: ClaudeRuntime, token: string): Promise<void>;
@@ -0,0 +1,200 @@
1
+ import { spawn } from "child_process";
2
+ import fs from "fs";
3
+ import { createRequire } from "module";
4
+ import path from "path";
5
+ import { CommandAbortedError, killTree } from "./commands.js";
6
+ import { TrackerError } from "./errors.js";
7
+ /** Commande du paquet `@anthropic-ai/claude-code` : son lanceur Node, qui exécute le binaire natif de la plateforme. */
8
+ export function packagedClaudeCommand() {
9
+ const require = createRequire(import.meta.url);
10
+ return [process.execPath, require.resolve("@anthropic-ai/claude-code/cli-wrapper.cjs")];
11
+ }
12
+ /** Variables du serveur transmises à Claude Code : chemins système et langue, aucun secret. */
13
+ const PASSED_ENV = ["PATH", "LANG", "TMPDIR", "TEMP", "TMP", "SystemRoot", "SYSTEMROOT", "APPDATA", "LOCALAPPDATA"];
14
+ function sessionEnv(runtime, token, extra) {
15
+ const env = { ...extra, HOME: runtime.home, CLAUDE_CONFIG_DIR: runtime.home, CLAUDE_CODE_OAUTH_TOKEN: token };
16
+ for (const name of PASSED_ENV) {
17
+ if (process.env[name] !== undefined)
18
+ env[name] = process.env[name];
19
+ }
20
+ return env;
21
+ }
22
+ const MAX_LINE = 240;
23
+ function shorten(text) {
24
+ const first = text.trim().split(/\r?\n/)[0];
25
+ return first.length > MAX_LINE ? `${first.slice(0, MAX_LINE)}…` : first;
26
+ }
27
+ /** Appel d'outil en clair : `Read src/app.ts`, `Grep mermaid`, `Edit src/app.ts`, `$ npm test`, `organizer create_task`. */
28
+ function describeTool(name, input, cwd) {
29
+ const relative = (file) => (typeof file === "string" && path.isAbsolute(file) ? path.relative(cwd, file) || "." : String(file ?? ""));
30
+ if (name === "Read")
31
+ return `Read ${relative(input?.file_path)}`;
32
+ if (name === "Grep")
33
+ return `Grep ${input?.pattern ?? ""}${input?.path ? ` in ${relative(input.path)}` : ""}`;
34
+ if (name === "Glob")
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 ?? ""}`);
40
+ const mcp = /^mcp__(.+?)__(.+)$/.exec(name);
41
+ if (mcp)
42
+ return `${mcp[1]} ${mcp[2]}`;
43
+ return name;
44
+ }
45
+ /** Lecture de la sortie `stream-json` : une ligne JSON par évènement, du texte brut pour les messages de Claude Code lui-même. */
46
+ class StreamReader {
47
+ cwd;
48
+ turns = 0;
49
+ result = null;
50
+ lastText = null;
51
+ messages = new Set();
52
+ pending = new Map();
53
+ constructor(cwd) {
54
+ this.cwd = cwd;
55
+ }
56
+ feed(source, chunk) {
57
+ const text = (this.pending.get(source) ?? "") + chunk;
58
+ const lines = text.split(/\r?\n/);
59
+ this.pending.set(source, lines.pop() ?? "");
60
+ return lines.flatMap((line) => this.line(line));
61
+ }
62
+ flush() {
63
+ const rest = [...this.pending.values()];
64
+ this.pending.clear();
65
+ return rest.flatMap((line) => this.line(line));
66
+ }
67
+ line(raw) {
68
+ const line = raw.trim();
69
+ if (line === "")
70
+ return [];
71
+ let event;
72
+ try {
73
+ event = JSON.parse(line);
74
+ }
75
+ catch {
76
+ this.lastText = shorten(line);
77
+ return [this.lastText];
78
+ }
79
+ if (event?.type === "assistant")
80
+ return this.assistant(event.message ?? {});
81
+ if (event?.type === "result") {
82
+ this.result = event;
83
+ if (typeof event.result === "string" && event.result.trim())
84
+ this.lastText = shorten(event.result);
85
+ }
86
+ return [];
87
+ }
88
+ assistant(message) {
89
+ if (typeof message.id === "string" && !this.messages.has(message.id)) {
90
+ this.messages.add(message.id);
91
+ this.turns += 1;
92
+ }
93
+ const lines = [];
94
+ for (const block of Array.isArray(message.content) ? message.content : []) {
95
+ if (block?.type === "text" && typeof block.text === "string" && block.text.trim()) {
96
+ this.lastText = shorten(block.text);
97
+ lines.push(this.lastText);
98
+ }
99
+ else if (block?.type === "tool_use" && typeof block.name === "string") {
100
+ lines.push(describeTool(block.name, block.input, this.cwd));
101
+ }
102
+ }
103
+ return lines;
104
+ }
105
+ }
106
+ /**
107
+ * Lance une session et attend sa fin. Les tours sont limités par Claude Code,
108
+ * la durée par le tracker, qui tue alors la session avec ses descendants, comme
109
+ * à l'annulation par `signal`. Une session qui n'aboutit pas lève une erreur
110
+ * avec sa raison ; une annulation lève `CommandAbortedError`.
111
+ */
112
+ export function runClaudeSession(runtime, options) {
113
+ if (options.signal?.aborted)
114
+ return Promise.reject(new CommandAbortedError());
115
+ fs.mkdirSync(runtime.home, { recursive: true, mode: 0o700 });
116
+ const [command, ...fixed] = runtime.command;
117
+ const args = [
118
+ ...fixed,
119
+ "-p",
120
+ options.prompt,
121
+ "--output-format",
122
+ "stream-json",
123
+ "--verbose",
124
+ "--max-turns",
125
+ String(options.maxTurns),
126
+ "--setting-sources",
127
+ "user",
128
+ "--permission-mode",
129
+ "dontAsk",
130
+ ...options.args,
131
+ ];
132
+ const reader = new StreamReader(options.cwd);
133
+ return new Promise((resolve, reject) => {
134
+ const child = spawn(command, args, {
135
+ cwd: options.cwd,
136
+ env: sessionEnv(runtime, options.token, options.env ?? {}),
137
+ stdio: ["ignore", "pipe", "pipe"],
138
+ detached: process.platform !== "win32",
139
+ windowsHide: true,
140
+ });
141
+ let settled = false;
142
+ let timedOut = false;
143
+ const stop = () => {
144
+ if (child.pid !== undefined && child.exitCode === null)
145
+ killTree(child.pid);
146
+ };
147
+ const timer = setTimeout(() => {
148
+ timedOut = true;
149
+ stop();
150
+ }, options.maxMinutes * 60_000);
151
+ options.signal?.addEventListener("abort", stop);
152
+ const emit = (lines) => {
153
+ for (const line of lines)
154
+ options.onLine?.(line, reader.turns);
155
+ };
156
+ const finish = (fn) => {
157
+ if (settled)
158
+ return;
159
+ settled = true;
160
+ clearTimeout(timer);
161
+ options.signal?.removeEventListener("abort", stop);
162
+ fn();
163
+ };
164
+ child.stdout.on("data", (chunk) => emit(reader.feed("stdout", String(chunk))));
165
+ child.stderr.on("data", (chunk) => emit(reader.feed("stderr", String(chunk))));
166
+ child.on("error", (err) => finish(() => reject(new TrackerError(`Cannot start Claude Code: ${err.message}`))));
167
+ child.on("close", (code) => {
168
+ emit(reader.flush());
169
+ finish(() => {
170
+ const result = reader.result;
171
+ if (options.signal?.aborted)
172
+ return reject(new CommandAbortedError());
173
+ if (timedOut)
174
+ return reject(new TrackerError(`Claude Code was stopped after ${options.maxMinutes} min.`));
175
+ if (result?.subtype === "error_max_turns")
176
+ return reject(new TrackerError(`Claude Code reached the limit of ${options.maxTurns} turns.`));
177
+ if (code !== 0 || !result || result.is_error === true) {
178
+ return reject(new TrackerError(`Claude Code stopped (exit code ${code})${reader.lastText ? `: ${reader.lastText}` : "."}`));
179
+ }
180
+ resolve({ structured: result.structured_output, turns: typeof result.num_turns === "number" ? result.num_turns : null });
181
+ });
182
+ });
183
+ });
184
+ }
185
+ /** Vérifie un token d'abonnement par une requête minimale ; lève une erreur avec la réponse de Claude Code s'il est refusé. */
186
+ export async function checkClaudeToken(runtime, token) {
187
+ try {
188
+ await runClaudeSession(runtime, {
189
+ cwd: runtime.home,
190
+ prompt: "Reply with OK.",
191
+ args: ["--tools", "", "--model", "haiku"],
192
+ token,
193
+ maxTurns: 1,
194
+ maxMinutes: 2,
195
+ });
196
+ }
197
+ catch (err) {
198
+ throw new TrackerError(`The Claude token was refused: ${err?.message ?? err}`);
199
+ }
200
+ }
@@ -13,6 +13,8 @@ export interface CommandOptions {
13
13
  export declare class CommandAbortedError extends Error {
14
14
  constructor();
15
15
  }
16
+ /** Arrête le processus et ses enfants : sous Windows, `npm` tourne dans un `cmd.exe` qui ne transmet pas le signal. */
17
+ export declare function killTree(pid: number): void;
16
18
  /**
17
19
  * Lance `git` ou `npm` sans shell, et attend sa fin. La commande reçoit
18
20
  * l'environnement du serveur sans GITHUB_TOKEN, plus `options.env`. Sous Windows,
@@ -9,7 +9,7 @@ export class CommandAbortedError extends Error {
9
9
  }
10
10
  const DEFAULT_TIMEOUT_MS = 10 * 60_000;
11
11
  /** Arrête le processus et ses enfants : sous Windows, `npm` tourne dans un `cmd.exe` qui ne transmet pas le signal. */
12
- function killTree(pid) {
12
+ export function killTree(pid) {
13
13
  if (process.platform === "win32") {
14
14
  spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore" });
15
15
  return;
@@ -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
  }
@@ -1,4 +1,6 @@
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
+ import type { Settings } from "../../shared/schemas/settings.schema.js";
3
+ import type { ClaudeRuntime } from "./claude.js";
2
4
  import type { GitHubConfig } from "./config.js";
3
5
  import { type Store } from "./store.js";
4
6
  /** Accès aux données et à GitHub pour exécuter les opérations. */
@@ -10,9 +12,14 @@ export interface OperationContext {
10
12
  cloneDir: () => string;
11
13
  /** Journalise une erreur d'une exécution en arrière-plan qui n'a pas pu être enregistrée dans l'opération. */
12
14
  logError: (message: string) => void;
15
+ /** Réglages de l'analyse par Claude, relus à chaque correction. */
16
+ settings: () => Settings;
17
+ /** Commande et dossier de configuration de Claude Code. */
18
+ claude: ClaudeRuntime;
13
19
  }
14
20
  /** Choix de l'agent pour une opération qu'il mène d'un bout à l'autre. */
15
21
  export interface AgentPlan {
22
+ scope: AuditScope;
16
23
  force: boolean;
17
24
  push: boolean;
18
25
  commitMessage: string;
@@ -22,19 +29,26 @@ export declare function branchName(date: Date): string;
22
29
  /** Vrai pour une branche nommée par `branchName`. */
23
30
  export declare function isTrackerBranch(branch: string): boolean;
24
31
  /**
25
- * Lance une correction depuis la GUI : clone, audit et `npm audit fix` s'exécutent
26
- * en arrière-plan, puis l'opération attend la décision sur `--force` ou le push.
27
- * 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é.
28
36
  */
29
- export declare function startUserFix(ctx: OperationContext, repoId: string): Operation;
37
+ export declare function startUserFix(ctx: OperationContext, repoId: string, scope: AuditScope): Operation;
30
38
  /**
31
- * Audit de la branche par défaut, celle que Dependabot analyse, lancé par
32
- * l'utilisateur et attendu jusqu'à sa fin. Refusé si une opération est en
33
- * 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é.
34
42
  */
35
- export declare function runDefaultBranchAudit(ctx: OperationContext, repoId: string): Promise<Operation>;
43
+ export declare function runDefaultBranchAudit(ctx: OperationContext, repoId: string, scope: AuditScope): Promise<Operation>;
36
44
  /** Applique ou passe `npm audit fix --force` sur une opération qui attend cette décision. */
37
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.
50
+ */
51
+ export declare function decideRepair(ctx: OperationContext, id: string, run: boolean): Operation;
38
52
  /** Commit, push et pull request d'une opération qui attend le push. */
39
53
  export declare function pushOperation(ctx: OperationContext, id: string, commitMessage: string): Operation;
40
54
  /**
@@ -44,8 +58,9 @@ export declare function pushOperation(ctx: OperationContext, id: string, commitM
44
58
  */
45
59
  export declare function cancelOperation(ctx: OperationContext, id: string): Operation;
46
60
  /**
47
- * Opération menée par l'agent d'un bout à l'autre, attendue jusqu'à sa fin :
48
- * `audit` s'arrête après `npm audit` ; `fix` enchaîne `npm audit fix`, puis
49
- * `--force` et le push selon `plan`. Refusé sur un dépôt déprécié.
61
+ * Opération menée par l'agent d'un bout à l'autre, sur le périmètre de `plan`,
62
+ * attendue jusqu'à sa fin : `audit` s'arrête après `npm audit` ; `fix` enchaîne
63
+ * `npm audit fix`, puis `--force` et le push selon `plan`. Refusé sur un dépôt
64
+ * déprécié.
50
65
  */
51
66
  export declare function runAgentOperation(ctx: OperationContext, repoId: string, kind: OperationKind, plan: AgentPlan): Promise<Operation>;