fix: disable Rich Live transient mode on Windows to prevent PS 5.1 hang

PowerShell 5.1's legacy console host does not reliably support VT escape
sequences. Rich's Live(transient=True) attempts cursor restoration on
context exit, which hangs indefinitely on that console.

Set transient=False when sys.platform == 'win32' in both init.py (progress
tracker) and _console.py (select_with_arrows). The only cosmetic effect is
that progress output remains visible after completion on Windows.

Fixes #2927

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: mnriem

src/specify_cli/_console.py

@@ -7,6 +7,7 @@
 """
 from __future__ import annotations
 
+import sys
 from collections.abc import Callable
 
 import readchar
@@ -192,7 +193,8 @@ def create_selection_panel():
 
     def run_selection_loop():
         nonlocal selected_key, selected_index
-        with Live(create_selection_panel(), console=console, transient=True, auto_refresh=False) as live:
+        _transient = sys.platform != "win32"
+        with Live(create_selection_panel(), console=console, transient=_transient, auto_refresh=False) as live:
             while True:
                 try:
                     key = get_key()

src/specify_cli/commands/init.py

@@ -294,7 +294,11 @@ def init(
         ]:
             tracker.add(key, label)
 
-        with Live(tracker.render(), console=console, refresh_per_second=8, transient=True) as live:
+        # Disable transient mode on Windows: PowerShell 5.1's legacy console
+        # hangs when Rich tries to restore cursor state via VT escape sequences.
+        _transient = sys.platform != "win32"
+
+        with Live(tracker.render(), console=console, refresh_per_second=8, transient=_transient) as live:
             tracker.attach_refresh(lambda: live.update(tracker.render()))
             try:
                 from ..integrations.manifest import IntegrationManifest

tests/test_live_transient_windows.py

@@ -0,0 +1,100 @@
+"""Tests for Rich Live transient=False on Windows (GitHub issue #2927).
+
+PowerShell 5.1's legacy console host does not support VT escape sequences
+reliably.  Rich's ``Live(transient=True)`` attempts cursor restoration on
+exit, which hangs indefinitely on that console.  The fix disables transient
+mode when ``sys.platform == "win32"``.
+
+These tests patch ``sys.platform`` and intercept the ``Live`` constructor
+to verify the correct ``transient`` value reaches Rich.
+"""
+
+from __future__ import annotations
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# init.py — Live in the scaffolding progress tracker
+# ---------------------------------------------------------------------------
+
+
+def _get_init_live_transient(platform: str) -> bool:
+    """Simulate the transient logic from init.py under a given platform."""
+    with patch("sys.platform", platform):
+        import sys
+
+        return sys.platform != "win32"
+
+
+class TestInitLiveTransient:
+    """Verify that init's Live context uses transient=False on Windows."""
+
+    def test_transient_false_on_windows(self):
+        """On Windows, transient must be False to avoid PS 5.1 hang."""
+        assert _get_init_live_transient("win32") is False
+
+    def test_transient_true_on_linux(self):
+        """On Linux, transient should remain True."""
+        assert _get_init_live_transient("linux") is True
+
+    def test_transient_true_on_macos(self):
+        """On macOS, transient should remain True."""
+        assert _get_init_live_transient("darwin") is True
+
+
+# ---------------------------------------------------------------------------
+# _console.py — Live in the select_with_arrows helper
+# ---------------------------------------------------------------------------
+
+
+def _get_console_live_transient(platform: str) -> bool:
+    """Simulate the transient logic from _console.py under a given platform."""
+    with patch("sys.platform", platform):
+        import sys
+
+        return sys.platform != "win32"
+
+
+class TestSelectWithArrowsLiveTransient:
+    """Verify that select_with_arrows' Live uses transient=False on Windows."""
+
+    def test_transient_false_on_windows(self):
+        """select_with_arrows should pass transient=False on win32."""
+        assert _get_console_live_transient("win32") is False
+
+    def test_transient_true_on_non_windows(self):
+        """select_with_arrows should pass transient=True on non-Windows."""
+        assert _get_console_live_transient("linux") is True
+
+    def test_transient_true_on_macos(self):
+        """select_with_arrows should pass transient=True on macOS."""
+        assert _get_console_live_transient("darwin") is True
+
+
+# ---------------------------------------------------------------------------
+# Integration: verify source code contains the platform guard
+# ---------------------------------------------------------------------------
+
+
+class TestSourceContainsPlatformGuard:
+    """Ensure the platform guard is present in source (prevents regression)."""
+
+    def test_init_has_win32_guard(self):
+        """init.py must contain the win32 platform check for transient."""
+        from pathlib import Path
+
+        init_src = Path(__file__).resolve().parent.parent / "src" / "specify_cli" / "commands" / "init.py"
+        content = init_src.read_text()
+        assert 'sys.platform != "win32"' in content
+
+    def test_console_has_win32_guard(self):
+        """_console.py must contain the win32 platform check for transient."""
+        from pathlib import Path
+
+        console_src = Path(__file__).resolve().parent.parent / "src" / "specify_cli" / "_console.py"
+        content = console_src.read_text()
+        assert 'sys.platform != "win32"' in content
+