Initial public release v0.0.1.alpha2

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.

test/opencode/loading_test.rb

@@ -0,0 +1,72 @@
+# 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