Expand description
Read-only inspection library backing the mimir-cli binary.
Implements the rendering + verification surfaces of
docs/concepts/decoder-tool-contract.md. Everything in this crate
is read-only — no function here writes to a workspace or appends
to a canonical log.
Public surface (v1):
LispRenderer—CanonicalRecord→ Lisp S-expression text reconstructing the agent-visible fields of Sem / Epi / Pro / Inf memory records. Backs thedecodesubcommand.verify— integrity check on acanonical.logfile covering the framing, opcode, and symbol-reference corruption classes fromdecoder-tool-contract.md§ 6.iso8601_from_millis— ms-since-epoch →YYYY-MM-DDTHH:MM:SSZstring inverse ofmimir_core::parse’s ISO-8601 loader, so timestamps round-trip bit-perfect through render → re-parse.
Structs§
- Lisp
Renderer - Renders memory records as Lisp S-expressions using a
SymbolTableto resolveSymbolId→ canonical name. Output conforms toir-write-surface.mdand re-parses to an equivalentUnboundForm(modulo librarian-assignedmemory_id/committed_at/observed_atfields which the agent never provides). - Verify
Report - Result of a
verifypass.
Enums§
- Render
Error - Errors produced by
LispRenderer::render_memory. None of these are fatal for the caller — the renderer can skip unrenderable records and continue. - Tail
Status - Classification of the trailing bytes past the last decodable record, if any.
- Verify
Error - Errors produced by
verifyandload_table_from_log.
Functions§
- iso8601_
from_ millis - ms-since-epoch →
YYYY-MM-DDTHH:MM:SSZUTC string. Matches the ISO-8601 format accepted bymimir_core::parse’s timestamp loader so the string round-trips bit-perfect. - load_
table_ from_ log - Open a canonical log read-only and return the reconstructed
SymbolTable(via a temporaryPipeline) so the renderer and verify helpers can share a table. - verify
- Read-only integrity check on a canonical log.