Enforce started-job primitive centralization boundary

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

Author: cursoragent

CONTRIBUTING.md

@@ -113,6 +113,7 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_session_profile_update_helper_usage.py` (session profile-update parameter helper usage enforcement),
   - `tests/test_session_upload_helper_usage.py` (session upload-input normalization helper usage enforcement),
   - `tests/test_start_job_context_helper_usage.py` (shared started-job context helper usage enforcement),
+  - `tests/test_started_job_helper_boundary.py` (centralization boundary enforcement for started-job helper primitives),
   - `tests/test_tool_mapping_reader_usage.py` (tools mapping-helper usage),
   - `tests/test_type_utils_usage.py` (type `__mro__` boundary centralization in `hyperbrowser/type_utils.py`),
   - `tests/test_web_pagination_internal_reuse.py` (web pagination helper internal reuse of shared job pagination helpers),

tests/test_architecture_marker_usage.py

@@ -45,6 +45,7 @@
     "tests/test_session_profile_update_helper_usage.py",
     "tests/test_session_upload_helper_usage.py",
     "tests/test_start_job_context_helper_usage.py",
+    "tests/test_started_job_helper_boundary.py",
     "tests/test_web_pagination_internal_reuse.py",
     "tests/test_web_payload_helper_usage.py",
 )

tests/test_started_job_helper_boundary.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+MANAGERS_DIR = Path("hyperbrowser/client/managers")
+
+
+def test_started_job_context_primitives_are_centralized():
+    violating_modules: list[str] = []
+    for module_path in sorted(MANAGERS_DIR.rglob("*.py")):
+        if module_path.name in {"__init__.py", "start_job_utils.py"}:
+            continue
+        module_text = module_path.read_text(encoding="utf-8")
+        if "ensure_started_job_id(" in module_text or "build_operation_name(" in module_text:
+            violating_modules.append(module_path.as_posix())
+
+    assert violating_modules == []