# Offline operator commands

**This file covers the inspection subcommands only.** The binary's primary
command is `serve`, which runs the actual system; its options are documented in
[`configuration.md`](configuration.md) and audited in
[`configuration-parity.md`](configuration-parity.md). The four subcommands are
`version`, `inspect-segment`, `inspect-all`, and `serve`.

The binary exposes upstream's offline inspection commands. They do not start
the server or open RocksDB, so they are safe against a data directory a live
process owns.

```
stream version
stream inspect-segment --blocks=table --blocks-truncate=100 <segment.jss>
stream inspect-all --data-dir=./data --collections-truncate=100
```

`version` emits the upstream build-information field shape; values necessarily
identify the Stream artifact rather than a Go build.

`inspect-segment` accepts `summary`, `table`, and `full` detail and handles
both sealed and active files. It reports a readable checksum-corrupt sealed
file as invalid; the checksum enforcement used by archive reads is unchanged.
A committed upstream-produced JSS fixture pins its rendered output byte for
byte, apart from the file path.

`inspect-all` walks both the steady archive and Stream's bootstrap live-capture
tree, aggregates network/tree/collection totals, tolerates a racing tail file,
and supports upstream's `--skip-unsealed` and collection-table truncation
controls. It inherits `JETSTREAM_DATA_DIR`, and root logging variables persist
across every command.

Note that `inspect-all` does not replace the online collections and segments
status tabs, which remain absent — see [`semantic-parity.md`](semantic-parity.md).