"""Transport for the `check` domain — args in, delegate, format out.

**Zero logic lives here.** Every command in this file should read as: parse,
call a service, turn the result into output and an exit code. If a command
grows a branch that is about the *problem* rather than about *presentation*,
that branch belongs in `service.py`.

The service import is deliberately at module level: by the time this module is
imported at all, `reach` has already decided to run a `check` command, so there
is nothing left to defer. Laziness lives one level up, in `main.py`.
"""

from __future__ import annotations

import typer

from tooling.core import console
from tooling.domains.check import service

app = typer.Typer(
    name="check",
    help="Consistency gates — the checks the push hook runs.",
    no_args_is_help=True,
    add_completion=False,
    rich_markup_mode=None,
)


@app.callback()
def _domain() -> None:
    """Keeps `check` a group.

    Typer collapses a single-command app into a bare command, so without this
    `reach check client-version` fails with "unexpected extra argument". Every
    domain router needs this until it has two or more verbs — and keeping it
    afterwards costs nothing and stops the shape changing under you.
    """


@app.command("client-version")
def client_version() -> None:
    """Fail if the client's baked version has drifted from project.yaml."""
    result = service.client_version()

    if result.problem:
        console.verdict(
            f"check-client-version: {result.problem}",
            ok=False,
            fix="check that project.yaml and client/project.godot exist and are readable",
        )
        raise typer.Exit(1)

    if not result.ok:
        console.verdict(
            "check-client-version: version drift\n"
            f"  project.yaml          {result.yaml_version}\n"
            f"  client/project.godot  {result.godot_version}\n"
            "\n"
            "This matters beyond cosmetics: the Atlas disk cache keys its\n"
            "invalidation on this version, so a stale mirror makes a shipped\n"
            "build serve canvases generated by code it no longer runs (T-1239).",
            ok=False,
            fix=(
                "set config/version in client/project.godot's [application] "
                f"section to {result.yaml_version} — project.yaml is the source of truth"
            ),
        )
        raise typer.Exit(1)

    console.verdict(f"check-client-version: OK — {result.yaml_version}")