@andrebuzeli/git-mcp 3.0.1 → 3.1.0

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

@@ -1,228 +1,186 @@
 import { z } from 'zod';
+import { VcsOperations } from '../providers/index.js';
 /**
- * Tool: git-files
+ * Tool: files
  *
- * GERENCIAMENTO DE ARQUIVOS - Expandido com bulk operations
- * Funcionalidades avançadas para manipulação de arquivos
+ * DESCRIÇÃO:
+ * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
  *
- * DESIGNED FOR: Programador individual autônomo
- * PHILOSOPHY: Operações em lote e manipulação avançada de arquivos
+ * 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
+ *
+ * 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
+ *
+ * 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
  */
-declare const GitFilesInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
-    action: z.ZodLiteral<"read">;
-    projectPath: z.ZodString;
-    filePath: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    action: "read";
-    projectPath: string;
-    filePath: string;
-}, {
-    action: "read";
-    projectPath: string;
-    filePath: string;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"create">;
-    projectPath: z.ZodString;
-    filePath: z.ZodString;
-    content: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    action: "create";
-    projectPath: string;
-    filePath: string;
-    content: string;
-}, {
-    action: "create";
-    projectPath: string;
-    filePath: string;
-    content: string;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"update">;
-    projectPath: z.ZodString;
-    filePath: z.ZodString;
-    content: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    action: "update";
-    projectPath: string;
-    filePath: string;
-    content: string;
-}, {
-    action: "update";
-    projectPath: string;
-    filePath: string;
-    content: string;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"delete">;
-    projectPath: z.ZodString;
-    filePath: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    action: "delete";
-    projectPath: string;
-    filePath: string;
-}, {
-    action: "delete";
-    projectPath: string;
-    filePath: string;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"list">;
+/**
+ * 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
+ *
+ * RECOMENDAÇÕES:
+ * - Sempre valide entrada antes de usar
+ * - 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"]>;
+    repo: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
     projectPath: z.ZodString;
-    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    provider: z.ZodEnum<["gitea", "github"]>;
+    content: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    sha: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    path: string;
-    recursive: boolean;
-    action: "list";
-    projectPath: string;
-}, {
-    action: "list";
+    provider: "gitea" | "github";
+    repo: string;
+    action: "delete" | "get" | "search" | "list" | "create" | "update" | "upload-project";
     projectPath: string;
     path?: string | undefined;
-    recursive?: boolean | undefined;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"create-dir">;
-    projectPath: z.ZodString;
-    dirPath: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    action: "create-dir";
-    projectPath: string;
-    dirPath: string;
-}, {
-    action: "create-dir";
-    projectPath: string;
-    dirPath: string;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"bulk-create">;
-    projectPath: z.ZodString;
-    files: z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
-        content: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        path: string;
-        content: string;
-    }, {
-        path: string;
-        content: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    action: "bulk-create";
-    projectPath: string;
-    files: {
-        path: string;
-        content: string;
-    }[];
-}, {
-    action: "bulk-create";
-    projectPath: string;
-    files: {
-        path: string;
-        content: string;
-    }[];
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"bulk-delete">;
-    projectPath: z.ZodString;
-    files: z.ZodArray<z.ZodString, "many">;
-    confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    action: "bulk-delete";
-    projectPath: string;
-    files: string[];
-    confirm: boolean;
+    message?: string | undefined;
+    ref?: string | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    sha?: string | undefined;
+    branch?: string | undefined;
+    query?: string | undefined;
+    content?: string | undefined;
 }, {
-    action: "bulk-delete";
+    provider: "gitea" | "github";
+    repo: string;
+    action: "delete" | "get" | "search" | "list" | "create" | "update" | "upload-project";
     projectPath: string;
-    files: string[];
-    confirm?: boolean | undefined;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"bulk-copy">;
-    projectPath: z.ZodString;
-    files: z.ZodArray<z.ZodObject<{
-        from: z.ZodString;
-        to: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        from: string;
-        to: string;
-    }, {
-        from: string;
-        to: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    action: "bulk-copy";
-    projectPath: string;
-    files: {
-        from: string;
-        to: string;
-    }[];
-}, {
-    action: "bulk-copy";
-    projectPath: string;
-    files: {
-        from: string;
-        to: string;
-    }[];
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"search">;
-    projectPath: z.ZodString;
-    query: z.ZodString;
-    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    caseSensitive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    action: "search";
-    projectPath: string;
-    query: string;
-    caseSensitive: boolean;
-}, {
-    action: "search";
-    projectPath: string;
-    query: string;
     path?: string | undefined;
-    caseSensitive?: boolean | undefined;
-}>, z.ZodObject<{
-    action: z.ZodLiteral<"create-template">;
-    projectPath: z.ZodString;
-    template: z.ZodEnum<["gitignore", "readme", "license", "dockerfile", "package-json"]>;
-    name: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    action: "create-template";
-    projectPath: string;
-    template: "gitignore" | "readme" | "license" | "dockerfile" | "package-json";
-    name?: string | undefined;
-}, {
-    action: "create-template";
-    projectPath: string;
-    template: "gitignore" | "readme" | "license" | "dockerfile" | "package-json";
-    name?: string | undefined;
-}>]>;
-export type GitFilesInput = z.infer<typeof GitFilesInputSchema>;
-declare const GitFilesResultSchema: z.ZodObject<{
+    message?: string | undefined;
+    ref?: string | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    sha?: string | undefined;
+    branch?: string | undefined;
+    query?: string | undefined;
+    content?: string | undefined;
+}>;
+export type FilesInput = z.infer<typeof FilesInputSchema>;
+/**
+ * Schema de saída padronizado
+ *
+ * ESTRUTURA:
+ * - success: Status da operação
+ * - action: Ação executada
+ * - message: Mensagem descritiva
+ * - data: Dados retornados (opcional)
+ * - error: Detalhes do erro (opcional)
+ */
+declare const FilesResultSchema: z.ZodObject<{
     success: z.ZodBoolean;
     action: z.ZodString;
     message: z.ZodString;
     data: z.ZodOptional<z.ZodAny>;
     error: z.ZodOptional<z.ZodString>;
-    recoverable: z.ZodOptional<z.ZodBoolean>;
-    suggestion: z.ZodOptional<z.ZodString>;
-    warning: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     message: string;
     action: string;
     success: boolean;
     error?: string | undefined;
     data?: any;
-    recoverable?: boolean | undefined;
-    suggestion?: string | undefined;
-    warning?: string | undefined;
 }, {
     message: string;
     action: string;
     success: boolean;
     error?: string | undefined;
     data?: any;
-    recoverable?: boolean | undefined;
-    suggestion?: string | undefined;
-    warning?: string | undefined;
 }>;
-export type GitFilesResult = z.infer<typeof GitFilesResultSchema>;
-export declare const gitFilesTool: {
+export type FilesResult = z.infer<typeof FilesResultSchema>;
+/**
+ * Tool: files
+ *
+ * DESCRIÇÃO:
+ * Gerenciamento completo de arquivos e diretórios Gitea com múltiplas ações
+ *
+ * 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)
+ *
+ * 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)
+ *
+ * 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)
+ *
+ * 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)
+ *
+ * 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)
+ *
+ * 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
+ */
+export declare const filesTool: {
     name: string;
     description: string;
     inputSchema: {
@@ -233,96 +191,298 @@ export declare const gitFilesTool: {
                 enum: string[];
                 description: string;
             };
-            projectPath: {
+            repo: {
                 type: string;
                 description: string;
             };
-            filePath: {
+            provider: {
                 type: string;
+                enum: string[];
                 description: string;
             };
-            content: {
+            path: {
                 type: string;
                 description: string;
             };
-            path: {
+            projectPath: {
                 type: string;
                 description: string;
-                default: string;
             };
-            recursive: {
+            content: {
                 type: string;
                 description: string;
-                default: boolean;
             };
-            dirPath: {
+            message: {
                 type: string;
                 description: string;
             };
-            files: {
+            branch: {
                 type: string;
                 description: string;
             };
-            confirm: {
+            sha: {
                 type: string;
                 description: string;
-                default: boolean;
             };
-            query: {
+            ref: {
                 type: string;
                 description: string;
             };
-            caseSensitive: {
+            query: {
                 type: string;
                 description: string;
-                default: boolean;
             };
-            template: {
+            page: {
                 type: string;
-                enum: string[];
                 description: string;
+                minimum: number;
             };
-            name: {
+            limit: {
                 type: string;
                 description: string;
+                minimum: number;
+                maximum: number;
             };
         };
         required: string[];
     };
-    handler(input: GitFilesInput): Promise<GitFilesResult>;
-    handleRead(params: GitFilesInput & {
-        action: "read";
-    }): Promise<GitFilesResult>;
-    handleCreate(params: GitFilesInput & {
-        action: "create";
-    }): Promise<GitFilesResult>;
-    handleUpdate(params: GitFilesInput & {
-        action: "update";
-    }): Promise<GitFilesResult>;
-    handleDelete(params: GitFilesInput & {
-        action: "delete";
-    }): Promise<GitFilesResult>;
-    handleList(params: GitFilesInput & {
-        action: "list";
-    }): Promise<GitFilesResult>;
-    handleCreateDir(params: GitFilesInput & {
-        action: "create-dir";
-    }): Promise<GitFilesResult>;
-    handleBulkCreate(params: GitFilesInput & {
-        action: "bulk-create";
-    }): Promise<GitFilesResult>;
-    handleBulkDelete(params: GitFilesInput & {
-        action: "bulk-delete";
-    }): Promise<GitFilesResult>;
-    handleBulkCopy(params: GitFilesInput & {
-        action: "bulk-copy";
-    }): Promise<GitFilesResult>;
-    handleSearch(params: GitFilesInput & {
-        action: "search";
-    }): Promise<GitFilesResult>;
-    handleCreateTemplate(params: GitFilesInput & {
-        action: "create-template";
-    }): Promise<GitFilesResult>;
+    /**
+     * Handler principal da tool files
+     *
+     * 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: FilesInput): Promise<FilesResult>;
+    /**
+     * Obtém o conteúdo de um arquivo específico
+     *
+     * FUNCIONALIDADE:
+     * - Retorna conteúdo completo do arquivo
+     * - Inclui metadados (SHA, tamanho, tipo)
+     * - Suporta diferentes referências (branch, tag, commit)
+     *
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - projectPath: Caminho do projeto local (OBRIGATÓRIO para TODAS as operações)
+     * - provider: Provedor a usar (gitea ou github)
+     * - repo: Nome do repositório
+     * - path: Caminho do arquivo
+     *
+     * PARÂMETROS OPCIONAIS:
+     * - ref: Branch, tag ou commit (padrão: branch padrão)
+     *
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Arquivo deve existir no caminho especificado
+     * - Referência deve ser válida
+     *
+     * 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
+     */
+    getFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
+    /**
+     * 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
+     *
+     * PARÂMETROS OBRIGATÓRIOS:
+     * - owner: Proprietário do repositório
+     * - repo: Nome do repositório
+     * - path: Caminho do arquivo
+     * - content: Conteúdo do arquivo
+     * - message: Mensagem de commit
+     *
+     * 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
+     *
+     * RECOMENDAÇÕES:
+     * - Use mensagens de commit descritivas
+     * - 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
+     *
+     * FUNCIONALIDADE:
+     * - 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
+     * - path: Caminho do arquivo
+     * - 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)
+     *
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Arquivo deve existir
+     * - SHA deve ser válido
+     *
+     * 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
+     */
+    updateFile(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
+    /**
+     * Deleta um arquivo do repositório
+     *
+     * FUNCIONALIDADE:
+     * - Remove arquivo especificado
+     * - Faz commit de exclusão
+     * - Requer SHA do arquivo
+     *
+     * 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)
+     *
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Arquivo deve existir
+     * - SHA deve ser válido
+     *
+     * RECOMENDAÇÕES:
+     * - Confirme exclusão antes de executar
+     * - Use mensagens de commit descritivas
+     * - 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
+     *
+     * FUNCIONALIDADE:
+     * - 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 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
+     * - 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
+     */
+    listFiles(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
+    /**
+     * Busca arquivos por conteúdo
+     *
+     * FUNCIONALIDADE:
+     * - 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
+     * - query: Termo de busca
+     *
+     * PARÂMETROS OPCIONAIS:
+     * - ref: Branch, tag ou commit (padrão: branch padrão)
+     *
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Query deve ter pelo menos 3 caracteres
+     * - 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
+     */
+    searchFiles(params: FilesInput, provider: VcsOperations, owner: string): Promise<FilesResult>;
+    /**
+     * 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
+     * - Faz commit com mensagem personalizada
+     *
+     * 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)
+     *
+     * VALIDAÇÕES:
+     * - Todos os parâmetros obrigatórios
+     * - Projeto deve existir no caminho especificado
+     * - Usuário deve ter permissão de escrita
+     *
+     * RECOMENDAÇÕES:
+     * - Use mensagens de commit descritivas
+     * - 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>;
 };
 export {};
 //# sourceMappingURL=git-files.d.ts.map