Roadmap to 1.0

TaiDB 1.0.0 should mean a stable embedded Rust database that users can depend on for local-first and AI-native applications.

The full roadmap is maintained in the repository at ROADMAP.md. This page summarizes the release gates.

0.2 Storage format hardening

• Add file magic, format version, and feature flags.
• Document the record format.
• Add migration tests for released formats.
• Define crash recovery guarantees.

0.3 API stability

• Review public Rust exports.
• Stabilize error variants.
• Add option builders.
• Add cursor scans for prefix and range iteration.
• Add examples for metadata stores, embedding caches, and local document indexes.
• Add compression benchmark output for ratio, space savings, write speed, read speed, and verify speed.
• Add easy CLI bridge examples for common non-Rust languages.

0.4 Durability and concurrency

Status: implemented in 0.4.0.

• Defined single-writer and shared read-only process guarantees.
• Hardened explicit read-only opens for library and CLI users.
• Tested shared readers, locked second writers, read-only write rejection, and snapshot consistency after later writes and compaction.
• Documented flush and sync_data() behavior per durability mode.

0.5 Compaction and space management

• Make compaction interruption-safe.
• Add compaction metrics and thresholds.
• Preserve encryption and compression settings during rewrite operations.

0.6 Vector search

• Keep exact cosine search as the correctness baseline.
• Add approximate indexing only with benchmark evidence.
• Document dimensionality and memory tradeoffs.

0.7 Node and other languages

• Keep Rust as the primary supported API.
• Keep Node quick start through the CLI bridge.
• Add native package only if maintenance cost is justified.
• Keep FFI examples source-only and easy to inspect.

0.8 Benchmarking

• Provide reproducible benchmark profiles.
• Record hardware and settings.
• Avoid broad performance claims without public scripts.

0.9 Release candidate

• Freeze public API and storage format.
• Run compatibility tests.
• Audit docs, examples, CLI help, and crate metadata.
• Tag a release candidate and collect feedback.

1.0 release criteria

TaiDB can ship 1.0.0 when:

• public Rust API is SemVer-stable
• on-disk format has versioning and migration tests
• crash recovery is documented and tested
• durability modes are documented and tested
• compaction is interruption-safe
• README, docs, examples, and CLI help are accurate
• CI passes fmt, clippy, tests, release build, native FFI build, smoke test, and cargo audit
• no secrets, generated artifacts, benchmark databases, or local agent state are tracked by Git