draftomen 0.3.0__py3-none-any.whl

draftomen/config.py

@@ -0,0 +1,133 @@
+"""Documented tunables for Draftomen.
+Centralize defaults that later scoring and deck-building modules will share.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class SplashConfig:
+    """Conservative Limited splash defaults shared by picks and builds.
+    Keep thresholds explicit so replay data can calibrate them safely.
+    """
+
+    enabled_by_default: bool = True
+    maximum_colors: int = 1
+    maximum_cards: int = 2
+    maximum_off_color_pips: int = 1
+    single_card_sources: int = 3
+    multiple_card_sources: int = 4
+    planned_basic_sources: int = 1
+    supported_minimum_grade: str = "A-"
+    speculative_minimum_grade: str = "A"
+    minimum_score_advantage: float = 5.0
+    ready_score_multiplier: float = 0.95
+    speculative_score_multiplier: float = 0.85
+    fixer_score_multiplier: float = 1.05
+    aggressive_minimum_spells: int = 8
+    aggressive_average_mana_value_max: float = 2.7
+    aggressive_minimum_two_drop_ratio: float = 0.3
+
+
+@dataclass(frozen=True)
+class DeckBuilderConfig:
+    """Deck-builder structural defaults.
+    Keep values aligned with Limited consensus until data-backed tuning exists.
+    """
+
+    deck_size: int = 40
+    target_spell_count: int = 23
+    pair_score_card_weight: float = 0.85
+    pair_score_win_rate_weight: float = 0.15
+    neutral_pair_win_rate: float = 0.5
+    pair_score_decimal_places: int = 2
+    default_land_count: int = 17
+    aggressive_land_count: int = 16
+    top_heavy_land_count: int = 18
+    aggressive_average_mana_value_max: float = 2.7
+    top_heavy_average_mana_value_min: float = 3.4
+    creature_floor: int = 14
+    creature_ceiling: int = 17
+    minimum_two_drops: int = 5
+    maximum_expensive_spells: int = 3
+    two_drop_mana_value: float = 2.0
+    expensive_spell_mana_value: float = 6.0
+    near_tie_creature_preference_points: float = 2.0
+    splash_max_cards: int = 2
+    splash_elite_score_minimum: float = 70.0
+    bench_card_count: int = 5
+    land_count_iteration_limit: int = 4
+    maximum_unresolved_metadata_ratio: float = 0.25
+    relaxation_order: tuple[str, ...] = (
+        "expensive-spell cap",
+        "minimum two-drop quota",
+        "creature ceiling",
+        "creature floor",
+        "eligible-card shortage",
+    )
+    main_color_source_floor: int = 7
+    structure_maindeck_rate_threshold: float = 0.5
+    structure_min_land_count: int = 14
+    structure_max_land_count: int = 20
+
+
+@dataclass(frozen=True)
+class PickEngineConfig:
+    """Pick-engine scoring defaults.
+    Scores stay integer-only for scan-friendly draft tables.
+    """
+
+    neutral_prior_score: float = 50.0
+    neutral_prior_win_rate: float = 0.55
+    thin_sample_minimum: int = 500
+    alsa_adjustment_max: float = 0.03
+    alsa_early_pick: float = 1.0
+    alsa_late_pick: float = 8.0
+    normalization_lower_percentile: float = 5.0
+    normalization_upper_percentile: float = 95.0
+    normalization_min_half_span: float = 0.05
+    score_decimal_places: int = 0
+    # Picks 1-5 stay open; pick 6 starts the linear color ramp.
+    open_pick_count: int = 5
+    commitment_start_pick: int = 6
+    # Pick 16 and later are treated as locked to the inferred pair.
+    locked_pick_index: int = 16
+    # Locked on-color cards get up to +15% score; off-color cards keep 75%.
+    on_color_bonus_multiplier: float = 1.15
+    off_color_penalty_multiplier: float = 0.75
+    # Each picked card starts at 1.0 color weight, then ratings move it up/down.
+    pool_weight_baseline: float = 1.0
+    pool_weight_rating_scale: float = 10.0
+    pool_weight_minimum: float = 0.25
+    pool_weight_maximum: float = 2.0
+    # Require two materially represented colors before naming a pair.
+    pool_weight_epsilon: float = 0.01
+    minimum_pair_colors: int = 2
+    premier_fallback_enabled: bool = True
+    # Open picks use pair win rates only as a close-pick tiebreaker.
+    early_pair_tiebreaker_score_threshold: float = 3.0
+    early_pair_tiebreaker_pair_weight_threshold: float = 0.25
+    early_pair_tiebreaker_max_offered_cards: int = 16
+
+
+DECK_BUILDER = DeckBuilderConfig()
+PICK_ENGINE = PickEngineConfig()
+SPLASH = SplashConfig()
+
+POLL_INTERVAL_SECONDS = 1.0
+RATINGS_CACHE_TTL_HOURS = 24
+
+COLOR_PAIRS = (
+    "WU",
+    "WB",
+    "WR",
+    "WG",
+    "UB",
+    "UR",
+    "UG",
+    "BR",
+    "BG",
+    "RG",
+)