gitlab-auto-reviewers 2.0.0

package/dist/services/comment-builder.service.js

@@ -0,0 +1,61 @@
+/**
+ * Service for building formatted reviewer assignment comments for GitLab merge requests.
+ *
+ * Generates markdown-formatted comments that include reviewer suggestions with
+ * file links, load balancing information, and GitLab quick actions for assigning reviewers.
+ */
+export class CommentBuilderService {
+    gitlabUrl;
+    /**
+     * Creates a new CommentBuilderService instance.
+     *
+     * @param gitlabUrl - The base URL of the GitLab instance (e.g., 'https://gitlab.com')
+     */
+    constructor(gitlabUrl) {
+        this.gitlabUrl = gitlabUrl;
+    }
+    buildReviewerAssignmentComment({ projectId, base, contributors, teamMembers, codeOwners, }) {
+        const sections = [
+            ...contributors
+                .filter(({ username }) => username)
+                .map(({ username, changes }) => `Hi @${username},\n\nAs a previous contributor, could you review the following files since your last change.\n${changes
+                .map(({ path, fragments }) => `- [ ] ${path}#${fragments
+                ?.map((fragment) => `[${fragment}](${this.gitlabUrl}/${projectId}/-/blame/${base}/${path}#${fragment})`)
+                .join(", ") || ""}`)
+                .join("\n")}\n\n/assign_reviewer @${username}\n\n`),
+            ...teamMembers.map(({ team, members, loadBalanced, memberScores }) => {
+                const membersWithScores = loadBalanced && memberScores
+                    ? memberScores
+                        .map((m) => {
+                        const score = Math.round(m.ratio);
+                        const suffix = m.fte === 1 ? "" : `(${m.score}:${m.fte})`;
+                        return `@${m.username}<sup>${score}${suffix}</sup>`;
+                    })
+                        .join(", ")
+                    : members.map((member) => `@${member}`).join(", ");
+                const assignedMember = loadBalanced && memberScores
+                    ? memberScores[0].username
+                    : members[0];
+                return `Hi ${membersWithScores},\n\nAs a member of ~"Team::${team}", could you review and approve?\n\n/assign_reviewer @${assignedMember}\n\n`;
+            }),
+            ...codeOwners
+                .filter(({ owners }) => owners && owners.length > 0)
+                .map(({ sectionName, files, owners, loadBalanced, allOwners, ownerScores, }) => {
+                const allOwnersWithScores = loadBalanced && ownerScores && allOwners
+                    ? ownerScores
+                        .map((o) => {
+                        const score = Math.round(o.ratio);
+                        const suffix = o.fte === 1 ? "" : `(${o.assignedMRs}:${o.fte})`;
+                        return `@${o.username}<sup>${score}${suffix}</sup>`;
+                    })
+                        .join(", ")
+                    : (allOwners || owners)
+                        .map((owner) => `@${owner}`)
+                        .join(", ");
+                return `Hi ${allOwnersWithScores},\n\n${sectionName === "Global" ? "As code owner(s)" : `As [${sectionName}] code owner(s)`}, please review and approve. The following file(s) may require more of your attention.\n${files.map((file) => `- [ ] [${file}](${this.gitlabUrl}/${projectId}/-/blame/${base}/${file})`).join("\n")}\n\n/assign_reviewer ${owners.map((owner) => `@${owner}`).join(", ")}\n\n`;
+            }),
+        ];
+        return sections.join("---\n");
+    }
+}
+//# sourceMappingURL=comment-builder.service.js.map

package/dist/services/comment-builder.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-builder.service.js","sourceRoot":"","sources":["../../src/services/comment-builder.service.ts"],"names":[],"mappings":"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"}

package/dist/services/contributors.service.d.ts

@@ -0,0 +1,52 @@
+import { GitDataSource } from "../datasources/git-data-source.interface.js";
+import { Contributor } from "../types.js";
+/**
+ * Represents a change to a specific file by a contributor.
+ *
+ * @property path - The file path that was modified
+ * @property fragments - Array of line ranges (e.g., 'L10-L20') that were changed
+ */
+export interface ContributorChange {
+    path: string;
+    fragments: string[];
+}
+/**
+ * Extends Contributor with information about their specific changes in a merge request.
+ *
+ * @property changes - Array of file changes made by this contributor
+ */
+export interface ContributorWithChanges extends Contributor {
+    changes: ContributorChange[];
+}
+/**
+ * Service for analyzing merge request contributors based on git blame data.
+ *
+ * Identifies previous contributors to modified code by analyzing git blame
+ * information and matching it against a whitelist of known contributors.
+ * Provides detailed information about which lines each contributor previously authored.
+ */
+export declare class ContributorsService {
+    private dataSource;
+    /**
+     * Creates a new ContributorsService instance.
+     *
+     * @param dataSource - The data source for accessing GitLab and git data
+     */
+    constructor(dataSource: GitDataSource);
+    /**
+     * Analyzes merge request diffs to identify previous contributors to modified code.
+     *
+     * Uses git blame to determine who previously authored the lines being removed
+     * in the merge request, then matches those authors against the whitelist.
+     * Returns contributors with detailed information about which files and line
+     * ranges they previously modified.
+     *
+     * @param project - The GitLab project identifier (ID or path)
+     * @param mr - The merge request IID
+     * @param base - The base commit SHA to blame against
+     * @param whitelist - Array of known contributors to match against
+     * @returns Array of contributors with their specific changes in this MR
+     */
+    getContributors(project: string, mr: number, base: string, whitelist: Contributor[]): Promise<ContributorWithChanges[]>;
+}
+//# sourceMappingURL=contributors.service.d.ts.map

package/dist/services/contributors.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributors.service.d.ts","sourceRoot":"","sources":["../../src/services/contributors.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAQD;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAMlB,OAAO,CAAC,UAAU;IAL9B;;;;OAIG;gBACiB,UAAU,EAAE,aAAa;IAE7C;;;;;;;;;;;;;OAaG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,WAAW,EAAE,GACvB,OAAO,CAAC,sBAAsB,EAAE,CAAC;CAoJrC"}

package/dist/services/contributors.service.js

@@ -0,0 +1,144 @@
+/**
+ * Service for analyzing merge request contributors based on git blame data.
+ *
+ * Identifies previous contributors to modified code by analyzing git blame
+ * information and matching it against a whitelist of known contributors.
+ * Provides detailed information about which lines each contributor previously authored.
+ */
+export class ContributorsService {
+    dataSource;
+    /**
+     * Creates a new ContributorsService instance.
+     *
+     * @param dataSource - The data source for accessing GitLab and git data
+     */
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    /**
+     * Analyzes merge request diffs to identify previous contributors to modified code.
+     *
+     * Uses git blame to determine who previously authored the lines being removed
+     * in the merge request, then matches those authors against the whitelist.
+     * Returns contributors with detailed information about which files and line
+     * ranges they previously modified.
+     *
+     * @param project - The GitLab project identifier (ID or path)
+     * @param mr - The merge request IID
+     * @param base - The base commit SHA to blame against
+     * @param whitelist - Array of known contributors to match against
+     * @returns Array of contributors with their specific changes in this MR
+     */
+    async getContributors(project, mr, base, whitelist) {
+        const diffs = await this.dataSource.getDiffs(project, mr);
+        console.error(`[Contributors] Processing ${diffs.length} diffs`);
+        const nested = await Promise.all(diffs.map(async ({ old_path: path, diff }) => {
+            if (!diff) {
+                console.error(`[Contributors] No diff for ${path}`);
+                return [];
+            }
+            const blame = await this.dataSource.getBlame(project, path, base);
+            if (!blame) {
+                return [];
+            }
+            const blameLines = blame.reduce((result, { commit: { author_email }, lines }) => {
+                const contributor = whitelist.find((c) => c.email === author_email?.toLowerCase());
+                lines.forEach(() => result.push(contributor));
+                return result;
+            }, []);
+            console.error(`[Contributors] ${path}: ${blameLines.filter((c) => c).length}/${blameLines.length} lines matched whitelist`);
+            const linesRemoved = {};
+            const diffLines = diff
+                .split("\n")
+                .filter((line) => !line.startsWith("+"));
+            let diffIndex = 0;
+            let fragmentStart = null;
+            let lastContributor = undefined;
+            do {
+                const diffLineContent = diffLines[diffIndex];
+                if (!diffLineContent ||
+                    diffLineContent === "\") {
+                    break;
+                }
+                if (!diffLineContent.startsWith("@@")) {
+                    console.error("Unexpected line", diffLineContent);
+                    break;
+                }
+                const [token] = diffLineContent.split("@@").slice(1, 2);
+                const [subToken] = token.split(" ").slice(1, 2);
+                const [startText, linesText] = subToken.replace("-", "").split(",");
+                const start = parseInt(startText);
+                const lines = linesText ? parseInt(linesText) : 1;
+                for (let i = 0; i < lines; i++) {
+                    diffIndex++;
+                    const blameIndex = start - 1 + i;
+                    const contributor = blameLines[blameIndex];
+                    if (diffLines[diffIndex]?.startsWith("-")) {
+                        if (contributor !== lastContributor) {
+                            if (lastContributor && lastContributor.email) {
+                                const fragmentEnd = blameIndex;
+                                const fragments = linesRemoved[lastContributor.email]?.fragments || [];
+                                fragments.push(fragmentEnd > (fragmentStart || 0)
+                                    ? `L${fragmentStart}-${fragmentEnd}`
+                                    : `L${fragmentStart}`);
+                                linesRemoved[lastContributor.email] = {
+                                    path,
+                                    fragments,
+                                    by: lastContributor,
+                                };
+                            }
+                            fragmentStart = blameIndex + 1;
+                            lastContributor = contributor;
+                        }
+                    }
+                    else if (lastContributor && lastContributor.email) {
+                        const fragmentEnd = blameIndex;
+                        const fragments = linesRemoved[lastContributor.email]?.fragments || [];
+                        fragments.push(fragmentEnd > (fragmentStart || 0)
+                            ? `L${fragmentStart}-${fragmentEnd}`
+                            : `L${fragmentStart}`);
+                        linesRemoved[lastContributor.email] = {
+                            path,
+                            fragments,
+                            by: lastContributor,
+                        };
+                        fragmentStart = null;
+                        lastContributor = undefined;
+                    }
+                }
+                diffIndex++;
+            } while (true);
+            if (lastContributor && lastContributor.email) {
+                const fragmentEnd = diffIndex - 1;
+                const fragments = linesRemoved[lastContributor.email]?.fragments || [];
+                fragments.push(fragmentEnd > (fragmentStart || 0)
+                    ? `L${fragmentStart}-${fragmentEnd}`
+                    : `L${fragmentStart}`);
+                linesRemoved[lastContributor.email] = {
+                    path,
+                    fragments,
+                    by: lastContributor,
+                };
+            }
+            const removed = Object.values(linesRemoved);
+            console.error(`[Contributors] ${path}: ${removed.length} contributors with removed lines`);
+            return removed;
+        }));
+        const mapping = nested
+            .flat()
+            .reduce((result, { path, fragments, by: contributor }) => {
+            if (!contributor.email)
+                return result;
+            const contribution = result[contributor.email] || {
+                ...contributor,
+                changes: [],
+            };
+            contribution.changes.push({ path, fragments });
+            return { ...result, [contributor.email]: contribution };
+        }, {});
+        const result = Object.values(mapping);
+        console.error(`[Contributors] Found ${result.length} contributors`);
+        return result;
+    }
+}
+//# sourceMappingURL=contributors.service.js.map

package/dist/services/contributors.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributors.service.js","sourceRoot":"","sources":["../../src/services/contributors.service.ts"],"names":[],"mappings":"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"}

package/dist/services/reviewer-service.d.ts

@@ -0,0 +1,125 @@
+import { AutoReviewerParams, AutoReviewerResult, ContributorAnalysisParams, WorkloadAnalysisParams, PostCommentParams, InviteReviewersParams, Contributor } from "../types.js";
+import { Logger } from "../logging/logger.service.js";
+import { CacheService } from "../cache/cache.service.js";
+/**
+ * Main service for suggesting and managing merge request reviewers.
+ *
+ * Orchestrates multiple analysis strategies to suggest appropriate reviewers:
+ * - Previous contributors based on git blame analysis
+ * - Team members with FTE-aware load balancing
+ * - Code owners with approval requirements and load balancing
+ *
+ * Provides transparency into reviewer selection with detailed scoring and reasoning.
+ */
+export declare class ReviewerService {
+    private dataSource;
+    private contributorsService;
+    private whitelistService;
+    private blacklistService;
+    private codeOwnersService;
+    private teamMembersService;
+    private commentBuilderService;
+    private logger;
+    private cache?;
+    /**
+     * Creates a new ReviewerService instance.
+     *
+     * @param gitlabUrl - The base URL of the GitLab instance (e.g., 'https://gitlab.com')
+     * @param token - GitLab personal access token or API token
+     * @param repoPath - Optional local repository path for git operations (enables local mode)
+     * @param logger - Optional logger instance for structured logging
+     * @param cache - Optional cache service for performance optimization
+     */
+    constructor(gitlabUrl: string, token: string, repoPath?: string, logger?: Logger, cache?: CacheService);
+    /**
+     * Suggests reviewers for a merge request using multiple analysis strategies.
+     *
+     * Analyzes the merge request to suggest appropriate reviewers based on:
+     * - Previous contributors to modified code (git blame analysis)
+     * - Team membership with FTE-aware load balancing
+     * - Code ownership rules with approval requirements
+     *
+     * Returns a formatted comment for posting to GitLab and detailed reviewer
+     * suggestions with transparency information (scores, reasoning, workload).
+     *
+     * @param params - Parameters including project, MR IID, or branch information
+     * @returns Reviewer suggestions with formatted comment and detailed analysis
+     * @throws Error if project/MR cannot be resolved or required data is unavailable
+     */
+    suggestReviewers(params: AutoReviewerParams): Promise<AutoReviewerResult>;
+    /**
+     * Analyzes contributors for a merge request without suggesting reviewers.
+     *
+     * Provides detailed contributor analysis including which files were changed
+     * and which previous contributors modified those files. Useful for
+     * understanding contribution patterns without generating reviewer suggestions.
+     *
+     * @param params - Parameters including project and merge request IID
+     * @returns Changed files and contributors with their modification details
+     * @throws Error if merge request is not found or has no diffs
+     */
+    getContributorAnalysis(params: ContributorAnalysisParams): Promise<{
+        changedFiles: (string | null)[];
+        contributors: Contributor[];
+    }>;
+    /**
+     * Analyzes current reviewer workload across all open merge requests.
+     *
+     * Calculates how many open merge requests each reviewer is currently
+     * assigned to, useful for understanding team capacity and load distribution.
+     *
+     * @param params - Parameters including project identifier
+     * @returns Array of reviewers with their current open MR counts
+     */
+    getReviewerWorkload(params: WorkloadAnalysisParams): Promise<{
+        reviewers: Array<{
+            username: string;
+            openMRs: number;
+        }>;
+    }>;
+    /**
+     * Posts a comment to a GitLab merge request.
+     *
+     * @param params - Parameters including project, MR IID or branch, and comment text
+     * @returns The created note with ID and body
+     * @throws Error if project/MR cannot be resolved
+     */
+    postComment(params: PostCommentParams): Promise<{
+        id: number;
+        body: string;
+    }>;
+    /**
+     * Suggests reviewers and posts the suggestion comment to the merge request.
+     *
+     * Combines suggestReviewers() and postComment() into a single operation.
+     *
+     * @param params - Parameters including project, MR IID or branch
+     * @returns Reviewer suggestions with formatted comment (same as suggestReviewers)
+     * @throws Error if project/MR cannot be resolved or comment posting fails
+     */
+    inviteReviewers(params: InviteReviewersParams): Promise<AutoReviewerResult>;
+    /**
+     * Helper method to fetch data with optional caching
+     * If cache is not available, directly executes the operation
+     */
+    private fetchWithCache;
+    /**
+     * Extract result from Promise.allSettled with partial failure handling
+     * If the promise failed and a fallback is provided, returns the fallback
+     * If the promise failed and no fallback is provided, throws the error
+     */
+    private extractResult;
+    /**
+     * Build a detailed contributor suggestion with transparency information
+     */
+    private buildContributorSuggestion;
+    /**
+     * Build a detailed team member suggestion with transparency information
+     */
+    private buildTeamMemberSuggestion;
+    /**
+     * Build a detailed code owner suggestion with transparency information
+     */
+    private buildCodeOwnerSuggestion;
+}
+//# sourceMappingURL=reviewer-service.d.ts.map

package/dist/services/reviewer-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer-service.d.ts","sourceRoot":"","sources":["../../src/services/reviewer-service.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EAEZ,MAAM,aAAa,CAAC;AAQrB,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAC,CAAe;IAE7B;;;;;;;;OAQG;gBAED,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,YAAY;IAkBtB;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CACpB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAsM9B;;;;;;;;;;OAUG;IACG,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC;QACvE,YAAY,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QAChC,YAAY,EAAE,WAAW,EAAE,CAAC;KAC7B,CAAC;IAuDF;;;;;;;;OAQG;IACG,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC;QACjE,SAAS,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzD,CAAC;IAqCF;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAkDnF;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBjF;;;OAGG;YACW,cAAc;IAW5B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4DlC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmEjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAmEjC"}