gitwise-cli 0.26.0__tar.gz → 0.27.0__tar.gz

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/CHANGELOG.md

@@ -3,6 +3,18 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v0.27.0 (2026-06-19)
+
+### Feat
+
+- **install**: Windows installer + extend audit to detect unpinned uses: (#63)
+
+## v0.26.1 (2026-06-18)
+
+### Fix
+
+- **ci**: bump all actions to Node 24 + document Homebrew install path (#62)
+
 ## v0.26.0 (2026-06-18)
 
 ### Feat

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitwise-cli
-Version: 0.26.0
+Version: 0.27.0
 Summary: Python CLI for optimizing git workflows and Claude Code integration
 Project-URL: Homepage, https://github.com/drzioner/gitwise
 Project-URL: Repository, https://github.com/drzioner/gitwise
@@ -60,7 +60,15 @@ gitwise addresses three daily pain points:
 
 Pick one:
 
-**curl | bash** (recommended, auto-installs `uv` if missing):
+**Homebrew** (macOS/Linux, recommended if you already use [Homebrew](https://brew.sh)):
+
+```bash
+brew install drzioner/tap/gitwise
+```
+
+Update later with `brew upgrade gitwise`. Uninstall with `brew uninstall gitwise`.
+
+**curl | bash** (auto-installs `uv` if missing, no package manager required):
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/drzioner/gitwise/main/install.sh | bash
@@ -81,17 +89,27 @@ uv sync
 uv run python -m gitwise doctor
 ```
 
+**Windows** (PowerShell 5.1+, auto-installs `uv` if missing):
+
+```powershell
+irm https://raw.githubusercontent.com/drzioner/gitwise/main/install.ps1 | iex
+```
+
+For a version-pinned install (e.g. for reproducible setups), see `Get-Help .\install.ps1 -Detailed` after download.
+
 Update an existing installation:
 
 ```bash
-uv tool upgrade gitwise-cli          # if installed via uv
+brew upgrade gitwise                   # if installed via Homebrew (macOS/Linux)
+uv tool upgrade gitwise-cli            # if installed via uv (any OS)
 # or re-run the curl | bash installer, which always pulls latest
 ```
 
 Uninstall:
 
 ```bash
-uv tool uninstall gitwise-cli
+brew uninstall gitwise                 # if installed via Homebrew
+uv tool uninstall gitwise-cli          # if installed via uv (any OS)
 ```
 
 ## Quick Start

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/README.md

@@ -27,7 +27,15 @@ gitwise addresses three daily pain points:
 
 Pick one:
 
-**curl | bash** (recommended, auto-installs `uv` if missing):
+**Homebrew** (macOS/Linux, recommended if you already use [Homebrew](https://brew.sh)):
+
+```bash
+brew install drzioner/tap/gitwise
+```
+
+Update later with `brew upgrade gitwise`. Uninstall with `brew uninstall gitwise`.
+
+**curl | bash** (auto-installs `uv` if missing, no package manager required):
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/drzioner/gitwise/main/install.sh | bash
@@ -48,17 +56,27 @@ uv sync
 uv run python -m gitwise doctor
 ```
 
+**Windows** (PowerShell 5.1+, auto-installs `uv` if missing):
+
+```powershell
+irm https://raw.githubusercontent.com/drzioner/gitwise/main/install.ps1 | iex
+```
+
+For a version-pinned install (e.g. for reproducible setups), see `Get-Help .\install.ps1 -Detailed` after download.
+
 Update an existing installation:
 
 ```bash
-uv tool upgrade gitwise-cli          # if installed via uv
+brew upgrade gitwise                   # if installed via Homebrew (macOS/Linux)
+uv tool upgrade gitwise-cli            # if installed via uv (any OS)
 # or re-run the curl | bash installer, which always pulls latest
 ```
 
 Uninstall:
 
 ```bash
-uv tool uninstall gitwise-cli
+brew uninstall gitwise                 # if installed via Homebrew
+uv tool uninstall gitwise-cli          # if installed via uv (any OS)
 ```
 
 ## Quick Start

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/gitwise/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.26.0"
+__version__ = "0.27.0"
 
 
 def get_version() -> str:

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/gitwise/__main__.py

@@ -32,12 +32,36 @@ def _install_rich_traceback() -> None:
         return
 
 
+def _ensure_utf8_stdio() -> None:
+    """Force stdout/stderr to UTF-8.
+
+    Windows defaults to a system codepage (often cp1252) for the Python
+    embedded in console apps. That codepage cannot encode characters like
+    U+2713 (✓) used throughout gitwise's status output, causing
+    UnicodeEncodeError when the user is not running through a wrapper that
+    sets PYTHONIOENCODING. macOS/Linux are already UTF-8 by default, so
+    this reconfigure is a no-op there.
+    """
+    for stream_name in ("stdout", "stderr"):
+        stream = getattr(sys, stream_name, None)
+        # TextIOWrapper.reconfigure exists on Python 3.7+; guard just in case
+        # the stream has been replaced with something non-standard.
+        reconfigure = getattr(stream, "reconfigure", None)
+        if callable(reconfigure):
+            try:
+                reconfigure(encoding="utf-8", errors="replace")
+            except (TypeError, ValueError):
+                # Stream does not accept these kwargs or is closed; ignore.
+                pass
+
+
 def main() -> int:
     import os
 
     from ._runtime_config import reset_runtime_config
     from .i18n import set_locale
 
+    _ensure_utf8_stdio()
     _install_rich_traceback()
 
     parser = build_parser()
@@ -93,6 +117,13 @@ def main() -> int:
         except Exception:
             if _should_show_rich_traceback():
                 raise
+            # No Rich traceback available (CI / non-tty / LOG_JSON mode).
+            # Still emit the raw traceback to stderr so CI logs are
+            # diagnostic. Otherwise the user only sees "unexpected error"
+            # and has no way to identify the root cause.
+            import traceback as _traceback
+
+            _traceback.print_exc()
             from .output import error as _error
 
             _error(t("unexpected_error"))

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/gitwise/_cli_setup_agents.py

@@ -385,6 +385,37 @@ def run_setup_agents(
     adapters_legacy_used: bool = False,
 ) -> int:
     """Dispatcher: global mode (default) or per-repo mode (--local)."""
+    import platform
+
+    if platform.system() == "Windows":
+        if not local:
+            # Global mode creates symlinks in ~/.claude/ (skills, CLAUDE.md
+            # pointer, etc.). Windows does not support POSIX-style symlinks
+            # without Developer Mode, and even with it the semantics around
+            # relative targets differ enough that the existing setup_agents
+            # code produces broken links. Fail fast with a clear workaround
+            # instead of letting the user hit a confusing traceback.
+            if as_json:
+                print_json(
+                    {
+                        "ok": False,
+                        "error": "windows_global_unsupported",
+                        "message": t("setup_agents_windows_global_unsupported"),
+                        "workaround": "gitwise setup-agents --local --no-symlinks",
+                    }
+                )
+            else:
+                error(t("setup_agents_windows_global_unsupported"))
+                info(t("setup_agents_windows_workaround_local"))
+            return 1
+        if not no_symlinks:
+            # Local mode auto-enables --no-symlinks on Windows. Same root
+            # cause: os.symlink() either errors out (no Developer Mode) or
+            # produces links that do not behave like POSIX symlinks for our
+            # sandbox check (os.path.realpath over a not-yet-existing target).
+            warn(t("setup_agents_windows_auto_no_symlinks"))
+            no_symlinks = True
+
     if local:
         return _run_setup_local(
             target,

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/gitwise/_i18n_data.json

@@ -519,6 +519,18 @@
     "es": "fsmonitor integrado no está soportado en Linux (solo macOS y Windows)",
     "en": "built-in fsmonitor not supported on Linux (macOS and Windows only)"
   },
+  "setup_agents_windows_global_unsupported": {
+    "es": "setup-agents en modo global no está soportado en Windows (requiere symlinks POSIX en ~/.claude/).",
+    "en": "setup-agents global mode is not supported on Windows (requires POSIX symlinks in ~/.claude/)."
+  },
+  "setup_agents_windows_workaround_local": {
+    "es": "Workaround: usá 'gitwise setup-agents --local --no-symlinks' dentro del repo donde quieras configurar los agentes.",
+    "en": "Workaround: use 'gitwise setup-agents --local --no-symlinks' inside the repo where you want to set up agents."
+  },
+  "setup_agents_windows_auto_no_symlinks": {
+    "es": "Windows detectado: activando --no-symlinks automáticamente (los symlinks POSIX no son confiables en Windows).",
+    "en": "Windows detected: auto-enabling --no-symlinks (POSIX symlinks are not reliable on Windows)."
+  },
   "gc_already_running": {
     "es": "git gc/maintenance ya está en ejecución — esperá a que termine",
     "en": "git gc/maintenance already running — wait for it to finish"

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/install.sh

@@ -5,12 +5,15 @@
 # Remote one-liner:
 #   curl -fsSL https://raw.githubusercontent.com/drzioner/gitwise/main/install.sh | bash
 #
+# Windows? Use install.ps1 instead:
+#   irm https://raw.githubusercontent.com/drzioner/gitwise/main/install.ps1 | iex
+#
 # This installer:
 #   1. Installs uv if not present (via https://astral.sh/uv/install.sh).
 #   2. Runs `uv tool install --upgrade gitwise-cli` (isolated venv, no PyPI pollution).
 #   3. Prints PATH guidance if `gitwise` is not yet on PATH.
 #
-# Supported OS: macOS, Linux. Windows users: see README for alternatives.
+# Supported OS: macOS, Linux. Windows users: see install.ps1 or README.
 
 set -Eeuo pipefail
 
@@ -66,7 +69,8 @@ case "$OS" in
     Linux)  printf 'gitwise installer - Linux (%s)\n' "$ARCH" ;;
     *)
         echo "error: unsupported OS '$OS'. This installer supports macOS and Linux." >&2
-        echo "Windows users: see README for alternative install methods." >&2
+        echo "Windows users: use install.ps1 -> https://raw.githubusercontent.com/drzioner/gitwise/main/install.ps1" >&2
+        echo "Or: irm https://raw.githubusercontent.com/drzioner/gitwise/main/install.ps1 | iex" >&2
         exit 1
         ;;
 esac

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitwise-cli"
-version = "0.26.0"
+version = "0.27.0"
 description = "Python CLI for optimizing git workflows and Claude Code integration"
 readme = "README.md"
 license = "MIT"

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/tests/conftest.py

@@ -34,6 +34,12 @@ def run_gitwise(
         [sys.executable, "-m", "gitwise"] + list(args),
         capture_output=True,
         text=True,
+        # gitwise forces UTF-8 stdio on Windows (see _ensure_utf8_stdio in
+        # __main__.py); the test harness must decode the captured stream as
+        # UTF-8 too, otherwise locale.getpreferredencoding() (cp1252 on
+        # English Windows) mangles non-ASCII characters in the assertion
+        # strings (e.g. "huérfanos" in the worktree-clean success message).
+        encoding="utf-8",
         cwd=cwd or PROJECT_ROOT,
         env=base_env,
     )

{gitwise_cli-0.26.0 → gitwise_cli-0.27.0}/tests/test_adapters.py

@@ -1,6 +1,9 @@
 """Tests for the adapter registry and planning system."""
 
 import json
+import sys
+
+import pytest
 
 from conftest import run_gitwise
 
@@ -196,6 +199,11 @@ class TestAdapterDryRun:
         assert any(a.get("file") == ".claude/settings.json" for a in data.get("actions", []))
         assert any("deprecated alias" in w for w in data.get("warnings", []))
 
+    @pytest.mark.skipif(
+        sys.platform == "win32",
+        reason="setup-agents global mode is intentionally blocked on Windows "
+        "(see run_setup_agents Windows guard); test asserts the POSIX behavior.",
+    )
     def test_adapters_claude_only_warns_in_global_mode(self, tmp_path):
         result = run_gitwise(
             "setup-agents",
@@ -212,6 +220,11 @@ class TestAdapterDryRun:
         assert data["mode"] == "global"
         assert any("deprecated alias" in w for w in data.get("warnings", []))
 
+    @pytest.mark.skipif(
+        sys.platform == "win32",
+        reason="setup-agents global mode is intentionally blocked on Windows "
+        "(see run_setup_agents Windows guard); test asserts the POSIX behavior.",
+    )
     def test_global_mode_allows_adapters(self, tmp_path):
         result = run_gitwise(
             "setup-agents",