Ajay Krishnan
9b0c4cd3cd
opencode-rails — production-grade Rails integration for OpenCode. Rails companion to opencode-ruby. ActiveRecord-aware session lifecycle (idempotent ensure!/recreate!/abort! with row-level locks), a Turn orchestrator driving the Reply state machine and recovering from session-not-found, an artifact pipeline backed by ActiveStorage, sandbox seeding, and tool-display value objects for Turbo Stream broadcasts. Drop into any Rails 7.1+ app that wants production-grade OpenCode streaming without rolling boilerplate. What this version ships: - Opencode::Session (AR-coupled lifecycle, row-level locks) - Opencode::Turn (Reply state machine, session-not-found recovery) - Opencode::Exchange (one turn = one request/response unit) - Opencode::Impostor (deterministic mock for tests) - Opencode::Sandbox / SandboxFile (per-session FS scratch space) - Opencode::Transform (host-rendered artifact pipeline) - Opencode::Artifact / MessageArtifacts (ActiveStorage-backed) - Opencode::UploadedFilesPrompt (system-prompt builder) - Opencode::ToolDisplay (Turbo Stream value objects) - Opencode::ErrorReporter (pluggable adapter — Honeybadger/Sentry/etc.) - examples/rails_integration.rb — canonical wiring blueprint 53 smoke tests. CI on Ruby 3.2/3.3/3.4. Ruby >= 3.2. Runtime deps: opencode-ruby = 0.0.1.alpha2, activerecord/activestorage/activesupport >= 7.1, < 9.0. See CHANGELOG.md for the alpha1 -> alpha2 delta.
73 lines
2.9 KiB
Ruby
73 lines
2.9 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require "test_helper"
|
|
|
|
# Smoke test: every constant the gem promises is defined and points at
|
|
# the right kind of object. If require "opencode-rails" loads cleanly,
|
|
# this passes. If the require chain drifts or a file fails to load,
|
|
# this catches it before downstream apps do.
|
|
class Opencode::LoadingTest < Minitest::Test
|
|
GEM_PROVIDED_CONSTANTS = %w[
|
|
Session Turn Exchange Artifact Sandbox SandboxFile
|
|
Transform Impostor MessageArtifacts UploadedFilesPrompt
|
|
ToolDisplay ErrorReporter
|
|
].freeze
|
|
|
|
# Reply / Tracer / Client / etc. ship in opencode-ruby and are
|
|
# transitively required by opencode-rails' umbrella. Verify the
|
|
# require chain pulled them in.
|
|
TRANSITIVE_CONSTANTS_FROM_OPENCODE_RUBY = %w[
|
|
Client Reply ReplyObserver Tracer Prompts
|
|
ResponseParser ToolPart PartSource Todo
|
|
Instrumentation Error
|
|
].freeze
|
|
|
|
def test_gem_provides_expected_constants
|
|
GEM_PROVIDED_CONSTANTS.each do |name|
|
|
assert Opencode.const_defined?(name),
|
|
"Expected Opencode::#{name} to be defined after `require \"opencode-rails\"`"
|
|
end
|
|
end
|
|
|
|
def test_transitively_loads_opencode_ruby_constants
|
|
TRANSITIVE_CONSTANTS_FROM_OPENCODE_RUBY.each do |name|
|
|
assert Opencode.const_defined?(name),
|
|
"Expected Opencode::#{name} to be defined transitively via opencode-ruby"
|
|
end
|
|
end
|
|
|
|
# We check via path match on both directory ("/opencode-rails/") and
|
|
# installed-gem name ("/opencode-rails-VERSION/") so the assertion is
|
|
# robust to either a sibling-repo dev setup or a bundle-resolved gem
|
|
# install.
|
|
GEM_PATH_PATTERN = ->(name) { %r{/#{Regexp.escape(name)}[-/]} }
|
|
|
|
def test_session_constant_points_at_this_gem
|
|
location = Opencode::Session.instance_method(:initialize).source_location.first
|
|
assert_match GEM_PATH_PATTERN.call("opencode-rails"), location,
|
|
"Expected Opencode::Session to be loaded from opencode-rails, got: #{location}"
|
|
end
|
|
|
|
def test_client_constant_points_at_opencode_ruby
|
|
location = Opencode::Client.instance_method(:initialize).source_location.first
|
|
assert_match GEM_PATH_PATTERN.call("opencode-ruby"), location,
|
|
"Expected Opencode::Client to come from opencode-ruby, got: #{location}"
|
|
refute_match GEM_PATH_PATTERN.call("opencode-rails"), location,
|
|
"Opencode::Client must NOT come from opencode-rails (it's an opencode-ruby class)"
|
|
end
|
|
|
|
def test_version_constant
|
|
assert_match(/\A\d+\.\d+\.\d+/, Opencode::RAILS_VERSION)
|
|
end
|
|
|
|
def test_no_opencode_rails_module
|
|
# Defining Opencode::Rails as a module would shadow ::Rails for any
|
|
# host code that references top-level Rails.* from inside the
|
|
# Opencode:: namespace (e.g. lib/opencode/containers/container.rb).
|
|
# Verify the namespace stays clean — version lives at
|
|
# Opencode::RAILS_VERSION, not Opencode::Rails::VERSION.
|
|
refute Opencode.const_defined?(:Rails),
|
|
"Opencode::Rails must not be defined — it would shadow ::Rails inside the Opencode namespace"
|
|
end
|
|
end
|