@elsikora/commitizen-plugin-commitlint-ai 2.0.0-dev.1 → 2.0.0

package/README.md

@@ -51,15 +51,18 @@ The plugin is built using clean architecture principles with clear separation of
 ### Layers
 
 - **Domain Layer**: Core business logic, entities, and value objects
+
   - Entities: `CommitMessage`, `LLMConfiguration`
   - Value Objects: `ApiKey`, `CommitBody`, `CommitHeader`
   - Enums: `ECommitMode`, `ELLMProvider`, `ELogLevel`
 
 - **Application Layer**: Use cases and interfaces
+
   - Use Cases: `GenerateCommitMessageUseCase`, `ValidateCommitMessageUseCase`, `ConfigureLLMUseCase`
   - Interfaces: `ILLMService`, `ICommitValidator`, `IConfigService`, etc.
 
 - **Infrastructure Layer**: External services and implementations
+
   - LLM Services: `OpenAILLMService`, `AnthropicLLMService`, `GoogleLLMService`, `AzureOpenAILLMService`, `AWSBedrockLLMService`, `OllamaLLMService`
   - Services: `CommitlintValidatorService`, `CosmicConfigService`, `PromptsCliInterface`
   - Repositories: `GitCommitRepository`
@@ -98,6 +101,7 @@ git cz
 ```
 
 The plugin will:
+
 1. Ask for your commit mode preference (auto/manual)
 2. If auto mode and no API key is configured, guide you through configuration
 3. Generate or help you write a commit message
@@ -130,6 +134,7 @@ The plugin supports multiple configuration methods using [Cosmiconfig](https://g
 ### Configuration File Locations
 
 Create a configuration file in any of these locations:
+
 - `.commitlintairc`
 - `.commitlintairc.json`
 - `.commitlintairc.yaml`
@@ -145,29 +150,29 @@ Create a configuration file in any of these locations:
 ```javascript
 // commitlintai.config.js
 module.exports = {
-  // AI provider: 'openai', 'anthropic', 'google', 'azure-openai', 'aws-bedrock', or 'ollama'
-  provider: 'openai',
-  
-  // Model to use (auto-migrates deprecated models)
-  model: 'gpt-4o',
-  
-  // Mode: 'auto' or 'manual'
-  mode: 'auto',
-  
-  // API key (optional - env vars recommended)
-  // Format varies by provider:
-  // - OpenAI/Anthropic/Google: 'your-api-key'
-  // - Azure OpenAI: 'endpoint|api-key|deployment-name'
-  // - AWS Bedrock: 'region|access-key-id|secret-access-key'
-  // - Ollama: 'host:port' or 'host:port|custom-model-name'
-  apiKey: 'your-api-key',
-  
-  // Retry configuration
-  maxGenerationRetries: 3,
-  maxValidationRetries: 3,
-  
-  // Custom instructions for AI
-  instructions: 'Focus on user-facing changes'
+	// AI provider: 'openai', 'anthropic', 'google', 'azure-openai', 'aws-bedrock', or 'ollama'
+	provider: "openai",
+
+	// Model to use (auto-migrates deprecated models)
+	model: "gpt-4o",
+
+	// Mode: 'auto' or 'manual'
+	mode: "auto",
+
+	// API key (optional - env vars recommended)
+	// Format varies by provider:
+	// - OpenAI/Anthropic/Google: 'your-api-key'
+	// - Azure OpenAI: 'endpoint|api-key|deployment-name'
+	// - AWS Bedrock: 'region|access-key-id|secret-access-key'
+	// - Ollama: 'host:port' or 'host:port|custom-model-name'
+	apiKey: "your-api-key",
+
+	// Retry configuration
+	maxGenerationRetries: 3,
+	maxValidationRetries: 3,
+
+	// Custom instructions for AI
+	instructions: "Focus on user-facing changes",
 };
 ```
 
@@ -176,19 +181,21 @@ module.exports = {
 ## Supported LLM Providers
 
 ### OpenAI
+
 - `gpt-4.1` (Latest 2025, most capable)
 - `gpt-4.1-nano` (Fastest 4.1 model)
 - `gpt-4.1-mini` (Balanced performance)
 - `gpt-4o` (Enhanced creative writing)
 - `gpt-4o-mini` (Faster, cost-effective)
-- `gpt-4-turbo` 
+- `gpt-4-turbo`
 - `gpt-4` (Original)
 - `gpt-3.5-turbo` (Fastest, most economical)
 - `o1` (Enhanced reasoning)
 - `o1-mini` (Fast reasoning)
 
 ### Anthropic
-- `claude-opus-4-20250514` (Latest 2025, most capable) 
+
+- `claude-opus-4-20250514` (Latest 2025, most capable)
 - `claude-sonnet-4-20250514` (Latest 2025, high-performance)
 - `claude-3-7-sonnet-latest` (Extended thinking capabilities)
 - `claude-3-5-sonnet-latest` (Previous flagship)
@@ -196,6 +203,7 @@ module.exports = {
 - `claude-3-opus-latest` (Complex tasks)
 
 ### Google (Gemini)
+
 - `gemini-2.5-pro` (Latest 2025, most capable)
 - `gemini-2.5-flash` (Latest 2025, fast)
 - `gemini-2.0-flash-exp` (Experimental)
@@ -205,12 +213,14 @@ module.exports = {
 - `gemini-1.0-pro`
 
 ### Google (Gemma - Open Models for Vertex AI)
+
 - `gemma-3-27b` (Most capable open model)
 - `gemma-3-12b` (Strong language capabilities)
 - `gemma-3-4b` (Balanced, multimodal support)
 - `gemma-3-1b` (Lightweight for edge deployment)
 
 ### Azure OpenAI
+
 - `gpt-4.1-turbo-2024-12-17` (Latest 2025, most capable)
 - `gpt-4.1-preview-2024-12-17` (Latest preview)
 - `gpt-4.1-mini-2024-12-17` (Fast 4.1 model)
@@ -222,6 +232,7 @@ module.exports = {
 - `o4-mini-2024-12-17` (Fast reasoning)
 
 ### AWS Bedrock
+
 - `anthropic.claude-opus-4-20250514-v1:0` (Claude Opus 4 - Latest 2025, most capable)
 - `anthropic.claude-sonnet-4-20250514-v1:0` (Claude Sonnet 4 - Latest 2025, balanced)
 - `anthropic.claude-3-5-sonnet-20241022-v2:0` (Claude 3.5 Sonnet v2)
@@ -233,6 +244,7 @@ module.exports = {
 - `mistral.mistral-large-2411-v1:0` (Latest Mistral)
 
 ### Ollama (Local Models)
+
 - `llama3.2` (Latest Llama)
 - `llama3.1`
 - `llama3`
@@ -246,14 +258,14 @@ module.exports = {
 ```javascript
 // commitlint.config.js
 export default {
-  extends: ['@commitlint/config-conventional'],
-  rules: {
-    'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor']],
-    'scope-case': [2, 'always', 'lower-case'],
-    'subject-max-length': [2, 'always', 72],
-    'body-max-line-length': [2, 'always', 100]
-  }
-}
+	extends: ["@commitlint/config-conventional"],
+	rules: {
+		"type-enum": [2, "always", ["feat", "fix", "docs", "style", "refactor"]],
+		"scope-case": [2, "always", "lower-case"],
+		"subject-max-length": [2, "always", 72],
+		"body-max-line-length": [2, "always", 100],
+	},
+};
 ```
 
 ### Manual Mode
@@ -270,36 +282,36 @@ touch .elsikora/manual
 
 ```json
 {
-  "commitlintai": {
-    "provider": "anthropic",
-    "model": "claude-3-5-sonnet-20241022",
-    "mode": "auto",
-    "maxGenerationRetries": 5
-  }
+	"commitlintai": {
+		"provider": "anthropic",
+		"model": "claude-3-5-sonnet-20241022",
+		"mode": "auto",
+		"maxGenerationRetries": 5
+	}
 }
 ```
 
 ## 🛣 Roadmap
 
-| Task / Feature                                                            | Status      |
-| ------------------------------------------------------------------------- | ----------- |
-| AI-powered commit message generation using OpenAI or Anthropic models     | ✅ Complete |
-| Full integration with Commitlint rules and configuration                  | ✅ Complete |
-| Support for both manual and automatic commit modes                        | ✅ Complete |
-| Clean architecture implementation                                         | ✅ Complete |
-| Cosmiconfig support for flexible configuration                           | ✅ Complete |
-| Environment variable support with priority over config                    | ✅ Complete |
-| Automatic model migration for deprecated models                          | ✅ Complete |
-| Configurable retry mechanism with UI feedback                           | ✅ Complete |
-| Dependency injection with @elsikora/cladi                               | ✅ Complete |
-| Support for more AI providers (Google, Azure, AWS, Ollama)              | ✅ Complete |
-| Enhanced diff analysis for better commit suggestions                     | 🚧 Planned  |
-| Custom prompt templates per project                                      | 🚧 Planned  |
-| Integration with more Git hosting platforms                              | 🚧 Planned  |
-| Performance optimizations for large codebases                            | 🚧 Planned  |
-| Multi-language support for commit messages                               | 🚧 Planned  |
-| Team collaboration features                                              | 🚧 Planned  |
-| Web UI for configuration management                                      | 🚧 Planned  |
+| Task / Feature                                                        | Status      |
+| --------------------------------------------------------------------- | ----------- |
+| AI-powered commit message generation using OpenAI or Anthropic models | ✅ Complete |
+| Full integration with Commitlint rules and configuration              | ✅ Complete |
+| Support for both manual and automatic commit modes                    | ✅ Complete |
+| Clean architecture implementation                                     | ✅ Complete |
+| Cosmiconfig support for flexible configuration                        | ✅ Complete |
+| Environment variable support with priority over config                | ✅ Complete |
+| Automatic model migration for deprecated models                       | ✅ Complete |
+| Configurable retry mechanism with UI feedback                         | ✅ Complete |
+| Dependency injection with @elsikora/cladi                             | ✅ Complete |
+| Support for more AI providers (Google, Azure, AWS, Ollama)            | ✅ Complete |
+| Enhanced diff analysis for better commit suggestions                  | 🚧 Planned  |
+| Custom prompt templates per project                                   | 🚧 Planned  |
+| Integration with more Git hosting platforms                           | 🚧 Planned  |
+| Performance optimizations for large codebases                         | 🚧 Planned  |
+| Multi-language support for commit messages                            | 🚧 Planned  |
+| Team collaboration features                                           | 🚧 Planned  |
+| Web UI for configuration management                                   | 🚧 Planned  |
 
 ## ❓ FAQ
 
@@ -323,6 +335,7 @@ A: Set the model to `custom` and include the model name in your API key: `localh
 
 **Q: What's the difference between provider API key formats?**  
 A: Each provider has specific requirements:
+
 - OpenAI/Anthropic/Google: Simple API key string
 - Azure OpenAI: `endpoint|api-key|deployment-name`
 - AWS Bedrock: `region|access-key-id|secret-access-key`

package/dist/cjs/application/constant/config-file-directory.constant.d.ts

@@ -2,4 +2,3 @@
  * Directory where configuration files are stored
  */
 export declare const CONFIG_FILE_DIRECTORY: string;
-//# sourceMappingURL=config-file-directory.constant.d.ts.map

package/dist/cjs/application/constant/config-module-name.constant.d.ts

@@ -2,4 +2,3 @@
  * Module name for configuration
  */
 export declare const CONFIG_MODULE_NAME: string;
-//# sourceMappingURL=config-module-name.constant.d.ts.map

package/dist/cjs/application/constant/index.d.ts

@@ -1,3 +1,2 @@
-export * from "./config-file-directory.constant.js";
-export * from "./config-module-name.constant.js";
-//# sourceMappingURL=index.d.ts.map
+export * from './config-file-directory.constant';
+export * from './config-module-name.constant';

package/dist/cjs/application/index.d.ts

@@ -1,3 +1,2 @@
-export type * from "./interface/index.js";
-export * from "./use-case/index.js";
-//# sourceMappingURL=index.d.ts.map
+export type * from './interface/index';
+export * from './use-case/index';

package/dist/cjs/application/interface/cli-interface-service-select-options.interface.d.ts

@@ -19,4 +19,3 @@ export interface ICliInterfaceServiceSelectOptions {
      */
     value: string;
 }
-//# sourceMappingURL=cli-interface-service-select-options.interface.d.ts.map

package/dist/cjs/application/interface/cli-interface-service.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICliInterfaceServiceSelectOptions } from "./cli-interface-service-select-options.interface.js";
+import type { ICliInterfaceServiceSelectOptions } from './cli-interface-service-select-options.interface';
 /**
  * Interface for CLI user interaction services.
  * Provides methods for displaying information and collecting input from users.
@@ -103,4 +103,3 @@ export interface ICliInterfaceService {
      */
     warn(message: string): void;
 }
-//# sourceMappingURL=cli-interface-service.interface.d.ts.map

package/dist/cjs/application/interface/command-service.interface.d.ts

@@ -17,4 +17,3 @@ export interface ICommandService {
      */
     executeWithOutput(command: string): Promise<string>;
 }
-//# sourceMappingURL=command-service.interface.d.ts.map

package/dist/cjs/application/interface/commit-repository.interface.d.ts

@@ -1,4 +1,4 @@
-import type { CommitMessage } from "../../domain/entity/commit-message.entity.js";
+import type { CommitMessage } from '../../domain/entity/commit-message.entity';
 /**
  * Interface for commit repository operations
  */
@@ -30,4 +30,3 @@ export interface ICommitRepository {
      */
     hasStagedChanges(): Promise<boolean>;
 }
-//# sourceMappingURL=commit-repository.interface.d.ts.map

package/dist/cjs/application/interface/commit-validator.interface.d.ts

@@ -1,5 +1,5 @@
-import type { CommitMessage } from "../../domain/entity/commit-message.entity.js";
-import type { ILlmPromptContext } from "./llm-service.interface.js";
+import type { CommitMessage } from '../../domain/entity/commit-message.entity';
+import type { ILlmPromptContext } from './llm-service.interface';
 /**
  * Validation result for a commit message
  */
@@ -27,4 +27,3 @@ export interface ICommitValidator {
      */
     validate(message: CommitMessage): Promise<ICommitValidationResult>;
 }
-//# sourceMappingURL=commit-validator.interface.d.ts.map

package/dist/cjs/application/interface/config-service.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IConfig } from "./config.interface.js";
-import type { IFileSystemService } from "./file-system-service.interface.js";
+import type { IConfig } from './config.interface';
+import type { IFileSystemService } from './file-system-service.interface';
 /**
  * Interface for managing application configuration.
  * Defines contract for reading, writing, and manipulating configuration settings.
@@ -45,4 +45,3 @@ export interface IConfigService {
      */
     setProperty<K extends keyof IConfig>(property: K, value: IConfig[K]): Promise<void>;
 }
-//# sourceMappingURL=config-service.interface.d.ts.map

package/dist/cjs/application/interface/config.interface.d.ts

@@ -1,5 +1,5 @@
-import type { ECommitMode } from "../../domain/enum/commit-mode.enum.js";
-import type { ELLMProvider } from "../../domain/enum/llm-provider.enum.js";
+import type { ECommitMode } from '../../domain/enum/commit-mode.enum';
+import type { ELLMProvider } from '../../domain/enum/llm-provider.enum';
 /**
  * Main configuration interface
  */
@@ -25,4 +25,3 @@ export interface IConfig {
      */
     validationMaxRetries?: number;
 }
-//# sourceMappingURL=config.interface.d.ts.map

package/dist/cjs/application/interface/file-system-service.interface.d.ts

@@ -59,4 +59,3 @@ export interface IFileSystemService {
      */
     writeFile(path: string, content: string, encoding?: BufferEncoding): Promise<void>;
 }
-//# sourceMappingURL=file-system-service.interface.d.ts.map

package/dist/cjs/application/interface/index.d.ts

@@ -1,10 +1,9 @@
-export type * from "./cli-interface-service-select-options.interface.js";
-export type * from "./cli-interface-service.interface.js";
-export type * from "./command-service.interface.js";
-export type * from "./commit-repository.interface.js";
-export type * from "./commit-validator.interface.js";
-export type * from "./config-service.interface.js";
-export type * from "./config.interface.js";
-export type * from "./file-system-service.interface.js";
-export type * from "./llm-service.interface.js";
-//# sourceMappingURL=index.d.ts.map
+export type * from './cli-interface-service-select-options.interface';
+export type * from './cli-interface-service.interface';
+export type * from './command-service.interface';
+export type * from './commit-repository.interface';
+export type * from './commit-validator.interface';
+export type * from './config-service.interface';
+export type * from './config.interface';
+export type * from './file-system-service.interface';
+export type * from './llm-service.interface';

package/dist/cjs/application/interface/llm-service.interface.d.ts

@@ -1,5 +1,5 @@
-import type { CommitMessage } from "../../domain/entity/commit-message.entity.js";
-import type { LLMConfiguration } from "../../domain/entity/llm-configuration.entity.js";
+import type { CommitMessage } from '../../domain/entity/commit-message.entity';
+import type { LLMConfiguration } from '../../domain/entity/llm-configuration.entity';
 /**
  * Context for generating commit messages
  */
@@ -41,4 +41,3 @@ export interface ILlmService {
      */
     supports(configuration: LLMConfiguration): boolean;
 }
-//# sourceMappingURL=llm-service.interface.d.ts.map

package/dist/cjs/application/use-case/configure-llm.use-case.d.ts

@@ -1,7 +1,7 @@
-import type { ECommitMode } from "../../domain/enum/commit-mode.enum.js";
-import type { ICliInterfaceService } from "../interface/cli-interface-service.interface.js";
-import type { IConfigService } from "../interface/config-service.interface.js";
-import { LLMConfiguration } from "../../domain/entity/llm-configuration.entity.js";
+import type { ICliInterfaceService } from '../interface/cli-interface-service.interface';
+import type { IConfigService } from '../interface/config-service.interface';
+import { LLMConfiguration } from '../../domain/entity/llm-configuration.entity';
+import { ECommitMode } from '../../domain/enum/commit-mode.enum';
 /**
  * Use case for configuring LLM settings
  */
@@ -11,29 +11,29 @@ export declare class ConfigureLLMUseCase {
     constructor(configService: IConfigService, cliInterface: ICliInterfaceService);
     /**
      * Configure LLM settings interactively
-     * @returns Promise resolving to the new configuration
+     * @returns {Promise<LLMConfiguration>} Promise resolving to the new configuration
      */
     configureInteractively(): Promise<LLMConfiguration>;
     /**
      * Get the current LLM configuration
-     * @returns Promise resolving to the current configuration or null if not configured
+     * @returns {Promise<LLMConfiguration | null>} Promise resolving to the current configuration or null if not configured
      */
     getCurrentConfiguration(): Promise<LLMConfiguration | null>;
     /**
      * Check if the current configuration needs LLM details
-     * @returns Promise resolving to true if LLM details are needed
+     * @returns {Promise<boolean>} Promise resolving to true if LLM details are needed
      */
     needsLLMDetails(): Promise<boolean>;
     /**
      * Save LLM configuration
-     * @param configuration - The configuration to save
+     * @param {LLMConfiguration} configuration - The configuration to save
+     * @returns {Promise<void>} Promise that resolves when configuration is saved
      */
     saveConfiguration(configuration: LLMConfiguration): Promise<void>;
     /**
      * Update the commit mode
-     * @param mode - The new commit mode
-     * @returns Promise resolving to the updated configuration
+     * @param {ECommitMode} mode - The new commit mode
+     * @returns {Promise<LLMConfiguration | null>} Promise resolving to the updated configuration
      */
     updateMode(mode: ECommitMode): Promise<LLMConfiguration | null>;
 }
-//# sourceMappingURL=configure-llm.use-case.d.ts.map

package/dist/cjs/application/use-case/configure-llm.use-case.js

@@ -5,6 +5,7 @@ var llmConfiguration_entity = require('../../domain/entity/llm-configuration.ent
 var anthropicModel_enum = require('../../domain/enum/anthropic-model.enum.js');
 var awsBedrockModel_enum = require('../../domain/enum/aws-bedrock-model.enum.js');
 var azureOpenaiModel_enum = require('../../domain/enum/azure-openai-model.enum.js');
+var commitMode_enum = require('../../domain/enum/commit-mode.enum.js');
 var googleModel_enum = require('../../domain/enum/google-model.enum.js');
 var llmProvider_enum = require('../../domain/enum/llm-provider.enum.js');
 var ollamaModel_enum = require('../../domain/enum/ollama-model.enum.js');
@@ -23,16 +24,16 @@ class ConfigureLLMUseCase {
     }
     /**
      * Configure LLM settings interactively
-     * @returns Promise resolving to the new configuration
+     * @returns {Promise<LLMConfiguration>} Promise resolving to the new configuration
      */
     async configureInteractively() {
         // First, select mode
         const mode = await this.CLI_INTERFACE.select("Select commit mode:", [
-            { label: "Auto (AI-powered)", value: "auto" },
-            { label: "Manual", value: "manual" },
-        ], "auto");
+            { label: "Auto (AI-powered)", value: commitMode_enum.ECommitMode.AUTO },
+            { label: "Manual", value: commitMode_enum.ECommitMode.MANUAL },
+        ], commitMode_enum.ECommitMode.AUTO);
         // If manual mode, create a minimal configuration
-        if (mode === "manual") {
+        if (mode === commitMode_enum.ECommitMode.MANUAL) {
             // Create configuration with dummy values for manual mode
             const configuration = new llmConfiguration_entity.LLMConfiguration("openai", // Default provider (won't be used)
             new apiKey_valueObject.ApiKey("manual-mode"), // Dummy API key
@@ -146,7 +147,7 @@ class ConfigureLLMUseCase {
             }
         }
         // Get API key
-        let apiKeyValue;
+        let credentialValue;
         // Check environment variables first
         const environmentVariableNames = {
             anthropic: "ANTHROPIC_API_KEY",
@@ -156,11 +157,11 @@ class ConfigureLLMUseCase {
             ollama: "OLLAMA_API_KEY",
             openai: "OPENAI_API_KEY",
         };
-        const environmentVariableName = environmentVariableNames[provider] || "";
+        const environmentVariableName = environmentVariableNames[provider] ?? "";
         const environmentApiKey = process.env[environmentVariableName];
         if (environmentApiKey && environmentApiKey.trim().length > 0) {
             this.CLI_INTERFACE.success(`Found API key in environment variable: ${environmentVariableName}`);
-            apiKeyValue = environmentApiKey;
+            credentialValue = environmentApiKey;
         }
         else {
             // Inform user about environment variable and format requirements
@@ -201,7 +202,7 @@ class ConfigureLLMUseCase {
             }
             this.CLI_INTERFACE.info(`API key will be read from ${environmentVariableName} environment variable${keyFormatInfo} or prompted each time.`);
             // Use dummy value for configuration
-            apiKeyValue = "will-prompt-on-use";
+            credentialValue = "will-prompt-on-use";
         }
         // Ask for retry configuration (advanced settings)
         const shouldConfigureAdvanced = await this.CLI_INTERFACE.confirm("Would you like to configure advanced settings (retry counts)?", false);
@@ -213,6 +214,8 @@ class ConfigureLLMUseCase {
                 if (Number.isNaN(parsedNumber) || parsedNumber < numeric_constant.MIN_RETRY_COUNT || parsedNumber > numeric_constant.MAX_RETRY_COUNT) {
                     return "Please enter a number between 1 and 10";
                 }
+                // eslint-disable-next-line @elsikora/sonar/no-redundant-jump
+                return;
             });
             maxRetries = Number.parseInt(retriesString, 10);
             const validationRetriesString = await this.CLI_INTERFACE.text("Max retries for validation fixes (default: 3):", "3", "3", (value) => {
@@ -220,12 +223,14 @@ class ConfigureLLMUseCase {
                 if (Number.isNaN(parsedNumber) || parsedNumber < numeric_constant.MIN_RETRY_COUNT || parsedNumber > numeric_constant.MAX_RETRY_COUNT) {
                     return "Please enter a number between 1 and 10";
                 }
+                // eslint-disable-next-line @elsikora/sonar/no-redundant-jump
+                return;
             });
             validationMaxRetries = Number.parseInt(validationRetriesString, 10);
         }
         // Create configuration
         // Create configuration - will save without API key
-        const configuration = new llmConfiguration_entity.LLMConfiguration(provider, new apiKey_valueObject.ApiKey(apiKeyValue), mode, model, maxRetries, validationMaxRetries);
+        const configuration = new llmConfiguration_entity.LLMConfiguration(provider, new apiKey_valueObject.ApiKey(credentialValue), mode, model, maxRetries, validationMaxRetries);
         // Save configuration (without API key)
         await this.saveConfiguration(configuration);
         this.CLI_INTERFACE.success("Configuration saved successfully!");
@@ -235,7 +240,7 @@ class ConfigureLLMUseCase {
     }
     /**
      * Get the current LLM configuration
-     * @returns Promise resolving to the current configuration or null if not configured
+     * @returns {Promise<LLMConfiguration | null>} Promise resolving to the current configuration or null if not configured
      */
     async getCurrentConfiguration() {
         const config = await this.CONFIG_SERVICE.get();
@@ -290,7 +295,7 @@ class ConfigureLLMUseCase {
             }
         }
         // For manual mode, return configuration with dummy API key
-        if (config.mode === "manual") {
+        if (config.mode === commitMode_enum.ECommitMode.MANUAL) {
             return new llmConfiguration_entity.LLMConfiguration(config.provider, new apiKey_valueObject.ApiKey("manual-mode"), config.mode, migratedModel, config.maxRetries ?? numeric_constant.DEFAULT_MAX_RETRIES, config.validationMaxRetries ?? numeric_constant.DEFAULT_VALIDATION_MAX_RETRIES);
         }
         // For auto mode, check environment variables
@@ -302,7 +307,7 @@ class ConfigureLLMUseCase {
             ollama: "OLLAMA_API_KEY",
             openai: "OPENAI_API_KEY",
         };
-        const environmentVariableName = environmentVariableNames[config.provider] || "";
+        const environmentVariableName = environmentVariableNames[config.provider] ?? "";
         const environmentApiKey = process.env[environmentVariableName];
         // If no API key in environment, return null (will prompt later)
         if (!environmentApiKey || environmentApiKey.trim().length === 0) {
@@ -312,11 +317,11 @@ class ConfigureLLMUseCase {
     }
     /**
      * Check if the current configuration needs LLM details
-     * @returns Promise resolving to true if LLM details are needed
+     * @returns {Promise<boolean>} Promise resolving to true if LLM details are needed
      */
     async needsLLMDetails() {
         const config = await this.CONFIG_SERVICE.get();
-        if (!config.mode || config.mode === "manual") {
+        if (!config.mode || config.mode === commitMode_enum.ECommitMode.MANUAL) {
             return false;
         }
         // For auto mode, check if API key is in environment
@@ -328,14 +333,15 @@ class ConfigureLLMUseCase {
             ollama: "OLLAMA_API_KEY",
             openai: "OPENAI_API_KEY",
         };
-        const environmentVariableName = environmentVariableNames[config.provider] || "";
+        const environmentVariableName = environmentVariableNames[config.provider] ?? "";
         const environmentApiKey = process.env[environmentVariableName];
         // Need details if no API key in environment
         return !environmentApiKey || environmentApiKey.trim().length === 0;
     }
     /**
      * Save LLM configuration
-     * @param configuration - The configuration to save
+     * @param {LLMConfiguration} configuration - The configuration to save
+     * @returns {Promise<void>} Promise that resolves when configuration is saved
      */
     async saveConfiguration(configuration) {
         const config = {
@@ -349,8 +355,8 @@ class ConfigureLLMUseCase {
     }
     /**
      * Update the commit mode
-     * @param mode - The new commit mode
-     * @returns Promise resolving to the updated configuration
+     * @param {ECommitMode} mode - The new commit mode
+     * @returns {Promise<LLMConfiguration | null>} Promise resolving to the updated configuration
      */
     async updateMode(mode) {
         const current = await this.getCurrentConfiguration();