fix: ensure category directories exist before writing index.mdx and run gen:schema before gen:docs

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

apps/docs/package.json

@@ -6,7 +6,7 @@
   "license": "Apache-2.0",
   "scripts": {
     "dev": "next dev",
-    "build": "pnpm --filter @objectstack/spec gen:docs && next build",
+    "build": "pnpm --filter @objectstack/spec gen:schema && pnpm --filter @objectstack/spec gen:docs && next build",
     "site:start": "next start",
     "site:lint": "next lint"
   },

content/docs/references/ai/mcp.mdx

@@ -0,0 +1,149 @@
+---
+title: Mcp
+description: Mcp protocol schemas
+---
+
+Model Context Protocol (MCP)
+
+Defines the protocol for connecting AI assistants to external tools, data sources,
+
+and resources. MCP enables AI models to access contextual information, invoke
+
+functions, and interact with external systems in a standardized way.
+
+Architecture Alignment:
+
+- Anthropic Model Context Protocol (MCP)
+
+- OpenAI Function Calling / Tools
+
+- LangChain Tool Interface
+
+- Microsoft Semantic Kernel Plugins
+
+Use Cases:
+
+- Connect AI agents to ObjectStack data (Objects, Views, Reports)
+
+- Expose business logic as callable tools (Workflows, Flows, Actions)
+
+- Provide dynamic context to AI models (User profile, Recent activity)
+
+- Enable AI to read and modify data through standardized interfaces
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/mcp.zod.ts`
+</Callout>
+
+## TypeScript Usage
+
+```typescript
+import { MCPCapability, MCPClientConfig, MCPPrompt, MCPPromptArgument, MCPPromptMessage, MCPPromptRequest, MCPPromptResponse, MCPResource, MCPResourceRequest, MCPResourceResponse, MCPResourceTemplate, MCPResourceType, MCPServerConfig, MCPServerInfo, MCPTool, MCPToolCallRequest, MCPToolCallResponse, MCPToolParameter, MCPTransportConfig, MCPTransportType } from '@objectstack/spec/ai';
+import type { MCPCapability, MCPClientConfig, MCPPrompt, MCPPromptArgument, MCPPromptMessage, MCPPromptRequest, MCPPromptResponse, MCPResource, MCPResourceRequest, MCPResourceResponse, MCPResourceTemplate, MCPResourceType, MCPServerConfig, MCPServerInfo, MCPTool, MCPToolCallRequest, MCPToolCallResponse, MCPToolParameter, MCPTransportConfig, MCPTransportType } from '@objectstack/spec/ai';
+
+// Validate data
+const result = MCPCapability.parse(data);
+```
+
+---
+
+## MCPCapability
+
+
+---
+
+## MCPClientConfig
+
+
+---
+
+## MCPPrompt
+
+
+---
+
+## MCPPromptArgument
+
+
+---
+
+## MCPPromptMessage
+
+
+---
+
+## MCPPromptRequest
+
+
+---
+
+## MCPPromptResponse
+
+
+---
+
+## MCPResource
+
+
+---
+
+## MCPResourceRequest
+
+
+---
+
+## MCPResourceResponse
+
+
+---
+
+## MCPResourceTemplate
+
+
+---
+
+## MCPResourceType
+
+
+---
+
+## MCPServerConfig
+
+
+---
+
+## MCPServerInfo
+
+
+---
+
+## MCPTool
+
+
+---
+
+## MCPToolCallRequest
+
+
+---
+
+## MCPToolCallResponse
+
+
+---
+
+## MCPToolParameter
+
+
+---
+
+## MCPTransportConfig
+
+
+---
+
+## MCPTransportType
+
+
+---
+

content/docs/references/api/dispatcher.mdx

@@ -0,0 +1,55 @@
+---
+title: Dispatcher
+description: Dispatcher protocol schemas
+---
+
+# HttpDispatcher Protocol
+
+Defines how the ObjectStack HttpDispatcher routes incoming API requests
+
+to the correct kernel service based on URL prefix matching.
+
+The dispatcher is the central routing component that:
+
+1. Matches incoming request URLs against registered route prefixes
+
+2. Delegates to the corresponding CoreService implementation
+
+3. Returns 503 Service Unavailable when a service is not registered
+
+4. Supports dynamic route registration from plugins via contributes.routes
+
+Architecture alignment:
+
+- Kubernetes: API server aggregation layer
+
+- Eclipse: Extension registry routing
+
+- VS Code: Command palette routing
+
+<Callout type="info">
+**Source:** `packages/spec/src/api/dispatcher.zod.ts`
+</Callout>
+
+## TypeScript Usage
+
+```typescript
+import { DispatcherConfig, DispatcherRoute } from '@objectstack/spec/api';
+import type { DispatcherConfig, DispatcherRoute } from '@objectstack/spec/api';
+
+// Validate data
+const result = DispatcherConfig.parse(data);
+```
+
+---
+
+## DispatcherConfig
+
+
+---
+
+## DispatcherRoute
+
+
+---
+

content/docs/references/api/object.mdx

@@ -0,0 +1,26 @@
+---
+title: Object
+description: Object protocol schemas
+---
+
+<Callout type="info">
+**Source:** `packages/spec/src/api/object.zod.ts`
+</Callout>
+
+## TypeScript Usage
+
+```typescript
+import { VersioningConfig } from '@objectstack/spec/api';
+import type { VersioningConfig } from '@objectstack/spec/api';
+
+// Validate data
+const result = VersioningConfig.parse(data);
+```
+
+---
+
+## VersioningConfig
+
+
+---
+