cap offline e3 receipt freshness

Co-Authored-By: Codex <noreply@openai.com>

Author: Pigbibi

runtime_preflight.py

@@ -14,6 +14,7 @@
 
 E3_RECEIPT_SCHEMA_VERSION = "qmt.e3.receipt.v1"
 E3_RECEIPT_REQUIRED_SUMMARY_COUNTS = ("accounts", "positions", "orders", "fills", "cash", "ledger")
+E3_RECEIPT_MAX_FRESHNESS_SECONDS = 300
 _E3_RECEIPT_FIELDS = frozenset(
     {
         "schema_version",
@@ -133,8 +134,12 @@ def _validate_e3_freshness(
     issues: list[PreflightIssue],
 ) -> None:
     freshness_seconds = receipt.get("freshness_seconds")
-    if not isinstance(freshness_seconds, int) or isinstance(freshness_seconds, bool) or freshness_seconds < 0:
-        issues.append(PreflightIssue("invalid_freshness", "Receipt freshness must be a non-negative integer."))
+    if (
+        not isinstance(freshness_seconds, int)
+        or isinstance(freshness_seconds, bool)
+        or not 0 <= freshness_seconds <= E3_RECEIPT_MAX_FRESHNESS_SECONDS
+    ):
+        issues.append(PreflightIssue("invalid_freshness", "Receipt freshness is outside the accepted window."))
         return
 
     as_of = receipt.get("as_of")

tests/test_runtime_preflight.py

@@ -7,7 +7,12 @@
 
 import pytest
 
-from runtime_preflight import E3_RECEIPT_SCHEMA_VERSION, run_preflight, validate_e3_receipt
+from runtime_preflight import (
+    E3_RECEIPT_MAX_FRESHNESS_SECONDS,
+    E3_RECEIPT_SCHEMA_VERSION,
+    run_preflight,
+    validate_e3_receipt,
+)
 from scripts.preflight_qmt_runtime import main
 
 
@@ -181,6 +186,7 @@ def test_e3_receipt_validator_accepts_complete_sanitized_receipt():
         ("summary_counts", {"accounts": 1}, "invalid_summary_counts"),
         ("as_of", "not-a-timestamp", "invalid_as_of"),
         ("freshness_seconds", -1, "invalid_freshness"),
+        ("freshness_seconds", E3_RECEIPT_MAX_FRESHNESS_SECONDS + 1, "invalid_freshness"),
         ("no_order", False, "no_order_required"),
         ("verify_only", False, "verify_only_required"),
     ],