Struct LayoutAdvisor 

pub struct LayoutAdvisor {
    pub fat_bytes: usize,
    pub large_batch_rows: u64,
}

Read-only layout advisor: turns the live access counters a component has accumulated into an actionable layout suggestion, without ever repacking.

This is the glass-box half of AGDF that works today (the physical repack is deferred): a developer can ask “which of my components would benefit from a different layout, and why?” and get an answer grounded in observed access, not a guess. The thresholds below encode the engine’s own benchmark findings (crates/khora-data/examples/layout_bench.rs): the field-SoA/SIMD lever pays on large, compute-bound batches, and the hot/cold split pays on fat components — Khora’s lean built-ins want neither. They are deliberately coarse heuristics and meant to be tuned.

Fields

fat_bytes: usize

A component at least this large (bytes) is “fat” → hot/cold split.

large_batch_rows: u64

A query touching at least this many rows on average is a “large batch”.

Implementations

impl LayoutAdvisor

pub fn recommend( &self, component_bytes: usize, query_count: u64, rows_scanned: u64, ) -> LayoutRecommendation

Recommends a layout for a component from its size and its (query_count, rows_scanned) access stats (as returned by World::component_access_stats).

Trait Implementations

impl Clone for LayoutAdvisor

fn clone(&self) -> LayoutAdvisor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LayoutAdvisor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LayoutAdvisor

fn default() -> Self

Returns the “default value” for a type.

impl Copy for LayoutAdvisor