labSignal: Take real things apart to see how they work.

# risk_score = likelihood(1-5) * impact(1-5), range 1-25.
TIER_THRESHOLDS: list[tuple[int, RiskTier]] = [
    (20, RiskTier.CRITICAL),
    (12, RiskTier.HIGH),
    (6, RiskTier.MEDIUM),
    (1, RiskTier.LOW),
]

def likelihood_score(event: Event, classification: Classification) -> int:
    """1-5, from event confidence (0-1) plus a source-reliability adjustment."""
    base = event.confidence * 5
    adjustment = SOURCE_RELIABILITY_ADJUSTMENT.get(classification.source_category, 0)
    return _clamp(base + adjustment, 1, 5)

def effective_capacity_hours(scenario: ScenarioId, resource: Resource, load_hours: float) -> float:
    """
    Hours actually available to allocate this month, per scenario.

    BASE / CONSTRAINED: installed capacity, unchanged — no investment.
    UPSIDE: installed capacity, topped up to exactly match load whenever
    load would otherwise exceed it — "add just enough capacity to clear
    the gap RCCP flagged," never more, never less.
    """
    if scenario == ScenarioId.UPSIDE:
        return max(resource.monthly_available_hours, load_hours)
    return resource.monthly_available_hours

def average_inter_demand_interval(records: list[WeekRecord]) -> float:
    """ADI = total periods / number of periods with nonzero demand.
    A SKU with demand every single period has ADI == 1.0 (the floor)."""
    n_periods = len(records)
    n_nonzero = sum(1 for r in records if r.actual > 0)
    if n_nonzero == 0:
        return float("inf")
    return n_periods / n_nonzero

# Canonical Syntetos-Boylan-Croston (2005) cutoffs, dataset-agnostic.
ADI_CUTOFF = 1.32
CV2_CUTOFF = 0.49

class Editorial(Theme):
    slug = "editorial"
    name = "Editorial"
    number = 1
    stylesheet = "theme-editorial.css"
    blurb = ("Long-form narrative on warm paper, old-style serif, oxblood "
             "accent. Stripe Press / MIT Technology Review.")
    good_for = ("Essays and post-mortems that are read start to finish. "
                "Strongest when the argument carries the page and there is "
                "more prose than data.")
    options = {"rail": False, "contents": True}