@entro314labs/ai-changelog-generator 3.2.1 → 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.2.1",
+  "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,94 +14,46 @@
     "bin/",
     "src/",
     "types/",
+    "manifest.json",
     "ai-changelog.sh",
     "ai-changelog-mcp.sh",
     "README.md",
     "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.71.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.941.0",
+    "@azure/identity": "^4.13.0",
     "@clack/prompts": "^0.11.0",
-    "@google/genai": "^1.13.0",
+    "@google/genai": "^1.30.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.7.1",
+    "@huggingface/inference": "^4.13.4",
+    "@lmstudio/sdk": "^1.5.0",
+    "@modelcontextprotocol/sdk": "^1.23.0",
+    "@modelcontextprotocol/server-filesystem": "2025.11.25",
     "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.5.0",
     "gradient-string": "^3.0.0",
-    "js-yaml": "^4.1.0",
-    "ollama": "^0.5.17",
-    "openai": "^5.12.2",
-    "ora": "^8.2.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/dxt": "^0.2.6",
-    "@types/node": "24.2.1",
-    "@vitest/coverage-v8": "^3.2.4",
-    "@vitest/ui": "^3.2.4",
+    "@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": "^3.2.4"
+    "vitest": "latest"
   },
   "keywords": [
     "changelog",
@@ -143,8 +95,8 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.0.0",
-    "pnpm": ">=8.0.0"
+    "node": ">=22.21.1",
+    "pnpm": ">=10.23.0"
   },
   "funding": {
     "type": "github",
@@ -156,12 +108,55 @@
     }
   },
   "volta": {
-    "node": "22.17.1",
-    "pnpm": "9.17.0"
+    "node": "22.22.1",
+    "pnpm": "10.23.0"
   },
-  "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",
+    "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",
+    "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/ai-changelog-generator.js

@@ -204,16 +204,17 @@ export class AIChangelogGenerator {
   // Utility methods for backward compatibility
   get hasAI() {
     try {
-      return this.appService?.orchestrator?.aiProvider?.isAvailable() || false
-    } catch (error) {
+      return this.appService?.orchestrator?.aiProvider?.isAvailable()
+    } catch (_error) {
       return false
     }
   }
 
   get gitExists() {
     try {
-      return this.appService?.orchestrator?.gitManager?.isGitRepo || false
-    } catch (error) {
+      const isGitRepo = this.appService?.orchestrator?.gitManager?.isGitRepo
+      return Boolean(isGitRepo)
+    } catch (_error) {
       return false
     }
   }