Enum EncodeDeploymentDecision 

pub enum EncodeDeploymentDecision {
    Met {
        measured_rows_per_sec: f64,
        target_rows_per_sec: f64,
    },
    Unmet {
        measured_rows_per_sec: f64,
        target_rows_per_sec: f64,
    },
    Undetermined {
        reason: EncodeDecisionBlocked,
    },
}

Tri-state Stage-3 encode deployment / amortized-surrogate decision (#988, #1412).

The decision the throughput gate exists to make is empirical: does the EXACT per-row encode clear the 100_000 rows/sec/GPU deployment target on a real device? Only a real device measurement can answer it:

• Self::Met — a device measurement CLEARED the target: ship the exact encode; the certified amortized surrogate is NOT needed.
• Self::Unmet — a device measurement MISSED the target: the certified amortized surrogate becomes justified.
• Self::Undetermined — no device measurement is available. The decision is BLOCKED on hardware; it is neither “surrogate unneeded” nor “surrogate justified”.

The critical anti-green-wash property (#1412): there is NO constructor that takes a CPU rate. A CPU measurement, however fast, can never move the decision out of Self::Undetermined. Projecting a CPU rate through an assumed CPU→GPU factor to declare the target met was the exact #1412 defect and is structurally impossible here — Self::Met / Self::Unmet come only from Self::from_device_measurement with engaged == true.

Variants

Met

A device measurement established the deployment target.

Fields

measured_rows_per_sec: f64

The measured device rows/sec that cleared the target.

target_rows_per_sec: f64

The target it was compared against.

Unmet

A device measurement fell short of the deployment target.

Fields

measured_rows_per_sec: f64

The measured device rows/sec that missed the target.

target_rows_per_sec: f64

The target it was compared against.

Undetermined

No device measurement is available; the decision is blocked on hardware.

Fields

reason: EncodeDecisionBlocked

Why no device measurement could be made.

Implementations

impl EncodeDeploymentDecision

pub fn from_device_measurement( engaged: bool, measured_rows_per_sec: f64, ) -> Self

The ONLY path to a Met/Unmet decision: a device measurement that actually engaged the device and produced a usable rate. engaged == false (false routing / CPU decline) or a non-finite / non-positive rate yields Self::Undetermined — never a fabricated pass or fail.

pub fn from_device_measurement_against( engaged: bool, measured_rows_per_sec: f64, target_rows_per_sec: f64, ) -> Self

Self::from_device_measurement against an explicit target (for tests that probe the decision logic without the global target constant).

pub fn blocked(reason: EncodeDecisionBlocked) -> Self

Construct the blocked decision for a host that cannot measure the exact encode on a device. This is the honest CPU-only / no-device-kernel outcome — the deployment target is left undetermined rather than projected.

pub fn surrogate_unneeded(&self) -> bool

True ONLY when a device measurement cleared the target: the exact encode ships and no surrogate is built. Never true from a CPU proxy.

pub fn surrogate_justified(&self) -> bool

True ONLY when a device measurement missed the target: the certified amortized surrogate becomes justified. Never true without a measurement.

pub fn is_undetermined(&self) -> bool

True when no device measurement is available and the decision is blocked on hardware (neither Self::surrogate_unneeded nor Self::surrogate_justified).

Trait Implementations

impl Clone for EncodeDeploymentDecision

fn clone(&self) -> EncodeDeploymentDecision

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for EncodeDeploymentDecision

impl Debug for EncodeDeploymentDecision

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for EncodeDeploymentDecision

fn eq(&self, other: &EncodeDeploymentDecision) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EncodeDeploymentDecision