feat(metadata): enhance metadata schemas with additional formats and options

hotlong · hotlong · commit b319c36602c3 · 2026-02-04T20:40:40.000+08:00
diff --git a/content/docs/meta.json b/content/docs/meta.json
@@ -8,10 +8,6 @@
     "objectui",
     "objectos",
     "---",
-    "automation",
-    "ai",
-    "hub",
-    "---",
     "references"
   ]
 }
diff --git a/packages/spec/json-schema/system/MetadataExportOptions.json b/packages/spec/json-schema/system/MetadataExportOptions.json
@@ -27,7 +27,9 @@
             "yaml",
             "yml",
             "ts",
-            "js"
+            "js",
+            "typescript",
+            "javascript"
           ],
           "default": "json"
         }
diff --git a/packages/spec/json-schema/system/MetadataFormat.json b/packages/spec/json-schema/system/MetadataFormat.json
@@ -8,7 +8,9 @@
         "yaml",
         "yml",
         "ts",
-        "js"
+        "js",
+        "typescript",
+        "javascript"
       ]
     }
   },
diff --git a/packages/spec/json-schema/system/MetadataLoadOptions.json b/packages/spec/json-schema/system/MetadataLoadOptions.json
@@ -22,6 +22,27 @@
         "cache": {
           "type": "boolean",
           "default": true
+        },
+        "useCache": {
+          "type": "boolean"
+        },
+        "validate": {
+          "type": "boolean"
+        },
+        "ifNoneMatch": {
+          "type": "string"
+        },
+        "recursive": {
+          "type": "boolean"
+        },
+        "limit": {
+          "type": "number"
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         }
       },
       "additionalProperties": false
diff --git a/packages/spec/json-schema/system/MetadataLoadResult.json b/packages/spec/json-schema/system/MetadataLoadResult.json
@@ -20,6 +20,13 @@
             },
             "hash": {
               "type": "string"
+            },
+            "etag": {
+              "type": "string"
+            },
+            "modifiedAt": {
+              "type": "string",
+              "format": "date-time"
             }
           },
           "additionalProperties": false
@@ -31,11 +38,19 @@
             "yaml",
             "yml",
             "ts",
-            "js"
+            "js",
+            "typescript",
+            "javascript"
           ]
         },
         "source": {
           "type": "string"
+        },
+        "fromCache": {
+          "type": "boolean"
+        },
+        "etag": {
+          "type": "string"
         }
       },
       "additionalProperties": false
diff --git a/packages/spec/json-schema/system/MetadataLoaderContract.json b/packages/spec/json-schema/system/MetadataLoaderContract.json
@@ -13,6 +13,12 @@
         "description": {
           "type": "string"
         },
+        "supportedFormats": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "capabilities": {
           "type": "object",
           "properties": {
diff --git a/packages/spec/json-schema/system/MetadataManagerConfig.json b/packages/spec/json-schema/system/MetadataManagerConfig.json
@@ -17,7 +17,26 @@
         },
         "basePath": {
           "type": "string"
-        }
+        },
+        "rootDir": {
+          "type": "string"
+        },
+        "formats": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "json",
+              "yaml",
+              "yml",
+              "ts",
+              "js",
+              "typescript",
+              "javascript"
+            ]
+          }
+        },
+        "watchOptions": {}
       },
       "required": [
         "loaders"
diff --git a/packages/spec/json-schema/system/MetadataSaveOptions.json b/packages/spec/json-schema/system/MetadataSaveOptions.json
@@ -11,7 +11,9 @@
             "yaml",
             "yml",
             "ts",
-            "js"
+            "js",
+            "typescript",
+            "javascript"
           ]
         },
         "create": {
@@ -24,6 +26,21 @@
         },
         "path": {
           "type": "string"
+        },
+        "prettify": {
+          "type": "boolean"
+        },
+        "indent": {
+          "type": "number"
+        },
+        "sortKeys": {
+          "type": "boolean"
+        },
+        "backup": {
+          "type": "boolean"
+        },
+        "atomic": {
+          "type": "boolean"
         }
       },
       "additionalProperties": false
diff --git a/packages/spec/json-schema/system/MetadataSaveResult.json b/packages/spec/json-schema/system/MetadataSaveResult.json
@@ -25,9 +25,19 @@
             },
             "hash": {
               "type": "string"
+            },
+            "etag": {
+              "type": "string"
+            },
+            "modifiedAt": {
+              "type": "string",
+              "format": "date-time"
             }
           },
           "additionalProperties": false
+        },
+        "etag": {
+          "type": "string"
         }
       },
       "required": [
diff --git a/packages/spec/json-schema/system/MetadataStats.json b/packages/spec/json-schema/system/MetadataStats.json
@@ -16,6 +16,13 @@
         },
         "hash": {
           "type": "string"
+        },
+        "etag": {
+          "type": "string"
+        },
+        "modifiedAt": {
+          "type": "string",
+          "format": "date-time"
         }
       },
       "additionalProperties": false
diff --git a/packages/spec/json-schema/system/MetadataWatchEvent.json b/packages/spec/json-schema/system/MetadataWatchEvent.json
@@ -9,7 +9,10 @@
           "enum": [
             "add",
             "change",
-            "unlink"
+            "unlink",
+            "added",
+            "changed",
+            "deleted"
           ]
         },
         "path": {
@@ -30,6 +33,13 @@
             },
             "hash": {
               "type": "string"
+            },
+            "etag": {
+              "type": "string"
+            },
+            "modifiedAt": {
+              "type": "string",
+              "format": "date-time"
             }
           },
           "additionalProperties": false
diff --git a/packages/spec/src/system/metadata-persistence.zod.ts b/packages/spec/src/system/metadata-persistence.zod.ts
@@ -89,7 +89,10 @@ export type MetadataScope = z.infer<typeof MetadataScopeSchema>;
  * Metadata Format
  * Supported file formats for metadata serialization.
  */
-export const MetadataFormatSchema = z.enum(['json', 'yaml', 'yml', 'ts', 'js']);
+export const MetadataFormatSchema = z.enum([
+  'json', 'yaml', 'yml', 'ts', 'js',
+  'typescript', 'javascript' // Aliases
+]);
 
 /**
  * Metadata Stats
@@ -100,6 +103,8 @@ export const MetadataStatsSchema = z.object({
   size: z.number().optional(),
   mtime: z.date().optional(),
   hash: z.string().optional(),
+  etag: z.string().optional(),
+  modifiedAt: z.date().optional(), // Alias for mtime
 });
 
 /**
@@ -110,6 +115,7 @@ export const MetadataLoaderContractSchema = z.object({
   name: z.string(),
   protocol: z.string(), // e.g. 'file:', 'http:', 's3:'
   description: z.string().optional(),
+  supportedFormats: z.array(z.string()).optional(),
   capabilities: z.object({
     read: z.boolean().default(true),
     write: z.boolean().default(false),
@@ -126,6 +132,12 @@ export const MetadataLoadOptionsSchema = z.object({
   namespace: z.string().optional(),
   raw: z.boolean().optional().describe('Return raw file content instead of parsed JSON'),
   cache: z.boolean().default(true),
+  useCache: z.boolean().optional(), // Alias for cache
+  validate: z.boolean().optional(),
+  ifNoneMatch: z.string().optional(), // For caching
+  recursive: z.boolean().optional(),
+  limit: z.number().optional(),
+  patterns: z.array(z.string()).optional(),
 });
 
 /**
@@ -136,16 +148,23 @@ export const MetadataLoadResultSchema = z.object({
   stats: MetadataStatsSchema.optional(),
   format: MetadataFormatSchema.optional(),
   source: z.string().optional(), // File path or URL
+  fromCache: z.boolean().optional(),
+  etag: z.string().optional(),
 });
 
 /**
  * Metadata Save Options
  */
 export const MetadataSaveOptionsSchema = z.object({
   format: MetadataFormatSchema.optional(),
-  create: z.boolean().default(true), // Create if not exists
+  create: z.boolean().default(true),
   overwrite: z.boolean().default(true),
-  path: z.string().optional(), // Specific path hint
+  path: z.string().optional(),
+  prettify: z.boolean().optional(),
+  indent: z.number().optional(),
+  sortKeys: z.boolean().optional(),
+  backup: z.boolean().optional(),
+  atomic: z.boolean().optional(),
 });
 
 /**
@@ -155,13 +174,14 @@ export const MetadataSaveResultSchema = z.object({
   success: z.boolean(),
   path: z.string().optional(),
   stats: MetadataStatsSchema.optional(),
+  etag: z.string().optional(),
 });
 
 /**
  * Metadata Watch Event
  */
 export const MetadataWatchEventSchema = z.object({
-  type: z.enum(['add', 'change', 'unlink']),
+  type: z.enum(['add', 'change', 'unlink', 'added', 'changed', 'deleted']),
   path: z.string(),
   stats: MetadataStatsSchema.optional(),
 });
@@ -195,10 +215,13 @@ export const MetadataImportOptionsSchema = z.object({
  * Metadata Manager Config
  */
 export const MetadataManagerConfigSchema = z.object({
-  loaders: z.array(z.any()), // Array of Loader instances (can't validate class instance comfortably in Zod)
+  loaders: z.array(z.any()),
   watch: z.boolean().default(false),
   cache: z.boolean().default(true),
   basePath: z.string().optional(),
+  rootDir: z.string().optional(),
+  formats: z.array(MetadataFormatSchema).optional(),
+  watchOptions: z.any().optional(), // Chokidar options
 });
 
 export type MetadataFormat = z.infer<typeof MetadataFormatSchema>;

Original file line number	Diff line number	Diff line change
`@@ -8,10 +8,6 @@`
`8`	`8`	`"objectui",`
`9`	`9`	`"objectos",`
`10`	`10`	`"---",`
`11`		`- "automation",`
`12`		`- "ai",`
`13`		`- "hub",`
`14`		`- "---",`
`15`	`11`	`"references"`
`16`	`12`	`]`
`17`	`13`	`}`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,9 @@`
`8`	`8`	`"yaml",`
`9`	`9`	`"yml",`
`10`	`10`	`"ts",`
`11`		`- "js"`
	`11`	`+ "js",`
	`12`	`+ "typescript",`
	`13`	`+ "javascript"`
`12`	`14`	`]`
`13`	`15`	`}`
`14`	`16`	`},`