Struct ReasoningRecord 

pub struct ReasoningRecord {
    pub schema: String,
    pub version: u32,
    pub id: String,
    pub task: String,
    pub recorded_at: String,
    pub head: Option<String>,
    pub redacted: Vec<String>,
    pub body: ReasoningBody,
}

A stored record: a body with the envelope only the writer stamps.

The envelope carries the schema and version, a unique id, the task, the time it was recorded, the commit the checkout was on and the secret shapes redacted from its text. One record is one JSON file in the store; the store reads back only records whose schema and version match.

use majordomus_cli::reasoning::record::*;

let record = ReasoningRecord {
    schema: RECORD_SCHEMA.into(),
    version: RECORD_VERSION,
    id: "attempt-20261001T000000Z-abcdef".into(),
    task: "untasked".into(),
    recorded_at: "2026-10-01T00:00:00Z".into(),
    head: None,
    redacted: vec![],
    body: ReasoningBody::Attempt(AttemptInput {
        assessment: None,
        attempt: "inline the call".into(),
        observed_failure: "the test still fails".into(),
        assumption_invalidated: None,
        evidence: vec![],
        updated_hypothesis: None,
    }),
};
let text = serde_json::to_string(&record).unwrap();
assert!(!text.contains("\"head\""), "an absent head is not written");
let back: ReasoningRecord = serde_json::from_str(&text).unwrap();
assert_eq!(back.id, record.id);
assert_eq!(back.body.kind(), "attempt");

Fields

schema: String

RECORD_SCHEMA.

version: u32

RECORD_VERSION.

id: String

<kind>-<yyyymmddThhmmssZ>-<hex>, unique in the store.

task: String

The task it was recorded under, or untasked.

recorded_at: String

When it was recorded, RFC 3339; stamped by the writer, never supplied.

head: Option<String>

The commit the checkout was on.

redacted: Vec<String>

Secret shapes the writer removed from the text, by shape name.

body: ReasoningBody

The record.

Trait Implementations

impl Clone for ReasoningRecord

fn clone(&self) -> ReasoningRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReasoningRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReasoningRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ReasoningRecord

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ordered for ReasoningRecord

Records are in the order they were written: by their millisecond stamp, then by id. The stamps are fixed-width, so the label orders as time does.

fn order_key(&self) -> OrderKey<'_>

The four parts this item is ordered by. Borrowed from the item: building a key allocates nothing, so sorting a large collection costs the comparisons and no more.

impl Serialize for ReasoningRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.