Offline operator commands #

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 without weakening the checksum enforcement used by archive reads — inspection must never be a way to read bytes the server would refuse. 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.