@andrebuzeli/git-mcp 3.4.0 → 4.0.2

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

@@ -1,469 +0,0 @@
-import { z } from 'zod';
-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
- * 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
- *
- * 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
- *
- * 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
- *
- * 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)
- * - projectPath: Caminho do projeto local (OBRIGATÓRIO para TODAS as operações)
- * - repo: Nome do repositório (extraído automaticamente do projectPath)
- *
- * 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
- * - 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
- * - 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
- *
- * 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 (repo extraído do projectPath)
- * - Inicializar local: action=init, projectPath=/path/to/project
- *
- * 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
- *
- * 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
- */
-/**
- * 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
- *
- * RECOMENDAÇÕES:
- * - Sempre valide entrada antes de usar
- * - 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"]>;
-    provider: z.ZodEnum<["gitea", "github"]>;
-    projectPath: z.ZodString;
-    repo: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    private: z.ZodOptional<z.ZodBoolean>;
-    auto_init: z.ZodOptional<z.ZodBoolean>;
-    gitignores: z.ZodOptional<z.ZodString>;
-    license: z.ZodOptional<z.ZodString>;
-    readme: z.ZodOptional<z.ZodString>;
-    default_branch: z.ZodOptional<z.ZodString>;
-    username: z.ZodOptional<z.ZodString>;
-    page: z.ZodOptional<z.ZodNumber>;
-    new_name: z.ZodOptional<z.ZodString>;
-    new_description: z.ZodOptional<z.ZodString>;
-    new_private: z.ZodOptional<z.ZodBoolean>;
-    archived: z.ZodOptional<z.ZodBoolean>;
-    organization: z.ZodOptional<z.ZodString>;
-    query: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    provider: "gitea" | "github";
-    action: "delete" | "get" | "search" | "init" | "clone" | "list" | "create" | "update" | "fork";
-    projectPath: string;
-    name?: string | undefined;
-    description?: string | undefined;
-    private?: boolean | undefined;
-    default_branch?: string | undefined;
-    organization?: string | undefined;
-    repo?: string | undefined;
-    page?: number | undefined;
-    auto_init?: boolean | undefined;
-    gitignores?: string | undefined;
-    license?: string | undefined;
-    readme?: string | undefined;
-    username?: string | undefined;
-    new_name?: string | undefined;
-    new_description?: string | undefined;
-    new_private?: boolean | undefined;
-    archived?: boolean | undefined;
-    query?: string | undefined;
-}, {
-    provider: "gitea" | "github";
-    action: "delete" | "get" | "search" | "init" | "clone" | "list" | "create" | "update" | "fork";
-    projectPath: string;
-    name?: string | undefined;
-    description?: string | undefined;
-    private?: boolean | undefined;
-    default_branch?: string | undefined;
-    organization?: string | undefined;
-    repo?: string | undefined;
-    page?: number | undefined;
-    auto_init?: boolean | undefined;
-    gitignores?: string | undefined;
-    license?: string | undefined;
-    readme?: string | undefined;
-    username?: string | undefined;
-    new_name?: string | undefined;
-    new_description?: string | undefined;
-    new_private?: boolean | undefined;
-    archived?: boolean | undefined;
-    query?: string | undefined;
-}>;
-export type GitRepositoriesInput = z.infer<typeof GitRepositoriesInputSchema>;
-declare const GitRepositoriesResultSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-    action: z.ZodString;
-    message: z.ZodString;
-    data: z.ZodOptional<z.ZodAny>;
-    error: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    action: string;
-    success: boolean;
-    error?: string | undefined;
-    data?: any;
-}, {
-    message: string;
-    action: string;
-    success: boolean;
-    error?: string | undefined;
-    data?: any;
-}>;
-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
- *
- * 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)
- *    - gitignores (opcional): Template de .gitignore
- *    - 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)
- *
- * 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
- *    - new_name (opcional): Novo nome
- *    - 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
- *
- * 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)
- *
- * 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
- *
- * RECOMENDAÇÕES DE USO:
- * - Use nomes descritivos para repositórios
- * - Configure visibilidade adequada para o projeto
- * - Mantenha descrições atualizadas
- * - Use templates para projetos similares
- * - Configure branch padrão adequada
- * - Use paginação para listas grandes
- */
-export declare const gitRepositoriesTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            provider: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            projectPath: {
-                type: string;
-                description: string;
-            };
-            name: {
-                type: string;
-                description: string;
-            };
-            description: {
-                type: string;
-                description: string;
-            };
-            private: {
-                type: string;
-                description: string;
-            };
-            auto_init: {
-                type: string;
-                description: string;
-            };
-            gitignores: {
-                type: string;
-                description: string;
-            };
-            license: {
-                type: string;
-                description: string;
-            };
-            readme: {
-                type: string;
-                description: string;
-            };
-            default_branch: {
-                type: string;
-                description: string;
-            };
-            username: {
-                type: string;
-                description: string;
-            };
-            page: {
-                type: string;
-                description: string;
-                minimum: number;
-            };
-            new_name: {
-                type: string;
-                description: string;
-            };
-            new_description: {
-                type: string;
-                description: string;
-            };
-            new_private: {
-                type: string;
-                description: string;
-            };
-            archived: {
-                type: string;
-                description: string;
-            };
-            organization: {
-                type: string;
-                description: string;
-            };
-            query: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    /**
-     * Handler principal da tool git-repositories
-     *
-     * FUNCIONALIDADE:
-     * - Valida entrada usando Zod schema
-     * - 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
-     * 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
-     *
-     * RECOMENDAÇÕES:
-     * - Sempre valide entrada antes de processar
-     * - Trate erros específicos adequadamente
-     * - Log detalhes de erro para debug
-     * - Retorne mensagens de erro úteis
-     */
-    handler(input: GitRepositoriesInput): Promise<GitRepositoriesResult>;
-    /**
-     * Cria um novo repositório
-     *
-     * FUNCIONALIDADE:
-     * - 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 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)
-     *
-     * VALIDAÇÕES:
-     * - Nome obrigatório
-     * - Nome único no usuário/organização
-     * - Permissões adequadas
-     *
-     * RECOMENDAÇÕES:
-     * - Use nomes descritivos e únicos
-     * - Configure visibilidade adequada
-     * - Inicialize com README para projetos novos
-     * - Use templates para consistência
-     */
-    createRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    listRepositories(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    getRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    updateRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    deleteRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    forkRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    searchRepositories(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-    /**
-     * Inicializa um repositório Git local
-     *
-     * FUNCIONALIDADE:
-     * - Executa 'git init' no diretório especificado
-     * - Cria estrutura básica do Git
-     * - Adiciona remote se especificado
-     *
-     * PARÂMETROS OBRIGATÓRIOS:
-     * - projectPath: Caminho do projeto local
-     *
-     * PARÂMETROS OPCIONAIS:
-     * - owner/repo: Para configurar remote
-     * - provider: Para determinar URL do remote
-     *
-     * RECOMENDAÇÕES:
-     * - Verifique se diretório existe
-     * - Use caminhos absolutos
-     * - Configure remote após inicialização
-     */
-    initRepository(params: GitRepositoriesInput, provider?: VcsOperations): Promise<GitRepositoriesResult>;
-    /**
-     * Clona um repositório para o diretório local
-     *
-     * FUNCIONALIDADE:
-     * - Clona repositório remoto para diretório local
-     * - Suporta diferentes protocolos (HTTPS, SSH)
-     * - Mantém estrutura de diretórios
-     *
-     * 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
-     * - Use caminhos absolutos
-     * - Considere profundidade de clone para repositórios grandes
-     */
-    cloneRepository(params: GitRepositoriesInput, provider: VcsOperations): Promise<GitRepositoriesResult>;
-};
-export {};
-//# sourceMappingURL=git-repositories.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"git-repositories.d.ts","sourceRoot":"","sources":["../../src/tools/git-repositories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAyB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AAEH;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiC9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;mBACkB,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmD1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;6BAC4B,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;6BAuB9E,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;0BAsBjF,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;6BAsB3E,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;6BAgC9E,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;2BAsBhF,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;+BAsB1E,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2B/G;;;;;;;;;;;;;;;;;;;OAmBG;2BAC0B,oBAAoB,aAAa,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsD5G;;;;;;;;;;;;;;;;;;OAkBG;4BAC2B,oBAAoB,YAAY,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA2C7G,CAAC"}