Method getConsensus

src/utils/usage-tracker.ts:412–480

(category: string)

  }

  getConsensus(category: string): PatternUsageStats[string] | null {
    const categoryPatterns = this.patterns.get(category);
    if (!categoryPatterns || categoryPatterns.size === 0) return null;

    const total = Array.from(categoryPatterns.values()).reduce((a, b) => a + b, 0);
    const sorted = Array.from(categoryPatterns.entries()).sort((a, b) => b[1] - a[1]);

    const [primaryName, primaryCount] = sorted[0];
    const primaryFreq = Math.round((primaryCount / total) * 100);
    const exampleKey = `${category}:${primaryName}`;
    const canonicalExample = this.canonicalExamples.get(exampleKey);

    const primaryDate = this.getRobustDate(category, primaryName);
    const primaryTrend = calculateTrend(primaryDate);

    let hasRisingAlternative = false;
    let alternatives: Array<{
      name: string;
      count: number;
      frequency: number;
      date: Date | undefined;
      trend: PatternTrend | undefined;
    }> = [];

    if (sorted.length > 1) {
      alternatives = sorted.slice(1, 4).map(([name, count]) => {
        const altDate = this.getRobustDate(category, name);
        const altTrend = calculateTrend(altDate);
        const altFreq = Math.round((count / total) * 100);
        if (altTrend === 'Rising') hasRisingAlternative = true;
        return { name, count, frequency: altFreq, date: altDate, trend: altTrend };
      });
    }

    // Generate actionable guidance from percentage + trend, now aware of rising alternatives
    const primaryGuidance = this.generateGuidance(
      primaryName,
      primaryFreq,
      primaryTrend,
      false,
      hasRisingAlternative
    );

    const result: PatternUsageStats[string] = {
      primary: {
        name: primaryName,
        count: primaryCount,
        frequency: `${primaryFreq}%`,
        examples: canonicalExample ? [canonicalExample.file] : [],
        canonicalExample: canonicalExample,
        newestFileDate: primaryDate?.toISOString(),
        trend: primaryTrend,
        guidance: primaryGuidance
      }
    };

    if (alternatives.length > 0) {
      result.alsoDetected = alternatives.map((alt) => ({