hotlong · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026
diff --git a/content/docs/references/auth/role/Role.mdx b/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 |  |
diff --git a/content/docs/references/automation/webhook/Webhook.mdx b/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 |

diff --git a/content/docs/references/automation/webhook/WebhookReceiver.mdx b/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 |  |

diff --git a/content/docs/references/automation/workflow/WorkflowRule.mdx b/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. |

diff --git a/content/docs/references/data/field/SelectOption.mdx b/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 |
diff --git a/content/docs/references/permission/permission/PermissionSet.mdx b/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 |

diff --git a/content/docs/references/permission/territory/Territory.mdx b/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 |

diff --git a/content/docs/references/shared/identifiers/EventName.mdx b/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)
+
diff --git a/content/docs/references/shared/identifiers/SnakeCaseIdentifier.mdx b/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)
+
diff --git a/content/docs/references/shared/identifiers/SystemIdentifier.mdx b/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)
+
diff --git a/content/docs/references/shared/identifiers/meta.json b/content/docs/references/shared/identifiers/meta.json
@@ -0,0 +1,3 @@
+{
+  "title": "Identifiers"
+}
diff --git a/content/docs/references/shared/meta.json b/content/docs/references/shared/meta.json
@@ -0,0 +1,6 @@
+{
+  "title": "Shared Protocol",
+  "pages": [
+    "identifiers"
+  ]
+}
diff --git a/content/docs/references/system/events/Event.mdx b/content/docs/references/system/events/Event.mdx
@@ -7,6 +7,6 @@ description: Event Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | Event name (snake_case with dots, e.g., user.created) |
+| **name** | `string` | ✅ | Event name (lowercase with dots, e.g., user.created, order.paid) |
 | **payload** | `any` | optional | Event payload schema |
 | **metadata** | `object` | ✅ | Event metadata |
diff --git a/content/docs/references/ui/action/Action.mdx b/content/docs/references/ui/action/Action.mdx
@@ -7,7 +7,7 @@ description: Action Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | Machine name (snake_case) |
+| **name** | `string` | ✅ | Machine name (lowercase 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 |

diff --git a/content/docs/references/ui/app/App.mdx b/content/docs/references/ui/app/App.mdx
@@ -7,7 +7,7 @@ description: App Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ | App unique machine name |
+| **name** | `string` | ✅ | App unique machine name (lowercase snake_case) |
 | **label** | `string` | ✅ | App display label |
 | **version** | `string` | optional | App version |
 | **description** | `string` | optional | App description |

diff --git a/content/docs/references/ui/app/DashboardNavItem.mdx b/content/docs/references/ui/app/DashboardNavItem.mdx
@@ -7,7 +7,7 @@ description: DashboardNavItem Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **id** | `string` | ✅ | Unique identifier for this navigation item |
+| **id** | `string` | ✅ | Unique identifier for this navigation item (lowercase snake_case) |
 | **label** | `string` | ✅ | Display proper label |
 | **icon** | `string` | optional | Icon name |
 | **visible** | `string` | optional | Visibility formula condition |

diff --git a/content/docs/references/ui/app/GroupNavItem.mdx b/content/docs/references/ui/app/GroupNavItem.mdx
@@ -7,7 +7,7 @@ description: GroupNavItem Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **id** | `string` | ✅ | Unique identifier for this navigation item |
+| **id** | `string` | ✅ | Unique identifier for this navigation item (lowercase snake_case) |
 | **label** | `string` | ✅ | Display proper label |
 | **icon** | `string` | optional | Icon name |
 | **visible** | `string` | optional | Visibility formula condition |

diff --git a/content/docs/references/ui/app/ObjectNavItem.mdx b/content/docs/references/ui/app/ObjectNavItem.mdx
@@ -7,7 +7,7 @@ description: ObjectNavItem Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **id** | `string` | ✅ | Unique identifier for this navigation item |
+| **id** | `string` | ✅ | Unique identifier for this navigation item (lowercase snake_case) |
 | **label** | `string` | ✅ | Display proper label |
 | **icon** | `string` | optional | Icon name |
 | **visible** | `string` | optional | Visibility formula condition |

diff --git a/content/docs/references/ui/app/PageNavItem.mdx b/content/docs/references/ui/app/PageNavItem.mdx
@@ -7,7 +7,7 @@ description: PageNavItem Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **id** | `string` | ✅ | Unique identifier for this navigation item |
+| **id** | `string` | ✅ | Unique identifier for this navigation item (lowercase snake_case) |
 | **label** | `string` | ✅ | Display proper label |
 | **icon** | `string` | optional | Icon name |
 | **visible** | `string` | optional | Visibility formula condition |

diff --git a/content/docs/references/ui/app/UrlNavItem.mdx b/content/docs/references/ui/app/UrlNavItem.mdx
@@ -7,7 +7,7 @@ description: UrlNavItem Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **id** | `string` | ✅ | Unique identifier for this navigation item |
+| **id** | `string` | ✅ | Unique identifier for this navigation item (lowercase snake_case) |
 | **label** | `string` | ✅ | Display proper label |
 | **icon** | `string` | optional | Icon name |
 | **visible** | `string` | optional | Visibility formula condition |

diff --git a/content/docs/references/ui/page/Page.mdx b/content/docs/references/ui/page/Page.mdx
@@ -7,7 +7,7 @@ description: Page Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | ✅ |  |
+| **name** | `string` | ✅ | Page unique name (lowercase snake_case) |
 | **label** | `string` | ✅ |  |
 | **description** | `string` | optional |  |
 | **type** | `Enum<'record' \| 'home' \| 'app' \| 'utility'>` | optional |  |

diff --git a/content/docs/references/ui/view/ListView.mdx b/content/docs/references/ui/view/ListView.mdx
@@ -7,7 +7,7 @@ description: ListView Schema Reference
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **name** | `string` | optional |  |
+| **name** | `string` | optional | Internal view name (lowercase snake_case) |
 | **label** | `string` | optional |  |
 | **type** | `Enum<'grid' \| 'kanban' \| 'calendar' \| 'gantt' \| 'map'>` | optional |  |
 | **data** | `object \| object \| object` | optional | Data source configuration (defaults to "object" provider) |

diff --git a/packages/spec/json-schema/auth/Role.json b/packages/spec/json-schema/auth/Role.json
@@ -6,8 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$",
-          "description": "Unique role name"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique role name (lowercase snake_case)"
         },
         "label": {
           "type": "string",

diff --git a/packages/spec/json-schema/automation/Webhook.json b/packages/spec/json-schema/automation/Webhook.json
@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Webhook unique name (lowercase snake_case)"
         },
         "label": {
           "type": "string"

diff --git a/packages/spec/json-schema/automation/WebhookReceiver.json b/packages/spec/json-schema/automation/WebhookReceiver.json
@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Webhook receiver unique name (lowercase snake_case)"
         },
         "path": {
           "type": "string",

diff --git a/packages/spec/json-schema/automation/WorkflowRule.json b/packages/spec/json-schema/automation/WorkflowRule.json
@@ -6,8 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$",
-          "description": "Unique workflow name"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique workflow name (lowercase snake_case)"
         },
         "objectName": {
           "type": "string",

diff --git a/packages/spec/json-schema/data/Field.json b/packages/spec/json-schema/data/Field.json
@@ -115,11 +115,13 @@
             "properties": {
               "label": {
                 "type": "string",
-                "description": "Display label"
+                "description": "Display label (human-readable, any case allowed)"
               },
               "value": {
                 "type": "string",
-                "description": "Stored value"
+                "minLength": 2,
+                "pattern": "^[a-z][a-z0-9_.]*$",
+                "description": "Stored value (lowercase machine identifier)"
               },
               "color": {
                 "type": "string",

diff --git a/packages/spec/json-schema/data/Object.json b/packages/spec/json-schema/data/Object.json
@@ -172,11 +172,13 @@
                   "properties": {
                     "label": {
                       "type": "string",
-                      "description": "Display label"
+                      "description": "Display label (human-readable, any case allowed)"
                     },
                     "value": {
                       "type": "string",
-                      "description": "Stored value"
+                      "minLength": 2,
+                      "pattern": "^[a-z][a-z0-9_.]*$",
+                      "description": "Stored value (lowercase machine identifier)"
                     },
                     "color": {
                       "type": "string",

diff --git a/packages/spec/json-schema/data/SelectOption.json b/packages/spec/json-schema/data/SelectOption.json
@@ -6,11 +6,13 @@
       "properties": {
         "label": {
           "type": "string",
-          "description": "Display label"
+          "description": "Display label (human-readable, any case allowed)"
         },
         "value": {
           "type": "string",
-          "description": "Stored value"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_.]*$",
+          "description": "Stored value (lowercase machine identifier)"
         },
         "color": {
           "type": "string",

diff --git a/packages/spec/json-schema/hub/ComposerResponse.json b/packages/spec/json-schema/hub/ComposerResponse.json
@@ -227,11 +227,13 @@
                                 "properties": {
                                   "label": {
                                     "type": "string",
-                                    "description": "Display label"
+                                    "description": "Display label (human-readable, any case allowed)"
                                   },
                                   "value": {
                                     "type": "string",
-                                    "description": "Stored value"
+                                    "minLength": 2,
+                                    "pattern": "^[a-z][a-z0-9_.]*$",
+                                    "description": "Stored value (lowercase machine identifier)"
                                   },
                                   "color": {
                                     "type": "string",

diff --git a/packages/spec/json-schema/kernel/Manifest.json b/packages/spec/json-schema/kernel/Manifest.json
@@ -221,11 +221,13 @@
                             "properties": {
                               "label": {
                                 "type": "string",
-                                "description": "Display label"
+                                "description": "Display label (human-readable, any case allowed)"
                               },
                               "value": {
                                 "type": "string",
-                                "description": "Stored value"
+                                "minLength": 2,
+                                "pattern": "^[a-z][a-z0-9_.]*$",
+                                "description": "Stored value (lowercase machine identifier)"
                               },
                               "color": {
                                 "type": "string",

diff --git a/packages/spec/json-schema/permission/PermissionSet.json b/packages/spec/json-schema/permission/PermissionSet.json
@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "Permission set unique name"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Permission set unique name (lowercase snake_case)"
         },
         "label": {
           "type": "string",

diff --git a/packages/spec/json-schema/permission/Territory.json b/packages/spec/json-schema/permission/Territory.json
@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Territory unique name (lowercase snake_case)"
         },
         "label": {
           "type": "string",

diff --git a/packages/spec/json-schema/shared/EventName.json b/packages/spec/json-schema/shared/EventName.json
@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/EventName",
+  "definitions": {
+    "EventName": {
+      "type": "string",
+      "minLength": 3,
+      "pattern": "^[a-z][a-z0-9_.]*$",
+      "description": "Event name (lowercase with dot notation for namespacing)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}
diff --git a/packages/spec/json-schema/shared/SnakeCaseIdentifier.json b/packages/spec/json-schema/shared/SnakeCaseIdentifier.json
@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/SnakeCaseIdentifier",
+  "definitions": {
+    "SnakeCaseIdentifier": {
+      "type": "string",
+      "minLength": 2,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Snake case identifier (lowercase with underscores only)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}
diff --git a/packages/spec/json-schema/shared/SystemIdentifier.json b/packages/spec/json-schema/shared/SystemIdentifier.json
@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/SystemIdentifier",
+  "definitions": {
+    "SystemIdentifier": {
+      "type": "string",
+      "minLength": 2,
+      "pattern": "^[a-z][a-z0-9_.]*$",
+      "description": "System identifier (lowercase with underscores or dots)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}
diff --git a/packages/spec/json-schema/system/Event.json b/packages/spec/json-schema/system/Event.json
@@ -6,8 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_.]*$",
-          "description": "Event name (snake_case with dots, e.g., user.created)"
+          "minLength": 3,
+          "pattern": "^[a-z][a-z0-9_.]*$",
+          "description": "Event name (lowercase with dots, e.g., user.created, order.paid)"
         },
         "payload": {
           "description": "Event payload schema"