@objectql/create 4.0.1 → 4.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/create",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "description": "Create ObjectQL apps with one command",
   "bin": {
     "create-objectql": "./dist/bin.js"

package/templates/enterprise/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @objectql/starter-enterprise
 
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectql/core@4.0.2
+  - @objectql/driver-sql@4.0.2
+  - @objectql/platform-node@4.0.2
+  - @objectql/types@4.0.2
+
 ## 4.0.1
 
 ### Patch Changes

package/templates/enterprise/README.md

@@ -81,7 +81,7 @@ src/
 │       └── index.ts
 │
 ├── extensions/               # Custom Extensions/Overrides
-│   ├── user.extension.object.yml
+│   ├── user_extension.object.yml
 │   └── README.md
 │
 ├── shared/                   # Shared Utilities
@@ -251,7 +251,7 @@ fields:
   email: { type: text }
 ```
 
-**Extension** (`extensions/user.extension.object.yml`):
+**Extension** (`extensions/user_extension.object.yml`):
 ```yaml
 name: user  # Same name triggers merge
 fields:

package/templates/enterprise/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/example-enterprise-erp",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "description": "ObjectQL Enterprise Example - CRM & HR Demo",
   "private": true,
   "keywords": [
@@ -43,7 +43,7 @@
     "@objectql/cli": "workspace:*",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
-    "@objectstack/spec": "^0.3.1",
+    "@objectstack/spec": "^0.3.3",
     "@types/jest": "^30.0.0",
     "@types/node": "^20.0.0",
     "jest": "^30.2.0",

package/templates/enterprise/src/core/attachment.object.yml

@@ -1,8 +1,17 @@
-name: attachment
+# File: attachment.object.yml
+# Object name is inferred from filename as 'attachment'
 label: Attachment
 description: File attachment for any object
 icon: attachment-line
 
+ai_context:
+  intent: "Manage file attachments linked to any record type"
+  domain: file_management
+  common_queries:
+    - "Find attachments for a specific record"
+    - "List recent uploads by user"
+    - "Filter by file type"
+
 fields:
   name:
     type: text

package/templates/enterprise/src/core/organization.object.yml

@@ -1,40 +1,67 @@
-name: organization
+# File: organization.object.yml
+# Object name is inferred from filename as 'organization'
 label: Organization
 description: Company or organization entity
 icon: building-line
 
+ai_context:
+  intent: "Define organizational hierarchy and structure"
+  domain: organizational_management
+  aliases: [company, org, department, team]
+  common_queries:
+    - "Show organization hierarchy"
+    - "Find active departments"
+    - "List teams under a parent org"
+
 fields:
   name:
     type: text
     required: true
     label: Organization Name
     index: true
+    ai_context:
+      intent: "Primary identifier for the organization"
   
   code:
     type: text
     label: Organization Code
     unique: true
     index: true
+    ai_context:
+      intent: "Unique code for system identification"
   
   type:
     type: select
+    label: Organization Type
     options:
-      - enterprise
-      - department
-      - team
+      - label: Enterprise
+        value: enterprise
+      - label: Department
+        value: department
+      - label: Team
+        value: team
     defaultValue: enterprise
     index: true
+    ai_context:
+      intent: "Classify organizational unit level"
+      is_state_machine: false
   
   parent:
     type: lookup
     reference_to: organization
     label: Parent Organization
     index: true
+    ai_context:
+      intent: "Define hierarchical organization structure"
+      semantic_type: hierarchy
   
   manager:
     type: lookup
     reference_to: user
     label: Manager
+    ai_context:
+      intent: "Organization leader or manager"
+      semantic_type: ownership
   
   description:
     type: textarea
@@ -62,11 +89,19 @@ fields:
   
   status:
     type: select
+    label: Status
     options:
-      - active
-      - inactive
+      - label: Active
+        value: active
+      - label: Inactive
+        value: inactive
     defaultValue: active
     index: true
+    ai_context:
+      intent: "Track organization operational status"
+      transitions:
+        active: [inactive]
+        inactive: [active]
 
 indexes:
   # For org tree queries

package/templates/enterprise/src/core/user.object.yml

@@ -1,4 +1,5 @@
-name: user
+# File: user.object.yml
+# Object name is inferred from filename as 'user'
 label: User
 description: System user with authentication and profile
 icon: user-line
@@ -35,21 +36,39 @@ fields:
   
   status:
     type: select
+    label: User Status
     options:
-      - active
-      - inactive
-      - suspended
+      - label: Active
+        value: active
+      - label: Inactive
+        value: inactive
+      - label: Suspended
+        value: suspended
     defaultValue: active
     index: true
+    ai_context:
+      intent: "Track user account status"
+      is_state_machine: true
+      transitions:
+        active: [inactive, suspended]
+        inactive: [active]
+        suspended: [active, inactive]
   
   role:
     type: select
+    label: User Role
     options:
-      - admin
-      - user
-      - guest
+      - label: Administrator
+        value: admin
+      - label: User
+        value: user
+      - label: Guest
+        value: guest
     defaultValue: user
     index: true
+    ai_context:
+      intent: "Define user permissions level"
+      selection_guidance: "Admin for full access; User for standard access; Guest for read-only"
   
   last_login_at:
     type: datetime
@@ -57,13 +76,19 @@ fields:
   
   locale:
     type: select
+    label: Preferred Language
     options:
-      - en
-      - zh-CN
-      - ja
-      - es
+      - label: English
+        value: en
+      - label: Chinese (Simplified)
+        value: zh-CN
+      - label: Japanese
+        value: ja
+      - label: Spanish
+        value: es
     defaultValue: en
-    label: Preferred Language
+    ai_context:
+      intent: "User interface language preference"
   
   timezone:
     type: text

package/templates/enterprise/src/extensions/README.md

@@ -8,7 +8,7 @@ Extensions use ObjectQL's **Schema Merging** feature. When you define an object
 
 ## Example: Extending the User Object
 
-The `user.extension.object.yml` file extends the core `user` object with company-specific customizations:
+The `user_extension.object.yml` file extends the core `user` object with company-specific customizations:
 
 1. **Adding fields** - Links to employee record, office location
 2. **Overriding properties** - Making email required and unique
@@ -30,12 +30,12 @@ The `user.extension.object.yml` file extends the core `user` object with company
 ## File Naming Convention
 
 ```
-[object_name].extension.object.yml
+[object_name]_extension.object.yml
 ```
 
 Examples:
-- `user.extension.object.yml` - Extends the `user` object
-- `organization.extension.object.yml` - Extends the `organization` object
+- `user_extension.object.yml` - Extends the `user` object
+- `organization_extension.object.yml` - Extends the `organization` object
 
 ## Loading Order
 

package/templates/enterprise/src/extensions/user_extension.object.yml

@@ -0,0 +1,65 @@
+# File: user_extension.object.yml
+# Explicitly set name to 'user' to extend the core user object
+# This extends the core user object with company-specific fields
+name: user
+label: System User (Extended)
+
+ai_context:
+  intent: "Extend base user with enterprise-specific fields"
+  extends: user
+  domain: hr_management
+
+fields:
+  # Add employee link
+  employee:
+    type: lookup
+    reference_to: hr_employee
+    label: Employee Record
+    unique: true
+    ai_context:
+      intent: "Link user account to HR employee record"
+      semantic_type: association
+  
+  # Override email to make it required and unique
+  email:
+    required: true
+    unique: true
+  
+  # Add custom fields
+  employee_id:
+    type: text
+    label: Employee ID
+    unique: true
+    index: true
+    ai_context:
+      intent: "Corporate employee identifier"
+  
+  department:
+    type: lookup
+    reference_to: hr_department
+    label: Department
+    ai_context:
+      intent: "User's organizational department"
+      semantic_type: hierarchy
+  
+  office_location:
+    type: select
+    label: Office Location
+    options:
+      - label: Headquarters
+        value: headquarters
+      - label: Branch Office A
+        value: branch_office_a
+      - label: Branch Office B
+        value: branch_office_b
+      - label: Remote
+        value: remote
+    ai_context:
+      intent: "Physical or remote work location"
+  
+  two_factor_enabled:
+    type: boolean
+    defaultValue: false
+    label: Two-Factor Auth Enabled
+    ai_context:
+      intent: "Security enhancement status"

package/templates/enterprise/src/modules/crm/crm_account.object.yml

@@ -1,13 +1,26 @@
+# File: crm_account.object.yml
+# Object name is inferred from filename as 'crm_account'
 label: Account
 description: Customer company or organization
 icon: briefcase-line
 
+ai_context:
+  intent: "Manage customer and prospect organizations"
+  domain: customer_relationship_management
+  aliases: [account, organization, company, customer]
+  common_queries:
+    - "Show active accounts by revenue"
+    - "Find accounts by industry"
+    - "List customer accounts with opportunities"
+
 fields:
   name:
     type: text
     required: true
     label: Account Name
     index: true
+    ai_context:
+      intent: "Company or organization name"
   
   account_number:
     type: text
@@ -17,26 +30,43 @@ fields:
   
   type:
     type: select
+    label: Account Type
     options:
-      - customer
-      - prospect
-      - partner
-      - competitor
+      - label: Customer
+        value: customer
+      - label: Prospect
+        value: prospect
+      - label: Partner
+        value: partner
+      - label: Competitor
+        value: competitor
     defaultValue: prospect
     index: true
+    ai_context:
+      intent: "Categorize relationship type with the organization"
+      selection_guidance: "Customer for active clients; Prospect for potential customers"
   
   industry:
     type: select
     options:
-      - technology
-      - finance
-      - healthcare
-      - manufacturing
-      - retail
-      - education
-      - other
+      - label: Technology
+        value: technology
+      - label: Finance
+        value: finance
+      - label: Healthcare
+        value: healthcare
+      - label: Manufacturing
+        value: manufacturing
+      - label: Retail
+        value: retail
+      - label: Education
+        value: education
+      - label: Other
+        value: other
     label: Industry
     index: true
+    ai_context:
+      intent: "Primary industry sector for segmentation and analysis"
   
   annual_revenue:
     type: currency
@@ -67,11 +97,17 @@ fields:
     reference_to: user
     label: Account Owner
     index: true
+    ai_context:
+      intent: "Primary sales representative managing this account"
+      semantic_type: ownership
   
   parent_account:
     type: lookup
     reference_to: crm_account
     label: Parent Account
+    ai_context:
+      intent: "Parent organization for corporate hierarchies"
+      semantic_type: hierarchy
   
   description:
     type: textarea
@@ -80,10 +116,18 @@ fields:
   status:
     type: select
     options:
-      - active
-      - inactive
+      - label: Active
+        value: active
+      - label: Inactive
+        value: inactive
     defaultValue: active
     index: true
+    ai_context:
+      intent: "Current operational status of the account"
+      is_state_machine: true
+      transitions:
+        active: [inactive]
+        inactive: [active]
 
 indexes:
   # For account owner queries

package/templates/enterprise/src/modules/crm/crm_contact.object.yml

@@ -1,7 +1,18 @@
+# File: crm_contact.object.yml
+# Object name is inferred from filename as 'crm_contact'
 label: Contact
 description: Individual contact person
 icon: user-line
 
+ai_context:
+  intent: "Manage individual contacts and decision-makers at accounts"
+  domain: customer_relationship_management
+  aliases: [contact, person, decision maker]
+  common_queries:
+    - "Find contacts by account"
+    - "Show contacts by job title"
+    - "List active contacts with email"
+
 fields:
   first_name:
     type: text
@@ -17,8 +28,10 @@ fields:
   
   full_name:
     type: formula
-    formula: "CONCAT(first_name, ' ', last_name)"
+    expression: "first_name + ' ' + last_name"
+    data_type: text
     label: Full Name
+    description: "Automatically calculated from first and last name"
   
   email:
     type: text
@@ -49,23 +62,36 @@ fields:
     label: Account
     required: true
     index: true
+    ai_context:
+      intent: "Company or organization this contact belongs to"
+      semantic_type: hierarchy
   
   owner:
     type: lookup
     reference_to: user
     label: Contact Owner
     index: true
+    ai_context:
+      intent: "Sales representative managing this contact"
+      semantic_type: ownership
   
   lead_source:
     type: select
     options:
-      - web
-      - referral
-      - trade_show
-      - partner
-      - other
+      - label: Web
+        value: web
+      - label: Referral
+        value: referral
+      - label: Trade Show
+        value: trade_show
+      - label: Partner
+        value: partner
+      - label: Other
+        value: other
     label: Lead Source
     index: true
+    ai_context:
+      intent: "Original source of the contact for attribution"
   
   linkedin_url:
     type: url
@@ -78,10 +104,18 @@ fields:
   status:
     type: select
     options:
-      - active
-      - inactive
+      - label: Active
+        value: active
+      - label: Inactive
+        value: inactive
     defaultValue: active
     index: true
+    ai_context:
+      intent: "Current status of contact engagement"
+      is_state_machine: true
+      transitions:
+        active: [inactive]
+        inactive: [active]
 
 indexes:
   # For account contact lookup