lean-claudient-core 0.1.0

package/src/metrics/competitorMetrics.ts

@@ -0,0 +1,175 @@
+/**
+ * Competitive Intelligence Tracking
+ * Monitors competitor vulnerabilities, feature releases, and market threat
+ */
+
+export interface Vulnerability {
+  id: string;
+  competitorId: string;
+  title: string;
+  severity: 'critical' | 'high' | 'medium' | 'low';
+  discoveredAt: number;
+  impact?: string;
+}
+
+export interface CompetitorRelease {
+  id: string;
+  competitorId: string;
+  title: string;
+  description: string;
+  releaseDate: number;
+  features: string[];
+}
+
+export interface Competitor {
+  id: string;
+  name: string;
+  sector: string;
+  foundedAt: number;
+  vulnerabilities: Vulnerability[];
+  releases: CompetitorRelease[];
+  threatScore: number; // 0-100
+  trendingDirection: 'up' | 'down' | 'stable';
+}
+
+export interface CompetitorMetrics {
+  totalCompetitors: number;
+  vulnerabilitiesFound: number;
+  vulnerabilitiesBySeverity: {
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+  };
+  avgThreatScore: number;
+  threateningCount: number; // Threat score > 70
+  stableCount: number;
+  decliningCount: number;
+  competitors: Competitor[];
+  featureVelocity: Record<string, number>; // releases per month by competitor
+}
+
+export function createCompetitor(id: string, name: string, sector: string): Competitor {
+  return {
+    id,
+    name,
+    sector,
+    foundedAt: Date.now(),
+    vulnerabilities: [],
+    releases: [],
+    threatScore: 50,
+    trendingDirection: 'stable',
+  };
+}
+
+export function addVulnerability(
+  competitor: Competitor,
+  title: string,
+  severity: 'critical' | 'high' | 'medium' | 'low'
+): Vulnerability {
+  const vuln: Vulnerability = {
+    id: `${competitor.id}-${Date.now()}`,
+    competitorId: competitor.id,
+    title,
+    severity,
+    discoveredAt: Date.now(),
+  };
+
+  competitor.vulnerabilities.push(vuln);
+
+  // Update threat score
+  const severityWeights = { critical: 25, high: 15, medium: 8, low: 2 };
+  competitor.threatScore = Math.min(100, competitor.threatScore + severityWeights[severity]);
+
+  return vuln;
+}
+
+export function addRelease(
+  competitor: Competitor,
+  title: string,
+  features: string[]
+): CompetitorRelease {
+  const release: CompetitorRelease = {
+    id: `${competitor.id}-${Date.now()}`,
+    competitorId: competitor.id,
+    title,
+    description: `${features.length} new features released`,
+    releaseDate: Date.now(),
+    features,
+  };
+
+  competitor.releases.push(release);
+  return release;
+}
+
+export function calculateCompetitorMetrics(competitors: Competitor[]): CompetitorMetrics {
+  const vulns = competitors.flatMap(c => c.vulnerabilities);
+
+  const vulnerabilitiesBySeverity = {
+    critical: vulns.filter(v => v.severity === 'critical').length,
+    high: vulns.filter(v => v.severity === 'high').length,
+    medium: vulns.filter(v => v.severity === 'medium').length,
+    low: vulns.filter(v => v.severity === 'low').length,
+  };
+
+  const avgThreatScore = competitors.length > 0 ? competitors.reduce((sum, c) => sum + c.threatScore, 0) / competitors.length : 0;
+
+  const featureVelocity: Record<string, number> = {};
+  competitors.forEach(c => {
+    const thirtyDaysAgo = Date.now() - 30 * 24 * 60 * 60 * 1000;
+    const recentReleases = c.releases.filter(r => r.releaseDate >= thirtyDaysAgo).length;
+    featureVelocity[c.name] = recentReleases;
+  });
+
+  return {
+    totalCompetitors: competitors.length,
+    vulnerabilitiesFound: vulns.length,
+    vulnerabilitiesBySeverity,
+    avgThreatScore: Math.round(avgThreatScore * 10) / 10,
+    threateningCount: competitors.filter(c => c.threatScore > 70).length,
+    stableCount: competitors.filter(c => c.threatScore >= 40 && c.threatScore <= 70).length,
+    decliningCount: competitors.filter(c => c.threatScore < 40).length,
+    competitors,
+    featureVelocity,
+  };
+}
+
+export function estimateMarketShareImpact(
+  vulnerabilitiesFound: number,
+  criticalVulns: number,
+  avgThreatScore: number
+): {
+  estimatedMarketShareLoss: number; // percentage
+  riskLevel: 'low' | 'medium' | 'high' | 'critical';
+  recommendation: string;
+} {
+  let marketShareLoss = 0;
+
+  // Critical vulns can cause 2-5% market share loss per vulnerability
+  marketShareLoss += criticalVulns * 3;
+
+  // Each vulnerability can cause 0.5-1.5% loss
+  marketShareLoss += (vulnerabilitiesFound - criticalVulns) * 0.75;
+
+  // Threat score impact
+  marketShareLoss += (avgThreatScore / 100) * 10;
+
+  const riskLevel = avgThreatScore > 80 ? 'critical' : avgThreatScore > 65 ? 'high' : avgThreatScore > 50 ? 'medium' : 'low';
+
+  const recommendations = {
+    critical: 'Immediate action required: Proactive outreach, highlight competitor vulnerabilities in sales messaging',
+    high: 'Accelerate feature roadmap announcements, emphasize security posture vs. competitors',
+    medium: 'Standard competitive positioning, monitor for escalation',
+    low: 'Maintain current market monitoring cadence',
+  };
+
+  return {
+    estimatedMarketShareLoss: Math.round(marketShareLoss * 100) / 100,
+    riskLevel,
+    recommendation: recommendations[riskLevel],
+  };
+}
+
+export function rankCompetitorsByThreat(competitors: Competitor[]): Competitor[] {
+  return [...competitors].sort((a, b) => b.threatScore - a.threatScore);
+}

package/src/metrics/dashboardGenerator.ts

@@ -0,0 +1,335 @@
+/**
+ * Dashboard HTML Generator
+ * Generates interactive HTML dashboard from DashboardMetrics
+ * Phase 8B Task 4
+ */
+
+import { DashboardMetrics } from './metricsTypes.js';
+
+/**
+ * Generate HTML dashboard
+ */
+export function generateDashboardHTML(metrics: DashboardMetrics): string {
+  const threatDist = metrics.threats.distribution;
+  const totalThreats = Object.values(threatDist).reduce((a, b) => a + b, 0);
+
+  const funnelStages = metrics.funnel.stages
+    .map(
+      (s) => `
+    <div style="margin: 10px 0; padding: 10px; background: #f0f0f0; border-radius: 5px;">
+      <div style="font-weight: bold;">${s.stage.toUpperCase()} (${s.count})</div>
+      <div>Percentage: ${s.percentage.toFixed(1)}%</div>
+      <div>Conversion Rate: ${(s.conversionRate * 100).toFixed(1)}%</div>
+      <div>Avg Quality: ${s.avgQuality.toFixed(0)}</div>
+      <div>Avg Revenue: $${s.avgRevenue.toFixed(0)}</div>
+    </div>
+  `
+    )
+    .join('');
+
+  const revenueByStage = metrics.revenue.byStage
+    .map(
+      (r) => `
+    <tr>
+      <td>${r.stage}</td>
+      <td>${r.leadCount}</td>
+      <td>$${r.totalRevenue.toFixed(0)}</td>
+      <td>$${r.avgRevenue.toFixed(0)}</td>
+      <td>${(r.confidence * 100).toFixed(0)}%</td>
+    </tr>
+  `
+    )
+    .join('');
+
+  const topSignals = metrics.signals.topPerforming
+    .map(
+      (s) => `
+    <tr>
+      <td>${s.signal}</td>
+      <td>${s.matchCount}</td>
+      <td>${(s.conversionRate * 100).toFixed(1)}%</td>
+      <td>${s.avgQuality.toFixed(0)}</td>
+      <td>$${s.roi.toFixed(0)}</td>
+    </tr>
+  `
+    )
+    .join('');
+
+  const topLeads = metrics.revenue.topLeads
+    .map(
+      (l) => `
+    <tr>
+      <td>${l.name}</td>
+      <td>${l.company}</td>
+      <td>$${l.projectedRevenue.toFixed(0)}</td>
+      <td>${l.quality.toFixed(0)}</td>
+      <td>${l.stage}</td>
+    </tr>
+  `
+    )
+    .join('');
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Business Metrics Dashboard</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: #f5f5f5;
+      padding: 20px;
+    }
+    .container { max-width: 1400px; margin: 0 auto; }
+    .header {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      padding: 30px;
+      border-radius: 8px;
+      margin-bottom: 30px;
+      box-shadow: 0 4px 6px rgba(0,0,0,0.1);
+    }
+    .header h1 { font-size: 32px; margin-bottom: 10px; }
+    .header p { font-size: 14px; opacity: 0.9; }
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+      gap: 20px;
+      margin-bottom: 30px;
+    }
+    .card {
+      background: white;
+      padding: 20px;
+      border-radius: 8px;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    .card h3 {
+      font-size: 12px;
+      color: #666;
+      text-transform: uppercase;
+      margin-bottom: 10px;
+      font-weight: 600;
+    }
+    .card .value {
+      font-size: 28px;
+      font-weight: bold;
+      color: #333;
+    }
+    .card .subtitle {
+      font-size: 12px;
+      color: #999;
+      margin-top: 5px;
+    }
+    .section {
+      background: white;
+      padding: 30px;
+      border-radius: 8px;
+      margin-bottom: 20px;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    .section h2 {
+      font-size: 18px;
+      margin-bottom: 20px;
+      color: #333;
+      border-bottom: 2px solid #667eea;
+      padding-bottom: 10px;
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      font-size: 13px;
+    }
+    table th {
+      background: #f8f8f8;
+      padding: 12px;
+      text-align: left;
+      font-weight: 600;
+      color: #333;
+      border-bottom: 2px solid #e0e0e0;
+    }
+    table td {
+      padding: 12px;
+      border-bottom: 1px solid #e0e0e0;
+    }
+    table tr:hover { background: #f9f9f9; }
+    .threat-badge {
+      display: inline-block;
+      padding: 2px 8px;
+      border-radius: 3px;
+      font-weight: 600;
+      font-size: 11px;
+    }
+    .threat-critical { background: #fee; color: #c33; }
+    .threat-high { background: #ffd6d6; color: #d97070; }
+    .threat-medium { background: #fff4e6; color: #cc8800; }
+    .threat-low { background: #e8f5e9; color: #2e7d32; }
+    .conversion-bar {
+      display: inline-block;
+      height: 20px;
+      background: #667eea;
+      border-radius: 2px;
+      padding: 0 4px;
+      color: white;
+      font-size: 11px;
+      line-height: 20px;
+    }
+    .footer {
+      text-align: center;
+      color: #999;
+      font-size: 12px;
+      margin-top: 40px;
+      padding: 20px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>Business Metrics Dashboard</h1>
+      <p>Generated on ${new Date(metrics.generatedAt).toLocaleString()}</p>
+    </div>
+
+    <div class="grid">
+      <div class="card">
+        <h3>Total Leads</h3>
+        <div class="value">${metrics.totalLeads}</div>
+        <div class="subtitle">Enriched leads</div>
+      </div>
+      <div class="card">
+        <h3>Total Projected Revenue</h3>
+        <div class="value">$${(metrics.totalProjectedRevenue / 1000).toFixed(0)}k</div>
+        <div class="subtitle">Forecast</div>
+      </div>
+      <div class="card">
+        <h3>Funnel Conversion</h3>
+        <div class="value">${(metrics.funnel.coldToSalesReady * 100).toFixed(1)}%</div>
+        <div class="subtitle">Cold → Sales-Ready</div>
+      </div>
+      <div class="card">
+        <h3>Critical Threats</h3>
+        <div class="value">${metrics.threats.distribution.CRITICAL}</div>
+        <div class="subtitle">${metrics.threats.percentByCritical.toFixed(1)}% of leads</div>
+      </div>
+    </div>
+
+    <div class="section">
+      <h2>Lead Funnel</h2>
+      <div>${funnelStages}</div>
+    </div>
+
+    <div class="section">
+      <h2>Revenue by Stage</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Stage</th>
+            <th>Lead Count</th>
+            <th>Total Revenue</th>
+            <th>Avg Revenue</th>
+            <th>Confidence</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${revenueByStage}
+        </tbody>
+      </table>
+    </div>
+
+    <div class="section">
+      <h2>Top Performing Signals</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Signal</th>
+            <th>Matches</th>
+            <th>Conversion</th>
+            <th>Avg Quality</th>
+            <th>ROI</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${topSignals}
+        </tbody>
+      </table>
+    </div>
+
+    <div class="section">
+      <h2>Top Leads</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Name</th>
+            <th>Company</th>
+            <th>Projected Revenue</th>
+            <th>Quality</th>
+            <th>Stage</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${topLeads}
+        </tbody>
+      </table>
+    </div>
+
+    <div class="section">
+      <h2>Threat Distribution</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>Threat Level</th>
+            <th>Count</th>
+            <th>Percentage</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><span class="threat-badge threat-critical">CRITICAL</span></td>
+            <td>${threatDist.CRITICAL}</td>
+            <td>${totalThreats > 0 ? ((threatDist.CRITICAL / totalThreats) * 100).toFixed(1) : 0}%</td>
+          </tr>
+          <tr>
+            <td><span class="threat-badge threat-high">HIGH</span></td>
+            <td>${threatDist.HIGH}</td>
+            <td>${totalThreats > 0 ? ((threatDist.HIGH / totalThreats) * 100).toFixed(1) : 0}%</td>
+          </tr>
+          <tr>
+            <td><span class="threat-badge threat-medium">MEDIUM</span></td>
+            <td>${threatDist.MEDIUM}</td>
+            <td>${totalThreats > 0 ? ((threatDist.MEDIUM / totalThreats) * 100).toFixed(1) : 0}%</td>
+          </tr>
+          <tr>
+            <td><span class="threat-badge threat-low">LOW</span></td>
+            <td>${threatDist.LOW}</td>
+            <td>${totalThreats > 0 ? ((threatDist.LOW / totalThreats) * 100).toFixed(1) : 0}%</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+
+    <div class="footer">
+      <p>Lean Claudient • Business Intelligence Dashboard</p>
+    </div>
+  </div>
+</body>
+</html>`;
+}
+
+/**
+ * Save dashboard HTML to file
+ */
+export function saveDashboardHTML(
+  metrics: DashboardMetrics,
+  outputPath: string
+): string {
+  const html = generateDashboardHTML(metrics);
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const filePath = `${outputPath}/dashboard-${timestamp}.html`;
+
+  require('fs').writeFileSync(filePath, html, 'utf-8');
+
+  return filePath;
+}
+
+export default generateDashboardHTML;