@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.
- package/README.md +346 -0
- package/dist/client.d.ts +307 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +299 -0
- package/dist/client.js.map +1 -0
- package/dist/config.d.ts +299 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +381 -0
- package/dist/config.js.map +1 -0
- package/dist/index.d.ts +22 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +53 -0
- package/dist/index.js.map +1 -0
- package/dist/providers/base-provider.d.ts +139 -0
- package/dist/providers/base-provider.d.ts.map +1 -0
- package/dist/providers/base-provider.js +246 -0
- package/dist/providers/base-provider.js.map +1 -0
- package/dist/providers/error-handler.d.ts +51 -0
- package/dist/providers/error-handler.d.ts.map +1 -0
- package/dist/providers/error-handler.js +170 -0
- package/dist/providers/error-handler.js.map +1 -0
- package/dist/providers/gitea-provider.d.ts +68 -0
- package/dist/providers/gitea-provider.d.ts.map +1 -0
- package/dist/providers/gitea-provider.js +515 -0
- package/dist/providers/gitea-provider.js.map +1 -0
- package/dist/providers/github-provider.d.ts +68 -0
- package/dist/providers/github-provider.d.ts.map +1 -0
- package/dist/providers/github-provider.js +518 -0
- package/dist/providers/github-provider.js.map +1 -0
- package/dist/providers/index.d.ts +13 -0
- package/dist/providers/index.d.ts.map +1 -0
- package/dist/providers/index.js +41 -0
- package/dist/providers/index.js.map +1 -0
- package/dist/providers/provider-factory.d.ts +75 -0
- package/dist/providers/provider-factory.d.ts.map +1 -0
- package/dist/providers/provider-factory.js +298 -0
- package/dist/providers/provider-factory.js.map +1 -0
- package/dist/providers/types.d.ts +276 -0
- package/dist/providers/types.d.ts.map +1 -0
- package/dist/providers/types.js +7 -0
- package/dist/providers/types.js.map +1 -0
- package/dist/server.d.ts +77 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +262 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/actions.d.ts +272 -0
- package/dist/tools/actions.d.ts.map +1 -0
- package/dist/tools/actions.js +428 -0
- package/dist/tools/actions.js.map +1 -0
- package/dist/tools/analytics.d.ts +326 -0
- package/dist/tools/analytics.d.ts.map +1 -0
- package/dist/tools/analytics.js +473 -0
- package/dist/tools/analytics.js.map +1 -0
- package/dist/tools/branches.d.ts +461 -0
- package/dist/tools/branches.d.ts.map +1 -0
- package/dist/tools/branches.js +525 -0
- package/dist/tools/branches.js.map +1 -0
- package/dist/tools/code-review.d.ts +323 -0
- package/dist/tools/code-review.d.ts.map +1 -0
- package/dist/tools/code-review.js +552 -0
- package/dist/tools/code-review.js.map +1 -0
- package/dist/tools/commits.d.ts +488 -0
- package/dist/tools/commits.d.ts.map +1 -0
- package/dist/tools/commits.js +578 -0
- package/dist/tools/commits.js.map +1 -0
- package/dist/tools/deployments.d.ts +319 -0
- package/dist/tools/deployments.d.ts.map +1 -0
- package/dist/tools/deployments.js +355 -0
- package/dist/tools/deployments.js.map +1 -0
- package/dist/tools/files.d.ts +456 -0
- package/dist/tools/files.d.ts.map +1 -0
- package/dist/tools/files.js +531 -0
- package/dist/tools/files.js.map +1 -0
- package/dist/tools/git-sync.d.ts +177 -0
- package/dist/tools/git-sync.d.ts.map +1 -0
- package/dist/tools/git-sync.js +112 -0
- package/dist/tools/git-sync.js.map +1 -0
- package/dist/tools/issues.d.ts +579 -0
- package/dist/tools/issues.d.ts.map +1 -0
- package/dist/tools/issues.js +631 -0
- package/dist/tools/issues.js.map +1 -0
- package/dist/tools/pulls.d.ts +702 -0
- package/dist/tools/pulls.d.ts.map +1 -0
- package/dist/tools/pulls.js +730 -0
- package/dist/tools/pulls.js.map +1 -0
- package/dist/tools/releases.d.ts +495 -0
- package/dist/tools/releases.d.ts.map +1 -0
- package/dist/tools/releases.js +551 -0
- package/dist/tools/releases.js.map +1 -0
- package/dist/tools/repositories.d.ts +513 -0
- package/dist/tools/repositories.d.ts.map +1 -0
- package/dist/tools/repositories.js +634 -0
- package/dist/tools/repositories.js.map +1 -0
- package/dist/tools/security.d.ts +341 -0
- package/dist/tools/security.d.ts.map +1 -0
- package/dist/tools/security.js +394 -0
- package/dist/tools/security.js.map +1 -0
- package/dist/tools/tags.d.ts +419 -0
- package/dist/tools/tags.d.ts.map +1 -0
- package/dist/tools/tags.js +479 -0
- package/dist/tools/tags.js.map +1 -0
- package/dist/tools/users.d.ts +376 -0
- package/dist/tools/users.d.ts.map +1 -0
- package/dist/tools/users.js +495 -0
- package/dist/tools/users.js.map +1 -0
- package/dist/tools/validator.d.ts +192 -0
- package/dist/tools/validator.d.ts.map +1 -0
- package/dist/tools/validator.js +198 -0
- package/dist/tools/validator.js.map +1 -0
- package/dist/tools/version-control.d.ts +247 -0
- package/dist/tools/version-control.d.ts.map +1 -0
- package/dist/tools/version-control.js +521 -0
- package/dist/tools/version-control.js.map +1 -0
- package/dist/tools/webhooks.d.ts +478 -0
- package/dist/tools/webhooks.d.ts.map +1 -0
- package/dist/tools/webhooks.js +541 -0
- package/dist/tools/webhooks.js.map +1 -0
- package/dist/tools/workflows.d.ts +313 -0
- package/dist/tools/workflows.d.ts.map +1 -0
- package/dist/tools/workflows.js +430 -0
- package/dist/tools/workflows.js.map +1 -0
- 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"}
|