Module trace 

Render trace + time-travel capture for ftui TUI (bead 2noh9.4.3).

Records frame snapshots, event streams, and render timing so that TUI bugs can be reproduced from a trace bundle without rerunning on the original machine.

Formats

• Render trace (.trace.jsonl): one JSON object per frame with timing, size, message that triggered the render, and optional text snapshot.
• Event stream (.events.jsonl): one JSON object per CassMsg with timestamp and serialized variant tag.
• Trace bundle (directory): render trace + event stream + tui_state.json
  • system_info.json.

Structs

EventRecord

One event’s metadata.

FrameRecord

One frame’s render metadata.

SystemInfo

System information snapshot for trace bundles.

TraceOptions

Options controlling trace capture, parsed from CLI flags.

TraceWriter

Appends frame and event records to JSONL files.

Functions

read_event_stream

Read a JSONL event stream file and return parsed records.

read_render_trace

Read a JSONL render trace file and return parsed records.

write_trace_bundle

Write a complete trace bundle directory containing: