Add symbol-level AST import helper boundary guard

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

Author: cursoragent

CONTRIBUTING.md

@@ -98,6 +98,7 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_ast_import_utils.py` (shared AST import-helper contract validation),
   - `tests/test_ast_import_utils_module_import_boundary.py` (shared AST import-helper module import boundary enforcement across test modules),
   - `tests/test_ast_module_import_helper_import_boundary.py` (shared AST module-import helper import boundary enforcement across test modules),
+  - `tests/test_ast_symbol_import_helper_import_boundary.py` (shared AST symbol-import helper import boundary enforcement across test modules),
   - `tests/test_binary_file_open_helper_usage.py` (shared binary file open helper usage enforcement),
   - `tests/test_browser_use_payload_helper_usage.py` (browser-use payload helper usage enforcement),
   - `tests/test_ci_workflow_quality_gates.py` (CI guard-stage + make-target enforcement),

tests/test_architecture_marker_usage.py

@@ -27,6 +27,7 @@
     "tests/test_ast_import_utils.py",
     "tests/test_ast_import_utils_module_import_boundary.py",
     "tests/test_ast_module_import_helper_import_boundary.py",
+    "tests/test_ast_symbol_import_helper_import_boundary.py",
     "tests/test_guardrail_ast_utils.py",
     "tests/test_helper_transport_usage_boundary.py",
     "tests/test_manager_model_dump_usage.py",

tests/test_ast_import_utils_module_import_boundary.py

@@ -19,6 +19,7 @@
     "tests/test_ast_import_helper_import_boundary.py",
     "tests/test_ast_import_helper_secondary_import_boundary.py",
     "tests/test_ast_module_import_helper_import_boundary.py",
+    "tests/test_ast_symbol_import_helper_import_boundary.py",
     "tests/test_ast_import_utils.py",
     "tests/test_ast_import_utils_module_import_boundary.py",
 )

tests/test_ast_symbol_import_helper_import_boundary.py

@@ -0,0 +1,32 @@
+from pathlib import Path
+
+import pytest
+
+from tests.ast_import_utils import imports_symbol_from_module
+
+pytestmark = pytest.mark.architecture
+
+
+EXPECTED_IMPORTS_SYMBOL_FROM_MODULE_IMPORTERS = (
+    "tests/test_ast_call_symbol_helper_import_boundary.py",
+    "tests/test_ast_import_helper_secondary_import_boundary.py",
+    "tests/test_ast_import_helper_usage.py",
+    "tests/test_ast_import_utils.py",
+    "tests/test_ast_module_import_helper_import_boundary.py",
+    "tests/test_ast_symbol_import_helper_import_boundary.py",
+)
+
+
+def test_imports_symbol_from_module_imports_are_centralized():
+    discovered_modules: list[str] = []
+    for module_path in sorted(Path("tests").glob("test_*.py")):
+        module_text = module_path.read_text(encoding="utf-8")
+        if not imports_symbol_from_module(
+            module_text,
+            module="tests.ast_import_utils",
+            symbol="imports_symbol_from_module",
+        ):
+            continue
+        discovered_modules.append(module_path.as_posix())
+
+    assert discovered_modules == list(EXPECTED_IMPORTS_SYMBOL_FROM_MODULE_IMPORTERS)