@turndb/cli

The turndb command line: inspect, verify, query, and ship a store from a terminal with no server running.

npm install -g @turndb/cli

turndb --version                                # the crate version compiled in
turndb import  mystore.turndb traces.jsonl      # each line needs a "body"; other scalars become attributes
turndb inspect mystore.turndb                   # manifest, parts, fold, members, retained revisions
turndb verify  mystore.turndb --deep            # every record, piece, frame, and pin
turndb query   mystore.turndb "SELECT model, count(*) FROM t GROUP BY model"
turndb backup  mystore.turndb snap.turndb       # the current store authority as one self-contained store
turndb query   snap.turndb "SELECT count(*) FROM t"

turndb help prints the authoritative verb set; where it and this list disagree, it is right.

What ships

A native binary, delivered through a per-platform package that npm installs as an optional dependency and skips everywhere it does not apply. There is deliberately no WASM fallback: the binary needs positioned reads and an OS-enforced writer lock. In-place content-punch and free-space-punch use Linux hole punching or Windows sparse-range zeroing and report unsupported on other platforms, so a platform without a build says so rather than silently running a different engine with different guarantees.

Published slices: linux-x64-gnu, linux-arm64-gnu, darwin-x64, darwin-arm64, and win32-x64-msvc. Other targets must build from source with cargo install turndb.

Reading a store the library wrote

Every read verb accepts a current-draft .turndb store file. A store written by the turndb wasm package or @turndb/native reads here identically. Any other physical identity is refused. There is no converter, migration reader, or fallback parser for discarded draft layouts.

Operating verbs (compact for part merge, refold, content-punch, free-space-punch, erase, recover for manifest promotion, reclaim, and backup) take the writer role — flock on Unix or LockFileEx on Windows, on the store container handle — and close it when they finish, so a store they have operated on is exactly one file.

Apache-2.0. See LICENSE and NOTICE.