Add parse response usage boundary architecture guard

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

Author: cursoragent

CONTRIBUTING.md

@@ -149,6 +149,7 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_pyproject_architecture_marker.py` (pytest marker registration enforcement),
   - `tests/test_readme_examples_listing.py` (README example-listing consistency enforcement),
   - `tests/test_request_helper_parse_import_boundary.py` (request-helper import boundary enforcement for direct response parsing imports),
+  - `tests/test_response_parse_usage_boundary.py` (centralized `parse_response_model(...)` usage boundary enforcement),
   - `tests/test_schema_injection_helper_usage.py` (shared schema injection helper usage enforcement in payload builders),
   - `tests/test_session_operation_metadata_usage.py` (session manager operation-metadata usage enforcement),
   - `tests/test_session_profile_update_helper_usage.py` (session profile-update parameter helper usage enforcement),

tests/test_architecture_marker_usage.py

@@ -51,6 +51,7 @@
     "tests/test_contributing_architecture_guard_listing.py",
     "tests/test_readme_examples_listing.py",
     "tests/test_request_helper_parse_import_boundary.py",
+    "tests/test_response_parse_usage_boundary.py",
     "tests/test_examples_syntax.py",
     "tests/test_docs_python3_commands.py",
     "tests/test_extension_create_helper_usage.py",

tests/test_response_parse_usage_boundary.py

@@ -0,0 +1,27 @@
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+ALLOWED_PARSE_RESPONSE_MODEL_MODULES = {
+    "hyperbrowser/client/managers/model_request_utils.py",
+    "hyperbrowser/client/managers/response_utils.py",
+    "hyperbrowser/client/managers/session_utils.py",
+}
+
+
+def test_parse_response_model_usage_is_centralized():
+    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 "parse_response_model(" not in module_text:
+            continue
+        normalized_path = module_path.as_posix()
+        if normalized_path not in ALLOWED_PARSE_RESPONSE_MODEL_MODULES:
+            violating_modules.append(normalized_path)
+
+    assert violating_modules == []