/// Returns the number of logical CPU cores available to the current process.
///
/// Delegates to [`std::thread::available_parallelism`], which honours OS-level
/// CPU affinity masks where supported. Returns at least `1`: if the query
/// fails the fallback prevents callers from creating zero-sized thread pools.