@entro314labs/ai-changelog-generator 3.2.1 → 3.6.0

package/src/domains/changelog/changelog.service.js

@@ -2,15 +2,22 @@ import path from 'node:path'
 import process from 'node:process'
 
 import colors from '../../shared/constants/colors.js'
+import { EnhancedConsole } from '../../shared/utils/cli-ui.js'
+import { DiffProcessor } from '../../shared/utils/diff-processor.js'
 import {
+  assessFileImportance,
+  categorizeFile,
+  detectLanguage,
+  getWorkingDirectoryChanges,
   handleUnifiedOutput,
   markdownCommitLink,
   markdownCommitRangeLink,
+  markdownIssueLink,
   parseConventionalCommit,
   processIssueReferences,
   sleep,
+  summarizeFileChanges,
 } from '../../shared/utils/utils.js'
-import { WorkspaceChangelogService } from './workspace-changelog.service.js'
 
 export class ChangelogService {
   constructor(gitService, aiAnalysisService, analysisEngine = null, configManager = null) {
@@ -18,16 +25,16 @@ export class ChangelogService {
     this.aiAnalysisService = aiAnalysisService
     this.analysisEngine = analysisEngine
     this.configManager = configManager
-    this.workspaceChangelogService = new WorkspaceChangelogService(aiAnalysisService, gitService)
   }
 
   /**
    * Generates a changelog from committed changes (git history)
    * @param {string} version - Version number for the release
    * @param {string} since - Generate changelog since this date/commit
+   * @param {Object} options - Additional options (dryRun, etc.)
    * @returns {Promise<string>} Complete changelog content
    */
-  async generateChangelog(version = null, since = null) {
+  async generateChangelog(version = null, since = null, options = {}) {
     console.log(colors.processingMessage('🤖 Analyzing changes with AI...'))
 
     // Get committed changes
@@ -89,7 +96,12 @@ export class ChangelogService {
     // Write changelog to file using existing utility
     const filename = version && version !== 'latest' ? `CHANGELOG-${version}.md` : 'AI_CHANGELOG.md'
     const outputFile = path.join(process.cwd(), filename)
-    handleUnifiedOutput(changelog, { format: 'markdown', outputFile, silent: false })
+    handleUnifiedOutput(changelog, {
+      format: 'markdown',
+      outputFile,
+      silent: false,
+      dryRun: options.dryRun,
+    })
 
     return {
       changelog,
@@ -597,7 +609,7 @@ export class ChangelogService {
    */
   async generateChangelogFromChanges(version = null) {
     // Use the proper WorkspaceChangelogService with optimized single AI call approach
-    const result = await this.workspaceChangelogService.generateWorkspaceChangelog(version, {
+    const result = await this.generateWorkspaceChangelog(version, {
       analysisMode: 'detailed', // Use detailed mode for better analysis
     })
 
@@ -620,11 +632,10 @@ export class ChangelogService {
    */
   async buildWorkingDirectorySection(workingDirAnalysis) {
     // Use the optimized WorkspaceChangelogService for consistent formatting
-    const workspaceResult =
-      await this.workspaceChangelogService.generateCommitStyleWorkingDirectoryEntries({
-        analysisMode: 'detailed',
-        workingDirAnalysis,
-      })
+    const workspaceResult = await this.generateCommitStyleWorkingDirectoryEntries({
+      analysisMode: 'detailed',
+      workingDirAnalysis,
+    })
 
     if (!workspaceResult?.entries || workspaceResult.entries.length === 0) {
       return ''
@@ -1639,11 +1650,9 @@ export class ChangelogService {
 
     // Configuration changes
     if (path?.includes('package.json')) {
-      if (addedContent.includes('"dependencies"') || addedContent.includes('"devDependencies"')) {
-        changes.push('updated dependencies')
-      }
-      if (addedContent.includes('"scripts"')) {
-        changes.push('modified scripts')
+      const configChanges = this.analyzePackageJsonChanges(addedContent, removedContent)
+      if (configChanges.length > 0) {
+        changes.push(...configChanges)
       }
     }
 
@@ -2043,11 +2052,15 @@ export class ChangelogService {
   }
 
   generateJSONChangelog(data) {
-    return JSON.stringify({
-      version: data.version || 'Unreleased',
-      changes: data.changes || [],
-      metadata: data.metadata || {}
-    }, null, 2)
+    return JSON.stringify(
+      {
+        version: data.version || 'Unreleased',
+        changes: data.changes || [],
+        metadata: data.metadata || {},
+      },
+      null,
+      2
+    )
   }
 
   generatePlainTextChangelog(data) {
@@ -2058,7 +2071,7 @@ export class ChangelogService {
     return {
       versions: [],
       format: 'markdown',
-      metadata: {}
+      metadata: {},
     }
   }
 
@@ -2070,14 +2083,14 @@ export class ChangelogService {
     return {
       valid: true,
       issues: [],
-      score: 100
+      score: 100,
     }
   }
 
   optimizeChangelogStructure(content) {
     return {
       optimized: content,
-      improvements: []
+      improvements: [],
     }
   }
 
@@ -2085,14 +2098,14 @@ export class ChangelogService {
     return {
       structure: 'standard',
       sections: ['unreleased', 'versions'],
-      completeness: 90
+      completeness: 90,
     }
   }
 
   detectChangelogPatterns(content) {
     return {
       patterns: ['keepachangelog', 'conventional'],
-      confidence: 'high'
+      confidence: 'high',
     }
   }
 
@@ -2100,7 +2113,7 @@ export class ChangelogService {
     return {
       compliant: true,
       standard: 'keepachangelog',
-      violations: []
+      violations: [],
     }
   }
 
@@ -2108,7 +2121,7 @@ export class ChangelogService {
     return {
       score: 85,
       strengths: ['consistent format'],
-      weaknesses: []
+      weaknesses: [],
     }
   }
 
@@ -2116,7 +2129,7 @@ export class ChangelogService {
     return {
       similarity: 75,
       differences: [],
-      recommendations: []
+      recommendations: [],
     }
   }
 
@@ -2124,21 +2137,21 @@ export class ChangelogService {
     return {
       title: 'Changelog',
       format: 'keepachangelog',
-      versions: []
+      versions: [],
     }
   }
 
   identifyMissingEntries(commits, changelog) {
     return {
       missing: [],
-      suggestions: []
+      suggestions: [],
     }
   }
 
   suggestImprovements(changelog) {
     return {
       improvements: [],
-      priority: 'low'
+      priority: 'low',
     }
   }
 
@@ -2146,7 +2159,585 @@ export class ChangelogService {
     return {
       versions: 0,
       entries: 0,
-      lastUpdate: null
+      lastUpdate: null,
+    }
+  }
+
+  // Workspace changelog methods (formerly in WorkspaceChangelogService)
+  async generateWorkspaceChangelog(version = null, options = {}) {
+    const result = await this.generateComprehensiveWorkspaceChangelog(options)
+
+    if (!result) {
+      return null
+    }
+
+    let changelog = result.changelog
+
+    // Add version information if provided
+    if (version) {
+      changelog = changelog.replace(
+        /# Working Directory Changelog/,
+        `# Working Directory Changelog - Version ${version}`
+      )
+    }
+
+    // Add context information for detailed modes
+    if (options.analysisMode === 'detailed' || options.analysisMode === 'enterprise') {
+      changelog += this.generateContextSection(result.context)
+    }
+
+    return {
+      ...result,
+      changelog,
+      version,
+    }
+  }
+
+  async generateComprehensiveWorkspaceChangelog(options = {}) {
+    try {
+      // Get working directory changes as raw array
+      const rawChanges = getWorkingDirectoryChanges()
+
+      if (!(rawChanges && Array.isArray(rawChanges)) || rawChanges.length === 0) {
+        EnhancedConsole.info('No changes detected in working directory.')
+        return null
+      }
+
+      // Enhanced analysis of changes with diff content for AI analysis
+      const enhancedChanges = await this.enhanceChangesWithDiff(rawChanges)
+      const changesSummary = summarizeFileChanges(enhancedChanges)
+
+      // Use DiffProcessor for intelligent processing
+      const analysisMode = options.analysisMode || 'standard'
+      const diffProcessor = new DiffProcessor({
+        analysisMode,
+        enableFiltering: true,
+        enablePatternDetection: true,
+      })
+
+      const processedResult = diffProcessor.processFiles(enhancedChanges)
+
+      // Generate changelog content with processed files
+      const changelog = await this.generateWorkspaceChangelogContent(
+        processedResult.processedFiles,
+        changesSummary,
+        processedResult,
+        analysisMode
+      )
+
+      return {
+        changelog,
+        changes: enhancedChanges,
+        processedFiles: processedResult.processedFiles,
+        patterns: processedResult.patterns,
+        summary: changesSummary,
+        filesProcessed: processedResult.filesProcessed,
+        filesSkipped: processedResult.filesSkipped,
+      }
+    } catch (error) {
+      console.error(colors.errorMessage('Workspace changelog generation failed:'), error.message)
+      throw error
+    }
+  }
+
+  async generateCommitStyleWorkingDirectoryEntries(options = {}) {
+    // Use provided working directory analysis or get current changes
+    let rawChanges
+    if (options.workingDirAnalysis?.changes) {
+      rawChanges = options.workingDirAnalysis.changes
+    } else {
+      rawChanges = getWorkingDirectoryChanges()
+    }
+
+    try {
+      if (!(rawChanges && Array.isArray(rawChanges)) || rawChanges.length === 0) {
+        return { entries: [] }
+      }
+
+      // Enhanced analysis of changes with diff content for AI analysis
+      const enhancedChanges = await this.enhanceChangesWithDiff(rawChanges)
+      const changesSummary = summarizeFileChanges(enhancedChanges)
+
+      // Use DiffProcessor for intelligent diff processing
+      const analysisMode =
+        this.aiAnalysisService?.analysisMode || options.analysisMode || 'standard'
+      const diffProcessor = new DiffProcessor({
+        analysisMode,
+        enableFiltering: true,
+        enablePatternDetection: true,
+      })
+
+      const processedResult = diffProcessor.processFiles(enhancedChanges)
+      const { processedFiles, patterns } = processedResult
+
+      // Build pattern summary if patterns were detected
+      const patternSummary =
+        Object.keys(patterns).length > 0
+          ? `\n\n**BULK PATTERNS DETECTED:**\n${Object.values(patterns)
+              .map((p) => `- ${p.description}`)
+              .join('\n')}`
+          : ''
+
+      // Build files section with processed diffs
+      const filesSection = processedFiles
+        .map((file) => {
+          if (file.isSummary) {
+            return `\n**[REMAINING FILES]:** ${file.diff}`
+          }
+
+          const compressionInfo = file.compressionApplied
+            ? ` [compressed from ${file.originalSize || 'unknown'} chars]`
+            : ''
+          const patternInfo = file.bulkPattern ? ` [${file.bulkPattern}]` : ''
+
+          return `\n**${file.filePath || file.path}** (${file.status})${compressionInfo}${patternInfo}:\n${file.diff}`
+        })
+        .join('\n')
+
+      // Build prompt for commit-style entries
+      const prompt = `Generate working directory change entries in the SAME FORMAT as git commits:
+
+**Analysis Mode**: ${analysisMode}
+**Total Files**: ${changesSummary.totalFiles} (${processedResult.filesProcessed} analyzed, ${processedResult.filesSkipped} summarized)
+**Categories**: ${Object.keys(changesSummary.categories).join(', ')}${patternSummary}
+
+**PROCESSED FILES:**${filesSection}
+
+STRICT FORMATTING REQUIREMENTS:
+Generate working directory change entries based ONLY on visible diff content:
+- (type) Detailed but focused description - Include key functional changes, method/function names, and important technical details without overwhelming verbosity
+
+Where:
+- type = feature, fix, refactor, docs, chore, etc. based on the actual changes
+- Detailed description = specific functions/methods affected, key technical changes, and functional purpose
+- Include exact method names, variable names, and technical specifics from the diffs
+
+EXAMPLES of CORRECT DETAILED FORMAT:
+- (feature) Created new bedrock.js file - Added BedrockProvider class with generateCompletion(), initializeClient(), and getAvailableModels() methods. Imported AWS SDK BedrockRuntimeClient and added support for Claude-3-5-sonnet and Llama-3.1 models with streaming capabilities.
+
+- (refactor) Updated model list in anthropic.js - Changed getDefaultModel() return value from 'claude-3-5-sonnet-20241022' to 'claude-sonnet-4-20250514'. Added claude-sonnet-4 model entry with 200k context window and updated pricing tier.
+
+- (fix) Updated configuration.manager.js - Added null check in getProviderConfig() method to prevent crashes when .env.local file is missing. Modified loadConfig() to gracefully handle missing environment files.
+
+FORBIDDEN - DO NOT MAKE ASSUMPTIONS:
+❌ Do not mention "integration" unless you see actual integration code
+❌ Do not mention "provider selection logic" unless you see that specific code
+❌ Do not assume files work together unless explicitly shown in diffs
+
+Generate one entry per file or logical change group. Only describe what you can literally see.`
+
+      // Make AI call
+      const messages = [
+        {
+          role: 'system',
+          content:
+            'You are an expert at analyzing code changes and generating detailed but focused commit-style changelog entries. You MUST only describe changes that are visible in the provided diff content. Include specific function/method names, key technical details, and the functional purpose of changes. Be precise and factual - only describe what you can literally see in the diffs. Provide enough detail to understand what changed technically, but avoid overwhelming verbosity.',
+        },
+        {
+          role: 'user',
+          content: prompt,
+        },
+      ]
+
+      // Set token limits based on analysis mode and number of changes
+      let maxTokens = 1200 // Default
+      if (analysisMode === 'enterprise') {
+        maxTokens = 3000
+      } else if (analysisMode === 'detailed') {
+        maxTokens = 2500
+      }
+
+      // Increase token limit for large numbers of working directory changes
+      if (enhancedChanges.length > 50) {
+        maxTokens = Math.min(maxTokens + 1500, 6000)
+      }
+
+      const aiOptions = {
+        max_tokens: maxTokens,
+        temperature: 0.3,
+      }
+
+      const response = await this.aiAnalysisService.aiProvider.generateCompletion(
+        messages,
+        aiOptions
+      )
+
+      const content = response.content || response.text
+
+      // Check if content is valid before processing
+      if (!content || typeof content !== 'string') {
+        console.warn(colors.warningMessage('⚠️  AI response was empty or invalid'))
+        console.warn(colors.infoMessage('💡 Using basic file change detection instead'))
+
+        // Fallback to basic entries from the changes we were given
+        const fallbackChanges = rawChanges || getWorkingDirectoryChanges()
+        const basicEntries = fallbackChanges.map((change) => {
+          const filePath = change.filePath || change.path || 'unknown file'
+          const status = change.status || 'M'
+          const changeType =
+            status === 'M'
+              ? 'update'
+              : status === 'A'
+                ? 'feature'
+                : status === 'D'
+                  ? 'remove'
+                  : 'chore'
+          const changeDesc =
+            status === 'M'
+              ? 'updated'
+              : status === 'A'
+                ? 'added'
+                : status === 'D'
+                  ? 'deleted'
+                  : 'changed'
+          return `- (${changeType}) Modified ${filePath} - File ${changeDesc} (pattern-based analysis)`
+        })
+
+        return { entries: basicEntries }
+      }
+
+      // Parse entries from response
+      const entries = content
+        .split('\n')
+        .filter((line) => {
+          const trimmed = line.trim()
+          // Accept lines starting with '- (' or directly with '(' for changelog entries
+          return trimmed.startsWith('- (') || trimmed.startsWith('(')
+        })
+        .map((line) => {
+          const trimmed = line.trim()
+          // Ensure all entries start with '- ' for consistent formatting
+          return trimmed.startsWith('- ') ? trimmed : `- ${trimmed}`
+        })
+      return {
+        entries,
+        changes: enhancedChanges,
+        summary: changesSummary,
+      }
+    } catch (error) {
+      // Provide specific guidance based on error type
+      if (error.message.includes('fetch failed') || error.message.includes('connection')) {
+        console.warn(colors.warningMessage('⚠️  AI provider connection failed'))
+        console.warn(
+          colors.infoMessage('💡 Check your internet connection and provider configuration')
+        )
+      } else if (error.message.includes('API key') || error.message.includes('401')) {
+        console.warn(colors.warningMessage('⚠️  Authentication failed'))
+        console.warn(colors.infoMessage('💡 Run `ai-changelog init` to configure your API key'))
+      } else {
+        console.warn(colors.warningMessage(`⚠️  AI analysis failed: ${error.message}`))
+        console.warn(colors.infoMessage('💡 Using basic file change detection instead'))
+      }
+
+      // Return basic entries from the changes we were given instead of getting fresh ones
+      const fallbackChanges = rawChanges || getWorkingDirectoryChanges()
+      const basicEntries = fallbackChanges.map((change) => {
+        const filePath = change.filePath || change.path || 'unknown file'
+        const status = change.status || 'M'
+        const changeType =
+          status === 'M'
+            ? 'update'
+            : status === 'A'
+              ? 'feature'
+              : status === 'D'
+                ? 'remove'
+                : 'chore'
+        const changeDesc =
+          status === 'M'
+            ? 'updated'
+            : status === 'A'
+              ? 'added'
+              : status === 'D'
+                ? 'deleted'
+                : 'changed'
+        return `- (${changeType}) Modified ${filePath} - File ${changeDesc} (pattern-based analysis)`
+      })
+
+      return { entries: basicEntries }
+    }
+  }
+
+  async enhanceChangesWithDiff(changes) {
+    const enhancedChanges = []
+
+    for (const change of changes) {
+      const enhancedChange = {
+        ...change,
+        category: categorizeFile(change.path || change.filePath),
+        language: detectLanguage(change.path || change.filePath),
+        importance: assessFileImportance(change.path || change.filePath, change.status),
+        enhanced: true,
+      }
+
+      // Get diff content if git service is available
+      if (this.gitService) {
+        try {
+          const diffAnalysis = await this.gitService.analyzeWorkingDirectoryFileChange(
+            change.status,
+            change.path || change.filePath
+          )
+
+          if (diffAnalysis) {
+            enhancedChange.diff = diffAnalysis.diff
+            enhancedChange.beforeContent = diffAnalysis.beforeContent
+            enhancedChange.afterContent = diffAnalysis.afterContent
+            enhancedChange.semanticChanges = diffAnalysis.semanticChanges
+            enhancedChange.functionalImpact = diffAnalysis.functionalImpact
+            enhancedChange.complexity = diffAnalysis.complexity
+          }
+        } catch (error) {
+          console.warn(`Failed to get diff for ${change.path || change.filePath}:`, error.message)
+        }
+      }
+
+      enhancedChanges.push(enhancedChange)
     }
+
+    return enhancedChanges
+  }
+
+  async generateWorkspaceChangelogContent(changes, summary, _context, analysisMode) {
+    if (analysisMode === 'detailed' || analysisMode === 'enterprise') {
+      return await this.generateAIChangelogContentFromChanges(changes, summary, analysisMode)
+    }
+    return this.generateBasicChangelogContentFromChanges(changes, summary)
+  }
+
+  async generateAIChangelogContentFromChanges(changes, changesSummary, analysisMode = 'standard') {
+    if (!this.aiAnalysisService.hasAI) {
+      console.log(colors.infoMessage('AI not available, using rule-based analysis...'))
+      return this.generateBasicChangelogContentFromChanges(changes, changesSummary)
+    }
+
+    try {
+      // Use DiffProcessor for intelligent diff processing
+      const diffProcessor = new DiffProcessor({
+        analysisMode,
+        enableFiltering: true,
+        enablePatternDetection: true,
+      })
+
+      const processedResult = diffProcessor.processFiles(changes)
+      const { processedFiles, patterns } = processedResult
+
+      // Build pattern summary if patterns were detected
+      const patternSummary =
+        Object.keys(patterns).length > 0
+          ? `\n\n**BULK PATTERNS DETECTED:**\n${Object.values(patterns)
+              .map((p) => `- ${p.description}`)
+              .join('\n')}`
+          : ''
+
+      // Build files section with processed diffs
+      const filesSection = processedFiles
+        .map((file) => {
+          if (file.isSummary) {
+            return `\n**[REMAINING FILES]:** ${file.diff}`
+          }
+
+          const compressionInfo = file.compressionApplied
+            ? ` [compressed from ${file.originalSize || 'unknown'} chars]`
+            : ''
+          const patternInfo = file.bulkPattern ? ` [${file.bulkPattern}]` : ''
+
+          return `\n**${file.filePath || file.path}** (${file.status})${compressionInfo}${patternInfo}:\n${file.diff}`
+        })
+        .join('\n')
+
+      // Build comprehensive prompt with processed changes
+      const prompt = `Generate a comprehensive AI changelog for the following working directory changes:
+
+**Analysis Mode**: ${analysisMode}
+**Total Files**: ${changesSummary.totalFiles} (${processedResult.filesProcessed} analyzed, ${processedResult.filesSkipped} summarized)
+**Categories**: ${Object.keys(changesSummary.categories).join(', ')}${patternSummary}
+
+**PROCESSED FILES:**${filesSection}
+
+CRITICAL INSTRUCTIONS FOR ANALYSIS:
+1. **ONLY DESCRIBE CHANGES VISIBLE IN THE DIFF CONTENT** - Do not invent or assume changes
+2. **BE FACTUAL AND PRECISE** - Only mention specific lines, functions, imports that you can see
+3. **NO ASSUMPTIONS OR SPECULATION** - If you can't see it in the diff, don't mention it
+4. **STICK TO OBSERVABLE FACTS** - Describe what was added, removed, or modified line by line
+5. **DO NOT MAKE UP INTEGRATION DETAILS** - Don't assume files work together unless explicitly shown
+
+STRICT FORMATTING REQUIREMENTS:
+Generate working directory change entries based ONLY on visible diff content:
+- (type) Detailed but focused description - Include key functional changes, method/function names, and important technical details without overwhelming verbosity
+
+EXAMPLES of CORRECT DETAILED FORMAT:
+✅ (feature) Created new bedrock.js file - Added BedrockProvider class with generateCompletion(), initializeClient(), and getAvailableModels() methods. Imported AWS SDK BedrockRuntimeClient and added support for Claude-3-5-sonnet and Llama-3.1 models with streaming capabilities.
+
+✅ (refactor) Updated model list in anthropic.js - Changed getDefaultModel() return value from 'claude-3-5-sonnet-20241022' to 'claude-sonnet-4-20250514'. Added claude-sonnet-4 model entry with 200k context and updated pricing tier.
+
+✅ (fix) Updated configuration.manager.js - Added null check in getProviderConfig() method to prevent crashes when .env.local file is missing. Modified loadConfig() to gracefully handle missing environment files.
+
+EXAMPLES of FORBIDDEN ASSUMPTIONS:
+❌ "Updated other providers to recognize bedrock" (not visible in diff)
+❌ "Refactored provider selection logic" (not shown in actual changes)
+❌ "Improved integration across the system" (speculation)
+❌ "Enhanced error handling throughout" (assumption)
+
+ONLY describe what you can literally see in the diff content. Do not invent connections or integrations.`
+
+      // Make AI call with all the context
+      const messages = [
+        {
+          role: 'system',
+          content:
+            'You are an expert at analyzing code changes and generating detailed but focused changelog entries. You MUST only describe changes that are visible in the provided diff content. Include specific function/method names, key technical details, and the functional purpose of changes. Be precise and factual - only describe what you can literally see in the diffs. Provide enough detail to understand what changed technically, but avoid overwhelming verbosity.',
+        },
+        {
+          role: 'user',
+          content: prompt,
+        },
+      ]
+
+      const options = {
+        max_tokens:
+          analysisMode === 'enterprise' ? 2500 : analysisMode === 'detailed' ? 2000 : 1200,
+        temperature: 0.2,
+      }
+
+      const response = await this.aiAnalysisService.aiProvider.generateCompletion(messages, options)
+
+      let changelog = response.content || response.text
+
+      // Check if changelog content is valid
+      if (!changelog || typeof changelog !== 'string') {
+        console.warn(colors.warningMessage('⚠️  AI response was empty or invalid'))
+        console.warn(colors.infoMessage('💡 Using basic file change detection instead'))
+
+        // Generate basic changelog from file changes
+        const timestamp = new Date().toISOString().split('T')[0]
+        const fallbackChanges = changes
+        const basicEntries = fallbackChanges.map((change) => {
+          const filePath = change.filePath || change.path || 'unknown file'
+          const status = change.status || 'M'
+          const changeType =
+            status === 'M'
+              ? 'Modified'
+              : status === 'A'
+                ? 'Added'
+                : status === 'D'
+                  ? 'Deleted'
+                  : 'Changed'
+          return `- ${changeType} ${filePath}`
+        })
+
+        changelog = `# Working Directory Changelog - ${timestamp}\n\n## Changes\n\n${basicEntries.join('\n')}`
+      }
+
+      // Add metadata
+      const timestamp = new Date().toISOString().split('T')[0]
+
+      // Ensure proper changelog format with Keep a Changelog header
+      if (!changelog.includes('# ')) {
+        changelog = `# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased] - ${timestamp}\n\n${changelog}`
+      }
+
+      // Add generation metadata
+      changelog += `\n\n---\n\n*Generated from ${changesSummary.totalFiles} working directory changes*\n`
+
+      return changelog
+    } catch (error) {
+      // Specific error guidance for AI failures
+      if (error.message.includes('fetch failed') || error.message.includes('ECONNREFUSED')) {
+        console.warn(colors.warningMessage('⚠️  Cannot connect to AI provider'))
+        console.warn(colors.infoMessage('💡 Check internet connection and provider service status'))
+      } else if (error.message.includes('API key') || error.message.includes('401')) {
+        console.warn(colors.warningMessage('⚠️  API authentication failed'))
+        console.warn(colors.infoMessage('💡 Run: ai-changelog init'))
+      } else if (error.message.includes('rate limit')) {
+        console.warn(colors.warningMessage('⚠️  Rate limit exceeded'))
+        console.warn(colors.infoMessage('💡 Wait a moment before retrying'))
+      } else {
+        console.warn(colors.warningMessage(`⚠️  AI analysis failed: ${error.message}`))
+      }
+
+      console.warn(colors.infoMessage('🔄 Falling back to pattern-based analysis'))
+      return this.generateBasicChangelogContentFromChanges(changes, changesSummary)
+    }
+  }
+
+  generateBasicChangelogContentFromChanges(changes, changesSummary) {
+    const timestamp = new Date().toISOString().split('T')[0]
+
+    let changelog = `# Working Directory Changes - ${timestamp}\n\n`
+
+    // Basic summary
+    changelog += '## Summary\n'
+    changelog += `${changes.length} files modified across ${Object.keys(changesSummary.categories).length} categories.\n\n`
+
+    // Changes by category
+    changelog += this.buildChangesByCategory(changes, changesSummary)
+
+    // Basic recommendations
+    changelog += '## Recommendations\n'
+    changelog += '- Review changes before committing\n'
+    changelog += '- Consider adding tests for new functionality\n'
+    changelog += '- Update documentation if needed\n\n'
+
+    return changelog
+  }
+
+  buildChangesByCategory(_changes, changesSummary) {
+    let content = '## Changes by Category\n\n'
+
+    Object.entries(changesSummary.categories).forEach(([category, files]) => {
+      const categoryIcon = this.getCategoryIcon(category)
+      content += `### ${categoryIcon} ${category.charAt(0).toUpperCase() + category.slice(1)} (${files.length} files)\n\n`
+
+      files.forEach((file) => {
+        const statusIcon = this.getStatusIcon(file.status)
+        content += `- ${statusIcon} ${file.path}\n`
+      })
+
+      content += '\n'
+    })
+
+    return content
+  }
+
+  getCategoryIcon(category) {
+    const icons = {
+      source: '💻',
+      tests: '🧪',
+      documentation: '📚',
+      configuration: '⚙️',
+      frontend: '🎨',
+      assets: '🖼️',
+      build: '🔧',
+      other: '📄',
+    }
+    return icons[category] || '📄'
+  }
+
+  getStatusIcon(status) {
+    const icons = {
+      A: '➕', // Added
+      M: '✏️', // Modified
+      D: '❌', // Deleted
+      R: '📝', // Renamed
+      C: '📋', // Copied
+    }
+    return icons[status] || '📄'
+  }
+
+  generateContextSection(context) {
+    let section = '## Context Analysis\n\n'
+    section += `- **Total Files:** ${context.totalFiles}\n`
+    section += `- **Primary Category:** ${context.primaryCategory}\n`
+    section += `- **Risk Level:** ${context.riskLevel}\n`
+    section += `- **Complexity:** ${context.complexity}\n\n`
+
+    if (context.recommendations.length > 0) {
+      section += '### Recommendations\n\n'
+      context.recommendations.forEach((rec) => {
+        section += `- ${rec}\n`
+      })
+      section += '\n'
+    }
+
+    return section
   }
 }