Method track

src/utils/usage-tracker.ts:255–308

(
    category: string,
    patternName: string,
    example?: { file: string; snippet: string },
    fileDate?: Date
  )

  }

  track(
    category: string,
    patternName: string,
    example?: { file: string; snippet: string },
    fileDate?: Date
  ): void {
    if (!this.patterns.has(category)) {
      this.patterns.set(category, new Map());
    }

    const categoryPatterns = this.patterns.get(category)!;
    categoryPatterns.set(patternName, (categoryPatterns.get(patternName) || 0) + 1);

    // Track file dates for P90 robust trend analysis
    if (fileDate) {
      const dateKey = `${category}:${patternName}`;
      const dates = this.patternFileDates.get(dateKey);
      if (dates) {
        dates.push(fileDate.getTime());
      } else {
        this.patternFileDates.set(dateKey, [fileDate.getTime()]);
      }
    }

    // Smart Canonical Example Selection
    const exampleKey = `${category}:${patternName}`;

    if (example) {
      if (!this.canonicalExamples.has(exampleKey)) {
        this.canonicalExamples.set(exampleKey, example);
      } else {
        // Check if new example is better
        const existing = this.canonicalExamples.get(exampleKey)!;

        // Priority 1: Core/Shared directories (likely definitive)
        const isCoreOrShared = (f: string) => f.includes('core/') || f.includes('shared/');
        const newIsPriority = isCoreOrShared(example.file);
        const oldIsPriority = isCoreOrShared(existing.file);

        if (newIsPriority && !oldIsPriority) {
          this.canonicalExamples.set(exampleKey, example);
        } else if (newIsPriority === oldIsPriority) {
          // Priority 2: Concise length (but not too short)
          const newLen = example.snippet.length;
          const oldLen = existing.snippet.length;

          // If current is very long (>200 chars) and new is shorter but substantial (>50), take new
          if (oldLen > 200 && newLen < oldLen && newLen > 50) {
            this.canonicalExamples.set(exampleKey, example);
          }
        }
      }
    }
  }

  /**
   * Track a file as a potential "Golden File" - a file that demonstrates multiple modern patterns