@andrebuzeli/git-mcp 2.29.0 → 2.29.2

package/dist/tools/git-files.js

@@ -7,45 +7,45 @@ const user_detection_js_1 = require("../utils/user-detection.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
  */
 const FilesInputSchema = zod_1.z.object({
     action: zod_1.z.enum(['get', 'create', 'update', 'delete', 'list', 'search', 'upload-project']),
-    // Parâmetros comuns
+    // Parâmetros comuns
     // owner: obtido automaticamente do provider,
     repo: zod_1.z.string(),
     path: zod_1.z.string().optional(),
@@ -60,16 +60,16 @@ const FilesInputSchema = zod_1.z.object({
     ref: zod_1.z.string().optional(),
     // Para search
     query: zod_1.z.string().optional(),
-    // Para list com paginação
+    // Para list com paginação
     page: zod_1.z.number().min(1).optional(),
     limit: zod_1.z.number().min(1).max(100).optional(),
 });
 /**
- * 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)
@@ -84,73 +84,73 @@ const FilesResultSchema = zod_1.z.object({
 /**
  * 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
  */
 exports.filesTool = {
     name: 'git-files',
-    description: 'tool: Gerencia arquivos Git, upload, download, busca e sincronização\n──────────────\naction get: obtém arquivo específico\naction get requires: repo, path, provider\n───────────────\naction create: cria novo arquivo\naction create requires: repo, path, content, message, provider\n───────────────\naction update: atualiza arquivo existente\naction update requires: repo, path, content, message, sha, provider\n───────────────\naction delete: remove arquivo\naction delete requires: repo, path, message, provider\n───────────────\naction list: lista arquivos do diretório\naction list requires: repo, path, provider\n───────────────\naction search: busca conteúdo em arquivos\naction search requires: repo, query, provider\n───────────────\naction upload-project: envia projeto completo\naction upload-project requires: repo, projectPath, message, provider',
+    description: 'tool: Gerencia arquivos Git, upload, download, busca e sincronização\n──────────────\naction get: obtém arquivo específico\naction get requires: repo, path, provider\n───────────────\naction create: cria novo arquivo\naction create requires: repo, path, content, message, provider\n───────────────\naction update: atualiza arquivo existente\naction update requires: repo, path, content, message, sha, provider\n───────────────\naction delete: remove arquivo\naction delete requires: repo, path, message, provider\n───────────────\naction list: lista arquivos do diretório\naction list requires: repo, path, provider\n───────────────\naction search: busca conteúdo em arquivos\naction search requires: repo, query, provider\n───────────────\naction upload-project: envia projeto completo\naction upload-project requires: repo, projectPath, message, provider',
     inputSchema: {
         type: 'object',
         properties: {
@@ -179,37 +179,37 @@ exports.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
      */
     async handler(input) {
         try {
             const validatedInput = FilesInputSchema.parse(input);
-            // Aplicar auto-detecção apenas para owner dentro do provider especificado
+            // Aplicar auto-detecção apenas para owner dentro do provider especificado
             const processedInput = await (0, user_detection_js_1.applyAutoUserDetection)(validatedInput, validatedInput.provider);
-            // Usar o provider especificado pelo usuário
+            // Usar o provider especificado pelo usuário
             const provider = index_js_1.globalProviderFactory.getProvider(processedInput.provider);
             if (!provider) {
-                throw new Error(`Provider '${processedInput.provider}' não encontrado`);
+                throw new Error(`Provider '${processedInput.provider}' não encontrado`);
             }
             // Obter o owner do provider
             const owner = (await provider.getCurrentUser()).login;
@@ -229,49 +229,49 @@ exports.filesTool = {
                 case 'upload-project':
                     return await this.uploadProject(processedInput, provider, owner);
                 default:
-                    throw new Error(`Ação não suportada: ${processedInput.action}`);
+                    throw new Error(`Ação não suportada: ${processedInput.action}`);
             }
         }
         catch (error) {
             return {
                 success: false,
                 action: input.action,
-                message: 'Erro na operação de arquivos',
+                message: 'Erro na operação de arquivos',
                 error: error instanceof Error ? error.message : String(error)
             };
         }
     },
     /**
-     * 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
      */
     async getFile(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.path) {
-                throw new Error('repo e path são obrigatórios');
+                throw new Error('repo e path são obrigatórios');
             }
             const file = await provider.getFile(owner, params.repo, params.path, params.ref);
             return {
@@ -286,38 +286,38 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async createFile(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.path || !params.content || !params.message) {
-                throw new Error('repo, path, content e message são obrigatórios');
+                throw new Error('repo, path, content e message são obrigatórios');
             }
             const result = await provider.createFile(owner, params.repo, params.path, params.content, params.message, params.branch);
             return {
@@ -332,41 +332,41 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async updateFile(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.path || !params.content || !params.message) {
-                throw new Error('repo, path, content e message são obrigatórios');
+                throw new Error('repo, path, content e message são obrigatórios');
             }
-            // Se não foi fornecido SHA, obter automaticamente
+            // Se não foi fornecido SHA, obter automaticamente
             let fileSha = params.sha;
             if (!fileSha) {
                 try {
@@ -374,7 +374,7 @@ exports.filesTool = {
                     fileSha = existingFile.sha;
                 }
                 catch (error) {
-                    throw new Error('Não foi possível obter SHA do arquivo. Forneça sha ou verifique se o arquivo existe.');
+                    throw new Error('Não foi possível obter SHA do arquivo. Forneça sha ou verifique se o arquivo existe.');
                 }
             }
             const result = await provider.updateFile(owner, params.repo, params.path, params.content, params.message, fileSha, params.branch);
@@ -390,40 +390,40 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async deleteFile(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.path || !params.message) {
-                throw new Error('repo, path e message são obrigatórios');
+                throw new Error('repo, path e message são obrigatórios');
             }
-            // Se não foi fornecido SHA, obter automaticamente
+            // Se não foi fornecido SHA, obter automaticamente
             let fileSha = params.sha;
             if (!fileSha) {
                 try {
@@ -431,7 +431,7 @@ exports.filesTool = {
                     fileSha = existingFile.sha;
                 }
                 catch (error) {
-                    throw new Error('Não foi possível obter SHA do arquivo. Forneça sha ou verifique se o arquivo existe.');
+                    throw new Error('Não foi possível obter SHA do arquivo. Forneça sha ou verifique se o arquivo existe.');
                 }
             }
             const result = await provider.deleteFile(owner, params.repo, params.path, params.message, fileSha, params.branch);
@@ -447,39 +447,39 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async listFiles(params, provider, owner) {
         try {
             if (!owner || !params.repo) {
-                throw new Error('e repo são obrigatórios');
+                throw new Error('e repo são obrigatórios');
             }
             const path = params.path || '';
             const page = params.page || 1;
@@ -503,41 +503,41 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async searchFiles(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.query) {
-                throw new Error('repo e query são obrigatórios');
+                throw new Error('repo e query são obrigatórios');
             }
             if (params.query.length < 3) {
                 throw new Error('Query deve ter pelo menos 3 caracteres');
             }
-            // Implementar busca de arquivos por conteúdo
+            // Implementar busca de arquivos por conteúdo
             // Por enquanto, retorna mensagem de funcionalidade
             return {
                 success: true,
@@ -545,8 +545,8 @@ exports.filesTool = {
                 message: `Busca por '${params.query}' solicitada`,
                 data: {
                     query: params.query,
-                    ref: params.ref || 'branch padrão',
-                    results: 'Funcionalidade de busca será implementada'
+                    ref: params.ref || 'branch padrão',
+                    results: 'Funcionalidade de busca será implementada'
                 }
             };
         }
@@ -555,38 +555,38 @@ exports.filesTool = {
         }
     },
     /**
-     * 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
      */
     async uploadProject(params, provider, owner) {
         try {
             if (!owner || !params.repo || !params.projectPath || !params.message) {
-                throw new Error('repo, projectPath e message são obrigatórios');
+                throw new Error('repo, projectPath e message são obrigatórios');
             }
             const result = await provider.uploadProject(owner, params.repo, params.projectPath, params.message, params.branch);
             return {
@@ -605,7 +605,7 @@ exports.filesTool = {
         }
     },
     /**
-     * Verifica se erro é relacionado a Git
+     * Verifica se erro é relacionado a Git
      */
     isGitRelatedError(errorMessage) {
         const gitKeywords = [