picovolt 1.7.1 → 1.8.0

package/README.md

@@ -111,10 +111,24 @@ cargo run --release --example repl     # interactive SQL shell (pvsql)
 cargo run --release --example bench    # evaluation harness across modes and workloads
 ```
 
-Install the first-class CLI with `cargo install picovolt`, then use `pv query`,
-`pv inspect`, `pv history`, `pv import`, `pv export`, and `pv bake`. Copyable
-Rust, Python, Go, Node, and browser projects are in [`starters/`](starters/README.md); supported adapters
-are catalogued in [`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md).
+Install the full CLI with `cargo install picovolt --features data-tools`, then use `pv query`,
+`pv inspect`, `pv history`, `pv diff`, `pv import`, `pv export`, and `pv bake`.
+Parquet/SQLite conversion, query explanations, inspection, resumable baking,
+and dataset signing are documented in [Data tools](docs/DATA_TOOLS.md).
+
+Compare two MVCC snapshots with:
+
+```sh
+pv diff ./data users --from 42 --to 57
+pv diff ./data users --from 42 --to 57 --format jsonl
+```
+
+CSV is the default and identifies each row with an `_change` column. JSONL uses
+`{"change":"added|removed","row":{...}}`. The diff is deterministic and
+duplicate-aware; an update is represented as a removed row followed by an added
+row. Copyable Rust, Python, Go, Node, and browser projects are in
+[`starters/`](starters/README.md); supported adapters are catalogued in
+[`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md).
 
 SQL supports the normal PicoVolt CRUD and schema statements plus projection,
 filters, aggregates, grouping, time travel, ordering, and pagination. The

package/package.json

@@ -2,7 +2,7 @@
   "name": "picovolt",
   "type": "module",
   "description": "Embedded SQL database with MVCC history and single-file deployment",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",