llm_rescuer 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6ccbd1c233b14f52a25b9718471106654feecc940a6a5e437307793b1a64d974
+  data.tar.gz: 1a2e08037d1a3acf18e694473b77246a4d67e53269b7b8bfcc03106032c0bdf3
+SHA512:
+  metadata.gz: 0a579571e96a250591237dead0cfd33a9f87966a62c24f4707138acf7dd087ed19c3e2362cc973246a7bbf6385289b2df7db6ee757c3b3355d460790db29dfba
+  data.tar.gz: 3f7db8460e977a030c18d3d94e6f82de41449702a2dea95d442099c018256ddb4b11ebf069d66b235e9b7d797e51fbfaeb8a2e358b6ffcf5c82ce4d246a967f2

data/.rspec

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

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.4

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-10-23
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# 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, caste, color, 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 email 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
+[INSERT CONTACT METHOD].
+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.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Paul Chobert
+
+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,154 @@
+# LLM Rescuer 🤖💰
+
+> ⚠️ **EXPERIMENTAL PROJECT - NOT FOR PRODUCTION USE**
+>
+> This project is an experimental proof-of-concept developed for educational purposes and pure, unadulterated fun. It uses AI to dynamically handle runtime errors, which introduces unpredictable behavior and potential security risks that would make your security team cry. **Never use this in production environments unless you enjoy explaining to your boss why the AI decided your user's name should be "🐱 Mr. Whiskers".**
+
+## The Mission: Fixing the Billion Dollar Mistake... With a Billion Dollars Worth of LLM Tokens
+
+In 1965, Tony Hoare invented the null reference and later called it his ["billion-dollar mistake"](https://www.infoq.com/presentations/Null-References-The-Billion-Dollar-Mistake-Tony-Hoare/). Well, we're here to fix it by potentially spending a billion dollars in OpenAI API tokens! 💸
+
+Because clearly, the best way to solve a problem caused by the absence of a value is to throw artificial intelligence at it until it hallucinates a reasonable response. What could possibly go wrong?
+
+## What This Abomination Does
+
+LLM Rescuer is a Ruby gem that catches your `NoMethodError`s when you call methods on `nil` and asks GPT to guess what you _probably_ wanted. It's like having a very expensive, overly-confident intern who's read your entire codebase and thinks they know what you meant.
+
+```ruby
+user = nil
+puts user.name  # Instead of crashing, might return "John Doe" or "undefined" or "🎭"
+                # depending on what the AI thinks is funny today
+```
+
+## How This Beautiful Disaster Works
+
+1. **The Trap**: We monkey-patch `NilClass` because why not break fundamental assumptions?
+2. **The Analysis**: When you call a method on `nil`, we pause everything and ask an LLM to read your mind
+3. **The Oracle**: GPT-5 analyzes your code like a digital Sherlock Holmes with ADHD
+4. **The Guess**: It returns what it thinks you wanted, which is right about 73.2% of the time\*
+5. **The Magic**: Your code continues running, probably doing something completely different than intended
+
+\*Statistics may be made up
+
+## Installation (AKA "How to Spend Your OpenAI Credits")
+
+Add this line to your application's Gemfile (and say goodbye to your API budget):
+
+```ruby
+gem 'llm_rescuer'
+```
+
+Then execute:
+
+```bash
+bundle install
+# Also install a second mortgage for your OpenAI bills
+```
+
+## Configuration
+
+1. **Feed the AI overlords**:
+
+   ```bash
+   export OPENAI_API_KEY="prepare-your-wallet"
+   ```
+
+2. **Set your project scope** (so it only ruins _your_ code):
+
+   ```ruby
+   LlmRescuer.prefix = "/path/to/your/beautiful/disaster"
+   ```
+
+3. **Embrace the chaos**:
+   ```ruby
+   require 'llm_rescuer'
+   LlmRescuer.setup
+   # You have chosen... poorly
+   ```
+
+## Real-World Usage Examples
+
+```ruby
+# Classic nil safety
+user = find_user(id: "nonexistent") # returns nil
+puts user.email
+# AI: "Analyzing context... user seems to need an email...
+#      returning 'no-reply@example.com'"
+
+# Shopping cart magic
+cart = session[:cart] # nil because session expired
+total = cart.total_price
+# AI: "This looks like e-commerce. Based on similar patterns,
+#      I'll return 0.0 to avoid charging $nil"
+
+# The existential crisis
+meaning_of_life = nil
+answer = meaning_of_life.to_i
+# AI: "Clearly this should be 42. I've read Douglas Adams."
+```
+
+## What Could Go Wrong? 🤔
+
+- Your nil users might suddenly become named "ChatGPT's Best Friend"
+- Your shopping cart totals might be replaced with haikus about commerce
+- Your boolean flags might return philosophical treatises on truth
+- Your API might start responding with interpretive dance descriptions
+- You might accidentally achieve sentience in your nil objects
+
+## Cost Analysis 💰
+
+- **Traditional nil handling**: Free, but your app crashes
+- **LLM Rescuer**: $0.002 per nil rescue (estimated)
+- **Your sanity**: Priceless (and rapidly depleting)
+
+For a typical Rails app with healthy nil hygiene, expect to spend approximately:
+
+- **Development**: $50-100/month (because you test things, right?)
+- **Production**: $500-5000/month (depending on how nil-happy your code is)
+- **Black Friday**: Your firstborn child
+
+## Dependencies (The Usual Suspects)
+
+- `ruby_llm` (~> 1.8.2) - For talking to our AI overlords
+- `ruby_llm-schema` (~> 0.2.1) - For making sure AI responses are structured chaos
+- `binding_of_caller` (~> 1.0.1) - For context that the AI will probably ignore anyway
+- A sense of humor (>= 1.0.0, required)
+- A healthy bank account (recommended)
+
+## Development
+
+After checking out the repo and questioning your life choices:
+
+```bash
+bin/setup    # Install dependencies
+rake spec    # Run tests (spoiler: they're as unpredictable as AI)
+bin/console  # Interactive prompt for immediate regret
+```
+
+## Contributing
+
+Found a bug? That might be a feature! Found a feature? That might be a bug!
+
+Submit PRs, issues, or interpretive dance videos explaining your problems. We accept contributions in all forms except sensible ones.
+
+## Success Stories
+
+> "LLM Rescuer saved my app from crashing! Sure, all my users are now named 'Anonymous Penguin' and my prices are in Bitcoin, but it didn't crash!" - Definitely Real User
+
+> "I deployed this to production and my nil errors went down 100%! My AWS bill went up 400%, but correlation isn't causation, right?" - Another Real Person
+
+## The Philosophy
+
+Why fix your code when you can train an AI to guess what your code should have done? It's like pair programming, except your pair is a probabilistic text generator that's read the entire internet and has strong opinions about variable naming.
+
+## License
+
+This project is licensed under the MIT License, which gives you the right to use, modify, and distribute this code. It does not give you the right to sue us when your production app starts writing poetry instead of processing payments.
+
+## Final Words
+
+Remember: null references were a billion-dollar mistake, but with today's AI API pricing, we can make it a trillion-dollar mistake! 🚀
+
+---
+
+_"In a world without nil safety, one gem dares to ask: 'What if we just guessed?'"_ 🎬

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[spec standard]

data/lib/llm_rescuer/nil_extension.rb

@@ -0,0 +1,65 @@
+module LlmRescuer
+  def self.prefix=(prefix)
+    @prefix = prefix
+  end
+
+  def self.prefix = @prefix
+
+  module NilExtension
+    class ResponseSchema < RubyLLM::Schema
+      string :ruby_expression, description: "ruby expression to evaluate to recover from the exception"
+      string :comment, description: "comment about the response"
+      string :error_message, description: "error message from the exception"
+    end
+
+    def method_missing(method_name, *args, &block)
+      chat =
+        RubyLLM
+          .chat
+          .with_tool(Tools::ReadSourceCodeTool)
+          .on_tool_call do |tool_call|
+          # Called when the AI decides to use a tool
+          puts "Calling tool: #{tool_call.name}"
+          puts "Arguments: #{tool_call.arguments}"
+        end
+          .on_tool_result do |result|
+          # Called after the tool returns its result
+          puts "Tool returned: #{result}"
+        end
+
+      chat.with_instructions <<~SYSTEM_PROMPT
+        A ruby program is about to crash or test about to fail because the method `#{method_name}` has been called on `nil`.
+        We are trying to determine what the return value of `NilClass.method_missing` should be so the program can resume.
+        You can use the `read_source_code` tool to read the source code of a file.
+        Generate a response with a ruby expression to evaluate.
+
+        Some examples of expression could be:
+        - super if we want to raise the error
+        - `nil` if we want to behave like &.
+        - a boolean
+        - a number
+        - a new instance of a class
+
+        The goal is to help the program to resume successfully with the best possible expression.
+        You need to look at the business logic of the caller to determine the best expression.
+      SYSTEM_PROMPT
+
+      filtered_caller = caller.filter { |line| line.start_with?(LlmRescuer.prefix) }.join("\n")
+
+      prompt = <<~PROMPT
+        Here is the failing method call:
+        method name: #{method_name}
+        arguments: #{args.inspect}
+        backtrace:
+        #{filtered_caller}
+      PROMPT
+      response = chat.with_schema(ResponseSchema).ask(prompt)
+      eval(response.content["ruby_expression"]) # standard:disable Security/Eval
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      first_caller = caller(1..1).first
+      first_caller&.start_with?(LlmRescuer.prefix) || false
+    end
+  end
+end

data/lib/llm_rescuer/tools/read_source_code_tool.rb

@@ -0,0 +1,35 @@
+module LlmRescuer
+  module Tools
+    class ReadSourceCodeTool < RubyLLM::Tool
+      description "Reads the source code of a given file"
+
+      param :file_path, desc: "The full path to the file to read, without the line number"
+      param :around_line_number, desc: "The line number around which to read the source code"
+      param :context_lines, desc: "The number of lines of context to include around the specified line number"
+
+      def execute(file_path:, around_line_number:, context_lines:)
+        around_line_number = around_line_number.to_i
+        context_lines = context_lines.to_i
+        return {error: "Unauthorized file path"} unless file_path.start_with?(LlmRescuer.prefix)
+
+        return {error: "File not found"} unless File.file?(file_path)
+
+        lines = File.readlines(file_path)
+
+        start = [around_line_number - context_lines - 1, 0].max
+        end_ = [around_line_number + context_lines - 1, lines.size - 1].min
+
+        snippet = lines[start..end_].each_with_index.map do |src, i|
+          num = start + i + 1
+          prefix = (num == around_line_number) ? "=> " : "   "
+          format("#{prefix}%4d | %s", num, src)
+        end
+
+        puts "#{file_path}:#{around_line_number}\n\n"
+        puts snippet.join
+      rescue => e
+        {error: e.message}
+      end
+    end
+  end
+end

data/lib/llm_rescuer/version.rb

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

data/lib/llm_rescuer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "ruby_llm"
+require "ruby_llm/schema"
+
+require_relative "llm_rescuer/version"
+require_relative "llm_rescuer/nil_extension"
+require_relative "llm_rescuer/tools/read_source_code_tool"
+
+RubyLLM.configure do |config|
+  config.openai_api_key = ENV.fetch("OPENAI_API_KEY")
+  config.default_model = "gpt-5"
+end
+
+module LlmRescuer
+  def self.setup
+    NilClass.prepend(LlmRescuer::NilExtension)
+  end
+end

data/sig/llm_rescuer.rbs

@@ -0,0 +1,4 @@
+module LlmRescuer
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: llm_rescuer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Paul Chobert
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: binding_of_caller
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.2
+- !ruby/object:Gem::Dependency
+  name: ruby_llm-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+description: "LLM Rescuer uses artificial intelligence to guess what you probably
+  meant when you called a method on nil. Instead of crashing with NoMethodError, it
+  asks GPT to analyze your code and hallucinate a reasonable response. Because clearly,
+  the best way to solve Tony Hoare's billion-dollar mistake is to throw AI at it until
+  it works. What could possibly go wrong? \U0001F3AD"
+email:
+- paul@chobert.fr
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".standard.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/llm_rescuer.rb
+- lib/llm_rescuer/nil_extension.rb
+- lib/llm_rescuer/tools/read_source_code_tool.rb
+- lib/llm_rescuer/version.rb
+- sig/llm_rescuer.rbs
+homepage: https://github.com/barodeur/llm_rescuer
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/barodeur/llm_rescuer
+  source_code_uri: https://github.com/paul/llm_rescuer
+  changelog_uri: https://github.com/paul/llm_rescuer/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: "Fix the billion-dollar mistake by spending billions on LLM tokens! \U0001F916\U0001F4B0"
+test_files: []