Struct GrowerTreeConfigurationBuilder 

pub struct GrowerTreeConfigurationBuilder { /* private fields */ }

Builder for GrowerTreeConfiguration.

Implementations

impl GrowerTreeConfigurationBuilder

pub fn target_name<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<String>,

This field holds verbatim the lower-kebab-case target-name belonging to the tree grow process.

pub fn depth<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<u8>,

Set this integer to define how many levels exist from root to leaf in the tree (≥5).

• Setting a higher number → deeper specialization (depth).
• Setting a lower number → simpler, more general modeling.

pub fn breadth<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<u8>,

Set this integer to define how many siblings or sub-branches each node has by default (≥7).

• Higher → broad coverage, e.g. “Spread (Loosen).”
• Lower → narrower, e.g. “Narrow (Tighten).”

pub fn density<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<u8>,

Set this integer to define how many variants (children) each leaf node holds by default (≥9).

• Higher → more fullness (“Dense”).
• Lower → sparser representation (“Sparse”).

pub fn leaf_granularity<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<f32>,

Set this fraction [0..1] to specify how finely detailed each leaf item becomes.

• 0 = coarse (broad, less specialized leaves),
• 1 = extremely specific leaves.

pub fn balance_symmetry<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<f32>,

Set this fraction [0..1] to numerically characerize the symmetrical vs. unbalanced structure of our tree.

• 0.0 = random/unbalanced,
• 1.0 = perfectly balanced.

pub fn complexity<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<ConfigurationComplexity>,

Set this field to select between “simple”, “balanced”, or “complex” for overall usage patterns.

pub fn level_specific<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<TreeLevelSpecificConfiguration>>,

Set this optional sub-struct to specify the arrays for per-level breadth & density overrides.

pub fn weighted_branching<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<WeightedBranchingConfiguration>>,

Set this optional sub-struct to define mean ± variance if you want random branching factors.

pub fn level_skipping<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<LevelSkippingConfiguration>>,

Set this optional sub-struct to define probabilities for skipping deeper expansions at certain levels.

pub fn capstone<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<CapstoneGenerationConfiguration>>,

Set this optional sub-struct to define the characteristics of capstone leaves, how many of them there are, and our chances of encountering one at any given level.

pub fn ordering<VALUE>(self, value: VALUE) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<SubBranchOrdering>>,

Set this optional sub-struct to define how sub-branches get ordered (alphabetical, difficulty, random).

pub fn ai_confidence<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<AiTreeBranchingConfidenceConfiguration>>,

Set this optional sub-struct to define how AI confidence modifies branch factor (if any).

pub fn aggregator_preference<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<f32>,

Set this fraction [0..1] to control how often aggregator nodes are used vs. dispatch nodes at intermediate levels.

• 0.0 => always dispatch
• 1.0 => always aggregator
• 0.5 => half aggregator, half dispatch

This is a simplistic alternative to tree_expansion_policy. If tree_expansion_policy is set to something more advanced, this field might be ignored or used as a fallback.

pub fn allow_early_leaves<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<bool>,

If true, leaf nodes may appear before the final depth, i.e. some sub-branches might terminate early with a LeafHolder. If false, all leaves appear exactly at depth.

pub fn partial_subbranch_probability<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<f32>,

Fraction [0..1] controlling how often each potential child sub-branch is included.

• 0.0 => no optional sub-branches
• 1.0 => all sub-branches are included

This might tie into ChildSpec optional or probability fields, e.g. randomizing which children appear.

pub fn tree_expansion_policy<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<TreeExpansionPolicy>,

An advanced enum describing how to pick among Dispatch, Aggregate, or LeafHolder at each level.

• If you set this to NodeVariantStrategy::Simple, you get a straightforward approach where we do dispatch at intermediate nodes and leaves at final depth.
• If you use Weighted, you can do random picks among aggregator/dispatch/leaf.
• If you do DepthBased, you can specify exactly which level to start aggregator vs. leaf.

pub fn aggregator_depth_limit<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<u8>>,

If set, aggregator nodes will not appear deeper than this level. If None, no limit. If Some(n), aggregator variant is disallowed for levels > n.

pub fn dispatch_depth_limit<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<u8>>,

If set, dispatch nodes will not appear deeper than this level. If None, no limit. If Some(n), dispatch variant is disallowed for levels > n.

pub fn leaf_min_depth<VALUE>( self, value: VALUE, ) -> GrowerTreeConfigurationBuilder

where VALUE: Into<Option<u8>>,

If set, leaf-holder nodes cannot appear before this level (forces deeper expansions). If None, no minimum. If Some(n), we skip leaf-holder variants until level ≥ n.

pub fn try_build( self, ) -> Result<GrowerTreeConfiguration, GrowerTreeConfigurationBuilderError>

Builds a new GrowerTreeConfiguration.

Errors

If a required field has not been initialized.

impl GrowerTreeConfigurationBuilder

pub fn build( self, ) -> Result<GrowerTreeConfiguration, GrowerTreeConfigurationError>

Consume the builder, construct the config, then validate it before returning.

Trait Implementations

impl Default for GrowerTreeConfigurationBuilder

fn default() -> GrowerTreeConfigurationBuilder

Returns the “default value” for a type.