Crate aonyx_memory 

aonyx-memory

The memory palace — Aonyx Agent’s differentiator vs flat-file agent memories.

Subsystems (V1 target)

• kg — Knowledge Graph with temporal validity windows.
• diary — Append-only narrative log per project.
• hybrid — BM25 + vectors + RRF fusion with temporal boost.
• splitter — Tree-sitter AST-aware code chunking.
• cross_link — Inter-project semantic linking via centroid cosine.
• time_machine — as_of queries over the full store.

Storage layout

• ~/.aonyx/sessions.db — cross-project session history (FTS5).
• ./.aonyx/palace.db — per-project KG, diary, chunks, embeddings.

The current crate ships scaffolded module skeletons and an in-memory InMemoryStore suitable for tests; production backends land iteratively.

Re-exports

pub use chunks::Chunk;

pub use chunks::ChunkId;

pub use chunks::ChunksStore;

pub use chunks::ScoredChunk;

pub use chunks::SqliteChunksStore;

pub use diary::DiaryEntry;

pub use diary::DiaryEntryId;

pub use diary::DiaryStore;

pub use diary::SqliteDiaryStore;

pub use kg::Direction;

pub use kg::Entity;

pub use kg::EntityId;

pub use kg::KgStore;

pub use kg::Relation;

pub use kg::RelationId;

pub use kg::SqliteKgStore;

pub use palace::Palace;

pub use sessions::SessionId;

pub use sessions::SessionRecord;

pub use sessions::SessionStore;

pub use sessions::SqliteSessionStore;

Modules

chunks

Searchable chunks store backed by SQLite FTS5.

cross_link

Inter-project semantic linking via centroid cosine.

diary

Append-only narrative log per project.

hybrid

Hybrid search: BM25 + vectors + RRF fusion with temporal boost.

kg

Knowledge graph: entities + relations with temporal validity windows.

palace

Unified memory palace — composes SqliteKgStore + SqliteDiaryStore behind a single MemoryStore facade.

sessions

Cross-run session persistence.

splitter

Tree-sitter AST-aware code chunking.

time_machine

as_of queries — reconstruct the memory palace as it was at a given moment.

Structs

InMemoryStore

A thread-safe in-memory store. Loses everything on drop.