gitlab-auto-reviewers 2.0.0

package/dist/services/team-members.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-members.service.js","sourceRoot":"","sources":["../../src/services/team-members.service.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;;;;;;;;;OAWG;IACH,sBAAsB,CACpB,WAAwB,EACxB,YAA2B,EAC3B,QAAgC;QAEhC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAoB,EAAE;YAC7D,MAAM,YAAY,GAA0B,OAAO,CAAC,GAAG,CAAC,CAAC,QAAgB,EAAuB,EAAE;gBAChG,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;gBACtE,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBACpD,CAAC;gBAED,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBACjE,MAAM,WAAW,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;gBACvC,MAAM,KAAK,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;gBAEhE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;YACnE,CAAC,CAAC,CAAC;YAEH,MAAM,aAAa,GAAG,YAAY;iBAC/B,IAAI,CAAC,CAAC,CAAsB,EAAE,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;iBAC3E,GAAG,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAE/C,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,aAAa;gBACtB,YAAY,EAAE,IAAI;gBAClB,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAsB,EAAE,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACvG,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+import { GitDataSource } from "../datasources/git-data-source.interface.js";
+import { Contributor } from "../types.js";
+/**
+ * Service for managing the whitelist of approved reviewers.
+ *
+ * Retrieves and validates the list of contributors who are eligible to be
+ * suggested as reviewers. Supports both CONTRIBUTORS file configuration and
+ * automatic discovery from project contributors.
+ */
+export declare class WhitelistService {
+    private dataSource;
+    /**
+     * Creates a new WhitelistService instance.
+     *
+     * @param dataSource - The data source for accessing GitLab data
+     */
+    constructor(dataSource: GitDataSource);
+    /**
+     * Retrieves the whitelist of approved reviewers for a project.
+     *
+     * Attempts to load contributor information from a CONTRIBUTORS file in the
+     * repository. If not found, automatically discovers contributors from the
+     * project's commit history using git commit data as the source of truth.
+     *
+     * @param project - The GitLab project identifier (ID or path)
+     * @param commitSha - The commit SHA to read the CONTRIBUTORS file from
+     * @returns Array of contributors with usernames derived from git history and team information
+     */
+    getWhitelist(project: string, commitSha: string): Promise<Contributor[]>;
+}
+//# sourceMappingURL=whitelist.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whitelist.service.d.ts","sourceRoot":"","sources":["../../src/services/whitelist.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAQ,MAAM,aAAa,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAMf,OAAO,CAAC,UAAU;IAL9B;;;;OAIG;gBACiB,UAAU,EAAE,aAAa;IAE7C;;;;;;;;;;OAUG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAyC/E"}

package/dist/services/whitelist.service.js

@@ -0,0 +1,51 @@
+/**
+ * Service for managing the whitelist of approved reviewers.
+ *
+ * Retrieves and validates the list of contributors who are eligible to be
+ * suggested as reviewers. Supports both CONTRIBUTORS file configuration and
+ * automatic discovery from project contributors.
+ */
+export class WhitelistService {
+    dataSource;
+    /**
+     * Creates a new WhitelistService instance.
+     *
+     * @param dataSource - The data source for accessing GitLab data
+     */
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    /**
+     * Retrieves the whitelist of approved reviewers for a project.
+     *
+     * Attempts to load contributor information from a CONTRIBUTORS file in the
+     * repository. If not found, automatically discovers contributors from the
+     * project's commit history using git commit data as the source of truth.
+     *
+     * @param project - The GitLab project identifier (ID or path)
+     * @param commitSha - The commit SHA to read the CONTRIBUTORS file from
+     * @returns Array of contributors with usernames derived from git history and team information
+     */
+    async getWhitelist(project, commitSha) {
+        const projectContributors = (await this.dataSource.getProjectContributors(project, commitSha)).map((email) => email.toLowerCase());
+        const data = await this.dataSource.getJsonFile(project, commitSha, "CONTRIBUTORS");
+        const whitelist = data?.contributors;
+        if (!whitelist) {
+            // Auto-discovery mode: derive usernames from email addresses
+            return projectContributors.map((email) => ({
+                username: email.replace(/@.*/g, ""),
+                email,
+            }));
+        }
+        // CONTRIBUTORS file mode: use configured data
+        return whitelist
+            .filter((contributor) => projectContributors.includes(contributor.email.toLowerCase()))
+            .map((contributor) => ({
+            username: contributor.username?.toLowerCase() || contributor.email.replace(/@.*/g, ""),
+            email: contributor.email.toLowerCase(),
+            teams: contributor.teams,
+            fte: contributor.fte,
+        }));
+    }
+}
+//# sourceMappingURL=whitelist.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whitelist.service.js","sourceRoot":"","sources":["../../src/services/whitelist.service.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAMP;IALpB;;;;OAIG;IACH,YAAoB,UAAyB;QAAzB,eAAU,GAAV,UAAU,CAAe;IAAG,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,SAAiB;QACnD,MAAM,mBAAmB,GAAG,CAC1B,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,CACjE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAWtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAC5C,OAAO,EACP,SAAS,EACT,cAAc,CACf,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,EAAE,YAAY,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,6DAA6D;YAC7D,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACzC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,KAAK;aACN,CAAC,CAAC,CAAC;QACN,CAAC;QAED,8CAA8C;QAC9C,OAAO,SAAS;aACb,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CACtB,mBAAmB,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAC9D;aACA,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACrB,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACtF,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE;YACtC,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,GAAG,EAAE,WAAW,CAAC,GAAG;SACrB,CAAC,CAAC,CAAC;IACR,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP Tool Definitions
+ *
+ * This module defines all tools exposed by the Auto Reviewers MCP Server.
+ * Each tool follows the Model Context Protocol specification and includes
+ * detailed input schemas for validation.
+ *
+ * @module tools
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Array of all tools exposed by the MCP server
+ *
+ * Tools:
+ * - suggest_reviewers: Suggest reviewers based on multiple factors
+ * - get_contributor_analysis: Analyze file contributors
+ * - get_reviewer_workload: Analyze reviewer workload
+ * - post_comment: Post a comment to a merge request
+ * - invite_reviewers: Suggest and invite reviewers
+ */
+export declare const TOOLS: Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,EAAE,IAAI,EAuKvB,CAAC"}

package/dist/tools.js

@@ -0,0 +1,176 @@
+/**
+ * MCP Tool Definitions
+ *
+ * This module defines all tools exposed by the Auto Reviewers MCP Server.
+ * Each tool follows the Model Context Protocol specification and includes
+ * detailed input schemas for validation.
+ *
+ * @module tools
+ */
+/**
+ * Array of all tools exposed by the MCP server
+ *
+ * Tools:
+ * - suggest_reviewers: Suggest reviewers based on multiple factors
+ * - get_contributor_analysis: Analyze file contributors
+ * - get_reviewer_workload: Analyze reviewer workload
+ * - post_comment: Post a comment to a merge request
+ * - invite_reviewers: Suggest and invite reviewers
+ */
+export const TOOLS = [
+    {
+        name: "suggest_reviewers",
+        description: "Automatically suggest reviewers for a GitLab merge request based on contributors, team members, and code owners",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: ["string", "number"],
+                    description: "GitLab project ID (e.g., 12345) or project path (e.g., 'group/project-name')",
+                },
+                mergeRequestIid: {
+                    type: "number",
+                    description: "Merge request internal ID (optional if branch provided)",
+                },
+                branch: {
+                    type: "string",
+                    description: "Branch name (optional, uses current branch if not provided)",
+                },
+                gitlabToken: {
+                    type: "string",
+                    description: "GitLab API token (optional, uses environment variable if not provided)",
+                },
+                gitlabUrl: {
+                    type: "string",
+                    description: "GitLab instance URL (optional, defaults to gitlab.com)",
+                },
+                repoPath: {
+                    type: "string",
+                    description: "Local repository path (optional, uses API if not provided)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "get_contributor_analysis",
+        description: "Get detailed contributor analysis for changed files in a merge request",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: ["string", "number"],
+                    description: "GitLab project ID (e.g., 12345) or project path (e.g., 'group/project-name')",
+                },
+                mergeRequestIid: {
+                    type: "number",
+                    description: "Merge request internal ID",
+                },
+                gitlabToken: {
+                    type: "string",
+                    description: "GitLab API token (optional)",
+                },
+                gitlabUrl: {
+                    type: "string",
+                    description: "GitLab instance URL (optional)",
+                },
+            },
+            required: ["project", "mergeRequestIid"],
+        },
+    },
+    {
+        name: "get_reviewer_workload",
+        description: "Get current workload analysis for potential reviewers",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: ["string", "number"],
+                    description: "GitLab project ID (e.g., 12345) or project path (e.g., 'group/project-name')",
+                },
+                gitlabToken: {
+                    type: "string",
+                    description: "GitLab API token (optional)",
+                },
+                gitlabUrl: {
+                    type: "string",
+                    description: "GitLab instance URL (optional)",
+                },
+            },
+            required: ["project"],
+        },
+    },
+    {
+        name: "post_comment",
+        description: "Post a comment to a GitLab merge request",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: ["string", "number"],
+                    description: "GitLab project ID or path (optional in local git mode)",
+                },
+                mergeRequestIid: {
+                    type: "number",
+                    description: "Merge request internal ID (optional if branch provided)",
+                },
+                branch: {
+                    type: "string",
+                    description: "Branch name (optional)",
+                },
+                comment: {
+                    type: "string",
+                    description: "Comment text to post",
+                },
+                gitlabToken: {
+                    type: "string",
+                    description: "GitLab API token (optional)",
+                },
+                gitlabUrl: {
+                    type: "string",
+                    description: "GitLab instance URL (optional)",
+                },
+                repoPath: {
+                    type: "string",
+                    description: "Local repository path (optional)",
+                },
+            },
+            required: ["comment"],
+        },
+    },
+    {
+        name: "invite_reviewers",
+        description: "Suggest reviewers, post comment, and invite them to a GitLab merge request",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: ["string", "number"],
+                    description: "GitLab project ID or path (optional in local git mode)",
+                },
+                mergeRequestIid: {
+                    type: "number",
+                    description: "Merge request internal ID (optional if branch provided)",
+                },
+                branch: {
+                    type: "string",
+                    description: "Branch name (optional)",
+                },
+                gitlabToken: {
+                    type: "string",
+                    description: "GitLab API token (optional)",
+                },
+                gitlabUrl: {
+                    type: "string",
+                    description: "GitLab instance URL (optional)",
+                },
+                repoPath: {
+                    type: "string",
+                    description: "Local repository path (optional)",
+                },
+            },
+            required: [],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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