docs(observe): split Observe + traceAI into product and SDK sections

src/components/Sidebar.astro

@@ -94,18 +94,18 @@ const isApiTab = activeTab?.tab === 'API';
 
 function inferApiMethod(title: string): { method: string; css: string } | null {
   const t = title.toLowerCase();
-  if (/\b(delete|remove)\b/.test(t)) {
-    return { method: 'DELETE', css: 'api-method-delete' };
-  }
-  if (/\b(update|edit|apply|restore)\b/.test(t)) {
-    return { method: 'PATCH', css: 'api-method-patch' };
-  }
-  if (/\b(list|get|retrieve|health|find|export|progress|analytics|agreement|compare|stats|summary|voices|tts|aggregat\w*)\b/.test(t)) {
+  if (/\b(list|get|retrieve|health|find|export|progress|analytics|agreement|compare|stats|summary|voices|tts)\b/.test(t)) {
     return { method: 'GET', css: 'api-method-get' };
   }
   if (/\b(create|add|generate|execute|submit|assign|bulk|complete|skip|release|pause|unpause|check|upload|start|duplicate|fetch|run|rerun|cancel|clone|merge)\b/.test(t)) {
     return { method: 'POST', css: 'api-method-post' };
   }
+  if (/\b(delete|remove)\b/.test(t)) {
+    return { method: 'DEL', css: 'api-method-delete' };
+  }
+  if (/\b(update|edit|apply|restore)\b/.test(t)) {
+    return { method: 'PATCH', css: 'api-method-patch' };
+  }
   return null;
 }
 ---

src/components/docs/CodeGroup.astro

@@ -40,6 +40,11 @@ const id = `code-group-${Math.random().toString(36).slice(2, 9)}`;
 </div>
 
 <style is:global>
+  /* Before JS initializes, hide all but the first code block so a multi-language
+     group doesn't flash every language's code stacked together (FOUC). */
+  [data-code-group]:not([data-cgp-init]) .code-panels > *:not(:first-child) {
+    display: none;
+  }
   /* Hide all code panel items; JS adds .cgp-active to show the selected one */
   .code-group-panel {
     display: none;

src/components/docs/Mermaid.astro

@@ -0,0 +1,38 @@
+---
+/**
+ * Mermaid diagram, rendered client-side from CDN.
+ * Usage in MDX:  <Mermaid chart={`flowchart LR\n  A --> B`} />
+ *
+ * The script is `is:inline` so Astro does not bundle it — the CDN module import
+ * then runs natively in the browser (matching how the rest of this repo loads
+ * third-party client scripts). The diagram source lives in the page, per the
+ * docs playbook. In the full monorepo, `pnpm add mermaid` and swap the CDN
+ * import for `import mermaid from 'mermaid'`.
+ */
+interface Props {
+  chart: string;
+}
+const { chart } = Astro.props;
+---
+
+<pre class="mermaid not-prose" style="background: transparent; text-align: center;">{chart}</pre>
+
+<style is:global>
+  /* Center the rendered diagram inside its container. Mermaid outputs a
+     fixed-width block <svg>, which would otherwise sit flush left. */
+  pre.mermaid > svg {
+    display: block;
+    margin-inline: auto;
+  }
+</style>
+
+<script is:inline type="module">
+  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
+  mermaid.initialize({ startOnLoad: false, theme: 'dark', securityLevel: 'loose' });
+  const run = () => {
+    try { mermaid.run({ querySelector: 'pre.mermaid:not([data-processed="true"])' }); }
+    catch (err) { console.error('Mermaid render failed:', err); }
+  };
+  run();
+  document.addEventListener('astro:after-swap', run);
+</script>

src/lib/api-navigation.ts

@@ -61,6 +61,11 @@ export const apiNavigation: ApiNavGroup[] = [
         "title": "Add columns to a scenario",
         "href": "/docs/api/scenarios/addcolumns",
         "method": "POST"
+      },
+      {
+        "title": "Add empty rows to a scenario",
+        "href": "/docs/api/scenarios/addemptyrowstodataset",
+        "method": "POST"
       }
     ]
   },
@@ -182,6 +187,11 @@ export const apiNavigation: ApiNavGroup[] = [
         "href": "/docs/api/run-tests/executeruntest",
         "method": "POST"
       },
+      {
+        "title": "Update test run components",
+        "href": "/docs/api/run-tests/updatetestcomponents",
+        "method": "PATCH"
+      },
       {
         "title": "Get test executions",
         "href": "/docs/api/run-tests/gettestexecutions",
@@ -192,6 +202,11 @@ export const apiNavigation: ApiNavGroup[] = [
         "href": "/docs/api/run-tests/gettestscenarios",
         "method": "GET"
       },
+      {
+        "title": "Get call executions for a test run",
+        "href": "/docs/api/run-tests/getcallexecutions",
+        "method": "GET"
+      },
       {
         "title": "Get evaluation summary",
         "href": "/docs/api/run-tests/getevalsummary",
@@ -279,8 +294,7 @@ export const apiNavigation: ApiNavGroup[] = [
       { "title": "Delete Eval Task", "href": "/docs/api/eval-tasks/delete-eval-task", "method": "DELETE" },
       { "title": "Bulk Delete Eval Tasks", "href": "/docs/api/eval-tasks/bulk-delete-eval-tasks", "method": "POST" },
       { "title": "Pause Eval Task", "href": "/docs/api/eval-tasks/pause-eval-task", "method": "POST" },
-      { "title": "Unpause Eval Task", "href": "/docs/api/eval-tasks/unpause-eval-task", "method": "POST" },
-      { "title": "Eval Task Aggregations", "href": "/docs/api/eval-tasks/eval-task-aggregations", "method": "GET" }
+      { "title": "Unpause Eval Task", "href": "/docs/api/eval-tasks/unpause-eval-task", "method": "POST" }
     ]
   },
   {