Struct PredicateDebugReport 

pub struct PredicateDebugReport {
    pub total_candidates: usize,
    pub matched: usize,
    pub clause_stats: BTreeMap<String, ClauseStats>,
}

Aggregate report from running a Predicate across a corpus of candidate evaluation contexts.

Phase 6 of CAPABILITY_ENHANCEMENTS_PLAN.md. Built by PredicateDebugReport::from_evaluations.

The report answers: “given this predicate and these candidates, how many matched, and how often did each clause filter?”. A clause with 1042 evaluations and 12 matches has 1.2% positive selectivity — operators use that to spot mismatches between their mental model of the data and the actual data.

Fields

total_candidates: usize

Number of candidates the predicate was evaluated against.

matched: usize

Number of candidates the predicate matched (returned true).

clause_stats: BTreeMap<String, ClauseStats>

Per-clause aggregated stats, keyed by the clause’s debug label. BTreeMap for deterministic iteration order in printed output.

Implementations

impl PredicateDebugReport

pub fn from_evaluations<'a, I>(pred: &Predicate, contexts: I) -> Self

where I: IntoIterator<Item = EvalContext<'a>>,

Run pred against each context in contexts, accumulating per-clause hit / miss stats.

Each context contributes one trace; the trace tree is walked post-order to update the per-label ClauseStats. Composite clauses (And / Or / Not) get their own labels too, so an operator can see “the And short-circuited 730/1042 times” at a glance.

pub fn render(&self) -> String

Format a human-readable summary suitable for terminal output.

Returned as a String rather than printed directly so tests can pin the format and callers can route to their own logger.

Trait Implementations

impl Clone for PredicateDebugReport

fn clone(&self) -> PredicateDebugReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PredicateDebugReport

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

Formats the value using the given formatter.

impl Default for PredicateDebugReport

fn default() -> PredicateDebugReport

Returns the “default value” for a type.

impl PartialEq for PredicateDebugReport

fn eq(&self, other: &PredicateDebugReport) -> 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 PredicateDebugReport