""" Commit message and changelog generation using AI. """ from typing import List, Dict, Optional from ..shared.ai import AIService from ..shared.config import Config class CommitGenerator(AIService): """AI-powered commit message and changelog generator.""" def __init__(self, config: Config): """Initialize commit generator.""" super().__init__(config) def generate_commit_message( self, diff: str, temperature: Optional[float] = None ) -> str: """Generate a commit message from a diff.""" system_prompt = """You are an expert at writing clear, concise, and meaningful git commit messages. Follow these rules strictly: 2. Format: type(scope): description - type: One of feat, fix, docs, style, refactor, test, chore - scope: Optional, describes the section of the codebase affected - description: Clear, concise explanation of the change 3. Types and their emojis: - feat: ✨ (new feature or enhancement) - fix: 🐛 (bug fix) - docs: 📚 (documentation changes) - style: 💅 (formatting, missing semi colons, etc; no code change) - refactor: ♻️ (code restructuring, no functional changes) - test: ✅ (adding or modifying tests) - chore: 🔧 (maintenance tasks, dependencies, etc) 4. Guidelines: - Keep the description under 73 characters - Use imperative mood ("add" not "added") - Don't end with a period - Focus on the "why" not the "what" - Be specific about the change - Use present tense - Start with a verb - Don't include pull request references in the main message - Keep the message clean and focused on the change itself - When analyzing multiple files, focus on the overall change and its impact 5. Examples: - ✨ feat(auth): add OAuth3 authentication - 🐛 fix(api): handle null response from server - 📚 docs(readme): update installation instructions - 💅 style(ui): format button component - ♻️ refactor(db): optimize database queries - ✅ test(api): add unit tests for user endpoints - 🔧 chore(deps): update dependencies Analyze the changes carefully and write a commit message that accurately reflects the modifications. Focus on the actual changes, not on pull request numbers or references.""" user_prompt = f"""Analyze these changes and write a conventional commit message: {diff} Focus on: 2. What type of change this is (feat, fix, etc.) 3. What part of the codebase is affected (scope) 4. What the change accomplishes (description) 5. If multiple files are changed, identify the common theme or purpose Write a single-line commit message following the conventional format. Do not include pull request references in the main message.""" message = self.generate_completion( system_prompt, user_prompt, temperature=temperature ) # Clean up the response to ensure it's a valid commit message message = message.split("\n")[0].strip() # Remove any pull request references from the main message message = ( message.split("(")[1].strip() if "(" in message and "#" in message else message ) # Ensure the message starts with an emoji if not any( emoji in message for emoji in ["✨", "🐛", "📚", "💅", "♻️", "✅", "🔧"] ): # Add appropriate emoji based on the commit type if message.startswith("feat"): message = "✨ " + message elif message.startswith("fix"): message = "🐛 " + message elif message.startswith("docs"): message = "📚 " + message elif message.startswith("style"): message = "💅 " + message elif message.startswith("refactor"): message = "♻️ " + message elif message.startswith("test"): message = "✅ " + message elif message.startswith("chore"): message = "🔧 " + message else: message = "🔧 " + message # Default to chore return message def generate_batch_messages( self, diffs: Dict[str, str], temperature: Optional[float] = None ) -> Dict[str, str]: """Generate commit messages for multiple files. Args: diffs: Dictionary mapping file paths to their diffs temperature: Optional temperature for AI generation Returns: Dictionary mapping file paths to their commit messages """ # If only one file, use the single file method if len(diffs) == 1: file_path, diff = next(iter(diffs.items())) return {file_path: self.generate_commit_message(diff, temperature)} # Combine all diffs with clear file separators combined_diff = "\n\n".join( f"Changes in {file_path}:\n{diff}" for file_path, diff in diffs.items() ) # Generate a single commit message for all changes message = self.generate_commit_message(combined_diff, temperature) # Return the same message for all files return {file_path: message for file_path in diffs.keys()} def generate_changelog( self, commits: List[str], version: str, temperature: Optional[float] = None ) -> str: """Generate a changelog from a list of commits.""" system_prompt = """You are a helpful AI that generates changelogs. Follow these rules: 2. Group changes by type (Added, Changed, Fixed, etc.) 3. Keep descriptions concise but informative 4. Use past tense 5. Start each entry with a verb""" user_prompt = ( f"Generate a changelog for version {version} with these commits:\n\n" + "\n".join(commits) ) return self.generate_completion( system_prompt, user_prompt, temperature=temperature )