Struct KnowledgeRecord 

pub struct KnowledgeRecord {
    pub schema_version: u32,
    pub record_id: String,
    pub kind: KnowledgeRecordKind,
    pub scope: KnowledgeScope,
    pub source: KnowledgeSource,
    pub confidence: KnowledgeConfidence,
    pub invalidation: KnowledgeInvalidation,
    pub data: Value,
    pub history: Vec<KnowledgeLifecycleEvent>,
}

A versioned knowledge record. data is deliberately opaque to this layer, but its shape, size, and sensitive field names are strictly bounded.

Fields

schema_version: u32

record_id: String

kind: KnowledgeRecordKind

scope: KnowledgeScope

source: KnowledgeSource

confidence: KnowledgeConfidence

invalidation: KnowledgeInvalidation

data: Value

history: Vec<KnowledgeLifecycleEvent>

Implementations

impl KnowledgeRecord

pub fn from_page_observation( observation: &SemanticObservation, options: KnowledgeRecordBuildOptions, ) -> Result<Self, KnowledgeValidationError>

Build an observed page-family record from fresh semantic structure.

Only page/region kinds are retained. Current revisioned target references, labels, text, accessibility trees, and form values are not copied into persistent knowledge.

pub fn from_intent_candidate( candidate: &SemanticIntentCandidate, options: KnowledgeRecordBuildOptions, ) -> Result<Self, KnowledgeValidationError>

Build an observed target-fingerprint record from one fresh intent candidate. Only a digest and non-sensitive semantic dimensions are retained; the candidate’s current reference and accessible name are never persisted.

pub fn from_workflow_definition( workflow: &WorkflowDefinition, options: KnowledgeRecordBuildOptions, ) -> Result<Self, KnowledgeValidationError>

Build a candidate workflow-entry record from a validated definition. Only hashed workflow identity, hashed step/output IDs, and bounded shape counts are retained; inputs, locators, predicates, and values are deliberately excluded.

pub fn validate(&self) -> Result<(), KnowledgeValidationError>

Validate one record against the stable contract and all payload bounds.

pub fn to_canonical_json(&self) -> Result<String, KnowledgeValidationError>

Serialize a validated record with deterministic object-key ordering.

pub fn content_hash(&self) -> Result<String, KnowledgeValidationError>

Hash the canonical record for integrity checks and stable comparisons.

pub fn assess(&self, context: &KnowledgeLookupContext) -> KnowledgeAssessment

Assess this record against current scope and fresh observation signals. A positive assessment never includes an executable target reference.

pub fn transition( &mut self, next: KnowledgeConfidence, reason: String, observed_at: String, fresh_verification: bool, ) -> Result<(), KnowledgeValidationError>

Apply a lifecycle transition. Promotion to verified and recovery from contradiction/quarantine require fresh verification evidence.

Trait Implementations

impl Clone for KnowledgeRecord

fn clone(&self) -> KnowledgeRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnowledgeRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KnowledgeRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for KnowledgeRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for KnowledgeRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for KnowledgeRecord