wm_memory/
lib.rs

1//! `WhiteMagic` v4 Memory — LMDB + Tantivy + `LanceDB`
2//!
3//! Replaces the v2 `SQLite` + FTS5 + Python HNSW stack with:
4//! - LMDB for key-value storage (mmap'd, zero-copy reads)
5//! - Tantivy for full-text search (Rust, Lucene-class performance)
6//! - `LanceDB` for vector similarity search (disk-based HNSW)
7
8#![forbid(unsafe_code)]
9
10pub mod associations;
11pub mod attestation;
12mod codec;
13pub mod cold_storage;
14pub mod consistency;
15pub mod conversational;
16pub mod credentials;
17pub mod embedder;
18pub mod enrichment;
19pub mod envelope;
20pub mod episodic;
21pub mod episodic_keys;
22pub mod galaxy_registry;
23pub mod indexes;
24pub mod lifecycle;
25pub mod mandala;
26pub mod memory;
27pub mod predictive_cache;
28pub mod query_planner;
29pub mod recall;
30pub mod recall_conformal;
31pub mod recovery;
32pub mod redact;
33pub mod reindex;
34pub mod release_manifest;
35pub mod revision;
36pub mod search;
37pub mod semantic;
38pub mod store;
39pub mod typology;
40pub mod validator;
41pub mod vector;
42
43pub use associations::{Association, AssociationStore, LinkType};
44pub use attestation::{
45    ATTESTATION_DOMAIN, ATTESTATION_KEY_ENV, ATTESTATIONS_DB, AttestationReport, RecordAttestation,
46    anchor_leaf_input, attestation_key, attestation_payload, attestation_prefix, merkle_root_hex,
47    sha256_hex, sign_attestation, verify_attestation,
48};
49pub use cold_storage::{
50    ColdQuery, ColdRecord, ColdRecordSummary, CompressionCodec, OuterRimFactors, PhagicConfig,
51    PhagicDigestReport, PhagicDigester, calculate_outer_rim_distance, compress_memory,
52    decompress_memory,
53};
54pub use consistency::{
55    CoherenceReceipt, CoherenceSnapshot, ConflictReport, ConsistencyError, CrossMemoryConsistency,
56    CrossMemoryConsistencyManager, Resolution, VectorClock, WriteOp,
57};
58pub use conversational::{
59    ConversationalConfig, ConversationalResult, ConversationalSearch, QueryClassification,
60    SearchMetrics,
61};
62pub use credentials::{
63    ADVICE as CREDENTIAL_ADVICE, credential_shaped_content, redact_credential_content,
64};
65#[cfg(feature = "onnx")]
66pub use embedder::OrtEmbedder;
67pub use embedder::{Embedder, EmbedderConfig, HttpEmbedder, StubEmbedder, create_embedder};
68pub use enrichment::VocabularyEnrichment;
69pub use episodic::{EpisodicSearchResult, EpisodicStore};
70pub use episodic_keys::{
71    AdaptiveAliases, EpisodicKey, KeyCategory, entity_key_terms, extract_episodic_keys,
72    key_index_terms, key_index_terms_with_aliases,
73};
74pub use galaxy_registry::{GalaxyMetadata, GalaxyRegistry};
75pub use lifecycle::{ConsolidationResult, ForgettingResult, Lifecycle, LifecycleConfig};
76pub use mandala::{Compartment, CompartmentConfig, MandalaLevel, MandalaManager};
77pub use memory::{
78    Memory, MemoryId, MemoryMetadata, MemoryType, Tier, content_hash, decode_embedding,
79    encode_embedding, trust_weighted_score,
80};
81pub use predictive_cache::{CacheStats, PredictiveCache};
82pub use query_planner::{QueryClass, QueryPlan};
83pub use recall::{RecallConfig, RecallEngine, RecallResult};
84pub use recovery::{
85    GalaxyIntegrity, IntegrityReport, QuarantineEntry, RecoveryStrategy, RepairReport,
86    check_integrity, grow_map_size, open_with_recovery, repair,
87};
88pub use reindex::{
89    ConsistencyReport, ContentRepairReport, DriftClassification, GalaxyConsistency,
90    GalaxyContentRepairStats, GalaxyDriftClass, GalaxyRebuildStats, IndexRebuildReport,
91    check_consistency, classify_drift, heal_index_drift, rebuild_index, repair_content,
92};
93pub use release_manifest::{
94    KEY_LINEAGE_MESH_ERA, RELEASE_MANIFEST_DOMAIN, ReleaseArtifact, ReleaseManifest,
95    release_payload, sign_release, verify_release,
96};
97pub use revision::{MemoryRevision, RevisionActor, RevisionChainReport};
98pub use search::{
99    IndexHealth, MAX_INDEX_CONTENT_LEN, MIN_PRINTABLE_RATIO, STOPWORDS, SearchEngine,
100    SearchOptions, SearchResult, sanitize_content_for_index, sanitize_tantivy_query, scrub_text,
101    strip_stopwords,
102};
103pub use semantic::{SemanticEncoder, SemanticScores};
104pub use store::MemoryQuery;
105pub use store::MemoryStore;
106pub use validator::{MemoryValidator, ValidationVerdict, ValidatorConfig, detect_injection};
107pub use vector::{VectorSearchEngine, VectorSearchResult, VectorStore};
108
109#[cfg(feature = "lancedb")]
110pub mod lance_vector;
111#[cfg(feature = "lancedb")]
112pub use lance_vector::LanceVectorStore;
wm_memory/lib.rs

wm_memory/
lib.rs
