mod planning_capacity

module planning_capacity

Advisory scheduler capacity from a captured, normalized observation.

Allocatable resources are scheduler-effective capacities before allocation. This module performs no scheduler calls and never grants storage admission.

Functions

fn inspect(bytes: &[u8], request: &CapacityRequest, evaluated_at: &str, max_age_seconds: u64) -> Result<Value>

Summarize one captured normalized snapshot without exposing node names.

Unknown resources, unknown states and inactive requested features contribute no free slots. Queue-eligible configured capacity is separate from capacity free at the observation. Pending demand is not subtracted as a placement or queue-time prediction.

Errors

The document, resource request or timestamp is invalid, the observation is stale/future-dated, or resource sums overflow.

Structs and Unions

struct CapacityRequest

One single-node resource request, scoped to an exact scheduler route.

partition: String

Exact partition; no fallback partition is selected.

host_target: String

Maintained physical-host profile label, not a runtime ISA attestation.

features: BTreeSet<String>

Literal features required together, without expression rewriting.

cpus: u64

CPUs required on one node.

memory_mib: u64

Scheduler memory required on one node, in MiB.

gpus: u64

GPUs required on one node; zero is a CPU request.

gpu_type: Option<String>

Optional homogeneous GPU type required by the request.

exclusive_node: Option<bool>

Resolved whole-node policy; absent means partition policy is unknown.

max_slots_per_node: Option<u64>

Explicit per-node slot ceiling, independent of free resource totals.

Implementations

impl CapacityRequest