@objectstack/objectql 4.0.1 → 4.0.3

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @objectstack/objectql@4.0.1 build /home/runner/work/spec/spec/packages/objectql
+> @objectstack/objectql@4.0.3 build /home/runner/work/framework/framework/packages/objectql
 > tsup --config ../../tsup.config.ts
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/spec/spec/tsup.config.ts
+CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
 CLI Target: es2020
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.mjs     102.95 KB
-ESM dist/index.mjs.map 211.04 KB
-ESM ⚡️ Build success in 203ms
-CJS dist/index.js     104.68 KB
-CJS dist/index.js.map 212.34 KB
-CJS ⚡️ Build success in 209ms
+ESM dist/index.mjs     112.91 KB
+ESM dist/index.mjs.map 230.31 KB
+ESM ⚡️ Build success in 125ms
+CJS dist/index.js     114.81 KB
+CJS dist/index.js.map 231.61 KB
+CJS ⚡️ Build success in 160ms
 DTS Build start
-DTS ⚡️ Build success in 25148ms
-DTS dist/index.d.mts 79.12 KB
-DTS dist/index.d.ts  79.12 KB
+DTS ⚡️ Build success in 21312ms
+DTS dist/index.d.mts 78.76 KB
+DTS dist/index.d.ts  78.76 KB

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @objectstack/objectql
 
+## 4.0.3
+
+### Patch Changes
+
+- @objectstack/spec@4.0.3
+- @objectstack/core@4.0.3
+- @objectstack/types@4.0.3
+
+## 4.0.3
+
+### Patch Changes
+
+- fix: ObjectQL.init() now tracks and warns about failed driver connections instead of silently swallowing errors, improving debuggability for cold-start and serverless issues.
+
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies [5f659e9]
+  - @objectstack/spec@4.0.2
+  - @objectstack/core@4.0.2
+  - @objectstack/types@4.0.2
+
 ## 4.0.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -4,7 +4,7 @@ import { ObjectOwnership, ServiceObject, QueryAST, HookContext, EngineQueryOptio
 import { ObjectStackManifest, InstalledPackage, ExecutionContext } from '@objectstack/spec/kernel';
 import { ObjectStackProtocol, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, UpdateManyDataRequest, DeleteManyDataRequest } from '@objectstack/spec/api';
 import { IDataEngine, DriverInterface, Logger, Plugin, PluginContext, ObjectKernel } from '@objectstack/core';
-import { IFeedService } from '@objectstack/spec/contracts';
+import { IFeedService, IRealtimeService } from '@objectstack/spec/contracts';
 
 /**
  * XState-inspired State Machine Protocol
@@ -130,15 +130,13 @@ declare class SchemaRegistry {
     private static objectContributors;
     /** FQN → Merged ServiceObject (cached, invalidated on changes) */
     private static mergedObjectCache;
-    /** Namespace → PackageId (ensures namespace uniqueness) */
+    /** Namespace → Set<PackageId> (multiple packages can share a namespace) */
     private static namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private static metadata;
     /**
      * Register a namespace for a package.
-     * Enforces namespace uniqueness within the instance.
-     *
-     * @throws Error if namespace is already registered to a different package
+     * Multiple packages can share the same namespace (e.g. 'sys').
      */
     static registerNamespace(namespace: string, packageId: string): void;
     /**
@@ -146,9 +144,13 @@ declare class SchemaRegistry {
      */
     static unregisterNamespace(namespace: string, packageId: string): void;
     /**
-     * Get the package that owns a namespace.
+     * Get the packages that use a namespace.
      */
     static getNamespaceOwner(namespace: string): string | undefined;
+    /**
+     * Get all packages that share a namespace.
+     */
+    static getNamespaceOwners(namespace: string): string[];
     /**
      * Register an object with ownership semantics.
      *
@@ -471,12 +473,8 @@ declare class SchemaRegistry {
         keyPrefix?: string | undefined;
         actions?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
-            type: "url" | "script" | "modal" | "flow" | "api";
+            label: string;
+            type: "url" | "flow" | "api" | "script" | "modal";
             refreshAfter: boolean;
             objectName?: string | undefined;
             icon?: string | undefined;
@@ -486,63 +484,35 @@ declare class SchemaRegistry {
             execute?: string | undefined;
             params?: {
                 name: string;
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
                 required: boolean;
                 options?: {
-                    label: string | {
-                        key: string;
-                        defaultValue?: string | undefined;
-                        params?: Record<string, string | number | boolean> | undefined;
-                    };
+                    label: string;
                     value: string;
                 }[] | undefined;
             }[] | undefined;
             variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-            confirmText?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
-            successMessage?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            confirmText?: string | undefined;
+            successMessage?: string | undefined;
             visible?: string | undefined;
             disabled?: string | boolean | undefined;
             shortcut?: string | undefined;
             bulkEnabled?: boolean | undefined;
             timeout?: number | undefined;
             aria?: {
-                ariaLabel?: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                } | undefined;
+                ariaLabel?: string | undefined;
                 ariaDescribedBy?: string | undefined;
                 role?: string | undefined;
             } | undefined;
         }[] | undefined;
     } | {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
+        label: string;
         active: boolean;
         isDefault: boolean;
         version?: string | undefined;
-        description?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        description?: string | undefined;
         icon?: string | undefined;
         branding?: {
             primaryColor?: string | undefined;
@@ -552,19 +522,11 @@ declare class SchemaRegistry {
         navigation?: any[] | undefined;
         areas?: {
             id: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             navigation: any[];
             icon?: string | undefined;
             order?: number | undefined;
-            description?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            description?: string | undefined;
             visible?: string | undefined;
             requiredPermissions?: string[] | undefined;
         }[] | undefined;
@@ -594,11 +556,7 @@ declare class SchemaRegistry {
             bottomNavItems?: string[] | undefined;
         } | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;
@@ -606,7 +564,7 @@ declare class SchemaRegistry {
         manifest: {
             id: string;
             version: string;
-            type: "theme" | "driver" | "app" | "server" | "ui" | "module" | "agent" | "objectql" | "plugin" | "gateway" | "adapter";
+            type: "theme" | "app" | "agent" | "driver" | "server" | "ui" | "module" | "objectql" | "plugin" | "gateway" | "adapter";
             name: string;
             namespace?: string | undefined;
             description?: string | undefined;
@@ -751,7 +709,7 @@ declare class SchemaRegistry {
                 extensionPoints?: {
                     id: string;
                     name: string;
-                    type: "provider" | "action" | "widget" | "hook" | "transformer" | "validator" | "decorator";
+                    type: "provider" | "action" | "hook" | "widget" | "transformer" | "validator" | "decorator";
                     cardinality: "multiple" | "single";
                     description?: string | undefined;
                     contract?: {
@@ -931,7 +889,7 @@ declare class SchemaRegistry {
     } | {
         id: string;
         version: string;
-        type: "theme" | "driver" | "app" | "server" | "ui" | "module" | "agent" | "objectql" | "plugin" | "gateway" | "adapter";
+        type: "theme" | "app" | "agent" | "driver" | "server" | "ui" | "module" | "objectql" | "plugin" | "gateway" | "adapter";
         name: string;
         namespace?: string | undefined;
         description?: string | undefined;
@@ -1076,7 +1034,7 @@ declare class SchemaRegistry {
             extensionPoints?: {
                 id: string;
                 name: string;
-                type: "provider" | "action" | "widget" | "hook" | "transformer" | "validator" | "decorator";
+                type: "provider" | "action" | "hook" | "widget" | "transformer" | "validator" | "decorator";
                 cardinality: "multiple" | "single";
                 description?: string | undefined;
                 contract?: {
@@ -1306,7 +1264,8 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         };
         services: Record<string, {
             enabled: boolean;
-            status: "degraded" | "stub" | "available" | "unavailable";
+            status: "degraded" | "stub" | "available" | "registered" | "unavailable";
+            handlerReady?: boolean | undefined;
             route?: string | undefined;
             provider?: string | undefined;
             version?: string | undefined;
@@ -1328,6 +1287,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     }>;
     getMetaItems(request: {
         type: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         items: unknown[];
@@ -1335,6 +1295,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     getMetaItem(request: {
         type: string;
         name: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         name: string;
@@ -1384,7 +1345,6 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         query?: any;
     }): Promise<{
         object: string;
-        value: any[];
         records: any[];
         total: number;
         hasMore: boolean;
@@ -1531,6 +1491,7 @@ declare class ObjectQL implements IDataEngine {
     private middlewares;
     private actions;
     private hostContext;
+    private realtimeService?;
     constructor(hostContext?: Record<string, any>);
     /**
      * Service Status Report
@@ -1624,6 +1585,13 @@ declare class ObjectQL implements IDataEngine {
      * Register a new storage driver
      */
     registerDriver(driver: DriverInterface, isDefault?: boolean): void;
+    /**
+     * Set the realtime service for publishing data change events.
+     * Should be called after kernel resolves the realtime service.
+     *
+     * @param service - An IRealtimeService instance for event publishing
+     */
+    setRealtimeService(service: IRealtimeService): void;
     /**
      * Helper to get object definition
      */
@@ -1919,6 +1887,30 @@ declare class ObjectQLPlugin implements Plugin {
      * Drivers that do not implement `syncSchema` are silently skipped.
      */
     private syncRegisteredSchemas;
+    /**
+     * Restore persisted metadata from the database (sys_metadata) on startup.
+     *
+     * Calls `protocol.loadMetaFromDb()` to bulk-load all active metadata
+     * records (objects, views, apps, etc.) into the in-memory SchemaRegistry.
+     * This closes the persistence loop so that user-created schemas survive
+     * kernel cold starts and redeployments.
+     *
+     * Gracefully degrades when:
+     * - The protocol service is unavailable (e.g., in-memory-only mode).
+     * - `loadMetaFromDb` is not implemented by the protocol shim.
+     * - The underlying driver/table does not exist yet (first-run scenario).
+     */
+    private restoreMetadataFromDb;
+    /**
+     * Bridge all SchemaRegistry objects to the metadata service.
+     *
+     * This ensures objects registered by plugins and loaded from sys_metadata
+     * are visible to AI tools and other consumers that query IMetadataService.
+     *
+     * Runs after both restoreMetadataFromDb() and syncRegisteredSchemas() to
+     * catch all objects in the SchemaRegistry regardless of their source.
+     */
+    private bridgeObjectsToMetadataService;
     /**
      * Load metadata from external metadata service into ObjectQL registry
      * This enables ObjectQL to use file-based or remote metadata

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { ObjectOwnership, ServiceObject, QueryAST, HookContext, EngineQueryOptio
 import { ObjectStackManifest, InstalledPackage, ExecutionContext } from '@objectstack/spec/kernel';
 import { ObjectStackProtocol, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, UpdateManyDataRequest, DeleteManyDataRequest } from '@objectstack/spec/api';
 import { IDataEngine, DriverInterface, Logger, Plugin, PluginContext, ObjectKernel } from '@objectstack/core';
-import { IFeedService } from '@objectstack/spec/contracts';
+import { IFeedService, IRealtimeService } from '@objectstack/spec/contracts';
 
 /**
  * XState-inspired State Machine Protocol
@@ -130,15 +130,13 @@ declare class SchemaRegistry {
     private static objectContributors;
     /** FQN → Merged ServiceObject (cached, invalidated on changes) */
     private static mergedObjectCache;
-    /** Namespace → PackageId (ensures namespace uniqueness) */
+    /** Namespace → Set<PackageId> (multiple packages can share a namespace) */
     private static namespaceRegistry;
     /** Type → Name/ID → MetadataItem */
     private static metadata;
     /**
      * Register a namespace for a package.
-     * Enforces namespace uniqueness within the instance.
-     *
-     * @throws Error if namespace is already registered to a different package
+     * Multiple packages can share the same namespace (e.g. 'sys').
      */
     static registerNamespace(namespace: string, packageId: string): void;
     /**
@@ -146,9 +144,13 @@ declare class SchemaRegistry {
      */
     static unregisterNamespace(namespace: string, packageId: string): void;
     /**
-     * Get the package that owns a namespace.
+     * Get the packages that use a namespace.
      */
     static getNamespaceOwner(namespace: string): string | undefined;
+    /**
+     * Get all packages that share a namespace.
+     */
+    static getNamespaceOwners(namespace: string): string[];
     /**
      * Register an object with ownership semantics.
      *
@@ -471,12 +473,8 @@ declare class SchemaRegistry {
         keyPrefix?: string | undefined;
         actions?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
-            type: "url" | "script" | "modal" | "flow" | "api";
+            label: string;
+            type: "url" | "flow" | "api" | "script" | "modal";
             refreshAfter: boolean;
             objectName?: string | undefined;
             icon?: string | undefined;
@@ -486,63 +484,35 @@ declare class SchemaRegistry {
             execute?: string | undefined;
             params?: {
                 name: string;
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
                 required: boolean;
                 options?: {
-                    label: string | {
-                        key: string;
-                        defaultValue?: string | undefined;
-                        params?: Record<string, string | number | boolean> | undefined;
-                    };
+                    label: string;
                     value: string;
                 }[] | undefined;
             }[] | undefined;
             variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-            confirmText?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
-            successMessage?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            confirmText?: string | undefined;
+            successMessage?: string | undefined;
             visible?: string | undefined;
             disabled?: string | boolean | undefined;
             shortcut?: string | undefined;
             bulkEnabled?: boolean | undefined;
             timeout?: number | undefined;
             aria?: {
-                ariaLabel?: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                } | undefined;
+                ariaLabel?: string | undefined;
                 ariaDescribedBy?: string | undefined;
                 role?: string | undefined;
             } | undefined;
         }[] | undefined;
     } | {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
+        label: string;
         active: boolean;
         isDefault: boolean;
         version?: string | undefined;
-        description?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        description?: string | undefined;
         icon?: string | undefined;
         branding?: {
             primaryColor?: string | undefined;
@@ -552,19 +522,11 @@ declare class SchemaRegistry {
         navigation?: any[] | undefined;
         areas?: {
             id: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             navigation: any[];
             icon?: string | undefined;
             order?: number | undefined;
-            description?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            description?: string | undefined;
             visible?: string | undefined;
             requiredPermissions?: string[] | undefined;
         }[] | undefined;
@@ -594,11 +556,7 @@ declare class SchemaRegistry {
             bottomNavItems?: string[] | undefined;
         } | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;
@@ -606,7 +564,7 @@ declare class SchemaRegistry {
         manifest: {
             id: string;
             version: string;
-            type: "theme" | "driver" | "app" | "server" | "ui" | "module" | "agent" | "objectql" | "plugin" | "gateway" | "adapter";
+            type: "theme" | "app" | "agent" | "driver" | "server" | "ui" | "module" | "objectql" | "plugin" | "gateway" | "adapter";
             name: string;
             namespace?: string | undefined;
             description?: string | undefined;
@@ -751,7 +709,7 @@ declare class SchemaRegistry {
                 extensionPoints?: {
                     id: string;
                     name: string;
-                    type: "provider" | "action" | "widget" | "hook" | "transformer" | "validator" | "decorator";
+                    type: "provider" | "action" | "hook" | "widget" | "transformer" | "validator" | "decorator";
                     cardinality: "multiple" | "single";
                     description?: string | undefined;
                     contract?: {
@@ -931,7 +889,7 @@ declare class SchemaRegistry {
     } | {
         id: string;
         version: string;
-        type: "theme" | "driver" | "app" | "server" | "ui" | "module" | "agent" | "objectql" | "plugin" | "gateway" | "adapter";
+        type: "theme" | "app" | "agent" | "driver" | "server" | "ui" | "module" | "objectql" | "plugin" | "gateway" | "adapter";
         name: string;
         namespace?: string | undefined;
         description?: string | undefined;
@@ -1076,7 +1034,7 @@ declare class SchemaRegistry {
             extensionPoints?: {
                 id: string;
                 name: string;
-                type: "provider" | "action" | "widget" | "hook" | "transformer" | "validator" | "decorator";
+                type: "provider" | "action" | "hook" | "widget" | "transformer" | "validator" | "decorator";
                 cardinality: "multiple" | "single";
                 description?: string | undefined;
                 contract?: {
@@ -1306,7 +1264,8 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         };
         services: Record<string, {
             enabled: boolean;
-            status: "degraded" | "stub" | "available" | "unavailable";
+            status: "degraded" | "stub" | "available" | "registered" | "unavailable";
+            handlerReady?: boolean | undefined;
             route?: string | undefined;
             provider?: string | undefined;
             version?: string | undefined;
@@ -1328,6 +1287,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     }>;
     getMetaItems(request: {
         type: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         items: unknown[];
@@ -1335,6 +1295,7 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
     getMetaItem(request: {
         type: string;
         name: string;
+        packageId?: string;
     }): Promise<{
         type: string;
         name: string;
@@ -1384,7 +1345,6 @@ declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
         query?: any;
     }): Promise<{
         object: string;
-        value: any[];
         records: any[];
         total: number;
         hasMore: boolean;
@@ -1531,6 +1491,7 @@ declare class ObjectQL implements IDataEngine {
     private middlewares;
     private actions;
     private hostContext;
+    private realtimeService?;
     constructor(hostContext?: Record<string, any>);
     /**
      * Service Status Report
@@ -1624,6 +1585,13 @@ declare class ObjectQL implements IDataEngine {
      * Register a new storage driver
      */
     registerDriver(driver: DriverInterface, isDefault?: boolean): void;
+    /**
+     * Set the realtime service for publishing data change events.
+     * Should be called after kernel resolves the realtime service.
+     *
+     * @param service - An IRealtimeService instance for event publishing
+     */
+    setRealtimeService(service: IRealtimeService): void;
     /**
      * Helper to get object definition
      */
@@ -1919,6 +1887,30 @@ declare class ObjectQLPlugin implements Plugin {
      * Drivers that do not implement `syncSchema` are silently skipped.
      */
     private syncRegisteredSchemas;
+    /**
+     * Restore persisted metadata from the database (sys_metadata) on startup.
+     *
+     * Calls `protocol.loadMetaFromDb()` to bulk-load all active metadata
+     * records (objects, views, apps, etc.) into the in-memory SchemaRegistry.
+     * This closes the persistence loop so that user-created schemas survive
+     * kernel cold starts and redeployments.
+     *
+     * Gracefully degrades when:
+     * - The protocol service is unavailable (e.g., in-memory-only mode).
+     * - `loadMetaFromDb` is not implemented by the protocol shim.
+     * - The underlying driver/table does not exist yet (first-run scenario).
+     */
+    private restoreMetadataFromDb;
+    /**
+     * Bridge all SchemaRegistry objects to the metadata service.
+     *
+     * This ensures objects registered by plugins and loaded from sys_metadata
+     * are visible to AI tools and other consumers that query IMetadataService.
+     *
+     * Runs after both restoreMetadataFromDb() and syncRegisteredSchemas() to
+     * catch all objects in the SchemaRegistry regardless of their source.
+     */
+    private bridgeObjectsToMetadataService;
     /**
      * Load metadata from external metadata service into ObjectQL registry
      * This enables ObjectQL to use file-based or remote metadata