@andrebuzeli/git-mcp 15.8.3 → 15.8.5

package/src/tools/git-diff.js

@@ -1,126 +1,137 @@
-import Ajv from "ajv";
-import { asToolError, asToolResult, errorToResponse } from "../utils/errors.js";
-import { validateProjectPath } from "../utils/repoHelpers.js";
-
-const ajv = new Ajv({ allErrors: true });
-
-export function createGitDiffTool(git) {
-  const inputSchema = {
-    type: "object",
-    properties: {
-      projectPath: { 
-        type: "string",
-        description: "Caminho absoluto do diretório do projeto"
-      },
-      action: { 
-        type: "string", 
-        enum: ["show", "compare", "stat"],
-        description: `Ação a executar:
-- show: Mostra diff do working directory (arquivos não commitados)
-- compare: Compara dois commits/branches/tags
-- stat: Mostra estatísticas (arquivos alterados, linhas +/-)`
-      },
-      from: { 
-        type: "string",
-        description: "Ref inicial para comparação (commit SHA, branch, tag). Default: HEAD"
-      },
-      to: { 
-        type: "string",
-        description: "Ref final para comparação. Se não fornecido, compara com working directory"
-      },
-      file: { 
-        type: "string",
-        description: "Arquivo específico para ver diff. Se não fornecido, mostra todos"
-      },
-      context: {
-        type: "number",
-        description: "Número de linhas de contexto ao redor das mudanças. Default: 3"
-      }
-    },
-    required: ["projectPath", "action"],
-    additionalProperties: false
-  };
-
-  const description = `Ver diferenças entre commits, branches ou arquivos.
-
-QUANDO USAR:
-- Ver o que mudou antes de commitar (action='show')
-- Comparar branches antes de merge (action='compare')
-- Ver estatísticas de mudanças (action='stat')
-
-EXEMPLOS:
-- Ver mudanças não commitadas: action='show'
-- Ver mudanças de um arquivo: action='show' file='src/index.js'
-- Comparar com último commit: action='compare' from='HEAD~1'
-- Comparar branches: action='compare' from='main' to='feature/x'
-- Ver stats: action='stat' from='main' to='develop'`;
-
-  async function handle(args) {
-    const validate = ajv.compile(inputSchema);
-    if (!validate(args || {})) return asToolError("VALIDATION_ERROR", "Parâmetros inválidos", validate.errors);
-    const { projectPath, action } = args;
-    
-    try {
-      validateProjectPath(projectPath);
-      if (action === "show") {
-        const diff = await git.diff(projectPath, {
-          file: args.file,
-          context: args.context || 3
-        });
-        
-        if (!diff || diff.length === 0) {
-          return asToolResult({ 
-            changes: [], 
-            message: "Nenhuma mudança detectada no working directory" 
-          });
-        }
-        
-        return asToolResult({
-          changes: diff,
-          totalFiles: diff.length,
-          message: `${diff.length} arquivo(s) com mudanças`
-        });
-      }
-      
-      if (action === "compare") {
-        const from = args.from || "HEAD";
-        const to = args.to;
-        
-        const diff = await git.diffCommits(projectPath, from, to, {
-          file: args.file,
-          context: args.context || 3
-        });
-        
-        return asToolResult({
-          from,
-          to: to || "working directory",
-          changes: diff,
-          totalFiles: diff.length,
-          message: `Comparando ${from} com ${to || 'working directory'}: ${diff.length} arquivo(s)`
-        });
-      }
-      
-      if (action === "stat") {
-        const from = args.from || "HEAD";
-        const to = args.to;
-        
-        const stats = await git.diffStats(projectPath, from, to);
-        
-        return asToolResult({
-          from,
-          to: to || "working directory",
-          ...stats,
-          message: `${stats.filesChanged} arquivo(s), +${stats.insertions} -${stats.deletions}`
-        });
-      }
-      
-      return asToolError("VALIDATION_ERROR", `Ação '${action}' não suportada`, { 
-        availableActions: ["show", "compare", "stat"] 
-      });
-    } catch (e) {
-      return errorToResponse(e);
-    }
-  }
-
-  return { name: "git-diff", description, inputSchema, handle };
-}
+import Ajv from "ajv";
+import { asToolError, asToolResult, errorToResponse } from "../utils/errors.js";
+import { validateProjectPath } from "../utils/repoHelpers.js";
+
+const ajv = new Ajv({ allErrors: true });
+
+export function createGitDiffTool(git) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      projectPath: {
+        type: "string",
+        description: "Caminho absoluto do diretório do projeto"
+      },
+      action: {
+        type: "string",
+        enum: ["show", "compare", "stat"],
+        description: `Ação a executar:
+- show: Mostra diff do working directory (arquivos não commitados)
+- compare: Compara dois commits/branches/tags
+- stat: Mostra estatísticas (arquivos alterados, linhas +/-)`
+      },
+      from: {
+        type: "string",
+        description: "Ref inicial para comparação (commit SHA, branch, tag). Default: HEAD"
+      },
+      fromRef: {
+        type: "string",
+        description: "Alias para 'from'. Ref inicial para comparação"
+      },
+      to: {
+        type: "string",
+        description: "Ref final para comparação. Se não fornecido, compara com working directory"
+      },
+      toRef: {
+        type: "string",
+        description: "Alias para 'to'. Ref final para comparação"
+      },
+      file: {
+        type: "string",
+        description: "Arquivo específico para ver diff. Se não fornecido, mostra todos"
+      },
+      filepath: {
+        type: "string",
+        description: "Alias para 'file'. Arquivo específico para ver diff"
+      },
+      context: {
+        type: "number",
+        description: "Número de linhas de contexto ao redor das mudanças. Default: 3"
+      }
+    },
+    required: ["projectPath", "action"],
+    additionalProperties: false
+  };
+
+  const description = `Ver diferenças entre commits, branches ou arquivos.
+
+QUANDO USAR:
+- Ver o que mudou antes de commitar (action='show')
+- Comparar branches antes de merge (action='compare')
+- Ver estatísticas de mudanças (action='stat')
+
+EXEMPLOS:
+- Ver mudanças não commitadas: action='show'
+- Ver mudanças de um arquivo: action='show' file='src/index.js'
+- Comparar com último commit: action='compare' from='HEAD~1'
+- Comparar branches: action='compare' from='main' to='feature/x'
+- Ver stats: action='stat' from='main' to='develop'`;
+
+  async function handle(args) {
+    const validate = ajv.compile(inputSchema);
+    if (!validate(args || {})) return asToolError("VALIDATION_ERROR", "Parâmetros inválidos", validate.errors);
+    const { projectPath, action } = args;
+
+    // Support aliases: fromRef -> from, toRef -> to, filepath -> file
+    const fromParam = args.from || args.fromRef || "HEAD";
+    const toParam = args.to || args.toRef;
+    const fileParam = args.file || args.filepath;
+
+    try {
+      validateProjectPath(projectPath);
+      if (action === "show") {
+        const diff = await git.diff(projectPath, {
+          file: fileParam,
+          context: args.context || 3
+        });
+
+        if (!diff || diff.length === 0) {
+          return asToolResult({
+            changes: [],
+            message: "Nenhuma mudança detectada no working directory"
+          });
+        }
+
+        return asToolResult({
+          changes: diff,
+          totalFiles: diff.length,
+          message: `${diff.length} arquivo(s) com mudanças`
+        });
+      }
+
+      if (action === "compare") {
+        const diff = await git.diffCommits(projectPath, fromParam, toParam, {
+          file: fileParam,
+          context: args.context || 3
+        });
+
+        return asToolResult({
+          from: fromParam,
+          to: toParam || "working directory",
+          changes: diff,
+          totalFiles: diff.length,
+          message: `Comparando ${fromParam} com ${toParam || 'working directory'}: ${diff.length} arquivo(s)`
+        });
+      }
+
+      if (action === "stat") {
+        const stats = await git.diffStats(projectPath, fromParam, toParam);
+
+        return asToolResult({
+          from: fromParam,
+          to: toParam || "working directory",
+          ...stats,
+          message: `${stats.filesChanged} arquivo(s), +${stats.insertions} -${stats.deletions}`
+        });
+      }
+
+      return asToolError("VALIDATION_ERROR", `Ação '${action}' não suportada`, {
+        availableActions: ["show", "compare", "stat"]
+      });
+    } catch (e) {
+      return errorToResponse(e);
+    }
+  }
+
+  return { name: "git-diff", description, inputSchema, handle };
+}