Add helper transport usage boundary architecture guard

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

CONTRIBUTING.md

@@ -112,6 +112,7 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_extension_route_constants_usage.py` (extension manager route-constant usage enforcement),
   - `tests/test_extract_payload_helper_usage.py` (extract start-payload helper usage enforcement),
   - `tests/test_guardrail_ast_utils.py` (shared AST guard utility contract),
+  - `tests/test_helper_transport_usage_boundary.py` (manager-helper transport usage boundary enforcement through shared model request helpers),
   - `tests/test_job_fetch_helper_boundary.py` (centralization boundary enforcement for retry/paginated-fetch helper primitives),
   - `tests/test_job_fetch_helper_usage.py` (shared retry/paginated-fetch defaults helper usage enforcement),
   - `tests/test_job_operation_metadata_usage.py` (shared scrape/crawl/extract operation-metadata usage enforcement),

tests/test_architecture_marker_usage.py

@@ -17,6 +17,7 @@
     "tests/test_agent_stop_helper_usage.py",
     "tests/test_agent_terminal_status_helper_usage.py",
     "tests/test_guardrail_ast_utils.py",
+    "tests/test_helper_transport_usage_boundary.py",
     "tests/test_manager_model_dump_usage.py",
     "tests/test_manager_helper_import_boundary.py",
     "tests/test_manager_parse_boundary.py",

tests/test_helper_transport_usage_boundary.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+ALLOWED_TRANSPORT_HELPER_MODULES = {
+    "hyperbrowser/client/managers/model_request_utils.py",
+}
+
+
+def test_helper_modules_centralize_transport_usage_in_model_request_utils():
+    violating_modules: list[str] = []
+    for module_path in sorted(
+        Path("hyperbrowser/client/managers").rglob("*.py")
+    ):
+        module_text = module_path.read_text(encoding="utf-8")
+        if "client.transport." not in module_text:
+            continue
+        normalized_path = module_path.as_posix()
+        if normalized_path not in ALLOWED_TRANSPORT_HELPER_MODULES:
+            violating_modules.append(normalized_path)
+
+    assert violating_modules == []