Struct RecoverReport 

pub struct RecoverReport {

    pub transcript_path: Option<PathBuf>,
    pub host_kind: HostKind,
    pub elapsed_ms: u64,
    pub elapsed_ms_resolve_path: u64,
    pub elapsed_ms_dedup_query: u64,
    pub elapsed_ms_parse: u64,
    pub elapsed_ms_writes: u64,
    pub lines_total: u32,
    pub lines_atomised: u32,
    pub lines_skipped_dedup: u32,
    pub lines_skipped_limit: u32,
    pub memories_created: Vec<String>,
    pub errors: Vec<String>,
    pub schema_version_at_run: i64,
    pub fast_path_hit: bool,
}

Per-call recovery report. Doubles as the JSON wire shape for ai-memory recover-previous-session --json and as the MCP-tool return shape; field names + serialization order are the wire contract.

Fields

transcript_path: Option<PathBuf>

Absolute path of the transcript file the recovery walked, or None when no transcript was located (host stub had no transcripts on disk).

host_kind: HostKind

Host whose transcript was recovered. Echoes the resolver arm that won (or --host flag value if explicit).

elapsed_ms: u64

Total wall-clock from recover_from_transcript entry to return, in milliseconds. Pinned by the regression test against the per-scenario budget (see #1389 perf design).

elapsed_ms_resolve_path: u64

Wall-clock for path resolution + stat(2) only.

elapsed_ms_dedup_query: u64

Wall-clock for the dedup-table SELECT.

elapsed_ms_parse: u64

Wall-clock for the JSONL stream parse.

elapsed_ms_writes: u64

Wall-clock for the INSERTs into memories and transcript_line_dedup.

lines_total: u32

Total lines read from the transcript (pre-filter).

lines_atomised: u32

Lines atomised into new memories this run.

lines_skipped_dedup: u32

Lines skipped because their sha256 was already in the dedup table from a prior recovery.

lines_skipped_limit: u32

Lines skipped because the --limit cap was reached.

memories_created: Vec<String>

IDs of memories created this run. Capped at the first QUIET_MEMORY_ID_PREVIEW_CAP in --quiet mode to keep the JSON payload bounded.

errors: Vec<String>

Best-effort errors surfaced during recovery. A non-empty list is NOT a hard failure — the recover verb is graceful by design so SessionStart-hook integration can’t wedge an agent boot.

schema_version_at_run: i64

CURRENT_SCHEMA_VERSION at the time recovery ran. Pinned in RecoverReport so a future schema migration that changes the dedup-table shape can be diagnosed from the JSON wire payload.

fast_path_hit: bool

true when the common-case fast-path short-circuited (transcript mtime ≤ most-recent memory_store write for this agent_id). When true, parse + writes never ran and the elapsed budget is the resolve-path + dedup-query sum.

Implementations

impl RecoverReport

pub fn new(host_kind: HostKind, schema_version: i64) -> Self

New empty report scaffold; callers fill fields as work happens. The Instant tracker pattern is captured in the RecoverTimer helper below.

Trait Implementations

impl Clone for RecoverReport

fn clone(&self) -> RecoverReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecoverReport

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

Formats the value using the given formatter.

impl Default for RecoverReport

fn default() -> RecoverReport

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RecoverReport

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RecoverReport

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

where __S: Serializer,

Serialize this value into the given Serde serializer.