ralph.rb 1.2.4355354345 → 2.0.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ralph.rb
 version: !ruby/object:Gem::Version
-  version: 1.2.4355354345
+  version: 2.0.0
 platform: ruby
 authors:
 - Nathan Kidd
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-02 00:00:00.000000000 Z
+date: 2026-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -68,58 +68,42 @@ files:
 - ".ruby-version"
 - AGENTS.md
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - bin/rubocop
 - bin/test
 - exe/ralph
 - lib/ralph.rb
-- lib/ralph/agents.rb
-- lib/ralph/agents/base.rb
-- lib/ralph/agents/claude_code.rb
-- lib/ralph/agents/codex.rb
-- lib/ralph/agents/open_code.rb
 - lib/ralph/cli.rb
-- lib/ralph/config.rb
-- lib/ralph/git/file_snapshot.rb
-- lib/ralph/helpers.rb
-- lib/ralph/iteration.rb
+- lib/ralph/display.rb
+- lib/ralph/events.rb
 - lib/ralph/loop.rb
-- lib/ralph/output/active_loop_error.rb
-- lib/ralph/output/banner.rb
-- lib/ralph/output/completion_deferred.rb
-- lib/ralph/output/completion_detected.rb
-- lib/ralph/output/config_summary.rb
-- lib/ralph/output/context_consumed.rb
-- lib/ralph/output/iteration.rb
-- lib/ralph/output/max_iterations_reached.rb
-- lib/ralph/output/no_plugin_warning.rb
-- lib/ralph/output/nonzero_exit_warning.rb
-- lib/ralph/output/plugin_error.rb
-- lib/ralph/output/status.rb
-- lib/ralph/output/struggle_warning.rb
-- lib/ralph/output/task_completion.rb
-- lib/ralph/output/tasks_file_created.rb
-- lib/ralph/prompt_template.rb
-- lib/ralph/storage/context.rb
-- lib/ralph/storage/history.rb
-- lib/ralph/storage/state.rb
-- lib/ralph/storage/tasks.rb
-- lib/ralph/threads/heartbeat.rb
-- lib/ralph/threads/stream_reader.rb
+- lib/ralph/metrics.rb
+- lib/ralph/opencode.rb
 - lib/ralph/version.rb
-- original/bin/ralph.js
-- original/ralph.ts
+- plans/00-complete-implementation.md
+- plans/01-cli-implementation.md
+- plans/02-loop-implementation.md
+- plans/03-agents-implementation.md
+- plans/04-metrics-implementation.md
+- plans/README.md
 - ralph.gemspec
 - ralph2.gemspec
 - screenshot.webp
 - specs/README.md
+- specs/__templates__/API_TEMPLATE.md
+- specs/__templates__/AUTOMATION_ACTION_TEMPLATE.md
+- specs/__templates__/AUTOMATION_TRIGGER_TEMPLATE.md
+- specs/__templates__/CONTROLLER_TEMPLATE.md
+- specs/__templates__/INTEGRATION_TEMPLATE.md
+- specs/__templates__/MODEL_TEMPLATE.md
 - specs/agents.md
 - specs/cli.md
-- specs/iteration.md
-- specs/output.md
-- specs/storage/local-data-structure.md
-- specs/tasks.md
+- specs/lib/todo_item.rb
+- specs/log
+- specs/loop.md
+- specs/metrics.md
 homepage: https://github.com/n-at-han-k/ralph.rb
 licenses:
 - MIT

data/lib/ralph/agents/base.rb

@@ -1,132 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-
-module Ralph
-  module Agents
-    class Base
-      include ::Ralph::Helpers
-
-      # Result of executing an agent process
-      ExecutionResult = Struct.new(:stdout_text, :stderr_text, :tool_counts, :exit_code, keyword_init: true) do
-        def combined_output
-          "#{stdout_text}\n#{stderr_text}"
-        end
-      end
-
-      def type        = raise NotImplementedError
-      def command     = raise NotImplementedError
-      def config_name = raise NotImplementedError
-
-      def parse_tool_output(_line) = raise NotImplementedError
-      def build_args(_prompt, _model, _options) = raise NotImplementedError
-
-      def build_env(_options) = ENV.to_h.dup
-
-      def execute(prompt, options = {})
-        command_args = build_args(prompt, options[:model],
-                                  { allow_all_permissions: options[:allow_all_permissions] })
-        environment = build_env(
-          filter_plugins: options[:disable_plugins],
-          allow_all_permissions: options[:allow_all_permissions]
-        )
-        full_command = [command] + command_args
-
-        if options[:stream_output]
-          execute_streaming(environment, full_command, options[:on_line])
-        else
-          execute_captured(environment, full_command)
-        end
-      rescue StandardError => agent_error
-        Agents::Base::ExecutionResult.new(
-          stdout_text: "", stderr_text: agent_error.to_s, tool_counts: {}, exit_code: -1
-        )
-      end
-
-      # Collects tool usage counts from output text.
-      # Delegates to parse_tool_output for each line.
-      def collect_tool_counts(text)
-        Hash.new(0).tap do |counts|
-          text.each_line do |line|
-            tool = parse_tool_output(line)
-            counts[tool] += 1 if tool
-          end
-        end
-      end
-
-      # Returns a fatal error message if one is detected in the output,
-      # or nil if no fatal error is found. Subclasses may override.
-      def detect_fatal_error(_output) = nil
-
-      # Extracts error patterns from agent output. Subclasses may override
-      # for agent-specific error formats.
-      def extract_errors(output)
-        errors = []
-        output.each_line do |line|
-          lower = line.downcase
-          if lower.include?("error:") ||
-             lower.include?("failed:") ||
-             lower.include?("exception:") ||
-             lower.include?("typeerror") ||
-             lower.include?("syntaxerror") ||
-             lower.include?("referenceerror") ||
-             (lower.include?("test") && lower.include?("fail"))
-            cleaned = line.strip[0, 200]
-            errors << cleaned if cleaned && !cleaned.empty? && !errors.include?(cleaned)
-          end
-        end
-        errors.first(10)
-      end
-
-      def validate!
-        path = which(command)
-        unless path
-          $stderr.puts "Error: #{config_name} CLI ('#{command}') not found."
-          exit 1
-        end
-      end
-
-      private
-
-        def execute_streaming(environment, full_command, on_line)
-          tool_counts = Hash.new(0)
-          stdout_text = +""
-          stderr_text = +""
-          mutex = Mutex.new
-
-          stdin, stdout, stderr, wait_thread = Open3.popen3(environment, *full_command)
-          stdin.close
-
-          stdout_reader = Threads::StreamReader.new(
-            stdout, stdout_text, mutex, tool_counts, on_line, false, method(:parse_tool_output)
-          )
-          stderr_reader = Threads::StreamReader.new(
-            stderr, stderr_text, mutex, tool_counts, on_line, true, method(:parse_tool_output)
-          )
-
-          stdout_reader.join
-          stderr_reader.join
-          exit_status = wait_thread.value
-
-          ExecutionResult.new(
-            stdout_text: stdout_text,
-            stderr_text: stderr_text,
-            tool_counts: tool_counts,
-            exit_code: exit_status.exitstatus || 1
-          )
-        end
-
-        def execute_captured(environment, full_command)
-          stdout, stderr, status = Open3.capture3(environment, *full_command, stdin_data: "")
-          tool_counts = collect_tool_counts("#{stdout}\n#{stderr}")
-
-          ExecutionResult.new(
-            stdout_text: stdout,
-            stderr_text: stderr,
-            tool_counts: tool_counts,
-            exit_code: status.exitstatus || 1
-          )
-        end
-    end
-  end
-end

data/lib/ralph/agents/claude_code.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Ralph
-  module Agents
-    class ClaudeCode < Base
-
-      def type = :claude_code
-      def command = "claude"
-      def config_name = "Claude Code"
-
-      def build_args(prompt, model, options)
-        args = ["-p", prompt]
-        args.push("--model", model) if model && !model.empty?
-        args.push("--dangerously-skip-permissions") if options && options[:allow_all_permissions]
-        args
-      end
-
-      def parse_tool_output(line)
-        match = strip_ansi(line).match(/(?:Using|Called|Tool:)\s+([A-Za-z0-9_-]+)/i)
-        match ? match[1] : nil
-      end
-    end
-  end
-end

data/lib/ralph/agents/codex.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Ralph
-  module Agents
-    class Codex < Base
-
-      def type = :codex
-      def command = "codex"
-      def config_name = "Codex"
-
-      def build_args(prompt, model, options)
-        args = ["exec"]
-        args.push("--model", model) if model && !model.empty?
-        args.push("--full-auto") if options && options[:allow_all_permissions]
-        args.push(prompt)
-        args
-      end
-
-      def parse_tool_output(line)
-        match = strip_ansi(line).match(/(?:Tool:|Using|Calling|Running)\s+([A-Za-z0-9_-]+)/i)
-        match ? match[1] : nil
-      end
-    end
-  end
-end

data/lib/ralph/agents/open_code.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Ralph
-  module Agents
-    class OpenCode < Base
-
-      def type = :opencode
-      def command = "opencode"
-      def config_name = "OpenCode"
-
-      def build_args(prompt, model, _options)
-        args = ["run"]
-        args.push("-m", model) if model && !model.empty?
-        args.push(prompt)
-        args
-      end
-
-      def parse_tool_output(line)
-        match = strip_ansi(line).match(/^\|\s{2}([A-Za-z0-9_-]+)/)
-        match ? match[1] : nil
-      end
-
-      def detect_fatal_error(output)
-        if output.include?("ralph-wiggum is not yet ready for use. This is a placeholder package.")
-          "Placeholder plugin error detected"
-        end
-      end
-    end
-  end
-end

data/lib/ralph/agents.rb

@@ -1,24 +0,0 @@
-module Ralph
-  module Agents
-
-    module_function
-
-    AGENT_NAME_MAP = {
-      "opencode" => :opencode,
-      "claude-code" => :claude_code,
-      "codex" => :codex
-    }.freeze
-
-    def valid_agent_names = AGENT_NAME_MAP.keys
-
-    def resolve(name_str)
-      AGENT_NAME_MAP[name_str].then do |sym|
-        case sym
-        when :opencode    then OpenCode.new
-        when :claude_code then ClaudeCode.new
-        when :codex       then Codex.new
-        else nil          end
-      end
-    end
-  end
-end

data/lib/ralph/config.rb

@@ -1,40 +0,0 @@
-module Ralph
-  class Config
-    # Single source of truth for config option names and their defaults.
-    # Use a lambda for mutable defaults to avoid shared state.
-    OPTIONS = {
-      prompt:                -> { PromptTemplate.new("") },
-      min_iterations:        1,
-      max_iterations:        0,
-      completion_promise:    "COMPLETE",
-      tasks_mode:            false,
-      task_promise:          "READY_FOR_NEXT_TASK",
-      model:                 "",
-      chosen_agent:            "opencode",
-      disable_plugins:       false,
-      allow_all_permissions: true,
-      stream_output:         true,
-      verbose_tools:         false,
-    }.freeze
-
-    attr_accessor(*OPTIONS.keys)
-
-    # Runtime state (not constructor args, not in to_h).
-    attr_accessor :current_pid, :stopping
-
-    def initialize(**opts)
-      OPTIONS.each do |key, default|
-        value = opts.fetch(key) { default.respond_to?(:call) ? default.call : default }
-        instance_variable_set(:"@#{key}", value)
-      end
-      @current_pid = nil
-      @stopping    = false
-    end
-
-    # Returns a hash of options suitable for passing to Loop#call.
-    # Excludes runtime state (current_pid, stopping).
-    def to_h
-      OPTIONS.keys.map { |k| [k, send(k)] }.to_h
-    end
-  end
-end

data/lib/ralph/git/file_snapshot.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-
-module Ralph
-  module Git
-    # Captures and compares file state via git for change detection
-    class FileSnapshot
-      attr_reader :files
-
-      def initialize(files)
-        @files = files
-      end
-
-      # Capture a snapshot of all tracked/modified files and their git hashes
-      def self.capture
-        files = {}
-        begin
-          status, _, _ = Open3.capture3("git", "status", "--porcelain")
-          tracked, _, _ = Open3.capture3("git", "ls-files")
-
-          all_files = Set.new
-          status.strip.each_line do |line|
-            name = line[3..]&.strip
-            all_files.add(name) if name && !name.empty?
-          end
-          tracked.strip.each_line do |file|
-            f = file.strip
-            all_files.add(f) unless f.empty?
-          end
-
-          all_files.each do |file|
-            begin
-              hash, _, _ = Open3.capture3("git", "hash-object", file)
-              files[file] = hash.strip unless hash.strip.empty?
-            rescue StandardError
-              # skip
-            end
-          end
-        rescue StandardError
-          # git not available
-        end
-        new(files)
-      end
-
-      # Return list of files that changed between this snapshot and a later one
-      def modified_since(other)
-        Array.new.tap do |changed|
-          other.files.each do |file, hash|
-            changed << file if files[file] != hash
-          end
-
-          files.each_key do |file|
-            changed << file unless other.files.key?(file)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ralph/helpers.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-module Ralph
-  module Helpers
-    def strip_ansi(input)
-      input.gsub(/\x1B\[[0-9;]*m/, "")
-    end
-
-    def escape_regex(str)
-      Regexp.escape(str)
-    end
-
-    def format_duration(ms)
-      total_seconds = [0, (ms / 1000).floor].max
-      hours = total_seconds / 3600
-      minutes = (total_seconds % 3600) / 60
-      seconds = total_seconds % 60
-
-      if hours > 0
-        "#{hours}:#{minutes.to_s.rjust(2, '0')}:#{seconds.to_s.rjust(2, '0')}"
-      else
-        "#{minutes}:#{seconds.to_s.rjust(2, '0')}"
-      end
-    end
-
-    def format_duration_long(ms)
-      total_seconds = [0, (ms / 1000).floor].max
-      hours = total_seconds / 3600
-      minutes = (total_seconds % 3600) / 60
-      seconds = total_seconds % 60
-
-      if hours > 0
-        "#{hours}h #{minutes}m #{seconds}s"
-      elsif minutes > 0
-        "#{minutes}m #{seconds}s"
-      else
-        "#{seconds}s"
-      end
-    end
-
-    def format_tool_summary(tool_counts, max_items = 6)
-      if tool_counts.empty?
-        ""
-      else
-        entries = tool_counts.sort_by { |_, v| -v }
-        shown = entries.first(max_items)
-        remaining = entries.length - shown.length
-
-        shown.map { |name, count| "#{name} #{count}" }
-          .tap { |parts| parts << "+#{remaining} more" if remaining > 0 }
-          .then { |parts| parts.join(" • ") }
-      end
-    end
-
-    def check_completion(output, promise)
-      pattern = /<promise>\s*#{escape_regex(promise)}\s*<\/promise>/i
-      output.match?(pattern)
-    end
-
-    # Cross-platform which
-    def which(cmd)
-      exts = ENV["PATHEXT"] ? ENV["PATHEXT"].split(";") : [""]
-      ENV["PATH"].split(File::PATH_SEPARATOR).each do |path|
-        exts.each do |ext|
-          exe = File.join(path, "#{cmd}#{ext}")
-          return exe if File.executable?(exe) && !File.directory?(exe)
-        end
-      end
-      nil
-    end
-
-    def now_ms
-      (Time.now.to_f * 1000).to_i
-    end
-  end
-end