@andrebuzeli/git-mcp 2.29.0 → 2.29.2

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

@@ -3,112 +3,112 @@ import { VcsOperations } from '../providers/index.js';
 /**
  * Tool: git-repositories
  *
- * DESCRIÇÃO COMPLETA:
- * Gerenciamento completo de repositórios Git com suporte multi-provider (GitHub e Gitea).
- * Esta tool é 100% auto-suficiente e implementa TODAS as operações de repositório sem depender
+ * DESCRIÇÃO COMPLETA:
+ * Gerenciamento completo de repositórios Git com suporte multi-provider (GitHub e Gitea).
+ * Esta tool é 100% auto-suficiente e implementa TODAS as operações de repositório sem depender
  * de outras tools ou comandos externos.
  *
  * FUNCIONALIDADES IMPLEMENTADAS:
  *
- * 1. CRIAÇÃO E CONFIGURAÇÃO:
- *    - create: Cria novos repositórios com configurações completas
- *    - init: Inicializa repositórios Git locais
- *    - clone: Clona repositórios remotos localmente
- *    - update: Atualiza configurações de repositórios existentes
+ * 1. CRIAÇÃO E CONFIGURAÇÃO:
+ *    - create: Cria novos repositórios com configurações completas
+ *    - init: Inicializa repositórios Git locais
+ *    - clone: Clona repositórios remotos localmente
+ *    - update: Atualiza configurações de repositórios existentes
  *
  * 2. LISTAGEM E BUSCA:
- *    - list: Lista repositórios do usuário ou organização
- *    - get: Obtém detalhes específicos de um repositório
- *    - search: Busca repositórios por critérios específicos
+ *    - list: Lista repositórios do usuário ou organização
+ *    - get: Obtém detalhes específicos de um repositório
+ *    - search: Busca repositórios por critérios específicos
  *
- * 3. OPERAÇÕES AVANÇADAS:
- *    - fork: Cria fork de repositórios existentes
- *    - delete: Remove repositórios permanentemente
- *    - archive: Arquivamento de repositórios
- *    - transfer: Transferência de propriedade
+ * 3. OPERAÇÕES AVANÇADAS:
+ *    - fork: Cria fork de repositórios existentes
+ *    - delete: Remove repositórios permanentemente
+ *    - archive: Arquivamento de repositórios
+ *    - transfer: Transferência de propriedade
  *
- * 4. CONFIGURAÇÕES E METADADOS:
- *    - Visibilidade (público/privado)
- *    - Descrições e documentação
- *    - Configurações de branch padrão
- *    - Templates e inicialização automática
- *    - Licenças e arquivos de configuração
+ * 4. CONFIGURAÇÕES E METADADOS:
+ *    - Visibilidade (público/privado)
+ *    - Descrições e documentação
+ *    - Configurações de branch padrão
+ *    - Templates e inicialização automática
+ *    - Licenças e arquivos de configuração
  *
- * PARÂMETROS OBRIGATÓRIOS:
- * - action: Ação a executar (create, list, get, update, delete, fork, search, init, clone)
+ * PARÂMETROS OBRIGATÓRIOS:
+ * - action: Ação a executar (create, list, get, update, delete, fork, search, init, clone)
  * - provider: Provedor a usar (gitea ou github)
- * - owner: Proprietário do repositório (obrigatório para operações remotas)
- * - repo: Nome do repositório (obrigatório para operações remotas)
- * - projectPath: Caminho do projeto local (obrigatório para operações locais)
+ * - owner: Proprietário do repositório (obrigatório para operações remotas)
+ * - repo: Nome do repositório (obrigatório para operações remotas)
+ * - projectPath: Caminho do projeto local (obrigatório para operações locais)
  *
- * PARÂMETROS OPCIONAIS:
- * - name: Nome do repositório para criação
- * - description: Descrição do repositório
- * - private: Visibilidade do repositório
- * - auto_init: Inicialização automática com README
+ * PARÂMETROS OPCIONAIS:
+ * - name: Nome do repositório para criação
+ * - description: Descrição do repositório
+ * - private: Visibilidade do repositório
+ * - auto_init: Inicialização automática com README
  * - gitignores: Template de .gitignore
- * - license: Template de licença
- * - readme: Conteúdo do README
- * - default_branch: Branch padrão
- * - username: Usuário para listagem
- * - page: Página para paginação
+ * - license: Template de licença
+ * - readme: Conteúdo do README
+ * - default_branch: Branch padrão
+ * - username: Usuário para listagem
+ * - page: Página para paginação
  * - limit: Limite de resultados
- * - new_name: Novo nome para atualização
- * - new_description: Nova descrição
+ * - new_name: Novo nome para atualização
+ * - new_description: Nova descrição
  * - new_private: Nova visibilidade
  * - archived: Status de arquivamento
- * - organization: Organização para fork
+ * - organization: Organização para fork
  * - query: Termo de busca
  *
  * CASOS DE USO:
- * 1. Criação de repositórios para novos projetos
- * 2. Backup e migração de código
- * 3. Organização de projetos em equipe
- * 4. Automação de workflows de desenvolvimento
- * 5. Gerenciamento de repositórios em massa
- * 6. Configuração de templates de projeto
- * 7. Sincronização entre diferentes provedores
+ * 1. Criação de repositórios para novos projetos
+ * 2. Backup e migração de código
+ * 3. Organização de projetos em equipe
+ * 4. Automação de workflows de desenvolvimento
+ * 5. Gerenciamento de repositórios em massa
+ * 6. Configuração de templates de projeto
+ * 7. Sincronização entre diferentes provedores
  *
  * EXEMPLOS DE USO:
- * - Criar repositório: action=create, name=meu-projeto, description=Projeto incrível
- * - Listar repositórios: action=list, username=usuario
- * - Buscar repositórios: action=search, query=react typescript
- * - Clonar repositório: action=clone, url=https://github.com/user/repo.git
+ * - Criar repositório: action=create, name=meu-projeto, description=Projeto incrível
+ * - Listar repositórios: action=list, username=usuario
+ * - Buscar repositórios: action=search, query=react typescript
+ * - Clonar repositório: action=clone, url=https://github.com/user/repo.git
  * - Inicializar local: action=init, projectPath=/path/to/project
  *
- * RECOMENDAÇÕES:
+ * RECOMENDAÇÕES:
  * - Use nomes descritivos e consistentes
  * - Configure visibilidade adequada para cada projeto
- * - Mantenha descrições atualizadas e informativas
- * - Use templates para padronização
- * - Configure branches padrão apropriadas
- * - Documente configurações importantes
- * - Use licenças adequadas para cada projeto
+ * - Mantenha descrições atualizadas e informativas
+ * - Use templates para padronização
+ * - Configure branches padrão apropriadas
+ * - Documente configurações importantes
+ * - Use licenças adequadas para cada projeto
  *
- * LIMITAÇÕES:
- * - Operações de arquivamento dependem do provedor
- * - Transferência de propriedade requer permissões especiais
- * - Alguns provedores podem ter limitações de API
+ * LIMITAÇÕES:
+ * - Operações de arquivamento dependem do provedor
+ * - Transferência de propriedade requer permissões especiais
+ * - Alguns provedores podem ter limitações de API
  *
- * SEGURANÇA:
- * - Tokens de acesso são obrigatórios para operações remotas
- * - Validação de permissões antes de operações destrutivas
- * - Logs detalhados de todas as operações
- * - Tratamento seguro de informações sensíveis
+ * SEGURANÇA:
+ * - Tokens de acesso são obrigatórios para operações remotas
+ * - Validação de permissões antes de operações destrutivas
+ * - Logs detalhados de todas as operações
+ * - Tratamento seguro de informações sensíveis
  */
 /**
- * Schema de validação para entrada da tool git-repositories
+ * Schema de validação para entrada da tool git-repositories
  *
- * VALIDAÇÕES:
- * - action: Ação obrigatória (create, list, get, update, delete, fork, search, init, clone)
- * - provider: Obrigatório (gitea ou github)
- * - Parâmetros específicos por ação
- * - Validação de tipos e formatos
+ * VALIDAÇÕES:
+ * - action: Ação obrigatória (create, list, get, update, delete, fork, search, init, clone)
+ * - provider: Obrigatório (gitea ou github)
+ * - 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 GitRepositoriesInputSchema: z.ZodObject<{
     action: z.ZodEnum<["create", "list", "get", "update", "delete", "fork", "search", "init", "clone"]>;
@@ -201,77 +201,77 @@ export type GitRepositoriesResult = z.infer<typeof GitRepositoriesResultSchema>;
 /**
  * Tool: git-repositories
  *
- * DESCRIÇÃO:
- * Gerenciamento completo de repositórios Git (GitHub + Gitea) com múltiplas ações
+ * DESCRIÇÃO:
+ * Gerenciamento completo de repositórios Git (GitHub + Gitea) com múltiplas ações
  *
- * ACTIONS DISPONÍVEIS:
+ * ACTIONS DISPONÍVEIS:
  *
- * 1. create - Criar novo repositório
- *    Parâmetros:
- *    - name (obrigatório): Nome do repositório
- *    - description (opcional): Descrição do repositório
- *    - private (opcional): Repositório privado (padrão: false)
- *    - auto_init (opcional): Inicializar com README (padrão: false)
+ * 1. create - Criar novo repositório
+ *    Parâmetros:
+ *    - name (obrigatório): Nome do repositório
+ *    - description (opcional): Descrição do repositório
+ *    - private (opcional): Repositório privado (padrão: false)
+ *    - auto_init (opcional): Inicializar com README (padrão: false)
  *    - gitignores (opcional): Template de .gitignore
- *    - license (opcional): Template de licença
- *    - readme (opcional): Conteúdo do README
- *    - default_branch (opcional): Branch padrão
+ *    - license (opcional): Template de licença
+ *    - readme (opcional): Conteúdo do README
+ *    - default_branch (opcional): Branch padrão
  *
- * 2. list - Listar repositórios
- *    Parâmetros:
- *    - username (opcional): Usuário específico (padrão: usuário atual)
- *    - page (opcional): Página da listagem (padrão: 1)
- *    - limit (opcional): Itens por página (padrão: 30)
+ * 2. list - Listar repositórios
+ *    Parâmetros:
+ *    - username (opcional): Usuário específico (padrão: usuário atual)
+ *    - page (opcional): Página da listagem (padrão: 1)
+ *    - limit (opcional): Itens por página (padrão: 30)
  *
- * 3. get - Obter detalhes do repositório
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
+ * 3. get - Obter detalhes do repositório
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
  *
- * 4. update - Atualizar repositório
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
+ * 4. update - Atualizar repositório
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
  *    - new_name (opcional): Novo nome
- *    - new_description (opcional): Nova descrição
+ *    - new_description (opcional): Nova descrição
  *    - new_private (opcional): Nova visibilidade
  *    - archived (opcional): Status de arquivamento
  *
- * 5. delete - Deletar repositório
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
+ * 5. delete - Deletar repositório
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
  *
- * 6. fork - Fazer fork do repositório
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório original
- *    - repo (obrigatório): Nome do repositório original
- *    - organization (opcional): Organização de destino
+ * 6. fork - Fazer fork do repositório
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório original
+ *    - repo (obrigatório): Nome do repositório original
+ *    - organization (opcional): Organização de destino
  *
- * 7. search - Buscar repositórios
- *    Parâmetros:
- *    - query (obrigatório): Termo de busca
- *    - page (opcional): Página da busca (padrão: 1)
- *    - limit (opcional): Itens por página (padrão: 30)
+ * 7. search - Buscar repositórios
+ *    Parâmetros:
+ *    - query (obrigatório): Termo de busca
+ *    - page (opcional): Página da busca (padrão: 1)
+ *    - limit (opcional): Itens por página (padrão: 30)
  *
- * 8. init - Inicializar repositório Git local
- *    Parâmetros:
- *    - projectPath (obrigatório): Caminho do projeto local
+ * 8. init - Inicializar repositório Git local
+ *    Parâmetros:
+ *    - projectPath (obrigatório): Caminho do projeto local
  *    - owner/repo (opcional): Para configurar remote
  *
- * 9. clone - Clonar repositório para local
- *    Parâmetros:
- *    - owner (obrigatório): Proprietário do repositório
- *    - repo (obrigatório): Nome do repositório
- *    - projectPath (obrigatório): Caminho local de destino
+ * 9. clone - Clonar repositório para local
+ *    Parâmetros:
+ *    - owner (obrigatório): Proprietário do repositório
+ *    - repo (obrigatório): Nome do repositório
+ *    - projectPath (obrigatório): Caminho local de destino
  *
- * RECOMENDAÇÕES DE USO:
- * - Use nomes descritivos para repositórios
+ * RECOMENDAÇÕES DE USO:
+ * - Use nomes descritivos para repositórios
  * - Configure visibilidade adequada para o projeto
- * - Mantenha descrições atualizadas
+ * - Mantenha descrições atualizadas
  * - Use templates para projetos similares
- * - Configure branch padrão adequada
- * - Use paginação para listas grandes
+ * - Configure branch padrão adequada
+ * - Use paginação para listas grandes
  */
 export declare const gitRepositoriesTool: {
     name: string;
@@ -376,60 +376,60 @@ export declare const gitRepositoriesTool: {
      *
      * 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: GitRepositoriesInput): Promise<GitRepositoriesResult>;
     /**
-     * Cria um novo repositório
+     * Cria um novo repositório
      *
      * FUNCIONALIDADE:
-     * - Valida parâmetros obrigatórios
-     * - Configura dados padrão
-     * - Chama API do provider para criação
+     * - Valida parâmetros obrigatórios
+     * - Configura dados padrão
+     * - Chama API do provider para criação
      * - Retorna resultado formatado
      *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - name: Nome do repositório
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - name: Nome do repositório
      *
-     * PARÂMETROS OPCIONAIS:
-     * - description: Descrição do repositório
-     * - private: Visibilidade (padrão: false)
-     * - auto_init: Inicializar com README (padrão: false)
+     * PARÂMETROS OPCIONAIS:
+     * - description: Descrição do repositório
+     * - private: Visibilidade (padrão: false)
+     * - auto_init: Inicializar com README (padrão: false)
      * - gitignores: Template de .gitignore
-     * - license: Template de licença
-     * - readme: Conteúdo do README
-     * - default_branch: Branch padrão (padrão: main)
+     * - license: Template de licença
+     * - readme: Conteúdo do README
+     * - default_branch: Branch padrão (padrão: main)
      *
-     * VALIDAÇÕES:
-     * - Nome obrigatório
-     * - Nome único no usuário/organização
-     * - Permissões adequadas
+     * VALIDAÇÕES:
+     * - Nome obrigatório
+     * - Nome único no usuário/organização
+     * - Permissões adequadas
      *
-     * RECOMENDAÇÕES:
-     * - Use nomes descritivos e únicos
+     * RECOMENDAÇÕES:
+     * - Use nomes descritivos e únicos
      * - Configure visibilidade adequada
      * - Inicialize com README para projetos novos
-     * - Use templates para consistência
+     * - Use templates para consistência
      */
     createRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
     listRepositories(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
@@ -439,48 +439,48 @@ export declare const gitRepositoriesTool: {
     forkRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
     searchRepositories(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
     /**
-     * Inicializa um repositório Git local
+     * Inicializa um repositório Git local
      *
      * FUNCIONALIDADE:
-     * - Executa 'git init' no diretório especificado
-     * - Cria estrutura básica do Git
+     * - Executa 'git init' no diretório especificado
+     * - Cria estrutura básica do Git
      * - Adiciona remote se especificado
      *
-     * PARÂMETROS OBRIGATÓRIOS:
+     * PARÂMETROS OBRIGATÓRIOS:
      * - projectPath: Caminho do projeto local
      *
-     * PARÂMETROS OPCIONAIS:
+     * PARÂMETROS OPCIONAIS:
      * - owner/repo: Para configurar remote
      * - provider: Para determinar URL do remote
      *
-     * RECOMENDAÇÕES:
-     * - Verifique se diretório existe
+     * RECOMENDAÇÕES:
+     * - Verifique se diretório existe
      * - Use caminhos absolutos
-     * - Configure remote após inicialização
+     * - Configure remote após inicialização
      */
     initRepository(params: GitRepositoriesInput, provider?: VcsOperations): Promise<GitRepositoriesResult>;
     /**
-     * Clona um repositório para o diretório local
+     * Clona um repositório para o diretório local
      *
      * FUNCIONALIDADE:
-     * - Clona repositório remoto para diretório local
+     * - Clona repositório remoto para diretório local
      * - Suporta diferentes protocolos (HTTPS, SSH)
-     * - Mantém estrutura de diretórios
+     * - Mantém estrutura de diretórios
      *
-     * 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 local de destino
      * - provider: Provider a ser usado
      *
-     * RECOMENDAÇÕES:
-     * - Verifique espaço em disco disponível
+     * RECOMENDAÇÕES:
+     * - Verifique espaço em disco disponível
      * - Use caminhos absolutos
-     * - Considere profundidade de clone para repositórios grandes
+     * - Considere profundidade de clone para repositórios grandes
      */
     cloneRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
     /**
-     * Verifica se erro é relacionado a Git
+     * Verifica se erro é relacionado a Git
      */
     isGitRelatedError(errorMessage: string): boolean;
 };