@andrebuzeli/git-mcp 12.0.0 → 13.6.0

package/src/utils/errors.js

@@ -1,3 +1,5 @@
+// Sistema de Erros Melhorado para AI Agents
+
 export class MCPError extends Error {
   constructor(code, message, data) {
     super(message);
@@ -6,6 +8,262 @@ export class MCPError extends Error {
   }
 }
 
+// Códigos de erro padronizados com sugestões para AI
+export const ERROR_CODES = {
+  // Auth
+  AUTH_GITHUB_INVALID: {
+    code: "AUTH_GITHUB_INVALID",
+    suggestion: "Verifique se GITHUB_TOKEN está configurado e é válido. Gere um novo token em github.com/settings/tokens"
+  },
+  AUTH_GITEA_INVALID: {
+    code: "AUTH_GITEA_INVALID", 
+    suggestion: "Verifique se GITEA_TOKEN e GITEA_URL estão configurados corretamente"
+  },
+  AUTH_NO_PERMISSION: {
+    code: "AUTH_NO_PERMISSION",
+    suggestion: "Token não tem permissão para esta operação. Verifique os scopes do token"
+  },
+  
+  // Repo
+  REPO_NOT_FOUND: {
+    code: "REPO_NOT_FOUND",
+    suggestion: "Repositório não existe. Use action='init' com createIfMissing=true para criar"
+  },
+  REPO_NO_WRITE: {
+    code: "REPO_NO_WRITE",
+    suggestion: "Sem permissão de escrita. Verifique se você é owner ou colaborador do repositório"
+  },
+  REPO_ALREADY_EXISTS: {
+    code: "REPO_ALREADY_EXISTS",
+    suggestion: "Repositório já existe. Use action='ensure' para verificar ou escolha outro nome"
+  },
+  
+  // Git Local
+  NOT_A_GIT_REPO: {
+    code: "NOT_A_GIT_REPO",
+    suggestion: "Diretório não é um repositório git. Use action='init' primeiro para inicializar"
+  },
+  NO_COMMITS: {
+    code: "NO_COMMITS",
+    suggestion: "Repositório não tem commits. Use action='add' e depois action='commit' primeiro"
+  },
+  NOTHING_TO_COMMIT: {
+    code: "NOTHING_TO_COMMIT",
+    suggestion: "Working tree limpa, nada para commitar. Modifique arquivos primeiro"
+  },
+  NOTHING_TO_PUSH: {
+    code: "NOTHING_TO_PUSH",
+    suggestion: "Nenhuma mudança para push. Faça commits primeiro"
+  },
+  
+  // Branches
+  BRANCH_NOT_FOUND: {
+    code: "BRANCH_NOT_FOUND",
+    suggestion: "Branch não existe. Use action='list' para ver branches disponíveis"
+  },
+  BRANCH_ALREADY_EXISTS: {
+    code: "BRANCH_ALREADY_EXISTS",
+    suggestion: "Branch já existe. Use outro nome ou delete a existente primeiro"
+  },
+  CANNOT_DELETE_CURRENT: {
+    code: "CANNOT_DELETE_CURRENT",
+    suggestion: "Não pode deletar branch atual. Faça checkout para outra branch primeiro"
+  },
+  
+  // Tags
+  TAG_NOT_FOUND: {
+    code: "TAG_NOT_FOUND",
+    suggestion: "Tag não existe. Use action='list' para ver tags disponíveis"
+  },
+  TAG_ALREADY_EXISTS: {
+    code: "TAG_ALREADY_EXISTS",
+    suggestion: "Tag já existe. Use outro nome ou delete a existente primeiro"
+  },
+  
+  // Refs
+  REF_NOT_FOUND: {
+    code: "REF_NOT_FOUND",
+    suggestion: "Referência não encontrada. Verifique se o commit/branch/tag existe. Use action='log' para ver histórico"
+  },
+  INSUFFICIENT_HISTORY: {
+    code: "INSUFFICIENT_HISTORY",
+    suggestion: "Histórico insuficiente para HEAD~N. Use action='log' para verificar quantos commits existem"
+  },
+  
+  // Stash
+  NOTHING_TO_STASH: {
+    code: "NOTHING_TO_STASH",
+    suggestion: "Working tree limpa, nada para stash. Modifique arquivos primeiro"
+  },
+  STASH_NOT_FOUND: {
+    code: "STASH_NOT_FOUND",
+    suggestion: "Stash não encontrado. Use action='list' para ver stashes disponíveis"
+  },
+  
+  // Remote
+  REMOTE_NOT_FOUND: {
+    code: "REMOTE_NOT_FOUND",
+    suggestion: "Remote não configurado. Use action='ensure-remotes' para configurar"
+  },
+  PUSH_REJECTED: {
+    code: "PUSH_REJECTED",
+    suggestion: "Push rejeitado (histórico divergente). Use force=true para forçar, ou faça pull primeiro"
+  },
+  MERGE_CONFLICT: {
+    code: "MERGE_CONFLICT",
+    suggestion: "Conflito de merge. Resolva conflitos manualmente e faça novo commit"
+  },
+  
+  // Network
+  NETWORK_TIMEOUT: {
+    code: "NETWORK_TIMEOUT",
+    suggestion: "Timeout de conexão. Verifique sua internet e tente novamente"
+  },
+  RATE_LIMIT: {
+    code: "RATE_LIMIT",
+    suggestion: "Rate limit excedido. Aguarde alguns minutos antes de tentar novamente"
+  },
+  
+  // Validation
+  VALIDATION_ERROR: {
+    code: "VALIDATION_ERROR",
+    suggestion: "Parâmetros inválidos. Verifique os parâmetros obrigatórios da action"
+  },
+  MISSING_PARAMETER: {
+    code: "MISSING_PARAMETER",
+    suggestion: "Parâmetro obrigatório faltando"
+  },
+  
+  // Files
+  FILE_NOT_FOUND: {
+    code: "FILE_NOT_FOUND",
+    suggestion: "Arquivo não encontrado no repositório. Use action='list' para ver arquivos disponíveis"
+  },
+  
+  // Issues/PRs
+  ISSUE_NOT_FOUND: {
+    code: "ISSUE_NOT_FOUND",
+    suggestion: "Issue não encontrada. Use action='list' para ver issues disponíveis"
+  },
+  PR_NOT_FOUND: {
+    code: "PR_NOT_FOUND",
+    suggestion: "Pull Request não encontrado. Use action='list' para ver PRs disponíveis"
+  },
+  
+  // Generic
+  UNKNOWN_ERROR: {
+    code: "UNKNOWN_ERROR",
+    suggestion: "Erro desconhecido. Verifique os logs para mais detalhes"
+  }
+};
+
+// Função para criar erro com sugestão
+export function createError(errorCode, details = {}) {
+  const errorInfo = ERROR_CODES[errorCode] || ERROR_CODES.UNKNOWN_ERROR;
+  return new MCPError(errorInfo.code, details.message || errorInfo.code, {
+    suggestion: errorInfo.suggestion,
+    ...details
+  });
+}
+
+// Função para mapear erros externos para códigos internos
+export function mapExternalError(error, context = {}) {
+  const msg = error?.message?.toLowerCase() || String(error).toLowerCase();
+  
+  // GitHub/Gitea API errors
+  if (msg.includes("bad credentials") || msg.includes("401")) {
+    return context.provider === "gitea" 
+      ? createError("AUTH_GITEA_INVALID", { originalError: msg })
+      : createError("AUTH_GITHUB_INVALID", { originalError: msg });
+  }
+  
+  if (msg.includes("not found") || msg.includes("404")) {
+    if (context.type === "repo") return createError("REPO_NOT_FOUND", { repo: context.repo, originalError: msg });
+    if (context.type === "branch") return createError("BRANCH_NOT_FOUND", { branch: context.branch, originalError: msg });
+    if (context.type === "tag") return createError("TAG_NOT_FOUND", { tag: context.tag, originalError: msg });
+    if (context.type === "file") return createError("FILE_NOT_FOUND", { file: context.file, originalError: msg });
+    if (context.type === "issue") return createError("ISSUE_NOT_FOUND", { number: context.number, originalError: msg });
+    if (context.type === "pr") return createError("PR_NOT_FOUND", { number: context.number, originalError: msg });
+    return createError("REF_NOT_FOUND", { ref: context.ref, originalError: msg });
+  }
+  
+  if (msg.includes("permission") || msg.includes("403") || msg.includes("forbidden")) {
+    return createError("AUTH_NO_PERMISSION", { originalError: msg });
+  }
+  
+  if (msg.includes("rate limit") || msg.includes("429")) {
+    return createError("RATE_LIMIT", { originalError: msg });
+  }
+  
+  if (msg.includes("timeout") || msg.includes("etimedout") || msg.includes("econnrefused")) {
+    return createError("NETWORK_TIMEOUT", { originalError: msg });
+  }
+  
+  if (msg.includes("push rejected") || msg.includes("non-fast-forward")) {
+    return createError("PUSH_REJECTED", { originalError: msg });
+  }
+  
+  if (msg.includes("conflict")) {
+    return createError("MERGE_CONFLICT", { originalError: msg });
+  }
+  
+  if (msg.includes("already exists")) {
+    if (context.type === "repo") return createError("REPO_ALREADY_EXISTS", { repo: context.repo, originalError: msg });
+    if (context.type === "branch") return createError("BRANCH_ALREADY_EXISTS", { branch: context.branch, originalError: msg });
+    if (context.type === "tag") return createError("TAG_ALREADY_EXISTS", { tag: context.tag, originalError: msg });
+    return createError("BRANCH_ALREADY_EXISTS", { originalError: msg });
+  }
+  
+  // isomorphic-git specific errors
+  if (msg.includes("could not find") && msg.includes("head~")) {
+    return createError("INSUFFICIENT_HISTORY", { originalError: msg });
+  }
+  
+  if (msg.includes("is not a git repository") || msg.includes("could not find .git")) {
+    return createError("NOT_A_GIT_REPO", { path: context.path, originalError: msg });
+  }
+  
+  if (msg.includes("nothing to commit") || msg.includes("working tree clean")) {
+    return createError("NOTHING_TO_COMMIT", { originalError: msg });
+  }
+  
+  if (msg.includes("could not resolve ref") || msg.includes("invalid reference")) {
+    return createError("REF_NOT_FOUND", { originalError: msg });
+  }
+  
+  if (msg.includes("branch") && (msg.includes("does not exist") || msg.includes("not found"))) {
+    return createError("BRANCH_NOT_FOUND", { originalError: msg });
+  }
+  
+  if (msg.includes("tag") && (msg.includes("does not exist") || msg.includes("not found"))) {
+    return createError("TAG_NOT_FOUND", { originalError: msg });
+  }
+  
+  if (msg.includes("no commits") || msg.includes("unknown revision")) {
+    return createError("NO_COMMITS", { originalError: msg });
+  }
+  
+  if (msg.includes("nada para stash") || msg.includes("nothing to stash") || msg.includes("no local changes")) {
+    return createError("NOTHING_TO_STASH", { originalError: msg });
+  }
+  
+  if (msg.includes("stash") && (msg.includes("not found") || msg.includes("não encontrado"))) {
+    return createError("STASH_NOT_FOUND", { originalError: msg });
+  }
+  
+  if (msg.includes("author") || msg.includes("committer")) {
+    return createError("VALIDATION_ERROR", { 
+      message: "Configure user.name e user.email", 
+      suggestion: "Use git-config para configurar ou forneça tokens de provider",
+      originalError: msg 
+    });
+  }
+  
+  // Generic fallback
+  return createError("UNKNOWN_ERROR", { originalError: msg, context });
+}
+
+// Resultado de sucesso
 export function asToolResult(result) {
   return {
     content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
@@ -13,10 +271,27 @@ export function asToolResult(result) {
   };
 }
 
+// Resultado de erro (formato melhorado para AI agents)
 export function asToolError(code, message, data) {
+  const errorInfo = ERROR_CODES[code] || {};
+  const response = {
+    error: true,
+    code: code,
+    message: message,
+    suggestion: errorInfo.suggestion || "Verifique os parâmetros e tente novamente",
+    ...data
+  };
   return {
-    content: [{ type: "text", text: JSON.stringify({ code, message, data }) }],
+    content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
     isError: true,
   };
 }
 
+// Helper para converter MCPError em resposta
+export function errorToResponse(error) {
+  if (error instanceof MCPError) {
+    return asToolError(error.code, error.message, error.data);
+  }
+  const mapped = mapExternalError(error);
+  return asToolError(mapped.code, mapped.message, mapped.data);
+}