picovolt 2.0.0 → 2.3.0

package/PUBLIC-RELEASE.json

@@ -0,0 +1,35 @@
+{
+  "schema_version": 1,
+  "version": "2.3.0",
+  "distribution": "public-source-free",
+  "license_id": "LicenseRef-PicoVolt-Public-Source-1.1",
+  "license_file": "LICENSE",
+  "license_sha256": "fea338d875dfc9e115342e6d802742126b57ba1c5ebef7a54cde9cf26c1984ff",
+  "fee": {
+    "amount": 0,
+    "currency": "EUR"
+  },
+  "account_required": false,
+  "licensor": {
+    "legal_name": "BEYOND SOFTWARE S.R.L.",
+    "company_id": "40707869",
+    "country": "Romania",
+    "address": "Str. Fabricii nr. 11, ap. 16, Cluj-Napoca, Cluj, 400620, Romania",
+    "email": "contact@beyond-software.ro"
+  },
+  "covered_components": [
+    "New vector, retrieval and encryption modules introduced after 2.0.0",
+    "New retrieval and vault interfaces in CLI, C, WASM, Python, Go and JavaScript",
+    "New tests and documentation accompanying those proprietary additions",
+    "Named persistent retrieval catalog, binary storage and related interfaces/tests introduced for 2.3"
+  ],
+  "preserved_licenses": [
+    "Previously Apache-2.0 components and full-text implementation retain their existing notices",
+    "Third-party components retain their own licenses"
+  ],
+  "authorization": "Owner selected public source and free registry downloads under revised proprietary terms on 2026-09-12",
+  "independent_legal_review": false,
+  "independent_security_audit": false,
+  "candidate_authority": "Founder explicitly authorized merge, tag and public publication of PicoVolt 2.3.0 on 2026-09-21",
+  "publication_status": "authorized-for-publication"
+}

package/README.md

@@ -2,23 +2,69 @@
 
 [![CI](https://github.com/MiniJe/picovolt/actions/workflows/ci.yml/badge.svg)](https://github.com/MiniJe/picovolt/actions/workflows/ci.yml)
 [![crates.io](https://img.shields.io/crates/v/picovolt.svg)](https://crates.io/crates/picovolt)
-[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
-![Version: 2.0](https://img.shields.io/badge/version-2.0-blue.svg)
+[![License: Proprietary](https://img.shields.io/badge/license-Proprietary-blue.svg)](LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/MiniJe/picovolt?style=social)](https://github.com/MiniJe/picovolt)
 
-PicoVolt is an embedded database engine written in Rust. **2.0** provides
-concurrent snapshot readers, bounded writer scheduling, and an incremental
-durable commit log. Independent security review and external application trials
-have not been completed. See the [2.0 release ledger](docs/RELEASE_2_0.md)
-for qualification evidence and publication status.
+PicoVolt is an embedded SQL database with queryable history. **2.2.0** adds
+native encrypted snapshots and vaults, key/password rotation, verified encrypted
+backup/restore and hybrid full-text/vector retrieval. It builds on the snapshot
+readers, bounded writer scheduling and durable commit logs introduced in 2.0.
+
+The source and official packages are available without a license fee under the
+[PicoVolt Public-Source License 1.1](LICENSE). This proprietary license permits
+commercial application embedding and unchanged registry/mirror distribution;
+standalone competing database products require a separate agreement. This is
+source-available, not open source. Earlier Apache grants remain unchanged.
+No account, activation, telemetry or pre-download acceptance is required.
+
+Read [encrypted storage](docs/ENCRYPTION_2_2.md), [hybrid search](docs/HYBRID_2_2.md)
+and [release evidence](docs/RELEASE_2_2.md). Native vault encryption is not offered
+in WASM. Independent security/cryptographic review and external application
+trials have not been completed; automated verification is not such an audit.
 
 Start with the [2.0 guide for every maintained interface](docs/QUICKSTART_2_0.md)
 for atomic batches, persistence choices, log diagnostics and error recovery.
 The [standalone review prompt](docs/INDEPENDENT_REVIEW_PROMPT.md) defines an
 independent assessment and external trials deferred beyond the 2.0 release.
 
-If PicoVolt is useful to you, consider starring the repository on GitHub. It is
-the simplest way to help others discover the project.
+## 2.3 implementation branch: persistent retrieval
+
+This branch prepares **2.3.0**, adding optional named persistent BM25/full-text
+and exact vector indexes. DDL, current-snapshot filtered retrieval, hybrid,
+transactional maintenance, format-8 persistence and inspection are implemented.
+Historical/transformed queries preserve correctness through the legacy fallback.
+Open performs source verification; commits may rewrite affected index envelopes
+and retain older CAS generations. Read the [2.3 guide](docs/PERSISTENT_RETRIEVAL_2_3.md)
+and [qualification ledger](docs/RELEASE_2_3.md) before evaluating this candidate.
+
+This PR does not publish 2.3 packages. The published 2.2 quick start below is
+preserved rather than presenting an unavailable registry install as verified.
+
+## Quick start
+
+The 2.2.0 release is free to download and use within its [license](LICENSE).
+Historical 2.0 documentation below remains useful for unchanged APIs. See the
+[transition policy](legal/TRANSITION.md) for continuing Apache rights and support.
+
+```sh
+cargo add picovolt@2.2.0
+```
+
+```rust
+use picovolt::Database;
+
+fn main() -> Result<(), picovolt::PvError> {
+    let mut db = Database::open_memory();
+    db.query("CREATE TABLE notes (id, body)")?;
+    db.query("INSERT INTO notes VALUES (1, 'Hello, PicoVolt')")?;
+    println!("{:?}", db.query("SELECT * FROM notes")?);
+    Ok(())
+}
+```
+
+For other languages, see [Install and distribution](#install-and-distribution).
+
+## Storage model
 
 The engine decouples query logic from storage representation through a
 Virtualization Layer Engine (VLE) that shifts between two on-disk shapes:
@@ -37,7 +83,7 @@ MVCC-preserving columnar layout with packed decimal encoding.
 The engine is exercised by Rust unit and integration suites plus doctests
 and maintained-binding integration tests. CI also enforces formatting and
 warning-free Clippy builds on Linux and Windows. Shipped changes are tracked in
-[CHANGELOG.md](CHANGELOG.md), and the remaining work toward 2.0 is tracked in
+[CHANGELOG.md](CHANGELOG.md), and future work is tracked in
 [ROADMAP.md](ROADMAP.md).
 
 ### Module map
@@ -160,30 +206,30 @@ databases.
 Durability is selectable via `Database::set_durability` (`Fast` OS-cache default,
 or crash-safe `Sync` with fsync and an atomic manifest).
 
-Native Rust applications can begin adopting the 2.0 concurrency surface through
+Native Rust applications can use the 2.0 concurrency surface through
 `SharedDatabase`. It is a cloneable, bounded worker-thread coordinator with
 explicit read and write transaction handles, FIFO admission, cooperative
 cancellation, and rollback before failed or abandoned writes release the queue.
-The first slice serializes execution and preserves format v5; use clones of one
-coordinator rather than independently opening the same development workspace.
+Explicit readers execute against independent snapshots while one writer updates
+the workspace. Logged workspaces use format 7 with commit-sequence anchoring;
+use clones of one coordinator for a shared development workspace.
 See [Shared database concurrency](docs/CONCURRENCY.md) for the contract and
 current limits.
 
-Measured results and the methodology are in [BENCHMARKS.md](BENCHMARKS.md). In
-short, PicoVolt is a page-backed engine with O(1) filesystem appends (autocommit
-around 33k rows/s, linear), larger-than-RAM reads through a bounded buffer pool (a
-667-page dataset serves from a 16-page pool), ordered secondary indexes (point
-lookups roughly 6,100 times faster than a scan, plus range predicates), MVCC
-time-travel, opt-in crash-safe durability (`Durability::Sync`), and a fast
-compile-and-publish path (CAS dedup, cooperative columnar compression,
-memory-mappable single-file artifacts). Current limits include full-workspace
-transaction backups rather than an incremental WAL, adaptive index access within
-a left-deep equality-join plan rather than a general SQL planner, and no
-concurrent writers.
+Measured results and the methodology are in [BENCHMARKS.md](BENCHMARKS.md).
+These measurements describe specific workloads and versions, rather than a
+general throughput guarantee. PicoVolt supports bounded page-cache reads,
+ordered secondary indexes, MVCC time travel and single-file publication.
+Shared filesystem transactions use an incremental page journal; the legacy
+unlogged surface retains full rollback images. Current limits include snapshot
+copy costs, a focused SQL planner and a single writer. The [2.0 benchmark
+baseline](benchmarks/COMPETITORS_2_0_RC3.md) records candidate measurements and
+their limits; see [the concurrency contract](docs/CONCURRENCY.md) for current
+resource costs.
 
 ## Maintenance and migration
 
-Cold-page maintenance is explicit in 1.x so the host retains ownership of
+Cold-page maintenance is explicit so the host retains ownership of
 scheduling and threads:
 
 ```sh
@@ -213,7 +259,7 @@ See [Migration and compaction](docs/MIGRATION.md).
 | **Rust** (crates.io) | `cargo add picovolt` |
 | **JavaScript / npm** (WebAssembly, browser and Node) | `npm install picovolt` |
 | **Python** (native wheels) | `python -m pip install picovolt` |
-| **Go** (`database/sql` and direct API) | `go get github.com/MiniJe/picovolt/bindings/go/v2@v2.0.0`, then provide the matching native C ABI library described in [`bindings/go/`](bindings/go) |
+| **Go** (`database/sql` and direct API) | `go get github.com/MiniJe/picovolt/bindings/go/v2@v2.3.0`, then provide the matching native C ABI library described in [`bindings/go/`](bindings/go) |
 | **C** | Download the matching `picovolt-capi-*` bundle from the [latest release](https://github.com/MiniJe/picovolt/releases/latest), or run `cargo build --release --features capi` |
 | **In-memory** (native, no filesystem) | `Database::open_memory()`, export with `bake_to_bytes()` |
 
@@ -292,10 +338,12 @@ native modules built on the public API. Both are documented in
 
 ## License
 
-Licensed under the [Apache License, Version 2.0](LICENSE). Third-party
-dependencies are under MIT or Apache-2.0 licenses, and their notices apply to
-redistributions (see [`NOTICE`](NOTICE)).
+PicoVolt 2.3.0 is distributed under the [PicoVolt Proprietary Lifetime License](LICENSE)
+and the public-release authorization recorded in [legal/PUBLIC-RELEASE.json](legal/PUBLIC-RELEASE.json).
+Earlier Apache-2.0 components retain their existing grants; the original license
+is preserved [here](legal/APACHE-2.0-LEGACY.txt). Third-party licenses and notices
+continue to apply (see [`NOTICE`](NOTICE)).
 
 The optional [`compliance`](src/engine/compliance.rs) module is not a license
 requirement. It is an opt-in helper for applications that want to enforce their
-own usage policy. Apache-2.0 places no usage restrictions on PicoVolt itself.
+own usage policy. It does not implement license activation or telemetry.

package/browser.js

@@ -1,3 +1,4 @@
+// Modified for PicoVolt 2.1.0 retrieval, 2026-09-11. See legal/COMPONENT-SCOPE-2.1.md.
 // Durable browser helper backed by the Origin Private File System (OPFS).
 import { Db } from "./picovolt.js";
 
@@ -62,6 +63,11 @@ export class PersistentDb {
     return statement;
   }
 
+  retrieve(request) {
+    this._assertOpen();
+    return JSON.parse(this.db.retrieve(JSON.stringify(request)));
+  }
+
   executeMany(sql, rows) {
     this._assertOpen();
     return JSON.parse(this.db.executeMany(sql, rows)).mutated;