chore(spec): regenerate api-surface + reference docs for #4587 (check:generated --fix, 2 proved stale)

api-surface.json: ./kernel loses MetadataEvent(type)/MetadataEventSchema and
MetadataBulkRegisterRequest(type)/MetadataBulkRegisterRequestSchema; ./api
gains the MetadataBulkRegisterRequest type alias beside its schema.
Reference docs: the api/metadata-plugin.mdx page (which documented the
removed kernel pair under the api section and advertised a then-nonexistent
./api type import) is no longer emitted; api/events.mdx now documents
MetadataEvent, api/metadata.mdx documents MetadataBulkRegisterRequest, and
kernel/metadata-plugin.mdx drops the removed schemas.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M9uWvoEp9CoLzYjNExj9sL

Author: claude

content/docs/references/api/events.mdx

@@ -26,8 +26,8 @@ Examples:
 ## TypeScript Usage
 
 ```typescript
-import { DataEvent, DataEventType, MetadataEventType } from '@objectstack/spec/api';
-import type { DataEvent, DataEventType, MetadataEventType } from '@objectstack/spec/api';
+import { DataEvent, DataEventType, MetadataEvent, MetadataEventType } from '@objectstack/spec/api';
+import type { DataEvent, DataEventType, MetadataEvent, MetadataEventType } from '@objectstack/spec/api';
 
 // Validate data
 const result = DataEvent.parse(data);
@@ -64,6 +64,24 @@ const result = DataEvent.parse(data);
 * `data.field.changed`
 
 
+---
+
+## MetadataEvent
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **id** | `string` | ✅ | Unique event identifier |
+| **type** | `Enum<'metadata.object.created' \| 'metadata.object.updated' \| 'metadata.object.deleted' \| 'metadata.field.created' \| 'metadata.field.updated' \| 'metadata.field.deleted' \| 'metadata.view.created' \| 'metadata.view.updated' \| 'metadata.view.deleted' \| 'metadata.app.created' \| 'metadata.app.updated' \| 'metadata.app.deleted' \| 'metadata.agent.created' \| 'metadata.agent.updated' \| 'metadata.agent.deleted' \| 'metadata.tool.created' \| 'metadata.tool.updated' \| 'metadata.tool.deleted' \| 'metadata.flow.created' \| 'metadata.flow.updated' \| 'metadata.flow.deleted' \| 'metadata.action.created' \| 'metadata.action.updated' \| 'metadata.action.deleted' \| 'metadata.workflow.created' \| 'metadata.workflow.updated' \| 'metadata.workflow.deleted' \| 'metadata.dashboard.created' \| 'metadata.dashboard.updated' \| 'metadata.dashboard.deleted' \| 'metadata.report.created' \| 'metadata.report.updated' \| 'metadata.report.deleted' \| 'metadata.role.created' \| 'metadata.role.updated' \| 'metadata.role.deleted' \| 'metadata.permission.created' \| 'metadata.permission.updated' \| 'metadata.permission.deleted'>` | ✅ | Event type |
+| **metadataType** | `string` | ✅ | Metadata type (object, view, agent, etc.) |
+| **name** | `string` | ✅ | Metadata item name |
+| **packageId** | `string` | optional | Package ID |
+| **definition** | `any` | optional | Full definition (create/update only) |
+| **userId** | `string` | optional | User who triggered the event |
+| **timestamp** | `string` | ✅ | Event timestamp |
+
+
 ---
 
 ## MetadataEventType

content/docs/references/api/meta.json

@@ -32,7 +32,6 @@
     "export",
     "identity",
     "metadata",
-    "metadata-plugin",
     "notification",
     "package-api",
     "package-registry",

content/docs/references/api/metadata-plugin.mdx

@@ -50,8 +50,8 @@ the entire platform, including Hono, Next.js, and NestJS adapters.
 ## TypeScript Usage
 
 ```typescript
-import { AppDefinitionResponse, ConceptListResponse, MetadataBulkResponse, MetadataBulkUnregisterRequest, MetadataDeleteResponse, MetadataDependenciesResponse, MetadataDependentsResponse, MetadataEffectiveResponse, MetadataExistsResponse, MetadataExportRequest, MetadataExportResponse, MetadataImportRequest, MetadataImportResponse, MetadataItemResponse, MetadataListResponse, MetadataNamesResponse, MetadataOverlayResponse, MetadataOverlaySaveRequest, MetadataQueryRequest, MetadataQueryResponse, MetadataRegisterRequest, MetadataTypeInfoResponse, MetadataTypesResponse, MetadataValidateRequest, MetadataValidateResponse, ObjectDefinitionResponse } from '@objectstack/spec/api';
-import type { AppDefinitionResponse, ConceptListResponse, MetadataBulkResponse, MetadataBulkUnregisterRequest, MetadataDeleteResponse, MetadataDependenciesResponse, MetadataDependentsResponse, MetadataEffectiveResponse, MetadataExistsResponse, MetadataExportRequest, MetadataExportResponse, MetadataImportRequest, MetadataImportResponse, MetadataItemResponse, MetadataListResponse, MetadataNamesResponse, MetadataOverlayResponse, MetadataOverlaySaveRequest, MetadataQueryRequest, MetadataQueryResponse, MetadataRegisterRequest, MetadataTypeInfoResponse, MetadataTypesResponse, MetadataValidateRequest, MetadataValidateResponse, ObjectDefinitionResponse } from '@objectstack/spec/api';
+import { AppDefinitionResponse, ConceptListResponse, MetadataBulkRegisterRequest, MetadataBulkResponse, MetadataBulkUnregisterRequest, MetadataDeleteResponse, MetadataDependenciesResponse, MetadataDependentsResponse, MetadataEffectiveResponse, MetadataExistsResponse, MetadataExportRequest, MetadataExportResponse, MetadataImportRequest, MetadataImportResponse, MetadataItemResponse, MetadataListResponse, MetadataNamesResponse, MetadataOverlayResponse, MetadataOverlaySaveRequest, MetadataQueryRequest, MetadataQueryResponse, MetadataRegisterRequest, MetadataTypeInfoResponse, MetadataTypesResponse, MetadataValidateRequest, MetadataValidateResponse, ObjectDefinitionResponse } from '@objectstack/spec/api';
+import type { AppDefinitionResponse, ConceptListResponse, MetadataBulkRegisterRequest, MetadataBulkResponse, MetadataBulkUnregisterRequest, MetadataDeleteResponse, MetadataDependenciesResponse, MetadataDependentsResponse, MetadataEffectiveResponse, MetadataExistsResponse, MetadataExportRequest, MetadataExportResponse, MetadataImportRequest, MetadataImportResponse, MetadataItemResponse, MetadataListResponse, MetadataNamesResponse, MetadataOverlayResponse, MetadataOverlaySaveRequest, MetadataQueryRequest, MetadataQueryResponse, MetadataRegisterRequest, MetadataTypeInfoResponse, MetadataTypesResponse, MetadataValidateRequest, MetadataValidateResponse, ObjectDefinitionResponse } from '@objectstack/spec/api';
 
 // Validate data
 const result = AppDefinitionResponse.parse(data);
@@ -85,6 +85,19 @@ const result = AppDefinitionResponse.parse(data);
 | **data** | `{ name: string; label: string; icon?: string; description?: string }[]` | ✅ | List of available concepts (Objects, Apps, Flows) |
 
 
+---
+
+## MetadataBulkRegisterRequest
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **items** | `{ type: string; name: string; data: Record<string, any> }[]` | ✅ | Items to register |
+| **continueOnError** | `boolean` | ✅ | Continue on individual failure |
+| **validate** | `boolean` | ✅ | Validate before registering |
+
+
 ---
 
 ## MetadataBulkResponse

content/docs/references/api/metadata.mdx

@@ -72,26 +72,13 @@ cohesive plugin that "takes over" the entire platform's metadata management:
 ## TypeScript Usage
 
 ```typescript
-import { MetadataBulkRegisterRequest, MetadataBulkResult, MetadataDependency, MetadataEvent, MetadataPluginConfig, MetadataPluginManifest, MetadataQuery, MetadataQueryResult, MetadataType, MetadataTypeRegistryEntry, MetadataValidationResult } from '@objectstack/spec/kernel';
-import type { MetadataBulkRegisterRequest, MetadataBulkResult, MetadataDependency, MetadataEvent, MetadataPluginConfig, MetadataPluginManifest, MetadataQuery, MetadataQueryResult, MetadataType, MetadataTypeRegistryEntry, MetadataValidationResult } from '@objectstack/spec/kernel';
+import { MetadataBulkResult, MetadataDependency, MetadataPluginConfig, MetadataPluginManifest, MetadataQuery, MetadataQueryResult, MetadataType, MetadataTypeRegistryEntry, MetadataValidationResult } from '@objectstack/spec/kernel';
+import type { MetadataBulkResult, MetadataDependency, MetadataPluginConfig, MetadataPluginManifest, MetadataQuery, MetadataQueryResult, MetadataType, MetadataTypeRegistryEntry, MetadataValidationResult } from '@objectstack/spec/kernel';
 
 // Validate data
-const result = MetadataBulkRegisterRequest.parse(data);
+const result = MetadataBulkResult.parse(data);
 ```
 
----
-
-## MetadataBulkRegisterRequest
-
-### Properties
-
-| Property | Type | Required | Description |
-| :--- | :--- | :--- | :--- |
-| **items** | `{ type: string; name: string; data: Record<string, any>; namespace?: string }[]` | ✅ | Items to register |
-| **continueOnError** | `boolean` | ✅ | Continue if individual item fails |
-| **validate** | `boolean` | ✅ | Validate before register |
-
-
 ---
 
 ## MetadataBulkResult
@@ -121,24 +108,6 @@ const result = MetadataBulkRegisterRequest.parse(data);
 | **kind** | `Enum<'reference' \| 'extends' \| 'includes' \| 'triggers'>` | ✅ | How the dependency is formed |
 
 
----
-
-## MetadataEvent
-
-### Properties
-
-| Property | Type | Required | Description |
-| :--- | :--- | :--- | :--- |
-| **event** | `Enum<'metadata.registered' \| 'metadata.updated' \| 'metadata.unregistered' \| 'metadata.validated' \| 'metadata.deployed' \| 'metadata.overlay.applied' \| 'metadata.overlay.removed' \| 'metadata.imported' \| 'metadata.exported'>` | ✅ | Event type |
-| **metadataType** | `Enum<'object' \| 'field' \| 'hook' \| 'seed' \| 'mapping' \| 'view' \| 'page' \| 'dashboard' \| 'app' \| 'action' \| 'report' \| 'dataset' \| 'flow' \| 'job' \| 'datasource' \| 'external_catalog' \| 'translation' \| 'email_template' \| 'doc' \| 'book' \| 'permission' \| 'position' \| 'agent' \| 'tool' \| 'skill'>` | ✅ | Metadata type |
-| **name** | `string` | ✅ | Metadata item name |
-| **namespace** | `string` | optional | Namespace |
-| **packageId** | `string` | optional | Owning package ID |
-| **timestamp** | `string` | ✅ | Event timestamp |
-| **actor** | `string` | optional | User or system that triggered the event |
-| **payload** | `Record<string, any>` | optional | Event-specific payload |
-
-
 ---
 
 ## MetadataPluginConfig

content/docs/references/kernel/metadata-plugin.mdx

@@ -1611,8 +1611,6 @@
     "MergeResultSchema (const)",
     "MergeStrategyConfig (type)",
     "MergeStrategyConfigSchema (const)",
-    "MetadataBulkRegisterRequest (type)",
-    "MetadataBulkRegisterRequestSchema (const)",
     "MetadataBulkResult (type)",
     "MetadataBulkResultSchema (const)",
     "MetadataCategory (type)",
@@ -1627,8 +1625,6 @@
     "MetadataDependencySchema (const)",
     "MetadataDiffItem (type)",
     "MetadataDiffItemSchema (const)",
-    "MetadataEvent (type)",
-    "MetadataEventSchema (const)",
     "MetadataFallbackStrategy (type)",
     "MetadataFallbackStrategySchema (const)",
     "MetadataLock (type)",
@@ -2846,6 +2842,7 @@
     "MarkNotificationsReadRequestSchema (const)",
     "MarkNotificationsReadResponse (type)",
     "MarkNotificationsReadResponseSchema (const)",
+    "MetadataBulkRegisterRequest (type)",
     "MetadataBulkRegisterRequestSchema (const)",
     "MetadataBulkResponse (type)",
     "MetadataBulkResponseSchema (const)",