ask-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '081f609a014a72157291794a40c580ed6fabb625c2db0c7511538acae540ea9b'
+  data.tar.gz: 1445552073a10f1fbae78f63d7220c894efbcb1cd6433f7aef8f977e4374b1e6
+SHA512:
+  metadata.gz: c0fcb6d2a6f53c8fa89dafd2ce2d6f3393c305a0df0cbfe67472798a9973032645e81ccec5517a855bba25e90572ac5c1100ba4d73b5e98e70ab329629e1ad99
+  data.tar.gz: 5227ec0290f2177f844922038439c99b7bfd8d0d35360b7256206825f220b0323d8d139117000169336f50242191b200f0896a79379d8769996aede9b2f12d36

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaka Ruto
+
+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,34 @@
+# ask-rails
+
+Rails integration for the ask-rb ecosystem. The only gem a Rails app needs to join
+the ask-rb stack — provides a Railtie, AR session persistence, a session factory,
+automatic service gem discovery, and generators.
+
+## Installation
+
+```bash
+bundle add ask-rails
+rails generate ask_rails:install
+```
+
+## Usage
+
+```ruby
+# In any Rails context
+session = Ask::Rails.agent_session
+session.run("Find all open issues labeled 'bug' in our repo")
+```
+
+Service gems like `ask-github`, `ask-slack` are auto-discovered — the agent gets their
+context (auth info, quick-start snippets, error guides) in the system prompt automatically.
+
+## Development
+
+```bash
+bin/setup
+bundle exec rake test
+```
+
+## License
+
+MIT

data/lib/ask/rails/configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    class Configuration
+      attr_accessor :default_model, :max_turns, :system_prompt,
+                    :tool_concurrency, :persistence_adapter, :tools
+
+      def initialize
+        @default_model = "gpt-4o"
+        @max_turns = 25
+        @system_prompt = nil
+        @tool_concurrency = 5
+        @persistence_adapter = nil
+        @tools = []
+      end
+    end
+  end
+end

data/lib/ask/rails/persistence.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    class Persistence
+      def initialize(model_class: nil)
+        @model_class = model_class || default_model_class
+      end
+
+      def save(session_id, data)
+        record = @model_class.find_or_initialize_by(session_id: session_id)
+        record.update!(data: data)
+      end
+
+      def load(session_id)
+        record = @model_class.find_by(session_id: session_id)
+        record&.data
+      end
+
+      def delete(session_id)
+        @model_class.where(session_id: session_id).delete_all
+      end
+
+      def list
+        @model_class.pluck(:session_id)
+      end
+
+      private
+
+      def default_model_class
+        # Lazy reference so the model class doesn't need to exist at load time
+        ask_session_model = Class.new(::ActiveRecord::Base) do
+          self.table_name = "ask_sessions"
+        end
+        # Store it as a constant so it's reusable
+        unless Object.const_defined?(:AskSession)
+          Object.const_set(:AskSession, ask_session_model)
+        end
+        AskSession
+      end
+    end
+  end
+end

data/lib/ask/rails/railtie.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    class Railtie < ::Rails::Railtie
+      rake_tasks do
+        # Load rake tasks if any
+      end
+
+      generators do
+        require_relative "../generators/ask/rails/install/install_generator"
+      end
+
+      initializer "ask_rails.configure" do |app|
+        Ask::Rails.configuration.default_model ||= ENV["ASK_DEFAULT_MODEL"] || "gpt-4o"
+        Ask::Rails.configuration.max_turns ||= (ENV["ASK_MAX_TURNS"] || 25).to_i
+      end
+
+      initializer "ask_rails.discover_tools", after: :eager_load_most do
+        Ask::Rails.discover_tools!
+      end
+
+      initializer "ask_rails.discover_services", after: :eager_load_most do
+        Ask::Rails::ServiceDiscovery.discover!
+      end
+    end
+  end
+end

data/lib/ask/rails/service_discovery.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    module ServiceDiscovery
+      SERVICE_GEMS_PATTERN = /\Aask-(?!tools|tools-shell|agent|rails|core|auth|schema|llm)/
+
+      module_function
+
+      def discover!
+        service_gems = Gem.loaded_specs.keys.select { |name| name.match?(SERVICE_GEMS_PATTERN) }
+        contexts = []
+
+        service_gems.each do |name|
+          begin
+            require "#{name.tr("-", "/")}/context"
+            mod = name.camelize.constantize
+            contexts << mod if mod.const_defined?(:DESCRIPTION)
+          rescue LoadError, NameError
+            # No context module for this gem
+          end
+        end
+
+        unless contexts.empty?
+          prompt = build_system_prompt(contexts)
+          existing = Ask::Rails.configuration.system_prompt
+          Ask::Rails.configuration.system_prompt = [existing, prompt].compact.join("\n\n")
+        end
+
+        contexts
+      end
+
+      def build_system_prompt(contexts)
+        sections = ["## Available Services"]
+
+        contexts.each do |mod|
+          sections << "### #{mod.name.demodulize}"
+          sections << mod::DESCRIPTION if mod.const_defined?(:DESCRIPTION)
+          sections << "Documentation: #{mod::DOCS_URL}" if mod.const_defined?(:DOCS_URL)
+          sections << "Authentication: #{mod::AUTH_HOW}" if mod.const_defined?(:AUTH_HOW)
+          sections << ""
+        end
+
+        sections.join("\n")
+      end
+    end
+  end
+end

data/lib/ask/rails/tool.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    class Tool < Ask::Tool
+      def rails_root
+        ::Rails.root
+      end
+    end
+  end
+end

data/lib/ask/rails/tools/read_file.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    module Tools
+      class ReadFile < Ask::Rails::Tool
+        description "Read a file from the Rails app. Paths are relative to Rails.root."
+
+        param :path, type: :string, desc: "Relative path from Rails.root", required: true
+
+        def execute(path:)
+          full_path = rails_root.join(path)
+          return Ask::Result.error(message: "File not found: #{path}") unless full_path.exist?
+
+          content = full_path.read
+          Ask::Result.success(
+            data: { path: path, content: content, size: content.length },
+            metadata: { path: path, size: content.length }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ask/rails/tools/read_routes.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    module Tools
+      class ReadRoutes < Ask::Rails::Tool
+        description "Read the Rails routes from config/routes.rb"
+        def execute
+          routes_file = rails_root.join("config", "routes.rb")
+          return Ask::Result.error(message: "No routes file found") unless routes_file.exist?
+
+          content = routes_file.read
+          Ask::Result.success(
+            data: { content: content },
+            metadata: { size: content.length }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ask/rails/tools/run_command.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    module Tools
+      class RunCommand < Ask::Rails::Tool
+        description "Run a shell command in the Rails app root directory."
+        param :command, type: :string, desc: "Shell command to run", required: true
+
+        def execute(command:)
+          output = `cd #{rails_root} && #{command} 2>&1`
+          Ask::Result.success(
+            data: { output: output, exit_status: $?.exitstatus },
+            metadata: { exit_status: $?.exitstatus }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ask/rails/tools/search_codebase.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    module Tools
+      class SearchCodebase < Ask::Rails::Tool
+        description "Search the Rails codebase with grep."
+        param :pattern, type: :string, desc: "Search pattern", required: true
+        param :path, type: :string, desc: "Subdirectory to search (optional)"
+
+        def execute(pattern:, path: nil)
+          search_path = path ? rails_root.join(path) : rails_root
+          results = `cd #{rails_root} && grep -rn '#{pattern}' #{search_path} 2>&1 | head -50`
+          Ask::Result.success(
+            data: { results: results, count: results.lines.count },
+            metadata: { pattern: pattern, count: results.lines.count }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ask/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Ask
+  module Rails
+    VERSION = "0.1.0"
+  end
+end

data/lib/ask/rails.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "rails"
+require "ask/agent"
+require "ask/auth"
+
+module Ask
+  module Rails
+    class << self
+      def configure
+        yield configuration
+      end
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def agent_session(**extra)
+        tools = configuration.tools.map { |t| t.is_a?(Class) ? t.new : t }
+        prompt = extra.delete(:system_prompt) || configuration.system_prompt || default_system_prompt
+
+        Ask::Agent::Session.new(
+          model: configuration.default_model,
+          max_turns: configuration.max_turns,
+          system_prompt: prompt,
+          tools: tools,
+          persistence: configuration.persistence_adapter,
+          **extra
+        )
+      end
+
+      def discover_tools!
+        self.configuration.tools = Ask::Tools::Shell::TOOLS.map(&:new) + discovered_rails_tools
+      end
+
+      def root
+        @root ||= Pathname.new(File.expand_path("..", __dir__))
+      end
+
+      private
+
+      def discovered_rails_tools
+        tools = []
+        files = Dir[::Rails.root.join("app", "tools", "*.rb")]
+        files.each do |f|
+          require f
+          klass = File.basename(f, ".rb").camelize.constantize rescue next
+          tools << klass if klass < Ask::Rails::Tool
+        end
+        tools
+      rescue
+        tools
+      end
+
+      def default_system_prompt
+        <<~PROMPT
+          You are a Ruby on Rails software engineer.
+          You have direct access to the application's code, database, and runtime.
+          Use your tools to inspect and modify the codebase.
+          Once you have enough information, stop calling tools and give your answer.
+        PROMPT
+      end
+    end
+  end
+end
+
+require_relative "rails/version"
+require_relative "rails/configuration"
+require_relative "rails/railtie"
+require_relative "rails/persistence"
+require_relative "rails/service_discovery"
+require_relative "rails/tool"
+require_relative "rails/tools/read_file"
+require_relative "rails/tools/run_command"
+require_relative "rails/tools/search_codebase"
+require_relative "rails/tools/read_routes"

data/lib/ask-rails.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "ask/rails"

data/lib/generators/ask/rails/install/install_generator.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Ask
+  module Rails
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+        source_root File.expand_path("templates", __dir__)
+
+        desc "Creates ask-rails configuration and migration"
+
+        def create_initializer
+          template "initializer.rb", "config/initializers/ask_rails.rb"
+        end
+
+        def create_migration
+          timestamp = Time.now.utc.strftime("%Y%m%d%H%M%S")
+          template "migration.rb", "db/migrate/#{timestamp}_create_ask_sessions.rb"
+        end
+
+        def create_tools_directory
+          empty_directory "app/tools"
+          create_file "app/tools/.keep", ""
+        end
+      end
+    end
+  end
+end

data/lib/generators/ask/rails/install/templates/initializer.rb

@@ -0,0 +1,5 @@
+Ask::Rails.configure do |config|
+  config.default_model = ENV.fetch("ASK_DEFAULT_MODEL", "gpt-4o")
+  config.max_turns = ENV.fetch("ASK_MAX_TURNS", 25).to_i
+  # config.persistence_adapter = Ask::Rails::Persistence.new
+end

data/lib/generators/ask/rails/install/templates/migration.rb

@@ -0,0 +1,12 @@
+class CreateAskSessions < ActiveRecord::Migration[7.1]
+  def change
+    create_table :ask_sessions do |t|
+      t.string :session_id, null: false
+      t.string :model
+      t.jsonb :data, default: {}
+      t.timestamps
+    end
+
+    add_index :ask_sessions, :session_id, unique: true
+  end
+end

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: ask-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: ask-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ask-tools-shell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ask-agent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ask-auth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !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'
+description: Railtie, AR session persistence, session factory, service gem discovery,
+  and generators.
+email:
+- kaka@myrrlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/ask-rails.rb
+- lib/ask/rails.rb
+- lib/ask/rails/configuration.rb
+- lib/ask/rails/persistence.rb
+- lib/ask/rails/railtie.rb
+- lib/ask/rails/service_discovery.rb
+- lib/ask/rails/tool.rb
+- lib/ask/rails/tools/read_file.rb
+- lib/ask/rails/tools/read_routes.rb
+- lib/ask/rails/tools/run_command.rb
+- lib/ask/rails/tools/search_codebase.rb
+- lib/ask/rails/version.rb
+- lib/generators/ask/rails/install/install_generator.rb
+- lib/generators/ask/rails/install/templates/initializer.rb
+- lib/generators/ask/rails/install/templates/migration.rb
+homepage: https://github.com/ask-rb/ask-rails
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Rails integration for the ask-rb ecosystem
+test_files: []