"""outlier-injection-derkachi — injects up to 350 m position outliers (FT-N-01).

Concrete generator is owned by AZ-408. AZ-406 commits to the public
signature so test specs can plan against it.
"""

from __future__ import annotations

from dataclasses import dataclass
from pathlib import Path


@dataclass(frozen=True)
class OutlierInjectionPlan:
    """Configuration for the outlier-injection-derkachi fixture."""

    target_segment_seconds: tuple[float, float]
    max_offset_m: float = 350.0
    n_outliers: int = 5


def build(plan: OutlierInjectionPlan, out_root: Path) -> Path:
    """Generate the fixture under ``out_root``. Returns the produced directory."""
    raise NotImplementedError("Owned by AZ-408 — AZ-406 supplies only the contract.")