//! Fixed-state lifecycle replay, never model-tool attribution (SMH-SPEC-PLUG0001). use super::{EntryFrame, Result, SessionId, TraceKind, TraceRecord}; use crate::metadata::lifecycle as evidence; use smith::EntryId; #[derive(Default)] pub(super) struct PendingLifecycle { invocation: Option<(EntryId, EntryId)>, effect: Option, } impl PendingLifecycle { pub(super) fn observe( &mut self, session_id: SessionId, entry: &EntryFrame, ) -> Result> { let crate::content_codec::EntryContentView::Meta { kind, detail } = crate::content_codec::EntryContentView::decode(&entry.content)? else { return Ok(None); }; if !evidence::reserved(kind) { return Ok(None); } let malformed = |_| smith::SmithError::Session { code: smith::error::SessionCode::EntryDecode, message: "invalid lifecycle trace identity".into(), }; let root = evidence::identity(detail, "root_entry_id").map_err(malformed)?; let invocation = evidence::identity(detail, "invocation_id").map_err(malformed)?; let (trace_kind, effect) = match kind { evidence::INVOCATION_INTENT => { self.invocation = Some((root, invocation)); (TraceKind::LifecycleInvocationStarted, None) } evidence::INVOCATION_COMPLETION => { self.invocation = None; (TraceKind::LifecycleInvocationCompleted, None) } evidence::EFFECT_INTENT => { let effect = evidence::identity(detail, "effect_id").map_err(malformed)?; self.invocation = Some((root, invocation)); self.effect = Some(effect); (TraceKind::LifecycleEffectStarted, Some(effect)) } evidence::EFFECT_COMPLETION => { self.invocation = Some((root, invocation)); let effect = evidence::identity(detail, "effect_id").map_err(malformed)?; self.effect = None; (TraceKind::LifecycleEffectCompleted, Some(effect)) } _ => return Ok(None), }; Ok(Some(TraceRecord { session_id, timestamp_ms: entry.timestamp_ms, kind: trace_kind, event_ref: format!( "root:{root}:invocation:{invocation}:effect:{}:entry:{}", effect.map_or_else(|| "none".into(), |id| id.to_string()), entry.id ), })) } pub(super) fn finish( &mut self, session_id: SessionId, timestamp_ms: i64, visit: &mut impl FnMut(TraceRecord) -> Result<()>, ) -> Result<()> { if let Some((root, invocation)) = self.invocation.take() { if let Some(effect) = self.effect.take() { visit(TraceRecord { session_id, timestamp_ms, kind: TraceKind::LifecycleEffectIncomplete, event_ref: format!( "root:{root}:invocation:{invocation}:effect:{effect}:mutation:unknown" ), })?; } visit(TraceRecord { session_id, timestamp_ms, kind: TraceKind::LifecycleInvocationIncomplete, event_ref: format!("root:{root}:invocation:{invocation}:outcome:unknown"), })?; } Ok(()) } }