Struct DerivedInsight 

pub struct DerivedInsight {
    pub id: InsightId,
    pub collective_id: CollectiveId,
    pub content: String,
    pub embedding: Vec<f32>,
    pub source_experience_ids: Vec<ExperienceId>,
    pub insight_type: InsightType,
    pub confidence: f32,
    pub domain: Vec<String>,
    pub created_at: Timestamp,
    pub updated_at: Timestamp,
}

A stored derived insight — synthesized knowledge from multiple experiences.

Unlike experiences (which are raw agent observations), insights are computed/derived knowledge that represents higher-level understanding.

Embedding Storage

Insight embeddings are stored inline (not in a separate table) because:

1. Insights are expected to be far fewer than experiences
2. The insight record is always loaded with its embedding for HNSW rebuild
3. Simpler storage model (no table join needed)

Fields

id: InsightId

Unique identifier (UUID v7, time-ordered).

collective_id: CollectiveId

The collective this insight belongs to.

content: String

The insight content (text).

embedding: Vec<f32>

Semantic embedding vector for similarity search.

source_experience_ids: Vec<ExperienceId>

IDs of the source experiences this insight was derived from.

insight_type: InsightType

The type of derivation.

confidence: f32

Confidence in this insight (0.0 = uncertain, 1.0 = certain).

domain: Vec<String>

Domain tags for categorical filtering.

created_at: Timestamp

When this insight was created.

updated_at: Timestamp

When this insight was last updated.

Trait Implementations

impl Clone for DerivedInsight

fn clone(&self) -> DerivedInsight

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DerivedInsight

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DerivedInsight

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DerivedInsight

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

where __S: Serializer,

Serialize this value into the given Serde serializer.