docs(nav): group Protocol Reference modules and clarify top-level nav

content/docs/protocol/meta.json

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

content/docs/references/ai/meta.json

@@ -1,16 +1,19 @@
 {
  "title": "AI Protocol",
  "pages": [
+ "---Agents & Tools---",
  "agent",
+ "tool",
+ "skill",
  "conversation",
- "embedding",
- "knowledge-document",
- "knowledge-source",
  "mcp",
+ "---Knowledge & Embeddings---",
+ "knowledge-source",
+ "knowledge-document",
+ "embedding",
+ "---Models & Solutions---",
  "model-registry",
- "skill",
  "solution-blueprint",
- "tool",
  "usage"
  ]
-}
+}

content/docs/references/api/meta.json

@@ -1,43 +1,50 @@
 {
  "title": "API Protocol",
  "pages": [
- "analytics",
- "auth",
- "auth-endpoints",
- "automation-api",
- "batch",
- "connector",
- "contract",
+ "---Overview---",
+ "protocol",
  "core-services",
- "discovery",
- "dispatcher",
  "documentation",
+ "discovery",
+ "---REST & HTTP---",
+ "rest-server",
+ "router",
  "endpoint",
- "errors",
- "events",
+ "object",
+ "batch",
  "export",
- "feed-api",
- "graphql",
  "http",
  "http-cache",
- "identity",
+ "errors",
+ "versioning",
+ "---Query Interfaces---",
+ "query-adapter",
+ "graphql",
+ "odata",
+ "analytics",
  "metadata",
  "metadata-plugin",
+ "contract",
+ "---Auth & Identity---",
+ "auth",
+ "auth-endpoints",
+ "identity",
+ "---Realtime & Events---",
+ "realtime",
+ "realtime-shared",
+ "websocket",
+ "events",
+ "dispatcher",
  "notification",
- "object",
- "odata",
+ "feed-api",
+ "---Automation & Integration---",
+ "automation-api",
+ "connector",
+ "plugin-rest-api",
+ "---Packages & Storage---",
  "package-api",
  "package-registry",
- "plugin-rest-api",
- "protocol",
- "query-adapter",
- "realtime",
- "realtime-shared",
  "registry",
- "rest-server",
- "router",
- "storage",
- "versioning",
- "websocket"
+ "storage"
  ]
-}
+}

content/docs/references/automation/meta.json

@@ -1,18 +1,21 @@
 {
  "title": "Automation Protocol",
  "pages": [
- "approval",
- "bpmn-interop",
- "connector",
- "etl",
- "execution",
+ "---Flows & Execution---",
  "flow",
- "job",
+ "execution",
  "node-executor",
- "offline",
  "state-machine",
- "sync",
+ "bpmn-interop",
+ "---Triggers & Jobs---",
  "trigger-registry",
- "webhook"
+ "job",
+ "webhook",
+ "offline",
+ "---Workflows & Integration---",
+ "approval",
+ "etl",
+ "sync",
+ "connector"
  ]
-}
+}

content/docs/references/cloud/meta.json

@@ -1,18 +1,21 @@
 {
  "title": "Cloud Protocol",
  "pages": [
- "app-store",
- "developer-portal",
+ "---Environments---",
  "environment",
  "environment-artifact",
  "environment-package",
+ "provisioning",
+ "tenant",
+ "---Marketplace & Distribution---",
  "marketplace",
  "marketplace-admin",
+ "app-store",
+ "developer-portal",
+ "---Packages---",
  "package",
  "package-version",
- "plugin-security",
- "provisioning",
  "template-manifest",
- "tenant"
+ "plugin-security"
  ]
-}
+}

content/docs/references/data/meta.json

@@ -1,29 +1,35 @@
 {
  "title": "Data Protocol",
  "pages": [
+ "---Core Modeling---",
+ "object",
+ "field",
+ "validation",
+ "mapping",
+ "document",
+ "---Query & Filter---",
+ "query",
+ "filter",
+ "date-macros",
  "analytics",
+ "---Engine & Drivers---",
  "data-engine",
  "datasource",
- "date-macros",
- "document",
  "driver",
- "driver-nosql",
  "driver-sql",
- "external-catalog",
- "external-lookup",
- "feed",
- "field",
- "filter",
+ "driver-nosql",
+ "---Hooks & Lifecycle---",
  "hook",
  "hook-body",
- "mapping",
+ "subscription",
+ "feed",
  "notification",
- "object",
- "query",
+ "---External Data---",
+ "external-catalog",
+ "external-lookup",
  "search-engine",
+ "---Seeding---",
  "seed",
- "seed-loader",
- "subscription",
- "validation"
+ "seed-loader"
  ]
-}
+}

content/docs/references/kernel/meta.json

@@ -1,37 +1,42 @@
 {
  "title": "Kernel Protocol",
  "pages": [
- "cli-extension",
- "cluster",
+ "---Core Runtime---",
  "context",
- "dependency-resolution",
- "dev-plugin",
  "execution-context",
- "feature",
  "manifest",
- "metadata-customization",
- "metadata-loader",
- "metadata-persistence",
- "metadata-plugin",
- "metadata-protection",
+ "feature",
+ "service-registry",
+ "startup-orchestrator",
+ "cluster",
+ "state-machine",
+ "cli-extension",
+ "dev-plugin",
  "misc",
- "package-artifact",
- "package-registry",
- "package-upgrade",
+ "---Plugin Lifecycle---",
  "plugin",
- "plugin-capability",
- "plugin-lifecycle-advanced",
- "plugin-lifecycle-events",
+ "plugin-structure",
  "plugin-loading",
- "plugin-registry",
+ "plugin-lifecycle-events",
+ "plugin-lifecycle-advanced",
  "plugin-runtime",
+ "plugin-registry",
+ "plugin-capability",
+ "---Plugin Security & Validation---",
  "plugin-security",
  "plugin-security-advanced",
- "plugin-structure",
  "plugin-validator",
  "plugin-versioning",
- "service-registry",
- "startup-orchestrator",
- "state-machine"
+ "---Dependencies & Packages---",
+ "dependency-resolution",
+ "package-artifact",
+ "package-registry",
+ "package-upgrade",
+ "---Metadata---",
+ "metadata-loader",
+ "metadata-persistence",
+ "metadata-plugin",
+ "metadata-customization",
+ "metadata-protection"
  ]
-}
+}

content/docs/references/system/meta.json

@@ -1,44 +1,51 @@
 {
  "title": "System Protocol",
  "pages": [
- "app-install",
- "audit",
- "auth-config",
- "cache",
- "change-management",
- "collaboration",
- "compliance",
+ "---Runtime & Services---",
  "core-services",
- "deploy-bundle",
- "disaster-recovery",
- "email-config",
- "email-template",
- "encryption",
- "environment-artifact",
  "http-server",
- "incident-response",
+ "worker",
  "job",
- "license",
- "logging",
- "masking",
  "message-queue",
+ "cache",
+ "search-engine",
+ "object-storage",
+ "---Observability---",
+ "logging",
+ "metrics",
+ "tracing",
+ "audit",
+ "---Metadata & Migration---",
  "metadata-loader",
  "metadata-persistence",
- "metrics",
  "migration",
- "notification",
- "object-storage",
- "provisioning",
- "registry-config",
- "search-engine",
+ "change-management",
+ "---Security & Compliance---",
+ "auth-config",
  "security-context",
- "settings-client",
- "settings-manifest",
+ "encryption",
+ "masking",
+ "compliance",
  "supplier-security",
+ "---Tenancy & Provisioning---",
  "tenant",
- "tracing",
- "training",
+ "provisioning",
+ "app-install",
+ "license",
+ "registry-config",
+ "settings-manifest",
+ "settings-client",
+ "---Deployment & Operations---",
+ "deploy-bundle",
+ "environment-artifact",
+ "disaster-recovery",
+ "incident-response",
+ "---Communication & Localization---",
+ "notification",
+ "email-config",
+ "email-template",
+ "collaboration",
  "translation",
- "worker"
+ "training"
  ]
-}
+}