Struct ContextRefCandidate 

pub struct ContextRefCandidate {

    pub ref_id: ContextRefId,
    pub summary: String,
    pub scope: Vec<String>,
    pub confidence: Option<u8>,
    pub authority: Option<String>,
    pub runtime_mode: RuntimeMode,
    pub authority_class: AuthorityClass,
    pub proof_state: ClaimProofState,
    pub requested_ceiling: ClaimCeiling,
    pub provenance_class: ProvenanceClass,
    pub semantic_trust: SemanticTrustClass,
    pub selection_reason: String,
    pub sensitivity: Sensitivity,
    pub raw_event_payload: Option<Value>,
}

Candidate selected by an upstream retrieval/memory layer.

Fields

ref_id: ContextRefId

Candidate ref id.

summary: String

Summary or abstracted content.

scope: Vec<String>

Scope fields.

confidence: Option<u8>

Confidence as a percentage, when known.

authority: Option<String>

Authority tier or source label, when known.

runtime_mode: RuntimeMode

Runtime mode bounding this candidate’s authority claim.

authority_class: AuthorityClass

Authority class used for ceiling calculation.

proof_state: ClaimProofState

Proof closure state for this candidate.

requested_ceiling: ClaimCeiling

Requested claim ceiling before weakest-link downgrade.

provenance_class: ProvenanceClass

Semantic provenance family for this candidate.

semantic_trust: SemanticTrustClass

Semantic trust class for this candidate.

selection_reason: String

Selection reason.

sensitivity: Sensitivity

Sensitivity tier used by redaction.

raw_event_payload: Option<Value>

Optional raw event payload from upstream.

Implementations

impl ContextRefCandidate

pub fn new(ref_id: ContextRefId, summary: impl Into<String>) -> Self

Build a minimal candidate from a ref and summary.

pub fn with_raw_event_payload(self, raw_event_payload: Value) -> Self

Attach raw event payload supplied by upstream lineage.

pub fn with_sensitivity(self, sensitivity: Sensitivity) -> Self

Attach sensitivity tier.

pub fn with_claim_metadata( self, runtime_mode: RuntimeMode, authority_class: AuthorityClass, proof_state: ClaimProofState, requested_ceiling: ClaimCeiling, ) -> Self

Attach explicit claim metadata for context-pack truth ceilings.

pub const fn with_semantic_metadata( self, provenance_class: ProvenanceClass, semantic_trust: SemanticTrustClass, ) -> Self

Attach explicit semantic provenance/trust metadata.

Trait Implementations

impl Clone for ContextRefCandidate

fn clone(&self) -> ContextRefCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextRefCandidate

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

Formats the value using the given formatter.

impl PartialEq for ContextRefCandidate

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