nedb-engine 2.2.28__tar.gz → 2.2.31__tar.gz

{nedb_engine-2.2.28 → nedb_engine-2.2.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nedb-engine
-Version: 2.2.28
+Version: 2.2.31
 Summary: NEDB — a versioned, self-compressing, time-traveling embedded database (replay-protected, idempotent, relational, searchable) with durable AOF persistence and a server daemon (nedbd).
 Project-URL: Homepage, https://github.com/aiassistsecure/nedb
 Project-URL: Repository, https://github.com/aiassistsecure/nedb
@@ -40,11 +40,11 @@ One Rust core → ships to **PyPI** and **npm** from a single source.
 
 ---
 
-## NEDB v2.0.36 — Production Stable
+## NEDB v2.2.31 — Production Stable
 
-**Current stable: 2.0.36** — Cross-platform native wheels shipping `nedbd-v2` binary inside `pip install nedb-engine`. Linux + Windows wheels built on GitHub Actions; macOS arm64 + x86_64 wheels built on Codemagic (M2 Mac Minis). All four platforms publish from one `v*` tag.
+**Current stable: 2.2.31** — Cross-platform native wheels shipping `nedbd-v2` binary inside `pip install nedb-engine`. Linux + Windows wheels built on GitHub Actions; macOS arm64 + x86_64 wheels built on Codemagic (M2 Mac Minis). All four platforms publish from one `v*` tag.
 
-NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.0.36**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
+NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.2.31**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
 
 ```bash
 # Run the v2 DAG engine — ships inside pip install nedb-engine
@@ -53,9 +53,9 @@ nedbd --dag --data ./data
 NEDBD_DAG=1 NEDB_TMK=<32-byte-hex> nedbd --data ./data
 
 curl http://127.0.0.1:7070/health
-# {"ok":true,"version":"2.0.36","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
+# {"ok":true,"version":"2.2.31","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
 
-# Tail the live event stream (new in v2.0.36)
+# Tail the live event stream (new in v2.2.31)
 curl http://127.0.0.1:7070/events
 # event: scan   data: {"objects":730000,"of":1310703,"rate":21043,"eta_s":28}
 # event: ready  data: {"seq":1310703,"head":"b2:9c14e07a…"}
@@ -79,7 +79,7 @@ curl http://127.0.0.1:7070/events
 
 **v1 AOF engine is still shipped and unchanged** — `nedbd` (no flag) runs v1.
 
-**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.0.36 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
+**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.2.31 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
 
 ---
 
@@ -244,11 +244,11 @@ nedbd --dag --data ./data                 # v2 DAG engine (or NEDBD_DAG=1)
 NEDBD_RESP2_PORT=6380 nedbd               # also speak RESP2 (redis-cli compatible)
 nedbd --log-level 2                       # 0=errors 1=requests 2=deploy 3=verbose
 
-# Live event stream (new in v2.0.36) — SSE: scan progress, ready, per-write head
+# Live event stream (new in v2.2.31) — SSE: scan progress, ready, per-write head
 curl http://127.0.0.1:7070/events
 ```
 
-### Startup modes (v2.0.36)
+### Startup modes (v2.2.31)
 
 - **Warm start** — every restart after the first open reads the `MANIFEST` file and restores `seq` + Merkle `head` in **O(1)**. No scan, no replay, independent of dataset size. Boots in milliseconds.
 - **Cold start** — first open of an existing dataset spawns the integrity scan in a background thread *and accepts connections immediately*. Reads serve instantly from the content-addressed DAG; writes return `HTTP 503 startup in progress` until the `startup_ready` gate flips. Progress (objects, rate, ETA) streams over `GET /events`.
@@ -258,7 +258,7 @@ curl http://127.0.0.1:7070/events
 | Variable | Default | Description |
 |---|---|---|
 | `NEDBD_DAG` | `0` | Set `1` to launch the v2 DAG engine (`nedbd-v2`). Same as `--dag`. |
-| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.0.36** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
+| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.2.31** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
 | `NEDBD_PORT` | `7070` | HTTP bind port. |
 | `NEDBD_TOKEN` | unset | Optional bearer token; required on every `/v1/*` request when set. |
 | `NEDB_TMK` | unset | 32-byte hex AES-256-GCM at-rest encryption key. |
@@ -321,7 +321,7 @@ db.query('FROM policy AS OF 200 VALID AS OF "2024-02-15"')
 
 ## Performance
 
-**v2 DAG Rust server (v2.0.36, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
+**v2 DAG Rust server (v2.2.31, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
 
 | Operation | Throughput | p50 | p99 |
 |---|---|---|---|

{nedb_engine-2.2.28 → nedb_engine-2.2.31}/README.md

@@ -19,11 +19,11 @@ One Rust core → ships to **PyPI** and **npm** from a single source.
 
 ---
 
-## NEDB v2.0.36 — Production Stable
+## NEDB v2.2.31 — Production Stable
 
-**Current stable: 2.0.36** — Cross-platform native wheels shipping `nedbd-v2` binary inside `pip install nedb-engine`. Linux + Windows wheels built on GitHub Actions; macOS arm64 + x86_64 wheels built on Codemagic (M2 Mac Minis). All four platforms publish from one `v*` tag.
+**Current stable: 2.2.31** — Cross-platform native wheels shipping `nedbd-v2` binary inside `pip install nedb-engine`. Linux + Windows wheels built on GitHub Actions; macOS arm64 + x86_64 wheels built on Codemagic (M2 Mac Minis). All four platforms publish from one `v*` tag.
 
-NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.0.36**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
+NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.2.31**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
 
 ```bash
 # Run the v2 DAG engine — ships inside pip install nedb-engine
@@ -32,9 +32,9 @@ nedbd --dag --data ./data
 NEDBD_DAG=1 NEDB_TMK=<32-byte-hex> nedbd --data ./data
 
 curl http://127.0.0.1:7070/health
-# {"ok":true,"version":"2.0.36","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
+# {"ok":true,"version":"2.2.31","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
 
-# Tail the live event stream (new in v2.0.36)
+# Tail the live event stream (new in v2.2.31)
 curl http://127.0.0.1:7070/events
 # event: scan   data: {"objects":730000,"of":1310703,"rate":21043,"eta_s":28}
 # event: ready  data: {"seq":1310703,"head":"b2:9c14e07a…"}
@@ -58,7 +58,7 @@ curl http://127.0.0.1:7070/events
 
 **v1 AOF engine is still shipped and unchanged** — `nedbd` (no flag) runs v1.
 
-**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.0.36 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
+**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.2.31 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
 
 ---
 
@@ -223,11 +223,11 @@ nedbd --dag --data ./data                 # v2 DAG engine (or NEDBD_DAG=1)
 NEDBD_RESP2_PORT=6380 nedbd               # also speak RESP2 (redis-cli compatible)
 nedbd --log-level 2                       # 0=errors 1=requests 2=deploy 3=verbose
 
-# Live event stream (new in v2.0.36) — SSE: scan progress, ready, per-write head
+# Live event stream (new in v2.2.31) — SSE: scan progress, ready, per-write head
 curl http://127.0.0.1:7070/events
 ```
 
-### Startup modes (v2.0.36)
+### Startup modes (v2.2.31)
 
 - **Warm start** — every restart after the first open reads the `MANIFEST` file and restores `seq` + Merkle `head` in **O(1)**. No scan, no replay, independent of dataset size. Boots in milliseconds.
 - **Cold start** — first open of an existing dataset spawns the integrity scan in a background thread *and accepts connections immediately*. Reads serve instantly from the content-addressed DAG; writes return `HTTP 503 startup in progress` until the `startup_ready` gate flips. Progress (objects, rate, ETA) streams over `GET /events`.
@@ -237,7 +237,7 @@ curl http://127.0.0.1:7070/events
 | Variable | Default | Description |
 |---|---|---|
 | `NEDBD_DAG` | `0` | Set `1` to launch the v2 DAG engine (`nedbd-v2`). Same as `--dag`. |
-| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.0.36** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
+| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.2.31** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
 | `NEDBD_PORT` | `7070` | HTTP bind port. |
 | `NEDBD_TOKEN` | unset | Optional bearer token; required on every `/v1/*` request when set. |
 | `NEDB_TMK` | unset | 32-byte hex AES-256-GCM at-rest encryption key. |
@@ -300,7 +300,7 @@ db.query('FROM policy AS OF 200 VALID AS OF "2024-02-15"')
 
 ## Performance
 
-**v2 DAG Rust server (v2.0.36, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
+**v2 DAG Rust server (v2.2.31, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
 
 | Operation | Throughput | p50 | p99 |
 |---|---|---|---|

{nedb_engine-2.2.28 → nedb_engine-2.2.31}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nedb-engine"
-version = "2.2.28"
+version = "2.2.31"
 description = "NEDB — a versioned, self-compressing, time-traveling embedded database (replay-protected, idempotent, relational, searchable) with durable AOF persistence and a server daemon (nedbd)."
 readme = "README.md"
 requires-python = ">=3.8"

{nedb_engine-2.2.28 → nedb_engine-2.2.31}/python/nedb/__init__.py

@@ -38,21 +38,35 @@ except ImportError:  # pure-Python install (sdist / unsupported platform)
     # informative error instead of a bare ImportError with no guidance.
     import types as _types, sys as _sys
 
+    import sys as _sys_tmp, os as _os_tmp
+    _is_msys2 = bool(_os_tmp.environ.get("MSYSTEM")) or "mingw" in _sys_tmp.executable.lower()
+    del _sys_tmp, _os_tmp
+
     class _NativeStub(_types.ModuleType):
-        _MSG = (
+        # Primary fix: install the Rust crate → get the nedbd server → use HTTP mode.
+        # Secondary fix (CPython only): pip reinstall to get the platform wheel with _native embedded.
+        _MSG_MSYS2 = (
+            "\n\n"
+            "  nedb._native (embedded v2 DAG core) is not available on MSYS2/MinGW Python.\n\n"
+            "  To use NEDB v2 features, install the server binary and use HTTP mode:\n\n"
+            "    cargo install nedb-engine          # install nedbd v2 server\n"
+            "    nedbd --dag ./data                 # start DAG server\n"
+            "    NEDB_URL=http://localhost:7070 python3 your_script.py\n\n"
+            "  Run 'nedbd --doctor' for a full diagnosis.\n"
+        )
+        _MSG_OTHER = (
             "\n\n"
-            "  nedb._native is not available on this platform.\n\n"
-            "  The compiled Rust core ships with platform wheels (Linux x86_64,\n"
-            "  macOS arm64/x86_64, Windows x64 CPython).  It is NOT included in\n"
-            "  the universal wheel installed on MSYS2/MinGW Python.\n\n"
-            "  Options:\n"
-            "    1. Use the HTTP server instead (works on any platform):\n"
-            "         nedbd --dag ./data                              # start DAG server\n"
-            "         NEDB_URL=http://localhost:7070 python3 script.py\n\n"
-            "    2. Re-install on a platform that has a native wheel:\n"
-            "         pip install --force-reinstall --no-cache-dir nedb-engine\n\n"
-            "    3. Run 'nedbd --doctor' for a full diagnosis.\n"
+            "  nedb._native (embedded v2 DAG core) is not available.\n"
+            "  You have the universal wheel — reinstall to get the platform wheel:\n\n"
+            "    pip install --force-reinstall --no-cache-dir nedb-engine\n\n"
+            "  Or install the server binary and use HTTP mode (works everywhere):\n\n"
+            "    cargo install nedb-engine          # install nedbd v2 server\n"
+            "    nedbd --dag ./data                 # start DAG server\n"
+            "    NEDB_URL=http://localhost:7070 python3 your_script.py\n\n"
+            "  Run 'nedbd --doctor' for a full diagnosis.\n"
         )
+        _MSG = _MSG_MSYS2 if _is_msys2 else _MSG_OTHER
+
         def __getattr__(self, name: str):
             raise ImportError(f"nedb._native.{name} is not available.{self._MSG}")
 
@@ -73,4 +87,4 @@ __all__ = [
     "wrap_redis", "WrappedRedis",
     "_native", "__has_native__",
 ]
-__version__ = "2.2.28"
+__version__ = "2.2.31"

{nedb_engine-2.2.28 → nedb_engine-2.2.31}/python/nedb/server.py

@@ -676,7 +676,7 @@ def _run_doctor() -> None:  # noqa: C901
         step += 1
         if has_cargo:
             _cmd("install from crates.io (recommended)",
-                 "cargo install nedb-core-v2",
+                 "cargo install nedb-engine",
                  f"binary → {os.path.join(_cargo_bin, 'nedbd')}")
             print()
             _cmd("OR reinstall pip wheel (also bundles the binary)",
@@ -810,7 +810,7 @@ def main() -> None:
             print("", file=_sys.stderr)
             print("  Quick fixes:", file=_sys.stderr)
             print("    pip install --force-reinstall --no-cache-dir nedb-engine  # re-install with binary", file=_sys.stderr)
-            print("    cargo install nedb-core-v2                                # build from source (any platform)", file=_sys.stderr)
+            print("    cargo install nedb-engine                                # build from source (any platform)", file=_sys.stderr)
             print("", file=_sys.stderr)
             _sys.exit(1)
         # Rust binary: nedbd-v2 [data_dir]
@@ -861,6 +861,30 @@ def main() -> None:
     print(BANNER)
     level_label = {0: "errors-only", 1: "requests", 2: "deploy", 3: "verbose"}.get(_log_level, str(_log_level))
     print(f"  nedbd {__version__} — http://{host}:{port}  data={os.path.abspath(data)}  auth={auth}  log={level_label}")
+
+    # ── v2 DAG health notice ──────────────────────────────────────────────────
+    # Check once at startup whether the v2 binary and _native extension are available.
+    # Print a single actionable line if either is missing — non-blocking, no exit.
+    _has_native = False
+    try:
+        from nedb import __has_native__ as _has_native  # type: ignore[attr-defined]
+    except Exception:
+        pass
+    _dag_bin_available = shutil.which("nedbd-v2") or shutil.which("nedbd_v2") or \
+        any(os.path.isfile(os.path.join(os.path.dirname(os.path.abspath(__file__)), n))
+            for n in ["nedbd-v2", "nedbd-v2.exe", "nedbd_v2", "nedbd_v2.exe"])
+    if not _has_native or not _dag_bin_available:
+        print()
+    if not _dag_bin_available:
+        print("  ⚡ v2 DAG engine not found — for content-addressed, instant-cold-start mode:")
+        print("       cargo install nedb-engine   →   nedbd --dag ./data")
+    if not _has_native:
+        print("  ⚡ nedb._native not available — embedded v2 API requires the platform wheel")
+        print("       pip install --force-reinstall --no-cache-dir nedb-engine")
+        print("       OR use HTTP mode: NEDB_URL=http://localhost:7070 python3 your_script.py")
+    if not _has_native or not _dag_bin_available:
+        print("  ℹ  Run 'nedbd --doctor' for a full diagnosis and exact fix commands.")
+        print()
     # Eagerly open all known databases so backfill-encrypt (if needed) runs
     # immediately and is visible in the boot log, not hidden on first request.
     names = manager.names()

nedb_engine-2.2.31/rust/nedb-v2/README.md

@@ -0,0 +1,179 @@
+# nedb-engine
+
+**NEDB v2 — content-addressed DAG storage engine with NQL and HTTP server**
+
+[![crates.io](https://img.shields.io/crates/v/nedb-engine?color=f97316)](https://crates.io/crates/nedb-engine)
+[![License: BUSL-1.1](https://img.shields.io/badge/license-BUSL--1.1-blue)](https://github.com/Eth-Interchained/nedb/blob/master/LICENSE)
+[![GitHub](https://img.shields.io/badge/github-Eth--Interchained%2Fnedb-8da0cb)](https://github.com/Eth-Interchained/nedb)
+
+This crate ships the **`nedbd`** binary — the NEDB v2 DAG HTTP server. Install it, point it at a data directory, and any language can speak to it over HTTP/JSON.
+
+```bash
+cargo install nedb-engine
+nedbd ./data              # AOF engine (pure Rust, v1-compatible)
+nedbd --dag ./data        # DAG engine (v2, content-addressed, recommended)
+```
+
+---
+
+## What is NEDB v2?
+
+NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**:
+
+- Every document version is an **immutable, BLAKE2b-hashed object**. Nothing is ever overwritten.
+- Every write produces a new **chain head** — a BLAKE2b commitment over the entire database history.
+- **Time-travel**: read any document `AS OF seq N` to see exactly what it contained at that point.
+- **Causal provenance**: documents link to their causal parents via `caused_by` hashes. `TRACE caused_by` walks the full causal graph backward.
+- **TRAVERSE**: named graph relations via `__links__`. `FROM person WHERE _id = "robert" TRAVERSE parent_of` returns linked nodes.
+- **O(1) warm start**: a `MANIFEST` file stores `seq` + Merkle head so restarts never re-scan the entire object store.
+- **Instant cold start**: the daemon accepts connections immediately; background scan loads objects incrementally.
+- **AES-256-GCM at rest**: optional symmetric encryption with a double-envelope key structure (TMK wraps DEK).
+
+---
+
+## Install
+
+```bash
+cargo install nedb-engine
+```
+
+The `nedbd` binary lands in `~/.cargo/bin/`. Make sure that's on your `PATH`.
+
+To verify:
+
+```bash
+nedbd --doctor      # diagnose your NEDB environment
+```
+
+---
+
+## Usage
+
+```
+nedbd [OPTIONS] [data_dir]
+```
+
+| Argument | Default | Description |
+|---|---|---|
+| `data_dir` | `./nedb-data` | Directory for database files |
+| `--dag` | off | Use the v2 content-addressed DAG engine |
+| `--doctor` | — | Diagnose environment, print fix commands |
+
+### Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `NEDBD_HOST` | `127.0.0.1` | Bind address |
+| `NEDBD_PORT` | `7070` | HTTP port |
+| `NEDBD_TOKEN` | — | Bearer token for auth (optional) |
+| `NEDB_TMK` | — | 64-char hex master key for AES-256-GCM encryption at rest |
+| `NEDBD_MEMORY` | — | `1` = pure in-memory mode (no disk I/O) |
+| `NEDBD_DAG` | — | `1` = same as `--dag` flag |
+
+---
+
+## HTTP API
+
+All endpoints return JSON. Auth: `Authorization: Bearer <token>` if `NEDBD_TOKEN` is set.
+
+```
+GET    /health
+GET    /v1/databases
+POST   /v1/databases                    {name, init?}
+GET    /v1/databases/<name>
+DELETE /v1/databases/<name>
+POST   /v1/databases/<name>/put         {coll, id, doc, caused_by?}
+POST   /v1/databases/<name>/query       {nql}
+POST   /v1/databases/<name>/link        {frm, rel, to}
+POST   /v1/databases/<name>/neighbors   {node, rel}
+GET    /v1/databases/<name>/verify
+POST   /v1/databases/<name>/checkpoint
+```
+
+---
+
+## NQL — NEDB Query Language
+
+```sql
+-- Basic queries
+FROM person LIMIT 10
+FROM driver WHERE status = "active"
+FROM driver WHERE rating >= 4.5 ORDER BY rating DESC
+
+-- Time-travel
+FROM will WHERE _id = "evans_will_2019" AS OF 5
+
+-- Causal trace (walks caused_by links backward)
+FROM event WHERE _id = "probate_filing" TRACE caused_by
+
+-- Graph traversal
+FROM person WHERE _id = "robert" TRAVERSE parent_of
+```
+
+---
+
+## Example: The Will — causal DAG in action
+
+```python
+import json, os, urllib.request
+
+def put(db_url, coll, id_, doc):
+    body = json.dumps({"coll": coll, "id": id_, "doc": doc}).encode()
+    req = urllib.request.Request(f"{db_url}/put", body,
+          {"Content-Type": "application/json"}, method="POST")
+    return json.loads(urllib.request.urlopen(req).read())["doc"]
+
+BASE = "http://localhost:7070/v1/databases/will"
+
+# Robert writes his will
+robert = put(BASE, "person", "robert", {"name": "Robert Evans", "role": "testator"})
+will_v1 = put(BASE, "will", "evans_will", {
+    "house": "mark", "business": "lisa",
+    "caused_by": [robert["_hash"]],   # causal link to testator record
+})
+
+# Amendment — chains off v1
+will_v2 = put(BASE, "will", "evans_will", {
+    "house": "mark", "business": "lisa", "vintage_car": "mark",
+    "caused_by": [will_v1["_hash"]],
+})
+
+# TRACE proves the amendment links back to the original
+query = json.dumps({"nql": 'FROM will WHERE _id = "evans_will" TRACE caused_by'}).encode()
+req = urllib.request.Request(f"{BASE}/query", query,
+      {"Content-Type": "application/json"}, method="POST")
+trace = json.loads(urllib.request.urlopen(req).read())["rows"]
+# → both versions + Robert's testator record, in causal order
+```
+
+---
+
+## Python companion
+
+The `nedb-engine` PyPI package ships the same server binary bundled in the wheel, plus:
+- Pure-Python AOF engine (`NEDB` class)
+- Embedded v2 DAG API (`nedb._native.NedbCore`) on supported platforms
+- `nedbd` console script
+
+```bash
+pip install nedb-engine
+
+# Use embedded API (Linux/macOS/Windows CPython)
+python3 -c "from nedb._native import NedbCore; db = NedbCore(); ..."
+
+# Use HTTP mode (any platform, including MSYS2/MinGW)
+NEDB_URL=http://localhost:7070 python3 your_script.py
+
+# Diagnose
+nedbd --doctor
+```
+
+---
+
+## License
+
+[BUSL-1.1](https://github.com/Eth-Interchained/nedb/blob/master/LICENSE) — Business Source License. Free for development and evaluation; production use requires a commercial licence from INTERCHAINED, LLC.
+
+---
+
+*Built by [INTERCHAINED, LLC](https://interchained.org) × Claude Sonnet 4.6*