Add optional metadata fields to 8 top-level entity schemas for extensibility

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

Author: Copilot

packages/spec/src/api/discovery.zod.ts

@@ -69,6 +69,11 @@ export const DiscoverySchema = z.object({
     supported: z.array(z.string()),
     timezone: z.string(),
   }),
+  
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 export type DiscoveryResponse = z.infer<typeof DiscoverySchema>;

packages/spec/src/hub/hub-federation.zod.ts

@@ -83,6 +83,11 @@ export const RegionSchema = z.object({
     maxTenants: z.number().int().positive().optional(),
     maxStorage: z.number().int().positive().optional().describe('Bytes'),
   }).optional(),
+  
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 export type Region = z.infer<typeof RegionSchema>;
@@ -159,6 +164,11 @@ export const HubInstanceSchema = z.object({
    */
   createdAt: z.string().datetime(),
   updatedAt: z.string().datetime(),
+  
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 export type HubInstance = z.infer<typeof HubInstanceSchema>;
@@ -255,6 +265,11 @@ export const FederationTopologySchema = z.object({
      */
     conflictResolution: z.enum(['last-write-wins', 'primary-wins', 'manual']).default('last-write-wins'),
   }),
+  
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 export type FederationTopology = z.infer<typeof FederationTopologySchema>;
@@ -503,6 +518,11 @@ export const EdgeLocationSchema = z.object({
    * Status
    */
   status: z.enum(['active', 'inactive']).default('active'),
+  
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 export type EdgeLocation = z.infer<typeof EdgeLocationSchema>;

packages/spec/src/kernel/plugin-structure.zod.ts

@@ -79,6 +79,7 @@ export const OpsFilePathSchema = z.string().describe('Validates a file path agai
 export const OpsDomainModuleSchema = z.object({
   name: z.string().regex(SNAKE_CASE_REGEX).describe('Module name (snake_case)'),
   files: z.array(z.string()).describe('List of files in this module'),
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 }).describe('Scanned domain module representing a plugin folder').superRefine((module, ctx) => {
   // Rule: Must have an index.ts
   if (!module.files.includes('index.ts')) {
@@ -95,6 +96,7 @@ export const OpsDomainModuleSchema = z.object({
 export const OpsPluginStructureSchema = z.object({
   root: z.string().describe('Root directory path of the plugin project'),
   files: z.array(z.string()).describe('List of all file paths relative to root'),
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 }).describe('Full plugin project layout validated against OPS conventions').superRefine((project, ctx) => {
   // Check for configuration file
   if (!project.files.includes('objectstack.config.ts')) {

packages/spec/src/system/change-management.zod.ts

@@ -361,6 +361,11 @@ export const ChangeRequestSchema = z.object({
      */
     url: z.string().url().describe('Attachment URL'),
   })).optional().describe('Attachments'),
+
+  /**
+   * Custom metadata key-value pairs for extensibility
+   */
+  metadata: z.record(z.string(), z.unknown()).optional().describe('Custom metadata key-value pairs for extensibility'),
 });
 
 // Type exports