shotgun-sh 0.2.17__py3-none-any.whl → 0.4.0.dev1__py3-none-any.whl

shotgun/tui/screens/onboarding.py

@@ -5,9 +5,12 @@ import webbrowser
 from textual import on
 from textual.app import ComposeResult
 from textual.containers import Container, Horizontal, VerticalScroll
+from textual.events import Resize
 from textual.screen import ModalScreen
 from textual.widgets import Button, Markdown, Static
 
+from shotgun.tui.layout import COMPACT_HEIGHT_THRESHOLD, TINY_HEIGHT_THRESHOLD
+
 
 class OnboardingModal(ModalScreen[None]):
     """Multi-page onboarding modal for new users.
@@ -120,6 +123,80 @@ class OnboardingModal(ModalScreen[None]):
             padding: 0;
             margin: 2 0 1 0;
         }
+
+        /* Tiny screen fallback */
+        #tiny-screen-container {
+            display: none;
+            width: auto;
+            height: auto;
+            padding: 1 2;
+            background: $surface;
+            text-align: center;
+        }
+
+        #tiny-screen-message {
+            padding: 1 0;
+        }
+
+        #tiny-screen-link {
+            padding: 1 0;
+            color: $accent;
+        }
+
+        /* Compact styles for short terminals */
+        #onboarding-container.compact {
+            padding: 1;
+            max-height: 98%;
+        }
+
+        #progress-sidebar.compact {
+            padding: 0;
+        }
+
+        .progress-item.compact {
+            padding: 0;
+        }
+
+        #onboarding-header.compact {
+            padding-bottom: 0;
+        }
+
+        #onboarding-content.compact {
+            padding: 0;
+        }
+
+        #page-indicator.compact {
+            padding: 0;
+        }
+
+        #buttons-container.compact {
+            padding: 0;
+        }
+
+        #resource-sections.compact {
+            padding: 0;
+        }
+
+        #resource-sections.compact Button {
+            margin: 0 0 1 0;
+        }
+
+        #video-section.compact {
+            margin: 0;
+        }
+
+        #docs-section.compact {
+            margin: 1 0 0 0;
+        }
+
+        /* Tiny mode - hide full onboarding, show minimal message */
+        OnboardingModal.tiny #onboarding-container {
+            display: none;
+        }
+
+        OnboardingModal.tiny #tiny-screen-container {
+            display: block;
+        }
     """
 
     BINDINGS = [
@@ -143,6 +220,20 @@ class OnboardingModal(ModalScreen[None]):
 
     def compose(self) -> ComposeResult:
         """Compose the onboarding modal."""
+        # Tiny screen fallback - shown when terminal is too small
+        with Container(id="tiny-screen-container"):
+            yield Static(
+                "Your screen is too small for the onboarding wizard.",
+                id="tiny-screen-message",
+            )
+            yield Static(
+                "[@click=screen.open_usage_guide]View usage instructions[/]",
+                id="tiny-screen-link",
+                markup=True,
+            )
+            yield Button("Start Shotgunning", id="tiny-close-button")
+
+        # Full onboarding container
         with Container(id="onboarding-container"):
             # Left sidebar for progress tracking
             with Container(id="progress-sidebar"):
@@ -192,6 +283,63 @@ class OnboardingModal(ModalScreen[None]):
     def on_mount(self) -> None:
         """Set up the modal after mounting."""
         self.update_page()
+        # Apply layout based on terminal height
+        self._apply_layout_for_height(self.app.size.height)
+
+    @on(Resize)
+    def handle_resize(self, event: Resize) -> None:
+        """Adjust layout based on terminal height."""
+        self._apply_layout_for_height(event.size.height)
+
+    def _apply_layout_for_height(self, height: int) -> None:
+        """Apply appropriate layout based on terminal height."""
+        if height < TINY_HEIGHT_THRESHOLD:
+            self.add_class("tiny")
+            self.remove_class("compact")
+        elif height < COMPACT_HEIGHT_THRESHOLD:
+            self.remove_class("tiny")
+            self._apply_compact_classes(True)
+        else:
+            self.remove_class("tiny")
+            self._apply_compact_classes(False)
+
+    def _apply_compact_classes(self, compact: bool) -> None:
+        """Apply or remove compact layout classes."""
+        container = self.query_one("#onboarding-container")
+        sidebar = self.query_one("#progress-sidebar")
+        header = self.query_one("#onboarding-header")
+        content = self.query_one("#onboarding-content")
+        page_indicator = self.query_one("#page-indicator")
+        buttons_container = self.query_one("#buttons-container")
+        resource_sections = self.query_one("#resource-sections")
+        progress_items = self.query(".progress-item")
+
+        if compact:
+            container.add_class("compact")
+            sidebar.add_class("compact")
+            header.add_class("compact")
+            content.add_class("compact")
+            page_indicator.add_class("compact")
+            buttons_container.add_class("compact")
+            resource_sections.add_class("compact")
+            for item in progress_items:
+                item.add_class("compact")
+        else:
+            container.remove_class("compact")
+            sidebar.remove_class("compact")
+            header.remove_class("compact")
+            content.remove_class("compact")
+            page_indicator.remove_class("compact")
+            buttons_container.remove_class("compact")
+            resource_sections.remove_class("compact")
+            for item in progress_items:
+                item.remove_class("compact")
+
+    def action_open_usage_guide(self) -> None:
+        """Open the usage guide in browser."""
+        webbrowser.open(
+            "https://github.com/shotgun-sh/shotgun?tab=readme-ov-file#-usage"
+        )
 
     def update_page(self) -> None:
         """Update the displayed page content and navigation buttons."""
@@ -279,40 +427,45 @@ Here are some helpful resources to get you up to speed with Shotgun:
 """
 
     def _page_2_modes(self) -> str:
-        """Page 2: Explanation of the 5 modes."""
+        """Page 2: Explanation of the Router and its modes."""
         return """
-## Understanding Shotgun's 5 Modes
-
-Shotgun has 5 specialized modes, each designed for specific tasks. Each mode writes to its own dedicated file in `.shotgun/`:
+## Understanding Shotgun's Router
 
-### 🔬 Research Mode
-Research topics with web search and synthesize findings. Perfect for gathering information and exploring new concepts.
+Shotgun uses an intelligent **Router** that orchestrates your workflow automatically. Just describe what you need, and the Router will coordinate research, specifications, planning, and tasks for you.
 
-**Writes to:** `.shotgun/research.md`
+### Two Operating Modes
 
-### 📝 Specify Mode
-Create detailed specifications and requirements documents. Great for planning features and documenting requirements.
+The Router operates in two modes, which you can toggle with `Shift+Tab`:
 
-**Writes to:** `.shotgun/specification.md`
+### 📋 Planning Mode (Default)
+- **Incremental execution**: Does one step at a time
+- **Asks clarifying questions** before complex tasks
+- **Shows plan for approval** before executing multi-step work
+- **Confirms before cascading** changes to dependent files
 
-### 📋 Plan Mode
-Create comprehensive, actionable plans with milestones. Ideal for breaking down large projects into manageable steps.
+Best for: Complex tasks, learning the workflow, staying in control
 
-**Writes to:** `.shotgun/plan.md`
+### ✍️ Drafting Mode
+- **Auto-executes** plans without stopping for approval
+- **Makes reasonable assumptions** instead of asking questions
+- **Updates all dependent files** automatically
 
-### ✅ Tasks Mode
-Generate specific, actionable tasks from research and plans. Best for getting concrete next steps and action items.
+Best for: Routine tasks, experienced users, speed-focused work
 
-**Writes to:** `.shotgun/tasks.md`
+---
 
-### 📤 Export Mode
-Export artifacts and findings to various formats. Creates documentation like Claude.md (AI instructions), Agent.md (agent specs), PRDs, and other deliverables. Can write to any file in `.shotgun/` except the mode-specific files above.
+### Files Created
 
-**Writes to:** `.shotgun/Claude.md`, `.shotgun/Agent.md`, `.shotgun/PRD.md`, etc.
+The Router manages these files in `.shotgun/`:
+- `research.md` - Research findings
+- `specification.md` - Detailed specifications
+- `plan.md` - Implementation plans
+- `tasks.md` - Actionable task lists
+- `exports/` - Documentation exports
 
 ---
 
-**Tip:** You can switch between modes using `Shift+Tab` or `Ctrl+P` to open the command palette!
+**Tip:** Press `Shift+Tab` to toggle between Planning and Drafting modes!
 """
 
     def _page_3_prompts(self) -> str:
@@ -337,12 +490,11 @@ Provide relevant context about what you're trying to accomplish:
 
 > "I'm working on the payment flow. I need to add support for refunds."
 
-### 4. Use the Right Mode
-Switch to the appropriate mode for your task:
-- Use **Research** for exploration
-- Use **Specify** for requirements
-- Use **Plan** for implementation strategy
-- Use **Tasks** for actionable next steps
+### 4. Let the Router Guide You
+The Router will automatically coordinate the right workflow:
+- Describe what you want to accomplish
+- In Planning mode, it will ask clarifying questions first
+- In Drafting mode, it will execute immediately
 
 ---
 
@@ -412,6 +564,7 @@ Intelligently compress the conversation history while preserving important conte
             self.dismiss()
 
     @on(Button.Pressed, "#close-button")
+    @on(Button.Pressed, "#tiny-close-button")
     def handle_close(self) -> None:
         """Handle close button press."""
         self.dismiss()

shotgun/tui/screens/pipx_migration.py

@@ -7,8 +7,11 @@ from typing import TYPE_CHECKING
 from textual import on
 from textual.app import ComposeResult
 from textual.containers import Container, Horizontal, VerticalScroll
+from textual.events import Resize
 from textual.screen import ModalScreen
-from textual.widgets import Button, Markdown
+from textual.widgets import Button, Label, Markdown
+
+from shotgun.tui.layout import COMPACT_HEIGHT_THRESHOLD
 
 if TYPE_CHECKING:
     pass
@@ -51,6 +54,31 @@ class PipxMigrationScreen(ModalScreen[None]):
             margin: 0 1;
             min-width: 20;
         }
+
+        #migration-status {
+            height: auto;
+            padding: 1;
+            min-height: 1;
+            text-align: center;
+        }
+
+        /* Compact styles for short terminals */
+        #migration-container.compact {
+            padding: 1;
+            max-height: 98%;
+        }
+
+        #migration-content.compact {
+            padding: 0;
+        }
+
+        #buttons-container.compact {
+            padding: 1 0 0 0;
+        }
+
+        #migration-status.compact {
+            padding: 0;
+        }
     """
 
     BINDINGS = [
@@ -106,6 +134,7 @@ Or install permanently: `uv tool install shotgun-sh`
                 )
 
                 with Container(id="buttons-container"):
+                    yield Label("", id="migration-status")
                     with Horizontal(id="action-buttons"):
                         yield Button(
                             "Copy Instructions to Clipboard",
@@ -124,6 +153,31 @@ Or install permanently: `uv tool install shotgun-sh`
         """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)
+        # Apply compact layout if starting in a short terminal
+        self._apply_compact_layout(self.app.size.height < COMPACT_HEIGHT_THRESHOLD)
+
+    @on(Resize)
+    def handle_resize(self, event: Resize) -> None:
+        """Adjust layout based on terminal height."""
+        self._apply_compact_layout(event.size.height < COMPACT_HEIGHT_THRESHOLD)
+
+    def _apply_compact_layout(self, compact: bool) -> None:
+        """Apply or remove compact layout classes for short terminals."""
+        container = self.query_one("#migration-container")
+        content = self.query_one("#migration-content")
+        buttons_container = self.query_one("#buttons-container")
+        status = self.query_one("#migration-status")
+
+        if compact:
+            container.add_class("compact")
+            content.add_class("compact")
+            buttons_container.add_class("compact")
+            status.add_class("compact")
+        else:
+            container.remove_class("compact")
+            content.remove_class("compact")
+            buttons_container.remove_class("compact")
+            status.remove_class("compact")
 
     @on(Button.Pressed, "#copy-instructions")
     def _copy_instructions(self) -> None:
@@ -136,16 +190,14 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 
 # Step 3: Run shotgun with uvx
 uvx shotgun-sh"""
+        status_label = self.query_one("#migration-status", Label)
         try:
             import pyperclip  # type: ignore[import-untyped]  # noqa: PGH003
 
             pyperclip.copy(instructions)
-            self.notify("Copied migration instructions to clipboard!")
+            status_label.update("✓ Copied migration instructions to clipboard!")
         except ImportError:
-            self.notify(
-                "Clipboard not available. See instructions above.",
-                severity="warning",
-            )
+            status_label.update("⚠️ Clipboard not available. See instructions above.")
 
     @on(Button.Pressed, "#continue")
     def _continue(self) -> None:

shotgun/tui/screens/provider_config.py

@@ -7,11 +7,13 @@ from typing import TYPE_CHECKING, cast
 from textual import on
 from textual.app import ComposeResult
 from textual.containers import Horizontal, Vertical
+from textual.events import Resize
 from textual.reactive import reactive
 from textual.screen import Screen
 from textual.widgets import Button, Input, Label, ListItem, ListView, Markdown, Static
 
 from shotgun.agents.config import ConfigManager, ProviderType
+from shotgun.tui.layout import COMPACT_HEIGHT_THRESHOLD
 
 if TYPE_CHECKING:
     from ..app import ShotgunApp
@@ -77,6 +79,38 @@ class ProviderConfigScreen(Screen[None]):
         #provider-list {
             padding: 1;
         }
+        #provider-status {
+            height: auto;
+            padding: 0 1;
+            min-height: 1;
+        }
+        #provider-status.error {
+            color: $error;
+        }
+
+        /* Compact styles for short terminals */
+        ProviderConfigScreen.compact #titlebox {
+            margin: 0;
+            padding: 0;
+            border: none;
+        }
+
+        ProviderConfigScreen.compact #provider-config-summary {
+            display: none;
+        }
+
+        ProviderConfigScreen.compact #provider-links {
+            display: none;
+        }
+
+        ProviderConfigScreen.compact #provider-list {
+            margin: 0;
+            padding: 0;
+        }
+
+        ProviderConfigScreen.compact #provider-actions {
+            padding: 0;
+        }
     """
 
     BINDINGS = [
@@ -103,6 +137,7 @@ class ProviderConfigScreen(Screen[None]):
             password=True,
             id="api-key",
         )
+        yield Label("", id="provider-status")
         with Horizontal(id="provider-actions"):
             yield Button("Save key \\[ENTER]", variant="primary", id="save")
             yield Button("Authenticate", variant="success", id="authenticate")
@@ -122,6 +157,21 @@ class ProviderConfigScreen(Screen[None]):
         # Refresh UI asynchronously
         self.run_worker(self._refresh_ui(), exclusive=False)
 
+        # Apply layout based on terminal height
+        self._apply_layout_for_height(self.app.size.height)
+
+    @on(Resize)
+    def handle_resize(self, event: Resize) -> None:
+        """Adjust layout based on terminal height."""
+        self._apply_layout_for_height(event.size.height)
+
+    def _apply_layout_for_height(self, height: int) -> None:
+        """Apply appropriate layout based on terminal height."""
+        if height < COMPACT_HEIGHT_THRESHOLD:
+            self.add_class("compact")
+        else:
+            self.remove_class("compact")
+
     def on_screenresume(self) -> None:
         """Refresh provider status when screen is resumed.
 
@@ -280,9 +330,11 @@ class ProviderConfigScreen(Screen[None]):
         """Async implementation of API key saving."""
         input_widget = self.query_one("#api-key", Input)
         api_key = input_widget.value.strip()
+        status_label = self.query_one("#provider-status", Label)
 
         if not api_key:
-            self.notify("Enter an API key before saving.", severity="error")
+            status_label.update("❌ Enter an API key before saving.")
+            status_label.add_class("error")
             return
 
         try:
@@ -291,25 +343,29 @@ class ProviderConfigScreen(Screen[None]):
                 api_key=api_key,
             )
         except Exception as exc:  # pragma: no cover - defensive; textual path
-            self.notify(f"Failed to save key: {exc}", severity="error")
+            status_label.update(f"❌ Failed to save key: {exc}")
+            status_label.add_class("error")
             return
 
         input_widget.value = ""
         await self.refresh_provider_status()
         await self._update_done_button_visibility()
-        self.notify(
-            f"Saved API key for {self._provider_display_name(self.selected_provider)}."
+        status_label.update(
+            f"✓ Saved API key for {self._provider_display_name(self.selected_provider)}."
         )
+        status_label.remove_class("error")
 
     def _clear_api_key(self) -> None:
         self.run_worker(self._do_clear_api_key(), exclusive=True)
 
     async def _do_clear_api_key(self) -> None:
         """Async implementation of API key clearing."""
+        status_label = self.query_one("#provider-status", Label)
         try:
             await self.config_manager.clear_provider_key(self.selected_provider)
         except Exception as exc:  # pragma: no cover - defensive; textual path
-            self.notify(f"Failed to clear key: {exc}", severity="error")
+            status_label.update(f"❌ Failed to clear key: {exc}")
+            status_label.add_class("error")
             return
 
         await self.refresh_provider_status()
@@ -321,9 +377,10 @@ class ProviderConfigScreen(Screen[None]):
             auth_button = self.query_one("#authenticate", Button)
             auth_button.display = True
 
-        self.notify(
-            f"Cleared API key for {self._provider_display_name(self.selected_provider)}."
+        status_label.update(
+            f"✓ Cleared API key for {self._provider_display_name(self.selected_provider)}."
         )
+        status_label.remove_class("error")
 
     async def _start_shotgun_auth(self) -> None:
         """Launch Shotgun Account authentication flow."""
@@ -335,4 +392,5 @@ class ProviderConfigScreen(Screen[None]):
         # Refresh provider status after auth completes
         if result:
             await self.refresh_provider_status()
-            # Notify handled by auth screen
+            # Auto-dismiss provider config screen after successful auth
+            self.dismiss()

shotgun/tui/screens/shared_specs/__init__.py

@@ -0,0 +1,21 @@
+"""Shared specs TUI screens and dialogs."""
+
+from shotgun.tui.screens.shared_specs.create_spec_dialog import CreateSpecDialog
+from shotgun.tui.screens.shared_specs.models import (
+    CreateSpecResult,
+    ShareSpecsAction,
+    ShareSpecsResult,
+    UploadScreenResult,
+)
+from shotgun.tui.screens.shared_specs.share_specs_dialog import ShareSpecsDialog
+from shotgun.tui.screens.shared_specs.upload_progress_screen import UploadProgressScreen
+
+__all__ = [
+    "CreateSpecDialog",
+    "CreateSpecResult",
+    "ShareSpecsAction",
+    "ShareSpecsDialog",
+    "ShareSpecsResult",
+    "UploadProgressScreen",
+    "UploadScreenResult",
+]