shotgun-sh 0.2.10.dev6__tar.gz → 0.2.10.dev8__tar.gz

{shotgun_sh-0.2.10.dev6 → shotgun_sh-0.2.10.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.2.10.dev6
+Version: 0.2.10.dev8
 Summary: AI-powered research, planning, and task management CLI tool
 Project-URL: Homepage, https://shotgun.sh/
 Project-URL: Repository, https://github.com/shotgun-sh/shotgun

{shotgun_sh-0.2.10.dev6 → shotgun_sh-0.2.10.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shotgun-sh"
-version = "0.2.10.dev6"
+version = "0.2.10.dev8"
 description = "AI-powered research, planning, and task management CLI tool"
 readme = "README_PYPI.md"
 license = { text = "MIT" }
@@ -66,6 +66,7 @@ dev = [
 
 [project.scripts]
 shotgun = "shotgun.main:app"
+shotgun-sh = "shotgun.main:app"
 
 [build-system]
 requires = ["hatchling"]

{shotgun_sh-0.2.10.dev6 → shotgun_sh-0.2.10.dev8}/src/shotgun/tui/app.py

@@ -9,12 +9,16 @@ from shotgun.agents.config import ConfigManager, get_config_manager
 from shotgun.logging_config import get_logger
 from shotgun.tui.screens.splash import SplashScreen
 from shotgun.utils.file_system_utils import get_shotgun_base_path
-from shotgun.utils.update_checker import perform_auto_update_async
+from shotgun.utils.update_checker import (
+    detect_installation_method,
+    perform_auto_update_async,
+)
 
 from .screens.chat import ChatScreen
 from .screens.directory_setup import DirectorySetupScreen
 from .screens.feedback import FeedbackScreen
 from .screens.model_picker import ModelPickerScreen
+from .screens.pipx_migration import PipxMigrationScreen
 from .screens.provider_config import ProviderConfigScreen
 from .screens.welcome import WelcomeScreen
 
@@ -56,14 +60,35 @@ class ShotgunApp(App[None]):
         # Track TUI startup
         from shotgun.posthog_telemetry import track_event
 
-        track_event("tui_started", {})
+        track_event(
+            "tui_started",
+            {
+                "installation_method": detect_installation_method(),
+            },
+        )
 
         self.push_screen(
             SplashScreen(), callback=lambda _arg: self.refresh_startup_screen()
         )
 
-    def refresh_startup_screen(self) -> None:
+    def refresh_startup_screen(self, skip_pipx_check: bool = False) -> None:
         """Push the appropriate screen based on configured providers."""
+        # Check for pipx installation and show migration modal first
+        if not skip_pipx_check:
+            installation_method = detect_installation_method()
+            if installation_method == "pipx":
+                if isinstance(self.screen, PipxMigrationScreen):
+                    return
+
+                # Show pipx migration modal as a blocking modal screen
+                self.push_screen(
+                    PipxMigrationScreen(),
+                    callback=lambda _arg: self.refresh_startup_screen(
+                        skip_pipx_check=True
+                    ),
+                )
+                return
+
         # Show welcome screen if no providers are configured OR if user hasn't seen it yet
         config = self.config_manager.load()
         if (

shotgun_sh-0.2.10.dev8/src/shotgun/tui/screens/pipx_migration.py

@@ -0,0 +1,153 @@
+"""Migration notice screen for pipx users."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from textual import on
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal, VerticalScroll
+from textual.screen import ModalScreen
+from textual.widgets import Button, Markdown
+
+if TYPE_CHECKING:
+    pass
+
+
+class PipxMigrationScreen(ModalScreen[None]):
+    """Modal screen warning pipx users about migration to uvx."""
+
+    CSS = """
+        PipxMigrationScreen {
+            align: center middle;
+        }
+
+        #migration-container {
+            width: 90;
+            height: auto;
+            max-height: 90%;
+            border: thick $error;
+            background: $surface;
+            padding: 2;
+        }
+
+        #migration-content {
+            height: 1fr;
+            padding: 1 0;
+        }
+
+        #buttons-container {
+            height: auto;
+            padding: 2 0 1 0;
+        }
+
+        #action-buttons {
+            width: 100%;
+            height: auto;
+            align: center middle;
+        }
+
+        .action-button {
+            margin: 0 1;
+            min-width: 20;
+        }
+    """
+
+    BINDINGS = [
+        ("escape", "dismiss", "Continue Anyway"),
+        ("ctrl+c", "app.quit", "Quit"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        """Compose the migration notice modal."""
+        with Container(id="migration-container"):
+            with VerticalScroll(id="migration-content"):
+                yield Markdown(
+                    """
+## We've Switched to uvx
+
+We've switched from `pipx` to `uvx` as the primary installation method due to critical build issues with our `kuzu` dependency.
+
+### The Problem
+Users with pipx encounter cmake build errors during installation because pip falls back to building from source instead of using pre-built binary wheels.
+
+### The Solution: uvx
+- ✅ **No build tools required** - Binary wheels enforced
+- ✅ **10-100x faster** - Much faster than pipx
+- ✅ **Better reliability** - No cmake/build errors
+
+### How to Migrate
+
+**1. Uninstall shotgun-sh from pipx:**
+```bash
+pipx uninstall shotgun-sh
+```
+
+**2. Install uv:**
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+Or with Homebrew: `brew install uv`
+
+**3. Run shotgun-sh with uvx:**
+```bash
+uvx shotgun-sh
+```
+Or install permanently: `uv tool install shotgun-sh`
+
+---
+
+### Need Help?
+
+**Discord:** https://discord.gg/5RmY6J2N7s
+
+**Full Migration Guide:** https://github.com/shotgun-sh/shotgun-sdk/blob/main/PIPX_MIGRATION.md
+"""
+                )
+
+                with Container(id="buttons-container"):
+                    with Horizontal(id="action-buttons"):
+                        yield Button(
+                            "Copy Instructions to Clipboard",
+                            variant="default",
+                            id="copy-instructions",
+                            classes="action-button",
+                        )
+                        yield Button(
+                            "Continue Anyway",
+                            variant="primary",
+                            id="continue",
+                            classes="action-button",
+                        )
+
+    def on_mount(self) -> None:
+        """Focus the continue button and ensure scroll starts at top."""
+        self.query_one("#continue", Button).focus()
+        self.query_one("#migration-content", VerticalScroll).scroll_home(animate=False)
+
+    @on(Button.Pressed, "#copy-instructions")
+    def _copy_instructions(self) -> None:
+        """Copy all migration instructions to clipboard."""
+        instructions = """# Step 1: Uninstall from pipx
+pipx uninstall shotgun-sh
+
+# Step 2: Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Step 3: Run shotgun with uvx
+uvx shotgun-sh"""
+        try:
+            import pyperclip  # type: ignore[import-untyped]  # noqa: PGH003
+
+            pyperclip.copy(instructions)
+            self.notify("Copied migration instructions to clipboard!")
+        except ImportError:
+            self.notify(
+                "Clipboard not available. See instructions above.",
+                severity="warning",
+            )
+
+    @on(Button.Pressed, "#continue")
+    def _continue(self) -> None:
+        """Dismiss the modal and continue."""
+        self.dismiss()

{shotgun_sh-0.2.10.dev6 → shotgun_sh-0.2.10.dev8}/src/shotgun/utils/update_checker.py

@@ -1,5 +1,6 @@
 """Simple auto-update functionality for shotgun-sh CLI."""
 
+import os
 import subprocess
 import sys
 import threading
@@ -20,6 +21,11 @@ def detect_installation_method() -> str:
     Returns:
         Installation method: 'uvx', 'uv-tool', 'pipx', 'pip', 'venv', or 'unknown'.
     """
+    # Check for simulation environment variable (for testing)
+    if os.getenv("PIPX_SIMULATE", "").lower() in ("true", "1"):
+        logger.debug("PIPX_SIMULATE enabled, simulating pipx installation")
+        return "pipx"
+
     # Check for uvx (ephemeral execution) by looking at executable path
     # uvx runs from a temporary cache directory
     executable = Path(sys.executable)