Module waveform_context 

Waveform transition schedule for grammar-escalation suppression.

Near-term engineering extension per §18.3 (Waveform Transition Artifacts). Registers deliberate transition windows (frequency hops, burst boundaries, power ramps) so the grammar layer can suppress spurious Violation escalation during known waveform-change intervals. Fixed-capacity (WaveformSchedule<N>) — no_std, no_alloc. Waveform transition context for grammar-escalation suppression.

Motivation (paper §18.3)

“Deliberate waveform transitions — frequency hops, modulation changes, burst boundaries — produce residual signatures structurally indistinguishable from interference onset without a waveform-schedule context flag. The correct integration contract includes a regime-context channel that suppresses grammar escalation during flagged transition windows. This is a near-term engineering extension. The platform_context.rs module provides the hook; population of the transition schedule is deployment-specific.”

This module provides that extension: a fixed-capacity waveform schedule that marks transition windows and suppresses spurious grammar escalation during those intervals.

Design

• TransitionWindow: a half-open interval [start_k, end_k + margin) during which the grammar-state escalation to Violation is suppressed. The optional suppression_margin adds post-transition damping to absorb residual ringing from waveform changes.
• WaveformSchedule<N>: a fixed-capacity (no_alloc) collection of transition windows. N is a compile-time constant.
• suppress_escalation(k, schedule): the query function the engine calls at observation k. Returns true during any active window.

Non-Claims

The schedule must be populated from a deployment-specific source (e.g., TDMA frame schedule, FHSS channel plan, link-layer signaling). This module provides the data structure and query logic only — it does not infer transition boundaries from the IQ residual itself.

no_std / no_alloc / zero-unsafe

WaveformSchedule<N> uses a [TransitionWindow; N] array. No heap. The crate-wide #![forbid(unsafe_code)] applies to all code here.

References

• de Beer (2026), §18.3 (Waveform Transition Artifacts)
• Rondeau et al. (2004), cognitive radio state machines (heuristic basis for suppression window design)

Structs

TransitionWindow

A single waveform transition window.

WaveformSchedule

Fixed-capacity waveform transition schedule.

Enums

SuppressionDecision

Suppression decision returned to the grammar/policy layer.

TransitionKind

Classification of a deliberate waveform transition event.

Functions

burst_start_window

Convenience constructor for a burst-start transition window.

freq_hop_window

Convenience constructor for a frequency-hop transition window.

power_change_window

Convenience constructor for a power-level change window.

suppress_escalation

Query whether grammar escalation should be suppressed at observation k.