Archived
Will Anderson
2454c83e82
- vector.rs: replace flat O(n) scan with instant-distance HNSW for stores >= 100 nodes; flat scan retained as fallback for small graphs; dirty-flag persistence in sled triggers index rebuild only when nodes are added - consolidation.rs: Episodic → Semantic promotion based on activation_count and salience_floor thresholds; global decay pass after each cycle; ConsolidationConfig + ConsolidationReport types; 8 tests - migration.rs: reads Neuron SQLite (memory_nodes, knowledge_entries, graph_edges) and writes to Engram sled; placeholder unit-vector embeddings with TODO for ONNX; 5 tests including full in-memory DB roundtrip - crates/engram-migrate: CLI binary (engram-migrate --sqlite / --output) - crates/engram-jni: JNI cdylib exposing open/close/put_node/get_node/ activate/search_embedding/touch/decay/node_count/edge_count via Java_ai_neuron_engram_EngramDb_* entry points; 6 tests - bindings/kotlin: EngramDb.kt (AutoCloseable JNI wrapper), EngramNode, EngramEdge, ActivatedNode, EngramTypes; build.gradle.kts; settings.gradle.kts - bindings/typescript: engram-wasm crate (wasm-bindgen, serde-wasm-bindgen); WasmEngramDb with in-memory backend (sled not available in WASM); TypeScript wrapper (index.ts, types.ts, package.json, tsconfig.json) - bindings/go: engram.go (CGo wrapper), engram.h (C header), engram_test.go (4 tests covering open/close/put_node/get_node/node_count/decay); go.mod - engram-core: wasm feature gate for in-memory backend; mem_storage.rs; activation.activate_mem for WASM path; Node::with_id helper; salience.rs doctest fixed (text block) - examples/basic.rs: consolidation section added - examples/migrate.rs: migration API demonstration Build: cargo build --workspace -- zero warnings, zero errors Tests: 38 pass (25 engram-core + 7 engram-ffi + 6 engram-jni)
54 lines
1.6 KiB
Rust
54 lines
1.6 KiB
Rust
/// Engram — a local-first memory substrate for accumulating intelligence.
|
|
///
|
|
/// An engram is the physical trace of a memory in the brain — the actual encoded
|
|
/// substrate. This crate provides the storage and retrieval primitives that model
|
|
/// how biological memory works: not as query-and-retrieve, but as
|
|
/// activation-and-propagation.
|
|
///
|
|
/// # Quick Start
|
|
///
|
|
/// ```rust,no_run
|
|
/// use engram_core::{EngramDb, Node, Edge, NodeType, MemoryTier, RelationType};
|
|
/// use std::path::Path;
|
|
///
|
|
/// let db = EngramDb::open(Path::new("/tmp/my-engram")).unwrap();
|
|
///
|
|
/// let node = Node::new(
|
|
/// NodeType::Memory,
|
|
/// vec![0.9, 0.1, 0.3, 0.7],
|
|
/// b"The spreading activation model of memory".to_vec(),
|
|
/// MemoryTier::Semantic,
|
|
/// 0.9,
|
|
/// );
|
|
/// let id = db.put_node(node).unwrap();
|
|
///
|
|
/// // Retrieve by spreading activation from a seed
|
|
/// let results = db.activate(&[id], &[0.8, 0.2, 0.3, 0.6], 3, 10).unwrap();
|
|
/// for r in results {
|
|
/// println!("{:.4} hops={} {:?}", r.activation_strength, r.hops,
|
|
/// String::from_utf8_lossy(&r.node.content));
|
|
/// }
|
|
/// ```
|
|
pub mod activation;
|
|
pub mod consolidation;
|
|
pub mod db;
|
|
pub mod error;
|
|
pub mod graph;
|
|
pub mod salience;
|
|
#[cfg(not(feature = "wasm"))]
|
|
pub mod storage;
|
|
#[cfg(feature = "wasm")]
|
|
pub mod mem_storage;
|
|
pub mod types;
|
|
pub mod vector;
|
|
#[cfg(feature = "migration")]
|
|
pub mod migration;
|
|
|
|
// Re-export the public surface
|
|
pub use db::EngramDb;
|
|
pub use error::{EngramError, EngramResult};
|
|
pub use types::{
|
|
ActivatedNode, Edge, MemoryTier, Node, NodeType, RelationType, ScoredNode, now_ms,
|
|
};
|
|
pub use consolidation::{ConsolidationConfig, ConsolidationReport};
|