@pennyfarthing/core 11.1.1 → 11.2.1

package/pennyfarthing_scripts/bikerack/sprint_panel.py

@@ -1,72 +1,435 @@
 """SprintPanel — Sprint status panel for BikeRack TUI.
 
 Story 103-6: First panel implementation proving the BasePanel vertical slice.
-Subscribes to /ws/sprint, renders sprint status as Rich table.
+Story 110-2: Added per-story cursor navigation and drill-through.
+Migrated to Textual Tree widget for native hierarchy navigation.
+Subscribes to /ws/sprint, renders sprint status with epic/story tree.
 """
 
 from __future__ import annotations
 
 from typing import Any
 
-from rich.console import Group
-from rich.table import Table
 from rich.text import Text
+from textual.app import ComposeResult
+from textual.message import Message
+from textual.widget import Widget
+from textual.widgets import Static, Tree
 
-from pennyfarthing_scripts.bikerack.base_panel import PANEL_ICONS, BasePanel
+from pennyfarthing_scripts.bikerack.base_panel import PANEL_ICONS, render_progress_bar
 
 
-class SprintPanel(BasePanel):
-    """Sprint status panel.
+def _normalize_status(status: str) -> str:
+    """Normalize status string: lowercase, strip, hyphens for separators."""
+    s = status.lower().strip().replace("_", "-") if status else ""
+    # Normalize both British and American spelling
+    if s == "cancelled":
+        s = "canceled"
+    return s
+
+
+def _is_terminal(status: str) -> bool:
+    """Return True if the normalized status is done or canceled."""
+    return _normalize_status(status) in {"done", "canceled"}
+
+
+def _status_badge(status: str) -> Text:
+    """Convert status string to styled Rich Text badge (symbol only, no text)."""
+    s = _normalize_status(status)
+    if s == "done":
+        return Text("\u2713", style="dim green")
+    if s == "canceled":
+        return Text("\u2715", style="dim")
+    if s == "in-progress":
+        return Text("\u27f3", style="bold yellow")
+    if s == "backlog":
+        return Text("\u25ef", style="dim")
+    if s == "blocked":
+        return Text("!", style="bold red")
+    if s == "review":
+        return Text("\u25ce", style="cyan")
+    return Text("\u2014", style="dim")
+
+
+def _format_assignee(email: str | None) -> str:
+    """Format an email address into a short display name.
+
+    ``"keith.avery@1898andco.io"`` → ``"K. Avery"``
+    ``None`` → ``""``
+    """
+    if not email:
+        return ""
+    local = email.split("@")[0]
+    parts = local.replace("_", ".").split(".")
+    if len(parts) < 2:
+        return parts[0].capitalize()
+    first_initial = parts[0][0].upper() if parts[0] else ""
+    last = parts[-1].capitalize()
+    return f"{first_initial}. {last}"
+
+
+def _should_expand(epic: dict[str, Any]) -> bool:
+    """Check if an epic should be expanded by default (has incomplete work).
+
+    Epics that are canceled, or whose stories are all done/canceled, collapse.
+    """
+    if _is_terminal(epic.get("status", "")):
+        return False
+    stories = epic.get("stories", [])
+    total_pts = 0
+    done_pts = 0
+    has_in_progress = False
+    for story in stories:
+        pts = story.get("points", 0)
+        if isinstance(pts, (int, float)):
+            total_pts += pts
+            if _is_terminal(story.get("status", "")):
+                done_pts += pts
+            if _normalize_status(story.get("status", "")) == "in-progress":
+                has_in_progress = True
+    return has_in_progress or done_pts < total_pts
+
+
+_EPIC_ID_WIDTH = 11  # "MSSCI-NNNNN" = 11 chars
+
+
+def _build_epic_label(
+    epic_id: str, title: str, done_pts: int, total_pts: int, jira_key: str = ""
+) -> Text:
+    """Build Rich Text label for an epic tree node."""
+    label = Text(no_wrap=True, overflow="ellipsis")
+    display_id = jira_key if jira_key else epic_id
+    if len(display_id) > _EPIC_ID_WIDTH:
+        display_id = display_id[: _EPIC_ID_WIDTH - 1] + "\u2026"
+    display_id = f"{display_id:<{_EPIC_ID_WIDTH}}"
+    label.append(display_id, style="bold cyan")
+    label.append("  ")
+    if total_pts > 0:
+        pct = int(done_pts / total_pts * 100)
+        label.append_text(render_progress_bar(pct, width=10, fill_style="dim green"))
+        label.append(f" {done_pts}/{total_pts} pts", style="dim")
+    else:
+        label.append("0 pts", style="dim")
+    label.append(f"  {title}", style="bold")
+    return label
+
+
+def _build_story_label(story: dict[str, Any], current_story_id: str) -> Text:
+    """Build Rich Text label for a story tree leaf.
+
+    Layout: ``✓  MSSCI-14952   2  Story title``
+    In-progress adds owner: ``⟳  MSSCI-15186   5  Story title  [K. Avery]``
+    Done stories are rendered entirely dim.
+    """
+    story_id = story.get("id", "")
+    title = story.get("title", "")
+    pts = story.get("points", "")
+    jira = story.get("jiraKey") or "\u2014"
+    status = _normalize_status(story.get("status", ""))
+    badge = _status_badge(story.get("status", ""))
+
+    is_done = _is_terminal(story.get("status", ""))
+    is_in_progress = status == "in-progress"
+    is_current = story_id == current_story_id
+
+    label = Text(no_wrap=True, overflow="ellipsis")
+    label.append_text(badge)
+
+    # MSSCI key flush left, fixed-width (14 chars — fits "MSSCI-NNNNN" + padding)
+    jira_padded = f"{jira:<14}"
+    label.append(f"  {jira_padded}", style="dim" if is_done else ("bold cyan" if is_current else "cyan"))
+
+    # Points right-aligned (2 chars)
+    pts_str = f"{pts:>2}" if isinstance(pts, int) else f"{pts!s:>2}"
+    label.append(f"  {pts_str}", style="dim")
+
+    # Title
+    label.append(f"  {title}", style="dim" if is_done else "")
+
+    # Owner for in-progress stories
+    if is_in_progress:
+        owner = _format_assignee(story.get("assignee"))
+        if owner:
+            label.append(f"  [{owner}]", style="dim yellow")
+
+    if is_current:
+        label.stylize("bold")
+
+    if is_done:
+        label.stylize("dim")
+
+    return label
+
+
+class SprintPanel(Widget):
+    """Sprint panel using native Textual Tree widget.
 
     Subscribes to the ``sprint`` WebSocket channel and renders
-    sprint status as a Rich table with story list, points, and velocity.
+    sprint status as a Tree with epic/story hierarchy.
+    """
+
+    DEFAULT_CSS = """
+    SprintPanel {
+        height: 1fr;
+        layout: vertical;
+    }
+    #sprint-header {
+        height: auto;
+        max-height: 3;
+        padding: 0 1;
+    }
+    #sprint-hints {
+        height: 1;
+        padding: 0 1;
+    }
+    #sprint-tree {
+        height: 1fr;
+    }
     """
 
     channel: str = "sprint"
     panel_name: str = "Sprint"
     icon: str = PANEL_ICONS["sprint"][0]
+    can_focus = True
+
+    class DataReceived(Message, bubble=False):
+        """WebSocket data received — triggers tree rebuild."""
 
-    def render_panel(self, payload: dict[str, Any]) -> Any:
-        """Render sprint data as Rich renderable.
+        def __init__(self, payload: dict[str, Any]) -> None:
+            super().__init__()
+            self.payload = payload
+
+    def __init__(self, client: Any = None, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self._client = client
+        self._last_payload: dict[str, Any] | None = None
+        self._mounted = False
+
+    def compose(self) -> ComposeResult:
+        yield Static(
+            "[dim]Waiting for sprint data...[/dim]", id="sprint-header"
+        )
+        yield Static(
+            "[dim]\u2191/\u2193:navigate  space:expand/collapse  Enter:open  j/k/e:vim nav[/dim]",
+            id="sprint-hints",
+        )
+        tree: Tree[dict[str, Any]] = Tree("Sprint", id="sprint-tree")
+        tree.show_root = False
+        tree.guide_depth = 3
+        yield tree
+
+    def on_mount(self) -> None:
+        """Subscribe to sprint channel via WS client."""
+        self._mounted = True
+        if self._client is not None and self.channel:
+            self._client.subscribe(self.channel, self._handle_ws_message)
+
+    def on_unmount(self) -> None:
+        """Mark unmounted so WS callbacks are ignored."""
+        self._mounted = False
+
+    def focus(self, scroll_visible: bool = True) -> "SprintPanel":
+        """Delegate focus to the tree widget."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+            tree.focus(scroll_visible)
+        except Exception:
+            super().focus(scroll_visible)
+        return self
+
+    # --- WebSocket message handling ---
+
+    def _handle_ws_message(self, message: dict[str, Any] | None) -> None:
+        """Handle incoming WebSocket message (called from async WS task)."""
+        if not self._mounted or message is None:
+            return
+        self._last_payload = message
+        try:
+            self.post_message(self.DataReceived(message))
+        except Exception:
+            pass
+
+    def on_sprint_panel_data_received(self, event: DataReceived) -> None:
+        """Process data in Textual message context — rebuilds tree."""
+        self._rebuild_tree(event.payload)
+
+    # --- Tree rebuild ---
+
+    def _rebuild_tree(self, payload: dict[str, Any]) -> None:
+        """Rebuild tree nodes from sprint payload, preserving expand/cursor state."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+        except Exception:
+            return
 
-        Returns a Group containing a sprint metrics header and a
-        story table with columns: ID, Title, Status, Pts, Jira.
-        """
         sprint = payload.get("sprint", {})
         metrics = payload.get("metrics", {})
         epics = payload.get("epics", [])
+        current_story_id = sprint.get("currentStory", "")
 
-        # Sprint metrics header
+        # Update header
         sprint_num = sprint.get("number", "")
         done = sprint.get("done", 0)
         remaining = sprint.get("remaining", 0)
         in_progress = sprint.get("inProgress", 0)
         velocity = metrics.get("velocity", 0)
-
-        header = Text.from_markup(
+        header_text = Text.from_markup(
             f"Sprint {sprint_num}  "
             f"[green]Done: {done}[/green] | "
             f"Remaining: {remaining} | "
             f"In Progress: {in_progress} | "
             f"Velocity: {velocity}"
         )
+        try:
+            self.query_one("#sprint-header", Static).update(header_text)
+        except Exception:
+            pass
 
-        # Story table
-        table = Table(title=sprint.get("name", "Sprint"))
-        table.add_column("ID", style="cyan")
-        table.add_column("Title")
-        table.add_column("Status")
-        table.add_column("Pts", justify="right")
-        table.add_column("Jira", style="dim")
+        # Save expand state from current tree nodes
+        saved_expanded: dict[str, bool] = {}
+        for node in tree.root.children:
+            data = node.data
+            if data and data.get("type") == "epic":
+                saved_expanded[data["id"]] = node.is_expanded
+
+        # Save cursor position by node identity
+        cursor_node_key: str | None = None
+        try:
+            highlighted = tree.get_node_at_line(tree.cursor_line)
+            if highlighted and highlighted.data:
+                data = highlighted.data
+                if data.get("type") == "epic":
+                    cursor_node_key = f"epic:{data['id']}"
+                elif data.get("type") == "story":
+                    cursor_node_key = f"story:{data['story'].get('id', '')}"
+        except Exception:
+            pass
+
+        # Rebuild tree
+        tree.clear()
+        cursor_target = None
 
         for epic in epics:
-            for story in epic.get("stories", []):
-                table.add_row(
-                    story.get("id", ""),
-                    story.get("title", ""),
-                    story.get("status", ""),
-                    str(story.get("points", "")),
-                    story.get("jiraKey") or "—",
-                )
-
-        return Group(header, table)
+            epic_id = epic.get("id", "")
+            epic_title = epic.get("title", "")
+            stories = epic.get("stories", [])
+
+            # Calculate epic progress (canceled counts as done)
+            total_pts = 0
+            done_pts = 0
+            for story in stories:
+                pts = story.get("points", 0)
+                if isinstance(pts, (int, float)):
+                    total_pts += pts
+                    if _is_terminal(story.get("status", "")):
+                        done_pts += pts
+
+            label = _build_epic_label(
+                epic_id, epic_title, done_pts, total_pts,
+                jira_key=epic.get("jiraKey", ""),
+            )
+            epic_data: dict[str, Any] = {
+                "type": "epic",
+                "id": epic_id,
+                "title": epic_title,
+            }
+            epic_node = tree.root.add(label, data=epic_data)
+
+            # Add story leaves
+            for story in stories:
+                story_label = _build_story_label(story, current_story_id)
+                story_data: dict[str, Any] = {"type": "story", "story": story}
+                story_node = epic_node.add_leaf(story_label, data=story_data)
+
+                if cursor_node_key == f"story:{story.get('id', '')}":
+                    cursor_target = story_node
+
+            # Restore expand state or apply default
+            if epic_id in saved_expanded:
+                if saved_expanded[epic_id]:
+                    epic_node.expand()
+                else:
+                    epic_node.collapse()
+            elif _should_expand(epic):
+                epic_node.expand()
+
+            if cursor_node_key == f"epic:{epic_id}":
+                cursor_target = epic_node
+
+        # Restore cursor position
+        if cursor_target is not None:
+            try:
+                tree.move_cursor(cursor_target)
+            except Exception:
+                pass
+
+    # --- Tree event handling ---
+
+    def on_tree_node_selected(self, event: Tree.NodeSelected) -> None:
+        """Handle enter on a tree node: drill into story or toggle epic."""
+        data = event.node.data
+        if not data:
+            return
+        if data.get("type") == "story":
+            story = data["story"]
+            from pennyfarthing_scripts.bikerack.story_detail_screen import (
+                StoryDetailScreen,
+            )
+
+            try:
+                self.app.push_screen(StoryDetailScreen(story_data=story))
+            except Exception:
+                pass
+        elif data.get("type") == "epic":
+            event.node.toggle()
+
+    # --- Compatibility methods for app-level bindings ---
+
+    def next_epic(self) -> None:
+        """Move cursor down — compat wrapper for app j binding."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+            tree.action_cursor_down()
+        except Exception:
+            pass
+
+    def prev_epic(self) -> None:
+        """Move cursor up — compat wrapper for app k binding."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+            tree.action_cursor_up()
+        except Exception:
+            pass
+
+    def toggle_epic(self) -> None:
+        """Toggle current node — compat wrapper for app e binding."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+            tree.action_toggle_node()
+        except Exception:
+            pass
+
+    def get_selected_story(self) -> dict[str, Any] | None:
+        """Return the currently highlighted story data, or None."""
+        try:
+            tree = self.query_one("#sprint-tree", Tree)
+            node = tree.get_node_at_line(tree.cursor_line)
+            if node and node.data and node.data.get("type") == "story":
+                return node.data["story"]
+        except Exception:
+            pass
+        return None
+
+    def drill_into_story(self) -> None:
+        """Push StoryDetailScreen for the highlighted story."""
+        story = self.get_selected_story()
+        if story is None:
+            return
+        from pennyfarthing_scripts.bikerack.story_detail_screen import (
+            StoryDetailScreen,
+        )
+
+        try:
+            self.app.push_screen(StoryDetailScreen(story_data=story))
+        except Exception:
+            pass