Struct FeedbackEvent 

pub struct FeedbackEvent {
    pub corpus_id: String,
    pub query_id: String,
    pub score: f64,
    pub timestamp: String,
}

One user-supplied satisfaction signal attached to a specific query.

score is a normalized scalar in [0, 1]:

• 1.0 = perfect, user got exactly what they wanted.
• 0.5 = neutral / ambiguous.
• 0.0 = wrong, unhelpful, or actively misleading.

Upstream mapping (stars to [0, 1], CTR to [0, 1], etc.) is the caller’s responsibility — the aggregator just computes statistics on whatever scalar you supply.

Fields

corpus_id: String

Must match the corpus_id of the MetaTrainingRecord the pipeline was built from.

query_id: String

Caller-supplied query identifier. Free-form; used for deduping and auditing. An empty string is allowed.

score: f64

Satisfaction signal in [0, 1]. Clamped at read time by FeedbackAggregator::summarize; store raw values if you want.

timestamp: String

Free-form timestamp string. Seconds-since-epoch by default from FeedbackEvent::now; swap in your own format as needed.

Implementations

impl FeedbackEvent

pub fn now( corpus_id: impl Into<String>, query_id: impl Into<String>, score: f64, ) -> Self

Construct with a default timestamp (epoch seconds).

pub fn append_to_default_store(&self) -> Result<PathBuf>

Append this event to the user’s default feedback store (~/.sphereql/feedback_events.json).

O(1) per call: opens the file in append mode and writes one JSON-encoded line. Previous implementation loaded the full aggregator, pushed the event, and rewrote the file — O(N) per append, which mattered on a production firehose. Legacy array-format stores are migrated to JSONL on the first append (one-time O(N) cost) and append at O(1) afterward.

Mirrors MetaTrainingRecord::append_to_default_store — both are instance methods on the data they persist.

pub fn append_to(&self, path: impl AsRef<Path>) -> Result<()>

Append this event to an arbitrary JSONL file. Creates the file and any missing parent directories on first call.

Trait Implementations

impl Clone for FeedbackEvent

fn clone(&self) -> FeedbackEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FeedbackEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FeedbackEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FeedbackEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.