scripts/generate-release-notes.js

#!/usr/bin/env node

/**
 * Generate release notes from commit messages between two tags
 * Used by GitHub Actions to create automated release notes
 */

const { execSync } = require('child_process');
const fs = require('fs');
const path = require('path');

function generateReleaseNotes(previousTag, currentTag) {
  try {
    console.log(`Generating release notes from ${previousTag} to ${currentTag}`);

    // Get commits between tags
    const gitLogCommand = `git log --pretty=format:"%H|%s|%an|%ae|%ad" --date=short --no-merges ${previousTag}..${currentTag}`;
    const commitsOutput = execSync(gitLogCommand, { encoding: 'utf8' });

    if (!commitsOutput.trim()) {
      console.log('No commits found between tags');
      return 'No changes in this release.';
    }

    const commits = commitsOutput.trim().split('\n').map(line => {
      const [hash, subject, author, email, date] = line.split('|');
      return { hash, subject, author, email, date };
    });

    // Categorize commits
    const categories = {
      'feat': { title: '✨ Features', commits: [] },
      'fix': { title: '🐛 Bug Fixes', commits: [] },
      'docs': { title: '📚 Documentation', commits: [] },
      'refactor': { title: '♻️ Refactoring', commits: [] },
      'test': { title: '🧪 Testing', commits: [] },
      'perf': { title: '⚡ Performance', commits: [] },
      'style': { title: '💅 Styling', commits: [] },
      'ci': { title: '🔧 CI/CD', commits: [] },
      'build': { title: '📦 Build', commits: [] },
      'chore': { title: '🔧 Maintenance', commits: [] },
      'other': { title: '📝 Other Changes', commits: [] }
    };

    commits.forEach(commit => {
      const subject = commit.subject.toLowerCase();
      let categorized = false;

      // Check for conventional commit prefixes
      for (const [prefix, category] of Object.entries(categories)) {
        if (prefix !== 'other' && subject.startsWith(`${prefix}:`)) {
          category.commits.push(commit);
          categorized = true;
          break;
        }
      }

      // If not categorized, put in other
      if (!categorized) {
        categories.other.commits.push(commit);
      }
    });

    // Generate release notes
    const releaseNotes = [];

    for (const [key, category] of Object.entries(categories)) {
      if (category.commits.length > 0) {
        releaseNotes.push(`### ${category.title}`);
        releaseNotes.push('');

        category.commits.forEach(commit => {
          // Clean up the subject by removing the prefix if it exists
          let cleanSubject = commit.subject;
          const colonIndex = cleanSubject.indexOf(':');
          if (colonIndex !== -1 && cleanSubject.substring(0, colonIndex).match(/^(feat|fix|docs|refactor|test|perf|style|ci|build|chore)$/)) {
            cleanSubject = cleanSubject.substring(colonIndex + 1).trim();
            // Capitalize first letter
            cleanSubject = cleanSubject.charAt(0).toUpperCase() + cleanSubject.slice(1);
          }

          releaseNotes.push(`- ${cleanSubject} (${commit.hash.substring(0, 7)})`);
        });

        releaseNotes.push('');
      }
    }

    // Add commit statistics
    const totalCommits = commits.length;
    const contributors = [...new Set(commits.map(c => c.author))];

    releaseNotes.push('---');
    releaseNotes.push('');
    releaseNotes.push(`**Release Statistics:**`);
    releaseNotes.push(`- ${totalCommits} commit${totalCommits !== 1 ? 's' : ''}`);
    releaseNotes.push(`- ${contributors.length} contributor${contributors.length !== 1 ? 's' : ''}`);

    if (contributors.length <= 5) {
      releaseNotes.push(`- Contributors: ${contributors.join(', ')}`);
    }

    return releaseNotes.join('\n');

  } catch (error) {
    console.error(`Error generating release notes: ${error.message}`);
    return `Failed to generate release notes: ${error.message}`;
  }
}

// Parse command line arguments
const previousTag = process.argv[2];
const currentTag = process.argv[3];

if (!previousTag || !currentTag) {
  console.error('Usage: generate-release-notes.js <previous-tag> <current-tag>');
  process.exit(1);
}

const releaseNotes = generateReleaseNotes(previousTag, currentTag);
console.log(releaseNotes);