@entro314labs/ai-changelog-generator 3.6.1 → 3.7.0

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "ai-changelog-generator",
   "display_name": "AI Changelog Generator",
-  "version": "3.6.1",
+  "version": "3.7.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": {
@@ -56,6 +56,18 @@
     {
       "name": "configure_providers",
       "description": "Manage AI providers - list, switch, test, and configure"
+    },
+    {
+      "name": "analyze_stash",
+      "description": "List and analyze git stashed changes with AI-powered insights"
+    },
+    {
+      "name": "list_provider_models",
+      "description": "List available AI models for configured providers"
+    },
+    {
+      "name": "check_provider_health",
+      "description": "Check health status and connectivity of all AI providers"
     }
   ],
   "tools_generated": false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@entro314labs/ai-changelog-generator",
   "displayName": "AI Changelog Generator",
-  "version": "3.6.1",
+  "version": "3.7.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",
@@ -22,16 +22,16 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.71.0",
-    "@aws-sdk/client-bedrock-runtime": "^3.941.0",
+    "@anthropic-ai/sdk": "^0.71.2",
+    "@aws-sdk/client-bedrock-runtime": "^3.948.0",
     "@azure/identity": "^4.13.0",
     "@clack/prompts": "^0.11.0",
-    "@google/genai": "^1.30.0",
+    "@google/genai": "^1.33.0",
     "@google/generative-ai": "^0.24.1",
     "@huggingface/hub": "^2.7.1",
-    "@huggingface/inference": "^4.13.4",
+    "@huggingface/inference": "^4.13.5",
     "@lmstudio/sdk": "^1.5.0",
-    "@modelcontextprotocol/sdk": "^1.23.0",
+    "@modelcontextprotocol/sdk": "^1.24.3",
     "@modelcontextprotocol/server-filesystem": "2025.11.25",
     "boxen": "^8.0.1",
     "chalk": "^5.6.2",
@@ -42,13 +42,13 @@
     "gradient-string": "^3.0.0",
     "js-yaml": "^4.1.1",
     "ollama": "^0.6.3",
-    "openai": "^6.9.1",
+    "openai": "^6.10.0",
     "ora": "^9.0.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@anthropic-ai/mcpb": "^2.0.1",
-    "@types/node": "24.10.1",
+    "@anthropic-ai/mcpb": "^2.1.2",
+    "@types/node": "25.0.1",
     "@vitest/browser": "latest",
     "@vitest/coverage-v8": "latest",
     "@vitest/ui": "latest",

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

@@ -154,7 +154,7 @@ export class ChangelogOrchestrator {
     }
   }
 
-  async generateChangelog(version, since) {
+  async generateChangelog(version, since, extraOptions = {}) {
     try {
       await this.ensureInitialized()
 
@@ -167,8 +167,34 @@ export class ChangelogOrchestrator {
         throw new Error('Not a git repository')
       }
 
+      // Handle tag range option (e.g., v1.0.0..v2.0.0)
+      let effectiveSince = since
+      let effectiveUntil = 'HEAD'
+      if (extraOptions.tagRange) {
+        const [fromTag, toTag] = extraOptions.tagRange.split('..')
+        if (fromTag) {
+          effectiveSince = fromTag
+        }
+        if (toTag) {
+          effectiveUntil = toTag
+        }
+        console.log(colors.infoMessage(`📦 Generating changelog between tags: ${fromTag} → ${toTag || 'HEAD'}`))
+      }
+
+      // Display author filter if specified
+      if (extraOptions.author) {
+        console.log(colors.infoMessage(`👤 Filtering commits by author: ${extraOptions.author}`))
+      }
+
+      // Merge options
+      const mergedOptions = {
+        ...this.options,
+        author: extraOptions.author,
+        until: effectiveUntil,
+      }
+
       // Generate changelog using the service
-      const result = await this.changelogService.generateChangelog(version, since, this.options)
+      const result = await this.changelogService.generateChangelog(version, effectiveSince, mergedOptions)
 
       if (!result) {
         console.log(colors.warningMessage('No changelog generated'))

package/src/application/services/application.service.js

@@ -41,8 +41,14 @@ export class ApplicationService {
 
   async generateChangelog(options = {}) {
     try {
-      const { version, since } = options
-      return await this.orchestrator.generateChangelog(version, since)
+      const { version, since, author, tagRange, format, output, dryRun } = options
+      return await this.orchestrator.generateChangelog(version, since, {
+        author,
+        tagRange,
+        format,
+        output,
+        dryRun,
+      })
     } catch (error) {
       console.error(colors.errorMessage('Application service error:'), error.message)
       throw error

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

@@ -37,8 +37,11 @@ export class ChangelogService {
   async generateChangelog(version = null, since = null, options = {}) {
     console.log(colors.processingMessage('🤖 Analyzing changes with AI...'))
 
-    // Get committed changes
-    const commits = await this.gitService.getCommitsSince(since)
+    // Get committed changes with optional filters
+    const commits = await this.gitService.getCommitsSince(since, {
+      author: options.author,
+      until: options.until,
+    })
 
     // Get working directory changes using analysis engine
     let workingDirAnalysis = null

package/src/domains/git/git-manager.js

@@ -205,11 +205,43 @@ export class GitManager {
    * Get commits between two references
    * @param {string} from - Starting reference (commit, tag, branch)
    * @param {string} to - Ending reference (default: 'HEAD')
+   * @param {Object} options - Optional filters
+   * @param {string} options.author - Filter by author name or email
    * @returns {Array<Object>} Array of commit objects
    */
-  getCommitsBetween(from, to = 'HEAD') {
+  getCommitsBetween(from, to = 'HEAD', options = {}) {
     try {
-      const output = this.execGitSafe(`git log ${from}..${to} --oneline`)
+      let command = `git log ${from}..${to} --oneline`
+      if (options.author) {
+        command += ` --author="${options.author}"`
+      }
+      const output = this.execGitSafe(command)
+      return output
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => {
+          const [hash, ...messageParts] = line.split(' ')
+          return {
+            hash: hash.trim(),
+            message: messageParts.join(' '),
+          }
+        })
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * Get commits filtered by author
+   * @param {string} author - Author name or email to filter by
+   * @param {number} limit - Maximum number of commits to return
+   * @returns {Array<Object>} Array of commit objects by this author
+   */
+  getCommitsByAuthor(author, limit = 50) {
+    try {
+      const output = this.execGitSafe(
+        `git log --author="${author}" --oneline -n ${limit}`
+      )
       return output
         .split('\n')
         .filter((line) => line.trim())
@@ -225,6 +257,116 @@ export class GitManager {
     }
   }
 
+  /**
+   * Get commits between two tags
+   * @param {string} fromTag - Starting tag
+   * @param {string} toTag - Ending tag (default: 'HEAD')
+   * @param {Object} options - Optional filters
+   * @returns {Array<Object>} Array of commit objects between tags
+   */
+  getCommitsBetweenTags(fromTag, toTag = 'HEAD', options = {}) {
+    return this.getCommitsBetween(fromTag, toTag, options)
+  }
+
+  /**
+   * Get list of all authors in repository
+   * @returns {Array<string>} Array of unique author names
+   */
+  getAllAuthors() {
+    try {
+      const output = this.execGitSafe('git log --format="%an" | sort -u')
+      return output
+        .split('\n')
+        .filter((name) => name.trim())
+        .sort()
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * Get list of stashed changes
+   * @returns {Array<Object>} Array of stash entries with index, message, and date
+   */
+  getStashList() {
+    try {
+      const output = this.execGitSafe('git stash list --format="%gd|%gs|%ci"')
+      if (!output.trim()) {
+        return []
+      }
+      return output
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => {
+          const [index, message, date] = line.split('|')
+          return {
+            index: index.trim(),
+            message: message.trim(),
+            date: date.trim(),
+          }
+        })
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * Get detailed information about a specific stash entry
+   * @param {string} stashRef - Stash reference (e.g., 'stash@{0}')
+   * @returns {Object|null} Stash details including files changed
+   */
+  getStashDetails(stashRef = 'stash@{0}') {
+    try {
+      // Get stash message
+      const message = this.execGitSafe(`git stash list --format="%gs" -1 ${stashRef}`).trim()
+
+      // Get files changed in stash
+      const statOutput = this.execGitSafe(`git stash show ${stashRef} --stat`)
+      const diffOutput = this.execGitSafe(`git stash show ${stashRef} -p`)
+
+      // Parse stat output for files
+      const files = statOutput
+        .split('\n')
+        .filter((line) => line.includes('|'))
+        .map((line) => {
+          const match = line.match(/^\s*(.+?)\s*\|\s*(\d+)/)
+          if (match) {
+            return {
+              path: match[1].trim(),
+              changes: parseInt(match[2], 10),
+            }
+          }
+          return null
+        })
+        .filter(Boolean)
+
+      // Get summary stats
+      const summaryMatch = statOutput.match(/(\d+) files? changed(?:, (\d+) insertions?)?(?:, (\d+) deletions?)?/)
+
+      return {
+        ref: stashRef,
+        message,
+        files,
+        diff: diffOutput,
+        stats: {
+          filesChanged: summaryMatch ? parseInt(summaryMatch[1], 10) : files.length,
+          insertions: summaryMatch && summaryMatch[2] ? parseInt(summaryMatch[2], 10) : 0,
+          deletions: summaryMatch && summaryMatch[3] ? parseInt(summaryMatch[3], 10) : 0,
+        },
+      }
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Check if there are any stashed changes
+   * @returns {boolean} True if stash has entries
+   */
+  hasStashedChanges() {
+    return this.getStashList().length > 0
+  }
+
   /**
    * Check if a file exists in a specific commit
    * @param {string} commitHash - The commit to check

package/src/domains/git/git.service.js

@@ -333,9 +333,29 @@ export class GitService {
     }
   }
 
-  async getCommitsSince(since) {
+  async getCommitsSince(since, options = {}) {
     try {
-      const command = since ? `git log --oneline --since="${since}"` : 'git log --oneline -10'
+      let command = 'git log --oneline'
+
+      // Handle different "since" formats
+      if (since) {
+        // Check if it's a tag/ref (starts with v, contains dots, or is a commit hash)
+        const isRef = /^v?\d|^[a-f0-9]{6,40}$/i.test(since)
+        if (isRef) {
+          const until = options.until || 'HEAD'
+          command = `git log ${since}..${until} --oneline`
+        } else {
+          // Treat as date
+          command += ` --since="${since}"`
+        }
+      } else {
+        command += ' -10'
+      }
+
+      // Add author filter if specified
+      if (options.author) {
+        command += ` --author="${options.author}"`
+      }
 
       const output = this.gitManager.execGitSafe(command)
       return output