lunaris-core 0.8.0

Core types, traits, and bi-temporal primitives for the Lunaris agent memory engine
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

//! lunaris-core — shared types, clock, errors, embedder trait, and storage abstraction.
#![deny(rust_2018_idioms, unreachable_pub)]
#![forbid(unsafe_code)]

// ADD task activation-ledger — persistent per-memory activation ledger
// (record shape + read-time recompute math). Lives here (not in a caller
// crate) per RC-1: shared data types belong in lunaris-core.
pub mod activation;
pub mod audit;
pub mod bitemporal;
// RFC 0007 §3.2 — per-provider circuit breaker (Closed → Open → HalfOpen).
// Consumed by the `FallbackExtractor` + `FallbackEmbedder` combinators
// in lunaris-extract / lunaris-embed; lives here because both downstream
// crates need the primitive and pulling either into the other would
// re-introduce a layering loop.
pub mod circuit_breaker;
pub mod embedder;
pub mod error;
pub mod hlc;
// F20 — repair JSON numbers that lost their integer-ness crossing the
// napi-rs boundary (every integer above u32::MAX arrives as a float).
pub mod json_repair;
// Wave 2.5B: storage-agnostic primitive KV key helpers (moved from lunaris-storage-moon).
pub mod keyspace;
pub mod primitives;
// W0.7 — the ONE catalogue naming the GGUF artifacts (no HTTP, no deps).
pub mod models;
// W0.7 — download+verify for the catalogue above; optional, pulls HTTP/TLS.
#[cfg(feature = "model-staging")]
pub mod model_staging;
// RFC 0001 — Scope newtype + ScopeError for multi-agent partition isolation.
pub mod retention;
pub mod scope;
pub mod snippet;
// Phase 23-01 — Scope derivation shared between lunaris-mcp and lunaris-hook.
pub mod scope_resolver;
pub mod storage;
// Task #28 — contextd store discovery, shared between lunaris-mcp and
// lunaris-hook (the other half of the bootstrap `scope_resolver` owns).
pub mod store_discovery;

pub use bitemporal::BiTemporal;
pub use circuit_breaker::{CircuitBreaker, CircuitConfig, CircuitState};
pub use embedder::{
    Embedder, FailingEmbedder, NOOP_DEFAULT_DIM, NoopEmbedder, StubEmbedder, det_vec,
};
pub use error::{
    ConsolError, ExtractError, LunarisError, RetrieveError, StorageError, Subsystem, ValidateError,
};
pub use hlc::{Hlc, HlcClock};
pub use primitives::{Chunk, Community, Entity, Episode, Fact, Relation};
// RFC 0001 — re-export Scope + ScopeError at the crate root so callers use
// `lunaris_core::Scope` / `lunaris::Scope` without path qualification.
pub use scope::{MemoryLevel, Scope, ScopeError, compose_levels};
pub use storage::{
    CypherDialect, CypherQuery, Filter, GraphDecay, GraphResult, HotKey, Key, KeywordHit,
    KeywordPort, ListError, Lsn, MAX_PAGE, NavigateHit, NavigateSpec, Page, QueueMsg, Row,
    RrfFusion, ScopePage, StorageCapabilities, StoragePort, VectorHit, WriteOp,
    sanitize_graph_ident, scan_page,
};