Release-gate negative test for ambiguous GeoTIFF metadata (#2361) (#2366)

Author: brendancol

docs/source/reference/release_gate_geotiff.rst

@@ -540,6 +540,15 @@ These gates are not tier rows but they back the rest of the checklist.
 * ``test_release_gate_2321.py`` -- meta-gate that asserts every promised
   VRT behaviour in this checklist resolves to a real test file and a real
   ``SUPPORTED_FEATURES`` entry.
+* ``xrspatial/geotiff/tests/test_release_gate_negative_2341.py`` --
+  negative cross-cutting gate from epic #2341 PR 5. Pins that
+  ambiguous metadata fails closed at every promised read entry point:
+  conflicting CRS between header and ``.aux.xml`` PAM sidecar
+  (xfail until PAM sidecar support lands), integer nodata sentinel
+  that cannot be honoured on a float-promoted raster (xfail against
+  ``#1774`` follow-up), rotated transform without ``allow_rotated=True``
+  uniformly across eager / dask / windowed paths, and mixed-tier VRT
+  children when stable-only is requested (xfail against epic ``#2342``).
 
 Placeholder PR cross-references
 ===============================

xrspatial/geotiff/_geotags.py

@@ -683,7 +683,11 @@ def _extract_transform(ifd: IFD,
                         f"M[6]={m[6] if len(m) > 6 else 0.0!r}). "
                         "Only axis-aligned affine transforms are supported. "
                         "Pass ``allow_rotated=True`` to read the pixel grid "
-                        "without the geospatial assumption (issue #2115)."
+                        "without the geospatial assumption "
+                        "(``reader.allow_rotated`` is the experimental tier "
+                        "opt-in; see "
+                        "``docs/source/reference/release_gate_geotiff.rst`` "
+                        "for the release-contract row; issue #2115)."
                     )
                 # Opt-in: drop georef, stash the rotated matrix on the
                 # GeoTransform so the validator + attrs-roundtrip code

xrspatial/geotiff/_validation.py

@@ -1117,8 +1117,9 @@ def _check_read_rotated_transform(context: Mapping[str, Any]) -> None:
         f"zonal) assume axis-aligned rasters and would silently produce "
         f"wrong results on a rotated grid. Pass ``allow_rotated=True`` "
         f"to read the pixel grid without the geospatial assumption "
-        f"(useful when you only want the array, not the geo-aware "
-        f"downstream ops). See issue #1987."
+        f"(``reader.allow_rotated`` is the experimental tier opt-in; "
+        f"see ``docs/source/reference/release_gate_geotiff.rst`` for "
+        f"the release-contract row; issue #1987)."
     )