lean-claudient-core 0.1.0

package/src/reporting/reportGenerator.ts

@@ -0,0 +1,802 @@
+/**
+ * Report Generator
+ * Multi-format report generation (PDF, HTML, CSV) for business analytics
+ * Phase 8C Task 12
+ */
+
+import { existsSync, writeFileSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import {
+  formatCurrency,
+  formatDate,
+  formatPercentage,
+  getTrendIndicator,
+  htmlToCSV,
+  HTMLTemplateData,
+} from './templates.js';
+
+export interface DateRange {
+  start: Date;
+  end: Date;
+}
+
+export interface ReportMetadata {
+  id: string;
+  type: 'executive-summary' | 'detailed-analysis';
+  generatedAt: string;
+  dateRange: DateRange;
+  dataFreshness: string;
+  version: string;
+}
+
+export interface LeadData {
+  id: string;
+  name: string;
+  company: string;
+  email: string;
+  score: number;
+  stage: string;
+  projectedRevenue: number;
+  signalCount: number;
+  threatLevel: string;
+  source: string;
+  createdAt: string;
+}
+
+export interface SignalData {
+  id: string;
+  leadId: string;
+  type: string;
+  strength: number;
+  source: string;
+  description: string;
+  createdAt: string;
+}
+
+export interface ConversionData {
+  id: string;
+  leadId: string;
+  leadName: string;
+  company: string;
+  conversionDate: string;
+  revenue: number;
+  source: string;
+}
+
+export interface AlertData {
+  id: string;
+  type: string;
+  severity: string;
+  message: string;
+  queuedAt: string;
+  resolved?: boolean;
+}
+
+export interface ReportGeneratorConfig {
+  outputDir?: string;
+  companyName?: string;
+  brandColor?: string;
+  logoUrl?: string;
+  emailNotification?: boolean;
+  notificationEmail?: string;
+}
+
+export class ReportGenerator {
+  private config: ReportGeneratorConfig;
+  private outputDir: string;
+  private scheduledReports: Map<string, any> = new Map();
+
+  constructor(config: ReportGeneratorConfig = {}) {
+    this.config = {
+      outputDir: './.reports',
+      companyName: 'Lean Claudient',
+      brandColor: '#4F46E5',
+      ...config,
+    };
+    this.outputDir = this.config.outputDir!;
+    this.ensureOutputDir();
+  }
+
+  private ensureOutputDir(): void {
+    if (!existsSync(this.outputDir)) {
+      const fs = require('fs');
+      fs.mkdirSync(this.outputDir, { recursive: true });
+    }
+  }
+
+  /**
+   * Generate executive summary report
+   */
+  generateExecutiveSummary(
+    dateRange: DateRange,
+    metrics: any,
+    leads: LeadData[],
+    alerts: AlertData[]
+  ): Buffer {
+    const metadata = this.createMetadata('executive-summary', dateRange);
+    const qualifiedLeads = leads.filter(l => l.score >= 70);
+    const totalRevenue = leads.reduce((sum, l) => sum + l.projectedRevenue, 0);
+    const weekOverWeekChange = this.calculateWeekOverWeekChange(metrics);
+
+    const templateData: HTMLTemplateData = {
+      title: 'Executive Summary',
+      dateRange,
+      metadata,
+      companyName: this.config.companyName!,
+      brandColor: this.config.brandColor!,
+      kpis: {
+        totalLeads: leads.length,
+        qualifiedLeads: qualifiedLeads.length,
+        projectedRevenue: totalRevenue,
+        activeThreats: alerts.filter(a => a.severity === 'critical').length,
+      },
+      trends: {
+        leadsWeekOverWeek: weekOverWeekChange.leads,
+        revenueWeekOverWeek: weekOverWeekChange.revenue,
+        threatWeekOverWeek: weekOverWeekChange.threats,
+      },
+      topLeads: leads
+        .sort((a, b) => b.projectedRevenue - a.projectedRevenue)
+        .slice(0, 3)
+        .map(l => ({
+          name: l.name,
+          company: l.company,
+          revenue: formatCurrency(l.projectedRevenue),
+          score: Math.round(l.score),
+        })),
+      recommendations: this.generateRecommendations(metrics, leads, alerts),
+    };
+
+    return this.renderExecutiveSummaryHTML(templateData);
+  }
+
+  /**
+   * Generate detailed analysis report
+   */
+  generateDetailedAnalysis(
+    dateRange: DateRange,
+    metrics: any,
+    leads: LeadData[],
+    signals: SignalData[],
+    conversions: ConversionData[],
+    alerts: AlertData[]
+  ): Buffer {
+    const metadata = this.createMetadata('detailed-analysis', dateRange);
+
+    const funnelData = this.calculateFunnelMetrics(leads);
+    const revenueBySource = this.groupRevenueBySource(leads);
+    const threatBreakdown = this.calculateThreatBreakdown(leads);
+    const signalEffectiveness = this.calculateSignalEffectiveness(signals, conversions);
+    const marketTrends = this.extractMarketTrends(signals);
+
+    const templateData: HTMLTemplateData = {
+      title: 'Detailed Analysis Report',
+      dateRange,
+      metadata,
+      companyName: this.config.companyName!,
+      brandColor: this.config.brandColor!,
+      funnelData,
+      revenueBySource,
+      threatBreakdown,
+      topLeads: leads
+        .sort((a, b) => b.projectedRevenue - a.projectedRevenue)
+        .slice(0, 5)
+        .map(l => ({
+          name: l.name,
+          company: l.company,
+          score: Math.round(l.score),
+          revenue: formatCurrency(l.projectedRevenue),
+          signals: l.signalCount,
+          threatLevel: l.threatLevel,
+          stage: l.stage,
+        })),
+      signalEffectiveness,
+      marketTrends,
+      alerts: alerts.slice(0, 10),
+      recommendations: this.generateDetailedRecommendations(metrics, leads, alerts, marketTrends),
+    };
+
+    return this.renderDetailedAnalysisHTML(templateData);
+  }
+
+  /**
+   * Export all leads to CSV
+   */
+  exportLeadsData(leads: LeadData[]): Buffer {
+    const headers = [
+      'ID',
+      'Name',
+      'Company',
+      'Email',
+      'Score',
+      'Stage',
+      'Projected Revenue',
+      'Signal Count',
+      'Threat Level',
+      'Source',
+      'Created Date',
+    ];
+
+    const rows = leads.map(lead => [
+      lead.id,
+      lead.name,
+      lead.company,
+      lead.email,
+      lead.score.toFixed(1),
+      lead.stage,
+      formatCurrency(lead.projectedRevenue).replace('$', '').replace(',', ''),
+      lead.signalCount.toString(),
+      lead.threatLevel,
+      lead.source,
+      formatDate(new Date(lead.createdAt)),
+    ]);
+
+    return this.createCSV(headers, rows);
+  }
+
+  /**
+   * Export all signals to CSV
+   */
+  exportSignalsData(signals: SignalData[]): Buffer {
+    const headers = ['ID', 'Lead ID', 'Type', 'Strength', 'Source', 'Description', 'Created Date'];
+
+    const rows = signals.map(signal => [
+      signal.id,
+      signal.leadId,
+      signal.type,
+      formatPercentage(signal.strength),
+      signal.source,
+      signal.description,
+      formatDate(new Date(signal.createdAt)),
+    ]);
+
+    return this.createCSV(headers, rows);
+  }
+
+  /**
+   * Export all conversions to CSV
+   */
+  exportConversionsData(conversions: ConversionData[]): Buffer {
+    const headers = ['ID', 'Lead ID', 'Name', 'Company', 'Conversion Date', 'Revenue', 'Source'];
+
+    const rows = conversions.map(conv => [
+      conv.id,
+      conv.leadId,
+      conv.leadName,
+      conv.company,
+      formatDate(new Date(conv.conversionDate)),
+      formatCurrency(conv.revenue).replace('$', '').replace(',', ''),
+      conv.source,
+    ]);
+
+    return this.createCSV(headers, rows);
+  }
+
+  /**
+   * Get list of scheduled reports
+   */
+  getScheduledReports(): any[] {
+    return Array.from(this.scheduledReports.values());
+  }
+
+  /**
+   * Trigger report generation
+   */
+  triggerReport(
+    type: 'executive-summary' | 'detailed-analysis',
+    dateRange: DateRange,
+    metrics: any,
+    leads: LeadData[],
+    signals?: SignalData[],
+    conversions?: ConversionData[],
+    alerts?: AlertData[]
+  ): string {
+    let report: Buffer;
+    const filename = `${type}_${new Date().toISOString().split('T')[0]}_${uuidv4().slice(0, 8)}.html`;
+
+    if (type === 'executive-summary') {
+      report = this.generateExecutiveSummary(dateRange, metrics, leads, alerts || []);
+    } else {
+      report = this.generateDetailedAnalysis(
+        dateRange,
+        metrics,
+        leads,
+        signals || [],
+        conversions || [],
+        alerts || []
+      );
+    }
+
+    const filepath = resolve(this.outputDir, filename);
+    writeFileSync(filepath, report);
+
+    return filepath;
+  }
+
+  /**
+   * Schedule recurring report
+   */
+  scheduleReport(
+    type: 'executive-summary' | 'detailed-analysis',
+    frequency: 'weekly' | 'monthly',
+    dayOfWeek?: number,
+    dayOfMonth?: number
+  ): string {
+    const reportId = uuidv4();
+    this.scheduledReports.set(reportId, {
+      id: reportId,
+      type,
+      frequency,
+      dayOfWeek,
+      dayOfMonth,
+      createdAt: new Date().toISOString(),
+      nextRun: this.calculateNextRun(frequency, dayOfWeek, dayOfMonth),
+    });
+
+    return reportId;
+  }
+
+  // Private helpers
+
+  private createMetadata(type: string, dateRange: DateRange): ReportMetadata {
+    return {
+      id: uuidv4(),
+      type: type as any,
+      generatedAt: new Date().toISOString(),
+      dateRange,
+      dataFreshness: `as of ${new Date().toLocaleTimeString()} on ${new Date().toLocaleDateString()}`,
+      version: '1.0.0',
+    };
+  }
+
+  private calculateWeekOverWeekChange(metrics: any): Record<string, number> {
+    return {
+      leads: (metrics?.leadsThisWeek || 0) - (metrics?.leadsLastWeek || 0),
+      revenue: (metrics?.revenueThisWeek || 0) - (metrics?.revenueLastWeek || 0),
+      threats: (metrics?.threatsThisWeek || 0) - (metrics?.threatsLastWeek || 0),
+    };
+  }
+
+  private generateRecommendations(metrics: any, leads: LeadData[], alerts: AlertData[]): string[] {
+    const recommendations: string[] = [];
+
+    // Top 3 recommendations based on data
+    if (leads.filter(l => l.score >= 70).length > 10) {
+      recommendations.push(
+        'High volume of qualified leads detected - consider expanding sales team or adjusting qualification criteria'
+      );
+    }
+
+    if (alerts.filter(a => a.severity === 'critical').length > 0) {
+      recommendations.push('Critical threats detected - prioritize competitive response strategy');
+    }
+
+    const lowSignalLeads = leads.filter(l => l.signalCount < 2);
+    if (lowSignalLeads.length > leads.length * 0.3) {
+      recommendations.push('Many leads have low signal count - enhance market research and enrichment process');
+    }
+
+    return recommendations.slice(0, 3);
+  }
+
+  private generateDetailedRecommendations(
+    metrics: any,
+    leads: LeadData[],
+    alerts: AlertData[],
+    trends: any
+  ): string[] {
+    const recommendations = this.generateRecommendations(metrics, leads, alerts);
+    // Additional detailed recommendations
+    if (trends?.length > 0) {
+      recommendations.push(`Capitalize on trending: ${trends[0].trend || 'emerging market opportunity'}`);
+    }
+    return recommendations.slice(0, 5);
+  }
+
+  private calculateFunnelMetrics(leads: LeadData[]): any {
+    const stages = ['cold', 'warm', 'hot', 'sales-ready'];
+    const funnel = {
+      cold: leads.filter(l => l.stage === 'cold').length,
+      warm: leads.filter(l => l.stage === 'warm').length,
+      hot: leads.filter(l => l.stage === 'hot').length,
+      'sales-ready': leads.filter(l => l.stage === 'sales-ready').length,
+    };
+
+    return {
+      ...funnel,
+      coldToWarmRate:
+        funnel.warm > 0 ? ((funnel.warm / (funnel.cold + funnel.warm)) * 100).toFixed(1) : '0.0',
+      warmToHotRate:
+        funnel.hot > 0 ? ((funnel.hot / (funnel.warm + funnel.hot)) * 100).toFixed(1) : '0.0',
+      hotToSalesReadyRate:
+        funnel['sales-ready'] > 0
+          ? ((funnel['sales-ready'] / (funnel.hot + funnel['sales-ready'])) * 100).toFixed(1)
+          : '0.0',
+    };
+  }
+
+  private groupRevenueBySource(leads: LeadData[]): Record<string, any> {
+    const sources = new Map<string, { count: number; revenue: number }>();
+
+    leads.forEach(lead => {
+      const current = sources.get(lead.source) || { count: 0, revenue: 0 };
+      current.count++;
+      current.revenue += lead.projectedRevenue;
+      sources.set(lead.source, current);
+    });
+
+    const result: Record<string, any> = {};
+    sources.forEach((data, source) => {
+      result[source] = {
+        count: data.count,
+        revenue: formatCurrency(data.revenue),
+        avgRevenue: formatCurrency(data.revenue / data.count),
+      };
+    });
+
+    return result;
+  }
+
+  private calculateThreatBreakdown(leads: LeadData[]): Record<string, number> {
+    return {
+      CRITICAL: leads.filter(l => l.threatLevel === 'CRITICAL').length,
+      HIGH: leads.filter(l => l.threatLevel === 'HIGH').length,
+      MEDIUM: leads.filter(l => l.threatLevel === 'MEDIUM').length,
+      LOW: leads.filter(l => l.threatLevel === 'LOW').length,
+      NONE: leads.filter(l => l.threatLevel === 'NONE').length,
+    };
+  }
+
+  private calculateSignalEffectiveness(signals: SignalData[], conversions: ConversionData[]): any {
+    const signalTypes = new Map<string, { count: number; conversionCount: number }>();
+
+    signals.forEach(signal => {
+      const current = signalTypes.get(signal.type) || { count: 0, conversionCount: 0 };
+      current.count++;
+      signalTypes.set(signal.type, current);
+    });
+
+    conversions.forEach(conv => {
+      const signal = signals.find(s => s.leadId === conv.leadId);
+      if (signal) {
+        const current = signalTypes.get(signal.type);
+        if (current) {
+          current.conversionCount++;
+        }
+      }
+    });
+
+    const result: Record<string, any> = {};
+    signalTypes.forEach((data, type) => {
+      result[type] = {
+        total: data.count,
+        conversions: data.conversionCount,
+        effectiveness: data.count > 0 ? ((data.conversionCount / data.count) * 100).toFixed(1) : '0.0',
+      };
+    });
+
+    return result;
+  }
+
+  private extractMarketTrends(signals: SignalData[]): any[] {
+    const trends = new Map<string, number>();
+    signals.forEach(signal => {
+      const count = (trends.get(signal.description) || 0) + 1;
+      trends.set(signal.description, count);
+    });
+
+    return Array.from(trends.entries())
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 5)
+      .map(([trend, count]) => ({ trend, frequency: count }));
+  }
+
+  private calculateNextRun(frequency: string, dayOfWeek?: number, dayOfMonth?: number): Date {
+    const now = new Date();
+    if (frequency === 'weekly') {
+      const nextRun = new Date(now);
+      nextRun.setDate(nextRun.getDate() + ((dayOfWeek || 1) - nextRun.getDay() + 7) % 7);
+      nextRun.setHours(9, 0, 0, 0);
+      return nextRun;
+    } else {
+      const nextRun = new Date(now);
+      nextRun.setMonth(nextRun.getMonth() + 1);
+      nextRun.setDate(dayOfMonth || 1);
+      nextRun.setHours(9, 0, 0, 0);
+      return nextRun;
+    }
+  }
+
+  private renderExecutiveSummaryHTML(data: HTMLTemplateData): Buffer {
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${data.title}</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; line-height: 1.6; color: #333; }
+    .page { page-break-after: always; padding: 40px; max-width: 8.5in; margin: 0 auto; }
+    .header { border-bottom: 3px solid ${data.brandColor}; padding-bottom: 20px; margin-bottom: 30px; }
+    .title { font-size: 28px; font-weight: bold; color: ${data.brandColor}; }
+    .subtitle { font-size: 14px; color: #666; }
+    .kpi-section { margin: 30px 0; }
+    .kpi-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin: 20px 0; }
+    .kpi-card { background: #f5f5f5; padding: 15px; border-radius: 8px; border-left: 4px solid ${data.brandColor}; }
+    .kpi-value { font-size: 24px; font-weight: bold; color: ${data.brandColor}; }
+    .kpi-label { font-size: 12px; color: #666; margin-top: 5px; }
+    .trend { font-size: 14px; margin-top: 5px; }
+    .trend.up { color: #059669; }
+    .trend.down { color: #dc2626; }
+    .recommendations { background: #fffbeb; padding: 15px; border-radius: 8px; margin: 20px 0; }
+    .recommendations h3 { margin-top: 0; color: #d97706; }
+    .recommendations li { margin: 10px 0; }
+    .footer { margin-top: 40px; padding-top: 20px; border-top: 1px solid #ddd; font-size: 12px; color: #666; }
+    @media print { body { margin: 0; padding: 0; } .page { padding: 20px; } }
+  </style>
+</head>
+<body>
+  <div class="page">
+    <div class="header">
+      <div class="title">${data.title}</div>
+      <div class="subtitle">
+        ${formatDate(data.dateRange.start)} – ${formatDate(data.dateRange.end)}
+      </div>
+    </div>
+
+    <div class="kpi-section">
+      <h2>Key Performance Indicators</h2>
+      <div class="kpi-grid">
+        <div class="kpi-card">
+          <div class="kpi-value">${data.kpis.totalLeads}</div>
+          <div class="kpi-label">Total Leads Identified</div>
+          <div class="trend ${data.trends.leadsWeekOverWeek >= 0 ? 'up' : 'down'}">
+            ${getTrendIndicator(data.trends.leadsWeekOverWeek)} ${Math.abs(data.trends.leadsWeekOverWeek)} vs last week
+          </div>
+        </div>
+        <div class="kpi-card">
+          <div class="kpi-value">${data.kpis.qualifiedLeads}</div>
+          <div class="kpi-label">Qualified Leads</div>
+          <div class="trend">${formatPercentage((data.kpis.qualifiedLeads / data.kpis.totalLeads) * 100)}</div>
+        </div>
+        <div class="kpi-card">
+          <div class="kpi-value">${formatCurrency(data.kpis.projectedRevenue)}</div>
+          <div class="kpi-label">Projected Revenue</div>
+          <div class="trend ${data.trends.revenueWeekOverWeek >= 0 ? 'up' : 'down'}">
+            ${getTrendIndicator(data.trends.revenueWeekOverWeek)} ${formatCurrency(Math.abs(data.trends.revenueWeekOverWeek))}
+          </div>
+        </div>
+        <div class="kpi-card">
+          <div class="kpi-value">${data.kpis.activeThreats}</div>
+          <div class="kpi-label">Critical Threats</div>
+          <div class="trend">Require immediate response</div>
+        </div>
+      </div>
+    </div>
+
+    <div class="kpi-section">
+      <h2>Top 3 Leads</h2>
+      ${data.topLeads
+        ?.map(
+          lead => `
+        <div style="padding: 10px 0; border-bottom: 1px solid #eee;">
+          <div style="font-weight: bold;">${lead.name} (${lead.company})</div>
+          <div style="color: #666; font-size: 14px;">
+            Quality: ${lead.score}% | Revenue: ${lead.revenue}
+          </div>
+        </div>
+      `
+        )
+        .join('') || ''}
+    </div>
+
+    <div class="recommendations">
+      <h3>Top 3 Recommendations</h3>
+      <ol>
+        ${data.recommendations?.map(rec => `<li>${rec}</li>`).join('') || ''}
+      </ol>
+    </div>
+
+    <div class="footer">
+      <strong>Report ID:</strong> ${data.metadata.id}<br>
+      <strong>Generated:</strong> ${data.metadata.dataFreshness}<br>
+      <strong>Version:</strong> ${data.metadata.version}
+    </div>
+  </div>
+</body>
+</html>
+    `;
+    return Buffer.from(html, 'utf-8');
+  }
+
+  private renderDetailedAnalysisHTML(data: HTMLTemplateData): Buffer {
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${data.title}</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; line-height: 1.6; color: #333; }
+    .page { page-break-after: always; padding: 40px; max-width: 8.5in; margin: 0 auto; }
+    .header { border-bottom: 3px solid ${data.brandColor}; padding-bottom: 20px; margin-bottom: 30px; }
+    .title { font-size: 28px; font-weight: bold; color: ${data.brandColor}; }
+    .subtitle { font-size: 14px; color: #666; }
+    section { margin: 30px 0; page-break-inside: avoid; }
+    h2 { color: ${data.brandColor}; border-bottom: 2px solid #eee; padding-bottom: 10px; }
+    table { width: 100%; border-collapse: collapse; margin: 15px 0; }
+    th { background: #f5f5f5; padding: 10px; text-align: left; font-weight: bold; }
+    td { padding: 10px; border-bottom: 1px solid #eee; }
+    .footer { margin-top: 40px; padding-top: 20px; border-top: 1px solid #ddd; font-size: 12px; color: #666; }
+    @media print { body { margin: 0; padding: 0; } .page { padding: 20px; } }
+  </style>
+</head>
+<body>
+  <div class="page">
+    <div class="header">
+      <div class="title">${data.title}</div>
+      <div class="subtitle">
+        ${formatDate(data.dateRange.start)} – ${formatDate(data.dateRange.end)}
+      </div>
+    </div>
+
+    <section>
+      <h2>Lead Funnel</h2>
+      <table>
+        <tr>
+          <th>Stage</th>
+          <th>Count</th>
+          <th>Conversion Rate</th>
+        </tr>
+        ${
+          data.funnelData
+            ? `
+          <tr><td>Cold</td><td>${data.funnelData.cold}</td><td>${data.funnelData.coldToWarmRate}%</td></tr>
+          <tr><td>Warm</td><td>${data.funnelData.warm}</td><td>${data.funnelData.warmToHotRate}%</td></tr>
+          <tr><td>Hot</td><td>${data.funnelData.hot}</td><td>${data.funnelData.hotToSalesReadyRate}%</td></tr>
+          <tr><td>Sales Ready</td><td>${data.funnelData['sales-ready']}</td><td>-</td></tr>
+        `
+            : ''
+        }
+      </table>
+    </section>
+
+    <section>
+      <h2>Revenue by Source</h2>
+      <table>
+        <tr>
+          <th>Source</th>
+          <th>Lead Count</th>
+          <th>Total Revenue</th>
+          <th>Avg Revenue/Lead</th>
+        </tr>
+        ${
+          data.revenueBySource
+            ? Object.entries(data.revenueBySource)
+                .map(
+                  ([source, data]: any) => `
+          <tr>
+            <td>${source}</td>
+            <td>${data.count}</td>
+            <td>${data.revenue}</td>
+            <td>${data.avgRevenue}</td>
+          </tr>
+        `
+                )
+                .join('')
+            : ''
+        }
+      </table>
+    </section>
+
+    <section>
+      <h2>Top 5 High-Value Leads</h2>
+      <table>
+        <tr>
+          <th>Name</th>
+          <th>Company</th>
+          <th>Quality Score</th>
+          <th>Projected Revenue</th>
+          <th>Signals</th>
+          <th>Threat Level</th>
+        </tr>
+        ${
+          data.topLeads
+            ?.map(
+              lead => `
+          <tr>
+            <td>${lead.name}</td>
+            <td>${lead.company}</td>
+            <td>${lead.score}%</td>
+            <td>${lead.revenue}</td>
+            <td>${lead.signals}</td>
+            <td>${lead.threatLevel}</td>
+          </tr>
+        `
+            )
+            .join('') || ''
+        }
+      </table>
+    </section>
+
+    <section>
+      <h2>Signal Effectiveness</h2>
+      <table>
+        <tr>
+          <th>Signal Type</th>
+          <th>Total Signals</th>
+          <th>Conversions</th>
+          <th>Effectiveness Rate</th>
+        </tr>
+        ${
+          data.signalEffectiveness
+            ? Object.entries(data.signalEffectiveness)
+                .map(
+                  ([type, data]: any) => `
+          <tr>
+            <td>${type}</td>
+            <td>${data.total}</td>
+            <td>${data.conversions}</td>
+            <td>${data.effectiveness}%</td>
+          </tr>
+        `
+                )
+                .join('')
+            : ''
+        }
+      </table>
+    </section>
+
+    <section>
+      <h2>Market Trends</h2>
+      <table>
+        <tr>
+          <th>Trend</th>
+          <th>Frequency</th>
+        </tr>
+        ${
+          data.marketTrends
+            ?.map(
+              trend => `
+          <tr>
+            <td>${trend.trend}</td>
+            <td>${trend.frequency} mentions</td>
+          </tr>
+        `
+            )
+            .join('') || ''
+        }
+      </table>
+    </section>
+
+    <section>
+      <h2>Recommendations</h2>
+      <ol>
+        ${data.recommendations?.map(rec => `<li>${rec}</li>`).join('') || ''}
+      </ol>
+    </section>
+
+    <div class="footer">
+      <strong>Report ID:</strong> ${data.metadata.id}<br>
+      <strong>Generated:</strong> ${data.metadata.dataFreshness}<br>
+      <strong>Version:</strong> ${data.metadata.version}
+    </div>
+  </div>
+</body>
+</html>
+    `;
+    return Buffer.from(html, 'utf-8');
+  }
+
+  private createCSV(headers: string[], rows: string[][]): Buffer {
+    const csv = [
+      headers.join(','),
+      ...rows.map(row => row.map(cell => `"${cell.replace(/"/g, '""')}"`).join(',')),
+    ].join('\n');
+
+    return Buffer.from(csv, 'utf-8');
+  }
+}