senior 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 39730d334959dd50f95ebdf665ac8731d61fc15fda52692e61c6a521d1228b4b
+  data.tar.gz: e2d2bb32557f3d3c7c780ec7f4293f0c56f68d885e0ed792ce2e0fce69e00b2a
+SHA512:
+  metadata.gz: 30cabd4898ce92778b12e1bac480d6e6de51bf57af8a0f1356ab24f29626cbe1c778c89b89f073880bcb099e871ab45b65cbb0f162555b1a85db9014239f1342
+  data.tar.gz: 5654b395cf96a528179988edc566ca0f4eebaa2a8f521859ba64b56f9ba1ffe60ef8a457c71f7d5da3a9ed2920b96568245fe676b2a9711b2cd9ca105cb47c1f

data/.editorconfig

@@ -0,0 +1,11 @@
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+max_line_length = 120
+trim_trailing_whitespace = true
+
+# 2 space indentation
+[*.rb]
+indent_style = space
+indent_size = 2

data/.env.example

@@ -0,0 +1,5 @@
+# Get this from https://platform.openai.com/account/api-keys
+OPEN_AI_ACCESS_TOKEN=
+
+# If you have an organization, get this form https://platform.openai.com/account/org-settings
+OPEN_AI_ORGANIZATION_ID=

data/.overcommit.yml

@@ -0,0 +1,33 @@
+# Use this file to configure the Overcommit hooks you wish to use. This will
+# extend the default configuration defined in:
+# https://github.com/sds/overcommit/blob/master/config/default.yml
+#
+# At the topmost level of this YAML file is a key representing type of hook
+# being run (e.g. pre-commit, commit-msg, etc.). Within each type you can
+# customize each hook, such as whether to only run it on certain files (via
+# `include`), whether to only display output if it fails (via `quiet`), etc.
+#
+# For a complete list of hooks, see:
+# https://github.com/sds/overcommit/tree/master/lib/overcommit/hook
+#
+# For a complete list of options that you can use to customize hooks, see:
+# https://github.com/sds/overcommit#configuration
+#
+# Uncomment the following lines to make the configuration take effect.
+
+PreCommit:
+  RuboCop:
+    enabled: true
+    on_warn: fail # Treat all warnings as failures
+
+  TrailingWhitespace:
+    enabled: true
+#    exclude:
+#      - '**/db/structure.sql' # Ignore trailing whitespace in generated files
+#
+#PostCheckout:
+#  ALL: # Special hook name that customizes all hooks of this type
+#    quiet: true # Change all post-checkout hooks to only display output on failure
+#
+#  IndexTags:
+#    enabled: true # Generate a tags file with `ctags` each time HEAD changes

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,46 @@
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.2
+  DisplayCopNames: true
+  NewCops: enable
+  Exclude:
+    - spec/support/broken_code.rb
+
+# --------------------- Security ----------------------
+Security/Eval:
+  Exclude:
+    - lib/senior/agent.rb
+
+# ----------------------- Style -----------------------
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+# ----------------------- Layout ----------------------
+
+Layout/LineLength:
+  Max: 120
+
+# ---------------------- Metrics ----------------------
+
+Metrics/BlockLength:
+  Exclude:
+    - '**/*_spec.rb'
+    - senior.gemspec
+
+Metrics/MethodLength:
+  Exclude:
+    - lib/senior/brains/open_ai.rb
+
+# ----------------------- RSpec -----------------------
+
+RSpec/ExampleLength:
+  Enabled: false

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.2.2

data/.yardstick.yml

@@ -0,0 +1,22 @@
+threshold: 100
+rules:
+  ApiTag::Presence:
+    enabled: true
+  ApiTag::Inclusion:
+    enabled: true
+  ApiTag::ProtectedMethod:
+    enabled: true
+  ApiTag::PrivateMethod:
+    enabled: true
+  ExampleTag:
+    enabled: true
+  ReturnTag:
+    enabled: true
+  Summary::Presence:
+    enabled: true
+  Summary::Length:
+    enabled: false
+  Summary::Delimiter:
+    enabled: true
+  Summary::SingleLine:
+    enabled: false

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+## [Unreleased]
+
+- Ability to wrap a method invocation. For example, `Senior.suggest_fix { my_broken_method(2) }`
+- Test generation `Senior.write_tests_for {}`
+- Configure API keys for the OpenAI
+- Use different OpenAI models
+- Parametrize the calls to OpenAI
+- See price per call
+- Set API calling and pricing limits
+- Use different AI APIs, not just OpenAI
+- Global convenience methods such as `auto_debug { }`
+- Guard plugin
+- RBS Signatures
+- Domain exceptions
+
+## [0.1.0] - 2023-04-10
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,84 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at wilson.dsigns@gmail.com. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
+available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in senior.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+guard :bundler do
+  watch('senior.gemspec')
+end
+
+guard :bundler_audit, run_on_start: true do
+  watch('Gemfile.lock')
+end
+
+group :tests do
+  guard :rspec, all_on_start: true, cmd: 'COVERAGE=false bundle exec rspec --format progress' do
+    watch(%r{^spec/.+_spec\.rb$})
+    watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+    watch('spec/spec_helper.rb') { 'spec' }
+  end
+end
+
+guard :rubocop do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 Wilson Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,104 @@
+# Senior
+
+[![Gem Version](https://badge.fury.io/rb/senior.svg)](https://badge.fury.io/rb/senior)
+[![Tests](https://github.com/wilsonsilva/senior/actions/workflows/main.yml/badge.svg)](https://github.com/wilsonsilva/senior/actions/workflows/main.yml)
+
+Provides AI-powered debugging and automatic suggestion of code fixes. It makes use of OpenAI's language model to analyze
+and modify the source code of broken methods, allowing them to be fixed automatically.
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add senior
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install senior
+
+## Usage
+
+Before using Senior, ensure that the environment variables `OPEN_AI_ACCESS_TOKEN` and `OPEN_AI_ORGANIZATION_ID` are
+defined. These variables are used by the gem to authenticate and access OpenAI's language model.
+
+### Auto-debugging a broken method
+To debug a broken method, call Senior.auto_debug and pass in the broken method, its arguments, and optionally its
+source code. The method will be called repeatedly, with modifications made to its source code each time, until it no
+longer raises exceptions.
+
+```ruby
+def square(n) = n * y
+
+result = Senior.auto_debug(method(:square), 2)
+puts result # => 4
+```
+
+### Suggesting a fix for a broken method
+To suggest a fix for a broken method, call Senior.suggest_fix and pass in the broken method and its arguments.
+The method will be analyzed and a fix will be suggested in the form of modified source code.
+
+```ruby
+def square(n) = n * y
+
+suggestion = Senior.suggest_fix(method(:square), 2)
+puts suggestion # => "def square(n) = n * n"
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`,
+which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file
+to [rubygems.org](https://rubygems.org).
+
+The health and maintainability of the codebase is ensured through a set of
+Rake tasks to test, lint and audit the gem for security vulnerabilities and documentation:
+
+```
+rake build                    # Build senior.gem into the pkg directory
+rake build:checksum           # Generate SHA512 checksum if senior.gem into the checksums directory
+rake bundle:audit:check       # Checks the Gemfile.lock for insecure dependencies
+rake bundle:audit:update      # Updates the bundler-audit vulnerability database
+rake clean                    # Remove any temporary products
+rake clobber                  # Remove any generated files
+rake coverage                 # Run spec with coverage
+rake install                  # Build and install senior.gem into system gems
+rake install:local            # Build and install senior.gem into system gems without network access
+rake qa                       # Test, lint and perform security and documentation audits
+rake release[remote]          # Create a tag, build and push senior.gem to rubygems.org
+rake rubocop                  # Run RuboCop
+rake rubocop:autocorrect      # Autocorrect RuboCop offenses (only when it's safe)
+rake rubocop:autocorrect_all  # Autocorrect RuboCop offenses (safe and unsafe)
+rake spec                     # Run RSpec code examples
+rake verify_measurements      # Verify that yardstick coverage is at least 100%
+rake yard                     # Generate YARD Documentation
+rake yard:junk                # Check the junk in your YARD Documentation
+rake yardstick_measure        # Measure docs in lib/**/*.rb with yardstick
+```
+
+### Type checking
+
+This gem leverages [RBS](https://github.com/ruby/rbs), a language to describe the structure of Ruby programs. It is
+used to provide type checking and autocompletion in your editor. Run `bundle exec typeprof FILENAME` to generate
+an RBS definition for the given Ruby file. And validate all definitions using [Steep](https://github.com/soutaro/steep)
+with the command `bundle exec steep check`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/wilsonsilva/senior. This project is intended
+to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the
+[code of conduct](https://github.com/wilsonsilva/senior/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Senior project's codebases, issue trackers, chat rooms and mailing lists is expected to
+follow the [code of conduct](https://github.com/wilsonsilva/senior/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'bundler/audit/task'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'yaml'
+require 'yard/rake/yardoc_task'
+require 'yard-junk/rake'
+require 'yardstick/rake/measurement'
+require 'yardstick/rake/verify'
+
+yardstick_options = YAML.load_file('.yardstick.yml')
+
+Bundler::Audit::Task.new
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+YARD::Rake::YardocTask.new
+YardJunk::Rake.define_task
+Yardstick::Rake::Measurement.new(:yardstick_measure, yardstick_options)
+Yardstick::Rake::Verify.new
+
+task default: %i[spec rubocop]
+
+# Remove the report on rake clobber
+CLEAN.include('measurements', 'doc', '.yardoc', 'tmp')
+
+# Delete these files and folders when running rake clobber.
+CLOBBER.include('coverage', '.rspec_status')
+
+desc 'Run spec with coverage'
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].execute
+  `open coverage/index.html`
+end
+
+desc 'Test, lint and perform security and documentation audits'
+task qa: %w[spec rubocop yard:junk verify_measurements bundle:audit]

data/Steepfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+target :lib do
+  signature 'sig'
+
+  check 'lib'
+end

data/lib/senior/agent.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Senior
+  # Suggests code fixes
+  #
+  # @api private
+  #
+  class Agent
+    # Instantiates a new Agent
+    #
+    # @api private
+    #
+    def initialize(brain = Brains::OpenAI.new)
+      @brain = brain
+    end
+
+    # Calls the given method continuously, using AI to attempt to fix it until it is no longer raises exceptions
+    #
+    # @api private
+    #
+    # @param broken_method [Method] A broken method to be fixed
+    # @param args [Object] Arguments given to a broken method
+    # @param broken_method_source [String|nil] Source code of the broken method
+    #
+    # @return [Object] The return value of the previously broken but now fixed method
+    #
+    def auto_debug(broken_method, args, broken_method_source = nil)
+      broken_method.call(*args)
+    rescue StandardError => e
+      puts "The invocation #{broken_method.name}(#{args}) failed. Debugging..."
+
+      suggested_fix_method_source = brain.suggest_fix(
+        erroneous_source: broken_method_source || broken_method.source,
+        exception_backtrace: e.backtrace&.first.to_s
+      )
+
+      puts "\nSuggested fix:\n#{suggested_fix_method_source}\n\n"
+
+      suggested_fix_method_name = eval(suggested_fix_method_source)
+
+      auto_debug(method(suggested_fix_method_name), args, suggested_fix_method_source)
+    end
+
+    # Suggests a fix for a broken method
+    #
+    # @api private
+    #
+    # @param broken_method [Method] A broken method to be fixed
+    # @param args [Object] Arguments given to a broken method
+    #
+    # @return [String] The suggested fix
+    #
+    def suggest_fix(broken_method, args)
+      broken_method.call(*args)
+    rescue StandardError => e
+      brain.suggest_fix(
+        erroneous_source: broken_method.source,
+        exception_backtrace: e.backtrace&.first.to_s
+      )
+    end
+
+    private
+
+    # The interface to an AI's API
+    #
+    # @api private
+    #
+    # @return [Object]
+    #
+    attr_reader :brain
+  end
+end

data/lib/senior/brains/open_ai.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'openai'
+
+module Senior
+  # Interface with the different AI API's
+  module Brains
+    # Interface to OpenAI's API
+    #
+    # @api private
+    #
+    class OpenAI
+      # Suggests a fix for a broken method
+      #
+      # @api private
+      #
+      # @param erroneous_source [String] Source code of a broken method
+      # @param exception_backtrace [String] First line of a broken method's backtrace
+      #
+      # @return [String] The suggested fix
+      #
+      def suggest_fix(erroneous_source:, exception_backtrace:)
+        prompt = <<~PROMPT
+          This is a method's source and the error. Fix the method:
+
+          ## Source:
+          #{erroneous_source}
+
+          ## Error:
+          #{exception_backtrace}
+
+          ## Updated source:
+        PROMPT
+
+        request_completion(prompt)
+      end
+
+      private
+
+      # Creates an instance of OpenAI::Client
+      #
+      # @api private
+      #
+      # @return [OpenAI::Client] A client to communicate with OpenAI's API
+      #
+      def open_ai_client
+        @open_ai_client ||= ::OpenAI::Client.new(
+          access_token: ENV.fetch('OPEN_AI_ACCESS_TOKEN'),
+          organization_id: ENV.fetch('OPEN_AI_ORGANIZATION_ID')
+        )
+      end
+
+      # Creates a completion in OpenAI's API
+      #
+      # @api private
+      #
+      # @param prompt [String] The prompt for which to generate a completion
+      # @param max_tokens [Integer] The maximum number of tokens to generate in the completion. Default value is 1024
+      #
+      # @return [String] The create completion
+      #
+      def request_completion(prompt, max_tokens = 1024)
+        response = open_ai_client.completions(
+          parameters: {
+            model: 'text-davinci-003',
+            prompt:,
+            max_tokens:,
+            n: 1,
+            stop: nil,
+            temperature: 0.7
+          }
+        )
+
+        raise 'No completion found' unless response['choices'].any?
+
+        response.dig('choices', 0, 'text').strip
+      end
+    end
+  end
+end

data/lib/senior/version.rb

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

data/lib/senior.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative 'senior/brains/open_ai'
+require_relative 'senior/agent'
+require_relative 'senior/version'
+
+require 'method_source'
+
+# Encapsulates all the gem's logic
+module Senior
+  # Calls the given method continuously, using AI to attempt to fix it until it is no longer raises exceptions
+  #
+  # @api public
+  #
+  # @example Debugging a broken method
+  #  def square(n) = n * y
+  #
+  #  result = Senior.auto_debug(method(:square), 2)
+  #  result # => 4
+  #
+  # @param broken_method [Method] A broken method to be fixed
+  # @param args [Object] Arguments given to a broken method
+  # @param broken_method_source [String|nil] Source code of the broken method
+  #
+  # @return [Object] The return value of the previously broken but now fixed method
+  #
+  def self.auto_debug(broken_method, args, broken_method_source = nil)
+    agent.auto_debug(broken_method, args, broken_method_source)
+  end
+
+  # Suggests a fix for a broken method
+  #
+  # @api public
+  #
+  # @example Suggesting a fix for a broken method
+  #  def square(n) = n * y
+  #
+  #  suggestion = Senior.suggest_fix(method(:square), 2)
+  #  suggestion # => "def square(n) = n * n"
+  #
+  # @param broken_method [Method] A broken method to be fixed
+  # @param args [Object] Arguments given to a broken method
+  #
+  # @return [String] The suggested fix
+  #
+  def self.suggest_fix(broken_method, args)
+    agent.suggest_fix(broken_method, args)
+  end
+
+  # Returns an instance of the agent
+  #
+  # @api private
+  #
+  # @return [Agent] An instance of the agent
+  #
+  def self.agent
+    @agent ||= Agent.new
+  end
+end

data/sig/gems/method_source/method.rbs

@@ -0,0 +1,4 @@
+# Monkey patched by the gem method_source
+class Method
+  def source: () -> String
+end

data/sig/gems/ruby-openai/client.rbs

@@ -0,0 +1,29 @@
+module OpenAI
+  class Client
+    @files: untyped
+    @finetunes: untyped
+    @images: untyped
+    @models: untyped
+
+    def initialize: (?access_token: String|nil, ?organization_id: String|nil, ?uri_base: nil, ?request_timeout: nil) -> void
+    def chat: (?parameters: Hash[untyped, untyped]) -> untyped
+    def completions: (?parameters: Hash[untyped, untyped]) -> untyped
+    def edits: (?parameters: Hash[untyped, untyped]) -> untyped
+    def embeddings: (?parameters: Hash[untyped, untyped]) -> untyped
+    def files: -> untyped
+    def finetunes: -> untyped
+    def images: -> untyped
+    def models: -> untyped
+    def moderations: (?parameters: Hash[untyped, untyped]) -> untyped
+    def transcribe: (?parameters: Hash[untyped, untyped]) -> untyped
+    def translate: (?parameters: Hash[untyped, untyped]) -> untyped
+
+    def self.get: (path: untyped) -> untyped
+    def self.json_post: (path: String, parameters: Hash[untyped, untyped]) -> untyped
+    def self.multipart_post: (path: String, ?parameters: Hash[untyped, untyped]?) -> untyped
+    def self.delete: (path: untyped) -> untyped
+    def self.uri: (path: String) -> untyped
+    def self.headers: -> Hash[String, String]
+    def self.request_timeout: -> untyped
+  end
+end

data/sig/senior/agent.rbs

@@ -0,0 +1,11 @@
+module Senior
+  class Agent
+    def initialize: (?_IBrain brain) -> void
+    def auto_debug: (Method broken_method, untyped args, String? | nil broken_method_source) -> untyped
+    def suggest_fix: (Method broken_method, untyped args) -> String
+
+    private
+
+    attr_reader brain: _IBrain
+  end
+end

data/sig/senior/brains/i_brain.rbs

@@ -0,0 +1,3 @@
+interface _IBrain
+  def suggest_fix: (erroneous_source: String, exception_backtrace: String) -> String
+end

data/sig/senior/brains/open_ai.rbs

@@ -0,0 +1,14 @@
+module Senior
+  module Brains
+    class OpenAI
+      @open_ai_client: untyped
+
+      def suggest_fix: (erroneous_source: String, exception_backtrace: String) -> String
+
+      private
+
+      def open_ai_client: -> untyped
+      def request_completion: (String prompt, ?Integer max_tokens) -> String
+    end
+  end
+end

data/sig/senior.rbs

@@ -0,0 +1,12 @@
+module Senior
+  VERSION: String
+  self.@agent: Agent
+
+  def self.auto_debug: (Method broken_method, untyped args, String? | nil broken_method_source) -> untyped
+
+  def self.suggest_fix: (Method broken_method, untyped args) -> String
+
+  private
+
+  def self.agent: -> Agent
+end

metadata

@@ -0,0 +1,425 @@
+--- !ruby/object:Gem::Specification
+name: senior
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Wilson Silva
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-04-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: method_source
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: overcommit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.49'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.49'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '2.19'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.17'
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: steep
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: typeprof
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard-junk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+- !ruby/object:Gem::Dependency
+  name: yardstick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: |-
+  This gem provides a simple interface to OpenAI's GPT4 API for code repair. Given a piece of broken
+      code, the gem generates a corrected version.
+email:
+- wilson.dsigns@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".env.example"
+- ".overcommit.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".tool-versions"
+- ".yardstick.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- Steepfile
+- lib/senior.rb
+- lib/senior/agent.rb
+- lib/senior/brains/open_ai.rb
+- lib/senior/version.rb
+- sig/gems/method_source/method.rbs
+- sig/gems/ruby-openai/client.rbs
+- sig/senior.rbs
+- sig/senior/agent.rbs
+- sig/senior/brains/i_brain.rbs
+- sig/senior/brains/open_ai.rbs
+homepage: https://github.com/wilsonsilva/senior
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/wilsonsilva/senior
+  source_code_uri: https://github.com/wilsonsilva/senior
+  changelog_uri: https://github.com/wilsonsilva/senior/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: AI coding companion
+test_files: []