Fix NumPy boolean radius admission across supported versions

Author: TNFR AI Agent

CHANGELOG.md

@@ -29,6 +29,8 @@ All notable changes to this project will be documented in this file.
 - Centralize represented-real admission for pressure, phase, capacity, nodal
   arithmetic, coherence observations and validation consumers. Retain explicit
   unavailable evidence and reject invalid inputs before coercion or caching.
+- Reject NumPy booleans as neighborhood radii across supported NumPy versions,
+  while preserving integer-index inputs for structural and phase observations.
 - Consolidate JSON input/output and detached report serialization, including
   duplicate/colliding keys, unsupported labels and non-finite values. Reports
   and construction recipes remain distinct from resumable checkpoints.

src/tnfr/metrics/local_coherence.py

@@ -13,12 +13,13 @@
 from operator import index as integer_index
 from typing import Any
 
+from ..mathematics.unified_numerical import np
 from .common import _coherence_on_nodes
 
 
 def _radius_nodes(G: Any, node: Any, radius: int) -> tuple[Any, ...]:
     """Return the validated center-inclusive outgoing graph ball once per node."""
-    if isinstance(radius, bool) or type(radius).__name__ == "bool_":
+    if isinstance(radius, bool) or (np is not None and isinstance(radius, np.bool_)):
         raise TypeError("radius must be a nonnegative integer")
     try:
         resolved_radius = integer_index(radius)

tests/test_phase_coherence_admission.py

@@ -38,7 +38,9 @@ def test_phase_observations_reject_invalid_authoritative_alias(invalid, nodes):
             observe(graph)
 
 
-@pytest.mark.parametrize("radius", [True, np.bool_(True), -1, 0.5, "1", None])
+@pytest.mark.parametrize(
+    "radius", [True, False, np.bool_(True), np.bool_(False), -1, 0.5, "1", None]
+)
 def test_structural_and_phase_observations_share_radius_admission(radius):
     graph = nx.path_graph(2)
     for observe in (
@@ -50,6 +52,17 @@ def test_structural_and_phase_observations_share_radius_admission(radius):
             observe(graph, 0, radius)
 
 
+def test_radius_admission_preserves_integer_index_protocol():
+    class Radius:
+        def __index__(self):
+            return 1
+
+    graph = nx.path_graph(3)
+    graph.nodes[2][ALIAS_THETA[0]] = "outside radius one"
+    for radius in (1, np.int64(1), Radius()):
+        assert phase_coherence.compute_phase_alignment(graph, 0, radius) == 1.0
+
+
 @pytest.mark.parametrize("radius", [0, 1, 2])
 def test_missing_center_never_becomes_a_perfect_phase_observation(radius):
     with pytest.raises(KeyError):