docs: tabbed sidebar nav + de-emphasize objectql/ui/os protocol branding

.changeset/docs-nav-restructure.md

@@ -0,0 +1,4 @@
+---
+---
+
+docs: restructure the docs site left navigation — split the single long sidebar into six icon-labelled tabs (Getting Started, Concepts, Guides, Reference, Protocol, Releases), de-emphasise the ObjectQL/ObjectUI/ObjectOS protocol branding (Protocol moved to the last tab), isolate the 238 generated reference pages into their own tab, group the Guides section (Foundations/Building/Integration/Operations/Cheatsheets), and fix the top-nav GitHub link (objectstack-ai/spec → framework). Nav-only; no doc URLs change.

apps/docs/lib/layout.shared.tsx

@@ -3,7 +3,7 @@ import Image from 'next/image';
 
 export const gitConfig = {
   user: 'objectstack-ai',
-  repo: 'spec',
+  repo: 'framework',
   branch: 'main',
 };
 

content/docs/concepts/meta.json

@@ -1,4 +1,6 @@
 {
   "title": "Concepts",
+  "icon": "Lightbulb",
+  "root": true,
   "pages": ["index", "north-star", "metadata-driven", "metadata-lifecycle", "design-principles", "architecture", "cluster-semantics", "webhook-delivery", "skills", "core", "packages", "setup-app", "cloud-artifact-api", "terminology", "implementation-status"]
 }

content/docs/getting-started/meta.json

@@ -1,4 +1,6 @@
 {
   "title": "Getting Started",
+  "icon": "Rocket",
+  "root": true,
   "pages": ["index", "quick-start", "core-concepts", "architecture", "examples", "cli", "glossary"]
 }

content/docs/guides/contracts/meta.json

@@ -1,4 +1,4 @@
 {
-  "title": "Contracts Protocol",
+  "title": "Service Contracts",
   "pages": ["index", "metadata-service", "auth-service", "storage-service", "data-engine", "cache-service"]
-}
+}

content/docs/guides/meta.json

@@ -1,7 +1,10 @@
 {
   "title": "Guides",
+  "icon": "BookOpen",
+  "root": true,
   "pages": [
     "index",
+    "---Foundations---",
     "packages",
     "metadata",
     "adding-a-metadata-type",
@@ -26,6 +29,7 @@
     "---Integration---",
     "api-reference",
     "client-sdk",
+    "contracts",
     "project-scoping",
     "driver-configuration",
     "kernel-services",
@@ -43,8 +47,7 @@
     "error-handling-server",
     "standards",
     "troubleshooting",
-    "---",
-    "contracts",
+    "---Cheatsheets---",
     "cheatsheets"
   ]
 }

content/docs/meta.json

@@ -4,11 +4,8 @@
     "getting-started",
     "concepts",
     "guides",
-    "---",
-    "protocol",
-    "---",
     "references",
-    "---",
+    "protocol",
     "releases"
   ]
 }

content/docs/protocol/meta.json

@@ -1,4 +1,6 @@
 {
-  "title": "Protocol Overview",
+  "title": "Protocol",
+  "icon": "Network",
+  "root": true,
   "pages": ["index", "objectql", "objectui", "objectos", "knowledge"]
 }

content/docs/references/meta.json

@@ -1,5 +1,7 @@
 {
-  "title": "Protocol Reference",
+  "title": "Reference",
+  "icon": "FileCode",
+  "root": true,
   "pages": [
     "ai",
     "api",

content/docs/releases/meta.json

@@ -1,4 +1,6 @@
 {
   "title": "Releases",
+  "icon": "Tag",
+  "root": true,
   "pages": ["index", "v9"]
 }

packages/spec/scripts/build-docs.ts

@@ -442,7 +442,11 @@ const pages = [
 ];
 
 const meta = {
-  title: "Protocol Reference",
+  title: "Reference",
+  icon: "FileCode",
+  // Render the (large, generated) reference as its own sidebar tab so it does not
+  // crowd the hand-written docs. Keep in sync with the other root sections' meta.json.
+  root: true,
   pages: pages
 };
 fs.writeFileSync(path.join(DOCS_ROOT, 'meta.json'), JSON.stringify(meta, null, 2));