wip(spec): regenerated artifacts and reference pages for the system/ renames (#15679)

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

Author: claude

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`

content/docs/references/system/collaboration.mdx

@@ -346,10 +346,11 @@ This schema accepts one of the following structures:
 | **enablePresence** | `boolean` | optional (default: `true`) | Enable presence tracking |
 | **enableAwareness** | `boolean` | optional (default: `true`) | Enable awareness state |
 | **maxUsers** | `integer` | optional | Maximum concurrent users |
-| **idleTimeout** | `integer` | optional (default: `300000`) | Idle timeout in milliseconds |
+| **idleTimeoutMs** | `integer` | optional (default: `300000`) | Idle timeout in milliseconds |
+| **idleTimeout** | `never` | optional | [REMOVED] `CollaborationSessionConfig.idleTimeout` was renamed to `idleTimeoutMs` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. This one was the live 1000x collision the rule exists to remove: the tenant surface carried its own `idleTimeout` in SECONDS, so the same bare name meant five minutes here and three and a half days there. Rename the key to `idleTimeoutMs`; the value (milliseconds) and the 300000 default are unchanged. |
 | **conflictResolution** | `Enum<'ot' \| 'crdt' \| 'manual'>` | optional (default: `"ot"`) | Conflict resolution strategy |
 | **persistence** | `boolean` | optional (default: `true`) | Enable operation persistence |
-| **snapshot** | `{ enabled: boolean; interval: integer }` | optional | Snapshot configuration |
+| **snapshot** | `{ enabled: boolean; intervalMs: integer }` | optional | Snapshot configuration |
 
 ### Nested Shape: `CollaborationSession.users[number]`
 
@@ -421,17 +422,19 @@ This schema accepts one of the following structures:
 | **enablePresence** | `boolean` | optional (default: `true`) | Enable presence tracking |
 | **enableAwareness** | `boolean` | optional (default: `true`) | Enable awareness state |
 | **maxUsers** | `integer` | optional | Maximum concurrent users |
-| **idleTimeout** | `integer` | optional (default: `300000`) | Idle timeout in milliseconds |
+| **idleTimeoutMs** | `integer` | optional (default: `300000`) | Idle timeout in milliseconds |
+| **idleTimeout** | `never` | optional | [REMOVED] `CollaborationSessionConfig.idleTimeout` was renamed to `idleTimeoutMs` in @objectstack/spec 17 — the unit of a duration-shaped number lives in the key name, not only in the describe prose. This one was the live 1000x collision the rule exists to remove: the tenant surface carried its own `idleTimeout` in SECONDS, so the same bare name meant five minutes here and three and a half days there. Rename the key to `idleTimeoutMs`; the value (milliseconds) and the 300000 default are unchanged. |
 | **conflictResolution** | `Enum<'ot' \| 'crdt' \| 'manual'>` | optional (default: `"ot"`) | Conflict resolution strategy |
 | **persistence** | `boolean` | optional (default: `true`) | Enable operation persistence |
-| **snapshot** | `{ enabled: boolean; interval: integer }` | optional | Snapshot configuration |
+| **snapshot** | `{ enabled: boolean; intervalMs: integer }` | optional | Snapshot configuration |
 
 ### Nested Shape: `CollaborationSessionConfig.snapshot`
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **enabled** | `boolean` | ✅ | Enable periodic snapshots |
-| **interval** | `integer` | ✅ | Snapshot interval in milliseconds |
+| **intervalMs** | `integer` | ✅ | Snapshot interval in milliseconds |
+| **interval** | `never` | optional | [REMOVED] `CollaborationSessionConfig.snapshot.interval` was renamed to `intervalMs` 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 `intervalMs`; the value (milliseconds) is unchanged. |
 
 
 ---

content/docs/references/system/disaster-recovery.mdx

@@ -112,7 +112,7 @@ Complete disaster recovery plan configuration
 | **rpo** | `{ value: number; unit?: Enum<'seconds' \| 'minutes' \| 'hours'> }` | ✅ | Recovery Point Objective |
 | **rto** | `{ value: number; unit?: Enum<'seconds' \| 'minutes' \| 'hours'> }` | ✅ | Recovery Time Objective |
 | **backup** | `{ strategy?: Enum<'full' \| 'incremental' \| 'differential'>; schedule?: string \| object; retention: object; destination: object; … }` | ✅ | Backup configuration |
-| **failover** | `{ mode?: Enum<'active_passive' \| 'active_active' \| 'pilot_light' \| 'warm_standby'>; autoFailover?: boolean; healthCheckInterval?: number; failureThreshold?: number; … }` | optional | Multi-region failover configuration |
+| **failover** | `{ mode?: Enum<'active_passive' \| 'active_active' \| 'pilot_light' \| 'warm_standby'>; autoFailover?: boolean; healthCheckIntervalSeconds?: number; failureThreshold?: number; … }` | optional | Multi-region failover configuration |
 | **replication** | `{ mode?: Enum<'synchronous' \| 'asynchronous' \| 'semi_synchronous'>; maxLagSeconds?: number; includeObjects?: string[]; excludeObjects?: string[] }` | optional | Data replication settings |
 | **testing** | `{ enabled?: boolean; schedule?: string \| object; notificationChannel?: string }` | optional | Automated disaster recovery testing |
 | **runbookUrl** | `string` | optional | URL to disaster recovery runbook/playbook |
@@ -150,7 +150,8 @@ Complete disaster recovery plan configuration
 | :--- | :--- | :--- | :--- |
 | **mode** | `Enum<'active_passive' \| 'active_active' \| 'pilot_light' \| 'warm_standby'>` | optional (default: `"active_passive"`) | Failover mode |
 | **autoFailover** | `boolean` | optional (default: `true`) | Enable automatic failover |
-| **healthCheckInterval** | `number` | optional (default: `30`) | Health check interval in seconds |
+| **healthCheckIntervalSeconds** | `number` | optional (default: `30`) | Health check interval in seconds |
+| **healthCheckInterval** | `never` | optional | [REMOVED] `FailoverConfig.healthCheckInterval` was renamed to `healthCheckIntervalSeconds` 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 `healthCheckIntervalSeconds`; the value (seconds) and the 30 default are unchanged. |
 | **failureThreshold** | `number` | optional (default: `3`) | Consecutive failures before failover |
 | **regions** | `{ name: string; role: Enum<'primary' \| 'secondary' \| 'witness'>; endpoint?: string; priority?: number }[]` | ✅ | Multi-region configuration (minimum 2 regions) |
 | **dns** | `{ ttl?: number; provider?: Enum<'route53' \| 'cloudflare' \| 'azure_dns' \| 'custom'> }` | optional | DNS failover settings |
@@ -194,7 +195,8 @@ Failover configuration
 | :--- | :--- | :--- | :--- |
 | **mode** | `Enum<'active_passive' \| 'active_active' \| 'pilot_light' \| 'warm_standby'>` | optional (default: `"active_passive"`) | Failover mode |
 | **autoFailover** | `boolean` | optional (default: `true`) | Enable automatic failover |
-| **healthCheckInterval** | `number` | optional (default: `30`) | Health check interval in seconds |
+| **healthCheckIntervalSeconds** | `number` | optional (default: `30`) | Health check interval in seconds |
+| **healthCheckInterval** | `never` | optional | [REMOVED] `FailoverConfig.healthCheckInterval` was renamed to `healthCheckIntervalSeconds` 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 `healthCheckIntervalSeconds`; the value (seconds) and the 30 default are unchanged. |
 | **failureThreshold** | `number` | optional (default: `3`) | Consecutive failures before failover |
 | **regions** | `{ name: string; role: Enum<'primary' \| 'secondary' \| 'witness'>; endpoint?: string; priority?: number }[]` | ✅ | Multi-region configuration (minimum 2 regions) |
 | **dns** | `{ ttl: number; provider?: Enum<'route53' \| 'cloudflare' \| 'azure_dns' \| 'custom'> }` | optional | DNS failover settings |