"""Invariant tests for the plain-language startup messages of the ``hermes`` CLI.

Contracts (not snapshots): a mistyped subcommand names the typo, offers the closest
match and ``hermes --help`` without dumping the 70-entry choice list; a rejected
profile name explains the rule; missing optional dependencies point at ``hermes update``.
"""

import io
import sys
from contextlib import redirect_stderr, redirect_stdout
from types import SimpleNamespace

import pytest

from hermes_cli._parser import build_top_level_parser


def _parse_error(argv: list[str]) -> str:
    parser, subparsers, _chat = build_top_level_parser()
    for name in ("sessions", "model", "profile"):
        subparsers.add_parser(name)
    gw = subparsers.add_parser("gateway").add_subparsers(dest="gateway_action", metavar="<action>")
    for name in ("start", "stop", "status"):
        gw.add_parser(name)
    err = io.StringIO()
    with redirect_stderr(err), pytest.raises(SystemExit) as exc:
        parser.parse_args(argv)
    assert exc.value.code == 2
    return err.getvalue()


def test_unknown_subcommand_names_typo_suggests_closest_and_hides_choice_list():
    text = _parse_error(["sesions"])
    assert "'sesions' is not a `hermes` command" in text
    assert "Did you mean: sessions" in text
    assert "hermes --help" in text
    assert "choose from" not in text
    assert "invalid choice" not in text


def test_unknown_subcommand_without_close_match_still_points_at_help():
    text = _parse_error(["zzqx"])
    assert "'zzqx' is not a `hermes` command" in text
    assert "Did you mean" not in text
    assert "hermes --help" in text


def test_nested_group_typo_names_the_group_and_suggests():
    text = _parse_error(["gateway", "stat"])
    assert "'stat' is not a `hermes gateway` command" in text
    assert "Did you mean:" in text and "status" in text


def test_non_choice_errors_keep_argparse_usage_line():
    text = _parse_error(["--no-such-flag"])
    assert text.startswith("usage: hermes")
    assert "--no-such-flag" in text


def test_top_level_usage_hides_subcommand_brace_list():
    parser, _sub, _chat = build_top_level_parser()
    assert "{chat" not in parser.format_usage()
    assert "<command>" in parser.format_usage()


def test_invalid_profile_flag_value_explains_rule_and_exits(monkeypatch):
    from hermes_cli import main as _main

    monkeypatch.setattr(sys, "argv", ["hermes", "-p", "Work Bot", "status"])
    err = io.StringIO()
    with redirect_stderr(err), pytest.raises(SystemExit) as exc:
        _main._apply_profile_override()
    assert exc.value.code == 2
    text = err.getvalue()
    assert "'Work Bot' is not a valid profile name" in text
    assert "hermes profile list" in text
    assert "Must match" not in text


def test_pytest_style_dash_p_is_still_ignored(monkeypatch):
    from hermes_cli import main as _main

    monkeypatch.setattr(sys, "argv", ["pytest", "-p", "no:xdist", "tests/"])
    assert _main._scan_profile_flag(sys.argv[1:]) == (None, 0, None)


def test_option_looking_dash_p_value_is_a_silent_skip_even_under_hermes(monkeypatch):
    from hermes_cli import main as _main

    # `-p no:xdist` reaching us through a differently named runner (tox, nox, python -m) must not exit.
    monkeypatch.setattr(sys, "argv", ["hermes", "-p", "no:xdist", "tests/"])
    assert _main._scan_profile_flag(sys.argv[1:]) == (None, 0, None)
    monkeypatch.setattr(sys, "argv", ["hermes", "-p", "--flag"])
    assert _main._scan_profile_flag(sys.argv[1:]) == (None, 0, None)


def test_title_cased_profile_label_is_normalised_not_rejected(monkeypatch):
    from hermes_cli import main as _main

    assert _main._scan_profile_flag(["-p", " Work ", "status"]) == ("work", 2, 0)
    assert _main._scan_profile_flag(["--profile=Work", "status"]) == ("work", 1, 0)


def test_invalid_dash_p_after_a_subcommand_is_left_to_that_subcommand(monkeypatch):
    from hermes_cli import main as _main

    # A plugin/subcommand flag such as `hermes kanban serve -p "Work Bot"` is not our profile selector.
    monkeypatch.setattr(sys, "argv", ["hermes", "kanban", "serve", "-p", "Work Bot"])
    assert _main._scan_profile_flag(sys.argv[1:]) == (None, 0, None)


def test_bare_continue_with_no_session_names_the_next_step(monkeypatch):
    from hermes_cli import main as _main

    monkeypatch.setattr(_main, "_latest_session_id", lambda _tui: None)
    monkeypatch.setattr(
        "hermes_cli.terminal_breadcrumbs.resolve_breadcrumb_session", lambda: None, raising=False
    )
    out = io.StringIO()
    args = SimpleNamespace(continue_last=True, resume=None, create_if_missing=False)
    with redirect_stdout(out), redirect_stderr(out), pytest.raises(SystemExit):
        _main._resolve_continue_arg(args, use_tui=False)
    text = out.getvalue()
    assert "hermes sessions list" in text
    assert "No previous CLI session" in text


def test_model_picker_does_not_warn_about_missing_provider(monkeypatch, capsys):
    from hermes_cli import main as _main
    from hermes_cli.auth import AuthError

    def _raise(_slug):
        raise AuthError("nothing configured", code="no_provider_configured")

    monkeypatch.setattr("hermes_cli.auth.resolve_provider", _raise)
    active = _main._resolve_active_provider({}, {}, "auto", {})
    out = capsys.readouterr().out
    assert active is None
    assert "Warning" not in out
    assert "Falling back to auto provider detection" not in out
    assert "pick one below" in out


def test_missing_dashboard_deps_point_at_hermes_update():
    from hermes_cli.main_dep_hints import missing_optional_deps_message

    text = missing_optional_deps_message("dashboard", "its web-server packages", "all")
    assert "hermes update" in text
    assert "-m pip install -e '.[all]'" in text
    assert "metadata" not in text


def test_missing_node_message_names_cli_fallback(monkeypatch, capsys):
    from hermes_cli import main_tui_launch as _tui

    monkeypatch.setattr("hermes_constants.find_node_executable", lambda _b: None)
    monkeypatch.setattr("hermes_cli.dep_ensure.ensure_dependency", lambda _n: False, raising=False)
    monkeypatch.delenv("HERMES_NODE", raising=False)
    with pytest.raises(SystemExit):
        _tui._tui_node_bin("node")
    text = capsys.readouterr().out
    assert "hermes --cli" in text
    assert "Node.js" in text