@andrebuzeli/git-mcp 2.27.4 → 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 -305
  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,431 +1,431 @@
1
- import { z } from 'zod';
2
- import { VcsOperations } from '../providers/index.js';
3
- /**
4
- * Tool: branches
5
- *
6
- * DESCRIÇÃO:
7
- * Gerenciamento completo de branches Gitea com múltiplas ações
8
- *
9
- * FUNCIONALIDADES:
10
- * - Criação de novas branches
11
- * - Listagem e busca de branches
12
- * - Obtenção de detalhes específicos
13
- * - Exclusão de branches
14
- * - Merge de branches
15
- * - Comparação entre branches
16
- *
17
- * USO:
18
- * - Para gerenciar fluxo de trabalho Git
19
- * - Para criar branches de feature
20
- * - Para organizar desenvolvimento
21
- * - Para controle de versão
22
- *
23
- * RECOMENDAÇÕES:
24
- * - Use convenções de nomenclatura consistentes
25
- * - Proteja branches importantes
26
- * - Mantenha branches limpas
27
- * - Documente propósito das branches
28
- */
29
- /**
30
- * Schema de validação para entrada da tool branches
31
- *
32
- * VALIDAÇÕES:
33
- * - action: Ação obrigatória (create, list, get, delete, merge, compare)
34
- * - Parâmetros específicos por ação
35
- * - Validação de tipos e formatos
36
- *
37
- * RECOMENDAÇÕES:
38
- * - Sempre valide entrada antes de usar
39
- * - Use parâmetros opcionais adequadamente
40
- * - Documente parâmetros obrigatórios
41
- */
42
- declare const BranchesInputSchema: z.ZodObject<{
43
- action: z.ZodEnum<["create", "list", "get", "delete", "merge", "compare"]>;
44
- repo: z.ZodString;
45
- projectPath: z.ZodString;
46
- provider: z.ZodEnum<["gitea", "github"]>;
47
- branch_name: z.ZodOptional<z.ZodString>;
48
- from_branch: z.ZodOptional<z.ZodString>;
49
- branch: z.ZodOptional<z.ZodString>;
50
- head: z.ZodOptional<z.ZodString>;
51
- base: z.ZodOptional<z.ZodString>;
52
- merge_method: z.ZodOptional<z.ZodEnum<["merge", "rebase", "squash"]>>;
53
- page: z.ZodOptional<z.ZodNumber>;
54
- limit: z.ZodOptional<z.ZodNumber>;
55
- base_branch: z.ZodOptional<z.ZodString>;
56
- head_branch: z.ZodOptional<z.ZodString>;
57
- }, "strip", z.ZodTypeAny, {
58
- provider: "gitea" | "github";
59
- repo: string;
60
- action: "merge" | "delete" | "get" | "list" | "create" | "compare";
61
- projectPath: string;
62
- head?: string | undefined;
63
- base?: string | undefined;
64
- page?: number | undefined;
65
- limit?: number | undefined;
66
- branch?: string | undefined;
67
- branch_name?: string | undefined;
68
- from_branch?: string | undefined;
69
- merge_method?: "merge" | "rebase" | "squash" | undefined;
70
- base_branch?: string | undefined;
71
- head_branch?: string | undefined;
72
- }, {
73
- provider: "gitea" | "github";
74
- repo: string;
75
- action: "merge" | "delete" | "get" | "list" | "create" | "compare";
76
- projectPath: string;
77
- head?: string | undefined;
78
- base?: string | undefined;
79
- page?: number | undefined;
80
- limit?: number | undefined;
81
- branch?: string | undefined;
82
- branch_name?: string | undefined;
83
- from_branch?: string | undefined;
84
- merge_method?: "merge" | "rebase" | "squash" | undefined;
85
- base_branch?: string | undefined;
86
- head_branch?: string | undefined;
87
- }>;
88
- export type BranchesInput = z.infer<typeof BranchesInputSchema>;
89
- /**
90
- * Schema de saída padronizado
91
- *
92
- * ESTRUTURA:
93
- * - success: Status da operação
94
- * - action: Ação executada
95
- * - message: Mensagem descritiva
96
- * - data: Dados retornados (opcional)
97
- * - error: Detalhes do erro (opcional)
98
- */
99
- declare const BranchesResultSchema: z.ZodObject<{
100
- success: z.ZodBoolean;
101
- action: z.ZodString;
102
- message: z.ZodString;
103
- data: z.ZodOptional<z.ZodAny>;
104
- error: z.ZodOptional<z.ZodString>;
105
- }, "strip", z.ZodTypeAny, {
106
- message: string;
107
- action: string;
108
- success: boolean;
109
- error?: string | undefined;
110
- data?: any;
111
- }, {
112
- message: string;
113
- action: string;
114
- success: boolean;
115
- error?: string | undefined;
116
- data?: any;
117
- }>;
118
- export type BranchesResult = z.infer<typeof BranchesResultSchema>;
119
- /**
120
- * Tool: branches
121
- *
122
- * DESCRIÇÃO:
123
- * Gerenciamento completo de branches Gitea com múltiplas ações
124
- *
125
- * ACTIONS DISPONÍVEIS:
126
- *
127
- * 1. create - Criar nova branch
128
- * Parâmetros:
129
- * - owner (obrigatório): Proprietário do repositório
130
- * - repo (obrigatório): Nome do repositório
131
- * - branch_name (obrigatório): Nome da nova branch
132
- * - from_branch (obrigatório): Branch de origem
133
- *
134
- * 2. list - Listar branches
135
- * Parâmetros:
136
- * - owner (obrigatório): Proprietário do repositório
137
- * - repo (obrigatório): Nome do repositório
138
- * - page (opcional): Página da listagem (padrão: 1)
139
- * - limit (opcional): Itens por página (padrão: 30)
140
- *
141
- * 3. get - Obter detalhes da branch
142
- * Parâmetros:
143
- * - owner (obrigatório): Proprietário do repositório
144
- * - repo (obrigatório): Nome do repositório
145
- * - branch (obrigatório): Nome da branch
146
- *
147
- * 4. delete - Deletar branch
148
- * Parâmetros:
149
- * - owner (obrigatório): Proprietário do repositório
150
- * - repo (obrigatório): Nome do repositório
151
- * - branch (obrigatório): Nome da branch
152
- *
153
- * 5. merge - Fazer merge de branches
154
- * Parâmetros:
155
- * - owner (obrigatório): Proprietário do repositório
156
- * - repo (obrigatório): Nome do repositório
157
- * - head (obrigatório): Branch de origem
158
- * - base (obrigatório): Branch de destino
159
- * - merge_method (opcional): Método de merge (padrão: merge)
160
- *
161
- * 6. compare - Comparar branches
162
- * Parâmetros:
163
- * - owner (obrigatório): Proprietário do repositório
164
- * - repo (obrigatório): Nome do repositório
165
- * - base_branch (obrigatório): Branch base
166
- * - head_branch (obrigatório): Branch de comparação
167
- *
168
- * RECOMENDAÇÕES DE USO:
169
- * - Use nomes descritivos para branches
170
- * - Mantenha branches principais protegidas
171
- * - Faça merge regularmente
172
- * - Documente propósito das branches
173
- * - Use convenções de nomenclatura
174
- * - Limpe branches antigas
175
- */
176
- export declare const branchesTool: {
177
- name: string;
178
- description: string;
179
- inputSchema: {
180
- type: string;
181
- properties: {
182
- action: {
183
- type: string;
184
- enum: string[];
185
- description: string;
186
- };
187
- repo: {
188
- type: string;
189
- description: string;
190
- };
191
- projectPath: {
192
- type: string;
193
- description: string;
194
- };
195
- provider: {
196
- type: string;
197
- description: string;
198
- };
199
- branch_name: {
200
- type: string;
201
- description: string;
202
- };
203
- from_branch: {
204
- type: string;
205
- description: string;
206
- };
207
- branch: {
208
- type: string;
209
- description: string;
210
- };
211
- head: {
212
- type: string;
213
- description: string;
214
- };
215
- base: {
216
- type: string;
217
- description: string;
218
- };
219
- merge_method: {
220
- type: string;
221
- enum: string[];
222
- description: string;
223
- };
224
- page: {
225
- type: string;
226
- description: string;
227
- minimum: number;
228
- };
229
- limit: {
230
- type: string;
231
- description: string;
232
- minimum: number;
233
- maximum: number;
234
- };
235
- base_branch: {
236
- type: string;
237
- description: string;
238
- };
239
- head_branch: {
240
- type: string;
241
- description: string;
242
- };
243
- };
244
- required: string[];
245
- };
246
- /**
247
- * Handler principal da tool branches
248
- *
249
- * FUNCIONALIDADE:
250
- * - Valida entrada usando Zod schema
251
- * - Roteia para método específico baseado na ação
252
- * - Trata erros de forma uniforme
253
- * - Retorna resultado padronizado
254
- *
255
- * FLUXO:
256
- * 1. Validação de entrada
257
- * 2. Roteamento por ação
258
- * 3. Execução do método específico
259
- * 4. Tratamento de erros
260
- * 5. Retorno de resultado
261
- *
262
- * TRATAMENTO DE ERROS:
263
- * - Validação: erro de schema
264
- * - Execução: erro da operação
265
- * - Roteamento: ação não suportada
266
- *
267
- * RECOMENDAÇÕES:
268
- * - Sempre valide entrada antes de processar
269
- * - Trate erros específicos adequadamente
270
- * - Log detalhes de erro para debug
271
- * - Retorne mensagens de erro úteis
272
- */
273
- handler(input: BranchesInput): Promise<BranchesResult>;
274
- /**
275
- * Cria uma nova branch no repositório
276
- *
277
- * FUNCIONALIDADE:
278
- * - Valida parâmetros obrigatórios
279
- * - Cria branch a partir de branch existente
280
- * - Retorna detalhes da nova branch
281
- *
282
- * PARÂMETROS OBRIGATÓRIOS:
283
- * - owner: Proprietário do repositório
284
- * - repo: Nome do repositório
285
- * - branch_name: Nome da nova branch
286
- * - from_branch: Branch de origem
287
- *
288
- * VALIDAÇÕES:
289
- * - Todos os parâmetros obrigatórios
290
- * - Branch de origem deve existir
291
- * - Nome da nova branch deve ser único
292
- *
293
- * RECOMENDAÇÕES:
294
- * - Use nomes descritivos para branches
295
- * - Crie a partir de branches estáveis
296
- * - Documente propósito da branch
297
- * - Use convenções de nomenclatura
298
- */
299
- createBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
300
- /**
301
- * Lista todas as branches do repositório
302
- *
303
- * FUNCIONALIDADE:
304
- * - Lista branches com paginação
305
- * - Retorna informações básicas de cada branch
306
- * - Suporta filtros de paginação
307
- *
308
- * PARÂMETROS OBRIGATÓRIOS:
309
- * - owner: Proprietário do repositório
310
- * - repo: Nome do repositório
311
- *
312
- * PARÂMETROS OPCIONAIS:
313
- * - page: Página da listagem (padrão: 1)
314
- * - limit: Itens por página (padrão: 30, máximo: 100)
315
- *
316
- * VALIDAÇÕES:
317
- * - e repo obrigatórios
318
- * - Page deve ser >= 1
319
- * - Limit deve ser entre 1 e 100
320
- *
321
- * RECOMENDAÇÕES:
322
- * - Use paginação para repositórios grandes
323
- * - Monitore número total de branches
324
- * - Mantenha branches organizadas
325
- */
326
- listBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
327
- /**
328
- * Obtém detalhes de uma branch específica
329
- *
330
- * FUNCIONALIDADE:
331
- * - Retorna informações completas da branch
332
- * - Inclui commit mais recente
333
- * - Informações de proteção e permissões
334
- *
335
- * PARÂMETROS OBRIGATÓRIOS:
336
- * - owner: Proprietário do repositório
337
- * - repo: Nome do repositório
338
- * - branch: Nome da branch
339
- *
340
- * VALIDAÇÕES:
341
- * - Todos os parâmetros obrigatórios
342
- * - Branch deve existir no repositório
343
- *
344
- * RECOMENDAÇÕES:
345
- * - Use para obter informações detalhadas
346
- * - Verifique status de proteção
347
- * - Monitore commits recentes
348
- */
349
- getBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
350
- /**
351
- * Deleta uma branch do repositório
352
- *
353
- * FUNCIONALIDADE:
354
- * - Remove branch especificada
355
- * - Valida permissões de exclusão
356
- * - Confirma exclusão bem-sucedida
357
- *
358
- * PARÂMETROS OBRIGATÓRIOS:
359
- * - owner: Proprietário do repositório
360
- * - repo: Nome do repositório
361
- * - branch: Nome da branch a ser deletada
362
- *
363
- * VALIDAÇÕES:
364
- * - Todos os parâmetros obrigatórios
365
- * - Branch deve existir
366
- * - Usuário deve ter permissão de exclusão
367
- *
368
- * RECOMENDAÇÕES:
369
- * - Confirme antes de deletar
370
- * - Verifique se branch foi mergeada
371
- * - Mantenha backup se necessário
372
- * - Documente motivo da exclusão
373
- */
374
- deleteBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
375
- /**
376
- * Faz merge de uma branch em outra
377
- *
378
- * FUNCIONALIDADE:
379
- * - Merge de branch de origem em branch de destino
380
- * - Suporta diferentes métodos de merge
381
- * - Retorna resultado do merge
382
- *
383
- * PARÂMETROS OBRIGATÓRIOS:
384
- * - owner: Proprietário do repositório
385
- * - repo: Nome do repositório
386
- * - head: Branch de origem (será mergeada)
387
- * - base: Branch de destino (receberá o merge)
388
- *
389
- * PARÂMETROS OPCIONAIS:
390
- * - merge_method: Método de merge (merge, rebase, squash)
391
- *
392
- * VALIDAÇÕES:
393
- * - Todos os parâmetros obrigatórios
394
- * - Branches devem existir
395
- * - Não deve haver conflitos
396
- *
397
- * RECOMENDAÇÕES:
398
- * - Resolva conflitos antes do merge
399
- * - Escolha método de merge adequado
400
- * - Teste após o merge
401
- * - Documente mudanças
402
- */
403
- mergeBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
404
- /**
405
- * Compara duas branches
406
- *
407
- * FUNCIONALIDADE:
408
- * - Compara diferenças entre branches
409
- * - Retorna commits diferentes
410
- * - Mostra divergências
411
- *
412
- * PARÂMETROS OBRIGATÓRIOS:
413
- * - owner: Proprietário do repositório
414
- * - repo: Nome do repositório
415
- * - base_branch: Branch base para comparação
416
- * - head_branch: Branch a ser comparada
417
- *
418
- * VALIDAÇÕES:
419
- * - Todos os parâmetros obrigatórios
420
- * - Ambas as branches devem existir
421
- *
422
- * RECOMENDAÇÕES:
423
- * - Use para verificar divergências
424
- * - Compare antes de fazer merge
425
- * - Analise commits diferentes
426
- * - Documente diferenças importantes
427
- */
428
- compareBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
429
- };
430
- export {};
1
+ import { z } from 'zod';
2
+ import { VcsOperations } from '../providers/index.js';
3
+ /**
4
+ * Tool: branches
5
+ *
6
+ * DESCRIÇÃO:
7
+ * Gerenciamento completo de branches Gitea com múltiplas ações
8
+ *
9
+ * FUNCIONALIDADES:
10
+ * - Criação de novas branches
11
+ * - Listagem e busca de branches
12
+ * - Obtenção de detalhes específicos
13
+ * - Exclusão de branches
14
+ * - Merge de branches
15
+ * - Comparação entre branches
16
+ *
17
+ * USO:
18
+ * - Para gerenciar fluxo de trabalho Git
19
+ * - Para criar branches de feature
20
+ * - Para organizar desenvolvimento
21
+ * - Para controle de versão
22
+ *
23
+ * RECOMENDAÇÕES:
24
+ * - Use convenções de nomenclatura consistentes
25
+ * - Proteja branches importantes
26
+ * - Mantenha branches limpas
27
+ * - Documente propósito das branches
28
+ */
29
+ /**
30
+ * Schema de validação para entrada da tool branches
31
+ *
32
+ * VALIDAÇÕES:
33
+ * - action: Ação obrigatória (create, list, get, delete, merge, compare)
34
+ * - Parâmetros específicos por ação
35
+ * - Validação de tipos e formatos
36
+ *
37
+ * RECOMENDAÇÕES:
38
+ * - Sempre valide entrada antes de usar
39
+ * - Use parâmetros opcionais adequadamente
40
+ * - Documente parâmetros obrigatórios
41
+ */
42
+ declare const BranchesInputSchema: z.ZodObject<{
43
+ action: z.ZodEnum<["create", "list", "get", "delete", "merge", "compare"]>;
44
+ repo: z.ZodString;
45
+ projectPath: z.ZodString;
46
+ provider: z.ZodEnum<["gitea", "github"]>;
47
+ branch_name: z.ZodOptional<z.ZodString>;
48
+ from_branch: z.ZodOptional<z.ZodString>;
49
+ branch: z.ZodOptional<z.ZodString>;
50
+ head: z.ZodOptional<z.ZodString>;
51
+ base: z.ZodOptional<z.ZodString>;
52
+ merge_method: z.ZodOptional<z.ZodEnum<["merge", "rebase", "squash"]>>;
53
+ page: z.ZodOptional<z.ZodNumber>;
54
+ limit: z.ZodOptional<z.ZodNumber>;
55
+ base_branch: z.ZodOptional<z.ZodString>;
56
+ head_branch: z.ZodOptional<z.ZodString>;
57
+ }, "strip", z.ZodTypeAny, {
58
+ provider: "gitea" | "github";
59
+ repo: string;
60
+ action: "merge" | "delete" | "get" | "list" | "create" | "compare";
61
+ projectPath: string;
62
+ head?: string | undefined;
63
+ base?: string | undefined;
64
+ page?: number | undefined;
65
+ limit?: number | undefined;
66
+ branch?: string | undefined;
67
+ branch_name?: string | undefined;
68
+ from_branch?: string | undefined;
69
+ merge_method?: "merge" | "rebase" | "squash" | undefined;
70
+ base_branch?: string | undefined;
71
+ head_branch?: string | undefined;
72
+ }, {
73
+ provider: "gitea" | "github";
74
+ repo: string;
75
+ action: "merge" | "delete" | "get" | "list" | "create" | "compare";
76
+ projectPath: string;
77
+ head?: string | undefined;
78
+ base?: string | undefined;
79
+ page?: number | undefined;
80
+ limit?: number | undefined;
81
+ branch?: string | undefined;
82
+ branch_name?: string | undefined;
83
+ from_branch?: string | undefined;
84
+ merge_method?: "merge" | "rebase" | "squash" | undefined;
85
+ base_branch?: string | undefined;
86
+ head_branch?: string | undefined;
87
+ }>;
88
+ export type BranchesInput = z.infer<typeof BranchesInputSchema>;
89
+ /**
90
+ * Schema de saída padronizado
91
+ *
92
+ * ESTRUTURA:
93
+ * - success: Status da operação
94
+ * - action: Ação executada
95
+ * - message: Mensagem descritiva
96
+ * - data: Dados retornados (opcional)
97
+ * - error: Detalhes do erro (opcional)
98
+ */
99
+ declare const BranchesResultSchema: z.ZodObject<{
100
+ success: z.ZodBoolean;
101
+ action: z.ZodString;
102
+ message: z.ZodString;
103
+ data: z.ZodOptional<z.ZodAny>;
104
+ error: z.ZodOptional<z.ZodString>;
105
+ }, "strip", z.ZodTypeAny, {
106
+ message: string;
107
+ action: string;
108
+ success: boolean;
109
+ error?: string | undefined;
110
+ data?: any;
111
+ }, {
112
+ message: string;
113
+ action: string;
114
+ success: boolean;
115
+ error?: string | undefined;
116
+ data?: any;
117
+ }>;
118
+ export type BranchesResult = z.infer<typeof BranchesResultSchema>;
119
+ /**
120
+ * Tool: branches
121
+ *
122
+ * DESCRIÇÃO:
123
+ * Gerenciamento completo de branches Gitea com múltiplas ações
124
+ *
125
+ * ACTIONS DISPONÍVEIS:
126
+ *
127
+ * 1. create - Criar nova branch
128
+ * Parâmetros:
129
+ * - owner (obrigatório): Proprietário do repositório
130
+ * - repo (obrigatório): Nome do repositório
131
+ * - branch_name (obrigatório): Nome da nova branch
132
+ * - from_branch (obrigatório): Branch de origem
133
+ *
134
+ * 2. list - Listar branches
135
+ * Parâmetros:
136
+ * - owner (obrigatório): Proprietário do repositório
137
+ * - repo (obrigatório): Nome do repositório
138
+ * - page (opcional): Página da listagem (padrão: 1)
139
+ * - limit (opcional): Itens por página (padrão: 30)
140
+ *
141
+ * 3. get - Obter detalhes da branch
142
+ * Parâmetros:
143
+ * - owner (obrigatório): Proprietário do repositório
144
+ * - repo (obrigatório): Nome do repositório
145
+ * - branch (obrigatório): Nome da branch
146
+ *
147
+ * 4. delete - Deletar branch
148
+ * Parâmetros:
149
+ * - owner (obrigatório): Proprietário do repositório
150
+ * - repo (obrigatório): Nome do repositório
151
+ * - branch (obrigatório): Nome da branch
152
+ *
153
+ * 5. merge - Fazer merge de branches
154
+ * Parâmetros:
155
+ * - owner (obrigatório): Proprietário do repositório
156
+ * - repo (obrigatório): Nome do repositório
157
+ * - head (obrigatório): Branch de origem
158
+ * - base (obrigatório): Branch de destino
159
+ * - merge_method (opcional): Método de merge (padrão: merge)
160
+ *
161
+ * 6. compare - Comparar branches
162
+ * Parâmetros:
163
+ * - owner (obrigatório): Proprietário do repositório
164
+ * - repo (obrigatório): Nome do repositório
165
+ * - base_branch (obrigatório): Branch base
166
+ * - head_branch (obrigatório): Branch de comparação
167
+ *
168
+ * RECOMENDAÇÕES DE USO:
169
+ * - Use nomes descritivos para branches
170
+ * - Mantenha branches principais protegidas
171
+ * - Faça merge regularmente
172
+ * - Documente propósito das branches
173
+ * - Use convenções de nomenclatura
174
+ * - Limpe branches antigas
175
+ */
176
+ export declare const branchesTool: {
177
+ name: string;
178
+ description: string;
179
+ inputSchema: {
180
+ type: string;
181
+ properties: {
182
+ action: {
183
+ type: string;
184
+ enum: string[];
185
+ description: string;
186
+ };
187
+ repo: {
188
+ type: string;
189
+ description: string;
190
+ };
191
+ projectPath: {
192
+ type: string;
193
+ description: string;
194
+ };
195
+ provider: {
196
+ type: string;
197
+ description: string;
198
+ };
199
+ branch_name: {
200
+ type: string;
201
+ description: string;
202
+ };
203
+ from_branch: {
204
+ type: string;
205
+ description: string;
206
+ };
207
+ branch: {
208
+ type: string;
209
+ description: string;
210
+ };
211
+ head: {
212
+ type: string;
213
+ description: string;
214
+ };
215
+ base: {
216
+ type: string;
217
+ description: string;
218
+ };
219
+ merge_method: {
220
+ type: string;
221
+ enum: string[];
222
+ description: string;
223
+ };
224
+ page: {
225
+ type: string;
226
+ description: string;
227
+ minimum: number;
228
+ };
229
+ limit: {
230
+ type: string;
231
+ description: string;
232
+ minimum: number;
233
+ maximum: number;
234
+ };
235
+ base_branch: {
236
+ type: string;
237
+ description: string;
238
+ };
239
+ head_branch: {
240
+ type: string;
241
+ description: string;
242
+ };
243
+ };
244
+ required: string[];
245
+ };
246
+ /**
247
+ * Handler principal da tool branches
248
+ *
249
+ * FUNCIONALIDADE:
250
+ * - Valida entrada usando Zod schema
251
+ * - Roteia para método específico baseado na ação
252
+ * - Trata erros de forma uniforme
253
+ * - Retorna resultado padronizado
254
+ *
255
+ * FLUXO:
256
+ * 1. Validação de entrada
257
+ * 2. Roteamento por ação
258
+ * 3. Execução do método específico
259
+ * 4. Tratamento de erros
260
+ * 5. Retorno de resultado
261
+ *
262
+ * TRATAMENTO DE ERROS:
263
+ * - Validação: erro de schema
264
+ * - Execução: erro da operação
265
+ * - Roteamento: ação não suportada
266
+ *
267
+ * RECOMENDAÇÕES:
268
+ * - Sempre valide entrada antes de processar
269
+ * - Trate erros específicos adequadamente
270
+ * - Log detalhes de erro para debug
271
+ * - Retorne mensagens de erro úteis
272
+ */
273
+ handler(input: BranchesInput): Promise<BranchesResult>;
274
+ /**
275
+ * Cria uma nova branch no repositório
276
+ *
277
+ * FUNCIONALIDADE:
278
+ * - Valida parâmetros obrigatórios
279
+ * - Cria branch a partir de branch existente
280
+ * - Retorna detalhes da nova branch
281
+ *
282
+ * PARÂMETROS OBRIGATÓRIOS:
283
+ * - owner: Proprietário do repositório
284
+ * - repo: Nome do repositório
285
+ * - branch_name: Nome da nova branch
286
+ * - from_branch: Branch de origem
287
+ *
288
+ * VALIDAÇÕES:
289
+ * - Todos os parâmetros obrigatórios
290
+ * - Branch de origem deve existir
291
+ * - Nome da nova branch deve ser único
292
+ *
293
+ * RECOMENDAÇÕES:
294
+ * - Use nomes descritivos para branches
295
+ * - Crie a partir de branches estáveis
296
+ * - Documente propósito da branch
297
+ * - Use convenções de nomenclatura
298
+ */
299
+ createBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
300
+ /**
301
+ * Lista todas as branches do repositório
302
+ *
303
+ * FUNCIONALIDADE:
304
+ * - Lista branches com paginação
305
+ * - Retorna informações básicas de cada branch
306
+ * - Suporta filtros de paginação
307
+ *
308
+ * PARÂMETROS OBRIGATÓRIOS:
309
+ * - owner: Proprietário do repositório
310
+ * - repo: Nome do repositório
311
+ *
312
+ * PARÂMETROS OPCIONAIS:
313
+ * - page: Página da listagem (padrão: 1)
314
+ * - limit: Itens por página (padrão: 30, máximo: 100)
315
+ *
316
+ * VALIDAÇÕES:
317
+ * - e repo obrigatórios
318
+ * - Page deve ser >= 1
319
+ * - Limit deve ser entre 1 e 100
320
+ *
321
+ * RECOMENDAÇÕES:
322
+ * - Use paginação para repositórios grandes
323
+ * - Monitore número total de branches
324
+ * - Mantenha branches organizadas
325
+ */
326
+ listBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
327
+ /**
328
+ * Obtém detalhes de uma branch específica
329
+ *
330
+ * FUNCIONALIDADE:
331
+ * - Retorna informações completas da branch
332
+ * - Inclui commit mais recente
333
+ * - Informações de proteção e permissões
334
+ *
335
+ * PARÂMETROS OBRIGATÓRIOS:
336
+ * - owner: Proprietário do repositório
337
+ * - repo: Nome do repositório
338
+ * - branch: Nome da branch
339
+ *
340
+ * VALIDAÇÕES:
341
+ * - Todos os parâmetros obrigatórios
342
+ * - Branch deve existir no repositório
343
+ *
344
+ * RECOMENDAÇÕES:
345
+ * - Use para obter informações detalhadas
346
+ * - Verifique status de proteção
347
+ * - Monitore commits recentes
348
+ */
349
+ getBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
350
+ /**
351
+ * Deleta uma branch do repositório
352
+ *
353
+ * FUNCIONALIDADE:
354
+ * - Remove branch especificada
355
+ * - Valida permissões de exclusão
356
+ * - Confirma exclusão bem-sucedida
357
+ *
358
+ * PARÂMETROS OBRIGATÓRIOS:
359
+ * - owner: Proprietário do repositório
360
+ * - repo: Nome do repositório
361
+ * - branch: Nome da branch a ser deletada
362
+ *
363
+ * VALIDAÇÕES:
364
+ * - Todos os parâmetros obrigatórios
365
+ * - Branch deve existir
366
+ * - Usuário deve ter permissão de exclusão
367
+ *
368
+ * RECOMENDAÇÕES:
369
+ * - Confirme antes de deletar
370
+ * - Verifique se branch foi mergeada
371
+ * - Mantenha backup se necessário
372
+ * - Documente motivo da exclusão
373
+ */
374
+ deleteBranch(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
375
+ /**
376
+ * Faz merge de uma branch em outra
377
+ *
378
+ * FUNCIONALIDADE:
379
+ * - Merge de branch de origem em branch de destino
380
+ * - Suporta diferentes métodos de merge
381
+ * - Retorna resultado do merge
382
+ *
383
+ * PARÂMETROS OBRIGATÓRIOS:
384
+ * - owner: Proprietário do repositório
385
+ * - repo: Nome do repositório
386
+ * - head: Branch de origem (será mergeada)
387
+ * - base: Branch de destino (receberá o merge)
388
+ *
389
+ * PARÂMETROS OPCIONAIS:
390
+ * - merge_method: Método de merge (merge, rebase, squash)
391
+ *
392
+ * VALIDAÇÕES:
393
+ * - Todos os parâmetros obrigatórios
394
+ * - Branches devem existir
395
+ * - Não deve haver conflitos
396
+ *
397
+ * RECOMENDAÇÕES:
398
+ * - Resolva conflitos antes do merge
399
+ * - Escolha método de merge adequado
400
+ * - Teste após o merge
401
+ * - Documente mudanças
402
+ */
403
+ mergeBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
404
+ /**
405
+ * Compara duas branches
406
+ *
407
+ * FUNCIONALIDADE:
408
+ * - Compara diferenças entre branches
409
+ * - Retorna commits diferentes
410
+ * - Mostra divergências
411
+ *
412
+ * PARÂMETROS OBRIGATÓRIOS:
413
+ * - owner: Proprietário do repositório
414
+ * - repo: Nome do repositório
415
+ * - base_branch: Branch base para comparação
416
+ * - head_branch: Branch a ser comparada
417
+ *
418
+ * VALIDAÇÕES:
419
+ * - Todos os parâmetros obrigatórios
420
+ * - Ambas as branches devem existir
421
+ *
422
+ * RECOMENDAÇÕES:
423
+ * - Use para verificar divergências
424
+ * - Compare antes de fazer merge
425
+ * - Analise commits diferentes
426
+ * - Documente diferenças importantes
427
+ */
428
+ compareBranches(params: BranchesInput, provider: VcsOperations): Promise<BranchesResult>;
429
+ };
430
+ export {};
431
431
  //# sourceMappingURL=git-branches.d.ts.map