ci(docs): ignore generated test-results links in active docs check

Author: rwilliamspbg-ops

scripts/check_active_doc_links.py

@@ -26,6 +26,20 @@
 LINK_RE = re.compile(r"\[[^\]]+\]\(([^)]+)\)")
 
 
+def is_generated_test_results_link(target: str) -> bool:
+    """Return True when link ultimately points into test-results/.
+
+    Accepts forms such as:
+    - /test-results/...
+    - test-results/...
+    - ../test-results/...
+    - ../../test-results/...
+    """
+
+    parts = [part for part in target.split("/") if part not in {"", ".", ".."}]
+    return bool(parts) and parts[0] == "test-results"
+
+
 def iter_markdown_files() -> list[Path]:
     files: list[Path] = []
     for root in TARGET_ROOTS:
@@ -71,6 +85,11 @@ def main() -> int:
                 if not clean_target:
                     continue
 
+                if is_generated_test_results_link(clean_target):
+                    # test-results links are runtime-generated artifacts and
+                    # are not guaranteed to be committed in git.
+                    continue
+
                 if clean_target.startswith("/"):
                     candidate = (REPO_ROOT / clean_target.lstrip("/")).resolve()
                 else: