mimir-cli 0.1.0

Mimir — read-only inspection CLI for canonical stores.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# mimir-cli

Read-only inspection CLI for [Mimir](https://github.com/buildepicshit/Mimir) canonical logs. Decoder tool per `decoder-tool-contract.md`.

> **Pre-1.0 status.** This crate is part of Mimir's active-development tree. CLI output and library APIs may change before v1. Public crates.io releases wait for the first alpha.

## Install

Until the first alpha release, build from the repository root:

```bash
cargo install --locked --path crates/mimir-cli
```

## Subcommands

```text
mimir-cli log     <path>   Stream summary of a canonical log.
mimir-cli decode  <path>   Emit re-parseable Lisp for memory records.
mimir-cli symbols <path>   Print the reconstructed symbol table.
mimir-cli verify  <path>   Integrity + corruption report.
```

All subcommands are read-only by construction: the binary never writes to the log, never appends, never truncates.

## Exit codes

- `0` — success / clean log.
- `1` — corruption signals (decode error, dangling symbols, corrupt tail).
- `2` — argument errors / file-not-found.

## Example

```bash
$ mimir-cli verify ~/.mimir/<workspace_hex>/canonical.log
Records decoded: 1247
Checkpoints: 38
Memory records: 412
Symbol events: 797
Trailing bytes: 0
Dangling symbols: 0
Tail status: Clean
```

## Companion library

The CLI's rendering + verification logic is exposed as the [`mimir_cli`](https://docs.rs/mimir-cli) library so you can embed it (e.g., in a custom inspector or a CI gate).

## License

[Apache-2.0](LICENSE).