Struct GeometryDiagnostics 

pub struct GeometryDiagnostics {
    pub schema_version: u32,
    pub total_csg_failures: u64,
    pub products_with_failures: u64,
    pub hosts_with_openings: u64,
    pub classification: ClassificationSummary,
    pub failures_by_reason: Vec<ReasonCount>,
    pub silent_no_ops: u64,
    pub rect_fast: RectFastSummary,
    pub worst_hosts: Vec<WorstHost>,
    pub oversized_ref_drops: u64,
    pub total_unsupported_items: u64,
    pub unsupported_items_by_type: Vec<ReasonCount>,
}

Aggregate CSG / opening diagnostics for one geometry pass — the public diagnostics contract. Built by aggregate_diagnostics from drained router data and serialized to the @ifc-lite/geometry complete event, and reused verbatim by the native ProcessingStats path (rust/processing/src/processor/mod.rs populates geometry_diagnostics). wasm-free (serde only).

Fields

schema_version: u32

Contract version (GEOMETRY_DIAGNOSTICS_SCHEMA_VERSION); serialized unconditionally so consumers can gate on it. Deserializes to 0 when the producer predates versioning.

total_csg_failures: u64

Total CSG boolean failures (un-cut openings, emptied hosts, fallbacks).

products_with_failures: u64

Distinct products (host elements) with at least one failure.

hosts_with_openings: u64

Hosts that had openings processed.

classification: ClassificationSummary

Opening-classifier outcome counts.

failures_by_reason: Vec<ReasonCount>

Failure counts by stable reason label, sorted desc by count.

silent_no_ops: u64

Hosts where rectangular cutters ran but the triangle count was unchanged (cut attempted, geometry not modified) — the highest-signal “looks wrong but did not error” indicator.

rect_fast: RectFastSummary

rect_fast fast-path engagement.

worst_hosts: Vec<WorstHost>

Bounded top-N worst-failing hosts (opt-in per-product detail).

oversized_ref_drops: u64

Refs the content-hash pass refused (u32::MAX, #3421/#3752). Additive.

total_unsupported_items: u64

Items dropped: no processor, or the processor errored. Additive.

Counted once per IfcRepresentationMap source PER ROUTER, not once per IfcMappedItem occurrence. That is a model-wide “once” on the wasm path, which walks a whole batch with one router. It is NOT model-wide on the native pool: process_entity_job builds a fresh router per element, and a source whose items all drop is refused by the shared mapped-item cache (empty meshes are never published), so every element that instantiates it walks it again and contributes its own count. Read the number as a lower bound on affected types, never as a count of distinct sources or elements.

unsupported_items_by_type: Vec<ReasonCount>

Self::total_unsupported_items broken down by IFC type, count-desc.

Implementations

impl GeometryDiagnostics

pub fn has_issues(&self) -> bool

Whether any CSG failure, silent no-op, or dropped item was recorded.

pub fn is_empty(&self) -> bool

Whether nothing diagnostic-worthy happened this pass — no openings classified, no failures, no silent no-ops, no rect_fast activity. Callers skip attaching an all-zero object so a consumer can gate on presence (if event.diagnostics) as well as on counts.

Trait Implementations

impl Clone for GeometryDiagnostics

fn clone(&self) -> GeometryDiagnostics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeometryDiagnostics

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

Formats the value using the given formatter.

impl Default for GeometryDiagnostics

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GeometryDiagnostics

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GeometryDiagnostics

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.