agentic-loop 3.18.1 → 3.19.0

package/bin/ralph.sh

@@ -142,6 +142,12 @@ main() {
       echo "Stop signal sent. Ralph will stop after current story completes."
       echo "(Use Ctrl+C to force stop immediately)"
       ;;
+    skip)
+      # Signal the loop to skip the current story and move to the next one
+      mkdir -p "$RALPH_DIR"
+      touch "$RALPH_DIR/.skip"
+      echo "Skip signal sent. Ralph will skip the current story when Claude finishes."
+      ;;
     status)
       ralph_status "$@"
       ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-loop",
-  "version": "3.18.1",
+  "version": "3.19.0",
   "description": "Autonomous AI coding loop - PRD-driven development with Claude Code",
   "author": "Allie Jones <allie@allthrive.ai>",
   "license": "MIT",

package/ralph/init.sh

@@ -744,6 +744,8 @@ Commands:
   run                     Run autonomous loop until all stories pass
   run --max <n>           Run with max iterations (default: 20)
   run --fast              Skip code review for faster iterations
+  stop                    Stop loop after current story finishes
+  skip                    Skip the current story, move to next
   status                  Show current feature and story status
   check                   Run verification checks only
   verify <story-id>       Verify a specific story

package/ralph/loop.sh

@@ -391,6 +391,10 @@ PATTERN: <pattern>"
 }
 
 run_loop() {
+  # Trap Ctrl+C to stop the loop cleanly.
+  # Creates .stop file so the loop exits at the next iteration check, then kills children.
+  trap 'echo ""; print_warning "Ctrl+C received — stopping loop..."; touch "$RALPH_DIR/.stop"; trap - INT; kill -INT $$' INT
+
   local max_iterations="$DEFAULT_MAX_ITERATIONS"
   local specific_story=""
   local fast_mode=false
@@ -748,6 +752,33 @@ run_loop() {
 
     rm -f "$claude_output_log"
 
+    # Check for skip signal (user ran `ralph skip` while Claude was running)
+    if [[ -f "$RALPH_DIR/.skip" ]]; then
+      rm -f "$RALPH_DIR/.skip"
+      print_warning "Skip signal received — skipping $story"
+      log_progress "$story" "SKIPPED" "User requested skip"
+      skipped_stories+=("$story")
+      jq --arg id "$story" '(.stories[] | select(.id==$id)) |= . + {skipped: true, skipReason: "user skipped"}' \
+        "$RALPH_DIR/prd.json" > "$RALPH_DIR/prd.json.tmp" && mv "$RALPH_DIR/prd.json.tmp" "$RALPH_DIR/prd.json"
+      last_story=""
+      consecutive_failures=0
+      consecutive_timeouts=0
+      session_started=false
+      rm -f "$prompt_file"
+      continue
+    fi
+
+    # Check for stop signal (user ran `ralph stop` or Ctrl+C while Claude was running)
+    if [[ -f "$RALPH_DIR/.stop" ]]; then
+      rm -f "$RALPH_DIR/.stop" "$prompt_file"
+      print_warning "Stop signal received. Exiting gracefully."
+      local passed failed
+      passed=$(jq '[.stories[] | select(.passes==true)] | length' "$RALPH_DIR/prd.json" 2>/dev/null || echo "0")
+      failed=$(jq '[.stories[] | select(.passes==false)] | length' "$RALPH_DIR/prd.json" 2>/dev/null || echo "0")
+      send_notification "🛑 Ralph stopped: $passed passed, $failed remaining"
+      return 0
+    fi
+
     if [[ $claude_exit_code -ne 0 ]]; then
       ((consecutive_timeouts++))
       print_warning "Claude session ended (timeout or error) - timeout $consecutive_timeouts/$max_timeouts"
@@ -950,6 +981,36 @@ startup_checklist() {
   fi
 }
 
+# Helper: Check if files listed in a story's files.create/files.modify already exist on disk
+# Returns newline-separated list of existing files (empty string if none)
+_check_story_files_exist() {
+  local story_id="$1"
+  local prd_file="$RALPH_DIR/prd.json"
+  [[ ! -f "$prd_file" ]] && return
+
+  local file_list
+  file_list=$(jq -r --arg id "$story_id" '
+    .stories[] | select(.id == $id) |
+    ((.files.create // []) + (.files.modify // [])) | .[]
+  ' "$prd_file" 2>/dev/null) || return
+
+  [[ -z "$file_list" ]] && return
+
+  local existing=""
+  while IFS= read -r f; do
+    [[ -z "$f" ]] && continue
+    if [[ -f "$f" ]]; then
+      if [[ -z "$existing" ]]; then
+        existing="$f"
+      else
+        existing="$existing"$'\n'"$f"
+      fi
+    fi
+  done <<< "$file_list"
+
+  [[ -n "$existing" ]] && echo "$existing"
+}
+
 # Helper: Build delta prompt for continuing session
 # Minimal context - just story ID + any failure info
 _build_delta_prompt() {
@@ -964,6 +1025,15 @@ _build_delta_prompt() {
   if [[ -n "$failure_context" ]]; then
     echo "## Retry: Fix the errors below"
     echo ""
+
+    # Check if story files already exist — if so, skip re-implementation
+    local existing_files
+    existing_files=$(_check_story_files_exist "$story")
+    if [[ -n "$existing_files" ]]; then
+      echo "**The code is ALREADY WRITTEN.** Do NOT rewrite. Fix ONLY the errors below, then verify."
+      echo ""
+    fi
+
     echo "Read \`.ralph/last_failure.txt\` for full error details."
     echo ""
     echo '```'
@@ -1039,6 +1109,20 @@ build_prompt() {
     echo ""
     echo "## Previous Iteration Failed"
     echo ""
+
+    # Check if story files already exist — if so, skip re-implementation
+    local existing_files
+    existing_files=$(_check_story_files_exist "$story")
+    if [[ -n "$existing_files" ]]; then
+      echo "**IMPORTANT: The code for this story is ALREADY WRITTEN.** These files exist:"
+      echo '```'
+      echo "$existing_files"
+      echo '```'
+      echo "Do NOT rewrite or re-implement. Read the existing code, then fix ONLY the"
+      echo "specific errors below. Go straight to verification after fixing."
+      echo ""
+    fi
+
     echo "Read \`.ralph/last_failure.txt\` for details. Key error:"
     echo ""
     echo '```'