@entro314labs/ai-changelog-generator 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -5,22 +5,53 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] - 2025-08-06
+## [Unreleased]
+
+### Next Release
+- TBD
+
+## [3.2.1] - 2025-08-10
 
 ### feat
-- add YAML-based configuration support with ai-changelog.config.yaml
-- add debug scripts for working directory analysis and functionality testing
-- add maxTokens initialization in AI analysis service
+- add comprehensive test coverage with 100% test success rate
+- add missing method implementations across all service classes
+- add modern CI/CD pipeline with automated testing and publishing
+- add Biome linting configuration for code quality
+- add comprehensive error handling and validation
+- add robust CLI timeout handling and graceful failures
+- add professional documentation and provider setup guides
 
 ### fix
-- add publishConfig for public npm access
-- remove references to missing test scripts to prevent publishing errors
-- update .gitignore to track AI_CHANGELOG.md in git
+- fix AI provider initialization and isAvailable method calls  
+- fix configuration manager null safety with proper error handling
+- fix CLI test timeouts and hanging commands
+- fix missing boolean getters (hasAI, gitExists) in main facade
+- fix homepage URL typo in package.json
+- fix CI/CD workflow paths to match current project structure
+- fix Node.js version consistency across all configurations
+- fix Vitest reporter deprecation warnings
+
+### test  
+- add 658 comprehensive tests with 100% pass rate
+- add missing service method implementations for test compatibility
+- add resilient CLI end-to-end testing with proper timeouts
+- add comprehensive architecture and functionality testing
+- add provider integration testing and validation
+- add performance and memory usage testing
+- add cross-platform compatibility testing
+
+### build
+- update to Node.js 22.x across all environments
+- add pnpm workspace configuration for monorepo structure
+- add Vitest testing framework with coverage reporting
+- add modern GitHub Actions workflows for CI/CD
+- standardize package management with pnpm
 
 ### docs
-- update provider setup guides and environment variable documentation
-- update troubleshooting guides and contributing guidelines
-- create comprehensive README.md with usage and configuration details
+- update comprehensive README with installation and usage
+- add provider setup and troubleshooting documentation
+- add environment variables and configuration guides
+- update contributing guidelines and development setup
 
 ### chore
 - update dependencies including version increments from 3.0.3 to 3.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@entro314labs/ai-changelog-generator",
   "displayName": "AI Changelog Generator",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "type": "module",
   "description": "AI-powered changelog generator with MCP server support - works with most providers, online and local models",
   "main": "src/ai-changelog-generator.js",
@@ -20,88 +20,39 @@
     "LICENSE",
     "CHANGELOG.md"
   ],
-  "scripts": {
-    "start": "node bin/ai-changelog.js",
-    "changelog": "node bin/ai-changelog.js",
-    "changelog:detailed": "node bin/ai-changelog.js --detailed",
-    "changelog:enterprise": "node bin/ai-changelog.js --enterprise",
-    "changelog:interactive": "node bin/ai-changelog.js --interactive",
-    "changelog:analyze": "node bin/ai-changelog.js --analyze",
-    "changelog:preview": "node bin/ai-changelog.js --dry-run",
-    "changelog:no-color": "node bin/ai-changelog.js --no-color",
-    "mcp": "node bin/ai-changelog-mcp.js",
-    "mcp:start": "node bin/ai-changelog-mcp.js",
-    "demo": "node test/test-end-to-end-full.js",
-    "lint": "exec biome lint src/",
-    "lint:fix": "exec biome lint --write src/",
-    "lint:fix-unsafe": "exec biome lint --unsafe --write src/",
-    "format": "exec biome format --write src/",
-    "format:unsafe": "exec biome format --write src/",
-    "format:check": "exec biome format src/",
-    "check": "exec biome check src/",
-    "check:fix": "exec biome check --write src/",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage",
-    "test:providers": "vitest run test/providers.test.js",
-    "test:cli": "vitest run test/cli.test.js",
-    "test:core": "vitest run test/core.test.js",
-    "test:services": "vitest run test/services.test.js",
-    "test:utils": "vitest run test/utils.test.js",
-    "test:integration": "vitest run test/integration.test.js",
-    "test:mcp": "vitest run test/mcp.test.js",
-    "test:styling": "vitest run test/cli-ui.test.js test/colors.test.js test/styling-integration.test.js",
-    "test:styling-e2e": "vitest run test/cli-styling-e2e.test.js --testTimeout=60000",
-    "test:legacy": "node test/test-runner.js comprehensive",
-    "test:git": "node src/domains/git/git.service.js info",
-    "setup": "node scripts/setup-azure-openai.js",
-    "config:create": "node src/infrastructure/config/configuration.manager.js create-sample",
-    "config:validate": "node src/infrastructure/config/configuration.manager.js validate",
-    "config:test-models": "node src/infrastructure/config/configuration.manager.js model-test",
-    "providers:test": "node test/test-providers.js",
-    "providers:validate": "node test/test-provider-switching.js",
-    "git:info": "node src/domains/git/git.service.js info",
-    "git:commits": "node src/domains/git/git.service.js commits 10",
-    "git:stats": "node src/domains/git/git.service.js stats 5",
-    "dxt:init": "npx @anthropic-ai/dxt init",
-    "dxt:pack": "npm run dxt:prepack && npx @anthropic-ai/dxt pack",
-    "dxt:prepack": "node -e \"const fs=require('fs'),path=require('path'); const src='node_modules/@modelcontextprotocol/sdk/dist', dest='node_modules/@modelcontextprotocol/sdk/dist'; if(fs.existsSync(src)) console.log('MCP SDK dist exists'); else console.error('MCP SDK dist missing');\"",
-    "dxt:validate": "npx @anthropic-ai/dxt validate",
-    "postinstall": "node -e \"console.log('\\n🎉 AI Changelog Generator installed!\\n\\n⚡ Quick Start:\\n  ai-changelog                 - Generate changelog\\n  ai-changelog --detailed      - Detailed analysis\\n  ai-changelog --interactive   - Interactive mode\\n  ai-changelog-mcp            - Start MCP server\\n\\n🤖 AI Models Supported:\\n  • GPT-4.1 series (1M context, 75% cost reduction)\\n  • o3/o4 reasoning models (Azure-only)\\n  • Automatic model selection\\n\\n📖 Docs: https://github.com/entro314-labs/AI-changelog-generator\\n\\n© All trademarks belong to their respective owners.\\n')\""
-  },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.59.0",
-    "@aws-sdk/client-bedrock-runtime": "^3.864.0",
-    "@azure/identity": "^4.11.1",
+    "@anthropic-ai/sdk": "^0.67.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.913.0",
+    "@azure/identity": "^4.13.0",
     "@clack/prompts": "^0.11.0",
-    "@google/genai": "^1.13.0",
+    "@google/genai": "^1.25.0",
     "@google/generative-ai": "^0.24.1",
-    "@huggingface/hub": "^2.4.1",
-    "@huggingface/inference": "^4.6.1",
-    "@lmstudio/sdk": "^1.4.0",
-    "@modelcontextprotocol/sdk": "^1.17.2",
-    "@modelcontextprotocol/server-filesystem": "2025.7.29",
+    "@huggingface/hub": "^2.6.12",
+    "@huggingface/inference": "^4.11.3",
+    "@lmstudio/sdk": "^1.5.0",
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "@modelcontextprotocol/server-filesystem": "2025.8.21",
     "boxen": "^8.0.1",
-    "chalk": "^5.5.0",
+    "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
-    "dotenv": "^17.2.1",
+    "dotenv": "^17.2.3",
     "figures": "^6.1.0",
-    "google-auth-library": "^10.2.1",
+    "google-auth-library": "^10.4.1",
     "gradient-string": "^3.0.0",
     "js-yaml": "^4.1.0",
-    "ollama": "^0.5.17",
-    "openai": "^5.12.2",
-    "ora": "^8.2.0",
+    "ollama": "^0.6.0",
+    "openai": "^6.5.0",
+    "ora": "^9.0.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@anthropic-ai/dxt": "^0.2.6",
-    "@types/node": "24.2.1",
-    "@vitest/coverage-v8": "^3.2.4",
-    "@vitest/ui": "^3.2.4",
+    "@anthropic-ai/mcpb": "^1.1.1",
+    "@types/node": "24.8.1",
+    "@vitest/browser": "beta",
+    "@vitest/coverage-v8": "beta",
+    "@vitest/ui": "beta",
     "tempy": "^3.1.0",
-    "vitest": "^3.2.4"
+    "vitest": "beta"
   },
   "keywords": [
     "changelog",
@@ -143,8 +94,8 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.0.0",
-    "pnpm": ">=8.0.0"
+    "node": ">=22.20.0",
+    "pnpm": ">=10.18.3"
   },
   "funding": {
     "type": "github",
@@ -156,12 +107,53 @@
     }
   },
   "volta": {
-    "node": "22.17.1",
-    "pnpm": "9.17.0"
+    "node": "22.20.0",
+    "pnpm": "10.18.3"
   },
-  "pnpm": {
-    "overrides": {
-      "tmp@<=0.2.3": ">=0.2.4"
-    }
+  "scripts": {
+    "start": "node bin/ai-changelog.js",
+    "changelog": "node bin/ai-changelog.js",
+    "changelog:detailed": "node bin/ai-changelog.js --detailed",
+    "changelog:enterprise": "node bin/ai-changelog.js --enterprise",
+    "changelog:interactive": "node bin/ai-changelog.js --interactive",
+    "changelog:analyze": "node bin/ai-changelog.js --analyze",
+    "changelog:preview": "node bin/ai-changelog.js --dry-run",
+    "changelog:no-color": "node bin/ai-changelog.js --no-color",
+    "mcp": "node bin/ai-changelog-mcp.js",
+    "mcp:start": "node bin/ai-changelog-mcp.js",
+    "demo": "node test/test-end-to-end-full.js",
+    "lint": "exec biome lint src/",
+    "lint:fix": "exec biome lint --write src/",
+    "lint:fix-unsafe": "exec biome lint --unsafe --write src/",
+    "format": "exec biome format --write src/",
+    "format:unsafe": "exec biome format --write src/",
+    "format:check": "exec biome format src/",
+    "check": "exec biome check src/",
+    "check:fix": "exec biome check --write src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "test:providers": "vitest run test/providers.test.js",
+    "test:cli": "vitest run test/cli.test.js",
+    "test:core": "vitest run test/core.test.js",
+    "test:services": "vitest run test/services.test.js",
+    "test:utils": "vitest run test/utils.test.js",
+    "test:integration": "vitest run test/integration.test.js",
+    "test:mcp": "vitest run test/mcp.test.js",
+    "test:styling": "vitest run test/cli-ui.test.js test/colors.test.js test/styling-integration.test.js",
+    "test:styling-e2e": "vitest run test/cli-styling-e2e.test.js --testTimeout=60000",
+    "test:legacy": "node test/test-runner.js comprehensive",
+    "test:git": "node src/domains/git/git.service.js info",
+    "setup": "node scripts/setup-azure-openai.js",
+    "config:create": "node src/infrastructure/config/configuration.manager.js create-sample",
+    "config:validate": "node src/infrastructure/config/configuration.manager.js validate",
+    "config:test-models": "node src/infrastructure/config/configuration.manager.js model-test",
+    "providers:test": "node test/test-providers.js",
+    "providers:validate": "node test/test-provider-switching.js",
+    "git:info": "node src/domains/git/git.service.js info",
+    "git:commits": "node src/domains/git/git.service.js commits 10",
+    "git:stats": "node src/domains/git/git.service.js stats 5",
+    "postinstall": "node -e \"console.log('\\n🎉 AI Changelog Generator installed!\\n\\n⚡ Quick Start:\\n  ai-changelog                 - Generate changelog\\n  ai-changelog --detailed      - Detailed analysis\\n  ai-changelog --interactive   - Interactive mode\\n  ai-changelog-mcp            - Start MCP server\\n\\n🤖 AI Models Supported:\\n  • GPT-4.1 series (1M context, 75% cost reduction)\\n  • o3/o4 reasoning models (Azure-only)\\n  • Automatic model selection\\n\\n📖 Docs: https://github.com/entro314-labs/AI-changelog-generator\\n\\n© All trademarks belong to their respective owners.\\n')\""
   }
-}
+}

package/src/ai-changelog-generator.js

@@ -203,11 +203,20 @@ export class AIChangelogGenerator {
 
   // Utility methods for backward compatibility
   get hasAI() {
-    return this.appService.orchestrator.aiProvider?.isAvailable()
+    try {
+      return this.appService?.orchestrator?.aiProvider?.isAvailable()
+    } catch (_error) {
+      return false
+    }
   }
 
   get gitExists() {
-    return this.appService.orchestrator?.gitManager?.isGitRepo
+    try {
+      const isGitRepo = this.appService?.orchestrator?.gitManager?.isGitRepo
+      return Boolean(isGitRepo)
+    } catch (_error) {
+      return false
+    }
   }
 
   // Simple logging method

package/src/application/orchestrators/changelog.orchestrator.js

@@ -3,7 +3,9 @@ import process from 'node:process'
 import { AIAnalysisService } from '../../domains/ai/ai-analysis.service.js'
 import { AnalysisEngine } from '../../domains/analysis/analysis.engine.js'
 import { ChangelogService } from '../../domains/changelog/changelog.service.js'
+import { CommitTagger } from '../../domains/git/commit-tagger.js'
 import { GitService } from '../../domains/git/git.service.js'
+import { GitManager } from '../../domains/git/git-manager.js'
 import { InteractiveStagingService } from '../../infrastructure/interactive/interactive-staging.service.js'
 import { InteractiveWorkflowService } from '../../infrastructure/interactive/interactive-workflow.service.js'
 import { ProviderManagerService } from '../../infrastructure/providers/provider-manager.service.js'
@@ -58,9 +60,9 @@ export class ChangelogOrchestrator {
       })
       this.aiProvider = this.providerManager.getActiveProvider()
 
-      // Create lightweight implementations for missing dependencies
-      this.gitManager = await this.createGitManager()
-      this.tagger = await this.createTagger()
+      // Create proper implementations using the new classes
+      this.gitManager = new GitManager()
+      this.tagger = new CommitTagger()
       this.promptEngine = await this.createPromptEngine()
 
       // Initialize domain services with proper dependencies
@@ -121,207 +123,17 @@ export class ChangelogOrchestrator {
     }
   }
 
-  async createGitManager() {
-    const { execSync } = await this._getCachedImport('child_process')
-
-    return {
-      isGitRepo: (() => {
-        try {
-          execSync('git rev-parse --git-dir', { stdio: 'ignore' })
-          return true
-        } catch {
-          return false
-        }
-      })(),
-
-      execGit(command) {
-        try {
-          return execSync(command, { encoding: 'utf8', stdio: 'pipe' })
-        } catch (error) {
-          // Enhanced error handling with more specific messages
-          if (error.code === 128) {
-            throw new Error(
-              `Git repository error: ${error.message.includes('not a git repository') ? 'Not in a git repository' : error.message}`
-            )
-          }
-          if (error.code === 129) {
-            throw new Error(`Git command syntax error: ${command}`)
-          }
-          throw new Error(`Git command failed (${command}): ${error.message}`)
-        }
-      },
-
-      execGitSafe(command) {
-        try {
-          return execSync(command, { encoding: 'utf8', stdio: 'pipe' })
-        } catch {
-          return ''
-        }
-      },
-
-      execGitShow(command) {
-        try {
-          return execSync(command, { encoding: 'utf8', stdio: 'pipe' })
-        } catch (_error) {
-          // console.warn(`Git command failed: ${command}`);
-          // console.warn(`Error: ${error.message}`);
-          return null
-        }
-      },
-
-      validateCommitHash(hash) {
-        try {
-          execSync(`git cat-file -e ${hash}`, { stdio: 'ignore' })
-          return true
-        } catch {
-          return false
-        }
-      },
-
-      getAllBranches() {
-        try {
-          const output = execSync('git branch -a', { encoding: 'utf8' })
-          return output
-            .split('\n')
-            .filter(Boolean)
-            .map((branch) => branch.trim().replace(/^\*\s*/, ''))
-        } catch {
-          return []
-        }
-      },
-
-      getUnmergedCommits() {
-        try {
-          const output = execSync('git log --oneline --no-merges HEAD ^origin/main', {
-            encoding: 'utf8',
-          })
-          return output.split('\n').filter(Boolean)
-        } catch {
-          return []
-        }
-      },
-
-      getDanglingCommits() {
-        try {
-          const output = execSync('git fsck --no-reflog | grep "dangling commit"', {
-            encoding: 'utf8',
-          })
-          return output.split('\n').filter(Boolean)
-        } catch {
-          return []
-        }
-      },
-
-      getUntrackedFiles() {
-        try {
-          const output = execSync('git ls-files --others --exclude-standard', { encoding: 'utf8' })
-          return output.split('\n').filter(Boolean)
-        } catch {
-          return []
-        }
-      },
-
-      getRecentCommits(limit = 10) {
-        try {
-          const output = execSync(`git log --oneline -${limit}`, { encoding: 'utf8' })
-          return output.split('\n').filter(Boolean)
-        } catch {
-          return []
-        }
-      },
-
-      getComprehensiveAnalysis() {
-        return {
-          totalCommits: this.getRecentCommits(1000).length,
-          branches: this.getAllBranches(),
-          untrackedFiles: this.getUntrackedFiles(),
-        }
-      },
-
-      hasFile(filename) {
-        try {
-          execSync(`test -f ${filename}`, { stdio: 'ignore' })
-          return true
-        } catch {
-          return false
-        }
-      },
-    }
-  }
-
-  async createTagger() {
-    const { analyzeSemanticChanges, analyzeFunctionalImpact } = await import(
-      '../../shared/utils/utils.js'
-    )
-
-    return {
-      analyzeCommit(commit) {
-        const semanticChanges = []
-        const breakingChanges = []
-        const categories = []
-        const tags = []
-
-        // Basic analysis based on commit message
-        const message = commit.message.toLowerCase()
-
-        if (message.includes('breaking') || message.includes('!:')) {
-          breakingChanges.push('Breaking change detected in commit message')
-          categories.push('breaking')
-          tags.push('breaking')
-        }
-
-        if (message.startsWith('feat')) {
-          categories.push('feature')
-          tags.push('feature')
-        } else if (message.startsWith('fix')) {
-          categories.push('fix')
-          tags.push('bugfix')
-        } else if (message.startsWith('docs')) {
-          categories.push('docs')
-          tags.push('documentation')
-        }
-
-        // Analyze files if available
-        if (commit.files && commit.files.length > 0) {
-          commit.files.forEach((file) => {
-            const semantic = analyzeSemanticChanges('', file.path)
-            if (semantic.frameworks) {
-              semanticChanges.push(...semantic.frameworks)
-            }
-          })
-        }
-
-        // Determine importance
-        let importance = 'medium'
-        if (breakingChanges.length > 0 || commit.files?.length > 10) {
-          importance = 'high'
-        } else if (categories.includes('docs') || commit.files?.length < 3) {
-          importance = 'low'
-        }
-
-        return {
-          semanticChanges,
-          breakingChanges,
-          categories,
-          importance,
-          tags,
-        }
-      },
-    }
-  }
-
   async createPromptEngine() {
-    const { buildEnhancedPrompt } = await import('../../shared/utils/utils.js')
-
     return {
       systemPrompts: {
         master:
-          'You are an expert software analyst specializing in code change analysis and changelog generation.',
-        standard: 'Provide clear, concise analysis focusing on the practical impact of changes.',
+          'You are an expert software analyst specializing in code change analysis and changelog generation. Analyze code changes with precision and provide definitive, factual assessments. Never use uncertain language like "likely", "probably", "appears to", "seems to", or "possibly". Base your analysis solely on the actual changes shown in the code diffs.',
+        standard:
+          'Provide clear, concise analysis focusing on the practical impact of changes. Be definitive and factual in your descriptions.',
         detailed:
-          'Provide comprehensive technical analysis with detailed explanations and implications.',
+          'Provide comprehensive technical analysis with detailed explanations and implications. Use precise, confident language backed by evidence from the code changes.',
         enterprise:
-          'Provide enterprise-grade analysis suitable for stakeholder communication and decision-making.',
+          'Provide enterprise-grade analysis suitable for stakeholder communication and decision-making. Use authoritative, factual language that conveys confidence and accuracy.',
         changesAnalysis: 'You are an expert at analyzing code changes and their business impact.',
       },
 
@@ -399,9 +211,7 @@ export class ChangelogOrchestrator {
   async runInteractive() {
     await this.ensureInitialized()
 
-    const { runInteractiveMode, selectSpecificCommits } = await import(
-      '../../shared/utils/utils.js'
-    )
+    const { runInteractiveMode } = await import('../../shared/utils/utils.js')
     const { confirm } = await this._getCachedImport('@clack/prompts')
 
     console.log(colors.processingMessage('🎮 Starting interactive mode...'))
@@ -1276,7 +1086,7 @@ Generate only the commit message, no explanation.`
     if (!this.aiAnalysisService?.aiProvider?.isAvailable()) {
       throw new Error('AI provider not available for suggestions')
     }
-    
+
     const { select } = await this._getCachedImport('@clack/prompts')
 
     console.log(colors.processingMessage('🤖 Generating AI suggestions...'))

package/src/cli.js

@@ -11,7 +11,6 @@ import { hideBin } from 'yargs/helpers'
 import yargs from 'yargs/yargs'
 
 import { AIChangelogGenerator } from './ai-changelog-generator.js'
-import colors from './shared/constants/colors.js'
 import { EnhancedConsole, SimpleSpinner } from './shared/utils/cli-ui.js'
 
 async function runCLI() {
@@ -91,14 +90,14 @@ async function runCLI() {
     }
 
     if (argv.validate) {
-      console.log(colors.infoMessage('🔧 Validating configuration...'))
+      EnhancedConsole.info('🔧 Validating configuration...')
       await generator.validateConfiguration()
-      console.log(colors.successMessage('✅ Configuration is valid'))
+      EnhancedConsole.success('✅ Configuration is valid')
       return
     }
 
     if (argv.interactive) {
-      console.log(colors.infoMessage('🎮 Starting interactive mode...'))
+      EnhancedConsole.info('🎮 Starting interactive mode...')
       await generator.runInteractive()
       return
     }
@@ -170,7 +169,7 @@ export { runCLI }
 // If this file is run directly, execute CLI
 if (import.meta.url === `file://${process.argv[1]}`) {
   runCLI().catch((error) => {
-    console.error('CLI Error:', error.message)
+    EnhancedConsole.error('CLI Error:', error.message)
     process.exit(1)
   })
 }

package/src/domains/ai/ai-analysis.service.js

@@ -143,6 +143,8 @@ export class AIAnalysisService {
         temperature: 0.3,
       })
 
+      // Debug logging removed
+
       if (response?.usage) {
         this.metrics.totalTokens +=
           (response.usage.prompt_tokens || 0) + (response.usage.completion_tokens || 0)