Kweb DB Core

kweb-db-core is a storage-only Rust library for a provenance-backed knowledge web in SQLite. It has no HTTP server, binary target, frontend assets, prompt policy, or user/root-role model. The Rust crate path is kweb_db_core.

This package continues the storage API previously packaged as kweb under a name that makes its database-core role explicit.

The directory is self-contained: copy it into an empty repository and run:

cargo test

After version 0.2.0 is published, applications can use it as an ordinary registry dependency:

[dependencies]
kweb-db-core = "=0.2.0"

The exact requirement is appropriate for an application that wants dependency updates to be explicit. Library authors can use a normal compatible requirement such as kweb-db-core = "0.2" when that better matches their release policy.

Applications open a database path with Kmap::open, create immutable provenance, and reuse the returned provenance ID in node creates and updates. Every create or update also requires a fresh random 16-byte IdempotencyId, which the caller must reuse for retries. Nodes expose ordered fixed and recent connection ID arrays; their caller owns all graph semantics and multi-node orchestration.

The application default is kweb.sqlite3 with a sibling kweb-provenance-artifacts/ directory. Large provenance payloads and attached media live there while SQLite retains their immutable metadata and links. The library reads externally stored provenance data transparently.

See Specification.md for the complete public contract, compatibility guarantees, and deliberate limitations.