Struct CachedNarrative 

pub struct CachedNarrative {
    pub narrative: String,
    pub subject: String,
    pub grounded: bool,
    pub unmatched: Vec<String>,
    pub model: String,
    pub prompt_version: u32,
    pub schema_version: u32,
    pub fact_digest: String,
    pub created_at: String,
}

A cached advisory narrative plus the provenance a caller needs to decide whether it still describes the current evidence.

subject is the stable label the narrative describes — the repo-relative file path for a file diagnosis — so a staleness check compares only against the subject’s own narratives, never a sibling’s. fact_digest is the digest of the fact-sheet text the narrative was written from; comparing it against a freshly built sheet’s digest is how a caller detects that a cached narrative has gone stale. created_at is an ISO-8601 UTC timestamp, so a lexical ordering of two entries is a chronological one.

Fields

narrative: String

The narrative text as the model produced it.

subject: String

The subject the narrative describes — the repo-relative file path for a file diagnosis, or a caller-chosen stable label for other lenses. Older sidecars written before this field existed deserialize as the empty string, which matches no real subject and so is simply never served.

grounded: bool

The generation-time groundedness verdict: whether every number the narrative quoted was grounded in the fact sheet when it was written. narrate recomputes the verdict from the cached narrative on every read, so a checker improvement applies to warm caches; this field records what the writing binary saw.

unmatched: Vec<String>

The numeric tokens that matched no fact value at generation time (empty iff grounded). Like grounded, this is the writing binary’s verdict; narrate recomputes it from the cached narrative on read.

model: String

The model id that produced the narrative.

prompt_version: u32

The prompt-template version in force when it was generated.

schema_version: u32

The fact-sheet schema version in force when it was generated.

fact_digest: String

Lowercase-hex SHA-256 of the fact-sheet text the narrative describes.

created_at: String

ISO-8601 UTC timestamp of when the narrative was cached.

Trait Implementations

impl Clone for CachedNarrative

fn clone(&self) -> CachedNarrative

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachedNarrative

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CachedNarrative

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CachedNarrative

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

where __S: Serializer,

Serialize this value into the given Serde serializer.