Struct Record 

pub struct Record {

    pub key: String,
    pub value: String,
    pub category: Category,
    pub priority: Priority,
    pub tags: Vec<String>,
    pub created_at: u64,
    pub updated_at: u64,
    pub ref_url: Option<String>,
    pub staleness: StalenessScore,
    pub lifecycle: RecordLifecycle,
    pub version: RecordVersion,
    pub quality: QualityScore,
    pub access_count: u32,
    pub last_accessed: u64,
    pub source: RecordSource,
    pub confidence: ConfidenceScore,
    pub gap_analysis_score: f32,
    pub payload: Option<Value>,
}

The universal store entry. All categories (gotcha, file, decision, …) share this struct. Category-specific detail is in value (human-readable) and in the typed FileRecord / GotchaRecord for Layer 0/1 fast paths.

Does not derive PartialEq — see module-level float equality note.

Key namespacing:

gotcha:<slug>     file:<path>     decision:<slug>
stage:current     dep:<ecosystem>:<name> dev_note:<slug>

Fields

key: String

Namespaced key — primary storage identifier and graph node key.

value: String

Human-readable content: purpose (file), rule (gotcha), body (decision). Indexed by tantivy for full-text search.

category: Category

priority: Priority

tags: Vec<String>

Free-form tags for search and filtering.

created_at: u64

Unix timestamp (seconds) when this record was first created.

updated_at: u64

Unix timestamp (seconds) of the last write.

ref_url: Option<String>

URL to a PR, issue, doc, or incident that explains this record.

staleness: StalenessScore

lifecycle: RecordLifecycle

version: RecordVersion

Versioning for Lamport-clock conflict resolution (see RecordVersion). Use record.version.device_id to identify the authoring device.

quality: QualityScore

access_count: u32

How many times this record has been read via mem_get or hooks.

last_accessed: u64

Unix timestamp (seconds) of the last access.

source: RecordSource

confidence: ConfidenceScore

gap_analysis_score: f32

Pre-computed gap risk score: change_frequency × (1 - coverage_score).

payload: Option<Value>

Structured per-category payload — typed data in JSON form.

• file:* → FileRecord
• gotcha:* → GotchaRecord
• decision:* → serialized decision body (TBD Layer 1)
• analytics:*, session:* → arbitrary JSON blob (DailyAgg, StaleReviewPayload, …)

value is always the human-readable text: rule, purpose, body. payload carries all structured fields so read sites never parse value as JSON. Stored as-is in MessagePack (serde_json::Value → msgpack map).

Implementations

impl Record

pub fn device_id(&self) -> DeviceId

The device that last wrote this record.

Convenience accessor — delegates to self.version.device_id.

pub fn payload_as<T: DeserializeOwned>(&self) -> Option<T>

Deserialize the structured payload into a typed value.

Returns None when payload is absent or the JSON shape does not match T. Always prefer this over serde_json::from_str(&self.value).

pub fn layer0_file_stub( key: impl Into<String>, device_id: DeviceId, logical_clock: u64, wall_clock: u64, ) -> Self

Construct a layer-0 file stub for file:<path>.

This is the persisted companion to FileRecord::layer0_stub. Layer 0 file records start empty on purpose/value, but still get the suppressed quality default so they never surface in Claude-facing injection paths until enrichment raises them.

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Record

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Record

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

where __S: Serializer,

Serialize this value into the given Serde serializer.