@andrebuzeli/git-mcp 3.3.0 → 4.0.2

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 (139) hide show
  1. package/README.md +63 -283
  2. package/dist/providers/base-provider.d.ts.map +1 -1
  3. package/dist/providers/base-provider.js +3 -26
  4. package/dist/providers/base-provider.js.map +1 -1
  5. package/dist/providers/gitea-provider.d.ts +0 -2
  6. package/dist/providers/gitea-provider.d.ts.map +1 -1
  7. package/dist/providers/gitea-provider.js +0 -62
  8. package/dist/providers/gitea-provider.js.map +1 -1
  9. package/dist/providers/github-provider.d.ts +0 -2
  10. package/dist/providers/github-provider.d.ts.map +1 -1
  11. package/dist/providers/github-provider.js +48 -105
  12. package/dist/providers/github-provider.js.map +1 -1
  13. package/dist/server.d.ts +0 -27
  14. package/dist/server.d.ts.map +1 -1
  15. package/dist/server.js +130 -1215
  16. package/dist/server.js.map +1 -1
  17. package/dist/tools/{git-commits.d.ts → git-analytics.d.ts} +4 -10
  18. package/dist/tools/git-analytics.d.ts.map +1 -0
  19. package/dist/tools/git-analytics.js +18 -0
  20. package/dist/tools/git-analytics.js.map +1 -0
  21. package/dist/tools/git-archive.d.ts +3 -0
  22. package/dist/tools/git-archive.d.ts.map +1 -1
  23. package/dist/tools/git-archive.js +2 -2
  24. package/dist/tools/git-archive.js.map +1 -1
  25. package/dist/tools/git-backup.d.ts +216 -0
  26. package/dist/tools/git-backup.d.ts.map +1 -0
  27. package/dist/tools/git-backup.js +813 -0
  28. package/dist/tools/git-backup.js.map +1 -0
  29. package/dist/tools/git-branches.d.ts +159 -8
  30. package/dist/tools/git-branches.d.ts.map +1 -1
  31. package/dist/tools/git-branches.js +554 -2
  32. package/dist/tools/git-branches.js.map +1 -1
  33. package/dist/tools/git-config.d.ts +3 -0
  34. package/dist/tools/git-config.d.ts.map +1 -1
  35. package/dist/tools/git-config.js +2 -2
  36. package/dist/tools/git-config.js.map +1 -1
  37. package/dist/tools/git-files.d.ts +130 -8
  38. package/dist/tools/git-files.d.ts.map +1 -1
  39. package/dist/tools/git-files.js +426 -2
  40. package/dist/tools/git-files.js.map +1 -1
  41. package/dist/tools/git-issues.d.ts +137 -471
  42. package/dist/tools/git-issues.d.ts.map +1 -1
  43. package/dist/tools/git-issues.js +605 -613
  44. package/dist/tools/git-issues.js.map +1 -1
  45. package/dist/tools/git-monitor.d.ts +161 -0
  46. package/dist/tools/git-monitor.d.ts.map +1 -0
  47. package/dist/tools/git-monitor.js +746 -0
  48. package/dist/tools/git-monitor.js.map +1 -0
  49. package/dist/tools/git-packages.d.ts +5 -2
  50. package/dist/tools/git-packages.d.ts.map +1 -1
  51. package/dist/tools/git-packages.js +3 -3
  52. package/dist/tools/git-packages.js.map +1 -1
  53. package/dist/tools/git-pulls.d.ts +38 -646
  54. package/dist/tools/git-pulls.d.ts.map +1 -1
  55. package/dist/tools/git-pulls.js +64 -716
  56. package/dist/tools/git-pulls.js.map +1 -1
  57. package/dist/tools/git-release.d.ts +187 -0
  58. package/dist/tools/git-release.d.ts.map +1 -0
  59. package/dist/tools/git-release.js +619 -0
  60. package/dist/tools/git-release.js.map +1 -0
  61. package/dist/tools/git-remote.d.ts +112 -77
  62. package/dist/tools/git-remote.d.ts.map +1 -1
  63. package/dist/tools/git-remote.js +481 -183
  64. package/dist/tools/git-remote.js.map +1 -1
  65. package/dist/tools/git-repos.d.ts +19 -0
  66. package/dist/tools/git-repos.d.ts.map +1 -0
  67. package/dist/tools/git-repos.js +18 -0
  68. package/dist/tools/git-repos.js.map +1 -0
  69. package/dist/tools/git-reset.d.ts +121 -74
  70. package/dist/tools/git-reset.d.ts.map +1 -1
  71. package/dist/tools/git-reset.js +540 -159
  72. package/dist/tools/git-reset.js.map +1 -1
  73. package/dist/tools/git-stash.d.ts +119 -78
  74. package/dist/tools/git-stash.d.ts.map +1 -1
  75. package/dist/tools/git-stash.js +560 -209
  76. package/dist/tools/git-stash.js.map +1 -1
  77. package/dist/tools/git-sync.d.ts +3 -163
  78. package/dist/tools/git-sync.d.ts.map +1 -1
  79. package/dist/tools/git-sync.js +9 -326
  80. package/dist/tools/git-sync.js.map +1 -1
  81. package/dist/tools/git-tags.d.ts +105 -331
  82. package/dist/tools/git-tags.d.ts.map +1 -1
  83. package/dist/tools/git-tags.js +545 -416
  84. package/dist/tools/git-tags.js.map +1 -1
  85. package/dist/tools/git-workflow.d.ts +127 -0
  86. package/dist/tools/git-workflow.d.ts.map +1 -0
  87. package/dist/tools/git-workflow.js +359 -0
  88. package/dist/tools/git-workflow.js.map +1 -0
  89. package/dist/utils/auto-detection.d.ts +113 -0
  90. package/dist/utils/auto-detection.d.ts.map +1 -0
  91. package/dist/utils/auto-detection.js +235 -0
  92. package/dist/utils/auto-detection.js.map +1 -0
  93. package/dist/utils/error-handler.d.ts +107 -0
  94. package/dist/utils/error-handler.d.ts.map +1 -0
  95. package/dist/utils/error-handler.js +331 -0
  96. package/dist/utils/error-handler.js.map +1 -0
  97. package/dist/utils/git-operations.d.ts.map +1 -1
  98. package/dist/utils/git-operations.js +6 -51
  99. package/dist/utils/git-operations.js.map +1 -1
  100. package/dist/utils/user-detection.d.ts +1 -13
  101. package/dist/utils/user-detection.d.ts.map +1 -1
  102. package/dist/utils/user-detection.js +1 -26
  103. package/dist/utils/user-detection.js.map +1 -1
  104. package/package.json +60 -60
  105. package/dist/client.d.ts +0 -307
  106. package/dist/client.d.ts.map +0 -1
  107. package/dist/client.js +0 -299
  108. package/dist/client.js.map +0 -1
  109. package/dist/tools/git-branch-protection.d.ts +0 -97
  110. package/dist/tools/git-branch-protection.d.ts.map +0 -1
  111. package/dist/tools/git-branch-protection.js +0 -182
  112. package/dist/tools/git-branch-protection.js.map +0 -1
  113. package/dist/tools/git-commits.d.ts.map +0 -1
  114. package/dist/tools/git-commits.js +0 -5
  115. package/dist/tools/git-commits.js.map +0 -1
  116. package/dist/tools/git-initialize.d.ts +0 -208
  117. package/dist/tools/git-initialize.d.ts.map +0 -1
  118. package/dist/tools/git-initialize.js +0 -470
  119. package/dist/tools/git-initialize.js.map +0 -1
  120. package/dist/tools/git-projects.d.ts +0 -112
  121. package/dist/tools/git-projects.d.ts.map +0 -1
  122. package/dist/tools/git-projects.js +0 -319
  123. package/dist/tools/git-projects.js.map +0 -1
  124. package/dist/tools/git-releases.d.ts +0 -486
  125. package/dist/tools/git-releases.d.ts.map +0 -1
  126. package/dist/tools/git-releases.js +0 -561
  127. package/dist/tools/git-releases.js.map +0 -1
  128. package/dist/tools/git-repositories.d.ts +0 -469
  129. package/dist/tools/git-repositories.d.ts.map +0 -1
  130. package/dist/tools/git-repositories.js +0 -637
  131. package/dist/tools/git-repositories.js.map +0 -1
  132. package/dist/tools/git-revert.d.ts +0 -147
  133. package/dist/tools/git-revert.d.ts.map +0 -1
  134. package/dist/tools/git-revert.js +0 -199
  135. package/dist/tools/git-revert.js.map +0 -1
  136. package/dist/tools/git-update-project.d.ts +0 -309
  137. package/dist/tools/git-update-project.d.ts.map +0 -1
  138. package/dist/tools/git-update-project.js +0 -878
  139. package/dist/tools/git-update-project.js.map +0 -1
@@ -1,268 +1,47 @@
1
1
  import { z } from 'zod';
2
- import { VcsOperations } from '../providers/index.js';
3
- /**
4
- * Tool: pulls
5
- *
6
- * DESCRIÇÃO:
7
- * Gerenciamento completo de pull requests com suporte multi-provider (GitHub e Gitea)
8
- *
9
- * FUNCIONALIDADES:
10
- * - Criação de novos pull requests
11
- * - Listagem e busca de PRs
12
- * - Obtenção de detalhes específicos
13
- * - Atualização de PRs existentes
14
- * - Merge de pull requests
15
- * - Fechamento de PRs
16
- * - Revisão e aprovação
17
- * - Busca por conteúdo e status
18
- *
19
- * USO:
20
- * - Para gerenciar integração de código
21
- * - Para revisão de código
22
- * - Para controle de qualidade
23
- * - Para colaboração em equipe
24
- *
25
- * RECOMENDAÇÕES:
26
- * - Use títulos descritivos
27
- * - Documente mudanças detalhadamente
28
- * - Revise antes de fazer merge
29
- * - Mantenha PRs pequenos e focados
30
- */
31
- /**
32
- * Schema de validação para entrada da tool pulls
33
- *
34
- * VALIDAÇÕES:
35
- * - action: Ação obrigatória (create, list, get, update, merge, close, review, search)
36
- * - Parâmetros específicos por ação
37
- * - Validação de tipos e formatos
38
- *
39
- * RECOMENDAÇÕES:
40
- * - Sempre valide entrada antes de usar
41
- * - Use parâmetros opcionais adequadamente
42
- * - Documente parâmetros obrigatórios
43
- */
44
- declare const PullsInputSchema: z.ZodObject<{
45
- action: z.ZodEnum<["create", "list", "get", "update", "merge", "close", "review", "search"]>;
46
- provider: z.ZodEnum<["gitea", "github"]>;
2
+ import { UniversalResponse } from '../utils/auto-detection.js';
3
+ declare const GitPullsInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
4
+ action: z.ZodLiteral<"create">;
47
5
  projectPath: z.ZodString;
48
- repo: z.ZodOptional<z.ZodString>;
49
- title: z.ZodOptional<z.ZodString>;
50
- body: z.ZodOptional<z.ZodString>;
51
- head: z.ZodOptional<z.ZodString>;
52
- base: z.ZodOptional<z.ZodString>;
53
- draft: z.ZodOptional<z.ZodBoolean>;
54
- labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
55
- assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
56
- reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
57
- milestone: z.ZodOptional<z.ZodNumber>;
58
- pull_number: z.ZodOptional<z.ZodNumber>;
59
- state: z.ZodOptional<z.ZodEnum<["open", "closed", "merged", "all"]>>;
60
- page: z.ZodOptional<z.ZodNumber>;
61
- new_title: z.ZodOptional<z.ZodString>;
62
- new_body: z.ZodOptional<z.ZodString>;
63
- new_base: z.ZodOptional<z.ZodString>;
64
- new_labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
65
- new_assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
66
- new_milestone: z.ZodOptional<z.ZodNumber>;
67
- merge_method: z.ZodOptional<z.ZodEnum<["merge", "rebase", "squash"]>>;
68
- merge_commit_title: z.ZodOptional<z.ZodString>;
69
- merge_commit_message: z.ZodOptional<z.ZodString>;
70
- review_event: z.ZodOptional<z.ZodEnum<["APPROVE", "REQUEST_CHANGES", "COMMENT"]>>;
71
- review_body: z.ZodOptional<z.ZodString>;
72
- query: z.ZodOptional<z.ZodString>;
73
- author: z.ZodOptional<z.ZodString>;
74
- assignee: z.ZodOptional<z.ZodString>;
75
- reviewer: z.ZodOptional<z.ZodString>;
76
- label: z.ZodOptional<z.ZodString>;
6
+ title: z.ZodString;
7
+ head: z.ZodString;
8
+ base: z.ZodDefault<z.ZodString>;
77
9
  }, "strip", z.ZodTypeAny, {
78
- provider: "gitea" | "github";
79
- action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
10
+ title: string;
11
+ head: string;
12
+ base: string;
13
+ action: "create";
80
14
  projectPath: string;
81
- title?: string | undefined;
82
- body?: string | undefined;
83
- state?: "open" | "closed" | "merged" | "all" | undefined;
84
- assignees?: string[] | undefined;
85
- labels?: string[] | undefined;
86
- head?: string | undefined;
87
- base?: string | undefined;
88
- draft?: boolean | undefined;
89
- repo?: string | undefined;
90
- page?: number | undefined;
91
- query?: string | undefined;
92
- milestone?: number | undefined;
93
- new_title?: string | undefined;
94
- new_body?: string | undefined;
95
- new_labels?: string[] | undefined;
96
- new_assignees?: string[] | undefined;
97
- new_milestone?: number | undefined;
98
- author?: string | undefined;
99
- assignee?: string | undefined;
100
- label?: string | undefined;
101
- reviewers?: string[] | undefined;
102
- pull_number?: number | undefined;
103
- new_base?: string | undefined;
104
- merge_method?: "merge" | "rebase" | "squash" | undefined;
105
- merge_commit_title?: string | undefined;
106
- merge_commit_message?: string | undefined;
107
- review_event?: "APPROVE" | "REQUEST_CHANGES" | "COMMENT" | undefined;
108
- review_body?: string | undefined;
109
- reviewer?: string | undefined;
110
15
  }, {
111
- provider: "gitea" | "github";
112
- action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
16
+ title: string;
17
+ head: string;
18
+ action: "create";
113
19
  projectPath: string;
114
- title?: string | undefined;
115
- body?: string | undefined;
116
- state?: "open" | "closed" | "merged" | "all" | undefined;
117
- assignees?: string[] | undefined;
118
- labels?: string[] | undefined;
119
- head?: string | undefined;
120
20
  base?: string | undefined;
121
- draft?: boolean | undefined;
122
- repo?: string | undefined;
123
- page?: number | undefined;
124
- query?: string | undefined;
125
- milestone?: number | undefined;
126
- new_title?: string | undefined;
127
- new_body?: string | undefined;
128
- new_labels?: string[] | undefined;
129
- new_assignees?: string[] | undefined;
130
- new_milestone?: number | undefined;
131
- author?: string | undefined;
132
- assignee?: string | undefined;
133
- label?: string | undefined;
134
- reviewers?: string[] | undefined;
135
- pull_number?: number | undefined;
136
- new_base?: string | undefined;
137
- merge_method?: "merge" | "rebase" | "squash" | undefined;
138
- merge_commit_title?: string | undefined;
139
- merge_commit_message?: string | undefined;
140
- review_event?: "APPROVE" | "REQUEST_CHANGES" | "COMMENT" | undefined;
141
- review_body?: string | undefined;
142
- reviewer?: string | undefined;
143
- }>;
144
- export type PullsInput = z.infer<typeof PullsInputSchema>;
145
- /**
146
- * Schema de saída padronizado
147
- *
148
- * ESTRUTURA:
149
- * - success: Status da operação
150
- * - action: Ação executada
151
- * - message: Mensagem descritiva
152
- * - data: Dados retornados (opcional)
153
- * - error: Detalhes do erro (opcional)
154
- */
155
- declare const PullsResultSchema: z.ZodObject<{
156
- success: z.ZodBoolean;
157
- action: z.ZodString;
158
- message: z.ZodString;
159
- data: z.ZodOptional<z.ZodAny>;
160
- error: z.ZodOptional<z.ZodString>;
21
+ }>, z.ZodObject<{
22
+ action: z.ZodLiteral<"list">;
23
+ projectPath: z.ZodString;
161
24
  }, "strip", z.ZodTypeAny, {
162
- message: string;
163
- action: string;
164
- success: boolean;
165
- error?: string | undefined;
166
- data?: any;
25
+ action: "list";
26
+ projectPath: string;
167
27
  }, {
168
- message: string;
169
- action: string;
170
- success: boolean;
171
- error?: string | undefined;
172
- data?: any;
173
- }>;
174
- export type PullsResult = z.infer<typeof PullsResultSchema>;
175
- /**
176
- * Tool: pulls
177
- *
178
- * DESCRIÇÃO:
179
- * Gerenciamento completo de Pull Requests Gitea com múltiplas ações
180
- *
181
- * ACTIONS DISPONÍVEIS:
182
- *
183
- * 1. create - Criar novo Pull Request
184
- * Parâmetros:
185
- * - owner (obrigatório): Proprietário do repositório
186
- * - repo (obrigatório): Nome do repositório
187
- * - title (obrigatório): Título do PR
188
- * - body (opcional): Descrição detalhada
189
- * - head (obrigatório): Branch de origem
190
- * - base (obrigatório): Branch de destino
191
- * - draft (opcional): Se é um draft PR
192
- * - labels (opcional): Array de labels
193
- * - assignees (opcional): Array de usuários responsáveis
194
- * - reviewers (opcional): Array de revisores
195
- * - milestone (opcional): ID do milestone
196
- *
197
- * 2. list - Listar Pull Requests
198
- * Parâmetros:
199
- * - owner (obrigatório): Proprietário do repositório
200
- * - repo (obrigatório): Nome do repositório
201
- * - state (opcional): Estado dos PRs (open, closed, merged, all) - padrão: open
202
- * - page (opcional): Página da listagem (padrão: 1)
203
- * - limit (opcional): Itens por página (padrão: 30, máximo: 100)
204
- *
205
- * 3. get - Obter detalhes do Pull Request
206
- * Parâmetros:
207
- * - owner (obrigatório): Proprietário do repositório
208
- * - repo (obrigatório): Nome do repositório
209
- * - pull_number (obrigatório): Número do PR
210
- *
211
- * 4. update - Atualizar Pull Request existente
212
- * Parâmetros:
213
- * - owner (obrigatório): Proprietário do repositório
214
- * - repo (obrigatório): Nome do repositório
215
- * - pull_number (obrigatório): Número do PR
216
- * - new_title (opcional): Novo título
217
- * - new_body (opcional): Nova descrição
218
- * - new_base (opcional): Nova branch base
219
- * - new_labels (opcional): Novos labels
220
- * - new_assignees (opcional): Novos responsáveis
221
- * - new_milestone (opcional): Novo milestone
222
- *
223
- * 5. merge - Fazer merge do Pull Request
224
- * Parâmetros:
225
- * - owner (obrigatório): Proprietário do repositório
226
- * - repo (obrigatório): Nome do repositório
227
- * - pull_number (obrigatório): Número do PR
228
- * - merge_method (opcional): Método de merge (merge, rebase, squash)
229
- * - merge_commit_title (opcional): Título do commit de merge
230
- * - merge_commit_message (opcional): Mensagem do commit de merge
231
- *
232
- * 6. close - Fechar Pull Request
233
- * Parâmetros:
234
- * - owner (obrigatório): Proprietário do repositório
235
- * - repo (obrigatório): Nome do repositório
236
- * - pull_number (obrigatório): Número do PR
237
- *
238
- * 7. review - Adicionar review ao Pull Request
239
- * Parâmetros:
240
- * - owner (obrigatório): Proprietário do repositório
241
- * - repo (obrigatório): Nome do repositório
242
- * - pull_number (obrigatório): Número do PR
243
- * - review_event (obrigatório): Tipo de review (APPROVE, REQUEST_CHANGES, COMMENT)
244
- * - review_body (opcional): Comentário do review
245
- *
246
- * 8. search - Buscar Pull Requests
247
- * Parâmetros:
248
- * - owner (obrigatório): Proprietário do repositório
249
- * - repo (obrigatório): Nome do repositório
250
- * - query (obrigatório): Termo de busca
251
- * - author (opcional): Autor dos PRs
252
- * - assignee (opcional): Responsável pelos PRs
253
- * - reviewer (opcional): Revisor dos PRs
254
- * - label (opcional): Label específico
255
- *
256
- * RECOMENDAÇÕES DE USO:
257
- * - Use títulos descritivos e claros
258
- * - Documente mudanças detalhadamente
259
- * - Solicite reviews adequados
260
- * - Mantenha PRs pequenos e focados
261
- * - Use labels para categorização
262
- * - Atribua responsáveis adequadamente
263
- * - Escolha método de merge apropriado
264
- */
265
- export declare const pullsTool: {
28
+ action: "list";
29
+ projectPath: string;
30
+ }>, z.ZodObject<{
31
+ action: z.ZodLiteral<"merge">;
32
+ projectPath: z.ZodString;
33
+ number: z.ZodNumber;
34
+ }, "strip", z.ZodTypeAny, {
35
+ number: number;
36
+ action: "merge";
37
+ projectPath: string;
38
+ }, {
39
+ number: number;
40
+ action: "merge";
41
+ projectPath: string;
42
+ }>]>;
43
+ export type GitPullsInput = z.infer<typeof GitPullsInputSchema>;
44
+ export declare const gitPullsTool: {
266
45
  name: string;
267
46
  description: string;
268
47
  inputSchema: {
@@ -273,11 +52,7 @@ export declare const pullsTool: {
273
52
  enum: string[];
274
53
  description: string;
275
54
  };
276
- repo: {
277
- type: string;
278
- description: string;
279
- };
280
- provider: {
55
+ projectPath: {
281
56
  type: string;
282
57
  description: string;
283
58
  };
@@ -285,10 +60,6 @@ export declare const pullsTool: {
285
60
  type: string;
286
61
  description: string;
287
62
  };
288
- body: {
289
- type: string;
290
- description: string;
291
- };
292
63
  head: {
293
64
  type: string;
294
65
  description: string;
@@ -297,393 +68,14 @@ export declare const pullsTool: {
297
68
  type: string;
298
69
  description: string;
299
70
  };
300
- draft: {
301
- type: string;
302
- description: string;
303
- };
304
- labels: {
305
- type: string;
306
- items: {
307
- type: string;
308
- };
309
- description: string;
310
- };
311
- assignees: {
312
- type: string;
313
- items: {
314
- type: string;
315
- };
316
- description: string;
317
- };
318
- reviewers: {
319
- type: string;
320
- items: {
321
- type: string;
322
- };
323
- description: string;
324
- };
325
- milestone: {
326
- type: string;
327
- description: string;
328
- };
329
- pull_number: {
330
- type: string;
331
- description: string;
332
- };
333
- state: {
334
- type: string;
335
- enum: string[];
336
- description: string;
337
- };
338
- page: {
339
- type: string;
340
- description: string;
341
- minimum: number;
342
- };
343
- new_title: {
344
- type: string;
345
- description: string;
346
- };
347
- new_body: {
348
- type: string;
349
- description: string;
350
- };
351
- new_base: {
352
- type: string;
353
- description: string;
354
- };
355
- new_labels: {
356
- type: string;
357
- items: {
358
- type: string;
359
- };
360
- description: string;
361
- };
362
- new_assignees: {
363
- type: string;
364
- items: {
365
- type: string;
366
- };
367
- description: string;
368
- };
369
- new_milestone: {
370
- type: string;
371
- description: string;
372
- };
373
- merge_method: {
374
- type: string;
375
- enum: string[];
376
- description: string;
377
- };
378
- merge_commit_title: {
379
- type: string;
380
- description: string;
381
- };
382
- merge_commit_message: {
383
- type: string;
384
- description: string;
385
- };
386
- review_event: {
387
- type: string;
388
- enum: string[];
389
- description: string;
390
- };
391
- review_body: {
392
- type: string;
393
- description: string;
394
- };
395
- query: {
396
- type: string;
397
- description: string;
398
- };
399
- author: {
400
- type: string;
401
- description: string;
402
- };
403
- assignee: {
404
- type: string;
405
- description: string;
406
- };
407
- reviewer: {
408
- type: string;
409
- description: string;
410
- };
411
- label: {
71
+ number: {
412
72
  type: string;
413
73
  description: string;
414
74
  };
415
75
  };
416
76
  required: string[];
417
77
  };
418
- /**
419
- * Handler principal da tool pulls
420
- *
421
- * FUNCIONALIDADE:
422
- * - Valida entrada usando Zod schema
423
- * - Roteia para método específico baseado na ação
424
- * - Trata erros de forma uniforme
425
- * - Retorna resultado padronizado
426
- *
427
- * FLUXO:
428
- * 1. Validação de entrada
429
- * 2. Seleção do provider
430
- * 3. Roteamento por ação
431
- * 4. Execução do método específico
432
- * 5. Tratamento de erros
433
- * 6. Retorno de resultado
434
- *
435
- * TRATAMENTO DE ERROS:
436
- * - Validação: erro de schema
437
- * - Execução: erro da operação
438
- * - Roteamento: ação não suportada
439
- *
440
- * RECOMENDAÇÕES:
441
- * - Sempre valide entrada antes de processar
442
- * - Trate erros específicos adequadamente
443
- * - Log detalhes de erro para debug
444
- * - Retorne mensagens de erro úteis
445
- */
446
- handler(input: PullsInput): Promise<PullsResult>;
447
- /**
448
- * Cria um novo Pull Request
449
- *
450
- * FUNCIONALIDADE:
451
- * - Cria PR com título e descrição
452
- * - Suporta configuração de branches
453
- * - Permite configuração de draft, labels, assignees
454
- *
455
- * PARÂMETROS OBRIGATÓRIOS:
456
- * - owner: Proprietário do repositório
457
- * - repo: Nome do repositório
458
- * - title: Título do PR
459
- * - head: Branch de origem
460
- * - base: Branch de destino
461
- *
462
- * PARÂMETROS OPCIONAIS:
463
- * - body: Descrição detalhada
464
- * - draft: Se é um draft PR
465
- * - labels: Array de labels para categorização
466
- * - assignees: Array de usuários responsáveis
467
- * - reviewers: Array de revisores
468
- * - milestone: ID do milestone associado
469
- *
470
- * VALIDAÇÕES:
471
- * - Todos os parâmetros obrigatórios
472
- * - Branches devem existir
473
- * - Head e base devem ser diferentes
474
- * - Usuário deve ter permissão de escrita
475
- *
476
- * RECOMENDAÇÕES:
477
- * - Use títulos descritivos e claros
478
- * - Documente mudanças detalhadamente
479
- * - Solicite reviews adequados
480
- * - Mantenha PRs pequenos e focados
481
- */
482
- createPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
483
- /**
484
- * Lista Pull Requests do repositório
485
- *
486
- * FUNCIONALIDADE:
487
- * - Lista PRs com filtros de estado
488
- * - Suporta paginação
489
- * - Retorna informações básicas de cada PR
490
- *
491
- * PARÂMETROS OBRIGATÓRIOS:
492
- * - owner: Proprietário do repositório
493
- * - repo: Nome do repositório
494
- *
495
- * PARÂMETROS OPCIONAIS:
496
- * - state: Estado dos PRs (open, closed, merged, all) - padrão: open
497
- * - page: Página da listagem (padrão: 1)
498
- * - limit: Itens por página (padrão: 30, máximo: 100)
499
- *
500
- * VALIDAÇÕES:
501
- * - e repo obrigatórios
502
- * - State deve ser um dos valores válidos
503
- * - Page deve ser >= 1
504
- * - Limit deve ser entre 1 e 100
505
- *
506
- * RECOMENDAÇÕES:
507
- * - Use paginação para repositórios com muitos PRs
508
- * - Monitore número total de PRs
509
- * - Filtre por estado para organização
510
- * - Mantenha PRs organizados
511
- */
512
- listPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
513
- /**
514
- * Obtém detalhes de um Pull Request específico
515
- *
516
- * FUNCIONALIDADE:
517
- * - Retorna informações completas do PR
518
- * - Inclui título, descrição, branches, labels
519
- * - Mostra status de merge e conflitos
520
- *
521
- * PARÂMETROS OBRIGATÓRIOS:
522
- * - owner: Proprietário do repositório
523
- * - repo: Nome do repositório
524
- * - pull_number: Número do PR
525
- *
526
- * VALIDAÇÕES:
527
- * - Todos os parâmetros obrigatórios
528
- * - PR deve existir no repositório
529
- * - Número deve ser válido
530
- *
531
- * RECOMENDAÇÕES:
532
- * - Use para obter detalhes completos
533
- * - Verifique status de merge
534
- * - Analise conflitos se houver
535
- * - Monitore mudanças importantes
536
- */
537
- getPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
538
- /**
539
- * Atualiza um Pull Request existente
540
- *
541
- * FUNCIONALIDADE:
542
- * - Atualiza campos do PR
543
- * - Suporta mudança de branch base
544
- * - Permite alteração de labels e assignees
545
- *
546
- * PARÂMETROS OBRIGATÓRIOS:
547
- * - owner: Proprietário do repositório
548
- * - repo: Nome do repositório
549
- * - pull_number: Número do PR
550
- *
551
- * PARÂMETROS OPCIONAIS:
552
- * - new_title: Novo título
553
- * - new_body: Nova descrição
554
- * - new_base: Nova branch base
555
- * - new_labels: Novos labels
556
- * - new_assignees: Novos responsáveis
557
- * - new_milestone: Novo milestone
558
- *
559
- * VALIDAÇÕES:
560
- * - Todos os parâmetros obrigatórios
561
- * - PR deve existir
562
- * - Pelo menos um campo deve ser atualizado
563
- *
564
- * RECOMENDAÇÕES:
565
- * - Atualize apenas campos necessários
566
- * - Use mensagens de commit descritivas
567
- * - Documente mudanças importantes
568
- * - Notifique responsáveis sobre mudanças
569
- */
570
- updatePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
571
- /**
572
- * Faz merge de um Pull Request
573
- *
574
- * FUNCIONALIDADE:
575
- * - Merge do PR na branch base
576
- * - Suporta diferentes métodos de merge
577
- * - Permite customização de commit de merge
578
- *
579
- * PARÂMETROS OBRIGATÓRIOS:
580
- * - owner: Proprietário do repositório
581
- * - repo: Nome do repositório
582
- * - pull_number: Número do PR
583
- *
584
- * PARÂMETROS OPCIONAIS:
585
- * - merge_method: Método de merge (merge, rebase, squash)
586
- * - merge_commit_title: Título do commit de merge
587
- * - merge_commit_message: Mensagem do commit de merge
588
- *
589
- * VALIDAÇÕES:
590
- * - Todos os parâmetros obrigatórios
591
- * - PR deve existir e estar aberto
592
- * - Não deve haver conflitos
593
- * - PR deve ser mergeable
594
- *
595
- * RECOMENDAÇÕES:
596
- * - Resolva conflitos antes do merge
597
- * - Escolha método de merge adequado
598
- * - Use títulos e mensagens descritivas
599
- * - Teste após o merge
600
- */
601
- mergePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
602
- /**
603
- * Fecha um Pull Request
604
- *
605
- * FUNCIONALIDADE:
606
- * - Altera estado do PR para closed
607
- * - Mantém histórico e comentários
608
- * - Permite reabertura posterior
609
- *
610
- * PARÂMETROS OBRIGATÓRIOS:
611
- * - owner: Proprietário do repositório
612
- * - repo: Nome do repositório
613
- * - pull_number: Número do PR
614
- *
615
- * VALIDAÇÕES:
616
- * - Todos os parâmetros obrigatórios
617
- * - PR deve existir
618
- * - PR deve estar aberto
619
- *
620
- * RECOMENDAÇÕES:
621
- * - Confirme que PR não é mais necessário
622
- * - Documente motivo do fechamento
623
- * - Use comentário explicativo
624
- * - Verifique se não há dependências
625
- */
626
- closePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
627
- /**
628
- * Adiciona review a um Pull Request
629
- *
630
- * FUNCIONALIDADE:
631
- * - Cria novo review no PR
632
- * - Suporta diferentes tipos de review
633
- * - Mantém histórico de revisões
634
- *
635
- * PARÂMETROS OBRIGATÓRIOS:
636
- * - owner: Proprietário do repositório
637
- * - repo: Nome do repositório
638
- * - pull_number: Número do PR
639
- * - review_event: Tipo de review (APPROVE, REQUEST_CHANGES, COMMENT)
640
- *
641
- * PARÂMETROS OPCIONAIS:
642
- * - review_body: Comentário do review
643
- *
644
- * VALIDAÇÕES:
645
- * - Todos os parâmetros obrigatórios
646
- * - PR deve existir
647
- * - Review event deve ser válido
648
- *
649
- * RECOMENDAÇÕES:
650
- * - Use reviews para controle de qualidade
651
- * - Documente feedback adequadamente
652
- * - Use tipos de review apropriados
653
- * - Mantenha reviews construtivos
654
- */
655
- addReview(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
656
- /**
657
- * Busca Pull Requests por critérios específicos
658
- *
659
- * FUNCIONALIDADE:
660
- * - Busca PRs por conteúdo
661
- * - Filtra por autor, assignee, reviewer e label
662
- * - Retorna resultados relevantes
663
- *
664
- * PARÂMETROS OBRIGATÓRIOS:
665
- * - owner: Proprietário do repositório
666
- * - repo: Nome do repositório
667
- * - query: Termo de busca
668
- *
669
- * PARÂMETROS OPCIONAIS:
670
- * - author: Autor dos PRs
671
- * - assignee: Responsável pelos PRs
672
- * - reviewer: Revisor dos PRs
673
- * - label: Label específico
674
- *
675
- * VALIDAÇÕES:
676
- * - Todos os parâmetros obrigatórios
677
- * - Query deve ter pelo menos 3 caracteres
678
- * - Repositório deve existir
679
- *
680
- * RECOMENDAÇÕES:
681
- * - Use termos de busca específicos
682
- * - Combine filtros para resultados precisos
683
- * - Analise relevância dos resultados
684
- * - Use para encontrar PRs relacionados
685
- */
686
- searchPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
78
+ handler(input: GitPullsInput): Promise<UniversalResponse>;
687
79
  };
688
80
  export {};
689
81
  //# sourceMappingURL=git-pulls.d.ts.map