agentmem 0.1.0

Local-first memory engine for AI coding agents
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

//! Core domain primitives and validation logic.
//!
//! This module contains the low-level building blocks that the rest of the
//! crate relies on:
//!
//! - hard limits that define safe operational boundaries
//! - validation rules for keys, namespaces, values, project names, and paths
//! - namespace helpers for prefix-aware key operations
//! - the in-memory map abstraction used by the store layer
//!
//! The intent is to keep these concerns centralised so that:
//!
//! - validation policy is not duplicated across the codebase
//! - limits remain explicit and reviewable
//! - typed wrappers in `types.rs` can delegate to a single source of truth
//! - future changes to the storage model remain controlled and auditable

pub mod limits;
pub mod map;
pub mod namespace;
pub mod validation;

/// Re-export of the in-memory map type used by the store layer.
///
/// Keeping this re-export here makes the internal dependency direction a little
/// cleaner for higher-level modules.
pub use self::map::MemoryMap;

/// Re-export of commonly used namespace helpers.
pub use self::namespace::{is_key_within_namespace, join_namespace_and_leaf, parent_namespace};

/// Re-export of selected validation entrypoints used widely across the crate.
///
/// These functions define the canonical rules for the crate's typed wrappers
/// and CLI input validation.
pub use self::validation::{
    validate_key, validate_key_leaf, validate_namespace, validate_project_name,
    validate_store_path, validate_value,
};