Add architecture guard for agent example coverage

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

Author: cursoragent

CONTRIBUTING.md

@@ -76,6 +76,7 @@ This runs lint, format checks, compile checks, tests, and package build.
 - Keep sync/async behavior in parity where applicable.
 - Prefer deterministic unit tests over network-dependent tests.
 - Preserve architectural guardrails with focused tests. Current guard suites include:
+  - `tests/test_agent_examples_coverage.py` (agent task example coverage enforcement),
   - `tests/test_agent_payload_helper_usage.py` (shared agent start-payload helper usage enforcement),
   - `tests/test_agent_terminal_status_helper_usage.py` (shared agent terminal-status helper usage enforcement),
   - `tests/test_architecture_marker_usage.py` (architecture marker coverage across guard modules),

tests/test_agent_examples_coverage.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+EXPECTED_AGENT_EXAMPLES = (
+    "async_browser_use_task.py",
+    "async_claude_computer_use_task.py",
+    "async_cua_task.py",
+    "async_gemini_computer_use_task.py",
+    "async_hyper_agent_task.py",
+    "sync_browser_use_task.py",
+    "sync_claude_computer_use_task.py",
+    "sync_cua_task.py",
+    "sync_gemini_computer_use_task.py",
+    "sync_hyper_agent_task.py",
+)
+
+
+def test_agent_examples_cover_all_agent_task_managers():
+    example_names = {path.name for path in Path("examples").glob("*.py")}
+    assert set(EXPECTED_AGENT_EXAMPLES).issubset(example_names)

tests/test_architecture_marker_usage.py

@@ -6,6 +6,7 @@
 
 
 ARCHITECTURE_GUARD_MODULES = (
+    "tests/test_agent_examples_coverage.py",
     "tests/test_agent_payload_helper_usage.py",
     "tests/test_agent_terminal_status_helper_usage.py",
     "tests/test_guardrail_ast_utils.py",