leankg 0.19.0

Lightweight Knowledge Graph for AI-Assisted Development
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
56
57
58
59
60
61

//! Optimized Local-First Vector Graph Engine (PRD ยง5.14 / FR-VE-*).
//!
//! Three-tier storage behind a static enum dispatch factory:
//! - Tier 1: graph topology (RocksDB Local / TiKV Cloud)
//! - Tier 2: SQ8/INT8 vectors fully in RAM
//! - Tier 3: flat binary FP32 + source payload
//!
//! Cozo `::hnsw` remains the shipped default until FR-VE-GATE. Select this
//! engine with `LEANKG_VECTOR_ENGINE=local|cloud`.

pub mod ab;
pub mod bench;
pub mod dual_write;
pub mod engine;
pub mod gate;
pub mod gc;
pub mod hnsw;
pub mod memory;
pub mod recovery;
pub mod simd;
pub mod threads;
pub mod tier1;
pub mod tier2;
pub mod tier3;

pub use ab::{
    evaluate_default_suite, load_ab_result_from_env, run_ab_suite, simulate_task, AbFloors,
    AbResult, AbSuiteReport, AbTaskOutcome, MIN_AB_TASKS,
};
pub use bench::{
    bench_query_p95, io_reduction_vs_mmap, oom_plan_within_cap, recall_sq8_vs_fp32,
    synth_sq8_cache, QueryBenchResult, TARGET_IO_REDUCTION, TARGET_P95_MS, TARGET_RECALL,
};
pub use dual_write::{DualWriteEngine, WriteInput};
pub use engine::{
    CloudEngine, EngineKind, LocalEngine, VectorEngine, VectorEngineError, VectorEngineFactory,
    VectorStorage, DEFAULT_VECTOR_DIM, ENV_VECTOR_ENGINE,
};
pub use gate::{evaluate_gate_smoke, GateReport};
pub use gc::{compact_shadow, fragmentation_ratio, maybe_gc, FRAGMENTATION_TRIGGER};
pub use hnsw::{
    brute_force_topk, recall_at_k, select_neighbors_heuristic, HnswParams, DEFAULT_EF_CONSTRUCTION,
    DEFAULT_EF_SEARCH, DEFAULT_M, M_MAX, M_MIN,
};
pub use memory::{
    auto_tune_block_cache, available_memory_bytes, plan_block_cache, plan_under_2gb_cgroup,
    MemoryPlan, LOCAL_SURVIVAL_CAP_BYTES,
};
pub use recovery::{assert_no_dangling_pointers, recover_and_list};
pub use simd::{detect_simd, dot_i8, dot_i8_auto, SimdKind};
pub use threads::{auto_tune_threads, build_rayon_pool, plan_threads, ThreadPlan};
pub use tier1::{
    BlockTableFactory, HnswAdjacency, RocksCompression, RocksDbLocalOptions, TopologyNode,
    TopologyStore,
};
pub use tier2::{dot_i8_scalar, quantize_sq8, Sq8Cache};
pub use tier3::{FlatPayloadFile, PayloadRecord, RECORD_HEADER_SIZE};

mod dw_test;
mod factory_test;
mod simd_test;