Skip update checks during installer verification

Author: gauss-math-inc

gauss_cli/banner.py

@@ -244,6 +244,9 @@ def check_for_updates() -> Optional[int]:
     ``~/.gauss/.update_check``).  Returns the number of commits behind,
     or ``None`` if the check fails or isn't applicable.
     """
+    if os.getenv("GAUSS_SKIP_UPDATE_CHECK", "").strip().lower() in {"1", "true", "yes", "on"}:
+        return None
+
     from gauss_cli.config import get_gauss_home, get_installed_repo_root
 
     gauss_home = get_gauss_home()

scripts/install-internal.sh

@@ -1614,7 +1614,7 @@ run_post_install_self_check() {
     log_info "Running post-install verification..."
 
     local version_output
-    if ! version_output="$("$GAUSS_BIN" --version 2>&1)"; then
+    if ! version_output="$(GAUSS_SKIP_UPDATE_CHECK=1 "$GAUSS_BIN" --version 2>&1)"; then
         log_error "Gauss CLI verification failed."
         printf '%s\n' "$version_output" >&2
         exit 1

tests/gauss_cli/test_update_check.py

@@ -80,6 +80,27 @@ def test_check_for_updates_no_git_dir(tmp_path):
         banner.__file__ = original
 
 
+def test_check_for_updates_can_be_disabled_via_env(tmp_path):
+    """Installer and CI callers can skip the update probe entirely."""
+    from gauss_cli.banner import check_for_updates
+
+    repo_dir = tmp_path / "checkout"
+    repo_dir.mkdir()
+    (repo_dir / ".git").mkdir()
+    (tmp_path / "install-root").write_text(str(repo_dir))
+
+    with patch.dict(
+        "os.environ",
+        {"GAUSS_HOME": str(tmp_path), "GAUSS_SKIP_UPDATE_CHECK": "1"},
+        clear=False,
+    ):
+        with patch("gauss_cli.banner.subprocess.run") as mock_run:
+            result = check_for_updates()
+
+    assert result is None
+    mock_run.assert_not_called()
+
+
 def test_check_for_updates_fallback_to_project_root():
     """Dev install: falls back to Path(__file__).parent.parent when GAUSS_HOME has no git repo."""
     import gauss_cli.banner as banner