s-librarykit 0.3.0__tar.gz → 0.3.1__tar.gz

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s-librarykit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Жирный КОРЕНЬ китов: единая error-иерархия, config/retry/paths-утили, checkpoint/resume, транспорт/auth/sessions — общий код для clikit, adapterkit и доменных пакетов.
 Author: Dmitry
 License: MIT

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/__init__.py

@@ -249,161 +249,100 @@ from librarykit.windows import (
     parse_window,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 
 __all__ = [
     "__version__",
-    # checkpoint
-    "Checkpoint",
-    "JsonlSink",
-    "RunMetrics",
-    # errors (единая иерархия ERROR-HUB)
-    "CliError",
-    "ApiError",
-    "AuthRequired",
-    "SessionExpired",
-    "RateLimited",
-    "ValidationError",
-    "NotImplementedYet",
-    "NotFoundError",
-    "ServerError",
-    "TransportError",
-    "Blocked",
-    "RETRYABLE",
-    "AdapterError",
-    "NotFound",
-    "GraphQLError",
-    # config_util / paths
-    "deep_merge",
-    "interpolate_env",
-    "load_dotenv",
-    "slugify",
-    "normalize_account_id",
-    "atomic_write_text",
-    "chmod_600",
-    "AppPaths",
-    # session_paths — единый резолвер браузерных сессий (~/.sessions)
-    "sessions_home",
-    "browser_profile_dir",
-    "shared_google_profile_dir",
-    "make_profile_dir_resolver",
-    "make_session_store",
-    # contract — generic «талия» (Protocol + enums + DTO координат сессии/кредов)
-    "PaginationMode",
-    "AuthMode",
+    # requesting: транспорт-исполнители + режимы/протоколы запроса
     "TransportKind",
     "RequestExecutionMode",
-    "SessionRef",
-    "Creds",
     "RequestBody",
     "ResponseLike",
     "Transport",
     "SyncTransport",
     "HttpRequestExecutor",
     "SyncHttpRequestExecutor",
-    "StreamTransport",
+    "Codec",
+    "make_transport",
+    "register_transport",
+    "create_request_executor",
+    "register_request_provider",
+    "HttpxTransport",
+    "HttpxRequestExecutor",
+    "HttpClient",
+    "RestHttpClient",
+    "HttpxSyncTransport",
+    "HttpxSyncRequestExecutor",
+    "SyncHttpClient",
+    # browser/сессии: ЖЦ браузер-сессии + профили + warmup-минт
     "BrowserBackend",
     "SyncBrowserBackend",
     "BrowserSession",
     "SyncBrowserSession",
-    "Codec",
-    "Auth",
-    # factory — нейтральный выбор транспорта/браузера по роли (Enum → фабрика → реестр)
     "BrowserEngine",
     "BrowserProvider",
     "AutomationDriver",
     "BrowserOptions",
     "BrowserSessionSettings",
-    "make_transport",
-    "register_transport",
-    "create_request_executor",
-    "register_request_provider",
     "make_browser_backend",
     "register_browser_backend",
     "create_browser_session",
     "register_browser_provider",
+    "sessions_home",
+    "browser_profile_dir",
+    "shared_google_profile_dir",
+    "make_profile_dir_resolver",
+    "make_session_store",
+    "WarmupTokenMinter",
+    "TokenHarvest",
+    # auth + refresh: стратегии авторизации + проактивное обновление сессии
+    "AuthMode",
+    "Auth",
     "Refreshable",
     "ProactiveRefreshable",
     "SyncRefreshable",
     "SyncProactiveRefreshable",
-    "ErrorMapper",
-    "Paginator",
+    "TokenAuth",
+    "CookieSessionAuth",
+    "OAuth2Auth",
+    "BrowserLoginAuth",
+    "CsrfHeaderAuth",
+    "CSRF_DEFAULT_HEADER",
+    "extract_token_from_text",
+    "dump_settings",
+    "load_settings",
+    "encrypt_settings",
+    "decrypt_settings",
+    "RotatingAuth",
+    "Keepalive",
+    "RefreshableChain",
+    "DEFAULT_ROTATE_INTERVAL",
+    # sessions + secrets: envelope-хранилище сессий + креды + keyring-стор
+    "SessionRef",
+    "Creds",
     "SessionStoreProtocol",
-    # contract — квоты/лимиты (generic DTO)
-    "QuotaScope",
-    "QuotaInfo",
-    "LimitSpec",
-    # protocols — онбординг/health контракты (опциональные)
-    "LoginMode",
-    "LoginRequirements",
-    "InteractiveFlow",
-    "OnboardingProtocol",
-    "HealthState",
-    "HealthStatus",
-    "HealthProtocol",
-    # entities (W6) — нейтральные data-классы оркестраторов (почва под W7)
-    "Session",
-    "SessionChanges",
-    "SessionContext",
-    "HealthReport",
-    # secret_store — keyring + file-fallback
-    "SecretStore",
-    # sessions (W4): envelope-шифрованное хранилище сессий (spec §4)
     "SessionStore",
     "SessionStoreError",
     "KekUnavailableError",
     "resolve_kek",
-    # transport (W4): конкретный httpx-транспорт + choke-point клиент
-    "HttpxTransport",
-    "HttpxRequestExecutor",
-    "HttpClient",
-    "RestHttpClient",
-    # transport sync-сиблинги (для навыков без event-loop)
-    "HttpxSyncTransport",
-    "HttpxSyncRequestExecutor",
-    "SyncHttpClient",
-    # forms (W8): кодек form-urlencoded тел с nested-JSON полями
-    "FormCodec",
-    # graphql (W8): GENERIC GraphQL-клиент поверх RestHttpClient/HttpClient
-    "GraphQLClient",
-    # upload (W8): GENERIC resumable chunked uploader
-    "ChunkedUploader",
-    "UploadResult",
-    # blocks (W8): GENERIC draft.js richtext block-хелперы
-    "blocks",
-    "text_block",
-    "block_end",
-    "header_block",
-    "list_item_block",
-    "paragraphs",
-    "decode_text_block",
-    # limit: проактивный конфигуратор троттлинга / rate-limit по scope
-    "LimitWindow",
-    "LimitPolicy",
-    "LimitScope",
-    "RateLimiter",
-    # windows: обобщённые ОКНА лимитов (rolling/calendar/fixed) + фабрика
-    "Window",
-    "RollingWindow",
-    "CalendarWindow",
-    "FixedWindow",
-    "parse_window",
-    # antibot: warmup-минт одноразовых токенов тёплой страницей (генерик)
-    "WarmupTokenMinter",
-    "TokenHarvest",
-    # pool: балансер N аккаунтов одного сервиса (селектор поверх SessionStore)
-    "SessionPool",
-    "PoolChoice",
-    "DEFAULT_SKIP_STATUSES",
-    # rpc (E1): codec-слой + RPC choke-point поверх HttpClient
-    "JsonCodec",
-    "PrefixedJsonCodec",
-    "RpcClient",
-    # stream (E1): WS-подобные persistent-транспорты (Stub + websockets reference)
-    "StubStreamTransport",
-    "WebSocketsStreamTransport",
-    "StreamClosedError",
-    # errmap (W4): декларативная карта HTTP-ответ → доменная ошибка
+    "SecretStore",
+    # errors + errmap: единая иерархия ERROR-HUB + карта ответ→ошибка
+    "CliError",
+    "ApiError",
+    "AuthRequired",
+    "SessionExpired",
+    "RateLimited",
+    "ValidationError",
+    "NotImplementedYet",
+    "NotFoundError",
+    "ServerError",
+    "TransportError",
+    "Blocked",
+    "RETRYABLE",
+    "AdapterError",
+    "NotFound",
+    "GraphQLError",
+    "ErrorMapper",
     "ErrorMap",
     "ErrorMapBuilder",
     "BodyRule",
@@ -411,7 +350,27 @@ __all__ = [
     "AuthExpired",
     "build_error_map",
     "DEFAULT_ERROR_MAP",
-    # pagination (W4): листатель ресурса (offset/cursor/page) tweepy-стиля
+    # reliability: retry / limit / pool / checkpoint
+    "RetryPolicy",
+    "DEFAULT_RETRY",
+    "SimpleRetryPolicy",
+    "DEFAULT_SIMPLE_RETRY",
+    "LimitWindow",
+    "LimitPolicy",
+    "LimitScope",
+    "RateLimiter",
+    "LimitSpec",
+    "QuotaScope",
+    "QuotaInfo",
+    "SessionPool",
+    "PoolChoice",
+    "DEFAULT_SKIP_STATUSES",
+    "Checkpoint",
+    "JsonlSink",
+    "RunMetrics",
+    # pagination / bulk / upload: листание ресурса + батчи + resumable-догрузка
+    "PaginationMode",
+    "Paginator",
     "CursorPaginator",
     "PageParams",
     "DEFAULT_PAGE_PARAMS",
@@ -420,40 +379,52 @@ __all__ = [
     "default_extract_items",
     "default_extract_cursor",
     "with_page_params",
-    # pagination flat-page (W8): offset/total на верхнем уровне тела
     "FlatPage",
     "parse_flat_page",
     "next_flat_offset",
-    # auth (W4): стратегии авторизации + персистентность сессии
-    "TokenAuth",
-    "CookieSessionAuth",
-    "OAuth2Auth",
-    "BrowserLoginAuth",
-    "CsrfHeaderAuth",
-    "CSRF_DEFAULT_HEADER",
-    "extract_token_from_text",
-    "dump_settings",
-    "load_settings",
-    "encrypt_settings",
-    "decrypt_settings",
-    # refresh: проактивное обновление ротируемой сессии + keepalive + fallback
-    "RotatingAuth",
-    "Keepalive",
-    "RefreshableChain",
-    "DEFAULT_ROTATE_INTERVAL",
-    # retry
-    "RetryPolicy",
-    "DEFAULT_RETRY",
-    "SimpleRetryPolicy",
-    "DEFAULT_SIMPLE_RETRY",
-    # bulk: движок батч-операций над набором id (per-item outcome, не роняет батч)
     "BulkOutcome",
     "BulkOperationError",
     "BulkError",
     "BulkOperationResult",
     "run_bulk",
     "run_bulk_async",
-    # redaction: маски секретов + truncation для HTTP-заголовков/body (audit/логи)
+    "ChunkedUploader",
+    "UploadResult",
+    # orchestration / protocols / entities: онбординг/health + нейтральные data-классы
+    "LoginMode",
+    "LoginRequirements",
+    "InteractiveFlow",
+    "OnboardingProtocol",
+    "HealthState",
+    "HealthStatus",
+    "HealthProtocol",
+    "Session",
+    "SessionChanges",
+    "SessionContext",
+    "HealthReport",
+    # rpc / stream / graphql: codec-слой + persistent-транспорты + GraphQL-клиент
+    "StreamTransport",
+    "JsonCodec",
+    "PrefixedJsonCodec",
+    "RpcClient",
+    "StubStreamTransport",
+    "WebSocketsStreamTransport",
+    "StreamClosedError",
+    "GraphQLClient",
+    # blocks / forms / windows / redaction / config: примитивы тел, окна, маски, утили путей
+    "blocks",
+    "text_block",
+    "block_end",
+    "header_block",
+    "list_item_block",
+    "paragraphs",
+    "decode_text_block",
+    "FormCodec",
+    "Window",
+    "RollingWindow",
+    "CalendarWindow",
+    "FixedWindow",
+    "parse_window",
     "SECRET_MASK",
     "HEADER_BLACKLIST",
     "BODY_FIELD_PATTERNS",
@@ -461,4 +432,12 @@ __all__ = [
     "sanitize_body",
     "truncate_body",
     "excerpt_response_body",
+    "deep_merge",
+    "interpolate_env",
+    "load_dotenv",
+    "slugify",
+    "normalize_account_id",
+    "atomic_write_text",
+    "chmod_600",
+    "AppPaths",
 ]

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/antibot/__init__.py

@@ -97,7 +97,8 @@ from .warmup_minter import TokenHarvest, WarmupTokenMinter
 #   ImpersonatedHttpExecutor  — TLS/JA3-impersonate (curl-cffi) [было CurlCffiTransport];
 #   BrowserRequestExecutor    — запрос «руками браузера» по CDP/CamouFox [было CdpTransport];
 #   BorrowedPageRequestExecutor — запрос в ЗАИМСТВОВАННОЙ странице [было PageEvaluateTransport];
-#   BrowserRequester          — роль «умеет выполнить запрос в браузере» [было CdpBrowserBackend].
+#   BrowserRequester          — роль «умеет выполнить запрос в браузере» ПОВЕРХ живой
+#                               contract.BrowserSession (fetch, не ЖЦ) [было CdpBrowserBackend].
 # Старые имена остаются deprecated-псевдонимами (ничего не удалено).
 ImpersonatedHttpExecutor = CurlCffiTransport
 BrowserRequestExecutor = CdpTransport

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/antibot/cdp.py

@@ -23,12 +23,28 @@ from ._helpers import _as_transport_error, _to_httpx_response
 
 @runtime_checkable
 class CdpBrowserBackend(Protocol):
-    """Контракт «движка реального браузера» под `CdpTransport` (точка DI).
+    """Контракт «умеет ВЫПОЛНИТЬ запрос в браузере» (роль `BrowserRequester`), под
+    `CdpTransport` (точка DI).
 
     Скрывает за собой запуск системного Edge/Chrome с `--remote-debugging-port`
     и `connect_over_cdp` (см. recipes/antibot `cdp_real_browser.py`). Реализация —
     в `librarykit.browser` (Playwright/patchright); здесь — только контракт, чтобы
     `antibot` не тащил тяжёлый browser-стек и тестировался фейком той же формы.
+
+    Разделение с `librarykit.contract.BrowserSession` (= `BrowserBackend`) — это
+    ДВЕ РАЗНЫЕ роли, а не одна:
+
+    - `BrowserSession` — ЖИЗНЕННЫЙ ЦИКЛ живой сессии: поднять/держать/закрыть
+      браузер и отдать страницу с контекстом (`ensure_page`/`context`/`aclose`);
+    - `CdpBrowserBackend` (`BrowserRequester`) — СПОСОБНОСТЬ выполнить HTTP-запрос
+      руками уже живой сессии (`fetch`), поверх её страницы/контекста.
+
+    Как Protocol'ы они пересекаются лишь по `aclose()`; ни один не является
+    структурным подтипом другого (у Requester нет `ensure_page`/`context`, у
+    Session нет `fetch`). Конкретные бэкенды `librarykit.browser`
+    (`CdpChromeBackend`/`CamoufoxBackend`) реализуют ОБА контракта одним объектом:
+    он И держит живую сессию, И умеет `fetch` поверх неё — то есть
+    `BrowserRequester` НАДСТРАИВАЕТ исполнение запроса над сессией, не заменяя её.
     """
 
     async def fetch(
@@ -174,11 +190,17 @@ class CdpTransport(Transport):
 
 @runtime_checkable
 class SyncCdpBrowserBackend(Protocol):
-    """Sync-сиблинг `CdpBrowserBackend`: движок реального/stealth-браузера БЕЗ await.
+    """Sync-сиблинг `CdpBrowserBackend`: роль `SyncBrowserRequester` БЕЗ await.
 
-    Та же роль (выполнить запрос внутри живого браузера, вернуть ответоподобный
+    Та же роль «умеет ВЫПОЛНИТЬ запрос в браузере» (`fetch` → ответоподобный
     объект под `_to_httpx_response`), но синхронная сигнатура — для навыков без
     event-loop. Реализация — `librarykit.browser.SyncCamoufoxBackend`.
+
+    То же разделение, что у async-версии: это СПОСОБНОСТЬ исполнить запрос поверх
+    живой сессии, а не её жизненный цикл — ЖЦ (поднять/держать/закрыть, страница+
+    контекст) несёт `librarykit.contract.SyncBrowserSession` (= `SyncBrowserBackend`,
+    `ensure_page`/`context`). Пересечение Protocol'ов — только семантика закрытия;
+    конкретный sync-бэкенд реализует обе роли одним объектом.
     """
 
     def fetch(

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/entities.py

@@ -93,7 +93,7 @@ class SessionContext:
 
 
 @dataclass
-class HealthStatus:
+class RawHealthStatus:
     """RAW-результат health-check адаптера ДО классификации (нейтрально).
 
     Это «сырая» форма, которую отдаёт ``NetworkAdapter.health_check()`` и которую
@@ -104,6 +104,8 @@ class HealthStatus:
     Развязка vs `librarykit.protocols.HealthStatus`: тот — УЖЕ классифицированный
     DTO (несёт `state: HealthState`, для `HealthProtocol`); ЭТОТ — сырой вход
     классификатора (несёт `healthy: bool` + `rate_limit_remaining`, без `state`).
+    Раньше оба назывались `HealthStatus` — конфликт снят переименованием этой,
+    RAW-формы, в `RawHealthStatus` (старое имя — deprecated-алиас ниже).
 
     `classify_health_state` читает поля по duck-typing (`.auth_valid`/
     `.api_reachable`/`.notes`/`.rate_limit_remaining`/`.healthy`), поэтому
@@ -146,6 +148,29 @@ __all__ = [
     "Session",
     "SessionChanges",
     "SessionContext",
-    "HealthStatus",
+    "RawHealthStatus",
     "HealthReport",
 ]
+
+
+def __getattr__(name: str) -> Any:
+    """PEP 562: deprecated-алиас `HealthStatus` → `RawHealthStatus`.
+
+    RAW-снимок здоровья переименован в `RawHealthStatus`, чтобы снять конфликт
+    имён с классифицированным DTO `librarykit.protocols.HealthStatus`. Старое имя
+    остаётся импортируемым (`from librarykit.entities import HealthStatus`) ради
+    обратной совместимости, но предупреждает о переезде.
+    """
+    if name == "HealthStatus":
+        import warnings
+
+        warnings.warn(
+            "librarykit.entities.HealthStatus переименован в RawHealthStatus. "
+            "Имя HealthStatus теперь закреплено за классифицированным DTO "
+            "librarykit.protocols.HealthStatus; RAW-снимок стал RawHealthStatus. "
+            "Обнови импорт на RawHealthStatus — старый алиас будет удалён позже.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return RawHealthStatus
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/orchestration/__init__.py

@@ -5,7 +5,7 @@
 в bublictr. Они переиспользуемы любым потребителем (bublictr / reverse-factory):
 
 - стоят на `librarykit.entities` (нейтральные `Session`/`SessionContext`/
-  `HealthReport`/RAW-`HealthStatus`, `network: str`) и `librarykit.enums.HealthState`;
+  `HealthReport`/`RawHealthStatus`, `network: str`) и `librarykit.enums.HealthState`;
 - репо/сторы/probe инжектируются как `librarykit.ports`-Protocol;
 - доменные привязки (реестр адаптеров, enum-значения `Operation`/`TargetKind`,
   координаты `SessionRef`, audit-store, браузерный профиль) ИНЪЕКТИРУЮТСЯ доменом

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/librarykit/orchestration/health.py

@@ -3,13 +3,13 @@
 Поднято из доменной архитектуры в КОРЕНЬ китов (переиспользуемый health-слой).
 Развязка:
 
-- стоит на `librarykit.entities` (`HealthReport`/RAW-`HealthStatus`, `network: str`)
+- стоит на `librarykit.entities` (`HealthReport`/`RawHealthStatus`, `network: str`)
   и `librarykit.enums.HealthState` (канон);
 - репо/probe инжектируются как `librarykit.ports`-Protocol — без доменных
   SQLite/Keyring/registry импортов и без `NetworkId`;
 - `classify_health_state` принимает ЛЮБОЙ объект с полями
   `.auth_valid/.api_reachable/.notes/.rate_limit_remaining/.healthy` (duck-typing) —
-  и нейтральный RAW-`HealthStatus`, и доменный pydantic-`HealthStatus`.
+  и нейтральный `RawHealthStatus`, и доменный pydantic-`HealthStatus`.
 
 ЗАКОН СЛОЁВ: только stdlib + `librarykit.*`; никаких adapterkit/clikit/bublictr.
 """
@@ -19,7 +19,7 @@ from dataclasses import dataclass, field
 from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Any
 
-from librarykit.entities import HealthReport, HealthStatus
+from librarykit.entities import HealthReport, RawHealthStatus
 from librarykit.enums import HealthState
 
 if TYPE_CHECKING:
@@ -37,7 +37,7 @@ __all__ = [
 
 
 # =========================================================================== #
-# 1. Классификатор RAW-HealthStatus → HealthState (SP-4 §8)                     #
+# 1. Классификатор RawHealthStatus → HealthState (SP-4 §8)                      #
 # =========================================================================== #
 
 # Порог warning: если rate_limit_remaining < этого значения (и не None) →
@@ -58,7 +58,7 @@ def classify_health_state(status: Any) -> HealthState:
     7. иначе (есть rate-limit info → DEGRADED, нет → UNKNOWN)
 
     `status` — ЛЮБОЙ объект с полями `.auth_valid/.api_reachable/.notes/
-    .rate_limit_remaining/.healthy` (нейтральный RAW-`HealthStatus` ИЛИ доменный
+    .rate_limit_remaining/.healthy` (нейтральный `RawHealthStatus` ИЛИ доменный
     pydantic-`HealthStatus`): классификатор домен-нейтрален.
     """
     # 1. Нет аутентификации
@@ -145,7 +145,7 @@ class HealthMonitor:
             return await probe.probe(binding=binding)
 
         # Fallback: без реального адаптера — synthetic UNAUTHENTICATED report.
-        fallback_status = HealthStatus(
+        fallback_status = RawHealthStatus(
             network=network_str,
             healthy=False,
             auth_valid=False,
@@ -258,7 +258,7 @@ class GenericAdapterHealthProbe:
 
         # Healthy.
         notes = [f"ping ok; {ping}"]
-        status = HealthStatus(
+        status = RawHealthStatus(
             network=str(binding.network),
             healthy=True,
             auth_valid=True,
@@ -287,7 +287,7 @@ def _err_report(
     kind: str = "error",
 ) -> HealthReport:
     auth_valid = kind != "unauthenticated"
-    status = HealthStatus(
+    status = RawHealthStatus(
         network=str(binding.network),
         healthy=False,
         auth_valid=auth_valid,

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "s-librarykit"
-version = "0.3.0"
+version = "0.3.1"
 description = "Жирный КОРЕНЬ китов: единая error-иерархия, config/retry/paths-утили, checkpoint/resume, транспорт/auth/sessions — общий код для clikit, adapterkit и доменных пакетов."
 readme = "README.md"
 license = { text = "MIT" }

{s_librarykit-0.3.0 → s_librarykit-0.3.1}/tests/test_orchestration.py

@@ -16,7 +16,7 @@ from typing import Any
 
 import pytest
 
-from librarykit.entities import HealthReport, HealthStatus, Session, SessionChanges
+from librarykit.entities import HealthReport, RawHealthStatus, Session, SessionChanges
 from librarykit.enums import HealthState
 from librarykit.orchestration import (
     GenericAdapterHealthProbe,
@@ -29,16 +29,16 @@ from librarykit.orchestration import (
 )
 
 # =========================================================================== #
-# classify_health_state — нейтральный RAW-HealthStatus                          #
+# classify_health_state — нейтральный RawHealthStatus                           #
 # =========================================================================== #
 
 
-def _status(**kwargs: Any) -> HealthStatus:
+def _status(**kwargs: Any) -> RawHealthStatus:
     defaults: dict[str, Any] = dict(
         network="telegram", healthy=True, auth_valid=True, api_reachable=True
     )
     defaults.update(kwargs)
-    return HealthStatus(**defaults)
+    return RawHealthStatus(**defaults)
 
 
 class TestClassifyHealthState:
@@ -100,6 +100,23 @@ class TestClassifyHealthState:
         assert classify_health_state(DuckStatus()) == HealthState.HEALTHY
 
 
+class TestRawHealthStatusDeprecatedAlias:
+    """entities.HealthStatus — deprecated-алиас RawHealthStatus (back-compat)."""
+
+    def test_old_name_resolves_to_new_with_warning(self):
+        import librarykit.entities as ent
+
+        with pytest.warns(DeprecationWarning, match="RawHealthStatus"):
+            legacy = ent.HealthStatus
+        assert legacy is RawHealthStatus
+
+    def test_unknown_attr_still_raises(self):
+        import librarykit.entities as ent
+
+        with pytest.raises(AttributeError):
+            _ = ent.DoesNotExist
+
+
 # =========================================================================== #
 # HealthMonitor — фейковые репо по librarykit.ports                             #
 # =========================================================================== #