fix: use average monthly downloads and compact rows

METRIC_PLAN.md

@@ -1,12 +1,12 @@
 # Metric Scope Plan
 
-1. Keep the table's primary metric named `Downloads / Month`.
-2. Calculate `Downloads / Month` from Hugging Face's `downloads` field, not from all-time downloads divided by age.
+1. Keep the table's primary metric named `Avg Downloads / Month`.
+2. Calculate `Avg Downloads / Month` from all-time downloads divided by model age in months.
 3. Support two metric scopes in the UI:
    - `Grouped repos`: sum downloads, all-time downloads, and likes across related repos.
    - `Representative repo`: use only the main repo shown in the Model column.
 4. Default to `Grouped repos`.
-5. Keep default sorting on `Downloads / Month`, and make sorting follow the selected metric scope.
-6. Show all-time downloads and monthly downloads under the downloads/month value so the scope is clear.
+5. Keep default sorting on `Avg Downloads / Month`, and make sorting follow the selected metric scope.
+6. Show all-time downloads and recent Hugging Face downloads under the average downloads/month value so the scope is clear.
 7. Calculate `Avg Likes / month` from likes divided by model age in months, using the selected metric scope.
 8. Explain the metric scope, rate formulas, and minimum download cutoff in the bottom info section.

leaderboard_core.py

@@ -164,6 +164,7 @@ GROUP_CSV_FIELDS = [
 
 SECONDS_PER_DAY = 86_400
 DAYS_PER_MONTH = 365.2425 / 12
+MIN_DOWNLOAD_RATE_AGE_DAYS = DAYS_PER_MONTH
 MIN_LIKE_RATE_AGE_DAYS = DAYS_PER_MONTH
 
 ARTIFACT_REVISION_SUFFIX_RE = re.compile(r"-(?:gguf|awq|gptq|fp8|fp4|mxfp8|nvfp4)-v[0-9]+$")
@@ -1300,18 +1301,23 @@ def age_days(created_at: Any, as_of: datetime) -> float:
 
 def rate_metrics(group: dict[str, Any], as_of: datetime) -> dict[str, float]:
     age = age_days(group.get("created_at"), as_of)
+    download_age = max(age, MIN_DOWNLOAD_RATE_AGE_DAYS)
     like_age = max(age, MIN_LIKE_RATE_AGE_DAYS)
-    group_downloads = int_metric(group.get("group_downloads", group.get("downloads")))
-    representative_downloads = int_metric(group.get("representative_downloads", group_downloads))
+    group_downloads_all_time = int_metric(group.get("group_downloads_all_time", group.get("downloads_all_time")))
+    representative_downloads_all_time = int_metric(
+        group.get("representative_downloads_all_time", group_downloads_all_time)
+    )
     group_likes = int_metric(group.get("group_likes", group.get("likes")))
     representative_likes = int_metric(group.get("representative_likes", group_likes))
+    group_downloads_per_month = round(group_downloads_all_time * DAYS_PER_MONTH / download_age, 4)
+    representative_downloads_per_month = round(representative_downloads_all_time * DAYS_PER_MONTH / download_age, 4)
     group_likes_per_month = round(group_likes * DAYS_PER_MONTH / like_age, 4)
     representative_likes_per_month = round(representative_likes * DAYS_PER_MONTH / like_age, 4)
     return {
         "age_days": round(age, 4),
-        "downloads_per_month": float(group_downloads),
-        "group_downloads_per_month": float(group_downloads),
-        "representative_downloads_per_month": float(representative_downloads),
+        "downloads_per_month": group_downloads_per_month,
+        "group_downloads_per_month": group_downloads_per_month,
+        "representative_downloads_per_month": representative_downloads_per_month,
         "likes_per_month": group_likes_per_month,
         "group_likes_per_month": group_likes_per_month,
         "representative_likes_per_month": representative_likes_per_month,
@@ -1651,6 +1657,15 @@ def render_html(payload: dict[str, Any]) -> str:
     def repo_count_label(count: int) -> str:
         return f"{count} repo" if count == 1 else f"{count} repos"
 
+    def more_variants_label(count: int) -> str:
+        return f"{count} more variant" if count == 1 else f"{count} more variants"
+
+    def artifact_link(model_id: str) -> str:
+        return (
+            f'<a href="{html.escape(model_url(model_id))}" target="_blank" rel="noreferrer">'
+            f"{html.escape(model_id)}</a>"
+        )
+
     table_rows = []
     for group in groups:
         if (
@@ -1678,10 +1693,48 @@ def render_html(payload: dict[str, Any]) -> str:
         group_likes = int_metric(group.get("group_likes", group.get("likes")))
         representative_likes = int_metric(group.get("representative_likes", group_likes))
         repo_label = repo_count_label(artifact_count)
-        related_repos = "".join(
-            f'<a href="{html.escape(model_url(str(item)))}" target="_blank" rel="noreferrer">{html.escape(str(item))}</a>'
-            for item in group["artifacts"]
+        group_downloads_detail_primary = format_compact_number(group_downloads_all_time) + " all-time across " + repo_label
+        group_downloads_detail_secondary = format_compact_number(group_downloads) + " recent HF downloads"
+        representative_downloads_detail_primary = (
+            format_compact_number(representative_downloads_all_time) + " all-time for representative"
+        )
+        representative_downloads_detail_secondary = (
+            format_compact_number(representative_downloads) + " recent HF downloads"
         )
+        group_likes_detail_primary = format_compact_number(group_likes) + " likes across " + repo_label
+        group_likes_detail_secondary = "grouped repos"
+        representative_likes_detail_primary = format_compact_number(representative_likes) + " likes for representative"
+        representative_likes_detail_secondary = "main repo only"
+        group_downloads_label = format_compact_number(group_downloads_per_month) + "/mo"
+        representative_downloads_label = format_compact_number(representative_downloads_per_month) + "/mo"
+        group_likes_label = format_compact_number(group_likes_per_month) + "/mo"
+        representative_likes_label = format_compact_number(representative_likes_per_month) + "/mo"
+        group_downloads_tooltip = "\n".join(
+            [group_downloads_label, group_downloads_detail_primary, group_downloads_detail_secondary]
+        )
+        representative_downloads_tooltip = "\n".join(
+            [
+                representative_downloads_label,
+                representative_downloads_detail_primary,
+                representative_downloads_detail_secondary,
+            ]
+        )
+        group_likes_tooltip = "\n".join([group_likes_label, group_likes_detail_primary, group_likes_detail_secondary])
+        representative_likes_tooltip = "\n".join(
+            [representative_likes_label, representative_likes_detail_primary, representative_likes_detail_secondary]
+        )
+        artifacts = [str(item) for item in group.get("artifacts") or []]
+        visible_artifact = artifact_link(artifacts[0]) if artifacts else ""
+        more_count = max(len(artifacts) - 1, 0)
+        extra_artifacts = "".join(artifact_link(item) for item in artifacts[1:])
+        more_label = more_variants_label(more_count)
+        artifact_toggle = (
+            f'<button class="artifact-toggle" type="button" aria-expanded="false" '
+            f'data-more-label="{attr(more_label)}">+ {html.escape(more_label)}</button>'
+            if more_count
+            else ""
+        )
+        artifact_extra = f'<span class="artifact-extra" hidden>{extra_artifacts}</span>' if more_count else ""
         row_attrs = {
             "data-class": group["candidate_class"],
             "data-creator": group["author"],
@@ -1690,25 +1743,14 @@ def render_html(payload: dict[str, Any]) -> str:
             "data-representative-downloads-per-month": representative_downloads_per_month,
             "data-group-likes-per-month": group_likes_per_month,
             "data-representative-likes-per-month": representative_likes_per_month,
-            "data-group-downloads-per-month-label": format_compact_number(group_downloads_per_month) + "/mo",
-            "data-representative-downloads-per-month-label": format_compact_number(representative_downloads_per_month)
-            + "/mo",
-            "data-group-likes-per-month-label": format_compact_number(group_likes_per_month) + "/mo",
-            "data-representative-likes-per-month-label": format_compact_number(representative_likes_per_month)
-            + "/mo",
-            "data-group-downloads-detail-primary": format_compact_number(group_downloads_all_time)
-            + " all-time across "
-            + repo_label,
-            "data-group-downloads-detail-secondary": format_compact_number(group_downloads) + " monthly downloads",
-            "data-representative-downloads-detail-primary": format_compact_number(representative_downloads_all_time)
-            + " all-time for representative",
-            "data-representative-downloads-detail-secondary": format_compact_number(representative_downloads)
-            + " monthly downloads",
-            "data-group-likes-detail-primary": format_compact_number(group_likes) + " likes across " + repo_label,
-            "data-group-likes-detail-secondary": "grouped repos",
-            "data-representative-likes-detail-primary": format_compact_number(representative_likes)
-            + " likes for representative",
-            "data-representative-likes-detail-secondary": "main repo only",
+            "data-group-downloads-per-month-label": group_downloads_label,
+            "data-representative-downloads-per-month-label": representative_downloads_label,
+            "data-group-likes-per-month-label": group_likes_label,
+            "data-representative-likes-per-month-label": representative_likes_label,
+            "data-group-downloads-tooltip": group_downloads_tooltip,
+            "data-representative-downloads-tooltip": representative_downloads_tooltip,
+            "data-group-likes-tooltip": group_likes_tooltip,
+            "data-representative-likes-tooltip": representative_likes_tooltip,
         }
         row_attr_text = " ".join(f'{name}="{attr(value)}"' for name, value in row_attrs.items())
         table_rows.append(
@@ -1719,12 +1761,12 @@ def render_html(payload: dict[str, Any]) -> str:
                 <a class="model-link" href="{html.escape(model_url(str(group['representative_id'])))}" target="_blank" rel="noreferrer">{html.escape(str(group['group_key']))}</a>
                 <div class="model-sub">{html.escape(str(group['representative_id']))}</div>
               </td>
-              <td class="num metric" data-label="Downloads / Month" data-metric="downloads_per_month"><span class="metric-value">{format_compact_number(group_downloads_per_month)}/mo</span><small class="metric-detail"><span class="metric-detail-primary">{format_compact_number(group_downloads_all_time)} all-time across {repo_label}</span><span class="metric-detail-secondary">{format_compact_number(group_downloads)} monthly downloads</span></small></td>
-              <td class="num metric" data-label="Avg Likes / month" data-metric="likes_per_month"><span class="metric-value">{format_compact_number(group_likes_per_month)}/mo</span><small class="metric-detail"><span class="metric-detail-primary">{format_compact_number(group_likes)} likes across {repo_label}</span><span class="metric-detail-secondary">grouped repos</span></small></td>
+              <td class="num metric has-tooltip" data-label="Avg Downloads / Month" data-metric="downloads_per_month" data-tooltip="{attr(group_downloads_tooltip)}" title="{attr(group_downloads_tooltip)}"><span class="metric-value">{group_downloads_label}</span></td>
+              <td class="num metric has-tooltip" data-label="Avg Likes / month" data-metric="likes_per_month" data-tooltip="{attr(group_likes_tooltip)}" title="{attr(group_likes_tooltip)}"><span class="metric-value">{group_likes_label}</span></td>
               <td data-label="Params">{format_params(group['parameter_count_b'])}</td>
               <td class="date-cell" data-label="Created">{render_created(group.get('created_at'), generated_at_dt)}</td>
               <td class="artifacts" data-label="Related repos">
-                <span>{related_repos}</span>
+                <span class="artifact-list">{visible_artifact}{artifact_toggle}{artifact_extra}</span>
               </td>
             </tr>
             """
@@ -1942,7 +1984,7 @@ def render_html(payload: dict[str, Any]) -> str:
     }}
     .site-footer a:hover {{ color: var(--accent); text-decoration: underline; }}
     table {{ width: 100%; min-width: 980px; border-collapse: collapse; table-layout: fixed; }}
-    th, td {{ padding: 12px 14px; border-bottom: 1px solid var(--line); vertical-align: top; text-align: left; font-size: 16px; }}
+    th, td {{ padding: 10px 14px; border-bottom: 1px solid var(--line); vertical-align: middle; text-align: left; font-size: 16px; }}
     td {{ overflow-wrap: anywhere; }}
     th {{
       position: sticky;
@@ -1967,12 +2009,33 @@ def render_html(payload: dict[str, Any]) -> str:
     tbody tr:hover {{ background: var(--hover); }}
     .rank {{ font-weight: 800; color: var(--accent-2); }}
     .model-cell {{ min-width: 260px; }}
-    .model-link {{ color: var(--ink); font-weight: 800; text-decoration: none; }}
+    .model-link {{ display: block; color: var(--ink); font-weight: 800; text-decoration: none; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }}
     .model-link:hover {{ color: var(--accent); }}
-    .model-sub {{ margin-top: 4px; color: var(--muted); font-size: 15px; overflow-wrap: anywhere; }}
+    .model-sub {{ margin-top: 4px; color: var(--muted); font-size: 15px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }}
     .num {{ text-align: right; white-space: nowrap; font-variant-numeric: tabular-nums; }}
-    .metric small {{ display: block; margin-top: 3px; color: var(--muted); font-size: 14px; white-space: normal; }}
-    .metric-detail span {{ display: block; }}
+    .metric {{ position: relative; }}
+    .metric.has-tooltip {{ cursor: help; }}
+    .metric.has-tooltip:hover::after,
+    .metric.has-tooltip:focus-within::after {{
+      content: attr(data-tooltip);
+      position: absolute;
+      right: 10px;
+      top: calc(100% + 8px);
+      z-index: 50;
+      width: max-content;
+      max-width: 280px;
+      padding: 8px 10px;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: oklch(18% 0.014 235);
+      color: var(--ink);
+      box-shadow: var(--shadow);
+      font-size: 13px;
+      line-height: 1.35;
+      text-align: left;
+      white-space: pre-line;
+      pointer-events: none;
+    }}
     .date-cell {{
       white-space: nowrap;
       font-variant-numeric: tabular-nums;
@@ -1988,9 +2051,52 @@ def render_html(payload: dict[str, Any]) -> str:
       color: var(--muted);
       font-size: 14px;
     }}
-    .artifacts {{ min-width: 280px; color: var(--muted); overflow-wrap: anywhere; }}
-    .artifacts span {{ display: flex; flex-wrap: wrap; gap: 5px 10px; overflow-wrap: anywhere; word-break: break-word; }}
-    .artifacts a {{ color: var(--link); text-decoration: none; overflow-wrap: anywhere; word-break: break-word; }}
+    .artifacts {{ min-width: 280px; color: var(--muted); }}
+    .artifact-list {{
+      display: flex;
+      align-items: center;
+      gap: 5px 10px;
+      min-width: 0;
+      overflow: hidden;
+      white-space: nowrap;
+    }}
+    .artifact-list.is-expanded {{
+      align-items: flex-start;
+      flex-wrap: wrap;
+      overflow: visible;
+      white-space: normal;
+    }}
+    .artifact-list > a {{
+      min-width: 0;
+      max-width: 170px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      flex: 0 1 auto;
+    }}
+    .artifact-list.is-expanded > a,
+    .artifact-list.is-expanded .artifact-extra a {{
+      max-width: none;
+      white-space: normal;
+      overflow-wrap: anywhere;
+    }}
+    .artifact-extra {{
+      display: contents;
+    }}
+    .artifact-toggle {{
+      flex: 0 0 auto;
+      border: 0;
+      padding: 0;
+      background: transparent;
+      color: var(--accent);
+      font: inherit;
+      font-size: 14px;
+      font-weight: 700;
+      cursor: pointer;
+      white-space: nowrap;
+    }}
+    .artifact-toggle:hover {{ color: var(--accent-2); text-decoration: underline; }}
+    .artifacts a {{ color: var(--link); text-decoration: none; }}
     .artifacts a:hover {{ color: var(--accent); text-decoration: underline; }}
     @media (max-width: 980px) {{
       .shell {{ padding: 16px 0; }}
@@ -2081,7 +2187,7 @@ def render_html(payload: dict[str, Any]) -> str:
         <div class="control">
           <label for="sortFilter">Sort by</label>
           <select id="sortFilter">
-            <option value="downloads_per_month">Downloads / Month</option>
+            <option value="downloads_per_month">Avg Downloads / Month</option>
             <option value="likes_per_month">Avg Likes / month</option>
           </select>
         </div>
@@ -2111,7 +2217,7 @@ def render_html(payload: dict[str, Any]) -> str:
           <tr>
             <th data-sort="num">Rank</th>
             <th data-sort="text">Model</th>
-            <th data-sort="num">Downloads / Month</th>
+            <th data-sort="num">Avg Downloads / Month</th>
             <th data-sort="num">Avg Likes / month</th>
             <th data-sort="text">Params</th>
             <th data-sort="text">Created</th>
@@ -2139,11 +2245,11 @@ def render_html(payload: dict[str, Any]) -> str:
         </div>
         <div class="method-item">
           <strong>Default sort</strong>
-          Rows are sorted by downloads per month unless you choose likes per month. Sorting follows the selected metric scope, and visible rank is recalculated after filters.
+          Rows are sorted by average downloads per month unless you choose likes per month. Sorting follows the selected metric scope, and visible rank is recalculated after filters.
         </div>
         <div class="method-item">
           <strong>Rates</strong>
-          <span class="formula">downloads/month = Hugging Face downloads field for the selected scope</span><br />
+          <span class="formula">avg downloads/month = all-time downloads / max(model age, 1 month)</span><br />
           <span class="formula">likes/month = total likes / max(model age, 1 month)</span>
         </div>
         <div class="method-item">
@@ -2206,13 +2312,15 @@ def render_html(payload: dict[str, Any]) -> str:
       const cell = row.querySelector(`[data-metric="${{metric}}"]`);
       if (!cell) return;
       const value = cell.querySelector('.metric-value');
-      const primary = cell.querySelector('.metric-detail-primary');
-      const secondary = cell.querySelector('.metric-detail-secondary');
       const prefix = metric === 'likes_per_month' ? `${{scope}}Likes` : `${{scope}}Downloads`;
       const rate = 'PerMonth';
+      const tooltip = row.dataset[`${{prefix}}Tooltip`];
       if (value) value.textContent = row.dataset[`${{prefix}}${{rate}}Label`] || value.textContent;
-      if (primary) primary.textContent = row.dataset[`${{prefix}}DetailPrimary`] || primary.textContent;
-      if (secondary) secondary.textContent = row.dataset[`${{prefix}}DetailSecondary`] || secondary.textContent;
+      if (tooltip) {{
+        cell.dataset.tooltip = tooltip;
+        cell.title = tooltip;
+        cell.setAttribute('aria-label', tooltip.replace(/\\n/g, ', '));
+      }}
     }}
     function updateScopedMetrics() {{
       rows.forEach(row => {{
@@ -2257,6 +2365,20 @@ def render_html(payload: dict[str, Any]) -> str:
     sortFilter.addEventListener('change', applyFilters);
     scopeFilter.addEventListener('change', applyFilters);
     classFilter.addEventListener('change', applyFilters);
+    tbody.addEventListener('click', event => {{
+      const target = event.target;
+      if (!(target instanceof Element)) return;
+      const button = target.closest('.artifact-toggle');
+      if (!button) return;
+      const list = button.closest('.artifact-list');
+      const extra = list?.querySelector('.artifact-extra');
+      if (!list || !extra) return;
+      const expanded = button.getAttribute('aria-expanded') === 'true';
+      button.setAttribute('aria-expanded', expanded ? 'false' : 'true');
+      list.classList.toggle('is-expanded', !expanded);
+      extra.hidden = expanded;
+      button.textContent = expanded ? `+ ${{button.dataset.moreLabel || 'more variants'}}` : 'Show fewer variants';
+    }});
     filterToggle?.addEventListener('click', () => {{
       setFiltersOpen(filterToggle.getAttribute('aria-expanded') !== 'true');
     }});

tests/test_leaderboard_core.py

@@ -521,24 +521,40 @@ class DiscoveryTests(unittest.TestCase):
 
 
 class RateMetricTests(unittest.TestCase):
-    def test_downloads_per_month_use_recent_downloads_and_likes_are_clamped_to_one_month(self):
+    def test_downloads_per_month_average_uses_all_time_and_month_clamp(self):
         metrics = rate_metrics(
             {
                 "created_at": "2026-06-18T12:00:00Z",
                 "downloads": 2_400,
-                "representative_downloads": 1_800,
                 "downloads_all_time": 4_800,
                 "likes": 50,
+                "representative_downloads_all_time": 3_600,
                 "representative_likes": 25,
             },
             datetime(2026, 6, 19, tzinfo=timezone.utc),
         )
-        self.assertEqual(metrics["downloads_per_month"], 2_400)
-        self.assertEqual(metrics["group_downloads_per_month"], 2_400)
-        self.assertEqual(metrics["representative_downloads_per_month"], 1_800)
+        self.assertEqual(metrics["downloads_per_month"], 4_800)
+        self.assertEqual(metrics["group_downloads_per_month"], 4_800)
+        self.assertEqual(metrics["representative_downloads_per_month"], 3_600)
         self.assertEqual(metrics["likes_per_month"], 50)
         self.assertEqual(metrics["representative_likes_per_month"], 25)
 
+    def test_downloads_per_month_average_normalizes_older_models_by_age(self):
+        metrics = rate_metrics(
+            {
+                "created_at": "2026-01-01T00:00:00Z",
+                "downloads": 2_400,
+                "downloads_all_time": 90_000,
+                "representative_downloads_all_time": 45_000,
+                "likes": 10,
+            },
+            datetime(2026, 4, 1, tzinfo=timezone.utc),
+        )
+        expected = round(90_000 * leaderboard_core.DAYS_PER_MONTH / 90, 4)
+        representative_expected = round(45_000 * leaderboard_core.DAYS_PER_MONTH / 90, 4)
+        self.assertEqual(metrics["downloads_per_month"], expected)
+        self.assertEqual(metrics["representative_downloads_per_month"], representative_expected)
+
     def test_compact_rates_preserve_tiny_nonzero_values(self):
         self.assertEqual(format_compact_number(0.0194), "<0.1")
 
@@ -629,9 +645,9 @@ class RenderTests(unittest.TestCase):
                     "downloads_all_time": 1_234_567,
                     "group_downloads_all_time": 1_234_567,
                     "representative_downloads_all_time": 987_654,
-                    "downloads_per_month": 123_456,
-                    "group_downloads_per_month": 123_456,
-                    "representative_downloads_per_month": 111_111,
+                    "downloads_per_month": 12_345.67,
+                    "group_downloads_per_month": 12_345.67,
+                    "representative_downloads_per_month": 9_876.54,
                     "likes": 1_234,
                     "group_likes": 1_234,
                     "representative_likes": 1_000,
@@ -645,8 +661,8 @@ class RenderTests(unittest.TestCase):
                     "router_served": True,
                     "supports_tools": True,
                     "supports_structured_output": False,
-                    "artifact_count": 1,
-                    "artifacts": ["Qwen/Qwen3-8B"],
+                    "artifact_count": 3,
+                    "artifacts": ["Qwen/Qwen3-8B", "Qwen/Qwen3-8B-AWQ", "unsloth/Qwen3-8B-GGUF"],
                     "artifact_signals": ["safetensors"],
                     "created_at": "2026-01-01T00:00:00Z",
                     "last_modified": "2026-01-02T00:00:00Z",
@@ -681,26 +697,36 @@ class RenderTests(unittest.TestCase):
         self.assertIn("padding-right: 42px", text)
         self.assertIn("background-position: right 16px center", text)
         self.assertIn('<option value="365" selected>1 year</option>', text)
-        self.assertIn("Downloads / Month", text)
+        self.assertIn("Avg Downloads / Month", text)
         self.assertIn("Avg Likes / month", text)
-        self.assertIn("data-group-downloads-per-month=\"123456.0\"", text)
-        self.assertIn("data-representative-downloads-per-month=\"111111.0\"", text)
+        self.assertIn("data-group-downloads-per-month=\"12345.67\"", text)
+        self.assertIn("data-representative-downloads-per-month=\"9876.54\"", text)
         self.assertIn("data-group-likes-per-month=\"456.78\"", text)
         self.assertIn("data-representative-likes-per-month=\"321.09\"", text)
+        self.assertIn("data-group-downloads-tooltip=", text)
+        self.assertIn("data-group-likes-tooltip=", text)
+        self.assertIn("class=\"num metric has-tooltip\"", text)
+        self.assertNotIn("class=\"metric-detail\"", text)
+        self.assertNotIn("<small class=\"metric-detail\"", text)
         self.assertIn(">Model<", text)
         self.assertNotIn("Model group", text)
         self.assertNotIn("visibleCount", text)
         self.assertIn("How This Is Calculated", text)
         self.assertIn("Grouped metrics sum downloads, all-time downloads, and likes across related lineage repos", text)
-        self.assertIn("downloads/month = Hugging Face downloads field for the selected scope", text)
+        self.assertIn("avg downloads/month = all-time downloads / max(model age, 1 month)", text)
         self.assertIn("likes/month = total likes / max(model age, 1 month)", text)
         self.assertIn("Valid popular artifacts without a safe grouping target stay as standalone rows", text)
         self.assertIn("configured download floor, currently 100K", text)
-        self.assertIn("123.5K/mo", text)
+        self.assertIn("12.3K/mo", text)
         self.assertIn("456.8/mo", text)
-        self.assertIn("1.2M all-time across 1 repo", text)
-        self.assertIn("123.5K monthly downloads", text)
-        self.assertIn("1.2K likes across 1 repo", text)
+        self.assertIn("1.2M all-time across 3 repos", text)
+        self.assertIn("123.5K recent HF downloads", text)
+        self.assertIn("1.2K likes across 3 repos", text)
+        self.assertIn("class=\"artifact-list\"", text)
+        self.assertIn("class=\"artifact-toggle\"", text)
+        self.assertIn("+ 2 more variants", text)
+        self.assertIn("class=\"artifact-extra\" hidden", text)
+        self.assertIn("Show fewer variants", text)
         self.assertNotIn("(123.5K total)", text)
         self.assertNotIn("(1.2K total)", text)
         self.assertIn('<span class="date-stamp">2026-01-01</span>', text)