docs: regenerate references from current spec (#1908)

The committed content/docs/references/** had drifted from packages/spec —
running `gen:docs` produced diffs across 18 generated files and 3 missing ones
(contracts/, system/book.mdx, system/doc.mdx for newly-added spec types). This
regenerates them so the generated reference docs match the schemas again.

Spec additions now reflected: UserFilters/UserFilterField view config, the
`chart` visualization enum value, the ADR-0046 doc/book package-doc protocols,
and the contracts reference group.

Generated output only (DO-NOT-EDIT files) — no hand-written docs or package code
touched. `next build` compiles all 1113 pages clean.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: os-zhuang

.changeset/regenerate-references.md

@@ -0,0 +1,4 @@
+---
+---
+
+docs: regenerate `content/docs/references/**` from current `packages/spec` schemas. Picks up spec additions that had drifted out of the committed generated docs — new `UserFilters`/`UserFilterField` view types, the `chart` visualization enum value, the ADR-0046 `doc`/`book` package-doc protocols, and the `contracts/` reference group. Generated output only; no package version impact.

content/docs/references/ai/meta.json

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

content/docs/references/api/meta.json

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

content/docs/references/api/metadata.mdx

@@ -314,7 +314,7 @@ Metadata query with filtering, sorting, and pagination
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **types** | `Enum<'object' \| 'field' \| 'trigger' \| 'validation' \| 'hook' \| 'seed' \| 'view' \| 'page' \| 'dashboard' \| 'app' \| 'action' \| 'report' \| 'dataset' \| 'flow' \| 'job' \| 'datasource' \| 'external_catalog' \| 'translation' \| 'router' \| 'function' \| 'service' \| 'email_template' \| 'permission' \| 'profile' \| 'role' \| 'agent' \| 'tool' \| 'skill'>[]` | optional | Filter by metadata types |
+| **types** | `Enum<'object' \| 'field' \| 'trigger' \| 'validation' \| 'hook' \| 'seed' \| 'view' \| 'page' \| 'dashboard' \| 'app' \| 'action' \| 'report' \| 'dataset' \| 'flow' \| 'job' \| 'datasource' \| 'external_catalog' \| 'translation' \| 'router' \| 'function' \| 'service' \| 'email_template' \| 'doc' \| 'book' \| 'permission' \| 'profile' \| 'role' \| 'agent' \| 'tool' \| 'skill'>[]` | optional | Filter by metadata types |
 | **namespaces** | `string[]` | optional | Filter by namespaces |
 | **packageId** | `string` | optional | Filter by owning package |
 | **search** | `string` | optional | Full-text search query |
@@ -349,7 +349,7 @@ Metadata query with filtering, sorting, and pagination
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **type** | `Enum<'object' \| 'field' \| 'trigger' \| 'validation' \| 'hook' \| 'seed' \| 'view' \| 'page' \| 'dashboard' \| 'app' \| 'action' \| 'report' \| 'dataset' \| 'flow' \| 'job' \| 'datasource' \| 'external_catalog' \| 'translation' \| 'router' \| 'function' \| 'service' \| 'email_template' \| 'permission' \| 'profile' \| 'role' \| 'agent' \| 'tool' \| 'skill'>` | ✅ | Metadata type |
+| **type** | `Enum<'object' \| 'field' \| 'trigger' \| 'validation' \| 'hook' \| 'seed' \| 'view' \| 'page' \| 'dashboard' \| 'app' \| 'action' \| 'report' \| 'dataset' \| 'flow' \| 'job' \| 'datasource' \| 'external_catalog' \| 'translation' \| 'router' \| 'function' \| 'service' \| 'email_template' \| 'doc' \| 'book' \| 'permission' \| 'profile' \| 'role' \| 'agent' \| 'tool' \| 'skill'>` | ✅ | Metadata type |
 | **name** | `string` | ✅ | Item name (snake_case) |
 | **data** | `Record<string, any>` | ✅ | Metadata payload |
 | **namespace** | `string` | optional | Optional namespace |

content/docs/references/automation/approval.mdx

@@ -71,6 +71,7 @@ const result = ApprovalDecision.parse(data);
 | **lockRecord** | `boolean` | ✅ | Lock the record from editing while pending |
 | **approvalStatusField** | `string` | optional | Business-object field to mirror request status onto |
 | **escalation** | `Object` | optional | Per-node SLA escalation |
+| **maxRevisions** | `integer` | ✅ | Max send-backs for revision before auto-reject (0 = send-back disabled) |
 
 
 ---

content/docs/references/automation/meta.json

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

content/docs/references/automation/node-executor.mdx

@@ -76,6 +76,7 @@ Canonical cross-paradigm action/node descriptor (ADR-0018)
 | **supportsRetry** | `boolean` | ✅ | Supports retry on failure |
 | **needsOutbox** | `boolean` | ✅ | Dispatch via service-messaging outbox (retry/idempotency/dead-letter) |
 | **isAsync** | `boolean` | ✅ | Suspends the flow awaiting an external reply |
+| **maturity** | `Enum<'ga' \| 'beta' \| 'reserved'>` | ✅ | Runtime maturity: ga (shipped), beta, or reserved (contract only — designers grey this out) |
 | **source** | `Enum<'builtin' \| 'plugin'>` | ✅ | builtin = platform baseline; plugin = third-party contributed |
 | **deprecated** | `boolean` | ✅ | Deprecated alias kept for back-compat |
 | **aliasOf** | `string` | optional | Canonical type this alias forwards to |

content/docs/references/cloud/meta.json

@@ -1,21 +1,18 @@
 {
   "title": "Cloud Protocol",
   "pages": [
-    "---Environments---",
+    "app-store",
+    "developer-portal",
     "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",
-    "plugin-security"
+    "tenant"
   ]
-}
+}

content/docs/references/contracts/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Contracts Protocol",
+  "pages": []
+}

content/docs/references/data/meta.json

@@ -1,35 +1,29 @@
 {
   "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-sql",
     "driver-nosql",
-    "---Hooks & Lifecycle---",
+    "driver-sql",
+    "external-catalog",
+    "external-lookup",
+    "feed",
+    "field",
+    "filter",
     "hook",
     "hook-body",
-    "subscription",
-    "feed",
+    "mapping",
     "notification",
-    "---External Data---",
-    "external-catalog",
-    "external-lookup",
+    "object",
+    "query",
     "search-engine",
-    "---Seeding---",
     "seed",
-    "seed-loader"
+    "seed-loader",
+    "subscription",
+    "validation"
   ]
-}
+}