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 and audited in 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.