Normalize catalogs for existing preview clients (#36)

Normalize each compatible benchmark history to one merged catalog when
assembling site data.

This lets PR #30's existing preview bundle load additive runtime results
without changing its head or rerunning benchmarks. Stored result bundles
remain immutable, and conflicting definitions still fail validation.

Validation: `npm run build`; editor diagnostics; `git diff --check`.
Tests were not run.

Signed-off-by: Ludvig Liljenberg <4257730+ludfjig@users.noreply.github.com>

Author: ludfjig

scripts/assemble-site.ts

@@ -1,7 +1,7 @@
 import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync } from 'node:fs'
 import { resolve } from 'node:path'
 import { z } from 'zod'
-import { historyIndexSchema, historyRunPath, parseHistoryRun, runKey, groupHistories, validatePublication } from '../shared/results.ts'
+import { historyIndexSchema, historyRunPath, parseHistoryRun, runKey, groupHistories, validateHistory, validatePublication } from '../shared/results.ts'
 import type { RunBundle } from '../shared/results.ts'
 import { readJson, readOptionalJson, writeJson } from './result-store.ts'
 
@@ -54,7 +54,11 @@ export function assembleSite(options: {
   const published = index.runs.map(entry => parseHistoryRun(readJson(resolve(options.store, historyRunPath(entry))), entry))
   const seen = new Set<number>()
   function serveData(destination: string, bundles: RunBundle[], preview?: { number: number, head: string, pending: { id: string, attempt: number } | null }) {
-    groupHistories(bundles)
+    const catalogs = new Map(groupHistories(bundles).flatMap(history => {
+      const { runtimes, platforms, metrics } = validateHistory(history)
+      const catalog = { runtimes, platforms, metrics }
+      return history.map(bundle => [runKey(bundle), catalog] as const)
+    }))
     const runs = bundles.map(bundle => {
       const entry = { id: bundle.run.id, attempt: bundle.run.attempt }
       if (!index.runs.some(run => run.id === entry.id && run.attempt === entry.attempt)) return entry
@@ -69,7 +73,7 @@ export function assembleSite(options: {
       } }
     })
     const history = historyIndexSchema.parse({ schemaVersion: 1, runs, ...(preview ? { preview } : {}) })
-    for (const bundle of bundles) writeJson(resolve(destination, 'data', historyRunPath(bundle.run)), bundle, true)
+    for (const bundle of bundles) writeJson(resolve(destination, 'data', historyRunPath(bundle.run)), { ...bundle, catalog: catalogs.get(runKey(bundle))! }, true)
     writeJson(resolve(destination, 'data/index.json'), history, true)
   }
   try {

scripts/publication.test.ts

@@ -262,6 +262,16 @@ test('benchmark definition changes retain selectable histories and pending previ
   const production = resolve(temporary, 'build')
   mkdirSync(production)
   writeFileSync(resolve(production, 'index.html'), '<!doctype html><title>Fixture</title>')
+  const compatibilityStore = resolve(temporary, 'compatibility-store')
+  writeJson(resolve(compatibilityStore, historyRunPath(first.run)), first, true)
+  writeJson(resolve(compatibilityStore, historyRunPath(expanded.run)), expanded, true)
+  writeJson(resolve(compatibilityStore, 'index.json'), { schemaVersion: 1, runs: [first.run, expanded.run].map(({ id, attempt }) => ({ id, attempt })) }, true)
+  const compatibilitySite = resolve(temporary, 'compatibility-site')
+  assembleSite({ production, store: compatibilityStore, output: compatibilitySite, repository, previews: [] })
+  const servedFirst = readJson(resolve(compatibilitySite, 'data', historyRunPath(first.run))) as any
+  const servedExpanded = readJson(resolve(compatibilitySite, 'data', historyRunPath(expanded.run))) as any
+  assert.deepEqual(servedFirst.catalog, servedExpanded.catalog)
+  assert.equal(servedFirst.catalog.runtimes.length, first.catalog.runtimes.length + 1)
   const pending = fixture()
   pending.run.id = 'pending'
   pending.run.createdAt = '2026-09-05T00:00:00Z'