Skip to main content

Crate khive_runtime

Crate khive_runtime 

Source
Expand description

khive-runtime: composable Service API used by daemon, MCP server, and CLI.

Wraps StorageBackend + query compilation into a single Rust API.

§Quick start

use khive_runtime::{KhiveRuntime, RuntimeConfig};

// In-memory for tests:
let rt = KhiveRuntime::memory()?;

// Default (production): reads ~/.khive/khive-graph.db
let rt = KhiveRuntime::new(RuntimeConfig::default())?;

// Create an entity:
let entity = rt.create_entity(None, "concept", "LoRA", None, None, vec![]).await?;

// Link two entities (EdgeRelation is the typed relation):
let edge = rt.link(None, entity.id, other_id, EdgeRelation::Extends, 1.0).await?;

Re-exports§

pub use curation::EdgeListFilter;
pub use curation::EntityPatch;
pub use curation::MergeStrategy;
pub use curation::MergeSummary;
pub use error::RuntimeError;
pub use error::RuntimeResult;
pub use fusion::FusionStrategy;
pub use graph_traversal::PathNode;
pub use graph_traversal::TraversalOptions;
pub use pack::PackRuntime;
pub use pack::VerbRegistry;
pub use pack::VerbRegistryBuilder;
pub use portability::ImportSummary;
pub use portability::KgArchive;
pub use retrieval::SearchHit;
pub use retrieval::SearchSource;
pub use runtime::KhiveRuntime;
pub use runtime::RuntimeConfig;

Modules§

curation
Curation operations: entity update/merge and edge-list filter type.
error
Runtime error types.
fusion
Fusion strategies for combining ranked result lists.
graph_traversal
operations
High-level operations composing storage capabilities into user-facing verbs.
pack
Pack runtime trait and verb registry (ADR-025 step 2).
portability
KG export / import — portable JSON archive for namespace-scoped knowledge graphs.
retrieval
Retrieval operations: local embedding generation and hybrid search with RRF fusion.
runtime
KhiveRuntime — composable handle to all storage capabilities.