rralph 0.1.3 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fee5ec363c3f2bef533634cc0959815995c58ab6427496d0a14c381371a6ced
-  data.tar.gz: c505d1dbe57ba55bbd905130713de18927fa54528a24609baf253a39a8ac7823
+  metadata.gz: 2e6f657f4d4105579bcc44c846bb182d9f6637fc6a530fdf01490c51b994cf0e
+  data.tar.gz: b4ad22a14bb0de01d4ba50399fe2e4ed867a40ecc274c9a865ae8c948e8dcfa0
 SHA512:
-  metadata.gz: efea6825e59d661ff2e9023a4cbab82a6d10b0f713e5a63bfd070ab8ae12dff087091485b5b2ecfbd95d16b830278a0f153d59a01ccebfa763ed3b75d699103d
-  data.tar.gz: c1fdb135c8599692a362c16832ce68096d8ca064098dcd17fae1d6d227a7c2eccecd40ac8de42944898ce71b2e1ef2d8d12c7487eedacaa52521f1b58b1d8dda
+  metadata.gz: 597dbd3a4bd200b39ee9bcc7ae8cbe7872826dd90e345b7c24a8b7a92623ddfeeb96d225ea8341ee68f8ca948264ef0dc206c61d66225cabdf54020d41f5e28a
+  data.tar.gz: 7915ff47830f6cf13a54d0b2d8eb9086c1fb773964eb47dcbc493bda21416a6da3e986f4b985486c833892f3f6c7d3224caf95a73354e6523d032024e0f57447

data/README.md

@@ -111,6 +111,8 @@ Options:
                                                # Default: todo.md
   -s, [--skip-commit], [--no-skip-commit]      # Skip git commits between tasks
                                                # Default: false
+  -v, [--verbose], [--no-verbose]              # Enable verbose logging with AI thinking and real-time output
+                                               # Default: false
 ```
 
 ### Examples
@@ -153,7 +155,7 @@ Learnings: 6 lines
 1. **Read** — `rralph` reads `plan.md`, `learnings.md`, and `todo.md`
 2. **Prompt** — Builds a prompt with file contents and sends to LLM
 3. **Parse** — Analyzes AI response for:
-   - `FAILURE` keyword (case-insensitive, whole word)
+   - `TASK_FAILURE` keyword (case-sensitive, whole word)
    - New learnings to extract
 4. **Update** — On success:
    - Marks current task as complete in `todo.md`
@@ -163,7 +165,7 @@ Learnings: 6 lines
 
 ### Failure Handling
 
-- Each `FAILURE` response increments a counter
+- Each `TASK_FAILURE` response increments a counter
 - Non-failure responses reset the counter to 0
 - When max failures reached, `rralph` exits with error:
 - ```
@@ -172,14 +174,39 @@ Learnings: 6 lines
 
 ### Logging
 
-Human-readable logs are output to stderr:
+By default, `rralph` outputs concise progress logs to stderr:
+
+```
+Starting rralph with max_failures=3, ai_command='qwen-code -y -s'
+Cycle 1: Processing task: Create odd_even.sh file with bash shebang
+Executing AI command...
+Completed in 2341ms (13407 tokens)
+[Cycle 1] Task completed. 0 failures. Git commit: abc123
+   Log saved: logs/cycle_1_20260302_145738.md
+```
+
+Use `--verbose` mode for detailed real-time logging including AI thinking:
+
+```bash
+rralph start --verbose
+```
+
+Verbose output shows:
+- Thinking: AI's thought process as it thinks
+- Real-time text output from the AI
+- Completion metrics (duration, token usage)
+
+Example verbose output:
 
 ```
-✅ [Cycle 4] Task completed. 0 failures. Git commit: abc123
-❌ [Cycle 5] FAILURE detected. Failures: 2/3
+Executing AI command...
+Thinking: The user wants me to create a bash script for checking even/odd numbers
+Thinking: I need to start with the basic file structure and shebang
+   I'll create the odd_even.sh file with a proper bash shebang.
+Completed in 1847ms (8234 tokens)
 ```
 
-In `--watch` mode, AI responses are saved to `logs/` for audit trail.
+In `--watch` mode, full AI responses are saved to `logs/` for audit trail.
 
 ## License
 

data/bin/rralph

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
-require_relative "../lib/rralph"
+require_relative '../lib/rralph'
 
 Rralph::CLI.start(ARGV)

data/lib/rralph/cli.rb

@@ -1,44 +1,49 @@
-require "thor"
-require_relative "runner"
+require 'thor'
+require_relative 'runner'
 
 module Rralph
   class CLI < Thor
-    desc "start", "Run the rralph orchestrator"
+    desc 'start', 'Run the rralph orchestrator'
     method_option :max_failures,
                   type: :numeric,
                   default: 3,
-                  aliases: "-m",
-                  desc: "Maximum allowed failures before stopping"
+                  aliases: '-m',
+                  desc: 'Maximum allowed failures before stopping'
     method_option :ai_command,
                   type: :string,
-                  default: "qwen-code -y -s",
-                  aliases: "-a",
-                  desc: "AI command to invoke"
+                  default: 'qwen-code -y -s',
+                  aliases: '-a',
+                  desc: 'AI command to invoke'
     method_option :watch,
                   type: :boolean,
                   default: false,
-                  aliases: "-w",
-                  desc: "Run in continuous loop until completion or max failures"
+                  aliases: '-w',
+                  desc: 'Run in continuous loop until completion or max failures'
     method_option :plan_path,
                   type: :string,
-                  default: "plan.md",
-                  aliases: "-p",
-                  desc: "Path to plan.md file"
+                  default: 'plan.md',
+                  aliases: '-p',
+                  desc: 'Path to plan.md file'
     method_option :learnings_path,
                   type: :string,
-                  default: "learnings.md",
-                  aliases: "-l",
-                  desc: "Path to learnings.md file"
+                  default: 'learnings.md',
+                  aliases: '-l',
+                  desc: 'Path to learnings.md file'
     method_option :todo_path,
                   type: :string,
-                  default: "todo.md",
-                  aliases: "-t",
-                  desc: "Path to todo.md file"
+                  default: 'todo.md',
+                  aliases: '-t',
+                  desc: 'Path to todo.md file'
     method_option :skip_commit,
                   type: :boolean,
                   default: false,
-                  aliases: "-s",
-                  desc: "Skip git commits between tasks"
+                  aliases: '-s',
+                  desc: 'Skip git commits between tasks'
+    method_option :verbose,
+                  type: :boolean,
+                  default: false,
+                  aliases: '-v',
+                  desc: 'Enable verbose logging with AI thinking and real-time output'
 
     def start
       runner = Runner.new(
@@ -48,41 +53,42 @@ module Rralph
         plan_path: options[:plan_path],
         learnings_path: options[:learnings_path],
         todo_path: options[:todo_path],
-        skip_commit: options[:skip_commit]
+        skip_commit: options[:skip_commit],
+        verbose: options[:verbose]
       )
 
       runner.run
     rescue Rralph::FileNotFound => e
-      $stderr.puts "Error: #{e.message}"
-      $stderr.puts "Please ensure plan.md, learnings.md, and todo.md exist in the current directory."
+      warn "Error: #{e.message}"
+      warn 'Please ensure plan.md, learnings.md, and todo.md exist in the current directory.'
       exit 1
     rescue Rralph::GitError => e
-      $stderr.puts "Git Error: #{e.message}"
+      warn "Git Error: #{e.message}"
       exit 1
-    rescue => e
-      $stderr.puts "Unexpected error: #{e.message}"
-      $stderr.puts e.backtrace.first(5)
+    rescue StandardError => e
+      warn "Unexpected error: #{e.message}"
+      warn e.backtrace.first(5)
       exit 1
     end
 
-    desc "version", "Show rralph version"
+    desc 'version', 'Show rralph version'
     def version
       puts "rralph v#{Rralph::VERSION}"
     end
 
-    desc "stats", "Show progress statistics"
+    desc 'stats', 'Show progress statistics'
     method_option :plan_path,
                   type: :string,
-                  default: "plan.md",
-                  aliases: "-p"
+                  default: 'plan.md',
+                  aliases: '-p'
     method_option :learnings_path,
                   type: :string,
-                  default: "learnings.md",
-                  aliases: "-l"
+                  default: 'learnings.md',
+                  aliases: '-l'
     method_option :todo_path,
                   type: :string,
-                  default: "todo.md",
-                  aliases: "-t"
+                  default: 'todo.md',
+                  aliases: '-t'
 
     def stats
       parser = Parser.new(
@@ -101,7 +107,7 @@ module Rralph
       puts "Pending: #{pending.size}"
       puts "Learnings: #{parser.learnings_content.lines.size} lines"
     rescue Rralph::FileNotFound => e
-      $stderr.puts "Error: #{e.message}"
+      warn "Error: #{e.message}"
       exit 1
     end
 

data/lib/rralph/file_updater.rb

@@ -1,6 +1,6 @@
 module Rralph
   class FileUpdater
-    def initialize(todo_path: "todo.md", learnings_path: "learnings.md")
+    def initialize(todo_path: 'todo.md', learnings_path: 'learnings.md')
       @todo_path = todo_path
       @learnings_path = learnings_path
     end
@@ -10,17 +10,17 @@ module Rralph
       lines = content.lines
 
       line = lines[task_index]
-      if line
-        updated_line = line.gsub(/^([-*]) \[ \]/, '\1 [x]')
-        lines[task_index] = updated_line
-        File.write(@todo_path, lines.join)
-      end
+      return unless line
+
+      updated_line = line.gsub(/^([-*]) \[ \]/, '\1 [x]')
+      lines[task_index] = updated_line
+      File.write(@todo_path, lines.join)
     end
 
     def append_learnings(new_learnings)
       return if new_learnings.empty?
 
-      existing_content = File.exist?(@learnings_path) ? File.read(@learnings_path) : ""
+      existing_content = File.exist?(@learnings_path) ? File.read(@learnings_path) : ''
       existing_learnings = existing_content.lines.map(&:strip).reject(&:empty?)
 
       unique_learnings = new_learnings.reject do |learning|
@@ -29,7 +29,7 @@ module Rralph
 
       return if unique_learnings.empty?
 
-      timestamp = Time.now.strftime("%Y-%m-%d %H:%M:%S")
+      timestamp = Time.now.iso8601
       new_section = "\n\n## Learnings - #{timestamp}\n\n"
       unique_learnings.each do |learning|
         new_section += "- #{learning}\n"

data/lib/rralph/git.rb

@@ -1,28 +1,22 @@
-require "shellwords"
+require 'shellwords'
 
 module Rralph
   class Git
-    def initialize
-    end
+    def initialize; end
 
     def in_git_repo?
-      result = `git rev-parse --git-dir 2>/dev/null`
+      `git rev-parse --git-dir 2>/dev/null`
       $?.success?
     end
 
     def commit_changes(message)
       add_result = `git add . 2>&1`
-      unless $?.success?
-        raise GitError, "Failed to stage files: #{add_result}"
-      end
+      raise GitError, "Failed to stage files: #{add_result}" unless $?.success?
 
       commit_result = `git commit -m #{message.shellescape} 2>&1`
-      unless $?.success?
-        raise GitError, "Failed to commit: #{commit_result}"
-      end
+      raise GitError, "Failed to commit: #{commit_result}" unless $?.success?
 
-      sha = `git rev-parse --short HEAD 2>/dev/null`.strip
-      sha
+      `git rev-parse --short HEAD 2>/dev/null`.strip
     end
 
     def status

data/lib/rralph/parser.rb

@@ -2,18 +2,18 @@ module Rralph
   class Parser
     attr_reader :plan_content, :learnings_content, :todo_content
 
-    def initialize(plan_path: "plan.md", learnings_path: "learnings.md", todo_path: "todo.md")
+    def initialize(plan_path: 'plan.md', learnings_path: 'learnings.md', todo_path: 'todo.md')
       @plan_path = plan_path
       @learnings_path = learnings_path
       @todo_path = todo_path
     end
 
     def load_files
-      raise FileNotFound, "plan.md not found" unless File.exist?(@plan_path)
+      raise FileNotFound, 'plan.md not found' unless File.exist?(@plan_path)
 
       @plan_content = File.read(@plan_path)
-      @learnings_content = File.exist?(@learnings_path) ? File.read(@learnings_path) : ""
-      @todo_content = File.exist?(@todo_path) ? File.read(@todo_path) : ""
+      @learnings_content = File.exist?(@learnings_path) ? File.read(@learnings_path) : ''
+      @todo_content = File.exist?(@todo_path) ? File.read(@todo_path) : ''
     end
 
     def pending_tasks
@@ -21,9 +21,9 @@ module Rralph
 
       @todo_content.lines.map.with_index do |line, index|
         stripped = line.strip
-        next unless stripped.start_with?("- [ ]") || stripped.start_with?("* [ ]")
+        next unless stripped.start_with?('- [ ]') || stripped.start_with?('* [ ]')
 
-        task_text = stripped.sub(/^[-*] \[ \] /, "").strip
+        task_text = stripped.sub(/^[-*] \[ \] /, '').strip
         { index: index, line: line, text: task_text, raw: stripped }
       end.compact
     end
@@ -33,9 +33,9 @@ module Rralph
 
       @todo_content.lines.map.with_index do |line, index|
         stripped = line.strip
-        next unless stripped.start_with?("- [x]") || stripped.start_with?("* [x]")
+        next unless stripped.start_with?('- [x]') || stripped.start_with?('* [x]')
 
-        task_text = stripped.sub(/^[-*] \[x\] /i, "").strip
+        task_text = stripped.sub(/^[-*] \[x\] /i, '').strip
         { index: index, line: line, text: task_text, raw: stripped }
       end.compact
     end
@@ -48,7 +48,7 @@ module Rralph
         next unless stripped.match?(/^[-*] \[[ x]\]/i)
 
         completed = stripped.match?(/^[-*] \[x\]/i)
-        task_text = stripped.sub(/^[-*] \[[ x]\] /i, "").strip
+        task_text = stripped.sub(/^[-*] \[[ x]\] /i, '').strip
         { index: index, line: line, text: task_text, raw: stripped, completed: completed }
       end.compact
     end
@@ -58,7 +58,11 @@ module Rralph
     end
 
     def failure_detected?(response)
-      response.match?(/\bFAILURE\b/i)
+      response.match?(/\bTASK_FAILURE\b/)
+    end
+
+    def task_completed?(response)
+      response.match?(/\bTASK_DONE\b/)
     end
 
     def extract_learnings(response)
@@ -67,11 +71,26 @@ module Rralph
       # Match various learning patterns like:
       # "Learning: xyz", "**Learning to add:** xyz", "- Learning: xyz", etc.
       response.lines.each do |line|
-        if match = line.match(/(?:^|\s)(?:\*\*)?(?:Learning|Insight|Note|Tip|Discovered|Found|Realized)[\s*]*[:\s]*(?:to add)?[:\s]*(.+?)(?:\*\*)?(?:\s*$)/i)
-          learning = match[1].strip
-          learning = learning.gsub(/^\*\*|\*\*$/, "").strip
-          learnings << learning unless learning.empty?
+        learning_pattern = /
+          (?:^|\s)                    # Start of line or whitespace
+          (?:\*\*)?                   # Optional bold markdown
+          (?:Learning|Insight|Note|Tip|Discovered|Found|Realized)  # Learning keywords
+          [\s*]*                      # Optional whitespace or asterisks
+          [:\s]*                      # Optional colons or whitespace
+          (?:to\sadd)?                # Optional "to add"
+          [:\s]*                      # Optional colons or whitespace
+          (.+?)                       # Capture the actual learning content
+          (?:\*\*)?                   # Optional closing bold markdown
+          (?:\s*$)                    # Optional whitespace to end of line
+        /ix
+
+        unless match = line.match(learning_pattern)
+          next
         end
+
+        learning = match[1].strip
+        learning = learning.gsub(/^\*\*|\*\*$/, '').strip
+        learnings << learning unless learning.empty?
       end
 
       # Also extract from ## Learnings sections
@@ -81,7 +100,8 @@ module Rralph
         section.lines.each do |line|
           stripped = line.strip
           next if stripped.empty?
-          stripped = stripped.sub(/^[-*]\s*/, "")
+
+          stripped = stripped.sub(/^[-*]\s*/, '')
           learnings << stripped unless stripped.empty?
         end
       end
@@ -92,26 +112,26 @@ module Rralph
     def build_prompt(current_task: nil)
       <<~PROMPT
         You are in an iterative development loop. There is a todo list with tasks.
-        
+
         YOUR CURRENT TASK (the first unchecked item in todo.md):
         > #{current_task}
-        
+
         INSTRUCTIONS - Follow these steps in order:
         1. Implement ONLY the task shown above
         2. Write a unit test for it
         3. Run the test
         4. Respond with exactly one of:
-           - "DONE" if the task is complete and test passes
-           - "FAILURE" if the test fails after your best effort
+           - "TASK_DONE" if the task is complete and test passes
+           - "TASK_FAILURE" if the test fails after your best effort
         5. Optionally add learnings as: "Learning: <insight>"
-        
+
         IMPORTANT RULES:
         - Work on ONE task only - the one shown above
         - Do NOT implement other tasks from the todo list
         - Do NOT mark tasks as done yourself
-        - After you respond "DONE", the system will mark this task complete
+        - After you respond "TASK_DONE", the system will mark this task complete
         - Then you will receive the next task
-        
+
         --- plan.md (context) ---
         #{@plan_content}
 

data/lib/rralph/runner.rb

@@ -1,15 +1,19 @@
+require 'json'
+require 'open3'
+require 'amazing_print'
 module Rralph
   class Runner
     attr_reader :cycle_count, :failure_count, :max_failures
 
     def initialize(
       max_failures: 3,
-      ai_command: "qwen-code -y -s",
+      ai_command: 'qwen-code -y -s',
       watch: false,
-      plan_path: "plan.md",
-      learnings_path: "learnings.md",
-      todo_path: "todo.md",
-      skip_commit: false
+      plan_path: 'plan.md',
+      learnings_path: 'learnings.md',
+      todo_path: 'todo.md',
+      skip_commit: false,
+      verbose: false
     )
       @max_failures = max_failures
       @ai_command = ai_command
@@ -18,6 +22,7 @@ module Rralph
       @learnings_path = learnings_path
       @todo_path = todo_path
       @skip_commit = skip_commit
+      @verbose = verbose
 
       @cycle_count = 0
       @failure_count = 0
@@ -37,28 +42,24 @@ module Rralph
     def run
       log("Starting rralph with max_failures=#{@max_failures}, ai_command='#{@ai_command}'")
 
-      unless @git.in_git_repo?
-        raise GitError, "Not in a git repository. Please initialize git first."
-      end
+      raise GitError, 'Not in a git repository. Please initialize git first.' unless @git.in_git_repo?
 
       @parser.load_files
 
       if todo_empty_or_missing?
-        log("todo.md is empty or missing. Generating todo list from plan...")
+        log('todo.md is empty or missing. Generating todo list from plan...')
         generate_todo_from_plan
         return true
       end
 
       unless @parser.has_pending_tasks?
-        log("All tasks completed! Well done!")
+        log('All tasks completed! Well done!')
         return true
       end
 
-      if @watch
-        run_watch_loop
-      else
-        run_single_cycle
-      end
+      return run_watch_loop if @watch
+
+      run_single_cycle
     end
 
     private
@@ -69,8 +70,6 @@ module Rralph
         break unless success
         break unless @parser.has_pending_tasks?
         break if @failure_count >= @max_failures
-
-        sleep 1
       end
 
       check_final_state
@@ -82,7 +81,7 @@ module Rralph
       @parser.load_files
 
       unless @parser.has_pending_tasks?
-        log("All tasks completed! Well done!")
+        log('All tasks completed! Well done!')
         return false
       end
 
@@ -105,7 +104,13 @@ module Rralph
 
       if @parser.failure_detected?(response)
         @failure_count += 1
-        log("❌ [Cycle #{@cycle_count}] FAILURE detected. Failures: #{@failure_count}/#{@max_failures}")
+        log("❌ [Cycle #{@cycle_count}] TASK_FAILURE detected. Failures: #{@failure_count}/#{@max_failures}")
+        return handle_failure
+      end
+
+      unless @parser.task_completed?(response)
+        @failure_count += 1
+        log("❌ [Cycle #{@cycle_count}] Neither TASK_DONE nor TASK_FAILURE found. Failures: #{@failure_count}/#{@max_failures}")
         return handle_failure
       end
 
@@ -118,14 +123,12 @@ module Rralph
       @file_updater.append_learnings(new_learnings) if new_learnings.any?
 
       if @skip_commit
-        log("⏭️  [Cycle #{@cycle_count}] Skipping commit (skip_commit enabled)")
+        log("⏭️ [Cycle #{@cycle_count}] Skipping commit (skip_commit enabled)")
       else
         commit_message = "rralph: #{current_task[:text]} [cycle #{@cycle_count}]"
         sha = @git.commit_changes(commit_message)
 
-        if sha
-          log("   Git commit: #{sha}")
-        end
+        log("   Git commit: #{sha}") if sha
       end
 
       true
@@ -143,55 +146,99 @@ module Rralph
       if @failure_count >= @max_failures
         exit 1
       elsif !@parser.has_pending_tasks?
-        log("All tasks completed! Well done!")
+        log('All tasks completed! Well done!')
         exit 0
       end
     end
 
     def execute_ai_command(prompt)
-      require "tempfile"
+      full_response = ''
 
-      # Write prompt to a temporary file
-      prompt_file = Tempfile.new(["rralph_prompt", ".txt"])
-      prompt_file.write(prompt)
-      prompt_file.close
+      begin
+        log('Executing AI command...')
+
+        # Use stream-json mode for real-time logging
+        cmd = "#{@ai_command} -y -s -o stream-json"
+
+        Open3.popen3(cmd) do |stdin, stdout, _stderr, wait_thr|
+          # Write prompt to stdin and close
+          stdin.write(prompt)
+          stdin.close
+
+          # Process stdout line by line for real-time streaming
+          stdout.each_line do |line|
+            event = JSON.parse(line)
+
+            case event['type']
+            when 'assistant'
+              content = event.dig('message', 'content')
+              content&.each do |item|
+                case item['type']
+                when 'thinking'
+                  log("[Thinking] #{item['thinking']}") if @verbose
+                when 'text'
+                  text = item['text']
+                  full_response += text
+                  log("[text] #{text}") if @verbose
+                when 'tool_use'
+                  tool_name = item['name']
+                  tool_input = item['input']
+                  log("[tool_use] #{tool_name}: #{tool_input.to_json}") if @verbose
+                end
+              end
+            when 'user'
+              if @verbose
+                content = event.dig('message', 'content')
+                content&.each do |item|
+                  if item['type'] == 'tool_result'
+                    tool_name = item.dig('tool_use_id')&.split('_')&.first || 'tool'
+                    result = item['content']
+                    log("[#{tool_name}] #{result}")
+                  elsif item['type'] == 'text'
+                    log("[text] #{item['text']}")
+                  end
+                end
+              end
+            when 'result'
+              duration = event['duration_ms']
+              tokens = event.dig('usage', 'total_tokens')
+              is_error = event['is_error']
+              if is_error
+                log('AI command failed')
+              else
+                log("Completed in #{duration}ms (#{tokens} tokens)")
+              end
+            else
+              log("   [event: #{event['type']}]") if @verbose
+            end
+          rescue JSON::ParserError
+            # Skip non-JSON lines
+            log("   #{line.chomp}") if @verbose
+          end
 
-      # Read response from a temporary file  
-      response_file = Tempfile.new(["rralph_response", ".txt"])
-      response_file.close
+          log("   Command exit status: #{wait_thr.value.exitstatus}")
+        end
 
-      begin
-        # Use bash -c with proper stdin redirection
-        cmd = "bash -c #{@ai_command.shellescape} < #{prompt_file.path} > #{response_file.path} 2>&1"
-        log("   Executing: #{@ai_command}")
-        system(cmd)
-
-        log("   Command exit status: #{$?.exitstatus}")
-        
-        response = File.read(response_file.path)
-        response.strip.empty? ? nil : response
-      ensure
-        prompt_file.unlink
-        response_file.unlink
+        full_response.strip.empty? ? nil : full_response
+      rescue Errno::ENOENT => e
+        log("Error: AI command '#{@ai_command}' not found: #{e.message}")
+        nil
+      rescue StandardError => e
+        log("Error executing AI command: #{e.message}")
+        nil
       end
-    rescue Errno::ENOENT => e
-      log("Error: AI command '#{@ai_command}' not found: #{e.message}")
-      nil
-    rescue => e
-      log("Error executing AI command: #{e.message}")
-      nil
     end
 
     def save_ai_log(prompt, response)
-      logs_dir = "logs"
+      logs_dir = 'logs'
       Dir.mkdir(logs_dir) unless Dir.exist?(logs_dir)
 
-      timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
+      timestamp = Time.now.iso8601
       filename = "#{logs_dir}/cycle_#{@cycle_count}_#{timestamp}.md"
 
       # Extract just the current task for the header
       task_match = prompt.match(/YOUR CURRENT TASK.*?\n>\s*(.+?)\n/)
-      task_text = task_match ? task_match[1].strip : "Unknown"
+      task_text = task_match ? task_match[1].strip : 'Unknown'
 
       content = <<~LOG
         # Cycle #{@cycle_count} - #{timestamp}
@@ -201,7 +248,7 @@ module Rralph
 
         ## AI Response
 
-        #{response || "(no response)"}
+        #{response || '(no response)'}
       LOG
 
       File.write(filename, content)
@@ -209,18 +256,31 @@ module Rralph
     end
 
     def log(message)
-      $stderr.puts(message)
+      warn(message)
     end
 
     def todo_empty_or_missing?
       return true unless File.exist?(@todo_path)
 
       content = File.read(@todo_path)
-      content.strip.empty? || !content.match?(/^- \[ \]/m)
+      content.strip.empty?
     end
 
     def generate_todo_from_plan
-      prompt = <<~PROMPT
+      prompt = build_todo_generation_prompt
+      response = execute_ai_command(prompt)
+
+      return log('❌ AI command failed when generating todo') unless response
+
+      todo_items = extract_todo_items(response)
+      return log('❌ Could not parse tasks from AI response') if todo_items.empty?
+
+      save_todo_file(todo_items)
+      handle_todo_commit(todo_items.size)
+    end
+
+    def build_todo_generation_prompt
+      <<~PROMPT
         Based on the following plan, generate a todo list with actionable tasks.
         Format each task as a markdown checkbox like: - [ ] Task description
         Keep tasks specific and actionable.
@@ -228,32 +288,29 @@ module Rralph
         --- plan.md ---
         #{@parser.plan_content}
       PROMPT
+    end
 
-      response = execute_ai_command(prompt)
-
-      if response
-        todo_items = response.scan(/^- \[ \] .+$/).uniq
+    def extract_todo_items(response)
+      response.scan(/^- \[ \] .+$/).uniq
+    end
 
-        if todo_items.any?
-          todo_content = "# Todo List\n\n" + todo_items.join("\n") + "\n"
+    def save_todo_file(todo_items)
+      todo_content = <<~TODO
+        # Todo List
 
-          File.write(@todo_path, todo_content)
+        #{todo_items.join("\n")}
+      TODO
 
-          if @skip_commit
-            log("⏭️  Generated #{todo_items.size} tasks (skip_commit enabled, no commit)")
-          else
-            commit_message = "rralph: generated todo from plan.md"
-            sha = @git.commit_changes(commit_message)
+      File.write(@todo_path, todo_content)
+    end
 
-            if sha
-              log("✅ Generated #{todo_items.size} tasks. Git commit: #{sha}")
-            end
-          end
-        else
-          log("❌ Could not parse tasks from AI response")
-        end
+    def handle_todo_commit(task_count)
+      if @skip_commit
+        log("⏭️  Generated #{task_count} tasks (skip_commit enabled, no commit)")
       else
-        log("❌ AI command failed when generating todo")
+        commit_message = 'rralph: generated todo from plan.md'
+        sha = @git.commit_changes(commit_message)
+        log("✅ Generated #{task_count} tasks. Git commit: #{sha}") if sha
       end
     end
   end

data/lib/rralph.rb

@@ -1,5 +1,5 @@
 module Rralph
-  VERSION = "0.1.3"
+  VERSION = '0.2.1'
 
   class Error < StandardError; end
   class FileNotFound < Error; end
@@ -7,8 +7,8 @@ module Rralph
   class AICommandError < Error; end
 end
 
-require_relative "rralph/parser"
-require_relative "rralph/file_updater"
-require_relative "rralph/git"
-require_relative "rralph/runner"
-require_relative "rralph/cli"
+require_relative 'rralph/parser'
+require_relative 'rralph/file_updater'
+require_relative 'rralph/git'
+require_relative 'rralph/runner'
+require_relative 'rralph/cli'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rralph
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.1
 platform: ruby
 authors:
 - rralph