Git CLI
=======

.. flowtool:: Git CLI
   :id: FLTL_GIT
   :status: approved
   :tags: ubflow, installer

   The Git command-line interface is used for repository discovery and
   remote tag resolution. Minimum required version: 2.x.

Usage
-----

.. list-table::
   :header-rows: 1
   :widths: 35 65

   * - Command
     - Purpose
   * - ``git rev-parse --show-toplevel``
     - Detect the repository root. Exit code 128 means not inside a repo.
   * - ``git ls-remote --tags <url>``
     - List all tags on a remote repository for version resolution.

Constraints
-----------

- ``git rev-parse`` is the only reliable method for repo-root detection;
  do not substitute with file-system heuristics.
- ``git ls-remote`` requires network access; handle timeouts gracefully.