Update docs metadata and improve schema build scripts

Standardize titles in meta.json files, update references/meta.json to include new pages, and reorganize ZOD_FILE_TITLES for consistency. The build-schemas script now cleans the output directory before generating new schemas to prevent stale files.

Author: hotlong

content/docs/references/driver/driver/meta.json

@@ -1,3 +1,3 @@
 {
-  "title": "Drivers"
+  "title": "Driver Interface"
 }

content/docs/references/meta.json

@@ -4,9 +4,12 @@
   "pages": [
     "data",
     "ui",
+    "automation",
     "system",
+    "permission",
     "ai",
     "api",
-    "misc"
+    "driver",
+    "integration"
   ]
 }

content/docs/references/system/audit/meta.json

@@ -1,3 +1,3 @@
 {
-  "title": "Audit"
+  "title": "Audit Logs"
 }

content/docs/references/system/license/meta.json

@@ -1,3 +1,3 @@
 {
-  "title": "Licenses"
+  "title": "License"
 }

packages/spec/scripts/build-docs.ts

@@ -23,12 +23,12 @@ const ZOD_FILE_TITLES: Record<string, string> = {
   // Data
   'object': 'Objects',
   'field': 'Fields',
-  'mapping': 'Mappings',
-  'filter': 'Filters',
-  'query': 'Queries',
   'dataset': 'Datasets',
   'hook': 'Hooks',
   'validation': 'Validation',
+  'mapping': 'Mappings',
+  'filter': 'Filters',
+  'query': 'Queries',
 
   // Automation
   'flow': 'Flows',
@@ -39,56 +39,51 @@ const ZOD_FILE_TITLES: Record<string, string> = {
   'sharing': 'Sharing Rules',
   'role': 'Roles',
   'policy': 'Policies',
+  'auth': 'Authentication',
+  'identity': 'Identity',
 
   // System
   'manifest': 'Manifest',
   'plugin': 'Plugins',
   'license': 'License',
   'audit': 'Audit Logs',
-  
-  // Driver
-  'driver': 'Driver Interface',
-  // AI
-  'agent': 'Agents',
-  'conversation': 'Conversations',
-  'cost': 'Cost Management',
-  'model-registry': 'Model Registry',
-  'nlq': 'Natural Language Query',
-  'predictive': 'Predictive Models',
-  'rag-pipeline': 'RAG Pipelines',
-  'workflow-automation': 'Workflow Automation',
-  // UI
-  'app': 'Applications',
-  'view': 'Views',
-  'action': 'Actions',
-  'dashboard': 'Dashboards',
-  'report': 'Reports',
-  'page': 'Pages',
-  'theme': 'Themes',
-  'widget': 'Widgets',
-  // System
-  'manifest': 'Manifest',
   'datasource': 'Datasources',
-  'driver': 'Drivers',
-  'auth': 'Authentication',
-  'identity': 'Identity',
-  'role': 'Roles',
-  'policy': 'Policies',
   'organization': 'Organizations',
   'tenant': 'Tenants',
   'webhook': 'Webhooks',
   'events': 'Events',
   'job': 'Jobs',
-  'realtime': 'Real-time Communication',
   'discovery': 'Service Discovery',
-  'plugin': 'Plugins',
   'translation': 'Translations',
-  'audit': 'Audit',
   'territory': 'Territories',
-  'license': 'Licenses',
-  'plan': 'Plans',
+  'plan': 'Subscription Plans',
+
+  // UI
+  'app': 'Applications',
+  'view': 'Views',
+  'action': 'Actions',
+  'dashboard': 'Dashboards',
+  'report': 'Reports',
+  'page': 'Pages',
+  'theme': 'Themes',
+  'widget': 'Widgets',
+
+  // AI
+  'agent': 'Agents',
+  'conversation': 'Conversations',
+  'cost': 'Cost Management',
+  'model-registry': 'Model Registry',
+  'nlq': 'Natural Language Query',
+  'predictive': 'Predictive Models',
+  'rag-pipeline': 'RAG Pipelines',
+  'workflow-automation': 'Workflow Automation',
+
+  // Driver
+  'driver': 'Driver Interface',
+
   // API
-  'contract': 'API Contracts'
+  'contract': 'API Contracts',
+  'realtime': 'Real-time Communication'
 };
 
 // Map SchemaName -> Category (e.g. 'Object' -> 'data')
@@ -307,10 +302,13 @@ const rootMetaProps = {
   pages: [
     "data",
     "ui",
+    "automation",
     "system",
+    "permission",
     "ai",
     "api",
-    "misc" 
+    "driver",
+    "integration"
   ]
 };
 fs.writeFileSync(path.join(DOCS_ROOT, 'meta.json'), JSON.stringify(rootMetaProps, null, 2));

packages/spec/scripts/build-schemas.ts

@@ -6,6 +6,12 @@ import * as Protocol from '../src/index';
 
 const OUT_DIR = path.resolve(__dirname, '../json-schema');
 
+// Clean output directory ensures no stale files remain
+if (fs.existsSync(OUT_DIR)) {
+  console.log(`Cleaning output directory: ${OUT_DIR}`);
+  fs.rmSync(OUT_DIR, { recursive: true, force: true });
+}
+
 // Ensure output directory exists
 if (!fs.existsSync(OUT_DIR)) {
   fs.mkdirSync(OUT_DIR, { recursive: true });