hyperi_rustlib/memory/mod.rs
1// Project: hyperi-rustlib
2// File: src/memory/mod.rs
3// Purpose: Memory management and OOM prevention
4// Language: Rust
5//
6// License: FSL-1.1-ALv2
7// Copyright: (c) 2026 HYPERI PTY LIMITED
8
9//! Memory management and OOM prevention.
10//!
11//! Provides cgroup-aware memory tracking with backpressure signals
12//! for Kubernetes-deployed services. Prevents OOM-kills by applying
13//! backpressure before hitting the container memory limit.
14//!
15//! # Architecture
16//!
17//! ```text
18//! Layer 1 (opt-in): Cap allocator -- hard limit, last-resort crash instead of OOM-kill
19//! Layer 2 (default): MemoryGuard -- cgroup-aware tracking, backpressure signals
20//! ```
21
22pub mod cgroup;
23pub mod guard;
24
25pub use cgroup::detect_memory_limit;
26pub use guard::{MemoryGuard, MemoryGuardConfig, MemoryPressure};