Module node_facts 

Node facts probes and TTL cache (ADR-099 section 2, card mesh-placement-03). Node facts probing, local advertisement and the facts TTL cache (ADR-099 section 2, card mesh-placement-03).

• host: the ProbeHost seam (real SystemHost, fakes in tests).
• probe: orchestration, shared helpers, ProbeConfig.
• macos / linux: OS probes (CPU, OS, memory, storage, Metal, ANE, board class, binfmt emulation).
• runtimes: native, Docker/OrbStack, Podman, Apple container, llama-server, mlx_lm, ollama.
• accel: vendor accelerators, only when their tool or device exists (nvidia-smi, hailortcli, Coral /dev/apex_* or USB id).
• measured: perf.* results from the conformance harness.
• cache: the verified-facts TTL cache held by ClusterMembership.

The data type (clawft_types::placement::NodeFacts) lives in clawft-types; signing lives in crate::node_facts_advert, beside the coarse SignedCapabilityAdvertisement.

Re-exports

pub use host::ProbeHost;

pub use host::SystemHost;

pub use probe::Collected;

pub use probe::DEFAULT_FACTS_TTL_SECS;

pub use probe::EmulationCache;

pub use probe::ProbeConfig;

pub use probe::build_facts;

pub use probe::probe_capabilities;

pub use probe::refresh_live;

pub use probe::valid_image_ref;

pub use cache::CacheError;

pub use cache::CachedNodeFacts;

pub use cache::InsertOutcome;

pub use cache::NodeFactsCache;

pub use cache::TierSource;

Modules

cache

TTL cache of verified node facts, held by crate::cluster::ClusterMembership (ADR-099 section 2).

host

The seam between probes and the machine: ProbeHost.

linux

Linux probes: CPU, distro/kernel, memory, storage, board class and binfmt emulation.

macos

macOS probes: CPU, OS version, unified memory, storage, Metal GPU and the Apple Neural Engine.

measured

Load measured perf.* capabilities written by the cog conformance harness (scripts/build.sh cogs-conformance sweep|probe) or an admission probe.

probe

Probe orchestration and the probes shared by every OS.

runtimes

Runtime probes: native, Docker-compatible engines (OrbStack, Docker Desktop, plain engine), Podman, Apple container, and the inference servers llama-server, mlx_lm and ollama.

Functions

probe_and_sign

Probe host, build facts for the node owning key, and sign them.