babylon.config.defines.ooda

OODA loop coefficients (Feature 032 — Observe/Orient/Decide/Act).

Spec 058: extracted from the historical babylon.config.defines monolith. Re-exported via babylon.config.defines.__init__; composed into GameDefines in babylon.config.defines._assembler.

Classes

OODADefines(**data)

OODA Loop System tunable coefficients (Feature 032).

class babylon.config.defines.ooda.OODADefines(**data)[source]

Bases: BaseModel

OODA Loop System tunable coefficients (Feature 032).

Controls cycle time computation, initiative scoring, action costs, consciousness effect multipliers, and propagation parameters.

See also

specs/032-ooda-loop-system/data-model.md: Full specification.

Parameters:
  • base_observe_time (float)

  • latency_weight (float)

  • base_orient_time (float)

  • coherence_weight (float)

  • base_act_time (float)

  • coord_weight (float)

  • depth_weight (float)

  • decision_mode_base_autocratic (float)

  • decision_mode_base_delegate (float)

  • decision_mode_base_democratic (float)

  • decision_mode_base_consensus (float)

  • initiative_weight_speed (float)

  • initiative_weight_institutional (float)

  • initiative_weight_counterintel (float)

  • initiative_weight_embeddedness (float)

  • initiative_weight_momentum (float)

  • institutional_bonus_federal (float)

  • institutional_bonus_state (float)

  • institutional_bonus_local (float)

  • institutional_bonus_nonstate (float)

  • momentum_decay (float)

  • momentum_success_bonus (float)

  • embeddedness_discount (float)

  • contradiction_cost_multiplier (float)

  • outsider_cost_multiplier (float)

  • min_cost_modifier (float)

  • max_ci_delta_per_tick (float)

  • action_base_educate (float)

  • action_base_agitate (float)

  • action_base_provide_service (float)

  • action_base_recruit (float)

  • action_base_organize (float)

  • action_base_propagandize (float)

  • action_base_repress (float)

  • action_base_surveil (float)

  • action_base_assimilate (float)

  • autonomy_effectiveness_scale (float)

  • agitation_contestation_delta (float)

  • agitation_educate_bonus (float)

  • contestation_threshold (float)

  • elder_legitimacy_multiplier (float)

  • counter_intel_increment (float)

  • base_cost_recruit (int)

  • base_cost_organize (int)

  • base_cost_educate (int)

  • base_cost_agitate (int)

  • base_cost_propagandize (int)

  • base_cost_fundraise (int)

  • base_cost_provide_service (int)

  • base_cost_employ (int)

  • base_cost_repress (int)

  • base_cost_protest (int)

  • base_cost_strike (int)

  • base_cost_expropriate (int)

  • base_cost_surveil (int)

  • base_cost_infiltrate (int)

  • base_cost_counter_intel (int)

  • base_cost_map_network (int)

  • base_cost_propose_alliance (int)

  • base_cost_denounce (int)

  • base_cost_build_infrastructure (int)

  • base_cost_attack_infrastructure (int)

  • base_cost_assimilate (int)

  • base_cost_move (int)

  • base_cost_pogrom (int)

  • base_cost_lockout (int)

  • base_cost_vigilantism (int)

  • base_cost_red_brown_coup (int)

  • repress_heat_delta (float)

  • surveil_heat_delta (float)

  • build_infrastructure_delta (float)

  • attack_infrastructure_delta (float)

  • orient_time_floor (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

base_observe_time: float
latency_weight: float
base_orient_time: float
coherence_weight: float
base_act_time: float
coord_weight: float
depth_weight: float
decision_mode_base_autocratic: float
decision_mode_base_delegate: float
decision_mode_base_democratic: float
decision_mode_base_consensus: float
initiative_weight_speed: float
initiative_weight_institutional: float
initiative_weight_counterintel: float
initiative_weight_embeddedness: float
initiative_weight_momentum: float
institutional_bonus_federal: float
institutional_bonus_state: float
institutional_bonus_local: float
institutional_bonus_nonstate: float
momentum_decay: float
momentum_success_bonus: float
embeddedness_discount: float
contradiction_cost_multiplier: float
outsider_cost_multiplier: float
min_cost_modifier: float
max_ci_delta_per_tick: float
action_base_educate: float
action_base_agitate: float
action_base_provide_service: float
action_base_recruit: float
action_base_organize: float
action_base_propagandize: float
action_base_repress: float
action_base_surveil: float
action_base_assimilate: float
autonomy_effectiveness_scale: float
agitation_contestation_delta: float
agitation_educate_bonus: float
contestation_threshold: float
elder_legitimacy_multiplier: float
counter_intel_increment: float
base_cost_recruit: int
base_cost_organize: int
base_cost_educate: int
base_cost_agitate: int
base_cost_propagandize: int
base_cost_fundraise: int
base_cost_provide_service: int
base_cost_employ: int
base_cost_repress: int
base_cost_protest: int
base_cost_strike: int
base_cost_expropriate: int
base_cost_surveil: int
base_cost_infiltrate: int
base_cost_counter_intel: int
base_cost_map_network: int
base_cost_propose_alliance: int
base_cost_denounce: int
base_cost_build_infrastructure: int
base_cost_attack_infrastructure: int
base_cost_assimilate: int
base_cost_move: int
base_cost_pogrom: int
base_cost_lockout: int
base_cost_vigilantism: int
base_cost_red_brown_coup: int
repress_heat_delta: float
surveil_heat_delta: float
build_infrastructure_delta: float
attack_infrastructure_delta: float
orient_time_floor: float
validate_derivations(game_defines)[source]

Cross-validate OODA coefficients against source primitives.

Checks that derived coefficients (Categories A and B) still match their source primitive formulas. Returns a list of drift warnings for any mismatches exceeding tolerance (0.001).

Parameters:

game_defines (GameDefines) – Parent GameDefines providing source primitives.

Return type:

list[str]

Returns:

List of warning messages for any detected drift. Empty if clean.

get_base_cost(action_type)[source]

Look up base AP cost for an action type.

Parameters:

action_type (str) – ActionType value string.

Return type:

int

Returns:

Base AP cost for the action.

Raises:

KeyError – If action_type is not recognized.

get_action_base(action_type)[source]

Look up consciousness base multiplier for an action type.

Parameters:

action_type (str) – ActionType value string.

Return type:

float

Returns:

Consciousness base multiplier (0.0 means no CI effect).