@andre.buzeli/git-mcp 16.0.8 → 16.1.3

package/src/tools/git-reset.js

@@ -1,16 +1,17 @@
 import Ajv from "ajv";
 import { asToolError, asToolResult, errorToResponse } from "../utils/errors.js";
 import { validateProjectPath, withRetry } from "../utils/repoHelpers.js";
+import { sendLog, requestConfirmation } from "../utils/mcpNotify.js";
 
 const ajv = new Ajv({ allErrors: true });
 
-export function createGitResetTool(git) {
+export function createGitResetTool(git, server) {
   const inputSchema = {
     type: "object",
     properties: {
       projectPath: { 
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: { 
         type: "string", 
@@ -30,7 +31,11 @@ export function createGitResetTool(git) {
     additionalProperties: false
   };
 
-  const description = `Reset Git - desfaz commits e/ou mudanças.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Reset Git - desfaz commits e/ou mudanças.
 
 ⚠️ CUIDADO: Reset pode causar perda de dados!
 
@@ -81,10 +86,18 @@ REFERÊNCIAS:
         return asToolResult({ success: true, action: "mixed", ref, message: "Commits desfeitos, mudanças mantidas no working directory" });
       }
       if (action === "hard") {
+        await sendLog(server, "warning", "reset hard solicitado", { ref });
+        const confirmed = await requestConfirmation(server, `⚠️ Vai executar reset hard para ${ref}. Isso DESCARTA mudanças permanentemente. Confirmar?`);
+        if (!confirmed) return asToolError("CANCELLED", "Operação cancelada pelo usuário");
+
         await withRetry(() => git.resetHard(projectPath, ref), 3, "reset-hard");
         return asToolResult({ success: true, action: "hard", ref, message: "⚠️ Reset hard executado - mudanças descartadas" });
       }
       if (action === "hard-clean") {
+        await sendLog(server, "warning", "reset hard-clean solicitado", { ref });
+        const confirmed = await requestConfirmation(server, `⚠️ Vai executar reset hard-clean para ${ref}. Isso DESCARTA mudanças E arquivos não rastreados permanentemente. Confirmar?`);
+        if (!confirmed) return asToolError("CANCELLED", "Operação cancelada pelo usuário");
+
         const result = await withRetry(() => git.resetHardClean(projectPath, ref), 3, "reset-hard-clean");
         return asToolResult({ 
           success: true, 
@@ -101,5 +114,11 @@ REFERÊNCIAS:
     }
   }
 
-  return { name: "git-reset", description, inputSchema, handle };
+  return { 
+    name: "git-reset", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false }
+  };
 }

package/src/tools/git-stash.js

@@ -11,7 +11,7 @@ export function createGitStashTool(git) {
     properties: {
       projectPath: {
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: {
         type: "string",
@@ -34,6 +34,7 @@ export function createGitStashTool(git) {
       },
       includeUntracked: {
         type: "boolean",
+        default: false,
         description: "Incluir arquivos não rastreados no stash (action='save'). Default: false"
       }
     },
@@ -41,7 +42,11 @@ export function createGitStashTool(git) {
     additionalProperties: false
   };
 
-  const description = `Gerenciamento de stash Git - salva mudanças temporariamente.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Gerenciamento de stash Git - salva mudanças temporariamente.
 
 QUANDO USAR STASH:
 - Precisa trocar de branch mas tem mudanças não commitadas
@@ -117,5 +122,11 @@ AÇÕES:
     }
   }
 
-  return { name: "git-stash", description, inputSchema, handle };
+  return { 
+    name: "git-stash", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }

package/src/tools/git-sync.js

@@ -10,7 +10,7 @@ export function createGitSyncTool(git) {
     properties: {
       projectPath: { 
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: { 
         type: "string", 
@@ -32,7 +32,11 @@ export function createGitSyncTool(git) {
     additionalProperties: false
   };
 
-  const description = `Sincronização com repositórios remotos (GitHub/Gitea).
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Sincronização com repositórios remotos (GitHub/Gitea).
 
 DIFERENÇA FETCH vs PULL:
 - fetch: Seguro - apenas baixa, não modifica working directory
@@ -125,5 +129,11 @@ NOTA: Se pull falhar com conflito, resolva manualmente e faça commit.`;
     }
   }
 
-  return { name: "git-sync", description, inputSchema, handle };
+  return { 
+    name: "git-sync", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }

package/src/tools/git-tags.js

@@ -10,7 +10,7 @@ export function createGitTagsTool(git) {
     properties: {
       projectPath: { 
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: { 
         type: "string", 
@@ -38,7 +38,11 @@ export function createGitTagsTool(git) {
     additionalProperties: false
   };
 
-  const description = `Gerenciamento de tags Git para versionamento.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Gerenciamento de tags Git para versionamento.
 
 AÇÕES DISPONÍVEIS:
 - list: Ver todas as tags existentes
@@ -109,5 +113,11 @@ FLUXO TÍPICO:
     }
   }
 
-  return { name: "git-tags", description, inputSchema, handle };
+  return { 
+    name: "git-tags", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }