"""Root-level CLI commands extracted from the main CLI surface."""

import ipaddress
import json
import logging
import os
import shlex
import subprocess
from pathlib import Path
from typing import NoReturn, Optional, cast

import httpx
import typer
import uvicorn
import yaml

from ....bootstrap import seed_hub_files, seed_repo_files
from ....core.config import (
    CONFIG_FILENAME,
    ConfigError,
    HubConfig,
    _normalize_base_path,
    ensure_hub_config_at,
    find_nearest_hub_config_path,
    load_hub_config,
    load_repo_config,
)
from ....core.git_utils import GitError, run_git
from ....core.runtime import RuntimeContext, clear_stale_lock
from ....core.state import RunnerState, load_state, now_iso, save_state, state_lock
from ....core.usage import (
    UsageError,
    default_codex_home,
    parse_iso_datetime,
    summarize_hub_usage,
    summarize_repo_usage,
)
from ....core.utils import RepoNotFoundError, default_editor, find_repo_root
from ....manifest import load_manifest
from ...web.app import create_hub_app
from .utils import request_json

logger = logging.getLogger("codex_autorunner.cli")


def _raise_exit(message: str, *, cause: Optional[BaseException] = None) -> NoReturn:
    typer.echo(message, err=True)
    if cause is not None:
        raise typer.Exit(code=1) from cause
    raise typer.Exit(code=1)


def _require_repo_config(repo: Optional[Path], hub: Optional[Path]) -> RuntimeContext:
    try:
        repo_root = find_repo_root(repo or Path.cwd())
    except RepoNotFoundError as exc:
        if repo is None:
            _raise_exit(
                "No .git directory found. Specify --repo <worktree-path> to resolve.",
                cause=exc,
            )
        _raise_exit("No .git directory found for repo commands.", cause=exc)
    try:
        config = load_repo_config(repo_root, hub_path=hub)
        return RuntimeContext(
            repo_root=repo_root,
            config=config,
        )
    except ConfigError as exc:
        _raise_exit(str(exc), cause=exc)


def _require_hub_config(path: Optional[Path]) -> HubConfig:
    try:
        return load_hub_config(path or Path.cwd())
    except ConfigError as exc:
        _raise_exit(str(exc), cause=exc)


def _build_server_url(
    config: object, path: str, *, base_path_override: Optional[str] = None
) -> str:
    base_path = (
        _normalize_base_path(base_path_override)
        if base_path_override is not None
        else (getattr(config, "server_base_path", None) or "")
    )
    if base_path.endswith("/") and path.startswith("/"):
        base_path = base_path[:-1]
    server_host = getattr(config, "server_host", "localhost")
    server_port = getattr(config, "server_port", 8000)
    return f"http://{server_host}:{server_port}{base_path}{path}"


def _resolve_hub_config_path_for_cli(
    repo_root: Path, hub: Optional[Path]
) -> Optional[Path]:
    if hub:
        candidate = hub
        if candidate.is_dir():
            candidate = candidate / CONFIG_FILENAME
        return candidate if candidate.exists() else None
    return cast(Optional[Path], find_nearest_hub_config_path(repo_root))


def _resolve_repo_api_path(repo_root: Path, hub: Optional[Path], path: str) -> str:
    if not path.startswith("/"):
        path = f"/{path}"
    hub_config_path = _resolve_hub_config_path_for_cli(repo_root, hub)
    if hub_config_path is None:
        return path
    hub_root = hub_config_path.parent.parent.resolve()
    manifest_rel: Optional[str] = None
    try:
        raw = yaml.safe_load(hub_config_path.read_text(encoding="utf-8")) or {}
        if isinstance(raw, dict):
            hub_cfg = raw.get("hub")
            if isinstance(hub_cfg, dict):
                manifest_value = hub_cfg.get("manifest")
                if isinstance(manifest_value, str) and manifest_value.strip():
                    manifest_rel = manifest_value.strip()
    except (OSError, yaml.YAMLError, KeyError, ValueError) as exc:
        logger.debug("Failed to read hub config for manifest: %s", exc)
        manifest_rel = None
    manifest_path = hub_root / (manifest_rel or ".codex-autorunner/manifest.yml")
    if not manifest_path.exists():
        return path
    try:
        manifest = load_manifest(manifest_path, hub_root)
    except (OSError, ValueError, KeyError) as exc:
        logger.debug("Failed to load manifest: %s", exc)
        return path

    repo_root = repo_root.resolve()
    for entry in manifest.repos:
        candidate = (hub_root / entry.path).resolve()
        if candidate == repo_root:
            return f"/repos/{entry.id}{path}"
    return path


def _resolve_auth_token(env_name: str) -> Optional[str]:
    if not env_name:
        return None
    value = os.environ.get(env_name)
    if value is None:
        return None
    value = value.strip()
    return value or None


def _is_loopback_host(host: str) -> bool:
    if host == "localhost":
        return True
    try:
        return ipaddress.ip_address(host).is_loopback
    except ValueError:
        return False


def _enforce_bind_auth(host: str, token_env: str) -> None:
    if _is_loopback_host(host):
        return
    if _resolve_auth_token(token_env):
        return
    _raise_exit(
        "Refusing to bind to a non-loopback host without server.auth_token_env set."
    )


def _has_nested_git(path: Path) -> bool:
    try:
        for child in path.iterdir():
            if not child.is_dir() or child.is_symlink():
                continue
            if (child / ".git").exists():
                return True
            if _has_nested_git(child):
                return True
    except OSError:
        return False
    return False


def register_root_commands(app: typer.Typer) -> None:
    @app.command()
    def init(
        path: Optional[Path] = typer.Argument(None, help="Repo path; defaults to CWD"),
        force: bool = typer.Option(False, "--force", help="Overwrite existing files"),
        git_init: bool = typer.Option(
            False, "--git-init", help="Run git init if missing"
        ),
        mode: str = typer.Option(
            "auto",
            "--mode",
            help="Initialization mode: repo, hub, or auto (default)",
        ),
    ):
        """Initialize a repo for Codex autorunner."""
        start_path = (path or Path.cwd()).resolve()
        mode = (mode or "auto").lower()
        if mode not in ("auto", "repo", "hub"):
            _raise_exit("Invalid mode; expected repo, hub, or auto")

        git_required = True
        target_root: Optional[Path] = None
        selected_mode = mode

        if mode in ("auto", "repo"):
            try:
                target_root = find_repo_root(start_path)
                selected_mode = "repo"
            except RepoNotFoundError:
                target_root = None

        if target_root is None:
            target_root = start_path
            if mode in ("hub",) or (mode == "auto" and _has_nested_git(target_root)):
                selected_mode = "hub"
                git_required = False
            elif git_init:
                selected_mode = "repo"
                try:
                    proc = run_git(["init"], target_root, check=False)
                except GitError as exc:
                    _raise_exit(f"git init failed: {exc}", cause=exc)
                if proc.returncode != 0:
                    detail = (
                        proc.stderr or proc.stdout or ""
                    ).strip() or f"exit {proc.returncode}"
                    _raise_exit(f"git init failed: {detail}")
            else:
                _raise_exit(
                    "No .git directory found; rerun with --git-init to create one"
                )

        ca_dir = target_root / ".codex-autorunner"
        ca_dir.mkdir(parents=True, exist_ok=True)

        try:
            hub_initialized = False
            if selected_mode == "hub":
                seed_hub_files(target_root, force=force)
                typer.echo(f"Initialized hub at {ca_dir}")
                hub_initialized = True
            else:
                seed_repo_files(target_root, force=force, git_required=git_required)
                typer.echo(f"Initialized repo at {ca_dir}")
                if find_nearest_hub_config_path(target_root) is None:
                    _, hub_initialized = ensure_hub_config_at(target_root)
                    if hub_initialized:
                        typer.echo(f"Initialized hub at {ca_dir}")
        except ConfigError as exc:
            _raise_exit(str(exc), cause=exc)
        typer.echo("Init complete")

    @app.command()
    def status(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(
            None, "--hub", "--path", help="Hub root path"
        ),
        output_json: bool = typer.Option(False, "--json", help="Emit JSON output"),
    ):
        """Show autorunner status."""
        engine = _require_repo_config(repo, hub)
        state = load_state(engine.state_path)
        repo_key = str(engine.repo_root)
        session_id = state.repo_to_session.get(repo_key) or state.repo_to_session.get(
            f"{repo_key}:codex"
        )
        opencode_session_id = state.repo_to_session.get(f"{repo_key}:opencode")
        session_record = state.sessions.get(session_id) if session_id else None
        opencode_record = (
            state.sessions.get(opencode_session_id) if opencode_session_id else None
        )
        quoted_repo = shlex.quote(str(engine.repo_root))
        recommended_actions = [
            f"car ticket-flow status --repo {quoted_repo}",
            f"car sessions --repo {quoted_repo}",
        ]
        if session_id or opencode_session_id:
            recommended_actions.append(f"car stop-session --repo {quoted_repo}")
        if state.runner_pid:
            recommended_actions.append(f"car kill --repo {quoted_repo}")

        if output_json:
            hub_config_path = _resolve_hub_config_path_for_cli(engine.repo_root, hub)
            payload = {
                "repo": str(engine.repo_root),
                "hub": (
                    str(hub_config_path.parent.parent.resolve())
                    if hub_config_path
                    else None
                ),
                "status": state.status,
                "last_run_id": state.last_run_id,
                "last_exit_code": state.last_exit_code,
                "last_run_started_at": state.last_run_started_at,
                "last_run_finished_at": state.last_run_finished_at,
                "runner_pid": state.runner_pid,
                "session_id": session_id,
                "session_record": (
                    {
                        "repo_path": session_record.repo_path,
                        "created_at": session_record.created_at,
                        "last_seen_at": session_record.last_seen_at,
                        "status": session_record.status,
                        "agent": session_record.agent,
                    }
                    if session_record
                    else None
                ),
                "opencode_session_id": opencode_session_id,
                "opencode_record": (
                    {
                        "repo_path": opencode_record.repo_path,
                        "created_at": opencode_record.created_at,
                        "last_seen_at": opencode_record.last_seen_at,
                        "status": opencode_record.status,
                        "agent": opencode_record.agent,
                    }
                    if opencode_record
                    else None
                ),
                "recommended_actions": recommended_actions,
            }
            typer.echo(json.dumps(payload, indent=2))
            return

        typer.echo(f"Repo: {engine.repo_root}")
        typer.echo(f"Status: {state.status}")
        typer.echo(f"Last run id: {state.last_run_id}")
        typer.echo(f"Last exit code: {state.last_exit_code}")
        typer.echo(f"Last start: {state.last_run_started_at}")
        typer.echo(f"Last finish: {state.last_run_finished_at}")
        typer.echo(f"Runner pid: {state.runner_pid}")
        if not session_id and not opencode_session_id:
            typer.echo("Terminal session: none")
        if session_id:
            detail = ""
            if session_record:
                detail = f" (status={session_record.status}, last_seen={session_record.last_seen_at})"
            typer.echo(f"Terminal session (codex): {session_id}{detail}")
        if opencode_session_id and opencode_session_id != session_id:
            detail = ""
            if opencode_record:
                detail = f" (status={opencode_record.status}, last_seen={opencode_record.last_seen_at})"
            typer.echo(f"Terminal session (opencode): {opencode_session_id}{detail}")
        typer.echo("Recommended actions:")
        for action in recommended_actions:
            typer.echo(f"- {action}")

    @app.command()
    def sessions(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
        output_json: bool = typer.Option(False, "--json", help="Emit JSON output"),
    ):
        """List active terminal sessions."""
        engine = _require_repo_config(repo, hub)
        config = engine.config
        path = _resolve_repo_api_path(engine.repo_root, hub, "/api/sessions")
        url = _build_server_url(config, path)
        auth_token = _resolve_auth_token(config.server_auth_token_env)
        if auth_token:
            url = f"{url}?include_abs_paths=1"
        payload = None
        source = "server"
        try:
            payload = request_json("GET", url, token_env=config.server_auth_token_env)
        except (
            httpx.HTTPError,
            httpx.ConnectError,
            httpx.TimeoutException,
            OSError,
        ) as exc:
            logger.debug(
                "Failed to fetch sessions from server, falling back to state: %s", exc
            )
            state = load_state(engine.state_path)
            payload = {
                "sessions": [
                    {
                        "session_id": session_id,
                        "repo_path": record.repo_path,
                        "created_at": record.created_at,
                        "last_seen_at": record.last_seen_at,
                        "status": record.status,
                        "alive": None,
                    }
                    for session_id, record in state.sessions.items()
                ],
                "repo_to_session": dict(state.repo_to_session),
            }
            source = "state"

        if output_json:
            if source != "server":
                payload["source"] = source
            typer.echo(json.dumps(payload, indent=2))
            return

        sessions_payload = (
            payload.get("sessions", []) if isinstance(payload, dict) else []
        )
        typer.echo(f"Sessions ({source}): {len(sessions_payload)}")
        for entry in sessions_payload:
            if not isinstance(entry, dict):
                continue
            session_id = entry.get("session_id") or "unknown"
            repo_path = (
                entry.get("abs_repo_path") or entry.get("repo_path") or "unknown"
            )
            status = entry.get("status") or "unknown"
            last_seen = entry.get("last_seen_at") or "unknown"
            alive = entry.get("alive")
            alive_text = "unknown" if alive is None else str(bool(alive))
            typer.echo(
                f"- {session_id}: repo={repo_path} status={status} last_seen={last_seen} alive={alive_text}"
            )

    @app.command("stop-session")
    def stop_session(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
        session_id: Optional[str] = typer.Option(
            None, "--session", help="Session id to stop"
        ),
    ):
        """Stop a terminal session by id or repo path."""
        engine = _require_repo_config(repo, hub)
        config = engine.config
        payload: dict[str, str] = {}
        if session_id:
            payload["session_id"] = session_id
        else:
            payload["repo_path"] = str(engine.repo_root)

        path = _resolve_repo_api_path(engine.repo_root, hub, "/api/sessions/stop")
        url = _build_server_url(config, path)
        try:
            response = request_json(
                "POST", url, payload, token_env=config.server_auth_token_env
            )
            stopped_id = response.get("session_id", payload.get("session_id", ""))
            typer.echo(f"Stopped session {stopped_id}")
            return
        except (
            httpx.HTTPError,
            httpx.ConnectError,
            httpx.TimeoutException,
            OSError,
        ) as exc:
            logger.debug(
                "Failed to stop session via server, falling back to state: %s", exc
            )

        with state_lock(engine.state_path):
            state = load_state(engine.state_path)
            target_id = payload.get("session_id")
            if not target_id:
                repo_lookup = payload.get("repo_path")
                if repo_lookup:
                    target_id = (
                        state.repo_to_session.get(repo_lookup)
                        or state.repo_to_session.get(f"{repo_lookup}:codex")
                        or state.repo_to_session.get(f"{repo_lookup}:opencode")
                    )
            if not target_id:
                _raise_exit("Session not found (server unavailable)")
            assert target_id is not None
            state.sessions.pop(target_id, None)
            state.repo_to_session = {
                repo_key: sid
                for repo_key, sid in state.repo_to_session.items()
                if sid != target_id
            }
            save_state(engine.state_path, state)
        typer.echo(f"Stopped session {target_id} (state only)")

    @app.command()
    def usage(
        repo: Optional[Path] = typer.Option(
            None,
            "--repo",
            help="Repo or hub path; defaults to CWD",
        ),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
        codex_home: Optional[Path] = typer.Option(
            None,
            "--codex-home",
            help="Override CODEX_HOME (defaults to env or ~/.codex)",
        ),
        since: Optional[str] = typer.Option(
            None,
            "--since",
            help="ISO timestamp filter, e.g. 2025-12-01 or 2025-12-01T12:00Z",
        ),
        until: Optional[str] = typer.Option(
            None,
            "--until",
            help="Upper bound ISO timestamp filter",
        ),
        output_json: bool = typer.Option(False, "--json", help="Emit JSON output"),
    ):
        """Show Codex/OpenCode token usage for a repo or hub by reading local session logs."""
        try:
            since_dt = parse_iso_datetime(since)
            until_dt = parse_iso_datetime(until)
        except UsageError as exc:
            _raise_exit(str(exc), cause=exc)

        codex_root = (codex_home or default_codex_home()).expanduser()

        repo_root: Optional[Path] = None
        try:
            repo_root = find_repo_root(repo or Path.cwd())
        except RepoNotFoundError:
            repo_root = None

        if repo_root and (repo_root / ".codex-autorunner" / "state.sqlite3").exists():
            engine = _require_repo_config(repo, hub)
        else:
            try:
                config = load_hub_config(hub or repo or Path.cwd())
            except ConfigError as exc:
                _raise_exit(str(exc), cause=exc)
            manifest = load_manifest(config.manifest_path, config.root)
            repo_map = [
                (entry.id, (config.root / entry.path)) for entry in manifest.repos
            ]
            per_repo, unmatched = summarize_hub_usage(
                repo_map,
                codex_root,
                since=since_dt,
                until=until_dt,
            )
            if output_json:
                payload = {
                    "mode": "hub",
                    "hub_root": str(config.root),
                    "codex_home": str(codex_root),
                    "since": since,
                    "until": until,
                    "repos": {
                        repo_id: summary.to_dict()
                        for repo_id, summary in per_repo.items()
                    },
                    "unmatched": unmatched.to_dict(),
                }
                typer.echo(json.dumps(payload, indent=2))
                return

            typer.echo(f"Hub: {config.root}")
            typer.echo(f"CODEX_HOME: {codex_root}")
            typer.echo(f"Repos: {len(per_repo)}")
            for repo_id, summary in per_repo.items():
                typer.echo(
                    f"- {repo_id}: total={summary.totals.total_tokens} "
                    f"(input={summary.totals.input_tokens}, cached={summary.totals.cached_input_tokens}, "
                    f"output={summary.totals.output_tokens}, reasoning={summary.totals.reasoning_output_tokens}) "
                    f"events={summary.events}"
                )
            if unmatched.events or unmatched.totals.total_tokens:
                typer.echo(
                    f"- unmatched: total={unmatched.totals.total_tokens} events={unmatched.events}"
                )
            return

        summary = summarize_repo_usage(
            engine.repo_root,
            codex_root,
            since=since_dt,
            until=until_dt,
        )

        if output_json:
            payload = {
                "mode": "repo",
                "repo": str(engine.repo_root),
                "codex_home": str(codex_root),
                "since": since,
                "until": until,
                "usage": summary.to_dict(),
            }
            typer.echo(json.dumps(payload, indent=2))
            return

        typer.echo(f"Repo: {engine.repo_root}")
        typer.echo(f"CODEX_HOME: {codex_root}")
        typer.echo(
            f"Totals: total={summary.totals.total_tokens} "
            f"(input={summary.totals.input_tokens}, cached={summary.totals.cached_input_tokens}, "
            f"output={summary.totals.output_tokens}, reasoning={summary.totals.reasoning_output_tokens})"
        )
        typer.echo(f"Events counted: {summary.events}")
        if isinstance(summary.latest_rate_limits, dict):
            primary = summary.latest_rate_limits.get("primary")
            secondary = summary.latest_rate_limits.get("secondary")
            primary_used = (
                primary.get("used_percent") if isinstance(primary, dict) else None
            )
            primary_window = (
                primary.get("window_minutes") if isinstance(primary, dict) else None
            )
            secondary_used = (
                secondary.get("used_percent") if isinstance(secondary, dict) else None
            )
            secondary_window = (
                secondary.get("window_minutes") if isinstance(secondary, dict) else None
            )
            typer.echo(
                f"Latest rate limits: primary_used={primary_used}%/{primary_window}m, "
                f"secondary_used={secondary_used}%/{secondary_window}m"
            )

    @app.command()
    def kill(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
    ):
        """Force-kill a running autorunner and clear stale lock/state.

        Safety:
        This interrupts active automation immediately and marks state as error.
        """
        engine = _require_repo_config(repo, hub)
        pid = engine.kill_running_process()
        with state_lock(engine.state_path):
            state = load_state(engine.state_path)
            new_state = RunnerState(
                last_run_id=state.last_run_id,
                status="error",
                last_exit_code=137,
                last_run_started_at=state.last_run_started_at,
                last_run_finished_at=now_iso(),
                autorunner_agent_override=state.autorunner_agent_override,
                autorunner_model_override=state.autorunner_model_override,
                autorunner_effort_override=state.autorunner_effort_override,
                autorunner_approval_policy=state.autorunner_approval_policy,
                autorunner_sandbox_mode=state.autorunner_sandbox_mode,
                autorunner_workspace_write_network=state.autorunner_workspace_write_network,
                runner_pid=None,
                sessions=state.sessions,
                repo_to_session=state.repo_to_session,
            )
            save_state(engine.state_path, new_state)
        clear_stale_lock(engine.lock_path)
        if pid:
            typer.echo(f"Sent SIGTERM to pid {pid}")
        else:
            typer.echo("No active autorunner process found; cleared stale lock if any.")

    @app.command()
    def resume(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
    ):
        """Resume a paused/running ticket flow (now uses ticket_flow).

        This command now uses ticket_flow for execution. For full control over
        flows, use 'car flow' commands instead.
        """
        typer.echo("The 'resume' command has been deprecated in favor of ticket_flow.")
        typer.echo("Use 'car flow ticket_flow start' to resume existing flows.")
        raise typer.Exit(code=0)

    @app.command()
    def log(
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
        run_id: Optional[int] = typer.Option(None, "--run", help="Show a specific run"),
        tail: Optional[int] = typer.Option(None, "--tail", help="Tail last N lines"),
    ):
        """Show autorunner log output."""
        engine = _require_repo_config(repo, hub)
        if not engine.log_path.exists():
            _raise_exit("Log file not found; run init")

        if run_id is not None:
            block = engine.read_run_block(run_id)
            if not block:
                _raise_exit("run not found")
            typer.echo(block)
            return

        if tail is not None:
            typer.echo(engine.tail_log(tail))
        else:
            state = load_state(engine.state_path)
            last_id = state.last_run_id
            if last_id is None:
                typer.echo("No runs recorded yet")
                return
            block = engine.read_run_block(last_id)
            if not block:
                typer.echo("No run block found (log may have rotated)")
                return
            typer.echo(block)

    @app.command()
    def edit(
        target: str = typer.Argument(..., help="active_context|decisions|spec"),
        repo: Optional[Path] = typer.Option(None, "--repo", help="Repo path"),
        hub: Optional[Path] = typer.Option(None, "--hub", help="Hub root path"),
    ):
        """Open one of the docs in $EDITOR."""
        engine = _require_repo_config(repo, hub)
        config = engine.config
        key = target.lower()
        if key not in ("active_context", "decisions", "spec"):
            _raise_exit("Invalid target; choose active_context, decisions, or spec")
        path = config.doc_path(key)
        ui_cfg = config.raw.get("ui") if isinstance(config.raw, dict) else {}
        ui_cfg = ui_cfg if isinstance(ui_cfg, dict) else {}
        config_editor = ui_cfg.get("editor") if isinstance(ui_cfg, dict) else None
        if not isinstance(config_editor, str) or not config_editor.strip():
            config_editor = "vi"
        editor = (
            os.environ.get("VISUAL")
            or os.environ.get("EDITOR")
            or default_editor(fallback=config_editor)
        )
        editor_parts = shlex.split(editor)
        if not editor_parts:
            editor_parts = [editor]
        typer.echo(f"Opening {path} with {' '.join(editor_parts)}")
        subprocess.run([*editor_parts, str(path)])

    @app.command()
    def serve(
        path: Optional[Path] = typer.Option(
            None, "--path", "--hub", help="Hub root path"
        ),
        host: Optional[str] = typer.Option(None, "--host", help="Host to bind"),
        port: Optional[int] = typer.Option(None, "--port", help="Port to bind"),
        base_path: Optional[str] = typer.Option(
            None, "--base-path", help="Base path for the server"
        ),
    ):
        """Start the hub web server and UI API."""
        try:
            config = load_hub_config(path or Path.cwd())
        except ConfigError as exc:
            _raise_exit(str(exc), cause=exc)
        bind_host = host or config.server_host
        bind_port = port or config.server_port
        normalized_base = (
            _normalize_base_path(base_path)
            if base_path is not None
            else config.server_base_path
        )
        _enforce_bind_auth(bind_host, config.server_auth_token_env)
        typer.echo(
            f"Serving hub on http://{bind_host}:{bind_port}{normalized_base or ''}"
        )
        uvicorn.run(
            create_hub_app(config.root, base_path=normalized_base),
            host=bind_host,
            port=bind_port,
            root_path="",
            access_log=config.server_access_log,
        )


__all__ = [
    "_resolve_repo_api_path",
    "register_root_commands",
]
