@theihtisham/ai-release-notes 1.0.0

package/src/formatter.js

@@ -0,0 +1,336 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const logger = require('./logger');
+const { formatDiffStats } = require('./diff-analyzer');
+const { formatContributorThanks } = require('./contributor');
+
+/**
+ * Format release notes using a template.
+ * @param {Object} analysis - Analysis results
+ * @param {Object} diffSummary - Diff analysis results
+ * @param {string} version - Current version
+ * @param {string} previousVersion - Previous version
+ * @param {Object} config - Configuration object
+ * @returns {string} Formatted release notes
+ */
+function formatReleaseNotes(analysis, diffSummary, version, previousVersion, config) {
+  try {
+    const template = loadTemplate(config.template);
+    const repoUrl = config.repoUrl || `https://github.com/${config.repoFullName || 'owner/repo'}`;
+
+    const variables = {
+      version: version || '0.0.0',
+      previous_version: previousVersion || '',
+      date: new Date().toISOString().split('T')[0],
+      summary: generateSummary(analysis, version),
+      categories: formatCategories(analysis.categories || {}),
+      breaking_changes: config.includeBreaking ? formatBreakingChanges(analysis.breaking || []) : '',
+      contributors: config.includeContributors ? formatContributors(analysis.contributors || []) : '',
+      diff_stats: config.includeDiffStats ? formatDiffStats(diffSummary) : '',
+      full_changelog_link: formatChangelogLink(repoUrl, previousVersion, version),
+      screenshots: config.includeScreenshots ? formatScreenshots(analysis.screenshots || []) : '',
+      bullet_points: formatBulletPoints(analysis.categories || {}),
+      linked_issues: formatLinkedIssues(analysis.linkedIssues || [], repoUrl),
+      impact_assessment: formatImpactAssessment(diffSummary),
+      action_items: generateActionItems(analysis, diffSummary),
+      known_issues: '',
+    };
+
+    let output = template;
+
+    // Replace all template variables
+    for (const [key, value] of Object.entries(variables)) {
+      const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+      output = output.replace(regex, value || '');
+    }
+
+    // Clean up any remaining unresolved template variables
+    output = cleanUnresolvedVariables(output);
+
+    // Clean up excessive blank lines
+    output = output.replace(/\n{3,}/g, '\n\n').trim();
+
+    return output;
+  } catch (err) {
+    logger.error('Failed to format release notes', err);
+    return `## Release v${version || '0.0.0'}\n\nGenerated on ${new Date().toISOString().split('T')[0]}`;
+  }
+}
+
+/**
+ * Load a template by name or file path.
+ */
+function loadTemplate(templateName) {
+  const builtInTemplates = ['default', 'minimal', 'detailed', 'enterprise', 'fun'];
+
+  if (builtInTemplates.includes(templateName)) {
+    const templatePath = path.join(__dirname, '..', 'templates', `${templateName}.md`);
+    try {
+      return fs.readFileSync(templatePath, 'utf-8');
+    } catch (err) {
+      logger.warn(`Built-in template "${templateName}" not found at ${templatePath}, using fallback`);
+      return '## What\'s Changed\n\n{{categories}}\n\n**Full Changelog**: {{full_changelog_link}}';
+    }
+  }
+
+  // Custom template file path
+  try {
+    const resolvedPath = path.resolve(templateName);
+    return fs.readFileSync(resolvedPath, 'utf-8');
+  } catch (err) {
+    logger.warn(`Custom template "${templateName}" not found, using default`);
+    try {
+      return fs.readFileSync(path.join(__dirname, '..', 'templates', 'default.md'), 'utf-8');
+    } catch (fallbackErr) {
+      return '## What\'s Changed\n\n{{categories}}\n\n**Full Changelog**: {{full_changelog_link}}';
+    }
+  }
+}
+
+/**
+ * Generate a one-line summary of the release.
+ */
+function generateSummary(analysis, version) {
+  if (!analysis || !analysis.stats) {
+    return `Release v${version} includes various improvements and fixes.`;
+  }
+
+  const parts = [];
+  const categoryCount = Object.keys(analysis.categories || {}).length;
+  const commitCount = analysis.stats.total_commits || 0;
+  const contributorCount = (analysis.contributors || []).length;
+
+  if (commitCount > 0) {
+    parts.push(`${commitCount} commit${commitCount !== 1 ? 's' : ''}`);
+  }
+  if (categoryCount > 0) {
+    parts.push(`${categoryCount} categor${categoryCount !== 1 ? 'ies' : 'y'} of changes`);
+  }
+  if (contributorCount > 0) {
+    parts.push(`${contributorCount} contributor${contributorCount !== 1 ? 's' : ''}`);
+  }
+
+  if (analysis.breaking && analysis.breaking.length > 0) {
+    parts.push(`${analysis.breaking.length} breaking change${analysis.breaking.length !== 1 ? 's' : ''}`);
+  }
+
+  if (parts.length === 0) {
+    return `Release v${version} includes various improvements and fixes.`;
+  }
+
+  return `Release v${version} brings ${parts.join(', ')}.`;
+}
+
+/**
+ * Format categorized changes as markdown sections.
+ */
+function formatCategories(categories) {
+  if (!categories || Object.keys(categories).length === 0) {
+    return 'No categorized changes in this release.';
+  }
+
+  const lines = [];
+  for (const [category, changes] of Object.entries(categories)) {
+    lines.push(`### ${category}`);
+    lines.push('');
+    for (const change of changes) {
+      let line = `- ${change.description}`;
+      if (change.pr) {
+        line += ` (#${change.pr})`;
+      }
+      if (change.author) {
+        line += ` by @${change.author}`;
+      }
+      lines.push(line);
+    }
+    lines.push('');
+  }
+
+  return lines.join('\n').trim();
+}
+
+/**
+ * Format breaking changes section.
+ */
+function formatBreakingChanges(breakingChanges) {
+  if (!breakingChanges || breakingChanges.length === 0) {
+    return '';
+  }
+
+  const lines = ['### 💥 Breaking Changes', ''];
+  for (const bc of breakingChanges) {
+    lines.push(`- **${bc.description}**`);
+    if (bc.scope) {
+      lines.push(`  - Scope: \`${bc.scope}\``);
+    }
+    if (bc.migration_guide) {
+      lines.push(`  - **Migration**: ${bc.migration_guide}`);
+    }
+    if (bc.pr) {
+      lines.push(`  - PR: #${bc.pr}`);
+    }
+  }
+  lines.push('');
+
+  return lines.join('\n').trim();
+}
+
+/**
+ * Format contributors section.
+ */
+function formatContributors(contributors) {
+  if (!contributors || contributors.length === 0) {
+    return '';
+  }
+
+  const lines = ['### 👥 Contributors', ''];
+  lines.push(formatContributorThanks(contributors));
+  lines.push('');
+
+  return lines.join('\n').trim();
+}
+
+/**
+ * Format bullet points for minimal template.
+ */
+function formatBulletPoints(categories) {
+  if (!categories || Object.keys(categories).length === 0) {
+    return '- No changes in this release.';
+  }
+
+  const lines = [];
+  for (const changes of Object.values(categories)) {
+    for (const change of changes) {
+      let line = `- ${change.description}`;
+      if (change.pr) {
+        line += ` (#${change.pr})`;
+      }
+      lines.push(line);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Format the full changelog comparison link.
+ */
+function formatChangelogLink(repoUrl, previousVersion, currentVersion) {
+  if (!previousVersion) {
+    return `${repoUrl}/releases/tag/v${currentVersion}`;
+  }
+  return `${repoUrl}/compare/v${previousVersion}...v${currentVersion}`;
+}
+
+/**
+ * Format screenshots section.
+ */
+function formatScreenshots(screenshots) {
+  if (!screenshots || screenshots.length === 0) {
+    return '';
+  }
+
+  const lines = ['### Screenshots', ''];
+  for (const shot of screenshots) {
+    lines.push(`![${shot.alt || 'Screenshot'}](${shot.url})`);
+  }
+  return lines.join('\n').trim();
+}
+
+/**
+ * Format linked issues section.
+ */
+function formatLinkedIssues(issues, repoUrl) {
+  if (!issues || issues.length === 0) {
+    return '';
+  }
+
+  const lines = ['### Linked Issues', ''];
+  for (const issue of issues) {
+    lines.push(`- [#${issue.number}](${repoUrl}/issues/${issue.number})`);
+  }
+  return lines.join('\n').trim();
+}
+
+/**
+ * Format impact assessment for enterprise template.
+ */
+function formatImpactAssessment(diffSummary) {
+  if (!diffSummary || diffSummary.files_changed === 0) {
+    return 'No significant impact assessment available for this release.';
+  }
+
+  const lines = [];
+  lines.push(`- **Impact Level**: ${diffSummary.impact}`);
+  lines.push(`- **Files Changed**: ${diffSummary.files_changed}`);
+  lines.push(`- **Code Changes**: +${diffSummary.additions} / -${diffSummary.deletions}`);
+
+  if (diffSummary.affected_areas.length > 0) {
+    lines.push(`- **Affected Areas**: ${diffSummary.affected_areas.join(', ')}`);
+  }
+
+  if (diffSummary.potential_breaking.length > 0) {
+    lines.push('');
+    lines.push('**Potential Breaking Changes Detected:**');
+    for (const pb of diffSummary.potential_breaking) {
+      lines.push(`- ${pb.file}: ${pb.reason}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate action items for enterprise template.
+ */
+function generateActionItems(analysis, diffSummary) {
+  const items = [];
+
+  if (analysis && analysis.breaking && analysis.breaking.length > 0) {
+    items.push('- **Required**: Review breaking changes and update configurations accordingly');
+  }
+
+  if (diffSummary && diffSummary.affected_areas) {
+    if (diffSummary.affected_areas.includes('Database')) {
+      items.push('- **Required**: Run database migrations before deploying');
+    }
+    if (diffSummary.affected_areas.includes('Configuration')) {
+      items.push('- **Required**: Review and update configuration files');
+    }
+    if (diffSummary.affected_areas.includes('Authentication')) {
+      items.push('- **Recommended**: Verify authentication flows after deployment');
+    }
+  }
+
+  if (items.length === 0) {
+    items.push('- No specific action items for this release');
+  }
+
+  return items.join('\n');
+}
+
+/**
+ * Clean up any remaining unresolved template variables.
+ * Replaces {{variable_name}} with empty string.
+ */
+function cleanUnresolvedVariables(output) {
+  return output.replace(/\{\{[a-z_]+\}\}/gi, '');
+}
+
+module.exports = {
+  formatReleaseNotes,
+  loadTemplate,
+  generateSummary,
+  formatCategories,
+  formatBreakingChanges,
+  formatContributors,
+  formatBulletPoints,
+  formatChangelogLink,
+  formatScreenshots,
+  formatLinkedIssues,
+  formatImpactAssessment,
+  generateActionItems,
+  cleanUnresolvedVariables,
+};

package/src/formatters/discord.js

@@ -0,0 +1,174 @@
+'use strict';
+
+/**
+ * Discord embed formatter.
+ * Produces Discord webhook-ready JSON with rich embeds,
+ * color coding by change type, and field-based layout.
+ */
+class DiscordFormatter {
+  constructor() {
+    this.name = 'Discord';
+    this.formatName = 'discord';
+  }
+
+  /**
+   * Format release data as Discord webhook JSON string.
+   * @param {Object} data - ReleaseData object
+   * @returns {string} JSON string of Discord webhook payload
+   */
+  format(data) {
+    const embeds = [];
+
+    // Main release embed
+    const mainEmbed = {
+      title: `Release v${data.version}`,
+      url: data.previousVersion
+        ? `${data.repoUrl}/compare/v${data.previousVersion}...v${data.version}`
+        : `${data.repoUrl}/releases/tag/v${data.version}`,
+      color: this._getEmbedColor(data),
+      description: this._truncate(this._escapeDiscord(data.summary || `Release v${data.version}`), 2048),
+      fields: [],
+      footer: {
+        text: `Powered by AI Release Notes`,
+      },
+      timestamp: new Date().toISOString(),
+    };
+
+    // Add version and date fields
+    mainEmbed.fields.push({
+      name: 'Version',
+      value: `v${data.version}`,
+      inline: true,
+    });
+    mainEmbed.fields.push({
+      name: 'Date',
+      value: data.date,
+      inline: true,
+    });
+
+    embeds.push(mainEmbed);
+
+    // Breaking changes embed (red)
+    if (data.breaking && data.breaking.length > 0) {
+      const breakingEmbed = {
+        title: ':rotating_light: Breaking Changes',
+        color: 0xED4245, // Discord red
+        fields: [],
+        timestamp: new Date().toISOString(),
+      };
+
+      for (const bc of data.breaking.slice(0, 5)) {
+        let value = this._escapeDiscord(bc.description);
+        if (bc.scope) value += `\nScope: \`${bc.scope}\``;
+        if (bc.migration_guide) value += `\n**Migration:** ${this._escapeDiscord(bc.migration_guide)}`;
+        breakingEmbed.fields.push({
+          name: this._truncate(bc.scope || 'Breaking Change', 256),
+          value: this._truncate(value, 1024),
+          inline: false,
+        });
+      }
+
+      embeds.push(breakingEmbed);
+    }
+
+    // Category embeds with color coding
+    if (data.categories) {
+      const categoryEntries = Object.entries(data.categories);
+      // Discord allows max 10 embeds total
+      const maxCategoryEmbeds = Math.min(categoryEntries.length, 10 - embeds.length);
+
+      for (let i = 0; i < maxCategoryEmbeds; i++) {
+        const [category, changes] = categoryEntries[i];
+        const color = this._getCategoryColor(category);
+
+        const fieldList = changes.slice(0, 10).map(change => {
+          let line = `  - ${this._escapeDiscord(change.description)}`;
+          if (change.pr) line += ` [#${change.pr}](${data.repoUrl}/pull/${change.pr})`;
+          if (change.author) line += ` by @${change.author}`;
+          return line;
+        }).join('\n');
+
+        embeds.push({
+          title: category,
+          color: color,
+          description: this._truncate(fieldList, 2048),
+          timestamp: new Date().toISOString(),
+        });
+      }
+    }
+
+    // Contributors embed
+    if (data.contributors && data.contributors.length > 0) {
+      const names = data.contributors.slice(0, 10).map(c => {
+        const badge = c.is_first_time ? ' :star:' : '';
+        return `\`@${c.login}\` (${c.commits_count})${badge}`;
+      }).join(', ');
+      const more = data.contributors.length > 10 ? `\n...and ${data.contributors.length - 10} more` : '';
+
+      embeds.push({
+        title: ':busts_in_silhouette: Contributors',
+        color: 0x5865F2, // Discord blurple
+        description: this._truncate(names + more, 2048),
+        timestamp: new Date().toISOString(),
+      });
+    }
+
+    return JSON.stringify({
+      username: 'Release Notes',
+      embeds: embeds.slice(0, 10), // Discord hard limit
+    }, null, 2);
+  }
+
+  /**
+   * Get the main embed color based on release content.
+   * @param {Object} data
+   * @returns {number}
+   */
+  _getEmbedColor(data) {
+    if (data.breaking && data.breaking.length > 0) return 0xED4245; // Red
+    const cats = Object.keys(data.categories || {});
+    if (cats.some(c => c.toLowerCase().includes('feature'))) return 0x57F287; // Green
+    if (cats.some(c => c.toLowerCase().includes('fix'))) return 0x3498DB; // Blue
+    return 0x5865F2; // Blurple
+  }
+
+  /**
+   * Get color for a category type.
+   * @param {string} category
+   * @returns {number}
+   */
+  _getCategoryColor(category) {
+    const lower = category.toLowerCase();
+    if (lower.includes('feature') || lower.includes('rocket')) return 0x57F287;
+    if (lower.includes('fix') || lower.includes('bug')) return 0x3498DB;
+    if (lower.includes('breaking')) return 0xED4245;
+    if (lower.includes('perf')) return 0xFEE75C;
+    if (lower.includes('doc')) return 0xEB459E;
+    if (lower.includes('security') || lower.includes('lock')) return 0xED4245;
+    if (lower.includes('test')) return 0x99AAB5;
+    return 0x5865F2;
+  }
+
+  /**
+   * Escape Discord markdown special characters.
+   * @param {string} str
+   * @returns {string}
+   */
+  _escapeDiscord(str) {
+    if (!str) return '';
+    return String(str);
+  }
+
+  /**
+   * Truncate a string to a maximum length.
+   * @param {string} str
+   * @param {number} max
+   * @returns {string}
+   */
+  _truncate(str, max) {
+    if (!str) return '';
+    return str.length > max ? str.substring(0, max - 3) + '...' : str;
+  }
+}
+
+module.exports = { DiscordFormatter };

package/src/formatters/html.js

@@ -0,0 +1,195 @@
+'use strict';
+
+/**
+ * HTML formatter.
+ * Produces beautiful HTML with inline CSS, color-coded sections,
+ * and responsive design. Email/client ready.
+ */
+class HTMLFormatter {
+  constructor() {
+    this.name = 'HTML';
+    this.formatName = 'html';
+  }
+
+  /**
+   * Format release data as HTML with inline CSS.
+   * @param {Object} data - ReleaseData object
+   * @returns {string} HTML string
+   */
+  format(data) {
+    const sections = [];
+
+    sections.push('<!DOCTYPE html>');
+    sections.push('<html lang="en">');
+    sections.push('<head>');
+    sections.push('<meta charset="UTF-8">');
+    sections.push('<meta name="viewport" content="width=device-width, initial-scale=1.0">');
+    sections.push(`<title>Release v${data.version}</title>`);
+    sections.push('<style>');
+    sections.push(this._getCSS());
+    sections.push('</style>');
+    sections.push('</head>');
+    sections.push('<body>');
+    sections.push('<div class="container">');
+
+    // Header
+    sections.push(`<h1 class="header">Release v${data.version}</h1>`);
+    sections.push(`<p class="date">${data.date}</p>`);
+    sections.push(`<p class="summary">${this._escapeHtml(data.summary || `Release v${data.version}`)}</p>`);
+
+    // Breaking changes
+    if (data.breaking && data.breaking.length > 0) {
+      sections.push('<div class="section breaking">');
+      sections.push('<h2 class="section-title breaking-title">Breaking Changes</h2>');
+      for (const bc of data.breaking) {
+        sections.push('<div class="item">');
+        sections.push(`<strong>${this._escapeHtml(bc.description)}</strong>`);
+        if (bc.scope) {
+          sections.push(`<span class="badge scope">Scope: ${this._escapeHtml(bc.scope)}</span>`);
+        }
+        if (bc.migration_guide) {
+          sections.push(`<p class="migration"><strong>Migration:</strong> ${this._escapeHtml(bc.migration_guide)}</p>`);
+        }
+        if (bc.pr) {
+          sections.push(`<a href="${data.repoUrl}/pull/${bc.pr}" class="link">PR #${bc.pr}</a>`);
+        }
+        sections.push('</div>');
+      }
+      sections.push('</div>');
+    }
+
+    // Categorized changes
+    if (data.categories) {
+      for (const [category, changes] of Object.entries(data.categories)) {
+        const cssClass = this._getCategoryClass(category);
+        sections.push(`<div class="section ${cssClass}">`);
+        sections.push(`<h2 class="section-title ${cssClass}-title">${this._escapeHtml(category)}</h2>`);
+        sections.push('<ul>');
+        for (const change of changes) {
+          let li = this._escapeHtml(change.description);
+          if (change.scope) {
+            li += ` <code class="scope-code">${this._escapeHtml(change.scope)}</code>`;
+          }
+          if (change.pr) {
+            li += ` <a href="${data.repoUrl}/pull/${change.pr}" class="link">#${change.pr}</a>`;
+          }
+          if (change.author) {
+            li += ` <span class="author">by @${this._escapeHtml(change.author)}</span>`;
+          }
+          sections.push(`<li>${li}</li>`);
+        }
+        sections.push('</ul>');
+        sections.push('</div>');
+      }
+    }
+
+    // Contributors
+    if (data.contributors && data.contributors.length > 0) {
+      sections.push('<div class="section contributors">');
+      sections.push('<h2 class="section-title contributors-title">Contributors</h2>');
+      sections.push('<div class="contributor-list">');
+      for (const c of data.contributors) {
+        const firstTimer = c.is_first_time ? ' <span class="first-timer">FIRST TIME</span>' : '';
+        sections.push(
+          `<span class="contributor">@${this._escapeHtml(c.login)} (${c.commits_count})${firstTimer}</span>`
+        );
+      }
+      sections.push('</div>');
+      sections.push('</div>');
+    }
+
+    // Footer
+    sections.push('<div class="footer">');
+    if (data.previousVersion) {
+      sections.push(`<a href="${data.repoUrl}/compare/v${data.previousVersion}...v${data.version}" class="changelog-link">Full Changelog</a>`);
+    }
+    sections.push(`<span>Generated on ${data.date}</span>`);
+    sections.push('</div>');
+
+    sections.push('</div>');
+    sections.push('</body>');
+    sections.push('</html>');
+
+    return sections.join('\n');
+  }
+
+  /**
+   * Get inline CSS styles.
+   * @returns {string}
+   */
+  _getCSS() {
+    return `
+      * { box-sizing: border-box; margin: 0; padding: 0; }
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, sans-serif; background: #f6f8fa; color: #24292f; line-height: 1.6; padding: 20px; }
+      .container { max-width: 800px; margin: 0 auto; background: #fff; border-radius: 12px; box-shadow: 0 1px 3px rgba(0,0,0,0.12); padding: 32px; }
+      .header { font-size: 28px; font-weight: 700; color: #24292f; border-bottom: 2px solid #e1e4e8; padding-bottom: 12px; margin-bottom: 8px; }
+      .date { color: #656d76; font-size: 14px; margin-bottom: 12px; }
+      .summary { font-size: 16px; color: #24292f; margin-bottom: 24px; padding: 12px; background: #f6f8fa; border-radius: 6px; border-left: 4px solid #0969da; }
+      .section { margin-bottom: 24px; border-radius: 8px; padding: 16px; }
+      .section-title { font-size: 18px; font-weight: 600; margin-bottom: 12px; padding-bottom: 8px; }
+      .features { background: #f0fff4; border: 1px solid #2da44e; }
+      .features-title { color: #1a7f37; border-bottom: 1px solid #2da44e33; }
+      .fixes { background: #ddf4ff; border: 1px solid #0969da; }
+      .fixes-title { color: #0550ae; border-bottom: 1px solid #0969da33; }
+      .breaking { background: #ffebe9; border: 1px solid #cf222e; }
+      .breaking-title { color: #a40e26; border-bottom: 1px solid #cf222e33; }
+      .other { background: #f6f8fa; border: 1px solid #d0d7de; }
+      .other-title { color: #656d76; border-bottom: 1px solid #d0d7de; }
+      .performance { background: #fff8c5; border: 1px solid #bf8700; }
+      .performance-title { color: #9a6700; border-bottom: 1px solid #bf870033; }
+      .section ul { list-style: none; padding-left: 0; }
+      .section li { padding: 4px 0; padding-left: 20px; position: relative; }
+      .section li::before { content: ''; position: absolute; left: 0; top: 12px; width: 8px; height: 8px; border-radius: 50%; }
+      .features li::before { background: #2da44e; }
+      .fixes li::before { background: #0969da; }
+      .breaking li::before { background: #cf222e; }
+      .item { padding: 8px 12px; margin-bottom: 8px; background: #fff; border-radius: 6px; border: 1px solid #cf222e33; }
+      .migration { margin-top: 6px; font-size: 14px; color: #656d76; }
+      .badge { display: inline-block; padding: 2px 8px; border-radius: 12px; font-size: 12px; margin-left: 8px; }
+      .scope { background: #e1e4e8; color: #656d76; }
+      .scope-code { background: #e1e4e8; padding: 1px 6px; border-radius: 4px; font-size: 13px; }
+      .link { color: #0969da; text-decoration: none; }
+      .link:hover { text-decoration: underline; }
+      .author { color: #656d76; font-size: 14px; }
+      .contributors { background: #fafbfc; border: 1px solid #d0d7de; }
+      .contributors-title { color: #24292f; border-bottom: 1px solid #d0d7de; }
+      .contributor-list { display: flex; flex-wrap: wrap; gap: 8px; }
+      .contributor { display: inline-block; padding: 4px 12px; background: #f6f8fa; border-radius: 16px; font-size: 14px; border: 1px solid #d0d7de; }
+      .first-timer { background: #ffd33d; color: #24292f; padding: 1px 6px; border-radius: 8px; font-size: 11px; font-weight: 600; margin-left: 4px; }
+      .footer { text-align: center; padding-top: 16px; border-top: 1px solid #e1e4e8; color: #656d76; font-size: 13px; display: flex; justify-content: space-between; align-items: center; }
+      .changelog-link { color: #0969da; text-decoration: none; font-weight: 500; }
+      @media (max-width: 600px) { .container { padding: 16px; } .header { font-size: 22px; } }
+    `.replace(/\n\s+/g, ' ').trim();
+  }
+
+  /**
+   * Get a CSS class name for a category.
+   * @param {string} category
+   * @returns {string}
+   */
+  _getCategoryClass(category) {
+    const lower = category.toLowerCase();
+    if (lower.includes('feature') || lower.includes('rocket')) return 'features';
+    if (lower.includes('fix') || lower.includes('bug')) return 'fixes';
+    if (lower.includes('breaking')) return 'breaking';
+    if (lower.includes('perf') || lower.includes('performance') || lower.includes('speed')) return 'performance';
+    return 'other';
+  }
+
+  /**
+   * Escape HTML special characters.
+   * @param {string} str
+   * @returns {string}
+   */
+  _escapeHtml(str) {
+    if (!str) return '';
+    return String(str)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#039;');
+  }
+}
+
+module.exports = { HTMLFormatter };