Struct SessionMinedCandidate 

pub struct SessionMinedCandidate {
    pub session_id: String,
    pub ts_ms: i64,
    pub source_repo: String,
    pub title: String,
    pub body: String,
    pub file_patterns: Vec<String>,
    pub gate_model: String,
    pub gate_verdict: String,
    pub content_hash: String,
    pub origin: String,
    pub requires_human_approval: bool,
}

Wire format for one session-mined candidate. Serialised verbatim into cloud_outbox.payload_json under kind = "session_mined_candidate".

Every field except gate_verdict carries a hard local invariant — see the validate method and the constructor builders below. source_repo is the load-bearing one: it MUST be derived from the current git remote / cwd and never empty, otherwise the candidate has no Project Scope and the cloud has no way to attribute it.

Fields

session_id: String

Platform session id from the hook stdin payload (Claude Code session_id, Cursor session uuid, …). Empty string is not accepted — cloud-side dedup keys on this.

ts_ms: i64

Unix-ms at the moment the gate produced its verdict.

source_repo: String

owner/repo for the GitHub remote, or the cwd basename as a fallback for non-GitHub repos. Never empty; rejected if the builder can’t determine a repo identity for the current workspace.

title: String

Single-line title, ≤ TITLE_MAX_CHARS chars. The gate is instructed to write this as a behavioural rule (imperative or declarative); rendering on the cloud side adds prefixes like “Remember:” so we don’t double them.

body: String

Multi-sentence rule body, ≤ BODY_MAX_CHARS chars. Usually 2-5 sentences plus an optional code snippet.

file_patterns: Vec<String>

1-3 file globs, never empty. Cloud-side cascade ordering keys on these (rules whose patterns match the target file surface first), so a candidate with zero patterns can never be served.

gate_model: String

Provider:model identifier for the gate call, e.g. "claude:haiku". Used for audits + future per-model recall.

gate_verdict: String

"KEEP" for a brand-new rule, or "MERGE:<id>" where <id> is the cloud rule id the gate decided to extend. Cloud applies the MERGE shape against the named rule’s body; KEEP becomes a fresh candidate_rules row.

content_hash: String

16-char hex sha256 of source_repo|title|body. Stable across retries so the cloud can dedup duplicate outbox uploads of the same candidate.

origin: String

Origin discriminator on the wire, always ORIGIN.

requires_human_approval: bool

Draft gate; session-mined candidates require human approval.

Implementations

impl SessionMinedCandidate

pub fn try_new(args: SessionMinedCandidateArgs) -> Result<Self, CandidateError>

Build a new candidate from gate output. Truncates title/body to the documented caps, derives the content hash, and pins the origin and draft flag. Callers must drop invalid candidates.

pub fn validate(&self) -> Result<(), CandidateError>

Re-validate an existing candidate. Used by the outbox dispatcher before posting so a corrupted row (e.g. tampered payload, wrong-origin row migrated in) never reaches the cloud endpoint.

Trait Implementations

impl Clone for SessionMinedCandidate

fn clone(&self) -> SessionMinedCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionMinedCandidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionMinedCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SessionMinedCandidate

impl PartialEq for SessionMinedCandidate

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SessionMinedCandidate

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 SessionMinedCandidate