"""TIASshot のヘッドレスセルフテストのランナー（/verify・verifier エージェント用）.

手順（すべてローカルのみ．実機カメラ・ネットワーク上のサービスには触れない）:
  1. ランナーがビルドする構成（Debug|x64）の出力 bin/x64/Debug・obj/x64/Debug を削除する
     （汚れた bin による依存漏れの見逃しを防ぐ．ENV_04「クリーン環境での検証」）．
     Release 等ほかの構成の出力（人間のビルド成果物）には触れない
     --full のときは packages も退避して nuget restore からやり直す（依存更新時）
  2. Debug|x64 をビルドする（SELFTEST フラグ入り）
  3. 既存テスト（NUnit・x64）を実行する（--skip-tests で省略）
  4. TIASshot.exe --selftest を実行し，終了コードと結果ファイルで判定する

出力: .verify/selftest/run-<日時>/ に build.log・test.log・selftest-result.txt・summary.json
終了コード: 0=全て合格，1=不合格あり，2=前提条件を満たさない（ツール未導入等）

使い方（リポジトリルートで実行）:
  python scripts/verify/run_selftest.py            # 通常（Debug 出力削除 → ビルド → テスト → セルフテスト）
  python scripts/verify/run_selftest.py --full     # 依存更新時（packages 退避 → nuget restore から）
  python scripts/verify/run_selftest.py --no-clean # Debug 出力を消さない（開発中の素早い再確認用．判定には使わない）
"""

from __future__ import annotations

import argparse
import datetime as dt
import json
import os
import shutil
import subprocess
import sys
from pathlib import Path

REPO = Path(__file__).resolve().parents[2]
SLN = REPO / "TIASshot.sln"
EXE = REPO / "TIASshot" / "bin" / "x64" / "Debug" / "TIASshot.exe"
TEST_DLL = REPO / "TIASshot.Tests" / "bin" / "x64" / "Debug" / "TIASshot.Tests.dll"
# クリーン対象はランナーがビルドする構成（Debug|x64）の出力だけ．bin 全体を消すと人間の Release 出力まで消える
CLEAN_DIRS = [REPO / p / d / "x64" / "Debug" for p in ("TIASshot", "TIASshot.Tests") for d in ("bin", "obj")]
SELFTEST_TIMEOUT_SEC = 420   # セルフテスト内部のウォッチドッグ（5 分）より長くする
BUILD_TIMEOUT_SEC = 1200

EXIT_OK = 0
EXIT_FAIL = 1
EXIT_PRECONDITION = 2


class PreconditionError(Exception):
    """前提条件を満たさない（verifier は「検証不能」と報告する）."""


def find_vs() -> Path:
    vswhere = Path(os.environ.get("ProgramFiles(x86)", r"C:\Program Files (x86)")) / \
        "Microsoft Visual Studio" / "Installer" / "vswhere.exe"
    if not vswhere.exists():
        raise PreconditionError(f"vswhere.exe が見つかりません: {vswhere}（Visual Studio / Build Tools を導入してください）")
    out = subprocess.run([str(vswhere), "-latest", "-products", "*", "-property", "installationPath"],
                         capture_output=True, text=True, check=False)
    path = out.stdout.strip().splitlines()[0] if out.stdout.strip() else ""
    if not path:
        raise PreconditionError("vswhere が Visual Studio / Build Tools を検出できません")
    return Path(path)


def find_nuget() -> str:
    found = shutil.which("nuget")
    if found:
        return found
    local = REPO / "nuget.exe"
    if local.exists():
        return str(local)
    raise PreconditionError("nuget.exe が見つかりません（setup.ps1 を実行するか PATH に追加してください）")


def run_logged(cmd: list[str], log: Path, timeout: int) -> int:
    """コマンドを実行し，標準出力・標準エラーをログへ書く．戻り値は終了コード."""
    with log.open("w", encoding="utf-8", errors="replace") as f:
        f.write("> " + " ".join(cmd) + "\n\n")
        f.flush()
        proc = subprocess.run(cmd, cwd=REPO, stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
                              timeout=timeout, check=False)
        f.write(decode_output(proc.stdout))
        return proc.returncode


def decode_output(data: bytes) -> str:
    """ツールの出力を復号する（MSBuild / vstest はリダイレクト時 UTF-8．古い環境の cp932 にも備える）."""
    try:
        return data.decode("utf-8")
    except UnicodeDecodeError:
        return data.decode("cp932", errors="replace")


def clean_build_outputs() -> None:
    for d in CLEAN_DIRS:
        if d.exists():
            try:
                shutil.rmtree(d)
            except OSError as ex:
                raise PreconditionError(
                    f"{d} を削除できません（TIASshot.exe や Visual Studio が使用中の可能性）: {ex}") from ex


def restore_packages_clean(run_dir: Path, nuget: str) -> tuple[bool, str]:
    """packages を退避して nuget restore からやり直す（clone 直後と同じ状態を再現する）."""
    packages = REPO / "packages"
    backup = REPO / f"packages.bak-{run_dir.name}"
    if packages.exists():
        try:
            # 改名は原子的．失敗時は packages が元のまま残る（中途半端な状態にならない）
            packages.rename(backup)
        except OSError as ex:
            raise PreconditionError(
                f"packages を退避できません（Visual Studio 等が使用中の可能性．packages は変更していません）: {ex}") from ex
    code = run_logged([nuget, "restore", str(SLN)], run_dir / "restore.log", BUILD_TIMEOUT_SEC)
    if code != 0:
        # 復元に失敗したら退避した packages を戻す（人間の作業環境を壊さない）
        if packages.exists():
            shutil.rmtree(packages, ignore_errors=True)
        if backup.exists():
            backup.rename(packages)
        return False, f"nuget restore 失敗（exit {code}）．packages は元に戻しました"
    if backup.exists():
        shutil.rmtree(backup, ignore_errors=True)
    return True, "nuget restore 成功（packages を再取得）"


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    parser.add_argument("--full", action="store_true", help="packages を退避して nuget restore からやり直す（依存更新時）")
    parser.add_argument("--no-clean", action="store_true", help="Debug 出力（bin/obj の x64/Debug）を削除しない（開発時の短縮用．判定には使わない）")
    parser.add_argument("--skip-tests", action="store_true", help="既存テスト（vstest）を実行しない（開発時の短縮用．判定には使わない）")
    args = parser.parse_args()
    # verifier（Git Bash 経由）が読めるよう，本ランナーの出力は UTF-8 に固定する
    if hasattr(sys.stdout, "reconfigure"):
        sys.stdout.reconfigure(encoding="utf-8")

    stamp = dt.datetime.now().strftime("%Y%m%d-%H%M%S")
    run_dir = REPO / ".verify" / "selftest" / f"run-{stamp}"
    run_dir.mkdir(parents=True, exist_ok=True)
    summary: dict = {"run_dir": str(run_dir), "steps": [], "result": None}

    def step(name: str, ok: bool, detail: str) -> None:
        summary["steps"].append({"name": name, "ok": ok, "detail": detail})
        print(f"[{'OK' if ok else 'NG'}] {name}: {detail}", flush=True)

    exit_code = EXIT_OK
    try:
        vs = find_vs()
        msbuild = vs / "MSBuild" / "Current" / "Bin" / "MSBuild.exe"
        vstest = vs / "Common7" / "IDE" / "CommonExtensions" / "Microsoft" / "TestWindow" / "vstest.console.exe"
        if not msbuild.exists():
            raise PreconditionError(f"MSBuild.exe が見つかりません: {msbuild}")

        if not args.no_clean:
            clean_build_outputs()
            step("clean", True, "Debug 出力（bin/obj の x64/Debug）を削除")

        if args.full:
            ok, detail = restore_packages_clean(run_dir, find_nuget())
            step("restore", ok, detail)
            if not ok:
                raise PreconditionError(detail)

        code = run_logged([str(msbuild), str(SLN), "/t:Build", "/p:Configuration=Debug", "/p:Platform=x64",
                           "/nologo", "/v:minimal"], run_dir / "build.log", BUILD_TIMEOUT_SEC)
        step("build", code == 0, f"Debug|x64 ビルド exit {code}（build.log）")
        if code != 0:
            exit_code = EXIT_FAIL
            raise RuntimeError("ビルド失敗")

        if not args.skip_tests:
            if not vstest.exists():
                raise PreconditionError(f"vstest.console.exe が見つかりません: {vstest}")
            code = run_logged([str(vstest), str(TEST_DLL), "/Platform:x64"], run_dir / "test.log", BUILD_TIMEOUT_SEC)
            step("tests", code == 0, f"既存テスト exit {code}（test.log）")
            if code != 0:
                exit_code = EXIT_FAIL

        result_file = run_dir / "selftest-result.txt"
        try:
            proc = subprocess.run([str(EXE), "--selftest", "--selftest-out", str(result_file)], cwd=REPO,
                                  stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
                                  timeout=SELFTEST_TIMEOUT_SEC, check=False)
            code = proc.returncode
        except subprocess.TimeoutExpired:
            code = None
        text = result_file.read_text(encoding="utf-8-sig", errors="replace") if result_file.exists() else ""
        heads = [ln for ln in text.splitlines() if ln.startswith("[") or ln.startswith("RESULT:")]
        summary["selftest_exit_code"] = code
        summary["selftest_lines"] = heads
        step("selftest", code == 0, f"exit {code}（selftest-result.txt）")
        for ln in heads:
            print(f"    {ln}", flush=True)
        if code != 0:
            exit_code = EXIT_FAIL
    except PreconditionError as ex:
        step("precondition", False, str(ex))
        exit_code = EXIT_PRECONDITION
    except RuntimeError as ex:
        step("abort", False, str(ex))
        exit_code = EXIT_FAIL
    except subprocess.TimeoutExpired as ex:
        step("timeout", False, f"{ex.cmd} が {ex.timeout} 秒で終わりません")
        exit_code = EXIT_FAIL

    summary["result"] = {EXIT_OK: "PASS", EXIT_FAIL: "FAIL", EXIT_PRECONDITION: "PRECONDITION"}[exit_code]
    (run_dir / "summary.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"RESULT: {summary['result']}  (出力: {run_dir})", flush=True)
    return exit_code


if __name__ == "__main__":
    sys.exit(main())