src/poolcoach_rl/recommend/__init__.py

"""PoolCoach recommend engine — module dùng chung cho BE web app + scripts.

31/07/2026 (BRIEF việc D): một engine duy nhất — ZonePlanner V2
(``recommend_v2``, tiêu chí design §8). Oracle/hybrid/zone-V1 + net/2-ply
xoá khỏi ``main``; bản đầy đủ sống ở nhánh ``v1-full``.

Import nhẹ: numpy/pooltool chỉ được import lazy bên trong hàm.
"""

from .core import (TRAJ_MIN_DISP, RecommendFullResult, ShotFull,
                   describe_full, recommend_v2, validate_full, warmup)
from .geometry import feasible_pockets, feasible_pockets_full, pocket_name
from .rules import WIN_EV, judge_shot, target_ball
from .simulate import (POS_COEF, SCRATCH_EV, path_len_after, simulate_shot,
                       simulate_shot_multi)
from .trajectory import extract_trajectories

__all__ = [
    "RecommendFullResult", "ShotFull", "recommend_v2", "validate_full",
    "describe_full", "warmup", "TRAJ_MIN_DISP",
    "feasible_pockets", "feasible_pockets_full", "pocket_name",
    "WIN_EV", "judge_shot", "target_ball",
    "POS_COEF", "SCRATCH_EV", "path_len_after",
    "simulate_shot", "simulate_shot_multi",
    "extract_trajectories",
]