girb 0.1.0

data/lib/girb/tools/session_history_tool.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require_relative "../session_history"
+
+module Girb
+  module Tools
+    class SessionHistoryTool < Base
+      class << self
+        def name
+          "get_session_history"
+        end
+
+        def description
+          "Get IRB session history. Can retrieve specific lines, line ranges, method definitions, AI conversation details, or full history."
+        end
+
+        def parameters
+          {
+            type: "object",
+            properties: {
+              action: {
+                type: "string",
+                enum: %w[get_line get_range get_method list_methods full_history list_ai_conversations get_ai_detail],
+                description: "Action to perform: get_line (single line), get_range (line range), get_method (method source), list_methods (list defined methods), full_history (all history), list_ai_conversations (list AI Q&A), get_ai_detail (get AI response with reasoning)"
+              },
+              line: {
+                type: "integer",
+                description: "Line number for get_line action"
+              },
+              start_line: {
+                type: "integer",
+                description: "Start line for get_range action"
+              },
+              end_line: {
+                type: "integer",
+                description: "End line for get_range action"
+              },
+              method_name: {
+                type: "string",
+                description: "Method name for get_method action"
+              }
+            },
+            required: ["action"]
+          }
+        end
+      end
+
+      def execute(_binding, action:, line: nil, start_line: nil, end_line: nil, method_name: nil)
+        case action
+        when "get_line"
+          get_single_line(line)
+        when "get_range"
+          get_line_range(start_line, end_line)
+        when "get_method"
+          get_method_source(method_name)
+        when "list_methods"
+          list_defined_methods
+        when "full_history"
+          get_full_history
+        when "list_ai_conversations"
+          list_ai_conversations
+        when "get_ai_detail"
+          get_ai_detail(line)
+        else
+          { error: "Unknown action: #{action}" }
+        end
+      rescue StandardError => e
+        { error: "#{e.class}: #{e.message}" }
+      end
+
+      private
+
+      def get_single_line(line)
+        return { error: "line parameter is required" } unless line
+
+        entry = SessionHistory.find_by_line(line)
+        if entry
+          {
+            line: entry.line_no,
+            code: entry.code,
+            method_definition: entry.method_definition&.name
+          }
+        else
+          { error: "Line #{line} not found in session history" }
+        end
+      end
+
+      def get_line_range(start_line, end_line)
+        return { error: "start_line and end_line parameters are required" } unless start_line && end_line
+
+        entries = SessionHistory.find_by_line_range(start_line, end_line)
+        if entries.any?
+          {
+            range: "#{start_line}-#{end_line}",
+            entries: entries.map { |e| { line: e.line_no, code: e.code } }
+          }
+        else
+          { error: "No entries found in range #{start_line}-#{end_line}" }
+        end
+      end
+
+      def get_method_source(method_name)
+        return { error: "method_name parameter is required" } unless method_name
+
+        method_def = SessionHistory.find_method(method_name)
+        if method_def
+          {
+            method_name: method_def.name,
+            start_line: method_def.start_line,
+            end_line: method_def.end_line,
+            source: method_def.code
+          }
+        else
+          { error: "Method '#{method_name}' not found in session history" }
+        end
+      end
+
+      def list_defined_methods
+        methods = SessionHistory.method_definitions
+        if methods.any?
+          {
+            count: methods.size,
+            methods: methods.map do |m|
+              {
+                name: m.name,
+                lines: "#{m.start_line}-#{m.end_line}"
+              }
+            end
+          }
+        else
+          { message: "No methods defined in this session" }
+        end
+      end
+
+      def get_full_history
+        history = SessionHistory.all_with_line_numbers
+        if history.any?
+          {
+            count: history.size,
+            history: history
+          }
+        else
+          { message: "No history in this session" }
+        end
+      end
+
+      def list_ai_conversations
+        conversations = SessionHistory.ai_conversations
+        if conversations.any?
+          {
+            count: conversations.size,
+            conversations: conversations.map do |c|
+              {
+                line: c[:line_no],
+                question: c[:question],
+                response_preview: c[:response][0, 200] + (c[:response].length > 200 ? "..." : "")
+              }
+            end
+          }
+        else
+          { message: "No AI conversations in this session" }
+        end
+      end
+
+      def get_ai_detail(line)
+        return { error: "line parameter is required" } unless line
+
+        detail = SessionHistory.get_ai_detail(line)
+        if detail
+          {
+            line: detail[:line_no],
+            question: detail[:question],
+            response: detail[:response],
+            reasoning: detail[:reasoning]
+          }
+        else
+          { error: "No AI conversation found at line #{line}" }
+        end
+      end
+    end
+  end
+end

data/lib/girb/tools.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "tools/base"
+require_relative "tools/inspect_object"
+require_relative "tools/get_source"
+require_relative "tools/list_methods"
+require_relative "tools/evaluate_code"
+require_relative "tools/read_file"
+require_relative "tools/find_file"
+require_relative "tools/session_history_tool"
+
+module Girb
+  module Tools
+    CORE_TOOLS = [InspectObject, GetSource, ListMethods, EvaluateCode, ReadFile, FindFile, SessionHistoryTool].freeze
+
+    class << self
+      def available_tools
+        tools = CORE_TOOLS.dup
+
+        # Rails tools are loaded conditionally
+        if defined?(ActiveRecord::Base)
+          require_relative "tools/rails_tools"
+          tools << RailsModelInfo
+        end
+
+        tools.select { |t| !t.respond_to?(:available?) || t.available? }
+      end
+
+      def find_tool(name)
+        available_tools.find { |t| t.tool_name == name }
+      end
+
+      def to_gemini_tools
+        available_tools.map(&:to_gemini_tool)
+      end
+    end
+  end
+end

data/lib/girb/version.rb

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

data/lib/girb.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "girb/version"
+require_relative "girb/configuration"
+require_relative "girb/providers/base"
+require_relative "girb/exception_capture"
+require_relative "girb/context_builder"
+require_relative "girb/prompt_builder"
+require_relative "girb/conversation_history"
+require_relative "girb/tools"
+require_relative "girb/ai_client"
+
+module Girb
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class ApiError < Error; end
+
+  class << self
+    attr_accessor :configuration
+
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    def setup!
+      configure unless configuration
+      require_relative "girb/irb_integration"
+      IrbIntegration.setup
+    end
+  end
+end
+
+# IRB がロードされていたら自動で組み込む
+if defined?(IRB)
+  Girb.setup!
+end
+
+# binding.girb サポート
+class Binding
+  def girb
+    require "irb"
+    Girb.setup! unless defined?(IRB::Command::Qq)
+
+    # IRB.start with this binding
+    IRB.setup(source_location[0], argv: [])
+    workspace = IRB::WorkSpace.new(self)
+    irb = IRB::Irb.new(workspace)
+    IRB.conf[:MAIN_CONTEXT] = irb.context
+    irb.run(IRB.conf)
+  end
+end

data/lib/irb/command/qq.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "irb/command"
+
+module IRB
+  module Command
+    class Qq < Base
+      category "AI Assistant"
+      description "Ask AI a question about your code"
+
+      def execute(question)
+        question = question.to_s.strip
+        if question.empty?
+          puts "[girb] Usage: qq \"your question here\""
+          return
+        end
+
+        unless Girb.configuration&.gemini_api_key
+          puts "[girb] Error: GEMINI_API_KEY not set"
+          puts "[girb] Run: export GEMINI_API_KEY=your-key"
+          puts "[girb] Or configure in your .irbrc:"
+          puts "[girb]   Girb.configure { |c| c.gemini_api_key = 'your-key' }"
+          return
+        end
+
+        current_binding = irb_context.workspace.binding
+
+        # AI質問を履歴に記録
+        line_no = irb_context.line_no rescue 0
+        Girb::SessionHistory.record(line_no, question, is_ai_question: true)
+
+        context = Girb::ContextBuilder.new(
+          current_binding,
+          irb_context
+        ).build
+
+        if Girb.configuration.debug
+          puts "[girb] Context collected:"
+          require "yaml"
+          puts context.to_yaml
+        end
+
+        client = Girb::AiClient.new
+        client.ask(question, context, binding: current_binding, line_no: line_no)
+      rescue Girb::Error => e
+        puts "[girb] Error: #{e.message}"
+      rescue StandardError => e
+        puts "[girb] Error: #{e.message}"
+        puts e.backtrace.first(5).join("\n") if Girb.configuration&.debug
+      end
+    end
+  end
+end
+
+IRB::Command.register(:qq, IRB::Command::Qq)

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: girb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- rira100000000
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+- !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: rspec
+  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: webmock
+  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'
+description: Ask questions in IRB and get AI-powered answers based on your runtime
+  context. Access local variables, exception info, and Rails model data while debugging.
+  Requires an LLM provider gem (e.g., girb-ruby_llm) or custom provider implementation.
+email:
+- 101010hayakawa@gmail.com
+executables:
+- girb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- README_ja.md
+- Rakefile
+- exe/girb
+- lib/girb.rb
+- lib/girb/ai_client.rb
+- lib/girb/configuration.rb
+- lib/girb/context_builder.rb
+- lib/girb/conversation_history.rb
+- lib/girb/exception_capture.rb
+- lib/girb/irb_integration.rb
+- lib/girb/prompt_builder.rb
+- lib/girb/providers/base.rb
+- lib/girb/session_history.rb
+- lib/girb/tools.rb
+- lib/girb/tools/base.rb
+- lib/girb/tools/evaluate_code.rb
+- lib/girb/tools/find_file.rb
+- lib/girb/tools/get_source.rb
+- lib/girb/tools/inspect_object.rb
+- lib/girb/tools/list_methods.rb
+- lib/girb/tools/rails_tools.rb
+- lib/girb/tools/read_file.rb
+- lib/girb/tools/session_history_tool.rb
+- lib/girb/version.rb
+- lib/irb/command/qq.rb
+homepage: https://github.com/rira100000000/girb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rira100000000/girb
+  source_code_uri: https://github.com/rira100000000/girb
+  changelog_uri: https://github.com/rira100000000/girb/blob/main/CHANGELOG.md
+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.7.2
+specification_version: 4
+summary: AI-powered IRB assistant
+test_files: []