Add critical protocol definitions: Field Widget, Plugin Lifecycle, Driver Interface, and Trigger Context

content/docs/references/data/Trigger.mdx

@@ -0,0 +1,16 @@
+---
+title: Trigger
+description: Trigger Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Trigger name (snake_case) |
+| **object** | `string` | ✅ | Target object name |
+| **timing** | `Enum<'before' \| 'after'>` | ✅ | Execution timing |
+| **action** | `Enum<'insert' \| 'update' \| 'delete'> \| Enum<'insert' \| 'update' \| 'delete'>[]` | ✅ | Database operation(s) to trigger on |
+| **description** | `string` | optional | Trigger description |
+| **active** | `boolean` | optional | Is trigger active |
+| **order** | `number` | optional | Execution order |

content/docs/references/data/TriggerAction.mdx

@@ -0,0 +1,10 @@
+---
+title: TriggerAction
+description: TriggerAction Schema Reference
+---
+
+## Allowed Values
+
+* `insert`
+* `update`
+* `delete`

content/docs/references/data/TriggerContext.mdx

@@ -0,0 +1,17 @@
+---
+title: TriggerContext
+description: TriggerContext Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **action** | `Enum<'insert' \| 'update' \| 'delete'>` | ✅ | Database operation type |
+| **timing** | `Enum<'before' \| 'after'>` | ✅ | Trigger execution timing |
+| **doc** | `Record<string, any>` | ✅ | Current document/record |
+| **previousDoc** | `Record<string, any>` | optional | Previous document state |
+| **userId** | `string` | ✅ | Current user ID |
+| **user** | `Record<string, any>` | ✅ | Current user record |
+| **ql** | `any` | optional | ObjectQL data access API |
+| **logger** | `any` | optional | Logging interface |

content/docs/references/data/TriggerTiming.mdx

@@ -0,0 +1,9 @@
+---
+title: TriggerTiming
+description: TriggerTiming Schema Reference
+---
+
+## Allowed Values
+
+* `before`
+* `after`

content/docs/references/system/DriverCapabilities.mdx

@@ -0,0 +1,14 @@
+---
+title: DriverCapabilities
+description: DriverCapabilities Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **transactions** | `boolean` | ✅ | Supports transactions |
+| **joins** | `boolean` | ✅ | Supports SQL joins |
+| **fullTextSearch** | `boolean` | ✅ | Supports full-text search |
+| **jsonFields** | `boolean` | ✅ | Supports JSON field types |
+| **arrayFields** | `boolean` | ✅ | Supports array field types |

content/docs/references/system/DriverInterface.mdx

@@ -0,0 +1,12 @@
+---
+title: DriverInterface
+description: DriverInterface Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Driver name |
+| **version** | `string` | ✅ | Driver version |
+| **supports** | `object` | ✅ | Driver capabilities |

content/docs/references/system/Plugin.mdx

@@ -0,0 +1,11 @@
+---
+title: Plugin
+description: Plugin Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **id** | `string` | optional | Plugin identifier |
+| **version** | `string` | optional | Plugin version |

content/docs/references/system/PluginContext.mdx

@@ -0,0 +1,14 @@
+---
+title: PluginContext
+description: PluginContext Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **ql** | `any` | optional | ObjectQL data access API |
+| **os** | `any` | optional | ObjectOS system API |
+| **logger** | `any` | optional | Logging interface |
+| **metadata** | `any` | optional | Metadata registry |
+| **events** | `any` | optional | Event bus |

content/docs/references/system/PluginLifecycle.mdx

@@ -0,0 +1,9 @@
+---
+title: PluginLifecycle
+description: PluginLifecycle Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |

content/docs/references/ui/FieldWidgetProps.mdx

@@ -0,0 +1,16 @@
+---
+title: FieldWidgetProps
+description: FieldWidgetProps Schema Reference
+---
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **value** | `any` | optional | Current field value |
+| **readonly** | `boolean` | optional | Read-only mode flag |
+| **required** | `boolean` | optional | Required field flag |
+| **error** | `string` | optional | Validation error message |
+| **field** | `object` | ✅ | Field schema definition |
+| **record** | `Record<string, any>` | optional | Complete record data |
+| **options** | `Record<string, any>` | optional | Custom widget options |

packages/spec/json-schema/DriverCapabilities.json

@@ -0,0 +1,39 @@
+{
+  "$ref": "#/definitions/DriverCapabilities",
+  "definitions": {
+    "DriverCapabilities": {
+      "type": "object",
+      "properties": {
+        "transactions": {
+          "type": "boolean",
+          "description": "Supports transactions"
+        },
+        "joins": {
+          "type": "boolean",
+          "description": "Supports SQL joins"
+        },
+        "fullTextSearch": {
+          "type": "boolean",
+          "description": "Supports full-text search"
+        },
+        "jsonFields": {
+          "type": "boolean",
+          "description": "Supports JSON field types"
+        },
+        "arrayFields": {
+          "type": "boolean",
+          "description": "Supports array field types"
+        }
+      },
+      "required": [
+        "transactions",
+        "joins",
+        "fullTextSearch",
+        "jsonFields",
+        "arrayFields"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

packages/spec/json-schema/DriverInterface.json

@@ -0,0 +1,59 @@
+{
+  "$ref": "#/definitions/DriverInterface",
+  "definitions": {
+    "DriverInterface": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Driver name"
+        },
+        "version": {
+          "type": "string",
+          "description": "Driver version"
+        },
+        "supports": {
+          "type": "object",
+          "properties": {
+            "transactions": {
+              "type": "boolean",
+              "description": "Supports transactions"
+            },
+            "joins": {
+              "type": "boolean",
+              "description": "Supports SQL joins"
+            },
+            "fullTextSearch": {
+              "type": "boolean",
+              "description": "Supports full-text search"
+            },
+            "jsonFields": {
+              "type": "boolean",
+              "description": "Supports JSON field types"
+            },
+            "arrayFields": {
+              "type": "boolean",
+              "description": "Supports array field types"
+            }
+          },
+          "required": [
+            "transactions",
+            "joins",
+            "fullTextSearch",
+            "jsonFields",
+            "arrayFields"
+          ],
+          "additionalProperties": false,
+          "description": "Driver capabilities"
+        }
+      },
+      "required": [
+        "name",
+        "version",
+        "supports"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}