feat(git): add getFileCommitHistory method to retrieve commit history for specific files

lucavb · lucavb · commit 02e89dff2da9 · 2025-08-21T08:52:14.000+02:00
- Implemented a new method in GitService to fetch the last N commit messages for a specified file, enhancing the ability to analyze commit patterns.
- Added corresponding tool in GitToolsService to facilitate retrieval of commit history with error handling for improved user experience.
diff --git a/src/services/git-tools.service.ts b/src/services/git-tools.service.ts
@@ -274,6 +274,34 @@ export class GitToolsService {
                     }
                 },
             }),
+
+            getFileCommitHistory: tool({
+                description: 'Get the last N commit messages that affected a specific file to understand commit patterns and context.',
+                inputSchema: z.object({
+                    filePath: z.string().describe('Path to the file to get commit history for (relative to git root)'),
+                    count: z.number().optional().describe('Number of recent commits to retrieve (default: 10)'),
+                }),
+                execute: async ({ filePath, count = 10 }) => {
+                    onToolCall(`Getting commit history for file: ${filePath}`);
+
+                    try {
+                        const commits = await this.gitService.getFileCommitHistory(filePath, count);
+                        
+                        return {
+                            success: true,
+                            filePath,
+                            commits,
+                            count: commits.length,
+                        };
+                    } catch (error) {
+                        return {
+                            success: false,
+                            error: `Error getting commit history for file: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                            filePath,
+                        };
+                    }
+                },
+            }),
         } as const;
     }
 }
diff --git a/src/services/git.service.ts b/src/services/git.service.ts
@@ -136,6 +136,20 @@ export class GitService {
         }
     }
 
+    async getFileCommitHistory(filePath: string, count: number): Promise<Array<{ hash: string; message: string; author: string; date: string }>> {
+        try {
+            const log = await this.git.log({ maxCount: count, file: filePath });
+            return log.all.map((commit) => ({
+                hash: commit.hash.substring(0, 7),
+                message: commit.message,
+                author: commit.author_name || 'Unknown',
+                date: commit.date,
+            }));
+        } catch {
+            throw new KnownError(`Failed to get commit history for file: ${filePath}`);
+        }
+    }
+
     async getStatus(): Promise<string> {
         try {
             const status = await this.git.status();
