@andrebuzeli/git-mcp 15.8.4 → 15.8.5

package/src/utils/repoHelpers.js

@@ -1,160 +1,160 @@
-import path from "node:path";
-import fs from "node:fs";
-
-export function getRepoNameFromPath(projectPath) {
-  const base = path.basename(projectPath).trim();
-  return base.replace(/\s+/g, "_").replace(/[^A-Za-z0-9_\-]/g, "");
-}
-
-export function normalizeProjectFilePath(projectPath, relative) {
-  const joined = path.resolve(projectPath, relative || ".");
-  return joined;
-}
-
-/**
- * Valida se um caminho é seguro (não contém path traversal)
- * @param {string} projectPath - Caminho do projeto
- * @throws {Error} Se o caminho contiver path traversal ou for inválido
- */
-export function validateProjectPath(projectPath) {
-  if (!projectPath || typeof projectPath !== "string") {
-    throw new Error("projectPath é obrigatório e deve ser uma string");
-  }
-  
-  // Verifica se é um caminho absoluto
-  if (!path.isAbsolute(projectPath)) {
-    throw new Error("projectPath deve ser um caminho absoluto");
-  }
-  
-  // Normaliza o caminho
-  const normalized = path.resolve(projectPath);
-  
-  // Verifica path traversal patterns
-  if (projectPath.includes("..") || projectPath.includes("./..")) {
-    throw new Error("Path traversal detectado: caminho não pode conter '..'");
-  }
-  
-  // Verifica se o diretório pai existe
-  const parentDir = path.dirname(normalized);
-  if (!fs.existsSync(parentDir)) {
-    throw new Error("Diretório pai não existe");
-  }
-  
-  // Verifica se o caminho não é muito longo (limite do Windows é 260 chars)
-  if (normalized.length > 260) {
-    throw new Error("Caminho muito longo (máximo 260 caracteres)");
-  }
-  
-  return normalized;
-}
-
-/**
- * Valida um caminho de arquivo relativo ao projeto
- * @param {string} projectPath - Caminho do projeto
- * @param {string} filePath - Caminho do arquivo relativo
- * @returns {string} Caminho absoluto validado
- */
-export function validateFilePath(projectPath, filePath) {
-  const normalizedProject = validateProjectPath(projectPath);
-  const absoluteFile = path.resolve(normalizedProject, filePath);
-  
-  // Garante que o arquivo está dentro do projeto
-  if (!absoluteFile.startsWith(normalizedProject)) {
-    throw new Error(`Path traversal detectado: '${filePath}' tenta acessar fora do projeto`);
-  }
-  
-  return absoluteFile;
-}
-
-export function getEnv(key) {
-  const v = process.env[key];
-  return v === undefined ? "" : String(v);
-}
-
-export function getProvidersEnv() {
-  return {
-    githubToken: getEnv("GITHUB_TOKEN"),
-    giteaUrl: getEnv("GITEA_URL"),
-    giteaToken: getEnv("GITEA_TOKEN"),
-  };
-}
-
-/**
- * Padrões comuns de .gitignore para diferentes tipos de projeto
- */
-export const GITIGNORE_TEMPLATES = {
-  node: [
-    "node_modules/",
-    "npm-debug.log*",
-    "yarn-debug.log*",
-    "yarn-error.log*",
-    ".npm",
-    ".yarn",
-    "dist/",
-    "build/",
-    ".env",
-    ".env.local",
-    ".env.*.local",
-    "*.log",
-    ".DS_Store",
-    "Thumbs.db",
-    "*.swp",
-    "*.swo",
-    ".idea/",
-    ".vscode/",
-    "*.sublime-*",
-    "coverage/",
-    ".nyc_output/"
-  ],
-  python: [
-    "__pycache__/",
-    "*.py[cod]",
-    "*$py.class",
-    "*.so",
-    ".Python",
-    "env/",
-    "venv/",
-    ".venv/",
-    "pip-log.txt",
-    "pip-delete-this-directory.txt",
-    ".tox/",
-    ".coverage",
-    ".cache",
-    "*.egg-info/",
-    ".installed.cfg",
-    "*.egg",
-    ".env",
-    ".vscode/",
-    ".idea/"
-  ],
-  general: [
-    ".DS_Store",
-    "Thumbs.db",
-    "*.log",
-    "*.tmp",
-    "*.temp",
-    "*.swp",
-    "*.swo",
-    "*~",
-    ".env",
-    ".env.local",
-    ".vscode/",
-    ".idea/"
-  ]
-};
-
-/**
- * Detecta o tipo de projeto baseado nos arquivos existentes
- */
-export function detectProjectType(projectPath) {
-  if (fs.existsSync(path.join(projectPath, "package.json"))) {
-    return "node";
-  }
-  if (fs.existsSync(path.join(projectPath, "requirements.txt")) || 
-      fs.existsSync(path.join(projectPath, "setup.py")) ||
-      fs.existsSync(path.join(projectPath, "pyproject.toml"))) {
-    return "python";
-  }
-  return "general";
-}
-
+import path from "node:path";
+import fs from "node:fs";
+
+export function getRepoNameFromPath(projectPath) {
+  const base = path.basename(projectPath).trim();
+  return base.replace(/\s+/g, "_").replace(/[^A-Za-z0-9_\-]/g, "");
+}
+
+export function normalizeProjectFilePath(projectPath, relative) {
+  const joined = path.resolve(projectPath, relative || ".");
+  return joined;
+}
+
+/**
+ * Valida se um caminho é seguro (não contém path traversal)
+ * @param {string} projectPath - Caminho do projeto
+ * @throws {Error} Se o caminho contiver path traversal ou for inválido
+ */
+export function validateProjectPath(projectPath) {
+  if (!projectPath || typeof projectPath !== "string") {
+    throw new Error("projectPath é obrigatório e deve ser uma string");
+  }
+  
+  // Verifica se é um caminho absoluto
+  if (!path.isAbsolute(projectPath)) {
+    throw new Error("projectPath deve ser um caminho absoluto");
+  }
+  
+  // Normaliza o caminho
+  const normalized = path.resolve(projectPath);
+  
+  // Verifica path traversal patterns
+  if (projectPath.includes("..") || projectPath.includes("./..")) {
+    throw new Error("Path traversal detectado: caminho não pode conter '..'");
+  }
+  
+  // Verifica se o diretório pai existe
+  const parentDir = path.dirname(normalized);
+  if (!fs.existsSync(parentDir)) {
+    throw new Error("Diretório pai não existe");
+  }
+  
+  // Verifica se o caminho não é muito longo (limite do Windows é 260 chars)
+  if (normalized.length > 260) {
+    throw new Error("Caminho muito longo (máximo 260 caracteres)");
+  }
+  
+  return normalized;
+}
+
+/**
+ * Valida um caminho de arquivo relativo ao projeto
+ * @param {string} projectPath - Caminho do projeto
+ * @param {string} filePath - Caminho do arquivo relativo
+ * @returns {string} Caminho absoluto validado
+ */
+export function validateFilePath(projectPath, filePath) {
+  const normalizedProject = validateProjectPath(projectPath);
+  const absoluteFile = path.resolve(normalizedProject, filePath);
+  
+  // Garante que o arquivo está dentro do projeto
+  if (!absoluteFile.startsWith(normalizedProject)) {
+    throw new Error(`Path traversal detectado: '${filePath}' tenta acessar fora do projeto`);
+  }
+  
+  return absoluteFile;
+}
+
+export function getEnv(key) {
+  const v = process.env[key];
+  return v === undefined ? "" : String(v);
+}
+
+export function getProvidersEnv() {
+  return {
+    githubToken: getEnv("GITHUB_TOKEN"),
+    giteaUrl: getEnv("GITEA_URL"),
+    giteaToken: getEnv("GITEA_TOKEN"),
+  };
+}
+
+/**
+ * Padrões comuns de .gitignore para diferentes tipos de projeto
+ */
+export const GITIGNORE_TEMPLATES = {
+  node: [
+    "node_modules/",
+    "npm-debug.log*",
+    "yarn-debug.log*",
+    "yarn-error.log*",
+    ".npm",
+    ".yarn",
+    "dist/",
+    "build/",
+    ".env",
+    ".env.local",
+    ".env.*.local",
+    "*.log",
+    ".DS_Store",
+    "Thumbs.db",
+    "*.swp",
+    "*.swo",
+    ".idea/",
+    ".vscode/",
+    "*.sublime-*",
+    "coverage/",
+    ".nyc_output/"
+  ],
+  python: [
+    "__pycache__/",
+    "*.py[cod]",
+    "*$py.class",
+    "*.so",
+    ".Python",
+    "env/",
+    "venv/",
+    ".venv/",
+    "pip-log.txt",
+    "pip-delete-this-directory.txt",
+    ".tox/",
+    ".coverage",
+    ".cache",
+    "*.egg-info/",
+    ".installed.cfg",
+    "*.egg",
+    ".env",
+    ".vscode/",
+    ".idea/"
+  ],
+  general: [
+    ".DS_Store",
+    "Thumbs.db",
+    "*.log",
+    "*.tmp",
+    "*.temp",
+    "*.swp",
+    "*.swo",
+    "*~",
+    ".env",
+    ".env.local",
+    ".vscode/",
+    ".idea/"
+  ]
+};
+
+/**
+ * Detecta o tipo de projeto baseado nos arquivos existentes
+ */
+export function detectProjectType(projectPath) {
+  if (fs.existsSync(path.join(projectPath, "package.json"))) {
+    return "node";
+  }
+  if (fs.existsSync(path.join(projectPath, "requirements.txt")) || 
+      fs.existsSync(path.join(projectPath, "setup.py")) ||
+      fs.existsSync(path.join(projectPath, "pyproject.toml"))) {
+    return "python";
+  }
+  return "general";
+}
+

package/src/utils/retry.js

@@ -1,123 +1,123 @@
-// Sistema de Retry com Backoff Exponencial e Rate Limit Handling
-
-const DEFAULT_OPTIONS = {
-  maxRetries: 3,
-  initialDelay: 1000,
-  maxDelay: 10000,
-  backoffFactor: 2,
-  retryableErrors: [
-    // Network errors
-    "ETIMEDOUT", "ECONNRESET", "ENOTFOUND", "ECONNREFUSED", "ENETUNREACH", "EHOSTUNREACH",
-    // HTTP status codes
-    "timeout", "rate limit", "429", "503", "502", "504",
-    // SSL/TLS (pode ser temporário)
-    "EPROTO", "UNABLE_TO_GET_ISSUER_CERT",
-    // Outros
-    "socket hang up", "network error"
-  ]
-};
-
-function shouldRetry(error, options) {
-  const msg = (error?.message || String(error)).toLowerCase();
-  const code = error?.code?.toLowerCase() || "";
-  
-  return options.retryableErrors.some(e => 
-    msg.includes(e.toLowerCase()) || code.includes(e.toLowerCase())
-  );
-}
-
-function sleep(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-/**
- * Extrai o tempo de espera do header Retry-After
- * @param {Error} error - Erro com possível informação de rate limit
- * @returns {number|null} - Tempo em ms para esperar, ou null se não encontrado
- */
-function getRetryAfterMs(error) {
-  // Tenta extrair de headers (axios errors)
-  const headers = error?.response?.headers;
-  if (headers) {
-    const retryAfter = headers['retry-after'] || headers['x-ratelimit-reset'];
-    if (retryAfter) {
-      // Se for número de segundos
-      const seconds = parseInt(retryAfter, 10);
-      if (!isNaN(seconds)) {
-        // Se for timestamp unix (maior que ano 2000 em segundos)
-        if (seconds > 946684800) {
-          return Math.max(0, (seconds * 1000) - Date.now());
-        }
-        return seconds * 1000;
-      }
-    }
-  }
-  
-  // Tenta extrair de GitHub API rate limit
-  const rateLimitReset = error?.response?.headers?.['x-ratelimit-reset'];
-  if (rateLimitReset) {
-    const resetTime = parseInt(rateLimitReset, 10) * 1000;
-    return Math.max(0, resetTime - Date.now());
-  }
-  
-  return null;
-}
-
-export async function withRetry(fn, options = {}) {
-  const opts = { ...DEFAULT_OPTIONS, ...options };
-  let lastError;
-  let delay = opts.initialDelay;
-  
-  for (let attempt = 1; attempt <= opts.maxRetries; attempt++) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error;
-      
-      if (attempt === opts.maxRetries || !shouldRetry(error, opts)) {
-        throw error;
-      }
-      
-      // Verificar se há Retry-After header
-      const retryAfterMs = getRetryAfterMs(error);
-      const waitTime = retryAfterMs !== null 
-        ? Math.min(retryAfterMs, opts.maxDelay) 
-        : delay;
-      
-      if (process.env.DEBUG_AGENT_LOG) {
-        console.error(`[Retry] Attempt ${attempt}/${opts.maxRetries} failed, waiting ${waitTime}ms...`);
-      }
-      
-      await sleep(waitTime);
-      delay = Math.min(delay * opts.backoffFactor, opts.maxDelay);
-    }
-  }
-  
-  throw lastError;
-}
-
-// Wrapper para axios com retry
-export async function axiosWithRetry(axiosInstance, config, options = {}) {
-  return withRetry(() => axiosInstance(config), options);
-}
-
-// Wrapper para operações git com retry
-export async function gitWithRetry(fn, options = {}) {
-  return withRetry(fn, {
-    ...options,
-    retryableErrors: [...DEFAULT_OPTIONS.retryableErrors, "ENOENT", "lock"]
-  });
-}
-
-/**
- * Wrapper específico para APIs com rate limit
- */
-export async function apiWithRateLimitRetry(fn, options = {}) {
-  return withRetry(fn, {
-    maxRetries: 5,
-    initialDelay: 2000,
-    maxDelay: 60000,
-    ...options,
-    retryableErrors: ["rate limit", "429", "403", "too many requests"]
-  });
-}
+// Sistema de Retry com Backoff Exponencial e Rate Limit Handling
+
+const DEFAULT_OPTIONS = {
+  maxRetries: 3,
+  initialDelay: 1000,
+  maxDelay: 10000,
+  backoffFactor: 2,
+  retryableErrors: [
+    // Network errors
+    "ETIMEDOUT", "ECONNRESET", "ENOTFOUND", "ECONNREFUSED", "ENETUNREACH", "EHOSTUNREACH",
+    // HTTP status codes
+    "timeout", "rate limit", "429", "503", "502", "504",
+    // SSL/TLS (pode ser temporário)
+    "EPROTO", "UNABLE_TO_GET_ISSUER_CERT",
+    // Outros
+    "socket hang up", "network error"
+  ]
+};
+
+function shouldRetry(error, options) {
+  const msg = (error?.message || String(error)).toLowerCase();
+  const code = error?.code?.toLowerCase() || "";
+  
+  return options.retryableErrors.some(e => 
+    msg.includes(e.toLowerCase()) || code.includes(e.toLowerCase())
+  );
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * Extrai o tempo de espera do header Retry-After
+ * @param {Error} error - Erro com possível informação de rate limit
+ * @returns {number|null} - Tempo em ms para esperar, ou null se não encontrado
+ */
+function getRetryAfterMs(error) {
+  // Tenta extrair de headers (axios errors)
+  const headers = error?.response?.headers;
+  if (headers) {
+    const retryAfter = headers['retry-after'] || headers['x-ratelimit-reset'];
+    if (retryAfter) {
+      // Se for número de segundos
+      const seconds = parseInt(retryAfter, 10);
+      if (!isNaN(seconds)) {
+        // Se for timestamp unix (maior que ano 2000 em segundos)
+        if (seconds > 946684800) {
+          return Math.max(0, (seconds * 1000) - Date.now());
+        }
+        return seconds * 1000;
+      }
+    }
+  }
+  
+  // Tenta extrair de GitHub API rate limit
+  const rateLimitReset = error?.response?.headers?.['x-ratelimit-reset'];
+  if (rateLimitReset) {
+    const resetTime = parseInt(rateLimitReset, 10) * 1000;
+    return Math.max(0, resetTime - Date.now());
+  }
+  
+  return null;
+}
+
+export async function withRetry(fn, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  let lastError;
+  let delay = opts.initialDelay;
+  
+  for (let attempt = 1; attempt <= opts.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      
+      if (attempt === opts.maxRetries || !shouldRetry(error, opts)) {
+        throw error;
+      }
+      
+      // Verificar se há Retry-After header
+      const retryAfterMs = getRetryAfterMs(error);
+      const waitTime = retryAfterMs !== null 
+        ? Math.min(retryAfterMs, opts.maxDelay) 
+        : delay;
+      
+      if (process.env.DEBUG_AGENT_LOG) {
+        console.error(`[Retry] Attempt ${attempt}/${opts.maxRetries} failed, waiting ${waitTime}ms...`);
+      }
+      
+      await sleep(waitTime);
+      delay = Math.min(delay * opts.backoffFactor, opts.maxDelay);
+    }
+  }
+  
+  throw lastError;
+}
+
+// Wrapper para axios com retry
+export async function axiosWithRetry(axiosInstance, config, options = {}) {
+  return withRetry(() => axiosInstance(config), options);
+}
+
+// Wrapper para operações git com retry
+export async function gitWithRetry(fn, options = {}) {
+  return withRetry(fn, {
+    ...options,
+    retryableErrors: [...DEFAULT_OPTIONS.retryableErrors, "ENOENT", "lock"]
+  });
+}
+
+/**
+ * Wrapper específico para APIs com rate limit
+ */
+export async function apiWithRateLimitRetry(fn, options = {}) {
+  return withRetry(fn, {
+    maxRetries: 5,
+    initialDelay: 2000,
+    maxDelay: 60000,
+    ...options,
+    retryableErrors: ["rate limit", "429", "403", "too many requests"]
+  });
+}

package/install.sh

@@ -1,68 +0,0 @@
-#!/bin/bash
-# =============================================================================
-# git-mcp Install Script
-# =============================================================================
-# Quick install for Linux servers (especially SSH remote environments)
-# This avoids the npx timeout issues on slow/unstable networks
-# =============================================================================
-
-set -e
-
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-RED='\033[0;31m'
-NC='\033[0m' # No Color
-
-echo -e "${GREEN}🚀 Installing @andrebuzeli/git-mcp...${NC}"
-
-# Check for Node.js
-if ! command -v node &> /dev/null; then
-    echo -e "${RED}❌ Node.js not found!${NC}"
-    echo "Please install Node.js first: https://nodejs.org/"
-    exit 1
-fi
-
-# Check Node version (need 18+)
-NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
-if [ "$NODE_VERSION" -lt 18 ]; then
-    echo -e "${YELLOW}⚠️  Node.js version 18+ recommended (found: $(node -v))${NC}"
-fi
-
-# Check for npm
-if ! command -v npm &> /dev/null; then
-    echo -e "${RED}❌ npm not found!${NC}"
-    exit 1
-fi
-
-echo "📦 Installing globally..."
-npm install -g @andrebuzeli/git-mcp@latest
-
-# Verify installation
-if command -v git-mcp &> /dev/null; then
-    echo -e "${GREEN}✅ git-mcp installed successfully!${NC}"
-    echo ""
-    echo -e "${YELLOW}📝 Next steps:${NC}"
-    echo "1. Configure your IDE to use 'git-mcp' as the command"
-    echo ""
-    echo "   For Cursor/VS Code (settings.json or mcp.json):"
-    echo '   {'
-    echo '     "mcpServers": {'
-    echo '       "git-mcp": {'
-    echo '         "command": "git-mcp",'
-    echo '         "env": {'
-    echo '           "GITHUB_TOKEN": "your-token",'
-    echo '           "GITEA_URL": "https://your-gitea",'
-    echo '           "GITEA_TOKEN": "your-token"'
-    echo '         }'
-    echo '       }'
-    echo '     }'
-    echo '   }'
-    echo ""
-    echo "2. Restart your IDE or reconnect SSH"
-    echo ""
-    echo -e "${GREEN}Done! 🎉${NC}"
-else
-    echo -e "${RED}❌ Installation failed. Check npm permissions.${NC}"
-    echo "Try: sudo npm install -g @andrebuzeli/git-mcp@latest"
-    exit 1
-fi