@imenam/mcp-dependabot-tracker 1.0.23 → 1.0.25

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 (73) hide show
  1. package/README.md +187 -76
  2. package/dist/shared/schemas/agent-token.schema.d.ts +47 -0
  3. package/dist/shared/schemas/agent-token.schema.js +18 -0
  4. package/dist/shared/schemas/api.schema.d.ts +25 -23
  5. package/dist/shared/schemas/api.schema.js +8 -8
  6. package/dist/shared/schemas/deploy.schema.d.ts +174 -0
  7. package/dist/shared/schemas/deploy.schema.js +72 -0
  8. package/dist/shared/schemas/model.schema.d.ts +9 -26
  9. package/dist/shared/schemas/model.schema.js +7 -15
  10. package/dist/src/cli/setup-mcp.d.ts +19 -16
  11. package/dist/src/cli/setup-mcp.js +35 -82
  12. package/dist/src/cli/users.d.ts +5 -0
  13. package/dist/src/cli/users.js +164 -0
  14. package/dist/src/core/agent-tokens.d.ts +15 -0
  15. package/dist/src/core/agent-tokens.js +96 -0
  16. package/dist/src/core/auth.d.ts +774 -0
  17. package/dist/src/core/auth.js +191 -0
  18. package/dist/src/core/commands.d.ts +1 -1
  19. package/dist/src/core/commands.js +47 -4
  20. package/dist/src/core/config.d.ts +2 -1
  21. package/dist/src/core/config.js +1 -4
  22. package/dist/src/core/data-dir.d.ts +3 -1
  23. package/dist/src/core/data-dir.js +11 -5
  24. package/dist/src/core/deploy-servers.d.ts +77 -0
  25. package/dist/src/core/deploy-servers.js +480 -0
  26. package/dist/src/core/deployments.d.ts +75 -0
  27. package/dist/src/core/deployments.js +387 -0
  28. package/dist/src/core/github.d.ts +2 -0
  29. package/dist/src/core/github.js +8 -0
  30. package/dist/src/core/log-dir.d.ts +1 -5
  31. package/dist/src/core/log-dir.js +1 -5
  32. package/dist/src/core/npm-sandbox.d.ts +19 -3
  33. package/dist/src/core/npm-sandbox.js +87 -17
  34. package/dist/src/core/operations.d.ts +20 -18
  35. package/dist/src/core/operations.js +86 -70
  36. package/dist/src/core/repair.d.ts +0 -7
  37. package/dist/src/core/repair.js +10 -33
  38. package/dist/src/core/repos.d.ts +2 -3
  39. package/dist/src/core/repos.js +4 -7
  40. package/dist/src/core/server-config.d.ts +29 -0
  41. package/dist/src/core/server-config.js +85 -0
  42. package/dist/src/core/settings.d.ts +9 -3
  43. package/dist/src/core/settings.js +49 -10
  44. package/dist/src/core/ssh.d.ts +31 -0
  45. package/dist/src/core/ssh.js +82 -0
  46. package/dist/src/core/store.d.ts +5 -12
  47. package/dist/src/core/store.js +82 -160
  48. package/dist/src/core/vault.d.ts +10 -0
  49. package/dist/src/core/vault.js +50 -0
  50. package/dist/src/index.d.ts +9 -0
  51. package/dist/src/index.js +46 -455
  52. package/dist/src/mcp.d.ts +6 -0
  53. package/dist/src/mcp.js +59 -0
  54. package/dist/src/server/app.d.ts +47 -0
  55. package/dist/src/server/app.js +273 -0
  56. package/dist/src/server/serve.d.ts +7 -0
  57. package/dist/src/server/serve.js +178 -0
  58. package/dist/src/tools/client.d.ts +15 -0
  59. package/dist/src/tools/client.js +62 -0
  60. package/dist/src/tools/format.d.ts +4 -5
  61. package/dist/src/tools/format.js +39 -16
  62. package/dist/src/tools/tools.d.ts +101 -15
  63. package/dist/src/tools/tools.js +91 -62
  64. package/gui/dist/assets/index-FrRzRTkV.js +71 -0
  65. package/gui/dist/assets/index-o3l3BAZD.css +1 -0
  66. package/gui/dist/index.html +2 -2
  67. package/package.json +11 -4
  68. package/dist/shared/schemas/ipc.schema.d.ts +0 -26
  69. package/dist/shared/schemas/ipc.schema.js +0 -53
  70. package/dist/src/gui-worker.d.ts +0 -1
  71. package/dist/src/gui-worker.js +0 -379
  72. package/gui/dist/assets/index-CS33iXZk.css +0 -1
  73. package/gui/dist/assets/index-CZN3w6nU.js +0 -64
@@ -0,0 +1,47 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * Token d'accès d'un agent, enregistré dans `<données>/agent-tokens.json` :
4
+ * `hash` est l'empreinte SHA-256 du token, qui n'est jamais conservé en clair ;
5
+ * `hint` ses quatre derniers caractères ; `lastUsedAt` la date de sa dernière
6
+ * utilisation, null s'il n'a jamais servi.
7
+ */
8
+ export declare const AgentTokenSchema: z.ZodObject<{
9
+ id: z.ZodString;
10
+ name: z.ZodString;
11
+ hash: z.ZodString;
12
+ hint: z.ZodString;
13
+ createdAt: z.ZodString;
14
+ lastUsedAt: z.ZodNullable<z.ZodString>;
15
+ }, z.core.$strip>;
16
+ export type AgentToken = z.infer<typeof AgentTokenSchema>;
17
+ export declare const AgentTokensFileSchema: z.ZodObject<{
18
+ tokens: z.ZodArray<z.ZodObject<{
19
+ id: z.ZodString;
20
+ name: z.ZodString;
21
+ hash: z.ZodString;
22
+ hint: z.ZodString;
23
+ createdAt: z.ZodString;
24
+ lastUsedAt: z.ZodNullable<z.ZodString>;
25
+ }, z.core.$strip>>;
26
+ }, z.core.$strip>;
27
+ export type AgentTokensFile = z.infer<typeof AgentTokensFileSchema>;
28
+ /** Token tel que la GUI le reçoit : sans son empreinte. */
29
+ export type AgentTokenView = Omit<AgentToken, "hash">;
30
+ /** Tokens d'agent, du plus récent au plus ancien. */
31
+ export interface AgentTokensResponse {
32
+ tokens: AgentTokenView[];
33
+ }
34
+ /** Corps de `POST /api/agent-tokens`. */
35
+ export declare const CreateAgentTokenBodySchema: z.ZodObject<{
36
+ name: z.ZodString;
37
+ }, z.core.$strip>;
38
+ export type CreateAgentTokenBody = z.infer<typeof CreateAgentTokenBodySchema>;
39
+ /**
40
+ * Token qui vient d'être créé : `secret` est le token en clair, rendu une seule
41
+ * fois ; `setupCommand` la commande qui déclare le mode MCP avec ce token.
42
+ */
43
+ export interface CreatedAgentTokenResponse {
44
+ token: AgentTokenView;
45
+ secret: string;
46
+ setupCommand: string;
47
+ }
@@ -0,0 +1,18 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * Token d'accès d'un agent, enregistré dans `<données>/agent-tokens.json` :
4
+ * `hash` est l'empreinte SHA-256 du token, qui n'est jamais conservé en clair ;
5
+ * `hint` ses quatre derniers caractères ; `lastUsedAt` la date de sa dernière
6
+ * utilisation, null s'il n'a jamais servi.
7
+ */
8
+ export const AgentTokenSchema = z.object({
9
+ id: z.string(),
10
+ name: z.string(),
11
+ hash: z.string(),
12
+ hint: z.string(),
13
+ createdAt: z.string(),
14
+ lastUsedAt: z.string().nullable(),
15
+ });
16
+ export const AgentTokensFileSchema = z.object({ tokens: z.array(AgentTokenSchema) });
17
+ /** Corps de `POST /api/agent-tokens`. */
18
+ export const CreateAgentTokenBodySchema = z.object({ name: z.string().trim().min(1).max(60) });
@@ -6,14 +6,6 @@ export declare const AddRepoBodySchema: z.ZodObject<{
6
6
  categoryId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
7
7
  }, z.core.$strip>;
8
8
  export type AddRepoBody = z.infer<typeof AddRepoBodySchema>;
9
- export declare const SetRightsBodySchema: z.ZodObject<{
10
- rights: z.ZodObject<{
11
- audit: z.ZodBoolean;
12
- fix: z.ZodBoolean;
13
- push: z.ZodBoolean;
14
- }, z.core.$strip>;
15
- }, z.core.$strip>;
16
- export type SetRightsBody = z.infer<typeof SetRightsBodySchema>;
17
9
  export declare const SetBranchBodySchema: z.ZodObject<{
18
10
  branch: z.ZodString;
19
11
  }, z.core.$strip>;
@@ -28,9 +20,6 @@ export declare const CategoryBodySchema: z.ZodObject<{
28
20
  name: z.ZodString;
29
21
  }, z.core.$strip>;
30
22
  export type CategoryBody = z.infer<typeof CategoryBodySchema>;
31
- export declare const CategoryRequestSchema: z.ZodObject<{
32
- categoryId: z.ZodString;
33
- }, z.core.$strip>;
34
23
  /** Catégories dans l'ordre alphabétique. */
35
24
  export interface CategoriesResponse {
36
25
  categories: Category[];
@@ -78,18 +67,30 @@ export declare const MergedBodySchema: z.ZodObject<{
78
67
  deploy: z.ZodBoolean;
79
68
  }, z.core.$strip>;
80
69
  export type MergedBody = z.infer<typeof MergedBodySchema>;
81
- /** Identifiant d'un dépôt dans une requête IPC. */
82
- export declare const RepoRequestSchema: z.ZodObject<{
83
- repoId: z.ZodString;
84
- }, z.core.$strip>;
85
- /** Alerte d'un dépôt, par son numéro GitHub. */
86
- export declare const AlertRequestSchema: z.ZodObject<{
87
- repoId: z.ZodString;
88
- number: z.ZodCoercedNumber<unknown>;
89
- }, z.core.$strip>;
90
- export declare const OperationRequestSchema: z.ZodObject<{
91
- operationId: z.ZodString;
70
+ /** Numéro GitHub d'une alerte, porté par le chemin de la requête. */
71
+ export declare const AlertNumberSchema: z.ZodCoercedNumber<unknown>;
72
+ /**
73
+ * Corps de `POST /api/agent/repos/:owner/:name/fixes` : le périmètre, et les
74
+ * corrections par Claude quand `npm audit fix` laisse des vulnérabilités.
75
+ */
76
+ export declare const AgentFixBodySchema: z.ZodObject<{
77
+ scope: z.ZodEnum<{
78
+ all: "all";
79
+ production: "production";
80
+ }>;
81
+ claude: z.ZodBoolean;
92
82
  }, z.core.$strip>;
83
+ export type AgentFixBody = z.infer<typeof AgentFixBodySchema>;
84
+ /** Dépôts non dépréciés renvoyés à un agent : tous, ou ceux de `category` quand il en a demandé une. */
85
+ export interface AgentReposResponse {
86
+ repos: RepoView[];
87
+ category: Category | null;
88
+ }
89
+ /** Opération renvoyée à un agent, avec l'adresse de son écran dans la GUI. */
90
+ export interface AgentOperationResponse {
91
+ operation: Operation;
92
+ guiUrl: string;
93
+ }
93
94
  /** Vulnérabilités trouvées par un audit : leur nombre, la plus haute gravité, la date et le périmètre de l'audit. */
94
95
  export interface AuditFindings {
95
96
  at: string;
@@ -203,8 +204,9 @@ export interface OperationSummary {
203
204
  export interface OperationsResponse {
204
205
  operations: OperationSummary[];
205
206
  }
207
+ /** Configuration lue par la GUI ; `githubServerUrl` est l'adresse web du serveur GitHub, sans barre finale. */
206
208
  export interface AppConfig {
207
209
  version: string;
208
210
  dataDir: string;
209
- githubConfigured: boolean;
211
+ githubServerUrl: string;
210
212
  }
@@ -1,17 +1,15 @@
1
1
  import { z } from "zod";
2
- import { AUDIT_SCOPES, RightsSchema } from "./model.schema.js";
2
+ import { AUDIT_SCOPES } from "./model.schema.js";
3
3
  /** Corps de `POST /api/repos` : `propriétaire/nom` ou lien GitHub, et la catégorie où le ranger (aucune par défaut). */
4
4
  export const AddRepoBodySchema = z.object({
5
5
  repository: z.string().trim().min(1),
6
6
  categoryId: z.string().min(1).nullable().default(null),
7
7
  });
8
- export const SetRightsBodySchema = z.object({ rights: RightsSchema });
9
8
  export const SetBranchBodySchema = z.object({ branch: z.string().trim().min(1) });
10
9
  /** Catégorie du dépôt ; null le sort de toute catégorie. */
11
10
  export const SetCategoryBodySchema = z.object({ categoryId: z.string().min(1).nullable() });
12
11
  /** Corps de `POST /api/categories` et de `PUT /api/categories/:id`. */
13
12
  export const CategoryBodySchema = z.object({ name: z.string().trim().min(1).max(60) });
14
- export const CategoryRequestSchema = z.object({ categoryId: z.string().min(1) });
15
13
  /** Corps de `POST /api/repos/:owner/:name/operations` : le périmètre de l'audit. */
16
14
  export const ScopeBodySchema = z.object({ scope: z.enum(AUDIT_SCOPES) });
17
15
  /** Dépôts visés par « Auditer tout » : tous les dépôts suivis, ceux d'une catégorie, ou ceux de la file d'attente. */
@@ -24,8 +22,10 @@ export const AuditTargetSchema = z.discriminatedUnion("kind", [
24
22
  export const AuditAllBodySchema = ScopeBodySchema.extend({ target: AuditTargetSchema });
25
23
  /** `deploy` : le dépôt passe aussi « à déployer », son déploiement n'étant pas automatique. */
26
24
  export const MergedBodySchema = z.object({ deploy: z.boolean() });
27
- /** Identifiant d'un dépôt dans une requête IPC. */
28
- export const RepoRequestSchema = z.object({ repoId: z.string().min(1) });
29
- /** Alerte d'un dépôt, par son numéro GitHub. */
30
- export const AlertRequestSchema = z.object({ repoId: z.string().min(1), number: z.coerce.number().int().positive() });
31
- export const OperationRequestSchema = z.object({ operationId: z.string().min(1) });
25
+ /** Numéro GitHub d'une alerte, porté par le chemin de la requête. */
26
+ export const AlertNumberSchema = z.coerce.number().int().positive();
27
+ /**
28
+ * Corps de `POST /api/agent/repos/:owner/:name/fixes` : le périmètre, et les
29
+ * corrections par Claude quand `npm audit fix` laisse des vulnérabilités.
30
+ */
31
+ export const AgentFixBodySchema = ScopeBodySchema.extend({ claude: z.boolean() });
@@ -0,0 +1,174 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * Serveur de déploiement, tel que l'interface le voit : connexion SSH par une
4
+ * clé ed25519 propre au tracker. `publicKey` est la clé à installer sur le
5
+ * serveur, null quand elle a été révoquée ; `keyCreatedAt` la date de sa
6
+ * génération ; `allowedFrom` l'adresse du tracker à laquelle sa ligne est limitée,
7
+ * null tant qu'aucun test ne l'a posée ; `hostKeyFingerprint` l'empreinte de la
8
+ * clé d'hôte enregistrée au premier test réussi, vérifiée à chaque connexion ;
9
+ * `testedAt` la date du dernier test réussi.
10
+ */
11
+ export declare const DeployServerSchema: z.ZodObject<{
12
+ id: z.ZodString;
13
+ name: z.ZodString;
14
+ host: z.ZodString;
15
+ port: z.ZodNumber;
16
+ username: z.ZodString;
17
+ publicKey: z.ZodNullable<z.ZodString>;
18
+ keyCreatedAt: z.ZodNullable<z.ZodString>;
19
+ allowedFrom: z.ZodNullable<z.ZodString>;
20
+ hostKeyFingerprint: z.ZodNullable<z.ZodString>;
21
+ createdAt: z.ZodString;
22
+ testedAt: z.ZodNullable<z.ZodString>;
23
+ }, z.core.$strip>;
24
+ export type DeployServer = z.infer<typeof DeployServerSchema>;
25
+ /** Serveur enregistré : la vue de l'interface et la clé privée, chiffrée avec VAULT_KEY ; null quand la clé a été révoquée. */
26
+ export declare const StoredDeployServerSchema: z.ZodObject<{
27
+ id: z.ZodString;
28
+ name: z.ZodString;
29
+ host: z.ZodString;
30
+ port: z.ZodNumber;
31
+ username: z.ZodString;
32
+ publicKey: z.ZodNullable<z.ZodString>;
33
+ keyCreatedAt: z.ZodNullable<z.ZodString>;
34
+ allowedFrom: z.ZodNullable<z.ZodString>;
35
+ hostKeyFingerprint: z.ZodNullable<z.ZodString>;
36
+ createdAt: z.ZodString;
37
+ testedAt: z.ZodNullable<z.ZodString>;
38
+ privateKeyEncrypted: z.ZodNullable<z.ZodString>;
39
+ }, z.core.$strip>;
40
+ export type StoredDeployServer = z.infer<typeof StoredDeployServerSchema>;
41
+ export declare const DeployServersFileSchema: z.ZodObject<{
42
+ servers: z.ZodArray<z.ZodObject<{
43
+ id: z.ZodString;
44
+ name: z.ZodString;
45
+ host: z.ZodString;
46
+ port: z.ZodNumber;
47
+ username: z.ZodString;
48
+ publicKey: z.ZodNullable<z.ZodString>;
49
+ keyCreatedAt: z.ZodNullable<z.ZodString>;
50
+ allowedFrom: z.ZodNullable<z.ZodString>;
51
+ hostKeyFingerprint: z.ZodNullable<z.ZodString>;
52
+ createdAt: z.ZodString;
53
+ testedAt: z.ZodNullable<z.ZodString>;
54
+ privateKeyEncrypted: z.ZodNullable<z.ZodString>;
55
+ }, z.core.$strip>>;
56
+ }, z.core.$strip>;
57
+ export type DeployServersFile = z.infer<typeof DeployServersFileSchema>;
58
+ /** Champs saisis pour un serveur. */
59
+ export declare const DeployServerBodySchema: z.ZodObject<{
60
+ name: z.ZodString;
61
+ host: z.ZodString;
62
+ port: z.ZodCoercedNumber<unknown>;
63
+ username: z.ZodString;
64
+ }, z.core.$strip>;
65
+ export type DeployServerBody = z.infer<typeof DeployServerBodySchema>;
66
+ /** `running` : le script s'exécute ; les trois autres états sont terminaux. */
67
+ export declare const DEPLOYMENT_STATUSES: readonly ["running", "done", "failed", "cancelled"];
68
+ export type DeploymentStatus = (typeof DEPLOYMENT_STATUSES)[number];
69
+ /**
70
+ * Exécution du script de déploiement d'un dépôt sur son serveur. `script` est
71
+ * le script tel qu'il a été lancé ; `branch` et `commit` les valeurs de
72
+ * $BRANCH et $COMMIT ; `server` le serveur, en clair (`nom · utilisateur@hôte:port`).
73
+ * `currentLine` est la dernière ligne du script commencée, `exitCode` le code
74
+ * de sortie du script, `output` sa sortie, stdout et stderr fusionnés, dont seule
75
+ * la fin est gardée au-delà de la limite (`outputTruncated`).
76
+ */
77
+ export declare const DeploymentSchema: z.ZodObject<{
78
+ id: z.ZodString;
79
+ repoId: z.ZodString;
80
+ serverId: z.ZodString;
81
+ server: z.ZodString;
82
+ branch: z.ZodString;
83
+ commit: z.ZodNullable<z.ZodString>;
84
+ script: z.ZodString;
85
+ status: z.ZodEnum<{
86
+ cancelled: "cancelled";
87
+ done: "done";
88
+ failed: "failed";
89
+ running: "running";
90
+ }>;
91
+ createdAt: z.ZodString;
92
+ updatedAt: z.ZodString;
93
+ endedAt: z.ZodNullable<z.ZodString>;
94
+ currentLine: z.ZodNullable<z.ZodNumber>;
95
+ exitCode: z.ZodNullable<z.ZodNumber>;
96
+ output: z.ZodString;
97
+ outputTruncated: z.ZodBoolean;
98
+ cancelRequested: z.ZodBoolean;
99
+ error: z.ZodNullable<z.ZodString>;
100
+ }, z.core.$strip>;
101
+ export type Deployment = z.infer<typeof DeploymentSchema>;
102
+ /** Ligne de la liste des déploiements : un déploiement sans son script ni sa sortie. */
103
+ export type DeploymentSummary = Omit<Deployment, "script" | "output">;
104
+ /** Corps de l'enregistrement du script d'un dépôt. */
105
+ export declare const SaveScriptBodySchema: z.ZodObject<{
106
+ script: z.ZodString;
107
+ }, z.core.$strip>;
108
+ /** Corps du choix du serveur d'un dépôt ; null le détache. */
109
+ export declare const SetDeployServerBodySchema: z.ZodObject<{
110
+ serverId: z.ZodNullable<z.ZodString>;
111
+ }, z.core.$strip>;
112
+ /**
113
+ * Serveur, commande d'installation de sa clé et commande qui la retire du
114
+ * fichier dédié, à lancer sur le serveur ; les deux sont null sans clé.
115
+ */
116
+ export interface DeployServerView {
117
+ server: DeployServer;
118
+ installCommand: string | null;
119
+ revokeCommand: string | null;
120
+ }
121
+ /** État d'une étape d'un renouvellement de clé. */
122
+ export type KeyStepStatus = "done" | "failed" | "skipped";
123
+ /** Déroulé d'un renouvellement : générer, ajouter, tester, retirer l'ancienne clé ; `error` dit pourquoi il s'est arrêté. */
124
+ export interface RotationResponse {
125
+ server: DeployServerView;
126
+ steps: KeyStepStatus[];
127
+ error: string | null;
128
+ }
129
+ /** Serveurs enregistrés, du plus ancien au plus récent. */
130
+ export interface DeployServersResponse {
131
+ servers: DeployServerView[];
132
+ }
133
+ /**
134
+ * Déploiement d'un dépôt : son serveur (null s'il n'en a pas), son script, le
135
+ * déploiement en cours et les derniers déploiements, du plus récent au plus ancien.
136
+ */
137
+ export interface RepoDeployResponse {
138
+ server: DeployServerView | null;
139
+ script: string;
140
+ activeDeployment: Deployment | null;
141
+ deployments: DeploymentSummary[];
142
+ }
143
+ export interface DeploymentResponse {
144
+ deployment: Deployment;
145
+ }
146
+ /**
147
+ * Place de la clé sur le serveur après un test : dans le fichier dédié ou
148
+ * non, présente aussi dans ~/.ssh/authorized_keys ou non, adresse à laquelle
149
+ * sa ligne est limitée, et la raison pour laquelle la limite n'a pas été posée.
150
+ */
151
+ export interface KeyFileStatus {
152
+ inDedicatedFile: boolean;
153
+ inAuthorizedKeys: boolean;
154
+ allowedFrom: string | null;
155
+ restrictError: string | null;
156
+ }
157
+ /** Résultat d'un test de connexion réussi. */
158
+ export interface TestDeployServerResponse {
159
+ server: DeployServerView;
160
+ fingerprint: string;
161
+ cwd: string;
162
+ keyFile: KeyFileStatus;
163
+ }
164
+ /** Variables que le tracker définit pour le script, avec leur rôle. */
165
+ export declare const SCRIPT_VARIABLES: readonly [{
166
+ readonly name: "BRANCH";
167
+ readonly description: "branche suivie du dépôt";
168
+ }, {
169
+ readonly name: "COMMIT";
170
+ readonly description: "dernier commit de cette branche sur GitHub";
171
+ }, {
172
+ readonly name: "REPO";
173
+ readonly description: "dépôt, propriétaire/nom";
174
+ }];
@@ -0,0 +1,72 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * Serveur de déploiement, tel que l'interface le voit : connexion SSH par une
4
+ * clé ed25519 propre au tracker. `publicKey` est la clé à installer sur le
5
+ * serveur, null quand elle a été révoquée ; `keyCreatedAt` la date de sa
6
+ * génération ; `allowedFrom` l'adresse du tracker à laquelle sa ligne est limitée,
7
+ * null tant qu'aucun test ne l'a posée ; `hostKeyFingerprint` l'empreinte de la
8
+ * clé d'hôte enregistrée au premier test réussi, vérifiée à chaque connexion ;
9
+ * `testedAt` la date du dernier test réussi.
10
+ */
11
+ export const DeployServerSchema = z.object({
12
+ id: z.string(),
13
+ name: z.string(),
14
+ host: z.string(),
15
+ port: z.number().int(),
16
+ username: z.string(),
17
+ publicKey: z.string().nullable(),
18
+ keyCreatedAt: z.string().nullable(),
19
+ allowedFrom: z.string().nullable(),
20
+ hostKeyFingerprint: z.string().nullable(),
21
+ createdAt: z.string(),
22
+ testedAt: z.string().nullable(),
23
+ });
24
+ /** Serveur enregistré : la vue de l'interface et la clé privée, chiffrée avec VAULT_KEY ; null quand la clé a été révoquée. */
25
+ export const StoredDeployServerSchema = DeployServerSchema.extend({ privateKeyEncrypted: z.string().nullable() });
26
+ export const DeployServersFileSchema = z.object({ servers: z.array(StoredDeployServerSchema) });
27
+ /** Champs saisis pour un serveur. */
28
+ export const DeployServerBodySchema = z.object({
29
+ name: z.string(),
30
+ host: z.string(),
31
+ port: z.coerce.number(),
32
+ username: z.string(),
33
+ });
34
+ /** `running` : le script s'exécute ; les trois autres états sont terminaux. */
35
+ export const DEPLOYMENT_STATUSES = ["running", "done", "failed", "cancelled"];
36
+ /**
37
+ * Exécution du script de déploiement d'un dépôt sur son serveur. `script` est
38
+ * le script tel qu'il a été lancé ; `branch` et `commit` les valeurs de
39
+ * $BRANCH et $COMMIT ; `server` le serveur, en clair (`nom · utilisateur@hôte:port`).
40
+ * `currentLine` est la dernière ligne du script commencée, `exitCode` le code
41
+ * de sortie du script, `output` sa sortie, stdout et stderr fusionnés, dont seule
42
+ * la fin est gardée au-delà de la limite (`outputTruncated`).
43
+ */
44
+ export const DeploymentSchema = z.object({
45
+ id: z.string(),
46
+ repoId: z.string(),
47
+ serverId: z.string(),
48
+ server: z.string(),
49
+ branch: z.string(),
50
+ commit: z.string().nullable(),
51
+ script: z.string(),
52
+ status: z.enum(DEPLOYMENT_STATUSES),
53
+ createdAt: z.string(),
54
+ updatedAt: z.string(),
55
+ endedAt: z.string().nullable(),
56
+ currentLine: z.number().int().nullable(),
57
+ exitCode: z.number().int().nullable(),
58
+ output: z.string(),
59
+ outputTruncated: z.boolean(),
60
+ cancelRequested: z.boolean(),
61
+ error: z.string().nullable(),
62
+ });
63
+ /** Corps de l'enregistrement du script d'un dépôt. */
64
+ export const SaveScriptBodySchema = z.object({ script: z.string().max(100_000) });
65
+ /** Corps du choix du serveur d'un dépôt ; null le détache. */
66
+ export const SetDeployServerBodySchema = z.object({ serverId: z.string().min(1).nullable() });
67
+ /** Variables que le tracker définit pour le script, avec leur rôle. */
68
+ export const SCRIPT_VARIABLES = [
69
+ { name: "BRANCH", description: "branche suivie du dépôt" },
70
+ { name: "COMMIT", description: "dernier commit de cette branche sur GitHub" },
71
+ { name: "REPO", description: "dépôt, propriétaire/nom" },
72
+ ];
@@ -5,17 +5,6 @@ export type AlertSeverity = (typeof ALERT_SEVERITIES)[number];
5
5
  /** Gravités d'une vulnérabilité rapportée par `npm audit`, de la plus grave à la moins grave. */
6
6
  export declare const NPM_SEVERITIES: readonly ["critical", "high", "moderate", "low", "info"];
7
7
  export type NpmSeverity = (typeof NPM_SEVERITIES)[number];
8
- /** Actions que l'agent peut être autorisé à lancer sur un dépôt, par les outils MCP. */
9
- export declare const RIGHTS: readonly ["audit", "fix", "push"];
10
- export type Right = (typeof RIGHTS)[number];
11
- export declare const RightsSchema: z.ZodObject<{
12
- audit: z.ZodBoolean;
13
- fix: z.ZodBoolean;
14
- push: z.ZodBoolean;
15
- }, z.core.$strip>;
16
- export type Rights = z.infer<typeof RightsSchema>;
17
- /** Droits d'un dépôt qui vient d'être ajouté : l'audit seul. */
18
- export declare const DEFAULT_RIGHTS: Rights;
19
8
  /**
20
9
  * Périmètre d'un audit et de ses corrections : `production` laisse de côté les
21
10
  * devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
@@ -85,7 +74,9 @@ export type Category = z.infer<typeof CategorySchema>;
85
74
  * `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
86
75
  * dépôt déprécié n'est plus synchronisé ni audité ;
87
76
  * `queuedAt` la date de son entrée dans la file d'attente, null s'il n'y est pas ;
88
- * `deployPendingAt` la date à laquelle il a été marqué « à déployer », null s'il ne l'est pas.
77
+ * `deployPendingAt` la date à laquelle il a été marqué « à déployer », null s'il ne l'est pas ;
78
+ * `deployServerId` le serveur sur lequel il se déploie, null s'il n'en a pas ;
79
+ * `deployScript` le script shell qui le déploie sur ce serveur.
89
80
  */
90
81
  export declare const RepoSchema: z.ZodObject<{
91
82
  id: z.ZodString;
@@ -95,11 +86,6 @@ export declare const RepoSchema: z.ZodObject<{
95
86
  branch: z.ZodString;
96
87
  categoryId: z.ZodNullable<z.ZodString>;
97
88
  addedAt: z.ZodString;
98
- rights: z.ZodObject<{
99
- audit: z.ZodBoolean;
100
- fix: z.ZodBoolean;
101
- push: z.ZodBoolean;
102
- }, z.core.$strip>;
103
89
  alerts: z.ZodArray<z.ZodObject<{
104
90
  number: z.ZodNumber;
105
91
  severity: z.ZodEnum<{
@@ -136,6 +122,8 @@ export declare const RepoSchema: z.ZodObject<{
136
122
  deprecatedAt: z.ZodNullable<z.ZodString>;
137
123
  queuedAt: z.ZodNullable<z.ZodString>;
138
124
  deployPendingAt: z.ZodNullable<z.ZodString>;
125
+ deployServerId: z.ZodNullable<z.ZodString>;
126
+ deployScript: z.ZodString;
139
127
  }, z.core.$strip>;
140
128
  export type Repo = z.infer<typeof RepoSchema>;
141
129
  export declare const ReposFileSchema: z.ZodObject<{
@@ -151,11 +139,6 @@ export declare const ReposFileSchema: z.ZodObject<{
151
139
  branch: z.ZodString;
152
140
  categoryId: z.ZodNullable<z.ZodString>;
153
141
  addedAt: z.ZodString;
154
- rights: z.ZodObject<{
155
- audit: z.ZodBoolean;
156
- fix: z.ZodBoolean;
157
- push: z.ZodBoolean;
158
- }, z.core.$strip>;
159
142
  alerts: z.ZodArray<z.ZodObject<{
160
143
  number: z.ZodNumber;
161
144
  severity: z.ZodEnum<{
@@ -192,13 +175,15 @@ export declare const ReposFileSchema: z.ZodObject<{
192
175
  deprecatedAt: z.ZodNullable<z.ZodString>;
193
176
  queuedAt: z.ZodNullable<z.ZodString>;
194
177
  deployPendingAt: z.ZodNullable<z.ZodString>;
178
+ deployServerId: z.ZodNullable<z.ZodString>;
179
+ deployScript: z.ZodString;
195
180
  }, z.core.$strip>>;
196
181
  }, z.core.$strip>;
197
182
  export type ReposFile = z.infer<typeof ReposFileSchema>;
198
183
  /** `audit` : clone et `npm audit` seulement ; `fix` : jusqu'aux corrections, à la branche et à la PR. */
199
184
  export declare const OPERATION_KINDS: readonly ["audit", "fix"];
200
185
  export type OperationKind = (typeof OPERATION_KINDS)[number];
201
- /** Qui a lancé l'opération : l'utilisateur depuis la GUI, ou l'agent par un outil MCP. */
186
+ /** Qui a lancé l'opération : l'utilisateur depuis la GUI, ou un agent par le mode MCP. */
202
187
  export declare const ORIGINS: readonly ["user", "agent"];
203
188
  export type Origin = (typeof ORIGINS)[number];
204
189
  /** `running` : l'opération s'exécute ; les trois autres états sont terminaux. */
@@ -348,8 +333,7 @@ export type Repair = z.infer<typeof RepairSchema>;
348
333
  /**
349
334
  * Opération d'audit ou de correction sur un clone temporaire, limitée aux
350
335
  * dépendances de `scope`. `workDir` est le
351
- * clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
352
- * qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
336
+ * clone, présent tant que l'opération n'est pas terminée. `found` liste les vulnérabilités du premier
353
337
  * audit, `remaining` celles qui restent après la dernière étape. `repair` est
354
338
  * la session de corrections par Claude, null quand elle n'a pas été lancée.
355
339
  */
@@ -376,7 +360,6 @@ export declare const OperationSchema: z.ZodObject<{
376
360
  }>;
377
361
  createdAt: z.ZodString;
378
362
  updatedAt: z.ZodString;
379
- pid: z.ZodNumber;
380
363
  workDir: z.ZodNullable<z.ZodString>;
381
364
  baseBranch: z.ZodString;
382
365
  cancelRequested: z.ZodBoolean;
@@ -3,15 +3,6 @@ import { z } from "zod";
3
3
  export const ALERT_SEVERITIES = ["critical", "high", "medium", "low"];
4
4
  /** Gravités d'une vulnérabilité rapportée par `npm audit`, de la plus grave à la moins grave. */
5
5
  export const NPM_SEVERITIES = ["critical", "high", "moderate", "low", "info"];
6
- /** Actions que l'agent peut être autorisé à lancer sur un dépôt, par les outils MCP. */
7
- export const RIGHTS = ["audit", "fix", "push"];
8
- export const RightsSchema = z.object({
9
- audit: z.boolean(),
10
- fix: z.boolean(),
11
- push: z.boolean(),
12
- });
13
- /** Droits d'un dépôt qui vient d'être ajouté : l'audit seul. */
14
- export const DEFAULT_RIGHTS = { audit: true, fix: false, push: false };
15
6
  /**
16
7
  * Périmètre d'un audit et de ses corrections : `production` laisse de côté les
17
8
  * devDependencies (`--omit=dev`), `all` couvre toutes les dépendances.
@@ -67,7 +58,9 @@ export const CategorySchema = z.object({
67
58
  * `deprecatedAt` la date à laquelle il a été marqué déprécié, null sinon : un
68
59
  * dépôt déprécié n'est plus synchronisé ni audité ;
69
60
  * `queuedAt` la date de son entrée dans la file d'attente, null s'il n'y est pas ;
70
- * `deployPendingAt` la date à laquelle il a été marqué « à déployer », null s'il ne l'est pas.
61
+ * `deployPendingAt` la date à laquelle il a été marqué « à déployer », null s'il ne l'est pas ;
62
+ * `deployServerId` le serveur sur lequel il se déploie, null s'il n'en a pas ;
63
+ * `deployScript` le script shell qui le déploie sur ce serveur.
71
64
  */
72
65
  export const RepoSchema = z.object({
73
66
  id: z.string(),
@@ -77,7 +70,6 @@ export const RepoSchema = z.object({
77
70
  branch: z.string(),
78
71
  categoryId: z.string().nullable(),
79
72
  addedAt: z.string(),
80
- rights: RightsSchema,
81
73
  alerts: z.array(AlertSchema),
82
74
  handledAlerts: z.array(HandledAlertSchema),
83
75
  pullRequests: z.array(PullRequestSchema),
@@ -86,11 +78,13 @@ export const RepoSchema = z.object({
86
78
  deprecatedAt: z.string().nullable(),
87
79
  queuedAt: z.string().nullable(),
88
80
  deployPendingAt: z.string().nullable(),
81
+ deployServerId: z.string().nullable(),
82
+ deployScript: z.string(),
89
83
  });
90
84
  export const ReposFileSchema = z.object({ categories: z.array(CategorySchema), repos: z.array(RepoSchema) });
91
85
  /** `audit` : clone et `npm audit` seulement ; `fix` : jusqu'aux corrections, à la branche et à la PR. */
92
86
  export const OPERATION_KINDS = ["audit", "fix"];
93
- /** Qui a lancé l'opération : l'utilisateur depuis la GUI, ou l'agent par un outil MCP. */
87
+ /** Qui a lancé l'opération : l'utilisateur depuis la GUI, ou un agent par le mode MCP. */
94
88
  export const ORIGINS = ["user", "agent"];
95
89
  /** `running` : l'opération s'exécute ; les trois autres états sont terminaux. */
96
90
  export const OPERATION_STATUSES = ["running", "done", "failed", "cancelled"];
@@ -163,8 +157,7 @@ export const RepairSchema = z.object({
163
157
  /**
164
158
  * Opération d'audit ou de correction sur un clone temporaire, limitée aux
165
159
  * dépendances de `scope`. `workDir` est le
166
- * clone, présent tant que l'opération n'est pas terminée ; `pid` est le processus
167
- * qui exécute l'étape en cours. `found` liste les vulnérabilités du premier
160
+ * clone, présent tant que l'opération n'est pas terminée. `found` liste les vulnérabilités du premier
168
161
  * audit, `remaining` celles qui restent après la dernière étape. `repair` est
169
162
  * la session de corrections par Claude, null quand elle n'a pas été lancée.
170
163
  */
@@ -177,7 +170,6 @@ export const OperationSchema = z.object({
177
170
  status: z.enum(OPERATION_STATUSES),
178
171
  createdAt: z.string(),
179
172
  updatedAt: z.string(),
180
- pid: z.number().int(),
181
173
  workDir: z.string().nullable(),
182
174
  baseBranch: z.string(),
183
175
  cancelRequested: z.boolean(),
@@ -1,24 +1,27 @@
1
- /**
2
- * Comment la GUI sera exposée. `undefined` des deux côtés = rien n'a été passé
3
- * en ligne de commande : on retombe sur le placeholder PROXY_URL à compléter.
4
- */
5
- export interface GuiExposure {
6
- proxyUrl?: string;
7
- appPort?: number;
1
+ export declare const PACKAGE_NAME = "@imenam/mcp-dependabot-tracker";
2
+ /** Ce que le mode MCP doit connaître : l'adresse du serveur et un token d'agent. */
3
+ export interface McpConnection {
4
+ serverUrl: string;
5
+ token: string;
8
6
  }
9
- /**
10
- * Traduit `--proxy_url=` / `--app_port=` en mode d'exposition de la GUI.
11
- * Les deux ensemble sont refusés : au runtime PROXY_URL primerait toujours,
12
- * donc un fichier portant les deux serait silencieusement trompeur.
13
- */
14
- export declare function parseGuiExposure(argv: string[]): {
15
- exposure: GuiExposure;
7
+ /** Commande qui déclare le mode MCP avec `connection` dans le `.mcp.json` du répertoire courant. */
8
+ export declare function setupCommand({ serverUrl, token }: McpConnection): string;
9
+ /** Valide une adresse de serveur http ou https ; rend l'adresse sans barre finale, ou la raison du refus. */
10
+ export declare function parseServerUrl(raw: string, label: string): {
11
+ url: string;
12
+ } | {
13
+ error: string;
14
+ };
15
+ /** Lit `--server_url=` et `--token=`, tous deux obligatoires. */
16
+ export declare function parseConnection(argv: string[]): {
17
+ connection: McpConnection;
16
18
  } | {
17
19
  error: string;
18
20
  };
19
21
  export interface SetupMcpOptions {
20
22
  cwd: string;
21
23
  force: boolean;
22
- exposure?: GuiExposure;
24
+ connection: McpConnection;
23
25
  }
24
- export declare function runSetupMcp({ cwd, force, exposure }: SetupMcpOptions): number;
26
+ /** Crée ou complète le `.mcp.json` de `cwd` avec l'entrée du mode MCP ; rend le code de sortie de la commande. */
27
+ export declare function runSetupMcp({ cwd, force, connection }: SetupMcpOptions): number;