Add scale-aware suggestions docs and data profile

Introduce scale-aware suggestions UX and schema: add a new ScaleAwarePage and blog entry (scale-aware-suggestions) and wire them into the docs nav and routes. Add DataScaleProfile type and test (src/components/ai/dataScaleProfile.ts + test) and update the suggestion engine to accept/handle declared scale (suggestCharts/suggestChartsGrouped changes). Update chart capability descriptors and the ai capability scorecard (ai/capability-scorecard.json) to reflect new fits/scores, added fixtures, and variant/caveat adjustments. Minor doc and navigation tweaks (InterrogationPage prev link) and preview component mapping for the new demo page.

Author: emeeks

ai/capability-scorecard.json

@@ -96,6 +96,7 @@ import CustomChartsPage from "./pages/features/CustomChartsPage"
 import CapabilitiesPage from "./pages/features/CapabilitiesPage"
 import InterrogationPage from "./pages/features/InterrogationPage"
 import SuggestionsPage from "./pages/features/SuggestionsPage"
+import ScaleAwarePage from "./pages/features/ScaleAwarePage"
 import ConversationArcPage from "./pages/features/ConversationArcPage"
 import TemporalLifecyclePage from "./pages/features/TemporalLifecyclePage"
 
@@ -431,6 +432,7 @@ export default function DocsApp() {
               <Route path="observation-hooks" element={<ObservationHooksPage />} />
               <Route path="capabilities" element={<CapabilitiesPage />} />
               <Route path="suggestions" element={<SuggestionsPage />} />
+              <Route path="scale" element={<ScaleAwarePage />} />
               <Route path="interrogation" element={<InterrogationPage />} />
               <Route path="conversation-arc" element={<ConversationArcPage />} />
               <Route path="temporal-lifecycle" element={<TemporalLifecyclePage />} />

docs/src/App.js

@@ -19,6 +19,18 @@
 // `draft: true`) are included here so the sync check and per-entry
 // inspection still work; the build scripts filter at consumption time.
 export const allBlogEntriesMeta = [
+  {
+    slug: "scale-aware-suggestions",
+    title: "Your sample lies about your data",
+    subtitle:
+      "Scale-aware chart suggestions: declare what the production dataset actually looks like, and get back recommendations that work at that scale instead of at the size of the sample you happened to pass.",
+    author: "Elijah Meeks",
+    date: "2026-05-29",
+    tags: ["case-study", "ai"],
+    excerpt:
+      "Hand `suggestCharts()` a hundred rows and it'll pick the right chart for the hundred. The production dataset is a million rows and the choice is wrong. Scale-aware suggestions close the gap by accepting a declared `DataScaleProfile` — what scale the data actually has, not what the sample looked like. With the design decisions behind it: split scale from quality, breakpoints per-chart not global, and the single-value gap the work surfaced.",
+    draft: true,
+  },
   {
     slug: "release-3-6-0",
     title: "Semiotic 3.6.0",

docs/src/blog/entries-meta.js

@@ -54,13 +54,15 @@ import LiveDashboard from "./entries/live-conversational-dashboard.js"
 import Release360 from "./entries/release-3-6-0.js"
 import TalkTrackIntelligence from "./entries/talk-track-intelligence.js"
 import FromSpecToRuntime from "./entries/from-spec-to-runtime.js"
+import ScaleAwareSuggestions from "./entries/scale-aware-suggestions.js"
 
 /**
  * Every entry, drafts included. Consumers that need the full list (direct
  * URL access, sync check) read this. Consumers that should NEVER surface
  * drafts (index listing, RSS, SEO prerender) read `blogEntries` below.
  */
 export const allBlogEntries = [
+  ScaleAwareSuggestions,
   Release360,
   FromSpecToRuntime,
   TalkTrackIntelligence,