gitlab-auto-reviewers 2.0.0 → 2.1.0

package/dist/cli/parameter-source-tracker.js

@@ -0,0 +1,252 @@
+/**
+ * Parameter Source Tracker
+ *
+ * Tracks and logs the source of each configuration parameter for debugging.
+ * Implements Requirement 3.5: THE System SHALL log the source of each configuration value for debugging
+ *
+ * @module cli/parameter-source-tracker
+ */
+/**
+ * Parameter Source Tracker
+ *
+ * Tracks the source of each configuration parameter and provides
+ * comprehensive logging for debugging configuration issues.
+ */
+export class ParameterSourceTracker {
+    parameters = new Map();
+    logger;
+    /**
+     * Creates a new ParameterSourceTracker instance
+     *
+     * @param logger - Logger instance for outputting parameter source information
+     */
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Track a parameter with its value and source
+     */
+    track(name, value, source, options) {
+        this.parameters.set(name, {
+            name,
+            value,
+            source,
+            sourceDetail: options?.sourceDetail,
+            masked: options?.masked,
+        });
+    }
+    /**
+     * Resolve a parameter value with source tracking
+     * Implements the precedence: CLI argument > environment variable > auto-detected > config file > default
+     */
+    resolve(name, cliValue, envVarName, autoDetectFn, configValue, defaultValue, options) {
+        // Priority 1: CLI argument
+        if (cliValue !== undefined) {
+            this.track(name, cliValue, 'cli-argument', {
+                sourceDetail: `--${this.toKebabCase(name)}`,
+                masked: options?.masked,
+            });
+            return cliValue;
+        }
+        // Priority 2: Environment variable
+        if (envVarName) {
+            const envValue = process.env[envVarName];
+            if (envValue !== undefined && envValue !== '') {
+                const parsedValue = this.parseEnvValue(envValue);
+                this.track(name, parsedValue, 'environment', {
+                    sourceDetail: envVarName,
+                    masked: options?.masked,
+                });
+                return parsedValue;
+            }
+        }
+        // Priority 3: Auto-detection
+        if (autoDetectFn) {
+            const autoValue = autoDetectFn();
+            if (autoValue !== undefined) {
+                this.track(name, autoValue, 'auto-detected', {
+                    masked: options?.masked,
+                });
+                return autoValue;
+            }
+        }
+        // Priority 4: Config file
+        if (configValue !== undefined) {
+            this.track(name, configValue, 'config-file', {
+                masked: options?.masked,
+            });
+            return configValue;
+        }
+        // Priority 5: Default value
+        if (defaultValue !== undefined) {
+            this.track(name, defaultValue, 'default', {
+                masked: options?.masked,
+            });
+            return defaultValue;
+        }
+        // Not set
+        this.track(name, undefined, 'not-set', {
+            masked: options?.masked,
+        });
+        return undefined;
+    }
+    /**
+     * Get all tracked parameters
+     */
+    getAll() {
+        return new Map(this.parameters);
+    }
+    /**
+     * Get a specific tracked parameter
+     *
+     * @param name - The name of the parameter to retrieve
+     * @returns The tracked parameter or undefined if not found
+     */
+    get(name) {
+        return this.parameters.get(name);
+    }
+    /**
+     * Log all parameter sources
+     * This implements Requirement 3.5
+     */
+    logParameterSources() {
+        this.logger.info('Configuration resolved - parameter sources:');
+        const sortedParams = Array.from(this.parameters.entries()).sort(([a], [b]) => a.localeCompare(b));
+        for (const [name, param] of sortedParams) {
+            const displayValue = this.formatValueForLog(param);
+            const sourceInfo = this.formatSourceForLog(param);
+            this.logger.info(`  ${name}: ${displayValue} (${sourceInfo})`);
+        }
+    }
+    /**
+     * Log parameter sources in a structured format (for JSON output)
+     */
+    toStructuredLog() {
+        const result = {};
+        for (const [name, param] of this.parameters) {
+            result[name] = {
+                value: param.masked ? '***' : param.value,
+                source: param.source,
+                sourceDetail: param.sourceDetail,
+            };
+        }
+        return result;
+    }
+    /**
+     * Format value for logging (handles masking and undefined)
+     */
+    formatValueForLog(param) {
+        if (param.value === undefined) {
+            return '<not set>';
+        }
+        if (param.masked) {
+            return '***';
+        }
+        if (typeof param.value === 'string') {
+            // Truncate long strings
+            if (param.value.length > 50) {
+                return `"${param.value.substring(0, 47)}..."`;
+            }
+            return `"${param.value}"`;
+        }
+        return String(param.value);
+    }
+    /**
+     * Format source information for logging
+     */
+    formatSourceForLog(param) {
+        switch (param.source) {
+            case 'cli-argument':
+                return `CLI argument ${param.sourceDetail || ''}`.trim();
+            case 'environment':
+                return `environment variable ${param.sourceDetail || ''}`.trim();
+            case 'auto-detected':
+                return param.sourceDetail ? `auto-detected from ${param.sourceDetail}` : 'auto-detected';
+            case 'config-file':
+                return param.sourceDetail ? `config file ${param.sourceDetail}` : 'config file';
+            case 'default':
+                return 'default';
+            case 'not-set':
+                return 'not set';
+            default:
+                return param.source;
+        }
+    }
+    /**
+     * Convert camelCase to kebab-case
+     */
+    toKebabCase(str) {
+        return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+    }
+    /**
+     * Parse environment variable value to appropriate type
+     */
+    parseEnvValue(value) {
+        // Try to parse as number
+        const num = Number(value);
+        if (!isNaN(num) && value.trim() !== '') {
+            return num;
+        }
+        // Try to parse as boolean
+        if (value.toLowerCase() === 'true') {
+            return true;
+        }
+        if (value.toLowerCase() === 'false') {
+            return false;
+        }
+        // Return as string
+        return value;
+    }
+}
+/**
+ * Create a parameter source tracker and resolve all CLI parameters
+ *
+ * @param options - CLI options from argument parsing
+ * @param cicdEnv - CI/CD environment detection result
+ * @param logger - Logger instance
+ * @returns Resolved parameters with source tracking
+ */
+export function resolveParametersWithTracking(options, cicdEnv, logger) {
+    const tracker = new ParameterSourceTracker(logger);
+    // Resolve each parameter with source tracking
+    // NOTE: We need to resolve project FIRST to determine if we should auto-detect repoPath
+    // When both project ID and project directory are available in CI, prefer API mode (project ID)
+    // because it provides more reliable data access in CI environments
+    const project = tracker.resolve('project', options.project, 'CI_PROJECT_ID', // Also check CI_PROJECT_ID environment variable
+    () => cicdEnv.isCI ? cicdEnv.projectId : undefined, undefined, undefined);
+    // Only auto-detect repoPath from CI_PROJECT_DIR if project is NOT already set
+    // This prevents the "Cannot specify both --repo-path and --project" conflict
+    const repoPath = tracker.resolve('repoPath', options.repoPath, project ? undefined : 'CI_PROJECT_DIR', // Only use CI_PROJECT_DIR if project is not set
+    undefined, undefined, undefined);
+    // Resolve mergeRequestIid FIRST to determine if we should auto-detect branch
+    // When both MR IID and branch are available in CI, prefer MR IID because
+    // it provides more specific context for reviewer suggestions
+    const mergeRequestIid = tracker.resolve('mergeRequestIid', options.mergeRequestIid, 'CI_MERGE_REQUEST_IID', () => cicdEnv.isCI ? cicdEnv.mergeRequestIid : undefined, undefined, undefined);
+    // Only auto-detect branch from CI_COMMIT_REF_NAME if mergeRequestIid is NOT already set
+    // This prevents the "Cannot specify both merge request IID and branch name" conflict
+    const branch = tracker.resolve('branch', options.branch, mergeRequestIid ? undefined : 'CI_COMMIT_REF_NAME', // Only use CI_COMMIT_REF_NAME if MR IID is not set
+    () => (cicdEnv.isCI && !mergeRequestIid) ? cicdEnv.branch : undefined, undefined, undefined);
+    const gitlabUrl = tracker.resolve('gitlabUrl', options.gitlabUrl, 'GITLAB_URL', () => process.env.CI_SERVER_URL, // Auto-detect from GitLab CI environment
+    undefined, 'https://gitlab.com') || 'https://gitlab.com';
+    const gitlabToken = tracker.resolve('gitlabToken', options.gitlabToken, 'GITLAB_TOKEN', () => process.env.CI_JOB_TOKEN, undefined, undefined, { masked: true });
+    const format = tracker.resolve('format', options.format, undefined, () => cicdEnv.isCI ? 'json' : undefined, undefined, 'text') || 'text';
+    const verbose = tracker.resolve('verbose', options.verbose, undefined, undefined, undefined, false) || false;
+    const dryRun = tracker.resolve('dryRun', options.dryRun, undefined, undefined, undefined, false) || false;
+    const quiet = tracker.resolve('quiet', options.quiet, undefined, () => cicdEnv.isCI ? true : undefined, undefined, false) || false;
+    return {
+        tracker,
+        resolved: {
+            repoPath,
+            project,
+            mergeRequestIid,
+            branch,
+            gitlabUrl,
+            gitlabToken,
+            format,
+            verbose,
+            dryRun,
+            quiet,
+        },
+    };
+}
+//# sourceMappingURL=parameter-source-tracker.js.map

package/dist/cli/parameter-source-tracker.js.map

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

package/dist/cli/template-engine.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Template Engine for CLI Comment Generation
+ *
+ * This module provides template loading, compilation, and rendering
+ * for custom comment formats in the CLI.
+ *
+ * @module cli/template-engine
+ */
+import type { AutoReviewerResult } from '../types.js';
+/**
+ * Compiled template interface
+ */
+export interface CompiledTemplate {
+    render(data: TemplateData): string;
+    validate(): boolean;
+}
+/**
+ * Template data interface
+ *
+ * @property contributors - Array of contributor suggestions with scoring and reasoning
+ * @property teamMembers - Array of team member suggestions with workload information
+ * @property codeOwners - Array of code owner suggestions based on CODEOWNERS file
+ * @property summary - Summary statistics for the reviewer suggestions
+ * @property timestamp - ISO timestamp when the analysis was performed
+ * @property projectId - Optional GitLab project ID for context
+ * @property mergeRequestIid - Optional merge request internal ID for context
+ */
+export interface TemplateData {
+    contributors: Array<{
+        username: string;
+        reason: string;
+        workload: number;
+        fte?: number;
+    }>;
+    teamMembers: Array<{
+        username: string;
+        reason: string;
+        workload: number;
+        fte?: number;
+    }>;
+    codeOwners: Array<{
+        username: string;
+        reason: string;
+        workload: number;
+        fte?: number;
+    }>;
+    summary: {
+        totalSuggestions: number;
+        contributorCount: number;
+        teamMemberCount: number;
+        codeOwnerCount: number;
+    };
+    timestamp: string;
+    projectId?: string;
+    mergeRequestIid?: number;
+    [key: string]: unknown;
+}
+/**
+ * Template engine for custom comment formats
+ */
+export declare class TemplateEngine {
+    private templates;
+    /**
+     * Load and compile a template from file
+     *
+     * @param templatePath - Path to the template file
+     * @returns Compiled template
+     * @throws Error if template cannot be loaded or compiled
+     */
+    loadTemplate(templatePath: string): Promise<CompiledTemplate>;
+    /**
+     * Compile a template from string content
+     *
+     * @param content - Template content
+     * @returns Compiled template
+     */
+    compileTemplate(content: string): CompiledTemplate;
+    /**
+     * Get the default template content
+     *
+     * @returns Default template content matching MCP server format
+     */
+    getDefaultTemplate(): string;
+    /**
+     * Render a comment using the default or custom template
+     *
+     * @param result - Reviewer analysis result
+     * @param templatePath - Optional custom template path
+     * @returns Rendered comment
+     */
+    renderComment(result: AutoReviewerResult, templatePath?: string): Promise<string>;
+    /**
+     * Validate a template file
+     *
+     * @param templatePath - Path to the template file
+     * @returns True if template is valid
+     * @throws Error if template is invalid
+     */
+    validateTemplate(templatePath: string): Promise<boolean>;
+    /**
+     * Clear template cache
+     */
+    clearCache(): void;
+}
+/**
+ * Default template engine instance
+ */
+export declare const templateEngine: TemplateEngine;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/cli/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/cli/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IACnC,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,WAAW,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,EAAE,KAAK,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAwED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAuC;IAExD;;;;;;OAMG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0BnE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAIlD;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAkC5B;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCvF;;;;;;OAMG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9D;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/cli/template-engine.js

@@ -0,0 +1,220 @@
+/**
+ * Template Engine for CLI Comment Generation
+ *
+ * This module provides template loading, compilation, and rendering
+ * for custom comment formats in the CLI.
+ *
+ * @module cli/template-engine
+ */
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Simple template implementation
+ */
+class SimpleTemplate {
+    content;
+    constructor(content) {
+        this.content = content;
+    }
+    render(data) {
+        let result = this.content;
+        // Replace template variables
+        result = result.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
+            const value = this.getNestedValue(data, path);
+            return value !== undefined ? String(value) : match;
+        });
+        // Handle loops for contributors
+        result = result.replace(/\{\{#each contributors\}\}([\s\S]*?)\{\{\/each\}\}/g, (_match, template) => {
+            return data.contributors.map(contributor => {
+                return template.replace(/\{\{(\w+)\}\}/g, (innerMatch, prop) => {
+                    const value = contributor[prop];
+                    return value !== undefined ? String(value) : innerMatch;
+                });
+            }).join('');
+        });
+        // Handle loops for team members
+        result = result.replace(/\{\{#each teamMembers\}\}([\s\S]*?)\{\{\/each\}\}/g, (_match, template) => {
+            return data.teamMembers.map(member => {
+                return template.replace(/\{\{(\w+)\}\}/g, (innerMatch, prop) => {
+                    const value = member[prop];
+                    return value !== undefined ? String(value) : innerMatch;
+                });
+            }).join('');
+        });
+        // Handle loops for code owners
+        result = result.replace(/\{\{#each codeOwners\}\}([\s\S]*?)\{\{\/each\}\}/g, (_match, template) => {
+            return data.codeOwners.map(owner => {
+                return template.replace(/\{\{(\w+)\}\}/g, (innerMatch, prop) => {
+                    const value = owner[prop];
+                    return value !== undefined ? String(value) : innerMatch;
+                });
+            }).join('');
+        });
+        // Handle conditionals
+        result = result.replace(/\{\{#if (\w+(?:\.\w+)*)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_match, path, content) => {
+            const value = this.getNestedValue(data, path);
+            return value ? content : '';
+        });
+        return result;
+    }
+    validate() {
+        // Basic validation - check for balanced template tags
+        const openTags = (this.content.match(/\{\{#/g) || []).length;
+        const closeTags = (this.content.match(/\{\{\//g) || []).length;
+        return openTags === closeTags;
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => {
+            return current && typeof current === 'object' && current !== null && key in current
+                ? current[key]
+                : undefined;
+        }, obj);
+    }
+}
+/**
+ * Template engine for custom comment formats
+ */
+export class TemplateEngine {
+    templates = new Map();
+    /**
+     * Load and compile a template from file
+     *
+     * @param templatePath - Path to the template file
+     * @returns Compiled template
+     * @throws Error if template cannot be loaded or compiled
+     */
+    async loadTemplate(templatePath) {
+        if (this.templates.has(templatePath)) {
+            return this.templates.get(templatePath);
+        }
+        const resolvedPath = resolve(templatePath);
+        if (!existsSync(resolvedPath)) {
+            throw new Error(`Template file not found: ${resolvedPath}`);
+        }
+        try {
+            const content = readFileSync(resolvedPath, 'utf-8');
+            const compiled = this.compileTemplate(content);
+            if (!compiled.validate()) {
+                throw new Error(`Template validation failed: ${templatePath}`);
+            }
+            this.templates.set(templatePath, compiled);
+            return compiled;
+        }
+        catch (error) {
+            throw new Error(`Failed to load template ${templatePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Compile a template from string content
+     *
+     * @param content - Template content
+     * @returns Compiled template
+     */
+    compileTemplate(content) {
+        return new SimpleTemplate(content);
+    }
+    /**
+     * Get the default template content
+     *
+     * @returns Default template content matching MCP server format
+     */
+    getDefaultTemplate() {
+        return `## 🔍 Suggested Reviewers
+
+{{#if summary.totalSuggestions}}
+Based on the analysis of changed files, here are the suggested reviewers:
+
+{{#if contributors}}
+### 📝 **Contributors** ({{contributors.length}})
+{{#each contributors}}
+- **@{{username}}** - {{reason}} (Current workload: {{workload}} MRs{{#if fte}}, FTE: {{fte}}{{/if}})
+{{/each}}
+
+{{/if}}
+{{#if teamMembers}}
+### 👥 **Team Members** ({{teamMembers.length}})
+{{#each teamMembers}}
+- **@{{username}}** - {{reason}} (Current workload: {{workload}} MRs{{#if fte}}, FTE: {{fte}}{{/if}})
+{{/each}}
+
+{{/if}}
+{{#if codeOwners}}
+### 🏠 **Code Owners** ({{codeOwners.length}})
+{{#each codeOwners}}
+- **@{{username}}** - {{reason}} (Current workload: {{workload}} MRs{{#if fte}}, FTE: {{fte}}{{/if}})
+{{/each}}
+
+{{/if}}
+---
+*Total suggestions: {{summary.totalSuggestions}} | Generated at {{timestamp}}*
+{{else}}
+No reviewer suggestions found based on the current analysis.
+{{/if}}`;
+    }
+    /**
+     * Render a comment using the default or custom template
+     *
+     * @param result - Reviewer analysis result
+     * @param templatePath - Optional custom template path
+     * @returns Rendered comment
+     */
+    async renderComment(result, templatePath) {
+        let template;
+        if (templatePath) {
+            template = await this.loadTemplate(templatePath);
+        }
+        else {
+            template = this.compileTemplate(this.getDefaultTemplate());
+        }
+        const templateData = {
+            contributors: result.contributors.map(c => ({
+                username: c.username,
+                reason: c.reason,
+                workload: c.workload,
+                fte: c.fte,
+            })),
+            teamMembers: result.teamMembers.map(t => ({
+                username: t.username,
+                reason: t.reason,
+                workload: t.workload,
+                fte: t.fte,
+            })),
+            codeOwners: result.codeOwners.map(o => ({
+                username: o.username,
+                reason: o.reason,
+                workload: o.workload,
+                fte: o.fte,
+            })),
+            summary: {
+                totalSuggestions: result.contributors.length + result.teamMembers.length + result.codeOwners.length,
+                contributorCount: result.contributors.length,
+                teamMemberCount: result.teamMembers.length,
+                codeOwnerCount: result.codeOwners.length,
+            },
+            timestamp: new Date().toISOString(),
+        };
+        return template.render(templateData);
+    }
+    /**
+     * Validate a template file
+     *
+     * @param templatePath - Path to the template file
+     * @returns True if template is valid
+     * @throws Error if template is invalid
+     */
+    async validateTemplate(templatePath) {
+        const template = await this.loadTemplate(templatePath);
+        return template.validate();
+    }
+    /**
+     * Clear template cache
+     */
+    clearCache() {
+        this.templates.clear();
+    }
+}
+/**
+ * Default template engine instance
+ */
+export const templateEngine = new TemplateEngine();
+//# sourceMappingURL=template-engine.js.map

package/dist/cli/template-engine.js.map

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

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

@@ -37,17 +37,36 @@ export interface MCPServerConfig {
  *
  * Loads configuration from environment variables, applies defaults,
  * validates settings, and provides type-safe access to configuration.
+ *
+ * Supports singleton pattern to avoid multiple instantiations and duplicate logging.
  */
 export declare class ConfigService {
+    private static instance;
+    private static hasLoggedDefaults;
     private config;
     private appliedDefaults;
     /**
      * Create a new configuration service
      *
      * Automatically loads and validates configuration from environment variables.
-     * Logs any default values that were applied.
+     * Logs any default values that were applied (only once per process).
+     *
+     * @param skipLogging - If true, skip logging applied defaults (useful for testing)
      */
-    constructor();
+    constructor(skipLogging?: boolean);
+    /**
+     * Get the singleton instance of ConfigService
+     *
+     * This ensures configuration is only loaded and logged once per process,
+     * avoiding duplicate log messages when multiple components need config.
+     *
+     * @returns The shared ConfigService instance
+     */
+    static getInstance(): ConfigService;
+    /**
+     * Reset the singleton instance (primarily for testing)
+     */
+    static resetInstance(): void;
     /**
      * Get the current configuration (read-only)
      */
@@ -58,6 +77,8 @@ export declare class ConfigService {
     getAppliedDefaults(): ReadonlyMap<string, unknown>;
     /**
      * Load configuration from environment variables and validate
+     *
+     * @param skipLogging - If true, skip logging applied defaults
      */
     private loadAndValidate;
     /**
@@ -83,6 +104,7 @@ export declare class ConfigService {
     /**
      * Log which default values were applied
      * Uses console.error since MCP servers log to stderr
+     * Only logs once per process to avoid duplicate messages
      */
     private logAppliedDefaults;
 }

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

@@ -1 +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"}
+{"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;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAS;IAEzC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAmC;IAE1D;;;;;;;OAOG;gBACS,WAAW,UAAQ;IAI/B;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B;;OAEG;IACH,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC;IAIhC;;OAEG;IACH,kBAAkB,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;IAKlD;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA+BvB;;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;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}