# ──────────────────────────────────────────────────────────────────────
# SCPN Control — Phase Dynamics Package
# © 1998–2026 Miroslav Šotek. All rights reserved.
# Contact: www.anulum.li | protoscience@anulum.li
# ORCID: https://orcid.org/0009-0009-3560-0851
# License: MIT OR Apache-2.0
# ──────────────────────────────────────────────────────────────────────
"""
Paper 27 Knm/UPDE engine + Kuramoto-Sakaguchi phase reduction.

Implements the generalized Kuramoto-Sakaguchi mean-field model with an
exogenous global field driver ζ sin(Ψ − θ), per the reviewer request
referencing arXiv:2004.06344 and SCPN Paper 27.
"""

from scpn_control.phase.adaptive_knm import (
    AdaptiveKnmConfig,
    AdaptiveKnmEngine,
    DiagnosticSnapshot,
)
from scpn_control.phase.knm import KnmSpec, build_knm_paper27
from scpn_control.phase.kuramoto import (
    GlobalPsiDriver,
    kuramoto_sakaguchi_step,
    lyapunov_exponent,
    lyapunov_v,
    order_parameter,
    wrap_phase,
)
from scpn_control.phase.lyapunov_guard import LyapunovGuard
from scpn_control.phase.plasma_knm import (
    OMEGA_PLASMA_8,
    PLASMA_LAYER_NAMES,
    build_knm_plasma,
    build_knm_plasma_from_config,
    plasma_omega,
)
from scpn_control.phase.realtime_monitor import RealtimeMonitor, TrajectoryRecorder
from scpn_control.phase.upde import UPDESystem
from scpn_control.phase.ws_phase_stream import PhaseStreamServer

__all__ = [
    "AdaptiveKnmConfig",
    "AdaptiveKnmEngine",
    "DiagnosticSnapshot",
    "kuramoto_sakaguchi_step",
    "order_parameter",
    "wrap_phase",
    "lyapunov_v",
    "lyapunov_exponent",
    "GlobalPsiDriver",
    "KnmSpec",
    "build_knm_paper27",
    "build_knm_plasma",
    "build_knm_plasma_from_config",
    "plasma_omega",
    "OMEGA_PLASMA_8",
    "PLASMA_LAYER_NAMES",
    "UPDESystem",
    "LyapunovGuard",
    "RealtimeMonitor",
    "TrajectoryRecorder",
    "PhaseStreamServer",
]
