Enforce sorted architecture guard inventory in CONTRIBUTING

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

Author: cursoragent

CONTRIBUTING.md

@@ -76,29 +76,29 @@ 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_architecture_marker_usage.py` (architecture marker coverage across guard modules),
+  - `tests/test_ci_workflow_quality_gates.py` (CI guard-stage + make-target enforcement),
+  - `tests/test_computer_action_endpoint_helper_usage.py` (computer-action endpoint-normalization helper usage enforcement),
+  - `tests/test_contributing_architecture_guard_listing.py` (`CONTRIBUTING.md` architecture-guard inventory completeness enforcement),
+  - `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_display_helper_usage.py` (display/key-format helper usage),
+  - `tests/test_docs_python3_commands.py` (`README`/`CONTRIBUTING`/examples python3 command consistency enforcement),
+  - `tests/test_example_run_instructions.py` (example run-instruction consistency enforcement),
+  - `tests/test_example_sync_async_parity.py` (sync/async example parity enforcement),
+  - `tests/test_examples_syntax.py` (example script syntax guardrail),
   - `tests/test_guardrail_ast_utils.py` (shared AST guard utility contract),
+  - `tests/test_makefile_quality_targets.py` (Makefile quality-gate target enforcement),
   - `tests/test_manager_model_dump_usage.py` (manager serialization centralization),
-  - `tests/test_mapping_reader_usage.py` (shared mapping-read parser usage),
   - `tests/test_mapping_keys_access_usage.py` (centralized key-iteration boundaries),
-  - `tests/test_tool_mapping_reader_usage.py` (tools mapping-helper usage),
-  - `tests/test_display_helper_usage.py` (display/key-format helper usage),
-  - `tests/test_ci_workflow_quality_gates.py` (CI guard-stage + make-target enforcement),
-  - `tests/test_makefile_quality_targets.py` (Makefile quality-gate target enforcement),
-  - `tests/test_pyproject_architecture_marker.py` (pytest marker registration enforcement),
-  - `tests/test_architecture_marker_usage.py` (architecture marker coverage across guard modules),
-  - `tests/test_readme_examples_listing.py` (README example-listing consistency enforcement),
+  - `tests/test_mapping_reader_usage.py` (shared mapping-read parser usage),
   - `tests/test_plain_type_guard_usage.py` (`str`/`int` guardrail enforcement via plain-type checks),
   - `tests/test_plain_type_identity_usage.py` (direct `type(... ) is str|int` guardrail enforcement via shared helpers),
-  - `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_examples_syntax.py` (example script syntax guardrail),
-  - `tests/test_docs_python3_commands.py` (`README`/`CONTRIBUTING`/examples python3 command consistency enforcement),
-  - `tests/test_example_sync_async_parity.py` (sync/async example parity enforcement),
-  - `tests/test_example_run_instructions.py` (example run-instruction consistency enforcement),
-  - `tests/test_computer_action_endpoint_helper_usage.py` (computer-action endpoint-normalization helper usage enforcement),
+  - `tests/test_pyproject_architecture_marker.py` (pytest marker registration enforcement),
+  - `tests/test_readme_examples_listing.py` (README example-listing consistency enforcement),
   - `tests/test_session_upload_helper_usage.py` (session upload-input normalization helper usage enforcement),
+  - `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_payload_helper_usage.py` (web manager payload-helper usage enforcement).
 
 ## Code quality conventions

tests/test_contributing_architecture_guard_listing.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+import re
 
 import pytest
 
@@ -7,13 +8,19 @@
 
 def test_contributing_lists_all_architecture_guard_modules():
     contributing_text = Path("CONTRIBUTING.md").read_text(encoding="utf-8")
+    listed_modules = re.findall(r"`(tests/test_[^`]+\.py)`", contributing_text)
+
     architecture_modules: list[str] = []
     for module_path in sorted(Path("tests").glob("test_*.py")):
         module_text = module_path.read_text(encoding="utf-8")
         if "pytestmark = pytest.mark.architecture" not in module_text:
             continue
         architecture_modules.append(module_path.as_posix())
 
+    assert listed_modules != []
+    assert listed_modules == sorted(listed_modules)
+    assert listed_modules == architecture_modules
+
     assert architecture_modules != []
     for module_path in architecture_modules:
         assert module_path in contributing_text