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

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

Note what the commands below no longer do: no `console.verdict(..., ok=False)`
followed by `raise typer.Exit(1)` at each failing branch. They raise
`ReachError` with a remedy and `@command` does the rest — renders the verdict
once, last, and exits non-zero. That is the difference between a contract and a
habit, and it is why every command here wears `@command`.

The service import is deliberately at module level: by the time this module is
imported at all, `reach` has 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

from tooling.core import cli, console
from tooling.core.command import command
from tooling.core.errors import ReachError
from tooling.domains.check import service

app = cli.domain("check", "Consistency gates — the checks the push hook runs.")


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

    if result.problem:
        raise ReachError(
            f"check-client-version: {result.problem}",
            fix="check that project.yaml and client/project.godot exist and are readable",
        )

    if not result.ok:
        raise ReachError(
            "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).",
            fix=(
                "set config/version in client/project.godot's [application] "
                f"section to {result.yaml_version} — project.yaml is the source of truth"
            ),
        )

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