fix: Align field naming with @objectstack/spec protocol (autonumber, minLength, maxLength)

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/foundation/core/src/util.ts

@@ -111,6 +111,7 @@ export function convertIntrospectedSchemaToObjects(
             if (foreignKey) {
                 // This is a lookup field
                 fieldConfig = {
+                    name: column.name,
                     type: 'lookup',
                     reference_to: foreignKey.referencedTable,
                     label: toTitleCase(column.name),
@@ -121,6 +122,7 @@ export function convertIntrospectedSchemaToObjects(
                 const fieldType = mapDatabaseTypeToFieldType(column.type);
 
                 fieldConfig = {
+                    name: column.name,
                     type: fieldType,
                     label: toTitleCase(column.name),
                     required: !column.nullable
@@ -133,7 +135,7 @@ export function convertIntrospectedSchemaToObjects(
 
                 // Add max length for text fields
                 if (column.maxLength && (fieldType === 'text' || fieldType === 'textarea')) {
-                    fieldConfig.max_length = column.maxLength;
+                    fieldConfig.maxLength = column.maxLength;
                 }
 
                 // Add default value

packages/foundation/types/src/field.ts

@@ -113,14 +113,43 @@ export interface FieldOption {
  * Extends the Protocol Field definition with runtime-specific properties.
  * The Protocol Constitution (SpecField) defines the core field schema.
  * This adds runtime conveniences and extensions.
+ * 
+ * We make certain spec fields optional since Zod applies defaults at parse time.
  */
-export interface FieldConfig extends Omit<Field, 'type' | 'options'> {
+export interface FieldConfig extends Omit<Field, 'type' | 'options' | 'required' | 'multiple' | 'unique' | 'deleteBehavior' | 'hidden' | 'readonly' | 'encryption' | 'index' | 'externalId'> {
     /** The data type of the field (extended with runtime types) */
     type: FieldType;
 
     /** Options for select fields (extended to allow number values) */
     options?: FieldOption[];
 
+    /** Whether the field is mandatory. Defaults to false. */
+    required?: boolean;
+    
+    /** Whether the field allows multiple values. */
+    multiple?: boolean;
+    
+    /** Whether the field is unique in the table. */
+    unique?: boolean;
+    
+    /** Delete behavior for relationships */
+    deleteBehavior?: 'set_null' | 'cascade' | 'restrict';
+    
+    /** Whether the field is hidden from default UI/API response. */
+    hidden?: boolean;
+    
+    /** Whether the field is read-only in UI. */
+    readonly?: boolean;
+    
+    /** Whether the field is encrypted */
+    encryption?: boolean;
+    
+    /** Whether to create a database index for this field. */
+    index?: boolean;
+    
+    /** Whether this is an external ID field */
+    externalId?: boolean;
+    
     /**
      * RUNTIME EXTENSIONS BELOW
      * These properties are NOT in the wire protocol but are useful for the runtime.
@@ -174,10 +203,35 @@ export interface FieldConfig extends Omit<Field, 'type' | 'options'> {
 
     /**
      * Regular expression pattern for validation.
-     * @deprecated Use SpecField validation pattern instead
+     * @deprecated Use validation.pattern instead
      */
     regex?: string;
 
+    /** 
+     * Field validation configuration.
+     * Defines validation rules applied at the field level.
+     */
+    validation?: {
+        /** Format validation (email, url, etc.) */
+        format?: 'email' | 'url' | 'phone' | 'date' | 'datetime';
+        /** Allowed protocols for URL validation */
+        protocols?: string[];
+        /** Minimum value for numbers */
+        min?: number;
+        /** Maximum value for numbers */
+        max?: number;
+        /** Minimum length for strings */
+        min_length?: number;
+        /** Maximum length for strings */
+        max_length?: number;
+        /** Regular expression pattern for validation */
+        pattern?: string;
+        /** Regex pattern (alias for pattern) */
+        regex?: string;
+        /** Custom validation message */
+        message?: string;
+    };
+    
     /**
      * AI context for the field.
      * Provides semantic information for AI tools.

packages/runtime/server/src/adapters/graphql.ts

@@ -76,7 +76,7 @@ function mapFieldTypeToGraphQL(field: FieldConfig, isInput: boolean = false): Gr
         case 'currency':
         case 'percent':
             return GraphQLFloat;
-        case 'auto_number':
+        case 'autonumber':
             return GraphQLInt;
         case 'boolean':
             return GraphQLBoolean;

packages/runtime/server/src/metadata.ts

@@ -197,8 +197,8 @@ export function createMetadataHandler(app: IObjectQL, options?: MetadataHandlerO
                     options: field.options,
                     min: field.min,
                     max: field.max,
-                    min_length: field.min_length,
-                    max_length: field.max_length,
+                    minLength: field.minLength,
+                    maxLength: field.maxLength,
                     regex: field.regex
                 });
             }

packages/tools/cli/src/commands/generate.ts

@@ -107,7 +107,7 @@ function mapFieldTypeToTs(field: FieldConfig): string {
         case 'number':
         case 'currency':
         case 'percent':
-        case 'auto_number':
+        case 'autonumber':
             return 'number';
 
         case 'boolean':

packages/tools/cli/src/commands/sync.ts

@@ -189,9 +189,9 @@ function generateObjectDefinition(table: IntrospectedTable, schema: Introspected
                 field.unique = true;
             }
 
-            // Add max_length for text-based fields
+            // Add maxLength for text-based fields
             if (column.maxLength && (fieldType === 'text' || fieldType === 'textarea')) {
-                field.max_length = column.maxLength;
+                field.maxLength = column.maxLength;
             }
 
             if (column.defaultValue !== undefined && column.defaultValue !== null) {