@andrebuzeli/git-mcp 2.27.3 → 2.28.0

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 (112) hide show
  1. package/dist/client.d.ts +306 -306
  2. package/dist/client.js +298 -298
  3. package/dist/config.d.ts +310 -310
  4. package/dist/config.js +392 -392
  5. package/dist/index.d.ts +22 -22
  6. package/dist/index.js +89 -89
  7. package/dist/providers/base-provider.d.ts +160 -156
  8. package/dist/providers/base-provider.d.ts.map +1 -1
  9. package/dist/providers/base-provider.js +274 -260
  10. package/dist/providers/base-provider.js.map +1 -1
  11. package/dist/providers/error-handler.d.ts +50 -50
  12. package/dist/providers/error-handler.js +175 -175
  13. package/dist/providers/gitea-provider.d.ts +97 -97
  14. package/dist/providers/gitea-provider.js +1001 -1001
  15. package/dist/providers/github-provider.d.ts +104 -104
  16. package/dist/providers/github-provider.js +1234 -1234
  17. package/dist/providers/index.d.ts +12 -12
  18. package/dist/providers/index.js +40 -40
  19. package/dist/providers/provider-factory.d.ts +74 -74
  20. package/dist/providers/provider-factory.js +311 -311
  21. package/dist/providers/types.d.ts +318 -298
  22. package/dist/providers/types.d.ts.map +1 -1
  23. package/dist/providers/types.js +6 -6
  24. package/dist/server.d.ts +76 -76
  25. package/dist/server.d.ts.map +1 -1
  26. package/dist/server.js +306 -357
  27. package/dist/server.js.map +1 -1
  28. package/dist/tools/gh-actions.d.ts +252 -252
  29. package/dist/tools/gh-actions.js +389 -389
  30. package/dist/tools/gh-analytics.d.ts +263 -263
  31. package/dist/tools/gh-analytics.js +401 -401
  32. package/dist/tools/gh-code-review.d.ts +304 -304
  33. package/dist/tools/gh-code-review.js +512 -512
  34. package/dist/tools/gh-codespaces.d.ts +138 -138
  35. package/dist/tools/gh-codespaces.js +282 -282
  36. package/dist/tools/gh-deployments.d.ts +300 -300
  37. package/dist/tools/gh-deployments.js +367 -367
  38. package/dist/tools/gh-gists.d.ts +174 -174
  39. package/dist/tools/gh-gists.js +321 -321
  40. package/dist/tools/gh-projects.d.ts +205 -205
  41. package/dist/tools/gh-projects.js +358 -358
  42. package/dist/tools/gh-security.d.ts +274 -274
  43. package/dist/tools/gh-security.js +395 -395
  44. package/dist/tools/gh-sync.d.ts +213 -213
  45. package/dist/tools/gh-sync.js +378 -378
  46. package/dist/tools/gh-workflows.d.ts +290 -290
  47. package/dist/tools/gh-workflows.js +432 -432
  48. package/dist/tools/git-archive.d.ts +165 -165
  49. package/dist/tools/git-archive.js +233 -233
  50. package/dist/tools/git-branches.d.ts +430 -430
  51. package/dist/tools/git-branches.d.ts.map +1 -1
  52. package/dist/tools/git-branches.js +627 -530
  53. package/dist/tools/git-branches.js.map +1 -1
  54. package/dist/tools/git-bundle.d.ts +171 -171
  55. package/dist/tools/git-bundle.js +241 -241
  56. package/dist/tools/git-cherry-pick.d.ts +158 -158
  57. package/dist/tools/git-cherry-pick.js +224 -224
  58. package/dist/tools/git-commits.d.ts +485 -485
  59. package/dist/tools/git-commits.d.ts.map +1 -1
  60. package/dist/tools/git-commits.js +735 -625
  61. package/dist/tools/git-commits.js.map +1 -1
  62. package/dist/tools/git-config.d.ts +140 -140
  63. package/dist/tools/git-config.js +268 -268
  64. package/dist/tools/git-files.d.ts +486 -486
  65. package/dist/tools/git-files.js +607 -607
  66. package/dist/tools/git-issues.d.ts +571 -571
  67. package/dist/tools/git-issues.d.ts.map +1 -1
  68. package/dist/tools/git-issues.js +740 -693
  69. package/dist/tools/git-issues.js.map +1 -1
  70. package/dist/tools/git-pulls.d.ts +694 -694
  71. package/dist/tools/git-pulls.js +732 -732
  72. package/dist/tools/git-rebase.d.ts +137 -137
  73. package/dist/tools/git-rebase.js +213 -213
  74. package/dist/tools/git-releases.d.ts +487 -487
  75. package/dist/tools/git-releases.js +557 -557
  76. package/dist/tools/git-remote.d.ts +138 -138
  77. package/dist/tools/git-remote.js +274 -274
  78. package/dist/tools/git-repositories.d.ts +483 -483
  79. package/dist/tools/git-repositories.js +640 -640
  80. package/dist/tools/git-reset.d.ts +130 -130
  81. package/dist/tools/git-reset.js +223 -223
  82. package/dist/tools/git-revert.d.ts +149 -149
  83. package/dist/tools/git-revert.js +198 -198
  84. package/dist/tools/git-stash.d.ts +140 -140
  85. package/dist/tools/git-stash.js +269 -269
  86. package/dist/tools/git-submodule.d.ts +152 -152
  87. package/dist/tools/git-submodule.js +289 -289
  88. package/dist/tools/git-sync.d.ts +178 -166
  89. package/dist/tools/git-sync.d.ts.map +1 -1
  90. package/dist/tools/git-sync.js +312 -117
  91. package/dist/tools/git-sync.js.map +1 -1
  92. package/dist/tools/git-tags.d.ts +411 -411
  93. package/dist/tools/git-tags.js +485 -485
  94. package/dist/tools/git-webhooks.d.ts +470 -482
  95. package/dist/tools/git-webhooks.d.ts.map +1 -1
  96. package/dist/tools/git-webhooks.js +543 -555
  97. package/dist/tools/git-webhooks.js.map +1 -1
  98. package/dist/tools/git-worktree.d.ts +159 -159
  99. package/dist/tools/git-worktree.js +269 -269
  100. package/dist/tools/repositories.d.ts +405 -405
  101. package/dist/tools/repositories.js +569 -569
  102. package/dist/tools/users.d.ts +372 -372
  103. package/dist/tools/users.js +499 -499
  104. package/dist/tools/validator.d.ts +170 -170
  105. package/dist/tools/validator.js +194 -194
  106. package/dist/tools/version-control.d.ts +136 -136
  107. package/dist/tools/version-control.js +164 -164
  108. package/dist/utils/terminal-controller.d.ts +80 -80
  109. package/dist/utils/terminal-controller.js +345 -345
  110. package/dist/utils/user-detection.d.ts +24 -24
  111. package/dist/utils/user-detection.js +53 -53
  112. package/package.json +59 -59
@@ -1,695 +1,695 @@
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
- repo: z.ZodString;
47
- provider: z.ZodEnum<["gitea", "github"]>;
48
- title: z.ZodOptional<z.ZodString>;
49
- body: z.ZodOptional<z.ZodString>;
50
- head: z.ZodOptional<z.ZodString>;
51
- base: z.ZodOptional<z.ZodString>;
52
- draft: z.ZodOptional<z.ZodBoolean>;
53
- labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
54
- assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
55
- reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
56
- milestone: z.ZodOptional<z.ZodNumber>;
57
- pull_number: z.ZodOptional<z.ZodNumber>;
58
- state: z.ZodOptional<z.ZodEnum<["open", "closed", "merged", "all"]>>;
59
- page: z.ZodOptional<z.ZodNumber>;
60
- limit: 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>;
77
- }, "strip", z.ZodTypeAny, {
78
- provider: "gitea" | "github";
79
- repo: string;
80
- action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
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
- page?: number | undefined;
90
- limit?: number | undefined;
91
- query?: string | undefined;
92
- author?: string | undefined;
93
- merge_method?: "merge" | "rebase" | "squash" | undefined;
94
- milestone?: number | undefined;
95
- new_title?: string | undefined;
96
- new_body?: string | undefined;
97
- new_labels?: string[] | undefined;
98
- new_assignees?: string[] | undefined;
99
- new_milestone?: number | undefined;
100
- assignee?: string | undefined;
101
- label?: string | undefined;
102
- reviewers?: string[] | undefined;
103
- pull_number?: number | undefined;
104
- new_base?: string | 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
- }, {
111
- provider: "gitea" | "github";
112
- repo: string;
113
- action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
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
- base?: string | undefined;
121
- draft?: boolean | undefined;
122
- page?: number | undefined;
123
- limit?: number | undefined;
124
- query?: string | undefined;
125
- author?: string | undefined;
126
- merge_method?: "merge" | "rebase" | "squash" | undefined;
127
- milestone?: number | undefined;
128
- new_title?: string | undefined;
129
- new_body?: string | undefined;
130
- new_labels?: string[] | undefined;
131
- new_assignees?: string[] | undefined;
132
- new_milestone?: number | undefined;
133
- assignee?: string | undefined;
134
- label?: string | undefined;
135
- reviewers?: string[] | undefined;
136
- pull_number?: number | undefined;
137
- new_base?: string | 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>;
161
- }, "strip", z.ZodTypeAny, {
162
- message: string;
163
- action: string;
164
- success: boolean;
165
- error?: string | undefined;
166
- data?: any;
167
- }, {
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: {
266
- name: string;
267
- description: string;
268
- inputSchema: {
269
- type: string;
270
- properties: {
271
- action: {
272
- type: string;
273
- enum: string[];
274
- description: string;
275
- };
276
- repo: {
277
- type: string;
278
- description: string;
279
- };
280
- provider: {
281
- type: string;
282
- description: string;
283
- };
284
- title: {
285
- type: string;
286
- description: string;
287
- };
288
- body: {
289
- type: string;
290
- description: string;
291
- };
292
- head: {
293
- type: string;
294
- description: string;
295
- };
296
- base: {
297
- type: string;
298
- description: string;
299
- };
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
- limit: {
344
- type: string;
345
- description: string;
346
- minimum: number;
347
- maximum: number;
348
- };
349
- new_title: {
350
- type: string;
351
- description: string;
352
- };
353
- new_body: {
354
- type: string;
355
- description: string;
356
- };
357
- new_base: {
358
- type: string;
359
- description: string;
360
- };
361
- new_labels: {
362
- type: string;
363
- items: {
364
- type: string;
365
- };
366
- description: string;
367
- };
368
- new_assignees: {
369
- type: string;
370
- items: {
371
- type: string;
372
- };
373
- description: string;
374
- };
375
- new_milestone: {
376
- type: string;
377
- description: string;
378
- };
379
- merge_method: {
380
- type: string;
381
- enum: string[];
382
- description: string;
383
- };
384
- merge_commit_title: {
385
- type: string;
386
- description: string;
387
- };
388
- merge_commit_message: {
389
- type: string;
390
- description: string;
391
- };
392
- review_event: {
393
- type: string;
394
- enum: string[];
395
- description: string;
396
- };
397
- review_body: {
398
- type: string;
399
- description: string;
400
- };
401
- query: {
402
- type: string;
403
- description: string;
404
- };
405
- author: {
406
- type: string;
407
- description: string;
408
- };
409
- assignee: {
410
- type: string;
411
- description: string;
412
- };
413
- reviewer: {
414
- type: string;
415
- description: string;
416
- };
417
- label: {
418
- type: string;
419
- description: string;
420
- };
421
- };
422
- required: string[];
423
- };
424
- /**
425
- * Handler principal da tool pulls
426
- *
427
- * FUNCIONALIDADE:
428
- * - Valida entrada usando Zod schema
429
- * - Roteia para método específico baseado na ação
430
- * - Trata erros de forma uniforme
431
- * - Retorna resultado padronizado
432
- *
433
- * FLUXO:
434
- * 1. Validação de entrada
435
- * 2. Seleção do provider
436
- * 3. Roteamento por ação
437
- * 4. Execução do método específico
438
- * 5. Tratamento de erros
439
- * 6. Retorno de resultado
440
- *
441
- * TRATAMENTO DE ERROS:
442
- * - Validação: erro de schema
443
- * - Execução: erro da operação
444
- * - Roteamento: ação não suportada
445
- *
446
- * RECOMENDAÇÕES:
447
- * - Sempre valide entrada antes de processar
448
- * - Trate erros específicos adequadamente
449
- * - Log detalhes de erro para debug
450
- * - Retorne mensagens de erro úteis
451
- */
452
- handler(input: PullsInput): Promise<PullsResult>;
453
- /**
454
- * Cria um novo Pull Request
455
- *
456
- * FUNCIONALIDADE:
457
- * - Cria PR com título e descrição
458
- * - Suporta configuração de branches
459
- * - Permite configuração de draft, labels, assignees
460
- *
461
- * PARÂMETROS OBRIGATÓRIOS:
462
- * - owner: Proprietário do repositório
463
- * - repo: Nome do repositório
464
- * - title: Título do PR
465
- * - head: Branch de origem
466
- * - base: Branch de destino
467
- *
468
- * PARÂMETROS OPCIONAIS:
469
- * - body: Descrição detalhada
470
- * - draft: Se é um draft PR
471
- * - labels: Array de labels para categorização
472
- * - assignees: Array de usuários responsáveis
473
- * - reviewers: Array de revisores
474
- * - milestone: ID do milestone associado
475
- *
476
- * VALIDAÇÕES:
477
- * - Todos os parâmetros obrigatórios
478
- * - Branches devem existir
479
- * - Head e base devem ser diferentes
480
- * - Usuário deve ter permissão de escrita
481
- *
482
- * RECOMENDAÇÕES:
483
- * - Use títulos descritivos e claros
484
- * - Documente mudanças detalhadamente
485
- * - Solicite reviews adequados
486
- * - Mantenha PRs pequenos e focados
487
- */
488
- createPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
489
- /**
490
- * Lista Pull Requests do repositório
491
- *
492
- * FUNCIONALIDADE:
493
- * - Lista PRs com filtros de estado
494
- * - Suporta paginação
495
- * - Retorna informações básicas de cada PR
496
- *
497
- * PARÂMETROS OBRIGATÓRIOS:
498
- * - owner: Proprietário do repositório
499
- * - repo: Nome do repositório
500
- *
501
- * PARÂMETROS OPCIONAIS:
502
- * - state: Estado dos PRs (open, closed, merged, all) - padrão: open
503
- * - page: Página da listagem (padrão: 1)
504
- * - limit: Itens por página (padrão: 30, máximo: 100)
505
- *
506
- * VALIDAÇÕES:
507
- * - e repo obrigatórios
508
- * - State deve ser um dos valores válidos
509
- * - Page deve ser >= 1
510
- * - Limit deve ser entre 1 e 100
511
- *
512
- * RECOMENDAÇÕES:
513
- * - Use paginação para repositórios com muitos PRs
514
- * - Monitore número total de PRs
515
- * - Filtre por estado para organização
516
- * - Mantenha PRs organizados
517
- */
518
- listPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
519
- /**
520
- * Obtém detalhes de um Pull Request específico
521
- *
522
- * FUNCIONALIDADE:
523
- * - Retorna informações completas do PR
524
- * - Inclui título, descrição, branches, labels
525
- * - Mostra status de merge e conflitos
526
- *
527
- * PARÂMETROS OBRIGATÓRIOS:
528
- * - owner: Proprietário do repositório
529
- * - repo: Nome do repositório
530
- * - pull_number: Número do PR
531
- *
532
- * VALIDAÇÕES:
533
- * - Todos os parâmetros obrigatórios
534
- * - PR deve existir no repositório
535
- * - Número deve ser válido
536
- *
537
- * RECOMENDAÇÕES:
538
- * - Use para obter detalhes completos
539
- * - Verifique status de merge
540
- * - Analise conflitos se houver
541
- * - Monitore mudanças importantes
542
- */
543
- getPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
544
- /**
545
- * Atualiza um Pull Request existente
546
- *
547
- * FUNCIONALIDADE:
548
- * - Atualiza campos do PR
549
- * - Suporta mudança de branch base
550
- * - Permite alteração de labels e assignees
551
- *
552
- * PARÂMETROS OBRIGATÓRIOS:
553
- * - owner: Proprietário do repositório
554
- * - repo: Nome do repositório
555
- * - pull_number: Número do PR
556
- *
557
- * PARÂMETROS OPCIONAIS:
558
- * - new_title: Novo título
559
- * - new_body: Nova descrição
560
- * - new_base: Nova branch base
561
- * - new_labels: Novos labels
562
- * - new_assignees: Novos responsáveis
563
- * - new_milestone: Novo milestone
564
- *
565
- * VALIDAÇÕES:
566
- * - Todos os parâmetros obrigatórios
567
- * - PR deve existir
568
- * - Pelo menos um campo deve ser atualizado
569
- *
570
- * RECOMENDAÇÕES:
571
- * - Atualize apenas campos necessários
572
- * - Use mensagens de commit descritivas
573
- * - Documente mudanças importantes
574
- * - Notifique responsáveis sobre mudanças
575
- */
576
- updatePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
577
- /**
578
- * Faz merge de um Pull Request
579
- *
580
- * FUNCIONALIDADE:
581
- * - Merge do PR na branch base
582
- * - Suporta diferentes métodos de merge
583
- * - Permite customização de commit de merge
584
- *
585
- * PARÂMETROS OBRIGATÓRIOS:
586
- * - owner: Proprietário do repositório
587
- * - repo: Nome do repositório
588
- * - pull_number: Número do PR
589
- *
590
- * PARÂMETROS OPCIONAIS:
591
- * - merge_method: Método de merge (merge, rebase, squash)
592
- * - merge_commit_title: Título do commit de merge
593
- * - merge_commit_message: Mensagem do commit de merge
594
- *
595
- * VALIDAÇÕES:
596
- * - Todos os parâmetros obrigatórios
597
- * - PR deve existir e estar aberto
598
- * - Não deve haver conflitos
599
- * - PR deve ser mergeable
600
- *
601
- * RECOMENDAÇÕES:
602
- * - Resolva conflitos antes do merge
603
- * - Escolha método de merge adequado
604
- * - Use títulos e mensagens descritivas
605
- * - Teste após o merge
606
- */
607
- mergePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
608
- /**
609
- * Fecha um Pull Request
610
- *
611
- * FUNCIONALIDADE:
612
- * - Altera estado do PR para closed
613
- * - Mantém histórico e comentários
614
- * - Permite reabertura posterior
615
- *
616
- * PARÂMETROS OBRIGATÓRIOS:
617
- * - owner: Proprietário do repositório
618
- * - repo: Nome do repositório
619
- * - pull_number: Número do PR
620
- *
621
- * VALIDAÇÕES:
622
- * - Todos os parâmetros obrigatórios
623
- * - PR deve existir
624
- * - PR deve estar aberto
625
- *
626
- * RECOMENDAÇÕES:
627
- * - Confirme que PR não é mais necessário
628
- * - Documente motivo do fechamento
629
- * - Use comentário explicativo
630
- * - Verifique se não há dependências
631
- */
632
- closePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
633
- /**
634
- * Adiciona review a um Pull Request
635
- *
636
- * FUNCIONALIDADE:
637
- * - Cria novo review no PR
638
- * - Suporta diferentes tipos de review
639
- * - Mantém histórico de revisões
640
- *
641
- * PARÂMETROS OBRIGATÓRIOS:
642
- * - owner: Proprietário do repositório
643
- * - repo: Nome do repositório
644
- * - pull_number: Número do PR
645
- * - review_event: Tipo de review (APPROVE, REQUEST_CHANGES, COMMENT)
646
- *
647
- * PARÂMETROS OPCIONAIS:
648
- * - review_body: Comentário do review
649
- *
650
- * VALIDAÇÕES:
651
- * - Todos os parâmetros obrigatórios
652
- * - PR deve existir
653
- * - Review event deve ser válido
654
- *
655
- * RECOMENDAÇÕES:
656
- * - Use reviews para controle de qualidade
657
- * - Documente feedback adequadamente
658
- * - Use tipos de review apropriados
659
- * - Mantenha reviews construtivos
660
- */
661
- addReview(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
662
- /**
663
- * Busca Pull Requests por critérios específicos
664
- *
665
- * FUNCIONALIDADE:
666
- * - Busca PRs por conteúdo
667
- * - Filtra por autor, assignee, reviewer e label
668
- * - Retorna resultados relevantes
669
- *
670
- * PARÂMETROS OBRIGATÓRIOS:
671
- * - owner: Proprietário do repositório
672
- * - repo: Nome do repositório
673
- * - query: Termo de busca
674
- *
675
- * PARÂMETROS OPCIONAIS:
676
- * - author: Autor dos PRs
677
- * - assignee: Responsável pelos PRs
678
- * - reviewer: Revisor dos PRs
679
- * - label: Label específico
680
- *
681
- * VALIDAÇÕES:
682
- * - Todos os parâmetros obrigatórios
683
- * - Query deve ter pelo menos 3 caracteres
684
- * - Repositório deve existir
685
- *
686
- * RECOMENDAÇÕES:
687
- * - Use termos de busca específicos
688
- * - Combine filtros para resultados precisos
689
- * - Analise relevância dos resultados
690
- * - Use para encontrar PRs relacionados
691
- */
692
- searchPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
693
- };
694
- export {};
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
+ repo: z.ZodString;
47
+ provider: z.ZodEnum<["gitea", "github"]>;
48
+ title: z.ZodOptional<z.ZodString>;
49
+ body: z.ZodOptional<z.ZodString>;
50
+ head: z.ZodOptional<z.ZodString>;
51
+ base: z.ZodOptional<z.ZodString>;
52
+ draft: z.ZodOptional<z.ZodBoolean>;
53
+ labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
54
+ assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
55
+ reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
56
+ milestone: z.ZodOptional<z.ZodNumber>;
57
+ pull_number: z.ZodOptional<z.ZodNumber>;
58
+ state: z.ZodOptional<z.ZodEnum<["open", "closed", "merged", "all"]>>;
59
+ page: z.ZodOptional<z.ZodNumber>;
60
+ limit: 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>;
77
+ }, "strip", z.ZodTypeAny, {
78
+ provider: "gitea" | "github";
79
+ repo: string;
80
+ action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
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
+ author?: string | undefined;
90
+ page?: number | undefined;
91
+ limit?: number | undefined;
92
+ query?: string | undefined;
93
+ merge_method?: "merge" | "rebase" | "squash" | undefined;
94
+ milestone?: number | undefined;
95
+ new_title?: string | undefined;
96
+ new_body?: string | undefined;
97
+ new_labels?: string[] | undefined;
98
+ new_assignees?: string[] | undefined;
99
+ new_milestone?: number | undefined;
100
+ assignee?: string | undefined;
101
+ label?: string | undefined;
102
+ reviewers?: string[] | undefined;
103
+ pull_number?: number | undefined;
104
+ new_base?: string | 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
+ }, {
111
+ provider: "gitea" | "github";
112
+ repo: string;
113
+ action: "merge" | "get" | "search" | "list" | "create" | "close" | "update" | "review";
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
+ base?: string | undefined;
121
+ draft?: boolean | undefined;
122
+ author?: string | undefined;
123
+ page?: number | undefined;
124
+ limit?: number | undefined;
125
+ query?: string | undefined;
126
+ merge_method?: "merge" | "rebase" | "squash" | undefined;
127
+ milestone?: number | undefined;
128
+ new_title?: string | undefined;
129
+ new_body?: string | undefined;
130
+ new_labels?: string[] | undefined;
131
+ new_assignees?: string[] | undefined;
132
+ new_milestone?: number | undefined;
133
+ assignee?: string | undefined;
134
+ label?: string | undefined;
135
+ reviewers?: string[] | undefined;
136
+ pull_number?: number | undefined;
137
+ new_base?: string | 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>;
161
+ }, "strip", z.ZodTypeAny, {
162
+ message: string;
163
+ action: string;
164
+ success: boolean;
165
+ error?: string | undefined;
166
+ data?: any;
167
+ }, {
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: {
266
+ name: string;
267
+ description: string;
268
+ inputSchema: {
269
+ type: string;
270
+ properties: {
271
+ action: {
272
+ type: string;
273
+ enum: string[];
274
+ description: string;
275
+ };
276
+ repo: {
277
+ type: string;
278
+ description: string;
279
+ };
280
+ provider: {
281
+ type: string;
282
+ description: string;
283
+ };
284
+ title: {
285
+ type: string;
286
+ description: string;
287
+ };
288
+ body: {
289
+ type: string;
290
+ description: string;
291
+ };
292
+ head: {
293
+ type: string;
294
+ description: string;
295
+ };
296
+ base: {
297
+ type: string;
298
+ description: string;
299
+ };
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
+ limit: {
344
+ type: string;
345
+ description: string;
346
+ minimum: number;
347
+ maximum: number;
348
+ };
349
+ new_title: {
350
+ type: string;
351
+ description: string;
352
+ };
353
+ new_body: {
354
+ type: string;
355
+ description: string;
356
+ };
357
+ new_base: {
358
+ type: string;
359
+ description: string;
360
+ };
361
+ new_labels: {
362
+ type: string;
363
+ items: {
364
+ type: string;
365
+ };
366
+ description: string;
367
+ };
368
+ new_assignees: {
369
+ type: string;
370
+ items: {
371
+ type: string;
372
+ };
373
+ description: string;
374
+ };
375
+ new_milestone: {
376
+ type: string;
377
+ description: string;
378
+ };
379
+ merge_method: {
380
+ type: string;
381
+ enum: string[];
382
+ description: string;
383
+ };
384
+ merge_commit_title: {
385
+ type: string;
386
+ description: string;
387
+ };
388
+ merge_commit_message: {
389
+ type: string;
390
+ description: string;
391
+ };
392
+ review_event: {
393
+ type: string;
394
+ enum: string[];
395
+ description: string;
396
+ };
397
+ review_body: {
398
+ type: string;
399
+ description: string;
400
+ };
401
+ query: {
402
+ type: string;
403
+ description: string;
404
+ };
405
+ author: {
406
+ type: string;
407
+ description: string;
408
+ };
409
+ assignee: {
410
+ type: string;
411
+ description: string;
412
+ };
413
+ reviewer: {
414
+ type: string;
415
+ description: string;
416
+ };
417
+ label: {
418
+ type: string;
419
+ description: string;
420
+ };
421
+ };
422
+ required: string[];
423
+ };
424
+ /**
425
+ * Handler principal da tool pulls
426
+ *
427
+ * FUNCIONALIDADE:
428
+ * - Valida entrada usando Zod schema
429
+ * - Roteia para método específico baseado na ação
430
+ * - Trata erros de forma uniforme
431
+ * - Retorna resultado padronizado
432
+ *
433
+ * FLUXO:
434
+ * 1. Validação de entrada
435
+ * 2. Seleção do provider
436
+ * 3. Roteamento por ação
437
+ * 4. Execução do método específico
438
+ * 5. Tratamento de erros
439
+ * 6. Retorno de resultado
440
+ *
441
+ * TRATAMENTO DE ERROS:
442
+ * - Validação: erro de schema
443
+ * - Execução: erro da operação
444
+ * - Roteamento: ação não suportada
445
+ *
446
+ * RECOMENDAÇÕES:
447
+ * - Sempre valide entrada antes de processar
448
+ * - Trate erros específicos adequadamente
449
+ * - Log detalhes de erro para debug
450
+ * - Retorne mensagens de erro úteis
451
+ */
452
+ handler(input: PullsInput): Promise<PullsResult>;
453
+ /**
454
+ * Cria um novo Pull Request
455
+ *
456
+ * FUNCIONALIDADE:
457
+ * - Cria PR com título e descrição
458
+ * - Suporta configuração de branches
459
+ * - Permite configuração de draft, labels, assignees
460
+ *
461
+ * PARÂMETROS OBRIGATÓRIOS:
462
+ * - owner: Proprietário do repositório
463
+ * - repo: Nome do repositório
464
+ * - title: Título do PR
465
+ * - head: Branch de origem
466
+ * - base: Branch de destino
467
+ *
468
+ * PARÂMETROS OPCIONAIS:
469
+ * - body: Descrição detalhada
470
+ * - draft: Se é um draft PR
471
+ * - labels: Array de labels para categorização
472
+ * - assignees: Array de usuários responsáveis
473
+ * - reviewers: Array de revisores
474
+ * - milestone: ID do milestone associado
475
+ *
476
+ * VALIDAÇÕES:
477
+ * - Todos os parâmetros obrigatórios
478
+ * - Branches devem existir
479
+ * - Head e base devem ser diferentes
480
+ * - Usuário deve ter permissão de escrita
481
+ *
482
+ * RECOMENDAÇÕES:
483
+ * - Use títulos descritivos e claros
484
+ * - Documente mudanças detalhadamente
485
+ * - Solicite reviews adequados
486
+ * - Mantenha PRs pequenos e focados
487
+ */
488
+ createPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
489
+ /**
490
+ * Lista Pull Requests do repositório
491
+ *
492
+ * FUNCIONALIDADE:
493
+ * - Lista PRs com filtros de estado
494
+ * - Suporta paginação
495
+ * - Retorna informações básicas de cada PR
496
+ *
497
+ * PARÂMETROS OBRIGATÓRIOS:
498
+ * - owner: Proprietário do repositório
499
+ * - repo: Nome do repositório
500
+ *
501
+ * PARÂMETROS OPCIONAIS:
502
+ * - state: Estado dos PRs (open, closed, merged, all) - padrão: open
503
+ * - page: Página da listagem (padrão: 1)
504
+ * - limit: Itens por página (padrão: 30, máximo: 100)
505
+ *
506
+ * VALIDAÇÕES:
507
+ * - e repo obrigatórios
508
+ * - State deve ser um dos valores válidos
509
+ * - Page deve ser >= 1
510
+ * - Limit deve ser entre 1 e 100
511
+ *
512
+ * RECOMENDAÇÕES:
513
+ * - Use paginação para repositórios com muitos PRs
514
+ * - Monitore número total de PRs
515
+ * - Filtre por estado para organização
516
+ * - Mantenha PRs organizados
517
+ */
518
+ listPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
519
+ /**
520
+ * Obtém detalhes de um Pull Request específico
521
+ *
522
+ * FUNCIONALIDADE:
523
+ * - Retorna informações completas do PR
524
+ * - Inclui título, descrição, branches, labels
525
+ * - Mostra status de merge e conflitos
526
+ *
527
+ * PARÂMETROS OBRIGATÓRIOS:
528
+ * - owner: Proprietário do repositório
529
+ * - repo: Nome do repositório
530
+ * - pull_number: Número do PR
531
+ *
532
+ * VALIDAÇÕES:
533
+ * - Todos os parâmetros obrigatórios
534
+ * - PR deve existir no repositório
535
+ * - Número deve ser válido
536
+ *
537
+ * RECOMENDAÇÕES:
538
+ * - Use para obter detalhes completos
539
+ * - Verifique status de merge
540
+ * - Analise conflitos se houver
541
+ * - Monitore mudanças importantes
542
+ */
543
+ getPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
544
+ /**
545
+ * Atualiza um Pull Request existente
546
+ *
547
+ * FUNCIONALIDADE:
548
+ * - Atualiza campos do PR
549
+ * - Suporta mudança de branch base
550
+ * - Permite alteração de labels e assignees
551
+ *
552
+ * PARÂMETROS OBRIGATÓRIOS:
553
+ * - owner: Proprietário do repositório
554
+ * - repo: Nome do repositório
555
+ * - pull_number: Número do PR
556
+ *
557
+ * PARÂMETROS OPCIONAIS:
558
+ * - new_title: Novo título
559
+ * - new_body: Nova descrição
560
+ * - new_base: Nova branch base
561
+ * - new_labels: Novos labels
562
+ * - new_assignees: Novos responsáveis
563
+ * - new_milestone: Novo milestone
564
+ *
565
+ * VALIDAÇÕES:
566
+ * - Todos os parâmetros obrigatórios
567
+ * - PR deve existir
568
+ * - Pelo menos um campo deve ser atualizado
569
+ *
570
+ * RECOMENDAÇÕES:
571
+ * - Atualize apenas campos necessários
572
+ * - Use mensagens de commit descritivas
573
+ * - Documente mudanças importantes
574
+ * - Notifique responsáveis sobre mudanças
575
+ */
576
+ updatePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
577
+ /**
578
+ * Faz merge de um Pull Request
579
+ *
580
+ * FUNCIONALIDADE:
581
+ * - Merge do PR na branch base
582
+ * - Suporta diferentes métodos de merge
583
+ * - Permite customização de commit de merge
584
+ *
585
+ * PARÂMETROS OBRIGATÓRIOS:
586
+ * - owner: Proprietário do repositório
587
+ * - repo: Nome do repositório
588
+ * - pull_number: Número do PR
589
+ *
590
+ * PARÂMETROS OPCIONAIS:
591
+ * - merge_method: Método de merge (merge, rebase, squash)
592
+ * - merge_commit_title: Título do commit de merge
593
+ * - merge_commit_message: Mensagem do commit de merge
594
+ *
595
+ * VALIDAÇÕES:
596
+ * - Todos os parâmetros obrigatórios
597
+ * - PR deve existir e estar aberto
598
+ * - Não deve haver conflitos
599
+ * - PR deve ser mergeable
600
+ *
601
+ * RECOMENDAÇÕES:
602
+ * - Resolva conflitos antes do merge
603
+ * - Escolha método de merge adequado
604
+ * - Use títulos e mensagens descritivas
605
+ * - Teste após o merge
606
+ */
607
+ mergePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
608
+ /**
609
+ * Fecha um Pull Request
610
+ *
611
+ * FUNCIONALIDADE:
612
+ * - Altera estado do PR para closed
613
+ * - Mantém histórico e comentários
614
+ * - Permite reabertura posterior
615
+ *
616
+ * PARÂMETROS OBRIGATÓRIOS:
617
+ * - owner: Proprietário do repositório
618
+ * - repo: Nome do repositório
619
+ * - pull_number: Número do PR
620
+ *
621
+ * VALIDAÇÕES:
622
+ * - Todos os parâmetros obrigatórios
623
+ * - PR deve existir
624
+ * - PR deve estar aberto
625
+ *
626
+ * RECOMENDAÇÕES:
627
+ * - Confirme que PR não é mais necessário
628
+ * - Documente motivo do fechamento
629
+ * - Use comentário explicativo
630
+ * - Verifique se não há dependências
631
+ */
632
+ closePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
633
+ /**
634
+ * Adiciona review a um Pull Request
635
+ *
636
+ * FUNCIONALIDADE:
637
+ * - Cria novo review no PR
638
+ * - Suporta diferentes tipos de review
639
+ * - Mantém histórico de revisões
640
+ *
641
+ * PARÂMETROS OBRIGATÓRIOS:
642
+ * - owner: Proprietário do repositório
643
+ * - repo: Nome do repositório
644
+ * - pull_number: Número do PR
645
+ * - review_event: Tipo de review (APPROVE, REQUEST_CHANGES, COMMENT)
646
+ *
647
+ * PARÂMETROS OPCIONAIS:
648
+ * - review_body: Comentário do review
649
+ *
650
+ * VALIDAÇÕES:
651
+ * - Todos os parâmetros obrigatórios
652
+ * - PR deve existir
653
+ * - Review event deve ser válido
654
+ *
655
+ * RECOMENDAÇÕES:
656
+ * - Use reviews para controle de qualidade
657
+ * - Documente feedback adequadamente
658
+ * - Use tipos de review apropriados
659
+ * - Mantenha reviews construtivos
660
+ */
661
+ addReview(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
662
+ /**
663
+ * Busca Pull Requests por critérios específicos
664
+ *
665
+ * FUNCIONALIDADE:
666
+ * - Busca PRs por conteúdo
667
+ * - Filtra por autor, assignee, reviewer e label
668
+ * - Retorna resultados relevantes
669
+ *
670
+ * PARÂMETROS OBRIGATÓRIOS:
671
+ * - owner: Proprietário do repositório
672
+ * - repo: Nome do repositório
673
+ * - query: Termo de busca
674
+ *
675
+ * PARÂMETROS OPCIONAIS:
676
+ * - author: Autor dos PRs
677
+ * - assignee: Responsável pelos PRs
678
+ * - reviewer: Revisor dos PRs
679
+ * - label: Label específico
680
+ *
681
+ * VALIDAÇÕES:
682
+ * - Todos os parâmetros obrigatórios
683
+ * - Query deve ter pelo menos 3 caracteres
684
+ * - Repositório deve existir
685
+ *
686
+ * RECOMENDAÇÕES:
687
+ * - Use termos de busca específicos
688
+ * - Combine filtros para resultados precisos
689
+ * - Analise relevância dos resultados
690
+ * - Use para encontrar PRs relacionados
691
+ */
692
+ searchPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
693
+ };
694
+ export {};
695
695
  //# sourceMappingURL=git-pulls.d.ts.map