Struct Recommendation 

pub struct Recommendation {

    pub hash: String,
    pub analyzer: String,
    pub params_snapshot: Map<String, Value>,
    pub origin: Origin,
    pub target_ref: String,
    pub action_kind: ActionKind,
    pub dedup_key: String,
    pub summary: Summary,
    pub severity: Severity,
    pub proposal: Proposal,
    pub destructive: bool,
    pub rollbackable: bool,
    pub evidence: Vec<String>,
    pub evidence_query: Option<String>,
    pub metric: Option<MetricSnapshot>,
    pub confidence: f64,
    pub importance: f64,
    pub created_at_ms: i64,
    pub guidance: Option<String>,
    pub evalset_hash: Option<String>,
    pub status: RecStatus,
}

A stored recommendation. hash (the content address) and status (the index-layer cache) are set by the engine, not serialized into the grain body — the body is immutable content, the lifecycle lives in the state index and the audit chain.

Fields

hash: String

analyzer: String

params_snapshot: Map<String, Value>

origin: Origin

target_ref: String

action_kind: ActionKind

dedup_key: String

summary: Summary

severity: Severity

proposal: Proposal

destructive: bool

rollbackable: bool

evidence: Vec<String>

evidence_query: Option<String>

metric: Option<MetricSnapshot>

confidence: f64

importance: f64

created_at_ms: i64

guidance: Option<String>

Optional LLM guidance: an ENRICH note on a deterministic recommendation, or an origin = llm draft’s own rationale (§9). Whitelisted, capped text — it never replaces the engine-templated summary.

evalset_hash: Option<String>

Rule E1’s pin (§7.4): the evalset hash a code_revision was gated against — REQUIRED for code targets, forbidden elsewhere (a recommendation targets code XOR an evalset, never both, and only code carries the pin). Shown at review; checked live at apply (superseded evalset ⇒ the pin is stale ⇒ re-gate).

status: RecStatus

Implementations

impl Recommendation

pub fn to_grain_spec(&self, namespace: &str) -> Result<GrainSpec>

Serialize the immutable body into grain fields (excludes hash/status).

pub fn from_fields(hash: &str, fields: &Map<String, Value>) -> Result<Self>

Reconstruct from a stored grain body. hash comes from the record’s address; status is supplied from the state index by the caller. Rule E1 is RE-CHECKED here — a hand-authored recommendation grain must not smuggle an unpinned code revision past the stamped path.

Trait Implementations

impl Clone for Recommendation

fn clone(&self) -> Recommendation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Recommendation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Recommendation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Recommendation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Recommendation

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 Recommendation