@objectql/create 4.0.0 → 4.0.2

package/templates/enterprise/src/modules/finance/finance_payment.object.yml

@@ -1,7 +1,18 @@
+# File: finance_payment.object.yml
+# Object name is inferred from filename as 'finance_payment'
 label: Payment
 description: Payment transaction record
 icon: money-dollar-circle-line
 
+ai_context:
+  intent: "Track customer payments and payment processing"
+  domain: financial_management
+  aliases: [payment, transaction, remittance]
+  common_queries:
+    - "Show payments by date"
+    - "Find pending payments"
+    - "List payments by method and status"
+
 fields:
   payment_number:
     type: text
@@ -15,6 +26,9 @@ fields:
     reference_to: finance_invoice
     label: Related Invoice
     index: true
+    ai_context:
+      intent: "Invoice this payment applies to"
+      semantic_type: association
   
   account:
     type: lookup
@@ -22,6 +36,9 @@ fields:
     label: Customer Account
     required: true
     index: true
+    ai_context:
+      intent: "Customer making the payment"
+      semantic_type: association
   
   payment_date:
     type: date
@@ -37,25 +54,42 @@ fields:
   payment_method:
     type: select
     options:
-      - bank_transfer
-      - credit_card
-      - debit_card
-      - check
-      - cash
-      - paypal
-      - other
+      - label: Bank Transfer
+        value: bank_transfer
+      - label: Credit Card
+        value: credit_card
+      - label: Debit Card
+        value: debit_card
+      - label: Check
+        value: check
+      - label: Cash
+        value: cash
+      - label: PayPal
+        value: paypal
+      - label: Other
+        value: other
     required: true
     index: true
+    ai_context:
+      intent: "Payment method for processing and reconciliation"
+      selection_guidance: "Bank transfer for large amounts; Card for smaller transactions"
   
   currency:
     type: select
     options:
-      - USD
-      - EUR
-      - GBP
-      - CNY
-      - JPY
+      - label: USD
+        value: USD
+      - label: EUR
+        value: EUR
+      - label: GBP
+        value: GBP
+      - label: CNY
+        value: CNY
+      - label: JPY
+        value: JPY
     defaultValue: USD
+    ai_context:
+      intent: "Payment currency for foreign exchange handling"
   
   reference_number:
     type: text
@@ -65,18 +99,33 @@ fields:
   status:
     type: select
     options:
-      - pending
-      - completed
-      - failed
-      - refunded
+      - label: Pending
+        value: pending
+      - label: Completed
+        value: completed
+      - label: Failed
+        value: failed
+      - label: Refunded
+        value: refunded
     defaultValue: pending
     required: true
     index: true
+    ai_context:
+      intent: "Current processing state of payment"
+      is_state_machine: true
+      transitions:
+        pending: [completed, failed]
+        completed: [refunded]
+        failed: [pending]
+        refunded: []
   
   processed_by:
     type: lookup
     reference_to: user
     label: Processed By
+    ai_context:
+      intent: "User who processed this payment"
+      semantic_type: association
   
   notes:
     type: textarea

package/templates/enterprise/src/modules/hr/hr_department.object.yml

@@ -1,7 +1,18 @@
+# File: hr_department.object.yml
+# Object name is inferred from filename as 'hr_department'
 label: Department
 description: Organizational department
 icon: building-line
 
+ai_context:
+  intent: "Manage organizational structure and departments"
+  domain: human_resources
+  aliases: [department, org unit, division]
+  common_queries:
+    - "Show department hierarchy"
+    - "Find departments by manager"
+    - "List active departments by cost center"
+
 fields:
   name:
     type: text
@@ -9,6 +20,8 @@ fields:
     label: Department Name
     unique: true
     index: true
+    ai_context:
+      intent: "Official department name"
   
   code:
     type: text
@@ -22,11 +35,17 @@ fields:
     reference_to: hr_department
     label: Parent Department
     index: true
+    ai_context:
+      intent: "Parent department for organizational hierarchy"
+      semantic_type: hierarchy
   
   manager:
     type: lookup
     reference_to: hr_employee
     label: Department Manager
+    ai_context:
+      intent: "Employee managing this department"
+      semantic_type: ownership
   
   cost_center:
     type: text
@@ -44,10 +63,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"
+      is_state_machine: true
+      transitions:
+        active: [inactive]
+        inactive: [active]
 
 indexes:
   # For org tree

package/templates/enterprise/src/modules/hr/hr_employee.object.yml

@@ -1,7 +1,18 @@
+# File: hr_employee.object.yml
+# Object name is inferred from filename as 'hr_employee'
 label: Employee
 description: Company employee record
 icon: user-line
 
+ai_context:
+  intent: "Manage employee records and organizational relationships"
+  domain: human_resources
+  aliases: [employee, staff, team member]
+  common_queries:
+    - "Show employees by department"
+    - "Find employees by manager"
+    - "List active employees by position"
+
 fields:
   employee_number:
     type: text
@@ -15,6 +26,9 @@ fields:
     reference_to: user
     label: System User Account
     unique: true
+    ai_context:
+      intent: "Link to system user account for access control"
+      semantic_type: association
   
   first_name:
     type: text
@@ -30,8 +44,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
@@ -54,6 +70,9 @@ fields:
     label: Department
     required: true
     index: true
+    ai_context:
+      intent: "Department where employee works"
+      semantic_type: hierarchy
   
   position:
     type: lookup
@@ -61,12 +80,18 @@ fields:
     label: Position
     required: true
     index: true
+    ai_context:
+      intent: "Employee's job position and role"
+      semantic_type: association
   
   manager:
     type: lookup
     reference_to: hr_employee
     label: Direct Manager
     index: true
+    ai_context:
+      intent: "Employee's direct supervisor for reporting structure"
+      semantic_type: hierarchy
   
   hire_date:
     type: date
@@ -81,22 +106,39 @@ fields:
   employment_type:
     type: select
     options:
-      - full_time
-      - part_time
-      - contract
-      - intern
+      - label: Full Time
+        value: full_time
+      - label: Part Time
+        value: part_time
+      - label: Contract
+        value: contract
+      - label: Intern
+        value: intern
     defaultValue: full_time
     index: true
+    ai_context:
+      intent: "Employment classification for benefits and payroll"
+      selection_guidance: "Full Time for regular employees; Contract for consultants"
   
   status:
     type: select
     options:
-      - active
-      - on_leave
-      - terminated
+      - label: Active
+        value: active
+      - label: On Leave
+        value: on_leave
+      - label: Terminated
+        value: terminated
     defaultValue: active
     required: true
     index: true
+    ai_context:
+      intent: "Current employment status"
+      is_state_machine: true
+      transitions:
+        active: [on_leave, terminated]
+        on_leave: [active, terminated]
+        terminated: []
   
   salary:
     type: currency

package/templates/enterprise/src/modules/hr/hr_position.object.yml

@@ -1,7 +1,18 @@
+# File: hr_position.object.yml
+# Object name is inferred from filename as 'hr_position'
 label: Position
 description: Job position or role
 icon: briefcase-line
 
+ai_context:
+  intent: "Define job positions and career levels in the organization"
+  domain: human_resources
+  aliases: [position, job role, title]
+  common_queries:
+    - "Show positions by department"
+    - "Find positions by level"
+    - "List active positions with salary ranges"
+
 fields:
   title:
     type: text
@@ -19,27 +30,44 @@ fields:
   level:
     type: select
     options:
-      - entry
-      - junior
-      - mid
-      - senior
-      - lead
-      - manager
-      - director
-      - executive
+      - label: Entry
+        value: entry
+      - label: Junior
+        value: junior
+      - label: Mid
+        value: mid
+      - label: Senior
+        value: senior
+      - label: Lead
+        value: lead
+      - label: Manager
+        value: manager
+      - label: Director
+        value: director
+      - label: Executive
+        value: executive
     label: Position Level
     index: true
+    ai_context:
+      intent: "Career level and seniority for compensation bands"
+      selection_guidance: "Entry for new grads; Senior for 5+ years experience"
   
   department:
     type: lookup
     reference_to: hr_department
     label: Department
     index: true
+    ai_context:
+      intent: "Department where this position exists"
+      semantic_type: association
   
   reports_to:
     type: lookup
     reference_to: hr_position
     label: Reports To Position
+    ai_context:
+      intent: "Position hierarchy for reporting structure"
+      semantic_type: hierarchy
   
   min_salary:
     type: currency
@@ -64,10 +92,18 @@ fields:
   status:
     type: select
     options:
-      - active
-      - inactive
+      - label: Active
+        value: active
+      - label: Inactive
+        value: inactive
     defaultValue: active
     index: true
+    ai_context:
+      intent: "Whether position is currently open for hiring"
+      is_state_machine: true
+      transitions:
+        active: [inactive]
+        inactive: [active]
 
 indexes:
   # For department positions

package/templates/enterprise/src/modules/hr/hr_timesheet.object.yml

@@ -1,7 +1,18 @@
+# File: hr_timesheet.object.yml
+# Object name is inferred from filename as 'hr_timesheet'
 label: Timesheet
 description: Employee time tracking
 icon: time-line
 
+ai_context:
+  intent: "Track employee work hours and attendance"
+  domain: human_resources
+  aliases: [timesheet, attendance, time card]
+  common_queries:
+    - "Show timesheets for approval"
+    - "Find timesheets by employee and date"
+    - "List overtime hours by department"
+
 fields:
   employee:
     type: lookup
@@ -9,6 +20,9 @@ fields:
     label: Employee
     required: true
     index: true
+    ai_context:
+      intent: "Employee submitting time worked"
+      semantic_type: association
   
   work_date:
     type: date
@@ -47,28 +61,50 @@ fields:
   work_type:
     type: select
     options:
-      - office
-      - remote
-      - field
-      - client_site
+      - label: Office
+        value: office
+      - label: Remote
+        value: remote
+      - label: Field
+        value: field
+      - label: Client Site
+        value: client_site
     defaultValue: office
     index: true
+    ai_context:
+      intent: "Work location for tracking remote vs on-site"
+      selection_guidance: "Remote for work from home; Field for on-location work"
   
   status:
     type: select
     options:
-      - draft
-      - submitted
-      - approved
-      - rejected
+      - label: Draft
+        value: draft
+      - label: Submitted
+        value: submitted
+      - label: Approved
+        value: approved
+      - label: Rejected
+        value: rejected
     defaultValue: draft
     required: true
     index: true
+    ai_context:
+      intent: "Approval workflow state"
+      is_state_machine: true
+      transitions:
+        draft: [submitted]
+        submitted: [approved, rejected]
+        approved: []
+        rejected: [draft]
   
   approved_by:
     type: lookup
     reference_to: user
     label: Approved By
+    ai_context:
+      intent: "Manager who approved the timesheet"
+      semantic_type: association
   
   approved_at:
     type: datetime

package/templates/enterprise/src/modules/project/project_milestone.object.yml

@@ -1,13 +1,26 @@
+# File: project_milestone.object.yml
+# Object name is inferred from filename as 'project_milestone'
 label: Milestone
 description: Project milestone or checkpoint
 icon: flag-line
 
+ai_context:
+  intent: "Track major project milestones and deliverables"
+  domain: project_management
+  aliases: [milestone, checkpoint, deliverable]
+  common_queries:
+    - "Show upcoming milestones"
+    - "Find milestones by project"
+    - "List completed milestones by date"
+
 fields:
   name:
     type: text
     required: true
     label: Milestone Name
     index: true
+    ai_context:
+      intent: "Descriptive name of the milestone"
   
   project:
     type: lookup
@@ -15,6 +28,9 @@ fields:
     label: Project
     required: true
     index: true
+    ai_context:
+      intent: "Project this milestone belongs to"
+      semantic_type: hierarchy
   
   description:
     type: textarea
@@ -32,19 +48,35 @@ fields:
   
   status:
     type: select
+    label: Milestone Status
     options:
-      - pending
-      - in_progress
-      - completed
-      - missed
+      - label: Pending
+        value: pending
+      - label: In Progress
+        value: in_progress
+      - label: Completed
+        value: completed
+      - label: Missed
+        value: missed
     defaultValue: pending
     required: true
     index: true
+    ai_context:
+      intent: "Current state of milestone progress"
+      is_state_machine: true
+      transitions:
+        pending: [in_progress]
+        in_progress: [completed, missed]
+        completed: []
+        missed: []
   
   owner:
     type: lookup
     reference_to: user
     label: Milestone Owner
+    ai_context:
+      intent: "Person responsible for delivering this milestone"
+      semantic_type: ownership
   
   deliverables:
     type: textarea

package/templates/enterprise/src/modules/project/project_project.object.yml

@@ -1,13 +1,26 @@
+# File: project_project.object.yml
+# Object name is inferred from filename as 'project_project'
 label: Project
 description: Project or initiative
 icon: folder-line
 
+ai_context:
+  intent: "Manage projects and track execution from planning to completion"
+  domain: project_management
+  aliases: [project, initiative, program]
+  common_queries:
+    - "Show active projects by priority"
+    - "Find projects by manager"
+    - "List projects by status and department"
+
 fields:
   name:
     type: text
     required: true
     label: Project Name
     index: true
+    ai_context:
+      intent: "Descriptive project name"
   
   code:
     type: text
@@ -22,40 +35,72 @@ fields:
   
   status:
     type: select
+    label: Project Status
     options:
-      - planning
-      - active
-      - on_hold
-      - completed
-      - cancelled
+      - label: Planning
+        value: planning
+      - label: Active
+        value: active
+      - label: On Hold
+        value: on_hold
+      - label: Completed
+        value: completed
+      - label: Cancelled
+        value: cancelled
     defaultValue: planning
     required: true
     index: true
+    ai_context:
+      intent: "Current project lifecycle stage"
+      is_state_machine: true
+      transitions:
+        planning: [active, cancelled]
+        active: [on_hold, completed, cancelled]
+        on_hold: [active, cancelled]
+        completed: []
+        cancelled: []
   
   priority:
     type: select
     options:
-      - low
-      - medium
-      - high
-      - critical
+      - label: Low
+        value: low
+      - label: Medium
+        value: medium
+      - label: High
+        value: high
+      - label: Critical
+        value: critical
     defaultValue: medium
     index: true
+    ai_context:
+      intent: "Project urgency and business impact"
+      selection_guidance: "Critical for strategic initiatives; High for important projects"
   
   type:
     type: select
     options:
-      - internal
-      - customer
-      - research
-      - maintenance
+      - label: Internal
+        value: internal
+      - label: Customer
+        value: customer
+      - label: Research
+        value: research
+      - label: Maintenance
+        value: maintenance
     index: true
+    ai_context:
+      intent: "Project category for resource allocation"
+      selection_guidance: "Customer for client projects; Internal for company initiatives"
   
   account:
     type: lookup
     reference_to: crm_account
     label: Customer Account
     index: true
+    ai_context:
+      intent: "Customer for external projects"
+      semantic_type: association
   
   owner:
     type: lookup
@@ -63,12 +108,18 @@ fields:
     label: Project Manager
     required: true
     index: true
+    ai_context:
+      intent: "Project manager responsible for delivery"
+      semantic_type: ownership
   
   department:
     type: lookup
     reference_to: hr_department
     label: Department
     index: true
+    ai_context:
+      intent: "Department owning this project"
+      semantic_type: association
   
   start_date:
     type: date