Accept finite Cosmoaudition wire numbers

Author: emeisazam

CHANGELOG.md

@@ -18,6 +18,9 @@
 - Preserved Cosmoaudition frame-level signals and sources beside resolved
   routes, and withheld malformed or out-of-range executable controls with an
   explicit bridge reason.
+- Accepted finite JavaScript wire numbers whose integer spelling exceeds a
+  signed 64-bit persistence value, so high-magnitude observations such as the
+  Bitcoin hashrate cannot invalidate an otherwise valid modulation frame.
 - Aligned active project language to **Sonic Matter Framework**: MASA
   describes, Cosmoaudition observes and modulates, and GERM cultivates. The
   projects remain distinct.

server/cosmoaudition.py

@@ -50,9 +50,33 @@ def _reject_nonfinite_json(value: str) -> None:
     raise ValueError(f"non-finite JSON constant: {value}")
 
 
+def _decode_json_integer(value: str) -> int | float:
+    """Keep ordinary integers exact and accept finite JavaScript wire numbers.
+
+    Cosmoaudition serializes IEEE-754 numbers with ``JSON.stringify``. A value
+    such as the Bitcoin hashrate can therefore arrive with an integer spelling
+    outside GERM's signed-64-bit persistence boundary even though the producer
+    already represents it as a finite float. Preserve normal JSON integers as
+    integers, but materialize those wider wire values as finite floats so one
+    observation cannot invalidate the complete modulation frame.
+    """
+
+    decoded = int(value)
+    if -(2**63) <= decoded < 2**63:
+        return decoded
+    widened = float(value)
+    if not math.isfinite(widened):
+        raise ValueError("JSON integer exceeds the finite-number boundary")
+    return widened
+
+
 def _decode_json_object(raw: bytes) -> dict[str, Any]:
     try:
-        value = json.loads(raw, parse_constant=_reject_nonfinite_json)
+        value = json.loads(
+            raw,
+            parse_constant=_reject_nonfinite_json,
+            parse_int=_decode_json_integer,
+        )
     except (UnicodeError, json.JSONDecodeError, ValueError, RecursionError) as exc:
         raise CosmoauditionBridgeError("Cosmoaudition returned invalid JSON") from exc
     if not isinstance(value, dict):

tests/test_server.py

@@ -973,6 +973,20 @@ def test_cosmoaudition_bridge_rejects_excessively_nested_json() -> None:
         _decode_json_object(payload)
 
 
+def test_cosmoaudition_bridge_accepts_finite_javascript_number_beyond_int64() -> None:
+    payload = _decode_json_object(b'{"hashrate":976061469948095400000}')
+
+    assert payload["hashrate"] == float("976061469948095400000")
+    assert isinstance(payload["hashrate"], float)
+
+
+def test_cosmoaudition_bridge_rejects_integer_beyond_finite_float_range() -> None:
+    payload = b'{"value":' + b"1" + (b"0" * 400) + b"}"
+
+    with pytest.raises(CosmoauditionBridgeError, match="invalid JSON"):
+        _decode_json_object(payload)
+
+
 def test_cosmoaudition_status_requires_boolean_remote_health(
     monkeypatch: pytest.MonkeyPatch,
 ) -> None: