babylon.models.entities.balkanization_faction

Spec-070 BalkanizationFaction entity (FR-005 – FR-008 + FR-045).

A political coalition that contests sovereignty over Territory through INFLUENCES edges. Disambiguated from:

This module is the political-topology coalition concept: a frozen Pydantic record carrying a colonial_stance axis and a 4-tuple of mechanical multipliers. It does not implement OODA loops or organizational hierarchy — those concerns are deferred to spec-072.

Cross-references:

  • I.1 Settler-Colonial Frame: colonial_stance is the principal axis.

  • I.16 Organization vs Institution: Faction is organization-side (voluntary, dissolvable).

  • I.20 Political Claims as Overlay: INFLUENCES edges are overlays on the immutable spatial substrate.

Classes

BalkanizationFaction(**data)

Political coalition contesting sovereignty (spec-070).
class babylon.models.entities.balkanization_faction.BalkanizationFaction(**data)[source]

Bases: BaseModel

Political coalition contesting sovereignty (spec-070).

Parameters:

  • id (str)

  • name (str)

  • ideology (str)

  • colonial_stance (ColonialStance)

  • is_settler_formation (bool)

  • extraction_modifier (float)

  • violence_modifier (float)

  • class_reduction (Annotated[float, FieldInfo(annotation=NoneType, required=True, description='Value in range [0.0, 1.0] representing likelihood', metadata=[Ge(ge=0.0), Le(le=1.0)]), AfterValidator(func=~babylon.kernel.math.quantize)])

  • metabolic_reduction (float)

  • color_hex (str)

  • founded_tick (int)

  • dissolved_tick (int | None)

id

Stable ID matching ^FAC_[A-Z][A-Z0-9_]*$.

name

Display name.

ideology

Free-text ideological label (e.g., "settler-restorationism").

colonial_stance

Principal political axis (UPHOLD / IGNORE / ABOLISH).

is_settler_formation

Whether the faction is composed primarily of settler-formation classes.

extraction_modifier

Mechanical multiplier on extraction (default by stance from BalkanizationDefines).

violence_modifier

Mechanical multiplier on state violence.

class_reduction

Faction’s effect on class contradiction ([0, 1]).

metabolic_reduction

Faction’s effect on metabolic impact ([-1, +1]).

color_hex

UI color in #RRGGBB form.

founded_tick

Tick the faction was instantiated.

dissolved_tick

Optional dissolution tick.

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

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

id: str
name: str
ideology: str
colonial_stance: ColonialStance
is_settler_formation: bool
extraction_modifier: float
violence_modifier: float
class_reduction: Annotated[float, FieldInfo(annotation=NoneType, required=True, description='Value in range [0.0, 1.0] representing likelihood', metadata=[Ge(ge=0.0), Le(le=1.0)]), AfterValidator(func=quantize)]
metabolic_reduction: float
color_hex: str
founded_tick: int
dissolved_tick: int | None