chore(spec): regenerate the deferred artifacts on the merged tree (#14478)

Discharges the os-regen deferral the merge commit recorded. Regenerated in the
order the generators require — `gen:migration-registry` writes a source file, so
the spec is rebuilt before `gen:api-surface` reads `dist/*.d.ts`:

  gen:migration-registry, build, gen:api-surface, gen:export-origins,
  gen:declaration-map, gen:docs

`check:generated` then reports all 15 generated artifacts up to date.

The ledger keeps every row from both sides and invents none: 356 entry files at
the merge base, +27 from main, +80 from this branch, 463 in the result — set
equality, not just a matching total. `check:migration-registry` reads the same
population back as 186 semantic, 161 retired-key, 116 retired-def.

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

Author: claude

content/docs/references/api/contract.mdx

@@ -454,7 +454,8 @@ const result = ApiErrorSchema.parse(data);
 | **batchScheduleFn** | `Enum<'microtask' \| 'timeout' \| 'manual'>` | optional (default: `"microtask"`) | Scheduling strategy for collecting batch keys |
 | **cacheEnabled** | `boolean` | optional (default: `true`) | Enable per-request result caching |
 | **cacheKeyFn** | `string` | optional | Name or identifier of the cache key function |
-| **cacheTtl** | `number` | optional | Cache time-to-live in seconds (0 = no expiration) |
+| **cacheTtlSeconds** | `number` | optional | Cache time-to-live in seconds (0 = no expiration) |
+| **cacheTtl** | `never` | optional | [REMOVED] `DataLoaderConfig.cacheTtl` was renamed to `cacheTtlSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `cacheTtlSeconds`; the value (seconds) is unchanged. |
 | **coalesceRequests** | `boolean` | optional (default: `true`) | Deduplicate identical requests within a batch window |
 | **maxConcurrency** | `integer` | optional | Maximum parallel batch requests |
 
@@ -667,7 +668,8 @@ const result = ApiErrorSchema.parse(data);
 | **batchScheduleFn** | `Enum<'microtask' \| 'timeout' \| 'manual'>` | optional (default: `"microtask"`) | Scheduling strategy for collecting batch keys |
 | **cacheEnabled** | `boolean` | optional (default: `true`) | Enable per-request result caching |
 | **cacheKeyFn** | `string` | optional | Name or identifier of the cache key function |
-| **cacheTtl** | `number` | optional | Cache time-to-live in seconds (0 = no expiration) |
+| **cacheTtlSeconds** | `number` | optional | Cache time-to-live in seconds (0 = no expiration) |
+| **cacheTtl** | `never` | optional | [REMOVED] `DataLoaderConfig.cacheTtl` was renamed to `cacheTtlSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `cacheTtlSeconds`; the value (seconds) is unchanged. |
 | **coalesceRequests** | `boolean` | optional (default: `true`) | Deduplicate identical requests within a batch window |
 | **maxConcurrency** | `integer` | optional | Maximum parallel batch requests |
 

content/docs/references/api/protocol.mdx

@@ -1207,9 +1207,9 @@ Enable package response
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **directives** | `Enum<'public' \| 'private' \| 'no-cache' \| 'no-store' \| 'must-revalidate' \| 'max-age'>[]` | ✅ | Cache control directives |
-| **maxAge** | `number` | optional | Maximum cache age in seconds |
-| **staleWhileRevalidate** | `number` | optional | Allow serving stale content while revalidating (seconds) |
-| **staleIfError** | `number` | optional | Allow serving stale content on error (seconds) |
+| **maxAge** | `number` | optional | Maximum cache age in seconds (unit per HTTP Cache-Control `max-age` (RFC 9111 §5.2.2.1)) |
+| **staleWhileRevalidate** | `number` | optional | Allow serving stale content while revalidating (seconds) (unit per HTTP Cache-Control `stale-while-revalidate` (RFC 5861 §3)) |
+| **staleIfError** | `number` | optional | Allow serving stale content on error (seconds) (unit per HTTP Cache-Control `stale-if-error` (RFC 5861 §4)) |
 
 
 ---

content/docs/references/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Protocol Reference
-description: Every schema published by @objectstack/spec — 1573 schemas across 14 protocol modules
+description: Every schema published by @objectstack/spec — 1574 schemas across 14 protocol modules
 ---
 
 {/* ⚠️  AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs live in the module folders under content/docs/. */}
@@ -29,11 +29,11 @@ counts are sums of the rows they head. Regenerate with
 | [Kernel Protocol](/docs/references/kernel) | 30 | 162 | Plugin lifecycle and manifests, capabilities and security, metadata loading, service registry. |
 | [QA Protocol](/docs/references/qa) | 1 | 8 | Declarative test suites — scenarios, steps, actions and assertions. |
 | [Security Protocol](/docs/references/security) | 5 | 30 | Permission sets, row-level security, sharing rules, tenancy posture. |
-| [Shared Protocol](/docs/references/shared) | 8 | 27 | Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums. |
+| [Shared Protocol](/docs/references/shared) | 9 | 28 | Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums. |
 | [Studio Protocol](/docs/references/studio) | 3 | 35 | Studio designer metadata — the authoring surfaces for the protocols above. |
 | [System Protocol](/docs/references/system) | 33 | 272 | The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance. |
 | [UI Protocol](/docs/references/ui) | 16 | 153 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
-| **Total** | **197** | **1573** | 14 protocol modules |
+| **Total** | **198** | **1574** | 14 protocol modules |
 
 ---
 
@@ -286,13 +286,14 @@ Permission sets, row-level security, sharing rules, tenancy posture.
 
 ## Shared Protocol
 
-**Source:** `packages/spec/src/shared/` · **Import:** `@objectstack/spec/shared` · **8 pages, 27 schemas**
+**Source:** `packages/spec/src/shared/` · **Import:** `@objectstack/spec/shared` · **9 pages, 28 schemas**
 
 Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums.
 
 | File | Schemas |
 | :--- | :--- |
 | [`enums.zod.ts`](/docs/references/shared/enums) | `IsolationLevelEnum`, `MutationEventEnum`, `SortDirectionEnum`, `SortItem` |
+| [`epoch.zod.ts`](/docs/references/shared/epoch) | `EpochMs` |
 | [`expression.zod.ts`](/docs/references/shared/expression) | `CronExpressionInput`, `EvaluatedExpression`, `Expression`, `ExpressionDialect`, `ExpressionInput`, `ExpressionMeta`, `Predicate`, `PredicateInput`, `TemplateExpressionInput` |
 | [`http.zod.ts`](/docs/references/shared/http) | `CorsConfig`, `HttpMethod`, `HttpMethodSubset`, `HttpRequest`, `RateLimitConfig`, `StaticMount` |
 | [`identifiers.zod.ts`](/docs/references/shared/identifiers) | `MetadataItemName`, `SnakeCaseIdentifier`, `SystemIdentifier` |

content/docs/references/integration/connector.mdx

@@ -148,7 +148,8 @@ Circuit breaker configuration
 | **failureThreshold** | `number` | optional (default: `5`) | Failures before opening circuit |
 | **resetTimeoutMs** | `number` | optional (default: `30000`) | Time in open state before half-open |
 | **halfOpenMaxRequests** | `number` | optional (default: `1`) | Requests allowed in half-open state |
-| **monitoringWindow** | `number` | optional (default: `60000`) | Rolling window for failure count in ms |
+| **monitoringWindowMs** | `number` | optional (default: `60000`) | Rolling window for failure count in ms |
+| **monitoringWindow** | `never` | optional | [REMOVED] `CircuitBreakerConfig.monitoringWindow` was renamed to `monitoringWindowMs` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `monitoringWindowMs`; the value (milliseconds) and the 60000 default are unchanged. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; apply them by hand. |
 | **fallbackStrategy** | `Enum<'cache' \| 'default_value' \| 'error' \| 'queue'>` | optional | Fallback strategy when circuit is open |
 
 
@@ -272,7 +273,8 @@ Circuit breaker configuration
 | **label** | `string` | ✅ | Trigger label |
 | **description** | `string` | optional |  |
 | **type** | `Enum<'polling' \| 'webhook'>` | ✅ | Trigger type |
-| **interval** | `number` | optional | Polling interval in seconds |
+| **intervalSeconds** | `number` | optional | Polling interval in seconds |
+| **interval** | `never` | optional | [REMOVED] `ConnectorTrigger.interval` was renamed to `intervalSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `intervalSeconds`; the value (seconds) is unchanged. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; apply them by hand. |
 
 ### Nested Shape: `Connector.syncConfig`
 
@@ -440,7 +442,8 @@ Connector health configuration
 | **failureThreshold** | `number` | optional (default: `5`) | Failures before opening circuit |
 | **resetTimeoutMs** | `number` | optional (default: `30000`) | Time in open state before half-open |
 | **halfOpenMaxRequests** | `number` | optional (default: `1`) | Requests allowed in half-open state |
-| **monitoringWindow** | `number` | optional (default: `60000`) | Rolling window for failure count in ms |
+| **monitoringWindowMs** | `number` | optional (default: `60000`) | Rolling window for failure count in ms |
+| **monitoringWindow** | `never` | optional | [REMOVED] `CircuitBreakerConfig.monitoringWindow` was renamed to `monitoringWindowMs` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `monitoringWindowMs`; the value (milliseconds) and the 60000 default are unchanged. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; apply them by hand. |
 | **fallbackStrategy** | `Enum<'cache' \| 'default_value' \| 'error' \| 'queue'>` | optional | Fallback strategy when circuit is open |
 
 
@@ -597,7 +600,8 @@ Connector status
 | **label** | `string` | ✅ | Trigger label |
 | **description** | `string` | optional |  |
 | **type** | `Enum<'polling' \| 'webhook'>` | ✅ | Trigger type |
-| **interval** | `number` | optional | Polling interval in seconds |
+| **intervalSeconds** | `number` | optional | Polling interval in seconds |
+| **interval** | `never` | optional | [REMOVED] `ConnectorTrigger.interval` was renamed to `intervalSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `intervalSeconds`; the value (seconds) is unchanged. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; apply them by hand. |
 
 
 ---
@@ -755,7 +759,8 @@ Connector type
 | **label** | `string` | ✅ | Trigger label |
 | **description** | `string` | optional |  |
 | **type** | `Enum<'polling' \| 'webhook'>` | ✅ | Trigger type |
-| **interval** | `number` | optional | Polling interval in seconds |
+| **intervalSeconds** | `number` | optional | Polling interval in seconds |
+| **interval** | `never` | optional | [REMOVED] `ConnectorTrigger.interval` was renamed to `intervalSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. Rename the key to `intervalSeconds`; the value (seconds) is unchanged. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; apply them by hand. |
 
 ### Nested Shape: `DeclarativeConnectorEntry.syncConfig`
 

content/docs/references/system/cache.mdx

@@ -53,7 +53,7 @@ Cache avalanche/stampede prevention configuration
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **jitterTtl** | `{ enabled: boolean; maxJitterSeconds: number }` | optional | TTL jitter to prevent simultaneous expiration |
-| **circuitBreaker** | `{ enabled: boolean; failureThreshold: number; resetTimeout: number }` | optional | Circuit breaker for backend protection |
+| **circuitBreaker** | `{ enabled: boolean; failureThreshold: number; resetTimeoutSeconds: number }` | optional | Circuit breaker for backend protection |
 | **lockout** | `{ enabled: boolean; lockTimeoutMs: number }` | optional | Lock-based stampede prevention |
 
 ### Nested Shape: `CacheAvalanchePrevention.jitterTtl`
@@ -69,7 +69,8 @@ Cache avalanche/stampede prevention configuration
 | :--- | :--- | :--- | :--- |
 | **enabled** | `boolean` | optional (default: `false`) | Enable circuit breaker for backend protection |
 | **failureThreshold** | `number` | optional (default: `5`) | Failures before circuit opens |
-| **resetTimeout** | `number` | optional (default: `30`) | Seconds before half-open state |
+| **resetTimeoutSeconds** | `number` | optional (default: `30`) | Seconds before half-open state |
+| **resetTimeout** | `never` | optional | [REMOVED] `CacheAvalanchePrevention.circuitBreaker.resetTimeout` was renamed to `resetTimeoutSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose, and the sibling `lockout` block on this same schema already spells `lockTimeoutMs`. Rename the key to `resetTimeoutSeconds`; the value (seconds) and the 30 default are unchanged. Note the two are NOT the same unit: this one is seconds, `lockTimeoutMs` is milliseconds. |
 
 ### Nested Shape: `CacheAvalanchePrevention.lockout`
 
@@ -90,7 +91,7 @@ Top-level application cache configuration
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **enabled** | `boolean` | optional (default: `false`) | Enable application-level caching |
-| **tiers** | `{ name: string; type: Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>; maxSize?: number; ttl: number; … }[]` | ✅ | Ordered cache tier hierarchy |
+| **tiers** | `{ name: string; type: Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>; maxSize?: number; ttlSeconds: number; … }[]` | ✅ | Ordered cache tier hierarchy |
 | **invalidation** | `{ trigger: Enum<'create' \| 'update' \| 'delete' \| 'manual'>; scope: Enum<'key' \| 'pattern' \| 'tag' \| 'all'>; pattern?: string; tags?: string[] }[]` | ✅ | Cache invalidation rules |
 | **prefetch** | `boolean` | optional (default: `false`) | Enable cache prefetching |
 | **compression** | `boolean` | optional (default: `false`) | Enable data compression in cache |
@@ -105,7 +106,8 @@ Configuration for a single cache tier in the hierarchy
 | **name** | `string` | ✅ | Unique cache tier name |
 | **type** | `Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>` | ✅ | Cache backend type |
 | **maxSize** | `number` | optional | Max size in MB |
-| **ttl** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttlSeconds** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttl** | `never` | optional | [REMOVED] `CacheTier.ttl` was renamed to `ttlSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose, and the sibling `maxSize` on this same tier is a size in MB. Rename the key to `ttlSeconds`; the value (seconds) and the 300 default are unchanged. |
 | **strategy** | `Enum<'lru' \| 'lfu' \| 'fifo' \| 'ttl'>` | optional (default: `"lru"`) | Eviction strategy |
 | **warmup** | `boolean` | optional (default: `false`) | Pre-populate cache on startup |
 
@@ -178,7 +180,8 @@ Configuration for a single cache tier in the hierarchy
 | **name** | `string` | ✅ | Unique cache tier name |
 | **type** | `Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>` | ✅ | Cache backend type |
 | **maxSize** | `number` | optional | Max size in MB |
-| **ttl** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttlSeconds** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttl** | `never` | optional | [REMOVED] `CacheTier.ttl` was renamed to `ttlSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose, and the sibling `maxSize` on this same tier is a size in MB. Rename the key to `ttlSeconds`; the value (seconds) and the 300 default are unchanged. |
 | **strategy** | `Enum<'lru' \| 'lfu' \| 'fifo' \| 'ttl'>` | optional (default: `"lru"`) | Eviction strategy |
 | **warmup** | `boolean` | optional (default: `false`) | Pre-populate cache on startup |
 
@@ -211,7 +214,7 @@ Distributed cache configuration with consistency and avalanche prevention
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **enabled** | `boolean` | optional (default: `false`) | Enable application-level caching |
-| **tiers** | `{ name: string; type: Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>; maxSize?: number; ttl?: number; … }[]` | ✅ | Ordered cache tier hierarchy |
+| **tiers** | `{ name: string; type: Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>; maxSize?: number; ttlSeconds?: number; … }[]` | ✅ | Ordered cache tier hierarchy |
 | **invalidation** | `{ trigger: Enum<'create' \| 'update' \| 'delete' \| 'manual'>; scope: Enum<'key' \| 'pattern' \| 'tag' \| 'all'>; pattern?: string; tags?: string[] }[]` | ✅ | Cache invalidation rules |
 | **prefetch** | `boolean` | optional (default: `false`) | Enable cache prefetching |
 | **compression** | `boolean` | optional (default: `false`) | Enable data compression in cache |
@@ -229,7 +232,8 @@ Configuration for a single cache tier in the hierarchy
 | **name** | `string` | ✅ | Unique cache tier name |
 | **type** | `Enum<'memory' \| 'redis' \| 'memcached' \| 'cdn'>` | ✅ | Cache backend type |
 | **maxSize** | `number` | optional | Max size in MB |
-| **ttl** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttlSeconds** | `number` | optional (default: `300`) | Default TTL in seconds |
+| **ttl** | `never` | optional | [REMOVED] `CacheTier.ttl` was renamed to `ttlSeconds` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose, and the sibling `maxSize` on this same tier is a size in MB. Rename the key to `ttlSeconds`; the value (seconds) and the 300 default are unchanged. |
 | **strategy** | `Enum<'lru' \| 'lfu' \| 'fifo' \| 'ttl'>` | optional (default: `"lru"`) | Eviction strategy |
 | **warmup** | `boolean` | optional (default: `false`) | Pre-populate cache on startup |
 
@@ -249,7 +253,7 @@ Rule defining when and how cached entries are invalidated
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **jitterTtl** | `{ enabled?: boolean; maxJitterSeconds?: number }` | optional | TTL jitter to prevent simultaneous expiration |
-| **circuitBreaker** | `{ enabled?: boolean; failureThreshold?: number; resetTimeout?: number }` | optional | Circuit breaker for backend protection |
+| **circuitBreaker** | `{ enabled?: boolean; failureThreshold?: number; resetTimeoutSeconds?: number }` | optional | Circuit breaker for backend protection |
 | **lockout** | `{ enabled?: boolean; lockTimeoutMs?: number }` | optional | Lock-based stampede prevention |
 
 ### Nested Shape: `DistributedCacheConfig.warmup`