git-vdb 0.2.0

An embedded vector database backed by immutable Git trees
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# Changelog

All notable changes to `git-vdb` are documented here. The project follows
[Semantic Versioning](https://semver.org/). Crate API compatibility and persisted
format compatibility are separate promises: a crate release may add APIs while
continuing to read and write the same canonical format version.

## [Unreleased]

## [0.2.0] - 2026-07-23

### Changed

- made deterministic sharded IVF-flat format version 2 the sole default for new
  roots, substantially reducing build, approximate-query, mutation, and storage
  costs while improving recall and filtered result completeness;
- retained read, validation, and mutation compatibility for canonical
  format-version-1 roots;
- replaced v1-only LSH creation flags with format-neutral query defaults in the
  CLI, exposed each root's persisted format in collection and snapshot info,
  and published the normative format-version-2 specification in rustdoc;
- reused the canonical codebook and unchanged assignments for sample-stable
  replacement batches, cutting the measured 100,000-point 1% upsert p50 by
  59.9-64.2% across arm64 and x86_64 without changing its resulting root;
- replaced per-candidate tree lookups with a compact shard-row search view,
  cutting the paired 100,000-point warm approximate-query p50 by 17.8-45.1%
  across x86_64 and arm64 with identical ordered results, scores, and work
  statistics.

## [0.1.1] - 2026-07-22

### Changed

- streamlined the README around installation, quick starts, the storage model,
  and links to the complete rustdoc and specifications;
- updated the benchmark-only PyArrow dependency from 21.0.0 to 23.0.1.

## [0.1.0] - 2026-07-22

Initial public release.

### Added

- deterministic immutable snapshot roots stored as canonical Git trees;
- named collections backed by commits and compare-and-swap refs;
- exact cosine search and deterministic LSH approximate search;
- typed IDs, JSON payload filters, point retrieval, counts, and deletion;
- historical reads, history, diffs, validation, materialization, and import;
- ref-free `SnapshotEngine` and named `Database` / `Collection` APIs;
- JSON CLI, formal rustdoc API documentation, and format-version-1 specification.

[Unreleased]: https://github.com/nishu-builder/git-vdb/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/nishu-builder/git-vdb/compare/v0.1.1...v0.2.0
[0.1.1]: https://github.com/nishu-builder/git-vdb/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/nishu-builder/git-vdb/releases/tag/v0.1.0