Build 060.25: implement Production Runtime Integration

app/tests/unit/bootstrap/test_app_factory.py

@@ -0,0 +1,166 @@
+from __future__ import annotations
+
+from types import SimpleNamespace
+
+import pytest
+
+import src.bootstrap.app_factory as app_factory
+from src.bootstrap.application import ApplicationComposition
+
+
+class RecordingJournal:
+    def __init__(self) -> None:
+        self.info_calls: list[
+            tuple[str, str, dict[str, object]]
+        ] = []
+
+    def log_info(
+        self,
+        event: str,
+        message: str,
+        context: dict[str, object],
+    ) -> None:
+        self.info_calls.append(
+            (
+                event,
+                message,
+                context,
+            )
+        )
+
+    def log_critical(
+        self,
+        event: str,
+        message: str,
+        context: dict[str, object],
+    ) -> None:
+        del event, message, context
+
+
+def make_settings() -> SimpleNamespace:
+    return SimpleNamespace(
+        bot_token="test-token",
+        bot_parse_mode="HTML",
+        log_level="INFO",
+        app_env="test",
+        exchange_name="dzengi",
+        default_symbol="BTC/USD_LEVERAGE",
+        trade_stream=SimpleNamespace(enabled=True),
+    )
+
+
+def test_create_app_builds_one_application_composition(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    settings = make_settings()
+    bot = object()
+    dispatcher = object()
+    runtime = object()
+    journal = RecordingJournal()
+    observed_runtime_settings: list[object] = []
+    registered_bots: list[object] = []
+    routed_dispatchers: list[object] = []
+
+    monkeypatch.setattr(
+        app_factory,
+        "load_settings",
+        lambda: settings,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "setup_logging",
+        lambda level: None,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "init_schema",
+        lambda: None,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "JournalService",
+        lambda: journal,
+    )
+
+    def build_runtime(received_settings: object) -> object:
+        observed_runtime_settings.append(received_settings)
+        return runtime
+
+    monkeypatch.setattr(
+        app_factory,
+        "build_trade_stream_production_runtime",
+        build_runtime,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "Bot",
+        lambda **kwargs: bot,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "Dispatcher",
+        lambda: dispatcher,
+    )
+    monkeypatch.setattr(
+        app_factory.NotificationTargetRegistry,
+        "set_bot",
+        registered_bots.append,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "setup_routers",
+        routed_dispatchers.append,
+    )
+
+    application = app_factory.create_app()
+
+    assert isinstance(application, ApplicationComposition)
+    assert application.bot is bot
+    assert application.dispatcher is dispatcher
+    assert application.trade_stream_runtime is runtime
+    assert observed_runtime_settings == [settings]
+    assert registered_bots == [bot]
+    assert routed_dispatchers == [dispatcher]
+    assert journal.info_calls[0][2]["trade_stream_enabled"] is True
+
+
+def test_runtime_build_error_is_fatal(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    expected = RuntimeError("invalid Trade Stream settings")
+
+    monkeypatch.setattr(
+        app_factory,
+        "load_settings",
+        make_settings,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "setup_logging",
+        lambda level: None,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "init_schema",
+        lambda: None,
+    )
+    monkeypatch.setattr(
+        app_factory,
+        "JournalService",
+        RecordingJournal,
+    )
+
+    def fail_runtime_build(settings: object) -> None:
+        del settings
+        raise expected
+
+    monkeypatch.setattr(
+        app_factory,
+        "build_trade_stream_production_runtime",
+        fail_runtime_build,
+    )
+
+    with pytest.raises(RuntimeError) as exc_info:
+        app_factory.create_app()
+
+    assert exc_info.value is expected

app/tests/unit/bootstrap/test_application.py

@@ -0,0 +1,442 @@
+from __future__ import annotations
+
+import asyncio
+
+import pytest
+
+from src.bootstrap.application import (
+    ApplicationComposition,
+    run_application,
+)
+from src.market_data.acquisition.runtime.trade_stream_production_runtime import (
+    TradeStreamProductionRuntimeState,
+)
+
+
+class FakeBotSession:
+    def __init__(
+        self,
+        *,
+        close_error: BaseException | None = None,
+    ) -> None:
+        self.close_calls = 0
+        self.close_error = close_error
+
+    async def close(self) -> None:
+        self.close_calls += 1
+
+        if self.close_error is not None:
+            raise self.close_error
+
+
+class FakeBot:
+    def __init__(
+        self,
+        *,
+        close_error: BaseException | None = None,
+    ) -> None:
+        self.session = FakeBotSession(
+            close_error=close_error,
+        )
+
+
+class FakeDispatcher:
+    def __init__(
+        self,
+        *,
+        return_immediately: bool = False,
+        error: BaseException | None = None,
+    ) -> None:
+        self.started = asyncio.Event()
+        self.release = asyncio.Event()
+        self.cancelled = asyncio.Event()
+        self.return_immediately = return_immediately
+        self.error = error
+        self.close_bot_session_values: list[bool] = []
+
+    async def start_polling(
+        self,
+        bot: FakeBot,
+        *,
+        close_bot_session: bool,
+    ) -> None:
+        del bot
+        self.close_bot_session_values.append(close_bot_session)
+        self.started.set()
+
+        try:
+            if not self.return_immediately:
+                await self.release.wait()
+        except asyncio.CancelledError:
+            self.cancelled.set()
+            raise
+
+        if self.error is not None:
+            raise self.error
+
+
+class FakeRuntime:
+    def __init__(
+        self,
+        *,
+        return_immediately: bool = False,
+        error: BaseException | None = None,
+        stop_error: BaseException | None = None,
+    ) -> None:
+        self.started = asyncio.Event()
+        self.release = asyncio.Event()
+        self.stopped = asyncio.Event()
+        self.return_immediately = return_immediately
+        self.error = error
+        self.stop_error = stop_error
+        self.stop_calls = 0
+
+    @property
+    def state(self) -> TradeStreamProductionRuntimeState:
+        return (
+            TradeStreamProductionRuntimeState.RUNNING
+            if self.started.is_set() and not self.stopped.is_set()
+            else TradeStreamProductionRuntimeState.STOPPED
+        )
+
+    @property
+    def running(self) -> bool:
+        return self.state is TradeStreamProductionRuntimeState.RUNNING
+
+    async def run(self) -> None:
+        self.started.set()
+
+        if not self.return_immediately:
+            await self.release.wait()
+
+        if self.error is not None:
+            raise self.error
+
+    async def stop(self) -> None:
+        self.stop_calls += 1
+        self.release.set()
+        self.stopped.set()
+
+        if self.stop_error is not None:
+            raise self.stop_error
+
+
+class BlockingStopRuntime(FakeRuntime):
+    def __init__(self) -> None:
+        super().__init__()
+
+        self.stop_entered = asyncio.Event()
+        self.stop_release = asyncio.Event()
+
+    async def stop(self) -> None:
+        self.stop_calls += 1
+        self.stop_entered.set()
+        await self.stop_release.wait()
+        self.release.set()
+        self.stopped.set()
+
+
+def make_application(
+    *,
+    dispatcher: FakeDispatcher,
+    runtime: FakeRuntime | None,
+    bot: FakeBot | None = None,
+) -> ApplicationComposition:
+    return ApplicationComposition(
+        bot=bot or FakeBot(),  # type: ignore[arg-type]
+        dispatcher=dispatcher,  # type: ignore[arg-type]
+        trade_stream_runtime=runtime,
+    )
+
+
+def test_disabled_runtime_runs_only_polling_and_closes_bot() -> None:
+    async def scenario() -> None:
+        dispatcher = FakeDispatcher(return_immediately=True)
+        bot = FakeBot()
+
+        await run_application(
+            make_application(
+                dispatcher=dispatcher,
+                runtime=None,
+                bot=bot,
+            )
+        )
+
+        assert dispatcher.close_bot_session_values == [False]
+        assert bot.session.close_calls == 1
+
+    asyncio.run(scenario())
+
+
+def test_polling_completion_stops_and_awaits_runtime() -> None:
+    async def scenario() -> None:
+        dispatcher = FakeDispatcher(return_immediately=True)
+        runtime = FakeRuntime()
+        bot = FakeBot()
+
+        await run_application(
+            make_application(
+                dispatcher=dispatcher,
+                runtime=runtime,
+                bot=bot,
+            )
+        )
+
+        assert runtime.started.is_set()
+        assert runtime.stop_calls == 1
+        assert runtime.stopped.is_set()
+        assert bot.session.close_calls == 1
+
+    asyncio.run(scenario())
+
+
+def test_runtime_error_is_fatal_and_stops_polling() -> None:
+    async def scenario() -> None:
+        expected = RuntimeError("trade stream failed")
+        dispatcher = FakeDispatcher()
+        runtime = FakeRuntime(
+            return_immediately=True,
+            error=expected,
+        )
+        bot = FakeBot()
+
+        with pytest.raises(RuntimeError) as exc_info:
+            await run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+
+        assert exc_info.value is expected
+        assert dispatcher.cancelled.is_set()
+        assert runtime.stop_calls == 1
+        assert bot.session.close_calls == 1
+
+    asyncio.run(scenario())
+
+
+def test_normal_runtime_completion_is_fatal() -> None:
+    async def scenario() -> None:
+        dispatcher = FakeDispatcher()
+        runtime = FakeRuntime(return_immediately=True)
+
+        with pytest.raises(
+            RuntimeError,
+            match="terminated unexpectedly",
+        ):
+            await run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                )
+            )
+
+        assert dispatcher.cancelled.is_set()
+        assert runtime.stop_calls == 1
+
+    asyncio.run(scenario())
+
+
+def test_application_cancellation_performs_full_cleanup() -> None:
+    async def scenario() -> None:
+        dispatcher = FakeDispatcher()
+        runtime = FakeRuntime()
+        bot = FakeBot()
+        task = asyncio.create_task(
+            run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+        )
+
+        await dispatcher.started.wait()
+        await runtime.started.wait()
+        task.cancel()
+
+        with pytest.raises(asyncio.CancelledError):
+            await task
+
+        assert dispatcher.cancelled.is_set()
+        assert runtime.stop_calls == 1
+        assert runtime.stopped.is_set()
+        assert bot.session.close_calls == 1
+        await asyncio.sleep(0)
+        assert not {
+            child.get_name()
+            for child in asyncio.all_tasks()
+            if child is not asyncio.current_task()
+            and not child.done()
+            and child.get_name()
+            in {
+                "telegram-polling",
+                "trade-stream-runtime",
+                "application-shutdown",
+            }
+        }
+
+    asyncio.run(scenario())
+
+
+def test_polling_error_stops_runtime_and_preserves_error() -> None:
+    async def scenario() -> None:
+        expected = RuntimeError("polling failed")
+        dispatcher = FakeDispatcher(
+            return_immediately=True,
+            error=expected,
+        )
+        runtime = FakeRuntime()
+        bot = FakeBot()
+
+        with pytest.raises(RuntimeError) as exc_info:
+            await run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+
+        assert exc_info.value is expected
+        assert runtime.stop_calls == 1
+        assert runtime.stopped.is_set()
+        assert bot.session.close_calls == 1
+
+    asyncio.run(scenario())
+
+
+def test_simultaneous_root_failures_are_awaited_deterministically() -> None:
+    async def scenario() -> None:
+        polling_error = RuntimeError("polling failed")
+        runtime_error = ValueError("trade stream failed")
+        dispatcher = FakeDispatcher(
+            error=polling_error,
+        )
+        runtime = FakeRuntime(
+            error=runtime_error,
+        )
+        bot = FakeBot()
+        task = asyncio.create_task(
+            run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+        )
+
+        await dispatcher.started.wait()
+        await runtime.started.wait()
+        dispatcher.release.set()
+        runtime.release.set()
+
+        with pytest.raises(ValueError) as exc_info:
+            await task
+
+        assert exc_info.value is runtime_error
+        assert runtime.stop_calls == 1
+        assert bot.session.close_calls == 1
+        assert any(
+            "cleanup also failed" in note
+            for note in getattr(runtime_error, "__notes__", ())
+        )
+        await asyncio.sleep(0)
+        assert not {
+            child.get_name()
+            for child in asyncio.all_tasks()
+            if child is not asyncio.current_task()
+            and not child.done()
+            and child.get_name()
+            in {
+                "telegram-polling",
+                "trade-stream-runtime",
+                "application-shutdown",
+            }
+        }
+
+    asyncio.run(scenario())
+
+
+def test_repeated_cancellation_does_not_interrupt_cleanup() -> None:
+    async def scenario() -> None:
+        dispatcher = FakeDispatcher()
+        runtime = BlockingStopRuntime()
+        bot = FakeBot()
+        task = asyncio.create_task(
+            run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+        )
+
+        await dispatcher.started.wait()
+        await runtime.started.wait()
+        task.cancel()
+        await runtime.stop_entered.wait()
+
+        task.cancel()
+        runtime.stop_release.set()
+
+        with pytest.raises(asyncio.CancelledError):
+            await task
+
+        assert task.cancelled() is True
+        assert dispatcher.cancelled.is_set()
+        assert runtime.stop_calls == 1
+        assert runtime.stopped.is_set()
+        assert bot.session.close_calls == 1
+        await asyncio.sleep(0)
+        assert not {
+            child.get_name()
+            for child in asyncio.all_tasks()
+            if child is not asyncio.current_task()
+            and not child.done()
+            and child.get_name()
+            in {
+                "telegram-polling",
+                "trade-stream-runtime",
+                "application-shutdown",
+            }
+        }
+
+    asyncio.run(scenario())
+
+
+def test_cleanup_error_does_not_replace_runtime_error() -> None:
+    async def scenario() -> None:
+        expected = RuntimeError("trade stream failed")
+        dispatcher = FakeDispatcher()
+        runtime = FakeRuntime(
+            return_immediately=True,
+            error=expected,
+            stop_error=RuntimeError("stop failed"),
+        )
+        bot = FakeBot(
+            close_error=RuntimeError("close failed"),
+        )
+
+        with pytest.raises(RuntimeError) as exc_info:
+            await run_application(
+                make_application(
+                    dispatcher=dispatcher,
+                    runtime=runtime,
+                    bot=bot,
+                )
+            )
+
+        assert exc_info.value is expected
+        assert bot.session.close_calls == 1
+        assert any(
+            "cleanup also failed" in note
+            for note in getattr(expected, "__notes__", ())
+        )
+
+    asyncio.run(scenario())

app/tests/unit/bootstrap/test_trade_stream_production_integration.py

@@ -0,0 +1,890 @@
+from __future__ import annotations
+
+import asyncio
+import json
+import threading
+import time
+from collections.abc import Awaitable, Callable
+from typing import Any
+
+import pytest
+from websockets.protocol import State
+
+import src.bootstrap.trade_stream_runtime as production_factory
+from src.bootstrap.application import (
+    ApplicationComposition,
+    run_application,
+)
+from src.core.config import Settings, TradeStreamSettings
+from src.market_data.acquisition.adapters.dzengi.websocket_transport import (
+    DzengiWebSocketTransport,
+)
+from src.market_data.acquisition.consistency.trade_stream_state_store import (
+    TradeStreamStateStore,
+)
+from src.market_data.acquisition.exceptions import (
+    TradeTransportError,
+    WebSocketTransportError,
+)
+from src.market_data.acquisition.runtime.trade_stream_production_runtime import (
+    TradeStreamProductionRuntime,
+    TradeStreamProductionRuntimeState,
+)
+
+
+SYMBOL = "BTC/USD_LEVERAGE"
+
+_OWNED_TASK_NAMES = frozenset(
+    {
+        "application-shutdown",
+        "telegram-polling",
+        "trade-stream-receive",
+        "trade-stream-runtime",
+        "trade-stream-runtime-recovery",
+        "trade-stream-scheduler",
+        "trade-stream-startup",
+    }
+)
+
+
+class FakeBotSession:
+    def __init__(self) -> None:
+        self.close_calls = 0
+
+    async def close(self) -> None:
+        self.close_calls += 1
+
+
+class FakeBot:
+    def __init__(self) -> None:
+        self.session = FakeBotSession()
+
+
+class ControlledDispatcher:
+    def __init__(
+        self,
+        *,
+        return_immediately: bool = False,
+    ) -> None:
+        self.return_immediately = return_immediately
+        self.started = asyncio.Event()
+        self.release = asyncio.Event()
+        self.cancelled = asyncio.Event()
+        self.close_bot_session_values: list[bool] = []
+
+    async def start_polling(
+        self,
+        bot: FakeBot,
+        *,
+        close_bot_session: bool,
+    ) -> None:
+        del bot
+        self.close_bot_session_values.append(close_bot_session)
+        self.started.set()
+
+        if self.return_immediately:
+            return
+
+        try:
+            await self.release.wait()
+        except asyncio.CancelledError:
+            self.cancelled.set()
+            raise
+
+
+class ScriptedConnection:
+    def __init__(
+        self,
+        *,
+        name: str,
+        calls: list[str],
+        send_error: Exception | None = None,
+        close_on_receive_error: bool = True,
+    ) -> None:
+        self.name = name
+        self.calls = calls
+        self.send_error = send_error
+        self.close_on_receive_error = close_on_receive_error
+
+        self.state = State.OPEN
+        self.incoming: asyncio.Queue[
+            str | bytes | BaseException
+        ] = asyncio.Queue()
+        self.sent_messages: list[str | bytes] = []
+        self.subscription_sent = asyncio.Event()
+        self.close_calls = 0
+        self.ping_calls = 0
+
+    async def close(
+        self,
+        code: int = 1000,
+        reason: str = "",
+    ) -> None:
+        del code, reason
+        self.calls.append(f"{self.name}.close")
+        self.close_calls += 1
+        self.state = State.CLOSED
+
+    async def send(
+        self,
+        message: str | bytes,
+    ) -> None:
+        self.calls.append(f"{self.name}.send")
+
+        if self.send_error is not None:
+            self.state = State.CLOSED
+            raise self.send_error
+
+        self.sent_messages.append(message)
+        self.subscription_sent.set()
+
+        if not isinstance(message, str):
+            return
+
+        document = json.loads(message)
+
+        if document.get("destination") != "trades.subscribe":
+            return
+
+        self.feed(
+            json.dumps(
+                {
+                    "correlationId": document["correlationId"],
+                    "destination": "trades.subscribe",
+                    "status": "OK",
+                }
+            )
+        )
+
+    async def recv(self) -> str | bytes:
+        item = await self.incoming.get()
+
+        if isinstance(item, BaseException):
+            self.calls.append(f"{self.name}.receive_error")
+
+            if self.close_on_receive_error:
+                self.state = State.CLOSED
+
+            raise item
+
+        self.calls.append(f"{self.name}.receive")
+        return item
+
+    async def ping(self) -> Awaitable[float]:
+        self.calls.append(f"{self.name}.ping")
+        self.ping_calls += 1
+
+        async def wait_for_pong() -> float:
+            return 0.001
+
+        return wait_for_pong()
+
+    def feed(
+        self,
+        item: str | bytes | BaseException,
+    ) -> None:
+        self.incoming.put_nowait(item)
+
+
+class ScriptedConnector:
+    def __init__(
+        self,
+        *,
+        calls: list[str],
+        connections: tuple[ScriptedConnection, ...] = (),
+        error: Exception | None = None,
+    ) -> None:
+        self.calls = calls
+        self.connections = list(connections)
+        self.error = error
+        self.options: list[dict[str, Any]] = []
+
+    async def __call__(
+        self,
+        url: str,
+        **kwargs: Any,
+    ) -> ScriptedConnection:
+        self.calls.append("connector.connect")
+        self.options.append(
+            {
+                "url": url,
+                **kwargs,
+            }
+        )
+
+        if self.error is not None:
+            raise self.error
+
+        return self.connections.pop(0)
+
+
+class BlockingRestClient:
+    def __init__(
+        self,
+        *,
+        calls: list[str],
+        document: object,
+        error: Exception | None = None,
+    ) -> None:
+        self.calls = calls
+        self.document = document
+        self.error = error
+        self.entered = threading.Event()
+        self.release = threading.Event()
+        self.requests: list[
+            tuple[str, dict[str, str] | None]
+        ] = []
+
+    def get_payload(
+        self,
+        path: str,
+        params: dict[str, str] | None = None,
+        headers: dict[str, str] | None = None,
+    ) -> object:
+        del headers
+        self.calls.append("recovery.fetch")
+        self.requests.append(
+            (
+                path,
+                params,
+            )
+        )
+        self.entered.set()
+
+        if not self.release.wait(timeout=5):
+            raise TimeoutError("test did not release REST recovery")
+
+        if self.error is not None:
+            raise self.error
+
+        return self.document
+
+
+def make_settings(
+    *,
+    enabled: bool = True,
+) -> Settings:
+    return Settings(
+        bot_token="test-token",
+        bot_parse_mode="HTML",
+        app_env="test",
+        log_level="INFO",
+        tz="UTC",
+        exchange_enabled=True,
+        exchange_name="dzengi",
+        exchange_base_url="https://rest.example.test",
+        exchange_ws_url="wss://legacy.example.test",
+        exchange_api_key="",
+        exchange_api_secret="",
+        exchange_timeout_sec=10,
+        exchange_testnet=True,
+        default_symbol="LEGACY",
+        trade_stream=TradeStreamSettings(
+            enabled=enabled,
+            websocket_url="wss://stream.example.test",
+            symbols=(SYMBOL,),
+            open_timeout_seconds=1.0,
+            probe_timeout_seconds=1.0,
+            close_timeout_seconds=1.0,
+            heartbeat_timeout_seconds=120.0,
+            scheduler_interval_seconds=60.0,
+            recovery_window_ms=3_599_999,
+        ),
+        db_host="localhost",
+        db_port=5432,
+        db_name="test",
+        db_user="test",
+        db_password="test",
+        debug_enabled=False,
+        journal_debug_enabled=False,
+    )
+
+
+def make_trade_document(
+    *,
+    trade_id: int,
+    timestamp: int,
+) -> dict[str, object]:
+    return {
+        "status": "OK",
+        "destination": "internal.trade",
+        "payload": {
+            "id": trade_id,
+            "price": "64555.55",
+            "size": "0.002",
+            "ts": timestamp,
+            "symbol": SYMBOL,
+            "buyer": True,
+            "orderId": f"order-{trade_id}",
+        },
+    }
+
+
+def make_recovered_trade(
+    *,
+    trade_id: int,
+    timestamp: int,
+) -> dict[str, object]:
+    return {
+        "a": trade_id,
+        "p": "64555.56",
+        "q": "0.003",
+        "T": timestamp,
+        "m": False,
+    }
+
+
+def install_connector(
+    monkeypatch: pytest.MonkeyPatch,
+    connector: ScriptedConnector,
+) -> list[DzengiWebSocketTransport]:
+    transport_type = production_factory.DzengiWebSocketTransport
+    transports: list[DzengiWebSocketTransport] = []
+
+    def build_transport(
+        **kwargs: Any,
+    ) -> DzengiWebSocketTransport:
+        transport = transport_type(
+            connector=connector,
+            **kwargs,
+        )
+        transports.append(transport)
+        return transport
+
+    monkeypatch.setattr(
+        production_factory,
+        "DzengiWebSocketTransport",
+        build_transport,
+    )
+
+    return transports
+
+
+def make_application(
+    *,
+    runtime: TradeStreamProductionRuntime | None,
+    dispatcher: ControlledDispatcher,
+    bot: FakeBot,
+) -> ApplicationComposition:
+    return ApplicationComposition(
+        bot=bot,  # type: ignore[arg-type]
+        dispatcher=dispatcher,  # type: ignore[arg-type]
+        trade_stream_runtime=runtime,
+    )
+
+
+async def wait_until(
+    predicate: Callable[[], bool],
+) -> None:
+    for _ in range(1_000):
+        if predicate():
+            return
+
+        await asyncio.sleep(0)
+
+    raise AssertionError("condition was not reached")
+
+
+async def assert_no_owned_tasks() -> None:
+    await asyncio.sleep(0)
+
+    assert not {
+        task.get_name()
+        for task in asyncio.all_tasks()
+        if task is not asyncio.current_task()
+        and not task.done()
+        and task.get_name() in _OWNED_TASK_NAMES
+    }
+
+
+def state_store_from(
+    runtime: TradeStreamProductionRuntime,
+) -> TradeStreamStateStore:
+    return (
+        runtime
+        ._reconnect_recovery_coordinator
+        ._recovery_coordinator
+        ._state_store
+    )
+
+
+def test_disabled_feature_runs_only_telegram_without_runtime_graph(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    def forbidden_dependency(
+        *args: Any,
+        **kwargs: Any,
+    ) -> None:
+        del args, kwargs
+        raise AssertionError("disabled feature built a dependency")
+
+    monkeypatch.setattr(
+        production_factory,
+        "DzengiWebSocketTransport",
+        forbidden_dependency,
+    )
+    monkeypatch.setattr(
+        production_factory,
+        "ExchangeRestClient",
+        forbidden_dependency,
+    )
+
+    runtime = (
+        production_factory.build_trade_stream_production_runtime(
+            make_settings(enabled=False),
+        )
+    )
+
+    async def scenario() -> None:
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher(
+            return_immediately=True,
+        )
+
+        await run_application(
+            make_application(
+                runtime=runtime,
+                dispatcher=dispatcher,
+                bot=bot,
+            )
+        )
+
+        assert dispatcher.close_bot_session_values == [False]
+        assert bot.session.close_calls == 1
+        await assert_no_owned_tasks()
+
+    assert runtime is None
+    asyncio.run(scenario())
+
+
+def test_production_factory_processes_ack_trade_and_shutdown(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    async def scenario() -> None:
+        calls: list[str] = []
+        connection = ScriptedConnection(
+            name="connection",
+            calls=calls,
+        )
+        connector = ScriptedConnector(
+            calls=calls,
+            connections=(connection,),
+        )
+        transports = install_connector(
+            monkeypatch,
+            connector,
+        )
+        runtime = (
+            production_factory.build_trade_stream_production_runtime(
+                make_settings(),
+            )
+        )
+
+        assert isinstance(runtime, TradeStreamProductionRuntime)
+
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher()
+        application_task = asyncio.create_task(
+            run_application(
+                make_application(
+                    runtime=runtime,
+                    dispatcher=dispatcher,
+                    bot=bot,
+                )
+            )
+        )
+
+        await connection.subscription_sent.wait()
+
+        timestamp = time.time_ns() // 1_000_000
+        connection.feed(
+            json.dumps(
+                make_trade_document(
+                    trade_id=100,
+                    timestamp=timestamp,
+                )
+            )
+        )
+
+        state_store = state_store_from(runtime)
+        await wait_until(
+            lambda: (
+                state_store.contains(SYMBOL)
+                and state_store.get(SYMBOL).last_trade_id == 100
+            )
+        )
+
+        dispatcher.release.set()
+        await application_task
+
+        subscription = json.loads(
+            connection.sent_messages[0],
+        )
+
+        assert subscription["destination"] == "trades.subscribe"
+        assert subscription["payload"]["symbols"] == [SYMBOL]
+        assert connector.options[0]["ping_interval"] is None
+        assert connector.options[0]["ping_timeout"] is None
+        assert connection.close_calls == 1
+        assert runtime.state is (
+            TradeStreamProductionRuntimeState.STOPPED
+        )
+        assert runtime._subscription_manager.subscription_keys == ()
+        assert bot.session.close_calls == 1
+        assert len(transports) == 1
+        await assert_no_owned_tasks()
+
+    asyncio.run(scenario())
+
+
+def test_connection_startup_failure_is_fatal_and_leaves_no_tasks(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    async def scenario() -> None:
+        calls: list[str] = []
+        connector = ScriptedConnector(
+            calls=calls,
+            error=OSError("connect failed"),
+        )
+        install_connector(
+            monkeypatch,
+            connector,
+        )
+        runtime = (
+            production_factory.build_trade_stream_production_runtime(
+                make_settings(),
+            )
+        )
+
+        assert isinstance(runtime, TradeStreamProductionRuntime)
+
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher()
+
+        with pytest.raises(
+            WebSocketTransportError,
+            match="connect failed",
+        ) as exc_info:
+            await run_application(
+                make_application(
+                    runtime=runtime,
+                    dispatcher=dispatcher,
+                    bot=bot,
+                )
+            )
+
+        assert isinstance(exc_info.value.__cause__, OSError)
+        assert dispatcher.cancelled.is_set()
+        assert runtime.state is (
+            TradeStreamProductionRuntimeState.FAILED
+        )
+        assert runtime._session.is_connected is False
+        assert runtime._subscription_manager.subscription_keys == ()
+        assert bot.session.close_calls == 1
+        await assert_no_owned_tasks()
+
+    asyncio.run(scenario())
+
+
+def test_subscription_startup_failure_rolls_back_concrete_graph(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    async def scenario() -> None:
+        calls: list[str] = []
+        connection = ScriptedConnection(
+            name="connection",
+            calls=calls,
+            send_error=OSError("subscription failed"),
+        )
+        connector = ScriptedConnector(
+            calls=calls,
+            connections=(connection,),
+        )
+        install_connector(
+            monkeypatch,
+            connector,
+        )
+        runtime = (
+            production_factory.build_trade_stream_production_runtime(
+                make_settings(),
+            )
+        )
+
+        assert isinstance(runtime, TradeStreamProductionRuntime)
+
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher()
+
+        with pytest.raises(
+            WebSocketTransportError,
+            match="subscription failed",
+        ):
+            await run_application(
+                make_application(
+                    runtime=runtime,
+                    dispatcher=dispatcher,
+                    bot=bot,
+                )
+            )
+
+        assert dispatcher.cancelled.is_set()
+        assert connection.state is State.CLOSED
+        assert runtime.state is (
+            TradeStreamProductionRuntimeState.FAILED
+        )
+        assert runtime._session.is_connected is False
+        assert runtime._subscription_manager.subscription_keys == ()
+        assert bot.session.close_calls == 1
+        await assert_no_owned_tasks()
+
+    asyncio.run(scenario())
+
+
+def test_reconnect_restores_recovers_then_processes_buffered_trade(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    async def scenario() -> None:
+        calls: list[str] = []
+        first_connection = ScriptedConnection(
+            name="first",
+            calls=calls,
+            close_on_receive_error=False,
+        )
+        second_connection = ScriptedConnection(
+            name="second",
+            calls=calls,
+        )
+        connector = ScriptedConnector(
+            calls=calls,
+            connections=(
+                first_connection,
+                second_connection,
+            ),
+        )
+        install_connector(
+            monkeypatch,
+            connector,
+        )
+
+        live_timestamp = (
+            time.time_ns() // 1_000_000
+        ) - 10_000
+        rest_client = BlockingRestClient(
+            calls=calls,
+            document=[
+                make_recovered_trade(
+                    trade_id=101,
+                    timestamp=live_timestamp + 1,
+                )
+            ],
+        )
+        monkeypatch.setattr(
+            production_factory,
+            "ExchangeRestClient",
+            lambda settings: rest_client,
+        )
+
+        runtime = (
+            production_factory.build_trade_stream_production_runtime(
+                make_settings(),
+            )
+        )
+
+        assert isinstance(runtime, TradeStreamProductionRuntime)
+
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher()
+        application_task = asyncio.create_task(
+            run_application(
+                make_application(
+                    runtime=runtime,
+                    dispatcher=dispatcher,
+                    bot=bot,
+                )
+            )
+        )
+
+        await first_connection.subscription_sent.wait()
+        first_connection.feed(
+            json.dumps(
+                make_trade_document(
+                    trade_id=100,
+                    timestamp=live_timestamp,
+                )
+            )
+        )
+
+        state_store = state_store_from(runtime)
+        await wait_until(
+            lambda: (
+                state_store.contains(SYMBOL)
+                and state_store.get(SYMBOL).last_trade_id == 100
+            )
+        )
+
+        first_connection.feed(
+            OSError("connection dropped"),
+        )
+
+        await wait_until(rest_client.entered.is_set)
+
+        assert second_connection.subscription_sent.is_set()
+        assert state_store.get(SYMBOL).last_trade_id == 100
+
+        second_connection.feed(
+            json.dumps(
+                make_trade_document(
+                    trade_id=102,
+                    timestamp=live_timestamp + 2,
+                )
+            )
+        )
+        rest_client.release.set()
+
+        await wait_until(
+            lambda: state_store.get(SYMBOL).last_trade_id == 102
+        )
+
+        dispatcher.release.set()
+        await application_task
+
+        state = state_store.get(SYMBOL)
+
+        assert state.last_trade_id == 102
+        assert state.last_trade is not None
+        assert state.last_trade.executed_at.timestamp() == pytest.approx(
+            (live_timestamp + 2) / 1_000,
+        )
+        assert len(connector.options) == 2
+        assert first_connection.close_calls == 1
+        assert second_connection.close_calls == 1
+        assert len(first_connection.sent_messages) == 1
+        assert len(second_connection.sent_messages) == 1
+        assert calls.index("second.send") < calls.index(
+            "recovery.fetch"
+        )
+        assert rest_client.requests[0][0] == "/api/v1/aggTrades"
+        request_params = rest_client.requests[0][1]
+
+        assert request_params is not None
+        assert request_params["symbol"] == SYMBOL
+        assert runtime._reconnect_recovery_coordinator.generation == 1
+        assert runtime.state is (
+            TradeStreamProductionRuntimeState.STOPPED
+        )
+        assert bot.session.close_calls == 1
+        await assert_no_owned_tasks()
+
+    asyncio.run(scenario())
+
+
+def test_recovery_failure_rejects_buffered_trade_and_cleans_up(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    async def scenario() -> None:
+        calls: list[str] = []
+        first_connection = ScriptedConnection(
+            name="first",
+            calls=calls,
+            close_on_receive_error=False,
+        )
+        second_connection = ScriptedConnection(
+            name="second",
+            calls=calls,
+        )
+        connector = ScriptedConnector(
+            calls=calls,
+            connections=(
+                first_connection,
+                second_connection,
+            ),
+        )
+        install_connector(
+            monkeypatch,
+            connector,
+        )
+
+        live_timestamp = (
+            time.time_ns() // 1_000_000
+        ) - 10_000
+        rest_client = BlockingRestClient(
+            calls=calls,
+            document=[],
+            error=OSError("recovery failed"),
+        )
+        monkeypatch.setattr(
+            production_factory,
+            "ExchangeRestClient",
+            lambda settings: rest_client,
+        )
+
+        runtime = (
+            production_factory.build_trade_stream_production_runtime(
+                make_settings(),
+            )
+        )
+
+        assert isinstance(runtime, TradeStreamProductionRuntime)
+
+        bot = FakeBot()
+        dispatcher = ControlledDispatcher()
+        application_task = asyncio.create_task(
+            run_application(
+                make_application(
+                    runtime=runtime,
+                    dispatcher=dispatcher,
+                    bot=bot,
+                )
+            )
+        )
+
+        await first_connection.subscription_sent.wait()
+        first_connection.feed(
+            json.dumps(
+                make_trade_document(
+                    trade_id=100,
+                    timestamp=live_timestamp,
+                )
+            )
+        )
+
+        state_store = state_store_from(runtime)
+        await wait_until(
+            lambda: (
+                state_store.contains(SYMBOL)
+                and state_store.get(SYMBOL).last_trade_id == 100
+            )
+        )
+
+        first_connection.feed(
+            OSError("connection dropped"),
+        )
+        await wait_until(rest_client.entered.is_set)
+
+        second_connection.feed(
+            json.dumps(
+                make_trade_document(
+                    trade_id=102,
+                    timestamp=live_timestamp + 2,
+                )
+            )
+        )
+        rest_client.release.set()
+
+        with pytest.raises(
+            TradeTransportError,
+            match="recovery failed",
+        ):
+            await application_task
+
+        assert state_store.get(SYMBOL).last_trade_id == 100
+        assert runtime._live_processing_gate.failed is True
+        assert dispatcher.cancelled.is_set()
+        assert runtime.state is (
+            TradeStreamProductionRuntimeState.FAILED
+        )
+        assert second_connection.close_calls == 1
+        assert bot.session.close_calls == 1
+        await assert_no_owned_tasks()
+
+    asyncio.run(scenario())

app/tests/unit/bootstrap/test_trade_stream_runtime.py

@@ -0,0 +1,157 @@
+from __future__ import annotations
+
+from src.bootstrap.trade_stream_runtime import (
+    build_trade_stream_production_runtime,
+)
+from src.core.config import Settings, TradeStreamSettings
+from src.market_data.acquisition.runtime.trade_stream_production_runtime import (
+    TradeStreamProductionRuntime,
+    TradeStreamProductionRuntimeState,
+)
+
+
+def make_settings(
+    *,
+    enabled: bool = True,
+    api_key: str = "api-key",
+) -> Settings:
+    return Settings(
+        bot_token="test-token",
+        bot_parse_mode="HTML",
+        app_env="test",
+        log_level="INFO",
+        tz="UTC",
+        exchange_enabled=False,
+        exchange_name="dzengi",
+        exchange_base_url="https://rest.example.test/",
+        exchange_ws_url="wss://legacy.example.test",
+        exchange_api_key=api_key,
+        exchange_api_secret="secret",
+        exchange_timeout_sec=17,
+        exchange_testnet=True,
+        default_symbol="LEGACY",
+        trade_stream=TradeStreamSettings(
+            enabled=enabled,
+            websocket_url="wss://stream.example.test/root",
+            symbols=(
+                "ETH/USD_LEVERAGE",
+                "BTC/USD_LEVERAGE",
+            ),
+            open_timeout_seconds=11.0,
+            probe_timeout_seconds=21.0,
+            close_timeout_seconds=9.0,
+            heartbeat_timeout_seconds=31.0,
+            scheduler_interval_seconds=6.0,
+            recovery_window_ms=123_456,
+        ),
+        db_host="localhost",
+        db_port=5432,
+        db_name="test",
+        db_user="test",
+        db_password="test",
+        debug_enabled=False,
+        journal_debug_enabled=False,
+    )
+
+
+def test_disabled_feature_does_not_build_runtime() -> None:
+    settings = make_settings(enabled=False)
+
+    assert build_trade_stream_production_runtime(settings) is None
+
+
+def test_builds_runtime_without_starting_lifecycle() -> None:
+    runtime = build_trade_stream_production_runtime(
+        make_settings(),
+    )
+
+    assert isinstance(runtime, TradeStreamProductionRuntime)
+    assert runtime.state is TradeStreamProductionRuntimeState.STOPPED
+    assert runtime.running is False
+    assert runtime._startup_task is None
+    assert runtime._receive_task is None
+    assert runtime._scheduler_task is None
+
+
+def test_uses_one_shared_stateful_dependency_graph() -> None:
+    runtime = build_trade_stream_production_runtime(
+        make_settings(),
+    )
+
+    assert isinstance(runtime, TradeStreamProductionRuntime)
+
+    transport = runtime._transport
+    service = runtime._trade_stream_service
+    reconnect_recovery = runtime._reconnect_recovery_coordinator
+    recovery = reconnect_recovery._recovery_coordinator
+
+    assert runtime._session._transport is transport
+    assert runtime._subscription_manager._transport is transport
+    assert runtime._runtime_scheduler.liveness_probe is transport
+    assert (
+        service._consistency_controller
+        is recovery._recovery_controller._consistency_controller
+    )
+    assert runtime._live_processing_gate is (
+        reconnect_recovery.live_processing_gate
+    )
+    assert runtime._runtime_scheduler.runtime_supervisor is (
+        runtime._runtime_supervisor
+    )
+
+
+def test_applies_explicit_transport_and_runtime_settings() -> None:
+    settings = make_settings()
+
+    runtime = build_trade_stream_production_runtime(settings)
+
+    assert isinstance(runtime, TradeStreamProductionRuntime)
+    transport = runtime._transport
+
+    assert transport._url == "wss://stream.example.test/root/connect"
+    assert transport._headers == {
+        "Origin": "https://rest.example.test",
+        "Content-Type": "application/json",
+        "X-MBX-APIKEY": "api-key",
+    }
+    assert transport._open_timeout == 11.0
+    assert transport._probe_timeout == 21.0
+    assert transport._close_timeout == 9.0
+    assert transport._ping_interval is None
+    assert transport._ping_timeout is None
+    assert runtime._symbols == (
+        "BTC/USD_LEVERAGE",
+        "ETH/USD_LEVERAGE",
+    )
+    assert runtime._runtime_scheduler.interval_seconds == 6.0
+    assert (
+        runtime._runtime_supervisor._heartbeat_monitor.timeout_seconds
+        == 31.0
+    )
+    assert (
+        runtime._reconnect_recovery_coordinator
+        ._recovery_coordinator
+        ._window_planner
+        .max_window_ms
+        == 123_456
+    )
+
+
+def test_recovery_rest_client_reuses_settings_snapshot() -> None:
+    settings = make_settings(api_key="")
+
+    runtime = build_trade_stream_production_runtime(settings)
+
+    assert isinstance(runtime, TradeStreamProductionRuntime)
+    document_source = (
+        runtime._reconnect_recovery_coordinator
+        ._recovery_coordinator
+        ._recovery_controller
+        ._document_source
+    )
+    rest_client = document_source._client
+
+    assert rest_client.settings is settings
+    assert rest_client.base_url == "https://rest.example.test"
+    assert rest_client.timeout == 17
+    assert "X-MBX-APIKEY" not in runtime._transport._headers

app/tests/unit/core/test_config.py

@@ -0,0 +1,202 @@
+from __future__ import annotations
+
+import pytest
+
+from src.core.config import load_settings
+
+
+_TRADE_STREAM_VARIABLES = (
+    "TRADE_STREAM_ENABLED",
+    "TRADE_STREAM_WS_URL",
+    "TRADE_STREAM_SYMBOLS",
+    "TRADE_STREAM_OPEN_TIMEOUT_SECONDS",
+    "TRADE_STREAM_PROBE_TIMEOUT_SECONDS",
+    "TRADE_STREAM_CLOSE_TIMEOUT_SECONDS",
+    "TRADE_STREAM_HEARTBEAT_TIMEOUT_SECONDS",
+    "TRADE_STREAM_SCHEDULER_INTERVAL_SECONDS",
+    "TRADE_STREAM_RECOVERY_WINDOW_MS",
+)
+
+
+def prepare_environment(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    monkeypatch.setenv("BOT_TOKEN", "test-token")
+    monkeypatch.delenv("EXCHANGE_BASE_URL", raising=False)
+    monkeypatch.delenv("EXCHANGE_ENABLED", raising=False)
+
+    for variable in _TRADE_STREAM_VARIABLES:
+        monkeypatch.delenv(variable, raising=False)
+
+
+def enable_trade_stream(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    monkeypatch.setenv("TRADE_STREAM_ENABLED", "true")
+    monkeypatch.setenv(
+        "TRADE_STREAM_WS_URL",
+        "wss://stream.example.test",
+    )
+    monkeypatch.setenv(
+        "TRADE_STREAM_SYMBOLS",
+        "ETH/USD_LEVERAGE,BTC/USD_LEVERAGE",
+    )
+    monkeypatch.setenv(
+        "EXCHANGE_BASE_URL",
+        "https://rest.example.test",
+    )
+
+
+def test_trade_stream_is_disabled_by_default(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    prepare_environment(monkeypatch)
+    monkeypatch.setenv("EXCHANGE_ENABLED", "true")
+
+    settings = load_settings()
+
+    assert settings.exchange_enabled is True
+    assert settings.trade_stream.enabled is False
+    assert settings.trade_stream.websocket_url == ""
+    assert settings.trade_stream.symbols == ()
+
+
+def test_disabled_trade_stream_ignores_dependent_values(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    prepare_environment(monkeypatch)
+    monkeypatch.setenv("TRADE_STREAM_OPEN_TIMEOUT_SECONDS", "invalid")
+    monkeypatch.setenv("TRADE_STREAM_SYMBOLS", ",")
+
+    settings = load_settings()
+
+    assert settings.trade_stream.enabled is False
+
+
+def test_trade_stream_flag_is_strict(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    prepare_environment(monkeypatch)
+    monkeypatch.setenv("TRADE_STREAM_ENABLED", "sometimes")
+
+    with pytest.raises(
+        ValueError,
+        match="TRADE_STREAM_ENABLED",
+    ):
+        load_settings()
+
+
+@pytest.mark.parametrize(
+    ("missing_variable", "message"),
+    (
+        (
+            "TRADE_STREAM_WS_URL",
+            "TRADE_STREAM_WS_URL",
+        ),
+        (
+            "TRADE_STREAM_SYMBOLS",
+            "TRADE_STREAM_SYMBOLS",
+        ),
+        (
+            "EXCHANGE_BASE_URL",
+            "EXCHANGE_BASE_URL",
+        ),
+    ),
+)
+def test_enabled_trade_stream_requires_explicit_endpoints_and_symbols(
+    monkeypatch: pytest.MonkeyPatch,
+    missing_variable: str,
+    message: str,
+) -> None:
+    prepare_environment(monkeypatch)
+    enable_trade_stream(monkeypatch)
+    monkeypatch.setenv(
+        "EXCHANGE_WS_URL",
+        "wss://legacy-fallback.example.test",
+    )
+    monkeypatch.setenv(
+        "DEFAULT_SYMBOL",
+        "LEGACY_FALLBACK",
+    )
+    monkeypatch.delenv(missing_variable)
+
+    with pytest.raises(
+        RuntimeError,
+        match=message,
+    ):
+        load_settings()
+
+
+def test_enabled_trade_stream_parses_independent_settings(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    prepare_environment(monkeypatch)
+    enable_trade_stream(monkeypatch)
+    monkeypatch.setenv(
+        "TRADE_STREAM_SYMBOLS",
+        " ETH/USD_LEVERAGE, BTC/USD_LEVERAGE,ETH/USD_LEVERAGE ",
+    )
+    monkeypatch.setenv("TRADE_STREAM_OPEN_TIMEOUT_SECONDS", "11.5")
+    monkeypatch.setenv("TRADE_STREAM_PROBE_TIMEOUT_SECONDS", "21")
+    monkeypatch.setenv("TRADE_STREAM_CLOSE_TIMEOUT_SECONDS", "9")
+    monkeypatch.setenv("TRADE_STREAM_HEARTBEAT_TIMEOUT_SECONDS", "31")
+    monkeypatch.setenv("TRADE_STREAM_SCHEDULER_INTERVAL_SECONDS", "6")
+    monkeypatch.setenv("TRADE_STREAM_RECOVERY_WINDOW_MS", "123456")
+
+    settings = load_settings()
+    trade_stream = settings.trade_stream
+
+    assert trade_stream.enabled is True
+    assert trade_stream.websocket_url == "wss://stream.example.test"
+    assert trade_stream.symbols == (
+        "BTC/USD_LEVERAGE",
+        "ETH/USD_LEVERAGE",
+    )
+    assert trade_stream.open_timeout_seconds == 11.5
+    assert trade_stream.probe_timeout_seconds == 21.0
+    assert trade_stream.close_timeout_seconds == 9.0
+    assert trade_stream.heartbeat_timeout_seconds == 31.0
+    assert trade_stream.scheduler_interval_seconds == 6.0
+    assert trade_stream.recovery_window_ms == 123_456
+
+
+@pytest.mark.parametrize(
+    ("variable", "value"),
+    (
+        ("TRADE_STREAM_OPEN_TIMEOUT_SECONDS", "0"),
+        ("TRADE_STREAM_PROBE_TIMEOUT_SECONDS", "-1"),
+        ("TRADE_STREAM_CLOSE_TIMEOUT_SECONDS", "nan"),
+        ("TRADE_STREAM_HEARTBEAT_TIMEOUT_SECONDS", "inf"),
+        ("TRADE_STREAM_SCHEDULER_INTERVAL_SECONDS", "invalid"),
+        ("TRADE_STREAM_RECOVERY_WINDOW_MS", "1.5"),
+        ("TRADE_STREAM_RECOVERY_WINDOW_MS", "0"),
+    ),
+)
+def test_enabled_trade_stream_rejects_invalid_numeric_settings(
+    monkeypatch: pytest.MonkeyPatch,
+    variable: str,
+    value: str,
+) -> None:
+    prepare_environment(monkeypatch)
+    enable_trade_stream(monkeypatch)
+    monkeypatch.setenv(variable, value)
+
+    with pytest.raises(ValueError, match=variable):
+        load_settings()
+
+
+def test_symbols_must_not_contain_empty_items(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    prepare_environment(monkeypatch)
+    enable_trade_stream(monkeypatch)
+    monkeypatch.setenv(
+        "TRADE_STREAM_SYMBOLS",
+        "BTC/USD_LEVERAGE,,ETH/USD_LEVERAGE",
+    )
+
+    with pytest.raises(
+        ValueError,
+        match="empty symbols",
+    ):
+        load_settings()

app/tests/unit/market_data/acquisition/adapters/dzengi/test_websocket_control_message_handler.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import pytest
+
+from src.market_data.acquisition.adapters.dzengi.websocket_control_message_handler import (
+    DzengiWebSocketControlMessageHandler,
+)
+from src.market_data.acquisition.exceptions import (
+    WebSocketControlMessageError,
+    WebSocketMessageRoutingError,
+)
+from src.market_data.acquisition.runtime.websocket_inbound_message import (
+    WebSocketControlMessageHandlerProtocol,
+)
+
+
+CORRELATION_ID = "trade-subscription-1"
+
+
+@pytest.fixture
+def handler() -> DzengiWebSocketControlMessageHandler:
+    return DzengiWebSocketControlMessageHandler()
+
+
+def test_implements_public_protocol_and_uses_slots(
+    handler: DzengiWebSocketControlMessageHandler,
+) -> None:
+    assert isinstance(
+        handler,
+        WebSocketControlMessageHandlerProtocol,
+    )
+    assert not hasattr(handler, "__dict__")
+
+
+def test_accepts_matching_successful_subscription_ack(
+    handler: DzengiWebSocketControlMessageHandler,
+) -> None:
+    handler.handle(
+        {
+            "correlationId": CORRELATION_ID,
+            "destination": "trades.subscribe",
+            "status": "OK",
+        },
+        expected_correlation_id=CORRELATION_ID,
+    )
+
+
+def test_rejects_negative_subscription_ack(
+    handler: DzengiWebSocketControlMessageHandler,
+) -> None:
+    with pytest.raises(
+        WebSocketControlMessageError,
+        match="отклонил",
+    ):
+        handler.handle(
+            {
+                "correlationId": CORRELATION_ID,
+                "status": "ERROR",
+                "payload": {
+                    "errorCode": "BAD_REQUEST",
+                },
+            },
+            expected_correlation_id=CORRELATION_ID,
+        )
+
+
+@pytest.mark.parametrize(
+    "document",
+    [
+        None,
+        {},
+        {
+            "correlationId": "unknown",
+            "destination": "trades.subscribe",
+            "status": "OK",
+        },
+        {
+            "correlationId": CORRELATION_ID,
+            "destination": "unknown",
+            "status": "OK",
+        },
+        {
+            "correlationId": CORRELATION_ID,
+            "destination": "trades.subscribe",
+        },
+        {
+            "correlationId": CORRELATION_ID,
+            "destination": "trades.subscribe",
+            "status": "",
+        },
+        {
+            "correlationId": CORRELATION_ID,
+            "destination": "trades.subscribe",
+            "status": None,
+        },
+    ],
+)
+def test_rejects_unknown_or_malformed_control_messages(
+    handler: DzengiWebSocketControlMessageHandler,
+    document: object,
+) -> None:
+    with pytest.raises(WebSocketMessageRoutingError):
+        handler.handle(
+            document,
+            expected_correlation_id=CORRELATION_ID,
+        )

app/tests/unit/market_data/acquisition/adapters/dzengi/test_websocket_inbound_message_classifier.py

@@ -0,0 +1,137 @@
+from __future__ import annotations
+
+import pytest
+
+from src.market_data.acquisition.adapters.dzengi.websocket_inbound_message_classifier import (
+    DzengiWebSocketInboundMessageClassifier,
+)
+from src.market_data.acquisition.exceptions import (
+    WebSocketMessageRoutingError,
+)
+from src.market_data.acquisition.runtime.websocket_inbound_message import (
+    WebSocketInboundMessageClassifierProtocol,
+    WebSocketInboundMessageKind,
+)
+
+
+@pytest.fixture
+def classifier() -> DzengiWebSocketInboundMessageClassifier:
+    return DzengiWebSocketInboundMessageClassifier()
+
+
+def test_implements_public_protocol(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+) -> None:
+    assert isinstance(
+        classifier,
+        WebSocketInboundMessageClassifierProtocol,
+    )
+
+
+def test_uses_slots(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+) -> None:
+    assert not hasattr(
+        classifier,
+        "__dict__",
+    )
+
+
+@pytest.mark.parametrize(
+    "document",
+    [
+        {
+            "destination": "internal.trade",
+        },
+        {
+            "destination": "ohlc.event",
+        },
+        {
+            "Payload": {},
+        },
+    ],
+)
+def test_recognizes_market_documents(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+    document: object,
+) -> None:
+    assert (
+        classifier.classify(document)
+        is WebSocketInboundMessageKind.MARKET
+    )
+
+
+@pytest.mark.parametrize(
+    "correlation_id",
+    [
+        "request-1",
+        1,
+    ],
+)
+def test_recognizes_control_responses(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+    correlation_id: str | int,
+) -> None:
+    assert (
+        classifier.classify(
+            {
+                "correlationId": correlation_id,
+                "destination": "trades.subscribe",
+            }
+        )
+        is WebSocketInboundMessageKind.CONTROL
+    )
+
+
+def test_market_markers_take_priority_over_correlation_id(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+) -> None:
+    assert (
+        classifier.classify(
+            {
+                "destination": "internal.trade",
+                "correlationId": "request-1",
+            }
+        )
+        is WebSocketInboundMessageKind.MARKET
+    )
+
+
+@pytest.mark.parametrize(
+    "document",
+    [
+        None,
+        [],
+        "message",
+        {},
+        {
+            "destination": "unknown",
+        },
+        {
+            "destination": [],
+        },
+        {
+            "correlationId": "",
+        },
+        {
+            "correlationId": "   ",
+        },
+        {
+            "correlationId": None,
+        },
+        {
+            "correlationId": True,
+        },
+        {
+            "correlationId": 1.5,
+        },
+    ],
+)
+def test_rejects_invalid_or_unknown_documents(
+    classifier: DzengiWebSocketInboundMessageClassifier,
+    document: object,
+) -> None:
+    with pytest.raises(
+        WebSocketMessageRoutingError,
+    ):
+        classifier.classify(document)

app/tests/unit/market_data/acquisition/adapters/dzengi/test_websocket_transport.py

@@ -0,0 +1,573 @@
+from __future__ import annotations
+
+import asyncio
+from collections.abc import Awaitable
+from typing import Any
+
+import pytest
+from websockets.protocol import State
+
+from src.market_data.acquisition.adapters.dzengi.websocket_transport import (
+    DzengiWebSocketTransport,
+    build_dzengi_websocket_url,
+)
+from src.market_data.acquisition.exceptions import (
+    WebSocketTransportError,
+    WebSocketTransportNotConnectedError,
+)
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    WebSocketTransportProtocol,
+)
+from src.market_data.acquisition.runtime.runtime_liveness_probe import (
+    RuntimeLivenessProbeProtocol,
+)
+
+
+class FakeConnection:
+    def __init__(
+        self,
+        *,
+        incoming: tuple[str | bytes, ...] = (),
+        state: State = State.OPEN,
+    ) -> None:
+        self.state = state
+        self.incoming = list(incoming)
+        self.sent_messages: list[str | bytes] = []
+        self.close_calls = 0
+        self.send_error: Exception | None = None
+        self.receive_error: Exception | None = None
+        self.ping_error: Exception | None = None
+        self.pong_error: Exception | None = None
+        self.pong_gate: asyncio.Event | None = None
+        self.ping_calls = 0
+        self.close_error: Exception | None = None
+
+    async def close(
+        self,
+        code: int = 1000,
+        reason: str = "",
+    ) -> None:
+        self.close_calls += 1
+        self.state = State.CLOSED
+
+        if self.close_error is not None:
+            raise self.close_error
+
+    async def send(
+        self,
+        message: str | bytes,
+    ) -> None:
+        if self.send_error is not None:
+            self.state = State.CLOSED
+            raise self.send_error
+
+        self.sent_messages.append(message)
+
+    async def recv(self) -> str | bytes:
+        if self.receive_error is not None:
+            self.state = State.CLOSED
+            raise self.receive_error
+
+        return self.incoming.pop(0)
+
+    async def ping(self) -> Awaitable[float]:
+        self.ping_calls += 1
+
+        if self.ping_error is not None:
+            raise self.ping_error
+
+        async def wait_for_pong() -> float:
+            if self.pong_gate is not None:
+                await self.pong_gate.wait()
+
+            if self.pong_error is not None:
+                raise self.pong_error
+
+            return 0.01
+
+        return wait_for_pong()
+
+
+class RecordingConnector:
+    def __init__(
+        self,
+        *connections: FakeConnection,
+    ) -> None:
+        self.connections = list(connections)
+        self.calls: list[
+            tuple[str, dict[str, Any]]
+        ] = []
+
+    async def __call__(
+        self,
+        url: str,
+        **kwargs: Any,
+    ) -> FakeConnection:
+        self.calls.append(
+            (
+                url,
+                kwargs,
+            )
+        )
+
+        return self.connections.pop(0)
+
+
+def create_transport(
+    connection: FakeConnection | None = None,
+) -> tuple[
+    DzengiWebSocketTransport,
+    FakeConnection,
+    RecordingConnector,
+]:
+    resolved_connection = connection or FakeConnection()
+    connector = RecordingConnector(
+        resolved_connection,
+    )
+    transport = DzengiWebSocketTransport(
+        url="https://api-adapter.dzengi.com",
+        headers={
+            "Origin": "https://api-adapter.dzengi.com",
+            "X-MBX-APIKEY": "test-key",
+        },
+        open_timeout=11,
+        ping_interval=12,
+        ping_timeout=13,
+        close_timeout=14,
+        connector=connector,
+    )
+
+    return (
+        transport,
+        resolved_connection,
+        connector,
+    )
+
+
+def test_transport_implements_protocol() -> None:
+    transport, *_ = create_transport()
+
+    assert isinstance(
+        transport,
+        WebSocketTransportProtocol,
+    )
+    assert isinstance(
+        transport,
+        RuntimeLivenessProbeProtocol,
+    )
+
+
+def test_transport_uses_slots() -> None:
+    transport, *_ = create_transport()
+
+    assert not hasattr(transport, "__dict__")
+
+
+@pytest.mark.parametrize(
+    ("raw_url", "expected"),
+    [
+        (
+            "https://api-adapter.dzengi.com",
+            "wss://api-adapter.dzengi.com/connect",
+        ),
+        (
+            "http://localhost:8080/",
+            "ws://localhost:8080/connect",
+        ),
+        (
+            "wss://api-adapter.dzengi.com/connect/",
+            "wss://api-adapter.dzengi.com/connect",
+        ),
+        (
+            "ws://localhost:8080/custom?token=abc",
+            "ws://localhost:8080/custom/connect?token=abc",
+        ),
+    ],
+)
+def test_build_url_normalizes_supported_urls(
+    raw_url: str,
+    expected: str,
+) -> None:
+    assert build_dzengi_websocket_url(raw_url) == expected
+
+
+@pytest.mark.parametrize(
+    "raw_url",
+    [
+        "",
+        "   ",
+        "ftp://api-adapter.dzengi.com",
+        "api-adapter.dzengi.com",
+        "wss:///connect",
+        "wss://api-adapter.dzengi.com/#fragment",
+    ],
+)
+def test_build_url_rejects_invalid_values(
+    raw_url: str,
+) -> None:
+    with pytest.raises(ValueError):
+        build_dzengi_websocket_url(raw_url)
+
+
+def test_build_url_rejects_non_string() -> None:
+    with pytest.raises(TypeError):
+        build_dzengi_websocket_url(123)  # type: ignore[arg-type]
+
+
+def test_connect_forwards_connection_options() -> None:
+    transport, _, connector = create_transport()
+
+    asyncio.run(transport.connect())
+
+    assert transport.is_connected is True
+    assert len(connector.calls) == 1
+
+    url, options = connector.calls[0]
+
+    assert url == "wss://api-adapter.dzengi.com/connect"
+    assert options["additional_headers"] == {
+        "Origin": "https://api-adapter.dzengi.com",
+        "X-MBX-APIKEY": "test-key",
+    }
+    assert tuple(options["subprotocols"]) == ("json",)
+    assert options["open_timeout"] == 11.0
+    assert options["ping_interval"] == 12.0
+    assert options["ping_timeout"] == 13.0
+    assert options["close_timeout"] == 14.0
+
+
+def test_connect_is_idempotent() -> None:
+    transport, _, connector = create_transport()
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.connect()
+
+    asyncio.run(scenario())
+
+    assert len(connector.calls) == 1
+
+
+def test_connect_wraps_connector_error() -> None:
+    async def broken_connector(
+        url: str,
+        **kwargs: Any,
+    ) -> FakeConnection:
+        raise OSError("connection failed")
+
+    transport = DzengiWebSocketTransport(
+        url="wss://api-adapter.dzengi.com/connect",
+        connector=broken_connector,
+    )
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="connection failed",
+    ) as exc_info:
+        asyncio.run(transport.connect())
+
+    assert isinstance(exc_info.value.__cause__, OSError)
+    assert transport.is_connected is False
+
+
+def test_connect_rejects_non_open_connection() -> None:
+    connection = FakeConnection(
+        state=State.CLOSED,
+    )
+    transport, _, _ = create_transport(connection)
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="состояние OPEN",
+    ):
+        asyncio.run(transport.connect())
+
+    assert connection.close_calls == 1
+    assert transport.is_connected is False
+
+
+def test_disconnect_closes_connection_and_is_idempotent() -> None:
+    transport, connection, _ = create_transport()
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.disconnect()
+        await transport.disconnect()
+
+    asyncio.run(scenario())
+
+    assert connection.close_calls == 1
+    assert transport.is_connected is False
+
+
+def test_disconnect_clears_connection_after_close_error() -> None:
+    connection = FakeConnection()
+    connection.close_error = RuntimeError("close failed")
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.disconnect()
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="close failed",
+    ):
+        asyncio.run(scenario())
+
+    assert transport.is_connected is False
+
+
+def test_send_forwards_text_and_binary_messages() -> None:
+    transport, connection, _ = create_transport()
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.send("text")
+        await transport.send(b"binary")
+
+    asyncio.run(scenario())
+
+    assert connection.sent_messages == [
+        "text",
+        b"binary",
+    ]
+
+
+def test_send_requires_open_connection() -> None:
+    transport, _, _ = create_transport()
+
+    with pytest.raises(
+        WebSocketTransportNotConnectedError,
+    ):
+        asyncio.run(transport.send("message"))
+
+
+def test_send_error_is_wrapped_and_discards_closed_connection() -> None:
+    connection = FakeConnection()
+    connection.send_error = RuntimeError("send failed")
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.send("message")
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="send failed",
+    ):
+        asyncio.run(scenario())
+
+    assert transport.is_connected is False
+
+
+def test_receive_returns_text_and_binary_messages() -> None:
+    connection = FakeConnection(
+        incoming=(
+            "text",
+            b"binary",
+        ),
+    )
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> tuple[str | bytes, str | bytes]:
+        await transport.connect()
+
+        return (
+            await transport.receive(),
+            await transport.receive(),
+        )
+
+    assert asyncio.run(scenario()) == (
+        "text",
+        b"binary",
+    )
+
+
+def test_receive_requires_open_connection() -> None:
+    transport, _, _ = create_transport()
+
+    with pytest.raises(
+        WebSocketTransportNotConnectedError,
+    ):
+        asyncio.run(transport.receive())
+
+
+def test_receive_error_is_wrapped_and_discards_closed_connection() -> None:
+    connection = FakeConnection()
+    connection.receive_error = RuntimeError("receive failed")
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.receive()
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="receive failed",
+    ):
+        asyncio.run(scenario())
+
+    assert transport.is_connected is False
+
+
+def test_probe_returns_true_after_pong() -> None:
+    transport, connection, _ = create_transport()
+
+    async def scenario() -> bool:
+        await transport.connect()
+        return await transport.probe()
+
+    assert asyncio.run(scenario()) is True
+    assert connection.ping_calls == 1
+
+
+def test_probe_returns_false_without_open_connection() -> None:
+    transport, connection, _ = create_transport()
+
+    assert asyncio.run(transport.probe()) is False
+    assert connection.ping_calls == 0
+
+
+def test_probe_returns_false_after_pong_timeout() -> None:
+    connection = FakeConnection()
+    connection.pong_gate = asyncio.Event()
+    connector = RecordingConnector(connection)
+    transport = DzengiWebSocketTransport(
+        url="wss://api-adapter.dzengi.com",
+        ping_timeout=0.001,
+        connector=connector,
+    )
+
+    async def scenario() -> bool:
+        await transport.connect()
+        return await transport.probe()
+
+    assert asyncio.run(scenario()) is False
+    assert connection.ping_calls == 1
+    assert transport.is_connected is True
+
+
+def test_probe_timeout_remains_finite_when_ping_timeout_is_disabled() -> None:
+    connection = FakeConnection()
+    connection.pong_gate = asyncio.Event()
+    connector = RecordingConnector(connection)
+    transport = DzengiWebSocketTransport(
+        url="wss://api-adapter.dzengi.com",
+        ping_timeout=None,
+        probe_timeout=0.001,
+        connector=connector,
+    )
+
+    async def scenario() -> bool:
+        await transport.connect()
+        return await transport.probe()
+
+    assert asyncio.run(scenario()) is False
+    assert connection.ping_calls == 1
+    assert connector.calls[0][1]["ping_timeout"] is None
+
+
+def test_probe_returns_false_when_connection_closes() -> None:
+    connection = FakeConnection()
+    connection.pong_error = RuntimeError("connection closed")
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> bool:
+        await transport.connect()
+        connection.state = State.CLOSED
+        return await transport.probe()
+
+    assert asyncio.run(scenario()) is False
+    assert transport.is_connected is False
+
+
+def test_probe_wraps_unexpected_ping_error_on_open_connection() -> None:
+    connection = FakeConnection()
+    connection.ping_error = RuntimeError("ping failed")
+    transport, _, _ = create_transport(connection)
+
+    async def scenario() -> None:
+        await transport.connect()
+        await transport.probe()
+
+    with pytest.raises(
+        WebSocketTransportError,
+        match="ping failed",
+    ) as error_info:
+        asyncio.run(scenario())
+
+    assert isinstance(error_info.value.__cause__, RuntimeError)
+    assert transport.is_connected is True
+
+
+def test_probe_cancellation_is_not_swallowed() -> None:
+    async def scenario() -> DzengiWebSocketTransport:
+        connection = FakeConnection()
+        connection.pong_gate = asyncio.Event()
+        transport, _, _ = create_transport(connection)
+        await transport.connect()
+
+        probe_task = asyncio.create_task(
+            transport.probe(),
+        )
+
+        while connection.ping_calls == 0:
+            await asyncio.sleep(0)
+
+        probe_task.cancel()
+
+        with pytest.raises(asyncio.CancelledError):
+            await probe_task
+
+        return transport
+
+    assert asyncio.run(scenario()).is_connected is True
+
+
+@pytest.mark.parametrize(
+    ("name", "value"),
+    [
+        ("open_timeout", 0),
+        ("ping_interval", -1),
+        ("ping_timeout", True),
+        ("probe_timeout", float("inf")),
+        ("close_timeout", "10"),
+    ],
+)
+def test_rejects_invalid_timeout(
+    name: str,
+    value: object,
+) -> None:
+    options = {
+        name: value,
+    }
+
+    with pytest.raises(
+        (TypeError, ValueError),
+    ):
+        DzengiWebSocketTransport(
+            url="wss://api-adapter.dzengi.com",
+            **options,  # type: ignore[arg-type]
+        )
+
+
+def test_copies_headers_from_caller() -> None:
+    headers = {
+        "Origin": "https://api-adapter.dzengi.com",
+    }
+    connection = FakeConnection()
+    connector = RecordingConnector(connection)
+    transport = DzengiWebSocketTransport(
+        url="wss://api-adapter.dzengi.com",
+        headers=headers,
+        connector=connector,
+    )
+
+    headers["Origin"] = "changed"
+
+    asyncio.run(transport.connect())
+
+    assert connector.calls[0][1]["additional_headers"] == {
+        "Origin": "https://api-adapter.dzengi.com",
+    }

app/tests/unit/market_data/acquisition/runtime/test_acquisition_runtime_event_logging_consumer.py

@@ -0,0 +1,201 @@
+from __future__ import annotations
+
+import asyncio
+import logging
+
+import pytest
+
+from src.market_data.acquisition.runtime.acquisition_runtime_event_logging_consumer import (
+    AcquisitionRuntimeEventLoggingConsumer,
+)
+from src.market_data.acquisition.runtime.acquisition_runtime_event_publisher import (
+    AcquisitionRuntimeEventConsumerProtocol,
+)
+from src.market_data.acquisition.runtime.runtime_events import (
+    ConnectedEvent,
+    ConnectFailedEvent,
+    DisconnectedEvent,
+    HeartbeatTimeoutEvent,
+    MessageReceivedEvent,
+    MessageSentEvent,
+    ReconnectCompletedEvent,
+    ReconnectFailedEvent,
+    ReconnectStartedEvent,
+)
+from src.market_data.acquisition.runtime.transport_messages import (
+    TransportBinaryMessage,
+    TransportTextMessage,
+)
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    AcquisitionRuntimeEvent,
+)
+
+
+TEST_LOGGER_NAME = "tests.acquisition_runtime_events"
+
+
+def create_consumer() -> AcquisitionRuntimeEventLoggingConsumer:
+    return AcquisitionRuntimeEventLoggingConsumer(
+        event_logger=logging.getLogger(
+            TEST_LOGGER_NAME,
+        )
+    )
+
+
+def test_logging_consumer_satisfies_protocol() -> None:
+    assert isinstance(
+        create_consumer(),
+        AcquisitionRuntimeEventConsumerProtocol,
+    )
+
+
+def test_logging_consumer_uses_slots() -> None:
+    consumer = create_consumer()
+
+    assert not hasattr(consumer, "__dict__")
+
+
+def test_invalid_logger_is_rejected() -> None:
+    with pytest.raises(
+        TypeError,
+        match="logging.Logger",
+    ):
+        AcquisitionRuntimeEventLoggingConsumer(
+            event_logger=object(),  # type: ignore[arg-type]
+        )
+
+
+@pytest.mark.parametrize(
+    (
+        "event",
+        "expected_level",
+        "expected_message",
+    ),
+    (
+        (
+            ConnectedEvent(),
+            logging.INFO,
+            "connected",
+        ),
+        (
+            DisconnectedEvent(),
+            logging.INFO,
+            "disconnected",
+        ),
+        (
+            ConnectFailedEvent(
+                reason="connection refused",
+            ),
+            logging.ERROR,
+            "connection refused",
+        ),
+        (
+            ReconnectStartedEvent(
+                attempt=1,
+            ),
+            logging.INFO,
+            "attempt=1",
+        ),
+        (
+            ReconnectCompletedEvent(
+                attempt=2,
+            ),
+            logging.INFO,
+            "attempt=2",
+        ),
+        (
+            ReconnectFailedEvent(
+                attempt=3,
+                reason="timeout",
+            ),
+            logging.ERROR,
+            "attempt=3 reason=timeout",
+        ),
+        (
+            HeartbeatTimeoutEvent(
+                timeout_seconds=30.0,
+            ),
+            logging.WARNING,
+            "timeout_seconds=30.0",
+        ),
+    ),
+)
+def test_lifecycle_event_uses_expected_log_level(
+    caplog: pytest.LogCaptureFixture,
+    event: AcquisitionRuntimeEvent,
+    expected_level: int,
+    expected_message: str,
+) -> None:
+    consumer = create_consumer()
+
+    caplog.set_level(
+        logging.DEBUG,
+        logger=TEST_LOGGER_NAME,
+    )
+
+    asyncio.run(
+        consumer.consume(event)
+    )
+
+    assert len(caplog.records) == 1
+    assert caplog.records[0].levelno == expected_level
+    assert expected_message in caplog.records[0].getMessage()
+
+
+def test_message_events_log_metadata_without_payload(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    consumer = create_consumer()
+    text_payload = "secret-subscription-payload"
+    binary_payload = b"secret-binary-payload"
+
+    caplog.set_level(
+        logging.DEBUG,
+        logger=TEST_LOGGER_NAME,
+    )
+
+    async def consume_messages() -> None:
+        await consumer.consume(
+            MessageReceivedEvent(
+                message=TransportTextMessage(
+                    payload=text_payload,
+                ),
+            )
+        )
+        await consumer.consume(
+            MessageSentEvent(
+                message=TransportBinaryMessage(
+                    payload=binary_payload,
+                ),
+            )
+        )
+
+    asyncio.run(consume_messages())
+
+    assert len(caplog.records) == 2
+    assert (
+        "message_type=TransportTextMessage "
+        f"payload_size={len(text_payload)}"
+        in caplog.records[0].getMessage()
+    )
+    assert (
+        "message_type=TransportBinaryMessage "
+        f"payload_size={len(binary_payload)}"
+        in caplog.records[1].getMessage()
+    )
+    assert text_payload not in caplog.text
+    assert binary_payload.decode() not in caplog.text
+
+
+def test_invalid_event_is_rejected() -> None:
+    consumer = create_consumer()
+
+    with pytest.raises(
+        TypeError,
+        match="AcquisitionRuntimeEvent",
+    ):
+        asyncio.run(
+            consumer.consume(
+                object(),  # type: ignore[arg-type]
+            )
+        )

app/tests/unit/market_data/acquisition/runtime/test_acquisition_runtime_event_publisher.py

@@ -0,0 +1,679 @@
+from __future__ import annotations
+
+import asyncio
+import logging
+
+import pytest
+
+from src.market_data.acquisition.runtime.acquisition_runtime_event_publisher import (
+    AcquisitionRuntimeEventConsumerProtocol,
+    AcquisitionRuntimeEventPublisher,
+    logger as publisher_logger,
+)
+from src.market_data.acquisition.runtime.heartbeat import (
+    HeartbeatMonitor,
+    HeartbeatState,
+)
+from src.market_data.acquisition.runtime.reconnect import (
+    ReconnectCoordinator,
+    ReconnectState,
+)
+from src.market_data.acquisition.runtime.runtime_commands import (
+    ConnectCommand,
+    DisconnectCommand,
+)
+from src.market_data.acquisition.runtime.runtime_events import (
+    ConnectedEvent,
+    DisconnectedEvent,
+    MessageReceivedEvent,
+    ReconnectStartedEvent,
+)
+from src.market_data.acquisition.runtime.transport_messages import (
+    TransportTextMessage,
+)
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    AcquisitionRuntimeCommand,
+    AcquisitionRuntimeEvent,
+    AcquisitionRuntimeEventPublisherProtocol,
+    AcquisitionSubscriptionMessage,
+)
+
+
+PUBLISHER_LOGGER_NAME = (
+    "src.market_data.acquisition.runtime."
+    "acquisition_runtime_event_publisher"
+)
+
+
+class RecordingConsumer:
+    def __init__(self) -> None:
+        self.events: list[AcquisitionRuntimeEvent] = []
+
+    async def consume(
+        self,
+        event: AcquisitionRuntimeEvent,
+    ) -> None:
+        self.events.append(event)
+
+
+def test_publisher_satisfies_protocol() -> None:
+    publisher = AcquisitionRuntimeEventPublisher()
+
+    assert isinstance(
+        publisher,
+        AcquisitionRuntimeEventPublisherProtocol,
+    )
+
+
+def test_consumer_satisfies_protocol() -> None:
+    assert isinstance(
+        RecordingConsumer(),
+        AcquisitionRuntimeEventConsumerProtocol,
+    )
+
+
+def test_publisher_uses_slots() -> None:
+    publisher = AcquisitionRuntimeEventPublisher()
+
+    assert not hasattr(publisher, "__dict__")
+
+
+def test_empty_publisher_accepts_event() -> None:
+    publisher = AcquisitionRuntimeEventPublisher()
+
+    asyncio.run(
+        publisher.publish(
+            ConnectedEvent(),
+        )
+    )
+
+
+def test_constructor_copies_consumer_collection() -> None:
+    first_consumer = RecordingConsumer()
+    consumers = [first_consumer]
+    publisher = AcquisitionRuntimeEventPublisher(consumers)
+
+    second_consumer = RecordingConsumer()
+    consumers.append(second_consumer)
+
+    event = ConnectedEvent()
+    asyncio.run(publisher.publish(event))
+
+    assert first_consumer.events == [event]
+    assert second_consumer.events == []
+
+
+def test_invalid_consumer_is_rejected() -> None:
+    with pytest.raises(
+        TypeError,
+        match="AcquisitionRuntimeEventConsumerProtocol",
+    ):
+        AcquisitionRuntimeEventPublisher(
+            consumers=(
+                object(),  # type: ignore[arg-type]
+            )
+        )
+
+
+def test_invalid_event_is_rejected() -> None:
+    publisher = AcquisitionRuntimeEventPublisher()
+
+    with pytest.raises(
+        TypeError,
+        match="AcquisitionRuntimeEvent",
+    ):
+        asyncio.run(
+            publisher.publish(
+                object(),  # type: ignore[arg-type]
+            )
+        )
+
+
+def test_event_is_delivered_to_consumers_in_registration_order() -> None:
+    calls: list[tuple[str, AcquisitionRuntimeEvent]] = []
+
+    class NamedConsumer:
+        def __init__(self, name: str) -> None:
+            self._name = name
+
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            calls.append(
+                (
+                    self._name,
+                    event,
+                )
+            )
+
+    event = ConnectedEvent()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            NamedConsumer("first"),
+            NamedConsumer("second"),
+        )
+    )
+
+    asyncio.run(publisher.publish(event))
+
+    assert calls == [
+        (
+            "first",
+            event,
+        ),
+        (
+            "second",
+            event,
+        ),
+    ]
+    assert calls[0][1] is event
+    assert calls[1][1] is event
+
+
+def test_publish_waits_for_consumer_completion() -> None:
+    completed = False
+
+    class YieldingConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            nonlocal completed
+
+            await asyncio.sleep(0)
+            completed = True
+
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            YieldingConsumer(),
+        )
+    )
+
+    asyncio.run(
+        publisher.publish(
+            ConnectedEvent(),
+        )
+    )
+
+    assert completed is True
+
+
+def test_concurrent_publications_are_serialized() -> None:
+    calls: list[tuple[str, int]] = []
+
+    async def scenario() -> None:
+        first_started = asyncio.Event()
+        release_first = asyncio.Event()
+
+        class BlockingConsumer:
+            async def consume(
+                self,
+                event: AcquisitionRuntimeEvent,
+            ) -> None:
+                assert isinstance(
+                    event,
+                    ReconnectStartedEvent,
+                )
+
+                calls.append(
+                    (
+                        "start",
+                        event.attempt,
+                    )
+                )
+
+                if event.attempt == 1:
+                    first_started.set()
+                    await release_first.wait()
+
+                calls.append(
+                    (
+                        "end",
+                        event.attempt,
+                    )
+                )
+
+        publisher = AcquisitionRuntimeEventPublisher(
+            consumers=(
+                BlockingConsumer(),
+            )
+        )
+
+        first_task = asyncio.create_task(
+            publisher.publish(
+                ReconnectStartedEvent(
+                    attempt=1,
+                )
+            )
+        )
+
+        await first_started.wait()
+
+        second_task = asyncio.create_task(
+            publisher.publish(
+                ReconnectStartedEvent(
+                    attempt=2,
+                )
+            )
+        )
+
+        await asyncio.sleep(0)
+
+        assert calls == [
+            (
+                "start",
+                1,
+            ),
+        ]
+
+        release_first.set()
+
+        await asyncio.gather(
+            first_task,
+            second_task,
+        )
+
+    asyncio.run(scenario())
+
+    assert calls == [
+        (
+            "start",
+            1,
+        ),
+        (
+            "end",
+            1,
+        ),
+        (
+            "start",
+            2,
+        ),
+        (
+            "end",
+            2,
+        ),
+    ]
+
+
+def test_consumer_error_is_logged_and_delivery_continues(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    class BrokenConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise RuntimeError(
+                "sensitive consumer failure detail",
+            )
+
+    recording_consumer = RecordingConsumer()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            BrokenConsumer(),
+            recording_consumer,
+        )
+    )
+    event = ConnectedEvent()
+
+    caplog.set_level(
+        logging.ERROR,
+        logger=PUBLISHER_LOGGER_NAME,
+    )
+
+    asyncio.run(publisher.publish(event))
+
+    assert recording_consumer.events == [event]
+    assert len(caplog.records) == 1
+    assert (
+        "event=ConnectedEvent consumer=BrokenConsumer "
+        "error_type=RuntimeError"
+        in caplog.records[0].getMessage()
+    )
+    assert caplog.records[0].exc_info is None
+    assert (
+        "sensitive consumer failure detail"
+        not in caplog.text
+    )
+
+
+def test_consumer_error_log_does_not_include_transport_payload(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    class PayloadEchoingBrokenConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise RuntimeError(
+                f"consumer rejected {event!r}"
+            )
+
+    payload = "secret-runtime-payload"
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            PayloadEchoingBrokenConsumer(),
+        )
+    )
+
+    caplog.set_level(
+        logging.ERROR,
+        logger=PUBLISHER_LOGGER_NAME,
+    )
+
+    asyncio.run(
+        publisher.publish(
+            MessageReceivedEvent(
+                message=TransportTextMessage(
+                    payload=payload,
+                ),
+            )
+        )
+    )
+
+    assert payload not in caplog.text
+    assert "consumer rejected" not in caplog.text
+    assert "error_type=RuntimeError" in caplog.text
+
+
+def test_logging_handler_error_does_not_escape_or_stop_delivery() -> None:
+    class BrokenConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise RuntimeError(
+                "consumer failed",
+            )
+
+    class RaisingHandler(logging.Handler):
+        def emit(
+            self,
+            record: logging.LogRecord,
+        ) -> None:
+            raise RuntimeError(
+                "logging failed",
+            )
+
+    handler = RaisingHandler()
+    recording_consumer = RecordingConsumer()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            BrokenConsumer(),
+            recording_consumer,
+        )
+    )
+    event = ConnectedEvent()
+
+    publisher_logger.addHandler(handler)
+
+    try:
+        asyncio.run(publisher.publish(event))
+    finally:
+        publisher_logger.removeHandler(handler)
+
+    assert recording_consumer.events == [event]
+
+
+def test_consumer_cancellation_is_propagated() -> None:
+    class CancelledConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise asyncio.CancelledError
+
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            CancelledConsumer(),
+        )
+    )
+
+    with pytest.raises(asyncio.CancelledError):
+        asyncio.run(
+            publisher.publish(
+                ConnectedEvent(),
+            )
+        )
+
+
+def test_publisher_can_be_reused_after_consumer_cancellation() -> None:
+    class CancelOnceConsumer:
+        def __init__(self) -> None:
+            self.calls = 0
+
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            self.calls += 1
+
+            if self.calls == 1:
+                raise asyncio.CancelledError
+
+    cancel_once_consumer = CancelOnceConsumer()
+    recording_consumer = RecordingConsumer()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            cancel_once_consumer,
+            recording_consumer,
+        )
+    )
+    second_event = DisconnectedEvent()
+
+    async def scenario() -> None:
+        with pytest.raises(asyncio.CancelledError):
+            await publisher.publish(
+                ConnectedEvent(),
+            )
+
+        await publisher.publish(second_event)
+
+    asyncio.run(scenario())
+
+    assert cancel_once_consumer.calls == 2
+    assert recording_consumer.events == [
+        second_event,
+    ]
+
+
+def test_recursive_publication_is_rejected_without_deadlock(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    class RecursiveConsumer:
+        def __init__(self) -> None:
+            self.publisher: (
+                AcquisitionRuntimeEventPublisher | None
+            ) = None
+
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            assert self.publisher is not None
+
+            await self.publisher.publish(
+                DisconnectedEvent(),
+            )
+
+    recursive_consumer = RecursiveConsumer()
+    recording_consumer = RecordingConsumer()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            recursive_consumer,
+            recording_consumer,
+        )
+    )
+    recursive_consumer.publisher = publisher
+    event = ConnectedEvent()
+
+    caplog.set_level(
+        logging.ERROR,
+        logger=PUBLISHER_LOGGER_NAME,
+    )
+
+    asyncio.run(publisher.publish(event))
+
+    assert recording_consumer.events == [event]
+    assert (
+        "event=ConnectedEvent consumer=RecursiveConsumer "
+        "error_type=RuntimeError"
+        in caplog.text
+    )
+
+
+def test_child_task_recursive_publication_is_rejected() -> None:
+    class ChildTaskRecursiveConsumer:
+        def __init__(self) -> None:
+            self.publisher: (
+                AcquisitionRuntimeEventPublisher | None
+            ) = None
+            self.rejected = False
+
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            assert self.publisher is not None
+
+            if not isinstance(event, ConnectedEvent):
+                return
+
+            try:
+                await asyncio.create_task(
+                    self.publisher.publish(
+                        DisconnectedEvent(),
+                    )
+                )
+            except RuntimeError:
+                self.rejected = True
+
+    recursive_consumer = ChildTaskRecursiveConsumer()
+    recording_consumer = RecordingConsumer()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            recursive_consumer,
+            recording_consumer,
+        )
+    )
+    recursive_consumer.publisher = publisher
+    event = ConnectedEvent()
+
+    asyncio.run(
+        asyncio.wait_for(
+            publisher.publish(event),
+            timeout=1.0,
+        )
+    )
+
+    assert recursive_consumer.rejected is True
+    assert recording_consumer.events == [event]
+
+
+def test_consumer_error_does_not_interrupt_heartbeat_timeout() -> None:
+    class BrokenConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise RuntimeError(
+                "consumer failed",
+            )
+
+    current_time = [0.0]
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            BrokenConsumer(),
+        )
+    )
+    monitor = HeartbeatMonitor(
+        event_publisher=publisher,
+        timeout_seconds=10.0,
+        clock=lambda: current_time[0],
+    )
+
+    monitor.start()
+    current_time[0] = 10.0
+
+    result = asyncio.run(
+        monitor.check_timeout()
+    )
+
+    assert result is True
+    assert monitor.state is HeartbeatState.TIMED_OUT
+
+
+def test_consumer_error_does_not_interrupt_reconnect() -> None:
+    class BrokenConsumer:
+        async def consume(
+            self,
+            event: AcquisitionRuntimeEvent,
+        ) -> None:
+            raise RuntimeError(
+                "consumer failed",
+            )
+
+    class RecordingCommandDispatcher:
+        def __init__(self) -> None:
+            self.commands: list[
+                AcquisitionRuntimeCommand
+            ] = []
+
+        async def dispatch(
+            self,
+            command: AcquisitionRuntimeCommand,
+        ) -> None:
+            self.commands.append(command)
+
+    class RecordingSubscriptionManager:
+        def __init__(self) -> None:
+            self.restore_calls = 0
+
+        async def subscribe(
+            self,
+            subscription_key: str,
+            message: AcquisitionSubscriptionMessage,
+        ) -> None:
+            return None
+
+        async def unsubscribe(
+            self,
+            subscription_key: str,
+            message: AcquisitionSubscriptionMessage,
+        ) -> None:
+            return None
+
+        async def restore_subscriptions(self) -> None:
+            self.restore_calls += 1
+
+        async def clear_subscriptions(self) -> None:
+            return None
+
+    dispatcher = RecordingCommandDispatcher()
+    subscriptions = RecordingSubscriptionManager()
+    publisher = AcquisitionRuntimeEventPublisher(
+        consumers=(
+            BrokenConsumer(),
+        )
+    )
+    coordinator = ReconnectCoordinator(
+        command_dispatcher=dispatcher,
+        subscription_manager=subscriptions,
+        event_publisher=publisher,
+    )
+
+    asyncio.run(
+        coordinator.reconnect()
+    )
+
+    assert coordinator.state is ReconnectState.CONNECTED
+    assert coordinator.attempt == 1
+    assert [
+        type(command)
+        for command in dispatcher.commands
+    ] == [
+        DisconnectCommand,
+        ConnectCommand,
+    ]
+    assert subscriptions.restore_calls == 1

app/tests/unit/market_data/acquisition/runtime/test_live_processing_gate.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+import asyncio
+
+import pytest
+
+from src.market_data.acquisition.runtime.live_processing_gate import (
+    RuntimeLiveProcessingGate,
+    RuntimeLiveProcessingGateProtocol,
+)
+
+
+def test_implements_protocol_uses_slots_and_starts_open() -> None:
+    gate = RuntimeLiveProcessingGate()
+
+    assert isinstance(
+        gate,
+        RuntimeLiveProcessingGateProtocol,
+    )
+    assert not hasattr(gate, "__dict__")
+    assert gate.locked is False
+    assert gate.failed is False
+
+
+def test_serializes_protected_operations() -> None:
+    async def scenario() -> list[str]:
+        gate = RuntimeLiveProcessingGate()
+        order: list[str] = []
+
+        async def contender() -> None:
+            async with gate:
+                order.append("contender")
+
+        async with gate:
+            order.append("owner")
+            contender_task = asyncio.create_task(
+                contender(),
+            )
+            await asyncio.sleep(0)
+
+            assert contender_task.done() is False
+            assert gate.locked is True
+
+        await contender_task
+        return order
+
+    assert asyncio.run(scenario()) == [
+        "owner",
+        "contender",
+    ]
+
+
+def test_releases_gate_after_error() -> None:
+    async def scenario() -> RuntimeLiveProcessingGate:
+        gate = RuntimeLiveProcessingGate()
+
+        with pytest.raises(
+            RuntimeError,
+            match="protected failure",
+        ):
+            async with gate:
+                raise RuntimeError(
+                    "protected failure",
+                )
+
+        return gate
+
+    assert asyncio.run(scenario()).locked is False
+
+
+def test_failed_gate_rejects_waiters_until_reset() -> None:
+    async def scenario() -> RuntimeLiveProcessingGate:
+        gate = RuntimeLiveProcessingGate()
+        failure = RuntimeError("recovery failed")
+
+        gate.fail(failure)
+
+        with pytest.raises(
+            RuntimeError,
+            match="recovery failed",
+        ) as error_info:
+            async with gate:
+                raise AssertionError(
+                    "failed gate must not admit live processing"
+                )
+
+        assert error_info.value is failure
+        assert gate.locked is False
+        assert gate.failed is True
+
+        gate.reset()
+
+        async with gate:
+            assert gate.locked is True
+
+        return gate
+
+    gate = asyncio.run(scenario())
+
+    assert gate.locked is False
+    assert gate.failed is False
+
+
+def test_rejects_reset_while_gate_is_locked() -> None:
+    async def scenario() -> None:
+        gate = RuntimeLiveProcessingGate()
+
+        async with gate:
+            with pytest.raises(
+                RuntimeError,
+                match="cannot be reset while locked",
+            ):
+                gate.reset()
+
+    asyncio.run(scenario())

app/tests/unit/market_data/acquisition/runtime/test_reconnect_coordinator.py

@@ -14,6 +14,7 @@ from src.market_data.acquisition.runtime.reconnect import (
 )
 from src.market_data.acquisition.runtime.runtime_commands import (
     ConnectCommand,
+    DisconnectCommand,
 )
 from src.market_data.acquisition.runtime.runtime_events import (
     ReconnectCompletedEvent,
@@ -115,16 +116,14 @@ def test_initial_state_is_disconnected() -> None:
     assert coordinator.attempt == 0
 
 
-def test_reconnect_dispatches_connect_command() -> None:
+def test_reconnect_dispatches_disconnect_then_connect() -> None:
     coordinator, dispatcher, *_ = create_coordinator()
 
     asyncio.run(coordinator.reconnect())
 
-    assert len(dispatcher.commands) == 1
-    assert isinstance(
-        dispatcher.commands[0],
-        ConnectCommand,
-    )
+    assert len(dispatcher.commands) == 2
+    assert isinstance(dispatcher.commands[0], DisconnectCommand)
+    assert isinstance(dispatcher.commands[1], ConnectCommand)
 
 
 def test_reconnect_restores_subscriptions() -> None:
@@ -185,7 +184,9 @@ def test_connect_error_publishes_failed_event() -> None:
             command: Any,
         ) -> None:
             self.commands.append(command)
-            raise RuntimeError("connection failed")
+
+            if isinstance(command, ConnectCommand):
+                raise RuntimeError("connection failed")
 
     dispatcher = BrokenCommandDispatcher()
     subscriptions = FakeSubscriptionManager()
@@ -218,7 +219,8 @@ def test_connect_error_sets_failed_state() -> None:
             self,
             command: Any,
         ) -> None:
-            raise RuntimeError("connection failed")
+            if isinstance(command, ConnectCommand):
+                raise RuntimeError("connection failed")
 
     coordinator = ReconnectCoordinator(
         command_dispatcher=BrokenCommandDispatcher(),
@@ -239,7 +241,8 @@ def test_connect_error_does_not_restore_subscriptions() -> None:
             self,
             command: Any,
         ) -> None:
-            raise RuntimeError("connection failed")
+            if isinstance(command, ConnectCommand):
+                raise RuntimeError("connection failed")
 
     subscriptions = FakeSubscriptionManager()
 

app/tests/unit/market_data/acquisition/runtime/test_runtime_reconnect_recovery_coordinator.py

@@ -0,0 +1,711 @@
+from __future__ import annotations
+
+import asyncio
+import threading
+
+import pytest
+
+from src.market_data.acquisition.recovery.trade_recovery_result import (
+    TradeRecoveryResult,
+)
+from src.market_data.acquisition.runtime.live_processing_gate import (
+    RuntimeLiveProcessingGate,
+)
+from src.market_data.acquisition.runtime.reconnect import (
+    ReconnectState,
+)
+from src.market_data.acquisition.runtime.runtime_reconnect_recovery_coordinator import (
+    RuntimeReconnectRecoveryCoordinator,
+    RuntimeReconnectRecoveryProtocol,
+)
+
+
+BTC = "BTC/USD_LEVERAGE"
+ETH = "ETH/USD_LEVERAGE"
+RECOVERY_END_TIME_MS = 1_785_326_405_123
+
+
+class FakeReconnectCoordinator:
+    def __init__(
+        self,
+        *,
+        order: list[str],
+        gate: RuntimeLiveProcessingGate,
+        error: Exception | None = None,
+        entered: asyncio.Event | None = None,
+        release: asyncio.Event | None = None,
+    ) -> None:
+        self._order = order
+        self._gate = gate
+        self._error = error
+        self._entered = entered
+        self._release = release
+        self._state = ReconnectState.DISCONNECTED
+        self._attempt = 0
+
+    @property
+    def state(self) -> ReconnectState:
+        return self._state
+
+    @property
+    def attempt(self) -> int:
+        return self._attempt
+
+    async def reconnect(self) -> None:
+        assert self._gate.locked is True
+
+        self._attempt += 1
+        self._state = ReconnectState.CONNECTING
+        self._order.append("reconnect")
+
+        if self._entered is not None:
+            self._entered.set()
+
+        if self._release is not None:
+            await self._release.wait()
+
+        if self._error is not None:
+            self._state = ReconnectState.FAILED
+            raise self._error
+
+        self._state = ReconnectState.CONNECTED
+
+
+class FakeRecoveryCoordinator:
+    def __init__(
+        self,
+        *,
+        order: list[str],
+        gate: RuntimeLiveProcessingGate,
+        error: Exception | None = None,
+        started: threading.Event | None = None,
+        release: threading.Event | None = None,
+    ) -> None:
+        self._order = order
+        self._gate = gate
+        self._error = error
+        self._started = started
+        self._release = release
+        self.calls: list[tuple[str, int]] = []
+        self.thread_ids: list[int] = []
+
+    def recover(
+        self,
+        *,
+        symbol: str,
+        recovery_end_time: int,
+    ) -> TradeRecoveryResult:
+        assert self._gate.locked is True
+
+        self.calls.append(
+            (
+                symbol,
+                recovery_end_time,
+            )
+        )
+        self.thread_ids.append(
+            threading.get_ident(),
+        )
+        self._order.append(
+            f"recover:{symbol}",
+        )
+
+        if self._started is not None:
+            self._started.set()
+
+        if self._release is not None:
+            if not self._release.wait(timeout=2.0):
+                raise AssertionError(
+                    "recovery release was not signalled"
+                )
+
+        if self._error is not None:
+            raise self._error
+
+        return TradeRecoveryResult(
+            symbol=symbol,
+            requested_start_time=recovery_end_time,
+            requested_end_time=recovery_end_time,
+            recovered_trades=(),
+        )
+
+
+class RecordingClock:
+    def __init__(
+        self,
+        *,
+        order: list[str],
+        value: object = RECOVERY_END_TIME_MS,
+    ) -> None:
+        self._order = order
+        self._value = value
+        self.calls = 0
+
+    def __call__(self) -> int:
+        self.calls += 1
+        self._order.append("clock")
+        return self._value  # type: ignore[return-value]
+
+
+def create_coordinator(
+    *,
+    symbols: tuple[str, ...] = (BTC,),
+    reconnect_error: Exception | None = None,
+    recovery_error: Exception | None = None,
+    reconnect_entered: asyncio.Event | None = None,
+    reconnect_release: asyncio.Event | None = None,
+    recovery_started: threading.Event | None = None,
+    recovery_release: threading.Event | None = None,
+    clock_value: object = RECOVERY_END_TIME_MS,
+) -> tuple[
+    RuntimeReconnectRecoveryCoordinator,
+    RuntimeLiveProcessingGate,
+    FakeReconnectCoordinator,
+    FakeRecoveryCoordinator,
+    RecordingClock,
+    list[str],
+]:
+    order: list[str] = []
+    gate = RuntimeLiveProcessingGate()
+    reconnect = FakeReconnectCoordinator(
+        order=order,
+        gate=gate,
+        error=reconnect_error,
+        entered=reconnect_entered,
+        release=reconnect_release,
+    )
+    recovery = FakeRecoveryCoordinator(
+        order=order,
+        gate=gate,
+        error=recovery_error,
+        started=recovery_started,
+        release=recovery_release,
+    )
+    clock = RecordingClock(
+        order=order,
+        value=clock_value,
+    )
+    coordinator = RuntimeReconnectRecoveryCoordinator(
+        reconnect_coordinator=reconnect,
+        recovery_coordinator=recovery,
+        live_processing_gate=gate,
+        symbols=symbols,
+        clock=clock,
+    )
+
+    return (
+        coordinator,
+        gate,
+        reconnect,
+        recovery,
+        clock,
+        order,
+    )
+
+
+async def wait_until(
+    predicate: object,
+) -> None:
+    for _ in range(100):
+        if callable(predicate) and predicate():
+            return
+
+        await asyncio.sleep(0)
+
+    raise AssertionError("condition was not reached")
+
+
+def test_implements_protocol_uses_slots_and_delegates_state() -> None:
+    coordinator, _, reconnect, *_ = create_coordinator()
+
+    assert isinstance(
+        coordinator,
+        RuntimeReconnectRecoveryProtocol,
+    )
+    assert not hasattr(coordinator, "__dict__")
+    assert coordinator.state is ReconnectState.DISCONNECTED
+    assert coordinator.attempt == 0
+    assert coordinator.generation == 0
+    assert coordinator.live_processing_gate is coordinator._live_processing_gate
+    assert coordinator.symbols == (BTC,)
+
+    asyncio.run(coordinator.reconnect())
+
+    assert coordinator.state is reconnect.state
+    assert coordinator.state is ReconnectState.CONNECTED
+    assert coordinator.attempt == 1
+    assert coordinator.generation == 1
+
+
+@pytest.mark.parametrize(
+    ("symbols", "error_type"),
+    [
+        ([], TypeError),
+        ((), ValueError),
+        (("", "   "), ValueError),
+        ((BTC, 1), TypeError),
+    ],
+)
+def test_rejects_invalid_symbols(
+    symbols: object,
+    error_type: type[Exception],
+) -> None:
+    with pytest.raises(error_type):
+        create_coordinator(
+            symbols=symbols,  # type: ignore[arg-type]
+        )
+
+
+def test_reconnect_restore_boundary_and_recovery_order() -> None:
+    (
+        coordinator,
+        gate,
+        _,
+        recovery,
+        clock,
+        order,
+    ) = create_coordinator(
+        symbols=(
+            f" {ETH} ",
+            BTC,
+            ETH,
+        ),
+    )
+    main_thread_id = threading.get_ident()
+
+    asyncio.run(coordinator.reconnect())
+
+    assert order == [
+        "reconnect",
+        "clock",
+        f"recover:{BTC}",
+        f"recover:{ETH}",
+    ]
+    assert recovery.calls == [
+        (
+            BTC,
+            RECOVERY_END_TIME_MS,
+        ),
+        (
+            ETH,
+            RECOVERY_END_TIME_MS,
+        ),
+    ]
+    assert clock.calls == 1
+    assert all(
+        thread_id != main_thread_id
+        for thread_id in recovery.thread_ids
+    )
+    assert gate.locked is False
+
+
+def test_live_processing_waits_until_recovery_finishes() -> None:
+    async def scenario() -> list[str]:
+        recovery_started = threading.Event()
+        recovery_release = threading.Event()
+        (
+            coordinator,
+            gate,
+            *_,
+        ) = create_coordinator(
+            recovery_started=recovery_started,
+            recovery_release=recovery_release,
+        )
+        order: list[str] = []
+
+        coordinator_task = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await wait_until(
+            recovery_started.is_set,
+        )
+
+        async def process_live() -> None:
+            async with gate:
+                order.append("live")
+
+        live_task = asyncio.create_task(
+            process_live(),
+        )
+        await asyncio.sleep(0)
+
+        assert live_task.done() is False
+        assert gate.locked is True
+
+        recovery_release.set()
+        await coordinator_task
+        await live_task
+
+        return order
+
+    assert asyncio.run(scenario()) == [
+        "live",
+    ]
+
+
+def test_concurrent_callers_share_one_operation() -> None:
+    async def scenario() -> tuple[
+        RuntimeReconnectRecoveryCoordinator,
+        FakeReconnectCoordinator,
+        FakeRecoveryCoordinator,
+    ]:
+        reconnect_entered = asyncio.Event()
+        reconnect_release = asyncio.Event()
+        (
+            coordinator,
+            _,
+            reconnect,
+            recovery,
+            *_,
+        ) = create_coordinator(
+            reconnect_entered=reconnect_entered,
+            reconnect_release=reconnect_release,
+        )
+
+        first = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await reconnect_entered.wait()
+
+        second = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await asyncio.sleep(0)
+
+        assert reconnect.attempt == 1
+
+        reconnect_release.set()
+        await asyncio.gather(
+            first,
+            second,
+        )
+
+        return (
+            coordinator,
+            reconnect,
+            recovery,
+        )
+
+    coordinator, reconnect, recovery = asyncio.run(
+        scenario()
+    )
+
+    assert reconnect.attempt == 1
+    assert len(recovery.calls) == 1
+    assert coordinator.generation == 1
+
+
+def test_timeout_and_transport_error_share_one_operation() -> None:
+    async def scenario() -> tuple[
+        RuntimeReconnectRecoveryCoordinator,
+        FakeReconnectCoordinator,
+        FakeRecoveryCoordinator,
+    ]:
+        reconnect_entered = asyncio.Event()
+        reconnect_release = asyncio.Event()
+        (
+            coordinator,
+            _,
+            reconnect,
+            recovery,
+            *_,
+        ) = create_coordinator(
+            reconnect_entered=reconnect_entered,
+            reconnect_release=reconnect_release,
+        )
+        observed_generation = coordinator.generation
+
+        timeout_task = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await reconnect_entered.wait()
+
+        transport_task = asyncio.create_task(
+            coordinator.reconnect_after_transport_failure(
+                observed_generation=observed_generation,
+            ),
+        )
+        await asyncio.sleep(0)
+
+        assert reconnect.attempt == 1
+        reconnect_release.set()
+
+        await asyncio.gather(
+            timeout_task,
+            transport_task,
+        )
+
+        return (
+            coordinator,
+            reconnect,
+            recovery,
+        )
+
+    coordinator, reconnect, recovery = asyncio.run(
+        scenario()
+    )
+
+    assert reconnect.attempt == 1
+    assert len(recovery.calls) == 1
+    assert coordinator.generation == 1
+
+
+def test_stale_transport_error_reuses_completed_operation() -> None:
+    (
+        coordinator,
+        _,
+        reconnect,
+        recovery,
+        *_,
+    ) = create_coordinator()
+
+    observed_generation = coordinator.generation
+
+    asyncio.run(coordinator.reconnect())
+    asyncio.run(
+        coordinator.reconnect_after_transport_failure(
+            observed_generation=observed_generation,
+        )
+    )
+
+    assert reconnect.attempt == 1
+    assert len(recovery.calls) == 1
+
+
+def test_reconnect_error_skips_clock_and_recovery() -> None:
+    reconnect_error = RuntimeError("reconnect failed")
+    (
+        coordinator,
+        gate,
+        _,
+        recovery,
+        clock,
+        _,
+    ) = create_coordinator(
+        reconnect_error=reconnect_error,
+    )
+
+    with pytest.raises(
+        RuntimeError,
+        match="reconnect failed",
+    ) as error_info:
+        asyncio.run(coordinator.reconnect())
+
+    assert error_info.value is reconnect_error
+    assert recovery.calls == []
+    assert clock.calls == 0
+    assert gate.locked is False
+    assert gate.failed is True
+
+
+def test_recovery_error_is_not_wrapped() -> None:
+    recovery_error = RuntimeError("recovery failed")
+    (
+        coordinator,
+        gate,
+        *_,
+    ) = create_coordinator(
+        recovery_error=recovery_error,
+    )
+
+    with pytest.raises(
+        RuntimeError,
+        match="recovery failed",
+    ) as error_info:
+        asyncio.run(coordinator.reconnect())
+
+    assert error_info.value is recovery_error
+    assert gate.locked is False
+    assert gate.failed is True
+    assert coordinator._recovery_task is None
+
+
+def test_recovery_error_rejects_buffered_live_processing() -> None:
+    async def scenario() -> tuple[
+        RuntimeLiveProcessingGate,
+        list[str],
+    ]:
+        recovery_error = RuntimeError("recovery failed")
+        recovery_started = threading.Event()
+        recovery_release = threading.Event()
+        (
+            coordinator,
+            gate,
+            *_,
+        ) = create_coordinator(
+            recovery_error=recovery_error,
+            recovery_started=recovery_started,
+            recovery_release=recovery_release,
+        )
+        processed: list[str] = []
+        coordinator_task = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await wait_until(
+            recovery_started.is_set,
+        )
+
+        async def process_live() -> None:
+            async with gate:
+                processed.append("live")
+
+        live_task = asyncio.create_task(
+            process_live(),
+        )
+        await asyncio.sleep(0)
+
+        assert live_task.done() is False
+        recovery_release.set()
+
+        with pytest.raises(
+            RuntimeError,
+            match="recovery failed",
+        ):
+            await coordinator_task
+
+        with pytest.raises(
+            RuntimeError,
+            match="recovery failed",
+        ):
+            await live_task
+
+        return (
+            gate,
+            processed,
+        )
+
+    gate, processed = asyncio.run(scenario())
+
+    assert processed == []
+    assert gate.locked is False
+    assert gate.failed is True
+
+
+@pytest.mark.parametrize(
+    ("clock_value", "error_type"),
+    [
+        (True, TypeError),
+        (1.5, TypeError),
+        (-1, ValueError),
+    ],
+)
+def test_rejects_invalid_clock_result(
+    clock_value: object,
+    error_type: type[Exception],
+) -> None:
+    coordinator, gate, *_ = create_coordinator(
+        clock_value=clock_value,
+    )
+
+    with pytest.raises(error_type):
+        asyncio.run(coordinator.reconnect())
+
+    assert gate.locked is False
+
+
+def test_cancellation_waits_for_worker_before_opening_gate() -> None:
+    async def scenario() -> tuple[
+        RuntimeReconnectRecoveryCoordinator,
+        RuntimeLiveProcessingGate,
+    ]:
+        recovery_started = threading.Event()
+        recovery_release = threading.Event()
+        (
+            coordinator,
+            gate,
+            *_,
+        ) = create_coordinator(
+            recovery_started=recovery_started,
+            recovery_release=recovery_release,
+        )
+        coordinator_task = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await wait_until(
+            recovery_started.is_set,
+        )
+
+        coordinator_task.cancel()
+        await asyncio.sleep(0)
+
+        assert coordinator_task.done() is False
+        assert gate.locked is True
+        assert coordinator._recovery_task is not None
+
+        recovery_release.set()
+
+        with pytest.raises(asyncio.CancelledError):
+            await coordinator_task
+
+        return (
+            coordinator,
+            gate,
+        )
+
+    coordinator, gate = asyncio.run(scenario())
+
+    assert gate.locked is False
+    assert coordinator._recovery_task is None
+
+
+def test_repeated_cancellation_waits_for_worker_before_opening_gate() -> None:
+    async def scenario() -> tuple[
+        RuntimeReconnectRecoveryCoordinator,
+        RuntimeLiveProcessingGate,
+        list[str],
+    ]:
+        recovery_started = threading.Event()
+        recovery_release = threading.Event()
+        (
+            coordinator,
+            gate,
+            *_,
+        ) = create_coordinator(
+            recovery_started=recovery_started,
+            recovery_release=recovery_release,
+        )
+        processed: list[str] = []
+        coordinator_task = asyncio.create_task(
+            coordinator.reconnect(),
+        )
+        await wait_until(
+            recovery_started.is_set,
+        )
+
+        async def process_live() -> None:
+            async with gate:
+                processed.append("live")
+
+        live_task = asyncio.create_task(
+            process_live(),
+        )
+
+        coordinator_task.cancel()
+        await asyncio.sleep(0)
+        coordinator_task.cancel()
+        await asyncio.sleep(0)
+
+        assert coordinator_task.done() is False
+        assert live_task.done() is False
+        assert gate.locked is True
+        assert coordinator._recovery_task is not None
+
+        recovery_release.set()
+
+        with pytest.raises(asyncio.CancelledError):
+            await coordinator_task
+
+        await live_task
+
+        return (
+            coordinator,
+            gate,
+            processed,
+        )
+
+    coordinator, gate, processed = asyncio.run(scenario())
+
+    assert processed == ["live"]
+    assert gate.locked is False
+    assert gate.failed is False
+    assert coordinator._recovery_task is None

app/tests/unit/market_data/acquisition/runtime/test_runtime_recovery_coordinator.py

@@ -184,7 +184,9 @@ class FakeStateStore:
         self._states.clear()
 
 
-class RecordingWindowPlanner:
+class RecordingWindowPlanner(
+    TradeRecoveryWindowPlanner,
+):
     """
     Planner с заранее заданным результатом.
     """
@@ -290,7 +292,7 @@ def create_coordinator(
 
     coordinator = RuntimeRecoveryCoordinator(
         state_store=resolved_state_store,
-        window_planner=resolved_window_planner,  # type: ignore[arg-type]
+        window_planner=resolved_window_planner,
         recovery_controller=resolved_recovery_controller,
     )
 
@@ -924,15 +926,8 @@ def test_controller_error_is_not_swallowed() -> None:
 
 def test_planner_error_is_not_swallowed() -> None:
     class BrokenPlanner(
-        TradeRecoveryWindowPlanner,
+        RecordingWindowPlanner,
     ):
-        def __init__(self) -> None:
-            pass
-
-        @property
-        def max_window_ms(self) -> int:
-            return 1
-
         def build_windows(
             self,
             *,

app/tests/unit/market_data/acquisition/runtime/test_runtime_scheduler.py

@@ -11,6 +11,9 @@ import pytest
 from src.market_data.acquisition.runtime.heartbeat import (
     HeartbeatState,
 )
+from src.market_data.acquisition.runtime.runtime_liveness_probe import (
+    RuntimeLivenessProbeProtocol,
+)
 from src.market_data.acquisition.runtime.scheduler import (
     RuntimeScheduler,
     RuntimeSchedulerProtocol,
@@ -58,9 +61,37 @@ class FakeHeartbeatMonitor:
         return self._results.pop(0)
 
 
+class FakeLivenessProbe:
+    def __init__(
+        self,
+        results: list[object] | None = None,
+        *,
+        error: BaseException | None = None,
+    ) -> None:
+        self._results = list(
+            results
+            if results is not None
+            else [True]
+        )
+        self._error = error
+        self.calls = 0
+
+    async def probe(self) -> bool:
+        self.calls += 1
+
+        if self._error is not None:
+            raise self._error
+
+        if not self._results:
+            return True
+
+        return self._results.pop(0)  # type: ignore[return-value]
+
+
 class FakeRuntimeSupervisor:
     def __init__(self) -> None:
         self.handle_timeout_calls = 0
+        self.notify_activity_calls = 0
 
     @property
     def state(self) -> RuntimeSupervisorState:
@@ -73,7 +104,7 @@ class FakeRuntimeSupervisor:
         return None
 
     def notify_activity(self) -> None:
-        return None
+        self.notify_activity_calls += 1
 
     async def handle_heartbeat_timeout(self) -> bool:
         self.handle_timeout_calls += 1
@@ -101,6 +132,7 @@ class RecordingSleep:
 
 def create_scheduler(
     *,
+    liveness_results: list[object] | None = None,
     heartbeat_results: list[bool] | None = None,
     interval_seconds: float = 1.0,
     sleep: Callable[[float], Awaitable[None]] | None = None,
@@ -115,6 +147,9 @@ def create_scheduler(
     supervisor = FakeRuntimeSupervisor()
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(
+            results=liveness_results,
+        ),
         heartbeat_monitor=heartbeat,
         runtime_supervisor=supervisor,
         interval_seconds=interval_seconds,
@@ -131,6 +166,10 @@ def create_scheduler(
 def test_scheduler_implements_protocol() -> None:
     scheduler, *_ = create_scheduler()
 
+    assert isinstance(
+        scheduler._liveness_probe,
+        RuntimeLivenessProbeProtocol,
+    )
     assert isinstance(
         scheduler,
         RuntimeSchedulerProtocol,
@@ -149,6 +188,71 @@ def test_initial_state_is_not_running() -> None:
     assert scheduler.running is False
 
 
+def test_claim_blocks_start_without_matching_owner() -> None:
+    scheduler, *_ = create_scheduler()
+    owner = object()
+    scheduler.claim(owner)
+
+    with pytest.raises(
+        RuntimeError,
+        match="owned by another lifecycle",
+    ):
+        asyncio.run(
+            scheduler.start()
+        )
+
+    scheduler.release(owner)
+
+
+def test_claim_rejects_active_scheduler() -> None:
+    scheduler, *_ = create_scheduler()
+    scheduler._running = True
+
+    with pytest.raises(
+        RuntimeError,
+        match="already owned or active",
+    ):
+        scheduler.claim(object())
+
+
+def test_release_rejects_running_owned_scheduler() -> None:
+    scheduler, *_ = create_scheduler()
+    owner = object()
+    scheduler.claim(owner)
+    scheduler._running = True
+
+    with pytest.raises(
+        RuntimeError,
+        match="Cannot release",
+    ):
+        scheduler.release(owner)
+
+
+def test_matching_owner_can_run_and_release_scheduler() -> None:
+    scheduler_holder: list[RuntimeScheduler] = []
+
+    async def stop_after_first_iteration(
+        seconds: float,
+    ) -> None:
+        scheduler_holder[0].stop()
+
+    scheduler, *_ = create_scheduler(
+        sleep=stop_after_first_iteration,
+    )
+    scheduler_holder.append(scheduler)
+    owner = object()
+    scheduler.claim(owner)
+
+    asyncio.run(
+        scheduler.start(
+            owner=owner,
+        )
+    )
+    scheduler.release(owner)
+
+    assert scheduler.running is False
+
+
 def test_exposes_interval_seconds() -> None:
     scheduler, *_ = create_scheduler(
         interval_seconds=2.5,
@@ -187,6 +291,7 @@ def test_rejects_invalid_interval_type(
 ) -> None:
     with pytest.raises(TypeError):
         RuntimeScheduler(
+            liveness_probe=FakeLivenessProbe(),
             heartbeat_monitor=FakeHeartbeatMonitor(),
             runtime_supervisor=FakeRuntimeSupervisor(),
             interval_seconds=interval_seconds,  # type: ignore[arg-type]
@@ -206,6 +311,7 @@ def test_rejects_non_positive_interval(
 ) -> None:
     with pytest.raises(ValueError):
         RuntimeScheduler(
+            liveness_probe=FakeLivenessProbe(),
             heartbeat_monitor=FakeHeartbeatMonitor(),
             runtime_supervisor=FakeRuntimeSupervisor(),
             interval_seconds=interval_seconds,
@@ -215,6 +321,7 @@ def test_rejects_non_positive_interval(
 def test_rejects_non_callable_sleep() -> None:
     with pytest.raises(TypeError):
         RuntimeScheduler(
+            liveness_probe=FakeLivenessProbe(),
             heartbeat_monitor=FakeHeartbeatMonitor(),
             runtime_supervisor=FakeRuntimeSupervisor(),
             interval_seconds=1.0,
@@ -233,9 +340,43 @@ def test_run_once_checks_heartbeat() -> None:
 
     assert result is False
     assert heartbeat.check_timeout_calls == 1
+    assert supervisor.notify_activity_calls == 1
     assert supervisor.handle_timeout_calls == 0
 
 
+def test_failed_probe_does_not_record_activity() -> None:
+    scheduler, heartbeat, supervisor = create_scheduler(
+        liveness_results=[False],
+        heartbeat_results=[False],
+    )
+
+    result = asyncio.run(
+        scheduler.run_once()
+    )
+
+    assert result is False
+    assert heartbeat.check_timeout_calls == 1
+    assert supervisor.notify_activity_calls == 0
+    assert supervisor.handle_timeout_calls == 0
+
+
+def test_rejects_non_boolean_probe_result() -> None:
+    scheduler, heartbeat, supervisor = create_scheduler(
+        liveness_results=["alive"],
+    )
+
+    with pytest.raises(
+        TypeError,
+        match="must return a boolean",
+    ):
+        asyncio.run(
+            scheduler.run_once()
+        )
+
+    assert heartbeat.check_timeout_calls == 0
+    assert supervisor.notify_activity_calls == 0
+
+
 def test_run_once_calls_supervisor_on_timeout() -> None:
     scheduler, heartbeat, supervisor = create_scheduler(
         heartbeat_results=[True],
@@ -402,6 +543,7 @@ def test_stop_during_run_once_prevents_sleep() -> None:
     heartbeat = StoppingHeartbeatMonitor()
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=heartbeat,
         runtime_supervisor=supervisor,
         interval_seconds=1.0,
@@ -438,6 +580,7 @@ def test_repeated_start_while_running_does_not_create_second_loop() -> None:
         scheduler.stop()
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=heartbeat,
         runtime_supervisor=supervisor,
         interval_seconds=1.0,
@@ -491,6 +634,7 @@ def test_heartbeat_error_is_propagated() -> None:
             raise RuntimeError("heartbeat failed")
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=BrokenHeartbeatMonitor(),
         runtime_supervisor=FakeRuntimeSupervisor(),
         interval_seconds=1.0,
@@ -511,6 +655,7 @@ def test_supervisor_error_is_propagated() -> None:
             raise RuntimeError("supervisor failed")
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=FakeHeartbeatMonitor(
             results=[True],
         ),
@@ -533,6 +678,7 @@ def test_start_resets_running_after_heartbeat_error() -> None:
             raise RuntimeError("heartbeat failed")
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=BrokenHeartbeatMonitor(),
         runtime_supervisor=FakeRuntimeSupervisor(),
         interval_seconds=1.0,
@@ -552,6 +698,7 @@ def test_start_resets_running_after_supervisor_error() -> None:
             raise RuntimeError("supervisor failed")
 
     scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(),
         heartbeat_monitor=FakeHeartbeatMonitor(
             results=[True],
         ),
@@ -588,3 +735,45 @@ def test_sleep_error_is_propagated_and_resets_running() -> None:
 
     assert heartbeat.check_timeout_calls == 1
     assert scheduler.running is False
+
+
+def test_liveness_error_is_propagated_and_resets_running() -> None:
+    liveness_error = RuntimeError("liveness failed")
+    scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(
+            error=liveness_error,
+        ),
+        heartbeat_monitor=FakeHeartbeatMonitor(),
+        runtime_supervisor=FakeRuntimeSupervisor(),
+        interval_seconds=1.0,
+    )
+
+    with pytest.raises(
+        RuntimeError,
+        match="liveness failed",
+    ) as error_info:
+        asyncio.run(
+            scheduler.start()
+        )
+
+    assert error_info.value is liveness_error
+    assert scheduler.running is False
+
+
+def test_liveness_cancellation_is_propagated() -> None:
+    cancellation = asyncio.CancelledError()
+    scheduler = RuntimeScheduler(
+        liveness_probe=FakeLivenessProbe(
+            error=cancellation,
+        ),
+        heartbeat_monitor=FakeHeartbeatMonitor(),
+        runtime_supervisor=FakeRuntimeSupervisor(),
+        interval_seconds=1.0,
+    )
+
+    with pytest.raises(asyncio.CancelledError):
+        asyncio.run(
+            scheduler.start()
+        )
+
+    assert scheduler.running is False

app/tests/unit/market_data/acquisition/runtime/test_runtime_supervisor.py

@@ -65,6 +65,7 @@ class FakeReconnectCoordinator:
     def __init__(self) -> None:
         self.reconnect_calls = 0
         self._attempt = 0
+        self._generation = 0
         self._state = ReconnectState.DISCONNECTED
 
     @property
@@ -75,11 +76,26 @@ class FakeReconnectCoordinator:
     def attempt(self) -> int:
         return self._attempt
 
+    @property
+    def generation(self) -> int:
+        return self._generation
+
     async def reconnect(self) -> None:
         self.reconnect_calls += 1
         self._attempt += 1
+        self._generation += 1
         self._state = ReconnectState.CONNECTED
 
+    async def reconnect_after_transport_failure(
+        self,
+        *,
+        observed_generation: int,
+    ) -> None:
+        if observed_generation != self._generation:
+            return
+
+        await self.reconnect()
+
 
 def create_supervisor() -> tuple[
     RuntimeSupervisor,
@@ -271,6 +287,41 @@ def test_timeout_runs_single_reconnect_attempt() -> None:
     assert reconnect.reconnect_calls == 1
 
 
+def test_delayed_timeout_reuses_completed_transport_reconnect() -> None:
+    async def scenario() -> tuple[
+        RuntimeSupervisor,
+        FakeHeartbeatMonitor,
+        FakeReconnectCoordinator,
+        bool,
+    ]:
+        supervisor, heartbeat, reconnect = create_supervisor()
+        supervisor.start()
+        observed_generation = reconnect.generation
+
+        await reconnect.reconnect_after_transport_failure(
+            observed_generation=observed_generation,
+        )
+        result = await supervisor.handle_heartbeat_timeout()
+
+        return (
+            supervisor,
+            heartbeat,
+            reconnect,
+            result,
+        )
+
+    supervisor, heartbeat, reconnect, result = asyncio.run(
+        scenario()
+    )
+
+    assert result is True
+    assert reconnect.reconnect_calls == 1
+    assert reconnect.generation == 1
+    assert heartbeat.stop_calls == 1
+    assert heartbeat.start_calls == 2
+    assert supervisor.state is RuntimeSupervisorState.RUNNING
+
+
 def test_successful_reconnect_restarts_heartbeat() -> None:
     supervisor, heartbeat, _ = create_supervisor()
 

app/tests/unit/market_data/acquisition/runtime/test_websocket_runtime_reconnect_integration.py

@@ -0,0 +1,252 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+import pytest
+from websockets.protocol import State
+
+from src.market_data.acquisition.adapters.dzengi.websocket_transport import (
+    DzengiWebSocketTransport,
+)
+from src.market_data.acquisition.exceptions import (
+    WebSocketTransportError,
+)
+from src.market_data.acquisition.runtime.acquisition_runtime_service import (
+    AcquisitionRuntimeService,
+)
+from src.market_data.acquisition.runtime.reconnect import (
+    ReconnectCoordinator,
+    ReconnectState,
+)
+from src.market_data.acquisition.runtime.runtime_events import (
+    ReconnectCompletedEvent,
+    ReconnectStartedEvent,
+)
+from src.market_data.acquisition.runtime.transport_messages import (
+    TransportTextMessage,
+)
+from src.market_data.acquisition.runtime.websocket_session import (
+    WebSocketSession,
+)
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    AcquisitionRuntimeEvent,
+)
+from src.market_data.acquisition.runtime.websocket_subscription_manager import (
+    WebSocketSubscriptionManager,
+)
+
+
+SUBSCRIPTION_KEY = "trades:BTC/USD_LEVERAGE"
+SUBSCRIPTION_PAYLOAD = '{"destination":"trades.subscribe"}'
+
+
+class FakeConnection:
+    def __init__(
+        self,
+        *,
+        send_error: Exception | None = None,
+    ) -> None:
+        self.state = State.OPEN
+        self.send_error = send_error
+        self.sent_messages: list[str | bytes] = []
+        self.close_calls = 0
+
+    async def close(
+        self,
+        code: int = 1000,
+        reason: str = "",
+    ) -> None:
+        self.close_calls += 1
+        self.state = State.CLOSED
+
+    async def send(
+        self,
+        message: str | bytes,
+    ) -> None:
+        if self.send_error is not None:
+            self.state = State.CLOSED
+            raise self.send_error
+
+        self.sent_messages.append(message)
+
+    async def recv(self) -> str | bytes:
+        return ""
+
+
+class RecordingConnector:
+    def __init__(
+        self,
+        *connections: FakeConnection,
+    ) -> None:
+        self._connections = list(connections)
+        self.calls: list[
+            tuple[str, dict[str, Any]]
+        ] = []
+
+    async def __call__(
+        self,
+        url: str,
+        **kwargs: Any,
+    ) -> FakeConnection:
+        self.calls.append(
+            (
+                url,
+                kwargs,
+            )
+        )
+
+        return self._connections.pop(0)
+
+
+class RecordingEventPublisher:
+    def __init__(self) -> None:
+        self.events: list[AcquisitionRuntimeEvent] = []
+
+    async def publish(
+        self,
+        event: AcquisitionRuntimeEvent,
+    ) -> None:
+        self.events.append(event)
+
+
+def create_runtime(
+    *connections: FakeConnection,
+) -> tuple[
+    WebSocketSession,
+    WebSocketSubscriptionManager,
+    ReconnectCoordinator,
+    RecordingConnector,
+    RecordingEventPublisher,
+]:
+    connector = RecordingConnector(
+        *connections,
+    )
+    transport = DzengiWebSocketTransport(
+        url="wss://api-adapter.dzengi.com",
+        connector=connector,
+    )
+    session = WebSocketSession(
+        transport,
+    )
+    subscriptions = WebSocketSubscriptionManager(
+        transport,
+    )
+    publisher = RecordingEventPublisher()
+    runtime_service = AcquisitionRuntimeService(
+        session=session,
+        transport=transport,
+        subscription_manager=subscriptions,
+        event_publisher=publisher,
+    )
+    reconnect = ReconnectCoordinator(
+        command_dispatcher=runtime_service,
+        subscription_manager=subscriptions,
+        event_publisher=publisher,
+    )
+
+    return (
+        session,
+        subscriptions,
+        reconnect,
+        connector,
+        publisher,
+    )
+
+
+def test_reconnect_replaces_open_connection_before_restore() -> None:
+    first_connection = FakeConnection()
+    second_connection = FakeConnection()
+    (
+        session,
+        subscriptions,
+        reconnect,
+        connector,
+        publisher,
+    ) = create_runtime(
+        first_connection,
+        second_connection,
+    )
+
+    async def scenario() -> None:
+        await session.start()
+        await subscriptions.subscribe(
+            SUBSCRIPTION_KEY,
+            TransportTextMessage(
+                payload=SUBSCRIPTION_PAYLOAD,
+            ),
+        )
+        await reconnect.reconnect()
+
+    asyncio.run(scenario())
+
+    assert len(connector.calls) == 2
+    assert first_connection.close_calls == 1
+    assert first_connection.state is State.CLOSED
+    assert first_connection.sent_messages == [
+        SUBSCRIPTION_PAYLOAD,
+    ]
+    assert second_connection.sent_messages == [
+        SUBSCRIPTION_PAYLOAD,
+    ]
+    assert session.is_connected is True
+    assert reconnect.state is ReconnectState.CONNECTED
+    assert publisher.events == [
+        ReconnectStartedEvent(attempt=1),
+        ReconnectCompletedEvent(attempt=1),
+    ]
+
+
+def test_reconnect_restores_subscription_after_initial_send_failure() -> None:
+    first_connection = FakeConnection(
+        send_error=RuntimeError(
+            "socket dropped while subscribing",
+        ),
+    )
+    second_connection = FakeConnection()
+    (
+        session,
+        subscriptions,
+        reconnect,
+        connector,
+        publisher,
+    ) = create_runtime(
+        first_connection,
+        second_connection,
+    )
+
+    async def scenario() -> None:
+        await session.start()
+
+        with pytest.raises(
+            WebSocketTransportError,
+            match="socket dropped while subscribing",
+        ):
+            await subscriptions.subscribe(
+                SUBSCRIPTION_KEY,
+                TransportTextMessage(
+                    payload=SUBSCRIPTION_PAYLOAD,
+                ),
+            )
+
+        assert subscriptions.subscription_keys == (
+            SUBSCRIPTION_KEY,
+        )
+
+        await reconnect.reconnect()
+
+    asyncio.run(scenario())
+
+    assert len(connector.calls) == 2
+    assert second_connection.sent_messages == [
+        SUBSCRIPTION_PAYLOAD,
+    ]
+    assert subscriptions.subscription_keys == (
+        SUBSCRIPTION_KEY,
+    )
+    assert session.is_connected is True
+    assert reconnect.state is ReconnectState.CONNECTED
+    assert publisher.events == [
+        ReconnectStartedEvent(attempt=1),
+        ReconnectCompletedEvent(attempt=1),
+    ]

app/tests/unit/market_data/acquisition/runtime/test_websocket_session.py

@@ -0,0 +1,196 @@
+from __future__ import annotations
+
+import asyncio
+
+import pytest
+
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    WebSocketSessionProtocol,
+)
+from src.market_data.acquisition.runtime.websocket_session import (
+    WebSocketSession,
+)
+
+
+class FakeTransport:
+    def __init__(self) -> None:
+        self.connected = False
+        self.connect_calls = 0
+        self.disconnect_calls = 0
+        self.connect_error: Exception | None = None
+        self.disconnect_error: Exception | None = None
+
+    @property
+    def is_connected(self) -> bool:
+        return self.connected
+
+    async def connect(self) -> None:
+        self.connect_calls += 1
+
+        if self.connect_error is not None:
+            raise self.connect_error
+
+        self.connected = True
+
+    async def disconnect(self) -> None:
+        self.disconnect_calls += 1
+        self.connected = False
+
+        if self.disconnect_error is not None:
+            raise self.disconnect_error
+
+    async def send(
+        self,
+        message: str | bytes,
+    ) -> None:
+        return None
+
+    async def receive(self) -> str | bytes:
+        return ""
+
+
+def create_session() -> tuple[
+    WebSocketSession,
+    FakeTransport,
+]:
+    transport = FakeTransport()
+    session = WebSocketSession(
+        transport,
+    )
+
+    return (
+        session,
+        transport,
+    )
+
+
+def test_session_implements_protocol() -> None:
+    session, _ = create_session()
+
+    assert isinstance(
+        session,
+        WebSocketSessionProtocol,
+    )
+
+
+def test_session_uses_slots() -> None:
+    session, _ = create_session()
+
+    assert not hasattr(session, "__dict__")
+
+
+def test_session_is_initially_disconnected() -> None:
+    session, _ = create_session()
+
+    assert session.is_connected is False
+
+
+def test_start_connects_transport() -> None:
+    session, transport = create_session()
+
+    asyncio.run(session.start())
+
+    assert session.is_connected is True
+    assert transport.connect_calls == 1
+
+
+def test_start_is_idempotent() -> None:
+    session, transport = create_session()
+
+    async def scenario() -> None:
+        await session.start()
+        await session.start()
+
+    asyncio.run(scenario())
+
+    assert session.is_connected is True
+    assert transport.connect_calls == 1
+
+
+def test_concurrent_start_creates_one_connection() -> None:
+    session, transport = create_session()
+
+    async def scenario() -> None:
+        await asyncio.gather(
+            session.start(),
+            session.start(),
+        )
+
+    asyncio.run(scenario())
+
+    assert session.is_connected is True
+    assert transport.connect_calls == 1
+
+
+def test_start_error_leaves_session_disconnected() -> None:
+    session, transport = create_session()
+    transport.connect_error = RuntimeError("start failed")
+
+    with pytest.raises(
+        RuntimeError,
+        match="start failed",
+    ):
+        asyncio.run(session.start())
+
+    assert session.is_connected is False
+
+
+def test_start_reconnects_after_remote_disconnect() -> None:
+    session, transport = create_session()
+
+    async def scenario() -> None:
+        await session.start()
+        transport.connected = False
+
+        assert session.is_connected is False
+
+        await session.start()
+
+    asyncio.run(scenario())
+
+    assert session.is_connected is True
+    assert transport.connect_calls == 2
+
+
+def test_stop_disconnects_transport() -> None:
+    session, transport = create_session()
+
+    async def scenario() -> None:
+        await session.start()
+        await session.stop()
+
+    asyncio.run(scenario())
+
+    assert session.is_connected is False
+    assert transport.disconnect_calls == 1
+
+
+def test_stop_is_idempotent() -> None:
+    session, transport = create_session()
+
+    async def scenario() -> None:
+        await session.start()
+        await session.stop()
+        await session.stop()
+
+    asyncio.run(scenario())
+
+    assert transport.disconnect_calls == 1
+    assert session.is_connected is False
+
+
+def test_stop_error_still_clears_session_state() -> None:
+    session, transport = create_session()
+    transport.disconnect_error = RuntimeError("stop failed")
+
+    async def scenario() -> None:
+        await session.start()
+        await session.stop()
+
+    with pytest.raises(
+        RuntimeError,
+        match="stop failed",
+    ):
+        asyncio.run(scenario())
+
+    assert session.is_connected is False

app/tests/unit/market_data/acquisition/runtime/test_websocket_subscription_manager.py

@@ -0,0 +1,419 @@
+from __future__ import annotations
+
+import asyncio
+
+import pytest
+
+from src.market_data.acquisition.exceptions import (
+    WebSocketUnsubscribeNotSupportedError,
+)
+from src.market_data.acquisition.runtime.transport_messages import (
+    TransportBinaryMessage,
+    TransportTextMessage,
+)
+from src.market_data.acquisition.runtime.websocket_protocol import (
+    WebSocketSubscriptionManagerProtocol,
+)
+from src.market_data.acquisition.runtime.websocket_subscription_manager import (
+    WebSocketSubscriptionManager,
+)
+
+
+class RecordingTransport:
+    def __init__(self) -> None:
+        self.messages: list[str | bytes] = []
+        self.send_error: Exception | None = None
+
+    async def connect(self) -> None:
+        return None
+
+    async def disconnect(self) -> None:
+        return None
+
+    async def send(
+        self,
+        message: str | bytes,
+    ) -> None:
+        if self.send_error is not None:
+            raise self.send_error
+
+        self.messages.append(message)
+
+    async def receive(self) -> str | bytes:
+        return ""
+
+
+def create_manager(
+    *,
+    supports_unsubscribe: bool = False,
+) -> tuple[
+    WebSocketSubscriptionManager,
+    RecordingTransport,
+]:
+    transport = RecordingTransport()
+    manager = WebSocketSubscriptionManager(
+        transport,
+        supports_unsubscribe=supports_unsubscribe,
+    )
+
+    return (
+        manager,
+        transport,
+    )
+
+
+def test_manager_implements_protocol() -> None:
+    manager, _ = create_manager()
+
+    assert isinstance(
+        manager,
+        WebSocketSubscriptionManagerProtocol,
+    )
+
+
+def test_manager_uses_slots() -> None:
+    manager, _ = create_manager()
+
+    assert not hasattr(manager, "__dict__")
+
+
+def test_manager_starts_with_empty_registry() -> None:
+    manager, _ = create_manager()
+
+    assert manager.subscription_keys == ()
+
+
+def test_subscribe_sends_and_registers_text_message() -> None:
+    manager, transport = create_manager()
+    message = TransportTextMessage(
+        payload='{"destination":"trades.subscribe"}',
+    )
+
+    asyncio.run(
+        manager.subscribe(
+            "trades:BTC",
+            message,
+        )
+    )
+
+    assert transport.messages == [
+        message.payload,
+    ]
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_subscribe_sends_binary_message() -> None:
+    manager, transport = create_manager()
+    message = TransportBinaryMessage(
+        payload=b"\x01\x02",
+    )
+
+    asyncio.run(
+        manager.subscribe(
+            "binary",
+            message,
+        )
+    )
+
+    assert transport.messages == [
+        b"\x01\x02",
+    ]
+    assert manager.subscription_keys == (
+        "binary",
+    )
+
+
+def test_duplicate_subscription_key_is_idempotent() -> None:
+    manager, transport = create_manager()
+    first_message = TransportTextMessage(
+        payload="first",
+    )
+    second_message = TransportTextMessage(
+        payload="second",
+    )
+
+    async def scenario() -> None:
+        await manager.subscribe(
+            "trades:BTC",
+            first_message,
+        )
+        await manager.subscribe(
+            "trades:BTC",
+            second_message,
+        )
+
+    asyncio.run(scenario())
+
+    assert transport.messages == [
+        "first",
+    ]
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_failed_subscribe_remains_registered_as_pending() -> None:
+    manager, transport = create_manager()
+    transport.send_error = RuntimeError("send failed")
+
+    with pytest.raises(
+        RuntimeError,
+        match="send failed",
+    ):
+        asyncio.run(
+            manager.subscribe(
+                "trades:BTC",
+                TransportTextMessage(
+                    payload="subscribe",
+                ),
+            )
+        )
+
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_pending_subscription_can_be_retried() -> None:
+    manager, transport = create_manager()
+    transport.send_error = RuntimeError("send failed")
+
+    async def scenario() -> None:
+        with pytest.raises(
+            RuntimeError,
+            match="send failed",
+        ):
+            await manager.subscribe(
+                "trades:BTC",
+                TransportTextMessage(
+                    payload="first-attempt",
+                ),
+            )
+
+        transport.send_error = None
+
+        await manager.subscribe(
+            "trades:BTC",
+            TransportTextMessage(
+                payload="second-attempt",
+            ),
+        )
+
+    asyncio.run(scenario())
+
+    assert transport.messages == [
+        "second-attempt",
+    ]
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_restore_sends_registered_messages_in_order() -> None:
+    manager, transport = create_manager()
+
+    async def scenario() -> None:
+        await manager.subscribe(
+            "first",
+            TransportTextMessage(
+                payload="first-message",
+            ),
+        )
+        await manager.subscribe(
+            "second",
+            TransportBinaryMessage(
+                payload=b"second-message",
+            ),
+        )
+
+        transport.messages.clear()
+        await manager.restore_subscriptions()
+
+    asyncio.run(scenario())
+
+    assert transport.messages == [
+        "first-message",
+        b"second-message",
+    ]
+
+
+def test_restore_error_preserves_registry() -> None:
+    manager, transport = create_manager()
+
+    async def prepare() -> None:
+        await manager.subscribe(
+            "trades:BTC",
+            TransportTextMessage(
+                payload="subscribe",
+            ),
+        )
+
+    asyncio.run(prepare())
+    transport.send_error = RuntimeError("restore failed")
+
+    with pytest.raises(
+        RuntimeError,
+        match="restore failed",
+    ):
+        asyncio.run(manager.restore_subscriptions())
+
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_unsubscribe_is_explicitly_unsupported_by_default() -> None:
+    manager, transport = create_manager()
+
+    async def scenario() -> None:
+        await manager.subscribe(
+            "trades:BTC",
+            TransportTextMessage(
+                payload="subscribe",
+            ),
+        )
+        await manager.unsubscribe(
+            "trades:BTC",
+            TransportTextMessage(
+                payload="unsubscribe",
+            ),
+        )
+
+    with pytest.raises(
+        WebSocketUnsubscribeNotSupportedError,
+    ):
+        asyncio.run(scenario())
+
+    assert transport.messages == [
+        "subscribe",
+    ]
+    assert manager.subscription_keys == (
+        "trades:BTC",
+    )
+
+
+def test_supported_unsubscribe_sends_and_removes_subscription() -> None:
+    manager, transport = create_manager(
+        supports_unsubscribe=True,
+    )
+
+    async def scenario() -> None:
+        await manager.subscribe(
+            "generic",
+            TransportTextMessage(
+                payload="subscribe",
+            ),
+        )
+        await manager.unsubscribe(
+            "generic",
+            TransportTextMessage(
+                payload="unsubscribe",
+            ),
+        )
+
+    asyncio.run(scenario())
+
+    assert transport.messages == [
+        "subscribe",
+        "unsubscribe",
+    ]
+    assert manager.subscription_keys == ()
+
+
+def test_supported_unsubscribe_is_idempotent_for_missing_key() -> None:
+    manager, transport = create_manager(
+        supports_unsubscribe=True,
+    )
+
+    asyncio.run(
+        manager.unsubscribe(
+            "missing",
+            TransportTextMessage(
+                payload="unsubscribe",
+            ),
+        )
+    )
+
+    assert transport.messages == []
+    assert manager.subscription_keys == ()
+
+
+def test_clear_removes_registry_without_sending_messages() -> None:
+    manager, transport = create_manager()
+
+    async def scenario() -> None:
+        await manager.subscribe(
+            "trades:BTC",
+            TransportTextMessage(
+                payload="subscribe",
+            ),
+        )
+
+        transport.messages.clear()
+        await manager.clear_subscriptions()
+
+    asyncio.run(scenario())
+
+    assert manager.subscription_keys == ()
+    assert transport.messages == []
+
+
+@pytest.mark.parametrize(
+    "subscription_key",
+    [
+        "",
+        "   ",
+    ],
+)
+def test_rejects_empty_subscription_key(
+    subscription_key: str,
+) -> None:
+    manager, _ = create_manager()
+
+    with pytest.raises(ValueError):
+        asyncio.run(
+            manager.subscribe(
+                subscription_key,
+                TransportTextMessage(
+                    payload="subscribe",
+                ),
+            )
+        )
+
+
+def test_rejects_non_string_subscription_key() -> None:
+    manager, _ = create_manager()
+
+    with pytest.raises(TypeError):
+        asyncio.run(
+            manager.subscribe(
+                123,  # type: ignore[arg-type]
+                TransportTextMessage(
+                    payload="subscribe",
+                ),
+            )
+        )
+
+
+def test_rejects_unsupported_message_type() -> None:
+    manager, _ = create_manager()
+
+    with pytest.raises(TypeError):
+        asyncio.run(
+            manager.subscribe(
+                "trades:BTC",
+                object(),  # type: ignore[arg-type]
+            )
+        )
+
+
+def test_rejects_non_boolean_unsubscribe_capability() -> None:
+    transport = RecordingTransport()
+
+    with pytest.raises(TypeError):
+        WebSocketSubscriptionManager(
+            transport,
+            supports_unsubscribe="yes",  # type: ignore[arg-type]
+        )

app/tests/unit/market_data/acquisition/test_trade_stream_runtime_composition.py

@@ -28,6 +28,12 @@ from src.market_data.acquisition.runtime.reconnect import (
     ReconnectCoordinatorProtocol,
     ReconnectState,
 )
+from src.market_data.acquisition.runtime.runtime_reconnect_recovery_coordinator import (
+    RuntimeReconnectRecoveryProtocol,
+)
+from src.market_data.acquisition.runtime.runtime_liveness_probe import (
+    RuntimeLivenessProbeProtocol,
+)
 from src.market_data.acquisition.runtime.runtime_events import (
     ReconnectCompletedEvent,
     ReconnectStartedEvent,
@@ -123,11 +129,17 @@ class FakeSession:
 
 
 class FakeTransport:
-    def __init__(self) -> None:
+    def __init__(
+        self,
+        *,
+        probe_results: tuple[bool, ...] = (True,),
+    ) -> None:
         self.connect_calls = 0
         self.disconnect_calls = 0
         self.sent_messages: list[str | bytes] = []
         self.receive_calls = 0
+        self.probe_calls = 0
+        self._probe_results = list(probe_results)
 
     async def connect(self) -> None:
         self.connect_calls += 1
@@ -145,6 +157,14 @@ class FakeTransport:
         self.receive_calls += 1
         return ""
 
+    async def probe(self) -> bool:
+        self.probe_calls += 1
+
+        if not self._probe_results:
+            return True
+
+        return self._probe_results.pop(0)
+
 
 class FakeSubscriptionManager:
     def __init__(self) -> None:
@@ -264,6 +284,25 @@ class FakeClock:
     def __call__(self) -> float:
         return self.value
 
+    def advance(
+        self,
+        seconds: float,
+    ) -> None:
+        self.value += seconds
+
+
+class FakeUnixTimeClock:
+    def __init__(
+        self,
+        value: int = RECOVERY_END_TIME_MS,
+    ) -> None:
+        self.value = value
+        self.calls = 0
+
+    def __call__(self) -> int:
+        self.calls += 1
+        return self.value
+
 
 class RecordingSleep:
     def __init__(self) -> None:
@@ -285,6 +324,7 @@ class CompositionDependencies:
     message_adapter: FakeMessageAdapter
     recovery_document_source: StubTradesDocumentSource
     heartbeat_clock: FakeClock
+    recovery_end_time_clock: FakeUnixTimeClock
     scheduler_sleep: RecordingSleep
 
 
@@ -295,13 +335,16 @@ def create_composition(
     heartbeat_timeout_seconds: float = 10.0,
     scheduler_interval_seconds: float = 1.0,
     max_recovery_window_ms: int = 3_599_999,
+    probe_results: tuple[bool, ...] = (True,),
 ) -> tuple[
     TradeStreamRuntimeComposition,
     CompositionDependencies,
 ]:
     dependencies = CompositionDependencies(
         session=FakeSession(),
-        transport=FakeTransport(),
+        transport=FakeTransport(
+            probe_results=probe_results,
+        ),
         subscription_manager=FakeSubscriptionManager(),
         event_publisher=FakeEventPublisher(),
         message_adapter=FakeMessageAdapter(
@@ -311,6 +354,7 @@ def create_composition(
             recovery_document,
         ),
         heartbeat_clock=FakeClock(),
+        recovery_end_time_clock=FakeUnixTimeClock(),
         scheduler_sleep=RecordingSleep(),
     )
 
@@ -323,10 +367,14 @@ def create_composition(
         recovery_document_source=(
             dependencies.recovery_document_source
         ),
+        symbols=(SYMBOL,),
         heartbeat_timeout_seconds=heartbeat_timeout_seconds,
         scheduler_interval_seconds=scheduler_interval_seconds,
         max_recovery_window_ms=max_recovery_window_ms,
         heartbeat_clock=dependencies.heartbeat_clock,
+        recovery_end_time_clock=(
+            dependencies.recovery_end_time_clock
+        ),
         scheduler_sleep=dependencies.scheduler_sleep,
     )
 
@@ -373,6 +421,14 @@ def test_components_implement_public_protocols() -> None:
         composition.reconnect_coordinator,
         ReconnectCoordinatorProtocol,
     )
+    assert isinstance(
+        composition.runtime_reconnect_recovery_coordinator,
+        RuntimeReconnectRecoveryProtocol,
+    )
+    assert isinstance(
+        composition.liveness_probe,
+        RuntimeLivenessProbeProtocol,
+    )
     assert isinstance(
         composition.heartbeat_monitor,
         HeartbeatMonitorProtocol,
@@ -460,8 +516,27 @@ def test_runtime_components_share_lifecycle_dependencies() -> None:
     )
     assert (
         composition.runtime_supervisor._reconnect_coordinator
+        is composition.runtime_reconnect_recovery_coordinator
+    )
+    assert (
+        composition.runtime_reconnect_recovery_coordinator
+        ._reconnect_coordinator
         is composition.reconnect_coordinator
     )
+    assert (
+        composition.runtime_reconnect_recovery_coordinator
+        ._recovery_coordinator
+        is composition.runtime_recovery_coordinator
+    )
+    assert (
+        composition.runtime_reconnect_recovery_coordinator
+        .live_processing_gate
+        is composition.live_processing_gate
+    )
+    assert (
+        composition.runtime_reconnect_recovery_coordinator.symbols
+        == (SYMBOL,)
+    )
     assert (
         composition.runtime_scheduler._heartbeat_monitor
         is composition.heartbeat_monitor
@@ -470,6 +545,14 @@ def test_runtime_components_share_lifecycle_dependencies() -> None:
         composition.runtime_scheduler._runtime_supervisor
         is composition.runtime_supervisor
     )
+    assert (
+        composition.liveness_probe
+        is dependencies.transport
+    )
+    assert (
+        composition.runtime_scheduler._liveness_probe
+        is composition.liveness_probe
+    )
 
 
 def test_configuration_is_forwarded() -> None:
@@ -507,6 +590,7 @@ def test_creation_has_no_runtime_side_effects() -> None:
     assert dependencies.transport.disconnect_calls == 0
     assert dependencies.transport.sent_messages == []
     assert dependencies.transport.receive_calls == 0
+    assert dependencies.transport.probe_calls == 0
 
     assert dependencies.subscription_manager.subscriptions == []
     assert dependencies.subscription_manager.unsubscriptions == []
@@ -515,6 +599,7 @@ def test_creation_has_no_runtime_side_effects() -> None:
 
     assert dependencies.event_publisher.events == []
     assert dependencies.recovery_document_source.calls == []
+    assert dependencies.recovery_end_time_clock.calls == 0
 
     assert composition.heartbeat_monitor.state is HeartbeatState.IDLE
     assert (
@@ -528,6 +613,103 @@ def test_creation_has_no_runtime_side_effects() -> None:
     assert composition.runtime_scheduler.running is False
 
 
+def test_successful_probe_keeps_quiet_connection_alive() -> None:
+    composition, dependencies = create_composition(
+        heartbeat_timeout_seconds=10.0,
+        probe_results=(True,),
+    )
+    composition.runtime_supervisor.start()
+    dependencies.heartbeat_clock.advance(10.0)
+
+    timed_out = asyncio.run(
+        composition.runtime_scheduler.run_once()
+    )
+
+    assert timed_out is False
+    assert dependencies.transport.probe_calls == 1
+    assert dependencies.session.start_calls == 0
+    assert dependencies.session.stop_calls == 0
+    assert composition.heartbeat_monitor.last_activity_at == 110.0
+    assert (
+        composition.runtime_supervisor.state
+        is RuntimeSupervisorState.RUNNING
+    )
+
+
+def test_failed_probe_triggers_reconnect_after_timeout() -> None:
+    composition, dependencies = create_composition(
+        heartbeat_timeout_seconds=10.0,
+        probe_results=(False,),
+    )
+    composition.runtime_supervisor.start()
+    dependencies.heartbeat_clock.advance(10.0)
+
+    timed_out = asyncio.run(
+        composition.runtime_scheduler.run_once()
+    )
+
+    assert timed_out is True
+    assert dependencies.transport.probe_calls == 1
+    assert dependencies.session.stop_calls == 1
+    assert dependencies.session.start_calls == 1
+    assert dependencies.subscription_manager.restore_calls == 1
+    assert dependencies.recovery_end_time_clock.calls == 1
+    assert (
+        composition.runtime_supervisor.state
+        is RuntimeSupervisorState.RUNNING
+    )
+
+
+def test_delayed_timeout_does_not_repeat_completed_transport_reconnect() -> None:
+    async def scenario() -> tuple[
+        TradeStreamRuntimeComposition,
+        CompositionDependencies,
+        bool,
+    ]:
+        composition, dependencies = create_composition(
+            heartbeat_timeout_seconds=10.0,
+            probe_results=(False,),
+        )
+        composition.runtime_supervisor.start()
+        observed_generation = (
+            composition.runtime_reconnect_recovery_coordinator.generation
+        )
+
+        await (
+            composition.runtime_reconnect_recovery_coordinator
+            .reconnect_after_transport_failure(
+                observed_generation=observed_generation,
+            )
+        )
+        dependencies.heartbeat_clock.advance(10.0)
+        timed_out = await composition.runtime_scheduler.run_once()
+
+        return (
+            composition,
+            dependencies,
+            timed_out,
+        )
+
+    composition, dependencies, timed_out = asyncio.run(
+        scenario()
+    )
+
+    assert timed_out is True
+    assert dependencies.transport.probe_calls == 1
+    assert dependencies.session.stop_calls == 1
+    assert dependencies.session.start_calls == 1
+    assert dependencies.subscription_manager.restore_calls == 1
+    assert dependencies.recovery_end_time_clock.calls == 1
+    assert (
+        composition.runtime_reconnect_recovery_coordinator.generation
+        == 1
+    )
+    assert (
+        composition.runtime_supervisor.state
+        is RuntimeSupervisorState.RUNNING
+    )
+
+
 def test_live_checkpoint_is_visible_to_runtime_recovery() -> None:
     checkpoint_trade = make_trade()
 
@@ -642,6 +824,35 @@ def test_reconnect_uses_composed_runtime_dependencies() -> None:
     )
 
 
+def test_runtime_reconnect_runs_recovery_after_subscription_restore() -> None:
+    composition, dependencies = create_composition(
+        recovery_document=[],
+    )
+
+    composition.trade_stream_acquisition_service.handle_message(
+        {
+            "destination": "internal.trade",
+        }
+    )
+
+    asyncio.run(
+        composition.runtime_reconnect_recovery_coordinator.reconnect()
+    )
+
+    assert dependencies.session.stop_calls == 1
+    assert dependencies.session.start_calls == 1
+    assert dependencies.subscription_manager.restore_calls == 1
+    assert dependencies.recovery_end_time_clock.calls == 1
+    assert dependencies.recovery_document_source.calls == [
+        (
+            SYMBOL,
+            CHECKPOINT_TIME_MS,
+            RECOVERY_END_TIME_MS,
+            None,
+        )
+    ]
+
+
 def test_separate_compositions_have_independent_state() -> None:
     first, _ = create_composition()
     second, _ = create_composition()
@@ -690,6 +901,7 @@ def test_invalid_heartbeat_configuration_is_not_hidden(
             [],
         ),
         heartbeat_clock=FakeClock(),
+        recovery_end_time_clock=FakeUnixTimeClock(),
         scheduler_sleep=RecordingSleep(),
     )
 
@@ -705,9 +917,13 @@ def test_invalid_heartbeat_configuration_is_not_hidden(
             recovery_document_source=(
                 dependencies.recovery_document_source
             ),
+            symbols=(SYMBOL,),
             heartbeat_timeout_seconds=heartbeat_timeout_seconds,  # type: ignore[arg-type]
             scheduler_interval_seconds=1.0,
             heartbeat_clock=dependencies.heartbeat_clock,
+            recovery_end_time_clock=(
+                dependencies.recovery_end_time_clock
+            ),
             scheduler_sleep=dependencies.scheduler_sleep,
         )
 

app/tests/unit/test_main.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import asyncio
+
+import src.main as main_module
+
+
+def test_main_runs_application_composition(
+    monkeypatch,
+) -> None:
+    application = object()
+    received_applications: list[object] = []
+
+    monkeypatch.setattr(
+        main_module,
+        "create_app",
+        lambda: application,
+    )
+
+    async def run(received_application: object) -> None:
+        received_applications.append(
+            received_application,
+        )
+
+    monkeypatch.setattr(
+        main_module,
+        "run_application",
+        run,
+    )
+
+    asyncio.run(main_module.main())
+
+    assert received_applications == [application]