gitlab-auto-reviewers 2.0.0

package/dist/config/config.service.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Configuration Service
+ *
+ * Centralized configuration management with validation and type safety.
+ * Loads configuration from environment variables and provides type-safe access.
+ */
+/**
+ * MCP Server configuration interface
+ *
+ * @property gitlabUrl - GitLab instance URL (e.g., https://gitlab.com)
+ * @property gitlabToken - GitLab API token for authentication (optional)
+ * @property repoPath - Path to local git repository for local operations (optional)
+ * @property cacheEnabled - Whether caching is enabled
+ * @property cacheTTL - Cache time-to-live in milliseconds
+ * @property maxParallelRequests - Maximum number of parallel API requests
+ * @property contributorDays - Number of days to analyze for contributor history
+ * @property maxRetries - Maximum number of retry attempts for failed operations
+ * @property retryDelayMs - Initial delay in milliseconds between retries
+ * @property logLevel - Minimum log level to output
+ * @property debug - Whether debug mode is enabled
+ */
+export interface MCPServerConfig {
+    gitlabUrl: string;
+    gitlabToken?: string;
+    repoPath?: string;
+    cacheEnabled: boolean;
+    cacheTTL: number;
+    maxParallelRequests: number;
+    contributorDays: number;
+    maxRetries: number;
+    retryDelayMs: number;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    debug: boolean;
+}
+/**
+ * Configuration service for managing MCP server settings
+ *
+ * Loads configuration from environment variables, applies defaults,
+ * validates settings, and provides type-safe access to configuration.
+ */
+export declare class ConfigService {
+    private config;
+    private appliedDefaults;
+    /**
+     * Create a new configuration service
+     *
+     * Automatically loads and validates configuration from environment variables.
+     * Logs any default values that were applied.
+     */
+    constructor();
+    /**
+     * Get the current configuration (read-only)
+     */
+    get(): Readonly<MCPServerConfig>;
+    /**
+     * Get which default values were applied during configuration loading
+     */
+    getAppliedDefaults(): ReadonlyMap<string, unknown>;
+    /**
+     * Load configuration from environment variables and validate
+     */
+    private loadAndValidate;
+    /**
+     * Validate the configuration
+     */
+    private validateConfig;
+    /**
+     * Get environment variable or default value
+     */
+    private getEnvOrDefault;
+    /**
+     * Get boolean environment variable
+     */
+    private getBooleanEnv;
+    /**
+     * Get number environment variable
+     */
+    private getNumberEnv;
+    /**
+     * Get log level from environment
+     */
+    private getLogLevel;
+    /**
+     * Log which default values were applied
+     * Uses console.error since MCP servers log to stderr
+     */
+    private logAppliedDefaults;
+}
+//# sourceMappingURL=config.service.d.ts.map

package/dist/config/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../src/config/config.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAE9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IAGrB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAmC;IAE1D;;;;;OAKG;;IAKH;;OAEG;IACH,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC;IAIhC;;OAEG;IACH,kBAAkB,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;IAKlD;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2CtB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/config/config.service.js

@@ -0,0 +1,169 @@
+/**
+ * Configuration Service
+ *
+ * Centralized configuration management with validation and type safety.
+ * Loads configuration from environment variables and provides type-safe access.
+ */
+/**
+ * Configuration service for managing MCP server settings
+ *
+ * Loads configuration from environment variables, applies defaults,
+ * validates settings, and provides type-safe access to configuration.
+ */
+export class ConfigService {
+    config;
+    appliedDefaults = new Map();
+    /**
+     * Create a new configuration service
+     *
+     * Automatically loads and validates configuration from environment variables.
+     * Logs any default values that were applied.
+     */
+    constructor() {
+        this.config = this.loadAndValidate();
+    }
+    /**
+     * Get the current configuration (read-only)
+     */
+    get() {
+        return Object.freeze({ ...this.config });
+    }
+    /**
+     * Get which default values were applied during configuration loading
+     */
+    getAppliedDefaults() {
+        // Return a copy of the map to prevent external modifications
+        return new Map(this.appliedDefaults);
+    }
+    /**
+     * Load configuration from environment variables and validate
+     */
+    loadAndValidate() {
+        const config = {
+            // GitLab Configuration
+            gitlabUrl: this.getEnvOrDefault('GITLAB_URL', 'https://gitlab.com'),
+            gitlabToken: process.env.GITLAB_TOKEN,
+            // Repository Configuration
+            repoPath: process.env.REPO_PATH,
+            // Performance Configuration
+            cacheEnabled: this.getBooleanEnv('CACHE_ENABLED', true),
+            cacheTTL: this.getNumberEnv('CACHE_TTL', 300000), // 5 minutes default
+            maxParallelRequests: this.getNumberEnv('MAX_PARALLEL_REQUESTS', 5),
+            // Git Configuration
+            contributorDays: this.getNumberEnv('CONTRIBUTOR_DAYS', 352),
+            maxRetries: this.getNumberEnv('MAX_RETRIES', 3),
+            retryDelayMs: this.getNumberEnv('RETRY_DELAY_MS', 1000),
+            // Logging Configuration
+            logLevel: this.getLogLevel(),
+            debug: this.getBooleanEnv('DEBUG', false),
+        };
+        this.validateConfig(config);
+        this.logAppliedDefaults();
+        return config;
+    }
+    /**
+     * Validate the configuration
+     */
+    validateConfig(config) {
+        const errors = [];
+        // Validate GitLab URL
+        if (!config.gitlabUrl) {
+            errors.push('GITLAB_URL is required');
+        }
+        else {
+            try {
+                new URL(config.gitlabUrl);
+            }
+            catch {
+                errors.push(`GITLAB_URL is not a valid URL: ${config.gitlabUrl}`);
+            }
+        }
+        // Validate numeric ranges
+        if (config.cacheTTL < 0) {
+            errors.push(`CACHE_TTL must be non-negative, got: ${config.cacheTTL}`);
+        }
+        if (config.maxParallelRequests < 1) {
+            errors.push(`MAX_PARALLEL_REQUESTS must be at least 1, got: ${config.maxParallelRequests}`);
+        }
+        if (config.contributorDays < 1) {
+            errors.push(`CONTRIBUTOR_DAYS must be at least 1, got: ${config.contributorDays}`);
+        }
+        if (config.maxRetries < 0) {
+            errors.push(`MAX_RETRIES must be non-negative, got: ${config.maxRetries}`);
+        }
+        if (config.retryDelayMs < 0) {
+            errors.push(`RETRY_DELAY_MS must be non-negative, got: ${config.retryDelayMs}`);
+        }
+        if (errors.length > 0) {
+            throw new Error(`Configuration validation failed:\n${errors.map(e => `  - ${e}`).join('\n')}\n\n` +
+                'Please check your environment variables and try again.');
+        }
+    }
+    /**
+     * Get environment variable or default value
+     */
+    getEnvOrDefault(key, defaultValue) {
+        const value = process.env[key];
+        if (value === undefined) {
+            this.appliedDefaults.set(key, defaultValue);
+            return defaultValue;
+        }
+        return value;
+    }
+    /**
+     * Get boolean environment variable
+     */
+    getBooleanEnv(key, defaultValue) {
+        const value = process.env[key];
+        if (value === undefined) {
+            this.appliedDefaults.set(key, defaultValue);
+            return defaultValue;
+        }
+        return value.toLowerCase() === 'true' || value === '1';
+    }
+    /**
+     * Get number environment variable
+     */
+    getNumberEnv(key, defaultValue) {
+        const value = process.env[key];
+        if (value === undefined) {
+            this.appliedDefaults.set(key, defaultValue);
+            return defaultValue;
+        }
+        const parsed = parseInt(value, 10);
+        if (isNaN(parsed)) {
+            throw new Error(`Environment variable ${key} must be a number, got: ${value}`);
+        }
+        return parsed;
+    }
+    /**
+     * Get log level from environment
+     */
+    getLogLevel() {
+        const value = process.env.LOG_LEVEL?.toLowerCase();
+        if (value === undefined) {
+            this.appliedDefaults.set('LOG_LEVEL', 'info');
+            return 'info';
+        }
+        const validLevels = ['debug', 'info', 'warn', 'error'];
+        if (!validLevels.includes(value)) {
+            throw new Error(`LOG_LEVEL must be one of: ${validLevels.join(', ')}, got: ${value}`);
+        }
+        return value;
+    }
+    /**
+     * Log which default values were applied
+     * Uses console.error since MCP servers log to stderr
+     */
+    logAppliedDefaults() {
+        if (this.appliedDefaults.size === 0) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        console.error(`[${timestamp}] [INFO] [ConfigService] Applied default configuration values:`);
+        for (const [key, value] of this.appliedDefaults.entries()) {
+            console.error(`[${timestamp}] [INFO] [ConfigService]   ${key} = ${JSON.stringify(value)}`);
+        }
+    }
+}
+//# sourceMappingURL=config.service.js.map

package/dist/config/config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../../src/config/config.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAkB;IACxB,eAAe,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE1D;;;;;OAKG;IACH;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,6DAA6D;QAC7D,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,MAAM,MAAM,GAAoB;YAC9B,uBAAuB;YACvB,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,oBAAoB,CAAC;YACnE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;YAErC,2BAA2B;YAC3B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;YAE/B,4BAA4B;YAC5B,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC;YACvD,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,oBAAoB;YACtE,mBAAmB,EAAE,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;YAElE,oBAAoB;YACpB,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,GAAG,CAAC;YAC3D,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;YAC/C,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC;YAEvD,wBAAwB;YACxB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE;YAC5B,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;SAC1C,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,MAAuB;QAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,sBAAsB;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,wCAAwC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,MAAM,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,kDAAkD,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,6CAA6C,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,6CAA6C,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;gBACjF,wDAAwD,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAI,GAAW,EAAE,YAAe;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC5C,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAW,EAAE,YAAqB;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC5C,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;IACzD,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,GAAW,EAAE,YAAoB;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC5C,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,2BAA2B,KAAK,EAAE,CAC9D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,WAAW;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CACrE,CAAC;QACJ,CAAC;QAED,OAAO,KAA4C,CAAC;IACtD,CAAC;IAED;;;OAGG;IACK,kBAAkB;QACxB,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,gEAAgE,CAAC,CAAC;QAE7F,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,8BAA8B,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,140 @@
+import { MergeRequest, MergeRequestDiff, BlameLine, GitLabNote } from '../types/index.js';
+/**
+ * GitDataSource Interface
+ *
+ * Abstraction layer for accessing git data from different sources (GitLab API or local git repository).
+ * All implementations must provide consistent behavior and error handling.
+ *
+ * Error Handling Contract:
+ * - All methods should throw MCPError with appropriate error codes
+ * - All errors must include data source context (dataSource field in details)
+ * - Transient errors should be retryable via ErrorHandler.withRetry
+ * - Not found scenarios should throw ErrorCategory.NOT_FOUND errors
+ * - Invalid input should throw ErrorCategory.VALIDATION errors
+ *
+ * @interface GitDataSource
+ */
+export interface GitDataSource {
+    /**
+     * Get the default branch name for a project
+     *
+     * @param project - Project identifier (e.g., "group/project")
+     * @returns Promise resolving to the default branch name (e.g., "main", "master")
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getDefaultBranch(project: string): Promise<string>;
+    /**
+     * Get a specific merge request by its IID
+     *
+     * @param project - Project identifier
+     * @param mr - Merge request IID (internal ID)
+     * @returns Promise resolving to MergeRequest or null if not found
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getMergeRequest(project: string, mr: number): Promise<MergeRequest | null>;
+    /**
+     * Find an open merge request by its source branch name
+     *
+     * @param project - Project identifier
+     * @param branch - Source branch name
+     * @returns Promise resolving to MergeRequest or null if not found
+     * @throws {MCPError} With code NOT_FOUND if no open MR exists for the branch
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getMergeRequestByBranch(project: string, branch: string): Promise<MergeRequest | null>;
+    /**
+     * Get the current branch name (local git only)
+     *
+     * Optional method only available in local git data source.
+     *
+     * @returns Promise resolving to current branch name
+     * @throws {MCPError} With code GIT_OPERATION if repository is in detached HEAD state
+     */
+    getCurrentBranch?(): Promise<string>;
+    /**
+     * Get the diff for a merge request
+     *
+     * @param project - Project identifier
+     * @param mr - Merge request IID
+     * @returns Promise resolving to array of file diffs
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     * @throws {MCPError} With code VALIDATION if merge request data is invalid
+     */
+    getDiffs(project: string, mr: number): Promise<MergeRequestDiff[]>;
+    /**
+     * Get git blame information for a file at a specific commit
+     *
+     * Returns blame data showing which commits last modified each line.
+     * Should gracefully handle failures by falling back or returning empty array.
+     *
+     * @param project - Project identifier
+     * @param path - File path relative to repository root
+     * @param ref - Git commit SHA or ref
+     * @returns Promise resolving to array of blame lines, or null/empty array if unavailable
+     * @throws {MCPError} With code GIT_OPERATION if operation fails critically
+     */
+    getBlame(project: string, path: string, ref: string): Promise<BlameLine[] | null>;
+    /**
+     * Get raw file content from a specific commit
+     *
+     * @param project - Project identifier
+     * @param commitSha - Git commit SHA
+     * @param path - File path relative to repository root
+     * @returns Promise resolving to file content as string, or null if not found
+     * @throws {MCPError} With code NOT_FOUND if file doesn't exist
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getRawFile(project: string, commitSha: string, path: string): Promise<string | null>;
+    /**
+     * Get and parse a JSON file from a specific commit
+     *
+     * @param project - Project identifier
+     * @param commitSha - Git commit SHA
+     * @param path - File path relative to repository root
+     * @returns Promise resolving to parsed JSON object, or null if not found
+     * @throws {MCPError} With code VALIDATION if JSON parsing fails
+     * @throws {MCPError} With code NOT_FOUND if file doesn't exist
+     */
+    getJsonFile<T = unknown>(project: string, commitSha: string, path: string): Promise<T | null>;
+    /**
+     * Get all merge requests for a project with optional state filter
+     *
+     * @param project - Project identifier
+     * @param state - Optional state filter (e.g., "opened", "closed", "merged")
+     * @returns Promise resolving to array of merge requests
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getMergeRequests(project: string, state?: string): Promise<MergeRequest[]>;
+    /**
+     * Get all notes (comments) for a merge request
+     *
+     * @param project - Project identifier
+     * @param mr - Merge request IID
+     * @returns Promise resolving to array of notes
+     * @throws {MCPError} With code API_CALL or GIT_OPERATION if operation fails
+     */
+    getNotes(project: string, mr: number): Promise<GitLabNote[]>;
+    /**
+     * Get list of project contributors based on commit history
+     *
+     * Returns email addresses of contributors who have committed up to the specified commit
+     * within the configured time range (see ConfigService.contributorDays).
+     *
+     * @param project - Project identifier
+     * @param commitSha - Git commit SHA to analyze history from
+     * @returns Promise resolving to array of contributor email addresses
+     * @throws {MCPError} With code GIT_OPERATION if operation fails
+     */
+    getProjectContributors(project: string, commitSha: string): Promise<string[]>;
+    /**
+     * Create a new note (comment) on a merge request
+     *
+     * @param project - Project identifier
+     * @param mr - Merge request IID
+     * @param body - Comment body (markdown supported)
+     * @returns Promise resolving to the created note
+     * @throws {MCPError} With code API_CALL if operation fails
+     */
+    createNote(project: string, mr: number, body: string): Promise<GitLabNote>;
+}
+//# sourceMappingURL=git-data-source.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-data-source.interface.d.ts","sourceRoot":"","sources":["../../src/datasources/git-data-source.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAE3E;;;;;;;;OAQG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEvF;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEnE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IAElF;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAErF;;;;;;;;;OASG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9F;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE3E;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7D;;;;;;;;;;OAUG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5E"}

package/dist/datasources/git-data-source.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-data-source.interface.js.map

package/dist/datasources/git-data-source.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-data-source.interface.js","sourceRoot":"","sources":["../../src/datasources/git-data-source.interface.ts"],"names":[],"mappings":""}

package/dist/datasources/gitlab-api-data-source.d.ts

@@ -0,0 +1,127 @@
+import { GitLabAPI } from "../api/gitlab-api.js";
+import { GitDataSource } from "./git-data-source.interface.js";
+import { MergeRequest, MergeRequestDiff, BlameLine, GitLabNote } from '../types/index.js';
+import { Logger } from '../logging/logger.service.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 declare class GitLabAPIDataSource implements GitDataSource {
+    protected logger: Logger;
+    protected gitlabApi: GitLabAPI;
+    /**
+     * Create a new GitLab API data source
+     *
+     * @param gitlabApi - GitLab API client instance
+     * @param logger - Optional logger instance for logging operations
+     */
+    constructor(gitlabApi: GitLabAPI, logger?: Logger);
+    /**
+     * 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
+     */
+    protected findMergeRequestByBranch(project: string, branch: string): Promise<MergeRequest>;
+    /**
+     * Get the default branch for a project
+     *
+     * @param project - The project ID or path
+     * @returns Promise resolving to the default branch name
+     */
+    getDefaultBranch(project: string): Promise<string>;
+    /**
+     * 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
+     */
+    getMergeRequest(project: string, mr: number): Promise<MergeRequest | null>;
+    /**
+     * 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
+     */
+    getMergeRequestByBranch(project: string, branch: string): Promise<MergeRequest | null>;
+    /**
+     * 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)
+     */
+    getDiffs(project: string, mr: number): Promise<MergeRequestDiff[]>;
+    /**
+     * 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
+     */
+    getBlame(project: string, path: string, ref: string): Promise<BlameLine[] | null>;
+    /**
+     * 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
+     */
+    getRawFile(project: string, commitSha: string, path: string): Promise<string | null>;
+    /**
+     * 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
+     */
+    getJsonFile<T = unknown>(project: string, commitSha: string, path: string): Promise<T | null>;
+    /**
+     * 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
+     */
+    getMergeRequests(project: string, state?: string): Promise<MergeRequest[]>;
+    /**
+     * 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
+     */
+    getNotes(project: string, mr: number): Promise<GitLabNote[]>;
+    /**
+     * 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
+     */
+    getProjectContributors(project: string, commitSha: string): Promise<string[]>;
+    /**
+     * 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
+     */
+    createNote(project: string, mr: number, body: string): Promise<GitLabNote>;
+}
+//# sourceMappingURL=gitlab-api-data-source.d.ts.map

package/dist/datasources/gitlab-api-data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-api-data-source.d.ts","sourceRoot":"","sources":["../../src/datasources/gitlab-api-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,UAAU,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtD;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAE/B;;;;;OAKG;gBACS,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAKjD;;;;;;;OAOG;cACa,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC;IAgCxB;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcxD;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAchF;;;;;;OAMG;IACG,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI5F;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA0BxE;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC;IAcvF;;;;;;;OAOG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAezB;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkBpB;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAclF;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAclE;;;;;;OAMG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC;IAepB;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAajF"}