Address code review: extract ObjectUpdateChanges interface and clarify import paths

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>

Author: Copilot

examples/schema-migration-example.ts

@@ -7,6 +7,13 @@
  * These migration instructions express declarative schema changes that
  * can be interpreted by migration tools or AI agents to safely evolve
  * your data model over time.
+ * 
+ * Note: This example uses a relative import path for demonstration purposes
+ * within the monorepo. In your application, import from the package:
+ * 
+ * ```typescript
+ * import { MigrationConfig, ... } from '@objectql/types';
+ * ```
  */
 
 import {

packages/foundation/types/src/migration.ts

@@ -88,6 +88,21 @@ export interface FieldDeleteInstruction extends BaseSchemaChangeInstruction {
     archive_location?: string;
 }
 
+/**
+ * Configuration changes that can be applied to an object.
+ * Used by ObjectUpdateInstruction to modify object metadata.
+ */
+export interface ObjectUpdateChanges {
+    /** Updated human-readable label */
+    label?: string;
+    /** Updated icon string */
+    icon?: string;
+    /** Updated description */
+    description?: string;
+    /** Updated datasource name */
+    datasource?: string;
+}
+
 /**
  * Instruction to update (modify) an object definition.
  * Can rename or change properties of an existing object.
@@ -102,12 +117,7 @@ export interface ObjectUpdateInstruction extends BaseSchemaChangeInstruction {
     new_object_name?: string;
 
     /** Updated properties (label, description, icon, etc.) */
-    changes: {
-        label?: string;
-        icon?: string;
-        description?: string;
-        datasource?: string;
-    };
+    changes: ObjectUpdateChanges;
 }
 
 /**