Merge branch 'main' of https://github.com/objectstack-ai/spec

Author: hotlong

content/docs/references/auth/role/Role.mdx

@@ -7,7 +7,7 @@ description: Role Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | Unique role name |
+| **name** | `string` | ✅ | Unique role name (lowercase snake_case) |
 | **label** | `string` | ✅ | Display label (e.g. VP of Sales) |
 | **parent** | `string` | optional | Parent Role ID (Reports To) |
 | **description** | `string` | optional |  |

content/docs/references/automation/webhook/Webhook.mdx

@@ -7,7 +7,7 @@ description: Webhook Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ |  |
+| **name** | `string` | ✅ | Webhook unique name (lowercase snake_case) |
 | **label** | `string` | optional |  |
 | **object** | `string` | ✅ | Object to listen to |
 | **triggers** | `Enum<'create' \| 'update' \| 'delete' \| 'undelete' \| 'api'>[]` | ✅ | Events that trigger execution |

content/docs/references/automation/webhook/WebhookReceiver.mdx

@@ -7,7 +7,7 @@ description: WebhookReceiver Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ |  |
+| **name** | `string` | ✅ | Webhook receiver unique name (lowercase snake_case) |
 | **path** | `string` | ✅ | URL Path (e.g. /webhooks/stripe) |
 | **verificationType** | `Enum<'none' \| 'header_token' \| 'hmac' \| 'ip_whitelist'>` | optional |  |
 | **verificationParams** | `object` | optional |  |

content/docs/references/automation/workflow/WorkflowRule.mdx

@@ -7,7 +7,7 @@ description: WorkflowRule Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | Unique workflow name |
+| **name** | `string` | ✅ | Unique workflow name (lowercase snake_case) |
 | **objectName** | `string` | ✅ | Target Object |
 | **triggerType** | `Enum<'on_create' \| 'on_update' \| 'on_create_or_update' \| 'on_delete' \| 'schedule'>` | ✅ | When to evaluate |
 | **criteria** | `string` | optional | Formula condition. If TRUE, actions execute. |

content/docs/references/data/field/SelectOption.mdx

@@ -7,7 +7,7 @@ description: SelectOption Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **label** | `string` | ✅ | Display label |
-| **value** | `string` | ✅ | Stored value |
+| **label** | `string` | ✅ | Display label (human-readable, any case allowed) |
+| **value** | `string` | ✅ | Stored value (lowercase machine identifier) |
 | **color** | `string` | optional | Color code for badges/charts |
 | **default** | `boolean` | optional | Is default option |

content/docs/references/permission/permission/PermissionSet.mdx

@@ -7,7 +7,7 @@ description: PermissionSet Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | Permission set unique name |
+| **name** | `string` | ✅ | Permission set unique name (lowercase snake_case) |
 | **label** | `string` | optional | Display label |
 | **isProfile** | `boolean` | optional | Whether this is a user profile |
 | **objects** | `Record<string, object>` | ✅ | Entity permissions |

content/docs/references/permission/territory/Territory.mdx

@@ -7,7 +7,7 @@ description: Territory Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ |  |
+| **name** | `string` | ✅ | Territory unique name (lowercase snake_case) |
 | **label** | `string` | ✅ | Territory Label (e.g. "West Coast") |
 | **modelId** | `string` | ✅ | Belongs to which Territory Model |
 | **parent** | `string` | optional | Parent Territory |

content/docs/references/shared/identifiers/EventName.mdx

@@ -0,0 +1,7 @@
+---
+title: EventName
+description: Event name (lowercase with dot notation for namespacing)
+---
+
+Event name (lowercase with dot notation for namespacing)
+

content/docs/references/shared/identifiers/SnakeCaseIdentifier.mdx

@@ -0,0 +1,7 @@
+---
+title: SnakeCaseIdentifier
+description: Snake case identifier (lowercase with underscores only)
+---
+
+Snake case identifier (lowercase with underscores only)
+

content/docs/references/shared/identifiers/SystemIdentifier.mdx

@@ -0,0 +1,7 @@
+---
+title: SystemIdentifier
+description: System identifier (lowercase with underscores or dots)
+---
+
+System identifier (lowercase with underscores or dots)
+