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.
70 lines
2.5 KiB
Ruby
70 lines
2.5 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require "test_helper"
|
|
|
|
# Smoke test for Opencode::Transform — the base class for
|
|
# content-rewriting transforms. It is intentionally abstract:
|
|
# #source_filename, #destination_filename, and #render all raise
|
|
# NotImplementedError. Subclasses (host-side) provide the meat.
|
|
# These tests document the abstract contract.
|
|
class Opencode::TransformTest < Minitest::Test
|
|
def test_source_filename_is_abstract
|
|
err = assert_raises(NotImplementedError) { Opencode::Transform.new.source_filename }
|
|
assert_match(/must implement #source_filename/, err.message)
|
|
end
|
|
|
|
def test_destination_filename_is_abstract
|
|
err = assert_raises(NotImplementedError) { Opencode::Transform.new.destination_filename }
|
|
assert_match(/must implement #destination_filename/, err.message)
|
|
end
|
|
|
|
def test_render_is_abstract
|
|
err = assert_raises(NotImplementedError) { Opencode::Transform.new.render(Object.new) }
|
|
assert_match(/must implement #render/, err.message)
|
|
end
|
|
|
|
def test_purge_impostors_defaults_to_false
|
|
refute Opencode::Transform.new.purge_impostors?,
|
|
"Default #purge_impostors? must be false — conservative opt-in by subclasses"
|
|
end
|
|
|
|
# A trivial concrete subclass exercises the defaults that DO exist
|
|
# (#applies_to?, #trusted?, #owned_filenames all delegate to the
|
|
# two abstract filename methods).
|
|
class FakeTransform < Opencode::Transform
|
|
def source_filename = "agent-output.json"
|
|
def destination_filename = "rendered.html"
|
|
end
|
|
|
|
Attachment = Struct.new(:filename, keyword_init: true)
|
|
Basenamed = Struct.new(:basename, keyword_init: true)
|
|
|
|
def test_applies_to_matches_source_filename_by_default
|
|
transform = FakeTransform.new
|
|
matching = Basenamed.new(basename: "agent-output.json")
|
|
other = Basenamed.new(basename: "something-else.json")
|
|
|
|
assert transform.applies_to?(matching)
|
|
refute transform.applies_to?(other)
|
|
end
|
|
|
|
def test_trusted_matches_destination_filename_by_default
|
|
transform = FakeTransform.new
|
|
trusted = Attachment.new(filename: "rendered.html")
|
|
untrusted = Attachment.new(filename: "agent-output.json")
|
|
|
|
assert transform.trusted?(trusted)
|
|
refute transform.trusted?(untrusted)
|
|
end
|
|
|
|
def test_owned_filenames_is_source_and_destination
|
|
assert_equal %w[agent-output.json rendered.html],
|
|
FakeTransform.new.owned_filenames
|
|
end
|
|
|
|
def test_error_is_a_subclass_of_standarderror
|
|
assert_operator Opencode::Transform::Error, :<, StandardError,
|
|
"Transform::Error must be rescuable by `rescue StandardError`"
|
|
end
|
|
end
|