@andrebuzeli/git-mcp 2.29.0 → 2.29.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.
- package/dist/providers/provider-factory.js +3 -3
- package/dist/providers/provider-factory.js.map +1 -1
- package/dist/server.js +9 -9
- package/dist/server.js.map +1 -1
- package/dist/tools/git-archive.d.ts +10 -10
- package/dist/tools/git-archive.js +22 -22
- package/dist/tools/git-archive.js.map +1 -1
- package/dist/tools/git-branches.d.ts +145 -145
- package/dist/tools/git-branches.js +172 -172
- package/dist/tools/git-branches.js.map +1 -1
- package/dist/tools/git-commits.d.ts +156 -156
- package/dist/tools/git-commits.js +188 -188
- package/dist/tools/git-commits.js.map +1 -1
- package/dist/tools/git-config.d.ts +15 -15
- package/dist/tools/git-config.js +45 -45
- package/dist/tools/git-config.js.map +1 -1
- package/dist/tools/git-files.d.ts +199 -199
- package/dist/tools/git-files.js +221 -221
- package/dist/tools/git-files.js.map +1 -1
- package/dist/tools/git-initialize.d.ts +41 -41
- package/dist/tools/git-initialize.js +73 -73
- package/dist/tools/git-initialize.js.map +1 -1
- package/dist/tools/git-issues.d.ts +190 -190
- package/dist/tools/git-issues.js +226 -226
- package/dist/tools/git-issues.js.map +1 -1
- package/dist/tools/git-pulls.d.ts +209 -209
- package/dist/tools/git-pulls.js +226 -226
- package/dist/tools/git-pulls.js.map +1 -1
- package/dist/tools/git-releases.d.ts +157 -157
- package/dist/tools/git-releases.js +171 -171
- package/dist/tools/git-releases.js.map +1 -1
- package/dist/tools/git-remote.d.ts +6 -6
- package/dist/tools/git-remote.js +14 -14
- package/dist/tools/git-remote.js.map +1 -1
- package/dist/tools/git-repositories.d.ts +176 -176
- package/dist/tools/git-repositories.js +218 -218
- package/dist/tools/git-repositories.js.map +1 -1
- package/dist/tools/git-reset.d.ts +10 -10
- package/dist/tools/git-reset.js +15 -15
- package/dist/tools/git-reset.js.map +1 -1
- package/dist/tools/git-revert.d.ts +11 -11
- package/dist/tools/git-revert.js +18 -18
- package/dist/tools/git-revert.js.map +1 -1
- package/dist/tools/git-stash.d.ts +7 -7
- package/dist/tools/git-stash.js +11 -11
- package/dist/tools/git-stash.js.map +1 -1
- package/dist/tools/git-sync.d.ts +13 -13
- package/dist/tools/git-sync.js +34 -34
- package/dist/tools/git-sync.js.map +1 -1
- package/dist/tools/git-tags.d.ts +134 -134
- package/dist/tools/git-tags.js +152 -152
- package/dist/tools/git-tags.js.map +1 -1
- package/dist/tools/git-upload-project.js +7 -7
- package/dist/tools/git-upload-project.js.map +1 -1
- package/dist/utils/terminal-controller.js +7 -7
- package/dist/utils/terminal-controller.js.map +1 -1
- package/package.json +2 -2
|
@@ -3,43 +3,43 @@ import { VcsOperations } from '../providers/index.js';
|
|
|
3
3
|
/**
|
|
4
4
|
* Tool: pulls
|
|
5
5
|
*
|
|
6
|
-
*
|
|
6
|
+
* DESCRIÇÃO:
|
|
7
7
|
* Gerenciamento completo de pull requests com suporte multi-provider (GitHub e Gitea)
|
|
8
8
|
*
|
|
9
9
|
* FUNCIONALIDADES:
|
|
10
|
-
* -
|
|
10
|
+
* - Criação de novos pull requests
|
|
11
11
|
* - Listagem e busca de PRs
|
|
12
|
-
* -
|
|
13
|
-
* -
|
|
12
|
+
* - Obtenção de detalhes específicos
|
|
13
|
+
* - Atualização de PRs existentes
|
|
14
14
|
* - Merge de pull requests
|
|
15
15
|
* - Fechamento de PRs
|
|
16
|
-
* -
|
|
17
|
-
* - Busca por
|
|
16
|
+
* - Revisão e aprovação
|
|
17
|
+
* - Busca por conteúdo e status
|
|
18
18
|
*
|
|
19
19
|
* USO:
|
|
20
|
-
* - Para gerenciar
|
|
21
|
-
* - Para
|
|
20
|
+
* - Para gerenciar integração de código
|
|
21
|
+
* - Para revisão de código
|
|
22
22
|
* - Para controle de qualidade
|
|
23
|
-
* - Para
|
|
23
|
+
* - Para colaboração em equipe
|
|
24
24
|
*
|
|
25
|
-
*
|
|
26
|
-
* - Use
|
|
27
|
-
* - Documente
|
|
25
|
+
* RECOMENDAÇÕES:
|
|
26
|
+
* - Use títulos descritivos
|
|
27
|
+
* - Documente mudanças detalhadamente
|
|
28
28
|
* - Revise antes de fazer merge
|
|
29
29
|
* - Mantenha PRs pequenos e focados
|
|
30
30
|
*/
|
|
31
31
|
/**
|
|
32
|
-
* Schema de
|
|
32
|
+
* Schema de validação para entrada da tool pulls
|
|
33
33
|
*
|
|
34
|
-
*
|
|
35
|
-
* - action:
|
|
36
|
-
* -
|
|
37
|
-
* -
|
|
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
38
|
*
|
|
39
|
-
*
|
|
39
|
+
* RECOMENDAÇÕES:
|
|
40
40
|
* - Sempre valide entrada antes de usar
|
|
41
|
-
* - Use
|
|
42
|
-
* - Documente
|
|
41
|
+
* - Use parâmetros opcionais adequadamente
|
|
42
|
+
* - Documente parâmetros obrigatórios
|
|
43
43
|
*/
|
|
44
44
|
declare const PullsInputSchema: z.ZodObject<{
|
|
45
45
|
action: z.ZodEnum<["create", "list", "get", "update", "merge", "close", "review", "search"]>;
|
|
@@ -146,11 +146,11 @@ declare const PullsInputSchema: z.ZodObject<{
|
|
|
146
146
|
}>;
|
|
147
147
|
export type PullsInput = z.infer<typeof PullsInputSchema>;
|
|
148
148
|
/**
|
|
149
|
-
* Schema de
|
|
149
|
+
* Schema de saída padronizado
|
|
150
150
|
*
|
|
151
151
|
* ESTRUTURA:
|
|
152
|
-
* - success: Status da
|
|
153
|
-
* - action:
|
|
152
|
+
* - success: Status da operação
|
|
153
|
+
* - action: Ação executada
|
|
154
154
|
* - message: Mensagem descritiva
|
|
155
155
|
* - data: Dados retornados (opcional)
|
|
156
156
|
* - error: Detalhes do erro (opcional)
|
|
@@ -178,92 +178,92 @@ export type PullsResult = z.infer<typeof PullsResultSchema>;
|
|
|
178
178
|
/**
|
|
179
179
|
* Tool: pulls
|
|
180
180
|
*
|
|
181
|
-
*
|
|
182
|
-
* Gerenciamento completo de Pull Requests Gitea com
|
|
181
|
+
* DESCRIÇÃO:
|
|
182
|
+
* Gerenciamento completo de Pull Requests Gitea com múltiplas ações
|
|
183
183
|
*
|
|
184
|
-
* ACTIONS
|
|
184
|
+
* ACTIONS DISPONÍVEIS:
|
|
185
185
|
*
|
|
186
186
|
* 1. create - Criar novo Pull Request
|
|
187
|
-
*
|
|
188
|
-
* - owner (
|
|
189
|
-
* - repo (
|
|
190
|
-
* - title (
|
|
191
|
-
* - body (opcional):
|
|
192
|
-
* - head (
|
|
193
|
-
* - base (
|
|
194
|
-
* - draft (opcional): Se
|
|
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
195
|
* - labels (opcional): Array de labels
|
|
196
|
-
* - assignees (opcional): Array de
|
|
196
|
+
* - assignees (opcional): Array de usuários responsáveis
|
|
197
197
|
* - reviewers (opcional): Array de revisores
|
|
198
198
|
* - milestone (opcional): ID do milestone
|
|
199
199
|
*
|
|
200
200
|
* 2. list - Listar Pull Requests
|
|
201
|
-
*
|
|
202
|
-
* - owner (
|
|
203
|
-
* - repo (
|
|
204
|
-
* - state (opcional): Estado dos PRs (open, closed, merged, all) -
|
|
205
|
-
* - page (opcional):
|
|
206
|
-
* - limit (opcional): Itens por
|
|
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
207
|
*
|
|
208
208
|
* 3. get - Obter detalhes do Pull Request
|
|
209
|
-
*
|
|
210
|
-
* - owner (
|
|
211
|
-
* - repo (
|
|
212
|
-
* - pull_number (
|
|
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
213
|
*
|
|
214
214
|
* 4. update - Atualizar Pull Request existente
|
|
215
|
-
*
|
|
216
|
-
* - owner (
|
|
217
|
-
* - repo (
|
|
218
|
-
* - pull_number (
|
|
219
|
-
* - new_title (opcional): Novo
|
|
220
|
-
* - new_body (opcional): Nova
|
|
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
221
|
* - new_base (opcional): Nova branch base
|
|
222
222
|
* - new_labels (opcional): Novos labels
|
|
223
|
-
* - new_assignees (opcional): Novos
|
|
223
|
+
* - new_assignees (opcional): Novos responsáveis
|
|
224
224
|
* - new_milestone (opcional): Novo milestone
|
|
225
225
|
*
|
|
226
226
|
* 5. merge - Fazer merge do Pull Request
|
|
227
|
-
*
|
|
228
|
-
* - owner (
|
|
229
|
-
* - repo (
|
|
230
|
-
* - pull_number (
|
|
231
|
-
* - merge_method (opcional):
|
|
232
|
-
* - merge_commit_title (opcional):
|
|
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
233
|
* - merge_commit_message (opcional): Mensagem do commit de merge
|
|
234
234
|
*
|
|
235
235
|
* 6. close - Fechar Pull Request
|
|
236
|
-
*
|
|
237
|
-
* - owner (
|
|
238
|
-
* - repo (
|
|
239
|
-
* - pull_number (
|
|
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
240
|
*
|
|
241
241
|
* 7. review - Adicionar review ao Pull Request
|
|
242
|
-
*
|
|
243
|
-
* - owner (
|
|
244
|
-
* - repo (
|
|
245
|
-
* - pull_number (
|
|
246
|
-
* - review_event (
|
|
247
|
-
* - review_body (opcional):
|
|
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
248
|
*
|
|
249
249
|
* 8. search - Buscar Pull Requests
|
|
250
|
-
*
|
|
251
|
-
* - owner (
|
|
252
|
-
* - repo (
|
|
253
|
-
* - query (
|
|
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
254
|
* - author (opcional): Autor dos PRs
|
|
255
|
-
* - assignee (opcional):
|
|
255
|
+
* - assignee (opcional): Responsável pelos PRs
|
|
256
256
|
* - reviewer (opcional): Revisor dos PRs
|
|
257
|
-
* - label (opcional): Label
|
|
257
|
+
* - label (opcional): Label específico
|
|
258
258
|
*
|
|
259
|
-
*
|
|
260
|
-
* - Use
|
|
261
|
-
* - Documente
|
|
259
|
+
* RECOMENDAÇÕES DE USO:
|
|
260
|
+
* - Use títulos descritivos e claros
|
|
261
|
+
* - Documente mudanças detalhadamente
|
|
262
262
|
* - Solicite reviews adequados
|
|
263
263
|
* - Mantenha PRs pequenos e focados
|
|
264
|
-
* - Use labels para
|
|
265
|
-
* - Atribua
|
|
266
|
-
* - Escolha
|
|
264
|
+
* - Use labels para categorização
|
|
265
|
+
* - Atribua responsáveis adequadamente
|
|
266
|
+
* - Escolha método de merge apropriado
|
|
267
267
|
*/
|
|
268
268
|
export declare const pullsTool: {
|
|
269
269
|
name: string;
|
|
@@ -429,119 +429,119 @@ export declare const pullsTool: {
|
|
|
429
429
|
*
|
|
430
430
|
* FUNCIONALIDADE:
|
|
431
431
|
* - Valida entrada usando Zod schema
|
|
432
|
-
* - Roteia para
|
|
432
|
+
* - Roteia para método específico baseado na ação
|
|
433
433
|
* - Trata erros de forma uniforme
|
|
434
434
|
* - Retorna resultado padronizado
|
|
435
435
|
*
|
|
436
436
|
* FLUXO:
|
|
437
|
-
* 1.
|
|
438
|
-
* 2.
|
|
439
|
-
* 3. Roteamento por
|
|
440
|
-
* 4.
|
|
437
|
+
* 1. Validação de entrada
|
|
438
|
+
* 2. Seleção do provider
|
|
439
|
+
* 3. Roteamento por ação
|
|
440
|
+
* 4. Execução do método específico
|
|
441
441
|
* 5. Tratamento de erros
|
|
442
442
|
* 6. Retorno de resultado
|
|
443
443
|
*
|
|
444
444
|
* TRATAMENTO DE ERROS:
|
|
445
|
-
* -
|
|
446
|
-
* -
|
|
447
|
-
* - Roteamento:
|
|
445
|
+
* - Validação: erro de schema
|
|
446
|
+
* - Execução: erro da operação
|
|
447
|
+
* - Roteamento: ação não suportada
|
|
448
448
|
*
|
|
449
|
-
*
|
|
449
|
+
* RECOMENDAÇÕES:
|
|
450
450
|
* - Sempre valide entrada antes de processar
|
|
451
|
-
* - Trate erros
|
|
451
|
+
* - Trate erros específicos adequadamente
|
|
452
452
|
* - Log detalhes de erro para debug
|
|
453
|
-
* - Retorne mensagens de erro
|
|
453
|
+
* - Retorne mensagens de erro úteis
|
|
454
454
|
*/
|
|
455
455
|
handler(input: PullsInput): Promise<PullsResult>;
|
|
456
456
|
/**
|
|
457
457
|
* Cria um novo Pull Request
|
|
458
458
|
*
|
|
459
459
|
* FUNCIONALIDADE:
|
|
460
|
-
* - Cria PR com
|
|
461
|
-
* - Suporta
|
|
462
|
-
* - Permite
|
|
463
|
-
*
|
|
464
|
-
*
|
|
465
|
-
* - owner:
|
|
466
|
-
* - repo: Nome do
|
|
467
|
-
* - title:
|
|
460
|
+
* - Cria PR com título e descrição
|
|
461
|
+
* - Suporta configuração de branches
|
|
462
|
+
* - Permite configuração de draft, labels, assignees
|
|
463
|
+
*
|
|
464
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
465
|
+
* - owner: Proprietário do repositório
|
|
466
|
+
* - repo: Nome do repositório
|
|
467
|
+
* - title: Título do PR
|
|
468
468
|
* - head: Branch de origem
|
|
469
469
|
* - base: Branch de destino
|
|
470
470
|
*
|
|
471
|
-
*
|
|
472
|
-
* - body:
|
|
473
|
-
* - draft: Se
|
|
474
|
-
* - labels: Array de labels para
|
|
475
|
-
* - assignees: Array de
|
|
471
|
+
* PARÂMETROS OPCIONAIS:
|
|
472
|
+
* - body: Descrição detalhada
|
|
473
|
+
* - draft: Se é um draft PR
|
|
474
|
+
* - labels: Array de labels para categorização
|
|
475
|
+
* - assignees: Array de usuários responsáveis
|
|
476
476
|
* - reviewers: Array de revisores
|
|
477
477
|
* - milestone: ID do milestone associado
|
|
478
478
|
*
|
|
479
|
-
*
|
|
480
|
-
* - Todos os
|
|
479
|
+
* VALIDAÇÕES:
|
|
480
|
+
* - Todos os parâmetros obrigatórios
|
|
481
481
|
* - Branches devem existir
|
|
482
482
|
* - Head e base devem ser diferentes
|
|
483
|
-
* -
|
|
483
|
+
* - Usuário deve ter permissão de escrita
|
|
484
484
|
*
|
|
485
|
-
*
|
|
486
|
-
* - Use
|
|
487
|
-
* - Documente
|
|
485
|
+
* RECOMENDAÇÕES:
|
|
486
|
+
* - Use títulos descritivos e claros
|
|
487
|
+
* - Documente mudanças detalhadamente
|
|
488
488
|
* - Solicite reviews adequados
|
|
489
489
|
* - Mantenha PRs pequenos e focados
|
|
490
490
|
*/
|
|
491
491
|
createPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
492
492
|
/**
|
|
493
|
-
* Lista Pull Requests do
|
|
493
|
+
* Lista Pull Requests do repositório
|
|
494
494
|
*
|
|
495
495
|
* FUNCIONALIDADE:
|
|
496
496
|
* - Lista PRs com filtros de estado
|
|
497
|
-
* - Suporta
|
|
498
|
-
* - Retorna
|
|
497
|
+
* - Suporta paginação
|
|
498
|
+
* - Retorna informações básicas de cada PR
|
|
499
499
|
*
|
|
500
|
-
*
|
|
501
|
-
* - owner:
|
|
502
|
-
* - repo: Nome do
|
|
500
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
501
|
+
* - owner: Proprietário do repositório
|
|
502
|
+
* - repo: Nome do repositório
|
|
503
503
|
*
|
|
504
|
-
*
|
|
505
|
-
* - state: Estado dos PRs (open, closed, merged, all) -
|
|
506
|
-
* - page:
|
|
507
|
-
* - limit: Itens por
|
|
504
|
+
* PARÂMETROS OPCIONAIS:
|
|
505
|
+
* - state: Estado dos PRs (open, closed, merged, all) - padrão: open
|
|
506
|
+
* - page: Página da listagem (padrão: 1)
|
|
507
|
+
* - limit: Itens por página (padrão: 30, máximo: 100)
|
|
508
508
|
*
|
|
509
|
-
*
|
|
510
|
-
* - e repo
|
|
511
|
-
* - State deve ser um dos valores
|
|
509
|
+
* VALIDAÇÕES:
|
|
510
|
+
* - e repo obrigatórios
|
|
511
|
+
* - State deve ser um dos valores válidos
|
|
512
512
|
* - Page deve ser >= 1
|
|
513
513
|
* - Limit deve ser entre 1 e 100
|
|
514
514
|
*
|
|
515
|
-
*
|
|
516
|
-
* - Use
|
|
517
|
-
* - Monitore
|
|
518
|
-
* - Filtre por estado para
|
|
515
|
+
* RECOMENDAÇÕES:
|
|
516
|
+
* - Use paginação para repositórios com muitos PRs
|
|
517
|
+
* - Monitore número total de PRs
|
|
518
|
+
* - Filtre por estado para organização
|
|
519
519
|
* - Mantenha PRs organizados
|
|
520
520
|
*/
|
|
521
521
|
listPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
522
522
|
/**
|
|
523
|
-
*
|
|
523
|
+
* Obtém detalhes de um Pull Request específico
|
|
524
524
|
*
|
|
525
525
|
* FUNCIONALIDADE:
|
|
526
|
-
* - Retorna
|
|
527
|
-
* - Inclui
|
|
526
|
+
* - Retorna informações completas do PR
|
|
527
|
+
* - Inclui título, descrição, branches, labels
|
|
528
528
|
* - Mostra status de merge e conflitos
|
|
529
529
|
*
|
|
530
|
-
*
|
|
531
|
-
* - owner:
|
|
532
|
-
* - repo: Nome do
|
|
533
|
-
* - pull_number:
|
|
530
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
531
|
+
* - owner: Proprietário do repositório
|
|
532
|
+
* - repo: Nome do repositório
|
|
533
|
+
* - pull_number: Número do PR
|
|
534
534
|
*
|
|
535
|
-
*
|
|
536
|
-
* - Todos os
|
|
537
|
-
* - PR deve existir no
|
|
538
|
-
* -
|
|
535
|
+
* VALIDAÇÕES:
|
|
536
|
+
* - Todos os parâmetros obrigatórios
|
|
537
|
+
* - PR deve existir no repositório
|
|
538
|
+
* - Número deve ser válido
|
|
539
539
|
*
|
|
540
|
-
*
|
|
540
|
+
* RECOMENDAÇÕES:
|
|
541
541
|
* - Use para obter detalhes completos
|
|
542
542
|
* - Verifique status de merge
|
|
543
543
|
* - Analise conflitos se houver
|
|
544
|
-
* - Monitore
|
|
544
|
+
* - Monitore mudanças importantes
|
|
545
545
|
*/
|
|
546
546
|
getPullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
547
547
|
/**
|
|
@@ -549,32 +549,32 @@ export declare const pullsTool: {
|
|
|
549
549
|
*
|
|
550
550
|
* FUNCIONALIDADE:
|
|
551
551
|
* - Atualiza campos do PR
|
|
552
|
-
* - Suporta
|
|
553
|
-
* - Permite
|
|
552
|
+
* - Suporta mudança de branch base
|
|
553
|
+
* - Permite alteração de labels e assignees
|
|
554
554
|
*
|
|
555
|
-
*
|
|
556
|
-
* - owner:
|
|
557
|
-
* - repo: Nome do
|
|
558
|
-
* - pull_number:
|
|
555
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
556
|
+
* - owner: Proprietário do repositório
|
|
557
|
+
* - repo: Nome do repositório
|
|
558
|
+
* - pull_number: Número do PR
|
|
559
559
|
*
|
|
560
|
-
*
|
|
561
|
-
* - new_title: Novo
|
|
562
|
-
* - new_body: Nova
|
|
560
|
+
* PARÂMETROS OPCIONAIS:
|
|
561
|
+
* - new_title: Novo título
|
|
562
|
+
* - new_body: Nova descrição
|
|
563
563
|
* - new_base: Nova branch base
|
|
564
564
|
* - new_labels: Novos labels
|
|
565
|
-
* - new_assignees: Novos
|
|
565
|
+
* - new_assignees: Novos responsáveis
|
|
566
566
|
* - new_milestone: Novo milestone
|
|
567
567
|
*
|
|
568
|
-
*
|
|
569
|
-
* - Todos os
|
|
568
|
+
* VALIDAÇÕES:
|
|
569
|
+
* - Todos os parâmetros obrigatórios
|
|
570
570
|
* - PR deve existir
|
|
571
571
|
* - Pelo menos um campo deve ser atualizado
|
|
572
572
|
*
|
|
573
|
-
*
|
|
574
|
-
* - Atualize apenas campos
|
|
573
|
+
* RECOMENDAÇÕES:
|
|
574
|
+
* - Atualize apenas campos necessários
|
|
575
575
|
* - Use mensagens de commit descritivas
|
|
576
|
-
* - Documente
|
|
577
|
-
* - Notifique
|
|
576
|
+
* - Documente mudanças importantes
|
|
577
|
+
* - Notifique responsáveis sobre mudanças
|
|
578
578
|
*/
|
|
579
579
|
updatePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
580
580
|
/**
|
|
@@ -582,30 +582,30 @@ export declare const pullsTool: {
|
|
|
582
582
|
*
|
|
583
583
|
* FUNCIONALIDADE:
|
|
584
584
|
* - Merge do PR na branch base
|
|
585
|
-
* - Suporta diferentes
|
|
586
|
-
* - Permite
|
|
585
|
+
* - Suporta diferentes métodos de merge
|
|
586
|
+
* - Permite customização de commit de merge
|
|
587
587
|
*
|
|
588
|
-
*
|
|
589
|
-
* - owner:
|
|
590
|
-
* - repo: Nome do
|
|
591
|
-
* - pull_number:
|
|
588
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
589
|
+
* - owner: Proprietário do repositório
|
|
590
|
+
* - repo: Nome do repositório
|
|
591
|
+
* - pull_number: Número do PR
|
|
592
592
|
*
|
|
593
|
-
*
|
|
594
|
-
* - merge_method:
|
|
595
|
-
* - merge_commit_title:
|
|
593
|
+
* PARÂMETROS OPCIONAIS:
|
|
594
|
+
* - merge_method: Método de merge (merge, rebase, squash)
|
|
595
|
+
* - merge_commit_title: Título do commit de merge
|
|
596
596
|
* - merge_commit_message: Mensagem do commit de merge
|
|
597
597
|
*
|
|
598
|
-
*
|
|
599
|
-
* - Todos os
|
|
598
|
+
* VALIDAÇÕES:
|
|
599
|
+
* - Todos os parâmetros obrigatórios
|
|
600
600
|
* - PR deve existir e estar aberto
|
|
601
|
-
* -
|
|
601
|
+
* - Não deve haver conflitos
|
|
602
602
|
* - PR deve ser mergeable
|
|
603
603
|
*
|
|
604
|
-
*
|
|
604
|
+
* RECOMENDAÇÕES:
|
|
605
605
|
* - Resolva conflitos antes do merge
|
|
606
|
-
* - Escolha
|
|
607
|
-
* - Use
|
|
608
|
-
* - Teste
|
|
606
|
+
* - Escolha método de merge adequado
|
|
607
|
+
* - Use títulos e mensagens descritivas
|
|
608
|
+
* - Teste após o merge
|
|
609
609
|
*/
|
|
610
610
|
mergePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
611
611
|
/**
|
|
@@ -613,24 +613,24 @@ export declare const pullsTool: {
|
|
|
613
613
|
*
|
|
614
614
|
* FUNCIONALIDADE:
|
|
615
615
|
* - Altera estado do PR para closed
|
|
616
|
-
* -
|
|
616
|
+
* - Mantém histórico e comentários
|
|
617
617
|
* - Permite reabertura posterior
|
|
618
618
|
*
|
|
619
|
-
*
|
|
620
|
-
* - owner:
|
|
621
|
-
* - repo: Nome do
|
|
622
|
-
* - pull_number:
|
|
619
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
620
|
+
* - owner: Proprietário do repositório
|
|
621
|
+
* - repo: Nome do repositório
|
|
622
|
+
* - pull_number: Número do PR
|
|
623
623
|
*
|
|
624
|
-
*
|
|
625
|
-
* - Todos os
|
|
624
|
+
* VALIDAÇÕES:
|
|
625
|
+
* - Todos os parâmetros obrigatórios
|
|
626
626
|
* - PR deve existir
|
|
627
627
|
* - PR deve estar aberto
|
|
628
628
|
*
|
|
629
|
-
*
|
|
630
|
-
* - Confirme que PR
|
|
629
|
+
* RECOMENDAÇÕES:
|
|
630
|
+
* - Confirme que PR não é mais necessário
|
|
631
631
|
* - Documente motivo do fechamento
|
|
632
|
-
* - Use
|
|
633
|
-
* - Verifique se
|
|
632
|
+
* - Use comentário explicativo
|
|
633
|
+
* - Verifique se não há dependências
|
|
634
634
|
*/
|
|
635
635
|
closePullRequest(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
636
636
|
/**
|
|
@@ -639,23 +639,23 @@ export declare const pullsTool: {
|
|
|
639
639
|
* FUNCIONALIDADE:
|
|
640
640
|
* - Cria novo review no PR
|
|
641
641
|
* - Suporta diferentes tipos de review
|
|
642
|
-
* -
|
|
642
|
+
* - Mantém histórico de revisões
|
|
643
643
|
*
|
|
644
|
-
*
|
|
645
|
-
* - owner:
|
|
646
|
-
* - repo: Nome do
|
|
647
|
-
* - pull_number:
|
|
644
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
645
|
+
* - owner: Proprietário do repositório
|
|
646
|
+
* - repo: Nome do repositório
|
|
647
|
+
* - pull_number: Número do PR
|
|
648
648
|
* - review_event: Tipo de review (APPROVE, REQUEST_CHANGES, COMMENT)
|
|
649
649
|
*
|
|
650
|
-
*
|
|
651
|
-
* - review_body:
|
|
650
|
+
* PARÂMETROS OPCIONAIS:
|
|
651
|
+
* - review_body: Comentário do review
|
|
652
652
|
*
|
|
653
|
-
*
|
|
654
|
-
* - Todos os
|
|
653
|
+
* VALIDAÇÕES:
|
|
654
|
+
* - Todos os parâmetros obrigatórios
|
|
655
655
|
* - PR deve existir
|
|
656
|
-
* - Review event deve ser
|
|
656
|
+
* - Review event deve ser válido
|
|
657
657
|
*
|
|
658
|
-
*
|
|
658
|
+
* RECOMENDAÇÕES:
|
|
659
659
|
* - Use reviews para controle de qualidade
|
|
660
660
|
* - Documente feedback adequadamente
|
|
661
661
|
* - Use tipos de review apropriados
|
|
@@ -663,38 +663,38 @@ export declare const pullsTool: {
|
|
|
663
663
|
*/
|
|
664
664
|
addReview(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
665
665
|
/**
|
|
666
|
-
* Busca Pull Requests por
|
|
666
|
+
* Busca Pull Requests por critérios específicos
|
|
667
667
|
*
|
|
668
668
|
* FUNCIONALIDADE:
|
|
669
|
-
* - Busca PRs por
|
|
669
|
+
* - Busca PRs por conteúdo
|
|
670
670
|
* - Filtra por autor, assignee, reviewer e label
|
|
671
671
|
* - Retorna resultados relevantes
|
|
672
672
|
*
|
|
673
|
-
*
|
|
674
|
-
* - owner:
|
|
675
|
-
* - repo: Nome do
|
|
673
|
+
* PARÂMETROS OBRIGATÓRIOS:
|
|
674
|
+
* - owner: Proprietário do repositório
|
|
675
|
+
* - repo: Nome do repositório
|
|
676
676
|
* - query: Termo de busca
|
|
677
677
|
*
|
|
678
|
-
*
|
|
678
|
+
* PARÂMETROS OPCIONAIS:
|
|
679
679
|
* - author: Autor dos PRs
|
|
680
|
-
* - assignee:
|
|
680
|
+
* - assignee: Responsável pelos PRs
|
|
681
681
|
* - reviewer: Revisor dos PRs
|
|
682
|
-
* - label: Label
|
|
682
|
+
* - label: Label específico
|
|
683
683
|
*
|
|
684
|
-
*
|
|
685
|
-
* - Todos os
|
|
684
|
+
* VALIDAÇÕES:
|
|
685
|
+
* - Todos os parâmetros obrigatórios
|
|
686
686
|
* - Query deve ter pelo menos 3 caracteres
|
|
687
|
-
* -
|
|
687
|
+
* - Repositório deve existir
|
|
688
688
|
*
|
|
689
|
-
*
|
|
690
|
-
* - Use termos de busca
|
|
689
|
+
* RECOMENDAÇÕES:
|
|
690
|
+
* - Use termos de busca específicos
|
|
691
691
|
* - Combine filtros para resultados precisos
|
|
692
|
-
* - Analise
|
|
692
|
+
* - Analise relevância dos resultados
|
|
693
693
|
* - Use para encontrar PRs relacionados
|
|
694
694
|
*/
|
|
695
695
|
searchPullRequests(params: PullsInput, provider: VcsOperations, owner: string): Promise<PullsResult>;
|
|
696
696
|
/**
|
|
697
|
-
* Verifica se erro
|
|
697
|
+
* Verifica se erro é relacionado a Git
|
|
698
698
|
*/
|
|
699
699
|
isGitRelatedError(errorMessage: string): boolean;
|
|
700
700
|
};
|