gitlab-auto-reviewers 2.0.0 → 2.1.0

package/dist/cli/output.js

@@ -2,62 +2,148 @@
  * CLI Output Formatters
  *
  * This module provides output formatting functions for CLI results.
- * Supports both JSON and human-readable text formats.
+ * Supports both JSON and human-readable text formats with enhanced features
+ * for verbose/quiet modes and structured CI/CD output.
  *
  * @module cli/output
  */
+import { writeFileSync } from 'fs';
+/**
+ * Enhanced output handler for CLI results
+ *
+ * @param result - Reviewer analysis result or enhanced CLI result
+ * @param options - CLI options for output control
+ * @returns Formatted output string
+ */
+export function handleOutput(result, options) {
+    const format = options.format || 'text';
+    const verbose = options.verbose || false;
+    const quiet = options.quiet || false;
+    let output;
+    if (format === 'json') {
+        output = formatJSON(result, verbose);
+    }
+    else {
+        output = formatText(result, verbose, quiet);
+    }
+    // Write to log file if specified
+    if (options.logFile) {
+        writeLogFile(options.logFile, result, options);
+    }
+    return output;
+}
 /**
  * Format reviewer suggestions as JSON
  *
  * @param result - Reviewer analysis result
+ * @param verbose - Include detailed information
  * @returns JSON string with formatted output
  */
-export function formatJSON(result) {
-    return JSON.stringify({
-        contributors: result.contributors.map(formatReviewerJSON),
-        teamMembers: result.teamMembers.map(formatReviewerJSON),
-        codeOwners: result.codeOwners.map(formatReviewerJSON),
+export function formatJSON(result, verbose = false) {
+    const baseResult = {
+        comment: result.comment,
+        contributors: result.contributors.map(r => formatReviewerJSON(r, verbose)),
+        teamMembers: result.teamMembers.map(r => formatReviewerJSON(r, verbose)),
+        codeOwners: result.codeOwners.map(r => formatReviewerJSON(r, verbose)),
         summary: {
             totalSuggestions: result.contributors.length + result.teamMembers.length + result.codeOwners.length,
             contributorCount: result.contributors.length,
             teamMemberCount: result.teamMembers.length,
             codeOwnerCount: result.codeOwners.length,
         },
-    }, null, 2);
+    };
+    // Add CLI-specific metadata if available
+    if ('metadata' in result) {
+        return JSON.stringify({
+            ...baseResult,
+            metadata: result.metadata,
+            commentResult: result.commentResult,
+            timestamp: new Date().toISOString(),
+        }, null, 2);
+    }
+    return JSON.stringify(baseResult, null, 2);
 }
 /**
  * Format a single reviewer suggestion as JSON object
  */
-function formatReviewerJSON(reviewer) {
-    return {
+function formatReviewerJSON(reviewer, verbose = false) {
+    const base = {
         username: reviewer.username,
-        score: reviewer.score,
         reason: reviewer.reason,
         workload: reviewer.workload,
-        fte: reviewer.fte,
-        workloadDetails: reviewer.workloadDetails,
-        reasoning: reviewer.reasoning,
+        score: reviewer.score, // Always include score in JSON output
     };
+    if (verbose) {
+        return {
+            ...base,
+            fte: reviewer.fte,
+            workloadDetails: reviewer.workloadDetails,
+            reasoning: reviewer.reasoning,
+        };
+    }
+    return base;
 }
 /**
  * Format reviewer suggestions as human-readable text
  *
  * @param result - Reviewer analysis result
+ * @param verbose - Include detailed information
+ * @param quiet - Suppress non-essential output
  * @returns Formatted text string
  */
-export function formatText(result) {
+export function formatText(result, verbose = false, quiet = false) {
     const lines = [];
-    lines.push('='.repeat(80));
-    lines.push('REVIEWER SUGGESTIONS');
-    lines.push('='.repeat(80));
-    lines.push('');
+    if (!quiet) {
+        lines.push('='.repeat(80));
+        lines.push('REVIEWER SUGGESTIONS');
+        lines.push('='.repeat(80));
+        lines.push('');
+    }
     // Summary
     const totalSuggestions = result.contributors.length + result.teamMembers.length + result.codeOwners.length;
+    if (quiet) {
+        // Minimal output for quiet mode
+        if (totalSuggestions === 0) {
+            lines.push('No reviewer suggestions found.');
+            return lines.join('\n');
+        }
+        // Just list usernames
+        const allReviewers = [
+            ...result.contributors.map(r => r.username),
+            ...result.teamMembers.map(r => r.username),
+            ...result.codeOwners.map(r => r.username),
+        ];
+        lines.push(`Suggested reviewers: ${allReviewers.join(', ')}`);
+        return lines.join('\n');
+    }
     lines.push(`Total Suggestions: ${totalSuggestions}`);
     lines.push(`  - Contributors: ${result.contributors.length}`);
     lines.push(`  - Team Members: ${result.teamMembers.length}`);
     lines.push(`  - Code Owners: ${result.codeOwners.length}`);
     lines.push('');
+    // Add CLI metadata if available and verbose
+    if (verbose && 'metadata' in result) {
+        lines.push('-'.repeat(80));
+        lines.push('EXECUTION METADATA');
+        lines.push('-'.repeat(80));
+        lines.push(`Execution Time: ${result.metadata.executionTime}ms`);
+        lines.push(`Data Source: ${result.metadata.dataSource}`);
+        lines.push(`Dry Run: ${result.metadata.dryRun ? 'Yes' : 'No'}`);
+        lines.push(`Config Sources: ${result.metadata.configSource.join(', ')}`);
+        if (result.commentResult) {
+            lines.push(`Comment Posted: ${result.commentResult.posted ? 'Yes' : 'No'}`);
+            if (result.commentResult.commentId) {
+                lines.push(`Comment ID: ${result.commentResult.commentId}`);
+            }
+            if (result.commentResult.url) {
+                lines.push(`Comment URL: ${result.commentResult.url}`);
+            }
+            if (result.commentResult.error) {
+                lines.push(`Comment Error: ${result.commentResult.error}`);
+            }
+        }
+        lines.push('');
+    }
     // Contributors
     if (result.contributors.length > 0) {
         lines.push('-'.repeat(80));
@@ -65,7 +151,7 @@ export function formatText(result) {
         lines.push('-'.repeat(80));
         lines.push('');
         result.contributors.forEach((reviewer, index) => {
-            lines.push(...formatReviewerText(reviewer, index + 1));
+            lines.push(...formatReviewerText(reviewer, index + 1, verbose));
             lines.push('');
         });
     }
@@ -76,7 +162,7 @@ export function formatText(result) {
         lines.push('-'.repeat(80));
         lines.push('');
         result.teamMembers.forEach((reviewer, index) => {
-            lines.push(...formatReviewerText(reviewer, index + 1));
+            lines.push(...formatReviewerText(reviewer, index + 1, verbose));
             lines.push('');
         });
     }
@@ -87,25 +173,27 @@ export function formatText(result) {
         lines.push('-'.repeat(80));
         lines.push('');
         result.codeOwners.forEach((reviewer, index) => {
-            lines.push(...formatReviewerText(reviewer, index + 1));
+            lines.push(...formatReviewerText(reviewer, index + 1, verbose));
             lines.push('');
         });
     }
-    lines.push('='.repeat(80));
+    if (!quiet) {
+        lines.push('='.repeat(80));
+    }
     return lines.join('\n');
 }
 /**
  * Format a single reviewer suggestion as text
  */
-function formatReviewerText(reviewer, index) {
+function formatReviewerText(reviewer, index, verbose = false) {
     const lines = [];
     lines.push(`${index}. @${reviewer.username}`);
     if (reviewer.score) {
         lines.push(`   Score: ${reviewer.score.total}/100`);
     }
     lines.push(`   Reason: ${reviewer.reason}`);
-    // Score breakdown
-    if (reviewer.score?.breakdown) {
+    // Score breakdown (verbose only)
+    if (verbose && reviewer.score?.breakdown) {
         const breakdown = reviewer.score.breakdown;
         const parts = [];
         if (breakdown.contribution > 0)
@@ -123,14 +211,19 @@ function formatReviewerText(reviewer, index) {
     // Workload details
     if (reviewer.workloadDetails) {
         const { current, capacity, utilizationPercent } = reviewer.workloadDetails;
-        lines.push(`   Workload: ${current}/${capacity} MRs (${utilizationPercent}% utilized)`);
+        if (verbose) {
+            lines.push(`   Workload: ${current}/${capacity} MRs (${utilizationPercent}% utilized)`);
+        }
+        else {
+            lines.push(`   Workload: ${current} MRs`);
+        }
     }
-    // FTE
-    if (reviewer.fte !== undefined && reviewer.fte !== 1) {
+    // FTE (verbose only)
+    if (verbose && reviewer.fte !== undefined && reviewer.fte !== 1) {
         lines.push(`   FTE: ${reviewer.fte}`);
     }
-    // Reasoning
-    if (reviewer.reasoning) {
+    // Reasoning (verbose only)
+    if (verbose && reviewer.reasoning) {
         lines.push(`   Details: ${reviewer.reasoning.primary}`);
         if (reviewer.reasoning.factors && reviewer.reasoning.factors.length > 0) {
             reviewer.reasoning.factors.forEach((factor) => {
@@ -140,4 +233,38 @@ function formatReviewerText(reviewer, index) {
     }
     return lines;
 }
+/**
+ * Write structured logs to file
+ *
+ * @param logFile - Path to log file
+ * @param result - Reviewer analysis result
+ * @param options - CLI options
+ */
+function writeLogFile(logFile, result, options) {
+    try {
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            command: 'invite-reviewers',
+            options: {
+                dryRun: options.dryRun,
+                format: options.format,
+                verbose: options.verbose,
+                quiet: options.quiet,
+            },
+            result: {
+                contributorCount: result.contributors.length,
+                teamMemberCount: result.teamMembers.length,
+                codeOwnerCount: result.codeOwners.length,
+                totalSuggestions: result.contributors.length + result.teamMembers.length + result.codeOwners.length,
+            },
+            ...(('metadata' in result) && { metadata: result.metadata }),
+            ...(('commentResult' in result) && { commentResult: result.commentResult }),
+        };
+        writeFileSync(logFile, JSON.stringify(logEntry, null, 2) + '\n', { flag: 'a' });
+    }
+    catch (error) {
+        // Don't fail the main operation if logging fails
+        console.warn(`Warning: Failed to write to log file ${logFile}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 //# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

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

package/dist/cli/parameter-source-tracker.d.ts

@@ -0,0 +1,169 @@
+/**
+ * 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
+ */
+import { Logger } from '../logging/logger.service.js';
+/**
+ * Source types for configuration parameters
+ */
+export type ParameterSource = 'cli-argument' | 'environment' | 'auto-detected' | 'config-file' | 'default' | 'not-set';
+/**
+ * Tracked parameter with its value and source
+ *
+ * @property name - The name of the parameter being tracked
+ * @property value - The resolved value of the parameter (may be undefined if not set)
+ * @property source - The source from which the parameter value was obtained
+ * @property sourceDetail - Additional detail about the source (e.g., env var name, file path)
+ * @property masked - Whether to mask the value in logs (for sensitive data like tokens)
+ */
+export interface TrackedParameter<T = unknown> {
+    name: string;
+    value: T | undefined;
+    source: ParameterSource;
+    sourceDetail?: string;
+    masked?: boolean;
+}
+/**
+ * All tracked parameters for a CLI invocation
+ *
+ * @property repoPath - Local repository path for git analysis
+ * @property project - GitLab project ID or path
+ * @property mergeRequestIid - Merge request internal ID
+ * @property branch - Git branch name for finding merge requests
+ * @property gitlabUrl - GitLab instance URL
+ * @property gitlabToken - GitLab API authentication token
+ * @property format - Output format (json or text)
+ * @property verbose - Enable verbose logging output
+ * @property dryRun - Run without making changes
+ * @property quiet - Suppress non-essential output
+ * @property dataSourceType - Data source type (local-git or gitlab-api)
+ */
+export interface ParameterSources {
+    repoPath: TrackedParameter<string>;
+    project: TrackedParameter<string | number>;
+    mergeRequestIid: TrackedParameter<number>;
+    branch: TrackedParameter<string>;
+    gitlabUrl: TrackedParameter<string>;
+    gitlabToken: TrackedParameter<string>;
+    format: TrackedParameter<'json' | 'text'>;
+    verbose: TrackedParameter<boolean>;
+    dryRun: TrackedParameter<boolean>;
+    quiet: TrackedParameter<boolean>;
+    dataSourceType: TrackedParameter<'local-git' | 'gitlab-api'>;
+}
+/**
+ * Parameter Source Tracker
+ *
+ * Tracks the source of each configuration parameter and provides
+ * comprehensive logging for debugging configuration issues.
+ */
+export declare class ParameterSourceTracker {
+    private parameters;
+    private logger;
+    /**
+     * Creates a new ParameterSourceTracker instance
+     *
+     * @param logger - Logger instance for outputting parameter source information
+     */
+    constructor(logger: Logger);
+    /**
+     * Track a parameter with its value and source
+     */
+    track<T>(name: string, value: T | undefined, source: ParameterSource, options?: {
+        sourceDetail?: string;
+        masked?: boolean;
+    }): void;
+    /**
+     * Resolve a parameter value with source tracking
+     * Implements the precedence: CLI argument > environment variable > auto-detected > config file > default
+     */
+    resolve<T>(name: string, cliValue: T | undefined, envVarName: string | undefined, autoDetectFn?: () => T | undefined, configValue?: T, defaultValue?: T, options?: {
+        masked?: boolean;
+    }): T | undefined;
+    /**
+     * Get all tracked parameters
+     */
+    getAll(): Map<string, TrackedParameter>;
+    /**
+     * 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: string): TrackedParameter | undefined;
+    /**
+     * Log all parameter sources
+     * This implements Requirement 3.5
+     */
+    logParameterSources(): void;
+    /**
+     * Log parameter sources in a structured format (for JSON output)
+     */
+    toStructuredLog(): Record<string, {
+        value: unknown;
+        source: ParameterSource;
+        sourceDetail?: string;
+    }>;
+    /**
+     * Format value for logging (handles masking and undefined)
+     */
+    private formatValueForLog;
+    /**
+     * Format source information for logging
+     */
+    private formatSourceForLog;
+    /**
+     * Convert camelCase to kebab-case
+     */
+    private toKebabCase;
+    /**
+     * Parse environment variable value to appropriate type
+     */
+    private parseEnvValue;
+}
+/**
+ * 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 declare function resolveParametersWithTracking(options: {
+    repoPath?: string;
+    project?: string | number;
+    mergeRequestIid?: number;
+    branch?: string;
+    gitlabUrl?: string;
+    gitlabToken?: string;
+    format?: 'json' | 'text';
+    verbose?: boolean;
+    dryRun?: boolean;
+    quiet?: boolean;
+}, cicdEnv: {
+    isCI: boolean;
+    platform?: string;
+    projectId?: string | number;
+    mergeRequestIid?: number;
+    branch?: string;
+    serverUrl?: string;
+}, logger: Logger): {
+    tracker: ParameterSourceTracker;
+    resolved: {
+        repoPath?: string;
+        project?: string | number;
+        mergeRequestIid?: number;
+        branch?: string;
+        gitlabUrl: string;
+        gitlabToken?: string;
+        format: 'json' | 'text';
+        verbose: boolean;
+        dryRun: boolean;
+        quiet: boolean;
+    };
+};
+//# sourceMappingURL=parameter-source-tracker.d.ts.map

package/dist/cli/parameter-source-tracker.d.ts.map

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