gitlab-auto-reviewers 2.0.0

package/dist/logging/example.js

@@ -0,0 +1,79 @@
+/**
+ * Logger Usage Examples
+ *
+ * This file demonstrates how to use the Logger service.
+ * It is not part of the production code.
+ */
+import { Logger, LogLevel } from './logger.service.js';
+// Example 1: Basic logging
+function basicLoggingExample() {
+    const logger = new Logger('MyService', LogLevel.DEBUG);
+    logger.debug('Starting service initialization');
+    logger.info('Service initialized successfully');
+    logger.warn('Configuration value missing, using default');
+    logger.error('Failed to connect to database', new Error('Connection timeout'));
+}
+// Example 2: Logging with context
+function contextLoggingExample() {
+    const logger = new Logger('ReviewerService', LogLevel.INFO);
+    logger.info('Fetching merge request', {
+        project: 'my-project',
+        mr: 123,
+        operation: 'fetchMR',
+    });
+    logger.info('Suggesting reviewers', {
+        project: 'my-project',
+        mr: 123,
+        operation: 'suggestReviewers',
+        candidateCount: 5,
+    });
+}
+// Example 3: Performance timing
+async function performanceTimingExample() {
+    const logger = new Logger('DataService', LogLevel.DEBUG);
+    const endTimer = logger.startTimer('fetchUserData');
+    // Simulate async operation
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    endTimer(); // Logs: "fetchUserData completed" with duration
+}
+// Example 4: Child loggers
+function childLoggerExample() {
+    const parentLogger = new Logger('Application', LogLevel.INFO);
+    const serviceLogger = parentLogger.child('UserService');
+    const repoLogger = serviceLogger.child('Repository');
+    parentLogger.info('Application started'); // [Application]
+    serviceLogger.info('Service initialized'); // [Application:UserService]
+    repoLogger.info('Connected to database'); // [Application:UserService:Repository]
+}
+// Example 5: Error logging with context
+function errorLoggingExample() {
+    const logger = new Logger('GitService', LogLevel.INFO);
+    try {
+        throw new Error('Git operation failed');
+    }
+    catch (error) {
+        logger.error('Failed to fetch git data', error, {
+            operation: 'git-blame',
+            file: 'src/index.ts',
+            commit: 'abc123',
+        });
+    }
+}
+// Example 6: Log level filtering
+function logLevelFilteringExample() {
+    // Only log warnings and errors
+    const prodLogger = new Logger('Production', LogLevel.WARN);
+    prodLogger.debug('Debug message'); // Not logged
+    prodLogger.info('Info message'); // Not logged
+    prodLogger.warn('Warning message'); // Logged
+    prodLogger.error('Error message'); // Logged
+}
+// Example 7: Parsing log level from environment
+function parseLogLevelExample() {
+    const logLevelStr = process.env.LOG_LEVEL || 'info';
+    const logLevel = Logger.parseLogLevel(logLevelStr);
+    const logger = new Logger('ConfigurableService', logLevel);
+    logger.info('Logger configured with level:', { level: logLevelStr });
+}
+export { basicLoggingExample, contextLoggingExample, performanceTimingExample, childLoggerExample, errorLoggingExample, logLevelFilteringExample, parseLogLevelExample, };
+//# sourceMappingURL=example.js.map

package/dist/logging/example.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logging Module
+ *
+ * Exports Logger service for structured logging with appropriate log levels.
+ */
+export { Logger, LogLevel, type LogContext } from './logger.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * Logging Module
+ *
+ * Exports Logger service for structured logging with appropriate log levels.
+ */
+export { Logger, LogLevel } from './logger.service.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAmB,MAAM,qBAAqB,CAAC"}

package/dist/logging/logger.service.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Logger Service
+ *
+ * Structured logging with appropriate log levels and context.
+ * Provides performance timing utilities and debug mode support.
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+/**
+ * Context information for log messages
+ *
+ * @property operation - Name of the operation being performed (optional)
+ * @property project - Project identifier (optional)
+ * @property mr - Merge request number (optional)
+ * @property duration - Operation duration in milliseconds (optional)
+ */
+export interface LogContext {
+    operation?: string;
+    project?: string;
+    mr?: number;
+    duration?: number;
+    [key: string]: unknown;
+}
+/**
+ * Logger service for structured logging with context
+ *
+ * Provides methods for logging at different levels (debug, info, warn, error)
+ * with contextual information and performance timing utilities.
+ */
+export declare class Logger {
+    private readonly context;
+    private readonly minLevel;
+    /**
+     * Create a new logger instance
+     *
+     * @param context - Context name for this logger (e.g., 'GitLabAPI', 'ReviewerService')
+     * @param minLevel - Minimum log level to output (default: INFO)
+     */
+    constructor(context: string, minLevel?: LogLevel);
+    /**
+     * Log a debug message (for detailed diagnostic information)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log an info message (for normal operations)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log a warning message (for recoverable issues)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log an error message (for failures)
+     *
+     * @param message - The log message
+     * @param error - Optional error object with stack trace
+     * @param context - Optional contextual information
+     */
+    error(message: string, error?: Error, context?: LogContext): void;
+    /**
+     * Start a performance timer for an operation
+     * Returns a function that when called, logs the duration
+     */
+    startTimer(operation: string): () => void;
+    /**
+     * Internal logging method
+     */
+    private log;
+    /**
+     * Format log message for human readability
+     */
+    private formatMessage;
+    /**
+     * Create a child logger with additional context
+     *
+     * @param childContext - Additional context to append to parent context
+     * @returns New logger instance with combined context
+     */
+    child(childContext: string): Logger;
+    /**
+     * Parse log level from string
+     */
+    static parseLogLevel(level: string): LogLevel;
+}
+//# sourceMappingURL=logger.service.d.ts.map

package/dist/logging/logger.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.service.d.ts","sourceRoot":"","sources":["../../src/logging/logger.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAwB;IAK/D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAYjE;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI;IASzC;;OAEG;IACH,OAAO,CAAC,GAAG;IAiCX;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;OAKG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;CAgB9C"}

package/dist/logging/logger.service.js

@@ -0,0 +1,160 @@
+/**
+ * Logger Service
+ *
+ * Structured logging with appropriate log levels and context.
+ * Provides performance timing utilities and debug mode support.
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Logger service for structured logging with context
+ *
+ * Provides methods for logging at different levels (debug, info, warn, error)
+ * with contextual information and performance timing utilities.
+ */
+export class Logger {
+    context;
+    minLevel;
+    /**
+     * Create a new logger instance
+     *
+     * @param context - Context name for this logger (e.g., 'GitLabAPI', 'ReviewerService')
+     * @param minLevel - Minimum log level to output (default: INFO)
+     */
+    constructor(context, minLevel = LogLevel.INFO) {
+        this.context = context;
+        this.minLevel = minLevel;
+    }
+    /**
+     * Log a debug message (for detailed diagnostic information)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, message, context);
+    }
+    /**
+     * Log an info message (for normal operations)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    info(message, context) {
+        this.log(LogLevel.INFO, message, context);
+    }
+    /**
+     * Log a warning message (for recoverable issues)
+     *
+     * @param message - The log message
+     * @param context - Optional contextual information
+     */
+    warn(message, context) {
+        this.log(LogLevel.WARN, message, context);
+    }
+    /**
+     * Log an error message (for failures)
+     *
+     * @param message - The log message
+     * @param error - Optional error object with stack trace
+     * @param context - Optional contextual information
+     */
+    error(message, error, context) {
+        // Include error message in the main message if error is provided
+        const fullMessage = error ? `${message}: ${error.message}` : message;
+        const errorContext = {
+            ...context,
+            error: error?.message,
+            stack: error?.stack,
+        };
+        this.log(LogLevel.ERROR, fullMessage, errorContext);
+    }
+    /**
+     * Start a performance timer for an operation
+     * Returns a function that when called, logs the duration
+     */
+    startTimer(operation) {
+        const startTime = Date.now();
+        return () => {
+            const duration = Date.now() - startTime;
+            this.debug(`${operation} completed`, { operation, duration });
+        };
+    }
+    /**
+     * Internal logging method
+     */
+    log(level, message, context) {
+        if (level < this.minLevel) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const levelName = LogLevel[level];
+        const contextStr = this.context;
+        // Format for console output
+        const formattedMessage = this.formatMessage(timestamp, levelName, contextStr, message, context);
+        // Output to stderr (MCP servers use stderr for logging)
+        if (level === LogLevel.ERROR) {
+            console.error(formattedMessage);
+            if (context?.stack) {
+                console.error(context.stack);
+            }
+        }
+        else if (level === LogLevel.WARN) {
+            console.error(`WARN: ${formattedMessage}`);
+        }
+        else if (level === LogLevel.DEBUG) {
+            console.error(`DEBUG: ${formattedMessage}`);
+        }
+        else {
+            console.error(formattedMessage);
+        }
+    }
+    /**
+     * Format log message for human readability
+     */
+    formatMessage(timestamp, level, context, message, data) {
+        const parts = [`[${timestamp}]`, `[${level}]`, `[${context}]`, message];
+        if (data && Object.keys(data).length > 0) {
+            // Filter out stack traces from inline display
+            const { stack, error, ...displayData } = data;
+            if (Object.keys(displayData).length > 0) {
+                parts.push(JSON.stringify(displayData));
+            }
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Create a child logger with additional context
+     *
+     * @param childContext - Additional context to append to parent context
+     * @returns New logger instance with combined context
+     */
+    child(childContext) {
+        return new Logger(`${this.context}:${childContext}`, this.minLevel);
+    }
+    /**
+     * Parse log level from string
+     */
+    static parseLogLevel(level) {
+        const normalized = level.toLowerCase();
+        switch (normalized) {
+            case 'debug':
+                return LogLevel.DEBUG;
+            case 'info':
+                return LogLevel.INFO;
+            case 'warn':
+            case 'warning':
+                return LogLevel.WARN;
+            case 'error':
+                return LogLevel.ERROR;
+            default:
+                return LogLevel.INFO;
+        }
+    }
+}
+//# sourceMappingURL=logger.service.js.map

package/dist/logging/logger.service.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Auto Reviewers MCP Server
+ *
+ * A Model Context Protocol (MCP) server that provides intelligent GitLab merge request
+ * reviewer suggestions through AI assistants. The server analyzes git blame data,
+ * team member availability with FTE-aware load balancing, CODEOWNERS rules, and
+ * current reviewer workload to suggest the most appropriate reviewers.
+ *
+ * @module mcp/server
+ */
+/**
+ * Main MCP Server class that handles tool requests and manages services
+ */
+export declare class AutoReviewerMCPServer {
+    private server;
+    private reviewerServices;
+    private config;
+    private logger;
+    private cache;
+    /**
+     * Initialize the MCP server with all required services
+     */
+    constructor();
+    /**
+     * Get or create a ReviewerService instance for the given configuration
+     * Services are cached per unique combination of GitLab URL, token, and repo path
+     *
+     * @param gitlabUrl - GitLab instance URL
+     * @param token - GitLab API token
+     * @param repoPath - Optional local repository path
+     * @returns ReviewerService instance
+     */
+    private getReviewerService;
+    /**
+     * Set up MCP protocol request handlers
+     * Handles ListTools and CallTool requests
+     */
+    private setupHandlers;
+    /**
+     * Handle a tool call request
+     * Routes the request to the appropriate ReviewerService method
+     *
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @returns Tool result
+     * @throws MCPError if tool is unknown or parameters are invalid
+     */
+    private handleToolCall;
+    /**
+     * Detect the local git repository path
+     * Attempts to find the git root directory from the current working directory
+     *
+     * @returns Git repository root path, or undefined if not in a git repository
+     */
+    private detectRepoPath;
+    /**
+     * Start the MCP server
+     * Connects to stdio transport and begins listening for requests
+     */
+    run(): Promise<void>;
+    /**
+     * Gracefully shutdown the MCP server
+     * Logs cache statistics, clears cache, and closes the server connection
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAe;IAE5B;;OAEG;;IAuCH;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA0CrB;;;;;;;;OAQG;YACW,cAAc;IAoD5B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBhC"}

package/dist/mcp/server.js

@@ -0,0 +1,213 @@
+/**
+ * Auto Reviewers MCP Server
+ *
+ * A Model Context Protocol (MCP) server that provides intelligent GitLab merge request
+ * reviewer suggestions through AI assistants. The server analyzes git blame data,
+ * team member availability with FTE-aware load balancing, CODEOWNERS rules, and
+ * current reviewer workload to suggest the most appropriate reviewers.
+ *
+ * @module mcp/server
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TOOLS } from "./tools.js";
+import { ReviewerService } from "../services/reviewer-service.js";
+import { ConfigService } from "../config/config.service.js";
+import { Logger } from "../logging/logger.service.js";
+import { ErrorHandler } from "../errors/error-handler.js";
+import { CacheService } from "../cache/cache.service.js";
+/**
+ * Main MCP Server class that handles tool requests and manages services
+ */
+export class AutoReviewerMCPServer {
+    server;
+    reviewerServices;
+    config;
+    logger;
+    cache;
+    /**
+     * Initialize the MCP server with all required services
+     */
+    constructor() {
+        // Initialize configuration
+        this.config = new ConfigService();
+        // Initialize logger with configured log level
+        const logLevel = Logger.parseLogLevel(this.config.get().logLevel);
+        this.logger = new Logger('MCPServer', logLevel);
+        // Log applied defaults
+        const defaults = this.config.getAppliedDefaults();
+        if (defaults.size > 0) {
+            this.logger.info('Using default configuration values', {
+                defaults: Array.from(defaults.entries()).map((entry) => ({ key: entry[0], value: entry[1] }))
+            });
+        }
+        // Initialize cache with configured TTL
+        this.cache = new CacheService({ ttlMs: this.config.get().cacheTTL * 1000 }, this.logger.child('Cache'));
+        // Initialize MCP server
+        this.server = new Server({ name: "auto-reviewers-server", version: "1.0.0" }, { capabilities: { tools: {} } });
+        this.reviewerServices = new Map();
+        this.logger.info('MCP Server initialized', {
+            version: '1.0.0',
+            cacheTTL: this.config.get().cacheTTL,
+            logLevel: this.config.get().logLevel,
+        });
+        this.setupHandlers();
+    }
+    /**
+     * Get or create a ReviewerService instance for the given configuration
+     * Services are cached per unique combination of GitLab URL, token, and repo path
+     *
+     * @param gitlabUrl - GitLab instance URL
+     * @param token - GitLab API token
+     * @param repoPath - Optional local repository path
+     * @returns ReviewerService instance
+     */
+    getReviewerService(gitlabUrl, token, repoPath) {
+        const key = `${gitlabUrl}:${token}:${repoPath || "api"}`;
+        if (!this.reviewerServices.has(key)) {
+            const cacheEnabled = this.config.get().cacheEnabled;
+            this.reviewerServices.set(key, new ReviewerService(gitlabUrl, token, repoPath, this.logger.child('ReviewerService'), cacheEnabled ? this.cache : undefined));
+            this.logger.debug('Created new ReviewerService', {
+                gitlabUrl,
+                repoPath: repoPath || 'api-mode',
+                cacheEnabled
+            });
+        }
+        return this.reviewerServices.get(key);
+    }
+    /**
+     * Set up MCP protocol request handlers
+     * Handles ListTools and CallTool requests
+     */
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            this.logger.debug('ListTools request received');
+            return { tools: TOOLS };
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            this.logger.info(`Tool call: ${name}`, { tool: name, args });
+            const endTimer = this.logger.startTimer(`Tool: ${name}`);
+            try {
+                const result = await ErrorHandler.wrap(() => this.handleToolCall(name, args), 'TOOL_CALL_FAILED', `Tool call ${name} failed`, { tool: name });
+                endTimer();
+                this.logger.info(`Tool call completed`, { tool: name });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                endTimer();
+                this.logger.error(`Tool call failed`, error instanceof Error ? error : new Error(String(error)));
+                const errorMessage = ErrorHandler.formatError(error instanceof Error ? error : new Error(String(error)));
+                return {
+                    content: [{ type: "text", text: `Error: ${errorMessage}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Handle a tool call request
+     * Routes the request to the appropriate ReviewerService method
+     *
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @returns Tool result
+     * @throws MCPError if tool is unknown or parameters are invalid
+     */
+    async handleToolCall(name, args) {
+        const params = args;
+        // Get configuration with fallbacks
+        const config = this.config.get();
+        const gitlabUrl = (typeof params.gitlabUrl === 'string' ? params.gitlabUrl : undefined) ||
+            process.env.GITLAB_URL ||
+            config.gitlabUrl;
+        const token = (typeof params.gitlabToken === 'string' ? params.gitlabToken : undefined) ||
+            process.env.GITLAB_TOKEN;
+        const repoPath = (typeof params.repoPath === 'string' ? params.repoPath : undefined) ||
+            process.env.REPO_PATH ||
+            this.detectRepoPath();
+        if (!token) {
+            throw ErrorHandler.configurationError("GitLab token is required. Provide gitlabToken parameter or set GITLAB_TOKEN environment variable.", { gitlabUrl, hasRepoPath: !!repoPath });
+        }
+        this.logger.debug('Getting reviewer service', {
+            gitlabUrl,
+            hasToken: !!token,
+            repoPath: repoPath || 'api-mode'
+        });
+        const reviewerService = this.getReviewerService(gitlabUrl, token, repoPath);
+        switch (name) {
+            case "suggest_reviewers":
+                return reviewerService.suggestReviewers(params);
+            case "get_contributor_analysis":
+                return reviewerService.getContributorAnalysis(params);
+            case "get_reviewer_workload":
+                return reviewerService.getReviewerWorkload(params);
+            case "post_comment":
+                return reviewerService.postComment(params);
+            case "invite_reviewers":
+                return reviewerService.inviteReviewers(params);
+            default:
+                throw ErrorHandler.validationError(`Unknown tool: ${name}`, { tool: name });
+        }
+    }
+    /**
+     * Detect the local git repository path
+     * Attempts to find the git root directory from the current working directory
+     *
+     * @returns Git repository root path, or undefined if not in a git repository
+     */
+    detectRepoPath() {
+        try {
+            const { execSync } = require("child_process");
+            const gitRoot = execSync("git rev-parse --show-toplevel", {
+                encoding: "utf-8",
+                cwd: process.cwd(),
+            }).trim();
+            this.logger.info('Detected git repository', { gitRoot });
+            return gitRoot;
+        }
+        catch (error) {
+            this.logger.debug('No git repository detected, using API mode', {
+                cwd: process.cwd(),
+            });
+            return undefined;
+        }
+    }
+    /**
+     * Start the MCP server
+     * Connects to stdio transport and begins listening for requests
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        const stats = this.cache.getStats();
+        this.logger.info('Auto Reviewers MCP Server started successfully', {
+            cacheSize: stats.size,
+            cacheTTL: this.config.get().cacheTTL,
+        });
+    }
+    /**
+     * Gracefully shutdown the MCP server
+     * Logs cache statistics, clears cache, and closes the server connection
+     */
+    async shutdown() {
+        this.logger.info('Shutting down MCP server...');
+        // Log cache statistics before shutdown
+        const stats = this.cache.getStats();
+        this.logger.info('Cache statistics', {
+            hits: stats.hits,
+            misses: stats.misses,
+            size: stats.size,
+            hitRate: stats.hitRate,
+        });
+        // Clear cache
+        this.cache.clear();
+        // Close server
+        await this.server.close();
+        this.logger.info('MCP server shut down successfully');
+    }
+}
+//# sourceMappingURL=server.js.map