galangal-orchestrate 0.13.0__py3-none-any.whl

galangal/ui/tui/styles/modals.tcss

@@ -0,0 +1,197 @@
+/*
+ * Modal Styles
+ * Shared styles for all modal screens
+ */
+
+/* Base modal centering */
+PromptModal,
+TextInputModal,
+QuestionAnswerModal,
+UserQuestionsModal,
+MultilineInputModal {
+    align: center middle;
+    layout: vertical;
+}
+
+/* ============================================
+ * Prompt Modal (multi-choice selections)
+ * ============================================ */
+
+#prompt-dialog {
+    width: 90%;
+    max-width: 120;
+    min-width: 50;
+    max-height: 80%;
+    background: #3c3836;
+    border: round #504945;
+    padding: 1 2;
+    layout: vertical;
+    overflow-y: auto;
+}
+
+#prompt-message {
+    color: #ebdbb2;
+    text-style: bold;
+    margin-bottom: 1;
+    text-wrap: wrap;
+}
+
+#prompt-options {
+    color: #ebdbb2;
+}
+
+#prompt-hint {
+    color: #7c6f64;
+    margin-top: 1;
+}
+
+/* ============================================
+ * Text Input Modal (single-line)
+ * ============================================ */
+
+#text-input-dialog {
+    width: 70%;
+    max-width: 80;
+    min-width: 40;
+    background: #3c3836;
+    border: round #504945;
+    padding: 1 2;
+    layout: vertical;
+}
+
+#text-input-label {
+    color: #ebdbb2;
+    text-style: bold;
+    margin-bottom: 1;
+    text-wrap: wrap;
+}
+
+#text-input-field {
+    width: 100%;
+}
+
+#text-input-hint {
+    color: #7c6f64;
+    margin-top: 1;
+}
+
+/* ============================================
+ * Question Answer Modal (discovery Q&A)
+ * ============================================ */
+
+#qa-dialog {
+    width: 90%;
+    max-width: 100;
+    min-width: 60;
+    max-height: 85%;
+    background: #3c3836;
+    border: round #504945;
+    padding: 1 2;
+    layout: vertical;
+    overflow-y: auto;
+}
+
+#qa-title {
+    color: #fe8019;
+    text-style: bold;
+    margin-bottom: 1;
+}
+
+#qa-questions {
+    color: #a89984;
+    margin-bottom: 1;
+    padding: 0 1;
+}
+
+#qa-current-question {
+    color: #ebdbb2;
+    text-style: bold;
+    margin-bottom: 1;
+    padding: 0 1;
+}
+
+#qa-input-field {
+    width: 100%;
+    margin-bottom: 1;
+}
+
+#qa-progress {
+    color: #7c6f64;
+}
+
+#qa-hint {
+    color: #7c6f64;
+    margin-top: 1;
+}
+
+/* ============================================
+ * User Questions Modal (enter own questions)
+ * ============================================ */
+
+#user-questions-dialog {
+    width: 90%;
+    max-width: 100;
+    min-width: 50;
+    height: auto;
+    max-height: 80%;
+    background: #3c3836;
+    border: round #504945;
+    padding: 1 2;
+    layout: vertical;
+}
+
+#user-questions-label {
+    color: #ebdbb2;
+    text-style: bold;
+    margin-bottom: 1;
+    text-wrap: wrap;
+}
+
+#user-questions-field {
+    width: 100%;
+    height: 10;
+    min-height: 6;
+    background: #282828;
+    border: solid #504945;
+}
+
+#user-questions-hint {
+    color: #7c6f64;
+    margin-top: 1;
+}
+
+/* ============================================
+ * Multiline Input Modal (task descriptions)
+ * ============================================ */
+
+#multiline-input-dialog {
+    width: 90%;
+    max-width: 100;
+    min-width: 50;
+    height: auto;
+    max-height: 80%;
+    background: #3c3836;
+    border: round #504945;
+    padding: 1 2;
+    layout: vertical;
+}
+
+#multiline-input-label {
+    color: #ebdbb2;
+    text-style: bold;
+    margin-bottom: 1;
+    text-wrap: wrap;
+}
+
+#multiline-input-field {
+    width: 100%;
+    height: 12;
+    min-height: 6;
+    background: #282828;
+    border: solid #504945;
+}
+
+#multiline-input-hint {
+    color: #7c6f64;
+    margin-top: 1;
+}

galangal/ui/tui/types.py

@@ -0,0 +1,107 @@
+"""
+Activity log types for structured logging.
+
+Provides structured activity entries with level, category, and optional details
+for filtering and export capabilities.
+"""
+
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from enum import Enum
+from pathlib import Path
+
+
+class ActivityLevel(str, Enum):
+    """Log entry severity level."""
+
+    INFO = "info"
+    SUCCESS = "success"
+    WARNING = "warning"
+    ERROR = "error"
+
+
+class ActivityCategory(str, Enum):
+    """Log entry category for filtering."""
+
+    STAGE = "stage"  # Stage transitions
+    VALIDATION = "validation"  # Validation results
+    CLAUDE = "claude"  # AI backend activity
+    FILE = "file"  # File operations
+    SYSTEM = "system"  # System messages
+
+
+@dataclass
+class ActivityEntry:
+    """
+    Structured activity log entry.
+
+    Captures rich metadata about each activity for filtering,
+    display, and export purposes.
+
+    Attributes:
+        timestamp: When the activity occurred (UTC).
+        level: Severity level (info, success, warning, error).
+        category: Category for filtering (stage, validation, claude, file, system).
+        message: Human-readable message.
+        icon: Deprecated, kept for backwards compatibility.
+        details: Optional additional details (e.g., stack trace, full output).
+    """
+
+    message: str
+    level: ActivityLevel = ActivityLevel.INFO
+    category: ActivityCategory = ActivityCategory.SYSTEM
+    icon: str = "•"
+    details: str | None = None
+    timestamp: datetime = field(default_factory=lambda: datetime.now(timezone.utc))
+
+    def format_display(self, show_timestamp: bool = True) -> str:
+        """
+        Format entry for display in TUI.
+
+        Args:
+            show_timestamp: Whether to include timestamp prefix.
+
+        Returns:
+            Formatted string with Rich markup.
+        """
+        colors = {
+            ActivityLevel.INFO: "#ebdbb2",
+            ActivityLevel.SUCCESS: "#b8bb26",
+            ActivityLevel.WARNING: "#fabd2f",
+            ActivityLevel.ERROR: "#fb4934",
+        }
+        color = colors.get(self.level, "#ebdbb2")
+
+        if show_timestamp:
+            time_str = self.timestamp.strftime("%H:%M:%S")
+            return f"[#928374]{time_str}[/] [{color}]{self.message}[/]"
+        return f"[{color}]{self.message}[/]"
+
+    def format_export(self) -> str:
+        """
+        Format entry for file export (plain text).
+
+        Returns:
+            Plain text line suitable for log file.
+        """
+        time_str = self.timestamp.isoformat()
+        line = f"{time_str} [{self.level.value}] [{self.category.value}] {self.message}"
+        if self.details:
+            line += f"\n  {self.details}"
+        return line
+
+
+def export_activity_log(entries: list[ActivityEntry], path: Path) -> None:
+    """
+    Export activity log entries to a file.
+
+    Args:
+        entries: List of activity entries to export.
+        path: File path to write to.
+    """
+    with open(path, "w") as f:
+        f.write("# Activity Log Export\n")
+        f.write(f"# Generated: {datetime.now(timezone.utc).isoformat()}\n")
+        f.write(f"# Entries: {len(entries)}\n\n")
+        for entry in entries:
+            f.write(entry.format_export() + "\n")

galangal/ui/tui/widgets.py

@@ -0,0 +1,263 @@
+"""
+Custom Textual widgets for TUI display.
+"""
+
+from rich.panel import Panel
+from rich.text import Text
+from textual.reactive import reactive
+from textual.widgets import Static
+
+from galangal import __version__
+from galangal.core.state import STAGE_ORDER
+
+
+class HeaderWidget(Static):
+    """Fixed header showing task info."""
+
+    task_name: reactive[str] = reactive("")
+    stage: reactive[str] = reactive("")
+    attempt: reactive[int] = reactive(1)
+    max_retries: reactive[int] = reactive(5)
+    elapsed: reactive[str] = reactive("0:00")
+    turns: reactive[int] = reactive(0)
+    status: reactive[str] = reactive("starting")
+
+    def render(self) -> Text:
+        text = Text()
+
+        # Row 1: Task, Stage, Attempt
+        text.append("Task: ", style="#928374")
+        text.append(self.task_name[:30], style="bold #83a598")
+        text.append("  Stage: ", style="#928374")
+        text.append(f"{self.stage}", style="bold #fabd2f")
+        text.append(f" ({self.attempt}/{self.max_retries})", style="#928374")
+        text.append("  Elapsed: ", style="#928374")
+        text.append(self.elapsed, style="bold #ebdbb2")
+        text.append("  Turns: ", style="#928374")
+        text.append(str(self.turns), style="bold #b8bb26")
+        text.append(f"  v{__version__}", style="#665c54")
+
+        return text
+
+
+def _format_duration(seconds: int) -> str:
+    """Format duration in seconds to human-readable string."""
+    if seconds >= 3600:
+        hours, remainder = divmod(seconds, 3600)
+        mins, secs = divmod(remainder, 60)
+        return f"{hours}:{mins:02d}:{secs:02d}"
+    else:
+        mins, secs = divmod(seconds, 60)
+        return f"{mins}:{secs:02d}"
+
+
+class StageProgressWidget(Static):
+    """Centered stage progress bar with full names and durations."""
+
+    current_stage: reactive[str] = reactive("PM")
+    skipped_stages: reactive[frozenset] = reactive(frozenset())
+    hidden_stages: reactive[frozenset] = reactive(frozenset())
+    stage_durations: reactive[dict] = reactive({}, always_update=True)
+
+    # Full stage display names
+    STAGE_DISPLAY = {
+        "PM": "PM",
+        "DESIGN": "DESIGN",
+        "PREFLIGHT": "PREFLIGHT",
+        "DEV": "DEV",
+        "MIGRATION": "MIGRATION",
+        "TEST": "TEST",
+        "CONTRACT": "CONTRACT",
+        "QA": "QA",
+        "BENCHMARK": "BENCHMARK",
+        "SECURITY": "SECURITY",
+        "REVIEW": "REVIEW",
+        "DOCS": "DOCS",
+        "COMPLETE": "COMPLETE",
+    }
+
+    STAGE_COMPACT = {
+        "PM": "PM",
+        "DESIGN": "DSGN",
+        "PREFLIGHT": "PREF",
+        "DEV": "DEV",
+        "MIGRATION": "MIGR",
+        "TEST": "TEST",
+        "CONTRACT": "CNTR",
+        "QA": "QA",
+        "BENCHMARK": "BENCH",
+        "SECURITY": "SEC",
+        "REVIEW": "RVW",
+        "DOCS": "DOCS",
+        "COMPLETE": "DONE",
+    }
+
+    def render(self) -> Text:
+        text = Text(justify="center")
+
+        # Filter out hidden stages (task type + config skips)
+        visible_stages = [s for s in STAGE_ORDER if s.value not in self.hidden_stages]
+
+        try:
+            current_idx = next(
+                i for i, s in enumerate(visible_stages) if s.value == self.current_stage
+            )
+        except StopIteration:
+            current_idx = 0
+
+        width = self.size.width or 0
+        use_window = width and width < 70
+        use_compact = width and width < 110
+        display_names = self.STAGE_COMPACT if use_compact else self.STAGE_DISPLAY
+
+        stages = visible_stages
+        if use_window:
+            start = max(current_idx - 2, 0)
+            end = min(current_idx + 3, len(stages))
+            items: list[int | None] = []
+            if start > 0:
+                items.append(None)
+            items.extend(range(start, end))
+            if end < len(stages):
+                items.append(None)
+        else:
+            items = list(range(len(stages)))
+
+        for idx, stage_idx in enumerate(items):
+            if idx > 0:
+                text.append(" ━ ", style="#504945")
+            if stage_idx is None:
+                text.append("...", style="#504945")
+                continue
+
+            stage = stages[stage_idx]
+            name = display_names.get(stage.value, stage.value)
+
+            if stage.value in self.skipped_stages:
+                text.append(f"⊘ {name}", style="#504945 strike")
+            elif stage_idx < current_idx:
+                # Completed stage - show with duration if available
+                duration = self.stage_durations.get(stage.value)
+                if duration is not None:
+                    duration_str = _format_duration(duration)
+                    text.append(f"● {name} ", style="#b8bb26")
+                    text.append(f"({duration_str})", style="#928374")
+                else:
+                    text.append(f"● {name}", style="#b8bb26")
+            elif stage_idx == current_idx:
+                text.append(f"◉ {name}", style="bold #fabd2f")
+            else:
+                text.append(f"○ {name}", style="#504945")
+
+        return text
+
+
+class CurrentActionWidget(Static):
+    """Shows the current action with animated spinner."""
+
+    action: reactive[str] = reactive("")
+    detail: reactive[str] = reactive("")
+    spinner_frame: reactive[int] = reactive(0)
+
+    SPINNERS = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+
+    def render(self) -> Text:
+        text = Text()
+        if self.action:
+            spinner = self.SPINNERS[self.spinner_frame % len(self.SPINNERS)]
+            text.append(f"{spinner} ", style="#83a598")
+            text.append(self.action, style="bold #ebdbb2")
+            if self.detail:
+                detail = self.detail
+                width = self.size.width or 0
+                if width:
+                    reserved = len(self.action) + 4
+                    max_detail = max(width - reserved, 0)
+                    if max_detail and len(detail) > max_detail:
+                        if max_detail > 3:
+                            detail = detail[: max_detail - 3] + "..."
+                        else:
+                            detail = ""
+                if not detail:
+                    return text
+                text.append(f": {detail}", style="#928374")
+        else:
+            text.append("○ Idle", style="#504945")
+        return text
+
+
+class FilesPanelWidget(Static):
+    """Panel showing files that have been read/written."""
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self._files: list[tuple[str, str]] = []
+
+    def add_file(self, action: str, path: str) -> None:
+        """Add a file operation."""
+        entry = (action, path)
+        if entry not in self._files:
+            self._files.append(entry)
+            self.refresh()
+
+    def render(self) -> Text:
+        width = self.size.width or 24
+        divider_width = max(width - 1, 1)
+        text = Text()
+        text.append("Files\n", style="bold #928374")
+        text.append("─" * divider_width + "\n", style="#504945")
+
+        if not self._files:
+            text.append("(none yet)", style="#504945 italic")
+        else:
+            # Show last 20 files
+            for action, path in self._files[-20:]:
+                display_path = path
+                if "/" in display_path:
+                    parts = display_path.split("/")
+                    display_path = "/".join(parts[-2:])
+                max_len = max(width - 4, 1)
+                if len(display_path) > max_len:
+                    if max_len > 3:
+                        display_path = display_path[: max_len - 3] + "..."
+                    else:
+                        display_path = display_path[:max_len]
+                icon = "✏️" if action == "write" else "📖"
+                color = "#b8bb26" if action == "write" else "#83a598"
+                text.append(f"{icon} ", style=color)
+                text.append(f"{display_path}\n", style="#ebdbb2")
+
+        return text
+
+
+class ErrorPanelWidget(Static):
+    """Dedicated panel for showing current error prominently."""
+
+    error: reactive[str | None] = reactive(None)
+    details: reactive[str | None] = reactive(None)
+
+    def render(self) -> Panel | Text:
+        if not self.error:
+            return Text("")
+
+        # Build error content
+        content = Text()
+        content.append(self.error, style="bold #fb4934")
+
+        if self.details:
+            # Truncate details if too long
+            details = self.details
+            max_lines = 5
+            lines = details.split("\n")
+            if len(lines) > max_lines:
+                details = "\n".join(lines[:max_lines]) + "\n..."
+
+            content.append("\n\n", style="")
+            content.append(details, style="#ebdbb2")
+
+        return Panel(
+            content,
+            title="[bold #fb4934]Error[/]",
+            border_style="#cc241d",
+            padding=(0, 1),
+        )

galangal/validation/__init__.py

@@ -0,0 +1,5 @@
+"""Validation system."""
+
+from galangal.validation.runner import ValidationResult, ValidationRunner
+
+__all__ = ["ValidationRunner", "ValidationResult"]