hpc-node 2026.1.28

Shared contracts for node-level resource management between HPC systems: cgroup v2 conventions, namespace handoff protocol, mount management, and readiness signaling.
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

//! # hpc-node
//!
//! Shared contracts for node-level resource management between HPC systems.
//!
//! This crate defines traits and types for:
//! - **cgroup v2 conventions** (`cgroup`): slice naming, ownership, scope management
//! - **Namespace handoff** (`namespace`): protocol for passing namespace FDs between processes
//! - **Mount management** (`mount`): refcounted mounts with lazy unmount
//! - **Readiness signaling** (`readiness`): boot readiness gate
//!
//! Both pact-agent and lattice-node-agent implement these traits independently.
//! When pact is init, lattice gains capabilities ("steroids") through the handoff
//! protocol. When lattice runs standalone, it creates its own hierarchy using the
//! same conventions.
//!
//! ## Design principles
//!
//! - **Traits and types only** — no implementations, no Linux-specific code
//! - **No runtime coupling** — pact and lattice have no runtime dependency on each other
//! - **Convention over configuration** — well-known paths and constants prevent drift

pub mod cgroup;
pub mod mount;
pub mod namespace;
pub mod readiness;

// Re-export key types at crate root.
pub use cgroup::{
    CgroupError, CgroupHandle, CgroupManager, CgroupMetrics, ResourceLimits, SliceOwner,
};
pub use mount::{MountError, MountHandle, MountManager};
pub use namespace::{
    NamespaceConsumer, NamespaceError, NamespaceProvider, NamespaceRequest, NamespaceResponse,
    NamespaceType,
};
pub use readiness::{ReadinessError, ReadinessGate};