Add tests for new schemas: execution, export, feed-api, discovery, storage

- Create execution.test.ts: ExecutionStatus, ExecutionStepLogSchema,
  ExecutionLogSchema, ExecutionErrorSchema, CheckpointSchema,
  ConcurrencyPolicySchema, ScheduleStateSchema
- Create export.test.ts: ExportFormat, ExportJobStatus, CreateExportJob*,
  ExportJobProgress, ImportValidation*, FieldMappingEntry,
  ExportImportTemplate, ScheduledExport, ExportApiContracts
- Extend feed-api.test.ts: Pin/Star/Search/Changelog schemas,
  new FeedApiErrorCode values
- Extend discovery.test.ts: version, rateLimit, capabilities,
  schemaDiscovery fields
- Extend storage.test.ts: FileTypeValidation, chunked upload schemas,
  UploadProgress

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Copilot

packages/spec/src/api/discovery.test.ts

@@ -536,3 +536,150 @@ describe('DiscoverySchema with services', () => {
     expect(discovery.services['ai'].enabled).toBe(false);
   });
 });
+
+// ==========================================
+// ServiceInfoSchema — version & rateLimit
+// ==========================================
+
+describe('ServiceInfoSchema (version field)', () => {
+  it('should accept a service with version', () => {
+    const info = ServiceInfoSchema.parse({
+      enabled: true,
+      status: 'available',
+      route: '/api/v1/data',
+      provider: 'objectql',
+      version: '3.0.6',
+    });
+    expect(info.version).toBe('3.0.6');
+  });
+
+  it('should allow version to be omitted', () => {
+    const info = ServiceInfoSchema.parse({
+      enabled: true,
+      status: 'available',
+    });
+    expect(info.version).toBeUndefined();
+  });
+});
+
+describe('ServiceInfoSchema (rateLimit field)', () => {
+  it('should accept a service with rateLimit', () => {
+    const info = ServiceInfoSchema.parse({
+      enabled: true,
+      status: 'available',
+      rateLimit: {
+        requestsPerMinute: 60,
+        requestsPerHour: 1000,
+        burstLimit: 10,
+        retryAfterMs: 5000,
+      },
+    });
+    expect(info.rateLimit?.requestsPerMinute).toBe(60);
+    expect(info.rateLimit?.burstLimit).toBe(10);
+  });
+
+  it('should allow rateLimit to be omitted', () => {
+    const info = ServiceInfoSchema.parse({
+      enabled: true,
+      status: 'available',
+    });
+    expect(info.rateLimit).toBeUndefined();
+  });
+
+  it('should allow partial rateLimit fields', () => {
+    const info = ServiceInfoSchema.parse({
+      enabled: true,
+      status: 'available',
+      rateLimit: {
+        requestsPerMinute: 100,
+      },
+    });
+    expect(info.rateLimit?.requestsPerMinute).toBe(100);
+    expect(info.rateLimit?.requestsPerHour).toBeUndefined();
+  });
+});
+
+// ==========================================
+// DiscoverySchema — capabilities
+// ==========================================
+
+describe('DiscoverySchema (capabilities field)', () => {
+  const fixture = {
+    name: 'ObjectStack',
+    version: '1.0.0',
+    environment: 'production' as const,
+    routes: { data: '/api/v1/data', metadata: '/api/v1/meta' },
+    services: minimalServices,
+    locale: { default: 'en-US', supported: ['en-US'], timezone: 'UTC' },
+  };
+
+  it('should accept discovery with capabilities', () => {
+    const discovery = DiscoverySchema.parse({
+      ...fixture,
+      capabilities: {
+        comments: {
+          enabled: true,
+          features: { threaded: true, reactions: true, mentions: true },
+          description: 'Feed and comments support',
+        },
+        automation: {
+          enabled: false,
+          description: 'Flow automation engine',
+        },
+      },
+    });
+    expect(discovery.capabilities?.comments.enabled).toBe(true);
+    expect(discovery.capabilities?.comments.features?.threaded).toBe(true);
+    expect(discovery.capabilities?.automation.enabled).toBe(false);
+  });
+
+  it('should allow capabilities to be omitted', () => {
+    const discovery = DiscoverySchema.parse(fixture);
+    expect(discovery.capabilities).toBeUndefined();
+  });
+});
+
+// ==========================================
+// DiscoverySchema — schemaDiscovery
+// ==========================================
+
+describe('DiscoverySchema (schemaDiscovery field)', () => {
+  const fixture = {
+    name: 'ObjectStack',
+    version: '1.0.0',
+    environment: 'production' as const,
+    routes: { data: '/api/v1/data', metadata: '/api/v1/meta' },
+    services: minimalServices,
+    locale: { default: 'en-US', supported: ['en-US'], timezone: 'UTC' },
+  };
+
+  it('should accept discovery with schemaDiscovery', () => {
+    const discovery = DiscoverySchema.parse({
+      ...fixture,
+      schemaDiscovery: {
+        openapi: '/api/v1/openapi.json',
+        graphql: '/graphql',
+        jsonSchema: '/api/v1/schemas',
+      },
+    });
+    expect(discovery.schemaDiscovery?.openapi).toBe('/api/v1/openapi.json');
+    expect(discovery.schemaDiscovery?.graphql).toBe('/graphql');
+    expect(discovery.schemaDiscovery?.jsonSchema).toBe('/api/v1/schemas');
+  });
+
+  it('should allow schemaDiscovery to be omitted', () => {
+    const discovery = DiscoverySchema.parse(fixture);
+    expect(discovery.schemaDiscovery).toBeUndefined();
+  });
+
+  it('should allow partial schemaDiscovery fields', () => {
+    const discovery = DiscoverySchema.parse({
+      ...fixture,
+      schemaDiscovery: {
+        openapi: '/api/v1/openapi.json',
+      },
+    });
+    expect(discovery.schemaDiscovery?.openapi).toBe('/api/v1/openapi.json');
+    expect(discovery.schemaDiscovery?.graphql).toBeUndefined();
+  });
+});

packages/spec/src/api/discovery.zod.ts

@@ -17,8 +17,17 @@ export const ServiceInfoSchema = z.object({
   route: z.string().optional().describe('e.g. /api/v1/analytics'),
   /** Implementation provider name */
   provider: z.string().optional().describe('e.g. "objectql", "plugin-redis", "driver-memory"'),
+  /** Service version */
+  version: z.string().optional().describe('Semantic version of the service implementation (e.g. "3.0.6")'),
   /** Human-readable reason if unavailable */
   message: z.string().optional().describe('e.g. "Install plugin-workflow to enable"'),
+  /** Rate limit configuration for this service */
+  rateLimit: z.object({
+    requestsPerMinute: z.number().int().optional().describe('Maximum requests per minute'),
+    requestsPerHour: z.number().int().optional().describe('Maximum requests per hour'),
+    burstLimit: z.number().int().optional().describe('Maximum burst request count'),
+    retryAfterMs: z.number().int().optional().describe('Suggested retry-after delay in milliseconds when rate-limited'),
+  }).optional().describe('Rate limit and quota info for this service'),
 });
 
 /**
@@ -108,6 +117,29 @@ export const DiscoverySchema = z.object({
     'Per-service availability map keyed by CoreServiceName'
   ),
 
+  /**
+   * Hierarchical capability descriptors.
+   * Declares platform features so clients can adapt UI without probing individual services.
+   * Each key is a capability domain (e.g., "comments", "automation", "search"),
+   * and its value describes what sub-features are available.
+   */
+  capabilities: z.record(z.string(), z.object({
+    enabled: z.boolean().describe('Whether this capability is available'),
+    features: z.record(z.string(), z.boolean()).optional()
+      .describe('Sub-feature flags within this capability'),
+    description: z.string().optional()
+      .describe('Human-readable capability description'),
+  })).optional().describe('Hierarchical capability descriptors for frontend intelligent adaptation'),
+
+  /**
+   * Schema discovery URLs for cross-ecosystem interoperability.
+   */
+  schemaDiscovery: z.object({
+    openapi: z.string().optional().describe('URL to OpenAPI (Swagger) specification (e.g., "/api/v1/openapi.json")'),
+    graphql: z.string().optional().describe('URL to GraphQL schema endpoint (e.g., "/graphql")'),
+    jsonSchema: z.string().optional().describe('URL to JSON Schema definitions'),
+  }).optional().describe('Schema discovery endpoints for API toolchain integration'),
+
   /**
    * Custom metadata key-value pairs for extensibility
    */