@andrebuzeli/git-mcp 2.29.1 → 2.29.2

package/dist/tools/git-files.d.ts

@@ -3,41 +3,41 @@ import { VcsOperations } from '../providers/index.js';
 /**
  * Tool: files
  *
- * DESCRIÇÃO:
- * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
+ * DESCRIÇÃO:
+ * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
  *
  * FUNCIONALIDADES:
- * - Criação de arquivos e diretórios
- * - Leitura e listagem de conteúdo
- * - Atualização de arquivos existentes
- * - Exclusão de arquivos e diretórios
- * - Busca por conteúdo e nome
- * - Controle de versão de arquivos
+ * - Criação de arquivos e diretórios
+ * - Leitura e listagem de conteúdo
+ * - Atualização de arquivos existentes
+ * - Exclusão de arquivos e diretórios
+ * - Busca por conteúdo e nome
+ * - Controle de versão de arquivos
  *
  * USO:
  * - Para gerenciar arquivos de projeto
- * - Para automatizar criação de arquivos
- * - Para backup e migração de conteúdo
- * - Para sincronização de arquivos
+ * - Para automatizar criação de arquivos
+ * - Para backup e migração de conteúdo
+ * - Para sincronização de arquivos
  *
- * RECOMENDAÇÕES:
+ * RECOMENDAÇÕES:
  * - Use mensagens de commit descritivas
- * - Mantenha estrutura de diretórios organizada
- * - Valide conteúdo antes de enviar
- * - Use branches para mudanças grandes
+ * - Mantenha estrutura de diretórios organizada
+ * - Valide conteúdo antes de enviar
+ * - Use branches para mudanças grandes
  */
 /**
- * Schema de validação para entrada da tool files
+ * Schema de validação para entrada da tool files
  *
- * VALIDAÇÕES:
- * - action: Ação obrigatória (get, create, update, delete, list, search)
- * - Parâmetros específicos por ação
- * - Validação de tipos e formatos
+ * VALIDAÇÕES:
+ * - action: Ação obrigatória (get, create, update, delete, list, search)
+ * - Parâmetros específicos por ação
+ * - Validação de tipos e formatos
  *
- * RECOMENDAÇÕES:
+ * RECOMENDAÇÕES:
  * - Sempre valide entrada antes de usar
- * - Use parâmetros opcionais adequadamente
- * - Documente parâmetros obrigatórios
+ * - Use parâmetros opcionais adequadamente
+ * - Documente parâmetros obrigatórios
  */
 declare const FilesInputSchema: z.ZodObject<{
     action: z.ZodEnum<["get", "create", "update", "delete", "list", "search", "upload-project"]>;
@@ -84,11 +84,11 @@ declare const FilesInputSchema: z.ZodObject<{
 }>;
 export type FilesInput = z.infer<typeof FilesInputSchema>;
 /**
- * Schema de saída padronizado
+ * Schema de saída padronizado
  *
  * ESTRUTURA:
- * - success: Status da operação
- * - action: Ação executada
+ * - success: Status da operação
+ * - action: Ação executada
  * - message: Mensagem descritiva
  * - data: Dados retornados (opcional)
  * - error: Detalhes do erro (opcional)
@@ -116,69 +116,69 @@ export type FilesResult = z.infer<typeof FilesResultSchema>;
 /**
  * Tool: files
  *
- * DESCRIÇÃO:
- * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
+ * DESCRIÇÃO:
+ * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
  *
- * ACTIONS DISPONÍVEIS:
+ * ACTIONS DISPONÍVEIS:
  *
- * 1. get - Obter conteúdo de arquivo
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - path (obrigatório): Caminho do arquivo
- *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
+ * 1. get - Obter conteúdo de arquivo
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - path (obrigatório): Caminho do arquivo
+ *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
  *
  * 2. create - Criar novo arquivo
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - path (obrigatório): Caminho do arquivo
- *    - content (obrigatório): Conteúdo do arquivo
- *    - message (obrigatório): Mensagem de commit
- *    - branch (opcional): Branch de destino (padrão: branch padrão)
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - path (obrigatório): Caminho do arquivo
+ *    - content (obrigatório): Conteúdo do arquivo
+ *    - message (obrigatório): Mensagem de commit
+ *    - branch (opcional): Branch de destino (padrão: branch padrão)
  *
  * 3. update - Atualizar arquivo existente
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - path (obrigatório): Caminho do arquivo
- *    - content (obrigatório): Novo conteúdo
- *    - message (obrigatório): Mensagem de commit
- *    - sha (obrigatório): SHA do arquivo atual
- *    - branch (opcional): Branch de destino (padrão: branch padrão)
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - path (obrigatório): Caminho do arquivo
+ *    - content (obrigatório): Novo conteúdo
+ *    - message (obrigatório): Mensagem de commit
+ *    - sha (obrigatório): SHA do arquivo atual
+ *    - branch (opcional): Branch de destino (padrão: branch padrão)
  *
  * 4. delete - Deletar arquivo
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - path (obrigatório): Caminho do arquivo
- *    - message (obrigatório): Mensagem de commit
- *    - sha (obrigatório): SHA do arquivo
- *    - branch (opcional): Branch de destino (padrão: branch padrão)
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - path (obrigatório): Caminho do arquivo
+ *    - message (obrigatório): Mensagem de commit
+ *    - sha (obrigatório): SHA do arquivo
+ *    - branch (opcional): Branch de destino (padrão: branch padrão)
  *
- * 5. list - Listar conteúdo de diretório
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - path (opcional): Caminho do diretório (padrão: raiz)
- *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
- *    - page (opcional): Página da listagem (padrão: 1)
- *    - limit (opcional): Itens por página (padrão: 30, máximo: 100)
+ * 5. list - Listar conteúdo de diretório
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - path (opcional): Caminho do diretório (padrão: raiz)
+ *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
+ *    - page (opcional): Página da listagem (padrão: 1)
+ *    - limit (opcional): Itens por página (padrão: 30, máximo: 100)
  *
- * 6. search - Buscar arquivos por conteúdo
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - query (obrigatório): Termo de busca
- *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
+ * 6. search - Buscar arquivos por conteúdo
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - query (obrigatório): Termo de busca
+ *    - ref (opcional): Branch, tag ou commit (padrão: branch padrão)
  *
- * RECOMENDAÇÕES DE USO:
+ * RECOMENDAÇÕES DE USO:
  * - Use mensagens de commit descritivas
- * - Mantenha estrutura de diretórios organizada
- * - Valide conteúdo antes de enviar
- * - Use branches para mudanças grandes
- * - Documente mudanças importantes
- * - Mantenha histórico de commits limpo
+ * - Mantenha estrutura de diretórios organizada
+ * - Valide conteúdo antes de enviar
+ * - Use branches para mudanças grandes
+ * - Documente mudanças importantes
+ * - Mantenha histórico de commits limpo
  */
 export declare const filesTool: {
     name: string;
@@ -251,239 +251,239 @@ export declare const filesTool: {
      *
      * FUNCIONALIDADE:
      * - Valida entrada usando Zod schema
-     * - Roteia para método específico baseado na ação
+     * - Roteia para método específico baseado na ação
      * - Trata erros de forma uniforme
      * - Retorna resultado padronizado
      *
      * FLUXO:
-     * 1. Validação de entrada
-     * 2. Roteamento por ação
-     * 3. Execução do método específico
+     * 1. Validação de entrada
+     * 2. Roteamento por ação
+     * 3. Execução do método específico
      * 4. Tratamento de erros
      * 5. Retorno de resultado
      *
      * TRATAMENTO DE ERROS:
-     * - Validação: erro de schema
-     * - Execução: erro da operação
-     * - Roteamento: ação não suportada
+     * - Validação: erro de schema
+     * - Execução: erro da operação
+     * - Roteamento: ação não suportada
      *
-     * RECOMENDAÇÕES:
+     * RECOMENDAÇÕES:
      * - Sempre valide entrada antes de processar
-     * - Trate erros específicos adequadamente
+     * - Trate erros específicos adequadamente
      * - Log detalhes de erro para debug
-     * - Retorne mensagens de erro úteis
+     * - Retorne mensagens de erro úteis
      */
     handler(input: FilesInput): Promise<FilesResult>;
     /**
-     * Obtém o conteúdo de um arquivo específico
+     * Obtém o conteúdo de um arquivo específico
      *
      * FUNCIONALIDADE:
-     * - Retorna conteúdo completo do arquivo
+     * - Retorna conteúdo completo do arquivo
      * - Inclui metadados (SHA, tamanho, tipo)
-     * - Suporta diferentes referências (branch, tag, commit)
+     * - Suporta diferentes referências (branch, tag, commit)
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - path: Caminho do arquivo
      *
-     * PARÂMETROS OPCIONAIS:
-     * - ref: Branch, tag ou commit (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - ref: Branch, tag ou commit (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
      * - Arquivo deve existir no caminho especificado
-     * - Referência deve ser válida
+     * - Referência deve ser válida
      *
-     * RECOMENDAÇÕES:
-     * - Use para leitura de arquivos de configuração
+     * RECOMENDAÇÕES:
+     * - Use para leitura de arquivos de configuração
      * - Verifique tamanho antes de ler arquivos grandes
-     * - Use referências específicas para versões
-     * - Trate arquivos binários adequadamente
+     * - Use referências específicas para versões
+     * - Trate arquivos binários adequadamente
      */
     getFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Cria um novo arquivo no repositório
+     * Cria um novo arquivo no repositório
      *
      * FUNCIONALIDADE:
-     * - Cria arquivo com conteúdo especificado
-     * - Faz commit automático com mensagem
-     * - Suporta criação em branches específicas
+     * - Cria arquivo com conteúdo especificado
+     * - Faz commit automático com mensagem
+     * - Suporta criação em branches específicas
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - path: Caminho do arquivo
-     * - content: Conteúdo do arquivo
+     * - content: Conteúdo do arquivo
      * - message: Mensagem de commit
      *
-     * PARÂMETROS OPCIONAIS:
-     * - branch: Branch de destino (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - branch: Branch de destino (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
-     * - Caminho deve ser válido
-     * - Usuário deve ter permissão de escrita
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Caminho deve ser válido
+     * - Usuário deve ter permissão de escrita
      *
-     * RECOMENDAÇÕES:
+     * RECOMENDAÇÕES:
      * - Use mensagens de commit descritivas
-     * - Valide conteúdo antes de enviar
-     * - Use branches para mudanças grandes
-     * - Documente propósito do arquivo
+     * - Valide conteúdo antes de enviar
+     * - Use branches para mudanças grandes
+     * - Documente propósito do arquivo
      */
     createFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Atualiza um arquivo existente no repositório
+     * Atualiza um arquivo existente no repositório
      *
      * FUNCIONALIDADE:
-     * - Atualiza conteúdo do arquivo
-     * - Faz commit com nova versão
+     * - Atualiza conteúdo do arquivo
+     * - Faz commit com nova versão
      * - Requer SHA do arquivo atual
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - path: Caminho do arquivo
-     * - content: Novo conteúdo
+     * - content: Novo conteúdo
      * - message: Mensagem de commit
      * - sha: SHA do arquivo atual
      *
-     * PARÂMETROS OPCIONAIS:
-     * - branch: Branch de destino (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - branch: Branch de destino (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
      * - Arquivo deve existir
-     * - SHA deve ser válido
+     * - SHA deve ser válido
      *
-     * RECOMENDAÇÕES:
+     * RECOMENDAÇÕES:
      * - Sempre obtenha SHA atual antes de atualizar
      * - Use mensagens de commit descritivas
-     * - Verifique se arquivo não foi modificado por outro usuário
-     * - Teste mudanças antes de commitar
+     * - Verifique se arquivo não foi modificado por outro usuário
+     * - Teste mudanças antes de commitar
      */
     updateFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Deleta um arquivo do repositório
+     * Deleta um arquivo do repositório
      *
      * FUNCIONALIDADE:
      * - Remove arquivo especificado
-     * - Faz commit de exclusão
+     * - Faz commit de exclusão
      * - Requer SHA do arquivo
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - path: Caminho do arquivo
      * - message: Mensagem de commit
      * - sha: SHA do arquivo
      *
-     * PARÂMETROS OPCIONAIS:
-     * - branch: Branch de destino (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - branch: Branch de destino (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
      * - Arquivo deve existir
-     * - SHA deve ser válido
+     * - SHA deve ser válido
      *
-     * RECOMENDAÇÕES:
-     * - Confirme exclusão antes de executar
+     * RECOMENDAÇÕES:
+     * - Confirme exclusão antes de executar
      * - Use mensagens de commit descritivas
-     * - Verifique dependências do arquivo
-     * - Mantenha backup se necessário
+     * - Verifique dependências do arquivo
+     * - Mantenha backup se necessário
      */
     deleteFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Lista conteúdo de um diretório
+     * Lista conteúdo de um diretório
      *
      * FUNCIONALIDADE:
-     * - Lista arquivos e subdiretórios
-     * - Suporta paginação
+     * - Lista arquivos e subdiretórios
+     * - Suporta paginação
      * - Inclui metadados de cada item
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      *
-     * PARÂMETROS OPCIONAIS:
-     * - path: Caminho do diretório (padrão: raiz)
-     * - ref: Branch, tag ou commit (padrão: branch padrão)
-     * - page: Página da listagem (padrão: 1)
-     * - limit: Itens por página (padrão: 30, máximo: 100)
+     * PARÂMETROS OPCIONAIS:
+     * - path: Caminho do diretório (padrão: raiz)
+     * - ref: Branch, tag ou commit (padrão: branch padrão)
+     * - page: Página da listagem (padrão: 1)
+     * - limit: Itens por página (padrão: 30, máximo: 100)
      *
-     * VALIDAÇÕES:
-     * - e repo obrigatórios
-     * - Diretório deve existir
+     * VALIDAÇÕES:
+     * - e repo obrigatórios
+     * - Diretório deve existir
      * - Page deve ser >= 1
      * - Limit deve ser entre 1 e 100
      *
-     * RECOMENDAÇÕES:
-     * - Use paginação para diretórios grandes
-     * - Monitore número total de itens
-     * - Use referências específicas para versões
-     * - Organize estrutura de diretórios
+     * RECOMENDAÇÕES:
+     * - Use paginação para diretórios grandes
+     * - Monitore número total de itens
+     * - Use referências específicas para versões
+     * - Organize estrutura de diretórios
      */
     listFiles(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Busca arquivos por conteúdo
+     * Busca arquivos por conteúdo
      *
      * FUNCIONALIDADE:
-     * - Busca arquivos que contenham texto específico
-     * - Suporta diferentes referências
+     * - Busca arquivos que contenham texto específico
+     * - Suporta diferentes referências
      * - Retorna resultados relevantes
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - query: Termo de busca
      *
-     * PARÂMETROS OPCIONAIS:
-     * - ref: Branch, tag ou commit (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - ref: Branch, tag ou commit (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
      * - Query deve ter pelo menos 3 caracteres
-     * - Repositório deve existir
+     * - Repositório deve existir
      *
-     * RECOMENDAÇÕES:
-     * - Use termos de busca específicos
-     * - Combine com filtros de diretório
-     * - Use referências para versões específicas
-     * - Analise resultados para relevância
+     * RECOMENDAÇÕES:
+     * - Use termos de busca específicos
+     * - Combine com filtros de diretório
+     * - Use referências para versões específicas
+     * - Analise resultados para relevância
      */
     searchFiles(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Faz upload de todo o projeto para o repositório
+     * Faz upload de todo o projeto para o repositório
      *
      * FUNCIONALIDADE:
      * - Envia todos os arquivos do projeto local
-     * - Ignora diretórios desnecessários (node_modules, .git, dist)
-     * - Ignora arquivos temporários e logs
+     * - Ignora diretórios desnecessários (node_modules, .git, dist)
+     * - Ignora arquivos temporários e logs
      * - Faz commit com mensagem personalizada
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - owner: Proprietário do repositório
-     * - repo: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
      * - projectPath: Caminho do projeto local
      * - message: Mensagem de commit
      *
-     * PARÂMETROS OPCIONAIS:
-     * - branch: Branch de destino (padrão: branch padrão)
+     * PARÂMETROS OPCIONAIS:
+     * - branch: Branch de destino (padrão: branch padrão)
      *
-     * VALIDAÇÕES:
-     * - Todos os parâmetros obrigatórios
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
      * - Projeto deve existir no caminho especificado
-     * - Usuário deve ter permissão de escrita
+     * - Usuário deve ter permissão de escrita
      *
-     * RECOMENDAÇÕES:
+     * RECOMENDAÇÕES:
      * - Use mensagens de commit descritivas
-     * - Verifique se o repositório está limpo
-     * - Use branches para mudanças grandes
+     * - Verifique se o repositório está limpo
+     * - Use branches para mudanças grandes
      * - Monitore erros de upload
      */
     uploadProject(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
     /**
-     * Verifica se erro é relacionado a Git
+     * Verifica se erro é relacionado a Git
      */
     isGitRelatedError(errorMessage: string): boolean;
 };