Kweb Storage
kweb 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 directory is self-contained: copy it into an empty repository and run:
After version 0.1.0 is published, applications can use it as an ordinary
registry dependency:
[]
= "=0.1.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 = "0.1" 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, migration behavior, compatibility guarantees, and deliberate limitations. Maintainers should follow PUBLISHING.md when releasing a new version.