Render the private families, generated surfaces, solid-anchor searches, hard-vs-advisory contrast checks, and gamut reductions from compileTheme's diagnostics. Add a colour token board driven off flattenThemeContract, with a visual capture per bundled theme and mode so a future generator or mapping change produces an obvious diff. Document the v2 pipeline, the expected repaint, and the border, accent, and alpha policies. Part of #231 (#239).