docs: classify env-driven tests as audit-only, legacy renderer tests as diagnostic

tests/test_ocr_real_paper_contract.py

@@ -1,3 +1,14 @@
+"""Production-path contract audit for real OCR papers.
+
+Classification: secondary audit coverage.
+Primary regression gate is tests/test_ocr_real_paper_regressions.py
+(spec-contract + fixture-backed production-path replay).
+
+These tests validate broader real-paper drift but require
+PAPERFORGE_REAL_OCR_VAULT env; they are not the deterministic
+first-line gate.
+"""
+
 from __future__ import annotations
 
 import json

tests/test_ocr_real_paper_reader_audit.py

@@ -1,3 +1,10 @@
+"""Reader-figure audit for real OCR papers.
+
+Classification: secondary audit coverage.
+Primary regression gate is tests/test_ocr_real_paper_regressions.py.
+Requires PAPERFORGE_REAL_OCR_VAULT env.
+"""
+
 from __future__ import annotations
 
 import json

tests/test_ocr_rendering.py

@@ -1,3 +1,11 @@
+"""Legacy page-local renderer tests.
+
+Classification: diagnostic only.
+render_page_blocks() is not the final fulltext truth for OCR-v2.
+Primary production path is render_fulltext_markdown() in ocr_render.py.
+These tests exist for backward compatibility and legacy trace interpretation.
+"""
+
 from __future__ import annotations
 
 from pathlib import Path