"""Frozen main.py imports for updater code still running after a checkout swap.

These are not the live helpers in main_desktop, main_install_repair or
main_web_build. Returning from an old installer can trigger a retry or report
success, so those call paths stop for relaunch instead.
"""

from pathlib import Path
from typing import NoReturn

from hermes_cli._old_updater import stop_for_relaunch


# Shim to stop the old updater doing work until relaunch. Retain the filename
# as data only, without recording a fingerprint or replacing the live recorder.
_BYTECODE_FINGERPRINT_FILE = ".bytecode-fingerprint"


class ShimQuarantineError(RuntimeError):
    # Shim to stop the old updater doing work until relaunch. Preserve the
    # historical exception payload without performing or claiming quarantine.
    def __init__(self, failed_shims: list[str]):
        self.failed_shims = list(failed_shims)
        super().__init__("could not quarantine live shim(s): " + ", ".join(self.failed_shims))


def _desktop_stamp_path() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not select a build stamp.
    stop_for_relaunch()


def _detect_broken_lazy_refresh_imports(
    install_cmd_prefix: list[str], *, env: dict[str, str] | None = None,
) -> None:
    # Shim to stop the old updater doing work until relaunch: unknown, not healthy [].
    return None


def _expected_windows_pe_machines() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not approve a binary.
    stop_for_relaunch()


def _hermes_exe_shims(scripts_dir: Path) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not select files to rename.
    stop_for_relaunch()


def _insert_python_pin(args: list[str]) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not prepare an install.
    stop_for_relaunch()


def _interpreter_scripts_dir() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not target live launchers.
    stop_for_relaunch()


def _load_installable_optional_extras(group: str = "all") -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not select dependency retries.
    stop_for_relaunch()


def _parse_pe_machine(path: Path) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not trigger a binary fallback.
    stop_for_relaunch()


def _quarantine_running_hermes_exe(
    scripts_dir: Path, *, max_attempts: int = 4, failed_out: list[str] | None = None,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not rename live executables.
    stop_for_relaunch()


def _repair_broken_lazy_refresh_imports(
    install_cmd_prefix: list[str], packages: list[str], *, env: dict[str, str] | None = None,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not repair or claim health.
    stop_for_relaunch()


def _resolve_install_target_python(
    install_cmd_prefix: list[str], env: dict[str, str] | None,
) -> None:
    # Shim to stop the old updater doing work until relaunch: no interpreter to probe.
    return None


def _restore_quarantined_exes(moved: list[tuple[Path, Path]]) -> None:
    # Shim to stop the old updater doing work until relaunch, including finally-block renames.
    return None


def _run_install_with_heartbeat(
    cmd: list[str], *, env: dict[str, str] | None = None, heartbeat_interval_seconds: int = 30,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not run pip/uv or report success.
    stop_for_relaunch()


def _run_package_only_install(cmd: list[str], *, env: dict[str, str] | None = None) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not run a package-only retry.
    stop_for_relaunch()


def _run_quarantined_install(
    cmd: list[str], *, env: dict[str, str] | None = None, scripts_dir: Path | None = None,
    strict_quarantine: bool = False,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not install or enable fallback.
    stop_for_relaunch()


def _run_with_idle_timeout(
    cmd: list[str], cwd: Path, *, idle_timeout_seconds: int = 180, indent: str = "    ",
    env: dict[str, str] | None = None,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not build or synthesize success.
    stop_for_relaunch()


def _self() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not expose live process scans.
    stop_for_relaunch()


def _verify_console_scripts_installed(
    install_cmd_prefix: list[str], *, env: dict[str, str] | None = None,
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not reinstall entry points.
    stop_for_relaunch()


def _verify_core_dependencies_installed(
    install_cmd_prefix: list[str], *, env: dict[str, str] | None = None, group: str = "all",
) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not reinstall missing packages.
    stop_for_relaunch()


def _web_ui_build_needed(web_dir: Path) -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not claim an unbuilt UI is current.
    stop_for_relaunch()


def _windows_native_machine() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not approve a fallback architecture.
    stop_for_relaunch()


def _windows_shim_in_process_chain() -> NoReturn:
    # Shim to stop the old updater doing work until relaunch, not spawn an install handoff.
    stop_for_relaunch()


def _write_web_ui_build_stamp(project_root: Path, web_dir: Path) -> None:
    # Shim to stop the old updater doing work until relaunch. Never write a success marker.
    return None