Add schema reference documentation for various components

- Created documentation for NetworkPolicy, OIDCConfig, OWDModel, Object, ObjectCapabilities, ObjectNavItem, ObjectPermission, Page, PageComponent, PageNavItem, PageRegion, PasswordPolicy, PermissionSet, Plan, Policy, Query, RateLimit, Report, ReportChart, ReportColumn, ReportGrouping, ReportType, Role, SAMLConfig, ScriptValidation, SelectOption, SessionPolicy, SharingLevel, SharingRule, SharingRuleType, SortNode, StateMachineValidation, Territory, TerritoryModel, TerritoryType, TransformType, TranslationBundle, TranslationData, UniquenessValidation, UrlNavItem, ValidationRule, View, Webhook, WebhookReceiver, WebhookTriggerType, WorkflowAction, WorkflowRule, and WorkflowTriggerType.
- Implemented a script to automate the generation of markdown documentation from JSON schema files.

Author: hotlong

.github/copilot-instructions.md

@@ -4,6 +4,8 @@
 **Context:** You are defining the "DNA" and "Constitution" of a metadata-driven low-code platform.
 **Location:** `packages/spec` repository.
 
+Mission: Build the "Post-SaaS Operating System" — an open-core, local-first ecosystem that virtualizes data (SQL/Redis/Excel) and unifies business logic.
+
 **PRIME DIRECTIVES:**
 
 1. **Zod First:** ALL definitions must start with a **Zod Schema**. We need runtime validation for the CLI and JSON Schema generation for the IDE.

.github/prompts/schema.prompt.md

@@ -5,8 +5,6 @@
 **Location:** `packages/spec` repository.
 
 Mission: Build the "Post-SaaS Operating System" — an open-core, local-first ecosystem that virtualizes data (SQL/Redis/Excel) and unifies business logic.
-1. The "Galaxy" Architecture (Monorepo Structure)
-We use a Monorepo (pnpm + Turborepo) to manage the ecosystem, but components are designed to be published independently.
 Project & Responsibilities
  * packages/protocol (The Constitution) [Apache 2.0]
    * CRITICAL: Contains the shared manifest.schema.json, TypeScript interfaces, and plugin lifecycle hooks (onInstall, onEnable).

content/docs/references/AIKnowledge.mdx

@@ -0,0 +1,13 @@
+---
+title: AIKnowledge
+description: AIKnowledge Schema Reference
+---
+
+# AIKnowledge
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **topics** | `string[]` | ✅ | Topics/Tags to recruit knowledge from |
+| **indexes** | `string[]` | ✅ | Vector Store Indexes |

content/docs/references/AIModelConfig.mdx

@@ -0,0 +1,16 @@
+---
+title: AIModelConfig
+description: AIModelConfig Schema Reference
+---
+
+# AIModelConfig
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **provider** | `Enum<'openai' \| 'azure_openai' \| 'anthropic' \| 'local'>` | optional |  |
+| **model** | `string` | ✅ | Model name (e.g. gpt-4, claude-3-opus) |
+| **temperature** | `number` | optional |  |
+| **maxTokens** | `number` | optional |  |
+| **topP** | `number` | optional |  |

content/docs/references/AITool.mdx

@@ -0,0 +1,14 @@
+---
+title: AITool
+description: AITool Schema Reference
+---
+
+# AITool
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **type** | `Enum<'action' \| 'flow' \| 'query' \| 'vector_search'>` | ✅ |  |
+| **name** | `string` | ✅ | Reference name (Action Name, Flow Name) |
+| **description** | `string` | optional | Override description for the LLM |

content/docs/references/Action.mdx

@@ -0,0 +1,24 @@
+---
+title: Action
+description: Action Schema Reference
+---
+
+# Action
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Machine name (snake_case) |
+| **label** | `string` | ✅ | Display label |
+| **icon** | `string` | optional | Icon name |
+| **locations** | `Enum<'list_toolbar' \| 'list_item' \| 'record_header' \| 'record_more' \| 'record_related' \| 'global_nav'>[]` | optional | Locations where this action is visible |
+| **location** | `any` | optional |  |
+| **type** | `Enum<'script' \| 'url' \| 'modal' \| 'flow' \| 'api'>` | optional | Action functionality type |
+| **target** | `string` | optional | URL, Script Name, Flow ID, or API Endpoint |
+| **execute** | `string` | optional | Legacy execution logic |
+| **params** | `object[]` | optional | Input parameters required from user |
+| **confirmText** | `string` | optional | Confirmation message before execution |
+| **successMessage** | `string` | optional | Success message to show after execution |
+| **refreshAfter** | `boolean` | optional | Refresh view after execution |
+| **visible** | `string` | optional | Formula returning boolean |

content/docs/references/ActionParam.mdx

@@ -0,0 +1,16 @@
+---
+title: ActionParam
+description: ActionParam Schema Reference
+---
+
+# ActionParam
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ |  |
+| **label** | `string` | ✅ |  |
+| **type** | `Enum<'text' \| 'textarea' \| 'email' \| 'url' \| 'phone' \| 'password' \| 'markdown' \| 'html' \| 'number' \| 'currency' \| 'percent' \| 'date' \| 'datetime' \| 'time' \| 'boolean' \| 'select' \| 'multiselect' \| 'lookup' \| 'master_detail' \| 'image' \| 'file' \| 'avatar' \| 'formula' \| 'summary' \| 'autonumber'>` | ✅ |  |
+| **required** | `boolean` | optional |  |
+| **options** | `object[]` | optional |  |

content/docs/references/Agent.mdx

@@ -0,0 +1,21 @@
+---
+title: Agent
+description: Agent Schema Reference
+---
+
+# Agent
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Agent unique identifier |
+| **label** | `string` | ✅ | Agent display name |
+| **avatar** | `string` | optional |  |
+| **role** | `string` | ✅ | The persona/role (e.g. "Senior Support Engineer") |
+| **instructions** | `string` | ✅ | System Prompt / Prime Directives |
+| **model** | `object` | optional |  |
+| **tools** | `object[]` | optional | Available tools |
+| **knowledge** | `object` | optional | RAG access |
+| **active** | `boolean` | optional |  |
+| **access** | `string[]` | optional | Who can chat with this agent |

content/docs/references/ApiEndpoint.mdx

@@ -0,0 +1,24 @@
+---
+title: ApiEndpoint
+description: ApiEndpoint Schema Reference
+---
+
+# ApiEndpoint
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Unique endpoint ID |
+| **path** | `string` | ✅ | URL Path (e.g. /api/v1/customers) |
+| **method** | `Enum<'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'PATCH'>` | ✅ | HTTP Method |
+| **summary** | `string` | optional |  |
+| **description** | `string` | optional |  |
+| **type** | `Enum<'flow' \| 'script' \| 'object_operation' \| 'proxy'>` | ✅ | Implementation type |
+| **target** | `string` | ✅ | Target Flow ID, Script Name, or Proxy URL |
+| **objectParams** | `object` | optional | For object_operation type |
+| **inputMapping** | `object[]` | optional | Map Request Body to Internal Params |
+| **outputMapping** | `object[]` | optional | Map Internal Result to Response Body |
+| **authRequired** | `boolean` | optional | Require authentication |
+| **rateLimit** | `object` | optional | Rate limiting policy |
+| **cacheTtl** | `number` | optional | Response cache TTL in seconds |

content/docs/references/ApiMapping.mdx

@@ -0,0 +1,14 @@
+---
+title: ApiMapping
+description: ApiMapping Schema Reference
+---
+
+# ApiMapping
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **source** | `string` | ✅ | Source field/path |
+| **target** | `string` | ✅ | Target field/path |
+| **transform** | `string` | optional | Transformation function name |