Add architecture guard for example script syntax

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

Author: cursoragent

CONTRIBUTING.md

@@ -92,7 +92,8 @@ This runs lint, format checks, compile checks, tests, and package build.
   - `tests/test_type_utils_usage.py` (type `__mro__` boundary centralization in `hyperbrowser/type_utils.py`),
   - `tests/test_polling_loop_usage.py` (`while True` polling-loop centralization in `hyperbrowser/client/polling.py`),
   - `tests/test_core_type_helper_usage.py` (core transport/config/header/file/polling/session/error/parsing manager+tool module enforcement of shared plain-type helper usage),
-  - `tests/test_contributing_architecture_guard_listing.py` (`CONTRIBUTING.md` architecture-guard inventory completeness enforcement).
+  - `tests/test_contributing_architecture_guard_listing.py` (`CONTRIBUTING.md` architecture-guard inventory completeness enforcement),
+  - `tests/test_examples_syntax.py` (example script syntax guardrail).
 
 ## Code quality conventions
 

tests/test_architecture_marker_usage.py

@@ -22,6 +22,7 @@
     "tests/test_polling_loop_usage.py",
     "tests/test_core_type_helper_usage.py",
     "tests/test_contributing_architecture_guard_listing.py",
+    "tests/test_examples_syntax.py",
 )
 
 

tests/test_examples_syntax.py

@@ -0,0 +1,15 @@
+import ast
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+def test_example_scripts_have_valid_python_syntax():
+    example_files = sorted(Path("examples").glob("*.py"))
+    assert example_files != []
+
+    for example_path in example_files:
+        source = example_path.read_text(encoding="utf-8")
+        ast.parse(source, filename=example_path.as_posix())