create-merlin-brain 2.3.3 → 2.5.0

package/files/loop/lib/boot.sh

@@ -0,0 +1,453 @@
+#!/usr/bin/env bash
+#
+# Merlin Loop - Boot Sequence
+# The 5-phase Merlin Pro boot sequence that runs before every task
+# Part of Merlin Pro v1.0
+#
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Boot Sequence State
+# ═══════════════════════════════════════════════════════════════════════════════
+
+BOOT_CONTEXT_TOKENS=0
+BOOT_SELECTED_AGENT=""
+BOOT_INSTALLED_SKILLS=""
+BOOT_TRAJECTORY=""
+BOOT_RECENT_CHANGES=""
+BOOT_CHECKPOINT_SUMMARY=""
+BOOT_HOT_FILES=""
+BOOT_DECISION_COUNT=0
+
+# Colors (ensure they're defined)
+: "${RESET:=\033[0m}"
+: "${BOLD:=\033[1m}"
+: "${DIM:=\033[2m}"
+: "${RED:=\033[31m}"
+: "${GREEN:=\033[32m}"
+: "${YELLOW:=\033[33m}"
+: "${BLUE:=\033[34m}"
+: "${MAGENTA:=\033[35m}"
+: "${CYAN:=\033[36m}"
+
+# Spinner frames for animated loading
+BOOT_SPINNER=("⠋" "⠙" "⠹" "⠸" "⠼" "⠴" "⠦" "⠧" "⠇" "⠏")
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Boot Animation Helpers
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Animated phase indicator
+boot_phase_start() {
+  local phase_num="$1"
+  local phase_name="$2"
+  printf "${CYAN}[%s/5]${RESET} ${BOLD}%s${RESET}" "$phase_num" "$phase_name"
+}
+
+# Phase success with checkmark
+boot_phase_success() {
+  local message="$1"
+  echo -e "\r${GREEN}      ✓${RESET} $message"
+}
+
+# Phase warning
+boot_phase_warn() {
+  local message="$1"
+  echo -e "\r${YELLOW}      ⚠${RESET} $message"
+}
+
+# Phase skip
+boot_phase_skip() {
+  local message="$1"
+  echo -e "\r${DIM}      ⏭ $message${RESET}"
+}
+
+# Quick spinner (single line update)
+boot_spinner() {
+  local message="$1"
+  local i=0
+  printf "\r      ${CYAN}%s${RESET} %s" "${BOOT_SPINNER[$i]}" "$message"
+  sleep 0.1
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase 1: Reinforce Sights
+# ═══════════════════════════════════════════════════════════════════════════════
+
+boot_phase_1_sights() {
+  local task_description="$1"
+
+  echo ""
+  boot_phase_start "1" "Reinforcing Sights..."
+  echo ""
+
+  # Check Sights connection
+  if type check_sights_connection &> /dev/null; then
+    local status
+    status=$(check_sights_connection 2>/dev/null || echo "not_configured")
+
+    if [ "$status" != "connected" ]; then
+      boot_phase_warn "Sights not connected - using local context"
+      return 1
+    fi
+    boot_phase_success "Sights: ${GREEN}Connected${RESET}"
+  fi
+
+  # Load checkpoint
+  if type fetch_checkpoint &> /dev/null; then
+    boot_spinner "Loading checkpoint..."
+    local checkpoint
+    checkpoint=$(fetch_checkpoint 2>/dev/null || echo "")
+    if [ -n "$checkpoint" ] && [ "$checkpoint" != "null" ]; then
+      BOOT_CHECKPOINT_SUMMARY=$(echo "$checkpoint" | jq -r '.checkpoint.summary // empty' 2>/dev/null || echo "")
+      local created_at
+      created_at=$(echo "$checkpoint" | jq -r '.checkpoint.createdAt // empty' 2>/dev/null | cut -c1-16 || echo "")
+      if [ -n "$BOOT_CHECKPOINT_SUMMARY" ]; then
+        boot_phase_success "Checkpoint: ${BOOT_CHECKPOINT_SUMMARY:0:50}"
+        BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 200))
+      else
+        boot_phase_skip "No checkpoint found"
+      fi
+    else
+      boot_phase_skip "No checkpoint found"
+    fi
+  fi
+
+  # Load trajectory
+  if type fetch_trajectory &> /dev/null; then
+    boot_spinner "Detecting trajectory..."
+    BOOT_TRAJECTORY=$(fetch_trajectory 2>/dev/null || echo "")
+    if [ -n "$BOOT_TRAJECTORY" ] && [ "$BOOT_TRAJECTORY" != "Not detected" ]; then
+      boot_phase_success "Trajectory: ${CYAN}\"$BOOT_TRAJECTORY\"${RESET}"
+      BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 50))
+    else
+      boot_phase_skip "Trajectory not detected yet"
+    fi
+  fi
+
+  # Load recent changes
+  if type fetch_recent_changes &> /dev/null; then
+    boot_spinner "Loading recent changes..."
+    BOOT_RECENT_CHANGES=$(fetch_recent_changes 2>/dev/null || echo "")
+    if [ -n "$BOOT_RECENT_CHANGES" ]; then
+      # Extract hot files
+      local hot_files
+      hot_files=$(echo "$BOOT_RECENT_CHANGES" | grep -o '\*\*[^*]*\*\*:' | head -3 | sed 's/\*\*//g' | sed 's/:$//' | tr '\n' ', ' | sed 's/,$//')
+      if [ -n "$hot_files" ]; then
+        BOOT_HOT_FILES="$hot_files"
+        boot_phase_success "Hot files: ${YELLOW}$hot_files${RESET}"
+        BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 300))
+      else
+        boot_phase_skip "No recent commits tracked"
+      fi
+    else
+      boot_phase_skip "Recent changes not available"
+    fi
+  fi
+
+  # Load recent decisions
+  if type get_decisions &> /dev/null; then
+    boot_spinner "Loading decisions..."
+    local decisions
+    decisions=$(get_decisions 5 2>/dev/null || echo "")
+    if [ -n "$decisions" ]; then
+      BOOT_DECISION_COUNT=$(echo "$decisions" | jq -r 'if type == "object" then (.count // (.decisions | length) // 0) else 0 end' 2>/dev/null || echo "0")
+      if [ "$BOOT_DECISION_COUNT" -gt 0 ]; then
+        boot_phase_success "Decisions: ${BOOT_DECISION_COUNT} recent decisions loaded"
+        BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 100))
+      else
+        boot_phase_skip "No decisions recorded yet"
+      fi
+    else
+      boot_phase_skip "Decisions not available"
+    fi
+  fi
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase 2: Analyze Task & Select Agent
+# ═══════════════════════════════════════════════════════════════════════════════
+
+boot_phase_2_agent() {
+  local task_description="$1"
+
+  echo ""
+  boot_phase_start "2" "Analyzing task..."
+  echo ""
+
+  # Select agent based on task keywords
+  if type select_agent_for_task &> /dev/null; then
+    BOOT_SELECTED_AGENT=$(select_agent_for_task "$task_description" 2>/dev/null || echo "implementation_dev")
+  else
+    BOOT_SELECTED_AGENT="implementation_dev"
+  fi
+
+  local agent_name
+  if type get_agent_display_name &> /dev/null; then
+    agent_name=$(get_agent_display_name "$BOOT_SELECTED_AGENT" 2>/dev/null || echo "$BOOT_SELECTED_AGENT")
+  else
+    agent_name="$BOOT_SELECTED_AGENT"
+  fi
+
+  boot_phase_success "Agent: ${BOLD}${MAGENTA}$agent_name${RESET}"
+
+  # Load agent-specific context
+  if type get_agent_context_injection &> /dev/null; then
+    local agent_context
+    agent_context=$(get_agent_context_injection "$BOOT_SELECTED_AGENT" 2>/dev/null || echo "")
+    if [ -n "$agent_context" ]; then
+      local context_lines
+      context_lines=$(echo "$agent_context" | wc -l | tr -d ' ')
+      boot_phase_success "Domain knowledge: ${context_lines} guidelines loaded"
+      BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 150))
+    fi
+  fi
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase 3: Scan Skills Index
+# ═══════════════════════════════════════════════════════════════════════════════
+
+boot_phase_3_scan_skills() {
+  local task_description="$1"
+
+  echo ""
+  boot_phase_start "3" "Scanning skills index..."
+  echo ""
+
+  # Get required skills for selected agent
+  local required_skills=""
+  if type get_agent_required_skills &> /dev/null; then
+    required_skills=$(get_agent_required_skills "$BOOT_SELECTED_AGENT" 2>/dev/null || echo "")
+  fi
+
+  # Detect additional skills from task keywords
+  local detected_skills=""
+  if type detect_skills_from_task &> /dev/null; then
+    detected_skills=$(detect_skills_from_task "$task_description" 2>/dev/null || echo "")
+  fi
+
+  # Combine and deduplicate
+  local all_skills
+  all_skills=$(echo -e "$required_skills\n$detected_skills" | sort -u | grep -v "^$" || echo "")
+
+  if [ -n "$all_skills" ]; then
+    local skill_count
+    skill_count=$(echo "$all_skills" | wc -l | tr -d ' ')
+    boot_phase_success "Found ${skill_count} relevant skill(s)"
+
+    # Check which are installed
+    local installed=""
+    if type get_installed_skills &> /dev/null; then
+      installed=$(get_installed_skills 2>/dev/null || echo "")
+    fi
+
+    # Store for phase 4
+    BOOT_NEEDED_SKILLS="$all_skills"
+    BOOT_INSTALLED_SKILLS="$installed"
+  else
+    boot_phase_success "No additional skills needed"
+  fi
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase 4: Install Missing Skills
+# ═══════════════════════════════════════════════════════════════════════════════
+
+boot_phase_4_install_skills() {
+  echo ""
+  boot_phase_start "4" "Checking skills..."
+  echo ""
+
+  if [ -z "$BOOT_NEEDED_SKILLS" ]; then
+    boot_phase_success "All skills ready"
+    return 0
+  fi
+
+  local installed_count=0
+  local skipped_count=0
+
+  while IFS= read -r skill; do
+    [ -z "$skill" ] && continue
+
+    if echo "$BOOT_INSTALLED_SKILLS" | grep -q "^${skill}$"; then
+      ((skipped_count++))
+    else
+      # Install the skill
+      if type install_skill &> /dev/null && install_skill "$skill" 2>/dev/null; then
+        boot_phase_success "Installed: ${GREEN}$skill${RESET}"
+        ((installed_count++))
+        BOOT_CONTEXT_TOKENS=$((BOOT_CONTEXT_TOKENS + 500))
+      else
+        boot_phase_skip "$skill (not available)"
+        ((skipped_count++))
+      fi
+    fi
+  done <<< "$BOOT_NEEDED_SKILLS"
+
+  if [ $installed_count -eq 0 ]; then
+    boot_phase_success "All ${skipped_count} skill(s) ready"
+  fi
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Phase 5: Start Work
+# ═══════════════════════════════════════════════════════════════════════════════
+
+boot_phase_5_ready() {
+  local task_description="$1"
+
+  echo ""
+  boot_phase_start "5" "Boot complete!"
+  echo ""
+
+  # Show summary box
+  echo -e "      ${CYAN}┌──────────────────────────────────────────────────────┐${RESET}"
+  printf "      ${CYAN}│${RESET} %-52s ${CYAN}│${RESET}\n" "Context: ~${BOOT_CONTEXT_TOKENS} tokens loaded"
+
+  local agent_display
+  if type get_agent_display_name &> /dev/null; then
+    agent_display=$(get_agent_display_name "$BOOT_SELECTED_AGENT" 2>/dev/null || echo "$BOOT_SELECTED_AGENT")
+  else
+    agent_display="$BOOT_SELECTED_AGENT"
+  fi
+  printf "      ${CYAN}│${RESET} %-52s ${CYAN}│${RESET}\n" "Agent: $agent_display"
+
+  if [ -n "$BOOT_TRAJECTORY" ] && [ "$BOOT_TRAJECTORY" != "Not detected" ]; then
+    printf "      ${CYAN}│${RESET} %-52s ${CYAN}│${RESET}\n" "Trajectory: ${BOOT_TRAJECTORY:0:40}"
+  fi
+
+  if [ -n "$BOOT_HOT_FILES" ]; then
+    printf "      ${CYAN}│${RESET} %-52s ${CYAN}│${RESET}\n" "Hot files: ${BOOT_HOT_FILES:0:40}"
+  fi
+
+  if [ "$BOOT_DECISION_COUNT" -gt 0 ]; then
+    printf "      ${CYAN}│${RESET} %-52s ${CYAN}│${RESET}\n" "Decisions: $BOOT_DECISION_COUNT loaded"
+  fi
+
+  echo -e "      ${CYAN}└──────────────────────────────────────────────────────┘${RESET}"
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Main Boot Sequence
+# ═══════════════════════════════════════════════════════════════════════════════
+
+run_boot_sequence() {
+  local task_description="${1:-Unknown task}"
+  local quiet="${2:-false}"
+
+  # Reset state
+  BOOT_CONTEXT_TOKENS=0
+  BOOT_SELECTED_AGENT=""
+  BOOT_INSTALLED_SKILLS=""
+  BOOT_TRAJECTORY=""
+  BOOT_RECENT_CHANGES=""
+  BOOT_NEEDED_SKILLS=""
+  BOOT_CHECKPOINT_SUMMARY=""
+  BOOT_HOT_FILES=""
+  BOOT_DECISION_COUNT=0
+
+  if [ "$quiet" != "true" ]; then
+    echo ""
+    echo -e "${MAGENTA}╔═══════════════════════════════════════════════════════════════════╗${RESET}"
+    echo -e "${MAGENTA}║${RESET}               ${BOLD}🚀 MERLIN PRO BOOT SEQUENCE${RESET}                       ${MAGENTA}║${RESET}"
+    echo -e "${MAGENTA}╚═══════════════════════════════════════════════════════════════════╝${RESET}"
+  fi
+
+  # Run all 5 phases
+  boot_phase_1_sights "$task_description"
+  boot_phase_2_agent "$task_description"
+  boot_phase_3_scan_skills "$task_description"
+  boot_phase_4_install_skills
+  boot_phase_5_ready "$task_description"
+
+  if [ "$quiet" != "true" ]; then
+    echo ""
+    echo -e "${GREEN}╔═══════════════════════════════════════════════════════════════════╗${RESET}"
+    printf "${GREEN}║${RESET} %-65s ${GREEN}║${RESET}\n" "▶️  Starting: ${task_description:0:50}"
+    echo -e "${GREEN}╚═══════════════════════════════════════════════════════════════════╝${RESET}"
+    echo ""
+  fi
+
+  return 0
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Quick Boot (minimal output)
+# ═══════════════════════════════════════════════════════════════════════════════
+
+run_boot_quick() {
+  local task_description="${1:-Unknown task}"
+
+  # Reset state
+  BOOT_CONTEXT_TOKENS=0
+  BOOT_SELECTED_AGENT=""
+  BOOT_TRAJECTORY=""
+
+  # Quick loads (no output)
+  if type fetch_trajectory &> /dev/null; then
+    BOOT_TRAJECTORY=$(fetch_trajectory 2>/dev/null || echo "")
+  fi
+
+  if type select_agent_for_task &> /dev/null; then
+    BOOT_SELECTED_AGENT=$(select_agent_for_task "$task_description" 2>/dev/null || echo "implementation_dev")
+  fi
+
+  BOOT_CONTEXT_TOKENS=500  # Estimate
+
+  echo -e "${GREEN}🚀${RESET} Boot complete (quick mode) - Agent: $BOOT_SELECTED_AGENT"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Helper: Get boot context for prompt injection
+# ═══════════════════════════════════════════════════════════════════════════════
+
+get_boot_context() {
+  local context=""
+
+  # Add trajectory
+  if [ -n "$BOOT_TRAJECTORY" ] && [ "$BOOT_TRAJECTORY" != "Not detected" ]; then
+    context="**Current Trajectory:** $BOOT_TRAJECTORY
+
+"
+  fi
+
+  # Add recent changes
+  if [ -n "$BOOT_RECENT_CHANGES" ]; then
+    context="${context}${BOOT_RECENT_CHANGES}
+
+"
+  fi
+
+  # Add agent context
+  if [ -n "$BOOT_SELECTED_AGENT" ] && type get_agent_context_injection &> /dev/null; then
+    local agent_context
+    agent_context=$(get_agent_context_injection "$BOOT_SELECTED_AGENT" 2>/dev/null || echo "")
+    if [ -n "$agent_context" ]; then
+      context="${context}## Agent Guidance ($BOOT_SELECTED_AGENT)
+
+$agent_context
+
+"
+    fi
+  fi
+
+  echo "$context"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Exports
+# ═══════════════════════════════════════════════════════════════════════════════
+
+export -f run_boot_sequence 2>/dev/null || true
+export -f run_boot_quick 2>/dev/null || true
+export -f get_boot_context 2>/dev/null || true

package/files/loop/lib/discuss.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+#
+# Merlin Loop - Discussion Mode
+# Spawns a fresh Claude session for conversation without losing loop state
+#
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Discussion State
+# ═══════════════════════════════════════════════════════════════════════════════
+
+DISCUSSION_DECISIONS=()
+DISCUSSION_CONTEXT=""
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Context Building
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Build a minimal context summary for discussion mode
+# Keeps under 2000 tokens for lightweight conversation
+build_discussion_context() {
+  local output="$1"
+  local iteration="$2"
+
+  local context=""
+
+  # Current task/situation
+  context+="## Current Situation\n\n"
+  context+="Loop iteration: $iteration\n"
+
+  # Extract what we're working on from the output
+  if echo "$output" | grep -q "DECISION_NEEDED"; then
+    local decision_line
+    decision_line=$(echo "$output" | grep -o "DECISION_NEEDED|[^|]*|[^|]*" | head -1)
+    local reason
+    reason=$(echo "$decision_line" | cut -d'|' -f2)
+    local details
+    details=$(echo "$decision_line" | cut -d'|' -f3)
+    context+="Decision needed: $reason\n"
+    context+="Details: $details\n"
+  elif echo "$output" | grep -q "LOW_CONFIDENCE"; then
+    local confidence_line
+    confidence_line=$(echo "$output" | grep -o "LOW_CONFIDENCE|[^|]*|[^|]*" | head -1)
+    local reason
+    reason=$(echo "$confidence_line" | cut -d'|' -f2)
+    local details
+    details=$(echo "$confidence_line" | cut -d'|' -f3)
+    context+="Uncertainty: $reason\n"
+    context+="Details: $details\n"
+  fi
+  context+="\n"
+
+  # Recent history (last 3 tasks)
+  context+="## Recent Progress\n\n"
+  if [ -f "$HISTORY_FILE" ]; then
+    local recent_tasks
+    recent_tasks=$(grep '"type":"task_complete"' "$HISTORY_FILE" | tail -3)
+    if [ -n "$recent_tasks" ]; then
+      echo "$recent_tasks" | while read -r line; do
+        if command -v jq &> /dev/null; then
+          local task_name
+          task_name=$(echo "$line" | jq -r '.task_name // "Unknown task"')
+          context+="- ✓ $task_name\n"
+        fi
+      done
+    else
+      context+="- No tasks completed yet\n"
+    fi
+  fi
+  context+="\n"
+
+  # Any pending decisions from previous discussions
+  if [ ${#DISCUSSION_DECISIONS[@]} -gt 0 ]; then
+    context+="## Previous Decisions (this session)\n\n"
+    for decision in "${DISCUSSION_DECISIONS[@]}"; do
+      context+="- $decision\n"
+    done
+    context+="\n"
+  fi
+
+  # Project summary if available
+  if [ -f ".planning/PROJECT.md" ]; then
+    context+="## Project\n\n"
+    context+=$(head -20 ".planning/PROJECT.md" | grep -v "^#" | head -5)
+    context+="\n"
+  fi
+
+  DISCUSSION_CONTEXT="$context"
+  echo -e "$context"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Discussion Spawning
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Spawn a fresh Claude session for discussion
+# The user can chat, think through problems, and make decisions
+spawn_discussion() {
+  local output="$1"
+  local iteration="$2"
+
+  echo ""
+  echo -e "${CYAN}╔═══════════════════════════════════════════════════════════════╗${RESET}"
+  echo -e "${CYAN}║  ${BOLD}DISCUSSION MODE${RESET}${CYAN}                                              ║${RESET}"
+  echo -e "${CYAN}║  Fresh Claude for conversation (no code changes)              ║${RESET}"
+  echo -e "${CYAN}╚═══════════════════════════════════════════════════════════════╝${RESET}"
+  echo ""
+
+  # Build context
+  local context
+  context=$(build_discussion_context "$output" "$iteration")
+
+  # Load discussion prompt
+  local prompt_file="$SCRIPT_DIR/prompts/PROMPT_DISCUSS.md"
+  if [ ! -f "$prompt_file" ]; then
+    echo -e "${YELLOW}Discussion prompt not found, using default${RESET}"
+    prompt_file=""
+  fi
+
+  # Build the full prompt
+  local full_prompt=""
+  if [ -n "$prompt_file" ]; then
+    full_prompt=$(cat "$prompt_file")
+  else
+    full_prompt="You are in DISCUSSION MODE - an advisor helping think through problems.
+Do NOT make code changes. Help the user think, ask questions, suggest approaches.
+When the user makes a decision, mark it with DECISION: prefix.
+When done, the user will say 'done' or 'continue'."
+  fi
+
+  # Inject context
+  full_prompt=$(echo "$full_prompt" | sed "s/{{CURRENT_TASK}}/$(echo "$context" | head -5 | tr '\n' ' ')/g")
+  full_prompt=$(echo "$full_prompt" | sed "s/{{RECENT_HISTORY}}/See context below/g")
+  full_prompt=$(echo "$full_prompt" | sed "s/{{PENDING_DECISIONS}}/None/g")
+  full_prompt=$(echo "$full_prompt" | sed "s/{{PROJECT_CONTEXT}}/See context below/g")
+
+  full_prompt+="
+
+---
+## Context
+
+$context
+---
+
+I'm ready to discuss. What's on your mind?"
+
+  echo -e "${BLUE}Starting discussion session...${RESET}"
+  echo -e "${BLUE}Type 'done' or 'continue' when ready to return to the loop.${RESET}"
+  echo ""
+
+  # Spawn Claude in interactive mode (not stream-json)
+  local discussion_output
+  local ai_cli
+  ai_cli=$(detect_ai_cli 2>/dev/null || echo "claude")
+
+  # Run interactively - this blocks until user ends discussion
+  case "$ai_cli" in
+    claude)
+      # Use interactive mode without --output-format
+      discussion_output=$(echo "$full_prompt" | claude 2>&1)
+      ;;
+    *)
+      discussion_output=$(echo "$full_prompt" | "$ai_cli" 2>&1)
+      ;;
+  esac
+
+  # Process decisions from the discussion
+  save_discussion_decisions "$discussion_output"
+
+  echo ""
+  echo -e "${GREEN}Discussion complete.${RESET}"
+
+  local decision_count=${#DISCUSSION_DECISIONS[@]}
+  if [ "$decision_count" -gt 0 ]; then
+    echo -e "${GREEN}Captured $decision_count decision(s) for future context.${RESET}"
+  fi
+
+  echo ""
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Decision Capture
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Parse Claude's output for DECISION: markers and save them
+save_discussion_decisions() {
+  local output="$1"
+
+  # Extract all DECISION: lines
+  while IFS= read -r line; do
+    local decision
+    decision=$(echo "$line" | sed 's/DECISION://')
+    decision=$(echo "$decision" | xargs)  # Trim whitespace
+
+    if [ -n "$decision" ]; then
+      DISCUSSION_DECISIONS+=("$decision")
+
+      # Also save to state file for persistence
+      if [ -f "$STATE_FILE" ] && command -v jq &> /dev/null; then
+        update_state_json ".memory.decisions += [\"[Discussion] $decision\"]"
+      fi
+
+      # Log to history
+      local now
+      now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+      echo "{\"type\":\"discussion_decision\",\"decision\":\"$decision\",\"timestamp\":\"$now\"}" >> "$HISTORY_FILE"
+    fi
+  done < <(echo "$output" | grep "^DECISION:" || echo "$output" | grep "DECISION:")
+}
+
+# Get decisions made in discussions (for injection into next task)
+get_discussion_decisions() {
+  if [ ${#DISCUSSION_DECISIONS[@]} -gt 0 ]; then
+    echo "## Decisions from Discussion"
+    echo ""
+    for decision in "${DISCUSSION_DECISIONS[@]}"; do
+      echo "- $decision"
+    done
+  fi
+}
+
+# Clear discussion decisions (after they've been applied)
+clear_discussion_decisions() {
+  DISCUSSION_DECISIONS=()
+}