wralph 0.1.2

data/lib/wralph/run/feedback.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+begin
+  require 'reline'
+rescue LoadError
+  # Fallback for older Ruby versions - reline was added in Ruby 2.7
+  # Use basic $stdin.gets for multiline input
+end
+
+require_relative '../interfaces/repo'
+require_relative '../interfaces/print'
+require_relative '../interfaces/shell'
+require_relative '../interfaces/agent'
+require_relative 'init'
+require_relative 'iterate_ci'
+
+module Wralph
+  module Run
+    module Feedback
+      def self.run(issue_number)
+        Init.ensure_initialized!
+
+        branch_name = "issue-#{issue_number}".freeze
+        plan_file = Interfaces::Repo.plan_file(issue_number)
+
+        stdout, = Interfaces::Shell.run_command('git branch --show-current')
+        current_branch = stdout.strip
+        Interfaces::Shell.switch_into_worktree(branch_name, create_if_not_exists: false)
+
+        # Check that the Pull Request is open
+        stdout, = Interfaces::Shell.run_command("gh pr view #{branch_name} --json state -q .state")
+        if stdout.strip != 'OPEN'
+          Interfaces::Print.error "Pull Request #{issue_number} is not open. Please open it and try again."
+          exit 1
+        end
+
+        # Get input from user on changes to make to the Pull Request
+        Interfaces::Print.info "Please review the changes to the Pull Request and provide feedback on what changes to make."
+        Interfaces::Print.info "  - Press Enter for a new line"
+        Interfaces::Print.info "  - Press Enter three times to submit"
+
+        if defined?(Reline)
+          changes = Reline.readmultiline("> ", true) do |buffer|
+            # Submit when the last line is empty (user pressed Enter on empty line)
+            # Buffer ends with "\n\n" when user presses Enter on an empty line
+            # We need content before the empty line
+            next false if buffer.empty? || buffer == "\n"
+
+            # Check if buffer ends with double newline (empty line entered)
+            if buffer.end_with?("\n\n\n")
+              # Verify we have at least one non-empty line
+              lines = buffer.split("\n")
+              lines.any? { |line| !line.strip.empty? }
+            else
+              false
+            end
+          end
+          # Remove the trailing empty line if present
+        else
+          # Fallback for older Ruby versions without reline
+          changes = ""
+          puts "> "
+          loop do
+            line = $stdin.gets
+            break if line.nil? || line.strip.empty?
+
+            changes += line
+            # Check if we've had two consecutive empty lines
+            if changes.end_with?("\n\n")
+              changes = changes.chomp
+              break
+            end
+          end
+        end
+        changes = changes.chomp
+
+        # Ask Claude to make the changes
+        Interfaces::Print.info "Asking Claude to evaluate your comments to the Pull Request..."
+        instructions = <<~INSTRUCTIONS
+          Background: You previously created a plan (found in the file #{plan_file}) and executed changes into a Pull Request
+          from the current branch (#{branch_name}) to the git origin. You can compare this branch against master
+          to see your proposed changes.
+
+          The user has reviewed your Pull Request and requested the following changes:
+
+          #{changes}
+
+          Do as follows:
+            1. Review your original plan that you documented in the plan file: `#{plan_file}`
+            2. Analyze the code changes that you've made in this branch by comparing it to the master branch
+            2. Review the user input
+            3. Make the necessary changes address the issues raised by the user
+            4. Commit and push the changes to the Pull Request branch
+            5. After pushing, output "FIXES_PUSHED" so I know you've completed the fixes
+        INSTRUCTIONS
+
+        # Run claude code with instructions
+        claude_output = Interfaces::Agent.run(instructions)
+        puts "CLAUDE_OUTPUT: #{claude_output}"
+
+        # Check if fixes were pushed
+        if claude_output.include?('FIXES_PUSHED')
+          Interfaces::Print.success 'Fixes have been pushed. Waiting before checking build status again...'
+          sleep 60 # Wait a bit for CircleCI to pick up the new commit
+        else
+          Interfaces::Print.error 'Could not confirm that fixes were pushed. Please check manually.'
+          exit 1
+        end
+
+        IterateCI.run(issue_number)
+
+        Interfaces::Shell.switch_into_worktree(current_branch)
+      end
+    end
+  end
+end

data/lib/wralph/run/init.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require_relative '../interfaces/repo'
+require_relative '../interfaces/print'
+
+module Wralph
+  module Run
+    module Init
+      def self.run
+        wralph_dir = Interfaces::Repo.wralph_dir
+        plans_dir = Interfaces::Repo.plans_dir
+
+        if Dir.exist?(wralph_dir)
+          Interfaces::Print.warning ".wralph directory already exists at #{wralph_dir}"
+          Interfaces::Print.info "Skipping initialization"
+          return
+        end
+
+        # Create .wralph directory
+        FileUtils.mkdir_p(wralph_dir)
+        Interfaces::Print.success "Created .wralph directory at #{wralph_dir}"
+
+        # Create plans subdirectory
+        FileUtils.mkdir_p(plans_dir)
+        Interfaces::Print.success "Created .wralph/plans directory"
+
+        # Create secrets.yaml template
+        secrets_file = Interfaces::Repo.secrets_file
+        unless File.exist?(secrets_file)
+          secrets_fixture = Interfaces::Repo.fixture_file('secrets.yaml')
+          if File.exist?(secrets_fixture)
+            FileUtils.cp(secrets_fixture, secrets_file)
+            Interfaces::Print.success "Created .wralph/secrets.yaml template"
+          else
+            Interfaces::Print.warning "Fixture file not found: #{secrets_fixture}"
+          end
+        end
+
+        # Create config.yaml template
+        config_file = Interfaces::Repo.config_file
+        unless File.exist?(config_file)
+          config_fixture = Interfaces::Repo.fixture_file('config.yaml')
+          if File.exist?(config_fixture)
+            FileUtils.cp(config_fixture, config_file)
+            Interfaces::Print.success "Created .wralph/config.yaml template"
+          else
+            Interfaces::Print.warning "Fixture file not found: #{config_fixture}"
+          end
+        end
+
+        # Ensure .wralph/secrets.yaml is in .gitignore
+        update_gitignore
+
+        Interfaces::Print.success "WRALPH initialized successfully!"
+        Interfaces::Print.info "You can now use 'wralph plan <issue_number>' to get started"
+      end
+
+      def self.initialized?
+        wralph_dir = Interfaces::Repo.wralph_dir
+        Dir.exist?(wralph_dir)
+      end
+
+      def self.ensure_initialized!
+        return if initialized?
+
+        Interfaces::Print.error "WRALPH has not been initialized in this repository."
+        Interfaces::Print.error ""
+        Interfaces::Print.error "Please run 'wralph init' first to set up WRALPH."
+        exit 1
+      rescue SystemExit
+        raise
+      rescue StandardError => e
+        Interfaces::Print.error "Error checking initialization: #{e.message}"
+        exit 1
+      end
+
+      def self.update_gitignore
+        repo_root = Interfaces::Repo.repo_root
+        gitignore_path = File.join(repo_root, '.gitignore')
+        secrets_ignore_entry = '.wralph/secrets.yaml'
+
+        # Check if entry already exists
+        if File.exist?(gitignore_path)
+          content = File.read(gitignore_path)
+          return if content.include?(secrets_ignore_entry)
+        end
+
+        # Add entry to .gitignore
+        entry = "\n# WRALPH secrets\n#{secrets_ignore_entry}\n"
+        File.open(gitignore_path, 'a') do |f|
+          f.write(entry)
+        end
+        Interfaces::Print.success "Added .wralph/secrets.yaml to .gitignore"
+      end
+    end
+  end
+end

data/lib/wralph/run/iterate_ci.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require_relative '../interfaces/repo'
+require_relative '../interfaces/print'
+require_relative '../interfaces/shell'
+require_relative '../interfaces/agent'
+require_relative '../interfaces/ci'
+
+module Wralph
+  module Run
+    module IterateCI
+      MAX_RETRIES = 10
+
+      def self.run(issue_number, pr_number = nil)
+        branch_name = "issue-#{issue_number}".freeze
+        pr_number ||= begin
+          stdout, = Interfaces::Shell.run_command("gh pr list --head #{branch_name} --json number -q '.[0].number'")
+          pr_num = stdout.strip
+          pr_num.empty? || pr_num == 'null' ? nil : pr_num
+        end
+
+        stdout, = Interfaces::Shell.run_command('git branch --show-current')
+        current_branch = stdout.strip
+        if current_branch != branch_name
+          Interfaces::Print.error "You are not on the branch #{branch_name}. Please switch to the branch #{branch_name} and try again."
+          exit 1
+        end
+
+        if pr_number.nil?
+          Interfaces::Print.error "Could not determine PR number from the branch name."
+          exit 1
+        end
+
+        plan_file = Interfaces::Repo.plan_file(issue_number)
+
+        api_token = Interfaces::Ci.api_token
+        if api_token.nil? || api_token.empty?
+          Interfaces::Print.error 'ci_api_token is not set in .wralph/secrets.yaml'
+          Interfaces::Print.error ''
+          Interfaces::Print.error 'Please add your CircleCI API token to .wralph/secrets.yaml:'
+          Interfaces::Print.error '  ci_api_token: your-token-here'
+          exit 1
+        else
+          Interfaces::Print.success 'Loaded CI API token from .wralph/secrets.yaml'
+        end
+        retry_count = 0
+
+        # Get repository info
+        repo_owner, = Interfaces::Shell.run_command('gh repo view --json owner -q .owner.login')
+        repo_name, = Interfaces::Shell.run_command('gh repo view --json name -q .name')
+
+        # Ensure tmp directory exists
+        FileUtils.mkdir_p(Interfaces::Repo.tmp_dir)
+
+        while retry_count < MAX_RETRIES
+          Interfaces::Print.info "Iteration #{retry_count + 1}/#{MAX_RETRIES}"
+
+          # Wait for build to complete
+          if Interfaces::Ci.wait_for_build(pr_number, repo_owner, repo_name, api_token)
+            Interfaces::Print.success "CircleCI build passed! Issue ##{issue_number} has been successfully solved."
+            return true
+          end
+
+          # Build failed, get failure details
+          Interfaces::Print.warning 'Build failed. Analyzing failures...'
+          failure_details = Interfaces::Ci.build_failures(pr_number, repo_owner, repo_name, api_token) || 'Could not fetch failure details'
+
+          Interfaces::Print.info 'Failure details:'
+          puts failure_details
+
+          retry_count += 1
+
+          if retry_count >= MAX_RETRIES
+            Interfaces::Print.error "Maximum retry count (#{MAX_RETRIES}) reached. Please fix the issues manually."
+            exit 1
+          end
+
+          # Store the failure details in a new file for each iteration
+          filename = Interfaces::Repo.failure_details_file(branch_name, retry_count)
+          File.write(filename, failure_details)
+
+          # Fix the issues
+          Interfaces::Print.info "Attempting to fix the issues (attempt #{retry_count}/#{MAX_RETRIES})..."
+
+          fix_instructions = <<~FIX_INSTRUCTIONS
+            The CircleCI build for PR ##{pr_number} has failed. The failure details have been logged into the following file:
+
+            #{filename}
+
+            Do as follows:
+            1. Review your original plan that you documented in the plan file: `#{plan_file}`
+            2. Analyze the failures above
+            3. Make the necessary changes to fix the issues
+            4. Commit and push the changes to the PR branch
+            5. After pushing, output "FIXES_PUSHED" so I know you've completed the fixes
+
+            The PR branch is: `issue-#{issue_number}`
+          FIX_INSTRUCTIONS
+
+          # Pass fix instructions to claude code
+          fix_output = Interfaces::Agent.run(fix_instructions)
+          puts "FIX_OUTPUT: #{fix_output}"
+
+          # Check if fixes were pushed
+          if fix_output.include?('FIXES_PUSHED')
+            Interfaces::Print.success 'Fixes have been pushed. Waiting before checking build status again...'
+            sleep 60 # Wait a bit for CircleCI to pick up the new commit
+          else
+            Interfaces::Print.error 'Could not confirm that fixes were pushed. Please check manually.'
+            exit 1
+          end
+        end
+
+        Interfaces::Print.error "Failed to resolve CircleCI build issues after #{MAX_RETRIES} attempts"
+        exit 1
+      end
+    end
+  end
+end

data/lib/wralph/run/plan.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require_relative '../interfaces/repo'
+require_relative '../interfaces/print'
+require_relative '../interfaces/shell'
+require_relative '../interfaces/agent'
+require_relative '../interfaces/objective_repository'
+require_relative 'init'
+require_relative 'execute_plan'
+
+module Wralph
+  module Run
+    module Plan
+      def self.run(issue_number)
+        Init.ensure_initialized!
+
+        plan_file = Interfaces::Repo.plan_file(issue_number)
+        branch_name = "issue-#{issue_number}".freeze
+
+        # Ensure plans directory exists
+        FileUtils.mkdir_p(Interfaces::Repo.plans_dir)
+
+        # Check if GitHub CLI is authenticated
+        _, _, success = Interfaces::Shell.run_command('gh auth status')
+        unless success
+          Interfaces::Print.error 'GitHub CLI is not authenticated. Please run \'gh auth login\''
+          exit 1
+        end
+
+        # Check for uncommitted changes
+        _, _, success = Interfaces::Shell.run_command('git diff-index --quiet HEAD --')
+        unless success
+          Interfaces::Print.warning 'You have uncommitted changes. The script will create a new branch, but consider committing or stashing your changes first.'
+          Interfaces::Shell.ask_user_to_continue('Continue anyway? (y/N) ')
+        end
+
+        # Fetch issue details to verify it exists and download it
+        Interfaces::Print.info "Fetching GitHub issue ##{issue_number}..."
+        begin
+          Interfaces::ObjectiveRepository.download!(issue_number)
+        rescue StandardError => e
+          Interfaces::Print.error "Issue ##{issue_number} not found or not accessible: #{e.message}"
+          exit 1
+        end
+
+        # Check if branch already exists (locally or remotely)
+        Interfaces::Print.info "Checking if branch '#{branch_name}' already exists..."
+        _, _, success = Interfaces::Shell.run_command("git show-ref --verify --quiet refs/heads/#{branch_name}")
+        if success
+          Interfaces::Print.error "Branch '#{branch_name}' already exists locally. Please delete it first."
+          exit 1
+        end
+
+        stdout, = Interfaces::Shell.run_command("git ls-remote --heads origin #{branch_name}")
+        if stdout.include?(branch_name)
+          Interfaces::Print.error "Branch '#{branch_name}' already exists on remote. Please delete it first."
+          exit 1
+        end
+
+        Interfaces::Print.success "Branch '#{branch_name}' does not exist locally or remotely. Proceeding..."
+
+        # Main workflow
+        Interfaces::Print.info "Starting workflow to solve GitHub issue ##{issue_number}"
+
+        # Step 1: Create initial plan and execute
+        Interfaces::Print.info 'Step 1: Creating plan and executing solution...'
+
+        objective_file = Interfaces::ObjectiveRepository.local_file_path(issue_number)
+        instructions_template = <<~INSTRUCTIONS
+          I need you to make a plan to solve the objective "#{issue_number}" in the file: `#{objective_file}`. You are not to make any code changes. Instead, here's what I need you to do:
+
+          1. First, read the objective from the file
+
+          2. Create a detailed plan for solving the issue. Write your thinking and plan in a markdown file at:
+             `#{plan_file}`
+
+           The plan should include:
+           - Analysis of the issue.
+           - Approach to solving it.
+           - Test cases that should be written to verify the solution.
+           - Steps you'll take.
+           - Any potential risks or considerations.
+           - A list of questions for any clarifications you need to ask the user. If you do not need any clarifications, you can say "No questions needed".
+        INSTRUCTIONS
+
+        # Run claude code with instructions
+        Interfaces::Print.info "Running Claude Code to create a plan to solve issue ##{issue_number}..."
+        claude_output = Interfaces::Agent.run(instructions_template)
+        puts "CLAUDE_OUTPUT: #{claude_output}"
+
+        # Check if the plan file was created
+        unless File.exist?(plan_file)
+          Interfaces::Print.error "Plan file '#{plan_file}' was not created. Please check the Claude Code output manually."
+          Interfaces::Print.error "Output: #{claude_output}"
+          exit 1
+        end
+
+        Interfaces::Print.success "Plan file '#{plan_file}' was created. Please review it, answering any questions Claude has asked."
+        Interfaces::Shell.ask_user_to_continue('When you are ready to proceed, answer "y" to continue (y/N) ')
+
+        # Execute the plan
+        ExecutePlan.run(issue_number)
+      end
+    end
+  end
+end

data/lib/wralph/run/remove.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative '../interfaces/print'
+require_relative '../interfaces/shell'
+require_relative 'init'
+
+module Wralph
+  module Run
+    module Remove
+      def self.run(issue_number)
+        Init.ensure_initialized!
+
+        branch_name = "issue-#{issue_number}".freeze
+
+        # Delete local branch
+        _, _, success = Interfaces::Shell.run_command("git branch -D #{branch_name}")
+        if success
+          Interfaces::Print.info "Deleted branch '#{branch_name}' locally"
+        else
+          Interfaces::Print.warning "Branch '#{branch_name}' not found locally"
+        end
+
+        # Delete remote branch
+        _, _, success = Interfaces::Shell.run_command("git push origin --delete #{branch_name}")
+        if success
+          Interfaces::Print.info "Deleted branch '#{branch_name}' on remote"
+        else
+          Interfaces::Print.warning "Branch '#{branch_name}' not found on remote"
+        end
+
+        # Remove worktree
+        _, _, success = Interfaces::Shell.run_command("wt remove #{branch_name}")
+        if success
+          Interfaces::Print.info "Removed worktree for branch '#{branch_name}'"
+        else
+          Interfaces::Print.warning "Worktree for branch '#{branch_name}' not found"
+        end
+
+        Interfaces::Print.success "Cleanup completed for issue ##{issue_number}"
+      end
+    end
+  end
+end

data/lib/wralph/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Wralph
+  VERSION = '0.1.2'
+end

data/lib/wralph.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'wralph/version'
+require_relative 'wralph/config'
+require_relative 'wralph/interfaces/repo'
+require_relative 'wralph/interfaces/print'
+require_relative 'wralph/interfaces/shell'
+require_relative 'wralph/interfaces/agent'
+require_relative 'wralph/interfaces/ci'
+require_relative 'wralph/interfaces/objective_repository'
+require_relative 'wralph/run/init'
+require_relative 'wralph/run/plan'
+require_relative 'wralph/run/execute_plan'
+require_relative 'wralph/run/iterate_ci'
+require_relative 'wralph/run/feedback'
+require_relative 'wralph/run/remove'
+
+module Wralph
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: wralph
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Nick Knipe
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'A CLI that wraps a coding agent and CI to autonomously complete software
+  objectives using the Ralph Wiggum technique. '
+email:
+- nick@hellodrifter.com
+executables:
+- wralph
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/wralph
+- lib/wralph.rb
+- lib/wralph/adapters/agents.rb
+- lib/wralph/adapters/agents/claude_code.rb
+- lib/wralph/adapters/cis.rb
+- lib/wralph/adapters/cis/circle_ci.rb
+- lib/wralph/adapters/objective_repositories.rb
+- lib/wralph/adapters/objective_repositories/github_issues.rb
+- lib/wralph/config.rb
+- lib/wralph/fixtures/config.yaml
+- lib/wralph/fixtures/secrets.yaml
+- lib/wralph/interfaces/agent.rb
+- lib/wralph/interfaces/ci.rb
+- lib/wralph/interfaces/objective_repository.rb
+- lib/wralph/interfaces/print.rb
+- lib/wralph/interfaces/repo.rb
+- lib/wralph/interfaces/shell.rb
+- lib/wralph/run/execute_plan.rb
+- lib/wralph/run/feedback.rb
+- lib/wralph/run/init.rb
+- lib/wralph/run/iterate_ci.rb
+- lib/wralph/run/plan.rb
+- lib/wralph/run/remove.rb
+- lib/wralph/version.rb
+homepage: https://github.com/niborg/wralph
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Human-In-The-Loop AI Factory
+test_files: []