3.4.0

HLV‑RAPS — Version 3.4.0 Release Notes

Release Date: May 7, 2026
Maintainer: Don Feeney
Scope: Wave‑Native Network (WNN) Telemetry Integration + DSM Hard‑Invariant Safing + Rollback Path Hardening

---

Overview

Version 3.4.0 introduces the first full integration of the Wave‑Native Network telemetry substrate into the Recursive Autonomous Projection System (RAPS). WNN now feeds curvature proxies, oscillatory prefactors, and coherence‑aware metrics directly into the Deterministic Safety Monitor (DSM).

RAPS 3.4.0 enforces a hard‑invariant safety contract:

If any WNN metric breaches its threshold or arrives malformed, DSM triggers an immediate rollback to the last known safe state using the new statically allocated StateSnapshotBuffer (backed by TelemetryRingBuffer).

No graceful degradation. No negotiation.
Rollback is deterministic, allocation‑free, and fully logged to the Immutable Telemetry Ledger (ITL).

This release also hardens the WNN→DSM safing path, ensuring malformed telemetry, non‑finite values, and rollback‑store edge cases all fail closed and remain fully auditable.

---

Key Changes

---

1. WNN Telemetry Validation & Safing Behavior

• Added explicit non‑finite (NaN/Inf) detection for all WnnTelemetry fields before threshold evaluation.
• Unified WNN breach handling so invalid telemetry and threshold violations both drive deterministic rollback safing.
• Added DSM diagnostics for WNN‑triggered safing events, including curvature‑breach and oscillatory‑prefactor guardrail violations.
• Hardened DSM to fail closed on:
  • negative curvature estimates,
  • non‑finite oscillatory prefactors,
  • malformed telemetry shapes.

---

2. ITL Logging Hardening for Invalid Telemetry

• Sanitized non‑finite WNN telemetry values before ITL commit using the named sentinel:
  DSM_Config::INVALID_TELEMETRY_SENTINEL
  to avoid ambiguous raw invalid values in the ledger.
• Preserved WNN alert + rollback commit emission for audit continuity.
• Implemented full ITL lifecycle for WNN DSM events:
  • payload sizing,
  • entry hashing,
  • flash‑backed commit,
  • Merkle batching,
  • flush behavior,
  • success‑returning rollback event logging.

---

3. Rollback‑Path Safety Guards

• Hardened trigger_wnn_immediate_rollback(...) to safely return when:
  • rollback_store == nullptr,
  • rollback_count == 0,
  • rollback plan is invalid or out‑of‑range.
• Eliminated unsafe dereference assumptions in WNN‑triggered rollback flow.
• Added validation for non‑finite thrust/gimbal values before rollback execution.

Updated rollback guard:

inline bool trigger_wnn_immediate_rollback(
    const RollbackPlan* rollback_store,
    uint32_t rollback_count,
    PhysicsState& active_state_pointer
) {
    if (rollback_count == 0 || rollback_store == nullptr) {
        return false;
    }
    // existing rollback execution path...
}

---

4. Statically Allocated Rollback Storage

• Introduced StateSnapshotBuffer backed by TelemetryRingBuffer for allocation‑free rollback storage.
• Ensures deterministic timing and eliminates dynamic memory from the safing path.
• Guarantees that rollback always targets a validated, last‑known‑safe state.

---

5. SIL Coverage Expansion

Added extensive SIL coverage for WNN‑integrated DSM behavior:

• Nominal WNN telemetry → DSM pass‑through.
• Threshold‑triggered rollback.
• Invalid telemetry fail‑closed behavior.
• Reversed‑dilation full‑shutdown behavior.
• Null rollback store with non‑zero count.
• Empty rollback store behavior.
• Out‑of‑range rollback count hardening.
• Non‑finite thrust/gimbal rollback validation.
• Registered new DSM WNN SIL test target in CMake.

---

Impact

RAPS 3.4.0 establishes the first physics‑informed, wave‑native safing substrate in the HLV ecosystem.
The DSM now enforces WNN coherence metrics as hard invariants, ensuring that any deviation—numeric, physical, or malformed—results in a deterministic, auditable rollback to a safe state.

This release significantly increases safety, observability, and determinism across the entire flight stack.