@entro314labs/ai-changelog-generator 3.3.0 → 3.6.0

package/CHANGELOG.md

@@ -10,6 +10,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Next Release
 - TBD
 
+## [3.6.0] - 2025-11-27
+
+### Feat
+- **MCPB Support**: Added full support for Model Context Protocol Bundle (MCPB) extension format.
+- **Packaging**: Updated manifest and packaging for seamless MCP server integration.
+
+### Fix
+- **Dry Run**: Fixed `dry-run` mode to correctly skip file writing while preserving output preview.
+- **CLI**: Fixed interactive mode timeouts in non-TTY/CI environments.
+- **MCP Server**: Fixed `ReferenceError` by using dynamic imports for `child_process` in ESM environment.
+- **Validation**: Fixed `WorkspaceChangelogService` validation to correctly detect git repositories.
+- **UI**: Fixed `EnhancedConsole.metrics` method shadowing in CLI UI utilities.
+- **Tests**: Fixed integration test failures in styling and workspace services.
+
+### Test
+- **Coverage**: Validated full test suite with 696 passing tests.
+- **Mocking**: Fixed mocking strategies in styling integration tests.
+
+### Chore
+- **Dependencies**: Updated project dependencies and type definitions.
+- **Audit**: Verified project robustness and MCP tool integration.
+
+## [3.3.0] - 2025-10-19
+
+### Refactor
+- **Architecture**: Major refactor of git management with new `GitManager` and `CommitTagger` domains.
+- **Services**: Re-architected `AnalysisEngine`, `ChangelogService`, and `WorkspaceChangelogService` for better separation of concerns.
+- **Config**: Modernized `biome.json` and `package.json` configurations.
+
+### Feat
+- **Git Analysis**: Enhanced merge commit analysis and processing.
+- **Configuration**: Added support for `merge` commit type in configuration.
+
+### Fix
+- **Reliability**: Resolved intermittent test failures and improved test suite reliability.
+- **Error Handling**: Added comprehensive error classes and improved exception handling.
+
+### Test
+- **New Tests**: Added `missing-functionality.test.js` covering edge cases and new architectural components.
+
 ## [3.2.1] - 2025-08-10
 
 ### feat
@@ -22,7 +62,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - add professional documentation and provider setup guides
 
 ### fix
-- fix AI provider initialization and isAvailable method calls  
+- 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
@@ -31,7 +71,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - fix Node.js version consistency across all configurations
 - fix Vitest reporter deprecation warnings
 
-### test  
+### 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

package/README.md

@@ -133,7 +133,7 @@ ai-changelog --help
 # Generate changelog from recent commits
 ./ai-changelog.sh
 
-# Interactive mode with guided setup  
+# Interactive mode with guided setup
 ./ai-changelog.sh --interactive
 
 # Analyze working directory changes
@@ -351,9 +351,29 @@ ai-changelog health --detailed
 - **[AI Provider Setup](./docs/providers.md)** - Configure OpenAI, Claude, and other providers
 - **[Configuration Reference](./docs/configuration.md)** - All YAML and environment options
 - **[MCP Integration](./docs/mcp-integration.md)** - Claude Desktop and MCP server setup
+- **[Desktop Extension (MCPB)](./MCPB_BUILD.md)** - Build and package as Claude Desktop Extension
 - **[API Reference](./docs/api-reference.md)** - All commands, options, and programmatic usage
 - **[Demo Media](./docs/media/)** - Interactive demos, GIFs, and video walkthroughs
 
+### Claude Desktop Extension
+
+Install AI Changelog Generator in Claude Desktop with **one click** using the MCPB (MCP Bundle) format:
+
+1. Download the latest `.mcpb` file from [Releases](https://github.com/entro314-labs/AI-changelog-generator/releases)
+2. Open Claude Desktop → Settings → Extensions
+3. Drag and drop the `.mcpb` file
+4. Click "Install"
+
+No configuration files, no terminal commands - just drag, drop, and start generating changelogs!
+
+**For developers:** Learn how to build and package the extension in [MCPB_BUILD.md](./MCPB_BUILD.md)
+
+```bash
+# Build Desktop Extension
+pnpm mcpb:validate  # Validate manifest
+pnpm mcpb:pack      # Create .mcpb file
+```
+
 ## Contributing
 
 <svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">

package/bin/ai-changelog-dxt.js

@@ -2,16 +2,19 @@
 
 /**
  * AI Changelog Generator - Claude Desktop Extension Entry Point
- * Optimized for DXT packaging and Claude Desktop integration
+ * Optimized for MCPB (MCP Bundle) packaging and Claude Desktop integration
+ *
+ * Note: This file is maintained for backward compatibility.
+ * The main MCP server entry point is bin/ai-changelog-mcp.js
  */
 
 import AIChangelogMCPServer from '../src/infrastructure/mcp/mcp-server.service.js'
 import { runMCPServer, setupProcessErrorHandlers } from '../src/shared/utils/cli-entry-utils.js'
 
-// Setup error handlers for DXT environment
+// Setup error handlers for MCPB environment
 setupProcessErrorHandlers('AI Changelog Generator - Claude Desktop Extension')
 
-// DXT-specific initialization
+// MCPB-specific initialization (legacy DXT compatibility)
 async function initializeDXTServer() {
   await runMCPServer(
     'AI Changelog Generator - Claude Desktop Extension',

package/manifest.json

@@ -0,0 +1,177 @@
+{
+  "manifest_version": "0.3",
+  "name": "ai-changelog-generator",
+  "display_name": "AI Changelog Generator",
+  "version": "3.6.0",
+  "description": "AI-powered changelog generator with MCP server support - works with most providers, online and local models",
+  "long_description": "Generate intelligent changelogs from git commits using AI. Supports multiple providers including OpenAI, Claude, Gemini, Ollama, and LM Studio. Perfect for automating release documentation with smart commit analysis and categorization.\n\nFeatures:\n- Automatic changelog generation from git commits\n- Working directory change analysis\n- Multiple AI provider support (OpenAI, Azure, Claude, Gemini, Ollama, LM Studio)\n- Interactive and batch modes\n- Repository health analysis\n- Branch analysis and recommendations\n- Commit categorization and impact assessment",
+  "author": {
+    "name": "entro314-labs",
+    "email": "hey@entro314.com",
+    "url": "https://github.com/entro314-labs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/entro314-labs/AI-changelog-generator.git"
+  },
+  "homepage": "https://github.com/entro314-labs/AI-changelog-generator",
+  "documentation": "https://github.com/entro314-labs/AI-changelog-generator#readme",
+  "support": "https://github.com/entro314-labs/AI-changelog-generator/issues",
+  "icon": "icon.png",
+  "server": {
+    "type": "node",
+    "entry_point": "bin/ai-changelog-mcp.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/bin/ai-changelog-mcp.js"],
+      "env": {
+        "AI_PROVIDER": "${user_config.AI_PROVIDER}",
+        "OPENAI_API_KEY": "${user_config.OPENAI_API_KEY}",
+        "AZURE_OPENAI_KEY": "${user_config.AZURE_OPENAI_KEY}",
+        "AZURE_OPENAI_ENDPOINT": "${user_config.AZURE_OPENAI_ENDPOINT}",
+        "AZURE_OPENAI_DEPLOYMENT_NAME": "${user_config.AZURE_OPENAI_DEPLOYMENT_NAME}",
+        "ANTHROPIC_API_KEY": "${user_config.ANTHROPIC_API_KEY}",
+        "GOOGLE_API_KEY": "${user_config.GOOGLE_API_KEY}",
+        "HUGGINGFACE_API_KEY": "${user_config.HUGGINGFACE_API_KEY}",
+        "VERTEX_PROJECT_ID": "${user_config.VERTEX_PROJECT_ID}",
+        "OLLAMA_HOST": "${user_config.OLLAMA_HOST}",
+        "LMSTUDIO_API_BASE": "${user_config.LMSTUDIO_API_BASE}",
+        "DEFAULT_ANALYSIS_MODE": "${user_config.DEFAULT_ANALYSIS_MODE}"
+      }
+    }
+  },
+  "tools": [
+    {
+      "name": "generate_changelog",
+      "description": "Generate AI-powered changelog from git commits or working directory changes"
+    },
+    {
+      "name": "analyze_repository",
+      "description": "Comprehensive repository analysis including health, commits, and branches"
+    },
+    {
+      "name": "analyze_current_changes",
+      "description": "Analyze staged and unstaged changes in working directory with AI-powered insights"
+    },
+    {
+      "name": "configure_providers",
+      "description": "Manage AI providers - list, switch, test, and configure"
+    }
+  ],
+  "tools_generated": false,
+  "user_config": {
+    "AI_PROVIDER": {
+      "type": "string",
+      "title": "AI Provider",
+      "description": "Choose your preferred AI provider, choose from: azure, openai, google, huggingface, ollama, lmstudio",
+      "required": false,
+      "sensitive": false,
+      "default": "openai"
+    },
+    "OPENAI_API_KEY": {
+      "type": "string",
+      "title": "OpenAI API Key",
+      "description": "Your OpenAI API key for GPT models",
+      "required": false,
+      "sensitive": true
+    },
+    "AZURE_OPENAI_KEY": {
+      "type": "string",
+      "title": "Azure OpenAI API Key",
+      "description": "Your Azure OpenAI API key",
+      "required": false,
+      "sensitive": true
+    },
+    "ANTHROPIC_API_KEY": {
+      "type": "string",
+      "title": "Anthropic API Key",
+      "description": "Your Anthropic API key for Claude models",
+      "required": false,
+      "sensitive": true
+    },
+    "GOOGLE_API_KEY": {
+      "type": "string",
+      "title": "Google AI API Key",
+      "description": "Your Google AI API key for Gemini models",
+      "required": false,
+      "sensitive": true
+    },
+    "HUGGINGFACE_API_KEY": {
+      "type": "string",
+      "title": "Hugging Face API Key",
+      "description": "Your Hugging Face API key",
+      "required": false,
+      "sensitive": true
+    },
+    "DEFAULT_ANALYSIS_MODE": {
+      "type": "string",
+      "title": "Default Analysis Mode",
+      "description": "Default mode for changelog generation (standard, detailed, or enterprise)",
+      "required": false,
+      "sensitive": false,
+      "default": "standard"
+    },
+    "AZURE_OPENAI_ENDPOINT": {
+      "type": "string",
+      "title": "Azure OpenAI Endpoint",
+      "description": "Your Azure OpenAI endpoint URL (e.g., https://your-resource.openai.azure.com)",
+      "required": false,
+      "sensitive": false
+    },
+    "AZURE_OPENAI_DEPLOYMENT_NAME": {
+      "type": "string",
+      "title": "Azure Deployment Name",
+      "description": "Your Azure OpenAI deployment name (e.g., gpt-4o)",
+      "required": false,
+      "sensitive": false
+    },
+    "VERTEX_PROJECT_ID": {
+      "type": "string",
+      "title": "Google Cloud Project ID",
+      "description": "Your Google Cloud Project ID for Vertex AI",
+      "required": false,
+      "sensitive": false
+    },
+    "OLLAMA_HOST": {
+      "type": "string",
+      "title": "Ollama Host",
+      "description": "Your Ollama server URL",
+      "required": false,
+      "sensitive": false,
+      "default": "http://localhost:11434"
+    },
+    "LMSTUDIO_API_BASE": {
+      "type": "string",
+      "title": "LM Studio API Base",
+      "description": "Your LM Studio server URL",
+      "required": false,
+      "sensitive": false,
+      "default": "http://localhost:1234/v1"
+    }
+  },
+  "keywords": [
+    "changelog",
+    "git",
+    "ai",
+    "automation",
+    "mcp",
+    "openai",
+    "claude",
+    "anthropic",
+    "gemini",
+    "azure",
+    "ollama",
+    "lmstudio",
+    "devops",
+    "release-notes",
+    "commit-analysis"
+  ],
+  "license": "MIT",
+  "compatibility": {
+    "claude_desktop": ">=1.0.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=22.x"
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@entro314labs/ai-changelog-generator",
   "displayName": "AI Changelog Generator",
-  "version": "3.3.0",
+  "version": "3.6.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",
@@ -14,6 +14,7 @@
     "bin/",
     "src/",
     "types/",
+    "manifest.json",
     "ai-changelog.sh",
     "ai-changelog-mcp.sh",
     "README.md",
@@ -21,38 +22,38 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.67.0",
-    "@aws-sdk/client-bedrock-runtime": "^3.913.0",
+    "@anthropic-ai/sdk": "^0.71.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.941.0",
     "@azure/identity": "^4.13.0",
     "@clack/prompts": "^0.11.0",
-    "@google/genai": "^1.25.0",
+    "@google/genai": "^1.30.0",
     "@google/generative-ai": "^0.24.1",
-    "@huggingface/hub": "^2.6.12",
-    "@huggingface/inference": "^4.11.3",
+    "@huggingface/hub": "^2.7.1",
+    "@huggingface/inference": "^4.13.4",
     "@lmstudio/sdk": "^1.5.0",
-    "@modelcontextprotocol/sdk": "^1.20.1",
-    "@modelcontextprotocol/server-filesystem": "2025.8.21",
+    "@modelcontextprotocol/sdk": "^1.23.0",
+    "@modelcontextprotocol/server-filesystem": "2025.11.25",
     "boxen": "^8.0.1",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "dotenv": "^17.2.3",
     "figures": "^6.1.0",
-    "google-auth-library": "^10.4.1",
+    "google-auth-library": "^10.5.0",
     "gradient-string": "^3.0.0",
-    "js-yaml": "^4.1.0",
-    "ollama": "^0.6.0",
-    "openai": "^6.5.0",
+    "js-yaml": "^4.1.1",
+    "ollama": "^0.6.3",
+    "openai": "^6.9.1",
     "ora": "^9.0.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@anthropic-ai/mcpb": "^1.1.1",
-    "@types/node": "24.8.1",
-    "@vitest/browser": "beta",
-    "@vitest/coverage-v8": "beta",
-    "@vitest/ui": "beta",
+    "@anthropic-ai/mcpb": "^2.0.1",
+    "@types/node": "24.10.1",
+    "@vitest/browser": "latest",
+    "@vitest/coverage-v8": "latest",
+    "@vitest/ui": "latest",
     "tempy": "^3.1.0",
-    "vitest": "beta"
+    "vitest": "latest"
   },
   "keywords": [
     "changelog",
@@ -94,8 +95,8 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.20.0",
-    "pnpm": ">=10.18.3"
+    "node": ">=22.21.1",
+    "pnpm": ">=10.23.0"
   },
   "funding": {
     "type": "github",
@@ -107,8 +108,8 @@
     }
   },
   "volta": {
-    "node": "22.20.0",
-    "pnpm": "10.18.3"
+    "node": "22.22.1",
+    "pnpm": "10.23.0"
   },
   "scripts": {
     "start": "node bin/ai-changelog.js",
@@ -146,14 +147,16 @@
     "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')\""
+    "mcpb:init": "mcpb init .",
+    "mcpb:validate": "mcpb validate manifest.json",
+    "mcpb:pack": "mcpb pack . ai-changelog-generator.mcpb",
+    "mcpb:build": "pnpm mcpb:validate && pnpm mcpb:pack",
+    "mcpb:info": "mcpb info ai-changelog-generator.mcpb",
+    "postinstall": "node -e \"console.log('🎉 AI Changelog Generator installed!⚡ Quick Start:  ai-changelog                 - Generate changelog  ai-changelog --detailed      - Detailed analysis  ai-changelog --interactive   - Interactive mode  ai-changelog-mcp            - Start MCP server🤖 AI Models Supported:  • GPT-4.1 series (1M context, 75% cost reduction)  • o3/o4 reasoning models (Azure-only)  • Automatic model selection📖 Docs: https://github.com/entro314-labs/AI-changelog-generator© All trademarks belong to their respective owners.')\""
   }
 }

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

@@ -168,7 +168,7 @@ export class ChangelogOrchestrator {
       }
 
       // Generate changelog using the service
-      const result = await this.changelogService.generateChangelog(version, since)
+      const result = await this.changelogService.generateChangelog(version, since, this.options)
 
       if (!result) {
         console.log(colors.warningMessage('No changelog generated'))
@@ -211,6 +211,12 @@ export class ChangelogOrchestrator {
   async runInteractive() {
     await this.ensureInitialized()
 
+    // Check for interactive environment
+    if (!process.stdin.isTTY && !process.env.CI) {
+      console.log(colors.warningMessage('Interactive mode requires a TTY terminal.'))
+      return { interactive: false, status: 'skipped' }
+    }
+
     const { runInteractiveMode } = await import('../../shared/utils/utils.js')
     const { confirm } = await this._getCachedImport('@clack/prompts')
 

package/src/cli.js

@@ -1,5 +1,17 @@
 #!/usr/bin/env node
 
+/**
+ * DEPRECATED: Legacy CLI Entry Point
+ *
+ * This file is deprecated and maintained only for backward compatibility.
+ * Please use bin/ai-changelog.js which delegates to CLIController instead.
+ *
+ * @deprecated Use bin/ai-changelog.js with CLIController
+ */
+
+console.warn('\n⚠️  WARNING: This CLI entry point is deprecated.')
+console.warn('Please use the main CLI: ai-changelog (or bin/ai-changelog.js)\n')
+
 /**
  * CLI Entry Point for AI Changelog Generator
  * Provides command-line interface for changelog generation functionality

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

@@ -31,9 +31,10 @@ export class ChangelogService {
    * 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
@@ -95,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,

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

@@ -1,9 +1,14 @@
 import colors from '../../shared/constants/colors.js'
+import { getWorkingDirectoryChanges } from '../../shared/utils/utils.js'
 import { ChangelogService } from './changelog.service.js'
 
 /**
  * WorkspaceChangelogService extends ChangelogService with workspace-specific functionality
  * for analyzing uncommitted changes and workspace state
+ *
+ * @deprecated This class is being phased out. The workspace changelog logic has been
+ * consolidated into ChangelogService. This class is maintained for backward compatibility
+ * with existing tests but should not be used in new code.
  */
 export class WorkspaceChangelogService extends ChangelogService {
   constructor(gitService, aiAnalysisService, analysisEngine = null, configManager = null) {
@@ -24,16 +29,34 @@ export class WorkspaceChangelogService extends ChangelogService {
     console.log(colors.processingMessage('🔍 Analyzing workspace changes...'))
 
     try {
-      // Get git status information
-      const status = await this.gitService.getStatus()
+      // Get git status information using utility function
+      const changes = getWorkingDirectoryChanges()
+
+      // Categorize changes
+      const status = {
+        staged: [],
+        unstaged: [],
+        untracked: []
+      }
+
+      changes.forEach(change => {
+        const statusCode = change.status || '??'
+        if (statusCode.startsWith('??')) {
+          status.untracked.push(change.filePath)
+        } else if (statusCode[0] !== ' ' && statusCode[0] !== '?') {
+          status.staged.push(change.filePath)
+        } else {
+          status.unstaged.push(change.filePath)
+        }
+      })
 
       // Update workspace metrics
       this.workspaceMetrics.unstagedFiles = status.unstaged?.length || 0
       this.workspaceMetrics.stagedFiles = status.staged?.length || 0
       this.workspaceMetrics.untrackedFiles = status.untracked?.length || 0
 
-      // Get detailed diff for staged/unstaged changes
-      const diff = await this.gitService.getDiff()
+      // Get detailed diff for staged/unstaged changes (empty for now)
+      const diff = ''
 
       // Use analysis engine if available
       let analysis = null
@@ -124,14 +147,24 @@ export class WorkspaceChangelogService extends ChangelogService {
   async validateWorkspace() {
     try {
       // Check if we're in a git repository
-      const isGitRepo = await this.gitService.isGitRepository()
+      let isGitRepo = false
+      try {
+        const { execSync } = await import('node:child_process')
+        execSync('git rev-parse --is-inside-work-tree', { stdio: 'ignore' })
+        isGitRepo = true
+      } catch {
+        isGitRepo = false
+      }
+
       if (!isGitRepo) {
         console.error(colors.errorMessage('Not in a git repository'))
         return false
       }
 
+      const changes = getWorkingDirectoryChanges()
+
       // Check if workspace has changes
-      if (!this.hasWorkspaceChanges()) {
+      if (!this.hasWorkspaceChanges() && changes.length === 0) {
         console.log(colors.infoMessage('No workspace changes detected'))
         return false
       }
@@ -201,14 +234,13 @@ export class WorkspaceChangelogService extends ChangelogService {
 
     for (const change of changes) {
       try {
-        // Get detailed diff for the file
-        const diff = await this.gitService.getFileDiff(change.file)
-
+        // For workspace changelog service, we don't have detailed diffs
+        // Just add basic enhancement
         enhancedChanges.push({
           ...change,
-          diff,
-          complexity: this.assessChangeComplexity(diff),
-          impact: this.assessChangeImpact(change.file, diff),
+          diff: '',
+          complexity: this.assessChangeComplexity(''),
+          impact: this.assessChangeImpact(change.file, ''),
         })
       } catch (error) {
         console.warn(

package/src/infrastructure/config/configuration.manager.js

@@ -5,15 +5,7 @@ import process from 'node:process'
 import yaml from 'js-yaml'
 
 import colors from '../../shared/constants/colors.js'
-
-// Model configurations - moved from lib/utils/model-config.js
-const MODEL_CONFIGS = {
-  'gpt-4': { maxTokens: 8192, cost: 0.03 },
-  'gpt-3.5-turbo': { maxTokens: 4096, cost: 0.002 },
-  'claude-3-opus': { maxTokens: 200000, cost: 0.015 },
-  'claude-3-sonnet': { maxTokens: 200000, cost: 0.003 },
-  'claude-3-haiku': { maxTokens: 200000, cost: 0.00025 },
-}
+import { MODEL_CONFIGS } from '../providers/utils/model-config.js'
 
 /**
  * Unified Configuration Manager

package/src/infrastructure/mcp/mcp-server.service.js

@@ -9,6 +9,7 @@ import fs from 'node:fs'
 import path, { dirname } from 'node:path'
 import process from 'node:process'
 import { fileURLToPath } from 'node:url'
+import { execSync } from 'node:child_process'
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
@@ -61,12 +62,17 @@ class AIChangelogMCPServer {
       // Set MCP server mode to suppress verbose logging
       process.env.MCP_SERVER_MODE = 'true'
 
+      // Initialize configuration
       this.configManager = new ConfigurationManager()
+
+      // Initialize application service
       this.applicationService = new ApplicationService()
+
+      // Initialize orchestrator with proper dependencies (it will create its own services)
       this.changelogOrchestrator = new ChangelogOrchestrator(this.configManager)
-      this.gitAnalyzer = new GitService()
-      this.analysisEngine = new AnalysisEngine()
-      this.providerService = new ProviderManagerService(this.configManager.getConfig())
+
+      // Initialize provider service
+      this.providerService = new ProviderManagerService(this.configManager.getAll())
 
       // Log available configuration
       const hasProvider = process.env.AI_PROVIDER
@@ -80,6 +86,9 @@ class AIChangelogMCPServer {
       } else {
         console.error(`[MCP] Configured with provider: ${process.env.AI_PROVIDER}`)
       }
+
+      // Wait for orchestrator to initialize its services
+      this.initPromise = this.changelogOrchestrator.ensureInitialized()
     } catch (error) {
       console.error('[MCP] Failed to initialize services:', error.message)
       console.error('[MCP] Server will start but tools may require configuration')
@@ -296,27 +305,55 @@ class AIChangelogMCPServer {
     } = args
 
     try {
+      // Ensure services are initialized
+      if (this.initPromise) {
+        await this.initPromise
+      }
+
       let result
 
       if (source === 'working-dir' || (source === 'auto' && this.hasWorkingDirectoryChanges())) {
-        // Generate from working directory changes
-        result = await this.changelogOrchestrator.generateWorkspaceChangelog({
-          version,
+        // Generate from working directory changes using ChangelogService
+        // Access the changelogService through the orchestrator
+        await this.changelogOrchestrator.ensureInitialized()
+        const changelogService = this.changelogOrchestrator.changelogService
+
+        result = await changelogService.generateWorkspaceChangelog(version, {
           analysisMode,
           includeAttribution,
         })
+
+        // Format result to match expected structure
+        if (result && result.changelog) {
+          result = {
+            content: result.changelog,
+            metadata: {
+              version,
+              source: 'working-directory',
+              filesProcessed: result.filesProcessed,
+              filesSkipped: result.filesSkipped,
+            }
+          }
+        }
       } else {
-        // Generate from commits
-        result = await this.changelogOrchestrator.generateChangelog({
-          version,
-          since,
-          analysisMode,
-          includeAttribution,
-        })
+        // Generate from commits - use orchestrator's generateChangelog(version, since)
+        result = await this.changelogOrchestrator.generateChangelog(version, since)
+
+        // Wrap result if needed
+        if (result && typeof result === 'string') {
+          result = {
+            content: result,
+            metadata: {
+              version,
+              since,
+              source: 'commits'
+            }
+          }
+        }
       }
 
       // Write file if requested
-      if (writeFile && result.content) {
+      if (writeFile && result && result.content) {
         const changelogPath = path.join(process.cwd(), 'AI_CHANGELOG.md')
         try {
           fs.writeFileSync(changelogPath, result.content, 'utf8')
@@ -330,10 +367,10 @@ class AIChangelogMCPServer {
         content: [
           {
             type: 'text',
-            text: result.content || 'No changelog content generated',
+            text: result?.content || 'No changelog content generated',
           },
         ],
-        metadata: result.metadata,
+        metadata: result?.metadata,
       }
     } catch (error) {
       throw new Error(`Changelog generation failed: ${error.message}`)
@@ -344,23 +381,30 @@ class AIChangelogMCPServer {
     const { analysisType = 'comprehensive', includeRecommendations = true, commitLimit = 50 } = args
 
     try {
+      // Ensure services are initialized
+      if (this.initPromise) {
+        await this.initPromise
+      }
+      await this.changelogOrchestrator.ensureInitialized()
+
       let result
 
       switch (analysisType) {
         case 'health':
-          result = await this.gitAnalyzer.assessRepositoryHealth(includeRecommendations)
+          result = await this.changelogOrchestrator.gitService.assessRepositoryHealth(includeRecommendations)
           break
         case 'commits':
-          result = await this.analysisEngine.analyzeRecentCommits(commitLimit)
+          result = await this.changelogOrchestrator.analysisEngine.analyzeRecentCommits(commitLimit)
           break
         case 'branches':
-          result = await this.gitAnalyzer.analyzeBranches()
+          result = await this.changelogOrchestrator.gitService.analyzeBranches()
           break
         case 'working-dir':
-          result = await this.analysisEngine.analyzeCurrentChanges()
+          result = await this.changelogOrchestrator.analysisEngine.analyzeCurrentChanges()
           break
         default:
-          result = await this.gitAnalyzer.analyzeComprehensive(includeRecommendations)
+          // Comprehensive analysis
+          result = await this.changelogOrchestrator.analyzeRepository({ type: analysisType })
           break
       }
 
@@ -381,7 +425,13 @@ class AIChangelogMCPServer {
     const { includeAIAnalysis = true, includeAttribution = true } = args
 
     try {
-      const result = await this.analysisEngine.analyzeCurrentChanges({
+      // Ensure services are initialized
+      if (this.initPromise) {
+        await this.initPromise
+      }
+      await this.changelogOrchestrator.ensureInitialized()
+
+      const result = await this.changelogOrchestrator.analysisEngine.analyzeCurrentChanges({
         includeAIAnalysis,
         includeAttribution,
       })
@@ -472,7 +522,6 @@ class AIChangelogMCPServer {
   hasWorkingDirectoryChanges() {
     try {
       // Simple check for working directory changes
-      const { execSync } = require('node:child_process')
       const result = execSync('git status --porcelain', { encoding: 'utf8' })
       return result.trim().length > 0
     } catch (_error) {

package/src/shared/utils/cli-ui.js

@@ -223,8 +223,13 @@ export class EnhancedConsole {
     EnhancedConsole.log(message, 'ai')
   }
 
-  static metrics(message) {
-    EnhancedConsole.log(message, 'metrics')
+  static metrics(data, title = 'Metrics') {
+    if (typeof data === 'string') {
+      EnhancedConsole.log(data, 'metrics')
+    } else if (data && Object.keys(data).length > 0) {
+      EnhancedConsole.section(title)
+      console.log(colors.formatMetrics(data))
+    }
   }
 
   static section(title, content = '') {
@@ -252,13 +257,6 @@ export class EnhancedConsole {
     }
   }
 
-  static metrics(metrics, title = 'Metrics') {
-    if (metrics && Object.keys(metrics).length > 0) {
-      EnhancedConsole.section(title)
-      console.log(colors.formatMetrics(metrics))
-    }
-  }
-
   static divider(char = '─', length = 60) {
     console.log(colors.separator(char, length))
   }

package/src/shared/utils/utils.js

@@ -1144,7 +1144,7 @@ ${enhancedMergeSummary}
         'ENHANCED MERGE SUMMARY:\n' + (enhancedMergeSummary || 'None') + '\n\n' +
         'FILES SECTION (first 3000 chars):\n' + filesSection.substring(0, 3000) + '\n\n' +
         'FULL PROMPT PREVIEW:\n' + prompt.substring(0, 2000) + '\n=== END DEBUG ==='
-      
+
       fs.writeFileSync('AI_INPUT_DEBUG.txt', debugContent)
       console.log('*** AI INPUT SAVED TO AI_INPUT_DEBUG.txt ***')
     } catch (error) {
@@ -1439,6 +1439,15 @@ function extractCategoryFromText(content) {
  */
 /**
  * Get raw working directory changes from git status
+ *
+ * Note: This is a lightweight utility function that shells out to git directly
+ * for simple status checks. For comprehensive git operations, services should
+ * use GitService/GitManager, but this utility is kept for:
+ * - Performance (avoids service initialization overhead)
+ * - Simplicity (standalone function for basic status checks)
+ * - Backward compatibility (widely used across codebase)
+ *
+ * @returns {Array} Array of change objects with status and filePath
  */
 export function getWorkingDirectoryChanges() {
   try {
@@ -1826,11 +1835,11 @@ function assessWorkspaceComplexity(categorizedChanges, totalFiles) {
  * Handle unified output for analysis commands
  */
 export function handleUnifiedOutput(data, config) {
-  const { format = 'markdown', outputFile, silent } = config
+  const { format = 'markdown', outputFile, silent, dryRun } = config
   if (format === 'json') {
     const jsonOutput = safeJsonStringify(data)
 
-    if (outputFile) {
+    if (outputFile && !dryRun) {
       // Write to file
       try {
         fs.writeFileSync(outputFile, jsonOutput, 'utf8')
@@ -1844,13 +1853,16 @@ export function handleUnifiedOutput(data, config) {
         }
       }
     } else if (!silent) {
+      if (dryRun && outputFile) {
+        console.log(colors.infoMessage(`[DRY RUN] Would save changelog to: ${colors.file(outputFile)}`))
+      }
       console.log(jsonOutput)
     }
   } else {
     // Markdown format (default)
     const markdownOutput = typeof data === 'string' ? data : safeJsonStringify(data)
 
-    if (outputFile) {
+    if (outputFile && !dryRun) {
       try {
         fs.writeFileSync(outputFile, markdownOutput, 'utf8')
         if (!silent) {
@@ -1863,6 +1875,9 @@ export function handleUnifiedOutput(data, config) {
         }
       }
     } else if (!silent) {
+      if (dryRun && outputFile) {
+        console.log(colors.infoMessage(`[DRY RUN] Would save changelog to: ${colors.file(outputFile)}`))
+      }
       console.log(markdownOutput)
     }
   }

package/types/index.d.ts

@@ -310,51 +310,42 @@ export class AIChangelogGenerator {
   constructor(constructorOptions?: {
     repositoryPath?: string
     configPath?: string
+    analysisMode?: AnalysisMode
+    modelOverride?: AIModel
+    dryRun?: boolean
+    silent?: boolean
   })
 
-  // Core methods
-  run(): Promise<void>
-  generateChangelog(changelogOptions?: ChangelogOptions): Promise<string>
-  analyzeCommits(commitOptions?: {
-    since?: string
-    limit?: number
-    repositoryPath?: string
-  }): Promise<CommitAnalysis>
+  // Core methods (these actually exist in the implementation)
+  generateChangelog(version?: string | null, since?: string | null): Promise<string>
 
-  // Enhanced analysis methods
-  analyzeCurrentChanges(analysisOptions?: {
-    includeAIAnalysis?: boolean
-    repositoryPath?: string
-  }): Promise<CurrentChangesAnalysis>
+  // Analysis methods
+  analyzeRepository(config?: { type?: string }): Promise<any>
+  analyzeCurrentChanges(): Promise<CurrentChangesAnalysis>
+  analyzeRecentCommits(limit?: number): Promise<CommitAnalysis>
+  analyzeBranches(config?: any): Promise<BranchAnalysis>
+  analyzeComprehensive(config?: any): Promise<RepositoryHealthCheck>
 
-  analyzeBranches(branchOptions?: {
-    includeAllBranches?: boolean
-    repositoryPath?: string
-  }): Promise<BranchAnalysis>
+  // Repository health
+  assessRepositoryHealth(includeRecommendations?: boolean): Promise<any>
 
-  analyzeRepository(repoOptions?: { repositoryPath?: string }): Promise<RepositoryHealthCheck>
+  // Interactive mode
+  runInteractive(): Promise<void>
 
-  // Configuration and validation
-  validateConfig(): Promise<{
-    success: boolean
-    provider?: AIProvider
-    model?: AIModel
-    capabilities?: ModelCapabilities
-    error?: string
-  }>
+  // Configuration
+  setAnalysisMode(mode: AnalysisMode): void
+  setModelOverride(model: AIModel): void
 
-  validateModels(): Promise<{
-    success: boolean
-    models?: Array<{
-      name: AIModel
-      available: boolean
-      capabilities?: ModelCapabilities
-    }>
-    error?: string
-  }>
+  // Validation
+  validateConfiguration(): Promise<void>
 
-  // Git operations
-  getGitInfo(gitOptions?: { includeStats?: boolean; repositoryPath?: string }): Promise<GitInfo>
+  // Metrics
+  getMetrics(): {
+    startTime: number
+    commitsProcessed: number
+    apiCalls: number
+    errors: number
+  }
 }
 
 export class AIChangelogMCPServer {
@@ -362,53 +353,55 @@ export class AIChangelogMCPServer {
 
   run(): Promise<void>
 
-  // MCP Tools
+  // MCP Tools (these match the actual implementation)
   generateChangelog(params: {
     repositoryPath?: string
+    source?: 'commits' | 'working-dir' | 'auto'
     analysisMode?: AnalysisMode
-    outputFormat?: OutputFormat
     since?: string
     version?: string
-    includeUnreleased?: boolean
-    model?: AIModel
-  }): Promise<string>
+    includeAttribution?: boolean
+    writeFile?: boolean
+  }): Promise<{
+    content: Array<{
+      type: 'text'
+      text: string
+    }>
+    metadata?: any
+  }>
 
-  analyzeCommits(params: {
+  analyzeRepository(params: {
     repositoryPath?: string
-    limit?: number
-    since?: string
-  }): Promise<CommitAnalysis>
+    analysisType?: 'health' | 'commits' | 'branches' | 'working-dir' | 'comprehensive'
+    includeRecommendations?: boolean
+    commitLimit?: number
+  }): Promise<{
+    content: Array<{
+      type: 'text'
+      text: string
+    }>
+  }>
 
   analyzeCurrentChanges(params: {
     repositoryPath?: string
     includeAIAnalysis?: boolean
-  }): Promise<CurrentChangesAnalysis>
-
-  getGitInfo(params: { repositoryPath?: string; includeStats?: boolean }): Promise<GitInfo>
-
-  configureAIProvider(params: {
-    provider?: AIProvider
-    showModels?: boolean
-    testConnection?: boolean
+    includeAttribution?: boolean
   }): Promise<{
-    success: boolean
-    provider?: AIProvider
-    models?: AIModel[]
-    error?: string
+    content: Array<{
+      type: 'text'
+      text: string
+    }>
   }>
 
-  validateModels(params: {
-    provider?: AIProvider
-    checkCapabilities?: boolean
-    testModels?: boolean
+  configureProviders(params: {
+    action?: 'list' | 'switch' | 'test' | 'configure' | 'validate'
+    provider?: string
+    testConnection?: boolean
   }): Promise<{
-    success: boolean
-    models?: Array<{
-      name: AIModel
-      available: boolean
-      capabilities?: ModelCapabilities
+    content: Array<{
+      type: 'text'
+      text: string
     }>
-    error?: string
   }>
 }