chore(uts): fix legacy uts/test/ paths in spec cross-references

uts/realtime/integration/proxy/auth_reauth.md

@@ -9,9 +9,9 @@ Proxy integration test against Ably Sandbox endpoint.
 Uses the programmable proxy (`uts/test/proxy/`) to inject transport-level faults while the SDK communicates with the real Ably backend. See `uts/test/realtime/integration/helpers/proxy.md` for proxy infrastructure details.
 
 Corresponding unit tests:
-- `uts/test/realtime/unit/connection/server_initiated_reauth_test.md` (RTN22, RTN22a)
-- `uts/test/realtime/unit/auth/realtime_authorize.md` (RTC8a, RTC8a1)
-- `uts/test/realtime/unit/auth/connection_auth_test.md` (RSA4c3 covers RTN22 reauth failure while CONNECTED)
+- `uts/realtime/unit/connection/server_initiated_reauth_test.md` (RTN22, RTN22a)
+- `uts/realtime/unit/auth/realtime_authorize.md` (RTC8a, RTC8a1)
+- `uts/realtime/unit/auth/connection_auth_test.md` (RSA4c3 covers RTN22 reauth failure while CONNECTED)
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/channel_faults.md

@@ -12,10 +12,10 @@ See `uts/test/realtime/integration/helpers/proxy.md` for the full proxy infrastr
 
 ## Corresponding Unit Tests
 
-- `uts/test/realtime/unit/channels/channel_attach.md` -- RTL4f (attach timeout)
-- `uts/test/realtime/unit/channels/channel_detach.md` -- RTL5f (detach timeout)
-- `uts/test/realtime/unit/channels/channel_server_initiated_detach.md` -- RTL13a (unsolicited DETACHED triggers reattach)
-- `uts/test/realtime/unit/channels/channel_error.md` -- RTL14 (channel ERROR transitions to FAILED)
+- `uts/realtime/unit/channels/channel_attach.md` -- RTL4f (attach timeout)
+- `uts/realtime/unit/channels/channel_detach.md` -- RTL5f (detach timeout)
+- `uts/realtime/unit/channels/channel_server_initiated_detach.md` -- RTL13a (unsolicited DETACHED triggers reattach)
+- `uts/realtime/unit/channels/channel_error.md` -- RTL14 (channel ERROR transitions to FAILED)
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/connection_open_failures.md

@@ -12,7 +12,7 @@ See `uts/test/realtime/integration/helpers/proxy.md` for the full proxy infrastr
 
 ## Related Unit Tests
 
-See `uts/test/realtime/unit/connection/connection_open_failures_test.md` for the corresponding unit tests that verify the same spec points with mocked WebSocket.
+See `uts/realtime/unit/connection/connection_open_failures_test.md` for the corresponding unit tests that verify the same spec points with mocked WebSocket.
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/connection_resume.md

@@ -8,7 +8,7 @@ Proxy integration test against Ably Sandbox endpoint.
 
 Uses the programmable proxy (`uts/test/proxy/`) to inject transport-level faults while the SDK communicates with the real Ably backend. See `uts/test/realtime/integration/helpers/proxy.md` for proxy infrastructure details.
 
-Corresponding unit tests: `uts/test/realtime/unit/connection/connection_failures_test.md`, `uts/test/realtime/unit/connection/connection_recovery_test.md`
+Corresponding unit tests: `uts/realtime/unit/connection/connection_failures_test.md`, `uts/realtime/unit/connection/connection_recovery_test.md`
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/heartbeat.md

@@ -12,7 +12,7 @@ See `uts/test/realtime/integration/helpers/proxy.md` for the full proxy infrastr
 
 ## Related Unit Tests
 
-See `uts/test/realtime/unit/connection/heartbeat_test.md` for the corresponding unit tests that verify the same spec points with mocked WebSocket and fake timers.
+See `uts/realtime/unit/connection/heartbeat_test.md` for the corresponding unit tests that verify the same spec points with mocked WebSocket and fake timers.
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/presence_reentry.md

@@ -12,7 +12,7 @@ See `uts/test/realtime/integration/helpers/proxy.md` for the full proxy infrastr
 
 ## Corresponding Unit Tests
 
-- `uts/test/realtime/unit/presence/realtime_presence_reentry.md` -- RTP17i (automatic re-entry on ATTACHED non-RESUMED), RTP17g (re-entry publishes ENTER with stored clientId and data)
+- `uts/realtime/unit/presence/realtime_presence_reentry.md` -- RTP17i (automatic re-entry on ATTACHED non-RESUMED), RTP17g (re-entry publishes ENTER with stored clientId and data)
 
 ## Sandbox Setup
 

uts/realtime/integration/proxy/rest_faults.md

@@ -12,9 +12,9 @@ See `uts/test/realtime/integration/helpers/proxy.md` for the full proxy infrastr
 
 ## Corresponding Unit Tests
 
-- `uts/test/rest/unit/auth/token_renewal.md` -- RSC10 (unit test verifies token renewal logic with mocked HTTP)
-- `uts/test/rest/unit/fallback.md` -- RSC15m/REC2c2 (unit test verifies fallback/error handling with mocked HTTP)
-- `uts/test/realtime/unit/channels/channel_publish.md` -- RTL6 (unit test verifies publish request formation)
+- `uts/rest/unit/auth/token_renewal.md` -- RSC10 (unit test verifies token renewal logic with mocked HTTP)
+- `uts/rest/unit/fallback.md` -- RSC15m/REC2c2 (unit test verifies fallback/error handling with mocked HTTP)
+- `uts/realtime/unit/channels/channel_publish.md` -- RTL6 (unit test verifies publish request formation)
 
 ## Sandbox Setup
 

uts/realtime/unit/auth/connection_auth_test.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client and authCallback
 
 ## Mock Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ## Purpose
 

uts/realtime/unit/auth/realtime_authorize.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client and authCallback
 
 ## Mock Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ## Purpose
 

uts/realtime/unit/channels/channel_additional_attached.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_annotations.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 
@@ -238,7 +238,7 @@ CLOSE_CLIENT(client)
 
 **Spec requirement:** RTAN1b — Has the same connection and channel state conditions as message publishing, see RTL6c.
 
-Tests that annotation publish fails in FAILED and SUSPENDED channel states, matching the behaviour tested in `uts/test/realtime/unit/channels/channel_publish.md` (RTL6c4). The same connection and channel state preconditions apply.
+Tests that annotation publish fails in FAILED and SUSPENDED channel states, matching the behaviour tested in `uts/realtime/unit/channels/channel_publish.md` (RTL6c4). The same connection and channel state preconditions apply.
 
 ### Setup
 ```pseudo
@@ -460,7 +460,7 @@ CLOSE_CLIENT(client)
 
 **Spec requirement:** RTAN3a — Is identical to `RestAnnotations#get`.
 
-`RealtimeAnnotations#get` uses the same underlying REST endpoint as `RestAnnotations#get`. The tests in `uts/test/rest/unit/channel/annotations.md` (covering RSAN3) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
+`RealtimeAnnotations#get` uses the same underlying REST endpoint as `RestAnnotations#get`. The tests in `uts/rest/unit/channel/annotations.md` (covering RSAN3) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
 
 ---
 

uts/realtime/unit/channels/channel_attach.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_attributes.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_connection_state.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_delta_decoding.md

@@ -7,11 +7,11 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ## Mock VCDiff Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_vcdiff.md` for the full Mock VCDiff Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_vcdiff.md` for the full Mock VCDiff Infrastructure specification.
 
 > **Transport encoding note:** On JSON transport (the default for unit tests),
 > binary vcdiff delta payloads cannot be transmitted as raw bytes — they must be

uts/realtime/unit/channels/channel_detach.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_error.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_get_message.md

@@ -13,4 +13,4 @@ Unit test with mocked HTTP client
 
 **Spec requirement:** `RealtimeChannel#getMessage` function: same as `RestChannel#getMessage`.
 
-`RealtimeChannel#getMessage` uses the same underlying REST endpoint as `RestChannel#getMessage`. The tests in `uts/test/rest/unit/channel/get_message.md` (covering RSL11) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
+`RealtimeChannel#getMessage` uses the same underlying REST endpoint as `RestChannel#getMessage`. The tests in `uts/rest/unit/channel/get_message.md` (covering RSL11) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.

uts/realtime/unit/channels/channel_history.md

@@ -16,7 +16,7 @@ Unit test with mocked HTTP client
 | RTL10a | Supports all the same params as `RestChannel#history` |
 | RTL10c | Returns a `PaginatedResult` page containing the first page of messages |
 
-`RealtimeChannel#history` uses the same underlying REST endpoint as `RestChannel#history`. The tests in `uts/test/rest/unit/channel/history.md` (covering RSL2) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
+`RealtimeChannel#history` uses the same underlying REST endpoint as `RestChannel#history`. The tests in `uts/rest/unit/channel/history.md` (covering RSL2) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
 
 ---
 

uts/realtime/unit/channels/channel_message_versions.md

@@ -13,4 +13,4 @@ Unit test with mocked HTTP client
 
 **Spec requirement:** `RealtimeChannel#getMessageVersions` function: same as `RestChannel#getMessageVersions`.
 
-`RealtimeChannel#getMessageVersions` uses the same underlying REST endpoint as `RestChannel#getMessageVersions`. The tests in `uts/test/rest/unit/channel/message_versions.md` (covering RSL14) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.
+`RealtimeChannel#getMessageVersions` uses the same underlying REST endpoint as `RestChannel#getMessageVersions`. The tests in `uts/rest/unit/channel/message_versions.md` (covering RSL14) should be used to verify that all the same behaviour, parameters, and return types apply when called on a `RealtimeChannel` instance.

uts/realtime/unit/channels/channel_properties.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_publish.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_server_initiated_detach.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket and fake timers
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_state_events.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_subscribe.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_update_delete_message.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/channel_when_state_test.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/channels/message_field_population.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/client/realtime_client.md

@@ -43,7 +43,7 @@ This means: if the state is already `connecting`, proceed immediately; otherwise
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 
@@ -72,7 +72,7 @@ The same test cases apply:
 
 The Realtime client has the same error handling as the REST client for invalid credentials.
 
-**See:** `uts/test/realtime/unit/client/client_options.md` - RSC1b
+**See:** `uts/rest/unit/auth/auth_scheme.md` - RSC1b
 
 Error code 40106 should be raised when no valid credentials are provided.
 
@@ -613,11 +613,11 @@ The following options are shared with the REST client and should behave identica
 | `token` / `tokenDetails` | RSC1c | `uts/test/realtime/unit/client/client_options.md` |
 | `authCallback` / `authUrl` | RSA8 | `unit/auth/auth_callback.md` |
 | `clientId` | RSA7, RSC17 | `unit/auth/client_id.md` |
-| `tls` | RSC18 | `uts/test/rest/unit/rest_client.md` |
+| `tls` | RSC18 | `uts/rest/unit/rest_client.md` |
 | `environment` / `endpoint` | RSC15e, REC1 | `unit/client/fallback.md` |
 | `restHost` / `realtimeHost` | RSC12, TO3k2, TO3k3 | `unit/client/fallback.md` |
 | `fallbackHosts` | RSC15 | `unit/client/fallback.md` |
-| `useBinaryProtocol` | RSC8, TO3f | `uts/test/rest/unit/rest_client.md` |
+| `useBinaryProtocol` | RSC8, TO3f | `uts/rest/unit/rest_client.md` |
 | `logLevel` / `logHandler` | TO3b, TO3c | (not yet specified) |
 
 ### Realtime-Specific Verification for Shared Options
@@ -715,7 +715,7 @@ CLOSE_CLIENT(client)
 
 ## Test Infrastructure Notes
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for mock installation, test isolation, and timer mocking guidance.
+See `uts/realtime/unit/helpers/mock_websocket.md` for mock installation, test isolation, and timer mocking guidance.
 
 ### Channel Naming
 

uts/realtime/unit/client/realtime_request.md

@@ -13,4 +13,4 @@ Unit test with mocked HTTP client
 
 **Spec requirement:** `RealtimeClient#request` is a wrapper around `RestClient#request` (see RSC19) delivered in an idiomatic way for the realtime library.
 
-`RealtimeClient#request` is a direct proxy to `RestClient#request`. The tests in `uts/test/rest/unit/request.md` (covering RSC19) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.
+`RealtimeClient#request` is a direct proxy to `RestClient#request`. The tests in `uts/rest/unit/request.md` (covering RSC19) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.

uts/realtime/unit/client/realtime_stats.md

@@ -16,4 +16,4 @@ Unit test with mocked HTTP client
 | RTC5a | Proxy to `RestClient#stats` presented with an async or threaded interface as appropriate |
 | RTC5b | Accepts all the same params as `RestClient#stats` and provides all the same functionality |
 
-`RealtimeClient#stats` is a direct proxy to `RestClient#stats`. The tests in `uts/test/rest/unit/stats.md` (covering RSC6) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.
+`RealtimeClient#stats` is a direct proxy to `RestClient#stats`. The tests in `uts/rest/unit/stats.md` (covering RSC6) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.

uts/realtime/unit/client/realtime_time.md

@@ -15,4 +15,4 @@ Unit test with mocked HTTP client
 |------|-------------|
 | RTC6a | Proxy to `RestClient#time` presented with an async or threaded interface as appropriate |
 
-`RealtimeClient#time` is a direct proxy to `RestClient#time`. The tests in `uts/test/rest/unit/time.md` (covering RSC16) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.
+`RealtimeClient#time` is a direct proxy to `RestClient#time`. The tests in `uts/rest/unit/time.md` (covering RSC16) should be used to test a `RealtimeClient` instance in place of a `RestClient` instance. All the same behaviour, parameters, and return types apply.

uts/realtime/unit/client/realtime_timeouts.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/connection/auto_connect_test.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---
 

uts/realtime/unit/connection/backoff_jitter_test.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ## Overview
 

uts/realtime/unit/connection/connection_failures_test.md

@@ -7,7 +7,7 @@ Unit test with mocked WebSocket client
 
 ## Mock WebSocket Infrastructure
 
-See `uts/test/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
+See `uts/realtime/unit/helpers/mock_websocket.md` for the full Mock WebSocket Infrastructure specification.
 
 ---