@andrebuzeli/git-mcp 2.6.1

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