ralph-code 0.5.0__py3-none-any.whl

ralph/claude_runner.py

@@ -0,0 +1,22 @@
+"""Claude Code CLI integration for ralph-coding application.
+
+This module is deprecated. Use harness_runner instead.
+Maintained for backwards compatibility.
+"""
+
+# Re-export everything from harness_runner for backwards compatibility
+from .harness_runner import (
+    HarnessResponse as ClaudeResponse,
+    HarnessRunner as ClaudeRunner,
+    HarnessResponse,
+    HarnessRunner,
+    HARNESS_MODEL_MAPPING,
+)
+
+__all__ = [
+    "ClaudeResponse",
+    "ClaudeRunner",
+    "HarnessResponse",
+    "HarnessRunner",
+    "HARNESS_MODEL_MAPPING",
+]

ralph/colors.py

@@ -0,0 +1,183 @@
+"""Nord Theme color constants for ralph-coding.
+
+This module defines the complete Nord Theme color palette (16 colors) for use
+throughout the application. Colors are organized into four semantic groups:
+
+POLAR NIGHT (Background colors):
+    NORD0-NORD3: Dark background colors, from darkest to lightest.
+    Use for backgrounds, panels, and UI chrome.
+    - NORD0: Main background
+    - NORD1: Elevated surfaces, secondary backgrounds
+    - NORD2: Selections, highlights, UI borders
+    - NORD3: Comments, inactive elements, subtle text
+
+SNOW STORM (Foreground colors):
+    NORD4-NORD6: Light text colors, from dimmest to brightest.
+    Use for text and foreground elements.
+    - NORD4: Main text color
+    - NORD5: Brighter text, emphasis
+    - NORD6: Brightest text, maximum contrast
+
+FROST (Accent colors):
+    NORD7-NORD10: Cool accent colors for interactive elements.
+    - NORD7 (FROST_TEAL): Success states, secondary accents
+    - NORD8 (FROST_CYAN): Primary accent, highlights, links
+    - NORD9 (FROST_LIGHT_BLUE): Tertiary accents, decorative
+    - NORD10 (FROST_BLUE): Primary buttons, key UI elements
+
+AURORA (State colors):
+    NORD11-NORD15: Vivid colors for semantic states.
+    - NORD11 (AURORA_RED): Errors, destructive actions, critical
+    - NORD12 (AURORA_ORANGE): Warnings, caution states
+    - NORD13 (AURORA_YELLOW): Attention, pending states, in-progress
+    - NORD14 (AURORA_GREEN): Success, completed, positive states
+    - NORD15 (AURORA_PURPLE): Special, info, accent states
+
+Color Mappings for Application States:
+    - Idle/Inactive: NORD3 (dim polar night)
+    - Pending: NORD13 (aurora yellow)
+    - In Progress: NORD8 (frost cyan) or NORD13 (aurora yellow)
+    - Success/Complete: NORD14 (aurora green)
+    - Error/Failed: NORD11 (aurora red)
+    - Warning: NORD12 (aurora orange)
+    - Info/Special: NORD15 (aurora purple)
+
+Usage Example:
+    from ralph.colors import NORD8, AURORA_GREEN, POLAR_NIGHT_0
+
+    # Use hex values directly
+    print(f"Primary accent: {NORD8}")
+
+    # Use semantic aliases
+    print(f"Success color: {AURORA_GREEN}")
+"""
+
+from typing import Final
+
+# =============================================================================
+# POLAR NIGHT - Background Colors
+# =============================================================================
+# Dark base colors for backgrounds and UI surfaces
+
+NORD0: Final[str] = "#2E3440"
+"""Darkest background - main application background."""
+
+NORD1: Final[str] = "#3B4252"
+"""Elevated surfaces - panels, cards, secondary backgrounds."""
+
+NORD2: Final[str] = "#434C5E"
+"""Selection backgrounds - highlights, UI borders, dividers."""
+
+NORD3: Final[str] = "#4C566A"
+"""Comments and inactive - subtle text, disabled states."""
+
+# Semantic aliases for Polar Night
+POLAR_NIGHT_0: Final[str] = NORD0
+POLAR_NIGHT_1: Final[str] = NORD1
+POLAR_NIGHT_2: Final[str] = NORD2
+POLAR_NIGHT_3: Final[str] = NORD3
+
+# Functional aliases for backgrounds
+BG_PRIMARY: Final[str] = NORD0
+BG_SECONDARY: Final[str] = NORD1
+BG_HIGHLIGHT: Final[str] = NORD2
+BG_COMMENT: Final[str] = NORD3
+
+# =============================================================================
+# SNOW STORM - Foreground Colors
+# =============================================================================
+# Light colors for text and foreground elements
+
+NORD4: Final[str] = "#D8DEE9"
+"""Main text color - standard foreground text."""
+
+NORD5: Final[str] = "#E5E9F0"
+"""Brighter text - emphasis, important content."""
+
+NORD6: Final[str] = "#ECEFF4"
+"""Brightest text - maximum contrast, headings."""
+
+# Semantic aliases for Snow Storm
+SNOW_STORM_0: Final[str] = NORD4
+SNOW_STORM_1: Final[str] = NORD5
+SNOW_STORM_2: Final[str] = NORD6
+
+# Functional aliases for foregrounds
+FG_PRIMARY: Final[str] = NORD4
+FG_BRIGHT: Final[str] = NORD5
+FG_BRIGHTEST: Final[str] = NORD6
+
+# =============================================================================
+# FROST - Accent Colors
+# =============================================================================
+# Cool accent colors for interactive and decorative elements
+
+NORD7: Final[str] = "#8FBCBB"
+"""Frost teal - secondary accents, success indicators."""
+
+NORD8: Final[str] = "#88C0D0"
+"""Frost cyan - primary accent, highlights, links."""
+
+NORD9: Final[str] = "#81A1C1"
+"""Frost light blue - tertiary accents, decorative elements."""
+
+NORD10: Final[str] = "#5E81AC"
+"""Frost blue - primary buttons, key interactive elements."""
+
+# Semantic aliases for Frost
+FROST_TEAL: Final[str] = NORD7
+FROST_CYAN: Final[str] = NORD8
+FROST_LIGHT_BLUE: Final[str] = NORD9
+FROST_BLUE: Final[str] = NORD10
+
+# Functional aliases for accents
+ACCENT_PRIMARY: Final[str] = NORD8
+ACCENT_SECONDARY: Final[str] = NORD7
+ACCENT_TERTIARY: Final[str] = NORD9
+ACCENT_BUTTON: Final[str] = NORD10
+
+# =============================================================================
+# AURORA - State Colors
+# =============================================================================
+# Vivid colors for semantic states and feedback
+
+NORD11: Final[str] = "#BF616A"
+"""Aurora red - errors, destructive actions, critical alerts."""
+
+NORD12: Final[str] = "#D08770"
+"""Aurora orange - warnings, caution states, attention needed."""
+
+NORD13: Final[str] = "#EBCB8B"
+"""Aurora yellow - pending states, in-progress, highlights."""
+
+NORD14: Final[str] = "#A3BE8C"
+"""Aurora green - success, completed, positive confirmation."""
+
+NORD15: Final[str] = "#B48EAD"
+"""Aurora purple - special states, info, accent highlights."""
+
+# Semantic aliases for Aurora
+AURORA_RED: Final[str] = NORD11
+AURORA_ORANGE: Final[str] = NORD12
+AURORA_YELLOW: Final[str] = NORD13
+AURORA_GREEN: Final[str] = NORD14
+AURORA_PURPLE: Final[str] = NORD15
+
+# Functional aliases for states
+STATE_ERROR: Final[str] = NORD11
+STATE_WARNING: Final[str] = NORD12
+STATE_PENDING: Final[str] = NORD13
+STATE_SUCCESS: Final[str] = NORD14
+STATE_INFO: Final[str] = NORD15
+
+# =============================================================================
+# All colors tuple for iteration
+# =============================================================================
+
+ALL_NORD_COLORS: Final[tuple[str, ...]] = (
+    NORD0, NORD1, NORD2, NORD3,      # Polar Night
+    NORD4, NORD5, NORD6,              # Snow Storm
+    NORD7, NORD8, NORD9, NORD10,      # Frost
+    NORD11, NORD12, NORD13, NORD14, NORD15,  # Aurora
+)
+"""All 16 Nord colors in order (NORD0-NORD15)."""

ralph/config.py

@@ -0,0 +1,227 @@
+"""Configuration management for ralph-coding application."""
+
+import json
+from pathlib import Path
+from typing import Any, Literal
+
+from .storage import get_config_path
+
+
+ErrorMode = Literal["block", "retry", "pause", "skip"]
+
+
+DEFAULT_CONFIG = {
+    "harness": "claude",
+    "worker_model": "opus",
+    "summary_model": "haiku",
+    "max_iterations": 10,
+    "max_story_attempts": 3,
+    "auto_spec_without_oversight": True,
+    "wait_on_rate_limit": True,
+    "pause_on_completion": True,
+    "always_build_tests": False,
+    "branch_prefix": "ralph",
+    "on_error": "block",
+}
+
+
+class Config:
+    """Global configuration manager for ralph-coding."""
+
+    def __init__(self) -> None:
+        self._config: dict[str, Any] = {}
+        self._load()
+
+    def _load(self) -> None:
+        """Load configuration from disk, using defaults for missing values."""
+        config_path = get_config_path()
+        needs_save = False
+
+        if config_path.exists():
+            try:
+                with open(config_path, "r", encoding="utf-8") as f:
+                    self._config = json.load(f)
+            except (json.JSONDecodeError, IOError):
+                self._config = {}
+
+        # Migration: convert old 'claude_binary' key to 'harness'
+        if "claude_binary" in self._config and "harness" not in self._config:
+            self._config["harness"] = self._config.pop("claude_binary")
+            needs_save = True
+
+        # Migration: map old 'model' key to worker_model
+        if "model" in self._config and "worker_model" not in self._config:
+            self._config["worker_model"] = self._config["model"]
+            needs_save = True
+        if "model" in self._config:
+            self._config.pop("model", None)
+            needs_save = True
+
+        # Set worker model if missing (based on harness defaults)
+        if "worker_model" not in self._config:
+            harness = self._config.get("harness", DEFAULT_CONFIG["harness"])
+            if harness == "codex":
+                self._config["worker_model"] = "gpt-5.2-codex"
+            else:
+                self._config["worker_model"] = "opus"
+            needs_save = True
+
+        # Set summary model if missing (based on harness defaults)
+        if "summary_model" not in self._config:
+            harness = self._config.get("harness", DEFAULT_CONFIG["harness"])
+            if harness == "codex":
+                self._config["summary_model"] = "gpt-5.2"
+            else:
+                self._config["summary_model"] = "haiku"
+            needs_save = True
+
+        # Apply defaults for any missing keys
+        for key, default in DEFAULT_CONFIG.items():
+            if key not in self._config:
+                self._config[key] = default
+
+        # Save if migration was performed
+        if needs_save:
+            self._save()
+
+    def _save(self) -> None:
+        """Save configuration to disk."""
+        config_path = get_config_path()
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(config_path, "w", encoding="utf-8") as f:
+            json.dump(self._config, f, indent=2, ensure_ascii=False)
+
+    @property
+    def harness(self) -> str:
+        """Path to the harness CLI tool (e.g., claude, aider)."""
+        return str(self._config["harness"])
+
+    @harness.setter
+    def harness(self, value: str) -> None:
+        self._config["harness"] = value
+        self._save()
+
+    @property
+    def worker_model(self) -> str:
+        """Model to use for implementation (harness-specific model names)."""
+        return str(self._config["worker_model"])
+
+    @worker_model.setter
+    def worker_model(self, value: str) -> None:
+        self._config["worker_model"] = value
+        self._save()
+
+    @property
+    def summary_model(self) -> str:
+        """Model to use for summarization and review tasks."""
+        return str(self._config["summary_model"])
+
+    @summary_model.setter
+    def summary_model(self, value: str) -> None:
+        self._config["summary_model"] = value
+        self._save()
+
+    @property
+    def max_iterations(self) -> int:
+        """Maximum iterations for implementation loop."""
+        return int(self._config["max_iterations"])
+
+    @max_iterations.setter
+    def max_iterations(self, value: int) -> None:
+        self._config["max_iterations"] = max(1, value)
+        self._save()
+
+    @property
+    def auto_spec_without_oversight(self) -> bool:
+        """Whether to auto-spec tasks without user confirmation."""
+        return bool(self._config["auto_spec_without_oversight"])
+
+    @auto_spec_without_oversight.setter
+    def auto_spec_without_oversight(self, value: bool) -> None:
+        self._config["auto_spec_without_oversight"] = value
+        self._save()
+
+    @property
+    def wait_on_rate_limit(self) -> bool:
+        """Whether to wait and retry on rate limit."""
+        return bool(self._config["wait_on_rate_limit"])
+
+    @wait_on_rate_limit.setter
+    def wait_on_rate_limit(self, value: bool) -> None:
+        self._config["wait_on_rate_limit"] = value
+        self._save()
+
+    @property
+    def pause_on_completion(self) -> bool:
+        """Whether to pause after completing all tasks."""
+        return bool(self._config["pause_on_completion"])
+
+    @pause_on_completion.setter
+    def pause_on_completion(self, value: bool) -> None:
+        self._config["pause_on_completion"] = value
+        self._save()
+
+    @property
+    def always_build_tests(self) -> bool:
+        """Whether to always build tests for implementations."""
+        return bool(self._config["always_build_tests"])
+
+    @always_build_tests.setter
+    def always_build_tests(self, value: bool) -> None:
+        self._config["always_build_tests"] = value
+        self._save()
+
+    @property
+    def max_story_attempts(self) -> int:
+        """Maximum attempts per story before marking as blocked."""
+        return int(self._config.get("max_story_attempts", 3))
+
+    @max_story_attempts.setter
+    def max_story_attempts(self, value: int) -> None:
+        self._config["max_story_attempts"] = max(1, value)
+        self._save()
+
+    @property
+    def branch_prefix(self) -> str:
+        """Prefix for feature branch names (e.g., 'ralph' creates 'ralph/feature-name')."""
+        return str(self._config.get("branch_prefix", "ralph"))
+
+    @branch_prefix.setter
+    def branch_prefix(self, value: str) -> None:
+        self._config["branch_prefix"] = value
+        self._save()
+
+    @property
+    def on_error(self) -> ErrorMode:
+        """Error handling mode (block, retry, pause, skip)."""
+        value: ErrorMode = self._config["on_error"]
+        return value
+
+    @on_error.setter
+    def on_error(self, value: ErrorMode) -> None:
+        if value not in ("block", "retry", "pause", "skip"):
+            raise ValueError(f"Invalid error mode: {value}")
+        self._config["on_error"] = value
+        self._save()
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return a copy of the configuration as a dictionary."""
+        return self._config.copy()
+
+    def reset_to_defaults(self) -> None:
+        """Reset all settings to defaults."""
+        self._config = DEFAULT_CONFIG.copy()
+        self._save()
+
+
+# Global config instance
+_config: Config | None = None
+
+
+def get_config() -> Config:
+    """Get the global configuration instance."""
+    global _config
+    if _config is None:
+        _config = Config()
+    return _config