create-merlin-brain 2.3.3 → 2.5.0

package/files/loop/lib/timeout.sh

@@ -0,0 +1,207 @@
+#!/usr/bin/env bash
+#
+# Merlin Loop - Timeout Handling
+# Provides timeout with countdown for pause points, enabling AFK operation
+#
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Timeout Configuration
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Default timeout: 5 minutes (300 seconds)
+PAUSE_TIMEOUT="${MERLIN_PAUSE_TIMEOUT:-300}"
+
+# Default action when timeout expires
+DEFAULT_TIMEOUT_ACTION="${MERLIN_DEFAULT_ACTION:-continue}"
+
+# Whether to show countdown (can be disabled for scripted use)
+SHOW_COUNTDOWN="${MERLIN_SHOW_COUNTDOWN:-true}"
+
+# Whether timeout is enabled
+TIMEOUT_ENABLED="${MERLIN_TIMEOUT_ENABLED:-true}"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Timeout Control
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Disable timeout (for interactive mode)
+disable_timeout() {
+  TIMEOUT_ENABLED="false"
+}
+
+# Enable timeout
+enable_timeout() {
+  TIMEOUT_ENABLED="true"
+}
+
+# Set timeout value
+set_timeout() {
+  local seconds="$1"
+  if [[ "$seconds" =~ ^[0-9]+$ ]]; then
+    PAUSE_TIMEOUT="$seconds"
+  else
+    echo -e "${RED}Invalid timeout value: $seconds${RESET}" >&2
+    return 1
+  fi
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Countdown Display
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Format seconds as M:SS
+format_time() {
+  local seconds="$1"
+  local minutes=$((seconds / 60))
+  local secs=$((seconds % 60))
+  printf "%d:%02d" "$minutes" "$secs"
+}
+
+# Display countdown timer (updates in place)
+countdown_display() {
+  local remaining="$1"
+  local default_action="$2"
+  local formatted
+  formatted=$(format_time "$remaining")
+
+  # Use carriage return to update in place
+  printf "\r⏱️  Auto-%s in %s... Press any key to respond " "$default_action" "$formatted"
+}
+
+# Clear the countdown line
+clear_countdown() {
+  # Clear to end of line
+  printf "\r\033[K"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Timeout Read
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Read with timeout and countdown
+# Args: $1 = prompt, $2 = default value, $3 = custom timeout (optional)
+# Returns: User input or default value via stdout
+# Exit code: 0 = user input, 1 = timeout (default used)
+read_with_timeout() {
+  local prompt="$1"
+  local default="$2"
+  local timeout="${3:-$PAUSE_TIMEOUT}"
+
+  # If timeout disabled, use regular read
+  if [ "$TIMEOUT_ENABLED" != "true" ] || [ "$timeout" -eq 0 ]; then
+    echo -n "$prompt"
+    read -r response
+    echo "${response:-$default}"
+    return 0
+  fi
+
+  # Show what will happen on timeout
+  echo ""
+  echo -e "${YELLOW}⏱️  Will auto-${default} in $(format_time "$timeout") if no response${RESET}"
+  echo ""
+  echo -n "$prompt"
+
+  local remaining="$timeout"
+  local response=""
+  local timed_out=false
+
+  # Save cursor position
+  tput sc 2>/dev/null || true
+
+  while [ "$remaining" -gt 0 ]; do
+    # Try to read with 1-second timeout
+    if read -t 1 -r response 2>/dev/null; then
+      clear_countdown
+      # User provided input
+      echo "${response:-$default}"
+      return 0
+    fi
+
+    # Decrement and show countdown
+    ((remaining--))
+
+    if [ "$SHOW_COUNTDOWN" = "true" ] && [ "$remaining" -gt 0 ]; then
+      # Restore cursor and show countdown
+      tput rc 2>/dev/null || printf "\r"
+      countdown_display "$remaining" "$default"
+    fi
+  done
+
+  # Timeout reached
+  timed_out=true
+  clear_countdown
+  echo ""
+  echo -e "${YELLOW}⏱️  Timeout reached. Auto-${default}.${RESET}"
+
+  # Log timeout event
+  log_timeout_event "$default"
+
+  echo "$default"
+  return 1
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Timeout Logging
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Log a timeout event to history
+log_timeout_event() {
+  local action="$1"
+  local now
+  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  if [ -n "$HISTORY_FILE" ] && [ -f "$HISTORY_FILE" ]; then
+    echo "{\"type\":\"timeout\",\"action\":\"$action\",\"timeout\":$PAUSE_TIMEOUT,\"timestamp\":\"$now\"}" >> "$HISTORY_FILE"
+  fi
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Get Default Action for Pause Reason
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Determine the appropriate default action based on pause reason
+# Args: $1 = pause reason (from LAST_PAUSE_REASON)
+# Returns: default action string
+get_default_for_pause() {
+  local reason="${1:-unknown}"
+
+  case "$reason" in
+    "checkpoint")
+      # Explicit checkpoints should NOT auto-continue - they're deliberate
+      echo "quit"
+      ;;
+    "decision")
+      # Decisions: proceed with Claude's recommendation
+      echo "continue"
+      ;;
+    "low_confidence")
+      # Low confidence: trust Claude's judgment, continue
+      echo "continue"
+      ;;
+    "periodic")
+      # Periodic checkpoints: continue is fine
+      echo "continue"
+      ;;
+    "interactive")
+      # Interactive mode: continue (though usually timeout is disabled)
+      echo "continue"
+      ;;
+    *)
+      # Unknown: default to continue
+      echo "continue"
+      ;;
+  esac
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Status Display
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Get timeout status for display
+get_timeout_status() {
+  if [ "$TIMEOUT_ENABLED" = "true" ]; then
+    echo "$(format_time "$PAUSE_TIMEOUT") (enabled)"
+  else
+    echo "Disabled (waits indefinitely)"
+  fi
+}

package/files/loop/lib/tui.sh

@@ -0,0 +1,388 @@
+#!/usr/bin/env bash
+#
+# Merlin Loop - Interactive TUI
+# Beautiful terminal interface for pause/continue control
+# Part of Merlin Pro v1.0
+#
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# ANSI Colors and Styles
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Colors (if not already defined)
+: "${RESET:=\033[0m}"
+: "${BOLD:=\033[1m}"
+: "${DIM:=\033[2m}"
+: "${ITALIC:=\033[3m}"
+: "${RED:=\033[31m}"
+: "${GREEN:=\033[32m}"
+: "${YELLOW:=\033[33m}"
+: "${BLUE:=\033[34m}"
+: "${MAGENTA:=\033[35m}"
+: "${CYAN:=\033[36m}"
+: "${WHITE:=\033[37m}"
+: "${BG_BLACK:=\033[40m}"
+: "${BG_BLUE:=\033[44m}"
+: "${BG_GREEN:=\033[42m}"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Progress Bar
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Draw a progress bar
+# Usage: draw_progress_bar 5 10 40  (5 of 10, width 40)
+draw_progress_bar() {
+  local current=${1:-0}
+  local total=${2:-100}
+  local width=${3:-40}
+  local label=${4:-"Progress"}
+
+  # Calculate percentage
+  local percent=0
+  if [ "$total" -gt 0 ]; then
+    percent=$((current * 100 / total))
+  fi
+
+  # Calculate filled width
+  local filled=$((current * width / total))
+  if [ "$filled" -gt "$width" ]; then
+    filled=$width
+  fi
+  local empty=$((width - filled))
+
+  # Build the bar
+  local bar=""
+  for ((i=0; i<filled; i++)); do
+    bar="${bar}█"
+  done
+  for ((i=0; i<empty; i++)); do
+    bar="${bar}░"
+  done
+
+  # Color based on progress
+  local color="${CYAN}"
+  if [ "$percent" -ge 80 ]; then
+    color="${GREEN}"
+  elif [ "$percent" -ge 50 ]; then
+    color="${YELLOW}"
+  fi
+
+  echo -e "${label}: ${color}${bar}${RESET} ${percent}% (${current}/${total})"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Spinner Animation
+# ═══════════════════════════════════════════════════════════════════════════════
+
+SPINNER_PID=""
+SPINNER_FRAMES=("⠋" "⠙" "⠹" "⠸" "⠼" "⠴" "⠦" "⠧" "⠇" "⠏")
+
+# Start spinner with message
+# Usage: start_spinner "Loading..."
+start_spinner() {
+  local message="${1:-Working...}"
+
+  (
+    local i=0
+    while true; do
+      printf "\r${CYAN}${SPINNER_FRAMES[$i]}${RESET} %s" "$message"
+      i=$(( (i+1) % ${#SPINNER_FRAMES[@]} ))
+      sleep 0.1
+    done
+  ) &
+
+  SPINNER_PID=$!
+  disown $SPINNER_PID 2>/dev/null || true
+}
+
+# Stop spinner with result
+# Usage: stop_spinner "Done!" or stop_spinner "Failed!" "error"
+stop_spinner() {
+  local message="${1:-Done}"
+  local status="${2:-success}"
+
+  if [ -n "$SPINNER_PID" ] && kill -0 "$SPINNER_PID" 2>/dev/null; then
+    kill "$SPINNER_PID" 2>/dev/null
+    wait "$SPINNER_PID" 2>/dev/null || true
+    SPINNER_PID=""
+  fi
+
+  # Clear the line and print result
+  printf "\r%-60s\r" " "
+
+  if [ "$status" == "success" ]; then
+    echo -e "${GREEN}✓${RESET} $message"
+  elif [ "$status" == "error" ]; then
+    echo -e "${RED}✗${RESET} $message"
+  elif [ "$status" == "warning" ]; then
+    echo -e "${YELLOW}⚠${RESET} $message"
+  else
+    echo -e "$message"
+  fi
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Interactive Pause Menu
+# ═══════════════════════════════════════════════════════════════════════════════
+
+TUI_LAST_ACTION=""
+
+# Show the pause menu and wait for input
+# Returns: 0 for continue, 1 for quit, 2 for pause
+show_pause_menu() {
+  local task_completed=${1:-0}
+  local task_total=${2:-0}
+  local current_task_name="${3:-Next task}"
+  local timeout=${4:-$PAUSE_TIMEOUT}
+
+  echo ""
+  echo -e "${MAGENTA}╔═══════════════════════════════════════════════════════════════════╗${RESET}"
+  echo -e "${MAGENTA}║${RESET}  ${BOLD}🔮 MERLIN LOOP${RESET}                                                  ${MAGENTA}║${RESET}"
+  echo -e "${MAGENTA}╠═══════════════════════════════════════════════════════════════════╣${RESET}"
+  echo -e "${MAGENTA}║${RESET}                                                                   ${MAGENTA}║${RESET}"
+
+  # Progress
+  if [ "$task_total" -gt 0 ]; then
+    local progress_bar
+    progress_bar=$(draw_progress_bar "$task_completed" "$task_total" 30 "Tasks")
+    printf "${MAGENTA}║${RESET}  %-65s ${MAGENTA}║${RESET}\n" "$progress_bar"
+  fi
+
+  # Next task
+  printf "${MAGENTA}║${RESET}  ${CYAN}Next:${RESET} %-58s ${MAGENTA}║${RESET}\n" "${current_task_name:0:58}"
+
+  echo -e "${MAGENTA}║${RESET}                                                                   ${MAGENTA}║${RESET}"
+  echo -e "${MAGENTA}╠═══════════════════════════════════════════════════════════════════╣${RESET}"
+  echo -e "${MAGENTA}║${RESET}                                                                   ${MAGENTA}║${RESET}"
+  echo -e "${MAGENTA}║${RESET}  ${GREEN}[Enter]${RESET} Continue     ${YELLOW}[p]${RESET} Pause     ${RED}[q]${RESET} Quit     ${CYAN}[s]${RESET} Status   ${MAGENTA}║${RESET}"
+  echo -e "${MAGENTA}║${RESET}                                                                   ${MAGENTA}║${RESET}"
+  echo -e "${MAGENTA}╚═══════════════════════════════════════════════════════════════════╝${RESET}"
+  echo ""
+
+  # Show timeout if enabled
+  if [ "$TIMEOUT_ENABLED" == "true" ] && [ "$timeout" -gt 0 ]; then
+    echo -e "${DIM}Auto-continue in ${timeout}s (press any key to interact)${RESET}"
+  fi
+
+  # Read input with timeout
+  local input=""
+  if [ "$TIMEOUT_ENABLED" == "true" ] && [ "$timeout" -gt 0 ]; then
+    read -t "$timeout" -n 1 input 2>/dev/null || true
+  else
+    read -n 1 input 2>/dev/null || true
+  fi
+
+  # Handle input
+  case "$input" in
+    ""|$'\n')
+      # Enter or timeout - continue
+      TUI_LAST_ACTION="continue"
+      return 0
+      ;;
+    "q"|"Q")
+      # Quit
+      TUI_LAST_ACTION="quit"
+      echo ""
+      echo -e "${YELLOW}Quitting gracefully...${RESET}"
+      return 1
+      ;;
+    "p"|"P")
+      # Pause
+      TUI_LAST_ACTION="pause"
+      show_pause_screen
+      return 2
+      ;;
+    "s"|"S")
+      # Status
+      TUI_LAST_ACTION="status"
+      show_status_screen
+      show_pause_menu "$task_completed" "$task_total" "$current_task_name" "$timeout"
+      return $?
+      ;;
+    *)
+      # Unknown input, continue
+      TUI_LAST_ACTION="continue"
+      return 0
+      ;;
+  esac
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Pause Screen
+# ═══════════════════════════════════════════════════════════════════════════════
+
+show_pause_screen() {
+  clear 2>/dev/null || true
+
+  echo ""
+  echo -e "${YELLOW}╔═══════════════════════════════════════════════════════════════════╗${RESET}"
+  echo -e "${YELLOW}║${RESET}                                                                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}              ${BOLD}⏸️  MERLIN LOOP PAUSED${RESET}                            ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}                                                                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}  Your work has been saved. You can safely:                        ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}  • Close this terminal                                            ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}  • Come back later                                                ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}  • Resume with: ${CYAN}merlin-loop resume${RESET}                              ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}                                                                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}╠═══════════════════════════════════════════════════════════════════╣${RESET}"
+  echo -e "${YELLOW}║${RESET}                                                                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}  ${GREEN}[Enter]${RESET} Resume now     ${RED}[q]${RESET} Quit completely                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}║${RESET}                                                                   ${YELLOW}║${RESET}"
+  echo -e "${YELLOW}╚═══════════════════════════════════════════════════════════════════╝${RESET}"
+  echo ""
+
+  # Save checkpoint before pausing
+  if type save_checkpoint &> /dev/null; then
+    save_checkpoint "Loop paused by user" "" "" "[]" "merlin-loop" 2>/dev/null || true
+  fi
+
+  read -n 1 input
+  case "$input" in
+    "q"|"Q")
+      echo ""
+      echo -e "${YELLOW}Exiting. Resume later with: ${CYAN}merlin-loop resume${RESET}"
+      exit 0
+      ;;
+    *)
+      echo ""
+      echo -e "${GREEN}Resuming...${RESET}"
+      ;;
+  esac
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Status Screen
+# ═══════════════════════════════════════════════════════════════════════════════
+
+show_status_screen() {
+  echo ""
+  echo -e "${CYAN}═══════════════════════════════════════════════════════════════════${RESET}"
+  echo -e "${BOLD}📊 LOOP STATUS${RESET}"
+  echo -e "${CYAN}═══════════════════════════════════════════════════════════════════${RESET}"
+  echo ""
+
+  # Read state file
+  if [ -f "$STATE_FILE" ] && command -v jq &> /dev/null; then
+    local iteration completed errors
+    iteration=$(jq -r '.iteration // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+    completed=$(jq -r '.tasks_completed // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+    errors=$(jq -r '.consecutive_errors // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+    local phase=$(jq -r '.current_phase // "N/A"' "$STATE_FILE" 2>/dev/null || echo "N/A")
+
+    echo -e "  ${CYAN}Iterations:${RESET}      $iteration"
+    echo -e "  ${CYAN}Tasks Completed:${RESET} $completed"
+    echo -e "  ${CYAN}Current Phase:${RESET}   $phase"
+    echo -e "  ${CYAN}Errors:${RESET}          $errors"
+  else
+    echo -e "  ${DIM}State file not available${RESET}"
+  fi
+
+  # Sights status
+  echo ""
+  if type check_sights_connection &> /dev/null; then
+    local sights_status
+    sights_status=$(check_sights_connection 2>/dev/null || echo "unknown")
+    case "$sights_status" in
+      "connected")
+        echo -e "  ${GREEN}🔮 Sights: Connected${RESET}"
+        ;;
+      *)
+        echo -e "  ${YELLOW}🔮 Sights: $sights_status${RESET}"
+        ;;
+    esac
+  fi
+
+  # Git status
+  echo ""
+  local git_status
+  git_status=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$git_status" -eq 0 ]; then
+    echo -e "  ${GREEN}📁 Git: Clean${RESET}"
+  else
+    echo -e "  ${YELLOW}📁 Git: $git_status uncommitted changes${RESET}"
+  fi
+
+  echo ""
+  echo -e "${CYAN}═══════════════════════════════════════════════════════════════════${RESET}"
+  echo ""
+  echo -e "${DIM}Press any key to continue...${RESET}"
+  read -n 1
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Task Header
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Show task header when starting a new task
+show_task_header() {
+  local task_num=${1:-1}
+  local task_total=${2:-1}
+  local task_name="${3:-Task}"
+  local agent_name="${4:-claude}"
+
+  echo ""
+  echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo -e "${BOLD}▶️  TASK ${task_num}/${task_total}${RESET}: ${task_name}"
+  echo -e "${DIM}Agent: ${agent_name}${RESET}"
+  echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo ""
+}
+
+# Show task completion
+show_task_complete() {
+  local task_name="${1:-Task}"
+  local duration="${2:-0}"
+  local status="${3:-success}"
+
+  echo ""
+
+  if [ "$status" == "success" ]; then
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+    echo -e "${GREEN}✅ COMPLETE:${RESET} ${task_name}"
+    echo -e "${DIM}Duration: ${duration}s${RESET}"
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  else
+    echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+    echo -e "${RED}❌ FAILED:${RESET} ${task_name}"
+    echo -e "${DIM}Duration: ${duration}s${RESET}"
+    echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  fi
+
+  echo ""
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Loop Complete Banner
+# ═══════════════════════════════════════════════════════════════════════════════
+
+show_loop_complete() {
+  local tasks_completed=${1:-0}
+  local total_duration=${2:-0}
+  local errors=${3:-0}
+
+  echo ""
+  echo -e "${GREEN}╔═══════════════════════════════════════════════════════════════════╗${RESET}"
+  echo -e "${GREEN}║${RESET}                                                                   ${GREEN}║${RESET}"
+  echo -e "${GREEN}║${RESET}              ${BOLD}🎉 MERLIN LOOP COMPLETE!${RESET}                           ${GREEN}║${RESET}"
+  echo -e "${GREEN}║${RESET}                                                                   ${GREEN}║${RESET}"
+  echo -e "${GREEN}╠═══════════════════════════════════════════════════════════════════╣${RESET}"
+  echo -e "${GREEN}║${RESET}                                                                   ${GREEN}║${RESET}"
+  printf "${GREEN}║${RESET}  ${CYAN}Tasks Completed:${RESET}  %-45s ${GREEN}║${RESET}\n" "$tasks_completed"
+  printf "${GREEN}║${RESET}  ${CYAN}Total Duration:${RESET}   %-45s ${GREEN}║${RESET}\n" "${total_duration}s"
+  printf "${GREEN}║${RESET}  ${CYAN}Errors:${RESET}           %-45s ${GREEN}║${RESET}\n" "$errors"
+  echo -e "${GREEN}║${RESET}                                                                   ${GREEN}║${RESET}"
+  echo -e "${GREEN}╚═══════════════════════════════════════════════════════════════════╝${RESET}"
+  echo ""
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Exports
+# ═══════════════════════════════════════════════════════════════════════════════
+
+export -f draw_progress_bar 2>/dev/null || true
+export -f start_spinner 2>/dev/null || true
+export -f stop_spinner 2>/dev/null || true
+export -f show_pause_menu 2>/dev/null || true
+export -f show_task_header 2>/dev/null || true
+export -f show_task_complete 2>/dev/null || true
+export -f show_loop_complete 2>/dev/null || true