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/session_test.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+# Contract smoke for Opencode::Session. Behavioral coverage (idempotent
+# ensure!/recreate!/abort! with row-level locking, race-safety,
+# permissions_for callable handoff) lives in the host application
+# where AR fixtures + a real ActiveRecord row exist.
+class Opencode::SessionTest < Minitest::Test
+  def test_initialize_takes_record_and_two_keyword_callables
+    params = Opencode::Session.instance_method(:initialize).parameters
+
+    assert_includes params, [ :req, :record ],
+      "Session must take a positional record (an AR row with #with_lock, #title, etc.)"
+    assert_includes params, [ :keyreq, :permissions_for ],
+      "Session must require a permissions_for: callable (host-injected per-product permissions)"
+    assert_includes params, [ :key, :on_error ],
+      "Session must accept an optional on_error: callable for adapter-style error reporting"
+  end
+
+  def test_public_api_is_ensure_recreate_abort_just_created
+    methods = Opencode::Session.instance_methods(false).sort
+    assert_equal %i[abort! ensure! just_created? recreate!].sort, methods.sort,
+      "Session's public surface should be exactly: ensure!/recreate!/abort!/just_created?. " \
+      "Found: #{methods.inspect}"
+  end
+end