gitlab-auto-reviewers 2.0.0

package/dist/datasources/gitlab-api-data-source.js

@@ -0,0 +1,248 @@
+import { Logger } from '../logging/logger.service.js';
+import { ErrorHandler } from '../errors/error-handler.js';
+/**
+ * GitLab API data source implementation
+ *
+ * Provides access to GitLab data through the GitLab REST API.
+ * Implements the GitDataSource interface with API-based operations.
+ */
+export class GitLabAPIDataSource {
+    logger;
+    gitlabApi;
+    /**
+     * Create a new GitLab API data source
+     *
+     * @param gitlabApi - GitLab API client instance
+     * @param logger - Optional logger instance for logging operations
+     */
+    constructor(gitlabApi, logger) {
+        this.logger = logger || new Logger('GitLabAPIDataSource');
+        this.gitlabApi = gitlabApi;
+    }
+    /**
+     * Find an open merge request by branch name
+     *
+     * @param project - The project ID or path
+     * @param branch - The source branch name to search for
+     * @returns Promise resolving to the merge request
+     * @throws {MCPError} If no open MR is found for the branch
+     */
+    async findMergeRequestByBranch(project, branch) {
+        const context = { project, branch, dataSource: 'GitLabAPI' };
+        try {
+            const mrs = await this.gitlabApi.getMergeRequests(project, "opened");
+            const mr = mrs.find((m) => m.source_branch === branch);
+            if (!mr) {
+                const available = mrs
+                    .map((m) => m.source_branch)
+                    .slice(0, 10)
+                    .join(", ");
+                throw ErrorHandler.notFoundError(`No open MR found for branch: ${branch}. Found ${mrs.length} open MRs with branches: ${available}`, context);
+            }
+            return mr;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('MCP')) {
+                throw error;
+            }
+            throw ErrorHandler.apiCallError('Failed to find merge request by branch', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get the default branch for a project
+     *
+     * @param project - The project ID or path
+     * @returns Promise resolving to the default branch name
+     */
+    async getDefaultBranch(project) {
+        const context = { project, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.getDefaultBranch(project);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get default branch', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get a specific merge request by IID
+     *
+     * @param project - The project ID or path
+     * @param mr - The merge request internal ID
+     * @returns Promise resolving to the merge request or null if not found
+     */
+    async getMergeRequest(project, mr) {
+        const context = { project, mr, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.getMergeRequest(project, mr);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get merge request', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get a merge request by its source branch name
+     *
+     * @param project - The project ID or path
+     * @param branch - The source branch name
+     * @returns Promise resolving to the merge request or null if not found
+     */
+    async getMergeRequestByBranch(project, branch) {
+        return this.findMergeRequestByBranch(project, branch);
+    }
+    /**
+     * Get all diffs for a merge request
+     *
+     * Note: For very large merge requests (100+ changed files), GitLab API may return
+     * limited or truncated data due to API constraints. Consider using LocalGitDataSource
+     * for complete analysis of large merge requests.
+     *
+     * @param project - The project ID or path
+     * @param mr - The merge request internal ID
+     * @returns Promise resolving to array of diffs (may be limited for large MRs)
+     */
+    async getDiffs(project, mr) {
+        const context = { project, mr, dataSource: 'GitLabAPI' };
+        try {
+            const diffs = await this.gitlabApi.getDiffs(project, mr);
+            // Log info about data retrieval for large MRs
+            if (diffs.length >= 100) {
+                this.logger.info('Large merge request processed', {
+                    project,
+                    mr,
+                    diffCount: diffs.length,
+                    note: 'API may have returned limited data. For complete analysis, use LocalGitDataSource.',
+                });
+            }
+            return diffs;
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get diffs', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get git blame information for a file
+     *
+     * @param project - The project ID or path
+     * @param path - The file path within the repository
+     * @param ref - The branch, tag, or commit SHA
+     * @returns Promise resolving to array of blame lines or null if file not found
+     */
+    async getBlame(project, path, ref) {
+        const context = { project, path, ref, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.getBlame(project, path, ref);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get blame', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get raw file content from repository
+     *
+     * @param project - The project ID or path
+     * @param commitSha - The commit SHA
+     * @param path - The file path within the repository
+     * @returns Promise resolving to file content or null if not found
+     */
+    async getRawFile(project, commitSha, path) {
+        const context = { project, commitSha, path, dataSource: 'GitLabAPI' };
+        try {
+            // GitLab API accepts both branch names and commit SHAs in ref parameter
+            return await this.gitlabApi.getRawFile(project, commitSha, path);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get raw file', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get and parse a JSON file from repository
+     *
+     * @param project - The project ID or path
+     * @param commitSha - The commit SHA
+     * @param path - The file path within the repository
+     * @returns Promise resolving to parsed JSON object or null if not found
+     * @throws {MCPError} If the file cannot be parsed as JSON
+     */
+    async getJsonFile(project, commitSha, path) {
+        const context = { project, commitSha, path, dataSource: 'GitLabAPI' };
+        try {
+            const content = await this.getRawFile(project, commitSha, path);
+            if (!content)
+                return null;
+            return typeof content === "string" ? JSON.parse(content) : content;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('MCP')) {
+                throw error;
+            }
+            throw ErrorHandler.validationError(`Failed to parse JSON file: ${path}`, context);
+        }
+    }
+    /**
+     * Get all merge requests for a project
+     *
+     * @param project - The project ID or path
+     * @param state - The merge request state to filter by (default: "opened")
+     * @returns Promise resolving to array of merge requests
+     */
+    async getMergeRequests(project, state = "opened") {
+        const context = { project, state, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.getMergeRequests(project, state);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get merge requests', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get all notes (comments) for a merge request
+     *
+     * @param project - The project ID or path
+     * @param mr - The merge request internal ID
+     * @returns Promise resolving to array of notes
+     */
+    async getNotes(project, mr) {
+        const context = { project, mr, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.getNotes(project, mr);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get notes', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get project contributors by analyzing commit history
+     *
+     * @param project - The project ID or path
+     * @param commitSha - The commit SHA to analyze history from
+     * @returns Promise resolving to array of contributor email addresses
+     */
+    async getProjectContributors(project, commitSha) {
+        const context = { project, commitSha, dataSource: 'GitLabAPI' };
+        try {
+            // GitLab API accepts both branch names and commit SHAs
+            return await this.gitlabApi.getProjectContributors(project, commitSha);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to get project contributors', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Create a note (comment) on a merge request
+     *
+     * @param project - The project ID or path
+     * @param mr - The merge request internal ID
+     * @param body - The comment text (supports Markdown)
+     * @returns Promise resolving to the created note
+     */
+    async createNote(project, mr, body) {
+        const context = { project, mr, dataSource: 'GitLabAPI' };
+        try {
+            return await this.gitlabApi.postComment(project, mr, body);
+        }
+        catch (error) {
+            throw ErrorHandler.apiCallError('Failed to create note', context, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+}
+//# sourceMappingURL=gitlab-api-data-source.js.map

package/dist/datasources/gitlab-api-data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-api-data-source.js","sourceRoot":"","sources":["../../src/datasources/gitlab-api-data-source.ts"],"names":[],"mappings":"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"}

package/dist/datasources/local-git-data-source.d.ts

@@ -0,0 +1,124 @@
+import { GitLabAPI } from "../api/gitlab-api.js";
+import { GitDataSource } from "./git-data-source.interface.js";
+import { GitLabAPIDataSource } from "./gitlab-api-data-source.js";
+import { Logger } from "../logging/logger.service.js";
+import { ConfigService } from "../config/config.service.js";
+import { BlameLine, MergeRequestDiff } from "../types/index.js";
+/**
+ * Local git repository data source implementation
+ *
+ * Provides access to git data through local git operations using simple-git.
+ * Falls back to GitLab API for operations that fail locally.
+ * Extends GitLabAPIDataSource to inherit API-based methods.
+ */
+export declare class LocalGitDataSource extends GitLabAPIDataSource implements GitDataSource {
+    private repoPath;
+    private config;
+    /**
+     * Create a new local git data source
+     *
+     * @param gitlabApi - GitLab API client instance for fallback operations
+     * @param repoPath - Path to the local git repository
+     * @param logger - Optional logger instance for logging operations
+     * @param config - Optional configuration service for settings
+     */
+    constructor(gitlabApi: GitLabAPI, repoPath: string, logger?: Logger, config?: ConfigService);
+    /**
+     * Get the project path from the git remote URL
+     *
+     * Parses the origin remote URL to extract the project path.
+     * Supports SSH, HTTPS, and git protocol URLs.
+     *
+     * @returns Promise resolving to the project path (e.g., "group/project")
+     * @throws {MCPError} If no origin remote is found or URL format is unsupported
+     */
+    getProjectFromRemote(): Promise<string>;
+    /**
+     * Get the current branch name from the local repository
+     *
+     * @returns Promise resolving to the current branch name
+     * @throws {MCPError} If repository is in detached HEAD state or branch cannot be determined
+     */
+    getCurrentBranch(): Promise<string>;
+    /**
+     * Get the default branch from local git repository
+     *
+     * Queries the remote HEAD to determine the default branch.
+     * Falls back to GitLab API if local detection fails.
+     *
+     * @param project - The project ID or path
+     * @returns Promise resolving to the default branch name
+     * @throws {MCPError} If both local and API detection fail
+     */
+    getDefaultBranch(project: string): Promise<string>;
+    /**
+     * Get project contributors from local git history
+     *
+     * Analyzes commit history using configurable date range to identify contributors.
+     * Uses retry logic for git operations.
+     *
+     * @param project - The project ID or path (used for logging)
+     * @param commitSha - The commit SHA to analyze history from
+     * @returns Promise resolving to array of contributor email addresses (up to 100)
+     */
+    getProjectContributors(project: string, commitSha: string): Promise<string[]>;
+    /**
+     * Get git blame information from local repository
+     *
+     * Validates commit existence before attempting blame.
+     * Falls back to API if local blame fails (graceful degradation).
+     *
+     * @param project - The project ID or path
+     * @param path - The file path within the repository
+     * @param ref - The commit SHA to blame
+     * @returns Promise resolving to array of blame lines (empty array if both local and API fail)
+     */
+    getBlame(project: string, path: string, ref: string): Promise<BlameLine[]>;
+    /**
+     * Validates that a commit exists in the repository (Requirement 6.1)
+     */
+    private validateCommitExists;
+    /**
+     * Get diffs for a merge request from local git repository
+     *
+     * Validates commits exist, handles special characters in paths,
+     * and fetches diffs in parallel for performance.
+     *
+     * @param project - The project ID or path
+     * @param mr - The merge request internal ID
+     * @returns Promise resolving to array of diffs
+     * @throws {MCPError} If merge request data is invalid or commits don't exist
+     */
+    getDiffs(project: string, mr: number): Promise<MergeRequestDiff[]>;
+    /**
+     * Parses git name-status output with special character handling (Requirement 6.3)
+     */
+    private parseGitNameStatus;
+    /**
+     * Gets diff for a single file with error handling
+     */
+    private getDiffForFile;
+    /**
+     * Get raw file content from local repository
+     *
+     * Tries git show first, falls back to filesystem read if that fails.
+     *
+     * @param project - The project ID or path (used for logging)
+     * @param branch - The branch name
+     * @param path - The file path within the repository
+     * @returns Promise resolving to file content or null if not found
+     * @throws {MCPError} If file is not found in git or filesystem
+     */
+    getRawFile(project: string, branch: string, path: string): Promise<string | null>;
+    /**
+     * Get and parse a JSON file from local repository
+     *
+     * @param project - The project ID or path
+     * @param branch - The branch name
+     * @param path - The file path within the repository
+     * @returns Promise resolving to parsed JSON object or null if not found
+     * @throws {MCPError} If the file cannot be parsed as JSON
+     */
+    getJsonFile<T = unknown>(project: string, branch: string, path: string): Promise<T | null>;
+}
+//# sourceMappingURL=local-git-data-source.d.ts.map

package/dist/datasources/local-git-data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-git-data-source.d.ts","sourceRoot":"","sources":["../../src/datasources/local-git-data-source.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;GAMG;AACH,qBAAa,kBACX,SAAQ,mBACR,YAAW,aAAa;IActB,OAAO,CAAC,QAAQ;IAZlB,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;;;;;OAOG;gBAED,SAAS,EAAE,SAAS,EACZ,QAAQ,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,aAAa;IAMxB;;;;;;;;OAQG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAyD7C;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAmCzC;;;;;;;;;OASG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwExD;;;;;;;;;OASG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC;IA+EpB;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyFhF;;OAEG;YACW,oBAAoB;IAkBlC;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAiHxE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;YACW,cAAc;IA2D5B;;;;;;;;;;OAUG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8CzB;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAqBrB"}