Merge pull request #395 from objectstack-ai/copilot/merge-logger-protocol

Author: hotlong

content/docs/references/system/index.mdx

@@ -23,7 +23,6 @@ This section contains all protocol schemas for the system layer of ObjectStack.
   <Card href="./events" title="Events" description="Source: packages/spec/src/system/events.zod.ts" />
   <Card href="./feature" title="Feature" description="Source: packages/spec/src/system/feature.zod.ts" />
   <Card href="./job" title="Job" description="Source: packages/spec/src/system/job.zod.ts" />
-  <Card href="./logger" title="Logger" description="Source: packages/spec/src/system/logger.zod.ts" />
   <Card href="./logging" title="Logging" description="Source: packages/spec/src/system/logging.zod.ts" />
   <Card href="./manifest" title="Manifest" description="Source: packages/spec/src/system/manifest.zod.ts" />
   <Card href="./masking" title="Masking" description="Source: packages/spec/src/system/masking.zod.ts" />
@@ -33,7 +32,6 @@ This section contains all protocol schemas for the system layer of ObjectStack.
   <Card href="./object-storage" title="Object Storage" description="Source: packages/spec/src/system/object-storage.zod.ts" />
   <Card href="./plugin" title="Plugin" description="Source: packages/spec/src/system/plugin.zod.ts" />
   <Card href="./plugin-capability" title="Plugin Capability" description="Source: packages/spec/src/system/plugin-capability.zod.ts" />
-  <Card href="./scoped-storage" title="Scoped Storage" description="Source: packages/spec/src/system/scoped-storage.zod.ts" />
   <Card href="./search-engine" title="Search Engine" description="Source: packages/spec/src/system/search-engine.zod.ts" />
   <Card href="./tracing" title="Tracing" description="Source: packages/spec/src/system/tracing.zod.ts" />
   <Card href="./translation" title="Translation" description="Source: packages/spec/src/system/translation.zod.ts" />

content/docs/references/system/logger.mdx

@@ -12,8 +12,8 @@ description: Logging protocol schemas
 ## TypeScript Usage
 
 ```typescript
-import { ConsoleDestinationConfigSchema, ExtendedLogLevelSchema, ExternalServiceDestinationConfigSchema, FileDestinationConfigSchema, HttpDestinationConfigSchema, LogDestinationSchema, LogDestinationTypeSchema, LogEnrichmentConfigSchema, LoggingConfigSchema, StructuredLogEntrySchema } from '@objectstack/spec/system';
-import type { ConsoleDestinationConfig, ExtendedLogLevel, ExternalServiceDestinationConfig, FileDestinationConfig, HttpDestinationConfig, LogDestination, LogDestinationType, LogEnrichmentConfig, LoggingConfig, StructuredLogEntry } from '@objectstack/spec/system';
+import { ConsoleDestinationConfigSchema, ExtendedLogLevelSchema, ExternalServiceDestinationConfigSchema, FileDestinationConfigSchema, HttpDestinationConfigSchema, LogDestinationSchema, LogDestinationTypeSchema, LogEnrichmentConfigSchema, LogEntrySchema, LogFormatSchema, LogLevelSchema, LoggerConfigSchema, LoggingConfigSchema, StructuredLogEntrySchema } from '@objectstack/spec/system';
+import type { ConsoleDestinationConfig, ExtendedLogLevel, ExternalServiceDestinationConfig, FileDestinationConfig, HttpDestinationConfig, LogDestination, LogDestinationType, LogEnrichmentConfig, LogEntry, LogFormat, LogLevel, LoggerConfig, LoggingConfig, StructuredLogEntry } from '@objectstack/spec/system';
 
 // Validate data
 const result = ConsoleDestinationConfigSchema.parse(data);
@@ -164,6 +164,66 @@ Log enrichment configuration
 
 ---
 
+## LogEntry
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **timestamp** | `string` | ✅ | ISO 8601 timestamp |
+| **level** | `Enum<'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'>` | ✅ | Log severity level |
+| **message** | `string` | ✅ | Log message |
+| **context** | `Record<string, any>` | optional | Structured context data |
+| **error** | `Record<string, any>` | optional | Error object if present |
+| **traceId** | `string` | optional | Distributed trace ID |
+| **spanId** | `string` | optional | Span ID |
+| **service** | `string` | optional | Service name |
+| **component** | `string` | optional | Component name (e.g. plugin id) |
+
+---
+
+## LogFormat
+
+Log output format
+
+### Allowed Values
+
+* `json`
+* `text`
+* `pretty`
+
+---
+
+## LogLevel
+
+Log severity level
+
+### Allowed Values
+
+* `debug`
+* `info`
+* `warn`
+* `error`
+* `fatal`
+
+---
+
+## LoggerConfig
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | optional | Logger name identifier |
+| **level** | `Enum<'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'>` | optional | Log severity level |
+| **format** | `Enum<'json' \| 'text' \| 'pretty'>` | optional | Log output format |
+| **redact** | `string[]` | optional | Keys to redact from log context |
+| **sourceLocation** | `boolean` | optional | Include file and line number |
+| **file** | `string` | optional | Path to log file |
+| **rotation** | `object` | optional |  |
+
+---
+
 ## LoggingConfig
 
 Logging configuration
@@ -176,6 +236,8 @@ Logging configuration
 | **label** | `string` | ✅ | Display label |
 | **enabled** | `boolean` | optional |  |
 | **level** | `Enum<'trace' \| 'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'>` | optional | Extended log severity level |
+| **default** | `object` | optional | Default logger configuration |
+| **loggers** | `Record<string, object>` | optional | Named logger configurations |
 | **destinations** | `object[]` | ✅ | Log destinations |
 | **enrichment** | `object` | optional | Log enrichment configuration |
 | **redact** | `string[]` | optional | Fields to redact |

content/docs/references/system/logging.mdx

@@ -16,7 +16,6 @@
     "events",
     "feature",
     "job",
-    "logger",
     "logging",
     "manifest",
     "masking",
@@ -26,7 +25,6 @@
     "object-storage",
     "plugin",
     "plugin-capability",
-    "scoped-storage",
     "search-engine",
     "tracing",
     "translation"

content/docs/references/system/meta.json

@@ -12,8 +12,8 @@ description: Object Storage protocol schemas
 ## TypeScript Usage
 
 ```typescript
-import { AccessControlConfigSchema, BucketConfigSchema, LifecycleActionSchema, LifecyclePolicyConfigSchema, LifecyclePolicyRuleSchema, MultipartUploadConfigSchema, ObjectMetadataSchema, ObjectStorageConfigSchema, PresignedUrlConfigSchema, StorageAclSchema, StorageClassSchema, StorageConnectionSchema, StorageProviderSchema } from '@objectstack/spec/system';
-import type { AccessControlConfig, BucketConfig, LifecycleAction, LifecyclePolicyConfig, LifecyclePolicyRule, MultipartUploadConfig, ObjectMetadata, ObjectStorageConfig, PresignedUrlConfig, StorageAcl, StorageClass, StorageConnection, StorageProvider } from '@objectstack/spec/system';
+import { AccessControlConfigSchema, BucketConfigSchema, FileMetadataSchema, LifecycleActionSchema, LifecyclePolicyConfigSchema, LifecyclePolicyRuleSchema, MultipartUploadConfigSchema, ObjectMetadataSchema, ObjectStorageConfigSchema, PresignedUrlConfigSchema, StorageAclSchema, StorageClassSchema, StorageConnectionSchema, StorageProviderSchema, StorageScopeSchema } from '@objectstack/spec/system';
+import type { AccessControlConfig, BucketConfig, FileMetadata, LifecycleAction, LifecyclePolicyConfig, LifecyclePolicyRule, MultipartUploadConfig, ObjectMetadata, ObjectStorageConfig, PresignedUrlConfig, StorageAcl, StorageClass, StorageConnection, StorageProvider, StorageScope } from '@objectstack/spec/system';
 
 // Validate data
 const result = AccessControlConfigSchema.parse(data);
@@ -64,6 +64,22 @@ const result = AccessControlConfigSchema.parse(data);
 
 ---
 
+## FileMetadata
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **path** | `string` | ✅ | File path |
+| **name** | `string` | ✅ | File name |
+| **size** | `integer` | ✅ | File size in bytes |
+| **mimeType** | `string` | ✅ | MIME type |
+| **lastModified** | `string` | ✅ | Last modified timestamp |
+| **created** | `string` | ✅ | Creation timestamp |
+| **etag** | `string` | optional | Entity tag |
+
+---
+
 ## LifecycleAction
 
 Lifecycle policy action type
@@ -149,9 +165,13 @@ Lifecycle policy action type
 | **name** | `string` | ✅ | Storage configuration identifier |
 | **label** | `string` | ✅ | Display label |
 | **provider** | `Enum<'s3' \| 'azure_blob' \| 'gcs' \| 'minio' \| 'r2' \| 'spaces' \| 'wasabi' \| 'backblaze' \| 'local'>` | ✅ | Primary storage provider |
+| **scope** | `Enum<'global' \| 'tenant' \| 'user' \| 'session' \| 'temp' \| 'cache' \| 'data' \| 'logs' \| 'config' \| 'public'>` | optional | Storage scope |
 | **connection** | `object` | ✅ | Connection credentials |
 | **buckets** | `object[]` | optional | Configured buckets |
 | **defaultBucket** | `string` | optional | Default bucket name for operations |
+| **location** | `string` | optional | Root path (local) or base location |
+| **quota** | `integer` | optional | Max size in bytes |
+| **options** | `Record<string, any>` | optional | Provider-specific configuration options |
 | **enabled** | `boolean` | optional | Enable this storage configuration |
 | **description** | `string` | optional | Configuration description |
 
@@ -238,3 +258,22 @@ Storage provider type
 * `backblaze`
 * `local`
 
+---
+
+## StorageScope
+
+Storage scope classification
+
+### Allowed Values
+
+* `global`
+* `tenant`
+* `user`
+* `session`
+* `temp`
+* `cache`
+* `data`
+* `logs`
+* `config`
+* `public`
+

content/docs/references/system/object-storage.mdx

@@ -5,27 +5,34 @@
       "type": "object",
       "properties": {
         "path": {
-          "type": "string"
+          "type": "string",
+          "description": "File path"
         },
         "name": {
-          "type": "string"
+          "type": "string",
+          "description": "File name"
         },
         "size": {
-          "type": "integer"
+          "type": "integer",
+          "description": "File size in bytes"
         },
         "mimeType": {
-          "type": "string"
+          "type": "string",
+          "description": "MIME type"
         },
         "lastModified": {
           "type": "string",
-          "format": "date-time"
+          "format": "date-time",
+          "description": "Last modified timestamp"
         },
         "created": {
           "type": "string",
-          "format": "date-time"
+          "format": "date-time",
+          "description": "Creation timestamp"
         },
         "etag": {
-          "type": "string"
+          "type": "string",
+          "description": "Entity tag"
         }
       },
       "required": [